import type { MediaBucket, SavedMedia } from './types.js';
/** Default per-file cap for inbound staging (5 MiB). */
export declare const MEDIA_MAX_BYTES: number;
export declare function ensureMediaDir(): Promise<string>;
export declare function saveMediaBuffer(buffer: Buffer, opts?: {
    contentType?: string;
    bucket?: MediaBucket;
    maxBytes?: number;
    originalFilename?: string;
}): Promise<SavedMedia>;
export declare function resolveMediaBufferPath(id: string, bucket?: MediaBucket): string;
export declare function readMediaBuffer(id: string, bucket?: MediaBucket, maxBytes?: number): Promise<{
    id: string;
    path: string;
    buffer: Buffer;
    size: number;
}>;
export declare function deleteMediaBuffer(id: string, bucket?: MediaBucket): Promise<void>;
export declare function mimeTypeFromMediaPath(filePath: string): string;