GenServer for coordinating concurrent access to Zarr arrays.

Provides chunk-level locking to prevent write conflicts while allowing concurrent reads. Monitors processes holding locks and automatically cleans up on process crashes.

Features

• Chunk-level read/write locks
• Multiple concurrent readers
• Exclusive writers
• Automatic lock cleanup on process crash
• Deadlock prevention via timeouts
• Process monitoring

Lock Semantics

• Read locks: Multiple processes can hold read locks on the same chunk simultaneously
• Write locks: Only one process can hold a write lock on a chunk at a time
• A chunk with a write lock cannot have any read locks (and vice versa)
• Locks are automatically released when the process terminates

Usage

# Start server for an array
{:ok, pid} = ExZarr.ArrayServer.start_link(array_id: "my_array")

# Acquire write lock on chunk {0, 0}
:ok = ExZarr.ArrayServer.lock_chunk(pid, {0, 0}, :write)

# Do write operation...

# Release lock
:ok = ExZarr.ArrayServer.unlock_chunk(pid, {0, 0})

# Acquire read lock (multiple processes can do this)
:ok = ExZarr.ArrayServer.lock_chunk(pid, {0, 0}, :read)