@dashadmin/dash-app-common 1.3.24 → 1.3.26

package/src/defaults/extensions/i18n/dashDefaultTranslations.ts

@@ -0,0 +1,82 @@
+/**
+ * Dash Default i18n Translations Extension
+ * 
+ * Default translations that extend the base dash-admin translations.
+ */
+import polyglotI18nProvider from 'ra-i18n-polyglot';
+import { en, es } from 'dash-admin/src/providers/i18n/languages';
+
+/**
+ * Dash default merged translations combining dash-admin base translations
+ */
+export const dashDefaultTranslations: Record<string, any> = {
+    en: {
+        ...en,
+    },
+    es: {
+        ...es,
+    },
+};
+
+/**
+ * Dash default available locales configuration
+ */
+export const dashDefaultAvailableLocales = [
+    { locale: 'en', name: 'English' },
+    { locale: 'es', name: 'Español' }
+];
+
+/**
+ * Dash default locale
+ */
+export const dashDefaultLocale = 'en';
+
+/**
+ * Create dash default i18n provider with merged translations
+ */
+export const createDashDefaultI18nProvider = (locale: string = dashDefaultLocale) => {
+    return polyglotI18nProvider(
+        (loc) => dashDefaultTranslations[loc as keyof typeof dashDefaultTranslations] || dashDefaultTranslations.en,
+        locale,
+        dashDefaultAvailableLocales
+    );
+};
+
+/**
+ * Load dash default translations asynchronously
+ * Useful for lazy loading to reduce initial bundle size
+ */
+export const loadDashDefaultTranslationsAsync = async () => {
+    try {
+        const [enLang, esLang] = await Promise.all([
+            import('dash-admin').then(module => module.en),
+            import('dash-admin').then(module => module.es)
+        ]);
+
+        return {
+            en: { ...enLang },
+            es: { ...esLang },
+        };
+    } catch (error) {
+        console.error('Failed to load dash default translations:', error);
+        return dashDefaultTranslations;
+    }
+};
+
+/**
+ * Create dash default i18n provider asynchronously
+ */
+export const createDashDefaultI18nProviderAsync = async (
+    locale: string = dashDefaultLocale,
+    locales?: Array<{ locale: string; name: string }>
+) => {
+    const loadedTranslations = await loadDashDefaultTranslationsAsync();
+    
+    return polyglotI18nProvider(
+        (loc) => loadedTranslations[loc as keyof typeof loadedTranslations] || loadedTranslations.en,
+        locale,
+        locales || dashDefaultAvailableLocales
+    );
+};
+
+export default dashDefaultTranslations;

package/src/defaults/extensions/i18n/index.ts

@@ -0,0 +1,22 @@
+/**
+ * i18n Extensions Index
+ * 
+ * Internationalization configurations and providers.
+ */
+
+// Default Translations
+export { 
+    dashDefaultTranslations, 
+    dashDefaultAvailableLocales, 
+    dashDefaultLocale, 
+    createDashDefaultI18nProvider,
+    loadDashDefaultTranslationsAsync,
+    createDashDefaultI18nProviderAsync 
+} from './dashDefaultTranslations';
+
+// Default i18n Provider hook and factory
+export { 
+    useDashDefaultI18nProvider, 
+    createDashDefaultI18nProviderWithSettings,
+    createDashDefaultI18nProviderFromAppState 
+} from './dashDefaultI18nProvider';

package/src/defaults/extensions/index.ts

