@ttt-productions/notification-core 0.2.1

package/README.md

@@ -0,0 +1,156 @@
+# @ttt-productions/notification-core
+
+Shared notification system for TTT Productions apps with Firestore integration.
+
+## Installation
+
+```bash
+npm install @ttt-productions/notification-core
+```
+
+## Features
+
+- 🔔 Real-time notification updates via Firestore listeners
+- 📊 Unread count tracking
+- ✅ Mark as read functionality (single or batch)
+- 🎯 Type-safe notification system with TypeScript
+- 🔥 Built on `@ttt-productions/query-core` for optimal caching
+
+## Usage
+
+### Fetch Notifications
+
+```tsx
+import { useNotifications } from '@ttt-productions/notification-core';
+
+function NotificationList() {
+  const { data: notifications, isLoading } = useNotifications({
+    userId: currentUser.uid,
+    subscribe: true, // Real-time updates
+  });
+
+  if (isLoading) return <div>Loading...</div>;
+
+  return (
+    <ul>
+      {notifications?.map((notification) => (
+        <li key={notification.id}>
+          {notification.title} - {notification.message}
+        </li>
+      ))}
+    </ul>
+  );
+}
+```
+
+### Unread Count Badge
+
+```tsx
+import { useUnreadCount } from '@ttt-productions/notification-core';
+
+function NotificationBadge() {
+  const { data: unreadCount } = useUnreadCount({
+    userId: currentUser.uid,
+    subscribe: true,
+  });
+
+  return <span className="badge">{unreadCount}</span>;
+}
+```
+
+### Mark as Read
+
+```tsx
+import { useMarkAsRead } from '@ttt-productions/notification-core';
+
+function NotificationItem({ notification }) {
+  const markAsRead = useMarkAsRead({ userId: currentUser.uid });
+
+  const handleClick = () => {
+    markAsRead.mutate({ notificationId: notification.id });
+    // Navigate to target
+  };
+
+  return <div onClick={handleClick}>{notification.message}</div>;
+}
+```
+
+### Mark All as Read
+
+```tsx
+import { useMarkAllAsRead, useNotifications } from '@ttt-productions/notification-core';
+
+function NotificationPanel() {
+  const { data: notifications } = useNotifications({
+    userId: currentUser.uid,
+    unreadOnly: true,
+  });
+
+  const markAllAsRead = useMarkAllAsRead({ userId: currentUser.uid });
+
+  const handleMarkAllRead = () => {
+    const unreadIds = notifications
+      ?.filter((n) => !n.isRead)
+      .map((n) => n.id) ?? [];
+    
+    if (unreadIds.length > 0) {
+      markAllAsRead.mutate({ notificationIds: unreadIds });
+    }
+  };
+
+  return <button onClick={handleMarkAllRead}>Mark All Read</button>;
+}
+```
+
+## Data Structure
+
+Notifications are stored in Firestore at:
+```
+userData/{userId}/metadata/notifications/{notificationId}
+```
+
+Each notification document has:
+```typescript
+interface Notification {
+  id: string;
+  type: string;                    // App-specific type
+  title: string;
+  message: string;
+  targetPath: string;              // Navigation target
+  targetParams?: Record<string, any>;
+  isRead: boolean;
+  createdAt: Timestamp;
+  metadata?: Record<string, any>;  // Type-specific data
+}
+```
+
+## Backend Integration
+
+Apps should implement a callable Cloud Function to create notifications:
+
+```typescript
+// In your app's functions/src/notifications.ts
+import { onCall } from 'firebase-functions/v2/https';
+import { getFirestore, Timestamp } from 'firebase-admin/firestore';
+
+export const createNotification = onCall(async (request) => {
+  const { userId, type, title, message, targetPath, targetParams, metadata } = request.data;
+  
+  await getFirestore()
+    .collection('userData')
+    .doc(userId)
+    .collection('metadata')
+    .doc('notifications')
+    .collection('notifications')
+    .add({
+      type,
+      title,
+      message,
+      targetPath,
+      targetParams,
+      isRead: false,
+      createdAt: Timestamp.now(),
+      metadata,
+    });
+});
+```

