@digitaldefiance/express-suite-react-components 2.4.4 → 2.5.0

package/README.md

@@ -31,6 +31,19 @@ yarn add @digitaldefiance/express-suite-react-components
 - **DashboardPage** - Basic dashboard layout
 - **ApiAccess** - API token display and copy component
 
+### Wrapper Components
+
+Pre-configured components that integrate with application contexts. See the [Component Wrappers Guide](WRAPPERS.md) for detailed usage.
+
+- **LoginFormWrapper** - Pre-configured login with auth context integration
+- **RegisterFormWrapper** - Pre-configured registration with auth context integration
+- **ChangePasswordFormWrapper** - Pre-configured password change with auth context
+- **BackupCodeLoginWrapper** - Pre-configured backup code login
+- **BackupCodesWrapper** - Pre-configured backup codes management
+- **UserSettingsFormWrapper** - Pre-configured settings form with auto-fetch
+- **VerifyEmailPageWrapper** - Pre-configured email verification
+- **LogoutPageWrapper** - Pre-configured logout with navigation
+
 ### UI Components
 
 - **ConfirmationDialog** - Reusable confirmation dialog
@@ -49,14 +62,19 @@ yarn add @digitaldefiance/express-suite-react-components
 
 - **useLocalStorage** - React hook for localStorage with state sync
 - **useExpiringValue** - React hook for values that expire after a duration
+- **useBackupCodes** - Manage backup code generation and retrieval
+- **useUserSettings** - Fetch and update user settings with context integration
+- **useEmailVerification** - Handle email verification flow
 
 ### Contexts & Providers
 
 - **I18nProvider** - Internationalization context with i18n engine integration
 - **AppThemeProvider** - MUI theme provider with dark/light mode toggle
 - **ThemeToggleButton** - Button component for theme switching
+- **SuiteConfigProvider** - Centralized configuration context (baseUrl, routes, languages)
 - **useI18n** - Hook for accessing i18n context
 - **useTheme** - Hook for accessing theme context
+- **useSuiteConfig** - Hook for accessing suite configuration
 
 ### Services
 
@@ -70,6 +88,44 @@ yarn add @digitaldefiance/express-suite-react-components
 
 ## Usage
 
+### Getting Started with Wrappers
+
+For the quickest setup, use wrapper components that handle context integration automatically. See the [Component Wrappers Guide](WRAPPERS.md) for comprehensive examples.
+
+```tsx
+import { 
+  SuiteConfigProvider,
+  AuthProvider,
+  LoginFormWrapper 
+} from '@digitaldefiance/express-suite-react-components';
+
+function App() {
+  return (
+    <SuiteConfigProvider
+      baseUrl="https://api.example.com"
+      routes={{
+        dashboard: '/dashboard',
+        login: '/login',
+      }}
+      languages={[
+        { code: 'en-US', label: 'English (US)' },
+      ]}
+    >
+      <AuthProvider baseUrl="https://api.example.com" onAuthError={() => {}}>
+        {/* Use wrappers for instant integration */}
+        <LoginFormWrapper />
+        
+        {/* Or customize via props */}
+        <LoginFormWrapper
+          redirectTo="/custom-dashboard"
+          componentProps={{ loginType: 'username' }}
+        />
+      </AuthProvider>
+    </SuiteConfigProvider>
+  );
+}
+```
+
 ### Menu System
 
 The menu system supports extensible menu types. See the [Menu Type Extensibility Guide](docs/MENU_TYPE_EXTENSIBILITY.md) for details on creating custom menus.
