Adapters matrix

Every service, adapter, package, and container accessor in one table.

Each core/<b> package holds one interface plus a Register/Open registry, each adapter is its own Go module at adapters/<b>/<a>, and the container is the sole resolver. This matrix maps service to adapter module and accessor so swaps stay config-only. Prefer a new interface over adding methods, which break implementers.

Swap an adapter by config

cache:
  adapter: redis
  options:
    addr: redis:6379
queue:
  adapter: redis
db:
  adapter: postgres
  options:
    dsn: postgres://app:secret@db:5432/app

CACHE_ADAPTER=redis
QUEUE_ADAPTER=redis
DB_ADAPTER=postgres

Resolve through the container

c := container.New(cfg)
cache, err := c.Cache()
if err != nil {
    return err
}
q, err := c.Queue()
if err != nil {
    return err
}

New(nil) is valid; untouched services close cleanly without opening. Accessors resolve lazily and retry on the next call after an error. Job() builds over the resolved Queue; Scheduler() shares both, so resolving Scheduler() resolves Job() and Queue as a side effect.

All defaults (memory/local/sqlite/log/noop) fit single-process dev. Move shared state to redis/postgres for multi-instance staging:

DB_ADAPTER=postgres CACHE_ADAPTER=redis QUEUE_ADAPTER=redis go run ./cmd/myapp

Adapter reference

Install every adapter module you resolve (replace vX.Y.Z with the lockstep release version):

go get github.com/zenta-dev/zever/adapters/cache/redis@vX.Y.Z

import "github.com/zenta-dev/zever/adapters/cache/redis"

redis.Register()

