@edusight/notification-widget 1.0.1

package/README.md

@@ -0,0 +1,74 @@
+# EduSight Notification Widget
+
+React notification center widget with Material UI styling.
+
+## Installation
+
+```bash
+npm install @edusight/notification-widget
+```
+
+## Usage
+
+```tsx
+import { NotificationCenter } from '@edusight/notification-widget';
+import { NotificationClient } from '@edusight/notification-sdk';
+
+const client = new NotificationClient({
+  apiKey: 'your-api-key',
+  baseUrl: 'https://api.example.com',
+  tenantId: 'your-tenant-id',
+  environmentId: 'dev',
+});
+
+function App() {
+  return (
+    <NotificationCenter
+      client={client}
+      tenantId="your-tenant-id"
+      environmentId="dev"
+      subscriberId="user-123"
+      position="top-right"
+      showUnreadBadge={true}
+    />
+  );
+}
+```
+
+## Features
+
+- **Real-time Updates**: WebSocket integration with automatic reconnection and acknowledgement persistence
+- **Multi-environment**: Scoped connections using `environmentId` for each tenant
+- **Notification Grouping**: Group by date (Today, Yesterday, This Week, etc.)
+- **Preferences**: Channel and category preference management
+- **Actions**: Mark as read, delete notifications
+- **Filtering**: Filter by all/unread
+- **Customizable**: Position, theme, max notifications
+
+## Components
+
+- `NotificationCenter` - Main notification center component
+- `NotificationBell` - Bell icon with unread badge
+- `NotificationList` - List of notifications with grouping
+- `NotificationItem` - Individual notification item
+- `Preferences` - Preference management component
+
+## Props
+
+### NotificationCenter
+
+- `client`: NotificationClient instance
+- `tenantId`: Tenant ID
+- `environmentId`: Environment ID (e.g., `dev`, `staging`, `prod`)
+- `subscriberId`: Subscriber ID
+- `position?`: Position ('top-left' | 'top-right' | 'bottom-left' | 'bottom-right')
+- `theme?`: Theme ('default' | 'dark')
+- `maxNotifications?`: Maximum notifications to display
+- `showUnreadBadge?`: Show unread count badge
+- `onNotificationClick?`: Click handler
+- `onMarkAsRead?`: Mark as read handler
+- `onDelete?`: Delete handler
+- `pollInterval?`: Polling interval in ms
+## License
+
+MIT

package/dist/components/EmptyState.d.ts

@@ -0,0 +1,7 @@
+import { default as React } from 'react';
+export interface EmptyStateProps {
+    message?: string;
+    icon?: React.ReactNode;
+}
+export declare const EmptyState: React.FC<EmptyStateProps>;
+//# sourceMappingURL=EmptyState.d.ts.map

package/dist/components/EmptyState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmptyState.d.ts","sourceRoot":"","sources":["../../src/components/EmptyState.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CACxB;AAED,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAehD,CAAC"}

package/dist/components/NotificationBell.d.ts

@@ -0,0 +1,8 @@
+import { default as React } from 'react';
+export interface NotificationBellProps {
+    unreadCount?: number;
+    onClick?: (event: React.MouseEvent<HTMLButtonElement>) => void;
+    showBadge?: boolean;
+}
+export declare const NotificationBell: React.FC<NotificationBellProps>;
+//# sourceMappingURL=NotificationBell.d.ts.map

package/dist/components/NotificationBell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotificationBell.d.ts","sourceRoot":"","sources":["../../src/components/NotificationBell.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IAC/D,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAgB5D,CAAC"}

package/dist/components/NotificationCenter.d.ts

@@ -0,0 +1,18 @@
+import { default as React } from 'react';
+import { Notification, NotificationClient } from '@edusight/notification-sdk';
+export interface NotificationCenterProps {
+    client: NotificationClient;
+    tenantId: string;
+    subscriberId: string;
+    environmentId: string;
+    position?: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+    theme?: 'default' | 'dark';
+    maxNotifications?: number;
+    showUnreadBadge?: boolean;
+    onNotificationClick?: (notification: Notification) => void;
+    onMarkAsRead?: (notificationId: string) => Promise<void>;
+    onDelete?: (notificationId: string) => Promise<void>;
+    pollInterval?: number;
+}
+export declare const NotificationCenter: React.FC<NotificationCenterProps>;
+//# sourceMappingURL=NotificationCenter.d.ts.map