package/dist/hooks/index.d.ts

@@ -0,0 +1,9 @@
+export { useNotifications } from './useNotifications.js';
+export type { UseNotificationsOptions } from './useNotifications.js';
+export { useUnreadCount } from './useUnreadCount.js';
+export type { UseUnreadCountOptions } from './useUnreadCount.js';
+export { useMarkAsRead } from './useMarkAsRead.js';
+export type { UseMarkAsReadOptions } from './useMarkAsRead.js';
+export { useMarkAllAsRead } from './useMarkAllAsRead.js';
+export type { UseMarkAllAsReadOptions } from './useMarkAllAsRead.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAErE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/hooks/index.js

@@ -0,0 +1,5 @@
+export { useNotifications } from './useNotifications.js';
+export { useUnreadCount } from './useUnreadCount.js';
+export { useMarkAsRead } from './useMarkAsRead.js';
+export { useMarkAllAsRead } from './useMarkAllAsRead.js';
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/hooks/useMarkAllAsRead.d.ts

@@ -0,0 +1,30 @@
+export interface UseMarkAllAsReadOptions {
+    /** User ID */
+    userId: string;
+    /** Query keys to invalidate after marking all as read */
+    invalidateKeys?: readonly unknown[][];
+}
+/**
+ * Mark all unread notifications as read in a batch operation.
+ *
+ * @example
+ * ```tsx
+ * const markAllAsRead = useMarkAllAsRead({ userId: currentUser.uid });
+ *
+ * const handleMarkAllRead = (unreadNotifications: Notification[]) => {
+ *   markAllAsRead.mutate({ notifications: unreadNotifications });
+ * };
+ * ```
+ */
+export declare function useMarkAllAsRead({ userId, invalidateKeys, }: UseMarkAllAsReadOptions): {
+    mutate: ({ notificationIds }: {
+        notificationIds: string[];
+    }) => void;
+    mutateAsync: ({ notificationIds }: {
+        notificationIds: string[];
+    }) => Promise<any>;
+    isPending: any;
+    isError: any;
+    error: any;
+};
+//# sourceMappingURL=useMarkAllAsRead.d.ts.map

package/dist/hooks/useMarkAllAsRead.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMarkAllAsRead.d.ts","sourceRoot":"","sources":["../../src/hooks/useMarkAllAsRead.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,uBAAuB;IACtC,cAAc;IACd,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,cAAc,CAAC,EAAE,SAAS,OAAO,EAAE,EAAE,CAAC;CACvC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,MAAM,EACN,cAAc,GACf,EAAE,uBAAuB;kCASQ;QAAE,eAAe,EAAE,MAAM,EAAE,CAAA;KAAE;uCASlB;QAAE,eAAe,EAAE,MAAM,EAAE,CAAA;KAAE;;;;EAazE"}

package/dist/hooks/useMarkAllAsRead.js

@@ -0,0 +1,44 @@
+'use client';
+import { useFirestoreBatch } from '@ttt-productions/query-core';
+/**
+ * Mark all unread notifications as read in a batch operation.
+ *
+ * @example
+ * ```tsx
+ * const markAllAsRead = useMarkAllAsRead({ userId: currentUser.uid });
+ *
+ * const handleMarkAllRead = (unreadNotifications: Notification[]) => {
+ *   markAllAsRead.mutate({ notifications: unreadNotifications });
+ * };
+ * ```
+ */
+export function useMarkAllAsRead({ userId, invalidateKeys, }) {
+    const batchMutation = useFirestoreBatch({
+        invalidateKeys: invalidateKeys ?? [
+            ['notifications', userId],
+            ['notifications-unread-count', userId],
+        ],
+    });
+    return {
+        mutate: ({ notificationIds }) => {
+            const operations = notificationIds.map((id) => ({
+                type: 'update',
+                docPath: `userData/${userId}/metadata/notifications/${id}`,
+                data: { isRead: true },
+            }));
+            batchMutation.mutate({ operations });
+        },
+        mutateAsync: async ({ notificationIds }) => {
+            const operations = notificationIds.map((id) => ({
+                type: 'update',
+                docPath: `userData/${userId}/metadata/notifications/${id}`,
+                data: { isRead: true },
+            }));
+            return batchMutation.mutateAsync({ operations });
+        },
+        isPending: batchMutation.isPending,
+        isError: batchMutation.isError,
+        error: batchMutation.error,
+    };
+}
+//# sourceMappingURL=useMarkAllAsRead.js.map

