import type { ResolvedConfig } from "../shared/config.js";
import { BackendError } from "../lib/backend.js";
/** The mint response. Its key set is the cross-repo pin (contract table 2.11). */
export interface MintedPreview {
    sessionId: string;
    /** Full `https://<label>.<apex>` — SERVER-COMPUTED, never assembled here. */
    url: string;
    /** `wss://…/tunnel` — server-computed for the same reason. */
    edgeUrl: string;
    /** An opaque JWS. Never parsed, never printed. */
    grant: string;
    heartbeatSec: number;
    /** ISO8601, the hard max. */
    expiresAt: string;
}
export interface HeartbeatResult {
    state: string;
    viewerCount: number;
    expiresAt: string;
}
/** The mint rate limit (§2.16). `retryAfterSec` comes from the header, never the body. */
export declare class PreviewRateLimitedError extends BackendError {
    readonly retryAfterSec: number;
    constructor(retryAfterSec: number);
}
/** A preview already exists for this working tree and the mint lost the race. */
export declare class PreviewConflictError extends BackendError {
    constructor(message: string);
}
/**
 * The session is gone — `preview_session_ended`, the CLI's terminal branch.
 *
 * `endReason` is the DISCRIMINATOR the five ending screens need, and it is
 * `undefined` against the API as built: every terminal cause answers this route
 * with a byte-identical body (`{"code":"preview_session_ended","message":"this
 * preview has ended"}`), verified against the running stack with an `abandoned`
 * row and an `expired` row. QA-F3-09 names that exact condition — "if the wire
 * carried one undifferentiated 'ended', the designer's spec would be unbuildable
 * and that is a fork, not a test failure".
 *
 * It is read here anyway so the client half is complete and the seam is one
 * field: the day the API adds `endReason` to the 410 body, the abandoned and
 * hard-max screens separate with no further client change.
 */
export declare class PreviewEndedError extends BackendError {
    readonly endReason?: string | undefined;
    constructor(message: string, endReason?: string | undefined);
}
/**
 * workingTreeKey is sha256 of the REALPATH of the project root, and the raw path
 * NEVER leaves the machine: it is a filesystem-layout disclosure with zero
 * platform value, and the one legitimate use (the one-session-per-tree supersede
 * rule) only needs a stable opaque key.
 *
 * realpath, not the literal argument, so `.`, a relative path and a symlink into
 * the same tree all produce ONE key — otherwise "one preview per working tree"
 * would be one preview per spelling of the path.
 */
export declare function workingTreeKey(projectRoot: string): Promise<string>;
/**
 * parseRetryAfter reads the 429's header. The BODY carries no discriminator for
 * which of the two mint limits fired — the header answers "how long", never
 * "which" — so a missing or unparseable value falls back to a minute rather than
 * inventing a number the copy would then state as fact.
 */
export declare function parseRetryAfter(raw: string | null): number;
/** POST /projects/{id}/preview-sessions — mint. */
export declare function mintPreviewSession(cfg: ResolvedConfig, projectId: string, key: string, fetchImpl?: typeof fetch): Promise<MintedPreview>;
/**
 * parseMint refuses a response missing any field the CLI depends on rather than
 * defaulting one. A defaulted `url` is a blank line where the creator expects the
 * link; a defaulted `edgeUrl` is a tunnel dialed at the wrong host. f2's
 * `parseProjectView` dropped its legacy tolerance for the same reason.
 */
export declare function parseMint(raw: unknown): MintedPreview;
/** POST /preview-sessions/{id}/heartbeat — keepalive AND re-authorization. */
export declare function heartbeatPreviewSession(cfg: ResolvedConfig, sessionId: string, fetchImpl?: typeof fetch): Promise<HeartbeatResult>;
/**
 * DELETE /preview-sessions/{id} — end. Best-effort and never throws: the creator
 * has already pressed Ctrl-C, and the session's own expiry reaps it regardless.
 * Surfacing a teardown failure would turn a successful stop into an error the
 * creator cannot act on.
 */
export declare function endPreviewSession(cfg: ResolvedConfig, sessionId: string, fetchImpl?: typeof fetch): Promise<void>;