package/dist/components/NotificationCenter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotificationCenter.d.ts","sourceRoot":"","sources":["../../src/components/NotificationCenter.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmB,MAAM,OAAO,CAAC;AAExC,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAK9E,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,UAAU,GAAG,WAAW,GAAG,aAAa,GAAG,cAAc,CAAC;IACrE,KAAK,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,mBAAmB,CAAC,EAAE,CAAC,YAAY,EAAE,YAAY,KAAK,IAAI,CAAC;IAC3D,YAAY,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,QAAQ,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CA+HhE,CAAC"}

package/dist/components/NotificationGroup.d.ts

@@ -0,0 +1,13 @@
+import { default as React } from 'react';
+import { Notification } from '@edusight/notification-sdk';
+export interface NotificationGroupProps {
+    groupLabel: string;
+    notifications: Notification[];
+    onMarkAsRead?: (notificationId: string) => void;
+    onDelete?: (notificationId: string) => void;
+    onClick?: (notification: Notification) => void;
+}
+export declare const NotificationGroup: React.FC<NotificationGroupProps>;
+export declare function groupNotificationsByDate(notifications: Notification[]): Record<string, Notification[]>;
+export declare function getGroupLabel(key: string): string;
+//# sourceMappingURL=NotificationGroup.d.ts.map

package/dist/components/NotificationGroup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotificationGroup.d.ts","sourceRoot":"","sources":["../../src/components/NotificationGroup.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAI1D,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,YAAY,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,QAAQ,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,YAAY,KAAK,IAAI,CAAC;CAChD;AAED,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CA4B9D,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CA0BtG;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAejD"}

package/dist/components/NotificationItem.d.ts

@@ -0,0 +1,10 @@
+import { default as React } from 'react';
+import { Notification } from '@edusight/notification-sdk';
+export interface NotificationItemProps {
+    notification: Notification;
+    onMarkAsRead?: (notificationId: string) => void;
+    onDelete?: (notificationId: string) => void;
+    onClick?: (notification: Notification) => void;
+}
+export declare const NotificationItem: React.FC<NotificationItemProps>;
+//# sourceMappingURL=NotificationItem.d.ts.map

package/dist/components/NotificationItem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotificationItem.d.ts","sourceRoot":"","sources":["../../src/components/NotificationItem.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAY1B,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,YAAY,CAAC;IAC3B,YAAY,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,QAAQ,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,YAAY,KAAK,IAAI,CAAC;CAChD;AAED,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAoF5D,CAAC"}

package/dist/components/NotificationList.d.ts

@@ -0,0 +1,16 @@
+import { default as React } from 'react';
+import { Notification } from '@edusight/notification-sdk';
+export interface NotificationListProps {
+    notifications: Notification[];
+    loading?: boolean;
+    error?: Error | null;
+    onNotificationClick?: (notification: Notification) => void;
+    onMarkAsRead?: (notificationId: string) => Promise<void>;
+    onDelete?: (notificationId: string) => Promise<void>;
+    subscriberId?: string;
+    tenantId?: string;
+    client?: any;
+    groupByDate?: boolean;
+}
+export declare const NotificationList: React.FC<NotificationListProps>;
+//# sourceMappingURL=NotificationList.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NotificationList.d.ts","sourceRoot":"","sources":["../../src/components/NotificationList.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmB,MAAM,OAAO,CAAC;AAGxC,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAM1D,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IACrB,mBAAmB,CAAC,EAAE,CAAC,YAAY,EAAE,YAAY,KAAK,IAAI,CAAC;IAC3D,YAAY,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,QAAQ,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAiH5D,CAAC"}

package/dist/components/Preferences.d.ts

