@ttt-productions/notification-core 0.2.1 → 0.2.3

package/dist/server/processBatchHelper.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Batch processor helper — called by the app's scheduled Cloud Function.
+ * Reads pending notifications, groups by dedupKey, creates/increments active docs.
+ */
+import type { NotificationSystemConfig } from '../types.js';
+import type { ServerFirestore } from './types.js';
+interface BatchProcessResult {
+    totalProcessed: number;
+    notificationsCreated: number;
+    notificationsUpdated: number;
+}
+/**
+ * Process the pending notifications queue.
+ *
+ * @example
+ * ```ts
+ * // In your scheduled Cloud Function:
+ * export const processNotificationBatch = onSchedule(
+ *   { schedule: 'every 10 minutes' },
+ *   async () => {
+ *     const result = await processBatchHelper(db as any, TTT_NOTIFICATION_CONFIG);
+ *     logger.info('Batch processed', result);
+ *   }
+ * );
+ * ```
+ */
+export declare function processBatchHelper(db: ServerFirestore, config: NotificationSystemConfig): Promise<BatchProcessResult>;
+export {};
+//# sourceMappingURL=processBatchHelper.d.ts.map

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

@@ -0,0 +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;AAOlD,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,CAmK7B"}

package/dist/server/processBatchHelper.js

