import fs from "node:fs";
import { ResultAsync } from "neverthrow";
import { z } from "zod";
import type { DataStore } from "../utils/data-store.js";
export declare const mediaDownloaderConfigSchema: z.ZodObject<{
    keys: z.ZodOptional<z.ZodArray<z.ZodString>>;
    mediaPattern: z.ZodDefault<z.ZodCustom<RegExp, RegExp>>;
    matchPath: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
    maxConcurrent: z.ZodDefault<z.ZodInt>;
    ignoreCache: z.ZodDefault<z.ZodBoolean>;
    enableIfModifiedSinceCheck: z.ZodDefault<z.ZodBoolean>;
    enableContentLengthCheck: z.ZodDefault<z.ZodBoolean>;
    forceClearTempFiles: z.ZodDefault<z.ZodBoolean>;
    transformLocalPath: z.ZodOptional<z.ZodFunction<z.ZodTuple<readonly [z.ZodString], null>, z.ZodString>>;
    maxTimeout: z.ZodDefault<z.ZodInt>;
    abortOnError: z.ZodDefault<z.ZodBoolean>;
    updatePaths: z.ZodDefault<z.ZodBoolean>;
}, z.core.$strip>;
type MediaDownloaderConfigWithDefaults = z.infer<typeof mediaDownloaderConfigSchema>;
export declare function localFilePathFromUrl(url: string): string;
export declare function checkCacheStatus(url: string, backupPath: string, abortSignal: AbortSignal, config: Pick<MediaDownloaderConfigWithDefaults, "ignoreCache" | "enableIfModifiedSinceCheck" | "enableContentLengthCheck" | "maxTimeout">): ResultAsync<{
    shouldDownload: boolean;
    existingFile?: undefined;
    stats?: undefined;
} | {
    shouldDownload: boolean;
    existingFile: string;
    stats: fs.Stats;
} | {
    shouldDownload: boolean;
    existingFile: string;
    stats: fs.Stats;
}, FileSystemError | NetworkError>;
export declare function downloadFile(url: string, filePath: string, abortSignal: AbortSignal, config: MediaDownloaderConfigWithDefaults): ResultAsync<void, FileSystemError | NetworkError>;
type MediaDownload = {
    url: string;
    sourceId: string;
    localPath: string;
};
export declare function findMediaUrls(dataStore: DataStore, options: MediaDownloaderConfigWithDefaults, encodeChars: string, queryJsonPaths: string[]): Promise<MediaDownload[]>;
export default function mediaDownloader(config?: z.input<typeof mediaDownloaderConfigSchema>): import("../content-transform.js").ContentTransform;
/**
 * Base error class for MediaDownloader errors
 */
declare class MediaDownloaderError extends Error {
    constructor(message: string, cause?: unknown);
}
declare class FileSystemError extends MediaDownloaderError {
    constructor(message: string, cause?: unknown);
}
declare class NetworkError extends MediaDownloaderError {
    constructor(message: string, cause?: unknown);
}
export {};
//# sourceMappingURL=media-downloader.d.ts.map