package/dist/hooks/useMarkAllAsRead.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMarkAllAsRead.js","sourceRoot":"","sources":["../../src/hooks/useMarkAllAsRead.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAUhE;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAC/B,MAAM,EACN,cAAc,GACU;IACxB,MAAM,aAAa,GAAG,iBAAiB,CAAC;QACtC,cAAc,EAAE,cAAc,IAAI;YAChC,CAAC,eAAe,EAAE,MAAM,CAAC;YACzB,CAAC,4BAA4B,EAAE,MAAM,CAAC;SACvC;KACF,CAAC,CAAC;IAEH,OAAO;QACL,MAAM,EAAE,CAAC,EAAE,eAAe,EAAiC,EAAE,EAAE;YAC7D,MAAM,UAAU,GAAwB,eAAe,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;gBACnE,IAAI,EAAE,QAAiB;gBACvB,OAAO,EAAE,YAAY,MAAM,2BAA2B,EAAE,EAAE;gBAC1D,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;aACvB,CAAC,CAAC,CAAC;YAEJ,aAAa,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;QACvC,CAAC;QACD,WAAW,EAAE,KAAK,EAAE,EAAE,eAAe,EAAiC,EAAE,EAAE;YACxE,MAAM,UAAU,GAAwB,eAAe,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;gBACnE,IAAI,EAAE,QAAiB;gBACvB,OAAO,EAAE,YAAY,MAAM,2BAA2B,EAAE,EAAE;gBAC1D,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;aACvB,CAAC,CAAC,CAAC;YAEJ,OAAO,aAAa,CAAC,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;QACnD,CAAC;QACD,SAAS,EAAE,aAAa,CAAC,SAAS;QAClC,OAAO,EAAE,aAAa,CAAC,OAAO;QAC9B,KAAK,EAAE,aAAa,CAAC,KAAK;KAC3B,CAAC;AACJ,CAAC"}

package/dist/hooks/useMarkAsRead.d.ts

@@ -0,0 +1,30 @@
+export interface UseMarkAsReadOptions {
+    /** User ID */
+    userId: string;
+    /** Query keys to invalidate after marking as read */
+    invalidateKeys?: readonly unknown[][];
+}
+/**
+ * Mark a single notification as read.
+ *
+ * @example
+ * ```tsx
+ * const markAsRead = useMarkAsRead({ userId: currentUser.uid });
+ *
+ * const handleNotificationClick = (notificationId: string) => {
+ *   markAsRead.mutate({ notificationId });
+ * };
+ * ```
+ */
+export declare function useMarkAsRead({ userId, invalidateKeys, }: UseMarkAsReadOptions): {
+    mutate: ({ notificationId }: {
+        notificationId: string;
+    }) => void;
+    mutateAsync: ({ notificationId }: {
+        notificationId: string;
+    }) => Promise<any>;
+    isPending: any;
+    isError: any;
+    error: any;
+};
+//# sourceMappingURL=useMarkAsRead.d.ts.map

