import { CueAuth } from './auth';
export type StorageBucket = 'raw' | 'processed';
/**
 * Provides document download URL resolution proxied through the Cue gateway.
 *
 * The returned URLs require an `Authorization: Bearer {token}` header — use
 * `cue.api.getAuthHeaders()` or `cue.auth.authenticatedFetch()` to fetch them.
 * For use in `<img src>` / `<video src>`, convert to a blob URL first:
 * ```ts
 * const response = await cue.auth.authenticatedFetch(url);
 * const objectUrl = URL.createObjectURL(await response.blob());
 * ```
 *
 * @example
 * ```ts
 * const url = cue.storage.getDownloadUrl('my-project', 'abc123', '.pdf');
 * const res  = await cue.auth.authenticatedFetch(url);
 * ```
 */
export declare class CueStorage {
    private readonly _auth;
    private readonly _gatewayUrl;
    constructor(_auth: CueAuth, _gatewayUrl: string);
    /**
     * Returns a gateway download URL for a document stored in Cue.
     *
     * The storage path is `{projectId}/{uuid}{suffix}`, e.g. `my-project/abc-123.pdf`.
     * The returned URL must be fetched with an Authorization header.
     *
     * @param projectId - The Cue project (space) ID.
     * @param uuid - The document UUID.
     * @param suffix - File suffix including the leading dot, e.g. `'.pdf'`, `'.ifc'`.
     * @param bucket - `'raw'` (default, original uploads) or `'processed'` (derived artefacts).
     */
    getDownloadUrl(projectId: string, uuid: string, suffix: string, bucket?: StorageBucket): string;
    /**
     * Returns a gateway download URL for an alternative representation using its
     * full `qcy:remoteRelativePath` stored in the processed bucket.
     *
     * Use this instead of `getDownloadUrl` when the document info was obtained via
     * `fetchAlternativeRepresentations` and carries a `remoteRelativePath`.
     *
     * @param remoteRelativePath - The full path in the processed bucket,
     *   e.g. `{projectId}/fragments/{uuid}.fragments`.
     */
    getAltRepDownloadUrl(remoteRelativePath: string): string;
    /**
     * Fetch a file through the gateway and return it as a Blob.
     * Convenience wrapper around `getDownloadUrl` + `authenticatedFetch`.
     */
    downloadBlob(projectId: string, uuid: string, suffix: string, bucket?: StorageBucket): Promise<Blob>;
}