@@ -295,8 +351,71 @@ interface RegisterFormProps {
 
 MIT © Digital Defiance
 
+## Documentation
+
+- **[Overview](docs/OVERVIEW.md)** - Package architecture and getting started guide
+- **[Components Documentation](docs/COMPONENTS.md)** - API reference for presentational components
+- **[Hooks Documentation](docs/HOOKS.md)** - API reference for custom React hooks
+- **[Wrappers API Documentation](docs/WRAPPERS_API.md)** - API reference for wrapper components
+- **[Component Wrappers Guide](WRAPPERS.md)** - Comprehensive guide to using wrappers, hooks, and components
+- **[Menu Type Extensibility Guide](docs/MENU_TYPE_EXTENSIBILITY.md)** - Creating custom menu types
+
 ## ChangeLog
 
+### Version 2.5.0
+
+#### Added
+
+- **SuiteConfigProvider** - Centralized configuration context for baseUrl, routes, languages, and timezones
+- **Component Wrappers** - Pre-configured wrapper components for all major forms and pages
+  - LoginFormWrapper, RegisterFormWrapper, ChangePasswordFormWrapper
+  - BackupCodeLoginWrapper, BackupCodesWrapper
+  - UserSettingsFormWrapper, VerifyEmailPageWrapper, LogoutPageWrapper
+- **Business Logic Hooks** - Reusable hooks for common operations
+  - useBackupCodes - Manage backup code generation and retrieval
+  - useUserSettings - Fetch and update user settings with context integration
+  - useEmailVerification - Handle email verification flow
+- **Component Wrappers Guide** - Comprehensive documentation at `WRAPPERS.md`
+
+#### Changed
+
+- **Wrapper Architecture** - All wrappers now use centralized SuiteConfigProvider
+- **Consistent API** - All wrappers support `onSuccess`, `componentProps`, and configurable routing
+- **Improved Testability** - Business logic extracted into hooks for easier testing
+- **Better DX** - Three levels of abstraction: Wrappers (easy), Hooks (flexible), Components (full control)
+
+#### Breaking Changes
+
+- **BackupCodesWrapper** - No longer requires `baseUrl` prop (uses SuiteConfigProvider)
+- **VerifyEmailPageWrapper** - No longer requires `baseUrl` prop (uses SuiteConfigProvider)
+- **UserSettingsFormWrapper** - No longer requires `baseUrl` or `languages` props (uses SuiteConfigProvider)
+
+#### Migration Guide
+
+```tsx
+// Old (v2.4.x)
+<BackupCodesWrapper baseUrl="https://api.example.com" />
+<UserSettingsFormWrapper 
+  baseUrl="https://api.example.com"
+  languages={[...]}
+/>
+
+// New (v2.5.0)
+<SuiteConfigProvider 
+  baseUrl="https://api.example.com"
+  languages={[...]}
+>
+  <BackupCodesWrapper />
+  <UserSettingsFormWrapper />
+</SuiteConfigProvider>
+```
+
+See [Component Wrappers Guide](WRAPPERS.md) for complete migration examples.
+
+### Version 2.4.5
+
+- DarkMode improvements
+
 ### Version 2.4.4
 
 - Fix t(tComponent( calls
@@ -321,23 +440,27 @@ MIT © Digital Defiance
 ### Version 2.4.0
 
 #### Changed
+
 - **Version Bump**: Updated from 2.3.5 to 2.4.0
 - **Dependency Update**: Upgraded `@digitaldefiance/suite-core-lib` from ^2.2.5 to ^2.2.10
 - **Translation Keys**: Replaced `Login_UseEmail` with `Login_UseEmailAddress` in BackupCodeLoginForm and LoginForm
 - **Error Messages**: Updated password login error to use `Error_Login_PasswordLoginNotSetup` instead of `PasswordLogin_Setup_NotAvailable` in AuthProvider
 
 #### Added
+
 - **Error Handling**: LoginForm now displays error messages via Alert component with Formik status
 - **Error Recovery**: LoginForm onSubmit wrapped with try-catch to capture and display errors
 - **Menu Context Integration**: TopMenu now uses `useMenu()` hook and `getTopMenus()` method
 - **Menu Types**: Added `AccountCircle` icon import and `IMenuConfig` interface import
 
 #### Fixed
+
 - **Import Path**: Corrected `IAppConfig` import path from `../interfaces/AppConfig` to `../interfaces/IAppConfig`
 - **Menu Rendering**: Simplified TopMenu additional menus logic to use centralized menu context
 - **Error Type**: Added `errorType: 'PasswordLoginNotSetup'` to password login error responses
 
 #### Technical
+
 - Enhanced error propagation in authentication flows
 - Improved menu configuration architecture with context-based management
 - Better alignment with suite-core-lib translation key naming conventions
@@ -365,10 +488,12 @@ MIT © Digital Defiance
 ### v2.3.0
 
 #### Breaking Changes
+
 - **Removed `IncludeOnMenu` enum** - Replaced with extensible `MenuType` system using branded string types
 - Menu system now requires `MenuTypes` constant instead of enum values
 
 #### Added
+
 - **Extensible Menu Type System** - New `MenuType` branded string type with `createMenuType()` factory function
 - **`MenuTypes` constant** - Built-in menu types (SideMenu, TopMenu, UserMenu) replacing enum
 - **`createMenuType()` function** - Factory for creating custom menu types with type safety
@@ -377,6 +502,7 @@ MIT © Digital Defiance
 - **Menu Type Extensibility Guide** - Comprehensive documentation at `docs/MENU_TYPE_EXTENSIBILITY.md`
 
 #### Changed
+
 - **IMenuOption.includeOnMenus** - Now uses `MenuType[]` instead of `IncludeOnMenu[]`
 - **DropdownMenu.menuType** - Now accepts `MenuType` instead of `IncludeOnMenu`
 - **MenuContext.getMenuOptions** - Now accepts `MenuType` parameter instead of `IncludeOnMenu`
@@ -384,6 +510,7 @@ MIT © Digital Defiance
 - Updated README with menu system usage examples and extensibility guide link
 
 #### Migration Guide
+
 ```typescript
 // Old (v2.2.x)
 import { IncludeOnMenu } from '@digitaldefiance/express-suite-react-components';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@digitaldefiance/express-suite-react-components",
-  "version": "2.4.4",
+  "version": "2.5.0",
   "description": "React MUI components for Digital Defiance Express Suite",
   "main": "src/index.js",
   "types": "src/index.d.ts",
@@ -8,9 +8,9 @@
     "build": "npx nx build digitaldefiance-express-suite-react-components",
     "build:stream": "npx nx build --outputStyle=stream digitaldefiance-express-suite-react-components",
     "build:logged": "npx nx build --outputStyle=stream digitaldefiance-express-suite-react-components 2>&1 | ansifilter -o build.log",
-    "test": "npx nx test digitaldefiance-express-suite-react-components",
-    "test:stream": "npx nx test --outputStyle=stream digitaldefiance-express-suite-react-components",
-    "test:logged": "npx nx test --outputStyle=stream digitaldefiance-express-suite-react-components 2>&1 | ansifilter -o test.log",
+    "test": "NODE_OPTIONS='--max-old-space-size=6144' npx nx test digitaldefiance-express-suite-react-components",
+    "test:stream": "NODE_OPTIONS='--max-old-space-size=6144' npx nx test --outputStyle=stream digitaldefiance-express-suite-react-components",
+    "test:logged": "NODE_OPTIONS='--max-old-space-size=6144' npx nx test --outputStyle=stream digitaldefiance-express-suite-react-components 2>&1 | ansifilter -o test.log",
     "test:coverage": "npx jest --coverage --testPathPattern=digitaldefiance-express-suite-react-components --coverageReporters=text",
     "lint": "npx nx lint digitaldefiance-express-suite-react-components",
     "lint:fix": "npx nx lint digitaldefiance-express-suite-react-components --fix",

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

@@ -1 +1 @@
-{"version":3,"file":"AuthProvider.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-express-suite-react-components/src/contexts/AuthProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,cAAc,EAE/B,WAAW,EACX,YAAY,EACZ,YAAY,EAIb,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAEL,YAAY,EAEb,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAEL,SAAS,EAMV,MAAM,OAAO,CAAC;AAMf,OAAO,EAAE,eAAe,EAAE,eAAe,EAA4C,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAEzI,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,KAAK,EAAE,OAAO,CAAC;IACf;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;;;OAQG;IACH,eAAe,EAAE,CACf,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,eAAe,EAAE,OAAO,EACxB,WAAW,CAAC,EAAE,MAAM,KACjB,OAAO,CACR;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GACzE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CACrC,CAAC;IACF;;;OAGG;IACH,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB;;;;;OAKG;IACH,cAAc,EAAE,CACd,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,MAAM,KAChB,OAAO,CACR,eAAe,GACf;QACE,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAChC,CACJ,CAAC;IACF,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,YAAY,EAAE,YAAY,CAAC;IAC3B,WAAW,EAAE,CACX,QAAQ,EAAE,YAAY,EACtB,QAAQ,CAAC,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,WAAW,EACnB,qBAAqB,CAAC,EAAE,MAAM,EAC9B,mBAAmB,CAAC,EAAE,MAAM,KACzB,OAAO,CACR;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,eAAe,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GACxD;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CACxC,CAAC;IACF,mBAAmB,EAAE,CACnB,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,WAAW,EACnB,qBAAqB,CAAC,EAAE,MAAM,EAC9B,mBAAmB,CAAC,EAAE,MAAM,KACzB,OAAO,CACR;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,eAAe,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GACzE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CACxC,CAAC;IACF,eAAe,EAAE,OAAO,CAAC;IAEzB,cAAc,EAAE,OAAO,CAAC;IACxB,wBAAwB,CAAC,EAAE,MAAM,OAAO,CAAC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,yBAAyB,EAAE,MAAM,CAAC;IAClC,aAAa,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,eAAe,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7L,iBAAiB,EAAE,CACjB,QAAQ,CAAC,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,WAAW,KAChB,OAAO,CAAC,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7D,YAAY,EAAE,MAAM,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,eAAe,CAAA;KAAE,CAAC,CAAC;IACtE,QAAQ,EAAE,CACR,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,KACd,OAAO,CACR;QACE,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;KAClB,GACD;QACE,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC/C,CACJ,CAAC;IACF,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,eAAe,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD;;;OAGG;IACH,wBAAwB,EAAE,MAAM,MAAM,CAAC;IACvC;;;OAGG;IACH,sBAAsB,EAAE,MAAM,MAAM,CAAC;IACrC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,WAAW,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,eAAe,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACxE,4BAA4B,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACxD,0BAA0B,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACtD,kBAAkB,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvM,OAAO,EAAE,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9D,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;IACjC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uBAAuB,EAAE,MAAM,CAAC;IAChC,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAClD;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,SAAS,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,UAAU,CAAC;IACtB,WAAW,EAAE,YAAY,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,WAAW,0CAEvB,CAAC;AAqgBF,eAAO,MAAM,YAAY,GAAI,yDAAyD,iBAAiB,4CAMtG,CAAC;AAEF,eAAO,MAAM,OAAO,uBAEnB,CAAC"}
+{"version":3,"file":"AuthProvider.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-express-suite-react-components/src/contexts/AuthProvider.tsx"],"names":[],"mappings":"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"}

package/src/contexts/AuthProvider.js

@@ -6,6 +6,7 @@ const ecies_lib_1 = require("@digitaldefiance/ecies-lib");
 const i18n_lib_1 = require("@digitaldefiance/i18n-lib");
 const react_1 = require("react");
 const I18nProvider_1 = require("./I18nProvider");
+const ThemeProvider_1 = require("./ThemeProvider");
 const authService_1 = require("../services/authService");
 const authenticatedApi_1 = require("../services/authenticatedApi");
 const useExpiringValue_1 = require("../hooks/useExpiringValue");
@@ -14,6 +15,7 @@ const suite_core_lib_1 = require("@digitaldefiance/suite-core-lib");
 exports.AuthContext = (0, react_1.createContext)({});
 const AuthProviderInner = ({ children, baseUrl, constants, eciesConfig, onLogout }) => {
     const { changeLanguage, currentLanguage, t, tComponent } = (0, I18nProvider_1.useI18n)();
+    const { setColorMode } = (0, ThemeProvider_1.useTheme)();
     const authService = (0, react_1.useMemo)(() => (0, authService_1.createAuthService)(constants, baseUrl, eciesConfig), [constants, baseUrl, eciesConfig]);
     const authenticatedApi = (0, react_1.useMemo)(() => (0, authenticatedApi_1.createAuthenticatedApiClient)(baseUrl), [baseUrl]);
     // Use the custom hooks for expiring values
@@ -97,6 +99,8 @@ const AuthProviderInner = ({ children, baseUrl, constants, eciesConfig, onLogout
                 setIsGlobalAdmin(userData.roles.some((r) => r.admin));
                 setIsAuthenticated(true);
                 setToken(token);
+                // Set theme based on user's darkMode preference
+                setColorMode(userData.darkMode ? 'dark' : 'light');
             }
         }
         catch (error) {
@@ -109,7 +113,7 @@ const AuthProviderInner = ({ children, baseUrl, constants, eciesConfig, onLogout
             setLoading(false);
             setIsCheckingAuth(false);
         }
-    }, [authService, clearMnemonic, clearWallet]);
+    }, [authService, clearMnemonic, clearWallet, setColorMode]);
     (0, react_1.useEffect)(() => {
         const token = localStorage.getItem('authToken');
         if (token) {
@@ -137,10 +141,12 @@ const AuthProviderInner = ({ children, baseUrl, constants, eciesConfig, onLogout
             setAuthState((prev) => prev + 1);
             localStorage.setItem('authToken', loginResult.token);
             localStorage.setItem('user', JSON.stringify(loginResult.user));
+            // Set theme based on user's darkMode preference
+            setColorMode(loginResult.user.darkMode ? 'dark' : 'light');
             return loginResult;
         }
         return loginResult;
-    }, [authService, setMnemonic, setWallet]);
+    }, [authService, setMnemonic, setWallet, setColorMode]);
     const emailChallengeLogin = (0, react_1.useCallback)(async (mnemonic, token, username, email, expireMnemonicSeconds, expireWalletSeconds) => {
         setLoading(true);
         const loginResult = await authService.emailChallengeLogin(mnemonic, token, username, email);
@@ -156,10 +162,12 @@ const AuthProviderInner = ({ children, baseUrl, constants, eciesConfig, onLogout
             setAuthState((prev) => prev + 1);
             localStorage.setItem('authToken', loginResult.token);
             localStorage.setItem('user', JSON.stringify(loginResult.user));
+            // Set theme based on user's darkMode preference
+            setColorMode(loginResult.user.darkMode ? 'dark' : 'light');
             return loginResult;
         }
         return loginResult;
-    }, [authService, setMnemonic, setWallet]);
+    }, [authService, setMnemonic, setWallet, setColorMode]);
     const getPasswordLoginService = (0, react_1.useCallback)(() => {
         const eciesService = new ecies_lib_1.ECIESService(eciesConfig);
         return new ecies_lib_1.PasswordLoginService(eciesService, new ecies_lib_1.Pbkdf2Service(ecies_lib_1.Constants.PBKDF2_PROFILES, ecies_lib_1.Constants.ECIES, ecies_lib_1.Constants.PBKDF2));
@@ -179,8 +187,12 @@ const AuthProviderInner = ({ children, baseUrl, constants, eciesConfig, onLogout
         setLoading(false);
         setWallet(wallet);
         setMnemonic(mnemonic);
+        // Set theme based on user's darkMode preference if login succeeded
+        if ('user' in loginResult) {
+            setColorMode(loginResult.user.darkMode ? 'dark' : 'light');
+        }
         return loginResult;
-    }, [authService, getPasswordLoginService, setMnemonic, setWallet, t, tComponent, isPasswordLoginAvailable]);
+    }, [authService, getPasswordLoginService, setMnemonic, setWallet, t, tComponent, isPasswordLoginAvailable, setColorMode]);
     const refreshToken = (0, react_1.useCallback)(async () => {
         try {
             const result = await authService.refreshToken();
@@ -232,6 +244,8 @@ const AuthProviderInner = ({ children, baseUrl, constants, eciesConfig, onLogout
             if (loginResult.user) {
                 setUser(loginResult.user);
                 setIsAuthenticated(true);
+                // Set theme based on user's darkMode preference
+                setColorMode(loginResult.user.darkMode ? 'dark' : 'light');
             }
             setAuthState((prev) => prev + 1);
             return {
@@ -242,7 +256,7 @@ const AuthProviderInner = ({ children, baseUrl, constants, eciesConfig, onLogout
             };
         }
         return loginResult;
-    }, [baseUrl]);
+    }, [baseUrl, setColorMode]);
     const logout = (0, react_1.useCallback)(async () => {
         localStorage.removeItem('user');
         localStorage.removeItem('authToken');

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-runtime").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,4CAa1B,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

@@ -2,6 +2,7 @@ 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;

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

@@ -1 +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,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,CAuBtD,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,EAO/B,CAAC"}
+{"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

@@ -20,6 +20,9 @@ const AppThemeProvider = ({ children, customTheme }) => {
         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]);

package/src/contexts/index.d.ts

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

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

@@ -1 +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"}
+{"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

@@ -5,3 +5,4 @@ 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.d.ts

@@ -1,3 +1,6 @@
 export * from './useExpiringValue';
 export * from './useLocalStorage';
+export * from './useBackupCodes';
+export * from './useUserSettings';
+export * from './useEmailVerification';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"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"}

package/src/hooks/index.js

@@ -3,3 +3,6 @@ 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);

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":"AAKA,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,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;QACrE,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,oBA8DF,CAAC"}

package/src/hooks/useBackupCodes.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useBackupCodes = void 0;
+const react_1 = require("react");
+const services_1 = require("../services");
+const contexts_1 = require("../contexts");
+const suite_core_lib_1 = require("@digitaldefiance/suite-core-lib");
+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;

package/src/hooks/useEmailVerification.d.ts

@@ -0,0 +1,10 @@
+export interface UseEmailVerificationResult {
+    isVerifying: boolean;
+    error: Error | null;
+    verifyEmail: (token: string) => Promise<{
+        success: boolean;
+        message?: string;
+    }>;
+}
+export declare const useEmailVerification: () => UseEmailVerificationResult;
+//# sourceMappingURL=useEmailVerification.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useEmailVerification.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-express-suite-react-components/src/hooks/useEmailVerification.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,0BAA0B;IACzC,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjF;AAED,eAAO,MAAM,oBAAoB,QAAO,0BA2BvC,CAAC"}

package/src/hooks/useEmailVerification.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useEmailVerification = void 0;
+const react_1 = require("react");
+const services_1 = require("../services");
+const contexts_1 = require("../contexts");
+const suite_core_lib_1 = require("@digitaldefiance/suite-core-lib");
+const useEmailVerification = () => {
+    const { baseUrl } = (0, contexts_1.useSuiteConfig)();
+    const api = (0, react_1.useMemo)(() => (0, services_1.createAuthenticatedApiClient)(baseUrl), [baseUrl]);
+    const [isVerifying, setIsVerifying] = (0, react_1.useState)(false);
+    const [error, setError] = (0, react_1.useState)(null);
+    const verifyEmail = async (verificationToken) => {
+        setIsVerifying(true);
+        setError(null);
+        try {
+            const result = await api.post('/verify-email', { token: verificationToken });
+            return { success: true, message: result.data.message };
+        }
+        catch (err) {
+            const errorMessage = err.response?.data?.message || (0, suite_core_lib_1.getSuiteCoreTranslation)(suite_core_lib_1.SuiteCoreStringKey.Error_VerificationFailed);
+            const error = new Error(errorMessage);
+            setError(error);
+            return { success: false, message: errorMessage };
+        }
+        finally {
+            setIsVerifying(false);
+        }
+    };
+    return {
+        isVerifying,
+        error,
+        verifyEmail,
+    };
+};
+exports.useEmailVerification = useEmailVerification;