4 Commits
Author SHA1 Message Date
Rene Nochebuena df462ca031 chore(cache-valkey): framework version alignment to v1.1.2 2026-08-08 00:43:17 -06:00
Rene Nochebuena 60226ecc01 docs(cache-valkey): fix wiring doc examples; align to v1.1.1 2026-08-07 23:32:17 -06:00
Rene Nochebuena 8907fed474 docs(cache-valkey): fix fictional launcher.Register/health.Register in doc examples (#2)
The package-doc examples showed a fictional launcher.Register / health.Register
API (and launcher.Append as a package func). Corrected to the real wiring:
lc.Append + web/health.NewHandler(...).ServeHTTP.
(component.go doc comment corrected too.)

Documentation-only. No code, API, or dependency changes; version stays v1.1.0
(the v1.1.0 tag is moved to include this fix). Verified by compiling the
corrected pattern against the real API.

Reviewed-on: #2
Co-authored-by: Rene Nochebuena Guerrero <rene@nochebuena.dev>
Co-committed-by: Rene Nochebuena Guerrero <rene@nochebuena.dev>
2026-08-07 22:18:54 -06:00
Rene Nochebuena 7ccd0694fb chore(cache-valkey): bump einherjar deps to v1.1.0 (framework version alignment) (#1)
Patch of the coordinated framework release: einherjar modules move to v1.1.0
in lockstep, so cache-valkey is bumped alongside the rest.

- go.mod: contracts, core -> v1.1.0 (via go get + go mod tidy)

No code or API changes. ModuleVersion() reports v1.1.0 automatically from
build info once tagged. Badge bumped to v1.1.0.

Reviewed-on: #1
Co-authored-by: Rene Nochebuena Guerrero <rene@nochebuena.dev>
Co-committed-by: Rene Nochebuena Guerrero <rene@nochebuena.dev>
2026-08-07 19:09:10 -06:00
6 changed files with 49 additions and 16 deletions
+30
View File
@@ -4,6 +4,36 @@ All notable changes to this module are documented here.
Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
This module adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). This module adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## [1.1.2] — 2026-08-08
Patch — coordinated framework version alignment.
### Changed
- Bumped `contracts`, `core` to v1.1.2. No code or API changes.
## [1.1.1] — 2026-08-07
Patch — corrected doc examples plus framework version alignment.
### Fixed
- Package doc examples used a fictional `launcher.Register` / `health.Register` API; corrected to
`lc.Append` + `web/health.NewHandler(...).ServeHTTP`. Verified by compiling against the real API.
### Changed
- Bumped `contracts` and `core` to v1.1.1.
## [1.1.0] — 2026-08-07
Coordinated framework version alignment — released in lockstep at v1.1.0.
### Changed
- Bumped einherjar dependencies (`contracts`, `core`) to v1.1.0 via `go get` + `go mod tidy`.
No code or API changes.
## [1.0.0] — 2026-05-28 ## [1.0.0] — 2026-05-28
### Added ### Added
+6 -5
View File
@@ -1,6 +1,6 @@
# einherjar/cache-valkey # einherjar/cache-valkey
[![version](https://img.shields.io/badge/version-v1.0.0-5C4EE5?style=flat-square)](https://code.nochebuena.dev/einherjar/cache-valkey) [![version](https://img.shields.io/badge/version-v1.1.2-5C4EE5?style=flat-square)](https://code.nochebuena.dev/einherjar/cache-valkey)
[![license](https://img.shields.io/badge/license-AGPL--3.0-22863A?style=flat-square)](LICENSE) [![license](https://img.shields.io/badge/license-AGPL--3.0-22863A?style=flat-square)](LICENSE)
[![go](https://img.shields.io/badge/Go-1.26+-00ADD8?style=flat-square&logo=go&logoColor=white)](https://go.dev) [![go](https://img.shields.io/badge/Go-1.26+-00ADD8?style=flat-square&logo=go&logoColor=white)](https://go.dev)
[![health](https://img.shields.io/badge/health-degraded-E36209?style=flat-square)]() [![health](https://img.shields.io/badge/health-degraded-E36209?style=flat-square)]()
@@ -17,8 +17,9 @@ import cachevalkey "code.nochebuena.dev/einherjar/cache-valkey"
vk := cachevalkey.New(logger, cachevalkey.Config{ vk := cachevalkey.New(logger, cachevalkey.Config{
Addrs: []string{"localhost:6379"}, Addrs: []string{"localhost:6379"},
}) })
launcher.Register(vk) // OnInit → OnStart → OnStop lc.Append(vk) // OnInit → OnStart → OnStop
health.Register(vk) // PING-based health check, LevelDegraded // vk is observability.Checkable (PING-based, LevelDegraded):
srv.Get("/health", health.NewHandler(logger, vk).ServeHTTP)
``` ```
## Connecting to other modules ## Connecting to other modules
@@ -30,8 +31,8 @@ them directly to the consuming modules:
```go ```go
// --- 1. Create the component (lifecycle + health + Provider) --- // --- 1. Create the component (lifecycle + health + Provider) ---
vk := cachevalkey.New(logger, cfg) vk := cachevalkey.New(logger, cfg)
launcher.Register(vk) lc.Append(vk)
health.Register(vk) srv.Get("/health", health.NewHandler(logger, vk).ServeHTTP)
// --- 2. Create adapters (one per consumer interface) --- // --- 2. Create adapters (one per consumer interface) ---
// Each adapter wraps vk (a Provider) and satisfies one interface in another module. // Each adapter wraps vk (a Provider) and satisfies one interface in another module.
+4 -3
View File
@@ -7,10 +7,11 @@ import (
// Component is the full cache-valkey capability: lifecycle management, health checks, // Component is the full cache-valkey capability: lifecycle management, health checks,
// and all Provider operations. // and all Provider operations.
// Register with launcher and health before starting the application: // Append it to a launcher, and wire a health endpoint (it satisfies
// observability.Checkable):
// //
// launcher.Register(vk) // lc.Append(vk)
// health.Register(vk) // srv.Get("/health", health.NewHandler(logger, vk).ServeHTTP)
type Component interface { type Component interface {
lifecycle.Component lifecycle.Component
observability.Checkable observability.Checkable
+3 -2
View File
@@ -4,8 +4,9 @@
// # Quick start // # Quick start
// //
// vk := cachevalkey.New(logger, cfg) // vk := cachevalkey.New(logger, cfg)
// launcher.Register(vk) // lifecycle: OnInit → OnStart → OnStop // lc.Append(vk) // lifecycle: OnInit → OnStart → OnStop
// health.Register(vk) // health: PING-based, LevelDegraded // // vk satisfies observability.Checkable (PING-based, LevelDegraded) — wire a health endpoint:
// srv.Get("/health", health.NewHandler(logger, vk).ServeHTTP)
// //
// # Adapters // # Adapters
// //
+2 -2
View File
@@ -3,8 +3,8 @@ module code.nochebuena.dev/einherjar/cache-valkey
go 1.26 go 1.26
require ( require (
code.nochebuena.dev/einherjar/contracts v1.0.0 code.nochebuena.dev/einherjar/contracts v1.1.2
code.nochebuena.dev/einherjar/core v1.0.0 code.nochebuena.dev/einherjar/core v1.1.2
github.com/valkey-io/valkey-go v1.0.54 github.com/valkey-io/valkey-go v1.0.54
) )
+4 -4
View File
@@ -1,7 +1,7 @@
code.nochebuena.dev/einherjar/contracts v1.0.0 h1:hRudEtOIqU7vwedYLsCh8+9q5dCnKb61qX+zibqImRU= code.nochebuena.dev/einherjar/contracts v1.1.2 h1:LNAFCKQjpNjkCyMid2AgkhDPPzOx8dvpRqqZ7F3zpo0=
code.nochebuena.dev/einherjar/contracts v1.0.0/go.mod h1:ccltUtrFb5+MEJdkx2VVEUL+xC5pupVlVVsMM8AlCWI= code.nochebuena.dev/einherjar/contracts v1.1.2/go.mod h1:ccltUtrFb5+MEJdkx2VVEUL+xC5pupVlVVsMM8AlCWI=
code.nochebuena.dev/einherjar/core v1.0.0 h1:AueZgfjp3+rQmDKOxmJQ945TTh+sqC1l/xJdTOdbr9w= code.nochebuena.dev/einherjar/core v1.1.2 h1:iYU2fIWtnyOYFbTMD92NaLJMye4XgZHXWhEjB3iS7lo=
code.nochebuena.dev/einherjar/core v1.0.0/go.mod h1:0IywfRnJXX9xXQO6iPVaq2QDlXbbpXrB8A4T7gO8nE4= code.nochebuena.dev/einherjar/core v1.1.2/go.mod h1:Y7qZ9nri9Ydey3+40yz75KErOvOUjRSoffdykXbncsw=
github.com/google/go-cmp v0.6.0 h1:ofyhxvXcZhMsU5ulbFiLKl/XBFqE1GSq7atu8tAmTRI= github.com/google/go-cmp v0.6.0 h1:ofyhxvXcZhMsU5ulbFiLKl/XBFqE1GSq7atu8tAmTRI=
github.com/google/go-cmp v0.6.0/go.mod h1:17dUlkBOakJ0+DkrSSNjCkIjxS6bF9zb3elmeNGIjoY= github.com/google/go-cmp v0.6.0/go.mod h1:17dUlkBOakJ0+DkrSSNjCkIjxS6bF9zb3elmeNGIjoY=
github.com/onsi/gomega v1.36.2 h1:koNYke6TVk6ZmnyHrCXba/T/MoLBXFjeC1PtvYgw0A8= github.com/onsi/gomega v1.36.2 h1:koNYke6TVk6ZmnyHrCXba/T/MoLBXFjeC1PtvYgw0A8=