package/dist/hooks/useMarkAsRead.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMarkAsRead.d.ts","sourceRoot":"","sources":["../../src/hooks/useMarkAsRead.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,oBAAoB;IACnC,cAAc;IACd,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,cAAc,CAAC,EAAE,SAAS,OAAO,EAAE,EAAE,CAAC;CACvC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,EAC5B,MAAM,EACN,cAAc,GACf,EAAE,oBAAoB;iCASU;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE;sCAMf;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE;;;;EAUrE"}

package/dist/hooks/useMarkAsRead.js

@@ -0,0 +1,40 @@
+'use client';
+import { useFirestoreUpdate } from '@ttt-productions/query-core';
+/**
+ * Mark a single notification as read.
+ *
+ * @example
+ * ```tsx
+ * const markAsRead = useMarkAsRead({ userId: currentUser.uid });
+ *
+ * const handleNotificationClick = (notificationId: string) => {
+ *   markAsRead.mutate({ notificationId });
+ * };
+ * ```
+ */
+export function useMarkAsRead({ userId, invalidateKeys, }) {
+    const updateMutation = useFirestoreUpdate({
+        invalidateKeys: invalidateKeys ?? [
+            ['notifications', userId],
+            ['notifications-unread-count', userId],
+        ],
+    });
+    return {
+        mutate: ({ notificationId }) => {
+            updateMutation.mutate({
+                docPath: `userData/${userId}/metadata/notifications/${notificationId}`,
+                data: { isRead: true },
+            });
+        },
+        mutateAsync: async ({ notificationId }) => {
+            return updateMutation.mutateAsync({
+                docPath: `userData/${userId}/metadata/notifications/${notificationId}`,
+                data: { isRead: true },
+            });
+        },
+        isPending: updateMutation.isPending,
+        isError: updateMutation.isError,
+        error: updateMutation.error,
+    };
+}
+//# sourceMappingURL=useMarkAsRead.js.map

package/dist/hooks/useMarkAsRead.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMarkAsRead.js","sourceRoot":"","sources":["../../src/hooks/useMarkAsRead.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAUjE;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAAC,EAC5B,MAAM,EACN,cAAc,GACO;IACrB,MAAM,cAAc,GAAG,kBAAkB,CAAe;QACtD,cAAc,EAAE,cAAc,IAAI;YAChC,CAAC,eAAe,EAAE,MAAM,CAAC;YACzB,CAAC,4BAA4B,EAAE,MAAM,CAAC;SACvC;KACF,CAAC,CAAC;IAEH,OAAO;QACL,MAAM,EAAE,CAAC,EAAE,cAAc,EAA8B,EAAE,EAAE;YACzD,cAAc,CAAC,MAAM,CAAC;gBACpB,OAAO,EAAE,YAAY,MAAM,2BAA2B,cAAc,EAAE;gBACtE,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;aACvB,CAAC,CAAC;QACL,CAAC;QACD,WAAW,EAAE,KAAK,EAAE,EAAE,cAAc,EAA8B,EAAE,EAAE;YACpE,OAAO,cAAc,CAAC,WAAW,CAAC;gBAChC,OAAO,EAAE,YAAY,MAAM,2BAA2B,cAAc,EAAE;gBACtE,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;aACvB,CAAC,CAAC;QACL,CAAC;QACD,SAAS,EAAE,cAAc,CAAC,SAAS;QACnC,OAAO,EAAE,cAAc,CAAC,OAAO;QAC/B,KAAK,EAAE,cAAc,CAAC,KAAK;KAC5B,CAAC;AACJ,CAAC"}

package/dist/hooks/useNotifications.d.ts