@@ -0,0 +1,177 @@
+/**
+ * Default Extensions Index
+ * 
+ * This is the main entry point for all default extensions.
+ * Applications can import what they need and override with their custom implementations.
+ */
+
+// ============================================================================
+// BOOTSTRAP EXTENSIONS
+// ============================================================================
+export {
+    dashDefaultInitializeApp,
+    dashDefaultBootstrapApp,
+    DashDefaultErrorBoundary,
+    type DashDefaultInitializeAppConfig,
+    type DashDefaultErrorBoundaryProps,
+    type DashDefaultErrorBoundaryState
+} from './bootstrap';
+
+// ============================================================================
+// COMPONENT EXTENSIONS
+// ============================================================================
+export {
+    DashDefaultLoader,
+    DashDefaultReactAdminNotification,
+    loadDashDefaultAutoAdminComponents,
+    dashDefaultAutoAdminComponents,
+    dashDefaultStaticComponents,
+    getDashDefaultStaticComponents,
+    dashDefaultNotificationConfig,
+    type DashDefaultLoaderProps
+} from './components';
+
+// ============================================================================
+// HOOK EXTENSIONS
+// ============================================================================
+export {
+    useDashDefaultMountTracker,
+    useDashDefaultRoutePath,
+    useDashDefaultLazyI18nProvider,
+    useDashDefaultLazyAutoAdminComponents,
+    useDashDefaultLazyResources
+} from './hooks';
+
+// ============================================================================
+// ROUTER EXTENSIONS
+// ============================================================================
+export {
+    dashDefaultPublicRoutes,
+    dashDefaultPrivateRoutes,
+    dashDefaultSharedRoutes,
+    DashDefaultRouterWrapper,
+    createDashDefaultRouterWrapper,
+    getDashDefaultRouterEnvVars
+} from './router';
+
+// ============================================================================
+// STATE EXTENSIONS
+// ============================================================================
+export {
+    dashDefaultAppSettings,
+    getDashDefaultThemeType,
+    getDashDefaultAppCommon,
+    getDashDefaultAppPath,
+    getDashDefaultPanelImages,
+    DASH_DEFAULT_INITIAL_APP_STATE,
+    getDashDefaultInitialAppState,
+    dashDefaultQueryClient,
+    createDashDefaultQueryClient,
+    dashDefaultQueryClientConfig,
+    dashDefaultDevQueryClientConfig,
+    dashDefaultLayoutSettings,
+    getDashDefaultTheme,
+    getDashDefaultLightTheme,
+    getDashDefaultDarkTheme,
+    dashDefaultResourceIcons,
+    type DashDefaultLayoutSettings,
+    type IDashDefaultUser,
+    type IDashDefaultAuth
+} from './state';
+
+// ============================================================================
+// I18N EXTENSIONS
+// ============================================================================
+export {
+    dashDefaultTranslations,
+    dashDefaultAvailableLocales,
+    dashDefaultLocale,
+    createDashDefaultI18nProvider,
+    loadDashDefaultTranslationsAsync,
+    createDashDefaultI18nProviderAsync,
+    useDashDefaultI18nProvider,
+    createDashDefaultI18nProviderWithSettings,
+    createDashDefaultI18nProviderFromAppState
+} from './i18n';
+
+// ============================================================================
+// PROVIDER EXTENSIONS
+// ============================================================================
+export {
+    dashDefaultAuthProvider,
+    dashDefaultAuthProviderConfig,
+    dashDefaultAuthProviderOverrides,
+    dashDefaultDataProvider,
+    dashDefaultDataProviderConfig,
+    dashDefaultDataProviderOverrides,
+    dashDefaultDataProviderExtensions,
+    dashAuthProvider,
+    dashDataProvider
+} from './providers';
+
+// ============================================================================
+// THEME EXTENSIONS
+// ============================================================================
+export {
+    dashDefaultExtendedThemeOptions,
+    dashDefaultPalette,
+    dashDefaultTypography
+} from './theme';
+
+// ============================================================================
+// LAYOUT EXTENSIONS
+// ============================================================================
+export {
+    createDashDefaultDomainAppLayout,
+    createDashDefaultDomainAppLayoutWithIPC,
+    useDashDefaultDomainAppLayout,
+    useDashDefaultDomainAppLayoutWithIPC
+} from './layout';
+
+// ============================================================================
+// ELECTRON EXTENSIONS
+// ============================================================================
+export {
+    useDashDefaultIPCListeners,
+    setupDashDefaultIPCListeners
+} from './electron';
+
+// ============================================================================
+// MANAGER EXTENSIONS
+// ============================================================================
+export {
+    DashDefaultWSMessagesManager
+} from './managers';
+
+// ============================================================================
+// UTILITY EXTENSIONS
+// ============================================================================
+export {
+    dashDefaultLogoutFromStorage,
+    dashDefaultIsAuthenticated,
+    dashDefaultGetCurrentUser,
+    dashDefaultGetToken,
+    dashDefaultGetResourceConfig,
+    dashDefaultSetResourceConfigs,
+    dashDefaultProcessPostData,
+    dashDefaultProcessFormData,
+    dashDefaultBuildQueryString,
+    dashDefaultIsFormDataResource,
+    DashIPCMessageBrokerContext,
+    DashIPCMessageBrokerProvider,
+    useDashIPCMessageBroker,
+    processDashDefaultNotification,
+    playDashDefaultNotificationSound,
+    playDashDefaultDigitalWatchAlarm,
+    requestDashDefaultNotificationPermission,
+    type DashLogMessage,
+    type DashSubprocessOutput,
+    type DashIPCMessageBrokerContextType,
+    type DashIPCMessageBrokerConfig
+} from './utils';
+
+// ============================================================================
+// STYLES (Side-effect import)
+// ============================================================================
+// Note: Import this in your app's entry point to load default styles
+// import 'dash-app-common/src/defaults/extensions/styles';

