import { Effect } from "effect-app";
import type { Abortable } from "events";
import type { Mode, ObjectEncodingOptions, OpenMode } from "fs";
import fs from "fs/promises";
import type internal from "stream";
export declare function readFile(fileName: string): Effect.Effect<NonSharedBuffer, import("effect/Cause").UnknownError, never>;
export declare function createReadableStream(fileName: string): Effect.Effect<import("node:fs").ReadStream, import("effect/Cause").UnknownError, import("effect/Scope").Scope>;
export declare function openFile(fileName: string): Effect.Effect<fs.FileHandle, import("effect/Cause").UnknownError, import("effect/Scope").Scope>;
export declare function tempFile(folder: string): (prefix: string) => (data: Data, options?: FileOptions) => Effect.Effect<string, import("effect/Cause").UnknownError, import("effect/Scope").Scope>;
type Data = string | NodeJS.ArrayBufferView | Iterable<string | NodeJS.ArrayBufferView> | AsyncIterable<string | NodeJS.ArrayBufferView> | internal.Stream;
export type FileOptions = (ObjectEncodingOptions & {
    mode?: Mode | undefined;
    flag?: OpenMode | undefined;
} & Abortable) | BufferEncoding | null;
export declare function tempFile_(folder: string, prefix: string, data: Data, options?: FileOptions): Effect.Effect<string, import("effect/Cause").UnknownError, import("effect/Scope").Scope>;
/**
 * Safe write file to .tmp and then rename
 */
export declare function writeTextFile(fileName: string, content: string): Effect.Effect<void, never, never>;
export declare function fileExists(fileName: string): Effect.Effect<boolean, never, never>;
export declare function readTextFile(fileName: string): Effect.Effect<string, import("effect/Cause").UnknownError, never>;
/**
 * Executes an action with an exclusive cross-process file lock.
 * Uses proper-lockfile for robust lock management with stale lock detection,
 * retry logic, and cross-platform support.
 *
 * @param filePath - The file to lock (will create {filePath}.lock)
 * @param action - The Effect to execute while holding the lock
 * @returns The result of the action
 */
export declare function withFileLock<A, E, R>(filePath: string, action: Effect.Effect<A, E, R>): Effect.Effect<A, E, R>;
export {};
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmlsZVV0aWwuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9maWxlVXRpbC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFDQSxPQUFPLEVBQUUsTUFBTSxFQUFFLE1BQU0sWUFBWSxDQUFBO0FBQ25DLE9BQU8sS0FBSyxFQUFFLFNBQVMsRUFBRSxNQUFNLFFBQVEsQ0FBQTtBQUN2QyxPQUFPLEtBQUssRUFBRSxJQUFJLEVBQUUscUJBQXFCLEVBQUUsUUFBUSxFQUFFLE1BQU0sSUFBSSxDQUFBO0FBQy9ELE9BQU8sRUFBRSxNQUFNLGFBQWEsQ0FBQTtBQUk1QixPQUFPLEtBQUssUUFBUSxNQUFNLFFBQVEsQ0FBQTtBQUVsQyx3QkFBZ0IsUUFBUSxDQUFDLFFBQVEsRUFBRSxNQUFNLDhFQUV4QztBQUVELHdCQUFnQixvQkFBb0IsQ0FBQyxRQUFRLEVBQUUsTUFBTSxrSEFFcEQ7QUFFRCx3QkFBZ0IsUUFBUSxDQUFDLFFBQVEsRUFBRSxNQUFNLG1HQUV4QztBQUVELHdCQUFnQixRQUFRLENBQ3RCLE1BQU0sRUFBRSxNQUFNLFlBRUUsTUFBTSxZQUFZLElBQUksWUFBWSxXQUFXLDhGQUM5RDtBQUVELEtBQUssSUFBSSxHQUNMLE1BQU0sR0FDTixNQUFNLENBQUMsZUFBZSxHQUN0QixRQUFRLENBQUMsTUFBTSxHQUFHLE1BQU0sQ0FBQyxlQUFlLENBQUMsR0FDekMsYUFBYSxDQUFDLE1BQU0sR0FBRyxNQUFNLENBQUMsZUFBZSxDQUFDLEdBQzlDLFFBQVEsQ0FBQyxNQUFNLENBQUE7QUFFbkIsTUFBTSxNQUFNLFdBQVcsR0FDbkIsQ0FBQyxxQkFBcUIsR0FBRztJQUN6QixJQUFJLENBQUMsRUFBRSxJQUFJLEdBQUcsU0FBUyxDQUFBO0lBQ3ZCLElBQUksQ0FBQyxFQUFFLFFBQVEsR0FBRyxTQUFTLENBQUE7Q0FDNUIsR0FBRyxTQUFTLENBQUMsR0FDWixjQUFjLEdBQ2QsSUFBSSxDQUFBO0FBQ1Isd0JBQWdCLFNBQVMsQ0FDdkIsTUFBTSxFQUFFLE1BQU0sRUFDZCxNQUFNLEVBQUUsTUFBTSxFQUNkLElBQUksRUFBRSxJQUFJLEVBQ1YsT0FBTyxDQUFDLEVBQUUsV0FBVyw0RkFnQnRCO0FBRUQ7O0dBRUc7QUFDSCx3QkFBZ0IsYUFBYSxDQUFDLFFBQVEsRUFBRSxNQUFNLEVBQUUsT0FBTyxFQUFFLE1BQU0scUNBUzlEO0FBRUQsd0JBQWdCLFVBQVUsQ0FBQyxRQUFRLEVBQUUsTUFBTSx3Q0FHMUM7QUFFRCx3QkFBZ0IsWUFBWSxDQUFDLFFBQVEsRUFBRSxNQUFNLHFFQUU1QztBQUVEOzs7Ozs7OztHQVFHO0FBQ0gsd0JBQWdCLFlBQVksQ0FBQyxDQUFDLEVBQUUsQ0FBQyxFQUFFLENBQUMsRUFDbEMsUUFBUSxFQUFFLE1BQU0sRUFDaEIsTUFBTSxFQUFFLE1BQU0sQ0FBQyxNQUFNLENBQUMsQ0FBQyxFQUFFLENBQUMsRUFBRSxDQUFDLENBQUMsR0FDN0IsTUFBTSxDQUFDLE1BQU0sQ0FBQyxDQUFDLEVBQUUsQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQThCeEIifQ==