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

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;

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":"AAQA,MAAM,WAAW,0BAA0B;IACzC,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,CACX,KAAK,EAAE,MAAM,KACV,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtD;AAED,eAAO,MAAM,oBAAoB,QAAO,0BAqCvC,CAAC"}

package/src/hooks/useEmailVerification.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useEmailVerification = 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 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 = (0, react_1.useCallback)(async (verificationToken) => {
+        setIsVerifying(true);
+        setError(null);
+        try {
+            const result = await api.post('/user/verify-email', {
+                token: verificationToken,
+            });
+            return { success: true, message: result.data.message };
+        }
+        catch (err) {
+            const axiosError = err;
+            const errorMessage = axiosError.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);
+        }
+    }, [api]);
+    return {
+        isVerifying,
+        error,
+        verifyEmail,
+    };
+};
+exports.useEmailVerification = useEmailVerification;

package/src/hooks/useExpiringValue.d.ts

@@ -0,0 +1,14 @@
+export interface TimerInfo {
+    timeout: NodeJS.Timeout;
+    startTime: number;
+    durationMs: number;
+}
+export interface ExpiringValueReturn<T> {
+    value: T | undefined;
+    setValue: (newValue: T, durationSeconds?: number, saveToStorage?: boolean) => () => void;
+    clearValue: () => void;
+    getRemainingTime: () => number;
+    isActive: boolean;
+}
+export declare function useExpiringValue<T>(defaultDurationSeconds: number, localStorageKey?: string): ExpiringValueReturn<T>;
+//# sourceMappingURL=useExpiringValue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useExpiringValue.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-express-suite-react-components/src/hooks/useExpiringValue.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC;IACrB,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,EAAE,eAAe,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,OAAO,KAAK,MAAM,IAAI,CAAC;IACzF,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,gBAAgB,EAAE,MAAM,MAAM,CAAC;IAC/B,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,sBAAsB,EAAE,MAAM,EAC9B,eAAe,CAAC,EAAE,MAAM,GACvB,mBAAmB,CAAC,CAAC,CAAC,CA0DxB"}

package/src/hooks/useExpiringValue.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useExpiringValue = useExpiringValue;
+const react_1 = require("react");
+function useExpiringValue(defaultDurationSeconds, localStorageKey) {
+    const [value, _setValue] = (0, react_1.useState)(undefined);
+    const [timer, setTimer] = (0, react_1.useState)(undefined);
+    const [durationSeconds, _setDurationSeconds] = (0, react_1.useState)(() => {
+        if (localStorageKey) {
+            const stored = localStorage.getItem(localStorageKey);
+            return stored ? parseInt(stored, 10) : defaultDurationSeconds;
+        }
+        return defaultDurationSeconds;
+    });
+    const getRemainingTime = (0, react_1.useCallback)(() => {
+        if (!timer)
+            return 0;
+        const elapsed = Date.now() - timer.startTime;
+        const remaining = Math.max(0, timer.durationMs - elapsed);
+        return Math.ceil(remaining / 1000);
+    }, [timer]);
+    const setValue = (0, react_1.useCallback)((newValue, customDurationSeconds, saveToStorage) => {
+        const finalDurationSeconds = customDurationSeconds ?? durationSeconds;
+        if (saveToStorage && customDurationSeconds !== undefined && localStorageKey) {
+            _setDurationSeconds(customDurationSeconds);
+            localStorage.setItem(localStorageKey, customDurationSeconds.toString());
+        }
+        _setValue(newValue);
+        if (timer) {
+            clearTimeout(timer.timeout);
+        }
+        const startTime = Date.now();
+        const durationMs = finalDurationSeconds * 1000;
+        const timeout = setTimeout(() => {
+            _setValue(undefined);
+            setTimer(undefined);
+        }, durationMs);
+        setTimer({ timeout, startTime, durationMs });
+        return () => {
+            clearTimeout(timeout);
+            setTimer(undefined);
+        };
+    }, [durationSeconds, timer, localStorageKey]);
+    const clearValue = (0, react_1.useCallback)(() => {
+        if (timer) {
+            clearTimeout(timer.timeout);
+            setTimer(undefined);
+        }
+        _setValue(undefined);
+    }, [timer]);
+    const isActive = Boolean(timer && value !== undefined);
+    return { value, setValue, clearValue, getRemainingTime, isActive };
+}

