@arex95/vue-core 3.1.0 → 3.3.0

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

@@ -0,0 +1,14 @@
+export interface CallbacksConfig {
+    onRefreshFailed?: () => void;
+    onLogout?: () => void;
+}
+/**
+ * Configures the lifecycle callbacks for auth events.
+ * @param {CallbacksConfig} config - Callbacks to invoke on refresh failure or logout.
+ */
+export declare const configCallbacks: (config: CallbacksConfig) => void;
+/**
+ * Returns the configured lifecycle callbacks.
+ * @returns {CallbacksConfig}
+ */
+export declare const getCallbacksConfig: () => CallbacksConfig;

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

@@ -3,3 +3,4 @@ export * from './endpointsConfig';
 export * from './sessionConfig';
 export * from './keyConfig';
 export * from './tokenPathsConfig';
+export * from './callbacksConfig';

package/dist/index.mjs

@@ -1246,6 +1246,20 @@ function getRefreshTokenPathsConfig() {
     return refreshTokenPathsConfig;
 }
 
+let callbacksConfig = {};
+/**
+ * Configures the lifecycle callbacks for auth events.
+ * @param {CallbacksConfig} config - Callbacks to invoke on refresh failure or logout.
+ */
+const configCallbacks = (config) => {
+    callbacksConfig = { ...config };
+};
+/**
+ * Returns the configured lifecycle callbacks.
+ * @returns {CallbacksConfig}
+ */
+const getCallbacksConfig = () => callbacksConfig;
+
 /**
  * Removes all stored authentication credentials (access and refresh tokens) from the specified storage locations.
  *
@@ -1340,7 +1354,7 @@ const verifyAuth = async () => {
     };
     const token = await getAuthToken(getAppKey(), sessionPersistence);
     if (!token) {
-        return handleAuthError("TOKEN_MISSING: No valid token found");
+        return handleAuthError("TOKEN_MISSING: No valid token found", false);
     }
     try {
         const decoded = jwtDecode(token);
@@ -1349,7 +1363,7 @@ const verifyAuth = async () => {
             return handleAuthError("TOKEN_INVALID: Invalid expiration format");
         }
         if (decoded.exp <= currentTime) {
-            return handleAuthError("TOKEN_EXPIRED: Token is expired");
+            return handleAuthError("TOKEN_EXPIRED: Token is expired", false);
         }
         return true;
     }
@@ -1775,7 +1789,11 @@ const refreshTokens = async (fetcher) => {
     catch (error) {
         handleError(error);
         await cleanCredentials(persistence);
-        if (typeof window !== 'undefined') {
+        const { onRefreshFailed } = getCallbacksConfig();
+        if (onRefreshFailed) {
+            onRefreshFailed();
+        }
+        else if (typeof window !== 'undefined') {
             window.location.reload();
         }
         throw error;
@@ -1853,7 +1871,9 @@ class AxiosService {
             },
             withCredentials: options.withCredentials ?? false,
         });
-        this.initializeInterceptors();
+        if (options.setupAuthInterceptors !== false) {
+            this.initializeInterceptors();
+        }
     }
     processQueue(error, token = null) {
         this.failedQueue.forEach((prom) => {
@@ -1889,6 +1909,9 @@ class AxiosService {
             return response;
         }, async (error) => {
             this.activeRequests--;
+            if (typeof window === 'undefined') {
+                return Promise.reject(error);
+            }
             const originalRequest = error.config;
             const isAuthError = axios.isAxiosError(error) && error.response?.status === 401;
             const isRefreshCall = originalRequest?.url === this.refreshTokenUrl;
@@ -4279,7 +4302,11 @@ function useAuth(fetcher) {
         }
         finally {
             await cleanCredentials(await getSessionPersistence());
-            if (typeof window !== 'undefined') {
+            const { onLogout } = getCallbacksConfig();
+            if (onLogout) {
+                onLogout();
+            }
+            else if (typeof window !== 'undefined') {
                 window.location.reload();
             }
         }
@@ -4406,9 +4433,14 @@ const ArexVueCore = {
             baseURL: options.axios.baseURL,
             headers: options.axios.headers,
             timeout: options.axios.timeout,
-            withCredentials: options.axios.withCredentials
+            withCredentials: options.axios.withCredentials,
+            setupAuthInterceptors: options.axios.setupAuthInterceptors,
+        });
+        configCallbacks({
+            onRefreshFailed: options.onRefreshFailed,
+            onLogout: options.onLogout,
         });
     },
 };
 
-export { AppTypes, ArchiveTypes, ArexVueCore, AudioTypes, AuthError, AxiosService, BaseError, ContentTypeEnum, DocumentTypes, ERROR_MESSAGES, ERROR_STYLES, ErrorEnum, ErrorMessages, ErrorStyles, ExceptionEnum, FontTypes, ImageTypes, KeyCodeEnum, NetworkError, OtherTypes, RestStd, ScreenBreakpoint, ScreenSize, ServerError, StorageKeyEnum, StorageTypeEnum, TextTypes, ValidationError, VideoTypes, ab2hex, addCustomKeyboardShortcut, addDays, addDoubleClickListener, addKeyListener, ageAtDate, axiosFetch, blobToFormData, bufferToBlob, calculateAge, cleanCredentials, clickOutside, compareObject, configAppKey, configAuthFetcher, configAxios, configEndpoints, configRefreshTokenPaths, configSession, configTokenKeys, configTokenPaths, copyToClipboard, countWords, createAxiosFetcher, createKeyMap, createOfetchFetcher, 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, extractAndValidateTokens, filterObjectByKeys, flattenObject, formDataToObject, formatDate, generateRandomString, getAppKey, getAuthRefreshToken, getAuthToken, getConfiguredAxiosInstance, getCookieStorage, getDecryptedItem, getDefaultAuthFetcher, getEndOfMonth, getEndpointsConfig, getObjectDifferences, getObjectKeys, getPreferredStorage, getQueryParam, getRefreshTokenPathsConfig, getSessionConfig, getSessionId, getSessionPersistence, getSessionStorage, getStartOfMonth, getStorage, getTokenConfig, getTokenPathsConfig, handleError, hasNestedProperties, hex2ab, importKey, isClient, isEmptyObject, isLeapYear, isServer, 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, refreshTokens, registerKeyboardShortcuts, removeAccent, removeClickOutside, removeCustomKeyboardShortcut, removeCustomShortcuts, removeDoubleClickListener, removeEmptyProperties, removeKeyListeners, replaceAll, retryWithBackoff, reverseString, safeGet, screenMap, scrollToTop, setDefaultAuthFetcherFactory, simulateKeyPress, stopDetectingKeyHold, storeAuthRefreshToken, storeAuthToken, storeEncryptedItem, storeTokens, stringToBlob, subtractDays, throttle, toCamelCase, toKebabCase, toggleTabNavigation, truncateString, unregisterKeyboardShortcuts, upperFirst, useAuth, useBreakpoint, useFetch, useFilter, usePagination, useSorter, validateAlphanumeric, validateLetters, validateNumbers, verifyAuth };
+export { AppTypes, ArchiveTypes, ArexVueCore, AudioTypes, AuthError, AxiosService, BaseError, ContentTypeEnum, DocumentTypes, ERROR_MESSAGES, ERROR_STYLES, ErrorEnum, ErrorMessages, ErrorStyles, ExceptionEnum, FontTypes, ImageTypes, KeyCodeEnum, NetworkError, OtherTypes, RestStd, ScreenBreakpoint, ScreenSize, ServerError, StorageKeyEnum, StorageTypeEnum, TextTypes, ValidationError, VideoTypes, ab2hex, addCustomKeyboardShortcut, addDays, addDoubleClickListener, addKeyListener, ageAtDate, axiosFetch, blobToFormData, bufferToBlob, calculateAge, cleanCredentials, clickOutside, compareObject, configAppKey, configAuthFetcher, configAxios, configCallbacks, configEndpoints, configRefreshTokenPaths, configSession, configTokenKeys, configTokenPaths, copyToClipboard, countWords, createAxiosFetcher, createKeyMap, createOfetchFetcher, 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, extractAndValidateTokens, filterObjectByKeys, flattenObject, formDataToObject, formatDate, generateRandomString, getAppKey, getAuthRefreshToken, getAuthToken, getCallbacksConfig, getConfiguredAxiosInstance, getCookieStorage, getDecryptedItem, getDefaultAuthFetcher, getEndOfMonth, getEndpointsConfig, getObjectDifferences, getObjectKeys, getPreferredStorage, getQueryParam, getRefreshTokenPathsConfig, getSessionConfig, getSessionId, getSessionPersistence, getSessionStorage, getStartOfMonth, getStorage, getTokenConfig, getTokenPathsConfig, handleError, hasNestedProperties, hex2ab, importKey, isClient, isEmptyObject, isLeapYear, isServer, 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, refreshTokens, registerKeyboardShortcuts, removeAccent, removeClickOutside, removeCustomKeyboardShortcut, removeCustomShortcuts, removeDoubleClickListener, removeEmptyProperties, removeKeyListeners, replaceAll, retryWithBackoff, reverseString, safeGet, screenMap, scrollToTop, setDefaultAuthFetcherFactory, simulateKeyPress, stopDetectingKeyHold, storeAuthRefreshToken, storeAuthToken, storeEncryptedItem, storeTokens, stringToBlob, subtractDays, throttle, toCamelCase, toKebabCase, toggleTabNavigation, truncateString, unregisterKeyboardShortcuts, upperFirst, useAuth, useBreakpoint, useFetch, useFilter, usePagination, useSorter, validateAlphanumeric, validateLetters, validateNumbers, verifyAuth };

package/dist/types/ArexVueCoreOptions.d.ts

@@ -39,4 +39,14 @@ export interface ArexVueCoreOptions {
     };
     /** The configuration options for the underlying Axios instance. */
     axios: AxiosServiceOptions;
+    /**
+     * Called when a token refresh attempt fails (e.g., to redirect to login via Vue Router).
+     * Falls back to `window.location.reload()` if not provided.
+     */
+    onRefreshFailed?: () => void;
+    /**
+     * Called after a successful logout (e.g., to redirect to login via Vue Router).
+     * Falls back to `window.location.reload()` if not provided.
+     */
+    onLogout?: () => void;
 }

package/dist/types/AxiosServiceOptions.d.ts

@@ -12,4 +12,10 @@ export interface AxiosServiceOptions {
     timeout?: number;
     /** A boolean indicating whether cross-site Access-Control requests should be made using credentials. */
     withCredentials?: boolean;
+    /**
+     * Whether to mount the authentication interceptors (token attachment + 401 refresh).
+     * Set to `false` in SSR environments where browser storage is unavailable.
+     * Defaults to `true`.
+     */
+    setupAuthInterceptors?: boolean;
 }

package/package.json

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