import { type EvoPaths } from "./paths.ts";
export interface FileLockOptions {
    timeoutMs?: number;
    staleAfterMs?: number;
    heartbeatMs?: number | false;
    ownerToken?: string;
    afterLockPrepared?: () => void | Promise<void>;
    onHeartbeatError?: (error: unknown) => void;
}
export type FileLockAttempt<T> = {
    acquired: true;
    value: T;
} | {
    acquired: false;
};
export interface DurabilityOptions {
    syncDirectory?: (path: string) => Promise<void>;
}
export declare function canonicalJson(value: unknown): string;
export declare function sha256(data: string | Uint8Array): string;
export declare function readJson<T>(path: string): Promise<T>;
export declare function readJsonIfExists<T>(path: string): Promise<T | undefined>;
export declare function atomicWriteFile(path: string, content: string): Promise<void>;
export declare function atomicWriteJson(path: string, value: unknown): Promise<void>;
export declare function appendJsonLine(path: string, value: unknown, options?: DurabilityOptions): Promise<void>;
export declare function durableUnlink(path: string, options?: DurabilityOptions): Promise<boolean>;
export declare function truncateIncompleteFinalLine(path: string): Promise<boolean>;
export declare function withFileLock<T>(paths: EvoPaths, name: string, operation: () => Promise<T>, options?: FileLockOptions): Promise<T>;
export declare function tryWithFileLock<T>(paths: EvoPaths, name: string, operation: () => Promise<T>, options?: Omit<FileLockOptions, "timeoutMs">): Promise<FileLockAttempt<T>>;
//# sourceMappingURL=storage.d.ts.map