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

package/src/utils/envUtils.tsx

@@ -1,27 +0,0 @@
-const getEnvironmentVariable = (environmentVariable: string): string => {
-  /* @ts-ignore Expected access to process */
-  const unvalidatedEnvironmentVariable = process.env[environmentVariable];
-  /*if (!unvalidatedEnvironmentVariable) {
-    throw new Error(
-      `Couldn't find environment variable: ${environmentVariable}`,
-    );
-  } else {
-    return unvalidatedEnvironmentVariable;
-  }*/
-  return unvalidatedEnvironmentVariable || null;
-};
-
-
-export const getEnv = (key: string) => {
-  
-  // @ts-ignore Expected access to process 
-  const PREFIX = process.env.ENV_PREFIX || process.env.NEXT_PUBLIC_ENV_PREFIX || process.env.VITE_ENV_PREFIX || process.env.REACT_ENV_PREFIX || 'VITE_';
-  //console.log('GET ENV', PREFIX, key);
-
-  if (PREFIX === 'NEXT_PUBLIC_') {
-    return getEnvironmentVariable(PREFIX + key);
-  }
-  // @ts-ignore Expected access to process 
-  return process.env[PREFIX + key] || null;
-  
-};

package/src/utils/environmentBodyClasses.ts

@@ -1,72 +0,0 @@
-/**
- * Environment Body Classes Utility
- *
- * Manages body CSS classes based on the runtime environment.
- * Useful for platform-specific styling (Electron, Mac, mobile, etc.)
- */
-
-export interface EnvironmentVars {
-    PLATFORM_TYPE?: string;
-    IS_ELECTRON?: boolean;
-    IS_MAC?: boolean;
-    IS_WINDOWS?: boolean;
-    IS_LINUX?: boolean;
-    PLATFORM?: string;
-}
-
-/**
- * Add environment-based classes to the document body
- * @param envVars - Environment variables object
- * @returns Cleanup function to remove the classes
- */
-export const setupEnvironmentBodyClasses = (envVars: EnvironmentVars): (() => void) => {
-    if (typeof document === 'undefined') {
-        return () => {}; // No-op for SSR
-    }
-
-    const { PLATFORM_TYPE, IS_ELECTRON, IS_MAC, IS_WINDOWS, IS_LINUX } = envVars;
-    const classesToAdd: string[] = [];
-
-    if (PLATFORM_TYPE) {
-        document.body.classList.add(PLATFORM_TYPE);
-        classesToAdd.push(PLATFORM_TYPE);
-    }
-
-    if (IS_ELECTRON) {
-        document.body.classList.add('electron');
-        classesToAdd.push('electron');
-    }
-
-    if (IS_MAC) {
-        document.body.classList.add('mac');
-        classesToAdd.push('mac');
-    }
-
-    if (IS_WINDOWS) {
-        document.body.classList.add('windows');
-        classesToAdd.push('windows');
-    }
-
-    if (IS_LINUX) {
-        document.body.classList.add('linux');
-        classesToAdd.push('linux');
-    }
-
-    // Return cleanup function
-    return () => {
-        classesToAdd.forEach(className => {
-            document.body.classList.remove(className);
-        });
-    };
-};
-
-/**
- * React hook for environment body classes
- * Use with useEffect to automatically clean up on unmount
- */
-export const useEnvironmentBodyClasses = (envVars: EnvironmentVars): void => {
-    // Note: This is a simple helper. For actual use, wrap in useEffect in your component:
-    // useEffect(() => setupEnvironmentBodyClasses(envVars), [envVars]);
-};
-
-export default setupEnvironmentBodyClasses;

package/src/utils/isDev.ts

