@arex95/vue-core 3.0.1 → 3.3.0

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

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

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

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

package/dist/graph/GraphStd.d.ts

@@ -0,0 +1,160 @@
+import { Fetcher } from "@/types/Fetcher";
+import { QueryOptions, MutationOptions, GraphQLResponse } from "@/types/GraphStdOptions";
+import { RetryConfig } from "@/utils/retry";
+/**
+ * A standardized GraphQL class that provides a generic interface for performing
+ * GraphQL queries and mutations. It is designed to be extended directly from your models.
+ *
+ * @example
+ * ```typescript
+ * export class UserGraphQL extends GraphStd {
+ *     static override endpoint = '/graphql';
+ *     static fetchFn = createAxiosFetcher(axiosInstance);
+ * }
+ *
+ * const users = await UserGraphQL.query<{ users: User[] }>({
+ *     query: 'query { users { id name email } }'
+ * });
+ * ```
+ */
+export declare class GraphStd {
+    /**
+     * The GraphQL endpoint. MUST be overridden in subclasses.
+     * @example static override endpoint = '/graphql';
+     */
+    static endpoint: string;
+    /** A record of global headers to be sent with every request. */
+    static headers: Record<string, string>;
+    /** The function used to make the actual HTTP requests. Optional, defaults to Axios fetcher. */
+    static fetchFn?: Fetcher;
+    /** Retry configuration for failed requests. Optional. */
+    static retryConfig?: RetryConfig;
+    /**
+     * Validates that the endpoint property is defined.
+     * @throws {Error} If endpoint is not defined
+     */
+    protected static validateEndpoint(): void;
+    /**
+     * Gets the fetcher function, using default if not provided.
+     * Creates a default Axios fetcher if not configured, allowing lazy initialization.
+     * @returns The fetcher function to use
+     */
+    private static getFetchFn;
+    /**
+     * Executes a GraphQL request with optional retry logic.
+     * @param config - The fetcher configuration
+     * @returns A promise that resolves with the GraphQL response data
+     */
+    private static executeGraphQLRequest;
+    /**
+     * Sets global headers that will be included in all subsequent requests made by this class.
+     * @param headers - An object containing the headers to be set
+     */
+    static setHeaders(headers: Record<string, string>): void;
+    /**
+     * Executes a GraphQL query.
+     * @template TData The expected data type from the query response
+     * @template TVariables The type of variables to pass to the query
+     * @param options - Options including query string, variables, and optional endpoint override
+     * @returns A promise that resolves with the GraphQL response data
+     *
+     * @example
+     * ```typescript
+     * interface User {
+     *   id: string;
+     *   name: string;
+     *   email: string;
+     * }
+     *
+     * interface UsersQueryVariables {
+     *   limit?: number;
+     *   offset?: number;
+     * }
+     *
+     * const response = await UserGraphQL.query<{ users: User[] }, UsersQueryVariables>({
+     *   query: `
+     *     query GetUsers($limit: Int, $offset: Int) {
+     *       users(limit: $limit, offset: $offset) {
+     *         id
+     *         name
+     *         email
+     *       }
+     *     }
+     *   `,
+     *   variables: { limit: 10, offset: 0 }
+     * });
+     *
+     * // Access data: response.data.users
+     * ```
+     */
+    static query<TData = unknown, TVariables extends Record<string, unknown> = Record<string, unknown>>(options: QueryOptions<TVariables>): Promise<GraphQLResponse<TData>>;
+    /**
+     * Executes a GraphQL mutation.
+     * @template TData The expected data type from the mutation response
+     * @template TVariables The type of variables to pass to the mutation
+     * @param options - Options including mutation string, variables, and optional endpoint override
+     * @returns A promise that resolves with the GraphQL response data
+     *
+     * @example
+     * ```typescript
+     * interface CreateUserInput {
+     *   name: string;
+     *   email: string;
+     *   password: string;
+     * }
+     *
+     * interface CreateUserResponse {
+     *   createUser: {
+     *     id: string;
+     *     name: string;
+     *     email: string;
+     *   };
+     * }
+     *
+     * const response = await UserGraphQL.mutation<CreateUserResponse, { input: CreateUserInput }>({
+     *   mutation: `
+     *     mutation CreateUser($input: CreateUserInput!) {
+     *       createUser(input: $input) {
+     *         id
+     *         name
+     *         email
+     *       }
+     *     }
+     *   `,
+     *   variables: {
+     *     input: {
+     *       name: 'John Doe',
+     *       email: 'john@example.com',
+     *       password: 'secret123'
+     *     }
+     *   }
+     * });
+     *
+     * // Access data: response.data.createUser
+     * ```
+     */
+    static mutation<TData = unknown, TVariables extends Record<string, unknown> = Record<string, unknown>>(options: MutationOptions<TVariables>): Promise<GraphQLResponse<TData>>;
+    /**
+     * Executes a raw GraphQL request with full control over the request body.
+     * Useful for advanced use cases like subscriptions (via WebSocket) or custom request formats.
+     * @template TData The expected data type from the response
+     * @template TVariables The type of variables
+     * @param options - Options including query/mutation string, variables, operationName, and optional endpoint
+     * @returns A promise that resolves with the GraphQL response data
+     *
+     * @example
+     * ```typescript
+     * const response = await UserGraphQL.rawRequest<{ user: User }>({
+     *   query: 'query { user(id: "123") { id name } }',
+     *   variables: {},
+     *   operationName: 'GetUser'
+     * });
+     * ```
+     */
+    static rawRequest<TData = unknown, TVariables extends Record<string, unknown> = Record<string, unknown>>(options: {
+        query: string;
+        variables?: TVariables;
+        operationName?: string;
+        url?: string;
+    }): Promise<GraphQLResponse<TData>>;
+}

