http-request-manager 18.9.4 → 18.9.5

package/README.md

@@ -24,10 +24,24 @@ A comprehensive Angular library providing enterprise-grade HTTP request manageme
 - ✅ **Type-Safe** - Full TypeScript support with generics
 - ✅ **Offline-First** - Built-in IndexedDB caching
 - ✅ **Real-Time Ready** - Seamless WebSocket integration
-- ✅ **Secure** - Encryption support for sensitive data
+- ✅ **Secure** - AES & RSA encryption support for sensitive data
 - ✅ **Scalable** - ComponentStore-based architecture
 - ✅ **Flexible** - Works with Observables or Signals
 
+### 🚀 Advanced Features
+
+| Feature | Description | Learn More |
+|---------|-------------|------------|
+| **🔐 Enterprise Encryption** | AES symmetric + RSA asymmetric encryption | [`Encryption Utils`](./src/docs/UTILS_README.md#encryption) |
+| **📡 Streaming Support** | NDJSON & Server-Sent Events (SSE) | [`HTTP Manager`](./src/docs/HTTP_MANAGER_README.md#streaming) |
+| **📄 File Downloads** | Progress tracking for large files | [`HTTP Manager`](./src/docs/HTTP_MANAGER_README.md#file-downloads) |
+| **📊 Pagination** | Built-in pagination with page tracking | [`HTTP State Manager`](./src/docs/HTTP_STATE_MANAGER_README.md#pagination) |
+| **🔔 Smart Notifications** | Persistent notifications with DB storage | [`WebSocket Guide`](./src/docs/ADVANCED_WEBSOCKET.md#notifications) |
+| **👥 Presence Tracking** | Real-time user presence by channel | [`WebSocket Guide`](./src/docs/ADVANCED_WEBSOCKET.md#presence) |
+| **🔄 Message Replay** | Automatic message history on reconnect | [`WebSocket Guide`](./src/docs/ADVANCED_WEBSOCKET.md#message-replay) |
+| **🏷️ Channel Architecture** | SYS-, PUB-, MES- channel prefixes | [`WebSocket Guide`](./src/docs/ADVANCED_WEBSOCKET.md#channels) |
+| **🔌 Singleton WebSocket** | Single connection across ALL instances | [`WebSocket Guide`](./src/docs/ADVANCED_WEBSOCKET.md#singleton) |
+
 ## 📋 Table of Contents
 
 - [Quick Start](#-quick-start)
@@ -35,6 +49,7 @@ A comprehensive Angular library providing enterprise-grade HTTP request manageme
 - [Services Overview](#-services-overview)
 - [Architecture](./src/docs/ARCHITECTURE.md)
 - [Interceptors](./src/docs/INTERCEPTOR_README.md)
+- [Advanced Features](#-advanced-features)
 - [Detailed Documentation](#-detailed-documentation)
 - [Demo Examples](#-demo-examples)
 - [Migration Guide](#-migration-guide)
@@ -216,14 +231,14 @@ export class AppModule { }
 
 | Service | Description | Use Case |
 |---------|-------------|----------|
-| [`HTTPManagerService`](./src/docs/HTTP_MANAGER_README.md) | Observable-based HTTP client | Simple API calls with loading states |
-| [`HTTPManagerSignalsService`](./src/docs/HTTP_SINGNALS_MANAGER_README.md) | Signal-based HTTP client | Modern reactive UI with Angular Signals |
-| [`HTTPManagerStateService`](./src/docs/HTTP_STATE_MANAGER_README.md) | ComponentStore with HTTP & WebSocket | CRUD operations with auto state sync |
-| [`WebSocketService`](./src/docs/WS_MANAGER_README.md) | WebSocket connection management | Real-time messaging and notifications |
-| [`LocalStorageManagerService`](./src/docs/LOCAL_STORAGE_README.md) | Secure local storage | User preferences, session data |
-| [`DatabaseManagerService`](./src/docs/DATABASE_README.md) | IndexedDB wrapper | Offline-first data access |
-| [`StoreStateManagerService`](./STORE_STATE_MANAGER_README.md) | Persistent ComponentStore | Application state persistence |
-| [`UtilsService`](./src/docs/UTILS_README.md) | Utility functions | JSON handling, encryption, headers, and conversions |
+| [`HTTPManagerService`](./src/docs/HTTP_MANAGER_README.md) | Observable-based HTTP client with retry, polling, streaming | Simple API calls with loading states |
+| [`HTTPManagerSignalsService`](./src/docs/HTTP_SINGNALS_MANAGER_README.md) | Signal-based HTTP client for modern reactive UI | Modern Angular with Signals |
+| [`HTTPManagerStateService`](./src/docs/HTTP_STATE_MANAGER_README.md) | ComponentStore + HTTP + WebSocket + IndexedDB | CRUD with auto state sync & real-time |
+| [`WebSocketManagerService`](./src/docs/WS_MANAGER_README.md) | Singleton WebSocket connection manager | Real-time messaging & notifications |
+| [`LocalStorageManagerService`](./src/docs/LOCAL_STORAGE_README.md) | Secure local/session storage with encryption | User preferences, session data |
+| [`DatabaseManagerService`](./src/docs/DATABASE_README.md) | IndexedDB wrapper via Dexie.js | Offline-first data access |
+| [`StoreStateManagerService`](./src/docs/COMPLETE_API_REFERENCE.md#storestatemanagerservice) | Persistent ComponentStore with localStorage sync | Application state persistence |
+| [`UtilsService`](./src/docs/UTILS_README.md) | Utilities: encryption, headers, merging, path/query | Helper functions |
 
 ### Common Use Cases
 
@@ -231,12 +246,16 @@ export class AppModule { }
 |----------|---------------|--------------|
 | Simple API calls | `HTTPManagerService` | Observables, retry, polling |
 | Modern reactive UI | `HTTPManagerSignalsService` | Angular Signals |
-| CRUD operations | `HTTPManagerStateService` | Auto state updates |
-| Real-time chat | `HTTPManagerStateService` + WebSocket | Messaging channels |
-| Persistent notifications | `HTTPManagerStateService` + WebSocket | Database-backed |
+| CRUD operations | `HTTPManagerStateService` | Auto state updates, pagination |
+| Real-time chat | `HTTPManagerStateService` + WebSocket | PUB- messaging channels |
+| Persistent notifications | `HTTPManagerStateService` + WebSocket | MES- channels with DB storage |
+| State synchronization | `HTTPManagerStateService` + WebSocket | SYS- private channels |
 | User preferences | `LocalStorageManagerService` | Encryption, expiration |
-| Offline-first | `DatabaseManagerService` | IndexedDB |
-| Large local datasets | `DatabaseManagerService` | Querying, indexing |
+| Offline-first | `DatabaseManagerService` | IndexedDB caching, querying |
+| Large local datasets | `DatabaseManagerService` | Bulk operations, indexing |
+| Secure data storage | `LocalStorageManagerService` | AES encryption |
+| File transfers | `HTTPManagerService` | Download progress tracking |
+| Live data streams | `HTTPManagerService` | NDJSON, SSE streaming |
 
 ## 🏗️ Architecture
 
@@ -298,9 +317,12 @@ The library provides several HTTP interceptors that are automatically configured
 
 ### Available Interceptors
 
-- **RequestErrorInterceptor** - Handles 400/500 errors with toast notifications
-- **WithCredentialsInterceptor** - Adds `withCredentials: true` to requests
-- **RequestHeadersInterceptor** - Adds common headers (Content-Type, Accept-Language, Current-Date)
+| Interceptor | Purpose | Automatically Applied |
+|-------------|---------|----------------------|
+| **RequestErrorInterceptor** | Handles 400/500 errors with toast notifications | ✅ Yes |
+| **RequestHeadersInterceptor** | Adds Content-Type, Accept-Language, Current-Date | ✅ Yes |
+| **CredentialsInterceptor** | Adds `withCredentials: true` for CORS | ✅ Yes |
+| **ProxyDebuggerInterceptor** | Debug logging for development | ⚙️ Configurable |
 
 ### Manual Configuration
 
@@ -313,6 +335,22 @@ providers: [
 ]
 ```
 
+### Customization
+
+Error handling can be customized with `ErrorSettings`:
+
+```typescript
+import { ErrorSettings } from 'http-request-manager';
+
+const customSettings: ErrorSettings = {
+  displayError: true,
+  displayWarning: true,
+  customHandler: (error) => {
+    // Custom error handling logic
+  }
+};
+```
+
 ## 📚 Detailed Documentation
 
 For in-depth documentation on each service and component, refer to the following detailed guides:
@@ -327,7 +365,7 @@ For in-depth documentation on each service and component, refer to the following
 | 📖 [WebSocket Manager Service](./src/docs/WS_MANAGER_README.md) | WebSocket connection management with channel-based messaging and notifications |
 | 📖 [Local Storage Manager Service](./src/docs/LOCAL_STORAGE_README.md) | Secure local/session storage with encryption and expiration |
 | 📖 [Database Manager Service](./src/docs/DATABASE_README.md) | IndexedDB wrapper via Dexie.js with Observable API for offline-first apps |
-| 📖 [Store State Manager Service](./STORE_STATE_MANAGER_README.md) | Persistent ComponentStore synchronized with local/session storage |
+| 📖 [Store State Manager Service](./src/docs/COMPLETE_API_REFERENCE.md#storestatemanagerservice) | Persistent ComponentStore synchronized with local/session storage |
 | 📖 [Utils Service](./src/docs/UTILS_README.md) | Utility functions for JSON handling, encryption, headers, and validation |
 
 ### Core Components
@@ -344,18 +382,57 @@ For in-depth documentation on each service and component, refer to the following
 
 ## 🎮 Demo Examples
 
-Comprehensive demo components showcase all library features:
+Comprehensive demo components showcase all library features in action:
 
 ### Available Demos
 
 Located in [`src/lib/http-request-services-demo/`](src/lib/http-request-services-demo/):
 
-- **HttpRequestServicesDemoComponent** - Main demo component
-- **RequestManagerDemoComponent** - HTTP service demonstrations
-- **RequestManagerStateDemoComponent** - State management examples
-- **RequestManagerWsDemoComponent** - WebSocket functionality
-- **LocalStorageDemoComponent** - Local storage examples
-- **DatabaseDataDemoComponent** - IndexedDB operations
+| Demo Component | Features Demonstrated |
+|----------------|----------------------|
+| **HttpRequestServicesDemoComponent** | Main demo hub with service selection |
+| **RequestManagerDemoComponent** | HTTP CRUD, file downloads, streaming, polling, retry |
+| **RequestManagerStateDemoComponent** | State management, pagination, WebSocket sync, IndexedDB caching |
+| **RequestManagerWsDemoComponent** | Real-time chat, AI messaging, notifications, presence tracking |
+| **LocalStorageDemoComponent** | Encrypted storage, expiration, reactive signals |
+| **LocalStorageSignalsDemoComponent** | Signal-based localStorage API |
+| **DatabaseDataDemoComponent** | IndexedDB CRUD, querying, bulk operations |
+| **RequestSignalsManagerDemoComponent** | Signal-based HTTP with file downloads |
+| **StoreStateManagerDemoComponent** | Persistent state with localStorage sync |
+
+### Demo Features
+
+**HTTP Service Demos:**
+- ✅ Basic CRUD operations
+- ✅ File download with progress tracking
+- ✅ Streaming responses (NDJSON, SSE)
+- ✅ Polling with countdown timers
+- ✅ Retry logic with custom delays
+- ✅ Error handling with toast notifications
+
+**State Management Demos:**
+- ✅ ComponentStore integration
+- ✅ Automatic state updates
+- ✅ Pagination controls
+- ✅ WebSocket real-time sync
+- ✅ IndexedDB caching
+- ✅ Database clear/refresh
+
+**WebSocket Demos:**
+- ✅ Channel-based messaging (PUB- channels)
+- ✅ Private state sync (SYS- channels)
+- ✅ Persistent notifications (MES- channels)
+- ✅ User presence tracking
+- ✅ Message history & replay
+- ✅ AI chat integration
+- ✅ Multi-room support
+
+**Storage Demos:**
+- ✅ Encrypted localStorage
+- ✅ SessionStorage usage
+- ✅ Expiration management
+- ✅ Signal-based API
+- ✅ Reactive updates
 
 ### Usage
 
@@ -369,6 +446,15 @@ Located in [`src/lib/http-request-services-demo/`](src/lib/http-request-services
 </app-http-request-services-demo>
 ```
 
+### Sample Models
+
+Demo includes production-ready sample models:
+- `User` - User data structures
+- `ClientInfo` - Client details
+- `SessionData` - Session management
+- `AIMessage` - AI chat messages
+- `Notification` - Notification structures
+
 ## 📖 Migration Guide
 
 ### From HttpClient to HTTPManagerService
@@ -434,18 +520,44 @@ isLoading$ = this.usersStore.isPending$;
 
 ### Core Models
 
-- **ApiRequest** - HTTP request configuration
-- **RetryOptions** - Retry behavior settings  
-- **DataType** - Data structure type (ARRAY, OBJECT)
-- **DatabaseStorage** - IndexedDB configuration
-- **SettingOptions** - Storage settings
-- **WSOptions** - WebSocket configuration
+All models follow the `<Name>Interface` + `<Name>Model` pattern with static `adapt()` methods.
+
+| Model | Description | Documentation |
+|-------|-------------|---------------|
+| **ApiRequest** | HTTP request configuration | [`Models Guide`](./src/docs/MODELS_README.md#apirequest) |
+| **RetryOptions** | Retry behavior settings | [`Models Guide`](./src/docs/MODELS_README.md#retryoptions) |
+| **DataType** | Data structure type (ARRAY, OBJECT) | [`Models Guide`](./src/docs/MODELS_README.md#datatype) |
+| **DatabaseStorage** | IndexedDB configuration | [`Models Guide`](./src/docs/MODELS_README.md#databasestorage) |
+| **SettingOptions** | Storage settings | [`Models Guide`](./src/docs/MODELS_README.md#settingoptions) |
+| **WSOptions** | WebSocket configuration | [`Models Guide`](./src/docs/MODELS_README.md#wsoptions) |
+| **ConfigOptions** | Global library configuration | [`Models Guide`](./src/docs/MODELS_README.md#configoptions) |
+| **StateStorageOptions** | Persistent state configuration | [`Models Guide`](./src/docs/MODELS_README.md#statestorageoptions) |
+| **TableSchemaDef** | Database table schema | [`Models Guide`](./src/docs/MODELS_README.md#tableschemadef) |
+| **ChannelMessage** | WebSocket message structure | [`Models Guide`](./src/docs/MODELS_README.md#channelmessage) |
+| **WSUser** | WebSocket user info | [`Models Guide`](./src/docs/MODELS_README.md#wsuser) |
 
 ### Enums
 
-- **StreamType** - Streaming response types
-- **StorageType** - Storage scope (GLOBAL, SESSION)
-- **CommunicationType** - WebSocket message types
+| Enum | Values | Description |
+|------|--------|-------------|
+| **DataType** | `ARRAY`, `OBJECT` | Response data structure |
+| **StreamType** | `NDJSON`, `SSE` | Streaming response types |
+| **StorageType** | `GLOBAL`, `SESSION` | Storage scope |
+| **CommunicationType** | `subscribe`, `unsubscribe`, `message`, `notification`, etc. | WebSocket message types |
+| **ChannelType** | `SYS`, `PUB`, `MES` | Channel prefixes |
+| **ToastColors** | `SUCCESS`, `WARN`, `ERROR`, `INFO` | Toast notification colors |
+
+### Configuration Tokens
+
+| Token | Type | Purpose |
+|-------|------|---------|
+| **CONFIG_SETTINGS_TOKEN** | `ConfigOptions` | Global library configuration |
+| **APP_ID** | `string` | Application ID for encryption |
+
+### Complete API Documentation
+
+For comprehensive API reference with all methods, parameters, and examples:
+📋 **[Complete API Reference](./src/docs/COMPLETE_API_REFERENCE.md)**
 
 ## 🤝 Contributing
 

package/fesm2022/http-request-manager.mjs

@@ -6933,7 +6933,7 @@ class RequestManagerDemoComponent {
         this.requestParams.GET = reqParams.apiOptions;
         this.GET$ = EMPTY; //Cancels Previous
         this.GET_error$.next('');
-        this.GET$ = this.httpManagerService.getRequest(reqParams.apiOptions, reqParams.path)
+        this.GET$ = this.httpManagerService.getRequest({ ...reqParams.apiOptions }, reqParams.path)
             .pipe(
         // tap((data) => console.log("API GET response", data)),
         catchError(error => {