@digitaldefiance/express-suite-react-components 5.0.2 → 5.0.4

package/src/contexts/MenuContext.js

@@ -0,0 +1,307 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useMenu = exports.MenuProvider = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+// src/app/menuContext.tsx
+const suite_core_lib_1 = require("@digitaldefiance/suite-core-lib");
+const icons_material_1 = require("@mui/icons-material");
+const react_1 = require("react");
+const MenuType_1 = require("../types/MenuType");
+const auth_context_1 = require("./auth-context");
+const I18nProvider_1 = require("./I18nProvider");
+const SuiteConfigProvider_1 = require("./SuiteConfigProvider");
+const ThemeProvider_1 = require("./ThemeProvider");
+const MenuContext = (0, react_1.createContext)(undefined);
+const MenuProvider = ({ children, menuConfigs = [], enableBackupCodes = true, hiddenMenuIds = [], }) => {
+    const { userData: user, isAuthenticated, admin: isGlobalAdmin, mnemonic, clearMnemonic, wallet, clearWallet, } = (0, auth_context_1.useAuth)();
+    const { mode: colorMode, toggleColorMode: themeToggle } = (0, ThemeProvider_1.useTheme)();
+    const registeredMenuOptions = (0, react_1.useRef)(new Set());
+    const [registeredOptions, setRegisteredOptions] = (0, react_1.useState)(new Map());
+    const { tComponent } = (0, I18nProvider_1.useI18n)();
+    const { baseUrl } = (0, SuiteConfigProvider_1.useSuiteConfig)();
+    // Flip the theme immediately with the crypto-free ThemeProvider toggle, then persist the choice to the server as a
+    // best-effort side effect. The persistence path (which pulls ecies-lib + axios) is loaded lazily via dynamic import
+    // ONLY when an authenticated user toggles, so it stays out of the static bundle for consumers that only use the menu.
+    const toggleColorMode = (0, react_1.useCallback)(() => {
+        const next = colorMode === 'dark' ? 'light' : 'dark';
+        themeToggle();
+        if (!isAuthenticated)
+            return;
+        void (async () => {
+            try {
+                const [{ createAuthenticatedApiClient }, { dehydrateUserSettings }] = await Promise.all([
+                    import('../services/index.js'),
+                    import('@digitaldefiance/suite-core-lib'),
+                ]);
+                const api = createAuthenticatedApiClient(baseUrl);
+                await api.post('/user/settings', dehydrateUserSettings({ darkMode: next === 'dark' }));
+            }
+            catch {
+                // Best-effort: the theme already flipped; a failed persist just means it is not remembered server-side.
+            }
+        })();
+    }, [colorMode, themeToggle, isAuthenticated, baseUrl]);
+    const registerMenuOption = (0, react_1.useCallback)((option) => {
+        const unregister = () => {
+            setRegisteredOptions((prev) => {
+                const newMap = new Map(prev);
+                newMap.delete(option.id);
+                return newMap;
+            });
+            registeredMenuOptions.current.delete(unregister);
+        };
+        setRegisteredOptions((prev) => {
+            const newMap = new Map(prev);
+            newMap.set(option.id, option);
+            return newMap;
+        });
+        registeredMenuOptions.current.add(unregister);
+        return unregister;
+    }, []);
+    const registerMenuOptions = (0, react_1.useCallback)((options) => {
+        const unregisterFunctions = options.map(registerMenuOption);
+        return () => unregisterFunctions.forEach((f) => f());
+    }, [registerMenuOption]);
+    const menuOptions = (0, react_1.useMemo)(() => {
+        const isUserRestricted = () => {
+            return user?.roles?.some((role) => role.child) ?? false;
+        };
+        let index = 0;
+        const baseOptions = [
+            {
+                id: 'dashboard',
+                label: tComponent(suite_core_lib_1.SuiteCoreComponentId, suite_core_lib_1.SuiteCoreStringKey.Common_Dashboard),
+                icon: (0, jsx_runtime_1.jsx)(icons_material_1.Dashboard, {}),
+                link: '/dashboard',
+                requiresAuth: true,
+                includeOnMenus: [MenuType_1.MenuTypes.SideMenu],
+                index: index++,
+            },
+            {
+                id: 'user-divider',
+                label: '',
+                divider: true,
+                includeOnMenus: [MenuType_1.MenuTypes.SideMenu],
+                index: index++,
+                requiresAuth: false,
+            },
+            {
+                id: 'logout',
+                label: tComponent(suite_core_lib_1.SuiteCoreComponentId, suite_core_lib_1.SuiteCoreStringKey.LogoutButton),
+                icon: (0, jsx_runtime_1.jsx)(icons_material_1.ExitToApp, {}),
+                link: '/logout',
+                requiresAuth: true,
+                includeOnMenus: [MenuType_1.MenuTypes.UserMenu, MenuType_1.MenuTypes.SideMenu],
+                index: index++,
+            },
+            {
+                id: 'login',
+                label: tComponent(suite_core_lib_1.SuiteCoreComponentId, suite_core_lib_1.SuiteCoreStringKey.Login_LoginButton),
+                icon: (0, jsx_runtime_1.jsx)(icons_material_1.Login, {}),
+                link: '/login',
+                requiresAuth: false,
+                includeOnMenus: [MenuType_1.MenuTypes.UserMenu, MenuType_1.MenuTypes.SideMenu],
+                index: index++,
+            },
+            {
+                id: 'register',
+                label: tComponent(suite_core_lib_1.SuiteCoreComponentId, suite_core_lib_1.SuiteCoreStringKey.RegisterButton),
+                icon: (0, jsx_runtime_1.jsx)(icons_material_1.PersonAdd, {}),
+                link: '/register',
+                requiresAuth: false,
+                includeOnMenus: [MenuType_1.MenuTypes.UserMenu, MenuType_1.MenuTypes.SideMenu],
+                index: index++,
+            },
+            {
+                id: 'forgot-password',
+                label: tComponent(suite_core_lib_1.SuiteCoreComponentId, suite_core_lib_1.SuiteCoreStringKey.ForgotPassword_Title),
+                icon: (0, jsx_runtime_1.jsx)(icons_material_1.LockOpen, {}),
+                link: '/forgot-password',
+                requiresAuth: false,
+                includeOnMenus: [MenuType_1.MenuTypes.UserMenu, MenuType_1.MenuTypes.SideMenu],
+                index: index++,
+            },
+            {
+                id: 'change-password',
+                label: tComponent(suite_core_lib_1.SuiteCoreComponentId, suite_core_lib_1.SuiteCoreStringKey.Common_ChangePassword),
+                icon: (0, jsx_runtime_1.jsx)(icons_material_1.LockReset, {}),
+                link: '/change-password',
+                requiresAuth: true,
+                includeOnMenus: [MenuType_1.MenuTypes.UserMenu, MenuType_1.MenuTypes.SideMenu],
+                index: index++,
+            },
+            ...(enableBackupCodes
+                ? [
+                    {
+                        id: 'backup-code',
+                        label: tComponent(suite_core_lib_1.SuiteCoreComponentId, suite_core_lib_1.SuiteCoreStringKey.BackupCodeRecovery_Title),
+                        icon: (0, jsx_runtime_1.jsx)(icons_material_1.Key, {}),
+                        link: '/backup-code',
+                        requiresAuth: false,
+                        includeOnMenus: [MenuType_1.MenuTypes.UserMenu, MenuType_1.MenuTypes.SideMenu],
+                        index: index++,
+                    },
+                    {
+                        id: 'backup-codes',
+                        label: tComponent(suite_core_lib_1.SuiteCoreComponentId, suite_core_lib_1.SuiteCoreStringKey.BackupCodeRecovery_GenerateNewCodes),
+                        icon: (0, jsx_runtime_1.jsx)(icons_material_1.Autorenew, {}),
+                        link: '/backup-codes',
+                        requiresAuth: true,
+                        includeOnMenus: [MenuType_1.MenuTypes.UserMenu, MenuType_1.MenuTypes.SideMenu],
+                        index: index++,
+                    },
+                ]
+                : []),
+            {
+                id: 'divider',
+                label: '',
+                divider: true,
+                includeOnMenus: [MenuType_1.MenuTypes.SideMenu],
+                index: index++,
+                requiresAuth: false,
+            },
+            {
+                id: 'clear-mnemonic',
+                label: tComponent(suite_core_lib_1.SuiteCoreComponentId, suite_core_lib_1.SuiteCoreStringKey.Common_ClearMnemonic),
+                action: clearMnemonic,
+                icon: (0, jsx_runtime_1.jsx)(icons_material_1.Key, {}),
+                requiresAuth: true,
+                includeOnMenus: [MenuType_1.MenuTypes.UserMenu, MenuType_1.MenuTypes.SideMenu],
+                index: index++,
+                filter: () => !!mnemonic,
+            },
+            {
+                id: 'clear-wallet',
+                label: tComponent(suite_core_lib_1.SuiteCoreComponentId, suite_core_lib_1.SuiteCoreStringKey.Common_ClearWallet),
+                action: clearWallet,
+                icon: (0, jsx_runtime_1.jsx)(icons_material_1.Key, {}),
+                requiresAuth: true,
+                includeOnMenus: [MenuType_1.MenuTypes.UserMenu, MenuType_1.MenuTypes.SideMenu],
+                index: index++,
+                filter: () => !!wallet,
+            },
+            ...(isUserRestricted() ? [] : []),
+            {
+                id: 'color-divider',
+                label: '',
+                divider: true,
+                includeOnMenus: [MenuType_1.MenuTypes.SideMenu],
+                index: index++,
+                requiresAuth: undefined,
+            },
+            {
+                id: 'theme-toggle',
+                label: colorMode === 'dark'
+                    ? tComponent(suite_core_lib_1.SuiteCoreComponentId, suite_core_lib_1.SuiteCoreStringKey.Common_ThemeToggle_Light)
+                    : tComponent(suite_core_lib_1.SuiteCoreComponentId, suite_core_lib_1.SuiteCoreStringKey.Common_ThemeToggle_Dark),
+                icon: colorMode === 'dark' ? (0, jsx_runtime_1.jsx)(icons_material_1.Brightness7, {}) : (0, jsx_runtime_1.jsx)(icons_material_1.Brightness4, {}),
+                includeOnMenus: [MenuType_1.MenuTypes.SideMenu],
+                index: index++,
+                requiresAuth: undefined,
+                action: toggleColorMode,
+            },
+            {
+                id: 'user-settings',
+                label: tComponent(suite_core_lib_1.SuiteCoreComponentId, suite_core_lib_1.SuiteCoreStringKey.Settings_Title),
+                icon: (0, jsx_runtime_1.jsx)(icons_material_1.Settings, {}),
+                link: '/user-settings',
+                requiresAuth: true,
+                includeOnMenus: [MenuType_1.MenuTypes.UserMenu, MenuType_1.MenuTypes.SideMenu],
+                index: index++,
+            },
+        ];
+        const allOptions = [...baseOptions, ...registeredOptions.values()];
+        return allOptions.sort((a, b) => a.index - b.index);
+    }, [
+        tComponent,
+        registeredOptions,
+        user?.roles,
+        colorMode,
+        toggleColorMode,
+        clearMnemonic,
+        clearWallet,
+        mnemonic,
+        wallet,
+        enableBackupCodes,
+    ]);
+    const getMenuOptions = (0, react_1.useCallback)((menuType, includeDividers) => {
+        const hidden = new Set(hiddenMenuIds);
+        const MenuFilter = (o) => {
+            // Suppress any option whose id the consumer asked to hide.
+            if (hidden.has(o.id))
+                return false;
+            // Apply the custom filter first
+            let customFilterPasses = true;
+            if (o.filter !== undefined) {
+                customFilterPasses = o.filter(o);
+            }
+            if (!customFilterPasses)
+                return false;
+            if (o.divider === true && !includeDividers)
+                return false;
+            if (o.requiresAdmin === true && !isGlobalAdmin)
+                return false;
+            return (o.includeOnMenus.includes(menuType) &&
+                (o.requiresAuth === undefined || o.requiresAuth === isAuthenticated));
+        };
+        const filtered = menuOptions.filter(MenuFilter);
+        // Drop dividers left orphaned once hidden items are removed: a divider at
+        // the start or end of the list, or immediately following another divider,
+        // carries no meaning and would show as a stray separator.
+        return filtered.filter((o, i) => {
+            if (o.divider !== true)
+                return true;
+            const prev = filtered[i - 1];
+            if (prev === undefined || prev.divider === true)
+                return false;
+            if (i === filtered.length - 1)
+                return false;
+            return true;
+        });
+    }, [hiddenMenuIds, isAuthenticated, isGlobalAdmin, menuOptions]);
+    (0, react_1.useEffect)(() => {
+        if (menuConfigs.length > 0) {
+            return registerMenuOptions(menuConfigs.flatMap((config) => config.options));
+        }
+        return undefined;
+    }, [menuConfigs, registerMenuOptions]);
+    const getTopMenus = (0, react_1.useCallback)(() => {
+        const menus = [
+            ...menuConfigs.map((config) => ({ ...config, isUserMenu: false })),
+            {
+                menuType: MenuType_1.MenuTypes.UserMenu,
+                menuIcon: (0, jsx_runtime_1.jsx)(icons_material_1.AccountCircle, {}),
+                priority: 0,
+                options: [],
+                isUserMenu: true,
+            },
+        ];
+        return menus.sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));
+    }, [menuConfigs]);
+    const contextValue = (0, react_1.useMemo)(() => {
+        return {
+            menuOptions: menuOptions,
+            getMenuOptions: getMenuOptions,
+            registerMenuOption: registerMenuOption,
+            registerMenuOptions: registerMenuOptions,
+            getTopMenus: getTopMenus,
+        };
+    }, [
+        menuOptions,
+        getMenuOptions,
+        registerMenuOption,
+        registerMenuOptions,
+        getTopMenus,
+    ]);
+    const memoizedChildren = (0, react_1.useMemo)(() => children, [children]);
+    return ((0, jsx_runtime_1.jsx)(MenuContext.Provider, { value: contextValue, children: memoizedChildren }));
+};
+exports.MenuProvider = MenuProvider;
+const useMenu = () => {
+    const context = (0, react_1.useContext)(MenuContext);
+    if (context === undefined) {
+        throw new Error('useMenu must be used within a MenuProvider');
+    }
+    return context;
+};
+exports.useMenu = useMenu;

