v1.0.2

code.nochebuena.dev/go/valkey

Overview

valkey v1.0.2 commits the Valkey client lifecycle API as stable. The module manages
the lifecycle of a valkey-go client: constructs it from config, verifies connectivity
at startup, exposes the native client to consumers, and closes it on shutdown. Health
checks run via PING.

What Changed Since v0.9.0

Dependency bumps

health, launcher, and logz promoted to v1.0.1. go directive updated to 1.26.

No API changes. Config, Provider, Component, and New are unchanged.

Roadmap items resolved

Item	Resolution
Validate under connection churn / network partitions	✅ Validated — trusts `valkey-go` reconnect internals; no additional code needed
Optional `KeyPrefix` in `Config`	❌ No — key namespacing is the caller's responsibility by design
Higher-level `Repository` helper	❌ No — belongs in a separate module; coupling to domain concerns would violate the building-block principle
Configurable health-check timeout	❌ No — health check uses the caller's context, which already controls the timeout

Full API (stable)

Config — VK_ADDRS (required), VK_PASSWORD, VK_DB (default 0),
VK_CLIENT_CACHE_MB (default 0, disables client-side caching).

Provider — Client() valkey.Client; inject into repositories and services.

Component — embeds launcher.Component, health.Checkable, and Provider;
register with lc.Append.

New(logger logz.Logger, cfg Config) Component — constructor.

HealthCheck(ctx) error — issues PING; priority health.LevelDegraded.

Migration from v0.9.0

No breaking changes. Drop-in replacement.

go get code.nochebuena.dev/go/valkey@v1.0.2

Downloads

2 Releases 2 Tags

Release v1.0.2 Stable