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

package/src/contexts/MenuContext.js

@@ -0,0 +1,292 @@
+"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 hooks_1 = require("../hooks");
+const services_1 = require("../services");
+const MenuType_1 = require("../types/MenuType");
+const AuthProvider_1 = require("./AuthProvider");
+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, AuthProvider_1.useAuth)();
+    const { mode: colorMode } = (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)();
+    const authenticatedApi = (0, react_1.useMemo)(() => (0, services_1.createAuthenticatedApiClient)(baseUrl), [baseUrl]);
+    const { toggleColorMode } = (0, hooks_1.useUserSettings)({
+        authenticatedApi,
+        isAuthenticated,
+    });
+    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/{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"}

package/src/contexts/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./AuthProvider"), exports);
+tslib_1.__exportStar(require("./MenuContext"), exports);
+tslib_1.__exportStar(require("./I18nProvider"), exports);
+tslib_1.__exportStar(require("./ThemeProvider"), exports);
+tslib_1.__exportStar(require("./SuiteConfigProvider"), exports);

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

@@ -4,3 +4,4 @@ export * from './useBackupCodes';
 export * from './useUserSettings';
 export * from './useEmailVerification';
 export * from './useAuthenticatedApi';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-express-suite-react-components/src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC"}

package/src/hooks/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./useExpiringValue"), exports);
+tslib_1.__exportStar(require("./useLocalStorage"), exports);
+tslib_1.__exportStar(require("./useBackupCodes"), exports);
+tslib_1.__exportStar(require("./useUserSettings"), exports);
+tslib_1.__exportStar(require("./useEmailVerification"), exports);
+tslib_1.__exportStar(require("./useAuthenticatedApi"), exports);

package/src/hooks/useAuthenticatedApi.d.ts

@@ -0,0 +1,34 @@
+/**
+ * useAuthenticatedApi — React hook + provider for a shared authenticated
+ * Axios instance.
+ *
+ * The provider creates a single AxiosInstance via createAuthenticatedApiClient
+ * using the baseUrl from SuiteConfigProvider. All component libraries consume
+ * the same instance through the useAuthenticatedApi() hook, eliminating
+ * duplicate axios instances and circular dependency issues.
+ *
+ * Usage:
+ *   // In the app root (wrap inside SuiteConfigProvider):
+ *   <AuthenticatedApiProvider>
+ *     <App />
+ *   </AuthenticatedApiProvider>
+ *
+ *   // In any component library:
+ *   const api = useAuthenticatedApi();
+ *   const res = await api.get('/some-endpoint');
+ */
+import { ReactNode } from 'react';
+import type { AxiosInstance } from 'axios';
+export interface AuthenticatedApiProviderProps {
+    children: ReactNode;
+    /** Optional token key in localStorage. Defaults to 'authToken'. */
+    tokenKey?: string;
+}
+export declare const AuthenticatedApiProvider: ({ children, tokenKey, }: AuthenticatedApiProviderProps) => import("react").JSX.Element;
+/**
+ * Returns the shared authenticated Axios instance.
+ * Must be used within an AuthenticatedApiProvider (which itself must be
+ * inside a SuiteConfigProvider).
+ */
+export declare const useAuthenticatedApi: () => AxiosInstance;
+//# sourceMappingURL=useAuthenticatedApi.d.ts.map

package/src/hooks/useAuthenticatedApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAuthenticatedApi.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-express-suite-react-components/src/hooks/useAuthenticatedApi.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAiB,SAAS,EAAuB,MAAM,OAAO,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAQ3C,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,SAAS,CAAC;IACpB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,wBAAwB,GAAI,yBAGtC,6BAA6B,gCAa/B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,QAAO,aAQtC,CAAC"}

package/src/hooks/useAuthenticatedApi.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useAuthenticatedApi = exports.AuthenticatedApiProvider = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+/**
+ * useAuthenticatedApi — React hook + provider for a shared authenticated
+ * Axios instance.
+ *
+ * The provider creates a single AxiosInstance via createAuthenticatedApiClient
+ * using the baseUrl from SuiteConfigProvider. All component libraries consume
+ * the same instance through the useAuthenticatedApi() hook, eliminating
+ * duplicate axios instances and circular dependency issues.
+ *
+ * Usage:
+ *   // In the app root (wrap inside SuiteConfigProvider):
+ *   <AuthenticatedApiProvider>
+ *     <App />
+ *   </AuthenticatedApiProvider>
+ *
+ *   // In any component library:
+ *   const api = useAuthenticatedApi();
+ *   const res = await api.get('/some-endpoint');
+ */
+const react_1 = require("react");
+const authenticatedApi_1 = require("../services/authenticatedApi");
+const SuiteConfigProvider_1 = require("../contexts/SuiteConfigProvider");
+const AuthenticatedApiContext = (0, react_1.createContext)(undefined);
+const AuthenticatedApiProvider = ({ children, tokenKey, }) => {
+    const { baseUrl } = (0, SuiteConfigProvider_1.useSuiteConfig)();
+    const api = (0, react_1.useMemo)(() => (0, authenticatedApi_1.createAuthenticatedApiClient)(baseUrl, tokenKey), [baseUrl, tokenKey]);
+    return ((0, jsx_runtime_1.jsx)(AuthenticatedApiContext.Provider, { value: api, children: children }));
+};
+exports.AuthenticatedApiProvider = AuthenticatedApiProvider;
+/**
+ * Returns the shared authenticated Axios instance.
+ * Must be used within an AuthenticatedApiProvider (which itself must be
+ * inside a SuiteConfigProvider).
+ */
+const useAuthenticatedApi = () => {
+    const context = (0, react_1.useContext)(AuthenticatedApiContext);
+    if (!context) {
+        throw new Error('useAuthenticatedApi must be used within an AuthenticatedApiProvider');
+    }
+    return context;
+};
+exports.useAuthenticatedApi = useAuthenticatedApi;

package/src/hooks/useBackupCodes.d.ts

@@ -0,0 +1,15 @@
+export interface UseBackupCodesOptions {
+    initialCodeCount?: number | null;
+}
+export interface UseBackupCodesResult {
+    backupCodesRemaining: number | null;
+    isLoading: boolean;
+    error: Error | null;
+    generateBackupCodes: (password?: string, mnemonic?: string) => Promise<{
+        message: string;
+        backupCodes: string[];
+    }>;
+    refreshCodeCount: () => Promise<void>;
+}
+export declare const useBackupCodes: (options?: UseBackupCodesOptions) => UseBackupCodesResult;
+//# sourceMappingURL=useBackupCodes.d.ts.map

package/src/hooks/useBackupCodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBackupCodes.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-express-suite-react-components/src/hooks/useBackupCodes.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,qBAAqB;IACpC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,oBAAoB;IACnC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,mBAAmB,EAAE,CACnB,QAAQ,CAAC,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,KACd,OAAO,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC,CAAC;IACH,gBAAgB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,eAAO,MAAM,cAAc,GACzB,UAAS,qBAA0B,KAClC,oBA4EF,CAAC"}

package/src/hooks/useBackupCodes.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useBackupCodes = void 0;
+const suite_core_lib_1 = require("@digitaldefiance/suite-core-lib");
+const react_1 = require("react");
+const contexts_1 = require("../contexts");
+const services_1 = require("../services");
+const useBackupCodes = (options = {}) => {
+    const { baseUrl } = (0, contexts_1.useSuiteConfig)();
+    const [backupCodesRemaining, setBackupCodesRemaining] = (0, react_1.useState)(options.initialCodeCount ?? null);
+    const [isLoading, setIsLoading] = (0, react_1.useState)(false);
+    const [error, setError] = (0, react_1.useState)(null);
+    const requestedOnMountRef = (0, react_1.useRef)(false);
+    const api = (0, react_1.useMemo)(() => (0, services_1.createAuthenticatedApiClient)(baseUrl), [baseUrl]);
+    const refreshCodeCount = (0, react_1.useCallback)(async () => {
+        setIsLoading(true);
+        setError(null);
+        try {
+            const result = await api.get('/user/backup-codes');
+            if (result?.data?.codeCount !== undefined) {
+                setBackupCodesRemaining(result.data.codeCount);
+            }
+        }
+        catch (err) {
+            setError(err instanceof Error
+                ? err
+                : new suite_core_lib_1.TranslatableSuiteError(suite_core_lib_1.SuiteCoreStringKey.BackupCodes_FailedToFetch));
+            setBackupCodesRemaining(0);
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [api]);
+    (0, react_1.useEffect)(() => {
+        if (requestedOnMountRef.current)
+            return;
+        if (backupCodesRemaining !== null)
+            return;
+        requestedOnMountRef.current = true;
+        refreshCodeCount();
+    }, [backupCodesRemaining, refreshCodeCount]);
+    const generateBackupCodes = async (password, mnemonic) => {
+        setIsLoading(true);
+        setError(null);
+        try {
+            const result = await api.post('/user/backup-codes', {
+                ...(password ? { password } : {}),
+                ...(mnemonic ? { mnemonic } : {}),
+            });
+            return {
+                message: result.data.message,
+                backupCodes: result.data.backupCodes,
+            };
+        }
+        catch (err) {
+            const error = err instanceof Error
+                ? err
+                : new suite_core_lib_1.TranslatableSuiteError(suite_core_lib_1.SuiteCoreStringKey.BackupCodes_FailedToGenerate);
+            setError(error);
+            throw error;
+        }
+        finally {
+            setIsLoading(false);
+        }
+    };
+    return {
+        backupCodesRemaining,
+        isLoading,
+        error,
+        generateBackupCodes,
+        refreshCodeCount,
+    };
+};
+exports.useBackupCodes = useBackupCodes;