package/src/contexts/SuiteConfigProvider.d.ts

@@ -0,0 +1,44 @@
+import { ReactNode } from 'react';
+export interface SuiteConfigRoutes {
+    dashboard?: string;
+    login?: string;
+    register?: string;
+    verifyEmail?: string;
+    forgotPassword?: string;
+    resetPassword?: string;
+    settings?: string;
+}
+export interface SuiteConfigContextData {
+    /**
+     * Base URL for API calls
+     */
+    baseUrl: string;
+    /**
+     * Application routes for navigation
+     */
+    routes: SuiteConfigRoutes;
+    /**
+     * Available languages for the application
+     */
+    languages: Array<{
+        code: string;
+        label: string;
+    }>;
+    /**
+     * Available timezones
+     */
+    timezones?: string[];
+}
+export interface SuiteConfigProviderProps {
+    children: ReactNode;
+    baseUrl: string;
+    routes?: Partial<SuiteConfigRoutes>;
+    languages?: Array<{
+        code: string;
+        label: string;
+    }>;
+    timezones?: string[];
+}
+export declare const SuiteConfigProvider: ({ children, baseUrl, routes, languages, timezones, }: SuiteConfigProviderProps) => import("react").JSX.Element;
+export declare const useSuiteConfig: () => SuiteConfigContextData;
+//# sourceMappingURL=SuiteConfigProvider.d.ts.map

