@arex95/vue-core 1.1.39 → 1.1.41

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/composables/axios/index.d.ts

@@ -1,3 +1,3 @@
 export * from './axiosFetch';
-export * from './createFetch';
+export * from './useFetch';
 export * from './useVueQuery';

package/dist/composables/axios/useFetch.d.ts

@@ -0,0 +1,9 @@
+import { AxiosInstance, AxiosRequestConfig } from 'axios';
+import { UseQueryOptions } from '@tanstack/vue-query';
+/**
+ * Creates a fetchFn for Axios requests with an optional custom instance.
+ * @param fetchComposable - The fn to use for the request (can be any fetch function).
+ * @param axiosCustomInstance - An optional custom Axios instance to use for the request.
+ * @returns A function that handles the request using the provided fn.
+ */
+export declare function useFetch(fetchFn: Function, axiosCustomInstance?: AxiosInstance): (axiosRequestConfig: AxiosRequestConfig, options?: UseQueryOptions) => any;

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

@@ -10,13 +10,11 @@ export declare class AxiosService {
     private cancelTokenSource;
     private activeRequests;
     private readonly refreshTokenUrl;
-    private readonly auth;
     private isRefreshing;
     private failedQueue;
     constructor(options: AxiosServiceOptions);
     private processQueue;
     private setAuthHeader;
-    private getLatestAuthToken;
     private initializeInterceptors;
     getActiveRequests(): number;
     getAxiosInstance(): AxiosInstance;

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

@@ -1,41 +1,4 @@
+import { AxiosServiceOptions } from "@/types/AxiosServiceOptions";
 import { AxiosInstance } from "axios";
-/**
- * Configuration object for the Axios instance.
- */
-interface AxiosConfig {
-    baseURL: string;
-}
-/**
- * Configuration object for a custom Axios instance.
- */
-interface CustomAxiosConfig {
-    baseURL: string;
-    headers?: Record<string, string>;
-}
-/**
- * Configures the global Axios instance with a base URL.
- *
- * @param {AxiosConfig} config - An object containing the base URL for the Axios instance.
- * @param {string} config.baseURL - The base URL for the Axios instance.
- *
- * @returns {void}
- */
-export declare const configAxios: (config: AxiosConfig) => void;
-/**
- * Retrieves the configured Axios instance.
- *
- * @returns {AxiosService} The configured Axios instance.
- * @throws Will throw an error if the Axios instance is not configured.
- */
-export declare const getAxiosInstance: () => AxiosInstance;
-/**
- * Creates a new AxiosService instance with custom headers.
- *
- * @param {CustomAxiosConfig} config - An object containing the base URL and optional custom headers.
- * @param {string} config.baseURL - The base URL for the Axios instance.
- * @param {Record<string, string>} [config.headers] - Custom headers to set (optional).
- *
- * @returns {AxiosService} The new AxiosService instance.
- */
-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

@@ -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,48 +1047,6 @@ const verifyAuth = async () => {
     }
 };
 
-let axiosInstance;
-/**
- * Configures the global Axios instance with a base URL.
- *
- * @param {AxiosConfig} config - An object containing the base URL for the Axios instance.
- * @param {string} config.baseURL - The base URL for the Axios instance.
- *
- * @returns {void}
- */
-const configAxios = (config) => {
-    axiosInstance = new AxiosService({
-        baseURL: config.baseURL,
-    });
-};
-/**
- * Retrieves the configured Axios instance.
- *
- * @returns {AxiosService} The configured Axios instance.
- * @throws Will throw an error if the Axios instance is not configured.
- */
-const getAxiosInstance = () => {
-    if (!axiosInstance) {
-        throw new Error("Axios instance not configured. Call configAxios first.");
-    }
-    return axiosInstance.getAxiosInstance();
-};
-/**
- * Creates a new AxiosService instance with custom headers.
- *
- * @param {CustomAxiosConfig} config - An object containing the base URL and optional custom headers.
- * @param {string} config.baseURL - The base URL for the Axios instance.
- * @param {Record<string, string>} [config.headers] - Custom headers to set (optional).
- *
- * @returns {AxiosService} The new AxiosService instance.
- */
-const createCustomAxiosInstance = (config) => {
-    return new AxiosService({
-        baseURL: config.baseURL,
-        headers: config.headers,
-    }).getAxiosInstance();
-};
-
 /**
  * Converts a Proxy object to a plain object.
  * @param {ProxyConstructor} proxy The Proxy object to convert.
@@ -1317,142 +1329,83 @@ 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.`);
-            }
-            if (!refreshToken || typeof refreshToken !== "string") {
-                throw new Error(`LOGIN_ERROR: Refresh token not found or invalid at path '${refreshTokenPath}' in response.`);
-            }
-            configSession({
-                persistencePreference: persistence,
-            });
-            await storeAuthToken(accessToken, secretKey, persistence);
-            await storeAuthRefreshToken(refreshToken, secretKey, persistence);
-            return data;
-        }
-        catch (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.");
-            }
-            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.");
-            }
-            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 (!refreshTokenAfterRefresh ||
-                typeof refreshTokenAfterRefresh !== "string") {
-                throw new Error(`REFRESH_ERROR: Refresh token not found or invalid at path '${refreshTokenPath}' in refresh response.`);
-            }
-            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,
-    };
-}
+        throw error;
+    }
+};
 
 class AxiosService {
     instance;
     cancelTokenSource;
     activeRequests = 0;
     refreshTokenUrl;
-    auth = useAuth();
     isRefreshing = false;
     failedQueue = [];
     constructor(options) {
@@ -1487,12 +1440,9 @@ class AxiosService {
             config.headers.Authorization = `Bearer ${token}`;
         }
     }
-    async getLatestAuthToken() {
-        return await getAuthToken(getAppKey(), "any");
-    }
     initializeInterceptors() {
         this.instance.interceptors.request.use(async (config) => {
-            const token = await this.getLatestAuthToken();
+            const token = await getAuthToken(getAppKey(), "any");
             if (token) {
                 this.setAuthHeader(config, token);
             }
@@ -1535,8 +1485,8 @@ class AxiosService {
             this.isRefreshing = true;
             originalRequest._retry = true;
             try {
-                await this.auth.refresh();
-                const newToken = await this.getLatestAuthToken();
+                await refreshTokens(this.instance);
+                const newToken = await getAuthToken(getAppKey(), "any");
                 if (newToken) {
                     this.processQueue(null, newToken);
                     this.setAuthHeader(originalRequest, newToken);
@@ -1575,6 +1525,22 @@ class AxiosService {
     }
 }
 
+let axiosServiceInstance;
+const configAxios = (config) => {
+    axiosServiceInstance = new AxiosService({
+        baseURL: config.baseURL,
+        headers: config.headers,
+        timeout: config.timeout,
+        withCredentials: config.withCredentials
+    });
+};
+const getConfiguredAxiosInstance = () => {
+    if (!axiosServiceInstance) {
+        throw new Error("Axios instance not configured. Call configAxios first.");
+    }
+    return axiosServiceInstance.getAxiosInstance();
+};
+
 /**
  * Creates and downloads a file from Blob data.
  * @param {Blob} blob The Blob containing the file data.
@@ -2960,7 +2926,7 @@ class RestStd {
     static resource;
     static isFormData = false;
     static headers = {};
-    static fetchComposable;
+    static fetchFn;
     /**
      * Set global headers for all requests.
      * @param headers Object containing headers to be set globally.
@@ -2984,12 +2950,12 @@ class RestStd {
      * Fetch a list of items from the server.
      *
      * @param params Query parameters for filtering the results.
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function (typically a promise).
      */
     static getAll(params, options = {}) {
-        return this.fetchComposable({
-            method: 'GET',
+        return this.fetchFn({
+            method: "GET",
             url: this.resource,
             params,
             headers: this.headers,
@@ -3000,12 +2966,12 @@ class RestStd {
      *
      * @param id The ID of the item to fetch.
      * @param params Additional query parameters for the request.
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function (typically a promise).
      */
     static getOne(id, params, options = {}) {
-        return this.fetchComposable({
-            method: 'GET',
+        return this.fetchFn({
+            method: "GET",
             url: `${this.resource}/${id}`,
             params,
             headers: this.headers,
@@ -3015,18 +2981,43 @@ class RestStd {
      * Create a new item on the server.
      *
      * @param data The data for the new item to create.
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function (typically a promise).
      */
     static create(data, options = {}) {
         const transformedData = this.transformData(data);
-        return this.fetchComposable({
-            method: 'POST',
+        return this.fetchFn({
+            method: "POST",
             url: this.resource,
             data: transformedData,
             headers: {
                 ...this.headers,
-                'Content-Type': this.isFormData ? ContentTypeEnum.FORM_DATA : ContentTypeEnum.JSON,
+                "Content-Type": this.isFormData
+                    ? ContentTypeEnum.FORM_DATA
+                    : ContentTypeEnum.JSON,
+            },
+        }, options);
+    }
+    /**
+     * Create multiple new items on the server.
+     *
+     * @param data An array of data for the items to create.
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function.
+     */
+    static bulkCreate(data, options = {}) {
+        const transformedData = this.isFormData
+            ? data.map((item) => this.transformData(item))
+            : data;
+        return this.fetchFn({
+            method: "POST",
+            url: `${this.resource}/bulk`,
+            data: transformedData,
+            headers: {
+                ...this.headers,
+                "Content-Type": this.isFormData
+                    ? ContentTypeEnum.FORM_DATA
+                    : ContentTypeEnum.JSON,
             },
         }, options);
     }
@@ -3035,18 +3026,43 @@ class RestStd {
      *
      * @param id The ID of the item to update.
      * @param data The updated data for the item.
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function (typically a promise).
      */
     static update(id, data, options = {}) {
         const transformedData = this.transformData(data);
-        return this.fetchComposable({
-            method: 'PUT',
+        return this.fetchFn({
+            method: "PUT",
             url: `${this.resource}/${id}`,
             data: transformedData,
             headers: {
                 ...this.headers,
-                'Content-Type': this.isFormData ? ContentTypeEnum.FORM_DATA : ContentTypeEnum.JSON,
+                "Content-Type": this.isFormData
+                    ? ContentTypeEnum.FORM_DATA
+                    : ContentTypeEnum.JSON,
+            },
+        }, options);
+    }
+    /**
+     * Update multiple existing items on the server.
+     *
+     * @param data An array of data for the items to update (each object should have an ID).
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function.
+     */
+    static bulkUpdate(data, options = {}) {
+        const transformedData = this.isFormData
+            ? data.map((item) => this.transformData(item))
+            : data;
+        return this.fetchFn({
+            method: "PUT",
+            url: `${this.resource}/bulk`,
+            data: transformedData,
+            headers: {
+                ...this.headers,
+                "Content-Type": this.isFormData
+                    ? ContentTypeEnum.FORM_DATA
+                    : ContentTypeEnum.JSON,
             },
         }, options);
     }
@@ -3055,18 +3071,20 @@ class RestStd {
      *
      * @param id The ID of the item to update.
      * @param data The updated data for the item.
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function (typically a promise).
      */
     static patch(id, data, options = {}) {
         const transformedData = this.transformData(data);
-        return this.fetchComposable({
-            method: 'PATCH',
+        return this.fetchFn({
+            method: "PATCH",
             url: `${this.resource}/${id}`,
             data: transformedData,
             headers: {
                 ...this.headers,
-                'Content-Type': this.isFormData ? ContentTypeEnum.FORM_DATA : ContentTypeEnum.JSON,
+                "Content-Type": this.isFormData
+                    ? ContentTypeEnum.FORM_DATA
+                    : ContentTypeEnum.JSON,
             },
         }, options);
     }
@@ -3074,47 +3092,39 @@ class RestStd {
      * Delete an item from the server.
      *
      * @param id The ID of the item to delete.
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function (typically a promise).
      */
     static delete(id, options = {}) {
-        return this.fetchComposable({
-            method: 'DELETE',
+        return this.fetchFn({
+            method: "DELETE",
             url: `${this.resource}/${id}`,
             headers: this.headers,
         }, options);
     }
     /**
-     * Custom request method for more flexibility.
+     * Delete multiple items from the server by their IDs.
      *
-     * @param method HTTP method (GET, POST, etc.).
-     * @param params Query parameters.
-     * @param data Request body data.
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
+     * @param ids An array of IDs of the items to delete.
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function.
      */
-    static customRequest(method, params, data, options = {}) {
-        const transformedData = this.transformData(data);
-        return this.fetchComposable({
-            method: method,
-            url: this.resource,
-            params: params,
-            data: transformedData,
-            headers: {
-                ...this.headers,
-                'Content-Type': this.isFormData ? ContentTypeEnum.FORM_DATA : ContentTypeEnum.JSON,
-            },
+    static bulkDelete(ids, options = {}) {
+        return this.fetchFn({
+            method: "DELETE",
+            url: `${this.resource}/bulk`,
+            data: { ids },
+            headers: this.headers,
         }, options);
     }
     /**
-     * Save method that decides whether to create or update based on the presence of 'id'.
-     * It calls either create or update based on the data.
+     * Upsert method that decides whether to create or update based on the presence of 'id'.
      *
      * @param data The data for the item to create or update.
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function (typically a promise).
      */
-    static save(data, options = {}) {
+    static upsert(data, options = {}) {
         if (data.id) {
             return this.update(data.id, data, options);
         }
@@ -3122,6 +3132,31 @@ class RestStd {
             return this.create(data, options);
         }
     }
+    /**
+     * Custom request method for more flexibility.
+     *
+     * @param method HTTP method (GET, POST, etc.).
+     * @param url The custom URL for the request.
+     * @param params Query parameters.
+     * @param data Request body data.
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function (typically a promise).
+     */
+    static customRequest(method, url, params, data, options = {}) {
+        const transformedData = this.transformData(data);
+        return this.fetchFn({
+            method: method,
+            url: url,
+            params: params,
+            data: transformedData,
+            headers: {
+                ...this.headers,
+                "Content-Type": this.isFormData
+                    ? ContentTypeEnum.FORM_DATA
+                    : ContentTypeEnum.JSON,
+            },
+        }, options);
+    }
 }
 
 /**
@@ -3141,15 +3176,15 @@ async function axiosFetch(axios, axiosRequest) {
 }
 
 /**
- * Creates a fetchComposable for Axios requests with an optional custom instance.
- * @param fetchComposable - The composable to use for the request (can be any fetch function).
+ * Creates a fetchFn for Axios requests with an optional custom instance.
+ * @param fetchComposable - The fn to use for the request (can be any fetch function).
  * @param axiosCustomInstance - An optional custom Axios instance to use for the request.
- * @returns A function that handles the request using the provided composable.
+ * @returns A function that handles the request using the provided fn.
  */
-function createFetch(fetchComposable, axiosCustomInstance) {
-    const instance = axiosCustomInstance || getAxiosInstance();
+function useFetch(fetchFn, axiosCustomInstance) {
+    const instance = axiosCustomInstance || getConfiguredAxiosInstance();
     return (axiosRequestConfig, options) => {
-        return fetchComposable(instance, axiosRequestConfig, options);
+        return fetchFn(instance, axiosRequestConfig, options);
     };
 }
 
@@ -3507,6 +3542,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.
@@ -3529,17 +3624,28 @@ const ArexVueCore = {
         });
         configTokenKeys({
             accessTokenKey: options.tokenKeys.accessToken,
-            refreshTokenKey: options.tokenKeys.refreshToken
+            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.apiUrl,
+            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, 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, useFetch, useFilter, usePagination, useSorter, useVueQuery, validateAlphanumeric, validateLetters, validateNumbers, verifyAuth };

package/dist/rest/RestStd.d.ts

@@ -2,7 +2,7 @@ export declare class RestStd {
     static resource: string;
     static isFormData: boolean;
     static headers: Record<string, string>;
-    static fetchComposable: Function;
+    static fetchFn: Function;
     /**
      * Set global headers for all requests.
      * @param headers Object containing headers to be set globally.
@@ -18,8 +18,8 @@ export declare class RestStd {
      * Fetch a list of items from the server.
      *
      * @param params Query parameters for filtering the results.
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function (typically a promise).
      */
     static getAll<T>(params?: Record<string, any>, options?: object): any;
     /**
@@ -27,61 +27,85 @@ export declare class RestStd {
      *
      * @param id The ID of the item to fetch.
      * @param params Additional query parameters for the request.
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function (typically a promise).
      */
     static getOne<T>(id: string | number, params?: Record<string, any>, options?: object): any;
     /**
      * Create a new item on the server.
      *
      * @param data The data for the new item to create.
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function (typically a promise).
      */
     static create<T>(data: any, options?: object): any;
+    /**
+     * Create multiple new items on the server.
+     *
+     * @param data An array of data for the items to create.
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function.
+     */
+    static bulkCreate<T>(data: any[], options?: object): any;
     /**
      * Update an existing item on the server.
      *
      * @param id The ID of the item to update.
      * @param data The updated data for the item.
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function (typically a promise).
      */
     static update<T>(id: string | number, data: any, options?: object): any;
+    /**
+     * Update multiple existing items on the server.
+     *
+     * @param data An array of data for the items to update (each object should have an ID).
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function.
+     */
+    static bulkUpdate<T>(data: any[], options?: object): any;
     /**
      * Partially update an existing item on the server.
      *
      * @param id The ID of the item to update.
      * @param data The updated data for the item.
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function (typically a promise).
      */
     static patch<T>(id: string | number, data: any, options?: object): any;
     /**
      * Delete an item from the server.
      *
      * @param id The ID of the item to delete.
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function (typically a promise).
      */
     static delete<T>(id: string | number, options?: object): any;
     /**
-     * Custom request method for more flexibility.
+     * Delete multiple items from the server by their IDs.
      *
-     * @param method HTTP method (GET, POST, etc.).
-     * @param params Query parameters.
-     * @param data Request body data.
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
+     * @param ids An array of IDs of the items to delete.
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function.
      */
-    static customRequest<T>(method: string, params?: Record<string, any>, data?: any, options?: object): any;
+    static bulkDelete<T>(ids: (string | number)[], options?: object): any;
     /**
-     * Save method that decides whether to create or update based on the presence of 'id'.
-     * It calls either create or update based on the data.
+     * Upsert method that decides whether to create or update based on the presence of 'id'.
      *
      * @param data The data for the item to create or update.
-     * @param options Additional options for the fetch composable.
-     * @returns The result of the fetch composable (typically a promise).
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function (typically a promise).
+     */
+    static upsert<T>(data: any, options?: object): any;
+    /**
+     * Custom request method for more flexibility.
+     *
+     * @param method HTTP method (GET, POST, etc.).
+     * @param url The custom URL for the request.
+     * @param params Query parameters.
+     * @param data Request body data.
+     * @param options Additional options for the fetch function.
+     * @returns The result of the fetch function (typically a promise).
      */
-    static save<T>(data: any, options?: object): any;
+    static customRequest<T>(method: string, url: string, params?: Record<string, any>, data?: any, options?: object): any;
 }

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.39",
+  "version": "1.1.41",
   "description": "Opinionated Vue Core",
   "main": "dist/index.js",
   "module": "dist/index.mjs",