/**
 * Builds a storage key from a prefix, optional namespace and key.
 *
 * @example
 * ```ts
 * createKey('app', 'token', 'auth'); // 'app/auth/token'
 * ```
 */
declare const createKey: (prefix: string, key: string, namespace?: string) => string;

type StorageType = 'session' | 'local';

interface SetToStorageConfig<V> extends Omit<GetFromStorageConfig<V>, 'fallback'> {
    value: V;
}
interface UnsetFromStorageConfig extends Omit<GetFromStorageConfig<any>, 'fallback'> {
}
interface GetFromStorageConfig<V> {
    /**
     * Storage key used to retrieve the value.
     * The full key is extended with the project namespace.
     */
    key: string;
    /**
     * Storage type.
     */
    type: StorageType;
    /**
     * Default value used when there is no value in storage.
     */
    fallback?: V;
    /**
     * Optional namespace segment used in the generated key.
     */
    namespace?: string;
    /**
     * Optional key prefix.
     */
    prefix?: string;
}
type SetToStorageWrappedConfig<V, BaseConfig extends StorageConfigBase> = Omit<SetToStorageConfig<V>, Extract<keyof SetToStorageConfig<V>, keyof BaseConfig>> & Partial<Pick<SetToStorageConfig<V>, Extract<keyof SetToStorageConfig<V>, keyof BaseConfig>>> & Pick<BaseConfig, Exclude<keyof BaseConfig, keyof SetToStorageConfig<V>>>;
type UnsetFromStorageWrappedConfig<BaseConfig extends StorageConfigBase> = Omit<UnsetFromStorageConfig, Extract<keyof UnsetFromStorageConfig, keyof BaseConfig>> & Partial<Pick<UnsetFromStorageConfig, Extract<keyof UnsetFromStorageConfig, keyof BaseConfig>>> & Pick<BaseConfig, Exclude<keyof BaseConfig, keyof UnsetFromStorageConfig>>;
type GetFromStorageWrappedConfig<V, BaseConfig extends StorageConfigBase> = Omit<GetFromStorageConfig<V>, Extract<keyof GetFromStorageConfig<V>, keyof BaseConfig>> & Partial<Pick<GetFromStorageConfig<V>, Extract<keyof GetFromStorageConfig<V>, keyof BaseConfig>>> & Pick<BaseConfig, Exclude<keyof BaseConfig, keyof GetFromStorageConfig<V>>>;
type StorageConfigBase = Partial<Pick<GetFromStorageConfig<any>, 'prefix' | 'type'>>;
interface StorageApi<BaseConfig extends StorageConfigBase> {
    set<Value>(config: SetToStorageWrappedConfig<Value, BaseConfig>): void;
    unset(config: UnsetFromStorageWrappedConfig<BaseConfig>): void;
    get<Value>(config: GetFromStorageWrappedConfig<Value, BaseConfig>): Value | null;
}
/**
 * Creates an interface for working with storage (`localStorage`, `sessionStorage`).
 */
declare function createStorage<BaseConfig extends StorageConfigBase>(storageConfig: BaseConfig): StorageApi<BaseConfig>;

export { createKey, createStorage };
export type { GetFromStorageConfig, GetFromStorageWrappedConfig, SetToStorageConfig, SetToStorageWrappedConfig, StorageApi, StorageConfigBase, StorageType, UnsetFromStorageConfig, UnsetFromStorageWrappedConfig };