@flusys/ng-core 0.1.0-alpha.1

package/fesm2022/flusys-ng-core.mjs

@@ -0,0 +1,253 @@
+import * as i0 from '@angular/core';
+import { signal, computed, Injectable, inject, Component, PLATFORM_ID, InjectionToken } from '@angular/core';
+import * as i2 from 'primeng/toast';
+import { ToastModule } from 'primeng/toast';
+import { ConfirmDialog } from 'primeng/confirmdialog';
+import * as i1 from 'primeng/progressbar';
+import { ProgressBarModule } from 'primeng/progressbar';
+import { finalize } from 'rxjs/operators';
+import { isPlatformBrowser } from '@angular/common';
+import { MessageService } from 'primeng/api';
+import { catchError, throwError } from 'rxjs';
+import { HttpClient } from '@angular/common/http';
+
+class ApiLoaderService {
+    loaders = signal({}, ...(ngDevMode ? [{ debugName: "loaders" }] : [])); // 👈 reactive store
+    DEFAULT_TAG = 'default';
+    // Global loading state
+    show = computed(() => {
+        const loaders = this.loaders();
+        return Object.values(loaders).some((count) => count > 0);
+    }, ...(ngDevMode ? [{ debugName: "show" }] : []));
+    // Get specific loader as a signal
+    getLoader(name) {
+        return computed(() => (this.loaders()[name] ?? 0) > 0);
+    }
+    increase(name = this.DEFAULT_TAG) {
+        this.loaders.update((loaders) => ({
+            ...loaders,
+            [name]: (loaders[name] ?? 0) + 1,
+        }));
+    }
+    decrease(name = this.DEFAULT_TAG) {
+        this.loaders.update((loaders) => {
+            const current = loaders[name] ?? 0;
+            return { ...loaders, [name]: Math.max(0, current - 1) };
+        });
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.0", ngImport: i0, type: ApiLoaderService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.1.0", ngImport: i0, type: ApiLoaderService, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.0", ngImport: i0, type: ApiLoaderService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+
+/**
+ * Root configuration component providing global UI elements.
+ * Include once at app root for global toast, confirm dialog, and loader.
+ */
+class LibAppConfigComponent {
+    apiLoaderService = inject(ApiLoaderService);
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.0", ngImport: i0, type: LibAppConfigComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.1.0", 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}\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"] }] });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.0", ngImport: i0, type: LibAppConfigComponent, decorators: [{
+            type: Component,
+            args: [{ selector: 'lib-app-config', standalone: true, 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}\n"] }]
+        }] });
+
+/**
+ * Interceptor that tracks loading state for HTTP requests.
+ * Uses 'x-loader-tag' header to group related requests.
+ *
+ * @example
+ * ```typescript
+ * http.get('/api/users', {
+ *   headers: new HttpHeaders({ 'x-loader-tag': 'users-list' })
+ * });
+ * // In template: apiLoaderService.getLoader('users-list')
+ * ```
+ */
+function apiLoaderInterceptor(req, next) {
+    const loaderService = inject(ApiLoaderService);
+    const loaderTag = req.headers.get('x-loader-tag') ?? loaderService.DEFAULT_TAG;
+    loaderService.increase(loaderTag);
+    const cleanReq = req.clone({
+        headers: req.headers.delete('x-loader-tag'),
+    });
+    return next(cleanReq).pipe(finalize(() => loaderService.decrease(loaderTag)));
+}
+
+/**
+ * Error Catching Interceptor
+ * Displays error messages for failed HTTP requests.
+ *
+ * NOTE: This interceptor only handles error display.
+ * For 401 handling and token refresh, use tokenRefreshInterceptor from @flusys/ng-auth.
+ *
+ * @example
+ * ```typescript
+ * // In app.config.ts
+ * provideHttpClient(
+ *   withFetch(),
+ *   withInterceptors([
+ *     authInterceptor,           // from @flusys/ng-auth
+ *     tokenRefreshInterceptor,   // from @flusys/ng-auth
+ *     errorCatchingInterceptor,  // from @flusys/ng-core
+ *     apiLoaderInterceptor,      // from @flusys/ng-core
+ *   ])
+ * )
+ * ```
+ */
+function errorCatchingInterceptor(req, next) {
+    const messageService = inject(MessageService);
+    const platformId = inject(PLATFORM_ID);
+    const isBrowser = isPlatformBrowser(platformId);
+    // Skip error display for check-login (expected to fail when not logged in)
+    const isCheckLogin = req.url.includes('/check-login');
+    return next(req).pipe(catchError((error) => {
+        // Skip 401 errors - handled by tokenRefreshInterceptor in ng-auth
+        // Skip check-login errors - expected behavior
+        if (error.status === 401 || isCheckLogin) {
+            return throwError(() => error);
+        }
+        // Display error message for other errors
+        if (isBrowser) {
+            const message = extractErrorMessage(error);
+            messageService.add({
+                severity: 'error',
+                summary: 'Sorry, an error occurred',
+                detail: message,
+            });
+        }
+        return throwError(() => error);
+    }));
+}
+/**
+ * Extract error message from HTTP error response
+ */
+function extractErrorMessage(error) {
+    if (typeof error.error?.message === 'string') {
+        return error.error.message;
+    }
+    if (Array.isArray(error.error?.message)) {
+        return error.error.message[0];
+    }
+    if (error.message) {
+        return error.message;
+    }
+    return 'An unexpected error occurred.';
+}
+
+/**
+ * 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 feature is enabled
+ * Features are enabled if their corresponding service exists and is enabled
+ */
+function isFeatureEnabled(config, feature) {
+    const service = config.services[feature];
+    return service?.enabled ?? false;
+}
+/**
+ * Helper function to get service base URL
+ * Returns service-specific URL or falls back to default apiBaseUrl
+ */
+function getServiceUrl(config, serviceName) {
+    const service = config.services[serviceName];
+    if (service?.enabled) {
+        return service.baseUrl;
+    }
+    // Fallback to default API base URL
+    return config.apiBaseUrl;
+}
+/**
+ * Helper function to check if a service is enabled
+ */
+function isServiceEnabled(config, serviceName) {
+    const service = config.services[serviceName];
+    return service?.enabled ?? false;
+}
+/**
+ * Check if company feature is enabled (backward compatible)
+ * Company feature is enabled if auth service is enabled
+ */
+function isCompanyFeatureEnabled(config) {
+    return config.enableCompanyFeature ?? false;
+}
+/**
+ * Check if storage feature is enabled (backward compatible)
+ * Storage feature is enabled if storage service is enabled
+ */
+function isStorageFeatureEnabled(config) {
+    return config.services.storage?.enabled ?? false;
+}
+/**
+ * Get permission mode from config
+ * Defaults to 'full' if not specified
+ */
+function getPermissionMode(config) {
+    return config.permissionMode ?? 'full';
+}
+const DEFAULT_APP_NAME = 'FLUSYS';
+
+/**
+ * Base API Service
+ * Provides service-specific base URL resolution
+ *
+ * Usage:
+ * ```typescript
+ * @Injectable({ providedIn: 'root' })
+ * export class MyService extends BaseApiService {
+ *   constructor() {
+ *     super('my-service'); // Service name from config
+ *   }
+ *
+ *   getData() {
+ *     return this.http.get(`${this.baseUrl}/data`);
+ *   }
+ * }
+ * ```
+ */
+class BaseApiService {
+    http = inject(HttpClient);
+    appConfig = inject(APP_CONFIG);
+    baseUrl;
+    /**
+     * @param serviceName - Service name from config (e.g., 'auth', 'iam', 'storage')
+     */
+    constructor(serviceName) {
+        this.baseUrl = getServiceUrl(this.appConfig, serviceName);
+        console.log(`[${serviceName}] Base URL:`, this.baseUrl);
+    }
+    /**
+     * Get full URL for an endpoint
+     * @param endpoint - API endpoint (e.g., '/users/get-all')
+     * @returns Full URL (e.g., 'http://localhost:2002/users/get-all')
+     */
+    getUrl(endpoint) {
+        // Remove leading slash if present to avoid double slashes
+        const cleanEndpoint = endpoint.startsWith('/') ? endpoint.substring(1) : endpoint;
+        return `${this.baseUrl}/${cleanEndpoint}`;
+    }
+}
+
+// Components
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { APP_CONFIG, ApiLoaderService, BaseApiService, DEFAULT_APP_NAME, LibAppConfigComponent, apiLoaderInterceptor, errorCatchingInterceptor, getDatabaseMode, getPermissionMode, getServiceUrl, isCompanyFeatureEnabled, isFeatureEnabled, isServiceEnabled, isStorageFeatureEnabled };
+//# sourceMappingURL=flusys-ng-core.mjs.map

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

@@ -0,0 +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 loaders = signal<Record<string, number>>({}); // 👈 reactive store\n  public 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  standalone: true,\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} 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 * Error Catching Interceptor\n * Displays error messages for failed HTTP requests.\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\n  return next(req).pipe(\n    catchError((error: HttpErrorResponse) => {\n      // Skip 401 errors - handled by tokenRefreshInterceptor in ng-auth\n      // Skip check-login errors - expected behavior\n      if (error.status === 401 || isCheckLogin) {\n        return throwError(() => error);\n      }\n\n      // Display error message for other errors\n      if (isBrowser) {\n        const message = extractErrorMessage(error);\n        messageService.add({\n          severity: 'error',\n          summary: 'Sorry, an error occurred',\n          detail: message,\n        });\n      }\n\n      return throwError(() => error);\n    })\n  );\n}\n\n/**\n * Extract error message from HTTP error response\n */\nfunction extractErrorMessage(error: HttpErrorResponse): string {\n  if (typeof error.error?.message === 'string') {\n    return error.error.message;\n  }\n\n  if (Array.isArray(error.error?.message)) {\n    return error.error.message[0];\n  }\n\n  if (error.message) {\n    return error.message;\n  }\n\n  return 'An unexpected error occurred.';\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 * App Configuration Interface\n * Centralized configuration for feature toggles and behavior control\n */\nexport interface IAppConfig {\n  /** Application name */\n  appName: string;\n\n  /** Default API base URL (fallback) */\n  apiBaseUrl: string;  \n  \n  /**\n   * enableCompanyFeature in across the app\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: IServiceConfig;\n    [key: string]: IServiceConfig;\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 feature is enabled\n * Features are enabled if their corresponding service exists and is enabled\n */\nexport function isFeatureEnabled(\n  config: IAppConfig,\n  feature: 'auth' | 'iam' | 'storage',\n): boolean {\n  const service = config.services[feature];\n  return service?.enabled ?? false;\n}\n\n/**\n * Helper function to get service base URL\n * Returns service-specific URL or falls back to default apiBaseUrl\n */\nexport function getServiceUrl(\n  config: IAppConfig,\n  serviceName: keyof IAppConfig['services'],\n): string {\n  const service = config.services[serviceName];\n  if (service?.enabled) {\n    return service.baseUrl;\n  }\n  // Fallback to default API base URL\n  return config.apiBaseUrl;\n}\n\n/**\n * Helper function to check if a service is enabled\n */\nexport function isServiceEnabled(\n  config: IAppConfig,\n  serviceName: keyof IAppConfig['services'],\n): boolean {\n  const service = config.services[serviceName];\n  return service?.enabled ?? false;\n}\n\n/**\n * Check if company feature is enabled (backward compatible)\n * Company feature is enabled if auth service is enabled\n */\nexport function isCompanyFeatureEnabled(config: IAppConfig): boolean {\n  return config.enableCompanyFeature ?? false;\n}\n\n/**\n * Check if storage feature is enabled (backward compatible)\n * Storage feature is enabled if storage service is enabled\n */\nexport function isStorageFeatureEnabled(config: IAppConfig): boolean {\n  return config.services.storage?.enabled ?? false;\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}\nexport const DEFAULT_APP_NAME = 'FLUSYS';\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 * 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.get(`${this.baseUrl}/data`);\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    console.log(`[${serviceName}] Base URL:`, this.baseUrl);\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/lib-app-config/lib-app-config.component';\n\n// Interceptors\nexport * from './interceptors/api-loader.interceptor';\nexport * from './interceptors/error-catching.interceptor';\n\n// Interfaces\nexport * from './interfaces/app-config.interface';\n\n// Services\nexport * from './services/api-loader.service';\nexport * from './services/base-api.service';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@flusys/ng-core",
+  "version": "0.1.0-alpha.1",
+  "description": "Core utilities and services for FLUSYS Angular packages",
+  "license": "MIT",
+  "peerDependencies": {
+    "@angular/common": "^21.0.0",
+    "@angular/core": "^21.0.0"
+  },
+  "sideEffects": false,
+  "module": "fesm2022/flusys-ng-core.mjs",
+  "typings": "types/flusys-ng-core.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./types/flusys-ng-core.d.ts",
+      "default": "./fesm2022/flusys-ng-core.mjs"
+    }
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  }
+}

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

