@quickql/react 1.0.0

package/dist/core/src/client.d.ts

@@ -0,0 +1,57 @@
+/**
+ * QuickQL Core Client
+ *
+ * Standard HTTP client for interacting with QuickQL servers across
+ * all JavaScript environments. Handles batching, caching, and plugins.
+ *
+ * (c) 2024-2026 Udinmo Inc. All rights reserved.
+ * Author: Udinmo Inc. <engineering@udinmo.com>
+ * License: MIT
+ */
+import { Query, Mutation, QuickQLRequest, QuickQLResponse, QuickQLError } from './types';
+export interface ClientOptions {
+    endpoint: string;
+    headers?: Record<string, string>;
+    timeout?: number;
+    retry?: number;
+    cacheTTL?: number;
+    plugins?: QuickQLPlugin[];
+}
+export type LifecycleHook = 'beforeRequest' | 'afterResponse' | 'onError';
+export interface QuickQLPlugin {
+    name: string;
+    onBeforeRequest?: (request: QuickQLRequest, context: any) => QuickQLRequest | Promise<QuickQLRequest>;
+    onAfterResponse?: (response: QuickQLResponse, context: any) => QuickQLResponse | Promise<QuickQLResponse>;
+    onError?: (error: QuickQLError, context: any) => void | Promise<void>;
+}
+/**
+ * Universal QuickQL Client for Browser and Node.js
+ */
+export declare class QuickQLClient {
+    private cache;
+    private options;
+    constructor(options: ClientOptions);
+    /**
+     * Main Query operation.
+     */
+    query<T = any>(query: Query, alias?: string): Promise<QuickQLResponse<T>>;
+    /**
+     * Main Mutation operation.
+     */
+    mutation<T = any>(mutation: Mutation, alias?: string): Promise<QuickQLResponse<T>>;
+    /**
+     * Batch multiple queries and mutations.
+     */
+    batch(items: (Query | Mutation)[], transaction?: boolean): Promise<QuickQLResponse<any>>;
+    /**
+     * Low-level execution logic with plugin support.
+     */
+    private execute;
+    private handleError;
+    private getCacheKey;
+    private getFromCache;
+    private setInCache;
+    clearCache(): void;
+    setHeaders(headers: Record<string, string>): void;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/core/src/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../core/src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAC/D,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,MAAM,MAAM,aAAa,GAAG,eAAe,GAAG,eAAe,GAAG,SAAS,CAAC;AAE1E,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,GAAG,KAAK,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACtG,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,GAAG,KAAK,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC1G,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvE;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAqD;IAClE,OAAO,CAAC,OAAO,CAA0B;gBAE7B,OAAO,EAAE,aAAa;IAelC;;OAEG;IACG,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,GAAE,MAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAoBvF;;OAEG;IACG,QAAQ,CAAC,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,GAAE,MAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAWhG;;OAEG;IACG,KAAK,CAAC,KAAK,EAAE,CAAC,KAAK,GAAG,QAAQ,CAAC,EAAE,EAAE,WAAW,UAAQ,GAAG,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;IAS5F;;OAEG;YACW,OAAO;IAgDrB,OAAO,CAAC,WAAW;IAqBnB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,UAAU;IASX,UAAU;IAIV,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAGlD"}

package/dist/core/src/client.js

@@ -0,0 +1,164 @@
+/**
+ * QuickQL Core Client
+ *
+ * Standard HTTP client for interacting with QuickQL servers across
+ * all JavaScript environments. Handles batching, caching, and plugins.
+ *
+ * (c) 2024-2026 Udinmo Inc. All rights reserved.
+ * Author: Udinmo Inc. <engineering@udinmo.com>
+ * License: MIT
+ */
+/**
+ * Universal QuickQL Client for Browser and Node.js
+ */
+export class QuickQLClient {
+    cache = new Map();
+    options;
+    constructor(options) {
+        this.options = {
+            endpoint: options.endpoint,
+            headers: {
+                'Content-Type': 'application/json',
+                'X-QuickQL-Version': '1.0.0',
+                ...(options.headers || {})
+            },
+            timeout: options.timeout || 15000,
+            retry: options.retry || 1,
+            cacheTTL: options.cacheTTL || 0,
+            plugins: options.plugins || []
+        };
+    }
+    /**
+     * Main Query operation.
+     */
+    async query(query, alias = 'data') {
+        const key = this.getCacheKey({ query, alias });
+        const cached = this.getFromCache(key);
+        if (cached)
+            return cached;
+        try {
+            const response = await this.execute({
+                queries: { [alias]: query }
+            });
+            const res = response;
+            if (res.data && !res.errors) {
+                this.setInCache(key, res);
+            }
+            return res;
+        }
+        catch (error) {
+            return this.handleError(error);
+        }
+    }
+    /**
+     * Main Mutation operation.
+     */
+    async mutation(mutation, alias = 'data') {
+        try {
+            const response = await this.execute({
+                mutations: { [alias]: mutation }
+            });
+            return response;
+        }
+        catch (error) {
+            return this.handleError(error);
+        }
+    }
+    /**
+     * Batch multiple queries and mutations.
+     */
+    async batch(items, transaction = false) {
+        try {
+            const response = await this.execute({ batch: items, transaction });
+            return response;
+        }
+        catch (error) {
+            return this.handleError(error);
+        }
+    }
+    /**
+     * Low-level execution logic with plugin support.
+     */
+    async execute(request, retries = this.options.retry) {
+        let currentRequest = request;
+        // Trigger onBeforeRequest hooks
+        for (const plugin of this.options.plugins) {
+            if (plugin.onBeforeRequest) {
+                currentRequest = await plugin.onBeforeRequest(currentRequest, this);
+            }
+        }
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.options.timeout);
+        try {
+            const response = await fetch(this.options.endpoint, {
+                method: 'POST',
+                headers: this.options.headers,
+                body: JSON.stringify(currentRequest),
+                signal: controller.signal
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                throw new Error(`QuickQL Client Error: ${response.status} ${response.statusText}`);
+            }
+            let data = await response.json();
+            // Trigger onAfterResponse hooks
+            for (const plugin of this.options.plugins) {
+                if (plugin.onAfterResponse) {
+                    data = await plugin.onAfterResponse(data, this);
+                }
+            }
+            return data;
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (retries > 0 && error.name !== 'AbortError') {
+                return this.execute(request, retries - 1);
+            }
+            throw error;
+        }
+    }
+    handleError(error) {
+        const isTimeout = error.name === 'AbortError';
+        const quickError = {
+            type: isTimeout ? 'NETWORK' : 'INTERNAL',
+            message: error.message || 'Unknown QuickQL Client error',
+            code: isTimeout ? 'TIMEOUT' : 'CLIENT_EXCEPTION'
+        };
+        // Trigger plugins
+        for (const plugin of this.options.plugins) {
+            if (plugin.onError) {
+                plugin.onError(quickError, this);
+            }
+        }
+        return {
+            data: null,
+            errors: [quickError]
+        };
+    }
+    getCacheKey(request) {
+        return JSON.stringify(request);
+    }
+    getFromCache(key) {
+        const cached = this.cache.get(key);
+        if (cached && cached.expiry > Date.now()) {
+            return cached.value;
+        }
+        this.cache.delete(key);
+        return null;
+    }
+    setInCache(key, value) {
+        if (this.options.cacheTTL > 0) {
+            this.cache.set(key, {
+                value,
+                expiry: Date.now() + this.options.cacheTTL
+            });
+        }
+    }
+    clearCache() {
+        this.cache.clear();
+    }
+    setHeaders(headers) {
+        this.options.headers = { ...this.options.headers, ...headers };
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/core/src/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../../core/src/client.ts"],"names":[],"mappings":"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"}

package/dist/core/src/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * QuickQL Core SDK
+ *
+ * Shared logic and client for the QuickQL ecosystem.
+ * Managed by Udinmo Inc.
+ *
+ * (c) 2024-2026 Udinmo Inc. All rights reserved.
+ * Author: Udinmo Inc. <engineering@udinmo.com>
+ * License: MIT
+ */
+export * from './types';
+export * from './client';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}

package/dist/core/src/index.js

@@ -0,0 +1,13 @@
+/**
+ * QuickQL Core SDK
+ *
+ * Shared logic and client for the QuickQL ecosystem.
+ * Managed by Udinmo Inc.
+ *
+ * (c) 2024-2026 Udinmo Inc. All rights reserved.
+ * Author: Udinmo Inc. <engineering@udinmo.com>
+ * License: MIT
+ */
+export * from './types';
+export * from './client';
+//# sourceMappingURL=index.js.map

package/dist/core/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../core/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}

package/dist/core/src/types.d.ts

@@ -0,0 +1,82 @@
+/**
+ * QuickQL Core Types
+ *
+ * Shared type definitions for queries, mutations, and responses.
+ * Ensured parity between server and client expectations.
+ *
+ * (c) 2024-2026 Udinmo Inc. All rights reserved.
+ * Author: Udinmo Inc. <engineering@udinmo.com>
+ * License: MIT
+ */
+/**
+ * QuickQL Core Types - Refined for Production
+ */
+export type Operator = 'eq' | 'ne' | 'gt' | 'lt' | 'in' | 'contains' | 'startsWith' | 'endsWith';
+export type WhereValue = string | number | boolean | Array<string | number | boolean> | null;
+export type WhereCondition = {
+    [operator in Operator]?: WhereValue;
+} | WhereValue;
+export type LogicalCondition = {
+    AND?: (WhereClause | LogicalCondition)[];
+    OR?: (WhereClause | LogicalCondition)[];
+};
+export type WhereClause = {
+    [field: string]: WhereCondition | LogicalCondition;
+};
+export type IncludeClause = {
+    [relation: string]: Partial<Query>;
+};
+export type OrderDirection = 'asc' | 'desc';
+export type OrderBy = {
+    [field: string]: OrderDirection;
+};
+export interface Query {
+    from: string;
+    select?: string[];
+    alias?: string;
+    where?: WhereClause | LogicalCondition;
+    include?: IncludeClause;
+    limit?: number;
+    offset?: number;
+    orderBy?: OrderBy;
+    aggregate?: {
+        count?: boolean;
+        sum?: string;
+        avg?: string;
+        max?: string;
+        min?: string;
+    };
+    directives?: Record<string, any>;
+}
+export type MutationType = 'create' | 'update' | 'delete';
+export interface Mutation {
+    type: MutationType;
+    collection: string;
+    data?: Record<string, unknown>;
+    where?: WhereClause | LogicalCondition;
+    select?: string[];
+}
+export interface QuickQLRequest {
+    queries?: Record<string, Query>;
+    mutations?: Record<string, Mutation>;
+    batch?: (Query | Mutation)[];
+    transaction?: boolean;
+}
+export interface QuickQLError {
+    type: 'VALIDATION' | 'NETWORK' | 'AUTH' | 'INTERNAL' | 'NOT_FOUND' | 'SECURITY';
+    message: string;
+    code?: string;
+    path?: string[];
+    stack?: string;
+}
+export interface QuickQLResponse<T = unknown> {
+    data: T | null;
+    errors?: QuickQLError[];
+    meta?: {
+        count?: number;
+        total?: number;
+        executionTime?: number;
+        hints?: string[];
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../core/src/types.ts"],"names":[],"mappings":"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"}

package/dist/core/src/types.js

@@ -0,0 +1,12 @@
+/**
+ * QuickQL Core Types
+ *
+ * Shared type definitions for queries, mutations, and responses.
+ * Ensured parity between server and client expectations.
+ *
+ * (c) 2024-2026 Udinmo Inc. All rights reserved.
+ * Author: Udinmo Inc. <engineering@udinmo.com>
+ * License: MIT
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../core/src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/react/src/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * QuickQL React Bindings
+ *
+ * Provides React Hooks (useQuickQL) and Context Providers for seamless
+ * data fetching in React 18/19 and Next.js applications.
+ *
+ * (c) 2024-2026 Udinmo Inc. All rights reserved.
+ * Author: Udinmo Inc. <engineering@udinmo.com>
+ * License: MIT
+ */
+import React from 'react';
+import { QuickQLClient, ClientOptions, Query, QuickQLError } from '@quickql/core';
+export interface QuickQLProviderProps {
+    options?: ClientOptions;
+    client?: QuickQLClient;
+    children: React.ReactNode;
+}
+/**
+ * Universal QuickQL Provider for React Apps
+ */
+export declare const QuickQLProvider: React.FC<QuickQLProviderProps>;
+export declare const useQuickQLClient: () => QuickQLClient;
+export interface UseQuickQLOptions {
+    enabled?: boolean;
+}
+/**
+ * Hook to fetch data using QuickQL queries.
+ */
+export declare function useQuickQL<T = any>(query: Query | null, config?: UseQuickQLOptions): {
+    data: T | null;
+    loading: boolean;
+    error: QuickQLError[] | null;
+    refetch: () => Promise<void>;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/react/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAuF,MAAM,OAAO,CAAC;AAC5G,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,KAAK,EAAmB,YAAY,EAAE,MAAM,eAAe,CAAC;AAQnG,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAY1D,CAAC;AAEF,eAAO,MAAM,gBAAgB,qBAM5B,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,MAAM,GAAE,iBAAsB;;;;;EAiCtF"}

package/dist/react/src/index.js

@@ -0,0 +1,72 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * QuickQL React Bindings
+ *
+ * Provides React Hooks (useQuickQL) and Context Providers for seamless
+ * data fetching in React 18/19 and Next.js applications.
+ *
+ * (c) 2024-2026 Udinmo Inc. All rights reserved.
+ * Author: Udinmo Inc. <engineering@udinmo.com>
+ * License: MIT
+ */
+import { createContext, useContext, useMemo, useState, useEffect, useCallback } from 'react';
+import { QuickQLClient } from '@quickql/core';
+const QuickQLContext = createContext(null);
+/**
+ * Universal QuickQL Provider for React Apps
+ */
+export const QuickQLProvider = ({ options, client, children }) => {
+    const instance = useMemo(() => {
+        if (client)
+            return client;
+        if (options)
+            return new QuickQLClient(options);
+        throw new Error('QuickQLProvider requires either a "client" instance or "options".');
+    }, [client, options?.endpoint]);
+    return (_jsx(QuickQLContext.Provider, { value: { client: instance }, children: children }));
+};
+export const useQuickQLClient = () => {
+    const context = useContext(QuickQLContext);
+    if (!context) {
+        throw new Error('useQuickQLClient must be used within a QuickQLProvider');
+    }
+    return context.client;
+};
+/**
+ * Hook to fetch data using QuickQL queries.
+ */
+export function useQuickQL(query, config = {}) {
+    const client = useQuickQLClient();
+    const [data, setData] = useState(null);
+    const [loading, setLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const queryKey = useMemo(() => JSON.stringify(query), [query]);
+    const fetchData = useCallback(async () => {
+        if (!query)
+            return;
+        setLoading(true);
+        setError(null);
+        try {
+            const response = await client.query(query);
+            if (response.errors) {
+                setError(response.errors);
+            }
+            else {
+                setData(response.data);
+            }
+        }
+        catch (e) {
+            setError([{ type: 'INTERNAL', message: e.message || 'Hook Error' }]);
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [client, queryKey]);
+    useEffect(() => {
+        if (config.enabled !== false && query) {
+            fetchData();
+        }
+    }, [fetchData, config.enabled, queryKey]);
+    return { data, loading, error, refetch: fetchData };
+}
+//# sourceMappingURL=index.js.map

package/dist/react/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "@quickql/react",
+  "version": "1.0.0",
+  "description": "React Hooks and Providers for QuickQL by Udinmo Inc.",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "author": "Udinmo Inc. <engineering@udinmo.com>",
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc"
+  },
+  "dependencies": {
+    "@quickql/core": "^1.0.0"
+  },
+  "peerDependencies": {
+    "react": "^19.x"
+  }
+}

package/src/index.tsx

@@ -0,0 +1,92 @@
+/**
+ * QuickQL React Bindings
+ * 
+ * Provides React Hooks (useQuickQL) and Context Providers for seamless 
+ * data fetching in React 18/19 and Next.js applications.
+ * 
+ * (c) 2024-2026 Udinmo Inc. All rights reserved.
+ * Author: Udinmo Inc. <engineering@udinmo.com>
+ * License: MIT
+ */
+
+import React, { createContext, useContext, useMemo, useState, useEffect, useCallback, useRef } from 'react';
+import { QuickQLClient, ClientOptions, Query, QuickQLResponse, QuickQLError } from '@quickql/core';
+
+interface QuickQLContextValue {
+  client: QuickQLClient;
+}
+
+const QuickQLContext = createContext<QuickQLContextValue | null>(null);
+
+export interface QuickQLProviderProps {
+  options?: ClientOptions;
+  client?: QuickQLClient;
+  children: React.ReactNode;
+}
+
+/**
+ * Universal QuickQL Provider for React Apps
+ */
+export const QuickQLProvider: React.FC<QuickQLProviderProps> = ({ options, client, children }) => {
+  const instance = useMemo(() => {
+    if (client) return client;
+    if (options) return new QuickQLClient(options);
+    throw new Error('QuickQLProvider requires either a "client" instance or "options".');
+  }, [client, options?.endpoint]);
+
+  return (
+    <QuickQLContext.Provider value={{ client: instance }}>
+       {children}
+    </QuickQLContext.Provider>
+  );
+};
+
+export const useQuickQLClient = () => {
+  const context = useContext(QuickQLContext);
+  if (!context) {
+    throw new Error('useQuickQLClient must be used within a QuickQLProvider');
+  }
+  return context.client;
+};
+
+export interface UseQuickQLOptions {
+  enabled?: boolean;
+}
+
+/**
+ * Hook to fetch data using QuickQL queries.
+ */
+export function useQuickQL<T = any>(query: Query | null, config: UseQuickQLOptions = {}) {
+  const client = useQuickQLClient();
+  const [data, setData] = useState<T | null>(null);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState<QuickQLError[] | null>(null);
+
+  const queryKey = useMemo(() => JSON.stringify(query), [query]);
+
+  const fetchData = useCallback(async () => {
+    if (!query) return;
+    setLoading(true);
+    setError(null);
+    try {
+      const response = await client.query<T>(query);
+      if (response.errors) {
+        setError(response.errors);
+      } else {
+        setData(response.data);
+      }
+    } catch (e: any) {
+      setError([{ type: 'INTERNAL', message: e.message || 'Hook Error' }]);
+    } finally {
+      setLoading(false);
+    }
+  }, [client, queryKey]);
+
+  useEffect(() => {
+    if (config.enabled !== false && query) {
+      fetchData();
+    }
+  }, [fetchData, config.enabled, queryKey]);
+
+  return { data, loading, error, refetch: fetchData };
+}

package/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./dist"
+  },
+  "include": ["src"]
+}