@flusys/ng-core 3.0.0-rc → 3.0.1

package/README.md

@@ -2,15 +2,15 @@
 
 ## Overview
 
-`@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.
+`@flusys/ng-core` is the foundation package providing core functionality for all FLUSYS Angular libraries. 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.
+**Key Principle:** ng-core has NO dependencies on other @flusys packages. All other packages depend on ng-core.
 
 ## Package Information
 
 - **Package:** `@flusys/ng-core`
-- **Dependencies:** None (base package)
-- **Dependents:** ng-shared, ng-layout, ng-auth, ng-iam, ng-storage, flusysng
+- **Version:** 3.0.1
+- **Peer Dependencies:** `@angular/*: >=21.0.0`, `primeng: >=21.0.0`
 - **Build Command:** `npm run build:ng-core`
 
 ## Package Structure
@@ -18,48 +18,55 @@
 ```
 ng-core/
 ├── components/
-│   └── lib-app-config/
-│       ├── lib-app-config.component.ts
-│       ├── lib-app-config.component.html
-│       └── lib-app-config.component.scss
+│   └── lib-app-config/          # Global toast, confirm, loader
 ├── interceptors/
 │   ├── api-loader.interceptor.ts
 │   └── error-catching.interceptor.ts
 ├── interfaces/
-│   └── app-config.interface.ts
+│   └── app-config.interface.ts  # IAppConfig, helpers, constants
 ├── services/
 │   ├── api-loader.service.ts
 │   └── base-api.service.ts
 └── public-api.ts
 ```
 
-## Public API Exports
+## Public API
 
 ```typescript
 // Components
-export * from './components/lib-app-config/lib-app-config.component';
-
-// Interceptors
-export * from './interceptors/api-loader.interceptor';
-export * from './interceptors/error-catching.interceptor';
-
-// Interfaces
-export * from './interfaces/app-config.interface';
+export { LibAppConfigComponent } from './components/public-api';
 
 // Services
-export * from './services/api-loader.service';
-export * from './services/base-api.service';
+export { ApiLoaderService, BaseApiService } from './services/public-api';
+
+// Interceptors
+export { apiLoaderInterceptor, errorCatchingInterceptor, SKIP_ERROR_TOAST } from './interceptors/public-api';
+
+// Interfaces & Types
+export {
+  APP_CONFIG, IAppConfig, IServiceConfig, IStorageServiceConfig,
+  IAuthorConfig, IRegistrationDefaults, PermissionMode,
+} from './interfaces/public-api';
+
+// Helper Functions
+export {
+  getDatabaseMode, isServiceEnabled, isFeatureEnabled, getServiceUrl,
+  isCompanyFeatureEnabled, isStorageFeatureEnabled, isFormBuilderFeatureEnabled,
+  isEmailFeatureEnabled, getPermissionMode, getDefaultStorageConfigId,
+  isSignUpEnabled, getDefaultCompanySlug, getDefaultBranchSlug, getRegistrationDefaults,
+} from './interfaces/public-api';
+
+// Constants
+export { DEFAULT_APP_NAME, DEFAULT_AUTHOR } from './interfaces/public-api';
 ```
 
 ---
 
-## Features
-
-### 1. APP_CONFIG (Configuration Management)
+## 1. APP_CONFIG (Configuration Management)
 
 Centralized configuration system with dynamic service URLs and feature flags.
 
-#### IAppConfig Interface
+### IAppConfig Interface
 
 ```typescript
 export type PermissionMode = 'rbac' | 'direct' | 'full';
@@ -69,356 +76,233 @@ export interface IServiceConfig {
   enabled: boolean;
 }
 
-export interface IAuthorConfig {
-  name: string;
-  url: string;
+export interface IStorageServiceConfig extends IServiceConfig {
+  defaultStorageConfigId?: string;  // Default storage config for uploads
+}
+
+export interface IAuthorConfig { name: string; url: string; }
+
+export interface IRegistrationDefaults {
+  companySlug?: string;  // Pre-fill company code (readonly)
+  branchSlug?: string;   // Pre-fill branch code (readonly)
 }
 
 export interface IAppConfig {
   appName: string;
-  author?: IAuthorConfig;                // Author/Brand info for footer attribution
+  author?: IAuthorConfig;
   apiBaseUrl: string;                    // Default fallback URL
-  enableCompanyFeature: boolean;         // Company/branch selection
+  enableCompanyFeature: boolean;         // Company selection/switching
+  enableSignUp?: boolean;                // Registration enabled (default: true)
+  registrationDefaults?: IRegistrationDefaults;
 
   services: {
     auth: IServiceConfig;
+    administration: IServiceConfig;
     iam: IServiceConfig;
-    storage: IServiceConfig;
-    [key: string]: IServiceConfig;       // Extensible for custom services
+    storage: IStorageServiceConfig;
+    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
+    enabled: boolean;      // true = multi-tenant DB, false = single DB
+    tenantHeader: string;  // Header name (e.g., 'x-tenant-id')
+    tenantId?: string;
   };
 
-  permissionMode?: PermissionMode;       // Defaults to 'full'
+  permissionMode?: PermissionMode;  // Defaults to 'full'
 }
-```
-
-#### APP_CONFIG Token
 
-```typescript
 export const APP_CONFIG = new InjectionToken<IAppConfig>('APP_CONFIG');
 ```
 
-**Provider setup in app.config.ts:**
-
-```typescript
-import { APP_CONFIG } from '@flusys/ng-core';
-import { DEFAULT_APP_CONFIG } from './config/app.config';
-
-export const appConfig: ApplicationConfig = {
-  providers: [
-    { provide: APP_CONFIG, useValue: DEFAULT_APP_CONFIG },
-  ]
-};
-```
+### Helper Functions
 
-#### Environment Structure (Shared Base Pattern)
+| Function | Returns | Description |
+|----------|---------|-------------|
+| `getDatabaseMode(config)` | `'single' \| 'multi-tenant'` | Database mode from `multiTenant.enabled` |
+| `isServiceEnabled(config, name)` | `boolean` | Check if service is enabled |
+| `isFeatureEnabled(config, feature)` | `boolean` | Same as above with strict ServiceName type |
+| `getServiceUrl(config, name)` | `string` | Service URL or fallback to `apiBaseUrl` |
+| `isCompanyFeatureEnabled(config)` | `boolean` | Check `enableCompanyFeature` |
+| `isStorageFeatureEnabled(config)` | `boolean` | Check `services.storage.enabled` |
+| `isFormBuilderFeatureEnabled(config)` | `boolean` | Check `services.formBuilder.enabled` |
+| `isEmailFeatureEnabled(config)` | `boolean` | Check `services.email.enabled` |
+| `getPermissionMode(config)` | `PermissionMode` | Permission mode (default: `'full'`) |
+| `getDefaultStorageConfigId(config)` | `string \| undefined` | Default storage config ID |
+| `isSignUpEnabled(config)` | `boolean` | Sign-up enabled (default: `true`) |
+| `getDefaultCompanySlug(config)` | `string \| undefined` | Registration default company |
+| `getDefaultBranchSlug(config)` | `string \| undefined` | Registration default branch |
+| `getRegistrationDefaults(config)` | `IRegistrationDefaults \| undefined` | Full registration defaults |
+
+**ServiceName:** `'auth' | 'administration' | 'iam' | 'storage' | 'formBuilder' | 'email'`
 
-All common configuration is extracted to a shared base:
+### Constants
 
 ```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 },
-    iam: { baseUrl: 'http://localhost:2002/iam', enabled: true },
-    storage: { baseUrl: 'http://localhost:2002/storage', enabled: true },
-  },
-};
+export const DEFAULT_APP_NAME = 'FLUSYS';
+export const DEFAULT_AUTHOR: IAuthorConfig = { name: 'Flusys', url: 'https://flusys.vercel.app' };
 ```
 
-#### Helper Functions
+### Configuration Modes
 
-```typescript
-import {
-  getDatabaseMode,
-  isFeatureEnabled,
-  getServiceUrl,
-  isServiceEnabled,
-  isCompanyFeatureEnabled,
-  isStorageFeatureEnabled,
-  getPermissionMode,
-} from '@flusys/ng-core';
-```
+| Mode | `enableCompanyFeature` | `multiTenant.enabled` | Services |
+|------|------------------------|----------------------|----------|
+| Simple | `false` | `false` | Disabled |
+| Single DB + Multi-Company | `true` | `false` | Enabled |
+| Multi-Tenant | `true` | `true` | Enabled |
 
-| Function | Signature | Description |
-|----------|-----------|-------------|
-| `getDatabaseMode` | `(config) → 'single' \| 'multi-tenant'` | Get database mode from `multiTenant.enabled` |
-| `isFeatureEnabled` | `(config, feature: 'auth' \| 'iam' \| 'storage') → boolean` | Check if a service feature is enabled |
-| `getServiceUrl` | `(config, serviceName) → string` | Get service URL or fallback to `apiBaseUrl` |
-| `isServiceEnabled` | `(config, serviceName) → boolean` | Check if a service is enabled |
-| `isCompanyFeatureEnabled` | `(config) → boolean` | Check `enableCompanyFeature` flag |
-| `isStorageFeatureEnabled` | `(config) → boolean` | Check `services.storage.enabled` |
-| `getPermissionMode` | `(config) → PermissionMode` | Get permission mode (defaults to `'full'`) |
+---
 
-#### Constants
+## 2. HTTP Interceptors
 
-```typescript
-export const DEFAULT_APP_NAME = 'FLUSYS';
-export const DEFAULT_AUTHOR: IAuthorConfig = {
-  name: 'Flusys',
-  url: 'https://flusys.vercel.app',
-};
-```
+Both use modern Angular functional interceptor pattern.
 
-#### Configuration Modes
+### apiLoaderInterceptor
 
-**Mode 1: Simple (No Company, No IAM)**
-```typescript
-{
-  enableCompanyFeature: false,
-  multiTenant: { enabled: false, tenantHeader: 'x-tenant-id' },
-  services: {
-    auth: { baseUrl: '...', enabled: false },
-    iam: { baseUrl: '...', enabled: false },
-    storage: { baseUrl: '...', enabled: false },
-  }
-}
-```
+Tracks loading state with tagged loaders via `x-loader-tag` header.
 
-**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 },
-    iam: { baseUrl: 'http://localhost:2002/iam', enabled: true },
-    storage: { baseUrl: 'http://localhost:2002/storage', enabled: true },
-  }
-}
-```
+export function apiLoaderInterceptor(req: HttpRequest<unknown>, next: HttpHandlerFn): Observable<HttpEvent<unknown>> {
+  const loaderService = inject(ApiLoaderService);
+  const loaderTag = req.headers.get('x-loader-tag') ?? loaderService.DEFAULT_TAG;
 
-**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 },
-    iam: { baseUrl: 'http://localhost:2002/iam', enabled: true },
-    storage: { baseUrl: 'http://localhost:2002/storage', enabled: true },
-  }
+  loaderService.increase(loaderTag);
+  const cleanReq = req.clone({ headers: req.headers.delete('x-loader-tag') });
+
+  return next(cleanReq).pipe(finalize(() => loaderService.decrease(loaderTag)));
 }
 ```
 
----
-
-### 2. HTTP Interceptors
-
-ng-core provides two functional interceptors. Both use the modern Angular functional interceptor pattern.
-
-#### 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)
-
+**Usage:**
 ```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' })
 });
-
-// Check loading state for that tag
-apiLoaderService.getLoader('users-list')(); // true while loading
 ```
 
-#### errorCatchingInterceptor
+### errorCatchingInterceptor
 
-Displays user-friendly error toast messages for failed HTTP requests via PrimeNG `MessageService`.
+Displays error toasts via PrimeNG `MessageService`.
 
-**Behavior:**
-- Skips 401 errors (handled by `tokenRefreshInterceptor` in ng-auth)
-- Skips `/check-login` endpoint errors (expected to fail when not logged in)
-- Extracts message from `error.error.message` (string or array), `error.message`, or fallback
-- SSR-safe: only displays messages in browser (`isPlatformBrowser` check)
+| Skips | Reason |
+|-------|--------|
+| 401 | Handled by `tokenRefreshInterceptor` |
+| 403 | Handled by permission UI |
+| `/check-login` | Expected to fail when not logged in |
+| `SKIP_ERROR_TOAST` context | Component handles locally |
 
-#### Interceptor Chain
+**Error Extraction:** Uses `error.error.error` as summary, `error.error.message` as detail (handles NestJS array format). SSR-safe.
 
+**Skip Toast for Local Handling:**
 ```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)
-  ])
-)
+this.http.post(url, data, { context: new HttpContext().set(SKIP_ERROR_TOAST, true) });
 ```
 
-**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.
+## 3. Services
 
-**Signals:**
+### ApiLoaderService
 
-| Signal | Type | Description |
-|--------|------|-------------|
-| `show` | `Signal<boolean>` | `true` if ANY loader tag has active requests |
+Signal-based loading state with tagged loaders.
 
-**Methods:**
+```typescript
+@Injectable({ providedIn: 'root' })
+export class ApiLoaderService {
+  private readonly loaders = signal<Record<string, number>>({});
+  readonly DEFAULT_TAG = 'default';
 
-| 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 |
+  readonly show: Signal<boolean> = computed(() =>
+    Object.values(this.loaders()).some((count) => count > 0)
+  );
 
-**Properties:**
+  getLoader(name: string): Signal<boolean> {
+    return computed(() => (this.loaders()[name] ?? 0) > 0);
+  }
 
-| Property | Type | Description |
-|----------|------|-------------|
-| `DEFAULT_TAG` | `string` | Default tag name (`'default'`) |
+  increase(name: string = this.DEFAULT_TAG): void { /* increment */ }
+  decrease(name: string = this.DEFAULT_TAG): void { /* decrement, min 0 */ }
+}
+```
 
 **Usage:**
-
 ```typescript