@@ -0,0 +1,194 @@
+import * as i0 from '@angular/core';
+import { Signal, InjectionToken } from '@angular/core';
+import { HttpRequest, HttpHandlerFn, HttpEvent, HttpClient } from '@angular/common/http';
+import { Observable } from 'rxjs';
+import * as _flusys_ng_core from '@flusys/ng-core';
+
+declare class ApiLoaderService {
+    private loaders;
+    readonly DEFAULT_TAG = "default";
+    readonly show: Signal<boolean>;
+    getLoader(name: string): Signal<boolean>;
+    increase(name?: string): void;
+    decrease(name?: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ApiLoaderService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ApiLoaderService>;
+}
+
+/**
+ * Root configuration component providing global UI elements.
+ * Include once at app root for global toast, confirm dialog, and loader.
+ */
+declare class LibAppConfigComponent {
+    readonly apiLoaderService: ApiLoaderService;
+    static ɵfac: i0.ɵɵFactoryDeclaration<LibAppConfigComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<LibAppConfigComponent, "lib-app-config", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Interceptor that tracks loading state for HTTP requests.
+ * Uses 'x-loader-tag' header to group related requests.
+ *
+ * @example
+ * ```typescript
+ * http.get('/api/users', {
+ *   headers: new HttpHeaders({ 'x-loader-tag': 'users-list' })
+ * });
+ * // In template: apiLoaderService.getLoader('users-list')
+ * ```
+ */
+declare function apiLoaderInterceptor(req: HttpRequest<unknown>, next: HttpHandlerFn): Observable<HttpEvent<unknown>>;
+
+/**
+ * Error Catching Interceptor
+ * Displays error messages for failed HTTP requests.
+ *
+ * NOTE: This interceptor only handles error display.
+ * For 401 handling and token refresh, use tokenRefreshInterceptor from @flusys/ng-auth.
+ *
+ * @example
+ * ```typescript
+ * // In app.config.ts
+ * provideHttpClient(
+ *   withFetch(),
+ *   withInterceptors([
+ *     authInterceptor,           // from @flusys/ng-auth
+ *     tokenRefreshInterceptor,   // from @flusys/ng-auth
+ *     errorCatchingInterceptor,  // from @flusys/ng-core
+ *     apiLoaderInterceptor,      // from @flusys/ng-core
+ *   ])
+ * )
+ * ```
+ */
+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;
+}
+/**
+ * App Configuration Interface
+ * Centralized configuration for feature toggles and behavior control
+ */
+interface IAppConfig {
+    /** Application name */
+    appName: string;
+    /** Default API base URL (fallback) */
+    apiBaseUrl: string;
+    /**
+     * enableCompanyFeature in across the app
+     */
+    enableCompanyFeature: boolean;
+    /**
+     * Service-specific base URLs
+     * If a service exists in this object, its feature is enabled
+     * Database mode is determined by multiTenant.enabled
+     */
+    services: {
+        auth: IServiceConfig;
+        iam: IServiceConfig;
+        storage: IServiceConfig;
+        [key: string]: IServiceConfig;
+    };
+    /**
+     * 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)
+     */
+    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 feature is enabled
+ * Features are enabled if their corresponding service exists and is enabled
+ */
+declare function isFeatureEnabled(config: IAppConfig, feature: 'auth' | 'iam' | 'storage'): boolean;
+/**
+ * Helper function to get service base URL
+ * Returns service-specific URL or falls back to default apiBaseUrl
+ */
+declare function getServiceUrl(config: IAppConfig, serviceName: keyof IAppConfig['services']): string;
+/**
+ * Helper function to check if a service is enabled
+ */
+declare function isServiceEnabled(config: IAppConfig, serviceName: keyof IAppConfig['services']): boolean;
+/**
+ * Check if company feature is enabled (backward compatible)
+ * Company feature is enabled if auth service is enabled
+ */
+declare function isCompanyFeatureEnabled(config: IAppConfig): boolean;
+/**
+ * Check if storage feature is enabled (backward compatible)
+ * Storage feature is enabled if storage service is enabled
+ */
+declare function isStorageFeatureEnabled(config: IAppConfig): boolean;
+/**
+ * Get permission mode from config
+ * Defaults to 'full' if not specified
+ */
+declare function getPermissionMode(config: IAppConfig): PermissionMode;
+declare const DEFAULT_APP_NAME = "FLUSYS";
+
+/**
+ * Base API Service
+ * Provides service-specific base URL resolution
+ *
+ * Usage:
+ * ```typescript
+ * @Injectable({ providedIn: 'root' })
+ * export class MyService extends BaseApiService {
+ *   constructor() {
+ *     super('my-service'); // Service name from config
+ *   }
+ *
+ *   getData() {
+ *     return this.http.get(`${this.baseUrl}/data`);
+ *   }
+ * }
+ * ```
+ */
+declare abstract class BaseApiService {
+    protected readonly http: HttpClient;
+    protected readonly appConfig: _flusys_ng_core.IAppConfig;
+    protected readonly baseUrl: string;
+    /**
+     * @param serviceName - Service name from config (e.g., 'auth', 'iam', 'storage')
+     */
+    constructor(serviceName: string);
+    /**
+     * Get full URL for an endpoint
+     * @param endpoint - API endpoint (e.g., '/users/get-all')
+     * @returns Full URL (e.g., 'http://localhost:2002/users/get-all')
+     */
+    protected getUrl(endpoint: string): string;
+}
+
+export { APP_CONFIG, ApiLoaderService, BaseApiService, DEFAULT_APP_NAME, LibAppConfigComponent, apiLoaderInterceptor, errorCatchingInterceptor, getDatabaseMode, getPermissionMode, getServiceUrl, isCompanyFeatureEnabled, isFeatureEnabled, isServiceEnabled, isStorageFeatureEnabled };
+export type { IAppConfig, IServiceConfig, PermissionMode };