Service	Adapter	Module	Register	Accessor
ai	anthropic	`github.com/zenta-dev/zever/adapters/ai/anthropic`	`anthropic.Register()`	`AI()`
ai	openai	`github.com/zenta-dev/zever/adapters/ai/openai`	`openai.Register()`	`AI()`
ai	gemini	`github.com/zenta-dev/zever/adapters/ai/gemini`	`gemini.Register()`	`AI()`
ai	ollama	`github.com/zenta-dev/zever/adapters/ai/ollama`	`ollama.Register()`	`AI()`
analytics	log	`github.com/zenta-dev/zever/adapters/analytics/log`	`log.Register()`	`Analytics()`
analytics	posthog	`github.com/zenta-dev/zever/adapters/analytics/posthog`	`posthog.Register()`	`Analytics()`
auth	jwt	`github.com/zenta-dev/zever/adapters/auth/jwt`	`jwt.Register()`	`Auth()`
auth	session	`github.com/zenta-dev/zever/adapters/auth/session`	`session.Register()`	`Auth()`
auth	oidc	`github.com/zenta-dev/zever/adapters/auth/oidc`	`oidc.Register()`	`Auth()`
billing	stub	`github.com/zenta-dev/zever/adapters/billing/stub`	`stub.Register()`	`Billing()`
billing	stripe	`github.com/zenta-dev/zever/adapters/billing/stripe`	`stripe.Register()`	`Billing()`
billing	paddle	`github.com/zenta-dev/zever/adapters/billing/paddle`	`paddle.Register()`	`Billing()`
cache	memory	`github.com/zenta-dev/zever/adapters/cache/memory`	`memory.Register()`	`Cache()`
cache	redis	`github.com/zenta-dev/zever/adapters/cache/redis`	`redis.Register()`	`Cache()`
cache	db	`github.com/zenta-dev/zever/adapters/cache/db`	`db.Register()`	`Cache()`
cdn	noop	`github.com/zenta-dev/zever/adapters/cdn/noop`	`noop.Register()`	`CDN()`
cdn	cloudflare	`github.com/zenta-dev/zever/adapters/cdn/cloudflare`	`cloudflare.Register()`	`CDN()`
crypto	local	`github.com/zenta-dev/zever/adapters/crypto/local`	`local.Register()`	`Crypto()`
crypto	kms	`github.com/zenta-dev/zever/adapters/crypto/kms`	`kms.Register()`	`Crypto()`
db	sqlite	`github.com/zenta-dev/zever/adapters/db/sqlite`	`sqlite.Register()`	`DB()`
db	postgres	`github.com/zenta-dev/zever/adapters/db/postgres`	`postgres.Register()`	`DB()`
document	local	`github.com/zenta-dev/zever/adapters/document/local`	`local.Register()`	`Document()`
document	remote	`github.com/zenta-dev/zever/adapters/document/remote`	`remote.Register()`	`Document()`
document	latex	`github.com/zenta-dev/zever/adapters/document/latex`	`latex.Register()`	`Document()`
eventbus	memory	`github.com/zenta-dev/zever/adapters/eventbus/memory`	`memory.Register()`	`EventBus()`
eventbus	redis	`github.com/zenta-dev/zever/adapters/eventbus/redis`	`redis.Register()`	`EventBus()`
flag	static	`github.com/zenta-dev/zever/adapters/flag/static`	`static.Register()`	`Flag()`
flag	firebase	`github.com/zenta-dev/zever/adapters/flag/firebase`	`firebase.Register()`	`Flag()`
geo	google	`github.com/zenta-dev/zever/adapters/geo/google`	`google.Register()`	`Geo()`
geo	static	`github.com/zenta-dev/zever/adapters/geo/static`	`static.Register()`	`Geo()`
geo	osm	`github.com/zenta-dev/zever/adapters/geo/osm`	`osm.Register()`	`Geo()`
i18n	embed	`github.com/zenta-dev/zever/adapters/i18n/embed`	`embed.Register()`	`I18n()`
i18n	remote	`github.com/zenta-dev/zever/adapters/i18n/remote`	`remote.Register()`	`I18n()`
idempotency	memory	`github.com/zenta-dev/zever/adapters/idempotency/memory`	`memory.Register()`	`Idempotency()`
idempotency	redis	`github.com/zenta-dev/zever/adapters/idempotency/redis`	`redis.Register()`	`Idempotency()`
idempotency	db	`github.com/zenta-dev/zever/adapters/idempotency/db`	`db.Register()`	`Idempotency()`
lock	memory	`github.com/zenta-dev/zever/adapters/lock/memory`	`memory.Register()`	`Lock()`
lock	redis	`github.com/zenta-dev/zever/adapters/lock/redis`	`redis.Register()`	`Lock()`
log	noop	`github.com/zenta-dev/zever/adapters/log/noop`	`noop.Register()`	`Log()`
log	zerolog	`github.com/zenta-dev/zever/adapters/log/zerolog`	`zerolog.Register()`	`Log()`
log	slog	`github.com/zenta-dev/zever/adapters/log/slog`	`slog.Register()`	`Log()`
log	pretty	`github.com/zenta-dev/zever/adapters/log/pretty`	`pretty.Register()`	`Log()`
mailer	log	`github.com/zenta-dev/zever/adapters/mailer/log`	`log.Register()`	`Mailer()`
mailer	smtp	`github.com/zenta-dev/zever/adapters/mailer/smtp`	`smtp.Register()`	`Mailer()`
media	local	`github.com/zenta-dev/zever/adapters/media/local`	`local.Register()`	`Media()`
media	s3	`github.com/zenta-dev/zever/adapters/media/s3`	`s3.Register()`	`Media()`
media	ffmpeg	`github.com/zenta-dev/zever/adapters/media/ffmpeg`	`none (no registry)`	`Media()`
notification	log	`github.com/zenta-dev/zever/adapters/notification/log`	`log.Register()`	`Notification()`
notification	twilio	`github.com/zenta-dev/zever/adapters/notification/twilio`	`twilio.Register()`	`Notification()`
notification	fcm	`github.com/zenta-dev/zever/adapters/notification/fcm`	`fcm.Register()`	`Notification()`
observability	noop	`github.com/zenta-dev/zever/adapters/observability/noop`	`noop.Register()`	`Observability()`
observability	stdout	`github.com/zenta-dev/zever/adapters/observability/stdout`	`stdout.Register()`	`Observability()`
observability	otlp	`github.com/zenta-dev/zever/adapters/observability/otlp`	`otlp.Register()`	`Observability()`
outbox	memory	`github.com/zenta-dev/zever/adapters/outbox/memory`	`memory.Register()`	`Outbox()`
outbox	db	`github.com/zenta-dev/zever/adapters/outbox/db`	`db.Register()`	`Outbox()`
outbox	cdc	`github.com/zenta-dev/zever/adapters/outbox/cdc`	`cdc.Register()`	`Outbox()`
password	argon2id	`github.com/zenta-dev/zever/adapters/password/argon2`	`argon2.Register()`	`Password()`
payment	stub	`github.com/zenta-dev/zever/adapters/payment/stub`	`stub.Register()`	`Payment()`
payment	stripe	`github.com/zenta-dev/zever/adapters/payment/stripe`	`stripe.Register()`	`Payment()`
payment	paddle	`github.com/zenta-dev/zever/adapters/payment/paddle`	`paddle.Register()`	`Payment()`
permission	noop	`github.com/zenta-dev/zever/adapters/permission/noop`	`noop.Register()`	`Permission()`
permission	rbac	`github.com/zenta-dev/zever/adapters/permission/rbac`	`rbac.Register()`	`Permission()`
permission	casbin	`github.com/zenta-dev/zever/adapters/permission/casbin`	`casbin.Register()`	`Permission()`
queue	memory	`github.com/zenta-dev/zever/adapters/queue/memory`	`memory.Register()`	`Queue()`
queue	db	`github.com/zenta-dev/zever/adapters/queue/db`	`db.Register()`	`Queue()`
queue	redis	`github.com/zenta-dev/zever/adapters/queue/redis`	`redis.Register()`	`Queue()`
ratelimit	memory	`github.com/zenta-dev/zever/adapters/ratelimit/memory`	`memory.Register()`	`RateLimit()`
ratelimit	redis	`github.com/zenta-dev/zever/adapters/ratelimit/redis`	`redis.Register()`	`RateLimit()`
resilience	memory	`github.com/zenta-dev/zever/adapters/resilience/inproc`	`inproc.Register()`	`Resilience()`
resilience	redis	`github.com/zenta-dev/zever/adapters/resilience/redis`	`redis.Register()`	`Resilience()`
router	fiber	`github.com/zenta-dev/zever/adapters/router/fiber`	`fiber.Register()`	`Router()`
router	stdhttp	`github.com/zenta-dev/zever/adapters/router/stdhttp`	`stdhttp.Register()`	`Router()`
scheduler	embedded	`github.com/zenta-dev/zever/adapters/scheduler/embedded`	`embedded.Register()`	`Scheduler()`
scheduler	postgres	`github.com/zenta-dev/zever/adapters/scheduler/postgres`	`postgres.Register()`	`Scheduler()`
search	db	`github.com/zenta-dev/zever/adapters/search/db`	`db.Register()`	`Search()`
search	postgres	`github.com/zenta-dev/zever/adapters/search/db`	`db.Register()`	`Search()`
search	meilisearch	`github.com/zenta-dev/zever/adapters/search/meilisearch`	`meilisearch.Register()`	`Search()`
search	sqlite	`github.com/zenta-dev/zever/adapters/search/db`	`db.Register()`	`Search()`
secrets	env	`github.com/zenta-dev/zever/adapters/secrets/env`	`env.Register()`	`Secrets()`
secrets	vault	`github.com/zenta-dev/zever/adapters/secrets/vault`	`vault.Register()`	`Secrets()`
session	memory	`github.com/zenta-dev/zever/adapters/session/memory`	`memory.Register()`	`Session()`
session	redis	`github.com/zenta-dev/zever/adapters/session/redis`	`redis.Register()`	`Session()`
session	db	`github.com/zenta-dev/zever/adapters/session/db`	`db.Register()`	`Session()`
session	cookie	`github.com/zenta-dev/zever/adapters/session/cookie`	`none (no registry)`	`Session()`
storage	local	`github.com/zenta-dev/zever/adapters/storage/local`	`local.Register()`	`Storage()`
storage	s3	`github.com/zenta-dev/zever/adapters/storage/s3`	`s3.Register()`	`Storage()`
storage	r2	`github.com/zenta-dev/zever/adapters/storage/r2`	`r2.Register()`	`Storage()`
tenant	single	`github.com/zenta-dev/zever/adapters/tenant/single`	`single.Register()`	`Tenant()`
tenant	header	`github.com/zenta-dev/zever/adapters/tenant/header`	`header.Register()`	`Tenant()`
vectorstore	db	`github.com/zenta-dev/zever/adapters/vectorstore/db`	`db.Register()`	`VectorStore()`
vectorstore	sqlite	`github.com/zenta-dev/zever/adapters/vectorstore/db`	`db.Register()`	`VectorStore()`
vectorstore	pgvector	`github.com/zenta-dev/zever/adapters/vectorstore/db`	`db.Register()`	`VectorStore()`
vectorstore	qdrant	`github.com/zenta-dev/zever/adapters/vectorstore/qdrant`	`qdrant.Register()`	`VectorStore()`
webhook	http	`github.com/zenta-dev/zever/adapters/webhook/http`	`http.Register()`	`Webhook()`
webhook	queue	`github.com/zenta-dev/zever/adapters/webhook/queue`	`queue.Register()`	`Webhook()`
workflow	memory	`github.com/zenta-dev/zever/adapters/workflow/memory`	`memory.Register()`	`Workflow()`
workflow	db	`github.com/zenta-dev/zever/adapters/workflow/db`	`db.Register()`	`Workflow()`
workflow	postgres	`github.com/zenta-dev/zever/adapters/workflow/db`	`db.Register()`	`Workflow()`
job	- (dispatcher)	`github.com/zenta-dev/zever/core/job`	`none (no registry)`	`Job()`