-// Global loading state
-@if (apiLoaderService.show()) {
-  <p-progressBar mode="indeterminate" />
-}
-
-// Tag-specific loading state
-@if (apiLoaderService.getLoader('users-list')()) {
-  <p>Loading users...</p>
-}
+@if (apiLoaderService.show()) { <p-progressBar mode="indeterminate" /> }
+@if (apiLoaderService.getLoader('users-list')()) { <p-skeleton /> }
 ```
 
-#### BaseApiService
+### BaseApiService
 
-Abstract base class for API services. Provides automatic URL resolution from APP_CONFIG.
+Abstract base for API services with automatic URL resolution.
 
-**Protected members:**
-
-| Member | Type | Description |
-|--------|------|-------------|
-| `http` | `HttpClient` | Injected HTTP client |
-| `appConfig` | `IAppConfig` | Injected app configuration |
-| `baseUrl` | `string` | Resolved base URL for the service |
+```typescript
+export abstract class BaseApiService {
+  protected readonly http = inject(HttpClient);
+  protected readonly appConfig = inject(APP_CONFIG);
+  protected readonly baseUrl: string;
 
-**Protected methods:**
+  constructor(serviceName: string) {
+    this.baseUrl = getServiceUrl(this.appConfig, serviceName);
+  }
 
-| Method | Parameters | Returns | Description |
-|--------|-----------|---------|-------------|
-| `getUrl(endpoint)` | `endpoint: string` | `string` | Build full URL, removes leading slash to avoid double slashes |
+  protected getUrl(endpoint: string): string {
+    const clean = endpoint.startsWith('/') ? endpoint.substring(1) : endpoint;
+    return `${this.baseUrl}/${clean}`;
+  }
+}
+```
 
 **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}`, {});
-  }
+  constructor() { super('auth'); }
+  getAll(filter: any) { return this.http.post(this.getUrl('user/get-all'), filter); }
 }
 ```
 
 ---
 
-### 4. Components
+## 4. Components
 
-#### LibAppConfigComponent
+### LibAppConfigComponent
 
-Root configuration component providing global UI elements. Include once at app root.
+Root configuration component. Include once at app root.
 
-**Selector:** `lib-app-config`
+- **Selector:** `lib-app-config`
+- **Change Detection:** `OnPush`
 
-**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 />
-```
+**Provides:** Global loading progress bar (fixed top, 4px, z-index 998), toast notifications (success uses primary color), confirm dialogs.
 
 **Usage:**
 ```typescript
-import { LibAppConfigComponent } from '@flusys/ng-core';
-
 @Component({
   selector: 'app-root',
-  standalone: true,
   imports: [LibAppConfigComponent, RouterOutlet],
-  template: `
-    <lib-app-config />
-    <router-outlet />
-  `
+  template: `<lib-app-config /><router-outlet />`
 })
 export class AppComponent {}
 ```
 
 ---
 
-## Usage Examples
-
-### Basic App Setup
+## 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,
+        authInterceptor,           // ng-auth: auth + tenant headers
+        tokenRefreshInterceptor,   // ng-auth: 401 + refresh
+        errorCatchingInterceptor,  // ng-core: error toasts
+        apiLoaderInterceptor,      // ng-core: loading state
       ])
     ),
     { provide: APP_CONFIG, useValue: DEFAULT_APP_CONFIG },
