@ttt-productions/notification-core 0.15.16 → 0.15.17

package/dist/react/index.js

@@ -1,6 +1,13 @@
-"use client";
+'use client';
 // Hooks
-export { useActiveNotifications, useNotificationHistory, useUnreadCount, useArchiveNotification, useArchiveAllNotifications, } from './hooks/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';
 // Components
-export { NotificationList, NotificationHistoryList, NotificationEmptyState, NotificationUnreadBadge, } from './components/index.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,QAAQ;AACR,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,aAAa;AACb,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\n// Hooks\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\n// Components\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,72 @@
+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;
+    /**
+     * Archives one rendered notification. Passed straight through to
+     * `useArchiveNotification`; the app wires it to its callable.
+     */
+    archiveFn: NotificationArchiveFn;
+    /**
+     * Adapter that ENQUEUES one server-owned archive-all job scoped to `category` and returns its
+     * `jobId`. Passed straight through to `useArchiveAllNotifications`; the app wires it to its
+     * enqueue callable. Per-tab scoping: the category flows through to the job.
+     */
+    enqueueArchiveAllFn: (category: string) => Promise<EnqueueArchiveAllResult>;
+    /**
+     * Adapter that returns the current status snapshot for an archive-all `jobId`. Passed straight
+     * through to `useArchiveAllNotifications`, which polls it until the job is terminal; the app wires
+     * it to its status callable / job-doc read.
+     */
+    getArchiveAllStatusFn: (jobId: string) => Promise<ArchiveAllJobSnapshot>;
+    /** Left-aligned title for the active-list header. */
+    title?: ReactNode;
+    /**
+     * Fires with the terminal result ONLY when the archive-all job completed — the whole category was
+     * walked. A complete result can still carry `notArchived > 0` (cards that each failed and stay in
+     * the list); the copy for that is the app's.
+     */
+    onClearAll?: (result: ArchiveAllPollResult) => void;
+    /** Re-read the displayed page every `refetchInterval` ms while mounted (default 30s). */
+    refetchInterval?: number;
+    /** How long a read page counts as fresh, in ms (default 30s). */
+    staleTime?: number;
+    /** Empty-state text, shown only for an answered, empty first page. */
+    emptyText?: string;
+    /** The failed-read state, shown before (never instead of) the pager. Copy is the app's. */
+    renderError: (state: NotificationListErrorState) => ReactNode;
+    /**
+     * Called with the rows on screen each time the displayed page's answered rows change
+     * (not while a page is loading or failed with nothing shown) — the rows to mark seen.
+     */
+    onRenderedRowsChange?: (rows: readonly NotificationDoc[]) => void;
+    /**
+     * Per-row control slot. The row itself is inert; the consumer renders the row's
+     * controls here — typically an ArrowRight "go to" (which may call `actions.archive`
+     * then navigate) plus a clear/archive button (calls `actions.archive`). Omit to render
+     * a row with no controls.
+     */
+    renderRowAction?: (notification: NotificationDoc, actions: NotificationRowActions) => ReactNode;
+}
+export interface NotificationHistoryListProps {
+    config: NotificationSystemConfig;
+    userId: string;
+    category: string;
+    pageSize?: number;
+    staleTime?: number;
+    /** Empty-state text, shown only for an answered, empty first page. */
+    emptyText?: string;
+    /** The failed-read state, shown before (never instead of) the pager. Copy is the app's. */
+    renderError: (state: NotificationListErrorState) => ReactNode;
+    /** Left-aligned title for the read-only archived-list header. */
+    title?: ReactNode;
+    /**
+     * Per-row control slot for archived rows. The row is inert; archived rows are
+     * read-only (no re-archive), so `actions.archive` is absent — the consumer
+     * typically renders only an ArrowRight "go to". Omit for a row with no controls.
+     */
+    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;;;OAGG;IACH,SAAS,EAAE,qBAAqB,CAAC;IACjC;;;;OAIG;IACH,mBAAmB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAC5E;;;;OAIG;IACH,qBAAqB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACzE,qDAAqD;IACrD,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,IAAI,CAAC;IACpD,yFAAyF;IACzF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2FAA2F;IAC3F,WAAW,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,SAAS,CAAC;IAC9D;;;OAGG;IACH,oBAAoB,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,eAAe,EAAE,KAAK,IAAI,CAAC;IAClE;;;;;OAKG;IACH,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,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2FAA2F;IAC3F,WAAW,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,SAAS,CAAC;IAC9D,iEAAiE;IACjE,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;;OAIG;IACH,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  /**\n   * Archives one rendered notification. Passed straight through to\n   * `useArchiveNotification`; the app wires it to its callable.\n   */\n  archiveFn: NotificationArchiveFn;\n  /**\n   * Adapter that ENQUEUES one server-owned archive-all job scoped to `category` and returns its\n   * `jobId`. Passed straight through to `useArchiveAllNotifications`; the app wires it to its\n   * enqueue callable. Per-tab scoping: the category flows through to the job.\n   */\n  enqueueArchiveAllFn: (category: string) => Promise<EnqueueArchiveAllResult>;\n  /**\n   * Adapter that returns the current status snapshot for an archive-all `jobId`. Passed straight\n   * through to `useArchiveAllNotifications`, which polls it until the job is terminal; the app wires\n   * it to its status callable / job-doc read.\n   */\n  getArchiveAllStatusFn: (jobId: string) => Promise<ArchiveAllJobSnapshot>;\n  /** Left-aligned title for the active-list header. */\n  title?: ReactNode;\n  /**\n   * Fires with the terminal result ONLY when the archive-all job completed — the whole category was\n   * walked. A complete result can still carry `notArchived > 0` (cards that each failed and stay in\n   * the list); the copy for that is the app's.\n   */\n  onClearAll?: (result: ArchiveAllPollResult) => void;\n  /** Re-read the displayed page every `refetchInterval` ms while mounted (default 30s). */\n  refetchInterval?: number;\n  /** How long a read page counts as fresh, in ms (default 30s). */\n  staleTime?: number;\n  /** Empty-state text, shown only for an answered, empty first page. */\n  emptyText?: string;\n  /** The failed-read state, shown before (never instead of) the pager. Copy is the app's. */\n  renderError: (state: NotificationListErrorState) => ReactNode;\n  /**\n   * Called with the rows on screen each time the displayed page's answered rows change\n   * (not while a page is loading or failed with nothing shown) — the rows to mark seen.\n   */\n  onRenderedRowsChange?: (rows: readonly NotificationDoc[]) => void;\n  /**\n   * Per-row control slot. The row itself is inert; the consumer renders the row's\n   * controls here — typically an ArrowRight \"go to\" (which may call `actions.archive`\n   * then navigate) plus a clear/archive button (calls `actions.archive`). Omit to render\n   * a row with no controls.\n   */\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  /** Empty-state text, shown only for an answered, empty first page. */\n  emptyText?: string;\n  /** The failed-read state, shown before (never instead of) the pager. Copy is the app's. */\n  renderError: (state: NotificationListErrorState) => ReactNode;\n  /** Left-aligned title for the read-only archived-list header. */\n  title?: ReactNode;\n  /**\n   * Per-row control slot for archived rows. The row is inert; archived rows are\n   * read-only (no re-archive), so `actions.archive` is absent — the consumer\n   * typically renders only an ArrowRight \"go to\". Omit for a row with no controls.\n   */\n  renderRowAction?: (\n    notification: NotificationHistoryItem,\n    actions: NotificationRowActions,\n  ) => ReactNode;\n}\n"]}

package/dist/server/delivery-ledger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delivery-ledger.d.ts","sourceRoot":"","sources":["../../src/server/delivery-ledger.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"delivery-ledger.d.ts","sourceRoot":"","sources":["../../src/server/delivery-ledger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,OAAO,KAAK,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAgB,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAWnF;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,cAAc,GAAG,SAAS,GAAG,YAAY,CAAC;AAEjF,+CAA+C;AAC/C,MAAM,MAAM,kBAAkB,GAAG,qBAAqB,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;;OAMG;IACH,mBAAmB,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE,iBAAiB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACxF;AACD,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG,eAAe,CAAC;AAChE,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG,kBAAkB,GAAG,cAAc,GAAG,OAAO,CAAC;AAElG,iEAAiE;AACjE,MAAM,WAAW,eAAe;IAC9B,uFAAuF;IACvF,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,kFAAkF;AAClF,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,6FAA6F;IAC7F,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,OAAO,EAAE,eAAe,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB,EAAE,oBAAoB,CAAC;CAC5C;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,SAAS,CAAA;CAAE,GAC1C;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,GAC5C;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAE9D,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,4GAA4G;IAC5G,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,MAAM,kBAAkB,GAC1B,cAAc,GACd,sBAAsB,GACtB,8BAA8B,GAC9B,SAAS,GACT,oBAAoB,CAAC;AAEzB,MAAM,WAAW,sBAAsB;IACrC,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;CACjG;AAED,sGAAsG;AACtG,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,SAAS,GAAG,mBAAmB,CAAC;AAEzE,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/D;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,IAAI,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1D,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC7D;;;;OAIG;IACH,eAAe,CACb,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/C,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,mGAAmG;IACnG,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC7E;AAcD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,QAAQ,EAAE,IAAI,CAAC,eAAe,EAAE,OAAO,GAAG,gBAAgB,CAAC,GAAG,IAAI,CAAC;IACnE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG;IACF,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB,CAkBA;AAED,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,eAAe,EACnB,MAAM,EAAE,wBAAwB,EAChC,OAAO,EAAE,qBAAqB,GAC7B,cAAc,CAgUhB"}

package/dist/server/delivery-ledger.js

