import * as Effect from "effect/Effect"; import type * as FileSystem from "effect/FileSystem"; import type { PlatformError } from "effect/PlatformError"; import * as Random from "effect/Random"; /** * Write `contents` to `filePath` via a same-directory temp file + rename. * * A plain `writeFileString` truncates the target before writing, so a crash * mid-write (or a concurrent reader — another CLI process, the RPC sidecar) * can observe empty/partial JSON. rename(2) is atomic on the same * filesystem, so readers see either the old contents or the new, never a * torn write. When `mode` is given it is applied to the temp file *before* * the rename, so a secret is never visible at its final path with default * permissions. The temp file is removed on failure. * * Used for `~/.alchemy/profiles.json`, the per-provider credential files, * and local state files. */ export const writeFileAtomic = ( fs: FileSystem.FileSystem, filePath: string, contents: string, mode?: number, ): Effect.Effect => Effect.flatMap(Random.next, (random) => { const tmp = `${filePath}.${process.pid}.${random.toString(36).slice(2)}.tmp`; return fs.writeFileString(tmp, contents).pipe( Effect.flatMap(() => (mode === undefined ? Effect.void : fs.chmod(tmp, mode))), Effect.flatMap(() => fs.rename(tmp, filePath)), Effect.tapError(() => fs.remove(tmp).pipe(Effect.ignore)), ); });