@arex95/vue-core 3.0.0 → 3.1.0

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

@@ -1,4 +1,4 @@
-import { AxiosServiceOptions } from "@/types/AxiosServiceOptions";
+import { AxiosServiceOptions } from "../../types/AxiosServiceOptions";
 import { AxiosInstance } from "axios";
 /**
  * Configures the singleton Axios service instance for the application.

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

@@ -1994,9 +1994,8 @@ const configAxios = (config) => {
         timeout: config.timeout,
         withCredentials: config.withCredentials
     });
-    // Configure auth fetcher factory to avoid circular dependency
-    const { setDefaultAuthFetcherFactory } = require("@/config/auth/authFetcher");
-    const { createAxiosFetcher } = require("@/fetchers/axios");
+    // Configure auth fetcher factory lazily to avoid circular dependency
+    // The factory function is only called when getDefaultAuthFetcher() is invoked
     setDefaultAuthFetcherFactory(() => {
         return createAxiosFetcher(axiosServiceInstance.getAxiosInstance());
     });
@@ -2026,9 +2025,8 @@ const getConfiguredAxiosInstance = () => {
                 withCredentials: false
             });
         }
-        // Configure auth fetcher factory to avoid circular dependency
-        const { setDefaultAuthFetcherFactory } = require("@/config/auth/authFetcher");
-        const { createAxiosFetcher } = require("@/fetchers/axios");
+        // Configure auth fetcher factory lazily to avoid circular dependency
+        // The factory function is only called when getDefaultAuthFetcher() is invoked
         setDefaultAuthFetcherFactory(() => {
             return createAxiosFetcher(axiosServiceInstance.getAxiosInstance());
         });
@@ -3673,18 +3671,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);
     }

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