@@ -426,140 +310,33 @@ export const appConfig: ApplicationConfig = {
 };
 ```
 
-### 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' })
-});
-
-// 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
+1. **Always provide APP_CONFIG** at application root
+2. **Match backend mode** - `multiTenant.enabled` should align with FLUSYS_NEST
+3. **Never import other @flusys packages** in ng-core
+4. **Use `BaseApiService`** for all API services
+5. **Use tagged loaders** for granular loading states
 
 ## Common Issues
 
-### 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.
-
-**Solution:** ng-core should NEVER import from other @flusys packages. Check imports and remove any references to ng-shared, ng-layout, or ng-auth.
+| Issue | Solution |
+|-------|----------|
+| `NullInjectorError: APP_CONFIG` | Add `{ provide: APP_CONFIG, useValue: config }` to providers |
+| Circular dependency | ng-core must NOT import other @flusys packages |
+| Loader flickers | Counter-based system handles concurrent requests automatically |
+| No error toast | Check: MessageService configured, not 401/403, not SKIP_ERROR_TOAST |
 
 ---
 
-## 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 and check-login) |
-
-### 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`) |
-| `IAuthorConfig` | Author/brand configuration (`name`, `url`) |
-| `PermissionMode` | `'rbac' \| 'direct' \| 'full'` |
-
-### Helper Functions
-
-| Function | Description |
-|----------|-------------|
-| `getDatabaseMode(config)` | Returns `'single'` or `'multi-tenant'` |
-| `isFeatureEnabled(config, feature)` | Check service feature enabled (`'auth' \| 'iam' \| 'storage'`) |
-| `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 |
-| `getPermissionMode(config)` | Get permission mode (default `'full'`) |
-
-### 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
+- [SHARED-GUIDE.md](./SHARED-GUIDE.md) - Components, directives, pipes
+- [LAYOUT-GUIDE.md](./LAYOUT-GUIDE.md) - Layout system
+- [FLUSYS_NEST/docs/CORE-GUIDE.md](../../FLUSYS_NEST/docs/CORE-GUIDE.md) - Backend core
 
 ---
 
-**Last Updated:** 2026-02-21
-**Angular Version:** 21
+**Last Updated:** 2026-02-25 | **Version:** 3.0.1 | **Angular:** 21

package/fesm2022/flusys-ng-core.mjs

@@ -35,10 +35,10 @@ class ApiLoaderService {
             return { ...loaders, [name]: Math.max(0, current - 1) };
         });
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: ApiLoaderService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
-    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: ApiLoaderService, providedIn: 'root' });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.5", ngImport: i0, type: ApiLoaderService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.1.5", ngImport: i0, type: ApiLoaderService, providedIn: 'root' });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: ApiLoaderService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.5", ngImport: i0, type: ApiLoaderService, decorators: [{
             type: Injectable,
             args: [{ providedIn: 'root' }]
         }] });
@@ -49,10 +49,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImpor
  */
 class LibAppConfigComponent {
     apiLoaderService = inject(ApiLoaderService);
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: LibAppConfigComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.1.3", type: LibAppConfigComponent, isStandalone: true, selector: "lib-app-config", ngImport: i0, template: "@if (apiLoaderService.show()) {\n<p-progressBar mode=\"indeterminate\" />\n}\n<p-toast />\n<p-confirmdialog />\n", styles: [":host ::ng-deep .p-progressbar{position:fixed;height:4px;z-index:998;left:0;right:0}:host ::ng-deep .p-toast-message-success{background:color-mix(in srgb,var(--p-primary-color),transparent 84%)!important;border-color:var(--p-primary-color)!important;color:var(--p-primary-color)!important}:host ::ng-deep .p-toast-message-success .p-toast-message-icon{color:var(--p-primary-color)!important;fill:var(--p-primary-color)!important}:host ::ng-deep .p-toast-message-success .p-toast-message-icon svg{color:var(--p-primary-color)!important;fill:var(--p-primary-color)!important}:host ::ng-deep .p-toast-message-success .p-toast-message-icon path{fill:var(--p-primary-color)!important}:host ::ng-deep .p-toast-message-success .p-toast-close-button{color:var(--p-primary-color)!important}:host ::ng-deep .p-toast-message-success .p-toast-close-button .p-toast-close-icon{color:var(--p-primary-color)!important}:host ::ng-deep .p-toast-message-success .p-toast-close-button:hover{background:color-mix(in srgb,var(--p-primary-color),transparent 70%)!important;color:var(--p-primary-color)!important}:host ::ng-deep .p-toast-message-success .p-toast-close-button:focus{box-shadow:0 0 0 .2rem color-mix(in srgb,var(--p-primary-color),transparent 50%)!important}:host ::ng-deep .p-toast-message-success .p-toast-detail{color:var(--p-text-color)!important}\n"], dependencies: [{ kind: "component", type: ConfirmDialog, selector: "p-confirmDialog, p-confirmdialog, p-confirm-dialog", inputs: ["header", "icon", "message", "style", "styleClass", "maskStyleClass", "acceptIcon", "acceptLabel", "closeAriaLabel", "acceptAriaLabel", "acceptVisible", "rejectIcon", "rejectLabel", "rejectAriaLabel", "rejectVisible", "acceptButtonStyleClass", "rejectButtonStyleClass", "closeOnEscape", "dismissableMask", "blockScroll", "rtl", "closable", "appendTo", "key", "autoZIndex", "baseZIndex", "transitionOptions", "focusTrap", "defaultFocus", "breakpoints", "modal", "visible", "position", "draggable"], outputs: ["onHide"] }, { kind: "ngmodule", type: ProgressBarModule }, { kind: "component", type: i1.ProgressBar, selector: "p-progressBar, p-progressbar, p-progress-bar", inputs: ["value", "showValue", "styleClass", "valueStyleClass", "unit", "mode", "color"] }, { kind: "ngmodule", type: ToastModule }, { kind: "component", type: i2.Toast, selector: "p-toast", inputs: ["key", "autoZIndex", "baseZIndex", "life", "styleClass", "position", "preventOpenDuplicates", "preventDuplicates", "showTransformOptions", "hideTransformOptions", "showTransitionOptions", "hideTransitionOptions", "motionOptions", "breakpoints"], outputs: ["onClose"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.5", ngImport: i0, type: LibAppConfigComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.1.5", type: LibAppConfigComponent, isStandalone: true, selector: "lib-app-config", ngImport: i0, template: "@if (apiLoaderService.show()) {\n<p-progressBar mode=\"indeterminate\" />\n}\n<p-toast />\n<p-confirmdialog />\n", styles: [":host ::ng-deep .p-progressbar{position:fixed;height:4px;z-index:998;left:0;right:0}:host ::ng-deep .p-toast-message-success{background:color-mix(in srgb,var(--p-primary-color),transparent 84%)!important;border-color:var(--p-primary-color)!important;color:var(--p-primary-color)!important}:host ::ng-deep .p-toast-message-success .p-toast-message-icon{color:var(--p-primary-color)!important;fill:var(--p-primary-color)!important}:host ::ng-deep .p-toast-message-success .p-toast-message-icon svg{color:var(--p-primary-color)!important;fill:var(--p-primary-color)!important}:host ::ng-deep .p-toast-message-success .p-toast-message-icon path{fill:var(--p-primary-color)!important}:host ::ng-deep .p-toast-message-success .p-toast-close-button{color:var(--p-primary-color)!important}:host ::ng-deep .p-toast-message-success .p-toast-close-button .p-toast-close-icon{color:var(--p-primary-color)!important}:host ::ng-deep .p-toast-message-success .p-toast-close-button:hover{background:color-mix(in srgb,var(--p-primary-color),transparent 70%)!important;color:var(--p-primary-color)!important}:host ::ng-deep .p-toast-message-success .p-toast-close-button:focus{box-shadow:0 0 0 .2rem color-mix(in srgb,var(--p-primary-color),transparent 50%)!important}:host ::ng-deep .p-toast-message-success .p-toast-detail{color:var(--p-text-color)!important}\n"], dependencies: [{ kind: "component", type: ConfirmDialog, selector: "p-confirmDialog, p-confirmdialog, p-confirm-dialog", inputs: ["header", "icon", "message", "style", "styleClass", "maskStyleClass", "acceptIcon", "acceptLabel", "closeAriaLabel", "acceptAriaLabel", "acceptVisible", "rejectIcon", "rejectLabel", "rejectAriaLabel", "rejectVisible", "acceptButtonStyleClass", "rejectButtonStyleClass", "closeOnEscape", "dismissableMask", "blockScroll", "rtl", "closable", "appendTo", "key", "autoZIndex", "baseZIndex", "transitionOptions", "focusTrap", "defaultFocus", "breakpoints", "modal", "visible", "position", "draggable"], outputs: ["onHide"] }, { kind: "ngmodule", type: ProgressBarModule }, { kind: "component", type: i1.ProgressBar, selector: "p-progressBar, p-progressbar, p-progress-bar", inputs: ["value", "showValue", "styleClass", "valueStyleClass", "unit", "mode", "color"] }, { kind: "ngmodule", type: ToastModule }, { kind: "component", type: i2.Toast, selector: "p-toast", inputs: ["key", "autoZIndex", "baseZIndex", "life", "styleClass", "position", "preventOpenDuplicates", "preventDuplicates", "showTransformOptions", "hideTransformOptions", "showTransitionOptions", "hideTransitionOptions", "motionOptions", "breakpoints"], outputs: ["onClose"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: LibAppConfigComponent, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.5", ngImport: i0, type: LibAppConfigComponent, decorators: [{
             type: Component,
             args: [{ selector: 'lib-app-config', changeDetection: ChangeDetectionStrategy.OnPush, imports: [ConfirmDialog, ProgressBarModule, ToastModule], template: "@if (apiLoaderService.show()) {\n<p-progressBar mode=\"indeterminate\" />\n}\n<p-toast />\n<p-confirmdialog />\n", styles: [":host ::ng-deep .p-progressbar{position:fixed;height:4px;z-index:998;left:0;right:0}:host ::ng-deep .p-toast-message-success{background:color-mix(in srgb,var(--p-primary-color),transparent 84%)!important;border-color:var(--p-primary-color)!important;color:var(--p-primary-color)!important}:host ::ng-deep .p-toast-message-success .p-toast-message-icon{color:var(--p-primary-color)!important;fill:var(--p-primary-color)!important}:host ::ng-deep .p-toast-message-success .p-toast-message-icon svg{color:var(--p-primary-color)!important;fill:var(--p-primary-color)!important}:host ::ng-deep .p-toast-message-success .p-toast-message-icon path{fill:var(--p-primary-color)!important}:host ::ng-deep .p-toast-message-success .p-toast-close-button{color:var(--p-primary-color)!important}:host ::ng-deep .p-toast-message-success .p-toast-close-button .p-toast-close-icon{color:var(--p-primary-color)!important}:host ::ng-deep .p-toast-message-success .p-toast-close-button:hover{background:color-mix(in srgb,var(--p-primary-color),transparent 70%)!important;color:var(--p-primary-color)!important}:host ::ng-deep .p-toast-message-success .p-toast-close-button:focus{box-shadow:0 0 0 .2rem color-mix(in srgb,var(--p-primary-color),transparent 50%)!important}:host ::ng-deep .p-toast-message-success .p-toast-detail{color:var(--p-text-color)!important}\n"] }]
         }] });
@@ -202,68 +202,66 @@ function getDefaultSummary(status) {
     }
 }
 
-/**
- * App Configuration Token
- * Use this to inject app config in services/components
- */
 const APP_CONFIG = new InjectionToken('APP_CONFIG');
-/**
- * Get database mode from config
- * Derived from multiTenant.enabled
- */
 function getDatabaseMode(config) {
     return config.multiTenant.enabled ? 'multi-tenant' : 'single';
 }
-/**
- * Check if a service is enabled
- */
 function isServiceEnabled(config, serviceName) {
     const service = config.services[serviceName];
     return service?.enabled ?? false;
 }
-/**
- * Check if a feature is enabled (alias for isServiceEnabled with strict types)
- */
 function isFeatureEnabled(config, feature) {
     return isServiceEnabled(config, feature);
 }
-/**
- * Get service base URL or fallback to default apiBaseUrl
- */
 function getServiceUrl(config, serviceName) {
     if (isServiceEnabled(config, serviceName)) {
         const service = config.services[serviceName];
-        return service.baseUrl;
+        return service?.baseUrl ?? config.apiBaseUrl;
     }
     return config.apiBaseUrl;
 }
-/**
- * Check if company feature is enabled
- */
 function isCompanyFeatureEnabled(config) {
     return config.enableCompanyFeature ?? false;
 }
-/**
- * Check if storage feature is enabled
- */
 function isStorageFeatureEnabled(config) {
     return isServiceEnabled(config, 'storage');
 }
-/**
- * Get permission mode from config
- * Defaults to 'full' if not specified
- */
+function isFormBuilderFeatureEnabled(config) {
+    return isServiceEnabled(config, 'formBuilder');
+}
+function isEmailFeatureEnabled(config) {
+    return isServiceEnabled(config, 'email');
+}
+function isEventManagerFeatureEnabled(config) {
+    return isServiceEnabled(config, 'eventManager');
+}
+function isNotificationFeatureEnabled(config) {
+    return isServiceEnabled(config, 'notification');
+}
+function getNotificationSocketUrl(config) {
+    const service = config.services.notification;
+    if (!service?.enabled)
+        return null;
+    return service.socketUrl ?? service.baseUrl;
+}
 function getPermissionMode(config) {
     return config.permissionMode ?? 'full';
 }
-/**
- * Get default storage config ID from config
- * Used for file upload operations when no storageConfigId is provided
- */
 function getDefaultStorageConfigId(config) {
     return config.services.storage?.defaultStorageConfigId;
 }
-// Default branding constants
+function isSignUpEnabled(config) {
+    return config.enableSignUp ?? true;
+}
+function getDefaultCompanySlug(config) {
+    return config.registrationDefaults?.companySlug;
+}
+function getDefaultBranchSlug(config) {
+    return config.registrationDefaults?.branchSlug;
+}
+function getRegistrationDefaults(config) {
+    return config.registrationDefaults;
+}
 const DEFAULT_APP_NAME = 'FLUSYS';
 const DEFAULT_AUTHOR = {
     name: 'Flusys',
@@ -318,5 +316,5 @@ class BaseApiService {
  * Generated bundle index. Do not edit.
  */
 
-export { APP_CONFIG, ApiLoaderService, BaseApiService, DEFAULT_APP_NAME, DEFAULT_AUTHOR, LibAppConfigComponent, SKIP_ERROR_TOAST, apiLoaderInterceptor, errorCatchingInterceptor, getDatabaseMode, getDefaultStorageConfigId, getPermissionMode, getServiceUrl, isCompanyFeatureEnabled, isFeatureEnabled, isServiceEnabled, isStorageFeatureEnabled };
+export { APP_CONFIG, ApiLoaderService, BaseApiService, DEFAULT_APP_NAME, DEFAULT_AUTHOR, LibAppConfigComponent, SKIP_ERROR_TOAST, apiLoaderInterceptor, errorCatchingInterceptor, getDatabaseMode, getDefaultBranchSlug, getDefaultCompanySlug, getDefaultStorageConfigId, getNotificationSocketUrl, getPermissionMode, getRegistrationDefaults, getServiceUrl, isCompanyFeatureEnabled, isEmailFeatureEnabled, isEventManagerFeatureEnabled, isFeatureEnabled, isFormBuilderFeatureEnabled, isNotificationFeatureEnabled, isServiceEnabled, isSignUpEnabled, isStorageFeatureEnabled };
 //# sourceMappingURL=flusys-ng-core.mjs.map

package/fesm2022/flusys-ng-core.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"flusys-ng-core.mjs","sources":["../../../projects/ng-core/services/api-loader.service.ts","../../../projects/ng-core/components/lib-app-config/lib-app-config.component.ts","../../../projects/ng-core/components/lib-app-config/lib-app-config.component.html","../../../projects/ng-core/interceptors/api-loader.interceptor.ts","../../../projects/ng-core/interceptors/error-catching.interceptor.ts","../../../projects/ng-core/interfaces/app-config.interface.ts","../../../projects/ng-core/services/base-api.service.ts","../../../projects/ng-core/public-api.ts","../../../projects/ng-core/flusys-ng-core.ts"],"sourcesContent":["import { computed, Injectable, Signal, signal } from '@angular/core';\n\n@Injectable({ providedIn: 'root' })\nexport class ApiLoaderService {\n  private readonly loaders = signal<Record<string, number>>({});\n  readonly DEFAULT_TAG = 'default';\n\n  // Global loading state\n  readonly show: Signal<boolean> = computed(() => {\n    const loaders = this.loaders();\n    return Object.values(loaders).some((count) => count > 0);\n  });\n\n  // Get specific loader as a signal\n  getLoader(name: string): Signal<boolean> {\n    return computed(() => (this.loaders()[name] ?? 0) > 0);\n  }\n\n  increase(name: string = this.DEFAULT_TAG): void {\n    this.loaders.update((loaders) => ({\n      ...loaders,\n      [name]: (loaders[name] ?? 0) + 1,\n    }));\n  }\n\n  decrease(name: string = this.DEFAULT_TAG): void {\n    this.loaders.update((loaders) => {\n      const current = loaders[name] ?? 0;\n      return { ...loaders, [name]: Math.max(0, current - 1) };\n    });\n  }\n}\n","import { ChangeDetectionStrategy, Component, inject } from '@angular/core';\nimport { ToastModule } from 'primeng/toast';\nimport { ConfirmDialog } from 'primeng/confirmdialog';\nimport { ApiLoaderService } from '../../services/api-loader.service';\nimport { ProgressBarModule } from 'primeng/progressbar';\n\n/**\n * Root configuration component providing global UI elements.\n * Include once at app root for global toast, confirm dialog, and loader.\n */\n@Component({\n  selector: 'lib-app-config',\n  changeDetection: ChangeDetectionStrategy.OnPush,\n  imports: [ConfirmDialog, ProgressBarModule, ToastModule],\n  templateUrl: './lib-app-config.component.html',\n  styleUrl: './lib-app-config.component.scss',\n})\nexport class LibAppConfigComponent {\n  readonly apiLoaderService = inject(ApiLoaderService);\n}\n","@if (apiLoaderService.show()) {\n<p-progressBar mode=\"indeterminate\" />\n}\n<p-toast />\n<p-confirmdialog />\n","import { HttpEvent, HttpHandlerFn, HttpRequest } from '@angular/common/http';\nimport { inject } from '@angular/core';\nimport { ApiLoaderService } from '../services/api-loader.service';\nimport { Observable } from 'rxjs';\nimport { finalize } from 'rxjs/operators';\n\n/**\n * Interceptor that tracks loading state for HTTP requests.\n * Uses 'x-loader-tag' header to group related requests.\n *\n * @example\n * ```typescript\n * http.get('/api/users', {\n *   headers: new HttpHeaders({ 'x-loader-tag': 'users-list' })\n * });\n * // In template: apiLoaderService.getLoader('users-list')\n * ```\n */\nexport function apiLoaderInterceptor(\n  req: HttpRequest<unknown>,\n  next: HttpHandlerFn\n): Observable<HttpEvent<unknown>> {\n  const loaderService = inject(ApiLoaderService);\n  const loaderTag = req.headers.get('x-loader-tag') ?? loaderService.DEFAULT_TAG;\n\n  loaderService.increase(loaderTag);\n\n  const cleanReq = req.clone({\n    headers: req.headers.delete('x-loader-tag'),\n  });\n\n  return next(cleanReq).pipe(\n    finalize(() => loaderService.decrease(loaderTag))\n  );\n}\n","import {\n  HttpErrorResponse,\n  HttpEvent,\n  HttpHandlerFn,\n  HttpRequest,\n  HttpContextToken,\n} from '@angular/common/http';\nimport { inject, PLATFORM_ID } from '@angular/core';\nimport { isPlatformBrowser } from '@angular/common';\nimport { MessageService } from 'primeng/api';\nimport { catchError, Observable, throwError } from 'rxjs';\n\n/**\n * HTTP context token to skip global error toast.\n * Use when component handles error display locally.\n *\n * @example\n * ```typescript\n * this.http.post(url, data, {\n *   context: new HttpContext().set(SKIP_ERROR_TOAST, true)\n * });\n * ```\n */\nexport const SKIP_ERROR_TOAST = new HttpContextToken<boolean>(() => false);\n\n/**\n * Error Catching Interceptor\n * Displays error messages for failed HTTP requests using backend response.\n *\n * Features:\n * - Uses backend's error title (error.error.error) as summary\n * - Uses backend's error message (error.error.message) as detail\n * - Falls back to sensible defaults based on status code\n * - Skip with SKIP_ERROR_TOAST context token for local handling\n *\n * NOTE: This interceptor only handles error display.\n * For 401 handling and token refresh, use tokenRefreshInterceptor from @flusys/ng-auth.\n *\n * @example\n * ```typescript\n * // In app.config.ts\n * provideHttpClient(\n *   withFetch(),\n *   withInterceptors([\n *     authInterceptor,           // from @flusys/ng-auth\n *     tokenRefreshInterceptor,   // from @flusys/ng-auth\n *     errorCatchingInterceptor,  // from @flusys/ng-core\n *     apiLoaderInterceptor,      // from @flusys/ng-core\n *   ])\n * )\n * ```\n */\nexport function errorCatchingInterceptor(\n  req: HttpRequest<unknown>,\n  next: HttpHandlerFn\n): Observable<HttpEvent<unknown>> {\n  const messageService = inject(MessageService);\n  const platformId = inject(PLATFORM_ID);\n  const isBrowser = isPlatformBrowser(platformId);\n\n  // Skip error display for check-login (expected to fail when not logged in)\n  const isCheckLogin = req.url.includes('/check-login');\n  // Skip if component handles error locally\n  const skipErrorToast = req.context.get(SKIP_ERROR_TOAST);\n\n  return next(req).pipe(\n    catchError((error: HttpErrorResponse) => {\n      // Skip 401 errors - handled by tokenRefreshInterceptor in ng-auth\n      // Skip 403 errors - handled by permission denied UI in components\n      // Skip check-login errors - expected behavior\n      // Skip if component handles error locally\n      if (error.status === 401 || error.status === 403 || isCheckLogin || skipErrorToast) {\n        return throwError(() => error);\n      }\n\n      // Display error message for other errors\n      if (isBrowser) {\n        const { summary, detail } = extractErrorInfo(error);\n        messageService.add({\n          severity: 'error',\n          summary,\n          detail,\n        });\n      }\n\n      return throwError(() => error);\n    })\n  );\n}\n\n/**\n * Extract error summary and detail from HTTP error response.\n * Uses backend response format: { message, error, statusCode }\n */\nfunction extractErrorInfo(error: HttpErrorResponse): { summary: string; detail: string } {\n  // Extract message from backend response\n  let detail: string;\n  if (typeof error.error?.message === 'string') {\n    detail = error.error.message;\n  } else if (Array.isArray(error.error?.message)) {\n    // NestJS validation errors come as array\n    detail = error.error.message[0];\n  } else if (error.message) {\n    detail = error.message;\n  } else {\n    detail = 'An unexpected error occurred.';\n  }\n\n  // Extract summary/title from backend response or use default based on status\n  let summary: string;\n  if (typeof error.error?.error === 'string') {\n    // Backend sends error type (e.g., \"Not Found\", \"Bad Request\", \"Validation Error\")\n    summary = error.error.error;\n  } else {\n    // Fallback to status-based title\n    summary = getDefaultSummary(error.status);\n  }\n\n  return { summary, detail };\n}\n\n/**\n * Get default error summary based on HTTP status code\n */\nfunction getDefaultSummary(status: number): string {\n  switch (status) {\n    case 400:\n      return 'Bad Request';\n    case 404:\n      return 'Not Found';\n    case 409:\n      return 'Conflict';\n    case 422:\n      return 'Validation Error';\n    case 500:\n      return 'Server Error';\n    case 502:\n    case 503:\n    case 504:\n      return 'Service Unavailable';\n    default:\n      return 'Error';\n  }\n}\n","import { InjectionToken } from '@angular/core';\n\n/**\n * IAM Permission Mode - controls permission system behavior\n */\nexport type PermissionMode = 'rbac' | 'direct' | 'full';\n\n/**\n * Service Configuration Interface\n */\nexport interface IServiceConfig {\n  baseUrl: string;\n  enabled: boolean;\n}\n\n/**\n * Storage Service Configuration Interface\n * Extends base service config with storage-specific options\n */\nexport interface IStorageServiceConfig extends IServiceConfig {\n  /**\n   * Default storage config ID from backend storage_config table\n   * Used when no storageConfigId is provided to upload operations\n   * If not set, backend will use company/branch default config\n   */\n  defaultStorageConfigId?: string;\n}\n\n/**\n * Author/Brand Configuration\n */\nexport interface IAuthorConfig {\n  name: string;\n  url: string;\n}\n\n/**\n * App Configuration Interface\n * Centralized configuration for feature toggles and behavior control\n */\nexport interface IAppConfig {\n  /** Application name */\n  appName: string;\n\n  /** Author/Brand info for footer attribution */\n  author?: IAuthorConfig;\n\n  /** Default API base URL (fallback) */\n  apiBaseUrl: string;  \n  \n  /**\n   * Enable company feature across the app\n   * When true, enables company selection/switching in layout and feature modules\n   */\n  enableCompanyFeature: boolean;\n\n  /**\n   * Service-specific base URLs\n   * If a service exists in this object, its feature is enabled\n   * Database mode is determined by multiTenant.enabled\n   */\n  services: {\n    auth: IServiceConfig;\n    iam: IServiceConfig;\n    storage: IStorageServiceConfig;\n  };\n\n  /**\n   * Multi-tenant configuration\n   * enabled: true → Database mode = multi-tenant\n   * enabled: false → Database mode = single\n   */\n  multiTenant: {\n    enabled: boolean;\n    tenantHeader: string;\n    tenantId?: string;\n  };\n\n  /**\n   * IAM Permission Mode - controls permission system behavior\n   * - 'rbac': Role-Based Access Control only (users get permissions via roles)\n   * - 'direct': Direct action assignments only (actions assigned directly to users)\n   * - 'full': Both RBAC and direct permissions (most flexible, default)\n   */\n  permissionMode?: PermissionMode;\n}\n\n/**\n * App Configuration Token\n * Use this to inject app config in services/components\n */\nexport const APP_CONFIG = new InjectionToken<IAppConfig>('APP_CONFIG');\n\n/**\n * Get database mode from config\n * Derived from multiTenant.enabled\n */\nexport function getDatabaseMode(config: IAppConfig): 'single' | 'multi-tenant' {\n  return config.multiTenant.enabled ? 'multi-tenant' : 'single';\n}\n\n/**\n * Check if a service is enabled\n */\nexport function isServiceEnabled(\n  config: IAppConfig,\n  serviceName: 'auth' | 'iam' | 'storage' | (string & {}),\n): boolean {\n  const service = config.services[serviceName as keyof typeof config.services];\n  return service?.enabled ?? false;\n}\n\n/**\n * Check if a feature is enabled (alias for isServiceEnabled with strict types)\n */\nexport function isFeatureEnabled(\n  config: IAppConfig,\n  feature: 'auth' | 'iam' | 'storage',\n): boolean {\n  return isServiceEnabled(config, feature);\n}\n\n/**\n * Get service base URL or fallback to default apiBaseUrl\n */\nexport function getServiceUrl(\n  config: IAppConfig,\n  serviceName: 'auth' | 'iam' | 'storage' | (string & {}),\n): string {\n  if (isServiceEnabled(config, serviceName)) {\n    const service = config.services[serviceName as keyof typeof config.services];\n    return service.baseUrl;\n  }\n  return config.apiBaseUrl;\n}\n\n/**\n * Check if company feature is enabled\n */\nexport function isCompanyFeatureEnabled(config: IAppConfig): boolean {\n  return config.enableCompanyFeature ?? false;\n}\n\n/**\n * Check if storage feature is enabled\n */\nexport function isStorageFeatureEnabled(config: IAppConfig): boolean {\n  return isServiceEnabled(config, 'storage');\n}\n\n/**\n * Get permission mode from config\n * Defaults to 'full' if not specified\n */\nexport function getPermissionMode(config: IAppConfig): PermissionMode {\n  return config.permissionMode ?? 'full';\n}\n\n/**\n * Get default storage config ID from config\n * Used for file upload operations when no storageConfigId is provided\n */\nexport function getDefaultStorageConfigId(config: IAppConfig): string | undefined {\n  return config.services.storage?.defaultStorageConfigId;\n}\n\n// Default branding constants\nexport const DEFAULT_APP_NAME = 'FLUSYS';\nexport const DEFAULT_AUTHOR: IAuthorConfig = {\n  name: 'Flusys',\n  url: 'https://flusys.vercel.app',\n};\n","import { inject } from '@angular/core';\nimport { HttpClient } from '@angular/common/http';\nimport { APP_CONFIG, getServiceUrl } from '../interfaces/app-config.interface';\n\n/**\n * Base API Service\n * Provides service-specific base URL resolution\n *\n * Note: This project uses POST-only RPC - all endpoints use POST, not REST verbs.\n *\n * Usage:\n * ```typescript\n * @Injectable({ providedIn: 'root' })\n * export class MyService extends BaseApiService {\n *   constructor() {\n *     super('my-service'); // Service name from config\n *   }\n *\n *   getData() {\n *     return this.http.post(`${this.baseUrl}/data/get`, {});\n *   }\n * }\n * ```\n */\nexport abstract class BaseApiService {\n  protected readonly http = inject(HttpClient);\n  protected readonly appConfig = inject(APP_CONFIG);\n  protected readonly baseUrl: string;\n\n  /**\n   * @param serviceName - Service name from config (e.g., 'auth', 'iam', 'storage')\n   */\n  constructor(serviceName: string) {\n    this.baseUrl = getServiceUrl(this.appConfig, serviceName);\n  }\n\n  /**\n   * Get full URL for an endpoint\n   * @param endpoint - API endpoint (e.g., '/users/get-all')\n   * @returns Full URL (e.g., 'http://localhost:2002/users/get-all')\n   */\n  protected getUrl(endpoint: string): string {\n    // Remove leading slash if present to avoid double slashes\n    const cleanEndpoint = endpoint.startsWith('/') ? endpoint.substring(1) : endpoint;\n    return `${this.baseUrl}/${cleanEndpoint}`;\n  }\n}\n","// Components\nexport * from './components/public-api';\n\n// Interceptors\nexport * from './interceptors/public-api';\n\n// Interfaces\nexport * from './interfaces/public-api';\n\n// Services\nexport * from './services/public-api';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"flusys-ng-core.mjs","sources":["../../../projects/ng-core/services/api-loader.service.ts","../../../projects/ng-core/components/lib-app-config/lib-app-config.component.ts","../../../projects/ng-core/components/lib-app-config/lib-app-config.component.html","../../../projects/ng-core/interceptors/api-loader.interceptor.ts","../../../projects/ng-core/interceptors/error-catching.interceptor.ts","../../../projects/ng-core/interfaces/app-config.interface.ts","../../../projects/ng-core/services/base-api.service.ts","../../../projects/ng-core/public-api.ts","../../../projects/ng-core/flusys-ng-core.ts"],"sourcesContent":["import { computed, Injectable, Signal, signal } from '@angular/core';\n\n@Injectable({ providedIn: 'root' })\nexport class ApiLoaderService {\n  private readonly loaders = signal<Record<string, number>>({});\n  readonly DEFAULT_TAG = 'default';\n\n  // Global loading state\n  readonly show: Signal<boolean> = computed(() => {\n    const loaders = this.loaders();\n    return Object.values(loaders).some((count) => count > 0);\n  });\n\n  // Get specific loader as a signal\n  getLoader(name: string): Signal<boolean> {\n    return computed(() => (this.loaders()[name] ?? 0) > 0);\n  }\n\n  increase(name: string = this.DEFAULT_TAG): void {\n    this.loaders.update((loaders) => ({\n      ...loaders,\n      [name]: (loaders[name] ?? 0) + 1,\n    }));\n  }\n\n  decrease(name: string = this.DEFAULT_TAG): void {\n    this.loaders.update((loaders) => {\n      const current = loaders[name] ?? 0;\n      return { ...loaders, [name]: Math.max(0, current - 1) };\n    });\n  }\n}\n","import { ChangeDetectionStrategy, Component, inject } from '@angular/core';\nimport { ToastModule } from 'primeng/toast';\nimport { ConfirmDialog } from 'primeng/confirmdialog';\nimport { ApiLoaderService } from '../../services/api-loader.service';\nimport { ProgressBarModule } from 'primeng/progressbar';\n\n/**\n * Root configuration component providing global UI elements.\n * Include once at app root for global toast, confirm dialog, and loader.\n */\n@Component({\n  selector: 'lib-app-config',\n  changeDetection: ChangeDetectionStrategy.OnPush,\n  imports: [ConfirmDialog, ProgressBarModule, ToastModule],\n  templateUrl: './lib-app-config.component.html',\n  styleUrl: './lib-app-config.component.scss',\n})\nexport class LibAppConfigComponent {\n  readonly apiLoaderService = inject(ApiLoaderService);\n}\n","@if (apiLoaderService.show()) {\n<p-progressBar mode=\"indeterminate\" />\n}\n<p-toast />\n<p-confirmdialog />\n","import { HttpEvent, HttpHandlerFn, HttpRequest } from '@angular/common/http';\nimport { inject } from '@angular/core';\nimport { ApiLoaderService } from '../services/api-loader.service';\nimport { Observable } from 'rxjs';\nimport { finalize } from 'rxjs/operators';\n\n/**\n * Interceptor that tracks loading state for HTTP requests.\n * Uses 'x-loader-tag' header to group related requests.\n *\n * @example\n * ```typescript\n * http.get('/api/users', {\n *   headers: new HttpHeaders({ 'x-loader-tag': 'users-list' })\n * });\n * // In template: apiLoaderService.getLoader('users-list')\n * ```\n */\nexport function apiLoaderInterceptor(\n  req: HttpRequest<unknown>,\n  next: HttpHandlerFn\n): Observable<HttpEvent<unknown>> {\n  const loaderService = inject(ApiLoaderService);\n  const loaderTag = req.headers.get('x-loader-tag') ?? loaderService.DEFAULT_TAG;\n\n  loaderService.increase(loaderTag);\n\n  const cleanReq = req.clone({\n    headers: req.headers.delete('x-loader-tag'),\n  });\n\n  return next(cleanReq).pipe(\n    finalize(() => loaderService.decrease(loaderTag))\n  );\n}\n","import {\n  HttpErrorResponse,\n  HttpEvent,\n  HttpHandlerFn,\n  HttpRequest,\n  HttpContextToken,\n} from '@angular/common/http';\nimport { inject, PLATFORM_ID } from '@angular/core';\nimport { isPlatformBrowser } from '@angular/common';\nimport { MessageService } from 'primeng/api';\nimport { catchError, Observable, throwError } from 'rxjs';\n\n/**\n * HTTP context token to skip global error toast.\n * Use when component handles error display locally.\n *\n * @example\n * ```typescript\n * this.http.post(url, data, {\n *   context: new HttpContext().set(SKIP_ERROR_TOAST, true)\n * });\n * ```\n */\nexport const SKIP_ERROR_TOAST = new HttpContextToken<boolean>(() => false);\n\n/**\n * Error Catching Interceptor\n * Displays error messages for failed HTTP requests using backend response.\n *\n * Features:\n * - Uses backend's error title (error.error.error) as summary\n * - Uses backend's error message (error.error.message) as detail\n * - Falls back to sensible defaults based on status code\n * - Skip with SKIP_ERROR_TOAST context token for local handling\n *\n * NOTE: This interceptor only handles error display.\n * For 401 handling and token refresh, use tokenRefreshInterceptor from @flusys/ng-auth.\n *\n * @example\n * ```typescript\n * // In app.config.ts\n * provideHttpClient(\n *   withFetch(),\n *   withInterceptors([\n *     authInterceptor,           // from @flusys/ng-auth\n *     tokenRefreshInterceptor,   // from @flusys/ng-auth\n *     errorCatchingInterceptor,  // from @flusys/ng-core\n *     apiLoaderInterceptor,      // from @flusys/ng-core\n *   ])\n * )\n * ```\n */\nexport function errorCatchingInterceptor(\n  req: HttpRequest<unknown>,\n  next: HttpHandlerFn\n): Observable<HttpEvent<unknown>> {\n  const messageService = inject(MessageService);\n  const platformId = inject(PLATFORM_ID);\n  const isBrowser = isPlatformBrowser(platformId);\n\n  // Skip error display for check-login (expected to fail when not logged in)\n  const isCheckLogin = req.url.includes('/check-login');\n  // Skip if component handles error locally\n  const skipErrorToast = req.context.get(SKIP_ERROR_TOAST);\n\n  return next(req).pipe(\n    catchError((error: HttpErrorResponse) => {\n      // Skip 401 errors - handled by tokenRefreshInterceptor in ng-auth\n      // Skip 403 errors - handled by permission denied UI in components\n      // Skip check-login errors - expected behavior\n      // Skip if component handles error locally\n      if (error.status === 401 || error.status === 403 || isCheckLogin || skipErrorToast) {\n        return throwError(() => error);\n      }\n\n      // Display error message for other errors\n      if (isBrowser) {\n        const { summary, detail } = extractErrorInfo(error);\n        messageService.add({\n          severity: 'error',\n          summary,\n          detail,\n        });\n      }\n\n      return throwError(() => error);\n    })\n  );\n}\n\n/**\n * Extract error summary and detail from HTTP error response.\n * Uses backend response format: { message, error, statusCode }\n */\nfunction extractErrorInfo(error: HttpErrorResponse): { summary: string; detail: string } {\n  // Extract message from backend response\n  let detail: string;\n  if (typeof error.error?.message === 'string') {\n    detail = error.error.message;\n  } else if (Array.isArray(error.error?.message)) {\n    // NestJS validation errors come as array\n    detail = error.error.message[0];\n  } else if (error.message) {\n    detail = error.message;\n  } else {\n    detail = 'An unexpected error occurred.';\n  }\n\n  // Extract summary/title from backend response or use default based on status\n  let summary: string;\n  if (typeof error.error?.error === 'string') {\n    // Backend sends error type (e.g., \"Not Found\", \"Bad Request\", \"Validation Error\")\n    summary = error.error.error;\n  } else {\n    // Fallback to status-based title\n    summary = getDefaultSummary(error.status);\n  }\n\n  return { summary, detail };\n}\n\n/**\n * Get default error summary based on HTTP status code\n */\nfunction getDefaultSummary(status: number): string {\n  switch (status) {\n    case 400:\n      return 'Bad Request';\n    case 404:\n      return 'Not Found';\n    case 409:\n      return 'Conflict';\n    case 422:\n      return 'Validation Error';\n    case 500:\n      return 'Server Error';\n    case 502:\n    case 503:\n    case 504:\n      return 'Service Unavailable';\n    default:\n      return 'Error';\n  }\n}\n","import { InjectionToken } from '@angular/core';\n\nexport type PermissionMode = 'rbac' | 'direct' | 'full';\n\nexport interface IServiceConfig {\n  baseUrl: string;\n  enabled: boolean;\n}\n\nexport interface IStorageServiceConfig extends IServiceConfig {\n  /** Default storage config ID (falls back to company/branch default if not set) */\n  defaultStorageConfigId?: string;\n}\n\nexport interface INotificationServiceConfig extends IServiceConfig {\n  /** WebSocket URL (defaults to baseUrl if not set) */\n  socketUrl?: string;\n}\n\nexport interface IAuthorConfig {\n  name: string;\n  url: string;\n}\n\nexport interface IRegistrationDefaults {\n  companySlug?: string;\n  branchSlug?: string;\n}\n\nexport interface IAppConfig {\n  appName: string;\n  author?: IAuthorConfig;\n  apiBaseUrl: string;\n  enableCompanyFeature: boolean;\n  /** @default true */\n  enableSignUp?: boolean;\n  registrationDefaults?: IRegistrationDefaults;\n  services: {\n    auth: IServiceConfig;\n    administration: IServiceConfig;\n    iam: IServiceConfig;\n    storage: IStorageServiceConfig;\n    formBuilder: IServiceConfig;\n    email: IServiceConfig;\n    eventManager: IServiceConfig;\n    notification?: INotificationServiceConfig;\n  };\n  multiTenant: {\n    enabled: boolean;\n    tenantHeader: string;\n    tenantId?: string;\n  };\n  /** 'rbac' | 'direct' | 'full' (default: 'full') */\n  permissionMode?: PermissionMode;\n}\n\nexport const APP_CONFIG = new InjectionToken<IAppConfig>('APP_CONFIG');\n\nexport function getDatabaseMode(config: IAppConfig): 'single' | 'multi-tenant' {\n  return config.multiTenant.enabled ? 'multi-tenant' : 'single';\n}\n\nexport function isServiceEnabled(\n  config: IAppConfig,\n  serviceName: 'auth' | 'iam' | 'storage' | (string & {}),\n): boolean {\n  const service = config.services[serviceName as keyof typeof config.services];\n  return service?.enabled ?? false;\n}\n\nexport function isFeatureEnabled(\n  config: IAppConfig,\n  feature: 'auth' | 'administration' | 'iam' | 'storage' | 'formBuilder' | 'email' | 'eventManager' | 'notification',\n): boolean {\n  return isServiceEnabled(config, feature);\n}\n\nexport function getServiceUrl(\n  config: IAppConfig,\n  serviceName: 'auth' | 'administration' | 'iam' | 'storage' | 'formBuilder' | 'email' | 'eventManager' | 'notification' | (string & {}),\n): string {\n  if (isServiceEnabled(config, serviceName)) {\n    const service = config.services[serviceName as keyof typeof config.services];\n    return service?.baseUrl ?? config.apiBaseUrl;\n  }\n  return config.apiBaseUrl;\n}\n\nexport function isCompanyFeatureEnabled(config: IAppConfig): boolean {\n  return config.enableCompanyFeature ?? false;\n}\n\nexport function isStorageFeatureEnabled(config: IAppConfig): boolean {\n  return isServiceEnabled(config, 'storage');\n}\n\nexport function isFormBuilderFeatureEnabled(config: IAppConfig): boolean {\n  return isServiceEnabled(config, 'formBuilder');\n}\n\nexport function isEmailFeatureEnabled(config: IAppConfig): boolean {\n  return isServiceEnabled(config, 'email');\n}\n\nexport function isEventManagerFeatureEnabled(config: IAppConfig): boolean {\n  return isServiceEnabled(config, 'eventManager');\n}\n\nexport function isNotificationFeatureEnabled(config: IAppConfig): boolean {\n  return isServiceEnabled(config, 'notification');\n}\n\nexport function getNotificationSocketUrl(config: IAppConfig): string | null {\n  const service = config.services.notification;\n  if (!service?.enabled) return null;\n  return service.socketUrl ?? service.baseUrl;\n}\n\nexport function getPermissionMode(config: IAppConfig): PermissionMode {\n  return config.permissionMode ?? 'full';\n}\n\nexport function getDefaultStorageConfigId(config: IAppConfig): string | undefined {\n  return config.services.storage?.defaultStorageConfigId;\n}\n\nexport function isSignUpEnabled(config: IAppConfig): boolean {\n  return config.enableSignUp ?? true;\n}\n\nexport function getDefaultCompanySlug(config: IAppConfig): string | undefined {\n  return config.registrationDefaults?.companySlug;\n}\n\nexport function getDefaultBranchSlug(config: IAppConfig): string | undefined {\n  return config.registrationDefaults?.branchSlug;\n}\n\nexport function getRegistrationDefaults(config: IAppConfig): IRegistrationDefaults | undefined {\n  return config.registrationDefaults;\n}\n\nexport const DEFAULT_APP_NAME = 'FLUSYS';\nexport const DEFAULT_AUTHOR: IAuthorConfig = {\n  name: 'Flusys',\n  url: 'https://flusys.vercel.app',\n};\n","import { inject } from '@angular/core';\nimport { HttpClient } from '@angular/common/http';\nimport { APP_CONFIG, getServiceUrl } from '../interfaces/app-config.interface';\n\n/**\n * Base API Service\n * Provides service-specific base URL resolution\n *\n * Note: This project uses POST-only RPC - all endpoints use POST, not REST verbs.\n *\n * Usage:\n * ```typescript\n * @Injectable({ providedIn: 'root' })\n * export class MyService extends BaseApiService {\n *   constructor() {\n *     super('my-service'); // Service name from config\n *   }\n *\n *   getData() {\n *     return this.http.post(`${this.baseUrl}/data/get`, {});\n *   }\n * }\n * ```\n */\nexport abstract class BaseApiService {\n  protected readonly http = inject(HttpClient);\n  protected readonly appConfig = inject(APP_CONFIG);\n  protected readonly baseUrl: string;\n\n  /**\n   * @param serviceName - Service name from config (e.g., 'auth', 'iam', 'storage')\n   */\n  constructor(serviceName: string) {\n    this.baseUrl = getServiceUrl(this.appConfig, serviceName);\n  }\n\n  /**\n   * Get full URL for an endpoint\n   * @param endpoint - API endpoint (e.g., '/users/get-all')\n   * @returns Full URL (e.g., 'http://localhost:2002/users/get-all')\n   */\n  protected getUrl(endpoint: string): string {\n    // Remove leading slash if present to avoid double slashes\n    const cleanEndpoint = endpoint.startsWith('/') ? endpoint.substring(1) : endpoint;\n    return `${this.baseUrl}/${cleanEndpoint}`;\n  }\n}\n","// Components\nexport * from './components/public-api';\n\n// Interceptors\nexport * from './interceptors/public-api';\n\n// Interfaces\nexport * from './interfaces/public-api';\n\n// Services\nexport * from './services/public-api';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@flusys/ng-core",
-  "version": "3.0.0-rc",
+  "version": "3.0.1",
   "description": "Core utilities and services for FLUSYS Angular packages",
   "license": "MIT",
   "peerDependencies": {
-    "@angular/common": "^21.0.0",
-    "@angular/core": "^21.0.0",
-    "@primeuix/themes": "^1.0.0",
-    "primeicons": "^7.0.0",
-    "primeng": "^21.0.0"
+    "@angular/common": ">=21.0.0",
+    "@angular/core": ">=21.0.0",
+    "@primeuix/themes": ">=1.0.0",
+    "primeicons": ">=7.0.0",
+    "primeng": ">=21.0.0"
   },
   "sideEffects": false,
   "module": "fesm2022/flusys-ng-core.mjs",
