@ttt-productions/notification-core 0.15.16 → 0.15.18

package/dist/react/hooks/useActiveNotifications.js

@@ -1,14 +1,9 @@
 'use client';
-import { paginatedPageKey } from '@ttt-productions/query-core';
-import { useFirestorePaginated, useReadRetryState } from '@ttt-productions/query-core/react';
+import { paginatedPageKey, useFirestorePaginated, useReadRetryState, } from '@ttt-productions/query-core/react';
 import { orderBy, where } from 'firebase/firestore';
 const DEFAULT_PAGE_SIZE = 20;
 const DEFAULT_REFETCH_INTERVAL = 30_000;
 const DEFAULT_STALE_TIME = 30_000;
-/**
- * Paginated read of active notifications. The displayed page is re-read every
- * `refetchInterval` ms while mounted — polling, not a realtime listener, for cost.
- */
 export function useActiveNotifications({ config, userId, category, enabled = true, pageSize = DEFAULT_PAGE_SIZE, refetchInterval = DEFAULT_REFETCH_INTERVAL, staleTime = DEFAULT_STALE_TIME, }) {
     const categoryConfig = config.categories[category];
     if (!categoryConfig) {
@@ -30,8 +25,8 @@ export function useActiveNotifications({ config, userId, category, enabled = tru
         refetchInterval,
         staleTime,
     });
-    // The displayed page's failure held through its retry: a refetch of a never-succeeded page clears
-    // `error` while it runs, so the list would drop its failure under the retry the person pressed.
+    // A refetch of a never-succeeded page clears `error` while it runs, so the failure is held
+    // through the retry.
     return { ...read, retryState: useReadRetryState(read, paginatedPageKey(queryKey, read.page)) };
 }
 //# sourceMappingURL=useActiveNotifications.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"useActiveNotifications.js","sourceRoot":"","sources":["../../../src/react/hooks/useActiveNotifications.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC7F,OAAO,EAAE,OAAO,EAAE,KAAK,EAAwB,MAAM,oBAAoB,CAAC;AAG1E,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAC7B,MAAM,wBAAwB,GAAG,MAAM,CAAC;AACxC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAElC;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,EACrC,MAAM,EACN,MAAM,EACN,QAAQ,EACR,OAAO,GAAG,IAAI,EACd,QAAQ,GAAG,iBAAiB,EAC5B,eAAe,GAAG,wBAAwB,EAC1C,SAAS,GAAG,kBAAkB,GACA;IAC9B,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;KAC7B,CAAC;IAEF,MAAM,QAAQ,GAAG,CAAC,eAAe,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC7E,MAAM,IAAI,GAAG,qBAAqB,CAAkB;QAClD,cAAc;QACd,QAAQ;QACR,WAAW;QACX,QAAQ;QACR,OAAO,EAAE,OAAO,IAAI,CAAC,CAAC,MAAM;QAC5B,eAAe;QACf,SAAS;KACV,CAAC,CAAC;IACH,kGAAkG;IAClG,gGAAgG;IAChG,OAAO,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;AACjG,CAAC","sourcesContent":["'use client';\n\nimport { paginatedPageKey } from '@ttt-productions/query-core';\nimport { useFirestorePaginated, useReadRetryState } from '@ttt-productions/query-core/react';\nimport { orderBy, where, type QueryConstraint } from 'firebase/firestore';\nimport type { NotificationDoc, UseActiveNotificationsOptions } from '../../types.js';\n\nconst DEFAULT_PAGE_SIZE = 20;\nconst DEFAULT_REFETCH_INTERVAL = 30_000;\nconst DEFAULT_STALE_TIME = 30_000;\n\n/**\n * Paginated read of active notifications. The displayed page is re-read every\n * `refetchInterval` ms while mounted — polling, not a realtime listener, for cost.\n */\nexport function useActiveNotifications({\n  config,\n  userId,\n  category,\n  enabled = true,\n  pageSize = DEFAULT_PAGE_SIZE,\n  refetchInterval = DEFAULT_REFETCH_INTERVAL,\n  staleTime = DEFAULT_STALE_TIME,\n}: UseActiveNotificationsOptions) {\n  const categoryConfig = config.categories[category];\n  if (!categoryConfig) {\n    throw new Error(`[notification-core] Unknown category: ${category}`);\n  }\n\n  const collectionPath = categoryConfig.activePath;\n  const isPersonal = categoryConfig.audienceType === 'personal';\n\n  const constraints: QueryConstraint[] = [\n    ...(isPersonal ? [where('targetUserId', '==', userId)] : []),\n    orderBy('updatedAt', 'desc'),\n  ];\n\n  const queryKey = ['notifications', 'active', category, userId, { pageSize }];\n  const read = useFirestorePaginated<NotificationDoc>({\n    collectionPath,\n    queryKey,\n    constraints,\n    pageSize,\n    enabled: enabled && !!userId,\n    refetchInterval,\n    staleTime,\n  });\n  // The displayed page's failure held through its retry: a refetch of a never-succeeded page clears\n  // `error` while it runs, so the list would drop its failure under the retry the person pressed.\n  return { ...read, retryState: useReadRetryState(read, paginatedPageKey(queryKey, read.page)) };\n}\n"]}
+{"version":3,"file":"useActiveNotifications.js","sourceRoot":"","sources":["../../../src/react/hooks/useActiveNotifications.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAwB,MAAM,oBAAoB,CAAC;AAG1E,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAC7B,MAAM,wBAAwB,GAAG,MAAM,CAAC;AACxC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAElC,MAAM,UAAU,sBAAsB,CAAC,EACrC,MAAM,EACN,MAAM,EACN,QAAQ,EACR,OAAO,GAAG,IAAI,EACd,QAAQ,GAAG,iBAAiB,EAC5B,eAAe,GAAG,wBAAwB,EAC1C,SAAS,GAAG,kBAAkB,GACA;IAC9B,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;KAC7B,CAAC;IAEF,MAAM,QAAQ,GAAG,CAAC,eAAe,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC7E,MAAM,IAAI,GAAG,qBAAqB,CAAkB;QAClD,cAAc;QACd,QAAQ;QACR,WAAW;QACX,QAAQ;QACR,OAAO,EAAE,OAAO,IAAI,CAAC,CAAC,MAAM;QAC5B,eAAe;QACf,SAAS;KACV,CAAC,CAAC;IACH,2FAA2F;IAC3F,qBAAqB;IACrB,OAAO,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;AACjG,CAAC","sourcesContent":["'use client';\n\nimport {\n  paginatedPageKey,\n  useFirestorePaginated,\n  useReadRetryState,\n} from '@ttt-productions/query-core/react';\nimport { orderBy, where, type QueryConstraint } from 'firebase/firestore';\nimport type { NotificationDoc, UseActiveNotificationsOptions } from '../../types.js';\n\nconst DEFAULT_PAGE_SIZE = 20;\nconst DEFAULT_REFETCH_INTERVAL = 30_000;\nconst DEFAULT_STALE_TIME = 30_000;\n\nexport function useActiveNotifications({\n  config,\n  userId,\n  category,\n  enabled = true,\n  pageSize = DEFAULT_PAGE_SIZE,\n  refetchInterval = DEFAULT_REFETCH_INTERVAL,\n  staleTime = DEFAULT_STALE_TIME,\n}: UseActiveNotificationsOptions) {\n  const categoryConfig = config.categories[category];\n  if (!categoryConfig) {\n    throw new Error(`[notification-core] Unknown category: ${category}`);\n  }\n\n  const collectionPath = categoryConfig.activePath;\n  const isPersonal = categoryConfig.audienceType === 'personal';\n\n  const constraints: QueryConstraint[] = [\n    ...(isPersonal ? [where('targetUserId', '==', userId)] : []),\n    orderBy('updatedAt', 'desc'),\n  ];\n\n  const queryKey = ['notifications', 'active', category, userId, { pageSize }];\n  const read = useFirestorePaginated<NotificationDoc>({\n    collectionPath,\n    queryKey,\n    constraints,\n    pageSize,\n    enabled: enabled && !!userId,\n    refetchInterval,\n    staleTime,\n  });\n  // A refetch of a never-succeeded page clears `error` while it runs, so the failure is held\n  // through the retry.\n  return { ...read, retryState: useReadRetryState(read, paginatedPageKey(queryKey, read.page)) };\n}\n"]}

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

@@ -1,33 +1,3 @@
 import type { ArchiveAllPollResult, UseArchiveAllNotificationsOptions } from '../../types.js';
-/**
- * Trigger + poll a SERVER-OWNED archive-all job for one notification category.
- *
- * This is a THIN STATUS POLLER, not a client loop. It:
- *   1. enqueues ONE server job via `enqueueArchiveAllFn(category)` (the category — the tab the tray
- *      was invoked on — flows into the job, preserving per-tab scoping: the worker archives ONLY
- *      that category's active cards, never all tabs);
- *   2. polls `getArchiveAllStatusFn(jobId)` until the job reaches a terminal state
- *      (`complete` | `incomplete` | `failed`);
- *   3. resolves an {@link ArchiveAllPollResult} the caller gates side effects on, and invalidates
- *      the read keys on a completed drain.
- *
- * All paging + ownership-checked per-card deletion happen server-side. The hook performs no client
- * Firestore writes and never chains archive calls. The generic package hardcodes no callable name —
- * the app injects both adapters.
- *
- * @example
- * ```tsx
- * const enqueue = httpsCallable(functions, 'enqueueArchiveAll');
- * const getStatus = httpsCallable(functions, 'getArchiveAllStatus');
- * const archiveAll = useArchiveAllNotifications({
- *   userId: user.uid,
- *   category: 'user',
- *   enqueueArchiveAllFn: (category) => enqueue({ category }).then((r) => r.data),
- *   getArchiveAllStatusFn: (jobId) => getStatus({ jobId }).then((r) => r.data),
- * });
- *
- * archiveAll.mutate();
- * ```
- */
 export declare function useArchiveAllNotifications({ userId, category, enqueueArchiveAllFn, getArchiveAllStatusFn, pollIntervalMs, maxPolls, invalidateKeys, }: UseArchiveAllNotificationsOptions): import("@tanstack/react-query").UseMutationResult<ArchiveAllPollResult, 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":"AAGA,OAAO,KAAK,EACV,oBAAoB,EACpB,iCAAiC,EAClC,MAAM,gBAAgB,CAAC;AASxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,0BAA0B,CAAC,EACzC,MAAM,EACN,QAAQ,EACR,mBAAmB,EACnB,qBAAqB,EACrB,cAAyC,EACzC,QAA4B,EAC5B,cAAc,GACf,EAAE,iCAAiC,iGAkEnC"}
+{"version":3,"file":"useArchiveAllNotifications.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useArchiveAllNotifications.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,iCAAiC,EAAE,MAAM,gBAAgB,CAAC;AAS9F,wBAAgB,0BAA0B,CAAC,EACzC,MAAM,EACN,QAAQ,EACR,mBAAmB,EACnB,qBAAqB,EACrB,cAAyC,EACzC,QAA4B,EAC5B,cAAc,GACf,EAAE,iCAAiC,iGAkEnC"}

package/dist/react/hooks/useArchiveAllNotifications.js

@@ -1,40 +1,10 @@
 'use client';
 import { useMutation, useQueryClient } from '@tanstack/react-query';
 const DEFAULT_POLL_INTERVAL_MS = 1500;
-const DEFAULT_MAX_POLLS = 120; // ~3 min at the default interval
+const DEFAULT_MAX_POLLS = 120;
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
-/**
- * Trigger + poll a SERVER-OWNED archive-all job for one notification category.
- *
- * This is a THIN STATUS POLLER, not a client loop. It:
- *   1. enqueues ONE server job via `enqueueArchiveAllFn(category)` (the category — the tab the tray
- *      was invoked on — flows into the job, preserving per-tab scoping: the worker archives ONLY
- *      that category's active cards, never all tabs);
- *   2. polls `getArchiveAllStatusFn(jobId)` until the job reaches a terminal state
- *      (`complete` | `incomplete` | `failed`);
- *   3. resolves an {@link ArchiveAllPollResult} the caller gates side effects on, and invalidates
- *      the read keys on a completed drain.
- *
- * All paging + ownership-checked per-card deletion happen server-side. The hook performs no client
- * Firestore writes and never chains archive calls. The generic package hardcodes no callable name —
- * the app injects both adapters.
- *
- * @example
- * ```tsx
- * const enqueue = httpsCallable(functions, 'enqueueArchiveAll');
- * const getStatus = httpsCallable(functions, 'getArchiveAllStatus');
- * const archiveAll = useArchiveAllNotifications({
- *   userId: user.uid,
- *   category: 'user',
- *   enqueueArchiveAllFn: (category) => enqueue({ category }).then((r) => r.data),
- *   getArchiveAllStatusFn: (jobId) => getStatus({ jobId }).then((r) => r.data),
- * });
- *
- * archiveAll.mutate();
- * ```
- */
 export function useArchiveAllNotifications({ userId, category, enqueueArchiveAllFn, getArchiveAllStatusFn, pollIntervalMs = DEFAULT_POLL_INTERVAL_MS, maxPolls = DEFAULT_MAX_POLLS, invalidateKeys, }) {
     const queryClient = useQueryClient();
     const defaultInvalidateKeys = [
@@ -43,15 +13,8 @@ export function useArchiveAllNotifications({ userId, category, enqueueArchiveAll
         ['notifications', 'history', category, userId],
     ];
     return useMutation({
-        // Server-owned archive-all: enqueue ONE job scoped to `category`, then poll its status until it
-        // reaches a terminal state. No browser loop, no chain of archive transactions. The mutation
-        // resolves with an explicit terminal result (never throws for an incomplete drain) — `complete`
-        // is the load-bearing flag callers gate post-clear side effects on.
         mutationFn: async () => {
             const { jobId } = await enqueueArchiveAllFn(category);
-            // Poll until terminal or until the guard bound is hit. A job that never terminates resolves
-            // `incomplete` (mirrors the old loop's honest "some remain" result) rather than hanging. The
-            // first poll happens immediately so a fast/already-complete job resolves without a delay.
             let lastArchived = 0;
             for (let poll = 0; poll < maxPolls; poll += 1) {
                 const snap = await getArchiveAllStatusFn(jobId);
@@ -66,7 +29,13 @@ export function useArchiveAllNotifications({ userId, category, enqueueArchiveAll
                     };
                 }
                 if (snap.state === 'incomplete') {
-                    return { status: 'incomplete', category, archived: lastArchived, notArchived: 0, complete: false };
+                    return {
+                        status: 'incomplete',
+                        category,
+                        archived: lastArchived,
+                        notArchived: 0,
+                        complete: false,
+                    };
                 }
                 if (snap.state === 'failed') {
                     return {
@@ -78,17 +47,18 @@ export function useArchiveAllNotifications({ userId, category, enqueueArchiveAll
                         error: snap.error,
                     };
                 }
-                // Still in-progress — wait before the next poll unless this was the last allowed poll.
                 if (poll < maxPolls - 1)
                     await sleep(pollIntervalMs);
             }
-            // Guard: the job never reached a terminal state within the poll budget — report incomplete.
-            return { status: 'incomplete', category, archived: lastArchived, notArchived: 0, complete: false };
+            return {
+                status: 'incomplete',
+                category,
+                archived: lastArchived,
+                notArchived: 0,
+                complete: false,
+            };
         },
         onSuccess: (result) => {
-            // Only a completed drain changed the active set; still invalidate on an incomplete drain since
-            // SOME cards were archived. A hard enqueue/poll failure rejects the mutation (onError), so this
-            // never runs for `failed`.
             const keysToInvalidate = invalidateKeys ?? defaultInvalidateKeys;
             keysToInvalidate.forEach((key) => {
                 queryClient.invalidateQueries({ queryKey: [...key], exact: false });

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

@@ -1 +1 @@
-{"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;AAMpE,MAAM,wBAAwB,GAAG,IAAI,CAAC;AACtC,MAAM,iBAAiB,GAAG,GAAG,CAAC,CAAC,iCAAiC;AAEhE,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,0BAA0B,CAAC,EACzC,MAAM,EACN,QAAQ,EACR,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,GAAG,wBAAwB,EACzC,QAAQ,GAAG,iBAAiB,EAC5B,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,gGAAgG;QAChG,4FAA4F;QAC5F,gGAAgG;QAChG,oEAAoE;QACpE,UAAU,EAAE,KAAK,IAAmC,EAAE;YACpD,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,mBAAmB,CAAC,QAAQ,CAAC,CAAC;YAEtD,4FAA4F;YAC5F,6FAA6F;YAC7F,0FAA0F;YAC1F,IAAI,YAAY,GAAG,CAAC,CAAC;YACrB,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,QAAQ,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;gBAC9C,MAAM,IAAI,GAAG,MAAM,qBAAqB,CAAC,KAAK,CAAC,CAAC;gBAChD,YAAY,GAAG,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;gBAElC,IAAI,IAAI,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;oBAC9B,OAAO;wBACL,MAAM,EAAE,UAAU;wBAClB,QAAQ;wBACR,QAAQ,EAAE,YAAY;wBACtB,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,CAAC;wBAClC,QAAQ,EAAE,IAAI;qBACf,CAAC;gBACJ,CAAC;gBACD,IAAI,IAAI,CAAC,KAAK,KAAK,YAAY,EAAE,CAAC;oBAChC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;gBACrG,CAAC;gBACD,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;oBAC5B,OAAO;wBACL,MAAM,EAAE,QAAQ;wBAChB,QAAQ;wBACR,QAAQ,EAAE,YAAY;wBACtB,WAAW,EAAE,CAAC;wBACd,QAAQ,EAAE,KAAK;wBACf,KAAK,EAAE,IAAI,CAAC,KAAK;qBAClB,CAAC;gBACJ,CAAC;gBAED,uFAAuF;gBACvF,IAAI,IAAI,GAAG,QAAQ,GAAG,CAAC;oBAAE,MAAM,KAAK,CAAC,cAAc,CAAC,CAAC;YACvD,CAAC;YAED,4FAA4F;YAC5F,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QACrG,CAAC;QACD,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE;YACpB,+FAA+F;YAC/F,gGAAgG;YAChG,2BAA2B;YAC3B,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;YACH,KAAK,MAAM,CAAC;QACd,CAAC;KACF,CAAC,CAAC;AACL,CAAC","sourcesContent":["'use client';\n\nimport { useMutation, useQueryClient } from '@tanstack/react-query';\nimport type {\n  ArchiveAllPollResult,\n  UseArchiveAllNotificationsOptions,\n} from '../../types.js';\n\nconst DEFAULT_POLL_INTERVAL_MS = 1500;\nconst DEFAULT_MAX_POLLS = 120; // ~3 min at the default interval\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n/**\n * Trigger + poll a SERVER-OWNED archive-all job for one notification category.\n *\n * This is a THIN STATUS POLLER, not a client loop. It:\n *   1. enqueues ONE server job via `enqueueArchiveAllFn(category)` (the category — the tab the tray\n *      was invoked on — flows into the job, preserving per-tab scoping: the worker archives ONLY\n *      that category's active cards, never all tabs);\n *   2. polls `getArchiveAllStatusFn(jobId)` until the job reaches a terminal state\n *      (`complete` | `incomplete` | `failed`);\n *   3. resolves an {@link ArchiveAllPollResult} the caller gates side effects on, and invalidates\n *      the read keys on a completed drain.\n *\n * All paging + ownership-checked per-card deletion happen server-side. The hook performs no client\n * Firestore writes and never chains archive calls. The generic package hardcodes no callable name —\n * the app injects both adapters.\n *\n * @example\n * ```tsx\n * const enqueue = httpsCallable(functions, 'enqueueArchiveAll');\n * const getStatus = httpsCallable(functions, 'getArchiveAllStatus');\n * const archiveAll = useArchiveAllNotifications({\n *   userId: user.uid,\n *   category: 'user',\n *   enqueueArchiveAllFn: (category) => enqueue({ category }).then((r) => r.data),\n *   getArchiveAllStatusFn: (jobId) => getStatus({ jobId }).then((r) => r.data),\n * });\n *\n * archiveAll.mutate();\n * ```\n */\nexport function useArchiveAllNotifications({\n  userId,\n  category,\n  enqueueArchiveAllFn,\n  getArchiveAllStatusFn,\n  pollIntervalMs = DEFAULT_POLL_INTERVAL_MS,\n  maxPolls = DEFAULT_MAX_POLLS,\n  invalidateKeys,\n}: UseArchiveAllNotificationsOptions) {\n  const queryClient = useQueryClient();\n\n  const defaultInvalidateKeys = [\n    ['notifications', 'active', category, userId],\n    ['notifications', 'unread-count', category, userId],\n    ['notifications', 'history', category, userId],\n  ];\n\n  return useMutation({\n    // Server-owned archive-all: enqueue ONE job scoped to `category`, then poll its status until it\n    // reaches a terminal state. No browser loop, no chain of archive transactions. The mutation\n    // resolves with an explicit terminal result (never throws for an incomplete drain) — `complete`\n    // is the load-bearing flag callers gate post-clear side effects on.\n    mutationFn: async (): Promise<ArchiveAllPollResult> => {\n      const { jobId } = await enqueueArchiveAllFn(category);\n\n      // Poll until terminal or until the guard bound is hit. A job that never terminates resolves\n      // `incomplete` (mirrors the old loop's honest \"some remain\" result) rather than hanging. The\n      // first poll happens immediately so a fast/already-complete job resolves without a delay.\n      let lastArchived = 0;\n      for (let poll = 0; poll < maxPolls; poll += 1) {\n        const snap = await getArchiveAllStatusFn(jobId);\n        lastArchived = snap.archived ?? 0;\n\n        if (snap.state === 'complete') {\n          return {\n            status: 'complete',\n            category,\n            archived: lastArchived,\n            notArchived: snap.notArchived ?? 0,\n            complete: true,\n          };\n        }\n        if (snap.state === 'incomplete') {\n          return { status: 'incomplete', category, archived: lastArchived, notArchived: 0, complete: false };\n        }\n        if (snap.state === 'failed') {\n          return {\n            status: 'failed',\n            category,\n            archived: lastArchived,\n            notArchived: 0,\n            complete: false,\n            error: snap.error,\n          };\n        }\n\n        // Still in-progress — wait before the next poll unless this was the last allowed poll.\n        if (poll < maxPolls - 1) await sleep(pollIntervalMs);\n      }\n\n      // Guard: the job never reached a terminal state within the poll budget — report incomplete.\n      return { status: 'incomplete', category, archived: lastArchived, notArchived: 0, complete: false };\n    },\n    onSuccess: (result) => {\n      // Only a completed drain changed the active set; still invalidate on an incomplete drain since\n      // SOME cards were archived. A hard enqueue/poll failure rejects the mutation (onError), so this\n      // never runs for `failed`.\n      const keysToInvalidate = invalidateKeys ?? defaultInvalidateKeys;\n      keysToInvalidate.forEach((key) => {\n        queryClient.invalidateQueries({ queryKey: [...key], exact: false });\n      });\n      void result;\n    },\n  });\n}\n"]}
+{"version":3,"file":"useArchiveAllNotifications.js","sourceRoot":"","sources":["../../../src/react/hooks/useArchiveAllNotifications.ts"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport { useMutation, useQueryClient } from '@tanstack/react-query';\nimport type { ArchiveAllPollResult, UseArchiveAllNotificationsOptions } from '../../types.js';\n\nconst DEFAULT_POLL_INTERVAL_MS = 1500;\nconst DEFAULT_MAX_POLLS = 120;\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nexport function useArchiveAllNotifications({\n  userId,\n  category,\n  enqueueArchiveAllFn,\n  getArchiveAllStatusFn,\n  pollIntervalMs = DEFAULT_POLL_INTERVAL_MS,\n  maxPolls = DEFAULT_MAX_POLLS,\n  invalidateKeys,\n}: UseArchiveAllNotificationsOptions) {\n  const queryClient = useQueryClient();\n\n  const defaultInvalidateKeys = [\n    ['notifications', 'active', category, userId],\n    ['notifications', 'unread-count', category, userId],\n    ['notifications', 'history', category, userId],\n  ];\n\n  return useMutation({\n    mutationFn: async (): Promise<ArchiveAllPollResult> => {\n      const { jobId } = await enqueueArchiveAllFn(category);\n\n      let lastArchived = 0;\n      for (let poll = 0; poll < maxPolls; poll += 1) {\n        const snap = await getArchiveAllStatusFn(jobId);\n        lastArchived = snap.archived ?? 0;\n\n        if (snap.state === 'complete') {\n          return {\n            status: 'complete',\n            category,\n            archived: lastArchived,\n            notArchived: snap.notArchived ?? 0,\n            complete: true,\n          };\n        }\n        if (snap.state === 'incomplete') {\n          return {\n            status: 'incomplete',\n            category,\n            archived: lastArchived,\n            notArchived: 0,\n            complete: false,\n          };\n        }\n        if (snap.state === 'failed') {\n          return {\n            status: 'failed',\n            category,\n            archived: lastArchived,\n            notArchived: 0,\n            complete: false,\n            error: snap.error,\n          };\n        }\n\n        if (poll < maxPolls - 1) await sleep(pollIntervalMs);\n      }\n\n      return {\n        status: 'incomplete',\n        category,\n        archived: lastArchived,\n        notArchived: 0,\n        complete: false,\n      };\n    },\n    onSuccess: (result) => {\n      const keysToInvalidate = invalidateKeys ?? defaultInvalidateKeys;\n      keysToInvalidate.forEach((key) => {\n        queryClient.invalidateQueries({ queryKey: [...key], exact: false });\n      });\n      void result;\n    },\n  });\n}\n"]}

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

@@ -1,11 +1,3 @@
 import type { NotificationArchiveResult, NotificationDoc, UseArchiveNotificationOptions } from '../../types.js';
-/**
- * Archive a single rendered 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` with the
- * row as rendered, resolves the adapter's `{ archived }` answer, and invalidates the
- * read keys on success.
- */
 export declare function useArchiveNotification({ userId, category, archiveFn, invalidateKeys, }: UseArchiveNotificationOptions): import("@tanstack/react-query").UseMutationResult<NotificationArchiveResult, Error, NotificationDoc, 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":"AAGA,OAAO,KAAK,EACV,yBAAyB,EACzB,eAAe,EACf,6BAA6B,EAC9B,MAAM,gBAAgB,CAAC;AAExB;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,MAAM,EACN,QAAQ,EACR,SAAS,EACT,cAAc,GACf,EAAE,6BAA6B,iHAkB/B"}
+{"version":3,"file":"useArchiveNotification.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useArchiveNotification.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,yBAAyB,EACzB,eAAe,EACf,6BAA6B,EAC9B,MAAM,gBAAgB,CAAC;AAExB,wBAAgB,sBAAsB,CAAC,EACrC,MAAM,EACN,QAAQ,EACR,SAAS,EACT,cAAc,GACf,EAAE,6BAA6B,iHAkB/B"}

package/dist/react/hooks/useArchiveNotification.js

@@ -1,13 +1,5 @@
 'use client';
 import { useMutation, useQueryClient } from '@tanstack/react-query';
-/**
- * Archive a single rendered 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` with the
- * row as rendered, resolves the adapter's `{ archived }` answer, and invalidates the
- * read keys on success.
- */
 export function useArchiveNotification({ userId, category, archiveFn, invalidateKeys, }) {
     const queryClient = useQueryClient();
     const defaultInvalidateKeys = [

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;AAOpE;;;;;;;GAOG;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,CAAoD;QACpE,UAAU,EAAE,CAAC,YAA6B,EAAE,EAAE,CAAC,SAAS,CAAC,YAAY,CAAC;QACtE,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","sourcesContent":["'use client';\n\nimport { useMutation, useQueryClient } from '@tanstack/react-query';\nimport type {\n  NotificationArchiveResult,\n  NotificationDoc,\n  UseArchiveNotificationOptions,\n} from '../../types.js';\n\n/**\n * Archive a single rendered notification through an app-supplied callable adapter.\n *\n * The notification system is Cloud-Functions-only: clients never write notification\n * docs. This hook performs no Firestore writes — it delegates to `archiveFn` with the\n * row as rendered, resolves the adapter's `{ archived }` answer, and invalidates the\n * read keys on success.\n */\nexport function useArchiveNotification({\n  userId,\n  category,\n  archiveFn,\n  invalidateKeys,\n}: UseArchiveNotificationOptions) {\n  const queryClient = useQueryClient();\n\n  const defaultInvalidateKeys = [\n    ['notifications', 'active', category, userId],\n    ['notifications', 'unread-count', category, userId],\n    ['notifications', 'history', category, userId],\n  ];\n\n  return useMutation<NotificationArchiveResult, Error, NotificationDoc>({\n    mutationFn: (notification: NotificationDoc) => archiveFn(notification),\n    onSuccess: () => {\n      const keysToInvalidate = invalidateKeys ?? defaultInvalidateKeys;\n      keysToInvalidate.forEach((key) => {\n        queryClient.invalidateQueries({ queryKey: [...key], exact: false });\n      });\n    },\n  });\n}\n"]}
+{"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;AAOpE,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,CAAoD;QACpE,UAAU,EAAE,CAAC,YAA6B,EAAE,EAAE,CAAC,SAAS,CAAC,YAAY,CAAC;QACtE,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","sourcesContent":["'use client';\n\nimport { useMutation, useQueryClient } from '@tanstack/react-query';\nimport type {\n  NotificationArchiveResult,\n  NotificationDoc,\n  UseArchiveNotificationOptions,\n} from '../../types.js';\n\nexport function useArchiveNotification({\n  userId,\n  category,\n  archiveFn,\n  invalidateKeys,\n}: UseArchiveNotificationOptions) {\n  const queryClient = useQueryClient();\n\n  const defaultInvalidateKeys = [\n    ['notifications', 'active', category, userId],\n    ['notifications', 'unread-count', category, userId],\n    ['notifications', 'history', category, userId],\n  ];\n\n  return useMutation<NotificationArchiveResult, Error, NotificationDoc>({\n    mutationFn: (notification: NotificationDoc) => archiveFn(notification),\n    onSuccess: () => {\n      const keysToInvalidate = invalidateKeys ?? defaultInvalidateKeys;\n      keysToInvalidate.forEach((key) => {\n        queryClient.invalidateQueries({ queryKey: [...key], exact: false });\n      });\n    },\n  });\n}\n"]}

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

@@ -1,21 +1,7 @@
 import type { NotificationHistoryItem, UseNotificationHistoryOptions } from '../../types.js';
-/**
- * Paginated read of ARCHIVED notification history (the two-tier system's history
- * tier). Personal history lives under a per-user path
- * (`userProfiles/{uid}/notificationHistory`) and shared/admin history under a
- * top-level collection (`adminNotificationHistory`) — both resolved from the
- * category's `historyPath`, so no `where` clause is needed either way. Rows are
- * immutable and ordered newest-first by `archivedAt`.
- *
- * Each history doc is a wrapper (`archivedSnapshot` + archive metadata + a
- * native-TTL `expireAt`); the `select` mapper flattens it into a
- * {@link NotificationHistoryItem} so the read surface renders like the active
- * list. Owner-only (user) / admin-only (admin) reads are enforced by Firestore
- * rules — this hook performs no writes.
- */
 export declare function useNotificationHistory({ config, userId, category, enabled, pageSize, staleTime, }: UseNotificationHistoryOptions): {
     retryState: import("@ttt-productions/query-core/react").ReadRetryState<Error>;
-    promise: Promise<import("@ttt-productions/query-core").PaginatedPage<import("@ttt-productions/query-core").WithId<NotificationHistoryItem>>>;
+    promise: Promise<import("@ttt-productions/query-core/react").PaginatedPage<import("@ttt-productions/query-core/types").WithId<NotificationHistoryItem>>>;
     error: Error | null;
     isError: boolean;
     isPending: boolean;
@@ -38,9 +24,9 @@ export declare function useNotificationHistory({ config, userId, category, enabl
     isRefetching: boolean;
     isStale: boolean;
     isEnabled: boolean;
-    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<import("@ttt-productions/query-core").PaginatedPage<import("@ttt-productions/query-core").WithId<NotificationHistoryItem>>, Error>>;
+    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<import("@ttt-productions/query-core/react").PaginatedPage<import("@ttt-productions/query-core/types").WithId<NotificationHistoryItem>>, Error>>;
     fetchStatus: import("@tanstack/query-core").FetchStatus;
-    data: import("@ttt-productions/query-core").WithId<NotificationHistoryItem>[] | undefined;
+    data: import("@ttt-productions/query-core/types").WithId<NotificationHistoryItem>[] | undefined;
     page: number;
     pageSize: number;
     hasNextPage: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"useNotificationHistory.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useNotificationHistory.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAEV,uBAAuB,EACvB,6BAA6B,EAC9B,MAAM,gBAAgB,CAAC;AAKxB;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,MAAM,EACN,MAAM,EACN,QAAQ,EACR,OAAc,EACd,QAA4B,EAC5B,SAA8B,GAC/B,EAAE,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgC/B"}
+{"version":3,"file":"useNotificationHistory.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useNotificationHistory.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAEV,uBAAuB,EACvB,6BAA6B,EAC9B,MAAM,gBAAgB,CAAC;AAKxB,wBAAgB,sBAAsB,CAAC,EACrC,MAAM,EACN,MAAM,EACN,QAAQ,EACR,OAAc,EACd,QAA4B,EAC5B,SAA8B,GAC/B,EAAE,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8B/B"}

package/dist/react/hooks/useNotificationHistory.js

@@ -1,23 +1,8 @@
 'use client';
-import { paginatedPageKey } from '@ttt-productions/query-core';
-import { useFirestorePaginated, useReadRetryState } from '@ttt-productions/query-core/react';
+import { paginatedPageKey, useFirestorePaginated, useReadRetryState, } from '@ttt-productions/query-core/react';
 import { orderBy } from 'firebase/firestore';
 const DEFAULT_PAGE_SIZE = 20;
 const DEFAULT_STALE_TIME = 60_000;
-/**
- * Paginated read of ARCHIVED notification history (the two-tier system's history
- * tier). Personal history lives under a per-user path
- * (`userProfiles/{uid}/notificationHistory`) and shared/admin history under a
- * top-level collection (`adminNotificationHistory`) — both resolved from the
- * category's `historyPath`, so no `where` clause is needed either way. Rows are
- * immutable and ordered newest-first by `archivedAt`.
- *
- * Each history doc is a wrapper (`archivedSnapshot` + archive metadata + a
- * native-TTL `expireAt`); the `select` mapper flattens it into a
- * {@link NotificationHistoryItem} so the read surface renders like the active
- * list. Owner-only (user) / admin-only (admin) reads are enforced by Firestore
- * rules — this hook performs no writes.
- */
 export function useNotificationHistory({ config, userId, category, enabled = true, pageSize = DEFAULT_PAGE_SIZE, staleTime = DEFAULT_STALE_TIME, }) {
     const categoryConfig = config.categories[category];
     if (!categoryConfig) {
@@ -37,15 +22,13 @@ export function useNotificationHistory({ config, userId, category, enabled = tru
             const snapshot = (data.archivedSnapshot ?? {});
             return {
                 ...snapshot,
-                // The archive occurrence id is the stable history-doc key; expose
-                // archivedAt for ordering/display.
                 archiveOccurrenceId: data.id,
                 archivedAt: data.archivedAt ?? snapshot.updatedAt ?? 0,
             };
         },
     });
-    // The displayed page's failure held through its retry: a refetch of a never-succeeded page clears
-    // `error` while it runs, so the list would drop its failure under the retry the person pressed.
+    // A refetch of a never-succeeded page clears `error` while it runs, so the failure is held
+    // through the retry.
     return { ...read, retryState: useReadRetryState(read, paginatedPageKey(queryKey, read.page)) };
 }
 //# sourceMappingURL=useNotificationHistory.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"useNotificationHistory.js","sourceRoot":"","sources":["../../../src/react/hooks/useNotificationHistory.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC7F,OAAO,EAAE,OAAO,EAAwB,MAAM,oBAAoB,CAAC;AAOnE,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAC7B,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAElC;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,sBAAsB,CAAC,EACrC,MAAM,EACN,MAAM,EACN,QAAQ,EACR,OAAO,GAAG,IAAI,EACd,QAAQ,GAAG,iBAAiB,EAC5B,SAAS,GAAG,kBAAkB,GACA;IAC9B,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,WAAW,CAAC,MAAM,CAAC,CAAC;IAE1D,MAAM,WAAW,GAAsB,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;IAEvE,MAAM,QAAQ,GAAG,CAAC,eAAe,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC9E,MAAM,IAAI,GAAG,qBAAqB,CAA0B;QAC1D,cAAc;QACd,QAAQ;QACR,WAAW;QACX,QAAQ;QACR,OAAO,EAAE,OAAO,IAAI,CAAC,CAAC,MAAM;QAC5B,SAAS;QACT,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACf,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,gBAAgB,IAAI,EAAE,CAAoB,CAAC;YAClE,OAAO;gBACL,GAAG,QAAQ;gBACX,kEAAkE;gBAClE,mCAAmC;gBACnC,mBAAmB,EAAE,IAAI,CAAC,EAAE;gBAC5B,UAAU,EAAG,IAAI,CAAC,UAAiC,IAAI,QAAQ,CAAC,SAAS,IAAI,CAAC;aAC/E,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;IACH,kGAAkG;IAClG,gGAAgG;IAChG,OAAO,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;AACjG,CAAC","sourcesContent":["'use client';\n\nimport { paginatedPageKey } from '@ttt-productions/query-core';\nimport { useFirestorePaginated, useReadRetryState } from '@ttt-productions/query-core/react';\nimport { orderBy, type QueryConstraint } from 'firebase/firestore';\nimport type {\n  NotificationDoc,\n  NotificationHistoryItem,\n  UseNotificationHistoryOptions,\n} from '../../types.js';\n\nconst DEFAULT_PAGE_SIZE = 20;\nconst DEFAULT_STALE_TIME = 60_000;\n\n/**\n * Paginated read of ARCHIVED notification history (the two-tier system's history\n * tier). Personal history lives under a per-user path\n * (`userProfiles/{uid}/notificationHistory`) and shared/admin history under a\n * top-level collection (`adminNotificationHistory`) — both resolved from the\n * category's `historyPath`, so no `where` clause is needed either way. Rows are\n * immutable and ordered newest-first by `archivedAt`.\n *\n * Each history doc is a wrapper (`archivedSnapshot` + archive metadata + a\n * native-TTL `expireAt`); the `select` mapper flattens it into a\n * {@link NotificationHistoryItem} so the read surface renders like the active\n * list. Owner-only (user) / admin-only (admin) reads are enforced by Firestore\n * rules — this hook performs no writes.\n */\nexport function useNotificationHistory({\n  config,\n  userId,\n  category,\n  enabled = true,\n  pageSize = DEFAULT_PAGE_SIZE,\n  staleTime = DEFAULT_STALE_TIME,\n}: UseNotificationHistoryOptions) {\n  const categoryConfig = config.categories[category];\n  if (!categoryConfig) {\n    throw new Error(`[notification-core] Unknown category: ${category}`);\n  }\n\n  const collectionPath = categoryConfig.historyPath(userId);\n\n  const constraints: QueryConstraint[] = [orderBy('archivedAt', 'desc')];\n\n  const queryKey = ['notifications', 'history', category, userId, { pageSize }];\n  const read = useFirestorePaginated<NotificationHistoryItem>({\n    collectionPath,\n    queryKey,\n    constraints,\n    pageSize,\n    enabled: enabled && !!userId,\n    staleTime,\n    select: (data) => {\n      const snapshot = (data.archivedSnapshot ?? {}) as NotificationDoc;\n      return {\n        ...snapshot,\n        // The archive occurrence id is the stable history-doc key; expose\n        // archivedAt for ordering/display.\n        archiveOccurrenceId: data.id,\n        archivedAt: (data.archivedAt as number | undefined) ?? snapshot.updatedAt ?? 0,\n      };\n    },\n  });\n  // The displayed page's failure held through its retry: a refetch of a never-succeeded page clears\n  // `error` while it runs, so the list would drop its failure under the retry the person pressed.\n  return { ...read, retryState: useReadRetryState(read, paginatedPageKey(queryKey, read.page)) };\n}\n"]}
+{"version":3,"file":"useNotificationHistory.js","sourceRoot":"","sources":["../../../src/react/hooks/useNotificationHistory.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAwB,MAAM,oBAAoB,CAAC;AAOnE,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAC7B,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAElC,MAAM,UAAU,sBAAsB,CAAC,EACrC,MAAM,EACN,MAAM,EACN,QAAQ,EACR,OAAO,GAAG,IAAI,EACd,QAAQ,GAAG,iBAAiB,EAC5B,SAAS,GAAG,kBAAkB,GACA;IAC9B,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,WAAW,CAAC,MAAM,CAAC,CAAC;IAE1D,MAAM,WAAW,GAAsB,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;IAEvE,MAAM,QAAQ,GAAG,CAAC,eAAe,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC9E,MAAM,IAAI,GAAG,qBAAqB,CAA0B;QAC1D,cAAc;QACd,QAAQ;QACR,WAAW;QACX,QAAQ;QACR,OAAO,EAAE,OAAO,IAAI,CAAC,CAAC,MAAM;QAC5B,SAAS;QACT,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACf,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,gBAAgB,IAAI,EAAE,CAAoB,CAAC;YAClE,OAAO;gBACL,GAAG,QAAQ;gBACX,mBAAmB,EAAE,IAAI,CAAC,EAAE;gBAC5B,UAAU,EAAG,IAAI,CAAC,UAAiC,IAAI,QAAQ,CAAC,SAAS,IAAI,CAAC;aAC/E,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;IACH,2FAA2F;IAC3F,qBAAqB;IACrB,OAAO,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;AACjG,CAAC","sourcesContent":["'use client';\n\nimport {\n  paginatedPageKey,\n  useFirestorePaginated,\n  useReadRetryState,\n} from '@ttt-productions/query-core/react';\nimport { orderBy, type QueryConstraint } from 'firebase/firestore';\nimport type {\n  NotificationDoc,\n  NotificationHistoryItem,\n  UseNotificationHistoryOptions,\n} from '../../types.js';\n\nconst DEFAULT_PAGE_SIZE = 20;\nconst DEFAULT_STALE_TIME = 60_000;\n\nexport function useNotificationHistory({\n  config,\n  userId,\n  category,\n  enabled = true,\n  pageSize = DEFAULT_PAGE_SIZE,\n  staleTime = DEFAULT_STALE_TIME,\n}: UseNotificationHistoryOptions) {\n  const categoryConfig = config.categories[category];\n  if (!categoryConfig) {\n    throw new Error(`[notification-core] Unknown category: ${category}`);\n  }\n\n  const collectionPath = categoryConfig.historyPath(userId);\n\n  const constraints: QueryConstraint[] = [orderBy('archivedAt', 'desc')];\n\n  const queryKey = ['notifications', 'history', category, userId, { pageSize }];\n  const read = useFirestorePaginated<NotificationHistoryItem>({\n    collectionPath,\n    queryKey,\n    constraints,\n    pageSize,\n    enabled: enabled && !!userId,\n    staleTime,\n    select: (data) => {\n      const snapshot = (data.archivedSnapshot ?? {}) as NotificationDoc;\n      return {\n        ...snapshot,\n        archiveOccurrenceId: data.id,\n        archivedAt: (data.archivedAt as number | undefined) ?? snapshot.updatedAt ?? 0,\n      };\n    },\n  });\n  // A refetch of a never-succeeded page clears `error` while it runs, so the failure is held\n  // through the retry.\n  return { ...read, retryState: useReadRetryState(read, paginatedPageKey(queryKey, read.page)) };\n}\n"]}

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

@@ -1,26 +1,4 @@
 import type { UseUnreadCountOptions } from '../../types.js';
-/**
- * Unread-count badge backed by a Firestore `count()` aggregation (a server-side
- * count, not a doc fetch), via query-core's `useFirestoreCount`. 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
- * const { count, isLoading } = useUnreadCount({
- *   config: TTT_NOTIFICATION_CONFIG,
- *   userId: user.uid,
- *   category: 'user',
- * });
- * ```
- */
 export declare function useUnreadCount({ config, userId, category, enabled, refetchInterval, countLimit, }: UseUnreadCountOptions): {
     error: Error;
     isError: true;

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,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8BvB"}
+{"version":3,"file":"useUnreadCount.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useUnreadCount.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAM5D,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,MAAM,EACN,QAAQ,EACR,OAAc,EACd,eAA0C,EAC1C,UAAgC,GACjC,EAAE,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4BvB"}

package/dist/react/hooks/useUnreadCount.js

@@ -3,28 +3,7 @@ import { where } from 'firebase/firestore';
 import { useFirestoreCount } from '@ttt-productions/query-core/react';
 const DEFAULT_REFETCH_INTERVAL = 30_000;
 const DEFAULT_COUNT_LIMIT = 99;
-/**
- * Unread-count badge backed by a Firestore `count()` aggregation (a server-side
- * count, not a doc fetch), via query-core's `useFirestoreCount`. 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
- * const { count, isLoading } = useUnreadCount({
- *   config: TTT_NOTIFICATION_CONFIG,
- *   userId: user.uid,
- *   category: 'user',
- * });
- * ```
- */
+// The personal `seenAt == 0` predicate needs a composite index.
 export function useUnreadCount({ config, userId, category, enabled = true, refetchInterval = DEFAULT_REFETCH_INTERVAL, countLimit = DEFAULT_COUNT_LIMIT, }) {
     const categoryConfig = config.categories[category];
     if (!categoryConfig) {
@@ -32,9 +11,7 @@ export function useUnreadCount({ config, userId, category, enabled = true, refet
     }
     const collectionPath = categoryConfig.activePath;
     const isPersonal = categoryConfig.audienceType === 'personal';
-    const constraints = isPersonal && userId
-        ? [where('targetUserId', '==', userId), where('seenAt', '==', 0)]
-        : [];
+    const constraints = isPersonal && userId ? [where('targetUserId', '==', userId), where('seenAt', '==', 0)] : [];
     const { data, ...rest } = useFirestoreCount({
         collectionPath,
         queryKey: ['notifications', 'unread-count', category, userId],

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,KAAK,EAAwB,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAGtE,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,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,GACf,UAAU,IAAI,MAAM;QAClB,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACjE,CAAC,CAAC,EAAE,CAAC;IAET,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,iBAAiB,CAAC;QAC1C,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,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","sourcesContent":["'use client';\n\nimport { where, type QueryConstraint } from 'firebase/firestore';\nimport { useFirestoreCount } from '@ttt-productions/query-core/react';\nimport type { UseUnreadCountOptions } from '../../types.js';\n\nconst DEFAULT_REFETCH_INTERVAL = 30_000;\nconst DEFAULT_COUNT_LIMIT = 99;\n\n/**\n * Unread-count badge backed by a Firestore `count()` aggregation (a server-side\n * count, not a doc fetch), via query-core's `useFirestoreCount`. Polls for cost\n * control; displays capped (`hasMore` → `99+`).\n *\n * - **personal** categories count **unseen** active items (`seenAt == 0`),\n *   scoped to the caller (`targetUserId == uid`);\n * - **shared** categories have no per-admin seen state, so the indicator is\n *   existence-based — a count of all active items, with no `seenAt` predicate.\n *\n * The personal `seenAt == 0` predicate needs a composite index, captured as an\n * app-side index step.\n *\n * @example\n * ```tsx\n * const { count, isLoading } = useUnreadCount({\n *   config: TTT_NOTIFICATION_CONFIG,\n *   userId: user.uid,\n *   category: 'user',\n * });\n * ```\n */\nexport function useUnreadCount({\n  config,\n  userId,\n  category,\n  enabled = true,\n  refetchInterval = DEFAULT_REFETCH_INTERVAL,\n  countLimit = DEFAULT_COUNT_LIMIT,\n}: UseUnreadCountOptions) {\n  const categoryConfig = config.categories[category];\n  if (!categoryConfig) {\n    throw new Error(`[notification-core] Unknown category: ${category}`);\n  }\n\n  const collectionPath = categoryConfig.activePath;\n  const isPersonal = categoryConfig.audienceType === 'personal';\n\n  const constraints: QueryConstraint[] =\n    isPersonal && userId\n      ? [where('targetUserId', '==', userId), where('seenAt', '==', 0)]\n      : [];\n\n  const { data, ...rest } = useFirestoreCount({\n    collectionPath,\n    queryKey: ['notifications', 'unread-count', category, userId],\n    constraints,\n    enabled: enabled && !!userId,\n    staleTime: refetchInterval,\n    refetchInterval,\n  });\n\n  const count = data ?? 0;\n\n  return {\n    count,\n    hasMore: count > countLimit,\n    ...rest,\n  };\n}\n"]}
+{"version":3,"file":"useUnreadCount.js","sourceRoot":"","sources":["../../../src/react/hooks/useUnreadCount.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,KAAK,EAAwB,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAGtE,MAAM,wBAAwB,GAAG,MAAM,CAAC;AACxC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAE/B,gEAAgE;AAChE,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,GACf,UAAU,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE9F,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,iBAAiB,CAAC;QAC1C,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,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","sourcesContent":["'use client';\n\nimport { where, type QueryConstraint } from 'firebase/firestore';\nimport { useFirestoreCount } from '@ttt-productions/query-core/react';\nimport type { UseUnreadCountOptions } from '../../types.js';\n\nconst DEFAULT_REFETCH_INTERVAL = 30_000;\nconst DEFAULT_COUNT_LIMIT = 99;\n\n// The personal `seenAt == 0` predicate needs a composite index.\nexport function useUnreadCount({\n  config,\n  userId,\n  category,\n  enabled = true,\n  refetchInterval = DEFAULT_REFETCH_INTERVAL,\n  countLimit = DEFAULT_COUNT_LIMIT,\n}: UseUnreadCountOptions) {\n  const categoryConfig = config.categories[category];\n  if (!categoryConfig) {\n    throw new Error(`[notification-core] Unknown category: ${category}`);\n  }\n\n  const collectionPath = categoryConfig.activePath;\n  const isPersonal = categoryConfig.audienceType === 'personal';\n\n  const constraints: QueryConstraint[] =\n    isPersonal && userId ? [where('targetUserId', '==', userId), where('seenAt', '==', 0)] : [];\n\n  const { data, ...rest } = useFirestoreCount({\n    collectionPath,\n    queryKey: ['notifications', 'unread-count', category, userId],\n    constraints,\n    enabled: enabled && !!userId,\n    staleTime: refetchInterval,\n    refetchInterval,\n  });\n\n  const count = data ?? 0;\n\n  return {\n    count,\n    hasMore: count > countLimit,\n    ...rest,\n  };\n}\n"]}

package/dist/react/index.d.ts

@@ -1,3 +1,11 @@
-export { useActiveNotifications, useNotificationHistory, useUnreadCount, useArchiveNotification, useArchiveAllNotifications, } from './hooks/index.js';
-export { NotificationList, NotificationHistoryList, NotificationEmptyState, NotificationUnreadBadge, } from './components/index.js';
+export { useActiveNotifications } from './hooks/useActiveNotifications.js';
+export { useNotificationHistory } from './hooks/useNotificationHistory.js';
+export { useUnreadCount } from './hooks/useUnreadCount.js';
+export { useArchiveNotification } from './hooks/useArchiveNotification.js';
+export { useArchiveAllNotifications } from './hooks/useArchiveAllNotifications.js';
+export { NotificationList } from './components/NotificationList.js';
+export { NotificationHistoryList } from './components/NotificationHistoryList.js';
+export { NotificationEmptyState } from './components/NotificationEmptyState.js';
+export { NotificationUnreadBadge } from './components/NotificationUnreadBadge.js';
+export type { NotificationListProps, NotificationHistoryListProps } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,cAAc,EACd,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,MAAM,uCAAuC,CAAC;AAEnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAElF,YAAY,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC"}

package/dist/react/index.js

@@ -1,6 +1,11 @@
-"use client";
-// Hooks
-export { useActiveNotifications, useNotificationHistory, useUnreadCount, useArchiveNotification, useArchiveAllNotifications, } from './hooks/index.js';
-// Components
-export { NotificationList, NotificationHistoryList, NotificationEmptyState, NotificationUnreadBadge, } from './components/index.js';
+'use client';
+export { useActiveNotifications } from './hooks/useActiveNotifications.js';
+export { useNotificationHistory } from './hooks/useNotificationHistory.js';
+export { useUnreadCount } from './hooks/useUnreadCount.js';
+export { useArchiveNotification } from './hooks/useArchiveNotification.js';
+export { useArchiveAllNotifications } from './hooks/useArchiveAllNotifications.js';
+export { NotificationList } from './components/NotificationList.js';
+export { NotificationHistoryList } from './components/NotificationHistoryList.js';
+export { NotificationEmptyState } from './components/NotificationEmptyState.js';
+export { NotificationUnreadBadge } from './components/NotificationUnreadBadge.js';
 //# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,QAAQ;AACR,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,cAAc,EACd,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,kBAAkB,CAAC;AAE1B,aAAa;AACb,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC","sourcesContent":["\"use client\";\n\n// Hooks\nexport {\n  useActiveNotifications,\n  useNotificationHistory,\n  useUnreadCount,\n  useArchiveNotification,\n  useArchiveAllNotifications,\n} from './hooks/index.js';\n\n// Components\nexport {\n  NotificationList,\n  NotificationHistoryList,\n  NotificationEmptyState,\n  NotificationUnreadBadge,\n} from './components/index.js';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,MAAM,uCAAuC,CAAC;AAEnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC","sourcesContent":["'use client';\n\nexport { useActiveNotifications } from './hooks/useActiveNotifications.js';\nexport { useNotificationHistory } from './hooks/useNotificationHistory.js';\nexport { useUnreadCount } from './hooks/useUnreadCount.js';\nexport { useArchiveNotification } from './hooks/useArchiveNotification.js';\nexport { useArchiveAllNotifications } from './hooks/useArchiveAllNotifications.js';\n\nexport { NotificationList } from './components/NotificationList.js';\nexport { NotificationHistoryList } from './components/NotificationHistoryList.js';\nexport { NotificationEmptyState } from './components/NotificationEmptyState.js';\nexport { NotificationUnreadBadge } from './components/NotificationUnreadBadge.js';\n\nexport type { NotificationListProps, NotificationHistoryListProps } from './types.js';\n"]}

package/dist/react/types.d.ts

@@ -0,0 +1,30 @@
+import type { ReactNode } from 'react';
+import type { ArchiveAllJobSnapshot, ArchiveAllPollResult, EnqueueArchiveAllResult, NotificationArchiveFn, NotificationDoc, NotificationHistoryItem, NotificationListErrorState, NotificationRowActions, NotificationSystemConfig } from '../types.js';
+export interface NotificationListProps {
+    config: NotificationSystemConfig;
+    userId: string;
+    category: string;
+    archiveFn: NotificationArchiveFn;
+    enqueueArchiveAllFn: (category: string) => Promise<EnqueueArchiveAllResult>;
+    getArchiveAllStatusFn: (jobId: string) => Promise<ArchiveAllJobSnapshot>;
+    title?: ReactNode;
+    onClearAll?: (result: ArchiveAllPollResult) => void;
+    refetchInterval?: number;
+    staleTime?: number;
+    emptyText?: string;
+    renderError: (state: NotificationListErrorState) => ReactNode;
+    onRenderedRowsChange?: (rows: readonly NotificationDoc[]) => void;
+    renderRowAction?: (notification: NotificationDoc, actions: NotificationRowActions) => ReactNode;
+}
+export interface NotificationHistoryListProps {
+    config: NotificationSystemConfig;
+    userId: string;
+    category: string;
+    pageSize?: number;
+    staleTime?: number;
+    emptyText?: string;
+    renderError: (state: NotificationListErrorState) => ReactNode;
+    title?: ReactNode;
+    renderRowAction?: (notification: NotificationHistoryItem, actions: NotificationRowActions) => ReactNode;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/react/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/react/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACrB,eAAe,EACf,uBAAuB,EACvB,0BAA0B,EAC1B,sBAAsB,EACtB,wBAAwB,EACzB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,wBAAwB,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,qBAAqB,CAAC;IACjC,mBAAmB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAC5E,qBAAqB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACzE,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,IAAI,CAAC;IACpD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,SAAS,CAAC;IAC9D,oBAAoB,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,eAAe,EAAE,KAAK,IAAI,CAAC;IAClE,eAAe,CAAC,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,OAAO,EAAE,sBAAsB,KAAK,SAAS,CAAC;CACjG;AAED,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,wBAAwB,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,SAAS,CAAC;IAC9D,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,eAAe,CAAC,EAAE,CAChB,YAAY,EAAE,uBAAuB,EACrC,OAAO,EAAE,sBAAsB,KAC5B,SAAS,CAAC;CAChB"}

package/dist/react/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/react/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/react/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { ReactNode } from 'react';\nimport type {\n  ArchiveAllJobSnapshot,\n  ArchiveAllPollResult,\n  EnqueueArchiveAllResult,\n  NotificationArchiveFn,\n  NotificationDoc,\n  NotificationHistoryItem,\n  NotificationListErrorState,\n  NotificationRowActions,\n  NotificationSystemConfig,\n} from '../types.js';\n\nexport interface NotificationListProps {\n  config: NotificationSystemConfig;\n  userId: string;\n  category: string;\n  archiveFn: NotificationArchiveFn;\n  enqueueArchiveAllFn: (category: string) => Promise<EnqueueArchiveAllResult>;\n  getArchiveAllStatusFn: (jobId: string) => Promise<ArchiveAllJobSnapshot>;\n  title?: ReactNode;\n  onClearAll?: (result: ArchiveAllPollResult) => void;\n  refetchInterval?: number;\n  staleTime?: number;\n  emptyText?: string;\n  renderError: (state: NotificationListErrorState) => ReactNode;\n  onRenderedRowsChange?: (rows: readonly NotificationDoc[]) => void;\n  renderRowAction?: (notification: NotificationDoc, actions: NotificationRowActions) => ReactNode;\n}\n\nexport interface NotificationHistoryListProps {\n  config: NotificationSystemConfig;\n  userId: string;\n  category: string;\n  pageSize?: number;\n  staleTime?: number;\n  emptyText?: string;\n  renderError: (state: NotificationListErrorState) => ReactNode;\n  title?: ReactNode;\n  renderRowAction?: (\n    notification: NotificationHistoryItem,\n    actions: NotificationRowActions,\n  ) => ReactNode;\n}\n"]}

package/dist/schemas.d.ts

@@ -1,23 +1,4 @@
-/**
- * @ttt-productions/notification-core — Zod schemas
- *
- * Runtime validation schemas for the generic notification document shapes whose
- * TypeScript types live in `./types.ts`. notification-core OWNS these shapes, so
- * it owns their schemas too — the consuming app's data package composes these rather than hand-mirroring them, so the schema can never drift
- * from the type.
- *
- * The interfaces in `./types.ts` remain the documented public type API. Each
- * schema is compile-time-checked against its interface via
- * `satisfies z.ZodType<Shape>` — a shape drift between the interface and the
- * schema fails the build here.
- *
- * zod-only, no React/firebase: safe for both server (Cloud Functions) and UI.
- */
 import { z } from 'zod';
-/**
- * Active notification document (`NotificationDoc`). Same shape for both the user
- * and admin active collections.
- */
 export declare const NotificationDocSchema: z.ZodObject<{
     id: z.ZodString;
     type: z.ZodString;
@@ -36,9 +17,6 @@ export declare const NotificationDocSchema: z.ZodObject<{
     createdAt: z.ZodNumber;
     updatedAt: z.ZodNumber;
 }, z.core.$strip>;
-/**
- * Pending notification (`PendingNotification`) — queue item for the batch processor.
- */
 export declare const PendingNotificationSchema: z.ZodObject<{
     id: z.ZodString;
     type: z.ZodString;

package/dist/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;iBAoBK,CAAC;AAExC;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;iBAQK,CAAC"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;iBAiBK,CAAC;AAExC,eAAO,MAAM,yBAAyB;;;;;;;;iBAQK,CAAC"}