pub
/
waymaker-client
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
2 Commits 1 Branch 1 Tag 356 KiB
TypeScript 86.5%
Rust 7.4%
Go 5.9%
Shell 0.2%
Go to file
Michael Netshipise 87a6171969 waymaker-client v0.1.27 — polyglot Go / TypeScript / Rust clients 
Extract the waymaker client into a standalone, polyglot repo versioned in
lockstep with the waymaker server (this tag == server v0.1.27).

- proto/   vendored client-facing protos (source of truth: waymaker repo).
           internal_proxy (server-internal ProxyService + replication) is
           intentionally excluded — it is a server concern, not a client one.
- rust/    standalone crate; build.rs generates from proto/. Quorum fence
           scope + Lock auto-reacquire / fence-watch (watch/is_lost) API.
- go/      module git.awesomike.com/pub/waymaker-client/go — generated stubs
           + ergonomic wrappers (locks/streams/kv/collections/sketches/object).
- ts/      @waymaker/client — generated stubs + ergonomic wrappers.
- scripts/ sync-protos.sh (re-vendor + align VERSION) + gen-go.sh + gen-ts.sh.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 		2026-06-09 19:20:48 +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.27 — polyglot Go / TypeScript / Rust clients 2026-06-09 19:20:48 +02:00
rust waymaker-client v0.1.27 — polyglot Go / TypeScript / Rust clients 2026-06-09 19:20:48 +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.27 — polyglot Go / TypeScript / Rust clients 2026-06-09 19:20:48 +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