src/

Package config loads configuration from the environment into a struct, once, at boot — and fails the boot when something required is missing.

Package ctxkit carries request-scoped identity on a context.Context.

Package di is the dependency-injection container: typed, lazy providers resolved through Go generics, with no reflection and no struct tags.

Package errs is the single error vocabulary of an inceptools application.

Package lifecycle gives a module three moments — init, ready, shutdown — and the signal handling that makes shutdown actually happen.

Package logx is the application logger: log/slog, with the request-scoped identity from ctxkit attached automatically.

Package module is the unit of organisation: a feature slice that declares what it provides, routes, owns and needs checked.

Package gormx translates database errors into the application's error vocabulary, and provides the query scopes every repository needs.

Package repo is a generic, tenant-scoped repository over GORM.

Package cache is a small, typed caching layer with two implementations and one rule: a cache failure is never a request failure.

Package events is a typed, in-process event bus: no `any` at the call site, no type assertion in the handler, and the failure modes handled.

Package lock is mutual exclusion across processes: "only one replica runs this at a time".

Package queue provides a small lifecycle-aware in-process work queue.

Package scheduler runs recurring work on a cron expression or a fixed interval, with the two properties that decide whether scheduled work is safe to deploy on more than one replica.

Package breaker stops calling a dependency that is clearly down.

Package idempotency makes a repeated POST safe.

Package outbox makes a side effect as durable as the write that caused it.

Package retry re-attempts work that failed for a reason that might not recur.

Package binding turns a request into a validated DTO, or into an error that already knows how to render itself.

Package filter is the last line of the request pipeline: it turns anything that escaped a handler into a response.

Package guard is authorization: the question "may this caller do this?", asked once per route, before the handler runs.

Package health answers the two questions an orchestrator asks, which are not the same question.

Package interceptor wraps a handler on both sides: before it runs, after it returns, and around a failure.

Package middleware is the request-scoped plumbing every route needs before any handler runs: identity on the context, a trace id, a recovered panic, a deadline.

Package pagination reads list parameters off a request, with the bounds applied before anything reaches the database.

Package pipe reads one value out of a request and converts it, returning an error that already carries the right status and the right field name.

Package response is the single shape every HTTP response in an inceptools service takes, and the single place an outgoing message is scrubbed.

Package router makes routes DATA.

Package sse exposes Fiber's SSE transport through the inceptools web layer.

Package webhook contains transport-independent helpers for signed webhooks.