@@ -1,65 +0,0 @@
-/**
- * Development Environment Detection Utility
- *
- * Provides functions to check if the application is running
- * in a development environment.
- */
-
-// Safe check for Node.js process object
-const getNodeEnv = (): string | undefined => {
-    try {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        if (typeof globalThis !== 'undefined' && (globalThis as any).process?.env?.NODE_ENV) {
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            return (globalThis as any).process.env.NODE_ENV;
-        }
-    } catch {
-        // Ignore errors in environments where process is not available
-    }
-    return undefined;
-};
-
-/**
- * Check if the application is running in development mode
- * Detects localhost, 127.0.0.1, or development hostnames
- */
-export const isDev = (): boolean => {
-    if (typeof window === 'undefined') {
-        // Node.js environment - check for NODE_ENV
-        return getNodeEnv() === 'development';
-    }
-
-    const { hostname } = window.location;
-    return (
-        hostname === 'localhost' ||
-        hostname === '127.0.0.1' ||
-        hostname.startsWith('192.168.') ||
-        hostname.endsWith('.local') ||
-        hostname.includes('dev.')
-    );
-};
-
-/**
- * Check if running in production mode
- */
-export const isProd = (): boolean => {
-    return !isDev();
-};
-
-/**
- * Check if running in test environment
- */
-export const isTest = (): boolean => {
-    return getNodeEnv() === 'test';
-};
-
-/**
- * Get the current environment name
- */
-export const getEnvironment = (): 'development' | 'production' | 'test' => {
-    if (isTest()) return 'test';
-    if (isDev()) return 'development';
-    return 'production';
-};
-
-export default isDev;

package/src/utils/notificationPermission.ts

@@ -1,57 +0,0 @@
-/**
- * Notification Permission Utilities
- *
- * Utilities for managing browser notification permissions.
- */
-
-/**
- * Request browser notification permission
- * Only requests if permission is in 'default' state (not yet decided)
- *
- * @returns Promise that resolves when permission is granted or rejected
- *
- * @example
- * ```tsx
- * // Request permission on app startup
- * await requestNotificationPermission();
- *
- * // Check if granted
- * if (Notification.permission === 'granted') {
- *   new Notification('Hello!');
- * }
- * ```
- */
-export const requestNotificationPermission = async (): Promise<NotificationPermission | null> => {
-    if ('Notification' in window && Notification.permission === 'default') {
-        return await Notification.requestPermission();
-    }
-    return Notification.permission ?? null;
-};
-
-/**
- * Check if notifications are supported in the current environment
- */
-export const isNotificationSupported = (): boolean => {
-    return 'Notification' in window;
-};
-
-/**
- * Check if notification permission has been granted
- */
-export const hasNotificationPermission = (): boolean => {
-    return 'Notification' in window && Notification.permission === 'granted';
-};
-
-/**
- * Check if notification permission has been denied
- */
-export const isNotificationDenied = (): boolean => {
-    return 'Notification' in window && Notification.permission === 'denied';
-};
-
-/**
- * Get current notification permission status
- */
-export const getNotificationPermission = (): NotificationPermission | null => {
-    return 'Notification' in window ? Notification.permission : null;
-};

package/src/utils/platformDetection.ts

