@flusys/ng-core 4.0.1 → 4.1.0

package/README.md

@@ -1,341 +1,386 @@
-# @flusys/ng-core Package Guide
+# @flusys/ng-core
 
-## Overview
+> Foundation library for the FLUSYS Angular platform — configuration injection, base HTTP services, API loaders, and HTTP interceptors.
 
-`@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.
+[![npm version](https://img.shields.io/npm/v/@flusys/ng-core.svg)](https://www.npmjs.com/package/@flusys/ng-core)
+[![Angular](https://img.shields.io/badge/Angular-21-red.svg)](https://angular.io)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue.svg)](https://www.typescriptlang.org)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
 
-**Key Principle:** ng-core has NO dependencies on other @flusys packages. All other packages depend on ng-core.
+---
 
-## Package Information
+## Table of Contents
+
+- [Overview](#overview)
+- [Features](#features)
+- [Compatibility](#compatibility)
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [Configuration Reference](#configuration-reference)
+  - [IAppConfig](#iappconfig)
+  - [APP_CONFIG Token](#app_config-token)
+- [Base Services](#base-services)
+  - [BaseApiService](#baseapiservice)
+  - [ApiLoaderService](#apiloaderservice)
+- [HTTP Interceptors](#http-interceptors)
+- [Helper Functions](#helper-functions)
+- [Exported Tokens](#exported-tokens)
+- [Troubleshooting](#troubleshooting)
+- [License](#license)
 
-- **Package:** `@flusys/ng-core`
-- **Version:** 4.0.1
-- **Peer Dependencies:** `@angular/*: >=21.0.0`, `primeng: >=21.0.0`
-- **Build Command:** `npm run build:ng-core`
+---
 
-## Package Structure
+## Overview
 
-```
-ng-core/
-├── components/
-│   └── lib-app-config/          # Global toast, confirm, loader
-├── interceptors/
-│   ├── api-loader.interceptor.ts
-│   └── error-catching.interceptor.ts
-├── interfaces/
-│   └── app-config.interface.ts  # IAppConfig, helpers, constants
-├── services/
-│   ├── api-loader.service.ts
-│   └── base-api.service.ts
-└── public-api.ts
-```
+`@flusys/ng-core` is the zero-dependency foundation of the FLUSYS Angular package hierarchy. Every other FLUSYS Angular package depends on it. It provides:
 
-## Public API
+- The **`APP_CONFIG`** injection token — single source of truth for all application configuration
+- **`BaseApiService`** — typed POST-only RPC HTTP client
+- **`ApiLoaderService`** — manages global loading state across concurrent requests
+- **HTTP interceptors** — base URL injection and error normalization
+- Utility helper functions for feature detection
 
-```typescript
-// Components
-export { LibAppConfigComponent } from './components/public-api';
-
-// Services
-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';
-```
+This package has **no FLUSYS dependencies** — it only depends on Angular core.
 
 ---
 
-## 1. APP_CONFIG (Configuration Management)
+## Features
 
-Centralized configuration system with dynamic service URLs and feature flags.
+- ✅ Typed `IAppConfig` with full IntelliSense
+- ✅ POST-only RPC HTTP client (`BaseApiService`)
+- ✅ Global loading state management (`ApiLoaderService`)
+- ✅ `APP_CONFIG` injection token for DI-based configuration
+- ✅ Feature detection helpers (`isAuthEnabled()`, `isIamEnabled()`, `isSignUpEnabled()`, etc.)
+- ✅ HTTP interceptors for base URL and error handling
+- ✅ Zoneless-compatible (no Zone.js dependency)
+- ✅ Signal-friendly architecture
 
-### IAppConfig Interface
+---
 
-```typescript
-export type PermissionMode = 'rbac' | 'direct' | 'full';
+## Compatibility
 
-export interface IServiceConfig {
-  baseUrl: string;
-  enabled: boolean;
-}
+| Package | Version |
+|---------|---------|
+| Angular | 21+ |
+| TypeScript | 5.x |
+| RxJS | 7.x |
 
-export interface IStorageServiceConfig extends IServiceConfig {
-  defaultStorageConfigId?: string;  // Default storage config for uploads
-}
+---
 
-export interface IAuthorConfig { name: string; url: string; }
+## Installation
 
-export interface IRegistrationDefaults {
-  companySlug?: string;  // Pre-fill company code (readonly)
-  branchSlug?: string;   // Pre-fill branch code (readonly)
-}
+```bash
+npm install @flusys/ng-core
+```
 
-export interface IAppConfig {
-  appName: string;
-  author?: IAuthorConfig;
-  apiBaseUrl: string;                    // Default fallback URL
-  enableCompanyFeature: boolean;         // Company selection/switching
-  enableSignUp?: boolean;                // Registration enabled (default: true)
-  registrationDefaults?: IRegistrationDefaults;
+---
 
-  services: {
-    auth: IServiceConfig;
-    administration: IServiceConfig;
-    iam: IServiceConfig;
-    storage: IStorageServiceConfig;
-    formBuilder: IServiceConfig;
-    email: IServiceConfig;
-  };
+## Quick Start
 
-  multiTenant: {
-    enabled: boolean;      // true = multi-tenant DB, false = single DB
-    tenantHeader: string;  // Header name (e.g., 'x-tenant-id')
-    tenantId?: string;
-  };
+### 1. Define App Config
 
-  permissionMode?: PermissionMode;  // Defaults to 'full'
-}
+```typescript
+// environments/environment.ts
+import { IAppConfig } from '@flusys/ng-core';
 
-export const APP_CONFIG = new InjectionToken<IAppConfig>('APP_CONFIG');
+export const environment: IAppConfig = {
+  appName: 'My App',
+  apiBaseUrl: 'http://localhost:2002',
+  production: false,
+  services: {
+    auth: {
+      enabled: true,
+      features: {
+        signUp: true,
+        emailVerification: true,
+      },
+    },
+    iam: { enabled: true },
+    storage: { enabled: true },
+    email: { enabled: false },
+    formBuilder: { enabled: false },
+    eventManager: { enabled: false },
+    notification: { enabled: false },
+    localization: { enabled: false },
+  },
+  multiTenant: false,
+  permissionMode: 'FULL',
+};
 ```
 
-### Helper Functions
-
-| 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'`
-
-### Constants
+### 2. Provide Config in `app.config.ts`
 
 ```typescript
-export const DEFAULT_APP_NAME = 'FLUSYS';
-export const DEFAULT_AUTHOR: IAuthorConfig = { name: 'Flusys', url: 'https://flusys.vercel.app' };
+import { ApplicationConfig } from '@angular/core';
+import { APP_CONFIG } from '@flusys/ng-core';
+import { environment } from './environments/environment';
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    { provide: APP_CONFIG, useValue: environment },
+    // ... other providers
+  ],
+};
 ```
 
-### Configuration Modes
+### 3. Inject Config Anywhere
 
-| Mode | `enableCompanyFeature` | `multiTenant.enabled` | Services |
-|------|------------------------|----------------------|----------|
-| Simple | `false` | `false` | Disabled |
-| Single DB + Multi-Company | `true` | `false` | Enabled |
-| Multi-Tenant | `true` | `true` | Enabled |
+```typescript
+import { inject } from '@angular/core';
+import { APP_CONFIG, IAppConfig } from '@flusys/ng-core';
 
----
+@Injectable({ providedIn: 'root' })
+export class MyService {
+  private config = inject<IAppConfig>(APP_CONFIG);
+
+  getApiUrl(): string {
+    return this.config.apiBaseUrl;
+  }
+}
+```
 
-## 2. HTTP Interceptors
+---
 
-Both use modern Angular functional interceptor pattern.
+## Configuration Reference
 
-### apiLoaderInterceptor
+### IAppConfig
 
-Tracks loading state with tagged loaders via `x-loader-tag` header.
+Complete configuration interface for the FLUSYS platform:
 
 ```typescript
-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;
+interface IAppConfig {
+  /** Application display name */
+  appName: string;
 