package/src/defaults/extensions/layout/dashDefaultDomainAppLayout.tsx

@@ -0,0 +1,126 @@
+/**
+ * Dash Default Domain App Layout Extension
+ * 
+ * Dash default app layout wrapper that includes window controls for Electron.
+ */
+import React, { useCallback, Suspense } from 'react';
+import DASHAppLayout from 'dash-admin/src/default-theme/DomainAppLayout';
+import { IDomainAppLayout } from 'dash-admin/src/default-theme/DomainAppLayout';
+import { getEnv } from 'dash-constants';
+
+// Lazy load components
+const IPCMessageBrokerProvider = React.lazy(() => 
+    import('dash-utils').then(m => ({ default: m.IPCMessageBrokerProvider }))
+);
+
+// Simple loading fallback
+const DashDefaultLayoutLoadingFallback = () => (
+    <div style={{ 
+        display: 'flex', 
+        justifyContent: 'center', 
+        alignItems: 'center', 
+        minHeight: '200px' 
+    }}>
+        Loading...
+    </div>
+);
+
+/**
+ * Check if running in Electron
+ */
+const isElectron = (): boolean => {
+    try {
+        return JSON.parse(getEnv('IS_ELECTRON') || 'false');
+    } catch {
+        return false;
+    }
+};
+
+/**
+ * Create Dash Default Domain App Layout component (sync version)
+ * Wraps the default DASHAppLayout
+ */
+export const createDashDefaultDomainAppLayout = () => {
+    const DashDefaultDomainAppLayout = <U, A>(props: IDomainAppLayout<U, A>): React.JSX.Element => {
+        const { ThemeComponent, children } = props;
+        return (
+            <DASHAppLayout ThemeComponent={ThemeComponent}>
+                {children}
+            </DASHAppLayout>
+        );
+    };
+    
+    return DashDefaultDomainAppLayout;
+};
+
+/**
+ * Create Dash Default Domain App Layout with Electron IPC support
+ * Wraps with IPCMessageBrokerProvider when in Electron
+ */
+export const createDashDefaultDomainAppLayoutWithIPC = () => {
+    const DashDefaultDomainAppLayout = <U, A>(props: IDomainAppLayout<U, A>): React.JSX.Element => {
+        const { ThemeComponent, children } = props;
+        const inElectron = isElectron();
+
+        const LayoutContent = inElectron ? (
+            <Suspense fallback={<DashDefaultLayoutLoadingFallback />}>
+                <IPCMessageBrokerProvider>
+                    {children}
+                </IPCMessageBrokerProvider>
+            </Suspense>
+        ) : (
+            children
+        );
+
+        return (
+            <DASHAppLayout ThemeComponent={ThemeComponent}>
+                {LayoutContent}
+            </DASHAppLayout>
+        );
+    };
+    
+    return DashDefaultDomainAppLayout;
+};
+
+/**
+ * Hook to get memoized Dash Default DomainAppLayout
+ */
+export const useDashDefaultDomainAppLayout = () => {
+    return useCallback(<U, A>(props: IDomainAppLayout<U, A>): React.JSX.Element => {
+        const { ThemeComponent, children } = props;
+        return (
+            <DASHAppLayout ThemeComponent={ThemeComponent}>
+                {children}
+            </DASHAppLayout>
+        );
+    }, []);
+};
+
+/**
+ * Hook to get memoized Dash Default DomainAppLayout with Electron IPC support
+ */
+export const useDashDefaultDomainAppLayoutWithIPC = () => {
+    const inElectron = isElectron();
+    
+    return useCallback(<U, A>(props: IDomainAppLayout<U, A>): React.JSX.Element => {
+        const { ThemeComponent, children } = props;
+
+        const LayoutContent = inElectron ? (
+            <Suspense fallback={<DashDefaultLayoutLoadingFallback />}>
+                <IPCMessageBrokerProvider>
+                    {children}
+                </IPCMessageBrokerProvider>
+            </Suspense>
+        ) : (
+            children
+        );
+
+        return (
+            <DASHAppLayout ThemeComponent={ThemeComponent}>
+                {LayoutContent}
+            </DASHAppLayout>
+        );
+    }, [inElectron]);
+};
+
+export default createDashDefaultDomainAppLayout;