@@ -1,98 +0,0 @@
-/**
- * Platform Detection Utilities
- *
- * Functions to detect the current platform/environment.
- * These are used to add appropriate body classes for platform-specific styling.
- */
-
-/**
- * Check if running in a WebView
- */
-export const isWebView = (): boolean => {
-    if (typeof navigator === 'undefined') return false;
-
-    const userAgent = navigator.userAgent.toLowerCase();
-    console.log('userAgent', userAgent);
-    return (/(webview|wv)/.test(userAgent) ||
-    /android.*(wv|.net)/.test(userAgent) || /iphone|ipod|ipad.*applewebkit(?!.*safari)/i.test(userAgent));
-};
-
-/**
- * Check if running on Android
- */
-export const isAndroid = (): boolean => {
-    if (typeof navigator === 'undefined') return false;
-    return /android/i.test(navigator.userAgent.toLowerCase());
-};
-
-/**
- * Check if running on iOS
- */
-export const isIOS = (): boolean => {
-    if (typeof navigator === 'undefined') return false;
-    return /iphone|ipad|ipod/i.test(navigator.userAgent.toLowerCase());
-};
-
-/**
- * Check if running on Windows
- */
-export const isWindows = (): boolean => {
-    try {
-        // Check via globalThis to avoid process not defined errors
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        const globalProcess = (globalThis as any).process;
-        const platform = globalProcess?.platform;
-        return platform === 'win32' ||
-            (typeof navigator !== 'undefined' && navigator.userAgent.toLowerCase().includes('windows'));
-    } catch (error) {
-        console.error('Error checking Windows platform:', error);
-        return false;
-    }
-};
-
-/**
- * Apply platform-specific body classes
- */
-export const applyPlatformBodyClasses = (): void => {
-    if (typeof document === 'undefined') return;
-
-    if (isWindows()) {
-        document.body.classList.add('windows');
-    }
-
-    if (isWebView()) {
-        console.log('webview');
-        document.body.classList.add('webview');
-
-        if (isAndroid()) {
-            document.body.classList.add('android');
-        }
-
-        if (isIOS()) {
-            document.body.classList.add('ios');
-        }
-    }
-
-    // Add sanitized user agent as body class
-    if (typeof navigator !== 'undefined' && navigator.userAgent) {
-        const userAgent = navigator.userAgent.toLowerCase();
-        // Sanitize user agent for use as CSS class
-        const sanitizedUA = userAgent
-            .replace(/[^a-z0-9]/g, '-') // Replace non-alphanumeric with hyphens
-            .replace(/-+/g, '-') // Replace multiple hyphens with single
-            .replace(/^-|-$/g, '') // Remove leading/trailing hyphens
-            .substring(0, 100); // Limit length
-
-        if (sanitizedUA) {
-            document.body.classList.add(`ua-${sanitizedUA}`);
-        }
-    }
-};
-
-export default {
-    isWebView,
-    isAndroid,
-    isIOS,
-    isWindows,
-    applyPlatformBodyClasses,
-};

package/src/utils/priceFormatter.ts

@@ -1,36 +0,0 @@
-/***
- * Centralized price formatter for all currencies.
- *
- * Amounts are ALWAYS passed as their real value (never in cents).
- *   - e.g. CLP 4990  → "$4.990"
- *   - e.g. USD 6.00  → "$6.00"
- *   - e.g. USD 6     → "$6"
- *
- * Formatting rules:
- *   - CLP: always formatted as an integer (no decimals), with thousands separator.
- *   - Other currencies: if the value is an integer → no decimals;
- *     if the value has a fractional part → up to 2 decimal places.
- */
-export const priceFormatter = (price: number, currencyCode: string = 'CLP'): string => {
-    // Ensure we work with an actual number
-    const numericPrice = typeof price === 'number' ? price : parseFloat(String(price));
-    if (isNaN(numericPrice)) return '$0';
-
-    if (currencyCode === 'CLP') {
-        // CLP never uses decimals – format as whole number with locale thousands separator
-        return `$${Math.round(numericPrice).toLocaleString('es-CL')}`;
-    }
-
-    // For all other currencies: detect int vs float
-    const isInteger = Number.isInteger(numericPrice);
-
-    if (isInteger) {
-        // Integer amount → no decimals, with thousands separator
-        return `$${numericPrice.toLocaleString('en-US')}`;
-    }
-
-    // Float amount → up to 2 decimal places
-    return `$${numericPrice.toLocaleString('en-US', { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`;
-};
-
-export default priceFormatter;

package/src/utils/resourceLoader.ts