@@ -0,0 +1,158 @@
+/**
+ * Batch processor helper — called by the app's scheduled Cloud Function.
+ * Reads pending notifications, groups by dedupKey, creates/increments active docs.
+ */
+const DEFAULT_COUNT_CAP = 5000;
+const DEFAULT_ACTOR_CAP = 5;
+const PROCESSING_BATCH_SIZE = 500;
+const MAX_ITERATIONS = 20;
+/**
+ * Process the pending notifications queue.
+ *
+ * @example
+ * ```ts
+ * // In your scheduled Cloud Function:
+ * export const processNotificationBatch = onSchedule(
+ *   { schedule: 'every 10 minutes' },
+ *   async () => {
+ *     const result = await processBatchHelper(db as any, TTT_NOTIFICATION_CONFIG);
+ *     logger.info('Batch processed', result);
+ *   }
+ * );
+ * ```
+ */
+export async function processBatchHelper(db, config) {
+    const pendingPath = config.pendingCollectionPath ?? 'pendingNotifications';
+    const cutoff = Date.now() - 30_000; // Process items older than 30 seconds
+    let totalProcessed = 0;
+    let notificationsCreated = 0;
+    let notificationsUpdated = 0;
+    let iterations = 0;
+    let hasMore = true;
+    while (hasMore && iterations < MAX_ITERATIONS) {
+        iterations++;
+        const pendingQuery = db.collection(pendingPath)
+            .where('createdAt', '<=', cutoff)
+            .orderBy('createdAt', 'asc')
+            .limit(PROCESSING_BATCH_SIZE);
+        const snapshot = await pendingQuery.get();
+        if (snapshot.empty) {
+            hasMore = false;
+            break;
+        }
+        // Group by dedupKey
+        const groups = new Map();
+        for (const docSnap of snapshot.docs) {
+            const data = docSnap.data();
+            const typeConfig = config.types[data.type];
+            if (!typeConfig)
+                continue;
+            const dedupKey = typeConfig.dedupKeyPattern(data.metadata);
+            const groupKey = `${data.category}::${dedupKey}`;
+            const existing = groups.get(groupKey);
+            if (existing) {
+                existing.count++;
+                // Add actor if not already present
+                if (!existing.actors.some((a) => a.id === data.actorId)) {
+                    existing.actors.push({ id: data.actorId, name: data.actorName });
+                }
+                existing.docs.push(docSnap);
+            }
+            else {
+                groups.set(groupKey, {
+                    type: data.type,
+                    category: data.category,
+                    targetUserId: data.targetUserId,
+                    metadata: data.metadata,
+                    actors: [{ id: data.actorId, name: data.actorName }],
+                    count: 1,
+                    docs: [docSnap],
+                });
+            }
+        }
+        // Process each group: dedup check against active, create or increment
+        for (const [, group] of groups) {
+            const typeConfig = config.types[group.type];
+            if (!typeConfig)
+                continue;
+            const categoryConfig = config.categories[group.category];
+            if (!categoryConfig)
+                continue;
+            const activePath = categoryConfig.activePath;
+            const dedupKey = typeConfig.dedupKeyPattern(group.metadata);
+            const countCap = typeConfig.countCap ?? DEFAULT_COUNT_CAP;
+            const actorCap = typeConfig.actorCap ?? DEFAULT_ACTOR_CAP;
+            // Check for existing active notification
+            const existingQuery = db.collection(activePath)
+                .where('dedupKey', '==', dedupKey)
+                .where('category', '==', group.category)
+                .limit(1);
+            const existingSnap = await existingQuery.get();
+            if (!existingSnap.empty) {
+                // Increment existing
+                const existingDoc = existingSnap.docs[0];
+                const existingData = existingDoc.data();
+                const currentCount = existingData.count || 1;
+                const currentActorIds = existingData.latestActorIds || [];
+                const currentActorNames = existingData.latestActorNames || [];
+                // Merge actors (new first, deduped, capped)
+                const newActors = group.actors.filter((a) => !currentActorIds.includes(a.id));
+                const mergedActorIds = [
+                    ...newActors.map((a) => a.id),
+                    ...currentActorIds,
+                ].slice(0, actorCap);
+                const mergedActorNames = [
+                    ...newActors.map((a) => a.name),
+                    ...currentActorNames,
+                ].slice(0, actorCap);
+                const newCount = Math.min(currentCount + group.count, countCap);
+                await existingDoc.ref.update({
+                    count: newCount,
+                    latestActorIds: mergedActorIds,
+                    latestActorNames: mergedActorNames,
+                    message: typeConfig.messagePattern(group.metadata, newCount),
+                    updatedAt: Date.now(),
+                });
+                notificationsUpdated++;
+            }
+            else {
+                // Create new notification
+                const targetPath = typeof typeConfig.defaultTargetPath === 'function'
+                    ? typeConfig.defaultTargetPath(group.metadata)
+                    : typeConfig.defaultTargetPath;
+                const now = Date.now();
+                const newDoc = {
+                    type: group.type,
+                    dedupKey,
+                    category: group.category,
+                    targetUserId: group.targetUserId,
+                    title: typeConfig.titlePattern(group.metadata),
+                    message: typeConfig.messagePattern(group.metadata, group.count),
+                    count: group.count,
+                    latestActorIds: group.actors.map((a) => a.id).slice(0, actorCap),
+                    latestActorNames: group.actors.map((a) => a.name).slice(0, actorCap),
+                    targetPath,
+                    metadata: group.metadata,
+                    createdAt: now,
+                    updatedAt: now,
+                };
+                await db.collection(activePath).add(newDoc);
+                notificationsCreated++;
+            }
+        }
+        // Delete processed pending docs in batches of 500
+        const allDocs = snapshot.docs;
+        for (let i = 0; i < allDocs.length; i += 500) {
+            const chunk = allDocs.slice(i, i + 500);
+            const batch = db.batch();
+            chunk.forEach((docSnap) => batch.delete(docSnap.ref));
+            await batch.commit();
+        }
+        totalProcessed += snapshot.size;
+        if (snapshot.size < PROCESSING_BATCH_SIZE) {
+            hasMore = false;
+        }
+    }
+    return { totalProcessed, notificationsCreated, notificationsUpdated };
+}
+//# sourceMappingURL=processBatchHelper.js.map

package/dist/server/processBatchHelper.js.map

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