package/src/defaults/extensions/layout/index.ts

@@ -0,0 +1,12 @@
+/**
+ * Layout Extensions Index
+ * 
+ * Layout-related configurations and components.
+ */
+
+export { 
+    createDashDefaultDomainAppLayout, 
+    createDashDefaultDomainAppLayoutWithIPC,
+    useDashDefaultDomainAppLayout,
+    useDashDefaultDomainAppLayoutWithIPC 
+} from './dashDefaultDomainAppLayout';

package/src/defaults/extensions/managers/DashDefaultWSMessagesManager.tsx

@@ -0,0 +1,99 @@
+import { useContext, useEffect, useState } from 'react';
+import { Notification } from 'react-admin';
+import type { ILaravelEchoManager } from 'dash-admin/src/contexts/com/LaravelEchoMgr';
+import useLaravelEcho from 'dash-admin/src/contexts/com/useLaravelEcho';
+import { useAuthContext } from 'dash-admin/src/contexts/auth/AuthContext';
+import type { IAuthContext } from 'dash-admin/src/contexts/auth';
+import { IDashNotificationPayloadBase } from 'dash-admin/src/interfaces/communication/INotification';
+
+
+export const DashDefaultReactAdminNotification = () => {
+    return <Notification
+        className='dash-notification'
+        autoHideDuration={8000}
+        multiLine={true}
+        anchorOrigin={{ vertical: 'top', horizontal: 'right' }}
+    />
+};
+
+const DashDefaultWSMessagesManager = (): ILaravelEchoManager => {
+    
+    const [events, setEvents] = useState<IDashNotificationPayloadBase[]>([]);
+    const [lastEvent, setLastEvent] = useState<IDashNotificationPayloadBase>(null);
+    const authContext: IAuthContext = useAuthContext();
+
+    const [userId, setUserId] = useState(null);
+    const [tenantId, setTenantId] = useState(null);
+
+
+    useEffect(() => {
+
+        if (!authContext?.user) {
+            return;
+        }
+
+
+        setUserId(authContext.user.id);
+        setTenantId(authContext.user.tenant_id);
+
+
+
+    }, [authContext])
+
+    const clear = () => {
+        setLastEvent(null);
+    };
+
+
+    const { echoChannel: channel2,
+        isConnected: isConnected2,
+        lastEvent: event2,
+        ping: pingConnection2,
+        addListener: addListener2,
+        removeListener: reoveListener2 } = useLaravelEcho({
+            type: 'private',
+            channel: userId ? `user.${userId}` : null,
+            enabled: !!userId // Only enable if userId exists
+        });
+
+    const { echoChannel: channel3,
+        isConnected: isConnected3,
+        lastEvent: event3,
+        ping: pingConnection3,
+        addListener: addListener3,
+        removeListener: reoveListener3 } = useLaravelEcho({
+            type: 'private',
+            channel: tenantId ? `tenant.${tenantId}.system` : null,
+            enabled: !!tenantId // Only enable if tenantId exists
+        });
+
+    useEffect(() => {
+        console.log("Private Tenant Message", event2);
+        const _lastEvent = event3?.data;
+        console.log(_lastEvent);
+        setLastEvent(_lastEvent);
+
+    }, [event3]);
+
+
+    useEffect(() => {
+        console.log("Private User Message", event2);
+        const _lastEvent = event2?.data;
+        console.log(_lastEvent);
+        setLastEvent(_lastEvent);
+
+    }, [event2]);
+
+
+    useEffect(() => {
+
+        setEvents((prev) => [...prev, lastEvent])
+    }, [lastEvent])
+
+    return {
+        events,
+        lastEvent,
+        clear
+    };
+};
+export default DashDefaultWSMessagesManager;

package/src/defaults/extensions/managers/index.ts

@@ -0,0 +1,7 @@
+/**
+ * Managers Index
+ * 
+ * Manager components for handling various app-level concerns.
+ */
+
+export { default as DashDefaultWSMessagesManager, DashDefaultReactAdminNotification } from './DashDefaultWSMessagesManager';