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

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

@@ -1,6 +1,6 @@
 import * as i0 from '@angular/core';
 import { Signal, InjectionToken } from '@angular/core';
-import { HttpRequest, HttpHandlerFn, HttpEvent, HttpContextToken, HttpClient } from '@angular/common/http';
+import { HttpRequest, HttpHandlerFn, HttpEvent, HttpClient } from '@angular/common/http';
 import { Observable } from 'rxjs';
 import * as _flusys_ng_core from '@flusys/ng-core';
 
@@ -15,10 +15,6 @@ declare class ApiLoaderService {
     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>;
@@ -39,119 +35,46 @@ declare class LibAppConfigComponent {
  */
 declare function apiLoaderInterceptor(req: HttpRequest<unknown>, next: HttpHandlerFn): Observable<HttpEvent<unknown>>;
 
-/**
- * HTTP context token to skip global error toast.
- * Use when component handles error display locally.
- *
- * @example
- * ```typescript
- * this.http.post(url, data, {
- *   context: new HttpContext().set(SKIP_ERROR_TOAST, true)
- * });
- * ```
- */
-declare const SKIP_ERROR_TOAST: HttpContextToken<boolean>;
-/**
- * Error Catching Interceptor
- * Displays error messages for failed HTTP requests using backend response.
- *
- * Features:
- * - Uses backend's error title (error.error.error) as summary
- * - Uses backend's error message (error.error.message) as detail
- * - Falls back to sensible defaults based on status code
- * - Skip with SKIP_ERROR_TOAST context token for local handling
- *
- * 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
- */
+type ServiceName = 'auth' | 'administration' | 'iam' | 'storage' | 'formBuilder' | 'email' | 'eventManager' | 'notification' | 'localization' | 'taskManager';
 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;
 }
-/**
- * Registration Defaults Configuration
- * Pre-fills and disables fields on registration page
- */
 interface IRegistrationDefaults {
-    /** Pre-fill company code field and make it readonly */
     companySlug?: string;
-    /** Pre-fill branch code field and make it readonly */
     branchSlug?: string;
 }
-/**
- * App Configuration Interface
- * Centralized configuration for feature toggles and behavior control
- */
+interface LayoutConfig {
+    preset?: string;
+    primary?: string;
+    surface?: string | null;
+    darkTheme?: boolean;
+    menuMode?: 'static' | 'overlay' | 'topbar';
+    isMemorable?: boolean;
+}
 interface IAppConfig {
-    /** Application name */
     appName: string;
-    /** Author/Brand info for footer attribution */
+    appLogo: string;
     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;
-    /**
-     * Enable user sign-up/registration
-     * When false: hides "Sign Up" link on login page and protects registration route
-     * @default true
-     */
+    /** @default true */
     enableSignUp?: boolean;
-    /**
-     * Registration defaults for pre-filling company/branch fields
-     * When set: pre-fills fields and makes them readonly
-     */
     registrationDefaults?: IRegistrationDefaults;
-    /**
-     * Service-specific base URLs
-     * If a service exists in this object, its feature is enabled
-     * Database mode is determined by multiTenant.enabled
-     */
+    layoutConfig?: LayoutConfig;
     services: {
         auth: IServiceConfig;
         administration: IServiceConfig;
@@ -159,93 +82,58 @@ interface IAppConfig {
         storage: IStorageServiceConfig;
         formBuilder: IServiceConfig;
         email: IServiceConfig;
+        eventManager: IServiceConfig;
+        notification?: INotificationServiceConfig;
+        localization?: IServiceConfig;
+        taskManager?: 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)
-     */
+    /** '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' | 'administration' | 'iam' | 'storage' | 'formBuilder' | 'email'): boolean;
-/**
- * Get service base URL or fallback to default apiBaseUrl
- */
-declare function getServiceUrl(config: IAppConfig, serviceName: 'auth' | 'administration' | 'iam' | 'storage' | 'formBuilder' | 'email' | (string & {})): string;
-/**
- * Check if company feature is enabled
- */
+declare function isServiceEnabled(config: IAppConfig, serviceName: ServiceName): boolean;
+declare function getServiceUrl(config: IAppConfig, serviceName: ServiceName): string;
 declare function isCompanyFeatureEnabled(config: IAppConfig): boolean;
-/**
- * Check if storage feature is enabled
- */
-declare function isStorageFeatureEnabled(config: IAppConfig): boolean;
-/**
- * Check if form-builder feature is enabled
- */
-declare function isFormBuilderFeatureEnabled(config: IAppConfig): boolean;
-/**
- * Check if email feature is enabled
- */
-declare function isEmailFeatureEnabled(config: IAppConfig): boolean;
-/**
- * Get permission mode from config
- * Defaults to 'full' if not specified
- */
+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;
-/**
- * Check if sign-up/registration is enabled
- * @default true
- */
 declare function isSignUpEnabled(config: IAppConfig): boolean;
-/**
- * Get default company slug for registration
- */
 declare function getDefaultCompanySlug(config: IAppConfig): string | undefined;
-/**
- * Get default branch slug for registration
- */
 declare function getDefaultBranchSlug(config: IAppConfig): string | undefined;
-/**
- * Get registration defaults
- */
-declare function getRegistrationDefaults(config: IAppConfig): IRegistrationDefaults | undefined;
 declare const DEFAULT_APP_NAME = "FLUSYS";
 declare const DEFAULT_AUTHOR: IAuthorConfig;
 
+interface ITranslateAdapter {
+    /** Current language code signal - read this to create reactive dependency */
+    translate(key: string, params?: Record<string, unknown>): string;
+}
+/** Registry for fallback messages when localization is not active */
+declare const FALLBACK_MESSAGES_REGISTRY: InjectionToken<Record<string, string>>;
+declare const provideFallbackMessagesRegistry: () => {
+    provide: InjectionToken<Record<string, string>>;
+    useValue: {};
+};
+interface ILocalizationStateServicesAdapter {
+    updateFallbackMessages(messages: Record<string, string>): void;
+    currentLanguageCode: Signal<string>;
+    isModuleLoaded(module: string): boolean;
+    mergeTranslations(translations: Record<string, string>): void;
+    markModuleLoaded(module: string): void;
+    currentLanguage: Signal<string>;
+    translations: Signal<Record<string, string>>;
+    fallbackMessages: Signal<Record<string, string>>;
+}
+interface ILocalizationApiServicesAdapter {
+    getTranslationsByLanguage(languageCode: string, modules: string[]): Observable<unknown>;
+}
+declare const LOCALIZATION_STATE_SERVICE: InjectionToken<ILocalizationStateServicesAdapter>;
+declare const LOCALIZATION_API_SERVICE: InjectionToken<ILocalizationApiServicesAdapter>;
+
 /**
  * Base API Service
  * Provides service-specific base URL resolution
@@ -273,7 +161,7 @@ declare abstract class BaseApiService {
     /**
      * @param serviceName - Service name from config (e.g., 'auth', 'iam', 'storage')
      */
-    constructor(serviceName: string);
+    constructor(serviceName: ServiceName);
     /**
      * Get full URL for an endpoint
      * @param endpoint - API endpoint (e.g., '/users/get-all')
@@ -282,5 +170,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, getDefaultBranchSlug, getDefaultCompanySlug, getDefaultStorageConfigId, getPermissionMode, getRegistrationDefaults, getServiceUrl, isCompanyFeatureEnabled, isEmailFeatureEnabled, isFeatureEnabled, isFormBuilderFeatureEnabled, isServiceEnabled, isSignUpEnabled, isStorageFeatureEnabled };
-export type { IAppConfig, IAuthorConfig, IRegistrationDefaults, IServiceConfig, IStorageServiceConfig, PermissionMode };
+export { APP_CONFIG, ApiLoaderService, BaseApiService, DEFAULT_APP_NAME, DEFAULT_AUTHOR, FALLBACK_MESSAGES_REGISTRY, LOCALIZATION_API_SERVICE, LOCALIZATION_STATE_SERVICE, LibAppConfigComponent, apiLoaderInterceptor, getDefaultBranchSlug, getDefaultCompanySlug, getDefaultStorageConfigId, getNotificationSocketUrl, getPermissionMode, getServiceUrl, isCompanyFeatureEnabled, isServiceEnabled, isSignUpEnabled, provideFallbackMessagesRegistry };
+export type { IAppConfig, IAuthorConfig, ILocalizationApiServicesAdapter, ILocalizationStateServicesAdapter, INotificationServiceConfig, IRegistrationDefaults, IServiceConfig, IStorageServiceConfig, ITranslateAdapter, LayoutConfig, PermissionMode, ServiceName };