internal/

Package bootstrap implements node startup loading and backfill.

Package buildvars exposes build info (version, commit hash, build date) injected via build-time linker flags.

Package clientapi implements the etcd-compatible gRPC Client API, including KV (Range, Txn), Watch, Lease, Cluster, and Maintenance services.

Package cmd wires up the main netsy command and server startup.

Package commonapi provides shared request handling logic used by both the Client API and Primary domain layer, such as Range queries.

Package config loads, parses, and validates per-node settings (from environment variables) and per-cluster settings (from a JSONC config file).

Package datafile reads and writes the .netsy data file format

Package datastore manages chunk and snapshot files in object storage, including upload, download, listing, and revision parsing.

Package discovery manages node registration files and the members file in object storage.

Package elector integrates s3lect leader election into the Netsy node lifecycle.

Package healthserver provides an unencrypted HTTP /health endpoint driven by the Node's HealthState.

Package heartbeat manages the outbound heartbeat sender goroutine.

Package localdb implements SQLite database operations including schema management, inserts, finds, transactions, replication, and compaction.

Package metrics provides centralized Prometheus metric registration, role-gated collection, and always-on node state metrics for Netsy.

Package mtls provides mutual TLS configuration, certificate validation, and identity extraction for client and peer gRPC connections.

Package node implements the Node gRPC service hosted by every Node.

Package nodestate tracks per-node runtime state: the Health, Elector, and Primary state triple, the current Cluster State, and the Committed Revision and Compaction Revision used to gate client-visible range requests and watches.

Package peerclient manages outbound gRPC client connections to peer Nodes.

Package primary implements the Primary gRPC service and domain layer, including transaction processing, the Follow replication stream, chunk buffering for async object storage writes, Replica heartbeat and receipt tracking, and heartbeat-based degradation.

Package replication implements the Replica-side Follow stream client.

Package snapshot implements the snapshot creation worker that periodically writes complete Netsy snapshot files to object storage based on record count, size, and age thresholds.

Package storage provides an abstraction layer to object storage.

Package watch manages watch subscriptions and distribution.