ng-awesome-node-auth

An elegant, standalone Angular library providing interceptors, guards, and session management for frontends backed by awesome-node-auth.

This library is designed to be lightweight and 100% tree-shakable. You only ship the code you actually use.

🔗 Official Documentation

For detailed instructions on how to set up the Node.js backend, visit the official documentation: 👉 www.awesomenodeauth.com

✨ Features

• Full Session Management: Reactive signals for user state and authentication status.
• Smart Guards: authGuard and guestGuard for seamless navigation control.
• Auto-Interception: Transparently handles Access & Refresh tokens via an HTTP interceptor.
• CSRF Protection: Native support for standard CSRF token patterns.
• UI Synchronization: Optional provideAuthUi() to sync themes and feature flags with the backend.
• SSR Friendly: Fully compatible with Angular Server-Side Rendering.

🚀 Installation

Install the library in your Angular project:

npm install ng-awesome-node-auth

🛠️ Quick Start

1. Configure Providers (app.config.ts)

Add provideAuth to your application configuration.

import { ApplicationConfig } from '@angular/core';
import { provideAuth, provideAuthUi } from 'ng-awesome-node-auth';

export const appConfig: ApplicationConfig = {
  providers: [
    // Core Auth (Session, Interceptor, CSRF)
    provideAuth({ apiPrefix: '/api/auth' }),
    
    // Optional: UI Integration (Theme sync, config fetching)
    provideAuthUi(),
  ]
};

2. Protect Routes (app.routes.ts)

import { authGuard, guestGuard } from 'ng-awesome-node-auth';

export const routes: Routes = [
  { path: 'login', component: LoginComponent, canActivate: [guestGuard] },
  { path: 'dashboard', component: DashboardComponent, canActivate: [authGuard] }
];

🎨 Advanced UI Integration

When using provideAuthUi(), the library automatically:

1. Fetches Backend Config: Exposes feature flags (registration, forgot-password, etc.) via UiConfigService.
2. Synchronizes Themes: Real-time CSS variable updates when colors are changed in the Admin Panel.

Feature Flag Example:

import { inject } from '@angular/core';
import { UiConfigService } from 'ng-awesome-node-auth';

// In your component...
uiConfig = inject(UiConfigService);
canRegister = this.uiConfig.hasFeature('register');

📖 API Summary

• user(): Signal with current AuthUser or null.
• isAuthenticated(): Signal returning true if logged in.
• logout(): Clears session and redirects.
• checkSession(): Re-fetches the current session (/me).
• refreshToken(): Manually triggers a token refresh.

For full API reference and backend integration guides, visit www.awesomenodeauth.com.