package/src/hooks/useLocalStorage.d.ts

@@ -0,0 +1,2 @@
+export declare function useLocalStorage<T>(key: string, defaultValue: T): [T, (value: T) => void];
+//# sourceMappingURL=useLocalStorage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useLocalStorage.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-express-suite-react-components/src/hooks/useLocalStorage.ts"],"names":[],"mappings":"AAGA,wBAAgB,eAAe,CAAC,CAAC,EAC/B,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,CAAC,GACd,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC,CAWzB"}

package/src/hooks/useLocalStorage.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useLocalStorage = useLocalStorage;
+const react_1 = require("react");
+const suite_core_lib_1 = require("@digitaldefiance/suite-core-lib");
+function useLocalStorage(key, defaultValue) {
+    const [storedValue, setStoredValue] = (0, react_1.useState)(() => {
+        return suite_core_lib_1.LocalStorageManager.getValue(key, defaultValue);
+    });
+    const setValue = (0, react_1.useCallback)((value) => {
+        setStoredValue(value);
+        suite_core_lib_1.LocalStorageManager.setValue(key, value);
+    }, [key]);
+    return [storedValue, setValue];
+}

package/src/hooks/useUserSettings.d.ts

@@ -0,0 +1,48 @@
+import { IUserSettings, IUserSettingsDTO } from '@digitaldefiance/suite-core-lib';
+export interface UseUserSettingsOptions {
+    authenticatedApi: {
+        post: <T = unknown>(url: string, data: Record<string, unknown>) => Promise<{
+            data: T;
+        }>;
+    };
+    isAuthenticated: boolean;
+}
+export interface UseUserSettingsResult {
+    currentLanguage: string;
+    changeLanguage: (languageCode: string) => Promise<void>;
+    userSettings: IUserSettings | undefined;
+    setUserSettingAndUpdateSettings: (setting?: Partial<IUserSettings>) => Promise<void>;
+    toggleColorMode: () => Promise<void>;
+}
+/**
+ * Hook for managing user settings state and synchronization.
+ * Used by AuthProvider to handle user settings logic.
+ */
+export declare const useUserSettings: ({ authenticatedApi, isAuthenticated, }: UseUserSettingsOptions) => UseUserSettingsResult;
+export interface UserSettingsValues extends IUserSettingsDTO {
+    [key: string]: string | boolean | undefined;
+}
+export interface UseUserSettingsPublicResult {
+    settings: UserSettingsValues | null;
+    isLoading: boolean;
+    error: Error | null;
+    updateSettings: (values: UserSettingsValues) => Promise<{
+        success: boolean;
+        message: string;
+    } | {
+        error: string;
+        errorType?: string;
+        field?: string;
+        errors?: Array<{
+            path: string;
+            msg: string;
+        }>;
+    }>;
+    refreshSettings: () => Promise<void>;
+}
+/**
+ * Public hook for components to manage user settings.
+ * Provides a simpler API for fetching and updating settings.
+ */
+export declare const useUserSettingsPublic: () => UseUserSettingsPublicResult;
+//# sourceMappingURL=useUserSettings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useUserSettings.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-express-suite-react-components/src/hooks/useUserSettings.ts"],"names":[],"mappings":"AAQA,OAAO,EAGL,aAAa,EACb,gBAAgB,EAGjB,MAAM,iCAAiC,CAAC;AAYzC,MAAM,WAAW,sBAAsB;IACrC,gBAAgB,EAAE;QAChB,IAAI,EAAE,CAAC,CAAC,GAAG,OAAO,EAChB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,OAAO,CAAC;YAAE,IAAI,EAAE,CAAC,CAAA;SAAE,CAAC,CAAC;KAC3B,CAAC;IACF,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,YAAY,EAAE,aAAa,GAAG,SAAS,CAAC;IACxC,+BAA+B,EAAE,CAC/B,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,KAC7B,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,eAAe,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,wCAG7B,sBAAsB,KAAG,qBAsF3B,CAAC;AAGF,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IAC1D,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CAC7C;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,cAAc,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,OAAO,CACnD;QACE,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KACjB,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,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,QAAO,2BAoGxC,CAAC"}

