@arex95/vue-core 1.1.29 → 1.1.31

package/dist/composables/auth/useAuth.d.ts

@@ -1,5 +1,4 @@
-import { AuthParams, AuthResponse, AuthTokenPaths } from "@/types";
-import { SessionPreference } from "@config/global/sessionConfig";
+import { AuthParams, AuthResponse, AuthTokenPaths, LocationPreference } from "@/types";
 /**
  * @typedef {object} AuthHook
  * @property {function(): Promise<number | null>} getTokenExpiry - Retrieves the expiration time of the current token in milliseconds.
@@ -9,7 +8,7 @@ import { SessionPreference } from "@config/global/sessionConfig";
  * @property {(tokenPaths?: AuthTokenPaths) => Promise<AuthResponse>} refresh - Refreshes authentication tokens.
  * @property {function(): Promise<boolean>} verifyAuth - Verifies the validity and expiration of the current authentication token.
  * @property {(preference: SessionPreference) => void} setSessionPersistencePreference - Sets the user's preferred storage for authentication data.
- * @property {function(): SessionPreference} getSessionPersistencePreference - Retrieves the user's current preferred storage for authentication data.
+ * @property {function(): SessionPreference} getSessionPersistence - Retrieves the user's current preferred storage for authentication data.
  */
 /**
  * Custom hook for authentication logic, including login, logout, token management, and session preference.
@@ -19,6 +18,6 @@ import { SessionPreference } from "@config/global/sessionConfig";
  */
 export declare function useAuth(secretKey?: string): {
     logout: (params?: AuthParams) => Promise<void>;
-    login: (params: AuthParams, persistence: SessionPreference, tokenPaths?: AuthTokenPaths) => Promise<AuthResponse>;
+    login: (params: AuthParams, persistence: LocationPreference, tokenPaths?: AuthTokenPaths) => Promise<AuthResponse>;
     refresh: (tokenPaths?: AuthTokenPaths) => Promise<AuthResponse>;
 };

package/dist/config/global/sessionConfig.d.ts

@@ -1,49 +1,34 @@
-export type SessionPreference = "local" | "session";
+import { LocationPreference, SessionConfigObject, SessionConfig } from "@/types/SessionConfig";
 /**
- * Configuration object for the session.
- */
-interface SessionConfigObject {
-    /** The unique session identifier. */
-    sessionId?: string;
-    /** The storage preference: 'local' for localStorage, 'session' for sessionStorage. */
-    persistencePreference?: SessionPreference;
-}
-/**
- * Loads the session configuration from storage (local or session).
- * This should be called once when the application initializes.
- */
-export declare function loadSessionConfigFromStorage(): Promise<void>;
-/**
- * Configures the session identifier and/or the data persistence preference for the active browser session.
- * Once configured, the session ID cannot be modified. The persistence preference can be updated.
+ * Configures the session identifier and/or data persistence preference
+ * for the active browser session.
  *
- * @param {SessionConfigObject} config - An object containing the unique session identifier and/or persistence preference.
+ * This function is asynchronous because it will always attempt to load the current configuration
+ * before applying changes and then saving them.
  *
- * @returns {void} Does not return anything, but freezes the session configuration (for ID) and updates preference.
+ * @param {SessionConfigObject} config - An object containing the unique session identifier and/or
+ * the persistence preference.
+ * @returns {Promise<void>} A promise that resolves when the session has been configured and saved.
  */
-export declare function configSession(config: SessionConfigObject): void;
+export declare function configSession(config: SessionConfigObject): Promise<void>;
 /**
- * Retrieves the current session identifier configuration.
+ * Retrieves the current session identifier.
+ * Always attempts to load the configuration from storage. If it fails, it uses the internal state.
  *
- * @returns {string} The unique session identifier.
+ * @returns {Promise<string>} A promise that resolves with the unique session identifier.
  */
-export declare function getSessionConfig(): string;
+export declare function getSessionId(): Promise<string>;
 /**
  * Retrieves the current data persistence preference.
+ * Always attempts to load the configuration from storage. If it fails, it uses the internal state.
  *
- * @returns {SessionPreference} The configured persistence preference ('local' or 'session').
+ * @returns {Promise<SessionPreference>} A promise that resolves with the configured persistence preference ('local' or 'session').
  */