package/src/contexts/SuiteConfigProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SuiteConfigProvider.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-express-suite-react-components/src/contexts/SuiteConfigProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,SAAS,EAAc,MAAM,OAAO,CAAC;AAE7D,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,MAAM,EAAE,iBAAiB,CAAC;IAE1B;;OAEG;IACH,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAElD;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAyBD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,SAAS,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACpC,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,eAAO,MAAM,mBAAmB,GAAI,sDAMjC,wBAAwB,gCAa1B,CAAC;AAEF,eAAO,MAAM,cAAc,QAAO,sBAMjC,CAAC"}

package/src/contexts/SuiteConfigProvider.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useSuiteConfig = exports.SuiteConfigProvider = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const defaultRoutes = {
+    dashboard: '/dashboard',
+    login: '/login',
+    register: '/register',
+    verifyEmail: '/verify-email',
+    forgotPassword: '/forgot-password',
+    resetPassword: '/reset-password',
+    settings: '/settings',
+};
+const defaultLanguages = [
+    { code: 'en-US', label: 'English (US)' },
+    { code: 'en-GB', label: 'English (UK)' },
+    { code: 'es-ES', label: 'Español' },
+    { code: 'fr-FR', label: 'Français' },
+    { code: 'de-DE', label: 'Deutsch' },
+    { code: 'ja', label: '日本語' },
+    { code: 'zh-CN', label: '中文 (简体)' },
+    { code: 'uk', label: 'Українська' },
+];
+const SuiteConfigContext = (0, react_1.createContext)(undefined);
+const SuiteConfigProvider = ({ children, baseUrl, routes = {}, languages = defaultLanguages, timezones, }) => {
+    const value = {
+        baseUrl,
+        routes: { ...defaultRoutes, ...routes },
+        languages,
+        timezones,
+    };
+    return ((0, jsx_runtime_1.jsx)(SuiteConfigContext.Provider, { value: value, children: children }));
+};
+exports.SuiteConfigProvider = SuiteConfigProvider;
+const useSuiteConfig = () => {
+    const context = (0, react_1.useContext)(SuiteConfigContext);
+    if (!context) {
+        throw new Error('useSuiteConfig must be used within a SuiteConfigProvider');
+    }
+    return context;
+};
+exports.useSuiteConfig = useSuiteConfig;

