@arex95/vue-core 1.1.38 → 1.1.40

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

@@ -1,23 +1,11 @@
-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.
- * @property {function(): Promise<void>} cleanCredentials - Clears authentication credentials from storage.
- * @property {(params?: AuthParams) => Promise<void>} logout - Logs out the user, clears credentials, and reloads the page.
- * @property {(params: AuthParams, persistence: SessionPreference, tokenPaths?: AuthTokenPaths) => Promise<AuthResponse>} login - Logs in the user and stores tokens.
- * @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} getSessionPersistence - Retrieves the user's current preferred storage for authentication data.
- */
+import { AuthResponse, AuthTokenPaths, LocationPreference } from "@/types";
 /**
  * Custom hook for authentication logic, including login, logout, token management, and session preference.
  *
  * @param {string} secretKey - The secret key used for token encryption/decryption.
  * @returns {AuthHook} An object containing authentication functions.
  */
-export declare function useAuth(secretKey?: string): {
-    logout: (params?: AuthParams) => Promise<void>;
-    login: (params: AuthParams, persistence: LocationPreference, tokenPaths?: AuthTokenPaths) => Promise<AuthResponse>;
-    refresh: (tokenPaths?: AuthTokenPaths) => Promise<AuthResponse>;
+export declare function useAuth(): {
+    logout: (params?: any) => Promise<void>;
+    login: (params: any | undefined, persistence: LocationPreference, tokenPaths?: AuthTokenPaths) => Promise<AuthResponse>;
 };

package/dist/config/axios/axiosConfig.d.ts

@@ -10,10 +10,9 @@ export declare class AxiosService {
     private cancelTokenSource;
     private activeRequests;
     private readonly refreshTokenUrl;
-    private readonly refreshAuth;
     private isRefreshing;
     private failedQueue;
-    constructor(options: AxiosServiceOptions, refreshAuth: () => Promise<void>);
+    constructor(options: AxiosServiceOptions);
     private processQueue;
     private setAuthHeader;
     private initializeInterceptors;

package/dist/config/axios/axiosInstance.d.ts

@@ -1,12 +1,4 @@
+import { AxiosServiceOptions } from "@/types/AxiosServiceOptions";
 import { AxiosInstance } from "axios";
-interface AxiosConfig {
-    baseURL: string;
-}
-interface CustomAxiosConfig {
-    baseURL: string;
-    headers?: Record<string, string>;
-}
-export declare const configAxios: (config: AxiosConfig) => void;
-export declare const getAxiosInstance: () => AxiosInstance;
-export declare const createCustomAxiosInstance: (config: CustomAxiosConfig) => AxiosInstance;
-export {};
+export declare const configAxios: (config: AxiosServiceOptions) => void;
+export declare const getConfiguredAxiosInstance: () => AxiosInstance;

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

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

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

@@ -0,0 +1,36 @@
+interface TokenPathsConfig {
+    accessTokenPath?: string;
+    refreshTokenPath?: string;
+}
+/**
+ * Configures the paths for access and refresh tokens in the authentication response.
+ * This function freezes the object to prevent further modifications.
+ *
+ * @param {TokenPathsConfig} config - An object containing the paths for access and refresh tokens.
+ * @param {string} [config.accessTokenPath="data.access_token"] - Path to the access token in the response.
+ * @param {string} [config.refreshTokenPath="data.refresh_token"] - Path to the refresh token in the response.
+ *
+ * @returns {void} Does not return anything but freezes the token paths configuration object.
+ */
+export declare function configTokenPaths(config: TokenPathsConfig): void;
+/**
+ * Configures the paths for access and refresh tokens in the refresh response.
+ * This function freezes the object to prevent further modifications.
+ *
+ * @param {TokenPathsConfig} config - An object containing the paths for access and refresh tokens.
+ * @param {string} [config.accessTokenPath="data.access_token"] - Path to the access token in the response.
+ * @param {string} [config.refreshTokenPath="data.refresh_token"] - Path to the refresh token in the response.
+ *
+ * @returns {void} Does not return anything but freezes the refresh token paths configuration object.
+ */
+export declare function configRefreshTokenPaths(config: TokenPathsConfig): void;
+/**
+ * Retrieves the configured authentication token paths.
+ *
+ * @returns {AuthTokenPaths} An object containing the configured authentication token paths.
+ * @property {string} accessTokenPath - Path to the access token in the response.
+ * @property {string} refreshTokenPath - Path to the refresh token in the response.
+ */
+export declare function getTokenPathsConfig(): TokenPathsConfig;
+export declare function getRefreshTokenPathsConfig(): TokenPathsConfig;
+export {};

package/dist/index.d.ts

@@ -12,7 +12,7 @@ export declare const ArexVueCore: {
      * @param app The Vue application instance.
      * @param options The configuration options provided by the user.
      */
-    install: (app: App, options: ArexVueCoreOptions) => Promise<void>;
+    install: (app: App, options: ArexVueCoreOptions) => void;
 };
 export * from "./rest";
 export * from "./composables";
@@ -20,3 +20,4 @@ export * from "./config";
 export * from "./enums";
 export * from "./types";
 export * from "./utils";
+export * from "./services";

package/dist/index.mjs

@@ -881,6 +881,60 @@ async function getSessionConfig() {
     return _sessionConfig;
 }
 
+let tokenPathsConfig = {
+    accessTokenPath: "data.access_token",
+    refreshTokenPath: "data.refresh_token",
+};
+let refreshTokenPathsConfig = {
+    accessTokenPath: "data.access_token",
+    refreshTokenPath: "data.refresh_token",
+};
+/**
+ * Configures the paths for access and refresh tokens in the authentication response.
+ * This function freezes the object to prevent further modifications.
+ *
+ * @param {TokenPathsConfig} config - An object containing the paths for access and refresh tokens.
+ * @param {string} [config.accessTokenPath="data.access_token"] - Path to the access token in the response.
+ * @param {string} [config.refreshTokenPath="data.refresh_token"] - Path to the refresh token in the response.
+ *
+ * @returns {void} Does not return anything but freezes the token paths configuration object.
+ */
+function configTokenPaths(config) {
+    tokenPathsConfig = Object.freeze({
+        accessTokenPath: config.accessTokenPath || "data.access_token",
+        refreshTokenPath: config.refreshTokenPath || "data.refresh_token",
+    });
+}
+/**
+ * Configures the paths for access and refresh tokens in the refresh response.
+ * This function freezes the object to prevent further modifications.
+ *
+ * @param {TokenPathsConfig} config - An object containing the paths for access and refresh tokens.
+ * @param {string} [config.accessTokenPath="data.access_token"] - Path to the access token in the response.
+ * @param {string} [config.refreshTokenPath="data.refresh_token"] - Path to the refresh token in the response.
+ *
+ * @returns {void} Does not return anything but freezes the refresh token paths configuration object.
+ */
+function configRefreshTokenPaths(config) {
+    refreshTokenPathsConfig = Object.freeze({
+        accessTokenPath: config.accessTokenPath || "data.access_token",
+        refreshTokenPath: config.refreshTokenPath || "data.refresh_token",
+    });
+}
+/**
+ * Retrieves the configured authentication token paths.
+ *
+ * @returns {AuthTokenPaths} An object containing the configured authentication token paths.
+ * @property {string} accessTokenPath - Path to the access token in the response.
+ * @property {string} refreshTokenPath - Path to the refresh token in the response.
+ */
+function getTokenPathsConfig() {
+    return tokenPathsConfig;
+}
+function getRefreshTokenPathsConfig() {
+    return refreshTokenPathsConfig;
+}
+
 /**
  * Clears all stored authentication data (access and refresh tokens)
  * from either sessionStorage, localStorage, or both based on the provided location preference.
@@ -993,132 +1047,6 @@ const verifyAuth = async () => {
     }
 };
 
-class AxiosService {
-    instance;
-    cancelTokenSource;
-    activeRequests = 0;
-    refreshTokenUrl;
-    refreshAuth;
-    isRefreshing = false;
-    failedQueue = [];
-    constructor(options, refreshAuth) {
-        this.cancelTokenSource = axios.CancelToken.source();
-        this.refreshAuth = refreshAuth;
-        const endpointsConfig = getEndpointsConfig();
-        this.refreshTokenUrl = endpointsConfig.REFRESH;
-        this.instance = axios.create({
-            baseURL: options.baseURL ?? "",
-            timeout: options.timeout ?? 30000,
-            headers: {
-                Accept: "application/json",
-                "Content-Type": "application/json",
-                ...options.headers,
-            },
-            withCredentials: options.withCredentials ?? false,
-        });
-        this.initializeInterceptors();
-    }
-    processQueue(error, token = null) {
-        this.failedQueue.forEach((prom) => {
-            if (error) {
-                prom.reject(error);
-            }
-            else if (token) {
-                prom.resolve(token);
-            }
-        });
-        this.failedQueue = [];
-    }
-    setAuthHeader(config, token) {
-        if (config.headers) {
-            config.headers.Authorization = `Bearer ${token}`;
-        }
-    }
-    initializeInterceptors() {
-        this.instance.interceptors.request.use(async (config) => {
-            const token = await getAuthToken(getAppKey(), "any");
-            if (token) {
-                this.setAuthHeader(config, token);
-            }
-            config.cancelToken = this.cancelTokenSource.token;
-            this.activeRequests++;
-            return config;
-        }, (error) => {
-            handleError(error, false);
-            return Promise.reject(error);
-        });
-        this.instance.interceptors.response.use((response) => {
-            this.activeRequests--;
-            return response;
-        }, async (error) => {
-            this.activeRequests--;
-            const originalRequest = error.config;
-            const isAuthError = axios.isAxiosError(error) && error.response?.status === 401;
-            const isRefreshCall = originalRequest?.url === this.refreshTokenUrl;
-            const isRetry = originalRequest?._retry === true;
-            if (!isAuthError || isRefreshCall || isRetry) {
-                handleError(error, false);
-                return Promise.reject(error);
-            }
-            if (!originalRequest) {
-                handleError(error, false);
-                return Promise.reject(error);
-            }
-            if (this.isRefreshing) {
-                return new Promise((resolve, reject) => {
-                    this.failedQueue.push({ resolve, reject });
-                })
-                    .then((newToken) => {
-                    this.setAuthHeader(originalRequest, newToken);
-                    return this.instance(originalRequest);
-                })
-                    .catch((err) => {
-                    return Promise.reject(err);
-                });
-            }
-            this.isRefreshing = true;
-            originalRequest._retry = true;
-            try {
-                await this.refreshAuth();
-                const newToken = await getAuthToken(getAppKey(), "any");
-                if (newToken) {
-                    this.processQueue(null, newToken);
-                    this.setAuthHeader(originalRequest, newToken);
-                }
-                else {
-                    const refreshError = new Error("New token not found after refresh.");
-                    this.processQueue(refreshError, null);
-                    throw refreshError;
-                }
-                this.isRefreshing = false;
-                return this.instance(originalRequest);
-            }
-            catch (refreshError) {
-                this.processQueue(refreshError, null);
-                this.isRefreshing = false;
-                handleError(refreshError, false);
-                return Promise.reject(error);
-            }
-        });
-    }
-    getActiveRequests() {
-        return this.activeRequests;
-    }
-    getAxiosInstance() {
-        return this.instance;
-    }
-    cancelAllRequests() {
-        this.cancelTokenSource.cancel("Operation canceled by the user.");
-        this.cancelTokenSource = axios.CancelToken.source();
-    }
-    setHeader(key, value) {
-        this.instance.defaults.headers.common[key] = value;
-    }
-    removeHeader(key) {
-        delete this.instance.defaults.headers.common[key];
-    }
-}
-
 /**
  * Converts a Proxy object to a plain object.
  * @param {ProxyConstructor} proxy The Proxy object to convert.
@@ -1401,157 +1329,216 @@ function flattenObject(obj, parentKey = '', result = {}) {
 // flattenObject({ a: 1, b: { c: 2, d: { e: 3 } } }); // { 'a': 1, 'b.c': 2, 'b.d.e': 3 }
 
 /**
- * @typedef {object} AuthHook
- * @property {function(): Promise<number | null>} getTokenExpiry - Retrieves the expiration time of the current token in milliseconds.
- * @property {function(): Promise<void>} cleanCredentials - Clears authentication credentials from storage.
- * @property {(params?: AuthParams) => Promise<void>} logout - Logs out the user, clears credentials, and reloads the page.
- * @property {(params: AuthParams, persistence: SessionPreference, tokenPaths?: AuthTokenPaths) => Promise<AuthResponse>} login - Logs in the user and stores tokens.
- * @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} getSessionPersistence - Retrieves the user's current preferred storage for authentication data.
- */
-/**
- * Custom hook for authentication logic, including login, logout, token management, and session preference.
+ * Extracts and validates the access and refresh tokens from a response object.
+ * Throws an error if the tokens are not found or are invalid.
  *
- * @param {string} secretKey - The secret key used for token encryption/decryption.
- * @returns {AuthHook} An object containing authentication functions.
- */
-function useAuth(secretKey = getAppKey()) {
-    const axiosInstance = getAxiosInstance();
+ * @param {any} data - The API response object.
+ * @param {AuthTokenPaths} tokenPaths - The paths for the tokens.
+ * @param {string} errorSource - A prefix for the error message ("LOGIN" or "REFRESH").
+ * @returns {TokenValidationResult} An object with the validated tokens.
+ */
+const extractAndValidateTokens = (data, tokenPaths, errorSource) => {
+    const accessTokenPath = tokenPaths?.accessTokenPath || "access_token";
+    const refreshTokenPath = tokenPaths?.refreshTokenPath || "refresh_token";
+    if (!data) {
+        throw new Error(`${errorSource}_ERROR: No data received.`);
+    }
+    const accessToken = safeGet(data, accessTokenPath.split("."));
+    const refreshToken = safeGet(data, refreshTokenPath.split("."));
+    if (!accessToken || typeof accessToken !== "string") {
+        throw new Error(`${errorSource}_ERROR: Access token not found or invalid at path '${accessTokenPath}' in response.`);
+    }
+    if (!refreshToken || typeof refreshToken !== "string") {
+        throw new Error(`${errorSource}_ERROR: Refresh token not found or invalid at path '${refreshTokenPath}' in response.`);
+    }
+    return { accessToken, refreshToken };
+};
+
+/**
+* Stores the access and refresh tokens in the appropriate storage based on the user's preference.
+*
+* @param {string} accessToken - El token de acceso.
+* @param {string} refreshToken - El token de refresco.
+* @param {LocationPreference} persistence - La preferencia de almacenamiento.
+*/
+const storeTokens = async (accessToken, refreshToken, persistence) => {
+    await storeAuthToken(accessToken, getAppKey(), persistence);
+    await storeAuthRefreshToken(refreshToken, getAppKey(), persistence);
+};
+
+/**
+   * Refreshes the authentication tokens using the stored refresh token.
+   * This function can also accept optional token paths if the refresh endpoint
+   * returns tokens with a different structure than the default login.
+   * If no refresh token is found, it throws an error and initiates a logout.
+   *
+   * @param {AuthTokenPaths} [tokenPaths] - Optional configuration for the paths (in dot notation) of the access and refresh tokens in the refresh endpoint response.
+   * @returns {Promise<AuthResponse>} The new authentication response with refreshed tokens.
+   * @throws {Error} If the refresh token is missing or the refresh request fails.
+   */
+const refreshTokens = async (axiosInstance) => {
+    const tokenPaths = getRefreshTokenPathsConfig();
     const endpoints = getEndpointsConfig();
-    /**
-     * Logs out the user by making a POST request to the logout endpoint,
-     * cleaning all stored credentials, and reloading the page.
-     * The session persistence preference is NOT reset here; it persists across logouts.
-     *
-     * @param {AuthParams} [params={}] - Optional parameters to send with the logout request.
-     * @returns {Promise<void>}
-     */
-    const logout = async (params = {}) => {
-        try {
-            await axiosInstance.post(endpoints.LOGOUT, params);
-        }
-        catch (error) {
-            handleError(error, false);
+    const secretKey = getAppKey();
+    const persistence = await getSessionPersistence();
+    try {
+        const refreshTokenFromStorage = await getAuthRefreshToken(secretKey, "any");
+        if (!refreshTokenFromStorage) {
+            throw new Error("TOKEN_MISSING: No refresh token found in storage.");
         }
-        finally {
-            await cleanCredentials(await getSessionPersistence());
+        const { data } = await axiosInstance.post(endpoints.REFRESH);
+        const { accessToken, refreshToken } = extractAndValidateTokens(data, tokenPaths, "REFRESH");
+        await storeTokens(accessToken, refreshToken, persistence);
+        return data;
+    }
+    catch (error) {
+        handleError(error, false);
+        await cleanCredentials(persistence);
+        if (window) {
             window.location.reload();
         }
-    };
-    /**
-     * Authenticates the user by making a POST request to the login endpoint,
-     * stores the received access and refresh tokens, and sets the session persistence preference.
-     *
-     * @param {AuthParams} params - The authentication parameters (e.g., username, password).
-     * @param {SessionPreference} persistence - The storage preference: 'local' for localStorage, 'session' for sessionStorage.
-     * @param {AuthTokenPaths} [tokenPaths] - Configuración opcional para las rutas (en notación de punto) donde se encuentran los tokens en la respuesta de la API.
-     * @returns {Promise<AuthResponse>} La respuesta de autenticación que contiene los tokens e información del usuario.
-     * @throws {Error} Si la solicitud de login falla, o si los tokens de acceso/refresco no se encuentran o no son válidos en la respuesta.
-     */
-    const login = async (params, persistence, tokenPaths) => {
-        try {
-            const { data } = await axiosInstance.post(endpoints.LOGIN, params);
-            const accessTokenPath = tokenPaths?.accessTokenPath || "access_token";
-            const refreshTokenPath = tokenPaths?.refreshTokenPath || "refresh_token";
-            const accessTokenPathArray = accessTokenPath.split(".");
-            const refreshTokenPathArray = refreshTokenPath.split(".");
-            if (!data) {
-                throw new Error("LOGIN_ERROR: No data received from login endpoint.");
-            }
-            const accessToken = safeGet(data, accessTokenPathArray);
-            const refreshToken = safeGet(data, refreshTokenPathArray);
-            if (!accessToken || typeof accessToken !== "string") {
-                throw new Error(`LOGIN_ERROR: Access token not found or invalid at path '${accessTokenPath}' in response.`);
+        throw error;
+    }
+};
+
+class AxiosService {
+    instance;
+    cancelTokenSource;
+    activeRequests = 0;
+    refreshTokenUrl;
+    isRefreshing = false;
+    failedQueue = [];
+    constructor(options) {
+        this.cancelTokenSource = axios.CancelToken.source();
+        const endpointsConfig = getEndpointsConfig();
+        this.refreshTokenUrl = endpointsConfig.REFRESH;
+        this.instance = axios.create({
+            baseURL: options.baseURL ?? "",
+            timeout: options.timeout ?? 30000,
+            headers: {
+                Accept: "application/json",
+                "Content-Type": "application/json",
+                ...options.headers,
+            },
+            withCredentials: options.withCredentials ?? false,
+        });
+        this.initializeInterceptors();
+    }
+    processQueue(error, token = null) {
+        this.failedQueue.forEach((prom) => {
+            if (error) {
+                prom.reject(error);
             }
-            if (!refreshToken || typeof refreshToken !== "string") {
-                throw new Error(`LOGIN_ERROR: Refresh token not found or invalid at path '${refreshTokenPath}' in response.`);
+            else if (token) {
+                prom.resolve(token);
             }
-            configSession({
-                persistencePreference: persistence,
-            });
-            await storeAuthToken(accessToken, secretKey, persistence);
-            await storeAuthRefreshToken(refreshToken, secretKey, persistence);
-            return data;
+        });
+        this.failedQueue = [];
+    }
+    setAuthHeader(config, token) {
+        if (config.headers) {
+            config.headers.Authorization = `Bearer ${token}`;
         }
-        catch (error) {
+    }
+    initializeInterceptors() {
+        this.instance.interceptors.request.use(async (config) => {
+            const token = await getAuthToken(getAppKey(), "any");
+            if (token) {
+                this.setAuthHeader(config, token);
+            }
+            config.cancelToken = this.cancelTokenSource.token;
+            this.activeRequests++;
+            return config;
+        }, (error) => {
             handleError(error, false);
-            throw error;
-        }
-    };
-    /**
-     * Refreshes the authentication tokens using the stored refresh token.
-     * This function can also accept optional token paths if the refresh endpoint
-     * returns tokens with a different structure than the default login.
-     * If no refresh token is found, it throws an error and initiates a logout.
-     *
-     * @param {AuthTokenPaths} [tokenPaths] - Configuración opcional para las rutas (en notación de punto) de los tokens de acceso y refresco en la respuesta del endpoint de refresco.
-     * @returns {Promise<AuthResponse>} The new authentication response with refreshed tokens.
-     * @throws {Error} If the refresh token is missing or the refresh request fails.
-     */
-    const refresh = async (tokenPaths) => {
-        try {
-            const refreshTokenFromStorage = await getAuthRefreshToken(secretKey, 'any');
-            if (!refreshTokenFromStorage) {
-                throw new Error("TOKEN_MISSING: No refresh token found in storage.");
+            return Promise.reject(error);
+        });
+        this.instance.interceptors.response.use((response) => {
+            this.activeRequests--;
+            return response;
+        }, async (error) => {
+            this.activeRequests--;
+            const originalRequest = error.config;
+            const isAuthError = axios.isAxiosError(error) && error.response?.status === 401;
+            const isRefreshCall = originalRequest?.url === this.refreshTokenUrl;
+            const isRetry = originalRequest?._retry === true;
+            if (!isAuthError || isRefreshCall || isRetry) {
+                handleError(error, false);
+                return Promise.reject(error);
             }
-            const { data } = await axiosInstance.post(endpoints.REFRESH, { refresh_token: refreshTokenFromStorage });
-            const accessTokenPath = tokenPaths?.accessTokenPath || "access_token";
-            const refreshTokenPath = tokenPaths?.refreshTokenPath || "refresh_token";
-            const accessTokenPathArray = accessTokenPath.split(".");
-            const refreshTokenPathArray = refreshTokenPath.split(".");
-            if (!data) {
-                throw new Error("REFRESH_ERROR: No data received from refresh endpoint.");
+            if (!originalRequest) {
+                handleError(error, false);
+                return Promise.reject(error);
             }
-            const accessTokenAfterRefresh = safeGet(data, accessTokenPathArray);
-            const refreshTokenAfterRefresh = safeGet(data, refreshTokenPathArray);
-            if (!accessTokenAfterRefresh ||
-                typeof accessTokenAfterRefresh !== "string") {
-                throw new Error(`REFRESH_ERROR: Access token not found or invalid at path '${accessTokenPath}' in refresh response.`);
+            if (this.isRefreshing) {
+                return new Promise((resolve, reject) => {
+                    this.failedQueue.push({ resolve, reject });
+                })
+                    .then((newToken) => {
+                    this.setAuthHeader(originalRequest, newToken);
+                    return this.instance(originalRequest);
+                })
+                    .catch((err) => {
+                    return Promise.reject(err);
+                });
             }
-            if (!refreshTokenAfterRefresh ||
-                typeof refreshTokenAfterRefresh !== "string") {
-                throw new Error(`REFRESH_ERROR: Refresh token not found or invalid at path '${refreshTokenPath}' in refresh response.`);
+            this.isRefreshing = true;
+            originalRequest._retry = true;
+            try {
+                await refreshTokens(this.instance);
+                const newToken = await getAuthToken(getAppKey(), "any");
+                if (newToken) {
+                    this.processQueue(null, newToken);
+                    this.setAuthHeader(originalRequest, newToken);
+                }
+                else {
+                    const refreshError = new Error("New token not found after refresh.");
+                    this.processQueue(refreshError, null);
+                    throw refreshError;
+                }
+                this.isRefreshing = false;
+                return this.instance(originalRequest);
             }
-            await storeAuthToken(accessTokenAfterRefresh, secretKey, await getSessionPersistence());
-            await storeAuthRefreshToken(refreshTokenAfterRefresh, secretKey, await getSessionPersistence());
-            return data;
-        }
-        catch (error) {
-            handleError(error, false);
-            await logout();
-            throw error;
-        }
-    };
-    return {
-        logout,
-        login,
-        refresh,
-    };
+            catch (refreshError) {
+                this.processQueue(refreshError, null);
+                this.isRefreshing = false;
+                handleError(refreshError, false);
+                return Promise.reject(error);
+            }
+        });
+    }
+    getActiveRequests() {
+        return this.activeRequests;
+    }
+    getAxiosInstance() {
+        return this.instance;
+    }
+    cancelAllRequests() {
+        this.cancelTokenSource.cancel("Operation canceled by the user.");
+        this.cancelTokenSource = axios.CancelToken.source();
+    }
+    setHeader(key, value) {
+        this.instance.defaults.headers.common[key] = value;
+    }
+    removeHeader(key) {
+        delete this.instance.defaults.headers.common[key];
+    }
 }
 
-let axiosInstance;
-const auth = useAuth();
-const refreshAndForget = async () => {
-    await auth.refresh();
-};
+let axiosServiceInstance;
 const configAxios = (config) => {
-    axiosInstance = new AxiosService({
+    axiosServiceInstance = new AxiosService({
         baseURL: config.baseURL,
-    }, refreshAndForget);
+        headers: config.headers,
+        timeout: config.timeout,
+        withCredentials: config.withCredentials
+    });
 };
-const getAxiosInstance = () => {
-    if (!axiosInstance) {
+const getConfiguredAxiosInstance = () => {
+    if (!axiosServiceInstance) {
         throw new Error("Axios instance not configured. Call configAxios first.");
     }
-    return axiosInstance.getAxiosInstance();
-};
-const createCustomAxiosInstance = (config) => {
-    return new AxiosService({
-        baseURL: config.baseURL,
-        headers: config.headers,
-    }, refreshAndForget).getAxiosInstance();
+    return axiosServiceInstance.getAxiosInstance();
 };
 
 /**
@@ -3126,7 +3113,7 @@ async function axiosFetch(axios, axiosRequest) {
  * @returns A function that handles the request using the provided composable.
  */
 function createFetch(fetchComposable, axiosCustomInstance) {
-    const instance = axiosCustomInstance || getAxiosInstance();
+    const instance = axiosCustomInstance || getConfiguredAxiosInstance();
     return (axiosRequestConfig, options) => {
         return fetchComposable(instance, axiosRequestConfig, options);
     };
@@ -3486,6 +3473,66 @@ function useSorter(items, criteriaList, selectedCriteria) {
     }).value;
 }
 
+/**
+ * Custom hook for authentication logic, including login, logout, token management, and session preference.
+ *
+ * @param {string} secretKey - The secret key used for token encryption/decryption.
+ * @returns {AuthHook} An object containing authentication functions.
+ */
+function useAuth() {
+    const axiosInstance = getConfiguredAxiosInstance();
+    const endpoints = getEndpointsConfig();
+    /**
+     * Logs out the user by making a POST request to the logout endpoint,
+     * cleaning all stored credentials, and reloading the page.
+     * The session persistence preference is NOT reset here; it persists across logouts.
+     *
+     * @param {AuthParams} [params={}] - Optional parameters to send with the logout request.
+     * @returns {Promise<void>}
+     */
+    const logout = async (params = {}) => {
+        try {
+            await axiosInstance.post(endpoints.LOGOUT, params);
+        }
+        catch (error) {
+            handleError(error, false);
+        }
+        finally {
+            await cleanCredentials(await getSessionPersistence());
+            window.location.reload();
+        }
+    };
+    /**
+     * Authenticates the user by making a POST request to the login endpoint,
+     * stores the received access and refresh tokens, and sets the session persistence preference.
+     *
+     * @param {AuthParams} params - The authentication parameters (e.g., username, password).
+     * @param {LocationPreference} persistence - The storage preference: 'local' for localStorage, 'session' for sessionStorage.
+     * @param {AuthTokenPaths} [tokenPaths] - Optional configuration for the paths (in dot notation) where the tokens are located in the API response.
+     * @returns {Promise<AuthResponse>} The authentication response containing the tokens and user information.
+     * @throws {Error} If the login request fails, or if the access/refresh tokens are not found or are invalid in the response.
+     */
+    const login = async (params = {}, persistence, tokenPaths = getTokenPathsConfig()) => {
+        try {
+            const { data } = await axiosInstance.post(endpoints.LOGIN, params);
+            const { accessToken, refreshToken } = extractAndValidateTokens(data, tokenPaths, "LOGIN");
+            configSession({
+                persistencePreference: persistence,
+            });
+            await storeTokens(accessToken, refreshToken, persistence);
+            return data;
+        }
+        catch (error) {
+            handleError(error, false);
+            throw error;
+        }
+    };
+    return {
+        logout,
+        login
+    };
+}
+
 /**
  * The Vue plugin for @arex95/vue-core.
  * Configures the core functionalities for authentication and API communication.
@@ -3498,38 +3545,38 @@ const ArexVueCore = {
      * @param app The Vue application instance.
      * @param options The configuration options provided by the user.
      */
-    install: async (app, options) => {
+    install: (app, options) => {
         if (!options) {
             console.warn("ArexVueCore: No configuration options were provided. The library may not function correctly.");
             return;
         }
-        try {
-            console.log("Starting configuration process...");
-            await configAppKey({
-                appKey: options.appKey
-            });
-            console.log("[1/4]-configAppKey executed successfully.");
-            await configTokenKeys({
-                accessTokenKey: options.tokenKeys.accessToken,
-                refreshTokenKey: options.tokenKeys.refreshToken
-            });
-            console.log("[2/4]-configTokenKeys executed successfully.");
-            await configEndpoints({
-                loginEndpoint: options.endpoints.login,
-                refreshEndpoint: options.endpoints.refresh,
-                logoutEndpoint: options.endpoints.logout,
-            });
-            console.log("[3/4]-configEndpoints executed successfully.");
-            await configAxios({
-                baseURL: options.apiUrl,
-            });
-            console.log("[4/4]-configAxios executed successfully.");
-            console.log("All configurations completed in the correct order.");
-        }
-        catch (error) {
-            console.error("Configuration failed:", error);
-        }
+        configAppKey({
+            appKey: options.appKey
+        });
+        configTokenKeys({
+            accessTokenKey: options.tokenKeys.accessToken,
+            refreshTokenKey: options.tokenKeys.refreshToken,
+        });
+        configEndpoints({
+            loginEndpoint: options.endpoints.login,
+            refreshEndpoint: options.endpoints.refresh,
+            logoutEndpoint: options.endpoints.logout,
+        });
+        configTokenPaths({
+            accessTokenPath: options.tokenPaths.accessToken,
+            refreshTokenPath: options.tokenPaths.refreshToken,
+        });
+        configRefreshTokenPaths({
+            accessTokenPath: options.refreshTokenPaths.accessToken,
+            refreshTokenPath: options.refreshTokenPaths.refreshToken,
+        });
+        configAxios({
+            baseURL: options.axios.baseURL,
+            headers: options.axios.headers,
+            timeout: options.axios.timeout,
+            withCredentials: options.axios.withCredentials
+        });
     },
 };
 
-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 };
+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, configRefreshTokenPaths, configSession, configTokenKeys, configTokenPaths, copyToClipboard, countWords, 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, extractAndValidateTokens, filterObjectByKeys, flattenObject, formDataToObject, formatDate, generateRandomString, getAppKey, getAuthRefreshToken, getAuthToken, getConfiguredAxiosInstance, getDecryptedItem, getEndOfMonth, getEndpointsConfig, getObjectDifferences, getObjectKeys, getQueryParam, getRefreshTokenPathsConfig, getSessionConfig, getSessionId, getSessionPersistence, getStartOfMonth, getTokenConfig, getTokenPathsConfig, 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, refreshTokens, registerKeyboardShortcuts, removeAccent, removeClickOutside, removeCustomKeyboardShortcut, removeCustomShortcuts, removeDoubleClickListener, removeEmptyProperties, removeKeyListeners, replaceAll, reverseString, safeGet, screenMap, scrollToTop, simulateKeyPress, stopDetectingKeyHold, storeAuthRefreshToken, storeAuthToken, storeEncryptedItem, storeTokens, stringToBlob, subtractDays, throttle, toCamelCase, toKebabCase, toggleTabNavigation, truncateString, unregisterKeyboardShortcuts, upperFirst, useAuth, useBreakpoint, useFilter, usePagination, useSorter, useVueQuery, validateAlphanumeric, validateLetters, validateNumbers, verifyAuth };

package/dist/services/credentials.d.ts

@@ -0,0 +1,56 @@
+import { LocationPreference } from "@/types/SessionConfig";
+/**
+ * Clears all stored authentication data (access and refresh tokens)
+ * from either sessionStorage, localStorage, or both based on the provided location preference.
+ *
+ * @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: (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.
+ *
+ * @param {string} secretKey - The secret key used for decryption.
+ * @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, 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.
+ *
+ * @param {string} secretKey - The secret key used for decryption.
+ * @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, location: LocationPreference) => Promise<string | null>;
+/**
+ * Stores the authentication token (access token) in storage after encrypting it,
+ * based on the specified session preference.
+ *
+ * @param {string} token - The access token to store.
+ * @param {string} secretKey - The secret key used for encryption.
+ * @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, location: LocationPreference) => Promise<void>;
+/**
+ * Stores the authentication refresh token in storage after encrypting it,
+ * based on the specified session preference.
+ *
+ * @param {string} token - The refresh token to store.
+ * @param {string} secretKey - The secret key used for encryption.
+ * @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, 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.
+ *
+ * @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.
+ */
+export declare const verifyAuth: () => Promise<boolean>;

package/dist/services/extractTokens.d.ts

@@ -0,0 +1,12 @@
+import { AuthTokenPaths } from "@/types";
+import { TokenValidationResult } from '@/types';
+/**
+ * Extracts and validates the access and refresh tokens from a response object.
+ * Throws an error if the tokens are not found or are invalid.
+ *
+ * @param {any} data - The API response object.
+ * @param {AuthTokenPaths} tokenPaths - The paths for the tokens.
+ * @param {string} errorSource - A prefix for the error message ("LOGIN" or "REFRESH").
+ * @returns {TokenValidationResult} An object with the validated tokens.
+ */
+export declare const extractAndValidateTokens: (data: any, tokenPaths: AuthTokenPaths, errorSource: string) => TokenValidationResult;

package/dist/services/index.d.ts

@@ -0,0 +1,4 @@
+export * from './extractTokens';
+export * from './refreshTokens';
+export * from "./storeTokens";
+export * from './credentials';

package/dist/services/refreshTokens.d.ts

@@ -0,0 +1,13 @@
+import { AuthResponse } from "@/types";
+import { AxiosInstance } from 'axios';
+/**
+   * Refreshes the authentication tokens using the stored refresh token.
+   * This function can also accept optional token paths if the refresh endpoint
+   * returns tokens with a different structure than the default login.
+   * If no refresh token is found, it throws an error and initiates a logout.
+   *
+   * @param {AuthTokenPaths} [tokenPaths] - Optional configuration for the paths (in dot notation) of the access and refresh tokens in the refresh endpoint response.
+   * @returns {Promise<AuthResponse>} The new authentication response with refreshed tokens.
+   * @throws {Error} If the refresh token is missing or the refresh request fails.
+   */
+export declare const refreshTokens: (axiosInstance: AxiosInstance) => Promise<AuthResponse>;

package/dist/services/storeTokens.d.ts

@@ -0,0 +1,9 @@
+import { LocationPreference } from "@/types";
+/**
+* Stores the access and refresh tokens in the appropriate storage based on the user's preference.
+*
+* @param {string} accessToken - El token de acceso.
+* @param {string} refreshToken - El token de refresco.
+* @param {LocationPreference} persistence - La preferencia de almacenamiento.
+*/
+export declare const storeTokens: (accessToken: string, refreshToken: string, persistence: LocationPreference) => Promise<void>;

package/dist/types/ArexVueCoreOptions.d.ts

@@ -1,3 +1,4 @@
+import { AxiosServiceOptions } from "./AxiosServiceOptions";
 export interface ArexVueCoreOptions {
     appKey: string;
     endpoints: {
@@ -9,5 +10,13 @@ export interface ArexVueCoreOptions {
         accessToken: string;
         refreshToken: string;
     };
-    apiUrl: string;
+    tokenPaths: {
+        accessToken: string;
+        refreshToken: string;
+    };
+    refreshTokenPaths: {
+        accessToken: string;
+        refreshToken: string;
+    };
+    axios: AxiosServiceOptions;
 }

package/dist/types/Auth.d.ts

@@ -3,10 +3,6 @@ export type AuthConfig = {
     endpoints: EndpointsConfig;
     storageKeys: TokensConfig;
 };
-export interface AuthParams {
-    username?: string;
-    password?: string;
-}
 export interface AuthTokenPaths {
     accessTokenPath?: string;
     refreshTokenPath?: string;

package/dist/types/TokenValidationResult.d.ts

@@ -0,0 +1,4 @@
+export type TokenValidationResult = {
+    accessToken: string;
+    refreshToken: string;
+};

package/dist/types/index.d.ts

@@ -9,3 +9,4 @@ export * from './DecodedJwtPayload';
 export * from './ArexVueCoreOptions';
 export * from './AppKeyConfig';
 export * from './AxiosServiceOptions';
+export * from './TokenValidationResult';

package/dist/utils/index.d.ts

@@ -7,7 +7,7 @@ export * from './files';
 export * from './objects';
 export * from './strings';
 export * from './validations';
-export * from './credentials';
+export * from '../services/credentials';
 export * from './storage';
 export * from './encryption';
 export * from './errors';

package/package.json

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