@@ -25,4 +25,4 @@
   "dependencies": {
     "tslib": "^2.3.0"
   }
-}
+}

package/types/flusys-ng-core.d.ts

@@ -80,120 +80,71 @@ declare const SKIP_ERROR_TOAST: HttpContextToken<boolean>;
  */
 declare function errorCatchingInterceptor(req: HttpRequest<unknown>, next: HttpHandlerFn): Observable<HttpEvent<unknown>>;
 
-/**
- * IAM Permission Mode - controls permission system behavior
- */
 type PermissionMode = 'rbac' | 'direct' | 'full';
-/**
- * Service Configuration Interface
- */
 interface IServiceConfig {
     baseUrl: string;
     enabled: boolean;
 }
-/**
- * Storage Service Configuration Interface
- * Extends base service config with storage-specific options
- */
 interface IStorageServiceConfig extends IServiceConfig {
-    /**
-     * Default storage config ID from backend storage_config table
-     * Used when no storageConfigId is provided to upload operations
-     * If not set, backend will use company/branch default config
-     */
+    /** Default storage config ID (falls back to company/branch default if not set) */
     defaultStorageConfigId?: string;
 }
-/**
- * Author/Brand Configuration
- */
+interface INotificationServiceConfig extends IServiceConfig {
+    /** WebSocket URL (defaults to baseUrl if not set) */
+    socketUrl?: string;
+}
 interface IAuthorConfig {
     name: string;
     url: string;
 }