@@ -0,0 +1,25 @@
+export interface UseNotificationsOptions {
+    /** User ID to fetch notifications for */
+    userId: string;
+    /** Enable/disable the query */
+    enabled?: boolean;
+    /** Enable realtime updates (default: true) */
+    subscribe?: boolean;
+    /** Maximum number of notifications to fetch (default: 50) */
+    limit?: number;
+    /** Only fetch unread notifications */
+    unreadOnly?: boolean;
+}
+/**
+ * Fetch user notifications with optional realtime updates.
+ *
+ * @example
+ * ```tsx
+ * const { data: notifications, isLoading } = useNotifications({
+ *   userId: currentUser.uid,
+ *   subscribe: true,
+ * });
+ * ```
+ */
+export declare function useNotifications({ userId, enabled, subscribe, limit: maxResults, unreadOnly, }: UseNotificationsOptions): any;
+//# sourceMappingURL=useNotifications.d.ts.map

package/dist/hooks/useNotifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNotifications.d.ts","sourceRoot":"","sources":["../../src/hooks/useNotifications.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,uBAAuB;IACtC,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,MAAM,EACN,OAAc,EACd,SAAgB,EAChB,KAAK,EAAE,UAAe,EACtB,UAAkB,GACnB,EAAE,uBAAuB,OAiBzB"}

package/dist/hooks/useNotifications.js

@@ -0,0 +1,31 @@
+'use client';
+import { useFirestoreCollection } from '@ttt-productions/query-core';
+import { orderBy, limit, where } from 'firebase/firestore';
+/**
+ * Fetch user notifications with optional realtime updates.
+ *
+ * @example
+ * ```tsx
+ * const { data: notifications, isLoading } = useNotifications({
+ *   userId: currentUser.uid,
+ *   subscribe: true,
+ * });
+ * ```
+ */
+export function useNotifications({ userId, enabled = true, subscribe = true, limit: maxResults = 50, unreadOnly = false, }) {
+    const constraints = [
+        orderBy('createdAt', 'desc'),
+        limit(maxResults),
+    ];
+    if (unreadOnly) {
+        constraints.unshift(where('isRead', '==', false));
+    }
+    return useFirestoreCollection({
+        collectionPath: `userData/${userId}/metadata/notifications`,
+        queryKey: ['notifications', userId, { unreadOnly, limit: maxResults }],
+        constraints,
+        enabled: enabled && !!userId,
+        subscribe,
+    });
+}
+//# sourceMappingURL=useNotifications.js.map

package/dist/hooks/useNotifications.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNotifications.js","sourceRoot":"","sources":["../../src/hooks/useNotifications.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAwB,MAAM,oBAAoB,CAAC;AAgBjF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAC/B,MAAM,EACN,OAAO,GAAG,IAAI,EACd,SAAS,GAAG,IAAI,EAChB,KAAK,EAAE,UAAU,GAAG,EAAE,EACtB,UAAU,GAAG,KAAK,GACM;IACxB,MAAM,WAAW,GAAsB;QACrC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC;QAC5B,KAAK,CAAC,UAAU,CAAC;KAClB,CAAC;IAEF,IAAI,UAAU,EAAE,CAAC;QACf,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,sBAAsB,CAAe;QAC1C,cAAc,EAAE,YAAY,MAAM,yBAAyB;QAC3D,QAAQ,EAAE,CAAC,eAAe,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;QACtE,WAAW;QACX,OAAO,EAAE,OAAO,IAAI,CAAC,CAAC,MAAM;QAC5B,SAAS;KACV,CAAC,CAAC;AACL,CAAC"}

package/dist/hooks/useUnreadCount.d.ts

@@ -0,0 +1,24 @@
+export interface UseUnreadCountOptions {
+    /** User ID to fetch unread count for */
+    userId: string;
+    /** Enable/disable the query */
+    enabled?: boolean;
+    /** Enable realtime updates (default: true) */
+    subscribe?: boolean;
+}
+/**
+ * Get the count of unread notifications for a user.
+ *
+ * @example
+ * ```tsx
+ * const { data: unreadCount } = useUnreadCount({
+ *   userId: currentUser.uid,
+ *   subscribe: true,
+ * });
+ * ```
+ */
+export declare function useUnreadCount({ userId, enabled, subscribe, }: UseUnreadCountOptions): {
+    data: any;
+    notifications: any;
+};
+//# sourceMappingURL=useUnreadCount.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useUnreadCount.d.ts","sourceRoot":"","sources":["../../src/hooks/useUnreadCount.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,qBAAqB;IACpC,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,OAAc,EACd,SAAgB,GACjB,EAAE,qBAAqB;;;EAiBvB"}

