@dashadmin/dash-utils 1.3.73 → 1.3.74-srcfree.2

package/src/hooks/useNotifications.ts

@@ -1,220 +0,0 @@
-import { useState, useCallback, useEffect } from 'react';
-
-/**
- * Represents a processed notification with standardized fields
- */
-export interface ProcessedNotification {
-    id: string;
-    title: string;
-    message: string;
-    customer?: string;
-    store?: string;
-    timestamp: string;
-    isRead: boolean;
-    data?: any;
-    severity?: 'info' | 'warning' | 'error' | 'success';
-}
-
-/**
- * Toast notification for snackbar display
- */
-export interface ToastNotification {
-    id: string;
-    title: string;
-    message: string;
-    severity: 'info' | 'warning' | 'error' | 'success';
-}
-
-/**
- * Dialog notification with position for draggable dialogs
- */
-export interface DialogNotification extends ProcessedNotification {
-    position: { x: number; y: number };
-    zIndex: number;
-}
-
-/**
- * Options for useNotifications hook
- */
-export interface UseNotificationsOptions {
-    /** Maximum number of notifications to keep in history */
-    maxNotifications?: number;
-    /** Initial z-index for dialog notifications */
-    initialZIndex?: number;
-    /** Auto-dismiss toast notifications after ms (0 = no auto dismiss) */
-    toastAutoDismiss?: number;
-}
-
-/**
- * Hook return type
- */
-export interface UseNotificationsReturn {
-    notifications: ProcessedNotification[];
-    toastNotifications: ToastNotification[];
-    dialogNotifications: DialogNotification[];
-    unreadCount: number;
-    addNotification: (notification: Omit<ProcessedNotification, 'id' | 'timestamp' | 'isRead'>) => ProcessedNotification;
-    addToast: (toast: Omit<ToastNotification, 'id'>) => string;
-    addDialogNotification: (notification: Omit<ProcessedNotification, 'id' | 'timestamp' | 'isRead'>) => DialogNotification;
-    markAsRead: (notificationId: string) => void;
-    markAllAsRead: () => void;
-    removeNotification: (notificationId: string) => void;
-    clearAllNotifications: () => void;
-    removeToast: (toastId: string) => void;
-    removeDialogNotification: (notificationId: string) => void;
-    bringDialogToFront: (notificationId: string) => void;
-    updateDialogPosition: (notificationId: string, position: { x: number; y: number }) => void;
-}
-
-/**
- * Generate a unique ID for notifications
- */
-const generateId = (): string => `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
-
-/**
- * Hook for managing notifications state
- * Handles notifications list, toast notifications, and draggable dialog notifications
- */
-export const useNotifications = (options: UseNotificationsOptions = {}): UseNotificationsReturn => {
-    const {
-        maxNotifications = 50,
-        initialZIndex = 100000,
-        toastAutoDismiss = 8000,
-    } = options;
-
-    const [notifications, setNotifications] = useState<ProcessedNotification[]>([]);
-    const [toastNotifications, setToastNotifications] = useState<ToastNotification[]>([]);
-    const [dialogNotifications, setDialogNotifications] = useState<DialogNotification[]>([]);
-    const [nextZIndex, setNextZIndex] = useState(initialZIndex);
-
-    const unreadCount = notifications.filter(n => !n.isRead).length;
-
-    // Add a new notification to the list
-    const addNotification = useCallback((
-        notification: Omit<ProcessedNotification, 'id' | 'timestamp' | 'isRead'>
-    ): ProcessedNotification => {
-        const processedNotification: ProcessedNotification = {
-            ...notification,
-            id: generateId(),
-            timestamp: new Date().toISOString(),
-            isRead: false,
-        };
-
-        setNotifications(prev => [processedNotification, ...prev.slice(0, maxNotifications - 1)]);
-        return processedNotification;
-    }, [maxNotifications]);
-
-    // Add a toast notification
-    const addToast = useCallback((toast: Omit<ToastNotification, 'id'>): string => {
-        const id = `toast-${generateId()}`;
-        setToastNotifications(prev => [...prev, { ...toast, id }]);
-        return id;
-    }, []);
-
-    // Add a dialog notification with position
-    const addDialogNotification = useCallback((
-        notification: Omit<ProcessedNotification, 'id' | 'timestamp' | 'isRead'>
-    ): DialogNotification => {
-        const processedNotification = addNotification(notification);
-
-        let dialogNotification: DialogNotification;
-
-        setDialogNotifications(prev => {
-            const dialogCount = prev.length;
-            const baseX = 20;
-            const baseY = typeof window !== 'undefined' ? window.innerHeight - 250 : 500;
-            const offsetY = dialogCount * -220;
-
-            dialogNotification = {
-                ...processedNotification,
-                position: { x: baseX, y: baseY + offsetY },
-                zIndex: initialZIndex + dialogCount + 1,
-            };
-
-            return [...prev, dialogNotification];
-        });
-
-        setNextZIndex(prev => prev + 1);
-
-        return dialogNotification!;
-    }, [addNotification, initialZIndex]);
-
-    // Mark a notification as read
-    const markAsRead = useCallback((notificationId: string) => {
-        setNotifications(prev =>
-            prev.map(n => n.id === notificationId ? { ...n, isRead: true } : n)
-        );
-    }, []);
-
-    // Mark all notifications as read
-    const markAllAsRead = useCallback(() => {
-        setNotifications(prev => prev.map(n => ({ ...n, isRead: true })));
-    }, []);
-
-    // Remove a notification
-    const removeNotification = useCallback((notificationId: string) => {
-        setNotifications(prev => prev.filter(n => n.id !== notificationId));
-    }, []);
-
-    // Clear all notifications
-    const clearAllNotifications = useCallback(() => {
-        setNotifications([]);
-    }, []);
-
-    // Remove a toast notification
-    const removeToast = useCallback((toastId: string) => {
-        setToastNotifications(prev => prev.filter(t => t.id !== toastId));
-    }, []);
-
-    // Remove a dialog notification
-    const removeDialogNotification = useCallback((notificationId: string) => {
-        setDialogNotifications(prev => prev.filter(d => d.id !== notificationId));
-        markAsRead(notificationId);
-    }, [markAsRead]);
-
-    // Bring a dialog to front
-    const bringDialogToFront = useCallback((notificationId: string) => {
-        setDialogNotifications(prev => {
-            const maxZ = Math.max(...prev.map(p => p.zIndex), initialZIndex);
-            return prev.map(d =>
-                d.id === notificationId
-                    ? { ...d, zIndex: maxZ + 1 }
-                    : d
-            );
-        });
-    }, [initialZIndex]);
-
-    // Update dialog position
-    const updateDialogPosition = useCallback((
-        notificationId: string,
-        position: { x: number; y: number }
-    ) => {
-        setDialogNotifications(prev =>
-            prev.map(d =>
-                d.id === notificationId
-                    ? { ...d, position }
-                    : d
-            )
-        );
-    }, []);
-
-    return {
-        notifications,
-        toastNotifications,
-        dialogNotifications,
-        unreadCount,
-        addNotification,
-        addToast,
-        addDialogNotification,
-        markAsRead,
-        markAllAsRead,
-        removeNotification,
-        clearAllNotifications,
-        removeToast,
-        removeDialogNotification,
-        bringDialogToFront,
-        updateDialogPosition,
-    };
-};
-
-export default useNotifications;

package/src/hooks/useQuickSearch.ts

@@ -1,42 +0,0 @@
-import { useState, useEffect } from 'react';
-
-export interface UseQuickSearchReturn {
-    quickSearchUseState: [string | null, React.Dispatch<React.SetStateAction<string | null>>];
-    sendQuickSearchEvent: (quickSearchString: string) => void;
-}
-
-/**
- * Hook for managing quick search events across components
- * Uses window events for cross-component communication
- */
-export const useQuickSearch = (): UseQuickSearchReturn => {
-    const quickSearchUseState = useState<string | null>(null);
-
-    const sendQuickSearchEvent = (quickSearchString: string) => {
-        if (typeof window !== 'undefined') {
-            window.dispatchEvent(
-                new MessageEvent('quickSearch', { data: { value: quickSearchString } }),
-            );
-        }
-    };
-
-    const eventHook = (e: MessageEvent) => {
-        quickSearchUseState[1](e.data?.value ?? null);
-    };
-
-    useEffect(() => {
-        if (typeof window !== 'undefined') {
-            window.addEventListener('quickSearch', eventHook as EventListener);
-            return () => {
-                window.removeEventListener('quickSearch', eventHook as EventListener);
-            };
-        }
-    }, []);
-
-    return {
-        quickSearchUseState,
-        sendQuickSearchEvent,
-    };
-};
-
-export default useQuickSearch;

package/src/hooks/useWindowSize.tsx

@@ -1,36 +0,0 @@
-import { useState, useEffect } from 'react';
-
-interface IWindowSize {
-	width: number | undefined;
-	height: number | undefined;
-}
-
-export const useWindowSize = (): IWindowSize => {
-	// Initialize state with undefined width/height so server and client renders match
-	// Learn more here: https://joshwcomeau.com/react/the-perils-of-rehydration/
-	const [windowSize, setWindowSize] = useState<IWindowSize>({
-		width: undefined,
-		height: undefined,
-	});
-
-	useEffect(() => {
-		// Handler to call on window resize
-		function handleResize() {
-			// Set window width/height to state
-			setWindowSize({
-				width: window.innerWidth,
-				height: window.innerHeight,
-			});
-		}
-		// Add event listener
-		window.addEventListener('resize', handleResize);
-		// Call handler right away so state gets updated with initial window size
-		handleResize();
-		// Remove event listener on cleanup
-		return () => window.removeEventListener('resize', handleResize);
-	}, []); // Empty array ensures that effect is only run on mount
-
-	return windowSize;
-};
-
-//export default useWindowSize;

package/src/index.ts

@@ -1,202 +0,0 @@
-// Hooks
-export { useWindowSize } from './hooks/useWindowSize';
-export { useCapacitorAppStateRefresh } from './hooks/useCapacitorAppStateRefresh';
-export { useDeviceStorageSync } from './hooks/useDeviceStorageSync';
-export {
-    useCapacitorKeyboard,
-    isCapacitorKeyboardAvailable,
-    getCapacitorKeyboard,
-    type KeyboardState,
-    type UseCapacitorKeyboardOptions
-} from './hooks/useCapacitorKeyboard';
-export {
-    useMobileDetection,
-    checkMobileDevice,
-    isWebView,
-    isAndroid,
-    isIOS,
-    isWindows,
-    isMacOS,
-    isLinux,
-    type MobileDetectionState,
-    type UseMobileDetectionOptions
-} from './hooks/useMobileDetection';
-export {
-    useDraggable,
-    type DraggablePosition,
-    type UseDraggableOptions,
-    type UseDraggableReturn
-} from './hooks/useDraggable';
-export {
-    useNotifications,
-    type ProcessedNotification,
-    type ToastNotification,
-    type DialogNotification,
-    type UseNotificationsOptions,
-    type UseNotificationsReturn
-} from './hooks/useNotifications';
-export {
-    useQuickSearch,
-    type UseQuickSearchReturn
-} from './hooks/useQuickSearch';
-export {
-    useMenuStateInit,
-    getInitialMenuState,
-    getInitialNavSize,
-    type UseMenuStateInitOptions
-} from './hooks/useMenuStateInit';
-
-// Utils
-export { updateDomCssVariables } from './utils/updateDomCssVariables';
-export { getEnv } from './utils/envUtils';
-export { dashStorage } from './utils/dashDtorage';
-export {
-    EMAIL_REGEX,
-    PHONE_REGEX,
-    URL_REGEX,
-    validateEmail,
-    validatePhone,
-    validateUrl,
-    validateRequired,
-    validateMinLength,
-    validateMaxLength,
-    validateRut,
-    checkPasswordStrength,
-    type PasswordStrength
-} from './utils/validation';
-
-// IPC Service for Electron
-export {
-    isDashIPCServiceAvailable,
-    isElectron,
-    getDashIPCService,
-    windowControl,
-    startWindowDrag,
-    executeIPCAction,
-    onIPCStdout,
-    useDashIPCService,
-    type DashIPCServiceType
-} from './utils/dashIPCService';
-
-// Text-to-speech (platform-routed: native Android / Electron+Python / no-op web)
-export { speak, speakAsync } from './utils/speechService';
-
-// Stored Theme
-export {
-    getStoredTheme,
-    setStoredTheme,
-    initializeStoredTheme,
-    clearStoredTheme
-} from './utils/storedTheme';
-
-// Development Environment Detection
-export {
-    isDev,
-    isProd,
-    isTest,
-    getEnvironment
-} from './utils/isDev';
-
-// Environment Body Classes
-export {
-    setupEnvironmentBodyClasses,
-    useEnvironmentBodyClasses,
-    type EnvironmentVars
-} from './utils/environmentBodyClasses';
-
-// Platform Detection
-export {
-    isWebView as isWebViewPlatform,
-    isAndroid as isAndroidPlatform,
-    isIOS as isIOSPlatform,
-    isWindows as isWindowsPlatform,
-    applyPlatformBodyClasses
-} from './utils/platformDetection';
-
-// Electron Store Sync
-export {
-    syncElectronStore,
-    hasElectronStore
-} from './utils/electronStoreSync';
-
-// Notification Permission
-export {
-    requestNotificationPermission,
-    isNotificationSupported,
-    hasNotificationPermission,
-    isNotificationDenied,
-    getNotificationPermission
-} from './utils/notificationPermission';
-
-// Dash Bootstrap App
-export {
-    dashInitializeApp,
-    dashBootstrapApp,
-    type DashInitializeAppConfig
-} from './utils/dashBootstrapApp';
-
-// Resource Loader
-export {
-    createResourceLoader,
-    createSimpleResourceLoader
-} from './utils/resourceLoader';
-
-// Auth Provider Utils
-export {
-    createLogoutFromStorage,
-    isUserAuthenticated,
-    getCurrentUser,
-    getAuthToken,
-    getTenantId,
-    getUserRoles,
-    setAuthData,
-    type LogoutConfig
-} from './utils/authProviderUtils';
-
-// Data Provider Utils
-export {
-    getResourceConfigManager,
-    setResourceConfigs,
-    getResourceConfig,
-    processPostData,
-    processFormData,
-    buildQueryString,
-    isFormDataResource,
-    type IResourceConfig
-} from './utils/dataProviderUtils';
-
-// Components
-export {
-    MinimalLayout,
-    type MinimalLayoutProps
-} from './components/MinimalLayout';
-
-export {
-    DashRouterComponent,
-    RouterComponent, // Backward compatibility alias
-    shouldUseHashRouter,
-    createRouterComponent,
-    type DashRouterComponentProps,
-    type RouterComponentProps // Backward compatibility alias
-} from './components/RouterComponent';
-
-// IPC Message Broker Context (Electron)
-export {
-    IPCMessageBrokerContext,
-    IPCMessageBrokerProvider,
-    useIPCMessageBroker,
-    type LogMessage,
-    type SubprocessOutput,
-    type IPCMessageBrokerContextType,
-    type IPCMessageBrokerConfig
-} from './contexts/IPCMessageBrokerContext';
-
-// Lazy App Loader
-export {
-    createLazyAppComponent,
-    createSimpleLazyApp,
-    DefaultLoadFailedComponent,
-    type LazyAppLoaderConfig
-} from './components/LazyAppLoader';
-
-export { priceFormatter } from "./utils/priceFormatter";

package/src/utils/authProviderUtils.ts

@@ -1,170 +0,0 @@
-/**
- * Auth Provider Utilities
- *
- * Helper functions for authentication operations.
- * These utilities are used by auth providers across Dash applications.
- */
-import { dashStorage } from './dashDtorage';
-
-/**
- * Configuration for logout function
- */
-export interface LogoutConfig {
-    /** Function to clear auth persistence service */
-    clearAuthPersistence?: () => void;
-    /** Function to sync to device store (Electron/Capacitor) */
-    syncToDeviceStore?: () => Promise<void>;
-    /** Function to remove cookies */
-    removeCookies?: (names: string[]) => void;
-    /** Additional storage keys to clear */
-    additionalKeys?: string[];
-}
-
-/**
- * Default storage keys to clear on logout
- */
-const DEFAULT_AUTH_STORAGE_KEYS = [
-    'token',
-    'authenticated',
-    'user',
-    'roles',
-    'tenant_id',
-    'user_id'
-];
-
-/**
- * Default cookie names to clear on logout
- */
-const DEFAULT_AUTH_COOKIE_NAMES = [
-    'token',
-    'tenant_id',
-    'user_id'
-];
-
-/**
- * Create a logout function with the given configuration
- * This factory allows apps to customize the logout behavior
- */
-export const createLogoutFromStorage = (config: LogoutConfig = {}) => {
-    return async (reason?: string): Promise<void> => {
-        console.log('🔓 logoutFromStorage called:', reason || 'no reason provided');
-
-        try {
-            // Clear auth persistence service if provided
-            if (config.clearAuthPersistence) {
-                config.clearAuthPersistence();
-            }
-
-            // Clear localStorage items
-            const keysToRemove = [...DEFAULT_AUTH_STORAGE_KEYS, ...(config.additionalKeys || [])];
-            keysToRemove.forEach(key => {
-                dashStorage.removeItem(key);
-            });
-
-            // Clear cookies if removeCookies function is provided
-            if (config.removeCookies) {
-                config.removeCookies(DEFAULT_AUTH_COOKIE_NAMES);
-            }
-
-            // Sync to device store (Electron/Capacitor) if provided
-            if (config.syncToDeviceStore) {
-                await config.syncToDeviceStore();
-            }
-
-            console.log('✅ Auth data cleared successfully');
-        } catch (error) {
-            console.error('❌ Error clearing auth data:', error);
-        }
-    };
-};
-
-/**
- * Check if user is currently authenticated
- * Based on localStorage values
- */
-export const isUserAuthenticated = (): boolean => {
-    try {
-        const authenticated = JSON.parse(dashStorage.getItem('authenticated') || 'false');
-        const user = JSON.parse(dashStorage.getItem('user') || 'null');
-        return authenticated && user?.id;
-    } catch {
-        return false;
-    }
-};
-
-/**
- * Get current user from storage
- */
-export const getCurrentUser = <T = any>(): T | null => {
-    try {
-        return JSON.parse(dashStorage.getItem('user') || 'null');
-    } catch {
-        return null;
-    }
-};
-
-/**
- * Get current token from storage
- */
-export const getAuthToken = (): string | null => {
-    return dashStorage.getItem('token');
-};
-
-/**
- * Get current tenant ID from storage
- */
-export const getTenantId = (): string | null => {
-    return dashStorage.getItem('tenant_id');
-};
-
-/**
- * Get user roles from storage
- */
-export const getUserRoles = <T = any>(): T[] => {
-    try {
-        return JSON.parse(dashStorage.getItem('roles') || '[]');
-    } catch {
-        return [];
-    }
-};
-
-/**
- * Set authentication data in storage
- */
-export const setAuthData = (data: {
-    token?: string;
-    user?: any;
-    roles?: any[];
-    authenticated?: boolean;
-    tenant_id?: string;
-    user_id?: string;
-}): void => {
-    if (data.token !== undefined) {
-        dashStorage.setItem('token', data.token);
-    }
-    if (data.user !== undefined) {
-        dashStorage.setItem('user', JSON.stringify(data.user));
-    }
-    if (data.roles !== undefined) {
-        dashStorage.setItem('roles', JSON.stringify(data.roles));
-    }
-    if (data.authenticated !== undefined) {
-        dashStorage.setItem('authenticated', JSON.stringify(data.authenticated));
-    }
-    if (data.tenant_id !== undefined) {
-        dashStorage.setItem('tenant_id', data.tenant_id);
-    }
-    if (data.user_id !== undefined) {
-        dashStorage.setItem('user_id', data.user_id);
-    }
-};
-
-export default {
-    createLogoutFromStorage,
-    isUserAuthenticated,
-    getCurrentUser,
-    getAuthToken,
-    getTenantId,
-    getUserRoles,
-    setAuthData
-};