-/**
- * App Configuration Interface
- * Centralized configuration for feature toggles and behavior control
- */
+interface IRegistrationDefaults {
+    companySlug?: string;
+    branchSlug?: string;
+}
 interface IAppConfig {
-    /** Application name */
     appName: string;
-    /** Author/Brand info for footer attribution */
     author?: IAuthorConfig;
-    /** Default API base URL (fallback) */
     apiBaseUrl: string;
-    /**
-     * Enable company feature across the app
-     * When true, enables company selection/switching in layout and feature modules
-     */
     enableCompanyFeature: boolean;
-    /**
-     * Service-specific base URLs
-     * If a service exists in this object, its feature is enabled
-     * Database mode is determined by multiTenant.enabled
-     */
+    /** @default true */
+    enableSignUp?: boolean;
+    registrationDefaults?: IRegistrationDefaults;
     services: {
         auth: IServiceConfig;
+        administration: IServiceConfig;
         iam: IServiceConfig;
         storage: IStorageServiceConfig;
+        formBuilder: IServiceConfig;
+        email: IServiceConfig;
+        eventManager: IServiceConfig;
+        notification?: INotificationServiceConfig;
     };
-    /**
-     * Multi-tenant configuration
-     * enabled: true → Database mode = multi-tenant
-     * enabled: false → Database mode = single
-     */
     multiTenant: {
         enabled: boolean;
         tenantHeader: string;
         tenantId?: string;
     };
-    /**
-     * IAM Permission Mode - controls permission system behavior
-     * - 'rbac': Role-Based Access Control only (users get permissions via roles)
-     * - 'direct': Direct action assignments only (actions assigned directly to users)
-     * - 'full': Both RBAC and direct permissions (most flexible, default)
-     */
+    /** 'rbac' | 'direct' | 'full' (default: 'full') */
     permissionMode?: PermissionMode;
 }