package/dist/server/types.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Server-side types for notification-core backend helpers.
+ * These use firebase-admin Firestore types passed in by the calling app.
+ */
+/**
+ * Firestore interface — matches firebase-admin's Firestore type.
+ * We accept this instead of importing firebase-admin directly.
+ */
+export interface ServerFirestore {
+    collection(path: string): ServerCollectionRef;
+    doc(path: string): ServerDocRef;
+    batch(): ServerWriteBatch;
+}
+export interface ServerCollectionRef {
+    doc(id?: string): ServerDocRef;
+    where(field: string, op: string, value: unknown): ServerQuery;
+    orderBy(field: string, direction?: 'asc' | 'desc'): ServerQuery;
+    limit(n: number): ServerQuery;
+    add(data: Record<string, unknown>): Promise<ServerDocRef>;
+}
+export interface ServerQuery {
+    where(field: string, op: string, value: unknown): ServerQuery;
+    orderBy(field: string, direction?: 'asc' | 'desc'): ServerQuery;
+    limit(n: number): ServerQuery;
+    get(): Promise<ServerQuerySnapshot>;
+}
+export interface ServerQuerySnapshot {
+    empty: boolean;
+    size: number;
+    docs: ServerDocSnapshot[];
+}
+export interface ServerDocSnapshot {
+    id: string;
+    exists: boolean;
+    data(): Record<string, unknown> | undefined;
+    ref: ServerDocRef;
+}
+export interface ServerDocRef {
+    id: string;
+    set(data: Record<string, unknown>, options?: {
+        merge?: boolean;
+    }): Promise<unknown>;
+    update(data: Record<string, unknown>): Promise<unknown>;
+    delete(): Promise<unknown>;
+    get(): Promise<ServerDocSnapshot>;
+}
+export interface ServerWriteBatch {
+    set(ref: ServerDocRef, data: Record<string, unknown>, options?: {
+        merge?: boolean;
+    }): ServerWriteBatch;
+    update(ref: ServerDocRef, data: Record<string, unknown>): ServerWriteBatch;
+    delete(ref: ServerDocRef): ServerWriteBatch;
+    commit(): Promise<unknown>;
+}
+/**
+ * Input for creating a notification via the helper.
+ */
+export interface CreateNotificationInput {
+    /** Notification type (must exist in config.types) */
+    type: string;
+    /** Actor who triggered this notification */
+    actorId: string;
+    /** Actor display name */
+    actorName: string;
+    /** Target user ID (required for 'personal' audience types) */
+    targetUserId?: string | null;
+    /** Type-specific metadata */
+    metadata: Record<string, unknown>;
+}
+/**
+ * Return type from createNotificationHelper factory.
+ */
+export interface NotificationHelper {
+    /** Send a notification using the configured delivery mode (realtime or queued) */
+    send(input: CreateNotificationInput): Promise<void>;
+    /** Send immediately (bypass queue, write directly to active collection) */
+    sendRealTime(input: CreateNotificationInput): Promise<void>;
+    /** Queue for batch processing */
+    queueForBatch(input: CreateNotificationInput): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/server/types.js

@@ -0,0 +1,6 @@
+/**
+ * Server-side types for notification-core backend helpers.
+ * These use firebase-admin Firestore types passed in by the calling app.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/server/types.js.map

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

package/dist/types.d.ts

@@ -1,73 +1,188 @@
-import type { Timestamp } from 'firebase/firestore';
 /**
- * Base notification type that can be extended per app.
+ * @ttt-productions/notification-core — Type definitions
+ *
+ * Two-tier notification system: active (unread) → history (archived).
+ * No `isRead` flag — existence in the active collection means unread.
  */
-export type NotificationType = string;
 /**
- * Core notification document structure stored in Firestore.
+ * Active notification document stored in Firestore.
+ * Same shape for both user and admin collections.
  */
-export interface Notification {
-    /** Unique notification ID (usually Firestore doc ID) */
+export interface NotificationDoc {
+    /** Firestore doc ID */
     id: string;
-    /** Type of notification - app-specific (e.g., 'trophy_received', 'game_scheduled') */
-    type: NotificationType;
+    /** Notification type (e.g. 'content_report', 'project_invite') */
+    type: string;
+    /** Dedup key (e.g. 'report_projectXYZ') — same key = same notification */
+    dedupKey: string;
+    /** Category: 'user' | 'admin' (extensible) */
+    category: string;
+    /** userId for 'user' category, null for 'admin' (shared) */
+    targetUserId: string | null;
     /** Notification title */
     title: string;
-    /** Notification message/body */
+    /** Notification body */
     message: string;
-    /** Target path to navigate to when clicked (app-specific route) */
+    /** Incremented on duplicates */
+    count: number;
+    /** Last N actor user IDs (capped) */
+    latestActorIds: string[];
+    /** Display names matching latestActorIds */
+    latestActorNames: string[];
+    /** Route path when clicked (e.g. '/admin' or '/projects/abc') */
     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>;
+    /** Type-specific metadata (e.g. { projectId, reason }) */
+    metadata: Record<string, unknown>;
+    /** First occurrence */
+    createdAt: number;
+    /** Latest occurrence */
+    updatedAt: number;
 }
 /**
- * Notification data without the ID (for creating new notifications).
+ * Archival audit trail — stored on every history doc.
  */
-export type NotificationInput = Omit<Notification, 'id'>;
+export interface ArchivalInfo {
+    /** userId who clicked/dismissed */
+    archivedBy: string;
+    /** Epoch ms */
+    archivedAt: number;
+    /** Device context */
+    device: 'web' | 'mobile';
+}
 /**
- * Options for marking notifications as read.
+ * History document — extends active with archival info.
  */
-export interface MarkAsReadOptions {
-    /** Single notification ID to mark as read */
-    notificationId?: string;
-    /** Mark all notifications as read */
-    all?: boolean;
+export interface NotificationHistoryDoc extends NotificationDoc {
+    /** Who/when/how it was archived */
+    archival: ArchivalInfo;
+    /** Admin userId (admin history only, quick-access field) */
+    handledBy?: string;
 }
 /**
- * Options for deleting notifications.
+ * Pending notification — queue item for the batch processor.
  */
-export interface DeleteNotificationOptions {
-    /** Single notification ID to delete */
-    notificationId?: string;
-    /** Delete all read notifications */
-    allRead?: boolean;
+export interface PendingNotification {
+    id: string;
+    /** Notification type */
+    type: string;
+    /** Target category */
+    category: string;
+    /** Target userId (null for admin/shared) */
+    targetUserId: string | null;
+    /** Who triggered this */
+    actorId: string;
+    /** Actor display name */
+    actorName: string;
+    /** Type-specific data for building the notification */
+    metadata: Record<string, unknown>;
+    /** Epoch ms */
+    createdAt: number;
 }
 /**
- * Navigation handler function signature that apps must provide.
+ * Per-category configuration (user vs admin).
  */
-export type NavigationHandler = (path: string, params?: Record<string, any>) => void;
+export interface NotificationCategoryConfig {
+    /** Firestore collection path for active notifications */
+    activePath: string;
+    /** Function that returns the history collection path */
+    historyPath: (userId?: string) => string;
+    /** 'personal' requires targetUserId, 'shared' = all members see everything */
+    audienceType: 'personal' | 'shared';
+}
 /**
- * Notification configuration per type (app-specific).
+ * Per-type configuration for a notification type.
  */
 export interface NotificationTypeConfig {
-    /** Icon or emoji to display */
+    /** Which category this type belongs to */
+    category: string;
+    /** Delivery mode */
+    delivery: 'realtime' | 'queued';
+    /** Function to build the dedupKey from metadata */
+    dedupKeyPattern: (metadata: Record<string, unknown>) => string;
+    /** Function to build the title from metadata */
+    titlePattern: (metadata: Record<string, unknown>) => string;
+    /** Function to build the message from metadata + count */
+    messagePattern: (metadata: Record<string, unknown>, count: number) => string;
+    /** Default target path, or function to build from metadata */
+    defaultTargetPath: string | ((metadata: Record<string, unknown>) => string);
+    /** Max count value (default 5000) */
+    countCap?: number;
+    /** Max latestActorIds array length (default 5) */
+    actorCap?: number;
+    /** Icon/emoji for display (optional) */
     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.
+ * Full notification system configuration — provided by each app.
  */
-export interface NotificationConfig {
-    /** Map of notification types to their configurations */
-    types: Record<NotificationType, NotificationTypeConfig>;
+export interface NotificationSystemConfig {
+    /** Category definitions */
+    categories: Record<string, NotificationCategoryConfig>;
+    /** Type definitions */
+    types: Record<string, NotificationTypeConfig>;
+    /** Batch processor interval in minutes (default 10) */
+    batchIntervalMinutes?: number;
+    /** Firestore collection for pending notifications (default 'pendingNotifications') */
+    pendingCollectionPath?: string;
+}
+export interface UseActiveNotificationsOptions {
+    config: NotificationSystemConfig;
+    userId: string;
+    category: string;
+    enabled?: boolean;
+    pageSize?: number;
+    refetchInterval?: number;
+}
+export interface UseUnreadCountOptions {
+    config: NotificationSystemConfig;
+    userId: string;
+    category: string;
+    enabled?: boolean;
+    refetchInterval?: number;
+    countLimit?: number;
+}
+export interface UseArchiveNotificationOptions {
+    config: NotificationSystemConfig;
+    userId: string;
+    category: string;
+    invalidateKeys?: readonly unknown[][];
+}
+export interface UseArchiveAllNotificationsOptions {
+    config: NotificationSystemConfig;
+    userId: string;
+    category: string;
+    invalidateKeys?: readonly unknown[][];
+}
+export interface UseNotificationHistoryOptions {
+    config: NotificationSystemConfig;
+    userId: string;
+    category: string;
+    enabled?: boolean;
+    pageSize?: number;
+}
+export interface NotificationListProps {
+    config: NotificationSystemConfig;
+    userId: string;
+    category: string;
+    onNotificationClick: (notification: NotificationDoc) => void;
+    onClearAll?: () => void;
+    refetchInterval?: number;
+    device?: 'web' | 'mobile';
+    emptyText?: string;
+}
+export interface NotificationEmptyStateProps {
+    text?: string;
+}
+export interface NotificationHistoryListProps {
+    config: NotificationSystemConfig;
+    userId: string;
+    category: string;
+    onNotificationClick?: (notification: NotificationHistoryDoc) => void;
+}
+export interface NotificationUnreadBadgeProps {
+    config: NotificationSystemConfig;
+    userId: string;
+    category: string;
+    refetchInterval?: number;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -1,2 +1,8 @@
+/**
+ * @ttt-productions/notification-core — Type definitions
+ *
+ * Two-tier notification system: active (unread) → history (archived).
+ * No `isRead` flag — existence in the active collection means unread.
+ */
 export {};
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@ttt-productions/notification-core",
-    "version": "0.2.1",
+    "version": "0.2.3",
     "description": "Shared notification system for TTT Productions apps — active/history two-tier architecture with dedup, batch processing, and themed UI components",
     "repository": {
         "type": "git",
@@ -21,6 +21,10 @@
             "types": "./dist/index.d.ts",
             "default": "./dist/index.js"
         },
+        "./react": {
+            "types": "./dist/react/index.d.ts",
+            "default": "./dist/react/index.js"
+        },
         "./server": {
             "types": "./dist/server/index.d.ts",
             "default": "./dist/server/index.js"
@@ -31,20 +35,20 @@
         "build": "tsc",
         "clean": "rm -rf dist *.tsbuildinfo",
         "typecheck": "tsc --noEmit",
-        "prepublishOnly": "npm run clean && npm run build"
+        "prepublishOnly": "npm run build"
     },
     "peerDependencies": {
         "@tanstack/react-query": ">=5.0.0",
-        "@ttt-productions/query-core": ">=0.3.0",
-        "@ttt-productions/ui-core": ">=0.2.0",
+        "@ttt-productions/query-core": "*",
+        "@ttt-productions/ui-core": "*",
         "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",
+        "@ttt-productions/query-core": "*",
+        "@ttt-productions/ui-core": "*",
         "@types/react": "^19.0.0",
         "@types/react-dom": "^19.0.0",
         "firebase": "^11.0.0",