package/dist/graph/index.d.ts

@@ -0,0 +1 @@
+export * from './GraphStd';

package/dist/index.mjs

@@ -1246,6 +1246,20 @@ function getRefreshTokenPathsConfig() {
     return refreshTokenPathsConfig;
 }
 
+let callbacksConfig = {};
+/**
+ * Configures the lifecycle callbacks for auth events.
+ * @param {CallbacksConfig} config - Callbacks to invoke on refresh failure or logout.
+ */
+const configCallbacks = (config) => {
+    callbacksConfig = { ...config };
+};
+/**
+ * Returns the configured lifecycle callbacks.
+ * @returns {CallbacksConfig}
+ */
+const getCallbacksConfig = () => callbacksConfig;
+
 /**
  * Removes all stored authentication credentials (access and refresh tokens) from the specified storage locations.
  *
@@ -1340,7 +1354,7 @@ const verifyAuth = async () => {
     };
     const token = await getAuthToken(getAppKey(), sessionPersistence);
     if (!token) {
-        return handleAuthError("TOKEN_MISSING: No valid token found");
+        return handleAuthError("TOKEN_MISSING: No valid token found", false);
     }
     try {
         const decoded = jwtDecode(token);
@@ -1349,7 +1363,7 @@ const verifyAuth = async () => {
             return handleAuthError("TOKEN_INVALID: Invalid expiration format");
         }
         if (decoded.exp <= currentTime) {
-            return handleAuthError("TOKEN_EXPIRED: Token is expired");
+            return handleAuthError("TOKEN_EXPIRED: Token is expired", false);
         }
         return true;
     }
@@ -1775,7 +1789,11 @@ const refreshTokens = async (fetcher) => {
     catch (error) {
         handleError(error);
         await cleanCredentials(persistence);
-        if (typeof window !== 'undefined') {
+        const { onRefreshFailed } = getCallbacksConfig();
+        if (onRefreshFailed) {
+            onRefreshFailed();
+        }
+        else if (typeof window !== 'undefined') {
             window.location.reload();
         }
         throw error;
@@ -1853,7 +1871,9 @@ class AxiosService {
             },
             withCredentials: options.withCredentials ?? false,
         });
-        this.initializeInterceptors();
+        if (options.setupAuthInterceptors !== false) {
+            this.initializeInterceptors();
+        }
     }
     processQueue(error, token = null) {
         this.failedQueue.forEach((prom) => {
@@ -1889,6 +1909,9 @@ class AxiosService {
             return response;
         }, async (error) => {
             this.activeRequests--;
+            if (typeof window === 'undefined') {
+                return Promise.reject(error);
+            }
             const originalRequest = error.config;
             const isAuthError = axios.isAxiosError(error) && error.response?.status === 401;
             const isRefreshCall = originalRequest?.url === this.refreshTokenUrl;
@@ -3671,18 +3694,25 @@ class RestStd {
      * Fetches a list of items from the resource's endpoint.
      * @template TResponse The expected response type
      * @template TParams The type of query parameters
-     * @param options - Options including params, options, and optional url override
+     * @template TData The type of request body data
+     * @param options - Options including params, data, and optional url override
      * @returns A promise that resolves with the response data
      */
     static getAll(options = {}) {
         this.validateResource();
-        const { params, url } = options;
+        const { params, data, url } = options;
         const finalUrl = url || this.resource;
+        const hasData = data !== undefined && data !== null;
+        const headers = { ...this.headers };
+        if (hasData) {
+            headers["Content-Type"] = ContentTypeEnum.JSON;
+        }
         const config = {
             method: "GET",
             url: finalUrl,
-            params,
-            headers: this.headers,
+            params: hasData ? undefined : params,
+            data: hasData ? data : undefined,
+            headers,
         };
         return this.executeFetch(config);
     }
