Directories
¶
| Path | Synopsis |
|---|---|
|
Package auth verifies bearer tokens and resolves them to a Principal that carries roles and permissions for authorization checks.
|
Package auth verifies bearer tokens and resolves them to a Principal that carries roles and permissions for authorization checks. |
|
Package config loads and validates runtime configuration from the environment.
|
Package config loads and validates runtime configuration from the environment. |
|
gen
|
|
|
api
Package api provides primitives to interact with the openapi HTTP API.
|
Package api provides primitives to interact with the openapi HTTP API. |
|
Package idempotency stores and replays responses to unsafe requests keyed by a client-supplied Idempotency-Key, so retries do not duplicate side effects.
|
Package idempotency stores and replays responses to unsafe requests keyed by a client-supplied Idempotency-Key, so retries do not duplicate side effects. |
|
Package maintenance runs periodic background cleanup tasks, such as deleting expired idempotency keys and published outbox messages, so tables that grow over time stay bounded.
|
Package maintenance runs periodic background cleanup tasks, such as deleting expired idempotency keys and published outbox messages, so tables that grow over time stay bounded. |
|
modules
|
|
|
widget
Package widget is the example vertical slice.
|
Package widget is the example vertical slice. |
|
Package observability wires structured logging, tracing, and metrics: an slog logger with trace correlation and secret redaction, and OpenTelemetry tracer and meter providers exported via OTLP and Prometheus.
|
Package observability wires structured logging, tracing, and metrics: an slog logger with trace correlation and secret redaction, and OpenTelemetry tracer and meter providers exported via OTLP and Prometheus. |
|
Package outbox implements the transactional outbox pattern.
|
Package outbox implements the transactional outbox pattern. |
|
platform
|
|
|
database
Package database builds a tuned pgx connection pool and provides a transaction helper.
|
Package database builds a tuned pgx connection pool and provides a transaction helper. |
|
problem
Package problem renders errors as RFC 9457 problem details (application/problem+json), attaching the active trace ID so a failed response can be traced back to its span.
|
Package problem renders errors as RFC 9457 problem details (application/problem+json), attaching the active trace ID so a failed response can be traced back to its span. |
|
Package server wires the HTTP listener, middleware, and graceful shutdown.
|
Package server wires the HTTP listener, middleware, and graceful shutdown. |
|
Package testutil provides integration-test helpers.
|
Package testutil provides integration-test helpers. |
Click to show internal directories.
Click to hide internal directories.