import type { SafeEnvironment } from './client.js';
/** Default upload fileName when only MIME type is known. */
export declare function defaultFileNameForMime(mimeType: string): string;
export interface AssetSummary {
    id: string;
    title: string;
    description?: string;
    fileName: string;
    contentType: string;
    url: string;
    width?: number;
    height?: number;
    size?: number;
}
export interface BacklinkSummary {
    entryId: string;
    contentType: string;
    label: string;
}
/**
 * Returns entries that reference the given asset ID.
 */
export declare function getAssetBacklinks(env: SafeEnvironment, assetId: string, locale: string): Promise<BacklinkSummary[]>;
/**
 * Fetches a single asset by ID and returns a summary.
 */
export declare function getAssetSummary(env: SafeEnvironment, assetId: string): Promise<AssetSummary | null>;
export interface GetAssetSummariesOptions {
    /** Called when a batch CMA request fails and per-ID fallback is used. */
    onWarning?: (message: string) => void;
}
/** Batch-fetch asset summaries by ID (one CMA request per 100 IDs). */
export declare function getAssetSummaries(env: SafeEnvironment, assetIds: string[], options?: GetAssetSummariesOptions): Promise<Map<string, AssetSummary>>;
/**
 * Uploads binary content to Contentful as a new draft asset.
 */
export declare function uploadAssetBuffer(env: SafeEnvironment, fileBuffer: Buffer, opts: {
    title?: string;
    description?: string;
    fileName: string;
    mimeType: string;
    locale: string;
}, onProgress?: (msg: string) => void): Promise<AssetSummary>;
/**
 * Uploads a local file to Contentful as a new draft asset.
 * Orchestrates: binary upload → asset creation → CDN processing → polling for URL.
 */
export declare function uploadAssetFile(env: SafeEnvironment, filePath: string, opts: {
    title?: string;
    description?: string;
    locale: string;
    fileName?: string;
}, onProgress?: (msg: string) => void): Promise<AssetSummary>;
//# sourceMappingURL=assets.d.ts.map