package/src/contexts/ThemeProvider.d.ts

@@ -0,0 +1,15 @@
+import { PaletteMode, Theme } from '@mui/material';
+import { FC, ReactNode } from 'react';
+export interface ThemeContextType {
+    toggleColorMode: () => void;
+    setColorMode: (mode: PaletteMode) => void;
+    mode: PaletteMode;
+}
+export declare const useTheme: () => ThemeContextType;
+export interface AppThemeProviderProps {
+    children: ReactNode;
+    customTheme?: (mode: PaletteMode) => Theme;
+}
+export declare const AppThemeProvider: FC<AppThemeProviderProps>;
+export declare const ThemeToggleButton: FC;
+//# sourceMappingURL=ThemeProvider.d.ts.map

package/src/contexts/ThemeProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeProvider.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-express-suite-react-components/src/contexts/ThemeProvider.tsx"],"names":[],"mappings":"AACA,OAAO,EAGL,WAAW,EAEX,KAAK,EACN,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,EAAE,EAAE,SAAS,EAAgD,MAAM,OAAO,CAAC;AAEpF,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,YAAY,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC;IAC1C,IAAI,EAAE,WAAW,CAAC;CACnB;AAID,eAAO,MAAM,QAAQ,wBAMpB,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,SAAS,CAAC;IACpB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,KAAK,CAAC;CAC5C;AAED,eAAO,MAAM,gBAAgB,EAAE,EAAE,CAAC,qBAAqB,CA0BtD,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,EAO/B,CAAC"}