@@ -4272,7 +4302,11 @@ function useAuth(fetcher) {
         }
         finally {
             await cleanCredentials(await getSessionPersistence());
-            if (typeof window !== 'undefined') {
+            const { onLogout } = getCallbacksConfig();
+            if (onLogout) {
+                onLogout();
+            }
+            else if (typeof window !== 'undefined') {
                 window.location.reload();
             }
         }
@@ -4399,9 +4433,14 @@ const ArexVueCore = {
             baseURL: options.axios.baseURL,
             headers: options.axios.headers,
             timeout: options.axios.timeout,
-            withCredentials: options.axios.withCredentials
+            withCredentials: options.axios.withCredentials,
+            setupAuthInterceptors: options.axios.setupAuthInterceptors,
+        });
+        configCallbacks({
+            onRefreshFailed: options.onRefreshFailed,
+            onLogout: options.onLogout,
         });
     },
 };
 
-export { AppTypes, ArchiveTypes, ArexVueCore, AudioTypes, AuthError, AxiosService, BaseError, ContentTypeEnum, DocumentTypes, ERROR_MESSAGES, ERROR_STYLES, ErrorEnum, ErrorMessages, ErrorStyles, ExceptionEnum, FontTypes, ImageTypes, KeyCodeEnum, NetworkError, OtherTypes, RestStd, ScreenBreakpoint, ScreenSize, ServerError, StorageKeyEnum, StorageTypeEnum, TextTypes, ValidationError, VideoTypes, ab2hex, addCustomKeyboardShortcut, addDays, addDoubleClickListener, addKeyListener, ageAtDate, axiosFetch, blobToFormData, bufferToBlob, calculateAge, cleanCredentials, clickOutside, compareObject, configAppKey, configAuthFetcher, configAxios, configEndpoints, configRefreshTokenPaths, configSession, configTokenKeys, configTokenPaths, copyToClipboard, countWords, createAxiosFetcher, createKeyMap, createOfetchFetcher, customShortcut, daysBetween, daysToNextBirthday, debounce, debounceAsync, debounceAsyncValidator, debounceAsyncWithImmediate, debounceLeading, debounceLeadingTrailing, debounceTrailing, decrypt, deepClone, deepEqual, deepMerge, detectKeyHold, disableCopy, disableF12Key, disableMouseButtons, disableRightClick, disableSpecificKeys, downloadBlob, enableMouseButtons, enableRightClick, enableSpecificKeys, encrypt, exportToCSV, exportToExcel, exportToJSON, exportToText, exportToXML, extractAndValidateTokens, filterObjectByKeys, flattenObject, formDataToObject, formatDate, generateRandomString, getAppKey, getAuthRefreshToken, getAuthToken, getConfiguredAxiosInstance, getCookieStorage, getDecryptedItem, getDefaultAuthFetcher, getEndOfMonth, getEndpointsConfig, getObjectDifferences, getObjectKeys, getPreferredStorage, getQueryParam, getRefreshTokenPathsConfig, getSessionConfig, getSessionId, getSessionPersistence, getSessionStorage, getStartOfMonth, getStorage, getTokenConfig, getTokenPathsConfig, handleError, hasNestedProperties, hex2ab, importKey, isClient, isEmptyObject, isLeapYear, isServer, isStrongPassword, isValidAge, isValidCreditCard, isValidDate, isValidEmail, isValidExpiryDate, isValidHexColor, isValidHexColorAlpha, isValidHexNumber, isValidIP, isValidPhoneNumber, isValidSSN, isValidTime, isValidURL, isValidUsername, isValidZIP, lowerFirst, objectToFormData, objectToFormDataEnhanced, objectToQueryString, openWindow, parseDate, proxyToPlainObject, readFileAsDataURL, readFileAsText, refreshTokens, registerKeyboardShortcuts, removeAccent, removeClickOutside, removeCustomKeyboardShortcut, removeCustomShortcuts, removeDoubleClickListener, removeEmptyProperties, removeKeyListeners, replaceAll, retryWithBackoff, reverseString, safeGet, screenMap, scrollToTop, setDefaultAuthFetcherFactory, simulateKeyPress, stopDetectingKeyHold, storeAuthRefreshToken, storeAuthToken, storeEncryptedItem, storeTokens, stringToBlob, subtractDays, throttle, toCamelCase, toKebabCase, toggleTabNavigation, truncateString, unregisterKeyboardShortcuts, upperFirst, useAuth, useBreakpoint, useFetch, useFilter, usePagination, useSorter, validateAlphanumeric, validateLetters, validateNumbers, verifyAuth };
+export { AppTypes, ArchiveTypes, ArexVueCore, AudioTypes, AuthError, AxiosService, BaseError, ContentTypeEnum, DocumentTypes, ERROR_MESSAGES, ERROR_STYLES, ErrorEnum, ErrorMessages, ErrorStyles, ExceptionEnum, FontTypes, ImageTypes, KeyCodeEnum, NetworkError, OtherTypes, RestStd, ScreenBreakpoint, ScreenSize, ServerError, StorageKeyEnum, StorageTypeEnum, TextTypes, ValidationError, VideoTypes, ab2hex, addCustomKeyboardShortcut, addDays, addDoubleClickListener, addKeyListener, ageAtDate, axiosFetch, blobToFormData, bufferToBlob, calculateAge, cleanCredentials, clickOutside, compareObject, configAppKey, configAuthFetcher, configAxios, configCallbacks, configEndpoints, configRefreshTokenPaths, configSession, configTokenKeys, configTokenPaths, copyToClipboard, countWords, createAxiosFetcher, createKeyMap, createOfetchFetcher, customShortcut, daysBetween, daysToNextBirthday, debounce, debounceAsync, debounceAsyncValidator, debounceAsyncWithImmediate, debounceLeading, debounceLeadingTrailing, debounceTrailing, decrypt, deepClone, deepEqual, deepMerge, detectKeyHold, disableCopy, disableF12Key, disableMouseButtons, disableRightClick, disableSpecificKeys, downloadBlob, enableMouseButtons, enableRightClick, enableSpecificKeys, encrypt, exportToCSV, exportToExcel, exportToJSON, exportToText, exportToXML, extractAndValidateTokens, filterObjectByKeys, flattenObject, formDataToObject, formatDate, generateRandomString, getAppKey, getAuthRefreshToken, getAuthToken, getCallbacksConfig, getConfiguredAxiosInstance, getCookieStorage, getDecryptedItem, getDefaultAuthFetcher, getEndOfMonth, getEndpointsConfig, getObjectDifferences, getObjectKeys, getPreferredStorage, getQueryParam, getRefreshTokenPathsConfig, getSessionConfig, getSessionId, getSessionPersistence, getSessionStorage, getStartOfMonth, getStorage, getTokenConfig, getTokenPathsConfig, handleError, hasNestedProperties, hex2ab, importKey, isClient, isEmptyObject, isLeapYear, isServer, isStrongPassword, isValidAge, isValidCreditCard, isValidDate, isValidEmail, isValidExpiryDate, isValidHexColor, isValidHexColorAlpha, isValidHexNumber, isValidIP, isValidPhoneNumber, isValidSSN, isValidTime, isValidURL, isValidUsername, isValidZIP, lowerFirst, objectToFormData, objectToFormDataEnhanced, objectToQueryString, openWindow, parseDate, proxyToPlainObject, readFileAsDataURL, readFileAsText, refreshTokens, registerKeyboardShortcuts, removeAccent, removeClickOutside, removeCustomKeyboardShortcut, removeCustomShortcuts, removeDoubleClickListener, removeEmptyProperties, removeKeyListeners, replaceAll, retryWithBackoff, reverseString, safeGet, screenMap, scrollToTop, setDefaultAuthFetcherFactory, simulateKeyPress, stopDetectingKeyHold, storeAuthRefreshToken, storeAuthToken, storeEncryptedItem, storeTokens, stringToBlob, subtractDays, throttle, toCamelCase, toKebabCase, toggleTabNavigation, truncateString, unregisterKeyboardShortcuts, upperFirst, useAuth, useBreakpoint, useFetch, useFilter, usePagination, useSorter, validateAlphanumeric, validateLetters, validateNumbers, verifyAuth };