-/**
- * App Configuration Token
- * Use this to inject app config in services/components
- */
 declare const APP_CONFIG: InjectionToken<IAppConfig>;
-/**
- * Get database mode from config
- * Derived from multiTenant.enabled
- */
 declare function getDatabaseMode(config: IAppConfig): 'single' | 'multi-tenant';
-/**
- * Check if a service is enabled
- */
 declare function isServiceEnabled(config: IAppConfig, serviceName: 'auth' | 'iam' | 'storage' | (string & {})): boolean;
-/**
- * Check if a feature is enabled (alias for isServiceEnabled with strict types)
- */
-declare function isFeatureEnabled(config: IAppConfig, feature: 'auth' | 'iam' | 'storage'): boolean;
-/**
- * Get service base URL or fallback to default apiBaseUrl
- */
-declare function getServiceUrl(config: IAppConfig, serviceName: 'auth' | 'iam' | 'storage' | (string & {})): string;
-/**
- * Check if company feature is enabled
- */
+declare function isFeatureEnabled(config: IAppConfig, feature: 'auth' | 'administration' | 'iam' | 'storage' | 'formBuilder' | 'email' | 'eventManager' | 'notification'): boolean;
+declare function getServiceUrl(config: IAppConfig, serviceName: 'auth' | 'administration' | 'iam' | 'storage' | 'formBuilder' | 'email' | 'eventManager' | 'notification' | (string & {})): string;
 declare function isCompanyFeatureEnabled(config: IAppConfig): boolean;
