import { type AccessGrant } from "@opengeni/contracts";
import type { ApiRouteDeps, ObjectStorageDependency } from "@opengeni/core";
import { prepareWorkspaceArtifactContent, type PreparedWorkspaceArtifactContent } from "./workspace-artifact-content.js";
type Storage = NonNullable<ObjectStorageDependency>;
export declare const MAX_SITE_SOURCE_BYTES: number;
export declare function validateSiteSource(storage: Storage, key: string, sizeBytes: number): Promise<void>;
export declare function prepareWorkspaceArtifactUpload(deps: ApiRouteDeps, grant: AccessGrant): Promise<{
    uploadId: string;
    html: {
        putUrl: string;
        requiredHeaders: Record<string, string>;
    };
    source: {
        putUrl: string;
        requiredHeaders: Record<string, string>;
    };
    expiresAt: string;
}>;
/** Provider version-pinned reads, without Site SHA checks or full HTML buffering. */
export declare function readArtifactObject(storage: Storage, key: string, expectedHead?: Awaited<ReturnType<NonNullable<Storage["headObject"]>>>): AsyncGenerator<Uint8Array<ArrayBufferLike>, void, unknown>;
type Input = Partial<Parameters<typeof prepareWorkspaceArtifactContent>[2]> & {
    uploadId?: string;
};
export declare function prepareWorkspaceArtifactPublication(deps: ApiRouteDeps, grant: AccessGrant, input: Input): Promise<PreparedWorkspaceArtifactContent & {
    uploadId?: string;
}>;
export declare function workspaceArtifactDownloads(storage: Storage, ref: {
    contentKey: string;
    sourceKey: string | null;
}, audience: "sandbox" | "public"): Promise<{
    html: {
        url: string;
        expiresAt: Date;
    };
    source: {
        url: string;
        expiresAt: Date;
        format: string;
    } | null;
}>;
export {};