Single-process vs multi-instance

Group	Single process	Multi-instance
cache, lock, ratelimit, idempotency, session, queue, eventbus	`memory`	`redis` (state must be shared)
db	`sqlite`	`postgres`
storage, media	`local`	`s3` / `r2`
auth	`jwt` (stateless) or `session` + shared store	`jwt`, or `session` only with shared store
search	`db` (legacy `sqlite`/`postgres` aliases)	`db` / `meilisearch`
vectorstore	`db` (legacy `sqlite`/`pgvector` aliases)	`db` / `qdrant`
mailer, notification, analytics	`log` (dev)	`smtp` / `twilio`+`fcm` / `posthog`
permission	`noop` (dev) / `rbac`	`rbac` / `casbin`
billing, payment	`stub` (dev)	`stripe` / `paddle`

Production notes

Close(ctx) closes only resolved services, dependents first; see API index for order and close shapes.
grpc has a lazy *grpc.Server singleton accessor (GRPC(opts...)) with no registry; EventBus() keeps an Eventbus() alias and RateLimit() a Ratelimit() alias.
Do not add methods to public interfaces; prefer new interfaces so external implementers keep compiling.
Shared redis/postgres endpoints become critical path: monitor, pool (max_conns), and bound timeouts per service.

Troubleshooting

State differs per instance: a memory adapter is still in the mix (cache, queue, session, lock). Move each shared-state service to redis.
Logins lost on restart: session on memory does not survive restarts. Use a shared session store for anything beyond local dev.
Jobs run twice or not at all: workers each resolved an isolated memory queue. Point all workers at the same shared queue (redis, or db on one database).
Swap did not take effect: _ADAPTER env or file adapter misspelled, or an old binary without the adapter compiled in. Check config show output and rebuild.

Config reference for adapter values and the env scheme.
API index for accessors and close order.
Authentication for jwt/session/oidc choice.
Authorization and permissions for noop/rbac/casbin choice.