import type { GraphQLClient } from '../client.js';
import { type GameHostQuery, type AmIGameHostQuery, type ActorHeartbeatMutation } from '../generated/graphql.js';
/**
 * Game-host election + actor liveness heartbeat — exposed as `client.host`.
 *
 * Targets the **game-api**. The elected host is deterministic across all
 * game-api replicas (the user whose earliest still-connected actor was created
 * first wins). {@link heartbeat} refreshes the caller's actor freshness (keeping
 * them host-eligible) and returns the freshly-elected host in one round-trip —
 * call it on an interval shorter than the server's freshness window.
 * {@link amIHost} is a UI convenience (not authoritative for mutations — use
 * `gameModelInvoke`'s `is_host` policy for that). All require a valid session;
 * `appId` is a `BigInt` decimal string.
 *
 * @throws {CrowdyGraphQLError} `UNAUTHENTICATED` without a session.
 */
export declare class HostAPI {
    private readonly graphql;
    constructor(graphql: GraphQLClient);
    /**
     * Return the single elected host user for an app, or `null` when no actors
     * exist.
     *
     * @param appId - The app to elect the host for.
     * @returns The elected {@link GameHost}, or `null`.
     */
    get(appId: string): Promise<GameHostQuery['gameHost']>;
    /**
     * Return whether the authenticated caller is the currently elected host for
     * the app. Convenience for UI only — not authoritative for server mutations
     * (use `gameModelInvoke`'s `is_host` policy for that).
     *
     * @param appId - The app to check host election for.
     * @returns `true` if the caller is the elected host; otherwise `false`.
     */
    amIHost(appId: string): Promise<AmIGameHostQuery['amIGameHost']>;
    /**
     * Refresh the caller's actor freshness in an app and return the freshly
     * elected host. Returns `null` when no fresh actors exist for the app.
     *
     * @param appId - The app whose actors to keep fresh (and elect the host for).
     * @returns The freshly elected {@link GameHost}, or `null`.
     */
    heartbeat(appId: string): Promise<ActorHeartbeatMutation['actorHeartbeat']>;
}
//# sourceMappingURL=host.d.ts.map