@flusys/ng-core 1.1.0 → 1.2.0-rc.1

package/README.md

@@ -1,632 +1,153 @@
-# @flusys/ng-core Package Guide
+# @flusys/ng-core
 
-## Overview
+Foundation library for the FLUSYS Angular platform — app configuration token, base HTTP service, loader service, and HTTP interceptors.
 
-`@flusys/ng-core` is the foundation package that provides core functionality for all FLUSYS Angular libraries and applications. It contains configuration management, HTTP interceptors, base services, and type definitions.
-
-**Key Principle:** ng-core has NO internal dependencies on other @flusys packages. All other packages depend on ng-core.
-
-## Package Information
-
-- **Package:** `@flusys/ng-core`
-- **Version:** 1.1.0
-- **Dependencies:** None (base package)
-- **Dependents:** ng-shared, ng-layout, ng-auth, ng-iam, ng-storage, flusysng
-- **Build Command:** `npm run build:ng-core`
-
-## Package Structure
-
-```
-ng-core/
-├── components/
-│   ├── lib-app-config/
-│   │   ├── lib-app-config.component.ts
-│   │   ├── lib-app-config.component.html
-│   │   └── lib-app-config.component.scss
-│   └── public-api.ts
-├── interceptors/
-│   ├── api-loader.interceptor.ts
-│   ├── error-catching.interceptor.ts
-│   └── public-api.ts
-├── interfaces/
-│   ├── app-config.interface.ts
-│   └── public-api.ts
-├── services/
-│   ├── api-loader.service.ts
-│   ├── base-api.service.ts
-│   └── public-api.ts
-├── ng-package.json
-├── package.json
-├── tsconfig.lib.json
-├── tsconfig.lib.prod.json
-└── public-api.ts
-```
-
-## Public API Exports
-
-```typescript
-// public-api.ts - re-exports from each module's public-api
-export * from './components/public-api';
-export * from './interceptors/public-api';
-export * from './interfaces/public-api';
-export * from './services/public-api';
-```
+[![npm version](https://img.shields.io/npm/v/@flusys/ng-core.svg)](https://www.npmjs.com/package/@flusys/ng-core)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 ---
 
-## Features
-
-### 1. APP_CONFIG (Configuration Management)
-
-Centralized configuration system with dynamic service URLs and feature flags.
-
-#### IAppConfig Interface
-
-```typescript
-export type PermissionMode = 'rbac' | 'direct' | 'full';
-
-export interface IServiceConfig {
-  baseUrl: string;
-  enabled: boolean;
-}
-
-export interface IAuthorConfig {
-  name: string;
-  url: string;
-}
-
-export interface IRegistrationDefaults {
-  companySlug?: string;                  // Pre-fill company code on registration
-  branchSlug?: string;                   // Pre-fill branch code on registration
-}
+## Installation
 
-export interface IAppConfig {
-  appName: string;
-  author?: IAuthorConfig;                // Author/Brand info for footer attribution
-  apiBaseUrl: string;                    // Default fallback URL
-  enableCompanyFeature: boolean;         // Company/branch selection
-  enableSignUp?: boolean;                // Enable registration (default: true)
-  registrationDefaults?: IRegistrationDefaults;  // Pre-fill registration fields
-
-  services: {
-    auth: IServiceConfig;
-    administration: IServiceConfig;
-    iam: IServiceConfig;
-    storage: IStorageServiceConfig;      // Extends IServiceConfig with defaultStorageConfigId
-    formBuilder: IServiceConfig;
-    email: IServiceConfig;
-  };
-
-  multiTenant: {
-    enabled: boolean;                    // true = multi-tenant DB, false = single DB
-    tenantHeader: string;                // Header name (e.g., 'x-tenant-id')
-    tenantId?: string;                   // Optional tenant ID value
-  };
-
-  permissionMode?: PermissionMode;       // Defaults to 'full'
-}
+```bash
+npm install @flusys/ng-core
 ```
 
-#### APP_CONFIG Token
+---
 
-```typescript
-export const APP_CONFIG = new InjectionToken<IAppConfig>('APP_CONFIG');
-```
+## 1. Register APP_CONFIG and Interceptors
 
-**Provider setup in app.config.ts:**
+Provide the config token and HTTP interceptors once in `app.config.ts`. Every FLUSYS package reads from `APP_CONFIG`.
 
 ```typescript
-import { APP_CONFIG } from '@flusys/ng-core';
-import { DEFAULT_APP_CONFIG } from './config/app.config';
+import { ApplicationConfig } from "@angular/core";
+import { provideHttpClient, withFetch, withInterceptors } from "@angular/common/http";
+import { APP_CONFIG, errorCatchingInterceptor, apiLoaderInterceptor } from "@flusys/ng-core";
 
 export const appConfig: ApplicationConfig = {
   providers: [
-    { provide: APP_CONFIG, useValue: DEFAULT_APP_CONFIG },
-  ]
+    {
+      provide: APP_CONFIG,
+      useValue: {
+        appName: "My App",
+        appLogo: "/assets/logo.png",
+        apiBaseUrl: "http://localhost:2002",
+        production: false,
+        permissionMode: "FULL", // 'RBAC' | 'DIRECT' | 'FULL'
+        multiTenant: false,
+        services: {
+          auth: {
+            enabled: true,
+            features: {
+              signUp: true,
+              emailVerification: true,
+              companySelection: true,
+            },
+          },
+          iam: { enabled: true },
+          storage: { enabled: true },
+          formBuilder: { enabled: false },
+          email: { enabled: false },
+          eventManager: { enabled: false },
+          notification: { enabled: false, socketUrl: "ws://localhost:2002" }, // optional
+          localization: { enabled: false },
+        },
+      },
+    },
+    provideHttpClient(
+      withFetch(),
+      withInterceptors([
+        // authInterceptor,         // from @flusys/ng-auth — add first
+        // tokenRefreshInterceptor, // from @flusys/ng-auth — add second
+        errorCatchingInterceptor, // shows toast on non-401/403 errors
+        apiLoaderInterceptor, // drives global progress bar
+      ]),
+    ),
+  ],
 };
 ```
 
-#### Environment Structure (Shared Base Pattern)
+Add `<lib-app-config />` once in your app root template. It renders the global toast, confirm dialog, and progress bar.
 
-All common configuration is extracted to a shared base:
-
-```typescript
-// projects/flusysng/src/environments/environment.base.ts
-export const BASE_ENVIRONMENT = {
-  appName: 'FLUSYS',
-  multiTenant: { enabled: false, tenantHeader: 'x-tenant-id' },
-  storage: { apiPath: '/upload/file', maxFileSize: 10485760, allowedMimeTypes: [...] },
-};
-
-// projects/flusysng/src/environments/environment.ts (development)
-import { BASE_ENVIRONMENT } from './environment.base';
-
-export const environment = {
-  ...BASE_ENVIRONMENT,
-  production: false,
-  apiBaseUrl: 'http://localhost:2002',
-  services: {
-    auth: { baseUrl: 'http://localhost:2002/auth', enabled: true },
-    administration: { baseUrl: 'http://localhost:2002/administration', enabled: true },
-    iam: { baseUrl: 'http://localhost:2002/iam', enabled: true },
-    storage: { baseUrl: 'http://localhost:2002/storage', enabled: true, defaultStorageConfigId: '...' },
-    formBuilder: { baseUrl: 'http://localhost:2002/form-builder', enabled: true },
-    email: { baseUrl: 'http://localhost:2002/email', enabled: true },
-  },
-};
-```
-
-#### Helper Functions
+---
 
-```typescript
-import {
-  getDatabaseMode,
-  isFeatureEnabled,
-  getServiceUrl,
-  isServiceEnabled,
-  isCompanyFeatureEnabled,
-  isStorageFeatureEnabled,
-  isFormBuilderFeatureEnabled,
-  isEmailFeatureEnabled,
-  getPermissionMode,
-  getDefaultStorageConfigId,
-  isSignUpEnabled,
-  getDefaultCompanySlug,
-  getDefaultBranchSlug,
-  getRegistrationDefaults,
-} from '@flusys/ng-core';
-```
+## 2. BaseApiService
 
-| Function | Signature | Description |
-|----------|-----------|-------------|
-| `getDatabaseMode` | `(config) → 'single' \| 'multi-tenant'` | Get database mode from `multiTenant.enabled` |
-| `isFeatureEnabled` | `(config, feature: ServiceName) → boolean` | Check if a service feature is enabled |
-| `getServiceUrl` | `(config, serviceName: ServiceName) → string` | Get service URL or fallback to `apiBaseUrl` |
-| `isServiceEnabled` | `(config, serviceName: ServiceName) → boolean` | Check if a service is enabled |
-| `isCompanyFeatureEnabled` | `(config) → boolean` | Check `enableCompanyFeature` flag |
-| `isStorageFeatureEnabled` | `(config) → boolean` | Check `services.storage.enabled` |
-| `isFormBuilderFeatureEnabled` | `(config) → boolean` | Check `services.formBuilder.enabled` |
-| `isEmailFeatureEnabled` | `(config) → boolean` | Check `services.email.enabled` |
-| `getPermissionMode` | `(config) → PermissionMode` | Get permission mode (defaults to `'full'`) |
-| `getDefaultStorageConfigId` | `(config) → string \| undefined` | Get `services.storage.defaultStorageConfigId` |
-| `isSignUpEnabled` | `(config) → boolean` | Check `enableSignUp` flag (defaults to `true`) |
-| `getDefaultCompanySlug` | `(config) → string \| undefined` | Get `registrationDefaults.companySlug` |
-| `getDefaultBranchSlug` | `(config) → string \| undefined` | Get `registrationDefaults.branchSlug` |
-| `getRegistrationDefaults` | `(config) → IRegistrationDefaults \| undefined` | Get full registration defaults object |
-
-**ServiceName Type:** `'auth' | 'administration' | 'iam' | 'storage' | 'formBuilder' | 'email'`
-
-#### Constants
+Extend to create a typed service for any POST-only RPC endpoint. The base URL is derived from `APP_CONFIG.apiBaseUrl`.
 
 ```typescript
-export const DEFAULT_APP_NAME = 'FLUSYS';
-export const DEFAULT_AUTHOR: IAuthorConfig = {
-  name: 'Flusys',
-  url: 'https://flusys.vercel.app',
-};
-```
+import { Injectable } from "@angular/core";
+import { BaseApiService } from "@flusys/ng-core";
 
-#### Configuration Modes
-
-**Mode 1: Simple (No Company, No IAM)**
-```typescript
-{
-  enableCompanyFeature: false,
-  multiTenant: { enabled: false, tenantHeader: 'x-tenant-id' },
-  services: {
-    auth: { baseUrl: '...', enabled: false },
-    administration: { baseUrl: '...', enabled: false },
-    iam: { baseUrl: '...', enabled: false },
-    storage: { baseUrl: '...', enabled: false },
-    formBuilder: { baseUrl: '...', enabled: false },
-    email: { baseUrl: '...', enabled: false },
+@Injectable({ providedIn: "root" })
+export class ProductService extends BaseApiService {
+  getAll() {
+    return this.http.post(`${this.baseUrl}/products/get-all`, {});
   }
-}
-```
 
-**Mode 2: Single DB + Multi-Company**
-```typescript
-{
-  enableCompanyFeature: true,
-  multiTenant: { enabled: false, tenantHeader: 'x-tenant-id' },
-  services: {
-    auth: { baseUrl: 'http://localhost:2002/auth', enabled: true },
-    administration: { baseUrl: 'http://localhost:2002/administration', enabled: true },
-    iam: { baseUrl: 'http://localhost:2002/iam', enabled: true },
-    storage: { baseUrl: 'http://localhost:2002/storage', enabled: true, defaultStorageConfigId: '...' },
-    formBuilder: { baseUrl: 'http://localhost:2002/form-builder', enabled: true },
-    email: { baseUrl: 'http://localhost:2002/email', enabled: true },
-  }
-}
-```
-
-**Mode 3: Multi-Tenant**
-```typescript
-{
-  enableCompanyFeature: true,
-  multiTenant: { enabled: true, tenantHeader: 'x-tenant-id', tenantId: 'tenant-123' },
-  services: {
-    auth: { baseUrl: 'http://localhost:2002/auth', enabled: true },
-    administration: { baseUrl: 'http://localhost:2002/administration', enabled: true },
-    iam: { baseUrl: 'http://localhost:2002/iam', enabled: true },
-    storage: { baseUrl: 'http://localhost:2002/storage', enabled: true, defaultStorageConfigId: '...' },
-    formBuilder: { baseUrl: 'http://localhost:2002/form-builder', enabled: true },
-    email: { baseUrl: 'http://localhost:2002/email', enabled: true },
+  findById(id: string) {
+    return this.http.post(this.getUrl(`products/get/${id}`), {});
   }
 }
 ```
 
 ---
 
-### 2. HTTP Interceptors
-
-ng-core provides two functional interceptors. Both use the modern Angular functional interceptor pattern.
+## 3. ApiLoaderService — Global Progress Bar
 
-#### apiLoaderInterceptor
-
-Tracks HTTP request loading state with tagged loaders. Uses a custom `x-loader-tag` header to group related requests.
-
-**Behavior:**
-1. Reads `x-loader-tag` header from request (defaults to `'default'`)
-2. Increments loader count for that tag
-3. Removes `x-loader-tag` header before sending to backend
-4. Decrements loader count on request completion (success or error)
+`apiLoaderInterceptor` automatically increments/decrements a reference count per request. `show` is `true` while any request is in flight.
 
 ```typescript
-import { apiLoaderInterceptor } from '@flusys/ng-core';
-
-// Tag a specific request
-this.http.post('/api/users/get-all', filter, {
-  headers: new HttpHeaders({ 'x-loader-tag': 'users-list' })
-});
+import { ApiLoaderService } from '@flusys/ng-core';
 
-// Check loading state for that tag
-apiLoaderService.getLoader('users-list')(); // true while loading
+readonly loader = inject(ApiLoaderService);
+// loader.show — Signal<boolean>
 ```
 
-#### errorCatchingInterceptor
-
-Displays user-friendly error toast messages for failed HTTP requests via PrimeNG `MessageService`.
-
-**Behavior:**
-- Skips 401 errors (handled by `tokenRefreshInterceptor` in ng-auth)
-- Skips 403 errors (handled by permission denied UI in components)
-- Skips `/check-login` endpoint errors (expected to fail when not logged in)
-- Skips requests with `SKIP_ERROR_TOAST` context token set to `true`
-- Uses backend's error title (`error.error.error`) as toast summary
-- Uses backend's error message (`error.error.message`) as toast detail
-- Falls back to status-based defaults for unknown error formats
-- SSR-safe: only displays messages in browser (`isPlatformBrowser` check)
-
-**SKIP_ERROR_TOAST Context Token:**
-
-Use this to skip global error toast for specific requests where the component handles errors locally:
+Tag requests to get per-section loading signals:
 
 ```typescript
-import { HttpContext } from '@angular/common/http';
-import { SKIP_ERROR_TOAST } from '@flusys/ng-core';
+import { HttpHeaders } from "@angular/common/http";
 
-this.http.post(url, data, {
-  context: new HttpContext().set(SKIP_ERROR_TOAST, true)
+this.http.post(url, body, {
+  headers: new HttpHeaders({ "x-loader-tag": "user-list" }),
 });
-```
 
-#### Interceptor Chain
-
-```typescript
-import { errorCatchingInterceptor, apiLoaderInterceptor } from '@flusys/ng-core';
-import { authInterceptor, tokenRefreshInterceptor } from '@flusys/ng-auth';
-
-provideHttpClient(
-  withFetch(),
-  withInterceptors([
-    authInterceptor,           // from @flusys/ng-auth (adds auth + tenant headers)
-    tokenRefreshInterceptor,   // from @flusys/ng-auth (handles 401 + token refresh)
-    errorCatchingInterceptor,  // from @flusys/ng-core (displays error toasts)
-    apiLoaderInterceptor,      // from @flusys/ng-core (tracks loading state)
-  ])
-)
+const isUserListLoading = this.loader.getLoader("user-list"); // Signal<boolean>
 ```
 
-**Order matters:** Auth interceptors first, then error handling, then loader tracking.
-
 ---
 
-### 3. Services
-
-#### ApiLoaderService
-
-Signal-based loading state management with tagged loaders. Provided at root level.
-
-**Signals:**
-
-| Signal | Type | Description |
-|--------|------|-------------|
-| `show` | `Signal<boolean>` | `true` if ANY loader tag has active requests |
-
-**Methods:**
-
-| Method | Parameters | Description |
-|--------|-----------|-------------|
-| `increase(name?)` | `name: string = 'default'` | Increment loader count for a tag |
-| `decrease(name?)` | `name: string = 'default'` | Decrement loader count for a tag (min 0) |
-| `getLoader(name)` | `name: string` | Get computed `Signal<boolean>` for a specific tag |
-
-**Properties:**
+## 4. Skip Error Toast Per Request
 
-| Property | Type | Description |
-|----------|------|-------------|
-| `DEFAULT_TAG` | `string` | Default tag name (`'default'`) |
-
-**Usage:**
+Opt out of the global error toast for requests you handle locally:
 
 ```typescript
-// Global loading state
-@if (apiLoaderService.show()) {
-  <p-progressBar mode="indeterminate" />
-}
-
-// Tag-specific loading state
-@if (apiLoaderService.getLoader('users-list')()) {
-  <p>Loading users...</p>
-}
-```
-
-#### BaseApiService
-
-Abstract base class for API services. Provides automatic URL resolution from APP_CONFIG.
-
-**Protected members:**
-
-| Member | Type | Description |
-|--------|------|-------------|
-| `http` | `HttpClient` | Injected HTTP client |
-| `appConfig` | `IAppConfig` | Injected app configuration |
-| `baseUrl` | `string` | Resolved base URL for the service |
-
-**Protected methods:**
+import { SKIP_ERROR_TOAST } from "@flusys/ng-core";
+import { HttpContext } from "@angular/common/http";
 
-| Method | Parameters | Returns | Description |
-|--------|-----------|---------|-------------|
-| `getUrl(endpoint)` | `endpoint: string` | `string` | Build full URL, removes leading slash to avoid double slashes |
-
-**Usage:**
-
-```typescript
-@Injectable({ providedIn: 'root' })
-export class UserApiService extends BaseApiService {
-  constructor() {
-    super('auth'); // Resolves to services.auth.baseUrl
-  }
-
-  getAll(filter: any) {
-    return this.http.post(this.getUrl('user/get-all'), filter);
-  }
-
-  getById(id: string) {
-    return this.http.post(`${this.getUrl('user/get')}/${id}`, {});
-  }
-}
-```
-
----
-
-### 4. Components
-
-#### LibAppConfigComponent
-
-Root configuration component providing global UI elements. Include once at app root.
-
-**Selector:** `lib-app-config`
-
-**Change Detection:** `OnPush` (optimal performance)
-
-**Provides:**
-- Global loading progress bar (fixed top, 4px height, z-index 998)
-- Toast notifications (PrimeNG Toast)
-- Confirm dialogs (PrimeNG ConfirmDialog)
-
-**Template:**
-```html
-@if (apiLoaderService.show()) {
-  <p-progressBar mode="indeterminate" />
-}
-<p-toast />
-<p-confirmdialog />
-```
-
-**Usage:**
-```typescript
-import { LibAppConfigComponent } from '@flusys/ng-core';
-
-@Component({
-  selector: 'app-root',
-  standalone: true,
-  imports: [LibAppConfigComponent, RouterOutlet],
-  template: `
-    <lib-app-config />
-    <router-outlet />
-  `
-})
-export class AppComponent {}
-```
-
----
-
-## Usage Examples
-
-### Basic App Setup
-
-```typescript
-// app.config.ts
-import { ApplicationConfig } from '@angular/core';
-import { provideHttpClient, withFetch, withInterceptors } from '@angular/common/http';
-import { APP_CONFIG, errorCatchingInterceptor, apiLoaderInterceptor } from '@flusys/ng-core';
-import { authInterceptor, tokenRefreshInterceptor } from '@flusys/ng-auth';
-import { DEFAULT_APP_CONFIG } from './config/app.config';
-
-export const appConfig: ApplicationConfig = {
-  providers: [
-    provideHttpClient(
-      withFetch(),
-      withInterceptors([
-        authInterceptor,
-        tokenRefreshInterceptor,
-        errorCatchingInterceptor,
-        apiLoaderInterceptor,
-      ])
-    ),
-    { provide: APP_CONFIG, useValue: DEFAULT_APP_CONFIG },
-  ]
-};
-```
-
-### Creating an API Service
-
-```typescript
-import { Injectable } from '@angular/core';
-import { BaseApiService } from '@flusys/ng-core';
-
-@Injectable({ providedIn: 'root' })
-export class AuthApiService extends BaseApiService {
-  constructor() {
-    super('auth'); // Resolves to services.auth.baseUrl
-  }
-
-  login(credentials: any) {
-    return this.http.post(this.getUrl('auth/login'), credentials);
-  }
-}
-```
-
-### Using Tagged Loaders
-
-```typescript
-import { HttpHeaders } from '@angular/common/http';
-import { ApiLoaderService } from '@flusys/ng-core';
-
-// In a service - tag requests
-this.http.post('/api/users/get-all', filter, {
-  headers: new HttpHeaders({ 'x-loader-tag': 'users-list' })
+this.http.post(url, body, {
+  context: new HttpContext().set(SKIP_ERROR_TOAST, true),
 });
-
-// In a component - check specific loader
-readonly usersLoading = this.apiLoaderService.getLoader('users-list');
-
-// In template
-@if (usersLoading()) {
-  <p-skeleton />
-}
 ```
 
 ---
 
-## Best Practices
-
-1. **Always provide APP_CONFIG** at application root level
-2. **Match backend configuration mode** (`multiTenant.enabled` should align with FLUSYS_NEST setup)
-3. **Enable features based on backend availability** (`services.iam.enabled` only if IAM module is deployed)
-4. **Never import from other @flusys packages** in ng-core
-5. **Keep ng-core minimal** - only foundation functionality
-6. **Use `BaseApiService`** for all API services to avoid hardcoded URLs
-7. **Don't create custom error handling** - use `errorCatchingInterceptor`
-8. **Don't manually track loading** - use `apiLoaderInterceptor` with `x-loader-tag` headers
+## 6. Feature Helper Functions
 
-## Common Issues
+Read flags without injecting `APP_CONFIG` directly:
 
-### APP_CONFIG Not Found
-
-**Problem:** `NullInjectorError: No provider for InjectionToken APP_CONFIG`
-
-**Solution:** Provide APP_CONFIG in app.config.ts:
 ```typescript
-{ provide: APP_CONFIG, useValue: DEFAULT_APP_CONFIG }
-```
-
-### Circular Dependency
-
-**Problem:** Build fails with circular dependency error involving ng-core.
+import { isSignUpEnabled, getPermissionMode, getNotificationSocketUrl } from "@flusys/ng-core";
 
-**Solution:** ng-core should NEVER import from other @flusys packages. Check imports and remove any references to ng-shared, ng-layout, or ng-auth.
+const config = inject(APP_CONFIG);
+isSignUpEnabled(config); // boolean — reads services.auth.features.signUp
+getPermissionMode(config); // 'RBAC' | 'DIRECT' | 'FULL'
+getNotificationSocketUrl(config); // string | undefined
+```
 
 ---
 
-## API Reference
-
-### Tokens
-
-| Token | Type | Description |
-|-------|------|-------------|
-| `APP_CONFIG` | `InjectionToken<IAppConfig>` | Application configuration |
-
-### Interceptors
-
-| Function | Description |
-|----------|-------------|
-| `apiLoaderInterceptor` | Loading state management with tagged loaders |
-| `errorCatchingInterceptor` | Error toast display (skips 401, 403, check-login, and SKIP_ERROR_TOAST) |
-| `SKIP_ERROR_TOAST` | HttpContextToken to skip global error toast for specific requests |
-
-### Services
-
-| Service | Description |
-|---------|-------------|
-| `ApiLoaderService` | Signal-based loading state with tagged loaders |
-| `BaseApiService` | Abstract base class for API services with URL resolution |
-
-### Interfaces & Types
-
-| Export | Description |
-|--------|-------------|
-| `IAppConfig` | App configuration interface |
-| `IServiceConfig` | Service configuration (`baseUrl`, `enabled`) |
-| `IStorageServiceConfig` | Storage service config (extends IServiceConfig with `defaultStorageConfigId`) |
-| `IAuthorConfig` | Author/brand configuration (`name`, `url`) |
-| `IRegistrationDefaults` | Registration defaults (`companySlug`, `branchSlug`) |
-| `PermissionMode` | `'rbac' \| 'direct' \| 'full'` |
-
-### Helper Functions
-
-| Function | Description |
-|----------|-------------|
-| `getDatabaseMode(config)` | Returns `'single'` or `'multi-tenant'` |
-| `isFeatureEnabled(config, feature)` | Check service feature enabled (ServiceName) |
-| `getServiceUrl(config, serviceName)` | Get service URL with fallback |
-| `isServiceEnabled(config, serviceName)` | Check if service is enabled |
-| `isCompanyFeatureEnabled(config)` | Check company feature flag |
-| `isStorageFeatureEnabled(config)` | Check storage service enabled |
-| `isFormBuilderFeatureEnabled(config)` | Check formBuilder service enabled |
-| `isEmailFeatureEnabled(config)` | Check email service enabled |
-| `getPermissionMode(config)` | Get permission mode (default `'full'`) |
-| `getDefaultStorageConfigId(config)` | Get default storage config ID for uploads |
-| `isSignUpEnabled(config)` | Check sign-up enabled (default `true`) |
-| `getDefaultCompanySlug(config)` | Get default company slug for registration |
-| `getDefaultBranchSlug(config)` | Get default branch slug for registration |
-
-**ServiceName:** `'auth' | 'administration' | 'iam' | 'storage' | 'formBuilder' | 'email'`
-
-### Constants
-
-| Constant | Value | Description |
-|----------|-------|-------------|
-| `DEFAULT_APP_NAME` | `'FLUSYS'` | Default application name |
-| `DEFAULT_AUTHOR` | `{ name: 'Flusys', url: '...' }` | Default author/brand info |
-
-### Components
-
-| Component | Selector | Description |
-|-----------|----------|-------------|
-| `LibAppConfigComponent` | `lib-app-config` | Global toast, confirm dialog, and loading bar |
-
-## See Also
-
-- **[SHARED-GUIDE.md](./SHARED-GUIDE.md)** - API services, components, directives
-- **[LAYOUT-GUIDE.md](./LAYOUT-GUIDE.md)** - Layout system
-- **[Angular Patterns](../../.claude/docs/angular/)** - Framework patterns
-- **[FLUSYS_NEST/docs/CORE-GUIDE.md](../../FLUSYS_NEST/docs/CORE-GUIDE.md)** - Backend core module
-
----
+## License
 
-**Last Updated:** 2026-02-23
-**Version:** 1.1.0
-**Angular Version:** 21
+MIT © FLUSYS