/**
 * React hooks for Pub/Sub system
 *
 * @module pubsub/react
 */
import { type FetchResponse } from 'fetchff';
import type { SubscriptionCallback, DefaultResponse } from './index';
import type { ApiError } from '@plyaz/types/api';
/**
 * Hook to subscribe to cache updates
 * Handles cleanup automatically
 *
 * @param key - Cache key to subscribe to
 * @param callback - Function called on cache updates
 * @param enabled - Enable/disable subscription
 *
 * @example
 * ```typescript
 * function LiveData() {
 *   const [data, setData] = useState(null);
 *
 *   useSubscription('/api/live-data', (response) => {
 *     if (response.data) {
 *       setData(response.data);
 *     }
 *   });
 *
 *   return <Display data={data} />;
 * }
 * ```
 */
export declare function useSubscription<T = DefaultResponse>(key: string | null, callback: SubscriptionCallback<T>, enabled?: boolean): void;
/**
 * Subscribe to multiple cache keys at once
 * Useful for dashboards or components that need multiple data sources
 *
 * @param keys - Array of cache keys to subscribe to
 * @param callback - Function called on any cache update
 * @param enabled - Enable/disable all subscriptions
 *
 * @example
 * ```typescript
 * function Dashboard() {
 *   const [metrics, setMetrics] = useState({});
 *
 *   useMultipleSubscriptions(
 *     ['/api/metrics', '/api/alerts', '/api/status'],
 *     (key, response) => {
 *       const dataKey = key.split('/').pop();
 *       setMetrics(prev => ({
 *         ...prev,
 *         [dataKey]: response.data
 *       }));
 *     }
 *   );
 *
 *   return <MetricsDisplay data={metrics} />;
 * }
 * ```
 */
export declare function useMultipleSubscriptions<T = DefaultResponse>(keys: string[], callback: (key: string, response: FetchResponse<T>) => void, enabled?: boolean): void;
/**
 * Hook for optimistic updates with subscription
 * Provides mutate function and subscribes to updates
 *
 * @param key - Cache key
 * @param initialData - Initial data value
 *
 * @example
 * ```typescript
 * function EditableUser({ userId }) {
 *   const { data, mutate, isValidating } = useOptimisticUpdate(
 *     `/api/user/${userId}`,
 *     null
 *   );
 *
 *   const updateName = async (newName) => {
 *     // Optimistic update
 *     mutate({ ...data, name: newName });
 *
 *     // Send to server
 *     await api.updateUser(userId, { name: newName });
 *   };
 *
 *   return (
 *     <input
 *       value={data?.name || ''}
 *       onChange={(e) => updateName(e.target.value)}
 *       disabled={isValidating}
 *     />
 *   );
 * }
 * ```
 */
export declare function useOptimisticUpdate<T = DefaultResponse>(key: string, initialData?: T): {
    data: T | undefined;
    mutate: (data: T | ((current: T | undefined) => T)) => void;
    isValidating: boolean;
    error: ApiError | undefined;
};
/**
 * Hook for real-time data with automatic refresh
 *
 * @param key - Cache key
 * @param refreshInterval - Refresh interval in milliseconds
 * @param enabled - Enable/disable real-time updates
 *
 * @example
 * ```typescript
 * function LiveMetrics() {
 *   const { data, isLoading, error } = useRealTimeData(
 *     '/api/metrics/live',
 *     5000 // Refresh every 5 seconds
 *   );
 *
 *   if (isLoading) return <Spinner />;
 *   if (error) return <Error error={error} />;
 *
 *   return <MetricsChart data={data} />;
 * }
 * ```
 */
export declare function useRealTimeData<T = DefaultResponse, ValueGiven = string | number | boolean, AllowedValues = Record<string, string>, Constraints = Record<string, string>, TError = ApiError<ValueGiven, AllowedValues, Constraints>>(key: string, refreshInterval?: number, enabled?: boolean): {
    data: T | undefined;
    isLoading: boolean;
    error: TError | undefined;
    refresh: () => void;
};
/**
 * Hook for subscription with debounced callback
 * Useful for reducing update frequency
 *
 * @param key - Cache key
 * @param callback - Debounced callback
 * @param delay - Debounce delay in milliseconds
 *
 * @example
 * ```typescript
 * function SearchResults() {
 *   const [results, setResults] = useState([]);
 *
 *   // Only update UI after 300ms of no changes
 *   useDebouncedSubscription(
 *     '/api/search/results',
 *     (response) => {
 *       setResults(response.data || []);
 *     },
 *     300
 *   );
 *
 *   return <ResultsList results={results} />;
 * }
 * ```
 */
export declare function useDebouncedSubscription<T = DefaultResponse>(key: string | null, callback: SubscriptionCallback<T>, delay?: number): void;
/**
 * Hook for conditional subscription based on a condition
 *
 * @param key - Cache key
 * @param callback - Subscription callback
 * @param condition - Condition function or boolean
 *
 * @example
 * ```typescript
 * function ConditionalData({ shouldFetch }) {
 *   const [data, setData] = useState(null);
 *
 *   useConditionalSubscription(
 *     '/api/conditional-data',
 *     (response) => setData(response.data),
 *     shouldFetch // Only subscribe when true
 *   );
 *
 *   return data ? <DataView data={data} /> : <Empty />;
 * }
 * ```
 */
export declare function useConditionalSubscription<T = DefaultResponse>(key: string | null, callback: SubscriptionCallback<T>, condition?: boolean | (() => boolean)): void;
/**
 * Hook to track subscription state
 *
 * @param key - Cache key
 * @returns Subscription state
 *
 * @example
 * ```typescript
 * function DataComponent() {
 *   const { data, error, isValidating, isSubscribed } = useSubscriptionState(
 *     '/api/data'
 *   );
 *
 *   return (
 *     <div>
 *       {isSubscribed && <Badge>Live</Badge>}
 *       {isValidating && <Spinner />}
 *       {error && <Error error={error} />}
 *       {data && <DataView data={data} />}
 *     </div>
 *   );
 * }
 * ```
 */
export declare function useSubscriptionState<T = DefaultResponse, ValueGiven = string | number | boolean, AllowedValues = Record<string, string>, Constraints = Record<string, string>, TError = ApiError<ValueGiven, AllowedValues, Constraints>>(key: string | null): {
    data: T | undefined;
    error: TError | undefined;
    isValidating: boolean;
    isLoading: boolean;
    isSubscribed: boolean;
};
//# sourceMappingURL=react.d.ts.map