-/**
- * Check if storage feature is enabled
- */
 declare function isStorageFeatureEnabled(config: IAppConfig): boolean;
-/**
- * Get permission mode from config
- * Defaults to 'full' if not specified
- */
+declare function isFormBuilderFeatureEnabled(config: IAppConfig): boolean;
+declare function isEmailFeatureEnabled(config: IAppConfig): boolean;
+declare function isEventManagerFeatureEnabled(config: IAppConfig): boolean;
+declare function isNotificationFeatureEnabled(config: IAppConfig): boolean;
+declare function getNotificationSocketUrl(config: IAppConfig): string | null;
 declare function getPermissionMode(config: IAppConfig): PermissionMode;
-/**
- * Get default storage config ID from config
- * Used for file upload operations when no storageConfigId is provided
- */
 declare function getDefaultStorageConfigId(config: IAppConfig): string | undefined;
+declare function isSignUpEnabled(config: IAppConfig): boolean;
+declare function getDefaultCompanySlug(config: IAppConfig): string | undefined;
+declare function getDefaultBranchSlug(config: IAppConfig): string | undefined;
+declare function getRegistrationDefaults(config: IAppConfig): IRegistrationDefaults | undefined;
 declare const DEFAULT_APP_NAME = "FLUSYS";
 declare const DEFAULT_AUTHOR: IAuthorConfig;
 
