import { NetworkPriority } from './NetworkConfig';
import { NetworkCore } from './NetworkCore';
import type { AnyStatsigOptions, NetworkConfigCommon } from './StatsigOptionsCommon';
import { StatsigUser } from './StatsigUser';
export type DataSource = 'Uninitialized' | 'Loading' | 'NoValues' | 'Cache' | 'Network' | 'NetworkNotModified' | 'Bootstrap' | 'Prefetch';
export type DataAdapterResult = {
    readonly source: DataSource;
    readonly data: string;
    readonly receivedAt: number;
    readonly stableID: string | null;
    readonly fullUserHash: string | null;
};
export type DataAdapterAsyncOptions = {
    /**
     * The maximum amount of time (in milliseconds) this operation is permitted to run.
     * If the timeout is hit, null is returned but any in-flight requests are kept alive with results going to cache for future updates.
     *
     * Note: If no timeout is given, the {@link NetworkConfigCommon.networkTimeoutMs|StatsigOptions.networkConfig.networkTimeoutMs} is used.
     */
    readonly timeoutMs?: NetworkConfigCommon['networkTimeoutMs'];
    /**
     * The priority that should be applied to the Http request that is fired.
     *
     * @see https://developer.mozilla.org/en-US/docs/Web/API/fetch#priority
     *
     * default: 'auto'
     */
    readonly priority?: NetworkPriority;
};
export type DataAdapterSyncOptions = {
    /**
     * The flag to disable background cache refresh.
     * If set to true, a network request to update the cache for future sessions will not fired.
     * if "explicitly" set to false, a network request to update the cache for future sessions will be fired, even in bootstrap cases.
     *
     * default: implicit false
     */
    readonly disableBackgroundCacheRefresh?: boolean;
};
export declare const DataAdapterCachePrefix = "statsig.cached";
/**
 * Describes a type that is used during intialize/update operations of a Statsig client.
 *
 * See below to find the default adapters, but know that it is possible to create your
 * own StatsigDataAdapter and provide it via `StatsigOptions.dataAdapter`.
 *
 * defaults:
 *
 * - {@link StatsigClient} uses {@link EvaluationsDataAdapter}
 *
 * - {@link StatsigOnDeviceEvalClient} uses {@link SpecsDataAdapter}
 */
type DataAdapterCommon = {
    /**
     * Called when the StatsigDataAdapter is attached to the Statsig client instance during construction.
     * @param {string} sdkKey The SDK key being used by the Statsig client.
     * @param {StatsigOptionsCommon | null} options The StatsigOptions being used by the Statsig client.
     */
    readonly attach: (sdkKey: string, options: AnyStatsigOptions | null, network: NetworkCore) => void;
};
export type EvaluationsDataAdapter = DataAdapterCommon & {
    /**
     * Synchronously get evaluation data for the given user. Called during initializeSync and/or updateUserSync.
     *
     * It is also called during async update operations before StatsigDataAdapter.getDataAsync is called.
     * @param {StatsigUser} user The StatsigUser to get data for.
     * @returns {DataAdapterResult | null} The data that was found for the given StatsigUser.
     */
    readonly getDataSync: (user: StatsigUser) => DataAdapterResult | null;
    /**
     * Asynchronously get evaluation data for the given user. Called during initializeAsync and/or updateUserAsync.
     *
     * @param {DataAdapterResult | null} current The data that was found synchronously (Cache). Will be used as fallback if getDataAsync fails
     * @param {StatsigUser} user The StatsigUser to get data for.
     * @returns {DataAdapterResult | null} The data that was found for the given StatsigUser.
     */
    readonly getDataAsync: (current: DataAdapterResult | null, user: StatsigUser, options?: DataAdapterAsyncOptions) => Promise<DataAdapterResult | null>;
    /**
     * Manually trigger a fetch for new evaluations data for the given user.
     *
     * @param {StatsigUser} user The StatsigUser to get data for.
     */
    readonly prefetchData: (user: StatsigUser, options?: DataAdapterAsyncOptions) => Promise<void>;
    /**
     * Manually set the evaluations data from a JSON string.
     *
     * Statsig Server SDKs supported:
     *  - node-js-server-sdk\@5.20.0
     *  - java-server-sdk\@1.18.0
     *  - python-sdk\@0.32.0
     *  - ruby-sdk\@1.34.0
     *  - dotnet-sdk\@1.25.0
     *  - php-sdk\@3.2.0
     *
     * Note: You can use {@link EvaluationsDataAdapter.setDataLegacy} if your server is running an older Statsig Server SDK.
     */
    readonly setData: (data: string) => void;
    /**
     * Manually set evaluations data for the given user.
     *
     * @param {StatsigUser} user The StatsigUser this data is for.
     *
     * @deprecated This method is provided only to support older versions of Statsig server SDKs.
     *  Newer SDKs include the StatsigUser as part of the data string, and can be used with the {@link EvaluationsDataAdapter.setData} method instead.
     */
    readonly setDataLegacy: (data: string, user: StatsigUser) => void;
};
export type SpecsDataAdapter = DataAdapterCommon & {
    /**
     * Synchronously get specs data. Called during initializeSync and/or updateUserSync.
     * It is also called during async update operations before StatsigDataAdapter.getDataAsync is called.
     * @returns {DataAdapterResult | null} The data that was found for the given StatsigUser.
     */
    readonly getDataSync: () => DataAdapterResult | null;
    /**
     * Asynchronously get specs data. Called during initializeAsync and/or updateUserAsync.
     *
     * @param {DataAdapterResult | null} current The data that was found synchronously (Cache). Will be used as fallback if getDataAsync fails
     * @returns {DataAdapterResult | null} The data that was found for the given StatsigUser.
     */
    readonly getDataAsync: (current: DataAdapterResult | null, options?: DataAdapterAsyncOptions) => Promise<DataAdapterResult | null>;
    /**
     * Manually trigger a fetch for new specs data.
     */
    readonly prefetchData: (options?: DataAdapterAsyncOptions) => Promise<void>;
    /**
     * Manually set specs data (Bootstrap).
     */
    readonly setData: (data: string) => void;
};
export {};