@@ -59,9 +59,7 @@ export function applyAggregation(params) {
         ? [actorId, ...prevActors.filter((id) => id !== actorId)].slice(0, actorCap)
         : prevActors.slice(0, actorCap);
     // staticRelight never shows a count (stays 1); increment counts up to the cap.
-    const count = strategy === 'staticRelight'
-        ? 1
-        : Math.min((existing?.count ?? 0) + 1, countCap);
+    const count = strategy === 'staticRelight' ? 1 : Math.min((existing?.count ?? 0) + 1, countCap);
     return {
         count,
         latestActorIds,
@@ -164,7 +162,11 @@ export function createDeliveryLedger(db, config, options) {
                 return 'skipped-ineligible-recipient';
             }
             const strategy = d.strategy ?? 'increment';
-            const payload = d.payload ?? { actorId: '', metadata: {}, occurrenceAt: Date.now() };
+            const payload = d.payload ?? {
+                actorId: '',
+                metadata: {},
+                occurrenceAt: Date.now(),
+            };
             const { typeConfig, categoryConfig } = getTypeConfig(notificationType);
             const activeRef = db.collection(categoryConfig.activePath).doc(buildActiveNotificationDocId({
                 category: typeConfig.category,

package/dist/server/delivery-ledger.js.map

@@ -1 +1 @@
-{"version":3,"file":"delivery-ledger.js","sourceRoot":"","sources":["../../src/server/delivery-ledger.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Generic notification delivery ledger (notification redesign — P1).\n *\n * One Firestore doc per (recipient|shared, type, occurrence) is BOTH the queue\n * row AND the idempotency ledger. This package owns the GENERIC mechanism;\n * the consuming app owns the concrete collection name, the deterministic\n * `deliveryId`/`eventId`/`aggregationKey` construction, and the worker that\n * selects rows per `materializationClass`. The app passes fully-formed\n * `DeliveryRowInput`s; this module never invents domain ids.\n *\n * Key invariants (FROZEN — this module is their single source; the consuming app's\n * notification design doc explains the product rationale):\n *  - Enqueue = create-if-absent. `ALREADY_EXISTS` is a per-row duplicate no-op,\n *    never a failure — there is no marker-without-payload state, so the\n *    \"marker created, payload lost\" crash window cannot exist.\n *  - Materialize = ONE transaction that reads the delivery row + active card,\n *    applies the aggregation exactly once (per strategy + caps), rotates the\n *    opaque `activityGeneration`, resets `seenAt`, and flips the row to\n *    `materialized` — so the \"applied but not marked\" double-apply window is gone.\n *    Retrying a `materialized` row is a successful no-op.\n *  - The same transaction asks the app whether the recipient may still receive\n *    (`options.isRecipientEligible`); an ineligible recipient gets no card and the\n *    row turns terminal `skipped`, so a row queued before (or retried after) the\n *    recipient became ineligible can never recreate a card. Re-running it is a no-op.\n *  - TTL (`expireAt`, a real Firestore Timestamp via `config.timestampFromMillis`)\n *    is set ONLY at `materialized` / `skipped`; a `queued` or `deadLetter` row is NEVER TTL'd\n *    so an unresolved delivery can't be silently deleted before replay.\n */\n\nimport { randomUUID } from 'node:crypto';\nimport type { NotificationSystemConfig, NotificationDoc } from '../types.js';\nimport type { ServerFirestore, ServerDocRef, ServerTransaction } from './types.js';\nimport { buildActiveNotificationDocId } from './activeNotificationId.js';\n\nconst DEFAULT_DELIVERIES_PATH = 'notificationDeliveries';\nconst DEFAULT_DELIVERY_TTL_MS = 90 * 24 * 60 * 60 * 1000; // 90 days\nconst DEFAULT_MAX_ATTEMPTS = 8;\nconst DEFAULT_COUNT_CAP = 5000;\nconst DEFAULT_ACTOR_CAP = 5;\nconst BACKOFF_BASE_MS = 60 * 1000; // 1 min\nconst BACKOFF_MAX_MS = 60 * 60 * 1000; // 1 hour\n\n/**\n * `skipped` is terminal: the recipient was not eligible when the row was materialized, so no card\n * was written. It is TTL'd like `materialized` and never retried.\n */\nexport type DeliveryState = 'queued' | 'materialized' | 'skipped' | 'deadLetter';\n\n/** Why a row was terminalized as `skipped`. */\nexport type DeliverySkipReason = 'recipientIneligible';\n\n/**\n * Ledger options the consuming app must decide.\n */\nexport interface DeliveryLedgerOptions {\n  /**\n   * Whether `recipientUid` may still receive a notification. Called INSIDE the materialize\n   * transaction, after the delivery row is read and before anything is written, so the answer\n   * and the card write commit together (BACKEND-116): read through `tx` only. A recipient that\n   * answers false gets no card, and the row becomes `skipped`. Not called for a shared\n   * (recipient-less) row. A consumer with no eligibility rule answers true.\n   */\n  isRecipientEligible: (recipientUid: string, tx: ServerTransaction) => Promise<boolean>;\n}\nexport type AggregationStrategy = 'increment' | 'staticRelight';\nexport type MaterializationClass =\n  | 'directQueued'\n  | 'realtimeFallback'\n  | 'fanoutOrphan'\n  | 'retry';\n\n/** The materialization payload carried on every delivery row. */\nexport interface DeliveryPayload {\n  /** The acting user's uid, or `null`/`''` for a system / no-actor occurrence (N-M2). */\n  actorId: string | null;\n  metadata: Record<string, unknown>;\n  occurrenceAt: number;\n}\n\n/** App-supplied, fully-formed delivery row (the app owns all id construction). */\nexport interface DeliveryRowInput {\n  deliveryId: string;\n  notificationType: string;\n  eventId: string;\n  /** `null` for shared-admin occurrences (the deliveryId hash uses the literal `'shared'`). */\n  recipientUid: string | null;\n  aggregationKey: string;\n  strategy: AggregationStrategy;\n  payload: DeliveryPayload;\n  payloadVersion: number;\n  materializationClass: MaterializationClass;\n}\n\nexport type EnqueueRowResult =\n  | { deliveryId: string; outcome: 'created' }\n  | { deliveryId: string; outcome: 'duplicate' }\n  | { deliveryId: string; outcome: 'failed'; error: unknown };\n\nexport interface EnqueueResult {\n  results: EnqueueRowResult[];\n  /** True iff EVERY row is now represented by a created-or-pre-existing doc (page-cursor invariant input). */\n  allResolved: boolean;\n}\n\nexport type MaterializeOutcome =\n  | 'materialized'\n  | 'already-materialized'\n  | 'skipped-ineligible-recipient'\n  | 'missing'\n  | 'skipped-non-queued';\n\nexport interface MaterializeManyOptions {\n  /** Rows materialized at once (default 10). */\n  concurrency?: number;\n  /**\n   * Called for a row whose materialize threw and whose failure could not then be recorded either —\n   * `error` is the recording's own failure and `details.cause` the materialize failure it was\n   * recording. The row stays as it was (queued, attempt count\n   * unchanged), so a later run selects it again; the rest of the batch proceeds. The app's capture\n   * goes here; without it the ledger writes the failure to `console.error`.\n   */\n  onUnrecordedFailure?: (deliveryId: string, error: unknown, details: { cause: unknown }) => void;\n}\n\n/** What a `replay` did: re-queued the row, found no row, or found a row that is not dead-lettered. */\nexport type ReplayOutcome = 'replayed' | 'missing' | 'not-dead-lettered';\n\nexport interface ReplayOptions {\n  /**\n   * The caller's own write (its audit event), composed into the replay transaction and awaited\n   * there on the `replayed` path only. A hook that throws or rejects fails the replay, so the\n   * reset never commits without it.\n   */\n  auditWrite?: (txn: ServerTransaction) => void | Promise<void>;\n}\n\nexport interface DeliveryLedger {\n  enqueue(rows: DeliveryRowInput[]): Promise<EnqueueResult>;\n  materialize(deliveryId: string): Promise<MaterializeOutcome>;\n  /**\n   * Materialize many rows with bounded concurrency. A row whose materialize throws has the failure\n   * recorded (a retry or a dead letter); each row is isolated, so one row's failure — even one\n   * whose recording also fails — never fails the batch or stops the rows behind it.\n   */\n  materializeMany(deliveryIds: string[], options?: MaterializeManyOptions): Promise<Record<MaterializeOutcome, number>>;\n  recordTransientFailure(deliveryId: string, error: unknown): Promise<void>;\n  deadLetter(deliveryId: string, error: unknown): Promise<void>;\n  /** Re-queue a dead-lettered row. A missing or non-dead-lettered row is answered, never written. */\n  replay(deliveryId: string, options?: ReplayOptions): Promise<ReplayOutcome>;\n}\n\n/** gRPC ALREADY_EXISTS (6) — the create-if-absent duplicate signal. */\nfunction isAlreadyExists(error: unknown): boolean {\n  const e = error as { code?: number; message?: string } | undefined;\n  return e?.code === 6 || /already.?exists/i.test(e?.message ?? '');\n}\n\nfunction backoffMs(attemptCount: number): number {\n  const exp = Math.min(BACKOFF_BASE_MS * 2 ** Math.max(0, attemptCount - 1), BACKOFF_MAX_MS);\n  // Full jitter — spread retries so a burst of failures doesn't synchronize.\n  return Math.floor(exp / 2 + Math.random() * (exp / 2));\n}\n\n/**\n * Apply the aggregation strategy to produce the active-doc field delta.\n * PURE — exported for direct unit testing. `existing` is the current active doc\n * (or null to create). Always rotates `activityGeneration` and resets `seenAt`.\n */\nexport function applyAggregation(params: {\n  strategy: AggregationStrategy;\n  existing: Pick<NotificationDoc, 'count' | 'latestActorIds'> | null;\n  actorId: string | null;\n  countCap: number;\n  actorCap: number;\n  buildMessage: (count: number) => string;\n  now: number;\n  generation: string;\n}): { count: number; latestActorIds: string[]; message: string; activityGeneration: string; seenAt: number; updatedAt: number } {\n  const { strategy, existing, actorId, countCap, actorCap, buildMessage, now, generation } = params;\n  const prevActors = existing?.latestActorIds ?? [];\n  // N-M2: a system / no-actor occurrence (null or '') is never injected into the actor\n  // list — it would render as a blank avatar / unresolvable uid in `latestActorIds`.\n  const latestActorIds = actorId\n    ? [actorId, ...prevActors.filter((id) => id !== actorId)].slice(0, actorCap)\n    : prevActors.slice(0, actorCap);\n  // staticRelight never shows a count (stays 1); increment counts up to the cap.\n  const count =\n    strategy === 'staticRelight'\n      ? 1\n      : Math.min((existing?.count ?? 0) + 1, countCap);\n  return {\n    count,\n    latestActorIds,\n    message: buildMessage(count),\n    activityGeneration: generation,\n    seenAt: 0,\n    updatedAt: now,\n  };\n}\n\nexport function createDeliveryLedger(\n  db: ServerFirestore,\n  config: NotificationSystemConfig,\n  options: DeliveryLedgerOptions,\n): DeliveryLedger {\n  const { isRecipientEligible } = options;\n  const deliveriesPath = config.deliveriesCollectionPath ?? DEFAULT_DELIVERIES_PATH;\n  const ttlMs = config.deliveryTtlMs ?? DEFAULT_DELIVERY_TTL_MS;\n  const maxAttempts = config.maxDeliveryAttempts ?? DEFAULT_MAX_ATTEMPTS;\n  const configTimestampFromMillis = config.timestampFromMillis;\n  if (!configTimestampFromMillis) {\n    throw new Error(\n      '[notification-core] createDeliveryLedger requires config.timestampFromMillis (Firestore TTL needs a real Timestamp for expireAt).',\n    );\n  }\n  // Bind to an explicitly non-optional type so the nested transaction closures\n  // (called later) see it as defined, not `... | undefined`.\n  const toTimestamp: (ms: number) => unknown = configTimestampFromMillis;\n\n  const deliveries = db.collection(deliveriesPath);\n\n  function deliveryRef(deliveryId: string): ServerDocRef {\n    return deliveries.doc(deliveryId);\n  }\n\n  function buildDeliveryDoc(row: DeliveryRowInput, now: number): Record<string, unknown> {\n    return {\n      deliveryId: row.deliveryId,\n      state: 'queued' as DeliveryState,\n      notificationType: row.notificationType,\n      eventId: row.eventId,\n      recipientUid: row.recipientUid,\n      aggregationKey: row.aggregationKey,\n      strategy: row.strategy,\n      payload: row.payload,\n      payloadVersion: row.payloadVersion,\n      materializationClass: row.materializationClass,\n      attemptCount: 0,\n      nextAttemptAt: now,\n      lastError: null,\n      createdAt: now,\n      materializedAt: null,\n      deadLetteredAt: null,\n      // No expireAt while queued.\n    };\n  }\n\n  function getTypeConfig(type: string) {\n    const typeConfig = config.types[type];\n    if (!typeConfig) throw new Error(`[notification-core] Unknown notification type: ${type}`);\n    const categoryConfig = config.categories[typeConfig.category];\n    if (!categoryConfig) throw new Error(`[notification-core] Unknown category: ${typeConfig.category}`);\n    return { typeConfig, categoryConfig };\n  }\n\n  async function enqueue(rows: DeliveryRowInput[]): Promise<EnqueueResult> {\n    if (rows.length === 0) return { results: [], allResolved: true };\n    const now = Date.now();\n    const settled = await Promise.allSettled(\n      rows.map((row) =>\n        deliveryRef(row.deliveryId)\n          .create(buildDeliveryDoc(row, now))\n          .then(() => ({ deliveryId: row.deliveryId, outcome: 'created' as const })),\n      ),\n    );\n    const results: EnqueueRowResult[] = settled.map((s, i) => {\n      const deliveryId = rows[i].deliveryId;\n      if (s.status === 'fulfilled') return s.value;\n      if (isAlreadyExists(s.reason)) return { deliveryId, outcome: 'duplicate' };\n      return { deliveryId, outcome: 'failed', error: s.reason };\n    });\n    return { results, allResolved: results.every((r) => r.outcome !== 'failed') };\n  }\n\n  async function materialize(deliveryId: string): Promise<MaterializeOutcome> {\n    return db.runTransaction(async (tx) => {\n      const dRef = deliveryRef(deliveryId);\n      const dSnap = await tx.get(dRef);\n      if (!dSnap.exists) return 'missing';\n      const d = (dSnap.data() ?? {}) as Record<string, unknown>;\n      const state = d.state as DeliveryState;\n      if (state === 'materialized') return 'already-materialized';\n      if (state === 'skipped') return 'skipped-ineligible-recipient';\n      if (state !== 'queued') return 'skipped-non-queued';\n\n      const notificationType = d.notificationType as string;\n      const aggregationKey = d.aggregationKey as string;\n      const recipientUid = (d.recipientUid as string | null) ?? null;\n\n      // The recipient is checked in this transaction, so a recipient that became ineligible\n      // (e.g. an erased account) never gets a card from a row queued before, or retried after.\n      if (recipientUid !== null && !(await isRecipientEligible(recipientUid, tx))) {\n        const skippedAt = Date.now();\n        tx.update(dRef, {\n          state: 'skipped' as DeliveryState,\n          skipReason: 'recipientIneligible' as DeliverySkipReason,\n          skippedAt,\n          expireAt: toTimestamp(skippedAt + ttlMs),\n        });\n        return 'skipped-ineligible-recipient';\n      }\n      const strategy = (d.strategy as AggregationStrategy) ?? 'increment';\n      const payload = (d.payload as DeliveryPayload) ?? { actorId: '', metadata: {}, occurrenceAt: Date.now() };\n      const { typeConfig, categoryConfig } = getTypeConfig(notificationType);\n\n      const activeRef = db.collection(categoryConfig.activePath).doc(\n        buildActiveNotificationDocId({\n          category: typeConfig.category,\n          audienceType: categoryConfig.audienceType,\n          targetUserId: recipientUid,\n          dedupKey: aggregationKey,\n          notificationType,\n        }),\n      );\n      const activeSnap = await tx.get(activeRef); // all reads before writes\n\n      const now = Date.now();\n      const generation = randomUUID();\n      const countCap = typeConfig.countCap ?? DEFAULT_COUNT_CAP;\n      const actorCap = typeConfig.actorCap ?? DEFAULT_ACTOR_CAP;\n      const buildMessage = (count: number) => typeConfig.messagePattern(payload.metadata, count);\n      // Latest-occurrence-derived fields — recomputed every materialize so an EXISTING\n      // aggregate card reflects the newest activity (title/targetPath/metadata), not the\n      // first occurrence's stale values (N-I4).\n      const title = typeConfig.titlePattern(payload.metadata);\n      // A type with no defaultTargetPath is linkless: the doc must OMIT the field\n      // entirely (Firestore rejects `undefined` values). A pre-existing doc written\n      // before a type went linkless keeps its stale targetPath until archived.\n      const targetPath =\n        typeConfig.defaultTargetPath === undefined\n          ? undefined\n          : typeof typeConfig.defaultTargetPath === 'function'\n            ? typeConfig.defaultTargetPath(payload.metadata)\n            : typeConfig.defaultTargetPath;\n      const targetPathField = targetPath === undefined ? {} : { targetPath };\n\n      if (activeSnap.exists) {\n        const existing = (activeSnap.data() ?? {}) as Pick<NotificationDoc, 'count' | 'latestActorIds'>;\n        const delta = applyAggregation({\n          strategy,\n          existing,\n          actorId: payload.actorId,\n          countCap,\n          actorCap,\n          buildMessage,\n          now,\n          generation,\n        });\n        tx.update(activeRef, { ...delta, title, ...targetPathField, metadata: payload.metadata });\n      } else {\n        const delta = applyAggregation({\n          strategy,\n          existing: null,\n          actorId: payload.actorId,\n          countCap,\n          actorCap,\n          buildMessage,\n          now,\n          generation,\n        });\n        const newDoc: Omit<NotificationDoc, 'id'> = {\n          type: notificationType,\n          dedupKey: aggregationKey,\n          category: typeConfig.category,\n          targetUserId: recipientUid,\n          title,\n          message: delta.message,\n          count: delta.count,\n          latestActorIds: delta.latestActorIds,\n          ...targetPathField,\n          metadata: payload.metadata,\n          seenAt: 0,\n          activityGeneration: generation,\n          createdAt: now,\n          updatedAt: now,\n        };\n        tx.set(activeRef, newDoc as Record<string, unknown>);\n      }\n\n      tx.update(dRef, {\n        state: 'materialized' as DeliveryState,\n        materializedAt: now,\n        expireAt: toTimestamp(now + ttlMs),\n      });\n      return 'materialized';\n    });\n  }\n\n  async function recordTransientFailure(deliveryId: string, error: unknown): Promise<void> {\n    await db.runTransaction(async (tx) => {\n      const dRef = deliveryRef(deliveryId);\n      const dSnap = await tx.get(dRef);\n      if (!dSnap.exists) return;\n      const d = (dSnap.data() ?? {}) as Record<string, unknown>;\n      if ((d.state as DeliveryState) !== 'queued') return;\n      const attemptCount = ((d.attemptCount as number) ?? 0) + 1;\n      const now = Date.now();\n      const message = error instanceof Error ? error.message : String(error);\n      if (attemptCount >= maxAttempts) {\n        tx.update(dRef, {\n          state: 'deadLetter' as DeliveryState,\n          attemptCount,\n          lastError: message,\n          deadLetteredAt: now,\n        });\n      } else {\n        // n1: re-stamp the row into the reserved `retry` materialization lane on backoff. Without\n        // this the row keeps its original class and competes for that lane's capacity while backed\n        // off; the worker's reserved `retry` slice (separate CLASS_CAPS capacity, drained in\n        // DRAIN_ORDER) would always select 0 rows. Re-stamping moves a backed-off row into the\n        // anti-starvation lane so it drains there instead of starving in its original lane.\n        tx.update(dRef, {\n          attemptCount,\n          nextAttemptAt: now + backoffMs(attemptCount),\n          lastError: message,\n          materializationClass: 'retry' as MaterializationClass,\n        });\n      }\n    });\n  }\n\n  async function deadLetter(deliveryId: string, error: unknown): Promise<void> {\n    await db.runTransaction(async (tx) => {\n      const dRef = deliveryRef(deliveryId);\n      const dSnap = await tx.get(dRef);\n      if (!dSnap.exists) return;\n      const d = (dSnap.data() ?? {}) as Record<string, unknown>;\n      if ((d.state as DeliveryState) !== 'queued') return;\n      tx.update(dRef, {\n        state: 'deadLetter' as DeliveryState,\n        attemptCount: ((d.attemptCount as number) ?? 0) + 1,\n        lastError: error instanceof Error ? error.message : String(error),\n        deadLetteredAt: Date.now(),\n      });\n    });\n  }\n\n  async function replay(deliveryId: string, options?: ReplayOptions): Promise<ReplayOutcome> {\n    return db.runTransaction(async (tx): Promise<ReplayOutcome> => {\n      const dRef = deliveryRef(deliveryId);\n      const dSnap = await tx.get(dRef);\n      if (!dSnap.exists) return 'missing';\n      const d = (dSnap.data() ?? {}) as Record<string, unknown>;\n      if ((d.state as DeliveryState) !== 'deadLetter') return 'not-dead-lettered';\n      tx.update(dRef, {\n        state: 'queued' as DeliveryState,\n        attemptCount: 0,\n        nextAttemptAt: Date.now(),\n        lastError: null,\n        deadLetteredAt: null,\n        expireAt: null, // clear any TTL set on a prior terminal\n      });\n      await options?.auditWrite?.(tx);\n      return 'replayed';\n    });\n  }\n\n  function reportUnrecordedFailure(\n    options: MaterializeManyOptions | undefined,\n    deliveryId: string,\n    error: unknown,\n    cause: unknown,\n  ): void {\n    try {\n      if (options?.onUnrecordedFailure) {\n        options.onUnrecordedFailure(deliveryId, error, { cause });\n        return;\n      }\n    } catch (handlerError) {\n      console.error('[notification-core] onUnrecordedFailure threw for delivery', deliveryId, handlerError);\n    }\n    console.error('[notification-core] A delivery failure could not be recorded', deliveryId, error, { cause });\n  }\n\n  async function materializeMany(\n    deliveryIds: string[],\n    options?: MaterializeManyOptions,\n  ): Promise<Record<MaterializeOutcome, number>> {\n    const concurrency = Math.max(1, options?.concurrency ?? 10);\n    const tally: Record<MaterializeOutcome, number> = {\n      materialized: 0,\n      'already-materialized': 0,\n      'skipped-ineligible-recipient': 0,\n      missing: 0,\n      'skipped-non-queued': 0,\n    };\n    let cursor = 0;\n    async function worker(): Promise<void> {\n      while (cursor < deliveryIds.length) {\n        const id = deliveryIds[cursor++];\n        try {\n          const outcome = await materialize(id);\n          tally[outcome] += 1;\n        } catch (error) {\n          try {\n            await recordTransientFailure(id, error);\n          } catch (recordError) {\n            reportUnrecordedFailure(options, id, recordError, error);\n          }\n        }\n      }\n    }\n    await Promise.all(Array.from({ length: Math.min(concurrency, deliveryIds.length) }, worker));\n    return tally;\n  }\n\n  return { enqueue, materialize, materializeMany, recordTransientFailure, deadLetter, replay };\n}\n"]}
+{"version":3,"file":"delivery-ledger.js","sourceRoot":"","sources":["../../src/server/delivery-ledger.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Generic notification delivery ledger (notification redesign — P1).\n *\n * One Firestore doc per (recipient|shared, type, occurrence) is BOTH the queue\n * row AND the idempotency ledger. This package owns the GENERIC mechanism;\n * the consuming app owns the concrete collection name, the deterministic\n * `deliveryId`/`eventId`/`aggregationKey` construction, and the worker that\n * selects rows per `materializationClass`. The app passes fully-formed\n * `DeliveryRowInput`s; this module never invents domain ids.\n *\n * Key invariants (FROZEN — this module is their single source; the consuming app's\n * notification design doc explains the product rationale):\n *  - Enqueue = create-if-absent. `ALREADY_EXISTS` is a per-row duplicate no-op,\n *    never a failure — there is no marker-without-payload state, so the\n *    \"marker created, payload lost\" crash window cannot exist.\n *  - Materialize = ONE transaction that reads the delivery row + active card,\n *    applies the aggregation exactly once (per strategy + caps), rotates the\n *    opaque `activityGeneration`, resets `seenAt`, and flips the row to\n *    `materialized` — so the \"applied but not marked\" double-apply window is gone.\n *    Retrying a `materialized` row is a successful no-op.\n *  - The same transaction asks the app whether the recipient may still receive\n *    (`options.isRecipientEligible`); an ineligible recipient gets no card and the\n *    row turns terminal `skipped`, so a row queued before (or retried after) the\n *    recipient became ineligible can never recreate a card. Re-running it is a no-op.\n *  - TTL (`expireAt`, a real Firestore Timestamp via `config.timestampFromMillis`)\n *    is set ONLY at `materialized` / `skipped`; a `queued` or `deadLetter` row is NEVER TTL'd\n *    so an unresolved delivery can't be silently deleted before replay.\n */\n\nimport { randomUUID } from 'node:crypto';\nimport type { NotificationSystemConfig, NotificationDoc } from '../types.js';\nimport type { ServerFirestore, ServerDocRef, ServerTransaction } from './types.js';\nimport { buildActiveNotificationDocId } from './activeNotificationId.js';\n\nconst DEFAULT_DELIVERIES_PATH = 'notificationDeliveries';\nconst DEFAULT_DELIVERY_TTL_MS = 90 * 24 * 60 * 60 * 1000; // 90 days\nconst DEFAULT_MAX_ATTEMPTS = 8;\nconst DEFAULT_COUNT_CAP = 5000;\nconst DEFAULT_ACTOR_CAP = 5;\nconst BACKOFF_BASE_MS = 60 * 1000; // 1 min\nconst BACKOFF_MAX_MS = 60 * 60 * 1000; // 1 hour\n\n/**\n * `skipped` is terminal: the recipient was not eligible when the row was materialized, so no card\n * was written. It is TTL'd like `materialized` and never retried.\n */\nexport type DeliveryState = 'queued' | 'materialized' | 'skipped' | 'deadLetter';\n\n/** Why a row was terminalized as `skipped`. */\nexport type DeliverySkipReason = 'recipientIneligible';\n\n/**\n * Ledger options the consuming app must decide.\n */\nexport interface DeliveryLedgerOptions {\n  /**\n   * Whether `recipientUid` may still receive a notification. Called INSIDE the materialize\n   * transaction, after the delivery row is read and before anything is written, so the answer\n   * and the card write commit together (BACKEND-116): read through `tx` only. A recipient that\n   * answers false gets no card, and the row becomes `skipped`. Not called for a shared\n   * (recipient-less) row. A consumer with no eligibility rule answers true.\n   */\n  isRecipientEligible: (recipientUid: string, tx: ServerTransaction) => Promise<boolean>;\n}\nexport type AggregationStrategy = 'increment' | 'staticRelight';\nexport type MaterializationClass = 'directQueued' | 'realtimeFallback' | 'fanoutOrphan' | 'retry';\n\n/** The materialization payload carried on every delivery row. */\nexport interface DeliveryPayload {\n  /** The acting user's uid, or `null`/`''` for a system / no-actor occurrence (N-M2). */\n  actorId: string | null;\n  metadata: Record<string, unknown>;\n  occurrenceAt: number;\n}\n\n/** App-supplied, fully-formed delivery row (the app owns all id construction). */\nexport interface DeliveryRowInput {\n  deliveryId: string;\n  notificationType: string;\n  eventId: string;\n  /** `null` for shared-admin occurrences (the deliveryId hash uses the literal `'shared'`). */\n  recipientUid: string | null;\n  aggregationKey: string;\n  strategy: AggregationStrategy;\n  payload: DeliveryPayload;\n  payloadVersion: number;\n  materializationClass: MaterializationClass;\n}\n\nexport type EnqueueRowResult =\n  | { deliveryId: string; outcome: 'created' }\n  | { deliveryId: string; outcome: 'duplicate' }\n  | { deliveryId: string; outcome: 'failed'; error: unknown };\n\nexport interface EnqueueResult {\n  results: EnqueueRowResult[];\n  /** True iff EVERY row is now represented by a created-or-pre-existing doc (page-cursor invariant input). */\n  allResolved: boolean;\n}\n\nexport type MaterializeOutcome =\n  | 'materialized'\n  | 'already-materialized'\n  | 'skipped-ineligible-recipient'\n  | 'missing'\n  | 'skipped-non-queued';\n\nexport interface MaterializeManyOptions {\n  /** Rows materialized at once (default 10). */\n  concurrency?: number;\n  /**\n   * Called for a row whose materialize threw and whose failure could not then be recorded either —\n   * `error` is the recording's own failure and `details.cause` the materialize failure it was\n   * recording. The row stays as it was (queued, attempt count\n   * unchanged), so a later run selects it again; the rest of the batch proceeds. The app's capture\n   * goes here; without it the ledger writes the failure to `console.error`.\n   */\n  onUnrecordedFailure?: (deliveryId: string, error: unknown, details: { cause: unknown }) => void;\n}\n\n/** What a `replay` did: re-queued the row, found no row, or found a row that is not dead-lettered. */\nexport type ReplayOutcome = 'replayed' | 'missing' | 'not-dead-lettered';\n\nexport interface ReplayOptions {\n  /**\n   * The caller's own write (its audit event), composed into the replay transaction and awaited\n   * there on the `replayed` path only. A hook that throws or rejects fails the replay, so the\n   * reset never commits without it.\n   */\n  auditWrite?: (txn: ServerTransaction) => void | Promise<void>;\n}\n\nexport interface DeliveryLedger {\n  enqueue(rows: DeliveryRowInput[]): Promise<EnqueueResult>;\n  materialize(deliveryId: string): Promise<MaterializeOutcome>;\n  /**\n   * Materialize many rows with bounded concurrency. A row whose materialize throws has the failure\n   * recorded (a retry or a dead letter); each row is isolated, so one row's failure — even one\n   * whose recording also fails — never fails the batch or stops the rows behind it.\n   */\n  materializeMany(\n    deliveryIds: string[],\n    options?: MaterializeManyOptions,\n  ): Promise<Record<MaterializeOutcome, number>>;\n  recordTransientFailure(deliveryId: string, error: unknown): Promise<void>;\n  deadLetter(deliveryId: string, error: unknown): Promise<void>;\n  /** Re-queue a dead-lettered row. A missing or non-dead-lettered row is answered, never written. */\n  replay(deliveryId: string, options?: ReplayOptions): Promise<ReplayOutcome>;\n}\n\n/** gRPC ALREADY_EXISTS (6) — the create-if-absent duplicate signal. */\nfunction isAlreadyExists(error: unknown): boolean {\n  const e = error as { code?: number; message?: string } | undefined;\n  return e?.code === 6 || /already.?exists/i.test(e?.message ?? '');\n}\n\nfunction backoffMs(attemptCount: number): number {\n  const exp = Math.min(BACKOFF_BASE_MS * 2 ** Math.max(0, attemptCount - 1), BACKOFF_MAX_MS);\n  // Full jitter — spread retries so a burst of failures doesn't synchronize.\n  return Math.floor(exp / 2 + Math.random() * (exp / 2));\n}\n\n/**\n * Apply the aggregation strategy to produce the active-doc field delta.\n * PURE — exported for direct unit testing. `existing` is the current active doc\n * (or null to create). Always rotates `activityGeneration` and resets `seenAt`.\n */\nexport function applyAggregation(params: {\n  strategy: AggregationStrategy;\n  existing: Pick<NotificationDoc, 'count' | 'latestActorIds'> | null;\n  actorId: string | null;\n  countCap: number;\n  actorCap: number;\n  buildMessage: (count: number) => string;\n  now: number;\n  generation: string;\n}): {\n  count: number;\n  latestActorIds: string[];\n  message: string;\n  activityGeneration: string;\n  seenAt: number;\n  updatedAt: number;\n} {\n  const { strategy, existing, actorId, countCap, actorCap, buildMessage, now, generation } = params;\n  const prevActors = existing?.latestActorIds ?? [];\n  // N-M2: a system / no-actor occurrence (null or '') is never injected into the actor\n  // list — it would render as a blank avatar / unresolvable uid in `latestActorIds`.\n  const latestActorIds = actorId\n    ? [actorId, ...prevActors.filter((id) => id !== actorId)].slice(0, actorCap)\n    : prevActors.slice(0, actorCap);\n  // staticRelight never shows a count (stays 1); increment counts up to the cap.\n  const count = strategy === 'staticRelight' ? 1 : Math.min((existing?.count ?? 0) + 1, countCap);\n  return {\n    count,\n    latestActorIds,\n    message: buildMessage(count),\n    activityGeneration: generation,\n    seenAt: 0,\n    updatedAt: now,\n  };\n}\n\nexport function createDeliveryLedger(\n  db: ServerFirestore,\n  config: NotificationSystemConfig,\n  options: DeliveryLedgerOptions,\n): DeliveryLedger {\n  const { isRecipientEligible } = options;\n  const deliveriesPath = config.deliveriesCollectionPath ?? DEFAULT_DELIVERIES_PATH;\n  const ttlMs = config.deliveryTtlMs ?? DEFAULT_DELIVERY_TTL_MS;\n  const maxAttempts = config.maxDeliveryAttempts ?? DEFAULT_MAX_ATTEMPTS;\n  const configTimestampFromMillis = config.timestampFromMillis;\n  if (!configTimestampFromMillis) {\n    throw new Error(\n      '[notification-core] createDeliveryLedger requires config.timestampFromMillis (Firestore TTL needs a real Timestamp for expireAt).',\n    );\n  }\n  // Bind to an explicitly non-optional type so the nested transaction closures\n  // (called later) see it as defined, not `... | undefined`.\n  const toTimestamp: (ms: number) => unknown = configTimestampFromMillis;\n\n  const deliveries = db.collection(deliveriesPath);\n\n  function deliveryRef(deliveryId: string): ServerDocRef {\n    return deliveries.doc(deliveryId);\n  }\n\n  function buildDeliveryDoc(row: DeliveryRowInput, now: number): Record<string, unknown> {\n    return {\n      deliveryId: row.deliveryId,\n      state: 'queued' as DeliveryState,\n      notificationType: row.notificationType,\n      eventId: row.eventId,\n      recipientUid: row.recipientUid,\n      aggregationKey: row.aggregationKey,\n      strategy: row.strategy,\n      payload: row.payload,\n      payloadVersion: row.payloadVersion,\n      materializationClass: row.materializationClass,\n      attemptCount: 0,\n      nextAttemptAt: now,\n      lastError: null,\n      createdAt: now,\n      materializedAt: null,\n      deadLetteredAt: null,\n      // No expireAt while queued.\n    };\n  }\n\n  function getTypeConfig(type: string) {\n    const typeConfig = config.types[type];\n    if (!typeConfig) throw new Error(`[notification-core] Unknown notification type: ${type}`);\n    const categoryConfig = config.categories[typeConfig.category];\n    if (!categoryConfig)\n      throw new Error(`[notification-core] Unknown category: ${typeConfig.category}`);\n    return { typeConfig, categoryConfig };\n  }\n\n  async function enqueue(rows: DeliveryRowInput[]): Promise<EnqueueResult> {\n    if (rows.length === 0) return { results: [], allResolved: true };\n    const now = Date.now();\n    const settled = await Promise.allSettled(\n      rows.map((row) =>\n        deliveryRef(row.deliveryId)\n          .create(buildDeliveryDoc(row, now))\n          .then(() => ({ deliveryId: row.deliveryId, outcome: 'created' as const })),\n      ),\n    );\n    const results: EnqueueRowResult[] = settled.map((s, i) => {\n      const deliveryId = rows[i].deliveryId;\n      if (s.status === 'fulfilled') return s.value;\n      if (isAlreadyExists(s.reason)) return { deliveryId, outcome: 'duplicate' };\n      return { deliveryId, outcome: 'failed', error: s.reason };\n    });\n    return { results, allResolved: results.every((r) => r.outcome !== 'failed') };\n  }\n\n  async function materialize(deliveryId: string): Promise<MaterializeOutcome> {\n    return db.runTransaction(async (tx) => {\n      const dRef = deliveryRef(deliveryId);\n      const dSnap = await tx.get(dRef);\n      if (!dSnap.exists) return 'missing';\n      const d = (dSnap.data() ?? {}) as Record<string, unknown>;\n      const state = d.state as DeliveryState;\n      if (state === 'materialized') return 'already-materialized';\n      if (state === 'skipped') return 'skipped-ineligible-recipient';\n      if (state !== 'queued') return 'skipped-non-queued';\n\n      const notificationType = d.notificationType as string;\n      const aggregationKey = d.aggregationKey as string;\n      const recipientUid = (d.recipientUid as string | null) ?? null;\n\n      // The recipient is checked in this transaction, so a recipient that became ineligible\n      // (e.g. an erased account) never gets a card from a row queued before, or retried after.\n      if (recipientUid !== null && !(await isRecipientEligible(recipientUid, tx))) {\n        const skippedAt = Date.now();\n        tx.update(dRef, {\n          state: 'skipped' as DeliveryState,\n          skipReason: 'recipientIneligible' as DeliverySkipReason,\n          skippedAt,\n          expireAt: toTimestamp(skippedAt + ttlMs),\n        });\n        return 'skipped-ineligible-recipient';\n      }\n      const strategy = (d.strategy as AggregationStrategy) ?? 'increment';\n      const payload = (d.payload as DeliveryPayload) ?? {\n        actorId: '',\n        metadata: {},\n        occurrenceAt: Date.now(),\n      };\n      const { typeConfig, categoryConfig } = getTypeConfig(notificationType);\n\n      const activeRef = db.collection(categoryConfig.activePath).doc(\n        buildActiveNotificationDocId({\n          category: typeConfig.category,\n          audienceType: categoryConfig.audienceType,\n          targetUserId: recipientUid,\n          dedupKey: aggregationKey,\n          notificationType,\n        }),\n      );\n      const activeSnap = await tx.get(activeRef); // all reads before writes\n\n      const now = Date.now();\n      const generation = randomUUID();\n      const countCap = typeConfig.countCap ?? DEFAULT_COUNT_CAP;\n      const actorCap = typeConfig.actorCap ?? DEFAULT_ACTOR_CAP;\n      const buildMessage = (count: number) => typeConfig.messagePattern(payload.metadata, count);\n      // Latest-occurrence-derived fields — recomputed every materialize so an EXISTING\n      // aggregate card reflects the newest activity (title/targetPath/metadata), not the\n      // first occurrence's stale values (N-I4).\n      const title = typeConfig.titlePattern(payload.metadata);\n      // A type with no defaultTargetPath is linkless: the doc must OMIT the field\n      // entirely (Firestore rejects `undefined` values). A pre-existing doc written\n      // before a type went linkless keeps its stale targetPath until archived.\n      const targetPath =\n        typeConfig.defaultTargetPath === undefined\n          ? undefined\n          : typeof typeConfig.defaultTargetPath === 'function'\n            ? typeConfig.defaultTargetPath(payload.metadata)\n            : typeConfig.defaultTargetPath;\n      const targetPathField = targetPath === undefined ? {} : { targetPath };\n\n      if (activeSnap.exists) {\n        const existing = (activeSnap.data() ?? {}) as Pick<\n          NotificationDoc,\n          'count' | 'latestActorIds'\n        >;\n        const delta = applyAggregation({\n          strategy,\n          existing,\n          actorId: payload.actorId,\n          countCap,\n          actorCap,\n          buildMessage,\n          now,\n          generation,\n        });\n        tx.update(activeRef, { ...delta, title, ...targetPathField, metadata: payload.metadata });\n      } else {\n        const delta = applyAggregation({\n          strategy,\n          existing: null,\n          actorId: payload.actorId,\n          countCap,\n          actorCap,\n          buildMessage,\n          now,\n          generation,\n        });\n        const newDoc: Omit<NotificationDoc, 'id'> = {\n          type: notificationType,\n          dedupKey: aggregationKey,\n          category: typeConfig.category,\n          targetUserId: recipientUid,\n          title,\n          message: delta.message,\n          count: delta.count,\n          latestActorIds: delta.latestActorIds,\n          ...targetPathField,\n          metadata: payload.metadata,\n          seenAt: 0,\n          activityGeneration: generation,\n          createdAt: now,\n          updatedAt: now,\n        };\n        tx.set(activeRef, newDoc as Record<string, unknown>);\n      }\n\n      tx.update(dRef, {\n        state: 'materialized' as DeliveryState,\n        materializedAt: now,\n        expireAt: toTimestamp(now + ttlMs),\n      });\n      return 'materialized';\n    });\n  }\n\n  async function recordTransientFailure(deliveryId: string, error: unknown): Promise<void> {\n    await db.runTransaction(async (tx) => {\n      const dRef = deliveryRef(deliveryId);\n      const dSnap = await tx.get(dRef);\n      if (!dSnap.exists) return;\n      const d = (dSnap.data() ?? {}) as Record<string, unknown>;\n      if ((d.state as DeliveryState) !== 'queued') return;\n      const attemptCount = ((d.attemptCount as number) ?? 0) + 1;\n      const now = Date.now();\n      const message = error instanceof Error ? error.message : String(error);\n      if (attemptCount >= maxAttempts) {\n        tx.update(dRef, {\n          state: 'deadLetter' as DeliveryState,\n          attemptCount,\n          lastError: message,\n          deadLetteredAt: now,\n        });\n      } else {\n        // n1: re-stamp the row into the reserved `retry` materialization lane on backoff. Without\n        // this the row keeps its original class and competes for that lane's capacity while backed\n        // off; the worker's reserved `retry` slice (separate CLASS_CAPS capacity, drained in\n        // DRAIN_ORDER) would always select 0 rows. Re-stamping moves a backed-off row into the\n        // anti-starvation lane so it drains there instead of starving in its original lane.\n        tx.update(dRef, {\n          attemptCount,\n          nextAttemptAt: now + backoffMs(attemptCount),\n          lastError: message,\n          materializationClass: 'retry' as MaterializationClass,\n        });\n      }\n    });\n  }\n\n  async function deadLetter(deliveryId: string, error: unknown): Promise<void> {\n    await db.runTransaction(async (tx) => {\n      const dRef = deliveryRef(deliveryId);\n      const dSnap = await tx.get(dRef);\n      if (!dSnap.exists) return;\n      const d = (dSnap.data() ?? {}) as Record<string, unknown>;\n      if ((d.state as DeliveryState) !== 'queued') return;\n      tx.update(dRef, {\n        state: 'deadLetter' as DeliveryState,\n        attemptCount: ((d.attemptCount as number) ?? 0) + 1,\n        lastError: error instanceof Error ? error.message : String(error),\n        deadLetteredAt: Date.now(),\n      });\n    });\n  }\n\n  async function replay(deliveryId: string, options?: ReplayOptions): Promise<ReplayOutcome> {\n    return db.runTransaction(async (tx): Promise<ReplayOutcome> => {\n      const dRef = deliveryRef(deliveryId);\n      const dSnap = await tx.get(dRef);\n      if (!dSnap.exists) return 'missing';\n      const d = (dSnap.data() ?? {}) as Record<string, unknown>;\n      if ((d.state as DeliveryState) !== 'deadLetter') return 'not-dead-lettered';\n      tx.update(dRef, {\n        state: 'queued' as DeliveryState,\n        attemptCount: 0,\n        nextAttemptAt: Date.now(),\n        lastError: null,\n        deadLetteredAt: null,\n        expireAt: null, // clear any TTL set on a prior terminal\n      });\n      await options?.auditWrite?.(tx);\n      return 'replayed';\n    });\n  }\n\n  function reportUnrecordedFailure(\n    options: MaterializeManyOptions | undefined,\n    deliveryId: string,\n    error: unknown,\n    cause: unknown,\n  ): void {\n    try {\n      if (options?.onUnrecordedFailure) {\n        options.onUnrecordedFailure(deliveryId, error, { cause });\n        return;\n      }\n    } catch (handlerError) {\n      console.error(\n        '[notification-core] onUnrecordedFailure threw for delivery',\n        deliveryId,\n        handlerError,\n      );\n    }\n    console.error(\n      '[notification-core] A delivery failure could not be recorded',\n      deliveryId,\n      error,\n      { cause },\n    );\n  }\n\n  async function materializeMany(\n    deliveryIds: string[],\n    options?: MaterializeManyOptions,\n  ): Promise<Record<MaterializeOutcome, number>> {\n    const concurrency = Math.max(1, options?.concurrency ?? 10);\n    const tally: Record<MaterializeOutcome, number> = {\n      materialized: 0,\n      'already-materialized': 0,\n      'skipped-ineligible-recipient': 0,\n      missing: 0,\n      'skipped-non-queued': 0,\n    };\n    let cursor = 0;\n    async function worker(): Promise<void> {\n      while (cursor < deliveryIds.length) {\n        const id = deliveryIds[cursor++];\n        try {\n          const outcome = await materialize(id);\n          tally[outcome] += 1;\n        } catch (error) {\n          try {\n            await recordTransientFailure(id, error);\n          } catch (recordError) {\n            reportUnrecordedFailure(options, id, recordError, error);\n          }\n        }\n      }\n    }\n    await Promise.all(Array.from({ length: Math.min(concurrency, deliveryIds.length) }, worker));\n    return tally;\n  }\n\n  return { enqueue, materialize, materializeMany, recordTransientFailure, deadLetter, replay };\n}\n"]}

package/dist/server/observed-generation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observed-generation.d.ts","sourceRoot":"","sources":["../../src/server/observed-generation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEnF,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,qBAAqB,GAAG,SAAS,CAAC;AAEzE;;;;GAIG;AACH,wBAAsB,kCAAkC,CACtD,EAAE,EAAE,eAAe,EACnB,SAAS,EAAE,YAAY,EACvB,MAAM,EAAE;IAAE,0BAA0B,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3D,OAAO,CAAC,eAAe,CAAC,CAc1B;AAED,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,qBAAqB,GAAG,SAAS,CAAC;AAEtG;;;;;;;GAOG;AACH,wBAAsB,iCAAiC,CACrD,EAAE,EAAE,eAAe,EACnB,MAAM,EAAE;IACN,SAAS,EAAE,YAAY,CAAC;IACxB,mHAAmH;IACnH,UAAU,EAAE,YAAY,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B,EAAE,MAAM,CAAC;IACnC,qFAAqF;IACrF,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,uFAAuF;IACvF,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;IAC7C,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;OASG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/D,GACA,OAAO,CAAC,cAAc,CAAC,CAoDzB"}
+{"version":3,"file":"observed-generation.d.ts","sourceRoot":"","sources":["../../src/server/observed-generation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEnF,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,qBAAqB,GAAG,SAAS,CAAC;AAEzE;;;;GAIG;AACH,wBAAsB,kCAAkC,CACtD,EAAE,EAAE,eAAe,EACnB,SAAS,EAAE,YAAY,EACvB,MAAM,EAAE;IAAE,0BAA0B,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3D,OAAO,CAAC,eAAe,CAAC,CAc1B;AAED,MAAM,MAAM,cAAc,GACxB,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,qBAAqB,GAAG,SAAS,CAAC;AAE3E;;;;;;;GAOG;AACH,wBAAsB,iCAAiC,CACrD,EAAE,EAAE,eAAe,EACnB,MAAM,EAAE;IACN,SAAS,EAAE,YAAY,CAAC;IACxB,mHAAmH;IACnH,UAAU,EAAE,YAAY,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B,EAAE,MAAM,CAAC;IACnC,qFAAqF;IACrF,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,uFAAuF;IACvF,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;IAC7C,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;OASG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/D,GACA,OAAO,CAAC,cAAc,CAAC,CAoDzB"}

package/dist/server/observed-generation.js.map

@@ -1 +1 @@
-{"version":3,"file":"observed-generation.js","sourceRoot":"","sources":["../../src/server/observed-generation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kCAAkC,CACtD,EAAmB,EACnB,SAAuB,EACvB,MAA4D;IAE5D,OAAO,EAAE,CAAC,cAAc,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;QACpC,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QACnC,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAA4B,CAAC;QAC5D,IAAK,IAAI,CAAC,kBAAyC,KAAK,MAAM,CAAC,0BAA0B,EAAE,CAAC;YAC1F,OAAO,qBAAqB,CAAC;QAC/B,CAAC;QACD,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE;YACnB,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE;YAChC,gBAAgB,EAAE,MAAM,CAAC,0BAA0B;SACpD,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC;AAID;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,iCAAiC,CACrD,EAAmB,EACnB,MA0BC;IAED,MAAM,EACJ,SAAS,EACT,UAAU,EACV,SAAS,EACT,0BAA0B,EAC1B,WAAW,EACX,QAAQ,EACR,aAAa,EACb,UAAU,EACV,mBAAmB,EACnB,SAAS,EACT,UAAU,GACX,GAAG,MAAM,CAAC;IAEX,OAAO,EAAE,CAAC,cAAc,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;QACpC,+CAA+C;QAC/C,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC7C,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;YACvB,MAAM,QAAQ,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,CAA4B,CAAC;YACvE,OAAQ,QAAQ,CAAC,WAAkC,KAAK,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;QAChG,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,CAAC,UAAU,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QACzC,MAAM,UAAU,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,CAA4B,CAAC;QACxE,IAAK,UAAU,CAAC,kBAAyC,KAAK,0BAA0B,EAAE,CAAC;YACzF,OAAO,qBAAqB,CAAC;QAC/B,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,UAAU,GAA4B;YAC1C,mBAAmB,EAAE,UAAU,CAAC,EAAE;YAClC,SAAS;YACT,WAAW;YACX,QAAQ,EAAE,SAAS,CAAC,EAAE;YACtB,0BAA0B;YAC1B,QAAQ;YACR,aAAa;YACb,gBAAgB,EAAE,UAAU;YAC5B,UAAU,EAAE,GAAG;YACf,QAAQ,EAAE,mBAAmB,CAAC,UAAU,CAAC;SAC1C,CAAC;QACF,IAAI,SAAS,KAAK,SAAS;YAAE,UAAU,CAAC,SAAS,GAAG,SAAS,CAAC;QAE9D,EAAE,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAC/B,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACrB,oEAAoE;QACpE,6EAA6E;QAC7E,yEAAyE;QACzE,MAAM,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;QACvB,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["/**\n * Observed-generation seen/archive protocol (notification redesign — P1).\n *\n * The SEEN/ARCHIVE precondition compares the card's current opaque\n * `activityGeneration` against the generation the client actually observed when\n * it rendered the row — so activity arriving after render (or a delete+recreate\n * that rotated the token) is never silently swallowed. Archive additionally\n * carries a retry-stable `requestId`; the deterministic history doc id makes a\n * replay return the stored result and touch nothing.\n *\n * GENERIC: the app constructs the deterministic ids (`historyRef`, `payloadHash`)\n * via its own canonical hash (in the consuming app's core package) and passes the\n * refs in; this module owns only the transactional state machine, not the id formulas.\n */\n\nimport type { ServerFirestore, ServerDocRef, ServerTransaction } from './types.js';\n\nexport type MarkSeenOutcome = 'seen' | 'generation-mismatch' | 'missing';\n\n/**\n * Set `seenAt`/`seenAtGeneration` ONLY if the card's current `activityGeneration`\n * still matches the observed one; otherwise no-op (the row stays unseen so newer\n * activity is never swallowed).\n */\nexport async function markNotificationSeenWithGeneration(\n  db: ServerFirestore,\n  activeRef: ServerDocRef,\n  params: { observedActivityGeneration: string; now?: number },\n): Promise<MarkSeenOutcome> {\n  return db.runTransaction(async (tx) => {\n    const snap = await tx.get(activeRef);\n    if (!snap.exists) return 'missing';\n    const data = (snap.data() ?? {}) as Record<string, unknown>;\n    if ((data.activityGeneration as string | undefined) !== params.observedActivityGeneration) {\n      return 'generation-mismatch';\n    }\n    tx.update(activeRef, {\n      seenAt: params.now ?? Date.now(),\n      seenAtGeneration: params.observedActivityGeneration,\n    });\n    return 'seen';\n  });\n}\n\nexport type ArchiveOutcome = 'archived' | 'replayed' | 'conflict' | 'generation-mismatch' | 'missing';\n\n/**\n * Archive one active card into history, idempotently and replay-safely.\n *\n * - history doc already exists + same `payloadHash` ⇒ `replayed` (touch NOTHING).\n * - history doc already exists + DIFFERENT `payloadHash` ⇒ `conflict` (caller alerts).\n * - first-seen: archive only if the active card's `activityGeneration` still\n *   matches the observed generation; else `generation-mismatch` (leave it active).\n */\nexport async function archiveNotificationWithGeneration(\n  db: ServerFirestore,\n  params: {\n    activeRef: ServerDocRef;\n    /** Deterministic history doc id = hash('notification-archive', category, audienceScope, requestId) (app-built). */\n    historyRef: ServerDocRef;\n    requestId: string;\n    observedActivityGeneration: string;\n    /** Deterministic payload hash (app-built) — the replay-vs-conflict discriminator. */\n    payloadHash: string;\n    category: string;\n    audienceScope: string;\n    /** Native-TTL expiry for the history doc; converted to a Timestamp via the factory. */\n    expireAtMs: number;\n    timestampFromMillis: (ms: number) => unknown;\n    /** Admin history quick-access field (admin category only). */\n    handledBy?: string;\n    /**\n     * Optional hook to compose additional writes (e.g. an audit event) INTO the\n     * same archive transaction, so they commit atomically with the active→history\n     * move. Invoked in the write phase ONLY on the successful 'archived' path —\n     * never on replay/conflict/generation-mismatch/missing — so the audit is\n     * written iff the archive actually happens. Honor reads-before-writes: do not\n     * read inside the hook. The hook is awaited inside the transaction body, so a\n     * throw or a rejected promise fails the archive instead of committing it\n     * without its write.\n     */\n    auditWrite?: (txn: ServerTransaction) => void | Promise<void>;\n  },\n): Promise<ArchiveOutcome> {\n  const {\n    activeRef,\n    historyRef,\n    requestId,\n    observedActivityGeneration,\n    payloadHash,\n    category,\n    audienceScope,\n    expireAtMs,\n    timestampFromMillis,\n    handledBy,\n    auditWrite,\n  } = params;\n\n  return db.runTransaction(async (tx) => {\n    // Reads first (Firestore reads-before-writes).\n    const historySnap = await tx.get(historyRef);\n    if (historySnap.exists) {\n      const existing = (historySnap.data() ?? {}) as Record<string, unknown>;\n      return (existing.payloadHash as string | undefined) === payloadHash ? 'replayed' : 'conflict';\n    }\n    const activeSnap = await tx.get(activeRef);\n    if (!activeSnap.exists) return 'missing';\n    const activeData = (activeSnap.data() ?? {}) as Record<string, unknown>;\n    if ((activeData.activityGeneration as string | undefined) !== observedActivityGeneration) {\n      return 'generation-mismatch';\n    }\n\n    const now = Date.now();\n    const historyDoc: Record<string, unknown> = {\n      archiveOccurrenceId: historyRef.id,\n      requestId,\n      payloadHash,\n      activeId: activeRef.id,\n      observedActivityGeneration,\n      category,\n      audienceScope,\n      archivedSnapshot: activeData,\n      archivedAt: now,\n      expireAt: timestampFromMillis(expireAtMs),\n    };\n    if (handledBy !== undefined) historyDoc.handledBy = handledBy;\n\n    tx.set(historyRef, historyDoc);\n    tx.delete(activeRef);\n    // Compose any caller-supplied write (e.g. an audit event) into THIS\n    // transaction so it commits atomically with the archive. Only reached on the\n    // successful path, after all reads, so reads-before-writes is preserved.\n    await auditWrite?.(tx);\n    return 'archived';\n  });\n}\n"]}
+{"version":3,"file":"observed-generation.js","sourceRoot":"","sources":["../../src/server/observed-generation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kCAAkC,CACtD,EAAmB,EACnB,SAAuB,EACvB,MAA4D;IAE5D,OAAO,EAAE,CAAC,cAAc,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;QACpC,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QACnC,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAA4B,CAAC;QAC5D,IAAK,IAAI,CAAC,kBAAyC,KAAK,MAAM,CAAC,0BAA0B,EAAE,CAAC;YAC1F,OAAO,qBAAqB,CAAC;QAC/B,CAAC;QACD,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE;YACnB,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE;YAChC,gBAAgB,EAAE,MAAM,CAAC,0BAA0B;SACpD,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC;AAKD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,iCAAiC,CACrD,EAAmB,EACnB,MA0BC;IAED,MAAM,EACJ,SAAS,EACT,UAAU,EACV,SAAS,EACT,0BAA0B,EAC1B,WAAW,EACX,QAAQ,EACR,aAAa,EACb,UAAU,EACV,mBAAmB,EACnB,SAAS,EACT,UAAU,GACX,GAAG,MAAM,CAAC;IAEX,OAAO,EAAE,CAAC,cAAc,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;QACpC,+CAA+C;QAC/C,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC7C,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;YACvB,MAAM,QAAQ,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,CAA4B,CAAC;YACvE,OAAQ,QAAQ,CAAC,WAAkC,KAAK,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;QAChG,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,CAAC,UAAU,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QACzC,MAAM,UAAU,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,CAA4B,CAAC;QACxE,IAAK,UAAU,CAAC,kBAAyC,KAAK,0BAA0B,EAAE,CAAC;YACzF,OAAO,qBAAqB,CAAC;QAC/B,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,UAAU,GAA4B;YAC1C,mBAAmB,EAAE,UAAU,CAAC,EAAE;YAClC,SAAS;YACT,WAAW;YACX,QAAQ,EAAE,SAAS,CAAC,EAAE;YACtB,0BAA0B;YAC1B,QAAQ;YACR,aAAa;YACb,gBAAgB,EAAE,UAAU;YAC5B,UAAU,EAAE,GAAG;YACf,QAAQ,EAAE,mBAAmB,CAAC,UAAU,CAAC;SAC1C,CAAC;QACF,IAAI,SAAS,KAAK,SAAS;YAAE,UAAU,CAAC,SAAS,GAAG,SAAS,CAAC;QAE9D,EAAE,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAC/B,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACrB,oEAAoE;QACpE,6EAA6E;QAC7E,yEAAyE;QACzE,MAAM,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;QACvB,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["/**\n * Observed-generation seen/archive protocol (notification redesign — P1).\n *\n * The SEEN/ARCHIVE precondition compares the card's current opaque\n * `activityGeneration` against the generation the client actually observed when\n * it rendered the row — so activity arriving after render (or a delete+recreate\n * that rotated the token) is never silently swallowed. Archive additionally\n * carries a retry-stable `requestId`; the deterministic history doc id makes a\n * replay return the stored result and touch nothing.\n *\n * GENERIC: the app constructs the deterministic ids (`historyRef`, `payloadHash`)\n * via its own canonical hash (in the consuming app's core package) and passes the\n * refs in; this module owns only the transactional state machine, not the id formulas.\n */\n\nimport type { ServerFirestore, ServerDocRef, ServerTransaction } from './types.js';\n\nexport type MarkSeenOutcome = 'seen' | 'generation-mismatch' | 'missing';\n\n/**\n * Set `seenAt`/`seenAtGeneration` ONLY if the card's current `activityGeneration`\n * still matches the observed one; otherwise no-op (the row stays unseen so newer\n * activity is never swallowed).\n */\nexport async function markNotificationSeenWithGeneration(\n  db: ServerFirestore,\n  activeRef: ServerDocRef,\n  params: { observedActivityGeneration: string; now?: number },\n): Promise<MarkSeenOutcome> {\n  return db.runTransaction(async (tx) => {\n    const snap = await tx.get(activeRef);\n    if (!snap.exists) return 'missing';\n    const data = (snap.data() ?? {}) as Record<string, unknown>;\n    if ((data.activityGeneration as string | undefined) !== params.observedActivityGeneration) {\n      return 'generation-mismatch';\n    }\n    tx.update(activeRef, {\n      seenAt: params.now ?? Date.now(),\n      seenAtGeneration: params.observedActivityGeneration,\n    });\n    return 'seen';\n  });\n}\n\nexport type ArchiveOutcome =\n  'archived' | 'replayed' | 'conflict' | 'generation-mismatch' | 'missing';\n\n/**\n * Archive one active card into history, idempotently and replay-safely.\n *\n * - history doc already exists + same `payloadHash` ⇒ `replayed` (touch NOTHING).\n * - history doc already exists + DIFFERENT `payloadHash` ⇒ `conflict` (caller alerts).\n * - first-seen: archive only if the active card's `activityGeneration` still\n *   matches the observed generation; else `generation-mismatch` (leave it active).\n */\nexport async function archiveNotificationWithGeneration(\n  db: ServerFirestore,\n  params: {\n    activeRef: ServerDocRef;\n    /** Deterministic history doc id = hash('notification-archive', category, audienceScope, requestId) (app-built). */\n    historyRef: ServerDocRef;\n    requestId: string;\n    observedActivityGeneration: string;\n    /** Deterministic payload hash (app-built) — the replay-vs-conflict discriminator. */\n    payloadHash: string;\n    category: string;\n    audienceScope: string;\n    /** Native-TTL expiry for the history doc; converted to a Timestamp via the factory. */\n    expireAtMs: number;\n    timestampFromMillis: (ms: number) => unknown;\n    /** Admin history quick-access field (admin category only). */\n    handledBy?: string;\n    /**\n     * Optional hook to compose additional writes (e.g. an audit event) INTO the\n     * same archive transaction, so they commit atomically with the active→history\n     * move. Invoked in the write phase ONLY on the successful 'archived' path —\n     * never on replay/conflict/generation-mismatch/missing — so the audit is\n     * written iff the archive actually happens. Honor reads-before-writes: do not\n     * read inside the hook. The hook is awaited inside the transaction body, so a\n     * throw or a rejected promise fails the archive instead of committing it\n     * without its write.\n     */\n    auditWrite?: (txn: ServerTransaction) => void | Promise<void>;\n  },\n): Promise<ArchiveOutcome> {\n  const {\n    activeRef,\n    historyRef,\n    requestId,\n    observedActivityGeneration,\n    payloadHash,\n    category,\n    audienceScope,\n    expireAtMs,\n    timestampFromMillis,\n    handledBy,\n    auditWrite,\n  } = params;\n\n  return db.runTransaction(async (tx) => {\n    // Reads first (Firestore reads-before-writes).\n    const historySnap = await tx.get(historyRef);\n    if (historySnap.exists) {\n      const existing = (historySnap.data() ?? {}) as Record<string, unknown>;\n      return (existing.payloadHash as string | undefined) === payloadHash ? 'replayed' : 'conflict';\n    }\n    const activeSnap = await tx.get(activeRef);\n    if (!activeSnap.exists) return 'missing';\n    const activeData = (activeSnap.data() ?? {}) as Record<string, unknown>;\n    if ((activeData.activityGeneration as string | undefined) !== observedActivityGeneration) {\n      return 'generation-mismatch';\n    }\n\n    const now = Date.now();\n    const historyDoc: Record<string, unknown> = {\n      archiveOccurrenceId: historyRef.id,\n      requestId,\n      payloadHash,\n      activeId: activeRef.id,\n      observedActivityGeneration,\n      category,\n      audienceScope,\n      archivedSnapshot: activeData,\n      archivedAt: now,\n      expireAt: timestampFromMillis(expireAtMs),\n    };\n    if (handledBy !== undefined) historyDoc.handledBy = handledBy;\n\n    tx.set(historyRef, historyDoc);\n    tx.delete(activeRef);\n    // Compose any caller-supplied write (e.g. an audit event) into THIS\n    // transaction so it commits atomically with the archive. Only reached on the\n    // successful path, after all reads, so reads-before-writes is preserved.\n    await auditWrite?.(tx);\n    return 'archived';\n  });\n}\n"]}

package/dist/server/processBatchHelper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"processBatchHelper.d.ts","sourceRoot":"","sources":["../../src/server/processBatchHelper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAuB,MAAM,aAAa,CAAC;AACjF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAQlD,UAAU,kBAAkB;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,eAAe,EACnB,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,kBAAkB,CAAC,CAmM7B"}
+{"version":3,"file":"processBatchHelper.d.ts","sourceRoot":"","sources":["../../src/server/processBatchHelper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAuB,MAAM,aAAa,CAAC;AACjF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAQlD,UAAU,kBAAkB;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,eAAe,EACnB,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,kBAAkB,CAAC,CAkM7B"}

package/dist/server/processBatchHelper.js

@@ -32,7 +32,8 @@ export async function processBatchHelper(db, config) {
     let hasMore = true;
     while (hasMore && iterations < MAX_ITERATIONS) {
         iterations++;
-        const pendingQuery = db.collection(pendingPath)
+        const pendingQuery = db
+            .collection(pendingPath)
             .where('createdAt', '<=', cutoff)
             .orderBy('createdAt', 'asc')
             .limit(PROCESSING_BATCH_SIZE);
@@ -118,10 +119,7 @@ export async function processBatchHelper(db, config) {
                     const currentActorIds = existingData.latestActorIds || [];
                     // Merge actor ids (new first, deduped, capped)
                     const newActorIds = group.actorIds.filter((id) => !currentActorIds.includes(id));
-                    const mergedActorIds = [
-                        ...newActorIds,
-                        ...currentActorIds,
-                    ].slice(0, actorCap);
+                    const mergedActorIds = [...newActorIds, ...currentActorIds].slice(0, actorCap);
                     const newCount = Math.min(currentCount + group.count, countCap);
                     tx.update(activeDocRef, {
                         count: newCount,

package/dist/server/processBatchHelper.js.map

@@ -1 +1 @@
-{"version":3,"file":"processBatchHelper.js","sourceRoot":"","sources":["../../src/server/processBatchHelper.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Batch processor helper — called by the app's scheduled Cloud Function.\n * Reads pending notifications, groups by dedupKey, creates/increments active docs.\n */\n\nimport type { NotificationSystemConfig, PendingNotification } from '../types.js';\nimport type { ServerFirestore } from './types.js';\nimport { buildActiveNotificationDocId } from './activeNotificationId.js';\n\nconst DEFAULT_COUNT_CAP = 5000;\nconst DEFAULT_ACTOR_CAP = 5;\nconst PROCESSING_BATCH_SIZE = 500;\nconst MAX_ITERATIONS = 20;\n\ninterface BatchProcessResult {\n  totalProcessed: number;\n  notificationsCreated: number;\n  notificationsUpdated: number;\n}\n\n/**\n * Process the pending notifications queue.\n *\n * @example\n * ```ts\n * // In your scheduled Cloud Function:\n * export const processNotificationBatch = onSchedule(\n *   { schedule: 'every 10 minutes' },\n *   async () => {\n *     const result = await processBatchHelper(db as any, TTT_NOTIFICATION_CONFIG);\n *     logger.info('Batch processed', result);\n *   }\n * );\n * ```\n */\nexport async function processBatchHelper(\n  db: ServerFirestore,\n  config: NotificationSystemConfig,\n): Promise<BatchProcessResult> {\n  const pendingPath = config.pendingCollectionPath ?? 'pendingNotifications';\n  const cutoff = Date.now() - 30_000; // Process items older than 30 seconds\n\n  let totalProcessed = 0;\n  let notificationsCreated = 0;\n  let notificationsUpdated = 0;\n  let iterations = 0;\n  let hasMore = true;\n\n  while (hasMore && iterations < MAX_ITERATIONS) {\n    iterations++;\n\n    const pendingQuery = db.collection(pendingPath)\n      .where('createdAt', '<=', cutoff)\n      .orderBy('createdAt', 'asc')\n      .limit(PROCESSING_BATCH_SIZE);\n\n    const snapshot = await pendingQuery.get();\n\n    if (snapshot.empty) {\n      break;\n    }\n\n    // Group by dedupKey\n    const groups = new Map<string, {\n      type: string;\n      category: string;\n      targetUserId: string | null;\n      metadata: Record<string, unknown>;\n      actorIds: string[];\n      count: number;\n      docs: typeof snapshot.docs;\n    }>();\n\n    for (const docSnap of snapshot.docs) {\n      const data = docSnap.data() as Omit<PendingNotification, 'id'>;\n      const typeConfig = config.types[data.type];\n      if (!typeConfig) continue;\n      const categoryConfig = config.categories[data.category];\n      if (!categoryConfig) continue;\n\n      const dedupKey = typeConfig.dedupKeyPattern(data.metadata);\n      // Personal notifications dedup per-recipient: a multi-recipient fan-out\n      // (same type/metadata, different targetUserId) must never collapse into\n      // one recipient's active doc. Shared notifications are intentionally a\n      // single doc for all admins (targetUserId is null).\n      const groupKey = categoryConfig.audienceType === 'personal'\n        ? `${data.category}::${data.targetUserId}::${dedupKey}`\n        : `${data.category}::${dedupKey}`;\n\n      const existing = groups.get(groupKey);\n      if (existing) {\n        existing.count++;\n        // Add actor id if not already present\n        if (!existing.actorIds.includes(data.actorId)) {\n          existing.actorIds.push(data.actorId);\n        }\n        existing.docs.push(docSnap);\n      } else {\n        groups.set(groupKey, {\n          type: data.type,\n          category: data.category,\n          targetUserId: data.targetUserId,\n          metadata: data.metadata,\n          actorIds: [data.actorId],\n          count: 1,\n          docs: [docSnap],\n        });\n      }\n    }\n\n    // Process each group: create or increment the group's active doc.\n    // Each group's groupKey uniquely determines a single active doc — the doc ID\n    // is a deterministic hash of exactly the dedupKey + category (+ targetUserId\n    // for personal) that compose the groupKey — so two distinct groups can never\n    // resolve to the same active doc and there is no cross-group contention. The\n    // work per group is independent I/O, so Promise.all turns N sequential\n    // round-trips into one parallel wave, removing the timeout risk under high\n    // dedup-group counts. WITHIN a dedup scope, the transactional read-modify-write\n    // on the deterministic ID makes concurrent writers (a racing real-time send,\n    // or an overlapping batch run) converge on one doc with correct counts.\n    const groupResults = await Promise.all(\n      Array.from(groups.values()).map(\n        async (group): Promise<'created' | 'updated' | 'skipped'> => {\n          const typeConfig = config.types[group.type];\n          if (!typeConfig) return 'skipped';\n\n          const categoryConfig = config.categories[group.category];\n          if (!categoryConfig) return 'skipped';\n\n          const activePath = categoryConfig.activePath;\n          const dedupKey = typeConfig.dedupKeyPattern(group.metadata);\n          const countCap = typeConfig.countCap ?? DEFAULT_COUNT_CAP;\n          const actorCap = typeConfig.actorCap ?? DEFAULT_ACTOR_CAP;\n\n          // Personal notifications are scoped to the recipient so different\n          // recipients never share an active doc; shared notifications omit\n          // targetUserId by design.\n          const activeDocRef = db.collection(activePath).doc(\n            buildActiveNotificationDocId({\n              category: group.category,\n              audienceType: categoryConfig.audienceType,\n              targetUserId: group.targetUserId,\n              dedupKey,\n            }),\n          );\n\n          return db.runTransaction(async (tx): Promise<'created' | 'updated'> => {\n            const existingSnap = await tx.get(activeDocRef);\n\n            if (existingSnap.exists) {\n              // Increment existing\n              const existingData = (existingSnap.data() ?? {}) as Record<string, unknown>;\n              const currentCount = (existingData.count as number) || 1;\n              const currentActorIds = (existingData.latestActorIds as string[]) || [];\n\n              // Merge actor ids (new first, deduped, capped)\n              const newActorIds = group.actorIds.filter(\n                (id) => !currentActorIds.includes(id)\n              );\n              const mergedActorIds = [\n                ...newActorIds,\n                ...currentActorIds,\n              ].slice(0, actorCap);\n\n              const newCount = Math.min(currentCount + group.count, countCap);\n\n              tx.update(activeDocRef, {\n                count: newCount,\n                latestActorIds: mergedActorIds,\n                message: typeConfig.messagePattern(group.metadata, newCount),\n                // New activity on an existing notification re-lights the unread badge.\n                seenAt: 0,\n                updatedAt: Date.now(),\n              });\n\n              return 'updated';\n            } else {\n              // Create new notification. A type with no defaultTargetPath is\n              // linkless — OMIT the field (Firestore rejects `undefined` values).\n              const targetPath = typeConfig.defaultTargetPath === undefined\n                ? undefined\n                : typeof typeConfig.defaultTargetPath === 'function'\n                  ? typeConfig.defaultTargetPath(group.metadata)\n                  : typeConfig.defaultTargetPath;\n              const now = Date.now();\n\n              const newDoc = {\n                type: group.type,\n                dedupKey,\n                category: group.category,\n                targetUserId: group.targetUserId,\n                title: typeConfig.titlePattern(group.metadata),\n                message: typeConfig.messagePattern(group.metadata, group.count),\n                count: group.count,\n                latestActorIds: group.actorIds.slice(0, actorCap),\n                ...(targetPath === undefined ? {} : { targetPath }),\n                metadata: group.metadata,\n                // Active docs are created unseen so the unread count() predicate matches.\n                seenAt: 0,\n                createdAt: now,\n                updatedAt: now,\n              };\n\n              tx.set(activeDocRef, newDoc);\n              return 'created';\n            }\n          });\n        }\n      )\n    );\n\n    for (const r of groupResults) {\n      if (r === 'created') notificationsCreated++;\n      else if (r === 'updated') notificationsUpdated++;\n    }\n\n    // Delete processed pending docs in batches of 500\n    const allDocs = snapshot.docs;\n    for (let i = 0; i < allDocs.length; i += 500) {\n      const chunk = allDocs.slice(i, i + 500);\n      const batch = db.batch();\n      chunk.forEach((docSnap) => batch.delete(docSnap.ref));\n      await batch.commit();\n    }\n\n    totalProcessed += snapshot.size;\n\n    if (snapshot.size < PROCESSING_BATCH_SIZE) {\n      hasMore = false;\n    }\n  }\n\n  return { totalProcessed, notificationsCreated, notificationsUpdated };\n}\n"]}
+{"version":3,"file":"processBatchHelper.js","sourceRoot":"","sources":["../../src/server/processBatchHelper.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Batch processor helper — called by the app's scheduled Cloud Function.\n * Reads pending notifications, groups by dedupKey, creates/increments active docs.\n */\n\nimport type { NotificationSystemConfig, PendingNotification } from '../types.js';\nimport type { ServerFirestore } from './types.js';\nimport { buildActiveNotificationDocId } from './activeNotificationId.js';\n\nconst DEFAULT_COUNT_CAP = 5000;\nconst DEFAULT_ACTOR_CAP = 5;\nconst PROCESSING_BATCH_SIZE = 500;\nconst MAX_ITERATIONS = 20;\n\ninterface BatchProcessResult {\n  totalProcessed: number;\n  notificationsCreated: number;\n  notificationsUpdated: number;\n}\n\n/**\n * Process the pending notifications queue.\n *\n * @example\n * ```ts\n * // In your scheduled Cloud Function:\n * export const processNotificationBatch = onSchedule(\n *   { schedule: 'every 10 minutes' },\n *   async () => {\n *     const result = await processBatchHelper(db as any, TTT_NOTIFICATION_CONFIG);\n *     logger.info('Batch processed', result);\n *   }\n * );\n * ```\n */\nexport async function processBatchHelper(\n  db: ServerFirestore,\n  config: NotificationSystemConfig,\n): Promise<BatchProcessResult> {\n  const pendingPath = config.pendingCollectionPath ?? 'pendingNotifications';\n  const cutoff = Date.now() - 30_000; // Process items older than 30 seconds\n\n  let totalProcessed = 0;\n  let notificationsCreated = 0;\n  let notificationsUpdated = 0;\n  let iterations = 0;\n  let hasMore = true;\n\n  while (hasMore && iterations < MAX_ITERATIONS) {\n    iterations++;\n\n    const pendingQuery = db\n      .collection(pendingPath)\n      .where('createdAt', '<=', cutoff)\n      .orderBy('createdAt', 'asc')\n      .limit(PROCESSING_BATCH_SIZE);\n\n    const snapshot = await pendingQuery.get();\n\n    if (snapshot.empty) {\n      break;\n    }\n\n    // Group by dedupKey\n    const groups = new Map<\n      string,\n      {\n        type: string;\n        category: string;\n        targetUserId: string | null;\n        metadata: Record<string, unknown>;\n        actorIds: string[];\n        count: number;\n        docs: typeof snapshot.docs;\n      }\n    >();\n\n    for (const docSnap of snapshot.docs) {\n      const data = docSnap.data() as Omit<PendingNotification, 'id'>;\n      const typeConfig = config.types[data.type];\n      if (!typeConfig) continue;\n      const categoryConfig = config.categories[data.category];\n      if (!categoryConfig) continue;\n\n      const dedupKey = typeConfig.dedupKeyPattern(data.metadata);\n      // Personal notifications dedup per-recipient: a multi-recipient fan-out\n      // (same type/metadata, different targetUserId) must never collapse into\n      // one recipient's active doc. Shared notifications are intentionally a\n      // single doc for all admins (targetUserId is null).\n      const groupKey =\n        categoryConfig.audienceType === 'personal'\n          ? `${data.category}::${data.targetUserId}::${dedupKey}`\n          : `${data.category}::${dedupKey}`;\n\n      const existing = groups.get(groupKey);\n      if (existing) {\n        existing.count++;\n        // Add actor id if not already present\n        if (!existing.actorIds.includes(data.actorId)) {\n          existing.actorIds.push(data.actorId);\n        }\n        existing.docs.push(docSnap);\n      } else {\n        groups.set(groupKey, {\n          type: data.type,\n          category: data.category,\n          targetUserId: data.targetUserId,\n          metadata: data.metadata,\n          actorIds: [data.actorId],\n          count: 1,\n          docs: [docSnap],\n        });\n      }\n    }\n\n    // Process each group: create or increment the group's active doc.\n    // Each group's groupKey uniquely determines a single active doc — the doc ID\n    // is a deterministic hash of exactly the dedupKey + category (+ targetUserId\n    // for personal) that compose the groupKey — so two distinct groups can never\n    // resolve to the same active doc and there is no cross-group contention. The\n    // work per group is independent I/O, so Promise.all turns N sequential\n    // round-trips into one parallel wave, removing the timeout risk under high\n    // dedup-group counts. WITHIN a dedup scope, the transactional read-modify-write\n    // on the deterministic ID makes concurrent writers (a racing real-time send,\n    // or an overlapping batch run) converge on one doc with correct counts.\n    const groupResults = await Promise.all(\n      Array.from(groups.values()).map(async (group): Promise<'created' | 'updated' | 'skipped'> => {\n        const typeConfig = config.types[group.type];\n        if (!typeConfig) return 'skipped';\n\n        const categoryConfig = config.categories[group.category];\n        if (!categoryConfig) return 'skipped';\n\n        const activePath = categoryConfig.activePath;\n        const dedupKey = typeConfig.dedupKeyPattern(group.metadata);\n        const countCap = typeConfig.countCap ?? DEFAULT_COUNT_CAP;\n        const actorCap = typeConfig.actorCap ?? DEFAULT_ACTOR_CAP;\n\n        // Personal notifications are scoped to the recipient so different\n        // recipients never share an active doc; shared notifications omit\n        // targetUserId by design.\n        const activeDocRef = db.collection(activePath).doc(\n          buildActiveNotificationDocId({\n            category: group.category,\n            audienceType: categoryConfig.audienceType,\n            targetUserId: group.targetUserId,\n            dedupKey,\n          }),\n        );\n\n        return db.runTransaction(async (tx): Promise<'created' | 'updated'> => {\n          const existingSnap = await tx.get(activeDocRef);\n\n          if (existingSnap.exists) {\n            // Increment existing\n            const existingData = (existingSnap.data() ?? {}) as Record<string, unknown>;\n            const currentCount = (existingData.count as number) || 1;\n            const currentActorIds = (existingData.latestActorIds as string[]) || [];\n\n            // Merge actor ids (new first, deduped, capped)\n            const newActorIds = group.actorIds.filter((id) => !currentActorIds.includes(id));\n            const mergedActorIds = [...newActorIds, ...currentActorIds].slice(0, actorCap);\n\n            const newCount = Math.min(currentCount + group.count, countCap);\n\n            tx.update(activeDocRef, {\n              count: newCount,\n              latestActorIds: mergedActorIds,\n              message: typeConfig.messagePattern(group.metadata, newCount),\n              // New activity on an existing notification re-lights the unread badge.\n              seenAt: 0,\n              updatedAt: Date.now(),\n            });\n\n            return 'updated';\n          } else {\n            // Create new notification. A type with no defaultTargetPath is\n            // linkless — OMIT the field (Firestore rejects `undefined` values).\n            const targetPath =\n              typeConfig.defaultTargetPath === undefined\n                ? undefined\n                : typeof typeConfig.defaultTargetPath === 'function'\n                  ? typeConfig.defaultTargetPath(group.metadata)\n                  : typeConfig.defaultTargetPath;\n            const now = Date.now();\n\n            const newDoc = {\n              type: group.type,\n              dedupKey,\n              category: group.category,\n              targetUserId: group.targetUserId,\n              title: typeConfig.titlePattern(group.metadata),\n              message: typeConfig.messagePattern(group.metadata, group.count),\n              count: group.count,\n              latestActorIds: group.actorIds.slice(0, actorCap),\n              ...(targetPath === undefined ? {} : { targetPath }),\n              metadata: group.metadata,\n              // Active docs are created unseen so the unread count() predicate matches.\n              seenAt: 0,\n              createdAt: now,\n              updatedAt: now,\n            };\n\n            tx.set(activeDocRef, newDoc);\n            return 'created';\n          }\n        });\n      }),\n    );\n\n    for (const r of groupResults) {\n      if (r === 'created') notificationsCreated++;\n      else if (r === 'updated') notificationsUpdated++;\n    }\n\n    // Delete processed pending docs in batches of 500\n    const allDocs = snapshot.docs;\n    for (let i = 0; i < allDocs.length; i += 500) {\n      const chunk = allDocs.slice(i, i + 500);\n      const batch = db.batch();\n      chunk.forEach((docSnap) => batch.delete(docSnap.ref));\n      await batch.commit();\n    }\n\n    totalProcessed += snapshot.size;\n\n    if (snapshot.size < PROCESSING_BATCH_SIZE) {\n      hasMore = false;\n    }\n  }\n\n  return { totalProcessed, notificationsCreated, notificationsUpdated };\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"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"}

package/dist/server/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * Server-side types for notification-core backend helpers.\n * These use firebase-admin Firestore types passed in by the calling app.\n */\n\n/**\n * Firestore interface — matches firebase-admin's Firestore type.\n * We accept this instead of importing firebase-admin directly.\n */\nexport interface ServerFirestore {\n  collection(path: string): ServerCollectionRef;\n  doc(path: string): ServerDocRef;\n  batch(): ServerWriteBatch;\n  runTransaction<T>(updateFunction: (transaction: ServerTransaction) => Promise<T>): Promise<T>;\n}\n\nexport interface ServerTransaction {\n  get(ref: ServerDocRef): Promise<ServerDocSnapshot>;\n  set(ref: ServerDocRef, data: Record<string, unknown>, options?: { merge?: boolean }): ServerTransaction;\n  update(ref: ServerDocRef, data: Record<string, unknown>): ServerTransaction;\n  delete(ref: ServerDocRef): ServerTransaction;\n}\n\nexport interface ServerCollectionRef {\n  doc(id?: string): ServerDocRef;\n  where(field: string, op: string, value: unknown): ServerQuery;\n  orderBy(field: string, direction?: 'asc' | 'desc'): ServerQuery;\n  limit(n: number): ServerQuery;\n  add(data: Record<string, unknown>): Promise<ServerDocRef>;\n}\n\nexport interface ServerQuery {\n  where(field: string, op: string, value: unknown): ServerQuery;\n  orderBy(field: string, direction?: 'asc' | 'desc'): ServerQuery;\n  limit(n: number): ServerQuery;\n  get(): Promise<ServerQuerySnapshot>;\n}\n\nexport interface ServerQuerySnapshot {\n  empty: boolean;\n  size: number;\n  docs: ServerDocSnapshot[];\n}\n\nexport interface ServerDocSnapshot {\n  id: string;\n  exists: boolean;\n  data(): Record<string, unknown> | undefined;\n  ref: ServerDocRef;\n}\n\nexport interface ServerDocRef {\n  id: string;\n  set(data: Record<string, unknown>, options?: { merge?: boolean }): Promise<unknown>;\n  update(data: Record<string, unknown>): Promise<unknown>;\n  /** Create-if-absent. Rejects with an `already-exists` error (gRPC code 6) if the doc exists. */\n  create(data: Record<string, unknown>): Promise<unknown>;\n  delete(): Promise<unknown>;\n  get(): Promise<ServerDocSnapshot>;\n}\n\nexport interface ServerWriteBatch {\n  set(ref: ServerDocRef, data: Record<string, unknown>, options?: { merge?: boolean }): ServerWriteBatch;\n  update(ref: ServerDocRef, data: Record<string, unknown>): ServerWriteBatch;\n  delete(ref: ServerDocRef): ServerWriteBatch;\n  commit(): Promise<unknown>;\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * Server-side types for notification-core backend helpers.\n * These use firebase-admin Firestore types passed in by the calling app.\n */\n\n/**\n * Firestore interface — matches firebase-admin's Firestore type.\n * We accept this instead of importing firebase-admin directly.\n */\nexport interface ServerFirestore {\n  collection(path: string): ServerCollectionRef;\n  doc(path: string): ServerDocRef;\n  batch(): ServerWriteBatch;\n  runTransaction<T>(updateFunction: (transaction: ServerTransaction) => Promise<T>): Promise<T>;\n}\n\nexport interface ServerTransaction {\n  get(ref: ServerDocRef): Promise<ServerDocSnapshot>;\n  set(\n    ref: ServerDocRef,\n    data: Record<string, unknown>,\n    options?: { merge?: boolean },\n  ): ServerTransaction;\n  update(ref: ServerDocRef, data: Record<string, unknown>): ServerTransaction;\n  delete(ref: ServerDocRef): ServerTransaction;\n}\n\nexport interface ServerCollectionRef {\n  doc(id?: string): ServerDocRef;\n  where(field: string, op: string, value: unknown): ServerQuery;\n  orderBy(field: string, direction?: 'asc' | 'desc'): ServerQuery;\n  limit(n: number): ServerQuery;\n  add(data: Record<string, unknown>): Promise<ServerDocRef>;\n}\n\nexport interface ServerQuery {\n  where(field: string, op: string, value: unknown): ServerQuery;\n  orderBy(field: string, direction?: 'asc' | 'desc'): ServerQuery;\n  limit(n: number): ServerQuery;\n  get(): Promise<ServerQuerySnapshot>;\n}\n\nexport interface ServerQuerySnapshot {\n  empty: boolean;\n  size: number;\n  docs: ServerDocSnapshot[];\n}\n\nexport interface ServerDocSnapshot {\n  id: string;\n  exists: boolean;\n  data(): Record<string, unknown> | undefined;\n  ref: ServerDocRef;\n}\n\nexport interface ServerDocRef {\n  id: string;\n  set(data: Record<string, unknown>, options?: { merge?: boolean }): Promise<unknown>;\n  update(data: Record<string, unknown>): Promise<unknown>;\n  /** Create-if-absent. Rejects with an `already-exists` error (gRPC code 6) if the doc exists. */\n  create(data: Record<string, unknown>): Promise<unknown>;\n  delete(): Promise<unknown>;\n  get(): Promise<ServerDocSnapshot>;\n}\n\nexport interface ServerWriteBatch {\n  set(\n    ref: ServerDocRef,\n    data: Record<string, unknown>,\n    options?: { merge?: boolean },\n  ): ServerWriteBatch;\n  update(ref: ServerDocRef, data: Record<string, unknown>): ServerWriteBatch;\n  delete(ref: ServerDocRef): ServerWriteBatch;\n  commit(): Promise<unknown>;\n}\n"]}

package/dist/types.d.ts

@@ -4,7 +4,6 @@
  * Two-tier notification system: active (unread) → history (archived).
  * No `isRead` flag — existence in the active collection means unread.
  */
-import type { ReactNode } from 'react';
 /**
  * Active notification document stored in Firestore.
  * Same shape for both user and admin collections.
@@ -325,75 +324,6 @@ export interface NotificationListErrorState {
     retrying: boolean;
     hasRows: boolean;
 }
-export interface NotificationListProps {
-    config: NotificationSystemConfig;
-    userId: string;
-    category: string;
-    /**
-     * Archives one rendered notification. Passed straight through to
-     * `useArchiveNotification`; the app wires it to its callable.
-     */
-    archiveFn: NotificationArchiveFn;
-    /**
-     * Adapter that ENQUEUES one server-owned archive-all job scoped to `category` and returns its
-     * `jobId`. Passed straight through to `useArchiveAllNotifications`; the app wires it to its
-     * enqueue callable. Per-tab scoping: the category flows through to the job.
-     */
-    enqueueArchiveAllFn: (category: string) => Promise<EnqueueArchiveAllResult>;
-    /**
-     * Adapter that returns the current status snapshot for an archive-all `jobId`. Passed straight
-     * through to `useArchiveAllNotifications`, which polls it until the job is terminal; the app wires
-     * it to its status callable / job-doc read.
-     */
-    getArchiveAllStatusFn: (jobId: string) => Promise<ArchiveAllJobSnapshot>;
-    /** Left-aligned title for the active-list header. */
-    title?: ReactNode;
-    /**
-     * Fires with the terminal result ONLY when the archive-all job completed — the whole category was
-     * walked. A complete result can still carry `notArchived > 0` (cards that each failed and stay in
-     * the list); the copy for that is the app's.
-     */
-    onClearAll?: (result: ArchiveAllPollResult) => void;
-    /** Re-read the displayed page every `refetchInterval` ms while mounted (default 30s). */
-    refetchInterval?: number;
-    /** How long a read page counts as fresh, in ms (default 30s). */
-    staleTime?: number;
-    /** Empty-state text, shown only for an answered, empty first page. */
-    emptyText?: string;
-    /** The failed-read state, shown before (never instead of) the pager. Copy is the app's. */
-    renderError: (state: NotificationListErrorState) => ReactNode;
-    /**
-     * Called with the rows on screen each time the displayed page's answered rows change
-     * (not while a page is loading or failed with nothing shown) — the rows to mark seen.
-     */
-    onRenderedRowsChange?: (rows: readonly NotificationDoc[]) => void;
-    /**
-     * Per-row control slot. The row itself is inert; the consumer renders the row's
-     * controls here — typically an ArrowRight "go to" (which may call `actions.archive`
-     * then navigate) plus a clear/archive button (calls `actions.archive`). Omit to render
-     * a row with no controls.
-     */
-    renderRowAction?: (notification: NotificationDoc, actions: NotificationRowActions) => ReactNode;
-}
-export interface NotificationHistoryListProps {
-    config: NotificationSystemConfig;
-    userId: string;
-    category: string;
-    pageSize?: number;
-    staleTime?: number;
-    /** Empty-state text, shown only for an answered, empty first page. */
-    emptyText?: string;
-    /** The failed-read state, shown before (never instead of) the pager. Copy is the app's. */
-    renderError: (state: NotificationListErrorState) => ReactNode;
-    /** Left-aligned title for the read-only archived-list header. */
-    title?: ReactNode;
-    /**
-     * Per-row control slot for archived rows. The row is inert; archived rows are
-     * read-only (no re-archive), so `actions.archive` is absent — the consumer
-     * typically renders only an ArrowRight "go to". Omit for a row with no controls.
-     */
-    renderRowAction?: (notification: NotificationHistoryItem, actions: NotificationRowActions) => ReactNode;
-}
 export interface NotificationEmptyStateProps {
     text?: string;
 }