package/dist/hooks/useUnreadCount.js

@@ -0,0 +1,31 @@
+'use client';
+import { useFirestoreCollection } from '@ttt-productions/query-core';
+import { where } from 'firebase/firestore';
+/**
+ * Get the count of unread notifications for a user.
+ *
+ * @example
+ * ```tsx
+ * const { data: unreadCount } = useUnreadCount({
+ *   userId: currentUser.uid,
+ *   subscribe: true,
+ * });
+ * ```
+ */
+export function useUnreadCount({ userId, enabled = true, subscribe = true, }) {
+    const constraints = [
+        where('isRead', '==', false),
+    ];
+    const { data: notifications } = useFirestoreCollection({
+        collectionPath: `userData/${userId}/metadata/notifications`,
+        queryKey: ['notifications-unread-count', userId],
+        constraints,
+        enabled: enabled && !!userId,
+        subscribe,
+    });
+    return {
+        data: notifications?.length ?? 0,
+        notifications,
+    };
+}
+//# sourceMappingURL=useUnreadCount.js.map

package/dist/hooks/useUnreadCount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUnreadCount.js","sourceRoot":"","sources":["../../src/hooks/useUnreadCount.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,KAAK,EAAwB,MAAM,oBAAoB,CAAC;AAYjE;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAAC,EAC7B,MAAM,EACN,OAAO,GAAG,IAAI,EACd,SAAS,GAAG,IAAI,GACM;IACtB,MAAM,WAAW,GAAsB;QACrC,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC;KAC7B,CAAC;IAEF,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,sBAAsB,CAAe;QACnE,cAAc,EAAE,YAAY,MAAM,yBAAyB;QAC3D,QAAQ,EAAE,CAAC,4BAA4B,EAAE,MAAM,CAAC;QAChD,WAAW;QACX,OAAO,EAAE,OAAO,IAAI,CAAC,CAAC,MAAM;QAC5B,SAAS;KACV,CAAC,CAAC;IAEH,OAAO;QACL,IAAI,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;QAChC,aAAa;KACd,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export type { Notification, NotificationInput, NotificationType, MarkAsReadOptions, DeleteNotificationOptions, NavigationHandler, NotificationTypeConfig, NotificationConfig, } from './types.js';
+export { useNotifications, useUnreadCount, useMarkAsRead, useMarkAllAsRead, } from './hooks/index.js';
+export type { UseNotificationsOptions, UseUnreadCountOptions, UseMarkAsReadOptions, UseMarkAllAsReadOptions, } from './hooks/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,yBAAyB,EACzB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+// Hooks
+export { useNotifications, useUnreadCount, useMarkAsRead, useMarkAllAsRead, } from './hooks/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAYA,QAAQ;AACR,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,gBAAgB,GACjB,MAAM,kBAAkB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,73 @@
+import type { Timestamp } from 'firebase/firestore';
+/**
+ * Base notification type that can be extended per app.
+ */
+export type NotificationType = string;
+/**
+ * Core notification document structure stored in Firestore.
+ */
+export interface Notification {
+    /** Unique notification ID (usually Firestore doc ID) */
+    id: string;
+    /** Type of notification - app-specific (e.g., 'trophy_received', 'game_scheduled') */
+    type: NotificationType;
+    /** Notification title */
+    title: string;
+    /** Notification message/body */
+    message: string;
+    /** Target path to navigate to when clicked (app-specific route) */
+    targetPath: string;
+    /** Optional URL/route parameters for navigation */
+    targetParams?: Record<string, any>;
+    /** Whether the notification has been read */
+    isRead: boolean;
+    /** When the notification was created */
+    createdAt: Timestamp;
+    /** Optional type-specific metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * Notification data without the ID (for creating new notifications).
+ */
+export type NotificationInput = Omit<Notification, 'id'>;
+/**
+ * Options for marking notifications as read.
+ */
+export interface MarkAsReadOptions {
+    /** Single notification ID to mark as read */
+    notificationId?: string;
+    /** Mark all notifications as read */
+    all?: boolean;
+}
+/**
+ * Options for deleting notifications.
+ */
+export interface DeleteNotificationOptions {
+    /** Single notification ID to delete */
+    notificationId?: string;
+    /** Delete all read notifications */
+    allRead?: boolean;
+}
+/**
+ * Navigation handler function signature that apps must provide.
+ */
+export type NavigationHandler = (path: string, params?: Record<string, any>) => void;
+/**
+ * Notification configuration per type (app-specific).
+ */
+export interface NotificationTypeConfig {
+    /** Icon or emoji to display */
+    icon?: string;
+    /** Color theme for the notification */
+    color?: string;
+    /** Custom navigation handler for this type */
+    navigateTo?: (params?: Record<string, any>) => string;
+}
+/**
+ * App-specific notification configuration.
+ */
+export interface NotificationConfig {
+    /** Map of notification types to their configurations */
+    types: Record<NotificationType, NotificationTypeConfig>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,wDAAwD;IACxD,EAAE,EAAE,MAAM,CAAC;IACX,sFAAsF;IACtF,IAAI,EAAE,gBAAgB,CAAC;IACvB,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,UAAU,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnC,6CAA6C;IAC7C,MAAM,EAAE,OAAO,CAAC;IAChB,wCAAwC;IACxC,SAAS,EAAE,SAAS,CAAC;IACrB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qCAAqC;IACrC,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,uCAAuC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oCAAoC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;AAErF;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,UAAU,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,MAAM,CAAC;CACvD;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC,gBAAgB,EAAE,sBAAsB,CAAC,CAAC;CACzD"}

package/dist/types.js

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

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,57 @@
+{
+    "name": "@ttt-productions/notification-core",
+    "version": "0.2.1",
+    "description": "Shared notification system for TTT Productions apps — active/history two-tier architecture with dedup, batch processing, and themed UI components",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/ttt-productions/ttt-packages.git",
+        "directory": "packages/notification-core"
+    },
+    "type": "module",
+    "main": "dist/index.js",
+    "module": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "sideEffects": false,
+    "files": [
+        "dist",
+        "src/styles"
+    ],
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "default": "./dist/index.js"
+        },
+        "./server": {
+            "types": "./dist/server/index.d.ts",
+            "default": "./dist/server/index.js"
+        },
+        "./styles": "./src/styles/notifications.css"
+    },
+    "scripts": {
+        "build": "tsc",
+        "clean": "rm -rf dist *.tsbuildinfo",
+        "typecheck": "tsc --noEmit",
+        "prepublishOnly": "npm run clean && npm run build"
+    },
+    "peerDependencies": {
+        "@tanstack/react-query": ">=5.0.0",
+        "@ttt-productions/query-core": ">=0.3.0",
+        "@ttt-productions/ui-core": ">=0.2.0",
+        "firebase": ">=10.0.0",
+        "react": ">=18.0.0",
+        "react-dom": ">=18.0.0"
+    },
+    "devDependencies": {
+        "@tanstack/react-query": "^5.0.0",
+        "@ttt-productions/query-core": "^0.3.7",
+        "@ttt-productions/ui-core": "^0.2.22",
+        "@types/react": "^19.0.0",
+        "@types/react-dom": "^19.0.0",
+        "firebase": "^11.0.0",
+        "react": "^19.2.0",
+        "react-dom": "^19.2.0",
+        "typescript": "^5.8.3"
+    },
+    "author": "DJ (TTT Productions)",
+    "license": "MIT"
+}