@@ -233,5 +184,5 @@ declare abstract class BaseApiService {
     protected getUrl(endpoint: string): string;
 }
 
-export { APP_CONFIG, ApiLoaderService, BaseApiService, DEFAULT_APP_NAME, DEFAULT_AUTHOR, LibAppConfigComponent, SKIP_ERROR_TOAST, apiLoaderInterceptor, errorCatchingInterceptor, getDatabaseMode, getDefaultStorageConfigId, getPermissionMode, getServiceUrl, isCompanyFeatureEnabled, isFeatureEnabled, isServiceEnabled, isStorageFeatureEnabled };
-export type { IAppConfig, IAuthorConfig, IServiceConfig, IStorageServiceConfig, PermissionMode };
+export { APP_CONFIG, ApiLoaderService, BaseApiService, DEFAULT_APP_NAME, DEFAULT_AUTHOR, LibAppConfigComponent, SKIP_ERROR_TOAST, apiLoaderInterceptor, errorCatchingInterceptor, getDatabaseMode, getDefaultBranchSlug, getDefaultCompanySlug, getDefaultStorageConfigId, getNotificationSocketUrl, getPermissionMode, getRegistrationDefaults, getServiceUrl, isCompanyFeatureEnabled, isEmailFeatureEnabled, isEventManagerFeatureEnabled, isFeatureEnabled, isFormBuilderFeatureEnabled, isNotificationFeatureEnabled, isServiceEnabled, isSignUpEnabled, isStorageFeatureEnabled };
+export type { IAppConfig, IAuthorConfig, INotificationServiceConfig, IRegistrationDefaults, IServiceConfig, IStorageServiceConfig, PermissionMode };