Gustavo Valverde 78bb334f0a feat(core): add plugin extension registry and dependency validation
Introduce the foundational Plugin Extension Protocol — a typed,
declarative mechanism for plugins to extend other plugins.

- BetterAuthExtensionRegistry: empty interface augmented by host
  plugins via declare module (parallel to BetterAuthPluginRegistry)
- extensions field on BetterAuthPlugin: typed via registry, gives
  compile-time checking and IDE autocomplete for extension contracts
- dependencies field on BetterAuthPlugin: validated at startup,
  throws BetterAuthError with descriptive message if missing
- getExtensions(hostId) on AuthContext: collects typed extension
  contributions from all plugins targeting a host
- Dependency validation in runPluginInit: fail-fast before any
  init runs
- Docs: Plugin Extension Protocol section in concepts/plugins.mdx
2026-03-20 00:53:52 +00:00
2026-03-19 12:18:34 -07:00
2026-03-19 16:07:55 -07:00
2025-12-08 16:58:23 -08:00
2026-01-03 13:27:46 -08:00
2026-01-21 04:08:09 +00:00

Better Auth Logo

Better Auth

The most comprehensive authentication framework for TypeScript
Learn more »

Discord · Website · Issues

npm npm version GitHub stars

About the Project

Better Auth is framework-agnostic authentication (and authorization) library for TypeScript. It provides a comprehensive set of features out of the box and includes a plugin ecosystem that simplifies adding advanced functionalities with minimal code in a short amount of time. Whether you need 2FA, multi-tenant support, or other complex features. It lets you focus on building your actual application instead of reinventing the wheel.

Why Better Auth

Authentication in the TypeScript ecosystem is a half-solved problem. Other open-source libraries often require a lot of additional code for anything beyond basic authentication. Rather than just pushing third-party services as the solution, I believe we can do better as a community—hence, Better Auth.

Contribution

Better Auth is a free and open source project licensed under the MIT License. You are free to do whatever you want with it.

You could help continuing its development by:

Security

If you discover a security vulnerability within Better Auth, please send an e-mail to security@better-auth.com.

All reports will be promptly addressed, and you'll be credited accordingly.

S
Description
No description provided
Readme
281 MiB
Latest
2026-04-16 05:05:30 -05:00
Languages
TypeScript 99.4%
CSS 0.3%
MDX 0.2%