Go to file
Michael Netshipise 14a75f503e waymaker-client v0.1.28 — optional ttl on all sketch reserves
Add ttl: Option<Duration> to Hll/Bloom/Cms/TopK/TDigest configs; create_* sends
ttl_ms (0 = never). For time-bucketed sketch keys (rolling-window cardinality
etc.) the server auto-evicts, so callers don't hand-purge old buckets.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-19 22:37:04 +02:00
go waymaker-client v0.1.27 — polyglot Go / TypeScript / Rust clients 2026-06-09 19:20:48 +02:00
proto waymaker-client v0.1.28 — optional ttl on all sketch reserves 2026-06-19 22:37:04 +02:00
rust waymaker-client v0.1.28 — optional ttl on all sketch reserves 2026-06-19 22:37:04 +02:00
scripts waymaker-client v0.1.27 — polyglot Go / TypeScript / Rust clients 2026-06-09 19:20:48 +02:00
ts waymaker-client v0.1.27 — polyglot Go / TypeScript / Rust clients 2026-06-09 19:20:48 +02:00
.gitignore waymaker-client v0.1.27 — polyglot Go / TypeScript / Rust clients 2026-06-09 19:20:48 +02:00
Cargo.toml waymaker-client v0.1.27 — polyglot Go / TypeScript / Rust clients 2026-06-09 19:20:48 +02:00
README.md waymaker-client v0.1.27 — polyglot Go / TypeScript / Rust clients 2026-06-09 19:20:48 +02:00
VERSION waymaker-client v0.1.28 — optional ttl on all sketch reserves 2026-06-19 22:37:04 +02:00

README.md

waymaker-client

Official client libraries for waymaker — the distributed coordination service (locks, streams, KV, collections, sketches, cache, object store) over gRPC.

Three clients, one wire contract, versioned in lockstep with the waymaker server:

Language Path Package
Rust rust/ waymaker-client (crate)
Go go/ git.awesomike.com/pub/waymaker-client/go (module)
TypeScript ts/ @waymaker/client (npm)

The .proto files in proto/ are vendored copies; the waymaker server repo is the source of truth. scripts/sync-protos.sh refreshes them and keeps VERSION aligned with the server.

Versioning

Every release is tagged at the same version as the waymaker server it targets (see VERSION). A client tagged v0.1.27 speaks the wire contract of waymaker v0.1.27. The gRPC wire format is backward-compatible across patch releases (enum integer values are stable), so a client one patch behind a server generally interoperates — but match versions for new surface.

Layout

proto/      vendored .proto (source of truth: waymaker repo)
rust/       Rust client crate (hand-written ergonomic wrappers + generated stubs)
go/         Go client module
ts/         TypeScript client (npm)
scripts/    sync-protos.sh + codegen scripts (gen-go/gen-ts)
VERSION     lockstep version with the waymaker server

Regenerating

# refresh protos from a local waymaker checkout, then regenerate all stubs
WAYMAKER_REPO=../waymaker ./scripts/sync-protos.sh
./scripts/gen-go.sh
./scripts/gen-ts.sh
# Rust regenerates from proto/ automatically via build.rs on `cargo build`.

Quickstart