@flusys/ng-auth 1.0.1 → 1.1.0

package/README.md

@@ -5,6 +5,7 @@
 `@flusys/ng-auth` provides complete authentication functionality including login, registration, token management, company/branch selection, user administration, and permission handling.
 
 **Package:** `@flusys/ng-auth`
+**Version:** 1.1.0
 **Dependencies:** ng-core, ng-shared, ng-layout
 **Build:** `npm run build:ng-auth`
 
@@ -27,7 +28,9 @@
 │  Guards                                                      │
 │  ├── authGuard           (requires authentication)          │
 │  ├── guestGuard          (allows only unauthenticated)      │
-│  └── companyFeatureGuard (requires company feature enabled) │
+│  ├── companyFeatureGuard (requires company feature enabled) │
+│  ├── emailFeatureGuard   (requires email service enabled)   │
+│  └── signUpFeatureGuard  (requires sign-up enabled)         │
 ├─────────────────────────────────────────────────────────────┤
 │  Interceptors                                                │
 │  ├── authInterceptor     (adds JWT + tenant headers)        │
@@ -273,7 +276,39 @@ import { companyFeatureGuard } from '@flusys/ng-auth';
 }
 ```
 
-**Checks:** `services.auth.enabled` in APP_CONFIG. Redirects to `/` if disabled.
+**Checks:** `enableCompanyFeature` in APP_CONFIG. Redirects to `/` if disabled.
+
+### emailFeatureGuard
+
+Protects email-related routes (forgot-password, reset-password, verify-email).
+
+```typescript
+import { emailFeatureGuard } from '@flusys/ng-auth';
+
+{
+  path: 'auth/forgot-password',
+  canActivate: [emailFeatureGuard, guestGuard],
+  loadComponent: () => import('./forgot-password.component')
+}
+```
+
+**Checks:** `services.email.enabled` in APP_CONFIG. Redirects to `/auth/login` if disabled.
+
+### signUpFeatureGuard
+
+Protects registration route when sign-up is disabled.
+
+```typescript
+import { signUpFeatureGuard } from '@flusys/ng-auth';
+
+{
+  path: 'auth/register',
+  canActivate: [signUpFeatureGuard, guestGuard],
+  loadComponent: () => import('./register.component')
+}
+```
+
+**Checks:** `enableSignUp` in APP_CONFIG (defaults to `true`). Redirects to `/auth/login` if `false`.
 
 ---
 
@@ -408,12 +443,19 @@ All page components follow Angular 21 best practices:
 - Auto-selects if only one company/branch available
 - Stores returnUrl for post-login redirect
 - Responsive form layout with mobile padding
+- **Conditional UI based on config:**
+  - "Forgot password?" link hidden when `services.email.enabled: false`
+  - "Sign Up" link hidden when `enableSignUp: false`
 
 **RegisterPageComponent** (`/auth/register`)
 - User registration with optional company creation
 - Two-column responsive grid layout
 - Email/password validation with signal forms
 - Company details section (when company feature enabled)
+- **Default company/branch support:**
+  - When `defaultCompanySlug` is set: pre-fills company code field and makes it readonly
+  - When `defaultBranchSlug` is set: pre-fills branch code field and makes it readonly
+  - "Create new company" option hidden when defaults are configured
 
 **ForgotPasswordPageComponent** (`/auth/forgot-password`)
 - Email input with validation
@@ -1091,7 +1133,8 @@ If using `*hasPermission` directive, it will also respect wildcard:
 
 ---
 
-**Last Updated:** 2026-02-21
+**Last Updated:** 2026-02-23
+**Version:** 1.1.0
 **Angular Version:** 21
 
 ## Component Checklist

package/fesm2022/flusys-ng-auth.mjs

@@ -1,7 +1,7 @@
 import { HttpClient } from '@angular/common/http';
 import * as i0 from '@angular/core';
 import { inject, Injectable, signal, computed, effect, PLATFORM_ID, ChangeDetectionStrategy, Component, untracked, DestroyRef, input, output, makeStateKey, TransferState } from '@angular/core';
-import { APP_CONFIG, getServiceUrl, isCompanyFeatureEnabled, isFeatureEnabled, getPermissionMode } from '@flusys/ng-core';
+import { APP_CONFIG, getServiceUrl, isCompanyFeatureEnabled, isEmailFeatureEnabled, isSignUpEnabled, isFeatureEnabled, getPermissionMode, getDefaultCompanySlug, getDefaultBranchSlug } from '@flusys/ng-core';
 import * as i2$1 from '@angular/router';
 import { Router, RouterOutlet, RouterLink, RouterLinkActive, ActivatedRoute } from '@angular/router';
 import { of, timeout, switchMap, map, tap, catchError, shareReplay, finalize, BehaviorSubject, throwError, filter, take, firstValueFrom } from 'rxjs';
@@ -672,6 +672,22 @@ const companyFeatureGuard = () => {
         return router.createUrlTree(['/']);
     return true;
 };
+/** Protects routes requiring email feature to be enabled */
+const emailFeatureGuard = () => {
+    const router = inject(Router);
+    const appConfig = inject(APP_CONFIG);
+    if (!appConfig.services.email?.enabled)
+        return router.createUrlTree([AUTH_ENDPOINTS.LOGIN]);
+    return true;
+};
+/** Protects routes requiring sign-up feature to be enabled */
+const signUpFeatureGuard = () => {
+    const router = inject(Router);
+    const appConfig = inject(APP_CONFIG);
+    if (appConfig.enableSignUp === false)
+        return router.createUrlTree([AUTH_ENDPOINTS.LOGIN]);
+    return true;
+};
 
 /** Endpoints that need withCredentials for cookie handling */
 const COOKIE_ENDPOINTS = [
@@ -789,21 +805,22 @@ const AUTH_ROUTES = [
             {
                 path: 'register',
                 loadComponent: () => Promise.resolve().then(function () { return registerPage_component; }).then((m) => m.RegisterPageComponent),
-                canActivate: [guestGuard],
+                canActivate: [signUpFeatureGuard, guestGuard],
             },
             {
                 path: 'forgot-password',
                 loadComponent: () => Promise.resolve().then(function () { return forgotPasswordPage_component; }).then((m) => m.ForgotPasswordPageComponent),
-                canActivate: [guestGuard],
+                canActivate: [emailFeatureGuard, guestGuard],
             },
             {
                 path: 'reset-password',
                 loadComponent: () => Promise.resolve().then(function () { return resetPasswordPage_component; }).then((m) => m.ResetPasswordPageComponent),
-                canActivate: [guestGuard],
+                canActivate: [emailFeatureGuard, guestGuard],
             },
             {
                 path: 'verify-email',
                 loadComponent: () => Promise.resolve().then(function () { return verifyEmailPage_component; }).then((m) => m.VerifyEmailPageComponent),
+                canActivate: [emailFeatureGuard],
             },
             {
                 path: '',
@@ -2862,6 +2879,8 @@ class LoginPageComponent {
     });
     isSelectionFormValid = computed(() => this.selectionForm().valid(), ...(ngDevMode ? [{ debugName: "isSelectionFormValid" }] : []));
     companyFeatureEnabled = computed(() => isCompanyFeatureEnabled(this.appConfig), ...(ngDevMode ? [{ debugName: "companyFeatureEnabled" }] : []));
+    emailFeatureEnabled = computed(() => isEmailFeatureEnabled(this.appConfig), ...(ngDevMode ? [{ debugName: "emailFeatureEnabled" }] : []));
+    signUpEnabled = computed(() => isSignUpEnabled(this.appConfig), ...(ngDevMode ? [{ debugName: "signUpEnabled" }] : []));
     sessionId = null;
     companies = signal([], ...(ngDevMode ? [{ debugName: "companies" }] : []));
     userName = signal('', ...(ngDevMode ? [{ debugName: "userName" }] : []));
@@ -3144,11 +3163,13 @@ class LoginPageComponent {
                       [formField]="loginForm.rememberMe" />
                     <span>Remember me</span>
                   </label>
-                  <span
-                    class="font-medium no-underline ml-2 text-right cursor-pointer text-primary"
-                    routerLink="/auth/forgot-password">
-                    Forgot password?
-                  </span>
+                  @if (emailFeatureEnabled()) {
+                    <span
+                      class="font-medium no-underline ml-2 text-right cursor-pointer text-primary"
+                      routerLink="/auth/forgot-password">
+                      Forgot password?
+                    </span>
+                  }
                 </div>
 
                 <p-button
@@ -3158,12 +3179,14 @@ class LoginPageComponent {
                   [loading]="isLoading()"
                   [disabled]="!isLoginFormValid() || isLoading()" />
 
-                <div class="flex items-center justify-center mt-4 gap-2">
-                  <span class="font-medium">Don't have an account?</span>
-                  <a routerLink="/auth/register" class="font-semibold text-primary cursor-pointer">
-                    Sign Up
-                  </a>
-                </div>
+                @if (signUpEnabled()) {
+                  <div class="flex items-center justify-center mt-4 gap-2">
+                    <span class="font-medium">Don't have an account?</span>
+                    <a routerLink="/auth/register" class="font-semibold text-primary cursor-pointer">
+                      Sign Up
+                    </a>
+                  </div>
+                }
               </form>
             }
 
@@ -3348,11 +3371,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.5", ngImpor
                       [formField]="loginForm.rememberMe" />
                     <span>Remember me</span>
                   </label>
-                  <span
-                    class="font-medium no-underline ml-2 text-right cursor-pointer text-primary"
-                    routerLink="/auth/forgot-password">
-                    Forgot password?
-                  </span>
+                  @if (emailFeatureEnabled()) {
+                    <span
+                      class="font-medium no-underline ml-2 text-right cursor-pointer text-primary"
+                      routerLink="/auth/forgot-password">
+                      Forgot password?
+                    </span>
+                  }
                 </div>
 
                 <p-button
@@ -3362,12 +3387,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.5", ngImpor
                   [loading]="isLoading()"
                   [disabled]="!isLoginFormValid() || isLoading()" />
 
-                <div class="flex items-center justify-center mt-4 gap-2">
-                  <span class="font-medium">Don't have an account?</span>
-                  <a routerLink="/auth/register" class="font-semibold text-primary cursor-pointer">
-                    Sign Up
-                  </a>
-                </div>
+                @if (signUpEnabled()) {
+                  <div class="flex items-center justify-center mt-4 gap-2">
+                    <span class="font-medium">Don't have an account?</span>
+                    <a routerLink="/auth/register" class="font-semibold text-primary cursor-pointer">
+                      Sign Up
+                    </a>
+                  </div>
+                }
               </form>
             }
 
@@ -4343,6 +4370,10 @@ class RegisterPageComponent {
     returnUrl = input('', ...(ngDevMode ? [{ debugName: "returnUrl" }] : []));
     isLoading = signal(false, ...(ngDevMode ? [{ debugName: "isLoading" }] : []));
     companyFeatureEnabled = computed(() => isCompanyFeatureEnabled(this.appConfig), ...(ngDevMode ? [{ debugName: "companyFeatureEnabled" }] : []));
+    defaultCompanySlug = computed(() => getDefaultCompanySlug(this.appConfig), ...(ngDevMode ? [{ debugName: "defaultCompanySlug" }] : []));
+    defaultBranchSlug = computed(() => getDefaultBranchSlug(this.appConfig), ...(ngDevMode ? [{ debugName: "defaultBranchSlug" }] : []));
+    hasDefaultCompany = computed(() => !!this.defaultCompanySlug(), ...(ngDevMode ? [{ debugName: "hasDefaultCompany" }] : []));
+    hasDefaultBranch = computed(() => !!this.defaultBranchSlug(), ...(ngDevMode ? [{ debugName: "hasDefaultBranch" }] : []));
     userFormModel = signal({
         name: '',
         email: '',
@@ -4390,14 +4421,24 @@ class RegisterPageComponent {
         return userValid;
     }, ...(ngDevMode ? [{ debugName: "isFormValid" }] : []));
     constructor() {
+        // Initialize with defaults from config or query params
         effect(() => {
             const params = this.queryParamMap();
             if (!params || this.companySlugInitialized)
                 return;
             this.companySlugInitialized = true;
-            const companySlug = params.get('companySlug');
-            if (companySlug) {
-                this.companyFormModel.update((model) => ({ ...model, companySlug }));
+            // Priority: config defaults > query params
+            const configCompanySlug = this.defaultCompanySlug();
+            const configBranchSlug = this.defaultBranchSlug();
+            const queryCompanySlug = params.get('companySlug');
+            const companySlug = configCompanySlug || queryCompanySlug || '';
+            const branchSlug = configBranchSlug || '';
+            if (companySlug || branchSlug) {
+                this.companyFormModel.update((model) => ({
+                    ...model,
+                    companySlug,
+                    branchSlug,
+                }));
             }
         });
     }
@@ -4603,22 +4644,28 @@ class RegisterPageComponent {
                       Company Details
                     </div>
                     <span class="text-muted-color font-medium"
-                      >Join existing or create new company</span
+                      >@if (hasDefaultCompany()) {
+                        You will join the default company
+                      } @else {
+                        Join existing or create new company
+                      }</span
                     >
                   </div>
 
-                  <div class="mb-4">
-                    <label
-                      class="p-checkbox-native"
-                      (click)="onCreateCompanyToggle()"
-                    >
-                      <input
-                        type="checkbox"
-                        [formField]="companyForm.createNewCompany"
-                      />
-                      <span>Create new company</span>
-                    </label>
-                  </div>
+                  @if (!hasDefaultCompany()) {
+                    <div class="mb-4">
+                      <label
+                        class="p-checkbox-native"
+                        (click)="onCreateCompanyToggle()"
+                      >
+                        <input
+                          type="checkbox"
+                          [formField]="companyForm.createNewCompany"
+                        />
+                        <span>Create new company</span>
+                      </label>
+                    </div>
+                  }
 
                   @if (!companyFormModel().createNewCompany) {
                     <div class="grid grid-cols-1 md:grid-cols-2 gap-4 mb-4">
@@ -4626,29 +4673,51 @@ class RegisterPageComponent {
                         <label for="companySlug" class="block font-medium mb-2"
                           >Company Code</label
                         >
-                        <input
-                          pInputText
-                          id="companySlug"
-                          [formField]="companyForm.companySlug"
-                          placeholder="Company code/slug"
-                          class="w-full"
-                        />
-                        <small class="text-muted-color"
-                          >Enter company code to join</small
-                        >
+                        @if (hasDefaultCompany()) {
+                          <input
+                            pInputText
+                            id="companySlug"
+                            [value]="defaultCompanySlug()"
+                            class="w-full bg-surface-100"
+                            readonly
+                          />
+                          <small class="text-muted-color">Pre-configured company</small>
+                        } @else {
+                          <input
+                            pInputText
+                            id="companySlug"
+                            [formField]="companyForm.companySlug"
+                            placeholder="Company code/slug"
+                            class="w-full"
+                          />
+                          <small class="text-muted-color"
+                            >Enter company code to join</small
+                          >
+                        }
                       </div>
 
                       <div>
                         <label for="branchSlug" class="block font-medium mb-2"
                           >Branch Code</label
                         >
-                        <input
-                          pInputText
-                          id="branchSlug"
-                          [formField]="companyForm.branchSlug"
-                          placeholder="Branch code (optional)"
-                          class="w-full"
-                        />
+                        @if (hasDefaultBranch()) {
+                          <input
+                            pInputText
+                            id="branchSlug"
+                            [value]="defaultBranchSlug()"
+                            class="w-full bg-surface-100"
+                            readonly
+                          />
+                          <small class="text-muted-color">Pre-configured branch</small>
+                        } @else {
+                          <input
+                            pInputText
+                            id="branchSlug"
+                            [formField]="companyForm.branchSlug"
+                            placeholder="Branch code (optional)"
+                            class="w-full"
+                          />
+                        }
                       </div>
                     </div>
                   } @else {
@@ -4842,22 +4911,28 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.5", ngImpor
                       Company Details
                     </div>
                     <span class="text-muted-color font-medium"
-                      >Join existing or create new company</span
+                      >@if (hasDefaultCompany()) {
+                        You will join the default company
+                      } @else {
+                        Join existing or create new company
+                      }</span
                     >
                   </div>
 
-                  <div class="mb-4">
-                    <label
-                      class="p-checkbox-native"
-                      (click)="onCreateCompanyToggle()"
-                    >
-                      <input
-                        type="checkbox"
-                        [formField]="companyForm.createNewCompany"
-                      />
-                      <span>Create new company</span>
-                    </label>
-                  </div>
+                  @if (!hasDefaultCompany()) {
+                    <div class="mb-4">
+                      <label
+                        class="p-checkbox-native"
+                        (click)="onCreateCompanyToggle()"
+                      >
+                        <input
+                          type="checkbox"
+                          [formField]="companyForm.createNewCompany"
+                        />
+                        <span>Create new company</span>
+                      </label>
+                    </div>
+                  }
 
                   @if (!companyFormModel().createNewCompany) {
                     <div class="grid grid-cols-1 md:grid-cols-2 gap-4 mb-4">
@@ -4865,29 +4940,51 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.5", ngImpor
                         <label for="companySlug" class="block font-medium mb-2"
                           >Company Code</label
                         >
-                        <input
-                          pInputText
-                          id="companySlug"
-                          [formField]="companyForm.companySlug"
-                          placeholder="Company code/slug"
-                          class="w-full"
-                        />
-                        <small class="text-muted-color"
-                          >Enter company code to join</small
-                        >
+                        @if (hasDefaultCompany()) {
+                          <input
+                            pInputText
+                            id="companySlug"
+                            [value]="defaultCompanySlug()"
+                            class="w-full bg-surface-100"
+                            readonly
+                          />
+                          <small class="text-muted-color">Pre-configured company</small>
+                        } @else {
+                          <input
+                            pInputText
+                            id="companySlug"
+                            [formField]="companyForm.companySlug"
+                            placeholder="Company code/slug"
+                            class="w-full"
+                          />
+                          <small class="text-muted-color"
+                            >Enter company code to join</small
+                          >
+                        }
                       </div>
 
                       <div>
                         <label for="branchSlug" class="block font-medium mb-2"
                           >Branch Code</label
                         >
-                        <input
-                          pInputText
-                          id="branchSlug"
-                          [formField]="companyForm.branchSlug"
-                          placeholder="Branch code (optional)"
-                          class="w-full"
-                        />
+                        @if (hasDefaultBranch()) {
+                          <input
+                            pInputText
+                            id="branchSlug"
+                            [value]="defaultBranchSlug()"
+                            class="w-full bg-surface-100"
+                            readonly
+                          />
+                          <small class="text-muted-color">Pre-configured branch</small>
+                        } @else {
+                          <input
+                            pInputText
+                            id="branchSlug"
+                            [formField]="companyForm.branchSlug"
+                            placeholder="Branch code (optional)"
+                            class="w-full"
+                          />
+                        }
                       </div>
                     </div>
                   } @else {
@@ -6861,5 +6958,5 @@ var verifyEmailPage_component = /*#__PURE__*/Object.freeze({
  * Generated bundle index. Do not edit.
  */
 
-export { ADMINISTRATION_ROUTES, AUTH_ENDPOINTS, AUTH_ROUTES, AdministrationPageComponent, AuthApiService, AuthCompanyApiProviderAdapter, AuthInitService, AuthLayoutApiAdapter, AuthLayoutStateAdapter, AuthStateProviderAdapter, AuthStateService, AuthUserPermissionProviderAdapter, AuthUserProviderAdapter, BranchApiService, BranchFormComponent, BranchListComponent, CompanyApiService, CompanyFormComponent, CompanyListComponent, ForgotPasswordPageComponent, LoginPageComponent, PROFILE_ROUTES, ProfilePageComponent, RegisterPageComponent, ResetPasswordPageComponent, TokenRefreshStateService, UserApiService, UserBranchPermissionDialogComponent, UserCompanyPermissionDialogComponent, UserFormComponent, UserListComponent, UserPermissionApiService, VerifyEmailPageComponent, authGuard, authInterceptor, companyFeatureGuard, guestGuard, isCompanySelectionResponse, isEmailVerificationRequired, isEndpoint, isLoginResponse, provideAuthLayoutIntegration, provideAuthProviders, tokenRefreshInterceptor };
+export { ADMINISTRATION_ROUTES, AUTH_ENDPOINTS, AUTH_ROUTES, AdministrationPageComponent, AuthApiService, AuthCompanyApiProviderAdapter, AuthInitService, AuthLayoutApiAdapter, AuthLayoutStateAdapter, AuthStateProviderAdapter, AuthStateService, AuthUserPermissionProviderAdapter, AuthUserProviderAdapter, BranchApiService, BranchFormComponent, BranchListComponent, CompanyApiService, CompanyFormComponent, CompanyListComponent, ForgotPasswordPageComponent, LoginPageComponent, PROFILE_ROUTES, ProfilePageComponent, RegisterPageComponent, ResetPasswordPageComponent, TokenRefreshStateService, UserApiService, UserBranchPermissionDialogComponent, UserCompanyPermissionDialogComponent, UserFormComponent, UserListComponent, UserPermissionApiService, VerifyEmailPageComponent, authGuard, authInterceptor, companyFeatureGuard, emailFeatureGuard, guestGuard, isCompanySelectionResponse, isEmailVerificationRequired, isEndpoint, isLoginResponse, provideAuthLayoutIntegration, provideAuthProviders, signUpFeatureGuard, tokenRefreshInterceptor };
 //# sourceMappingURL=flusys-ng-auth.mjs.map