-export declare function getSessionPersistencePreference(): SessionPreference;
+export declare function getSessionPersistence(): Promise<LocationPreference>;
 /**
- * Generates a new UUID for the current session.
- *
- * @returns {void} Does not return anything, but updates the session identifier.
- */
-export declare function regenerateSessionId(): void;
-/**
- * Retrieves the current session identifier.
+ * Retrieves the complete session configuration.
+ * Always attempts to load the configuration from storage. If it fails, it uses the internal state.
  *
- * @returns {string} The unique session identifier.
+ * @returns {Promise<SessionConfig>} A promise that resolves with the session configuration object.
  */
-export declare function getSessionId(): string;
-export {};
+export declare function getSessionConfig(): Promise<SessionConfig>;

package/dist/index.mjs

@@ -866,14 +866,14 @@ async function decrypt(encryptedValue, secretKey) {
  * @param key The key under which to store the value.
  * @param value The value to encrypt and store.
  * @param secretKey The secret key for encryption.
- * @param persistent If true, uses localStorage; otherwise, uses sessionStorage.
+ * @param location Determines where the item is stored: 'local' for localStorage, 'session' for sessionStorage.
  * @returns A promise that resolves when the item is stored. Throws an error if it fails.
  */
-async function storeEncryptedItem(key, value, secretKey, persistent) {
+async function storeEncryptedItem(key, value, secretKey, location) {
     if (typeof window === "undefined") {
         throw new Error("Cannot access storage: window is not defined.");
     }
-    const storage = persistent ? window.localStorage : window.sessionStorage;
+    const storage = location === "local" ? window.localStorage : window.sessionStorage;
     const encryptedValue = await encrypt(value, secretKey);
     storage.setItem(key, encryptedValue);
 }
@@ -882,15 +882,20 @@ async function storeEncryptedItem(key, value, secretKey, persistent) {
  * Assumes the `window` environment is available.
  * @param key The key of the item to retrieve.
  * @param secretKey The secret key for decryption.
- * @param persistent If true, searches localStorage; otherwise, sessionStorage.
+ * @param location Specifies where to search for the item: 'local' for localStorage, 'session' for sessionStorage, or 'any' to check both (session first).
  * @returns A promise that resolves with the decrypted value or null if not found or decryption fails.
  */
-async function getDecryptedItem(key, secretKey, persistent) {
+async function getDecryptedItem(key, secretKey, location) {
     if (typeof window === "undefined") {
         return null;
     }
-    const storage = persistent ? window.localStorage : window.sessionStorage;
-    const encryptedData = storage.getItem(key);
+    let encryptedData = null;
+    if (location === "session" || location === "any") {
+        encryptedData = window.sessionStorage.getItem(key);
+    }
+    if (!encryptedData && (location === "local" || location === "any")) {
+        encryptedData = window.localStorage.getItem(key);
+    }
     if (!encryptedData) {
         return null;
     }
@@ -933,106 +938,110 @@ function getAppKey() {
     return appKey;
 }
 
-let sessionId = v4();
-let sessionConfig = Object.freeze({
-    SESSION_ID: sessionId,
+const SESSION_KEY = "session_config_";
+const internalSessionState = {
+    sessionId: v4(),
+    persistencePreference: "session",
+};
+let _sessionConfig = Object.freeze({
+    SESSION_ID: internalSessionState.sessionId,
+    PERSISTENCE: internalSessionState.persistencePreference,
 });
-let persistencePreference = "session";
 /**
- * Loads the session configuration from storage (local or session).
- * This should be called once when the application initializes.
+ * Updates the immutable `_sessionConfig` object with the current state of `internalSessionState`
+ * and freezes it.
  */
-async function loadSessionConfigFromStorage() {
-    const isPersistent = persistencePreference === "local";
-    const storedConfig = await getDecryptedItem("sessionConfig", getAppKey(), isPersistent);
-    if (storedConfig) {
-        try {
-            const parsedConfig = JSON.parse(storedConfig);
-            sessionConfig = Object.freeze({
-                ...sessionConfig,
-                ...parsedConfig,
-            });
-            if (parsedConfig.SESSION_ID) {
-                sessionId = parsedConfig.SESSION_ID;
-            }
-        }
-        catch (error) {
-            console.error("Error parsing stored session config:", error);
-            regenerateSessionId();
-        }
-    }
-    else {
-        regenerateSessionId();
-    }
-    await saveSessionConfigToStorage();
+function updateSessionConfig() {
+    _sessionConfig = Object.freeze({
+        SESSION_ID: internalSessionState.sessionId,
+        PERSISTENCE: internalSessionState.persistencePreference,
+    });
 }
 /**
  * Saves the current session configuration to local or session storage.
+ * @returns {Promise<void>} A promise that resolves when the session configuration has been saved.
  */
-async function saveSessionConfigToStorage() {
-    const isPersistent = persistencePreference === "local";
+async function saveSessionConfig() {
+    const location = internalSessionState.persistencePreference;
     try {
-        await storeEncryptedItem("sessionConfig", JSON.stringify(sessionConfig), getAppKey(), isPersistent);
+        await storeEncryptedItem(SESSION_KEY, JSON.stringify(_sessionConfig), getAppKey(), location);
     }
     catch (error) {
-        console.error("Error saving session config to storage:", error);
+        console.error("Error saving session configuration to storage:", error);
     }
 }
 /**
- * Configures the session identifier and/or the data persistence preference for the active browser session.
- * Once configured, the session ID cannot be modified. The persistence preference can be updated.
- *
- * @param {SessionConfigObject} config - An object containing the unique session identifier and/or persistence preference.
+ * Attempts to load the configuration from storage.
+ * If it fails or is not found, `internalSessionState` will retain its current values (initial or last configured).
+ * Then, it updates `_sessionConfig`.
  *
- * @returns {void} Does not return anything, but freezes the session configuration (for ID) and updates preference.
- */
-function configSession(config) {
-    let updatedConfig = { ...sessionConfig };
-    if (config.sessionId && sessionConfig.SESSION_ID === sessionId) {
-        updatedConfig = {
-            ...updatedConfig,
-            SESSION_ID: config.sessionId,
-        };
-        sessionId = config.sessionId;
+ * @returns {Promise<void>} A promise that resolves when the state has been loaded and updated.
+ */
+async function loadSessionConfig() {
+    const location = internalSessionState.persistencePreference;
+    try {
+        const storedConfig = await getDecryptedItem(SESSION_KEY, getAppKey(), location);
+        if (storedConfig) {
+            const parsedConfig = JSON.parse(storedConfig);
+            internalSessionState.sessionId = parsedConfig.SESSION_ID;
+            internalSessionState.persistencePreference = parsedConfig.PERSISTENCE;
+            updateSessionConfig();
+        }
     }
-    if (config.persistencePreference) {
-        persistencePreference = config.persistencePreference;
+    catch (error) {
+        console.warn(`Error loading or parsing from storage`, error);
     }
-    sessionConfig = Object.freeze(updatedConfig);
-    saveSessionConfigToStorage();
 }
 /**
- * Retrieves the current session identifier configuration.
+ * Configures the session identifier and/or data persistence preference
+ * for the active browser session.
+ *
+ * This function is asynchronous because it will always attempt to load the current configuration
+ * before applying changes and then saving them.
  *
- * @returns {string} The unique session identifier.
+ * @param {SessionConfigObject} config - An object containing the unique session identifier and/or
+ * the persistence preference.
+ * @returns {Promise<void>} A promise that resolves when the session has been configured and saved.
  */
-function getSessionConfig() {
-    return sessionConfig.SESSION_ID;
+async function configSession(config) {
+    if (config.sessionId) {
+        internalSessionState.sessionId = config.sessionId;
+    }
+    if (config.persistencePreference) {
+        internalSessionState.persistencePreference = config.persistencePreference;
+    }
+    updateSessionConfig();
+    await saveSessionConfig();
 }
 /**
- * Retrieves the current data persistence preference.
+ * Retrieves the current session identifier.
+ * Always attempts to load the configuration from storage. If it fails, it uses the internal state.
  *
- * @returns {SessionPreference} The configured persistence preference ('local' or 'session').
+ * @returns {Promise<string>} A promise that resolves with the unique session identifier.
  */
-function getSessionPersistencePreference() {
-    return persistencePreference;
+async function getSessionId() {
+    await loadSessionConfig();
+    return _sessionConfig.SESSION_ID;
 }
 /**
- * Generates a new UUID for the current session.
+ * Retrieves the current data persistence preference.
+ * Always attempts to load the configuration from storage. If it fails, it uses the internal state.
  *
- * @returns {void} Does not return anything, but updates the session identifier.
+ * @returns {Promise<SessionPreference>} A promise that resolves with the configured persistence preference ('local' or 'session').
  */
-function regenerateSessionId() {
-    sessionId = v4();
-    configSession({ sessionId: sessionId });
+async function getSessionPersistence() {
+    await loadSessionConfig();
+    return _sessionConfig.PERSISTENCE;
 }
 /**
- * Retrieves the current session identifier.
+ * Retrieves the complete session configuration.
+ * Always attempts to load the configuration from storage. If it fails, it uses the internal state.
  *
- * @returns {string} The unique session identifier.
+ * @returns {Promise<SessionConfig>} A promise that resolves with the session configuration object.
  */
-function getSessionId() {
-    return sessionId;
+async function getSessionConfig() {
+    await loadSessionConfig();
+    return _sessionConfig;
 }
 
 /**
@@ -2699,16 +2708,21 @@ function isValidHexNumber(hex) {
 
 /**
  * Clears all stored authentication data (access and refresh tokens)
- * from either sessionStorage or localStorage based on the provided preference.
+ * from either sessionStorage, localStorage, or both based on the provided location preference.
  *
- * @param {SessionPreference} preference - The storage preference ('local' for localStorage, 'session' for sessionStorage).
+ * @param {LocationPreference} location - The storage preference ('local' for localStorage, 'session' for sessionStorage, 'any' for both).
  * @returns {Promise<void>} A promise that resolves when all relevant storage items are removed.
  */
-const cleanCredentials = async (preference) => {
+const cleanCredentials = async (location) => {
     const tokensConfig = getTokenConfig();
     Object.keys(tokensConfig).forEach((key) => {
-        const storage = preference === "local" ? localStorage : sessionStorage;
-        storage.removeItem(tokensConfig[key]);
+        const itemKey = tokensConfig[key];
+        if (location === "local" || location === "any") {
+            localStorage.removeItem(itemKey);
+        }
+        if (location === "session" || location === "any") {
+            sessionStorage.removeItem(itemKey);
+        }
     });
 };
 /**
@@ -2719,9 +2733,9 @@ const cleanCredentials = async (preference) => {
  * @param {SessionPreference} preference - The storage preference ('local' for localStorage, 'session' for sessionStorage).
  * @returns {Promise<string | null>} A promise that resolves with the decrypted access token, or null if not found.
  */
-const getAuthToken = async (secretKey, preference) => {
+const getAuthToken = async (secretKey, location) => {
     const tokensConfig = getTokenConfig();
-    return await getDecryptedItem(tokensConfig.ACCESS_TOKEN, secretKey, preference === "local");
+    return await getDecryptedItem(tokensConfig.ACCESS_TOKEN, secretKey, location);
 };
 /**
  * Retrieves the authentication refresh token from storage, decrypting it
@@ -2731,9 +2745,9 @@ const getAuthToken = async (secretKey, preference) => {
  * @param {SessionPreference} preference - The storage preference ('local' for localStorage, 'session' for sessionStorage).
  * @returns {Promise<string | null>} A promise that resolves with the decrypted refresh token, or null if not found.
  */
-const getAuthRefreshToken = async (secretKey, preference) => {
+const getAuthRefreshToken = async (secretKey, location) => {
     const tokensConfig = getTokenConfig();
-    return await getDecryptedItem(tokensConfig.REFRESH_TOKEN, secretKey, preference === "local");
+    return await getDecryptedItem(tokensConfig.REFRESH_TOKEN, secretKey, location);
 };
 /**
  * Stores the authentication token (access token) in storage after encrypting it,
@@ -2744,9 +2758,9 @@ const getAuthRefreshToken = async (secretKey, preference) => {
  * @param {SessionPreference} preference - The storage preference ('local' for localStorage, 'session' for sessionStorage).
  * @returns {Promise<void>} A promise that resolves when the token is successfully stored.
  */
-const storeAuthToken = async (token, secretKey, preference) => {
+const storeAuthToken = async (token, secretKey, location) => {
     const tokensConfig = getTokenConfig();
-    await storeEncryptedItem(tokensConfig.ACCESS_TOKEN, token, secretKey, preference === "local");
+    await storeEncryptedItem(tokensConfig.ACCESS_TOKEN, token, secretKey, location);
 };
 /**
  * Stores the authentication refresh token in storage after encrypting it,
@@ -2757,52 +2771,50 @@ const storeAuthToken = async (token, secretKey, preference) => {
  * @param {SessionPreference} preference - The storage preference ('local' for localStorage, 'session' for sessionStorage).
  * @returns {Promise<void>} A promise that resolves when the token is successfully stored.
  */
-const storeAuthRefreshToken = async (token, secretKey, preference) => {
+const storeAuthRefreshToken = async (token, secretKey, location) => {
     const tokensConfig = getTokenConfig();
-    await storeEncryptedItem(tokensConfig.REFRESH_TOKEN, token, secretKey, preference === "local");
+    await storeEncryptedItem(tokensConfig.REFRESH_TOKEN, token, secretKey, location);
 };
 /**
  * Verifies the validity and expiration of the current authentication token.
  * If the token is missing, invalid, or expired, appropriate errors are thrown and credentials are cleaned.
  *
- * @param {string} secretKey - The secret key used for token decryption.
- * @param {SessionPreference} preference - The current session persistence preference.
  * @returns {Promise<boolean>} True if the token is valid and unexpired.
  * @throws {Error} "TOKEN_MISSING" if no token is found, "TOKEN_EXPIRED" if the token has expired,
  * "TOKEN_INVALID" if the token format is invalid.
  */
 const verifyAuth = async () => {
-    const preference = getSessionPersistencePreference();
+    const sessionPersistence = 'any';
+    const handleAuthError = async (message, shouldClean = true) => {
+        handleError(message, false);
+        if (shouldClean) {
+            await cleanCredentials(sessionPersistence);
+        }
+        return false;
+    };
     try {
-        const token = await getAuthToken(getAppKey(), preference);
+        const token = await getAuthToken(getAppKey(), sessionPersistence);
         if (!token) {
-            handleError("TOKEN_MISSING: No valid token found", false);
-            await cleanCredentials(preference);
-            return false;
+            return await handleAuthError("TOKEN_MISSING: No valid token found");
+        }
+        let decoded;
+        try {
+            decoded = jwtDecode(token);
+        }
+        catch (decodeError) {
+            return await handleAuthError("TOKEN_INVALID: Invalid token format");
         }
-        const decoded = jwtDecode(token);
         const currentTime = Date.now() / 1000;
         if (typeof decoded.exp !== "number") {
-            handleError("TOKEN_INVALID: Invalid expiration format", false);
-            await cleanCredentials(preference);
-            return false;
+            return await handleAuthError("TOKEN_INVALID: Invalid expiration format");
         }
         if (decoded.exp <= currentTime) {
-            handleError("TOKEN_EXPIRED: Token is expired", false);
-            await cleanCredentials(preference);
-            return false;
+            return await handleAuthError("TOKEN_EXPIRED: Token is expired");
         }
         return true;
     }
     catch (error) {
-        if (error instanceof Error && error.message.includes("Invalid")) {
-            handleError("TOKEN_INVALID: Invalid token format", false);
-            await cleanCredentials(preference);
-            return false;
-        }
-        handleError("AUTH_ERROR: An unexpected error occurred", false);
-        await cleanCredentials(preference);
-        return false;
+        return await handleAuthError("AUTH_ERROR: An unexpected error occurred", true);
     }
 };
 
@@ -3366,7 +3378,7 @@ function useSorter(items, criteriaList, selectedCriteria) {
  * @property {(tokenPaths?: AuthTokenPaths) => Promise<AuthResponse>} refresh - Refreshes authentication tokens.
  * @property {function(): Promise<boolean>} verifyAuth - Verifies the validity and expiration of the current authentication token.
  * @property {(preference: SessionPreference) => void} setSessionPersistencePreference - Sets the user's preferred storage for authentication data.
- * @property {function(): SessionPreference} getSessionPersistencePreference - Retrieves the user's current preferred storage for authentication data.
+ * @property {function(): SessionPreference} getSessionPersistence - Retrieves the user's current preferred storage for authentication data.
  */
 /**
  * Custom hook for authentication logic, including login, logout, token management, and session preference.
@@ -3377,7 +3389,6 @@ function useSorter(items, criteriaList, selectedCriteria) {
 function useAuth(secretKey = getAppKey()) {
     const axiosInstance = getAxiosInstance();
     const endpoints = getEndpointsConfig();
-    const currentPersistencePreference = getSessionPersistencePreference();
     /**
      * Logs out the user by making a POST request to the logout endpoint,
      * cleaning all stored credentials, and reloading the page.
@@ -3394,7 +3405,7 @@ function useAuth(secretKey = getAppKey()) {
             handleError(error, false);
         }
         finally {
-            await cleanCredentials(currentPersistencePreference);
+            await cleanCredentials(await getSessionPersistence());
             window.location.reload();
         }
     };
@@ -3450,7 +3461,7 @@ function useAuth(secretKey = getAppKey()) {
      */
     const refresh = async (tokenPaths) => {
         try {
-            const refreshTokenFromStorage = await getAuthRefreshToken(secretKey, currentPersistencePreference);
+            const refreshTokenFromStorage = await getAuthRefreshToken(secretKey, await getSessionPersistence());
             if (!refreshTokenFromStorage) {
                 throw new Error("TOKEN_MISSING: No refresh token found in storage.");
             }
@@ -3472,8 +3483,8 @@ function useAuth(secretKey = getAppKey()) {
                 typeof refreshTokenAfterRefresh !== "string") {
                 throw new Error(`REFRESH_ERROR: Refresh token not found or invalid at path '${refreshTokenPath}' in refresh response.`);
             }
-            await storeAuthToken(accessTokenAfterRefresh, secretKey, currentPersistencePreference);
-            await storeAuthRefreshToken(refreshTokenAfterRefresh, secretKey, currentPersistencePreference);
+            await storeAuthToken(accessTokenAfterRefresh, secretKey, await getSessionPersistence());
+            await storeAuthRefreshToken(refreshTokenAfterRefresh, secretKey, await getSessionPersistence());
             return data;
         }
         catch (error) {
@@ -3524,4 +3535,4 @@ const ArexVueCore = {
     },
 };
 
-export { AppTypes, ArchiveTypes, ArexVueCore, AudioTypes, AxiosService, ContentTypeEnum, DocumentTypes, ERROR_MESSAGES, ERROR_STYLES, ErrorEnum, ErrorMessages, ErrorStyles, ExceptionEnum, FontTypes, ImageTypes, KeyCodeEnum, OtherTypes, RestStd, ScreenBreakpoint, ScreenSize, StorageKeyEnum, StorageTypeEnum, TextTypes, VideoTypes, ab2hex, addCustomKeyboardShortcut, addDays, addDoubleClickListener, addKeyListener, ageAtDate, axiosFetch, blobToFormData, bufferToBlob, calculateAge, cleanCredentials, clickOutside, compareObject, configAppKey, configAxios, configEndpoints, configSession, configTokenKeys, copyToClipboard, countWords, createCustomAxiosInstance, createFetch, createKeyMap, customShortcut, daysBetween, daysToNextBirthday, debounce, debounceAsync, debounceAsyncValidator, debounceAsyncWithImmediate, debounceLeading, debounceLeadingTrailing, debounceTrailing, decrypt, deepClone, deepEqual, deepMerge, detectKeyHold, disableCopy, disableF12Key, disableMouseButtons, disableRightClick, disableSpecificKeys, downloadBlob, enableMouseButtons, enableRightClick, enableSpecificKeys, encrypt, exportToCSV, exportToExcel, exportToJSON, exportToText, exportToXML, filterObjectByKeys, flattenObject, formDataToObject, formatDate, generateRandomString, getAppKey, getAuthRefreshToken, getAuthToken, getAxiosInstance, getDecryptedItem, getEndOfMonth, getEndpointsConfig, getObjectDifferences, getObjectKeys, getQueryParam, getSessionConfig, getSessionId, getSessionPersistencePreference, getStartOfMonth, getTokenConfig, handleError, hasNestedProperties, hex2ab, importKey, isEmptyObject, isLeapYear, isStrongPassword, isValidAge, isValidCreditCard, isValidDate, isValidEmail, isValidExpiryDate, isValidHexColor, isValidHexColorAlpha, isValidHexNumber, isValidIP, isValidPhoneNumber, isValidSSN, isValidTime, isValidURL, isValidUsername, isValidZIP, loadSessionConfigFromStorage, lowerFirst, objectToFormData, objectToFormDataEnhanced, objectToQueryString, openWindow, parseDate, proxyToPlainObject, readFileAsDataURL, readFileAsText, regenerateSessionId, registerKeyboardShortcuts, removeAccent, removeClickOutside, removeCustomKeyboardShortcut, removeCustomShortcuts, removeDoubleClickListener, removeEmptyProperties, removeKeyListeners, replaceAll, reverseString, safeGet, screenMap, scrollToTop, simulateKeyPress, stopDetectingKeyHold, storeAuthRefreshToken, storeAuthToken, storeEncryptedItem, stringToBlob, subtractDays, throttle, toCamelCase, toKebabCase, toggleTabNavigation, truncateString, unregisterKeyboardShortcuts, upperFirst, useAuth, useBreakpoint, useFilter, usePagination, useSorter, useVueQuery, validateAlphanumeric, validateLetters, validateNumbers, verifyAuth };
+export { AppTypes, ArchiveTypes, ArexVueCore, AudioTypes, AxiosService, ContentTypeEnum, DocumentTypes, ERROR_MESSAGES, ERROR_STYLES, ErrorEnum, ErrorMessages, ErrorStyles, ExceptionEnum, FontTypes, ImageTypes, KeyCodeEnum, OtherTypes, RestStd, ScreenBreakpoint, ScreenSize, StorageKeyEnum, StorageTypeEnum, TextTypes, VideoTypes, ab2hex, addCustomKeyboardShortcut, addDays, addDoubleClickListener, addKeyListener, ageAtDate, axiosFetch, blobToFormData, bufferToBlob, calculateAge, cleanCredentials, clickOutside, compareObject, configAppKey, configAxios, configEndpoints, configSession, configTokenKeys, copyToClipboard, countWords, createCustomAxiosInstance, createFetch, createKeyMap, customShortcut, daysBetween, daysToNextBirthday, debounce, debounceAsync, debounceAsyncValidator, debounceAsyncWithImmediate, debounceLeading, debounceLeadingTrailing, debounceTrailing, decrypt, deepClone, deepEqual, deepMerge, detectKeyHold, disableCopy, disableF12Key, disableMouseButtons, disableRightClick, disableSpecificKeys, downloadBlob, enableMouseButtons, enableRightClick, enableSpecificKeys, encrypt, exportToCSV, exportToExcel, exportToJSON, exportToText, exportToXML, filterObjectByKeys, flattenObject, formDataToObject, formatDate, generateRandomString, getAppKey, getAuthRefreshToken, getAuthToken, getAxiosInstance, getDecryptedItem, getEndOfMonth, getEndpointsConfig, getObjectDifferences, getObjectKeys, getQueryParam, getSessionConfig, getSessionId, getSessionPersistence, getStartOfMonth, getTokenConfig, handleError, hasNestedProperties, hex2ab, importKey, isEmptyObject, isLeapYear, isStrongPassword, isValidAge, isValidCreditCard, isValidDate, isValidEmail, isValidExpiryDate, isValidHexColor, isValidHexColorAlpha, isValidHexNumber, isValidIP, isValidPhoneNumber, isValidSSN, isValidTime, isValidURL, isValidUsername, isValidZIP, lowerFirst, objectToFormData, objectToFormDataEnhanced, objectToQueryString, openWindow, parseDate, proxyToPlainObject, readFileAsDataURL, readFileAsText, registerKeyboardShortcuts, removeAccent, removeClickOutside, removeCustomKeyboardShortcut, removeCustomShortcuts, removeDoubleClickListener, removeEmptyProperties, removeKeyListeners, replaceAll, reverseString, safeGet, screenMap, scrollToTop, simulateKeyPress, stopDetectingKeyHold, storeAuthRefreshToken, storeAuthToken, storeEncryptedItem, stringToBlob, subtractDays, throttle, toCamelCase, toKebabCase, toggleTabNavigation, truncateString, unregisterKeyboardShortcuts, upperFirst, useAuth, useBreakpoint, useFilter, usePagination, useSorter, useVueQuery, validateAlphanumeric, validateLetters, validateNumbers, verifyAuth };

package/dist/types/SessionConfig.d.ts

@@ -1,3 +1,13 @@
+export type LocationPreference = "local" | "session" | "any";
 export type SessionConfig = {
     SESSION_ID: string;
+    PERSISTENCE: LocationPreference;
 };
+export interface InternalSessionState {
+    sessionId: string;
+    persistencePreference: LocationPreference;
+}
+export interface SessionConfigObject {
+    sessionId?: string;
+    persistencePreference?: LocationPreference;
+}

package/dist/utils/credentials.d.ts

@@ -1,12 +1,12 @@
-import { SessionPreference } from "@config/global/sessionConfig";
+import { LocationPreference } from "@/types/SessionConfig";
 /**
  * Clears all stored authentication data (access and refresh tokens)
- * from either sessionStorage or localStorage based on the provided preference.
+ * from either sessionStorage, localStorage, or both based on the provided location preference.
  *
- * @param {SessionPreference} preference - The storage preference ('local' for localStorage, 'session' for sessionStorage).
+ * @param {LocationPreference} location - The storage preference ('local' for localStorage, 'session' for sessionStorage, 'any' for both).
  * @returns {Promise<void>} A promise that resolves when all relevant storage items are removed.
  */
-export declare const cleanCredentials: (preference: SessionPreference) => Promise<void>;
+export declare const cleanCredentials: (location: LocationPreference) => Promise<void>;
 /**
  * Retrieves the authentication token (access token) from storage, decrypting it
  * using the provided secret key and based on the specified session preference.
@@ -15,7 +15,7 @@ export declare const cleanCredentials: (preference: SessionPreference) => Promis
  * @param {SessionPreference} preference - The storage preference ('local' for localStorage, 'session' for sessionStorage).
  * @returns {Promise<string | null>} A promise that resolves with the decrypted access token, or null if not found.
  */
-export declare const getAuthToken: (secretKey: string, preference: SessionPreference) => Promise<string | null>;
+export declare const getAuthToken: (secretKey: string, location: LocationPreference) => Promise<string | null>;
 /**
  * Retrieves the authentication refresh token from storage, decrypting it
  * using the provided secret key and based on the specified session preference.
@@ -24,7 +24,7 @@ export declare const getAuthToken: (secretKey: string, preference: SessionPrefer
  * @param {SessionPreference} preference - The storage preference ('local' for localStorage, 'session' for sessionStorage).
  * @returns {Promise<string | null>} A promise that resolves with the decrypted refresh token, or null if not found.
  */
-export declare const getAuthRefreshToken: (secretKey: string, preference: SessionPreference) => Promise<string | null>;
+export declare const getAuthRefreshToken: (secretKey: string, location: LocationPreference) => Promise<string | null>;
 /**
  * Stores the authentication token (access token) in storage after encrypting it,
  * based on the specified session preference.
@@ -34,7 +34,7 @@ export declare const getAuthRefreshToken: (secretKey: string, preference: Sessio
  * @param {SessionPreference} preference - The storage preference ('local' for localStorage, 'session' for sessionStorage).
  * @returns {Promise<void>} A promise that resolves when the token is successfully stored.
  */
-export declare const storeAuthToken: (token: string, secretKey: string, preference: SessionPreference) => Promise<void>;
+export declare const storeAuthToken: (token: string, secretKey: string, location: LocationPreference) => Promise<void>;
 /**
  * Stores the authentication refresh token in storage after encrypting it,
  * based on the specified session preference.
@@ -44,13 +44,11 @@ export declare const storeAuthToken: (token: string, secretKey: string, preferen
  * @param {SessionPreference} preference - The storage preference ('local' for localStorage, 'session' for sessionStorage).
  * @returns {Promise<void>} A promise that resolves when the token is successfully stored.
  */
-export declare const storeAuthRefreshToken: (token: string, secretKey: string, preference: SessionPreference) => Promise<void>;
+export declare const storeAuthRefreshToken: (token: string, secretKey: string, location: LocationPreference) => Promise<void>;
 /**
  * Verifies the validity and expiration of the current authentication token.
  * If the token is missing, invalid, or expired, appropriate errors are thrown and credentials are cleaned.
  *
- * @param {string} secretKey - The secret key used for token decryption.
- * @param {SessionPreference} preference - The current session persistence preference.
  * @returns {Promise<boolean>} True if the token is valid and unexpired.
  * @throws {Error} "TOKEN_MISSING" if no token is found, "TOKEN_EXPIRED" if the token has expired,
  * "TOKEN_INVALID" if the token format is invalid.

package/dist/utils/storage.d.ts

@@ -1,19 +1,20 @@
+import { LocationPreference } from "@/types";
 /**
  * Encrypts and stores an item in local or session storage.
  * Assumes the `window` environment is available.
  * @param key The key under which to store the value.
  * @param value The value to encrypt and store.
  * @param secretKey The secret key for encryption.
- * @param persistent If true, uses localStorage; otherwise, uses sessionStorage.
+ * @param location Determines where the item is stored: 'local' for localStorage, 'session' for sessionStorage.
  * @returns A promise that resolves when the item is stored. Throws an error if it fails.
  */
-export declare function storeEncryptedItem(key: string, value: string, secretKey: string, persistent: boolean): Promise<void>;
+export declare function storeEncryptedItem(key: string, value: string, secretKey: string, location: LocationPreference): Promise<void>;
 /**
  * Retrieves and decrypts a value from local or session storage.
  * Assumes the `window` environment is available.
  * @param key The key of the item to retrieve.
  * @param secretKey The secret key for decryption.
- * @param persistent If true, searches localStorage; otherwise, sessionStorage.
+ * @param location Specifies where to search for the item: 'local' for localStorage, 'session' for sessionStorage, or 'any' to check both (session first).
  * @returns A promise that resolves with the decrypted value or null if not found or decryption fails.
  */
-export declare function getDecryptedItem(key: string, secretKey: string, persistent: boolean): Promise<string | null>;
+export declare function getDecryptedItem(key: string, secretKey: string, location: LocationPreference): Promise<string | null>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arex95/vue-core",
-  "version": "1.1.29",
+  "version": "1.1.31",
   "description": "Opinionated Vue Core",
   "main": "dist/index.js",
   "module": "dist/index.mjs",