-  loaderService.increase(loaderTag);
-  const cleanReq = req.clone({ headers: req.headers.delete('x-loader-tag') });
+  /** Backend API base URL */
+  apiBaseUrl: string;
 
-  return next(cleanReq).pipe(finalize(() => loaderService.decrease(loaderTag)));
-}
-```
+  /** Production mode flag */
+  production: boolean;
 
-**Usage:**
-```typescript
-this.http.post('/api/users/get-all', filter, {
-  headers: new HttpHeaders({ 'x-loader-tag': 'users-list' })
-});
-```
-
-### errorCatchingInterceptor
+  /** Multi-tenant mode — isolates data per company */
+  multiTenant?: boolean;
 
-Displays error toasts via PrimeNG `MessageService`.
+  /** IAM permission evaluation mode */
+  permissionMode?: 'RBAC' | 'DIRECT' | 'FULL';
 
-| 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 |
+  services: {
+    auth?: {
+      enabled: boolean;
+      features?: {
+        /** Allow self-registration */
+        signUp?: boolean;
+        /** Email verification on register */
+        emailVerification?: boolean;
+        /** Require company selection after login */
+        companySelection?: boolean;
+      };
+    };
+    iam?: { enabled: boolean };
+    storage?: { enabled: boolean };
+    email?: { enabled: boolean };
+    formBuilder?: { enabled: boolean };
+    eventManager?: { enabled: boolean };
+    notification?: { enabled: boolean };
+    localization?: { enabled: boolean };
+  };
+}
+```
 
