Skip to content

ADR 0049

github-actions[bot] edited this page Nov 22, 2026 · 1 revision

Status: accepted · Built: done · Date: 2026-11-22

The ecosystem's ADR 0007 (no lock-in). Built: the contract in docs/contracts.md (The user pool contract); Spotpass's tests check each call (kodentuzo/spotpass#5).

The user pool is a contract in our own terms; Spotpass is its reference implementation

Context

The contract said the pool was "Better Auth's API, with the anonymous plugin". So the only way to replace Spotpass was to clone Better Auth, and a change in Better Auth could change the contract without anyone deciding it. The ecosystem's ADR 0007 asks that every brick's contract be written in Kodentuzo's own terms.

Decision

  • The pool's contract is the calls apps and spotkit actually make, written out in docs/contracts.md ("The user pool contract"): guest sign-in, the session, a token and its keys, export and self-delete. The tokens' claims, the auth.users columns apps may read, and what the pool keeps and for how long are part of it, as before.
  • Spotpass is the reference implementation. Its tests check each call, so another pool can run the same checks to show it fits.
  • Better Auth's client keeps working with Spotpass. It's a convenience for apps, not the contract.

Consequences

  • A change to these calls is a change to the contract: docs, the changelog, and Spotpass's tests together.
  • Email and password sign-in (the accounts step) adds its calls to this table when it ships.

Clone this wiki locally