@flusys/ng-auth 1.0.0-beta → 1.1.1-beta

package/README.md

@@ -406,6 +406,27 @@ getCompanyBranches(companyId);        // User's permitted branches
 - Email/password validation
 - Terms acceptance
 
+### Profile Page
+
+**ProfilePageComponent** (`/profile`)
+- Update name and phone
+- Upload profile picture (requires `PROFILE_UPLOAD_PROVIDER` from ng-storage)
+- Change password
+- View company/branch info (if company feature enabled)
+- View roles/actions (requires `PROFILE_PERMISSION_PROVIDER` from ng-iam)
+
+**Optional Provider Dependencies:**
+
+| Provider | Source | Feature Enabled |
+|----------|--------|-----------------|
+| `PROFILE_UPLOAD_PROVIDER` | ng-storage via `provideStorageProviders()` | Profile picture upload |
+| `PROFILE_PERMISSION_PROVIDER` | ng-iam via `provideIamProviders()` | Roles/actions display |
+
+**Graceful Degradation:**
+- If provider not registered, feature shows "not enabled" message
+- If service disabled in config, section is hidden
+- No errors thrown for missing optional providers
+
 ### Administration Pages
 
 **AdministrationPageComponent** (`/administration`)
@@ -513,6 +534,21 @@ import { ADMINISTRATION_ROUTES } from '@flusys/ng-auth';
 }
 ```
 
+### PROFILE_ROUTES
+
+User profile page routes.
+
+```typescript
+import { PROFILE_ROUTES } from '@flusys/ng-auth';
+
+// Route: /profile
+{
+  path: 'profile',
+  canActivate: [authGuard],
+  children: PROFILE_ROUTES
+}
+```
+
 ---
 
 ## Setup
@@ -529,6 +565,8 @@ import {
   provideAuthLayoutIntegration,
   provideAuthProviders
 } from '@flusys/ng-auth';
+import { provideIamProviders } from '@flusys/ng-iam';
+import { provideStorageProviders } from '@flusys/ng-storage';
 
 export const appConfig: ApplicationConfig = {
   providers: [
@@ -542,7 +580,9 @@ export const appConfig: ApplicationConfig = {
     ),
     { provide: APP_CONFIG, useValue: DEFAULT_APP_CONFIG },
     ...provideAuthLayoutIntegration(),
-    ...provideAuthProviders()
+    ...provideAuthProviders(),
+    ...provideIamProviders(),      // Enables permissions display on profile page
+    ...provideStorageProviders(),  // Enables profile picture upload
   ]
 };
 ```
@@ -551,7 +591,7 @@ export const appConfig: ApplicationConfig = {
 
 ```typescript
 import { Routes } from '@angular/router';
-import { authGuard, guestGuard, AUTH_ROUTES, ADMINISTRATION_ROUTES } from '@flusys/ng-auth';
+import { authGuard, guestGuard, AUTH_ROUTES, ADMINISTRATION_ROUTES, PROFILE_ROUTES } from '@flusys/ng-auth';
 
 export const routes: Routes = [
   { path: 'auth', children: AUTH_ROUTES },
@@ -560,7 +600,8 @@ export const routes: Routes = [
     canActivate: [authGuard],
     children: [
       { path: 'dashboard', loadComponent: () => import('./dashboard.component') },
-      { path: 'administration', children: ADMINISTRATION_ROUTES }
+      { path: 'administration', children: ADMINISTRATION_ROUTES },
+      { path: 'profile', children: PROFILE_ROUTES }
     ]
   }
 ];
@@ -770,5 +811,5 @@ providers: [
 
 ---
 
-**Last Updated:** 2026-02-15
+**Last Updated:** 2026-02-16
 **Angular Version:** 21