-**Error Extraction:** Uses `error.error.error` as summary, `error.error.message` as detail (handles NestJS array format). SSR-safe.
+### APP_CONFIG Token
 
-**Skip Toast for Local Handling:**
 ```typescript
-this.http.post(url, data, { context: new HttpContext().set(SKIP_ERROR_TOAST, true) });
+import { APP_CONFIG } from '@flusys/ng-core';
+
+// In component/service
+const config = inject<IAppConfig>(APP_CONFIG);
 ```
 
 ---
 
-## 3. Services
+## Base Services
 
-### ApiLoaderService
+### BaseApiService
 
-Signal-based loading state with tagged loaders.
+Typed HTTP client configured for POST-only RPC endpoints. All FLUSYS API services extend this class.
 
 ```typescript
+import { BaseApiService, ISingleResponse, IListResponse } from '@flusys/ng-core';
+
 @Injectable({ providedIn: 'root' })
-export class ApiLoaderService {
-  private readonly loaders = signal<Record<string, number>>({});
-  readonly DEFAULT_TAG = 'default';
+export class ProductApiService extends BaseApiService {
+  protected resource = 'product';
 
-  readonly show: Signal<boolean> = computed(() =>
-    Object.values(this.loaders()).some((count) => count > 0)
-  );
+  getAll(params: IListParams): Observable<IListResponse<Product>> {
+    return this.post(`${this.resource}/get-all`, params);
+  }
 
-  getLoader(name: string): Signal<boolean> {
-    return computed(() => (this.loaders()[name] ?? 0) > 0);
+  getById(id: string): Observable<ISingleResponse<Product>> {
+    return this.post(`${this.resource}/get/${id}`, {});
   }
 
-  increase(name: string = this.DEFAULT_TAG): void { /* increment */ }
-  decrease(name: string = this.DEFAULT_TAG): void { /* decrement, min 0 */ }
+  insert(data: CreateProductDto): Observable<ISingleResponse<Product>> {
+    return this.post(`${this.resource}/insert`, data);
+  }
+
+  update(data: UpdateProductDto): Observable<ISingleResponse<Product>> {
+    return this.post(`${this.resource}/update`, data);
+  }
+
+  delete(id: string): Observable<IMessageResponse> {
+    return this.post(`${this.resource}/delete`, { id });
+  }
 }
 ```
 
-**Usage:**
-```typescript
-@if (apiLoaderService.show()) { <p-progressBar mode="indeterminate" /> }
-@if (apiLoaderService.getLoader('users-list')()) { <p-skeleton /> }
-```
+**Key Methods:**
 
-### BaseApiService
+| Method | Signature | Description |
+|--------|-----------|-------------|
+| `post<T>` | `(path, body, options?)` | POST request with automatic base URL |
+| `get<T>` | `(path, options?)` | GET request (rarely used in FLUSYS) |
+| `setLoader` | `(show: boolean)` | Manually toggle loading indicator |
+
+**BaseApiService** automatically:
+- Prepends `apiBaseUrl` from `APP_CONFIG`
+- Sets `Content-Type: application/json`
+- Triggers `ApiLoaderService` for loading state
+- Normalizes errors through `GlobalErrorHandler`
+
+### ApiLoaderService
 