package/dist/rest/GraphStd.d.ts

@@ -0,0 +1,160 @@
+import { Fetcher } from "@/types/Fetcher";
+import { QueryOptions, MutationOptions, GraphQLResponse } from "@/types/GraphStdOptions";
+import { RetryConfig } from "@/utils/retry";
+/**
+ * A standardized GraphQL class that provides a generic interface for performing
+ * GraphQL queries and mutations. It is designed to be extended directly from your models.
+ *
+ * @example
+ * ```typescript
+ * export class UserGraphQL extends GraphStd {
+ *     static override endpoint = '/graphql';
+ *     static fetchFn = createAxiosFetcher(axiosInstance);
+ * }
+ *
+ * const users = await UserGraphQL.query<{ users: User[] }>({
+ *     query: 'query { users { id name email } }'
+ * });
+ * ```
+ */
+export declare class GraphStd {
+    /**
+     * The GraphQL endpoint. MUST be overridden in subclasses.
+     * @example static override endpoint = '/graphql';
+     */
+    static endpoint: string;
+    /** A record of global headers to be sent with every request. */
+    static headers: Record<string, string>;
+    /** The function used to make the actual HTTP requests. Optional, defaults to Axios fetcher. */
+    static fetchFn?: Fetcher;
+    /** Retry configuration for failed requests. Optional. */
+    static retryConfig?: RetryConfig;
+    /**
+     * Validates that the endpoint property is defined.
+     * @throws {Error} If endpoint is not defined
+     */
+    protected static validateEndpoint(): void;
+    /**
+     * Gets the fetcher function, using default if not provided.
+     * Creates a default Axios fetcher if not configured, allowing lazy initialization.
+     * @returns The fetcher function to use
+     */
+    private static getFetchFn;
+    /**
+     * Executes a GraphQL request with optional retry logic.
+     * @param config - The fetcher configuration
+     * @returns A promise that resolves with the GraphQL response data
+     */
+    private static executeGraphQLRequest;
+    /**
+     * Sets global headers that will be included in all subsequent requests made by this class.
+     * @param headers - An object containing the headers to be set
+     */
+    static setHeaders(headers: Record<string, string>): void;
+    /**
+     * Executes a GraphQL query.
+     * @template TData The expected data type from the query response
+     * @template TVariables The type of variables to pass to the query
+     * @param options - Options including query string, variables, and optional endpoint override
+     * @returns A promise that resolves with the GraphQL response data
+     *
+     * @example
+     * ```typescript
+     * interface User {
+     *   id: string;
+     *   name: string;
+     *   email: string;
+     * }
+     *
+     * interface UsersQueryVariables {
+     *   limit?: number;
+     *   offset?: number;
+     * }
+     *
+     * const response = await UserGraphQL.query<{ users: User[] }, UsersQueryVariables>({
+     *   query: `
+     *     query GetUsers($limit: Int, $offset: Int) {
+     *       users(limit: $limit, offset: $offset) {
+     *         id
+     *         name
+     *         email
+     *       }
+     *     }
+     *   `,
+     *   variables: { limit: 10, offset: 0 }
+     * });
+     *
+     * // Access data: response.data.users
+     * ```
+     */
+    static query<TData = unknown, TVariables extends Record<string, unknown> = Record<string, unknown>>(options: QueryOptions<TVariables>): Promise<GraphQLResponse<TData>>;
+    /**
+     * Executes a GraphQL mutation.
+     * @template TData The expected data type from the mutation response
+     * @template TVariables The type of variables to pass to the mutation
+     * @param options - Options including mutation string, variables, and optional endpoint override
+     * @returns A promise that resolves with the GraphQL response data
+     *
+     * @example
+     * ```typescript
+     * interface CreateUserInput {
+     *   name: string;
+     *   email: string;
+     *   password: string;
+     * }
+     *
+     * interface CreateUserResponse {
+     *   createUser: {
+     *     id: string;
+     *     name: string;
+     *     email: string;
+     *   };
+     * }
+     *
+     * const response = await UserGraphQL.mutation<CreateUserResponse, { input: CreateUserInput }>({
+     *   mutation: `
+     *     mutation CreateUser($input: CreateUserInput!) {
+     *       createUser(input: $input) {
+     *         id
+     *         name
+     *         email
+     *       }
+     *     }
+     *   `,
+     *   variables: {
+     *     input: {
+     *       name: 'John Doe',
+     *       email: 'john@example.com',
+     *       password: 'secret123'
+     *     }
+     *   }
+     * });
+     *
+     * // Access data: response.data.createUser
+     * ```
+     */
+    static mutation<TData = unknown, TVariables extends Record<string, unknown> = Record<string, unknown>>(options: MutationOptions<TVariables>): Promise<GraphQLResponse<TData>>;
+    /**
+     * Executes a raw GraphQL request with full control over the request body.
+     * Useful for advanced use cases like subscriptions (via WebSocket) or custom request formats.
+     * @template TData The expected data type from the response
+     * @template TVariables The type of variables
+     * @param options - Options including query/mutation string, variables, operationName, and optional endpoint
+     * @returns A promise that resolves with the GraphQL response data
+     *
+     * @example
+     * ```typescript
+     * const response = await UserGraphQL.rawRequest<{ user: User }>({
+     *   query: 'query { user(id: "123") { id name } }',
+     *   variables: {},
+     *   operationName: 'GetUser'
+     * });
+     * ```
+     */
+    static rawRequest<TData = unknown, TVariables extends Record<string, unknown> = Record<string, unknown>>(options: {
+        query: string;
+        variables?: TVariables;
+        operationName?: string;
+        url?: string;
+    }): Promise<GraphQLResponse<TData>>;
+}