package/src/hooks/useUserSettings.js

@@ -0,0 +1,171 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useUserSettingsPublic = exports.useUserSettings = void 0;
+const ecies_lib_1 = require("@digitaldefiance/ecies-lib");
+const i18n_lib_1 = require("@digitaldefiance/i18n-lib");
+const suite_core_lib_1 = require("@digitaldefiance/suite-core-lib");
+const react_1 = require("react");
+const contexts_1 = require("../contexts");
+const defaultUserSettings = {
+    darkMode: false,
+    currency: new i18n_lib_1.CurrencyCode(i18n_lib_1.DefaultCurrencyCode),
+    timezone: new i18n_lib_1.Timezone(i18n_lib_1.DefaultTimezone),
+    siteLanguage: i18n_lib_1.DefaultLanguageCode,
+    directChallenge: false,
+};
+/**
+ * Hook for managing user settings state and synchronization.
+ * Used by AuthProvider to handle user settings logic.
+ */
+const useUserSettings = ({ authenticatedApi, isAuthenticated, }) => {
+    const { setColorMode: themeSetPaletteMode, mode: currentThemeMode } = (0, contexts_1.useTheme)();
+    const { currentLanguage, changeLanguage } = (0, contexts_1.useI18n)();
+    const [userSettings, setUserSettings] = (0, react_1.useState)(undefined);
+    const setUserSettingAndUpdateSettings = (0, react_1.useCallback)(async (setting) => {
+        if (setting) {
+            // Merge settings with defaults and existing settings
+            const merged = {
+                ...defaultUserSettings,
+                ...(userSettings ? userSettings : {}),
+                ...setting,
+            };
+            // TypeScript requires all IUserSettings fields, but during initialization
+            // some fields like email may not be set yet. We'll use Partial until
+            // all required fields are available.
+            setUserSettings(merged);
+            if (setting.darkMode !== undefined) {
+                themeSetPaletteMode(setting.darkMode ? 'dark' : 'light');
+            }
+            if (setting.siteLanguage !== undefined &&
+                setting.siteLanguage !== currentLanguage) {
+                await changeLanguage(setting.siteLanguage);
+            }
+            // Send to server if authenticated and we have complete settings (including email)
+            if (isAuthenticated && merged.email) {
+                const dehydratedSettings = (0, suite_core_lib_1.dehydrateUserSettings)(merged);
+                await authenticatedApi.post('/user/settings', dehydratedSettings);
+            }
+        }
+        else {
+            setUserSettings(undefined);
+            themeSetPaletteMode('light');
+        }
+    }, [
+        isAuthenticated,
+        userSettings,
+        currentLanguage,
+        changeLanguage,
+        themeSetPaletteMode,
+        authenticatedApi,
+    ]);
+    const changeLanguageSetting = (0, react_1.useCallback)(async (languageCode) => {
+        await setUserSettingAndUpdateSettings({ siteLanguage: languageCode });
+    }, [setUserSettingAndUpdateSettings]);
+    const toggleColorMode = (0, react_1.useCallback)(async () => {
+        // When not authenticated, read from the current theme mode
+        // When authenticated, read from userSettings (synced with server)
+        const currentDarkMode = isAuthenticated
+            ? userSettings?.darkMode ?? false
+            : currentThemeMode === 'dark';
+        await setUserSettingAndUpdateSettings({ darkMode: !currentDarkMode });
+    }, [
+        isAuthenticated,
+        userSettings?.darkMode,
+        currentThemeMode,
+        setUserSettingAndUpdateSettings,
+    ]);
+    return {
+        changeLanguage: changeLanguageSetting,
+        currentLanguage,
+        userSettings,
+        setUserSettingAndUpdateSettings,
+        toggleColorMode,
+    };
+};
+exports.useUserSettings = useUserSettings;
+/**
+ * Public hook for components to manage user settings.
+ * Provides a simpler API for fetching and updating settings.
+ */
+const useUserSettingsPublic = () => {
+    const { userData, setUserSetting, userSettings } = (0, contexts_1.useAuth)();
+    const [settings, setSettings] = (0, react_1.useState)(null);
+    const [isLoading, setIsLoading] = (0, react_1.useState)(true);
+    const [error, setError] = (0, react_1.useState)(null);
+    const refreshSettings = (0, react_1.useCallback)(async () => {
+        setIsLoading(true);
+        setError(null);
+        try {
+            if (userSettings) {
+                const dehydratedSettings = (0, suite_core_lib_1.dehydrateUserSettings)(userSettings);
+                setSettings(dehydratedSettings);
+            }
+            else if (userData) {
+                const fallback = {
+                    email: userData.email || '',
+                    timezone: userData.timezone || 'UTC',
+                    siteLanguage: userData.siteLanguage || 'en-US',
+                    currency: userData.currency || 'USD',
+                    darkMode: userData.darkMode || false,
+                    directChallenge: userData.directChallenge || false,
+                    ...(userData.displayName !== undefined ? { displayName: userData.displayName } : {}),
+                };
+                setSettings(fallback);
+            }
+        }
+        catch (err) {
+            setError(err instanceof Error
+                ? err
+                : new suite_core_lib_1.TranslatableSuiteError(suite_core_lib_1.SuiteCoreStringKey.Settings_RetrieveFailure));
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [userSettings, userData]);
+    (0, react_1.useEffect)(() => {
+        refreshSettings();
+    }, [refreshSettings]);
+    const updateSettings = (0, react_1.useCallback)(async (values) => {
+        setIsLoading(true);
+        setError(null);
+        try {
+            await setUserSetting({
+                darkMode: values.darkMode,
+                currency: new i18n_lib_1.CurrencyCode(values.currency),
+                timezone: new i18n_lib_1.Timezone(values.timezone),
+                siteLanguage: values.siteLanguage,
+                email: new ecies_lib_1.EmailString(values.email),
+                directChallenge: values.directChallenge,
+                ...(values.displayName !== undefined ? { displayName: values.displayName } : {}),
+            });
+            setSettings(values);
+            return {
+                success: true,
+                message: (0, suite_core_lib_1.getSuiteCoreTranslation)(suite_core_lib_1.SuiteCoreStringKey.Settings_SaveSuccess),
+            };
+        }
+        catch (err) {
+            const axiosError = err;
+            const errorMessage = axiosError.response?.data?.message ||
+                (0, suite_core_lib_1.getSuiteCoreTranslation)(suite_core_lib_1.SuiteCoreStringKey.Settings_UpdateFailed);
+            setError(err instanceof Error ? err : new Error(errorMessage));
+            return {
+                error: errorMessage,
+                errorType: axiosError.response?.data?.errorType,
+                field: axiosError.response?.data?.field,
+                errors: axiosError.response?.data?.errors,
+            };
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [setUserSetting]);
+    return {
+        settings,
+        isLoading,
+        error,
+        updateSettings,
+        refreshSettings,
+    };
+};
+exports.useUserSettingsPublic = useUserSettingsPublic;

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

@@ -1,4 +1,3 @@
-// Export all components
 export * from './auth';
 export * from './components';
 export * from './contexts';
@@ -7,3 +6,4 @@ export * from './interfaces';
 export * from './services';
 export * from './types';
 export * from './wrappers';
+//# sourceMappingURL=index.d.ts.map

package/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/digitaldefiance-express-suite-react-components/src/index.ts"],"names":[],"mappings":"AACA,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC"}

package/src/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+// Export all components
+tslib_1.__exportStar(require("./auth"), exports);
+tslib_1.__exportStar(require("./components"), exports);
+tslib_1.__exportStar(require("./contexts"), exports);
+tslib_1.__exportStar(require("./hooks"), exports);
+tslib_1.__exportStar(require("./interfaces"), exports);
+tslib_1.__exportStar(require("./services"), exports);
+tslib_1.__exportStar(require("./types"), exports);
+tslib_1.__exportStar(require("./wrappers"), exports);

package/src/interfaces/IAppConfig.d.ts

@@ -0,0 +1,8 @@
+export interface IAppConfig {
+    hostname: string;
+    siteTitle: string;
+    server: string;
+    /** Whether TOTP two-factor authentication is available on this deployment. */
+    totpAvailable?: boolean;
+}
+//# sourceMappingURL=IAppConfig.d.ts.map

package/src/interfaces/IAppConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAppConfig.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-express-suite-react-components/src/interfaces/IAppConfig.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB"}

package/src/interfaces/IAppConfig.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });