analytica-frontend-lib 1.1.35 → 1.1.36

package/dist/index.d.mts

@@ -10,6 +10,7 @@ export { default as Table } from './Table/index.mjs';
 export { default as CheckBox } from './CheckBox/index.mjs';
 import * as react from 'react';
 import { ReactNode, HTMLAttributes, InputHTMLAttributes } from 'react';
+import * as zustand from 'zustand';
 import { StoreApi } from 'zustand';
 export { default as Radio, RadioGroup, RadioGroupItem } from './Radio/index.mjs';
 export { default as TextArea } from './TextArea/index.mjs';
@@ -46,7 +47,8 @@ export { useApiConfig } from './Auth/useApiConfig/index.mjs';
 export { Quiz, QuizAlternative, QuizConnectDots, QuizContent, QuizDissertative, QuizFooter, QuizHeader, QuizHeaderResult, QuizImageQuestion, QuizListResult, QuizListResultByMateria, QuizMultipleChoice, QuizQuestionList, QuizResultHeaderTitle, QuizResultPerformance, QuizResultTitle, QuizTitle, QuizTrueOrFalse, getStatusBadge } from './Quiz/index.mjs';
 export { ANSWER_STATUS, Activity, Lesson, QUESTION_DIFFICULTY, QUESTION_STATUS, QUESTION_TYPE, Question, QuestionResult, QuizState, SUBTYPE_ENUM, Simulated, UserAnswerItem, useQuizStore } from './Quiz/useQuizStore/index.mjs';
 export { default as LoadingModal } from './LoadingModal/index.mjs';
-export { default as NotificationCard, NotificationGroup, NotificationItem } from './NotificationCard/index.mjs';
+import { N as NotificationApiClient, a as Notification, F as FetchNotificationsParams, b as NotificationGroup } from './NotificationCard-IYDURfYp.mjs';
+export { B as BackendNotification, g as BackendNotificationsResponse, c as NotificationCard, e as NotificationEntityType, d as NotificationItem, f as NotificationType, h as NotificationsResponse } from './NotificationCard-IYDURfYp.mjs';
 import 'react/jsx-runtime';
 
 /**
@@ -134,6 +136,127 @@ declare const CheckboxListItem: react.ForwardRefExoticComponent<{
     state?: CheckboxListState;
     /** Additional CSS classes */
     className?: string;
-} & Omit<InputHTMLAttributes<HTMLInputElement>, "size" | "value" | "checked" | "type" | "name" | "onChange"> & react.RefAttributes<HTMLInputElement>>;
+} & Omit<InputHTMLAttributes<HTMLInputElement>, "onChange" | "name" | "type" | "size" | "value" | "checked"> & react.RefAttributes<HTMLInputElement>>;
 
-export { CheckboxList, CheckboxListItem };
+/**
+ * Notification store state interface
+ */
+interface NotificationState {
+    /**
+     * List of all notifications
+     */
+    notifications: Notification[];
+    /**
+     * Number of unread notifications
+     */
+    unreadCount: number;
+    /**
+     * Loading state
+     */
+    loading: boolean;
+    /**
+     * Error state
+     */
+    error: string | null;
+    /**
+     * Whether there are more notifications to load
+     */
+    hasMore: boolean;
+    /**
+     * Current page for pagination
+     */
+    currentPage: number;
+}
+/**
+ * Notification store actions interface
+ */
+interface NotificationActions {
+    /**
+     * Fetch notifications from API
+     */
+    fetchNotifications: (params?: FetchNotificationsParams) => Promise<void>;
+    /**
+     * Mark a specific notification as read
+     */
+    markAsRead: (id: string) => Promise<void>;
+    /**
+     * Mark all notifications as read
+     */
+    markAllAsRead: () => Promise<void>;
+    /**
+     * Delete a notification
+     */
+    deleteNotification: (id: string) => Promise<void>;
+    /**
+     * Clear all notifications
+     */
+    clearNotifications: () => void;
+    /**
+     * Reset error state
+     */
+    resetError: () => void;
+    /**
+     * Group notifications by time periods
+     */
+    getGroupedNotifications: () => NotificationGroup[];
+}
+type NotificationStore = NotificationState & NotificationActions;
+/**
+ * Format time relative to now
+ */
+declare const formatTimeAgo: (date: Date) => string;
+/**
+ * Create notification store with injected API client
+ */
+declare const createNotificationStore: (apiClient: NotificationApiClient) => zustand.UseBoundStore<Omit<zustand.StoreApi<NotificationStore>, "setState" | "devtools"> & {
+    setState(partial: NotificationStore | Partial<NotificationStore> | ((state: NotificationStore) => NotificationStore | Partial<NotificationStore>), replace?: false | undefined, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+    setState(state: NotificationStore | ((state: NotificationStore) => NotificationStore), replace: true, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+    devtools: {
+        cleanup: () => void;
+    };
+}>;
+
+/**
+ * Create a notification store hook with injected API client
+ * This allows different applications to provide their own API implementation
+ *
+ * @param apiClient - API client instance that implements NotificationApiClient interface
+ * @returns Zustand hook for notification store
+ *
+ * @example
+ * ```typescript
+ * import { createUseNotificationStore } from 'analytica-frontend-lib';
+ * import api from './services/apiService';
+ *
+ * const useNotificationStore = createUseNotificationStore(api);
+ * ```
+ */
+declare const createUseNotificationStore: (apiClient: NotificationApiClient) => zustand.UseBoundStore<Omit<zustand.StoreApi<NotificationStore>, "setState" | "devtools"> & {
+    setState(partial: NotificationStore | Partial<NotificationStore> | ((state: NotificationStore) => NotificationStore | Partial<NotificationStore>), replace?: false | undefined, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+    setState(state: NotificationStore | ((state: NotificationStore) => NotificationStore), replace: true, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+    devtools: {
+        cleanup: () => void;
+    };
+}>;
+
+export { CheckboxList, CheckboxListItem, FetchNotificationsParams, Notification, type NotificationActions, NotificationApiClient, NotificationGroup, type NotificationState, type NotificationStore, createNotificationStore, createUseNotificationStore, formatTimeAgo };

package/dist/index.d.ts

@@ -10,6 +10,7 @@ export { default as Table } from './Table/index.js';
 export { default as CheckBox } from './CheckBox/index.js';
 import * as react from 'react';
 import { ReactNode, HTMLAttributes, InputHTMLAttributes } from 'react';
+import * as zustand from 'zustand';
 import { StoreApi } from 'zustand';
 export { default as Radio, RadioGroup, RadioGroupItem } from './Radio/index.js';
 export { default as TextArea } from './TextArea/index.js';
@@ -46,7 +47,8 @@ export { useApiConfig } from './Auth/useApiConfig/index.js';
 export { Quiz, QuizAlternative, QuizConnectDots, QuizContent, QuizDissertative, QuizFooter, QuizHeader, QuizHeaderResult, QuizImageQuestion, QuizListResult, QuizListResultByMateria, QuizMultipleChoice, QuizQuestionList, QuizResultHeaderTitle, QuizResultPerformance, QuizResultTitle, QuizTitle, QuizTrueOrFalse, getStatusBadge } from './Quiz/index.js';
 export { ANSWER_STATUS, Activity, Lesson, QUESTION_DIFFICULTY, QUESTION_STATUS, QUESTION_TYPE, Question, QuestionResult, QuizState, SUBTYPE_ENUM, Simulated, UserAnswerItem, useQuizStore } from './Quiz/useQuizStore/index.js';
 export { default as LoadingModal } from './LoadingModal/index.js';
-export { default as NotificationCard, NotificationGroup, NotificationItem } from './NotificationCard/index.js';
+import { N as NotificationApiClient, a as Notification, F as FetchNotificationsParams, b as NotificationGroup } from './NotificationCard-IYDURfYp.js';
+export { B as BackendNotification, g as BackendNotificationsResponse, c as NotificationCard, e as NotificationEntityType, d as NotificationItem, f as NotificationType, h as NotificationsResponse } from './NotificationCard-IYDURfYp.js';
 import 'react/jsx-runtime';
 
 /**
@@ -134,6 +136,127 @@ declare const CheckboxListItem: react.ForwardRefExoticComponent<{
     state?: CheckboxListState;
     /** Additional CSS classes */
     className?: string;
-} & Omit<InputHTMLAttributes<HTMLInputElement>, "size" | "value" | "checked" | "type" | "name" | "onChange"> & react.RefAttributes<HTMLInputElement>>;
+} & Omit<InputHTMLAttributes<HTMLInputElement>, "onChange" | "name" | "type" | "size" | "value" | "checked"> & react.RefAttributes<HTMLInputElement>>;
 
-export { CheckboxList, CheckboxListItem };
+/**
+ * Notification store state interface
+ */
+interface NotificationState {
+    /**
+     * List of all notifications
+     */
+    notifications: Notification[];
+    /**
+     * Number of unread notifications
+     */
+    unreadCount: number;
+    /**
+     * Loading state
+     */
+    loading: boolean;
+    /**
+     * Error state
+     */
+    error: string | null;
+    /**
+     * Whether there are more notifications to load
+     */
+    hasMore: boolean;
+    /**
+     * Current page for pagination
+     */
+    currentPage: number;
+}
+/**
+ * Notification store actions interface
+ */
+interface NotificationActions {
+    /**
+     * Fetch notifications from API
+     */
+    fetchNotifications: (params?: FetchNotificationsParams) => Promise<void>;
+    /**
+     * Mark a specific notification as read
+     */
+    markAsRead: (id: string) => Promise<void>;
+    /**
+     * Mark all notifications as read
+     */
+    markAllAsRead: () => Promise<void>;
+    /**
+     * Delete a notification
+     */
+    deleteNotification: (id: string) => Promise<void>;
+    /**
+     * Clear all notifications
+     */
+    clearNotifications: () => void;
+    /**
+     * Reset error state
+     */
+    resetError: () => void;
+    /**
+     * Group notifications by time periods
+     */
+    getGroupedNotifications: () => NotificationGroup[];
+}
+type NotificationStore = NotificationState & NotificationActions;
+/**
+ * Format time relative to now
+ */
+declare const formatTimeAgo: (date: Date) => string;
+/**
+ * Create notification store with injected API client
+ */
+declare const createNotificationStore: (apiClient: NotificationApiClient) => zustand.UseBoundStore<Omit<zustand.StoreApi<NotificationStore>, "setState" | "devtools"> & {
+    setState(partial: NotificationStore | Partial<NotificationStore> | ((state: NotificationStore) => NotificationStore | Partial<NotificationStore>), replace?: false | undefined, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+    setState(state: NotificationStore | ((state: NotificationStore) => NotificationStore), replace: true, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+    devtools: {
+        cleanup: () => void;
+    };
+}>;
+
+/**
+ * Create a notification store hook with injected API client
+ * This allows different applications to provide their own API implementation
+ *
+ * @param apiClient - API client instance that implements NotificationApiClient interface
+ * @returns Zustand hook for notification store
+ *
+ * @example
+ * ```typescript
+ * import { createUseNotificationStore } from 'analytica-frontend-lib';
+ * import api from './services/apiService';
+ *
+ * const useNotificationStore = createUseNotificationStore(api);
+ * ```
+ */
+declare const createUseNotificationStore: (apiClient: NotificationApiClient) => zustand.UseBoundStore<Omit<zustand.StoreApi<NotificationStore>, "setState" | "devtools"> & {
+    setState(partial: NotificationStore | Partial<NotificationStore> | ((state: NotificationStore) => NotificationStore | Partial<NotificationStore>), replace?: false | undefined, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+    setState(state: NotificationStore | ((state: NotificationStore) => NotificationStore), replace: true, action?: (string | {
+        [x: string]: unknown;
+        [x: number]: unknown;
+        [x: symbol]: unknown;
+        type: string;
+    }) | undefined): void;
+    devtools: {
+        cleanup: () => void;
+    };
+}>;
+
+export { CheckboxList, CheckboxListItem, FetchNotificationsParams, Notification, type NotificationActions, NotificationApiClient, NotificationGroup, type NotificationState, type NotificationStore, createNotificationStore, createUseNotificationStore, formatTimeAgo };