export declare const ATOMIC_JSON_FILE_MODE = 384;
/**
 * Read a JSON object file using a no-follow open. Returns an empty object when
 * the file does not exist or is empty. Throws when the file exists but does not
 * contain a JSON object (so callers can distinguish "no settings" from
 * "malformed settings").
 */
export declare function readJsonObjectFile<T extends Record<string, unknown> = Record<string, unknown>>(filePath: string): T;
/**
 * Atomically write a JSON file: create a unique temp file in the same
 * directory, fsync its contents via close, then `rename` over the target. A
 * failure during rename removes the temp file (best effort). The target is
 * created with 0o600 permissions.
 */
export declare function atomicWriteJson(filePath: string, value: unknown): void;