package/dist/rest/RestStd.d.ts

@@ -69,10 +69,11 @@ export declare class RestStd {
      * Fetches a list of items from the resource's endpoint.
      * @template TResponse The expected response type
      * @template TParams The type of query parameters
-     * @param options - Options including params, options, and optional url override
+     * @template TData The type of request body data
+     * @param options - Options including params, data, and optional url override
      * @returns A promise that resolves with the response data
      */
-    static getAll<TResponse = unknown, TParams extends Record<string, unknown> = Record<string, unknown>>(options?: GetAllOptions<TParams>): Promise<TResponse>;
+    static getAll<TResponse = unknown, TParams extends Record<string, unknown> = Record<string, unknown>, TData = unknown>(options?: GetAllOptions<TParams, TData>): Promise<TResponse>;
     /**
      * Fetches a single item by its ID.
      * @template TResponse The expected response type

package/dist/types/ArexVueCoreOptions.d.ts

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

package/dist/types/AxiosServiceOptions.d.ts

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

package/dist/types/GraphStdOptions.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Options for GraphQL query operations.
+ * @template TVariables The type of variables to pass to the query
+ */
+export interface QueryOptions<TVariables extends Record<string, unknown> = Record<string, unknown>> {
+    /** The GraphQL query string */
+    query: string;
+    /** Variables to pass to the query */
+    variables?: TVariables;
+    /** Operation name (useful when multiple operations are in the query) */
+    operationName?: string;
+    /** Optional custom endpoint URL (overrides the default endpoint) */
+    url?: string;
+}
+/**
+ * Options for GraphQL mutation operations.
+ * @template TVariables The type of variables to pass to the mutation
+ */
+export interface MutationOptions<TVariables extends Record<string, unknown> = Record<string, unknown>> {
+    /** The GraphQL mutation string */
+    mutation: string;
+    /** Variables to pass to the mutation */
+    variables?: TVariables;
+    /** Operation name (useful when multiple operations are in the mutation) */
+    operationName?: string;
+    /** Optional custom endpoint URL (overrides the default endpoint) */
+    url?: string;
+}
+/**
+ * Standard GraphQL response structure.
+ * @template TData The type of the data returned by the query/mutation
+ */
+export interface GraphQLResponse<TData = unknown> {
+    /** The data returned by the GraphQL operation */
+    data?: TData;
+    /** Array of errors if the operation failed */
+    errors?: Array<{
+        message: string;
+        path?: (string | number)[];
+        extensions?: Record<string, unknown>;
+    }>;
+}

package/dist/types/RestStdOptions.d.ts

@@ -1,5 +1,6 @@
-export interface GetAllOptions<TParams extends Record<string, unknown> = Record<string, unknown>> {
+export interface GetAllOptions<TParams extends Record<string, unknown> = Record<string, unknown>, TData = unknown> {
     params?: TParams;
+    data?: TData;
     options?: Record<string, unknown>;
     url?: string;
 }

package/package.json

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