auth/CHANGELOG.md

# Changelog

## v1.1.3 — 2026-08-08

Patch — coordinated framework version alignment. Bumped einherjar dependencies (\`contracts\`, \`core\`, \`web\`) to v1.1.3.
No code or API changes.## v1.1.2 — 2026-08-08

Patch — documentation fix plus coordinated framework version alignment.

### Fixed

- README wiring example: `rbac.NewClaimsPermissionProvider("perms", authmw.GetClaims)` (was
  missing the `getClaims` argument); install line updated to v1.1.2.

### Changed

- Bumped `contracts`, `core`, `web` to v1.1.2.

## v1.1.1 — 2026-08-07

Patch — coordinated framework version alignment. Bumped `contracts`, `core`, `web` to v1.1.1.
No code or API changes.

## v1.1.0 — 2026-08-07

Coordinated framework version alignment — released in lockstep at v1.1.0.

### Changed

- Bumped einherjar dependencies (`contracts`, `core`, `web`) to v1.1.0 via `go get` + `go mod tidy`.
  No code or API changes.

## v1.0.0

Initial release.

### `authmw`

- `BagEnricher` type — `func(bag security.SecurityBag, r *http.Request) security.SecurityBag`;
  enriches the request-scoped SecurityBag after the base Identity is built. Register via
  `WithBagEnricher`. Multiple enrichers run in registration order, each receiving the bag
  returned by the previous one.
- `SetTokenData` — integration contract for provider packages (auth-jwt, auth-firebase).
  Stores uid and raw claims in context via typed keys; consumed by `EnrichmentMiddleware`.
- `GetClaims` — exported accessor for raw token claims stored by `SetTokenData`. Available
  to custom `IdentityEnricher` implementations and `ClaimsPermissionProvider`.
- `EnrichmentMiddleware` — builds a `security.SecurityBag` from uid+claims. Calls the
  application `IdentityEnricher`, wraps the Identity in a SecurityBag, runs all registered
  `BagEnricher` functions in order, then stores the bag via `security.SetBagInContext`.
  Accepts `logging.Logger`; routes errors through `httputil.Error` (401 on missing token,
  500 on enricher failure).
- `AuthzMiddleware` — per-route permission gate. Returns 401 on missing identity, 403 on
  provider error or insufficient permissions (fail-closed).
- `IdentityEnricher` interface — implemented by the application to load user data from uid+claims.
- `EnrichOpt` type — `func(*enrichConfig)`.
- `WithTenantHeader(header string) EnrichOpt` — reads Identity.TenantID from a named request
  header. Implemented as a `BagEnricher` internally.
- `WithBagEnricher(fn BagEnricher) EnrichOpt` — registers a custom enricher. Use for any
  attribute beyond TenantID: hardware IDs, grant codes, etc.

### `rbac`

- `NewClaimsPermissionProvider` — reads pre-computed bitmasks from JWT claims in context.
  Flat format: `claims[claimsKey][resource] = mask`. Wildcard `"*"` fallback.
  Handles int64, float64, json.Number.
- `NewCachedPermissionProvider` — wraps any `security.PermissionProvider` with TTL caching.
  Default cache key: `"rbac:{uid}:{resource}"` (single-tenant) or
  `"rbac:{tenantID}:{uid}:{resource}"` (multi-tenant). TenantID sourced from the SecurityBag
  in context automatically. Accepts `...CachedOpt` for customization.
- `CachedOpt` type — `func(*cachedConfig)`.
- `WithCacheKey(fn func(security.SecurityBag, string, string) string) CachedOpt` — overrides
  the default cache key function. Use when additional bag attributes (hardware IDs, grant codes)
  must be part of the key.
- `NewChainPermissionProvider` — tries providers in order; returns first non-zero mask. Errors
  short-circuit.
- `Cache` interface — pluggable cache backend. Satisfied by `einherjar/cache-valkey` via duck
  typing.