npm - @flusys/ng-core - Versions diffs - 1.1.1-beta → 1.2.0-rc.1 - Mend

@flusys/ng-core 1.1.1-beta → 1.2.0-rc.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/README.md +90 -500
package/fesm2022/flusys-ng-core.mjs +66 -138
package/fesm2022/flusys-ng-core.mjs.map +1 -1
package/package.json +6 -6
package/types/flusys-ng-core.d.ts +69 -116

package/README.md CHANGED Viewed

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

package/fesm2022/flusys-ng-core.mjs CHANGED Viewed

@@ -1,24 +1,20 @@
 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 { signal, computed, Injectable, inject, Component, InjectionToken } from '@angular/core';
+import * as i1 from '@flusys/ng-ui';
+import { ConfirmDialog, UiModule } from '@flusys/ng-ui';
 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" }] : []));
+    loaders = signal({}, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "loaders" }] : /* istanbul ignore next */ []));
     DEFAULT_TAG = 'default';
     // Global loading state
     show = computed(() => {
         const loaders = this.loaders();
         return Object.values(loaders).some((count) => count > 0);
-    }, ...(ngDevMode ? [{ debugName: "show" }] : []));
+    }, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "show" }] : /* istanbul ignore next */ []));
     // Get specific loader as a signal
     getLoader(name) {
         return computed(() => (this.loaders()[name] ?? 0) > 0);
@@ -35,26 +31,38 @@ class ApiLoaderService {
             return { ...loaders, [name]: Math.max(0, current - 1) };
         });
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: ApiLoaderService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
-    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: ApiLoaderService, providedIn: 'root' });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.6", ngImport: i0, type: ApiLoaderService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.6", ngImport: i0, type: ApiLoaderService, providedIn: 'root' });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: ApiLoaderService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.6", 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.3", ngImport: i0, type: LibAppConfigComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.1.3", type: LibAppConfigComponent, isStandalone: true, selector: "lib-app-config", ngImport: i0, template: "@if (apiLoaderService.show()) {\n<p-progressBar mode=\"indeterminate\" />\n}\n<p-toast />\n<p-confirmdialog />\n", styles: [":host ::ng-deep .p-progressbar{position:fixed;height:4px;z-index:998;left:0;right:0}:host ::ng-deep .p-toast-message-success{background:color-mix(in srgb,var(--p-primary-color),transparent 84%)!important;border-color:var(--p-primary-color)!important;color:var(--p-primary-color)!important}:host ::ng-deep .p-toast-message-success .p-toast-message-icon{color:var(--p-primary-color)!important;fill:var(--p-primary-color)!important}:host ::ng-deep .p-toast-message-success .p-toast-message-icon svg{color:var(--p-primary-color)!important;fill:var(--p-primary-color)!important}:host ::ng-deep .p-toast-message-success .p-toast-message-icon path{fill:var(--p-primary-color)!important}:host ::ng-deep .p-toast-message-success .p-toast-close-button{color:var(--p-primary-color)!important}:host ::ng-deep .p-toast-message-success .p-toast-close-button .p-toast-close-icon{color:var(--p-primary-color)!important}:host ::ng-deep .p-toast-message-success .p-toast-close-button:hover{background:color-mix(in srgb,var(--p-primary-color),transparent 70%)!important;color:var(--p-primary-color)!important}:host ::ng-deep .p-toast-message-success .p-toast-close-button:focus{box-shadow:0 0 0 .2rem color-mix(in srgb,var(--p-primary-color),transparent 50%)!important}:host ::ng-deep .p-toast-message-success .p-toast-detail{color:var(--p-text-color)!important}\n"], dependencies: [{ kind: "component", type: ConfirmDialog, selector: "p-confirmDialog, p-confirmdialog, p-confirm-dialog", inputs: ["header", "icon", "message", "style", "styleClass", "maskStyleClass", "acceptIcon", "acceptLabel", "closeAriaLabel", "acceptAriaLabel", "acceptVisible", "rejectIcon", "rejectLabel", "rejectAriaLabel", "rejectVisible", "acceptButtonStyleClass", "rejectButtonStyleClass", "closeOnEscape", "dismissableMask", "blockScroll", "rtl", "closable", "appendTo", "key", "autoZIndex", "baseZIndex", "transitionOptions", "focusTrap", "defaultFocus", "breakpoints", "modal", "visible", "position", "draggable"], outputs: ["onHide"] }, { kind: "ngmodule", type: ProgressBarModule }, { kind: "component", type: i1.ProgressBar, selector: "p-progressBar, p-progressbar, p-progress-bar", inputs: ["value", "showValue", "styleClass", "valueStyleClass", "unit", "mode", "color"] }, { kind: "ngmodule", type: ToastModule }, { kind: "component", type: i2.Toast, selector: "p-toast", inputs: ["key", "autoZIndex", "baseZIndex", "life", "styleClass", "position", "preventOpenDuplicates", "preventDuplicates", "showTransformOptions", "hideTransformOptions", "showTransitionOptions", "hideTransitionOptions", "motionOptions", "breakpoints"], outputs: ["onClose"] }] });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.6", ngImport: i0, type: LibAppConfigComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.0.6", type: LibAppConfigComponent, isStandalone: true, selector: "lib-app-config", ngImport: i0, template: `
+    @if (apiLoaderService.show()) {
+      <f-progressbar mode="indeterminate" />
+    }
+    <f-toast />
+    <f-confirmdialog />
+  `, isInline: true, dependencies: [{ kind: "component", type: ConfirmDialog, selector: "f-confirmdialog", inputs: ["key", "icon", "acceptLabel", "rejectLabel", "acceptIcon", "rejectIcon", "acceptButtonStyleClass", "rejectButtonStyleClass", "closeOnEscape", "blockScroll", "defaultFocus", "styleClass", "style"] }, { kind: "ngmodule", type: UiModule }, { kind: "component", type: i1.ToastComponent, selector: "f-toast", inputs: ["key", "position"], outputs: ["onClose"] }, { kind: "component", type: i1.ProgressbarComponent, selector: "f-progressbar", inputs: ["value", "mode", "showValue", "unit", "severity", "color", "styleClass"] }] });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: LibAppConfigComponent, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.6", 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}:host ::ng-deep .p-toast-message-success{background:color-mix(in srgb,var(--p-primary-color),transparent 84%)!important;border-color:var(--p-primary-color)!important;color:var(--p-primary-color)!important}:host ::ng-deep .p-toast-message-success .p-toast-message-icon{color:var(--p-primary-color)!important;fill:var(--p-primary-color)!important}:host ::ng-deep .p-toast-message-success .p-toast-message-icon svg{color:var(--p-primary-color)!important;fill:var(--p-primary-color)!important}:host ::ng-deep .p-toast-message-success .p-toast-message-icon path{fill:var(--p-primary-color)!important}:host ::ng-deep .p-toast-message-success .p-toast-close-button{color:var(--p-primary-color)!important}:host ::ng-deep .p-toast-message-success .p-toast-close-button .p-toast-close-icon{color:var(--p-primary-color)!important}:host ::ng-deep .p-toast-message-success .p-toast-close-button:hover{background:color-mix(in srgb,var(--p-primary-color),transparent 70%)!important;color:var(--p-primary-color)!important}:host ::ng-deep .p-toast-message-success .p-toast-close-button:focus{box-shadow:0 0 0 .2rem color-mix(in srgb,var(--p-primary-color),transparent 50%)!important}:host ::ng-deep .p-toast-message-success .p-toast-detail{color:var(--p-text-color)!important}\n"] }]
+            args: [{
+                    selector: 'lib-app-config',
+                    imports: [ConfirmDialog, UiModule],
+                    template: `
+    @if (apiLoaderService.show()) {
+      <f-progressbar mode="indeterminate" />
+    }
+    <f-toast />
+    <f-confirmdialog />
+  `,
+                }]
         }] });
 /**
@@ -79,146 +87,64 @@ function apiLoaderInterceptor(req, next) {
     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 403 errors - handled by permission denied UI in components
-        // Skip check-login errors - expected behavior
-        if (error.status === 401 || error.status === 403 || isCheckLogin) {
-            return throwError(() => error);
-        }
-        // Display error message for other errors
-        if (isBrowser) {
-            const message = extractErrorMessage(error);
-            messageService.add({
-                severity: 'error',
-                summary: 'Error',
-                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];
+function isServiceEnabled(config, serviceName) {
+    const service = config.services[serviceName];
     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;
+    if (isServiceEnabled(config, serviceName)) {
+        const service = config.services[serviceName];
+        return service?.baseUrl ?? config.apiBaseUrl;
     }
-    // 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;
+function getNotificationSocketUrl(config) {
+    const service = config.services.notification;
+    if (!service?.enabled)
+        return null;
+    return service.socketUrl ?? service.baseUrl;
 }
-/**
- * Get permission mode from config
- * Defaults to 'full' if not specified
- */
 function getPermissionMode(config) {
     return config.permissionMode ?? 'full';
 }
