An idiomatic Elixir client for TerminusDB, the document graph database with built-in version control.

v0.1 provides the foundation: an immutable TerminusDB.Config for connection context, a Req-based TerminusDB.Client HTTP layer, a typed TerminusDB.Error, the TerminusDB.Database management API, and TerminusDB.Telemetry events on every operation. Connection context is immutable data, making it safe for concurrent use.

Document, schema, branch, commit, diff, merge, WOQL, GraphQL, and streaming APIs, plus optional Ecto and ExDatalog integrations, are planned for later milestones. See ARCHITECTURE.md and the ADRs (under docs/adr/) for the full design and roadmap.

Quick start

# 1. Configure a connection (immutable context)
config = TerminusDB.Config.new(endpoint: "http://localhost:6363")

# 2. Manage databases
{:ok, _} = TerminusDB.Database.create(config, "mydb",
  label: "My Database",
  comment: "A new database",
  schema: true
)

# 3. Scope to a database (for later document work)
config = TerminusDB.Config.with_database(config, "mydb")

All public calls return {:ok, result} or {:error, %TerminusDB.Error{}}. Each !/1-suffixed variant raises TerminusDB.Error instead. Every operation emits :telemetry events (see TerminusDB.Telemetry).