import { type FileSystem } from "../platform/compat/fs.js";
/**
 * Safely write a cache file: mkdir parent dir → write file → verify file exists.
 *
 * Throws on write failure (after logging context). Returns `false` if the parent
 * directory was removed concurrently (cache cleanup race), which callers should
 * treat as a skippable condition.
 */
export declare function writeCacheFile(fs: FileSystem, path: string, content: string, label?: string): Promise<boolean>;
/**
 * Verify a cache file exists before attempting dynamic import.
 * Returns true if the file exists and is a regular file, false when the path
 * is genuinely absent or is not a regular file. Non-absence stat failures
 * (EACCES, EIO, ...) are
 * rethrown so callers do not misreport an unreadable cache as a cache miss
 * and loop forever re-transforming the same module.
 */
export declare function verifyCacheFileExists(fs: FileSystem, path: string, label?: string): Promise<boolean>;
/**
 * Check if a write error is caused by a concurrent cache cleanup race
 * (directory removed between mkdir and write).
 */
export declare function isCacheWriteRaceError(error: unknown): boolean;
//# sourceMappingURL=cache-file-ops.d.ts.map