-Abstract base for API services with automatic URL resolution.
+Tracks concurrent HTTP requests to show/hide global loading indicators.
 
 ```typescript
-export abstract class BaseApiService {
-  protected readonly http = inject(HttpClient);
-  protected readonly appConfig = inject(APP_CONFIG);
-  protected readonly baseUrl: string;
+import { ApiLoaderService } from '@flusys/ng-core';
 
-  constructor(serviceName: string) {
-    this.baseUrl = getServiceUrl(this.appConfig, serviceName);
-  }
+@Component({ ... })
+export class AppComponent {
+  private loader = inject(ApiLoaderService);
 
-  protected getUrl(endpoint: string): string {
-    const clean = endpoint.startsWith('/') ? endpoint.substring(1) : endpoint;
-    return `${this.baseUrl}/${clean}`;
-  }
+  // Reactive loading state (signal)
+  isLoading = this.loader.isLoading;
 }
 ```
 
-**Usage:**
-```typescript
-@Injectable({ providedIn: 'root' })
-export class UserApiService extends BaseApiService {
-  constructor() { super('auth'); }
-  getAll(filter: any) { return this.http.post(this.getUrl('user/get-all'), filter); }
+```html
+<!-- Use in template -->
+@if (isLoading()) {
+  <p-progressBar mode="indeterminate" />
 }
 ```
 
----
+**ApiLoaderService API:**
 
-## 4. Components
+| Member | Type | Description |
+|--------|------|-------------|
+| `isLoading` | `Signal<boolean>` | True when any HTTP request is pending |
+| `increment()` | `void` | Manually increment request counter |
+| `decrement()` | `void` | Manually decrement request counter |
 
-### LibAppConfigComponent
+---
+
+## HTTP Interceptors
 
-Root configuration component. Include once at app root.
+`@flusys/ng-core` provides base HTTP interceptors registered via `provideHttpClient`:
 
-- **Selector:** `lib-app-config`
+### Base URL Interceptor
 
-**Provides:** Global loading progress bar (fixed top, 4px, z-index 998), toast notifications (success uses primary color), confirm dialogs.
+Automatically prepends `APP_CONFIG.apiBaseUrl` to all relative HTTP requests.
 
-**Usage:**
 ```typescript
-@Component({
-  selector: 'app-root',
-  imports: [LibAppConfigComponent, RouterOutlet],
-  template: `<lib-app-config /><router-outlet />`
-})
-export class AppComponent {}
+// Absolute URLs are passed through unchanged
+// Relative URLs like '/auth/login' become 'http://localhost:2002/auth/login'
 ```
 
----
+### Error Normalizer Interceptor
 
-## Setup
+Normalizes all HTTP error responses into a consistent `IErrorResponse` shape before they reach your services.
+
+### Registering Interceptors
 
 ```typescript