package/src/contexts/ThemeProvider.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ThemeToggleButton = exports.AppThemeProvider = exports.useTheme = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const icons_material_1 = require("@mui/icons-material");
+const material_1 = require("@mui/material");
+const react_1 = require("react");
+const ThemeContext = (0, react_1.createContext)(undefined);
+const useTheme = () => {
+    const context = (0, react_1.useContext)(ThemeContext);
+    if (!context) {
+        throw new Error('useTheme must be used within an AppThemeProvider');
+    }
+    return context;
+};
+exports.useTheme = useTheme;
+const AppThemeProvider = ({ children, customTheme }) => {
+    const [mode, setMode] = (0, react_1.useState)('light');
+    const colorMode = (0, react_1.useMemo)(() => ({
+        toggleColorMode: () => {
+            setMode((prevMode) => (prevMode === 'light' ? 'dark' : 'light'));
+        },
+        setColorMode: (newMode) => {
+            setMode(newMode);
+        },
+        mode,
+    }), [mode]);
+    const theme = (0, react_1.useMemo)(() => (customTheme ? customTheme(mode) : (0, material_1.createTheme)({ palette: { mode } })), [mode, customTheme]);
+    return ((0, jsx_runtime_1.jsx)(ThemeContext.Provider, { value: colorMode, children: (0, jsx_runtime_1.jsx)(material_1.ThemeProvider, { theme: theme, children: children }) }));
+};
+exports.AppThemeProvider = AppThemeProvider;
+const ThemeToggleButton = () => {
+    const { mode, toggleColorMode } = (0, exports.useTheme)();
+    return ((0, jsx_runtime_1.jsx)(material_1.IconButton, { onClick: toggleColorMode, color: "inherit", children: mode === 'dark' ? (0, jsx_runtime_1.jsx)(icons_material_1.Brightness7, {}) : (0, jsx_runtime_1.jsx)(icons_material_1.Brightness4, {}) }));
+};
+exports.ThemeToggleButton = ThemeToggleButton;