@@ -0,0 +1,10 @@
+import { default as React } from 'react';
+import { NotificationClient } from '@edusight/notification-sdk';
+export interface PreferencesProps {
+    client: NotificationClient;
+    subscriberId: string;
+    tenantId: string;
+    onClose?: () => void;
+}
+export declare const Preferences: React.FC<PreferencesProps>;
+//# sourceMappingURL=Preferences.d.ts.map

package/dist/components/Preferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Preferences.d.ts","sourceRoot":"","sources":["../../src/components/Preferences.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAC;AAEnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAoBD,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,gBAAgB,CA+IlD,CAAC"}

package/dist/hooks/useNotificationCenter.d.ts

@@ -0,0 +1,22 @@
+import { Notification, NotificationClient } from '@edusight/notification-sdk';
+export interface UseNotificationCenterOptions {
+    client: NotificationClient;
+    tenantId: string;
+    subscriberId: string;
+    environmentId: string;
+    pollInterval?: number;
+    autoFetch?: boolean;
+    autoAck?: boolean;
+}
+export interface UseNotificationCenterReturn {
+    notifications: Notification[];
+    loading: boolean;
+    error: Error | null;
+    unreadCount: number;
+    connected: boolean;
+    refresh: () => Promise<void>;
+    markAsRead: (notificationId: string) => Promise<void>;
+    deleteNotification: (notificationId: string) => Promise<void>;
+}
+export declare function useNotificationCenter(options: UseNotificationCenterOptions): UseNotificationCenterReturn;
+//# sourceMappingURL=useNotificationCenter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useNotificationCenter.d.ts","sourceRoot":"","sources":["../../src/hooks/useNotificationCenter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAsB,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAIlG,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,2BAA2B;IAC1C,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,UAAU,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,kBAAkB,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/D;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,4BAA4B,GACpC,2BAA2B,CAyE7B"}

package/dist/hooks/useNotifications.d.ts

@@ -0,0 +1,21 @@
+import { NotificationClient, Notification, NotificationFilters } from '@edusight/notification-sdk';
+export interface UseNotificationsOptions {
+    client: NotificationClient;
+    tenantId: string;
+    subscriberId?: string;
+    filters?: NotificationFilters;
+    pollInterval?: number;
+    autoFetch?: boolean;
+    maxNotifications?: number;
+}
+export interface UseNotificationsReturn {
+    notifications: Notification[];
+    loading: boolean;
+    error: Error | null;
+    unreadCount: number;
+    refresh: () => Promise<void>;
+    markAsRead: (notificationId: string) => Promise<void>;
+    deleteNotification: (notificationId: string) => Promise<void>;
+}
+export declare function useNotifications(options: UseNotificationsOptions): UseNotificationsReturn;
+//# 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":"AACA,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEnG,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,UAAU,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,kBAAkB,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/D;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,sBAAsB,CAoFzF"}

package/dist/hooks/useWebSocket.d.ts

@@ -0,0 +1,20 @@
+import { Notification, NotificationSocketAckEvent, NotificationClient } from '@edusight/notification-sdk';
+export interface UseWebSocketOptions {
+    client: NotificationClient;
+    tenantId: string;
+    subscriberId: string;
+    environmentId: string;
+    enabled?: boolean;
+    autoAck?: boolean;
+}
+export interface UseWebSocketReturn {
+    connected: boolean;
+    connect: () => void;
+    disconnect: () => void;
+    onNotification: (handler: (notification: Notification) => void) => () => void;
+    onAck: (handler: (ack: NotificationSocketAckEvent) => void) => () => void;
+    ackNotification: (notificationId: string) => void;
+    error: Error | null;
+}
+export declare function useWebSocket(options: UseWebSocketOptions): UseWebSocketReturn;
+//# sourceMappingURL=useWebSocket.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useWebSocket.d.ts","sourceRoot":"","sources":["../../src/hooks/useWebSocket.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAG1G,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,cAAc,EAAE,CAAC,OAAO,EAAE,CAAC,YAAY,EAAE,YAAY,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;IAC9E,KAAK,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,0BAA0B,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;IAC1E,eAAe,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,kBAAkB,CAiG7E"}