@@ -1,107 +0,0 @@
-/**
- * Resource Loader Utility
- *
- * Provides a generic mechanism for lazy-loading and caching resources.
- * Useful for loading React-Admin resource configurations on demand.
- */
-
-/**
- * Creates a resource loader with caching support
- *
- * @param loadFn - Async function that loads the resources
- * @returns Object with getResources() method and cached resources array
- *
- * @example
- * ```typescript
- * const { getResources, resources } = createResourceLoader(async () => {
- *     const [{ default: systemResources }, { default: todoResource }] = await Promise.all([
- *         import('dash-admin/src/systemResources'),
- *         import('@app/resources/demo/todoResource'),
- *     ]);
- *     return [...systemResources, todoResource];
- * });
- *
- * // Async usage (recommended)
- * const allResources = await getResources();
- *
- * // Sync usage (returns cached or empty array)
- * const cachedResources = resources;
- * ```
- */
-export const createResourceLoader = <T>(
-    loadFn: () => Promise<T[]>
-): {
-    getResources: () => Promise<T[]>;
-    resources: T[];
-    clearCache: () => void;
-    isLoaded: () => boolean;
-} => {
-    let cachedResources: T[] | null = null;
-    let loadingPromise: Promise<T[]> | null = null;
-
-    const getResources = async (): Promise<T[]> => {
-        // Return cached if available
-        if (cachedResources) {
-            return cachedResources;
-        }
-
-        // If already loading, return the existing promise to avoid duplicate loads
-        if (loadingPromise) {
-            return loadingPromise;
-        }
-
-        // Start loading
-        loadingPromise = loadFn().then((resources) => {
-            cachedResources = resources;
-            loadingPromise = null;
-            return resources;
-        }).catch((error) => {
-            loadingPromise = null;
-            console.error('Failed to load resources:', error);
-            throw error;
-        });
-
-        return loadingPromise;
-    };
-
-    const clearCache = (): void => {
-        cachedResources = null;
-        loadingPromise = null;
-    };
-
-    const isLoaded = (): boolean => {
-        return cachedResources !== null;
-    };
-
-    // Return empty array for sync access, will be populated after getResources() is called
-    const resources: T[] = [];
-
-    return {
-        getResources,
-        resources,
-        clearCache,
-        isLoaded,
-    };
-};
-
-/**
- * Simple resource loader for cases where you just need the async getter
- *
- * @param loadFn - Async function that loads the resources
- * @returns Async function that returns cached resources
- */
-export const createSimpleResourceLoader = <T>(
-    loadFn: () => Promise<T[]>
-): (() => Promise<T[]>) => {
-    let cache: T[] | null = null;
-
-    return async (): Promise<T[]> => {
-        if (cache) {
-            return cache;
-        }
-        cache = await loadFn();
-        return cache;
-    };
-};
-
-export default createResourceLoader;

package/src/utils/speechService.ts

