import type { ApiRequestOptions } from "@trigger.dev/core/v3";
import { ApiClient } from "@trigger.dev/core/v3";
/**
 * Configuration options for creating an API client instance.
 */
export type UseApiClientOptions = {
    /** Optional access token for authentication */
    accessToken?: string;
    /** Optional base URL for the API endpoints */
    baseURL?: string;
    /** Optional preview branch name for preview environments */
    previewBranch?: string;
    /** Optional additional request configuration */
    requestOptions?: ApiRequestOptions;
    /**
     * Optional callback that mints a fresh access token. Used to reconnect a
     * realtime stream that the server rejected because its token expired.
     */
    refreshAccessToken?: () => Promise<string>;
    /**
     * Enable or disable the API client instance.
     *
     * Set enabled to false if you don't have an accessToken and don't want to throw an error.
     */
    enabled?: boolean;
};
/**
 * Hook to create an API client instance using authentication context or provided options.
 *
 * @param {UseApiClientOptions} [options] - Configuration options for the API client
 * @returns {ApiClient} An initialized API client instance
 * @throws {Error} When no access token is available in either context or options
 *
 * @example
 * ```ts
 * // Using context authentication
 * const apiClient = useApiClient();
 *
 * // Using custom options
 * const apiClient = useApiClient({
 *   accessToken: "your-access-token",
 *   baseURL: "https://api.my-trigger.com",
 *   requestOptions: { retry: { maxAttempts: 10 } }
 * });
 * ```
 */
export declare function useApiClient(options?: UseApiClientOptions): ApiClient | undefined;