v22.0.0

✨ Key Highlights

• Support for Angular v22: Added support for the latest Angular release, v22. [#725]

🙌 Special Thanks

This release was made possible with support from the following contributor.

• @twonky4

v21.0.0

✨ Key Highlights

• Support for Angular v21: Added support for the latest Angular release, v21. [#680,#695]

🙌 Special Thanks

This release was made possible with support from the following contributors.

• @ArnaudFlaesch
• @rOBloOm

v20.1.0

✨ Key Highlights

• Feature - Logout and login options can be passed to tokenRefreshFeature (#656)
• Fix - loginOptions in login inactivity test (#685)
• Fix - lint and test errors
• Fix - directive kaHasRoles re-render on token refresh and auth events (#671)
• Fix - Export Roles type from auth.guard.ts (#667)

🙌 Special Thanks

This release was made possible with support from the following contributors.

• @Maxouhell
• @no-felix
• @simon-b64
• @WuglyakBolgoink

v20.0.0

✨ Key Highlights

• Support for Angular v20: Added support for the latest Angular release, v20. [#644, #649]
• Documentation: Fixed incorrect references, added instructions for loading an external configuration file, and improved the AutoRefreshToken documentation. [#614, #629, #638, #639]
• Examples: Added a new example demonstrating how to load an external configuration file in fetch_config.
• Interceptor: Applied a security fix to properly evaluate asynchronous conditions in the custom bearer token interceptor. [#619]

🙌 Special Thanks

This release was made possible with support from the following contributors. Thank you all for your great work and for helping improve the quality of this library!

• @ArnaudFlaesch
• @rammba
• @lucagobbi
• @bartvanb
• @Tlepel

v19.0.2

Bug fixes ✨

• Solve issues #600 and #601, related to the Keycloak initialization and AuthGuardData values in createAuthGuard.

v19.0.1

✨ Key Highlights

• Documentation Update: Fixed broken links to the docs folder in the README.md file for improved navigation.

v19.0.0

✨ Key Highlights

• Functional Configuration: Simplify setup with provideKeycloak—no more KeycloakService or KeycloakAngularModule.
• Angular Signals: Reactive handling of Keycloak events for a cleaner, modern approach.
• Enhanced Interceptors: Add tokens with explicit configuration using includeBearerTokenInterceptor and customBearerTokenInterceptor.
• Role-Based Rendering: New *kaHasRoles directive for conditional rendering based on roles.
• Modular Features: Introduced withAutoRefreshToken for seamless token refresh and session management.
• Functional Route Guards: Create custom guards with createAuthGuard for streamlined route protection.

⚠️ Breaking Changes

• Deprecated KeycloakService, KeycloakAngularModule, KeycloakAuthGuard, and keycloakEvents$.
• Bearer tokens are no longer added automatically to all HTTP requests—explicit configuration required.

🛠️ Legacy Version Still Bundled

The legacy implementation of Keycloak-Angular (KeycloakService, KeycloakAngularModule, etc.) is still bundled in this release for backward compatibility. However, it is deprecated and will be removed in a future major version. We strongly encourage migrating to the new APIs.

🛠️ Migration Guide

See the migration guide. 🚀

v16.1.0

Features ✨

• Add support to Keycloak v26.

Contributors 🙏🏻

• Special thanks to @tomaThomas for the Keycloak v26 update.

v16.0.1

Bug fixes ✨

• Fix version compatibility table in README.md, to update support to keycloak v.25.

v16.0.0

Features ✨

• Add support to Angular v18
• Add support to Keycloak v25

Contributors 🙏🏻

• Special thanks to @giboow for the Angular v18 update and @TDesjardins for fixing a typo in the README.