@@ -1,112 +0,0 @@
-import { getDashIPCService, isElectron } from './dashIPCService';
-
-/**
- * Unified text-to-speech entry point, routed by platform:
- * - Android (native/Capacitor): @capacitor-community/text-to-speech
- * - Electron: window.DashIPCService -> Python tts_service (unchanged)
- * - Web/other: no-op (not yet supported)
- *
- * Capacitor is deliberately accessed via `window.Capacitor` rather than a
- * static `import ... from '@capacitor/core'`: the Android build externalizes
- * @capacitor/core from the Rollup bundle (it's injected as a global by the
- * native bridge at runtime), so a static import resolves to a bare, unbundled
- * specifier that the WebView cannot load.
- */
-
-interface CapacitorGlobal {
-    isNativePlatform?: () => boolean;
-    getPlatform?: () => string;
-    Plugins?: {
-        TextToSpeech?: {
-            speak: (options: {
-                text: string;
-                lang?: string;
-                rate?: number;
-                pitch?: number;
-                volume?: number;
-            }) => Promise<unknown>;
-        };
-    };
-}
-
-const getCapacitor = (): CapacitorGlobal | undefined =>
-    (window as unknown as { Capacitor?: CapacitorGlobal })?.Capacitor;
-
-const getTextToSpeechPlugin = () => getCapacitor()?.Plugins?.TextToSpeech;
-
-const LANG_LOCALE_MAP: Record<string, string> = {
-    es: 'es-ES',
-    en: 'en-US',
-    pt: 'pt-BR',
-    fr: 'fr-FR',
-    de: 'de-DE',
-    it: 'it-IT',
-};
-
-// The Electron/Python path accepts short codes (gTTS); the Capacitor plugin
-// expects BCP-47 locale tags, so only the Android branch needs this mapping.
-const toLocale = (lang?: string): string => {
-    if (!lang) return LANG_LOCALE_MAP.es;
-    if (lang.includes('-')) return lang;
-    return LANG_LOCALE_MAP[lang.toLowerCase()] || lang;
-};
-
-const isNativeAndroid = (): boolean => {
-    const capacitor = getCapacitor();
-    return !!capacitor?.isNativePlatform?.() && capacitor.getPlatform?.() === 'android';
-};
-
-export const speak = (text: string, lang?: string): void => {
-    if (!text) return;
-
-    if (isNativeAndroid()) {
-        const textToSpeech = getTextToSpeechPlugin();
-        if (!textToSpeech) {
-            console.warn('Native Android TTS plugin not available on window.Capacitor.Plugins');
-            return;
-        }
-        textToSpeech
-            .speak({ text, lang: toLocale(lang), rate: 1.0, pitch: 1.0, volume: 1.0 })
-            .catch((error) => {
-                console.error('Native Android TTS failed:', error);
-            });
-        return;
-    }
-
-    if (isElectron()) {
-        getDashIPCService()?.speak({ message: text, lang });
-        return;
-    }
-
-    // Web/other: no-op (unchanged behavior)
-};
-
-export const speakAsync = async (text: string, lang?: string): Promise<void> => {
-    if (!text) return;
-
-    if (isNativeAndroid()) {
-        const textToSpeech = getTextToSpeechPlugin();
-        if (!textToSpeech) {
-            console.warn('Native Android TTS plugin not available on window.Capacitor.Plugins');
-            return;
-        }
-        await textToSpeech.speak({ text, lang: toLocale(lang), rate: 1.0, pitch: 1.0, volume: 1.0 });
-        return;
-    }
-
-    if (isElectron()) {
-        const ipc = getDashIPCService() as (ReturnType<typeof getDashIPCService> & {
-            speakAsync?: (text: string, lang?: string) => Promise<unknown>;
-        });
-        if (ipc?.speakAsync) {
-            await ipc.speakAsync(text, lang);
-        } else {
-            ipc?.speak({ message: text, lang });
-        }
-        return;
-    }
-
-    // Web/other: no-op (unchanged behavior)
-};
-
-export default { speak, speakAsync };

package/src/utils/storedTheme.ts

@@ -1,60 +0,0 @@
-/**
- * Stored Theme Utility
- *
- * Handles theme persistence and initialization in localStorage
- * and the document's data-theme attribute.
- */
-import { dashStorage } from './dashDtorage';
-
-/**
- * Get the stored theme from localStorage
- */
-export const getStoredTheme = (): string | null => {
-    return dashStorage.getItem('theme');
-};
-
-/**
- * Set the theme in localStorage and update the document attribute
- */
-export const setStoredTheme = (theme: string): void => {
-    dashStorage.setItem('theme', theme);
-    if (typeof document !== 'undefined') {
-        document.documentElement.setAttribute('data-theme', theme);
-    }
-};
-
-/**
- * Initialize the theme from storage or use a default
- * Sets both localStorage and the data-theme attribute
- */
-export const initializeStoredTheme = (defaultTheme: string): string => {
-    const storedTheme = getStoredTheme();
-    const themeToUse = storedTheme || defaultTheme;
-
-    if (typeof document !== 'undefined') {
-        document.documentElement.setAttribute('data-theme', themeToUse);
-    }
-
-    if (!storedTheme) {
-        dashStorage.setItem('theme', defaultTheme);
-    }
-
-    return themeToUse;
-};
-
-/**
- * Clear the stored theme
- */
-export const clearStoredTheme = (): void => {
-    dashStorage.removeItem('theme');
-    if (typeof document !== 'undefined') {
-        document.documentElement.removeAttribute('data-theme');
-    }
-};
-
-export default {
-    getStoredTheme,
-    setStoredTheme,
-    initializeStoredTheme,
-    clearStoredTheme,
-};