einherjar/cache-valkey
2
0
Fork 0
Code Issues Pull Requests Packages Releases 2 Activity
11 Commits 1 Branch 12 Tags
f0d1724d06936c0a8fa58266cd576c5eecdf7d67
Commit Graph
10 Commits
Author SHA1 Message Date
Rene Nochebuena f0d1724d06 release: v1.6.0 (coordinated lockstep bump) 2026-08-13 23:11:46 -06:00
Rene Nochebuena 0bef8ceb83 chore(cache-valkey): framework version alignment to v1.5.0 2026-08-12 17:55:51 -06:00
Rene Nochebuena 205b2c828d chore(cache-valkey): dependency refresh; framework version alignment to v1.4.0 2026-08-12 15:28:20 -06:00
Rene Nochebuena b178b03289 chore(cache-valkey): framework version alignment to v1.3.0 2026-08-08 10:48:25 -06:00
Rene Nochebuena 6a6a951525 chore(cache-valkey): framework version alignment to v1.2.0 2026-08-08 02:24:52 -06:00
Rene Nochebuena ad4cd5ec72 chore(cache-valkey): framework version alignment to v1.1.3 2026-08-08 01:26:25 -06:00
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 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
Rene Nochebuena df7aa63e5c feat(cache-valkey): initial implementation — Provider, adapters (v1.0.0) 
Introduces code.nochebuena.dev/einherjar/cache-valkey — the Valkey cache starter
for the Einherjar framework. Absorbs the valkey package from micro-lib and adds
three duck-typed adapters that wire directly into auth, web, and auth-jwt.

Core:
- Provider interface — Get, Set, Del, Exists, Expire, IncrWithTTL, Native()
- Component interface — lifecycle.Component + observability.Checkable + Provider
- Config struct (EINHERJAR_VALKEY_* env vars)
- New(logger, cfg) Component — creates valkey-go client in OnInit;
  PING in OnStart; logs "valkey: connected"
- IncrWithTTL implemented with Lua script (atomic INCR + conditional EXPIRE);
  race-free fixed-window semantics with no MULTI/EXEC overhead
- Priority: LevelDegraded — Valkey outage degrades, does not halt the service

Adapters (duck-typed — no import of auth, web, or auth-jwt):
- PermissionCache — Get/Set int64 bitmasks as string; satisfies auth/rbac.Cache
- RateLimiterStore — fixed-window via IncrWithTTL; satisfies web/mw.RateLimiterStore
- Blacklist — Exists/Set "1" with TTL; satisfies auth-jwt.Blacklist

Compliance test verifies CT-6, duck-type shape assignments, and full adapter
behavioural coverage with a mockProvider (no live server required).

- Component interface embeds observability.Identifiable; identifiable.go implements
  ModulePath and ModuleVersion via runtime/debug.ReadBuildInfo() — prints in launcher banner
 2026-05-29 15:58:56 +00:00