package/src/contexts/auth-context.d.ts

@@ -0,0 +1,172 @@
+import type { EmailString, Member as FrontendMember, SecureString } from '@digitaldefiance/ecies-lib';
+import type { CurrencyCode } from '@digitaldefiance/i18n-lib';
+import type { IRequestUserDTO, ISuccessMessage, IUserSettings } from '@digitaldefiance/suite-core-lib';
+import type { Wallet } from '@ethereumjs/wallet';
+import type { PaletteMode } from '@mui/material';
+export interface AuthContextData {
+    /**
+     * True if the user has a global admin role
+     */
+    admin: boolean;
+    /**
+     * Counter that increments on login/logout to trigger effects in dependent components
+     */
+    authState: number;
+    /**
+     * Performs a server side backup-code login
+     * @param identifier
+     * @param code
+     * @param isEmail
+     * @param recoverMnemonic
+     * @param newPassword
+     * @returns
+     */
+    backupCodeLogin: (identifier: string, code: string, isEmail: boolean, recoverMnemonic: boolean, newPassword?: string) => Promise<{
+        token: string;
+        codeCount: number;
+        mnemonic?: string;
+        message?: string;
+    } | {
+        error: string;
+        status?: number;
+    }>;
+    /**
+     * Verifies the stored token (if any) and updates auth state
+     * @returns void
+     */
+    checkAuth: () => void;
+    /**
+     * Changes the stored browser password login mnemonic
+     * @param currentPassword
+     * @param newPassword
+     * @returns
+     */
+    changePassword: (currentPassword: string, newPassword: string) => Promise<ISuccessMessage | {
+        error: string;
+        errorType?: string | undefined;
+    }>;
+    clearMnemonic: () => void;
+    clearWallet: () => void;
+    colorMode?: PaletteMode;
+    currencyCode?: CurrencyCode;
+    directLogin: (mnemonic: SecureString, username?: string, email?: EmailString, expireMnemonicSeconds?: number, expireWalletSeconds?: number) => Promise<{
+        token: string;
+        user: IRequestUserDTO;
+        wallet: Wallet;
+    } | {
+        pendingTotpToken: string;
+    } | {
+        error: string;
+        errorType?: string;
+    }>;
+    emailChallengeLogin: (mnemonic: SecureString, token: string, username?: string, email?: EmailString, expireMnemonicSeconds?: number, expireWalletSeconds?: number) => Promise<{
+        token: string;
+        user: IRequestUserDTO;
+        wallet: Wallet;
+        message: string;
+    } | {
+        pendingTotpToken: string;
+    } | {
+        error: string;
+        errorType?: string;
+    }>;
+    isAuthenticated: boolean;
+    isCheckingAuth: boolean;
+    isBrowserPasswordLoginAvailable?: () => boolean;
+    loading: boolean;
+    logout: () => void;
+    mnemonic?: SecureString;
+    mnemonicExpirationSeconds: number;
+    passwordLogin: (password: SecureString, username?: string, email?: EmailString) => Promise<{
+        token: string;
+        user: IRequestUserDTO;
+        wallet: Wallet;
+    } | {
+        pendingTotpToken: string;
+    } | {
+        error: string;
+        errorType?: string;
+    }>;
+    requestEmailLogin: (username?: string, email?: EmailString) => Promise<string | {
+        error: string;
+        errorType?: string;
+    }>;
+    refreshToken: () => Promise<{
+        token: string;
+        user: IRequestUserDTO;
+    }>;
+    register: (username: string, email: string, timezone: string, password?: string, mnemonic?: string, displayName?: string, directChallenge?: boolean) => Promise<{
+        success: boolean;
+        message: string;
+        mnemonic: string;
+    } | {
+        error: string;
+        errorType?: string;
+        field?: string;
+        errors?: Array<{
+            path: string;
+            msg: string;
+        }>;
+    }>;
+    serverPublicKey: string | null;
+    /**
+     * Gets the remaining time in seconds for the mnemonic expiration
+     * @returns Number of seconds remaining, or 0 if no mnemonic is set
+     */
+    getMnemonicRemainingTime: () => number;
+    /**
+     * Gets the remaining time in seconds for the wallet expiration
+     * @returns Number of seconds remaining, or 0 if no wallet is set
+     */
+    getWalletRemainingTime: () => number;
+    setMnemonic: (mnemonic: SecureString, durationSeconds?: number) => void;
+    setMnemonicExpirationSeconds: (seconds: number) => void;
+    setWalletExpirationSeconds: (seconds: number) => void;
+    setUpBrowserPasswordLogin: (mnemonic: SecureString, password: SecureString, username?: string, email?: EmailString) => Promise<{
+        success: boolean;
+        message: string;
+    } | {
+        error: string;
+        errorType?: string;
+    }>;
+    setUser: (user: IRequestUserDTO | null) => Promise<void>;
+    setUserSetting: (setting?: Partial<IUserSettings>) => Promise<void>;
+    setWallet: (wallet: Wallet, durationSeconds?: number) => void;
+    user: FrontendMember | null;
+    userData: IRequestUserDTO | null;
+    userSettings: IUserSettings | undefined;
+    token: string | null;
+    wallet?: Wallet;
+    walletExpirationSeconds: number;
+    verifyToken: (token: string) => Promise<boolean>;
+    /**
+     * Initiates TOTP setup for the authenticated user.
+     * Returns the provisioning URI and raw base32 secret on success.
+     */
+    setupTotp: () => Promise<{
+        provisioningUri: string;
+        secret: string;
+    } | {
+        error: string;
+    }>;
+    /**
+     * Confirms TOTP setup with a 6-digit code.
+     */
+    confirmTotp: (code: string) => Promise<{
+        success: boolean;
+    } | {
+        error: string;
+    }>;
+    /**
+     * Completes TOTP login by verifying a 6-digit code against a pending TOTP token.
+     */
+    verifyTotpLogin: (pendingTotpToken: string, code: string) => Promise<{
+        token: string;
+        user: IRequestUserDTO;
+    } | {
+        error: string;
+    }>;
+}
+export declare const AuthContext: import("react").Context<AuthContextData>;
+export declare const useAuth: () => AuthContextData;
+//# sourceMappingURL=auth-context.d.ts.map

package/src/contexts/auth-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-context.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-express-suite-react-components/src/contexts/auth-context.tsx"],"names":[],"mappings":"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"}

package/src/contexts/auth-context.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useAuth = exports.AuthContext = void 0;
+/**
+ * The authentication context, its data shape, and the `useAuth` hook, split out of AuthProvider so consumers that only
+ * read auth state (e.g. the menu components) need not pull AuthProvider's runtime crypto/HTTP stack (ecies-lib,
+ * @ethereumjs/wallet, axios) into their bundle. The crypto/suite symbols are imported as TYPES only, so they are erased
+ * at build time and add no runtime weight. AuthProvider re-exports these, so the public API is unchanged.
+ */
+const react_1 = require("react");
+exports.AuthContext = (0, react_1.createContext)({});
+const useAuth = () => (0, react_1.useContext)(exports.AuthContext);
+exports.useAuth = useAuth;

package/src/contexts/{index.ts → index.d.ts}

@@ -3,3 +3,4 @@ export * from './MenuContext';
 export * from './I18nProvider';
 export * from './ThemeProvider';
 export * from './SuiteConfigProvider';
+//# sourceMappingURL=index.d.ts.map

package/src/contexts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-express-suite-react-components/src/contexts/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC"}