-// app.config.ts
-import { APP_CONFIG, errorCatchingInterceptor, apiLoaderInterceptor } from '@flusys/ng-core';
-import { authInterceptor, tokenRefreshInterceptor } from '@flusys/ng-auth';
+import { provideHttpClient, withInterceptors } from '@angular/common/http';
+import { baseUrlInterceptor, errorNormalizerInterceptor } from '@flusys/ng-core';
 
 export const appConfig: ApplicationConfig = {
   providers: [
     provideHttpClient(
-      withFetch(),
       withInterceptors([
-        authInterceptor,           // ng-auth: auth + tenant headers
-        tokenRefreshInterceptor,   // ng-auth: 401 + refresh
-        errorCatchingInterceptor,  // ng-core: error toasts
-        apiLoaderInterceptor,      // ng-core: loading state
+        baseUrlInterceptor,
+        errorNormalizerInterceptor,
       ])
     ),
-    { provide: APP_CONFIG, useValue: DEFAULT_APP_CONFIG },
-  ]
+  ],
 };
 ```
 
 ---
 
-## Best Practices
+## Helper Functions
 
-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
+Feature detection helpers that read from `APP_CONFIG`:
 
-## Common Issues
+```typescript
+import {
+  isAuthEnabled,
+  isIamEnabled,
+  isStorageEnabled,
+  isSignUpEnabled,
+  isEmailVerificationEnabled,
+  isCompanySelectionEnabled,
+  isLocalizationEnabled,
+  isNotificationEnabled,
+} from '@flusys/ng-core';
+
+// Usage in a service or guard
+const authOn = isAuthEnabled(config);       // boolean
+const iamOn = isIamEnabled(config);         // boolean
+const storageOn = isStorageEnabled(config); // boolean
+const signUpOn = isSignUpEnabled(config);   // boolean
+```
 
-| 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 |
+---
+
+## Exported Tokens
+
+| Token | Type | Description |
+|-------|------|-------------|
+| `APP_CONFIG` | `InjectionToken<IAppConfig>` | Global app configuration |
+| `TRANSLATE_ADAPTER` | `InjectionToken<ITranslateAdapter>` | Localization adapter interface |
 
 ---
 
-## See Also
+## Troubleshooting
+
+**`NullInjectorError: No provider for APP_CONFIG`**
+
+You forgot to provide `APP_CONFIG` in `app.config.ts`:
 
-- [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
+```typescript
+providers: [
+  { provide: APP_CONFIG, useValue: environment },
+]
+```
+
+**`Cannot read properties of undefined (reading 'apiBaseUrl')`**
+
+`APP_CONFIG` was provided but the environment object is missing the required field. Check that your environment file implements the full `IAppConfig` interface.
+
+**`HTTP 404 on API requests`**
+
+Check that `apiBaseUrl` does not have a trailing slash:
+
+```typescript
+// ❌ Wrong
+apiBaseUrl: 'http://localhost:2002/'
+
+// ✅ Correct
+apiBaseUrl: 'http://localhost:2002'
+```
 
 ---
 
-**Last Updated:** 2026-02-25 | **Version:** 3.0.1 | **Angular:** 21
+## License
+
+MIT © FLUSYS

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/interfaces/translate-adapter.interface.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 {  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  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 { InjectionToken, Signal } from '@angular/core';\n\nexport interface ITranslateAdapter {\n  /** Current language code signal - read this to create reactive dependency */\n  readonly languageCode: Signal<string>;\n  translate(key: string, params?: Record<string, string | number>): string;\n}\n\nexport const TRANSLATE_ADAPTER = new InjectionToken<ITranslateAdapter>('TRANSLATE_ADAPTER');\n\n/** Registry for fallback messages when localization is not active */\nexport const FALLBACK_MESSAGES_REGISTRY = new InjectionToken<Record<string, string>>(\n  'FALLBACK_MESSAGES_REGISTRY',\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';\nimport { ITranslateAdapter, TRANSLATE_ADAPTER } from '../interfaces/translate-adapter.interface';\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 translateAdapter = inject(TRANSLATE_ADAPTER, { optional: true });\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, translateAdapter);\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, messageKey, messageParams, error, statusCode }\n * If messageKey is present and translate adapter is available, translates the message.\n */\nfunction extractErrorInfo(\n  error: HttpErrorResponse,\n  translateAdapter: ITranslateAdapter | null\n): { summary: string; detail: string } {\n  // Check if we have a messageKey for translation\n  const messageKey = error.error?.messageKey;\n  const messageParams = error.error?.messageParams ?? error.error?.messageVariables;\n\n  let detail: string;\n  if (messageKey && translateAdapter) {\n    // Use translated message if available\n    detail = translateAdapter.translate(messageKey, messageParams);\n  } else 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 = translateAdapter\n      ? translateAdapter.translate('shared.unexpected.error')\n      : 'shared.unexpected.error';\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, translateAdapter);\n  }\n\n  return { summary, detail };\n}\n\n/**\n * Get default error summary based on HTTP status code.\n * Uses TRANSLATE_ADAPTER for localization when available.\n */\nfunction getDefaultSummary(status: number, translateAdapter: ITranslateAdapter | null): string {\n  const keyMap: Record<number, string> = {\n    400: 'shared.error.bad.request',\n    404: 'shared.error.not.found',\n    409: 'shared.error.conflict',\n    422: 'shared.error.validation.error',\n    500: 'shared.error.server.error',\n    502: 'shared.error.service.unavailable',\n    503: 'shared.error.service.unavailable',\n    504: 'shared.error.service.unavailable',\n  };\n\n  const key = keyMap[status] || 'shared.error';\n\n  if (translateAdapter) {\n    return translateAdapter.translate(key);\n  }\n\n  // Fallback to key when no translator available\n  return key;\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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"}
+{"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/interfaces/translate-adapter.interface.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 {  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  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 { InjectionToken, Signal } from '@angular/core';\n\nexport interface ITranslateAdapter {\n  /** Current language code signal - read this to create reactive dependency */\n  readonly languageCode: Signal<string>;\n  translate(key: string, params?: Record<string, string | number>): string;\n}\n\nexport const TRANSLATE_ADAPTER = new InjectionToken<ITranslateAdapter>('TRANSLATE_ADAPTER');\n\n/** Registry for fallback messages when localization is not active */\nexport const FALLBACK_MESSAGES_REGISTRY = new InjectionToken<Record<string, string>>(\n  'FALLBACK_MESSAGES_REGISTRY',\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';\nimport { ITranslateAdapter, TRANSLATE_ADAPTER } from '../interfaces/translate-adapter.interface';\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 translateAdapter = inject(TRANSLATE_ADAPTER, { optional: true });\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, translateAdapter);\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, messageKey, messageParams, error, statusCode }\n * If messageKey is present and translate adapter is available, translates the message.\n */\nfunction extractErrorInfo(\n  error: HttpErrorResponse,\n  translateAdapter: ITranslateAdapter | null\n): { summary: string; detail: string } {\n  // Check if we have a messageKey for translation\n  const messageKey = error.error?.messageKey;\n  const messageParams = error.error?.messageParams ?? error.error?.messageVariables;\n\n  let detail: string;\n  if (messageKey && translateAdapter) {\n    // Use translated message if available\n    detail = translateAdapter.translate(messageKey, messageParams);\n  } else 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 = translateAdapter\n      ? translateAdapter.translate('shared.unexpected.error')\n      : 'shared.unexpected.error';\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, translateAdapter);\n  }\n\n  return { summary, detail };\n}\n\n/**\n * Get default error summary based on HTTP status code.\n * Uses TRANSLATE_ADAPTER for localization when available.\n */\nfunction getDefaultSummary(status: number, translateAdapter: ITranslateAdapter | null): string {\n  const keyMap: Record<number, string> = {\n    400: 'shared.error.bad.request',\n    404: 'shared.error.not.found',\n    409: 'shared.error.conflict',\n    422: 'shared.error.validation.error',\n    500: 'shared.error.server.error',\n    502: 'shared.error.service.unavailable',\n    503: 'shared.error.service.unavailable',\n    504: 'shared.error.service.unavailable',\n  };\n\n  const key = keyMap[status] || 'shared.error';\n\n  if (translateAdapter) {\n    return translateAdapter.translate(key);\n  }\n\n  // Fallback to key when no translator available\n  return key;\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  appLogo: 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:\n    | 'auth'\n    | 'administration'\n    | 'iam'\n    | 'storage'\n    | 'formBuilder'\n    | 'email'\n    | 'eventManager'\n    | 'notification',\n): boolean {\n  return isServiceEnabled(config, feature);\n}\n\nexport function getServiceUrl(\n  config: IAppConfig,\n  serviceName:\n    | 'auth'\n    | 'administration'\n    | 'iam'\n    | 'storage'\n    | 'formBuilder'\n    | 'email'\n    | 'eventManager'\n    | 'notification'\n    | (string & {}),\n): string {\n  if (isServiceEnabled(config, serviceName)) {\n    const service =\n      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(\n  config: IAppConfig,\n): 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(\n  config: IAppConfig,\n): 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,6 +1,6 @@
 {
   "name": "@flusys/ng-core",
-  "version": "4.0.1",
+  "version": "4.1.0",
   "description": "Core utilities and services for FLUSYS Angular packages",
   "license": "MIT",
   "peerDependencies": {

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

@@ -103,6 +103,7 @@ interface IRegistrationDefaults {
 }
 interface IAppConfig {
     appName: string;
+    appLogo: string;
     author?: IAuthorConfig;
     apiBaseUrl: string;
     enableCompanyFeature: boolean;