Repository navigation
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 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.
-
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, theauth.userscolumns 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.
- 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.
Published from docs/. Edit the files there; changes here are overwritten.