Skip to content

v0.1.0 — Shared foundation

Latest

Choose a tag to compare

@abd-ulbasit abd-ulbasit released this 10 Jun 07:30

First public release. The shared-library foundation (pkg/) is complete and tested; the 9 services build on top of this.

Highlights

pkg/ shared libraries (built, vetted, -race tested):

  • grpcutil — server factory with the full interceptor chain (recovery → logging → auth) for both unary and streaming, OpenTelemetry tracing via otelgrpc, graceful shutdown, readiness-aware gRPC health.
  • natsutil — JetStream publisher/subscriber with standard event envelopes, DLQ, consumer-side idempotency, and trace/correlation propagation across the async hop.
  • observability — single-call OpenTelemetry setup (traces + metrics + trace-correlated logs) with OTLP exporters and stdout fallback.
  • config — zero-dependency env-var loader (durations, slices, defaults, required).
  • health/healthz + /readyz with concurrent, timeout-bounded checks.
  • testutil — testcontainers + in-process (bufconn) gRPC test server.

Also: local infra via docker-compose (NATS, Postgres, Redis, MinIO, Prometheus/Tempo/Loki/Grafana), Buf proto tooling, platform design + phased implementation plan, and ADR 0001 (Backend-for-Frontend).

See the implementation plan for the roadmap.