The ledger

Shared error message helpers for API hooks — extracts user-facing message from ApiRequestError, generic Error, or unknown, and strips bearer tokens / auth credentials before display.

Tiny generic helper that owns {data, loading, error} for an async fetch — collapses three useStates into one.

Verify the current session against /auth/me on mount. On 401 or missing token, clear auth + redirect to /login. Returns the authenticated user once verified.

Fetch billing status + plans, expose changePlan against the active OpenAliceClient.

List/create/delete API keys against the active OpenAliceClient. Exposes newKey + clearNewKey for one-shot reveal.

Returns an async (email, password) → AuthActionResult that drives AuthProvider.login + sets the SSO sessionStorage flag. Translates RateLimitError into a UI-friendly message with retryAfter seconds.

Returns an async () → void that drives AuthProvider.logout, then clears the SSO sessionStorage flag. Errors during logout are swallowed — local state is cleared regardless.

Fetch the currently authenticated PublicUser from the active OpenAliceClient and expose loading/error/refetch.

Returns an async (name, email, password, _confirm?) → AuthActionResult that drives AuthProvider.register + sets the SSO sessionStorage flag. Translates RateLimitError into a UI-friendly message.

Fetch usage rollup for the last N days from the active OpenAliceClient.

Legacy adapter — fetch the current User (legacy shape) from the active OpenAliceClient. Prefer useMe() for new code.