-/**
- * Get default storage config ID from config
- * Used for file upload operations when no storageConfigId is provided
- */
 function getDefaultStorageConfigId(config) {
     return config.services.storage?.defaultStorageConfigId;
 }
-// Default branding constants
+function isSignUpEnabled(config) {
+    return config.enableSignUp ?? true;
+}
+function getDefaultCompanySlug(config) {
+    return config.registrationDefaults?.companySlug;
+}
+function getDefaultBranchSlug(config) {
+    return config.registrationDefaults?.branchSlug;
+}
 const DEFAULT_APP_NAME = 'FLUSYS';
 const DEFAULT_AUTHOR = {
     name: 'Flusys',
     url: 'https://flusys.vercel.app',
 };
+/** Registry for fallback messages when localization is not active */
+const FALLBACK_MESSAGES_REGISTRY = new InjectionToken('FALLBACK_MESSAGES_REGISTRY');
+// ✅ Provide it once at root as a single shared object
+const provideFallbackMessagesRegistry = () => ({
+    provide: FALLBACK_MESSAGES_REGISTRY,
+    useValue: {}, // Single object instance shared across all injections
+});
+const LOCALIZATION_STATE_SERVICE = new InjectionToken('LOCALIZATION_STATE_SERVICE');
+const LOCALIZATION_API_SERVICE = new InjectionToken('LOCALIZATION_API_SERVICE');
 /**
  * Base API Service
  * Provides service-specific base URL resolution
  *
+ * Note: This project uses POST-only RPC - all endpoints use POST, not REST verbs.
+ *
  * Usage:
  * ```typescript
  * @Injectable({ providedIn: 'root' })
@@ -228,7 +154,7 @@ const DEFAULT_AUTHOR = {
  *   }
  *
  *   getData() {
- *     return this.http.get(`${this.baseUrl}/data`);
+ *     return this.http.post(`${this.baseUrl}/data/get`, {});
  *   }
  * }
  * ```
@@ -250,7 +176,9 @@ class BaseApiService {
      */
     getUrl(endpoint) {
         // Remove leading slash if present to avoid double slashes
-        const cleanEndpoint = endpoint.startsWith('/') ? endpoint.substring(1) : endpoint;
+        const cleanEndpoint = endpoint.startsWith('/')
+            ? endpoint.substring(1)
+            : endpoint;
         return `${this.baseUrl}/${cleanEndpoint}`;
     }
 }
