import { DexieCloudOptions } from './DexieCloudOptions';
import { DBRealmRole, DexieCloudSchema, AuthProvidersResponse } from 'dexie-cloud-common';
import { UserLogin } from './db/entities/UserLogin';
import { PersistedSyncState } from './db/entities/PersistedSyncState';
import { SyncState } from './types/SyncState';
import { DXCUserInteraction } from './types/DXCUserInteraction';
import { DXCWebSocketStatus } from './DXCWebSocketStatus';
import { PermissionChecker } from './PermissionChecker';
import { DexieCloudSyncOptions } from './DexieCloudSyncOptions';
import { Invite } from './Invite';
import { BehaviorSubject, Observable } from 'rxjs';
/** Progress state for blob downloads */
export interface BlobProgress {
    /** Whether blob downloads are currently in progress */
    isDownloading: boolean;
    /** Number of blobs remaining to download */
    blobsRemaining: number;
    /** Total bytes remaining to download (estimated from BlobRef.$size) */
    bytesRemaining: number;
}
/** The API of db.cloud, where `db` is an instance of Dexie with dexie-cloud-addon active.
 */
export interface LoginHints {
    email?: string;
    userId?: string;
    grant_type?: 'demo' | 'otp';
    otpId?: string;
    otp?: string;
    /** OAuth provider name to initiate OAuth flow (e.g., 'google', 'github') */
    provider?: string;
    /** Dexie Cloud authorization code received from OAuth callback */
    oauthCode?: string;
    /** Optional redirect path (relative or absolute) to use for OAuth redirect URI. */
    redirectPath?: string;
    /**
     * Optional login intent hint.
     *
     * - `"login"`:    Only existing users are accepted. Unknown users always get
     *                 USER_NOT_REGISTERED regardless of the database user policy.
     * - `"register"`: New-user registration is intended. Unknown users that would
     *                 normally get USER_NOT_REGISTERED will instead get
     *                 USER_NOT_ACCEPTED (i.e. the policy blocked them, not the
     *                 fact that registration isn't supported here).
     * - `undefined`:  Default behaviour — the server returns whatever code the
     *                 user policy dictates.
     */
    intent?: 'login' | 'register';
}
export interface DexieCloudAPI {
    version: string;
    options: DexieCloudOptions | null;
    schema: DexieCloudSchema | null;
    currentUserId: string;
    currentUser: BehaviorSubject<UserLogin>;
    webSocketStatus: BehaviorSubject<DXCWebSocketStatus>;
    syncState: BehaviorSubject<SyncState>;
    persistedSyncState: BehaviorSubject<PersistedSyncState | undefined>;
    /** Observable of blob download progress.
     *
     * Shows the current state of background blob downloads (when blobMode='eager')
     * or provides insight into unresolved blobs (when blobMode='lazy').
     *
     * Use this to show progress indicators or "downloading for offline" status.
     */
    blobProgress: Observable<BlobProgress>;
    events: {
        syncComplete: Observable<void>;
    };
    userInteraction: BehaviorSubject<DXCUserInteraction | undefined>;
    invites: Observable<Invite[]>;
    roles: Observable<{
        [roleName: string]: DBRealmRole;
    }>;
    usingServiceWorker?: boolean;
    isServiceWorkerDB?: boolean;
    /** Login using Dexie Cloud OTP or Demo user.
     *
     * @param email Email to authenticate
     * @param userId Optional userId to authenticate
     * @param grant_type requested grant type
     */
    login(hint?: LoginHints): Promise<void>;
    logout(options?: {
        force?: boolean;
    }): Promise<void>;
    /**
     * Connect to given URL
     */
    configure(options: DexieCloudOptions): void;
    /** Trigger a sync
     *
     */
    sync(options?: DexieCloudSyncOptions): Promise<void>;
    /** Method that returns an observable of the available permissions of given
     * entity.
     *
     * @param entity Entity to check permission for
     */
    permissions<T extends {
        owner: string;
        realmId: string;
        table: () => string;
    }>(entity: T): Observable<PermissionChecker<T>>;
    /** Method that returns an observable of the available permissions of given
     * object and table name.
     *
     * @param obj Object retrieved from a dexie query
     * @param table Table name that the object was retrieved from
     */
    permissions<T>(obj: T, table: string): Observable<PermissionChecker<T, string>>;
    /** Query available authentication providers from the server.
     *
     * Returns information about which OAuth providers are configured
     * and whether OTP (email) authentication is enabled.
     *
     * Useful for apps that want to build their own login UI and show
     * provider-specific buttons.
     *
     * @returns Promise resolving to available auth providers
     */
    getAuthProviders(): Promise<AuthProvidersResponse>;
}