@@ -261,5 +189,5 @@ class BaseApiService {
  * Generated bundle index. Do not edit.
  */
-export { APP_CONFIG, ApiLoaderService, BaseApiService, DEFAULT_APP_NAME, DEFAULT_AUTHOR, LibAppConfigComponent, apiLoaderInterceptor, errorCatchingInterceptor, getDatabaseMode, getDefaultStorageConfigId, getPermissionMode, getServiceUrl, isCompanyFeatureEnabled, isFeatureEnabled, isServiceEnabled, isStorageFeatureEnabled };
+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 };
 //# sourceMappingURL=flusys-ng-core.mjs.map

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

	@@ -1 +1 @@
1	- {"version":3,"file":"flusys-ng-core.mjs","sources":["../../../projects/ng-core/services/api-loader.service.ts","../../../projects/ng-core/components/lib-app-config/lib-app-config.component.ts","../../../projects/ng-core/components/lib-app-config/lib-app-config.component.html","../../../projects/ng-core/interceptors/api-loader.interceptor.ts","../../../projects/ng-core/interceptors/error-catching.interceptor.ts","../../../projects/ng-core/interfaces/app-config.interface.ts","../../../projects/ng-core/services/base-api.service.ts","../../../projects/ng-core/public-api.ts","../../../projects/ng-core/flusys-ng-core.ts"],"sourcesContent":["import { computed, Injectable, Signal, signal } from '@angular/core';\n\n@Injectable({ providedIn: 'root' })\nexport class ApiLoaderService {\n private readonly loaders = signal<Record<string, number>>({});\n readonly DEFAULT_TAG = 'default';\n\n // Global loading state\n readonly show: Signal<boolean> = computed(() => {\n const loaders = this.loaders();\n return Object.values(loaders).some((count) => count > 0);\n });\n\n // Get specific loader as a signal\n getLoader(name: string): Signal<boolean> {\n return computed(() => (this.loaders()[name] ?? 0) > 0);\n }\n\n increase(name: string = this.DEFAULT_TAG): void {\n this.loaders.update((loaders) => ({\n ...loaders,\n [name]: (loaders[name] ?? 0) + 1,\n }));\n }\n\n decrease(name: string = this.DEFAULT_TAG): void {\n this.loaders.update((loaders) => {\n const current = loaders[name] ?? 0;\n return { ...loaders, [name]: Math.max(0, current - 1) };\n });\n }\n}\n","import { 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 403 errors - handled by permission denied UI in components\n // Skip check-login errors - expected behavior\n if (error.status === 401 \|\| error.status === 403 \|\| 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: 'Error',\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 Storage Service Configuration Interface\n * Extends base service config with storage-specific options\n /\nexport interface IStorageServiceConfig extends IServiceConfig {\n /\n Default storage config ID from backend storage_config table\n * Used when no storageConfigId is provided to upload operations\n * If not set, backend will use company/branch default config\n /\n defaultStorageConfigId?: string;\n}\n\n/\n Author/Brand Configuration\n /\nexport interface IAuthorConfig {\n name: string;\n url: string;\n}\n\n/\n App Configuration Interface\n * Centralized configuration for feature toggles and behavior control\n /\nexport interface IAppConfig {\n /* Application name /\n appName: string;\n\n /* Author/Brand info for footer attribution /\n author?: IAuthorConfig;\n\n /* Default API base URL (fallback) /\n apiBaseUrl: string; \n \n /\n 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: IStorageServiceConfig;\n [key: string]: IServiceConfig \| IStorageServiceConfig;\n };\n\n /\n Multi-tenant configuration\n * enabled: true → Database mode = multi-tenant\n * enabled: false → Database mode = single\n /\n multiTenant: {\n enabled: boolean;\n tenantHeader: string;\n tenantId?: string;\n };\n\n /\n IAM Permission Mode - controls permission system behavior\n * - 'rbac': Role-Based Access Control only (users get permissions via roles)\n * - 'direct': Direct action assignments only (actions assigned directly to users)\n * - 'full': Both RBAC and direct permissions (most flexible, default)\n /\n permissionMode?: PermissionMode;\n}\n\n/\n App Configuration Token\n * Use this to inject app config in services/components\n /\nexport const APP_CONFIG = new InjectionToken<IAppConfig>('APP_CONFIG');\n\n/\n Get database mode from config\n * Derived from multiTenant.enabled\n /\nexport function getDatabaseMode(config: IAppConfig): 'single' \| 'multi-tenant' {\n return config.multiTenant.enabled ? 'multi-tenant' : 'single';\n}\n\n/\n Check if a 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}\n\n/\n Get default storage config ID from config\n * Used for file upload operations when no storageConfigId is provided\n /\nexport function getDefaultStorageConfigId(config: IAppConfig): string \| undefined {\n return config.services.storage?.defaultStorageConfigId;\n}\n\n// Default branding constants\nexport const DEFAULT_APP_NAME = 'FLUSYS';\nexport const DEFAULT_AUTHOR: IAuthorConfig = {\n name: 'Flusys',\n url: 'https://flusys.vercel.app',\n};\n","import { inject } from '@angular/core';\nimport { HttpClient } from '@angular/common/http';\nimport { APP_CONFIG, getServiceUrl } from '../interfaces/app-config.interface';\n\n/\n Base API Service\n * Provides service-specific base URL resolution\n \n 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 }\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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"}
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/interceptors/api-loader.interceptor.ts","../../../projects/ng-core/interfaces/app-config.interface.ts","../../../projects/ng-core/interfaces/translate-adapter.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 { ConfirmDialog, UiModule } from '@flusys/ng-ui';\nimport { ApiLoaderService } from '../../services/api-loader.service';\n\n@Component({\n selector: 'lib-app-config',\n imports: [ConfirmDialog, UiModule],\n template: `\n @if (apiLoaderService.show()) {\n <f-progressbar mode=\"indeterminate\" />\n }\n <f-toast />\n <f-confirmdialog />\n `,\n})\nexport class LibAppConfigComponent {\n readonly apiLoaderService = inject(ApiLoaderService);\n}\n","import { HttpEvent, HttpHandlerFn, HttpRequest } from '@angular/common/http';\nimport { inject } from '@angular/core';\nimport { Observable } from 'rxjs';\nimport { finalize } from 'rxjs/operators';\nimport { ApiLoaderService } from '../services/api-loader.service';\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 =\n 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(finalize(() => loaderService.decrease(loaderTag)));\n}\n","import { InjectionToken } from '@angular/core';\n\nexport type PermissionMode = 'rbac' \| 'direct' \| 'full';\n\nexport type ServiceName =\n \| 'auth'\n \| 'administration'\n \| 'iam'\n \| 'storage'\n \| 'formBuilder'\n \| 'email'\n \| 'eventManager'\n \| 'notification'\n \| 'localization'\n \| 'taskManager';\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 LayoutConfig {\n preset?: string;\n primary?: string;\n surface?: string \| null;\n darkTheme?: boolean;\n menuMode?: 'static' \| 'overlay' \| 'topbar';\n isMemorable?: boolean;\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 layoutConfig?: LayoutConfig;\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 localization?: IServiceConfig;\n taskManager?: IServiceConfig;\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 isServiceEnabled(\n config: IAppConfig,\n serviceName: ServiceName,\n): boolean {\n const service = config.services[serviceName as keyof typeof config.services];\n return service?.enabled ?? false;\n}\n\nexport function getServiceUrl(\n config: IAppConfig,\n serviceName: ServiceName,\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 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 const DEFAULT_APP_NAME = 'FLUSYS';\nexport const DEFAULT_AUTHOR: IAuthorConfig = {\n name: 'Flusys',\n url: 'https://flusys.vercel.app',\n};\n","import { InjectionToken, Signal } from '@angular/core';\nimport { Observable } from 'rxjs';\n\nexport interface ITranslateAdapter {\n /* Current language code signal - read this to create reactive dependency /\n translate(key: string, params?: Record<string, unknown>): string;\n}\n\n/* Registry for fallback messages when localization is not active /\nexport const FALLBACK_MESSAGES_REGISTRY = new InjectionToken<\n Record<string, string>\n>('FALLBACK_MESSAGES_REGISTRY');\n// ✅ Provide it once at root as a single shared object\nexport const provideFallbackMessagesRegistry = () => ({\n provide: FALLBACK_MESSAGES_REGISTRY,\n useValue: {}, // Single object instance shared across all injections\n});\n\n// Injection Token for localization services used in the resolver\nexport interface ILocalizationStateServicesAdapter {\n updateFallbackMessages(messages: Record<string, string>): void;\n currentLanguageCode: Signal<string>;\n isModuleLoaded(module: string): boolean;\n mergeTranslations(translations: Record<string, string>): void;\n markModuleLoaded(module: string): void;\n currentLanguage: Signal<string>;\n translations: Signal<Record<string, string>>;\n fallbackMessages: Signal<Record<string, string>>;\n}\nexport interface ILocalizationApiServicesAdapter {\n getTranslationsByLanguage(languageCode: string, modules: string[]): Observable<unknown>;\n}\nexport const LOCALIZATION_STATE_SERVICE =\n new InjectionToken<ILocalizationStateServicesAdapter>(\n 'LOCALIZATION_STATE_SERVICE',\n );\nexport const LOCALIZATION_API_SERVICE =\n new InjectionToken<ILocalizationApiServicesAdapter>(\n 'LOCALIZATION_API_SERVICE',\n );\n","import { HttpClient } from '@angular/common/http';\nimport { inject } from '@angular/core';\nimport {\n APP_CONFIG,\n getServiceUrl,\n ServiceName,\n} 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: ServiceName) {\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('/')\n ? endpoint.substring(1)\n : 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 CHANGED Viewed

@@ -1,14 +1,13 @@
 {
   "name": "@flusys/ng-core",
-  "version": "1.1.1-beta",
+  "version": "1.2.0-rc.1",
   "description": "Core utilities and services for FLUSYS Angular packages",
   "license": "MIT",
   "peerDependencies": {
-    "@angular/common": "^21.0.0",
-    "@angular/core": "^21.0.0",
-    "@primeuix/themes": "^1.0.0",
-    "primeicons": "^7.0.0",
-    "primeng": "^21.0.0"
+    "@angular/common": ">=22.0.0",
+    "@angular/core": ">=22.0.0",
+    "@flusys/ng-ui": ">=1.2.0-rc.1",
+    "rxjs": "^7.8.0"
   },
   "sideEffects": false,
   "module": "fesm2022/flusys-ng-core.mjs",
@@ -22,6 +21,7 @@
       "default": "./fesm2022/flusys-ng-core.mjs"
     }
   },
+  "type": "module",
   "dependencies": {
     "tslib": "^2.3.0"
   }

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

@@ -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,154 +35,111 @@ declare class LibAppConfigComponent {
  */
 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
- */
+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;
 }
-/**
- * App Configuration Interface
- * Centralized configuration for feature toggles and behavior control
- */
+interface IRegistrationDefaults {
+    companySlug?: string;
+    branchSlug?: string;
+}
+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;
-    /**
-     * 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
-     */
+    /** @default true */
+    enableSignUp?: boolean;
+    registrationDefaults?: IRegistrationDefaults;
+    layoutConfig?: LayoutConfig;
     services: {
         auth: IServiceConfig;
+        administration: IServiceConfig;
         iam: IServiceConfig;
         storage: IStorageServiceConfig;
-        [key: string]: IServiceConfig | 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 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 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 (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 getNotificationSocketUrl(config: IAppConfig): string | null;
 declare function getPermissionMode(config: IAppConfig): PermissionMode;
-/**
- * Get default storage config ID from config
- * Used for file upload operations when no storageConfigId is provided
- */
 declare function getDefaultStorageConfigId(config: IAppConfig): string | undefined;
+declare function isSignUpEnabled(config: IAppConfig): boolean;
+declare function getDefaultCompanySlug(config: IAppConfig): string | undefined;
+declare function getDefaultBranchSlug(config: IAppConfig): string | undefined;
 declare 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
  *
+ * Note: This project uses POST-only RPC - all endpoints use POST, not REST verbs.
+ *
  * Usage:
  * ```typescript
  * @Injectable({ providedIn: 'root' })
@@ -196,7 +149,7 @@ declare const DEFAULT_AUTHOR: IAuthorConfig;
  *   }
  *
  *   getData() {
- *     return this.http.get(`${this.baseUrl}/data`);
+ *     return this.http.post(`${this.baseUrl}/data/get`, {});
  *   }
  * }
  * ```
@@ -208,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')
@@ -217,5 +170,5 @@ declare abstract class BaseApiService {
     protected getUrl(endpoint: string): string;
 }
-export { APP_CONFIG, ApiLoaderService, BaseApiService, DEFAULT_APP_NAME, DEFAULT_AUTHOR, LibAppConfigComponent, apiLoaderInterceptor, errorCatchingInterceptor, getDatabaseMode, getDefaultStorageConfigId, getPermissionMode, getServiceUrl, isCompanyFeatureEnabled, isFeatureEnabled, isServiceEnabled, isStorageFeatureEnabled };
-export type { IAppConfig, IAuthorConfig, IServiceConfig, IStorageServiceConfig, PermissionMode };
+export { APP_CONFIG, ApiLoaderService, BaseApiService, DEFAULT_APP_NAME, DEFAULT_AUTHOR, 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 };