http-request-manager 18.9.5 → 18.10.0

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 (7) hide show
  1. package/README.md +52 -52
  2. package/fesm2022/http-request-manager.mjs +556 -66
  3. package/fesm2022/http-request-manager.mjs.map +1 -1
  4. package/http-request-manager-18.10.0.tgz +0 -0
  5. package/package.json +1 -1
  6. package/types/http-request-manager.d.ts +190 -26
  7. package/http-request-manager-18.9.5.tgz +0 -0
package/README.md CHANGED
@@ -12,12 +12,12 @@ A comprehensive Angular library providing enterprise-grade HTTP request manageme
12
12
 
13
13
  | Feature | Description | Service |
14
14
  |---------|-------------|---------|
15
- | **🌐 HTTP Request Management** | Observable-based & Signal-based HTTP services with retry logic, polling, and streaming | [`HTTPManagerService`](./src/docs/HTTP_MANAGER_README.md) |
16
- | **🔄 State Management** | ComponentStore integration with automatic CRUD state updates | [`HTTPManagerStateService`](./src/docs/HTTP_STATE_MANAGER_README.md) |
17
- | **💬 Real-Time Communication** | WebSocket messaging with channel-based architecture | [`WebSocketManagerService`](./src/docs/WS_MANAGER_README.md) |
18
- | **💾 Data Persistence** | LocalStorage/SessionStorage with encryption & IndexedDB caching | [`LocalStorageManagerService`](./src/docs/LOCAL_STORAGE_README.md) |
19
- | **🗄️ Database Management** | IndexedDB integration via Dexie.js with Observable API | [`DatabaseManagerService`](./src/docs/DATABASE_README.md) |
20
- | **⚡ Utility Functions** | JSON handling, encryption, headers, and validation | [`UtilsService`](./src/docs/UTILS_README.md) |
15
+ | **🌐 HTTP Request Management** | Observable-based & Signal-based HTTP services with retry logic, polling, and streaming | [`HTTPManagerService`](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/HTTP_MANAGER_README.md) |
16
+ | **🔄 State Management** | ComponentStore integration with automatic CRUD state updates | [`HTTPManagerStateService`](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/HTTP_STATE_MANAGER_README.md) |
17
+ | **💬 Real-Time Communication** | WebSocket messaging with channel-based architecture | [`WebSocketManagerService`](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/WS_MANAGER_README.md) |
18
+ | **💾 Data Persistence** | LocalStorage/SessionStorage with encryption & IndexedDB caching | [`LocalStorageManagerService`](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/LOCAL_STORAGE_README.md) |
19
+ | **🗄️ Database Management** | IndexedDB integration via Dexie.js with Observable API | [`DatabaseManagerService`](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/DATABASE_README.md) |
20
+ | **⚡ Utility Functions** | JSON handling, encryption, headers, and validation | [`UtilsService`](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/UTILS_README.md) |
21
21
 
22
22
  ### Key Benefits
23
23
 
@@ -32,23 +32,23 @@ A comprehensive Angular library providing enterprise-grade HTTP request manageme
32
32
 
33
33
  | Feature | Description | Learn More |
34
34
  |---------|-------------|------------|
35
- | **🔐 Enterprise Encryption** | AES symmetric + RSA asymmetric encryption | [`Encryption Utils`](./src/docs/UTILS_README.md#encryption) |
36
- | **📡 Streaming Support** | NDJSON & Server-Sent Events (SSE) | [`HTTP Manager`](./src/docs/HTTP_MANAGER_README.md#streaming) |
37
- | **📄 File Downloads** | Progress tracking for large files | [`HTTP Manager`](./src/docs/HTTP_MANAGER_README.md#file-downloads) |
38
- | **📊 Pagination** | Built-in pagination with page tracking | [`HTTP State Manager`](./src/docs/HTTP_STATE_MANAGER_README.md#pagination) |
39
- | **🔔 Smart Notifications** | Persistent notifications with DB storage | [`WebSocket Guide`](./src/docs/ADVANCED_WEBSOCKET.md#notifications) |
40
- | **👥 Presence Tracking** | Real-time user presence by channel | [`WebSocket Guide`](./src/docs/ADVANCED_WEBSOCKET.md#presence) |
41
- | **🔄 Message Replay** | Automatic message history on reconnect | [`WebSocket Guide`](./src/docs/ADVANCED_WEBSOCKET.md#message-replay) |
42
- | **🏷️ Channel Architecture** | SYS-, PUB-, MES- channel prefixes | [`WebSocket Guide`](./src/docs/ADVANCED_WEBSOCKET.md#channels) |
43
- | **🔌 Singleton WebSocket** | Single connection across ALL instances | [`WebSocket Guide`](./src/docs/ADVANCED_WEBSOCKET.md#singleton) |
35
+ | **🔐 Enterprise Encryption** | AES symmetric + RSA asymmetric encryption | [`Encryption Utils`](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/UTILS_README.md#encryption) |
36
+ | **📡 Streaming Support** | NDJSON & Server-Sent Events (SSE) | [`HTTP Manager`](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/HTTP_MANAGER_README.md#streaming) |
37
+ | **📄 File Downloads** | Progress tracking for large files | [`HTTP Manager`](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/HTTP_MANAGER_README.md#file-downloads) |
38
+ | **📊 Pagination** | Built-in pagination with page tracking | [`HTTP State Manager`](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/HTTP_STATE_MANAGER_README.md#pagination) |
39
+ | **🔔 Smart Notifications** | Persistent notifications with DB storage | [`WebSocket Guide`](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/ADVANCED_WEBSOCKET.md#notifications) |
40
+ | **👥 Presence Tracking** | Real-time user presence by channel | [`WebSocket Guide`](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/ADVANCED_WEBSOCKET.md#presence) |
41
+ | **🔄 Message Replay** | Automatic message history on reconnect | [`WebSocket Guide`](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/ADVANCED_WEBSOCKET.md#message-replay) |
42
+ | **🏷️ Channel Architecture** | SYS-, PUB-, MES- channel prefixes | [`WebSocket Guide`](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/ADVANCED_WEBSOCKET.md#channels) |
43
+ | **🔌 Singleton WebSocket** | Single connection across ALL instances | [`WebSocket Guide`](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/ADVANCED_WEBSOCKET.md#singleton) |
44
44
 
45
45
  ## 📋 Table of Contents
46
46
 
47
47
  - [Quick Start](#-quick-start)
48
48
  - [Configuration](#️-configuration)
49
49
  - [Services Overview](#-services-overview)
50
- - [Architecture](./src/docs/ARCHITECTURE.md)
51
- - [Interceptors](./src/docs/INTERCEPTOR_README.md)
50
+ - [Architecture](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/ARCHITECTURE.md)
51
+ - [Interceptors](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/INTERCEPTOR_README.md)
52
52
  - [Advanced Features](#-advanced-features)
53
53
  - [Detailed Documentation](#-detailed-documentation)
54
54
  - [Demo Examples](#-demo-examples)
@@ -231,14 +231,14 @@ export class AppModule { }
231
231
 
232
232
  | Service | Description | Use Case |
233
233
  |---------|-------------|----------|
234
- | [`HTTPManagerService`](./src/docs/HTTP_MANAGER_README.md) | Observable-based HTTP client with retry, polling, streaming | Simple API calls with loading states |
235
- | [`HTTPManagerSignalsService`](./src/docs/HTTP_SINGNALS_MANAGER_README.md) | Signal-based HTTP client for modern reactive UI | Modern Angular with Signals |
236
- | [`HTTPManagerStateService`](./src/docs/HTTP_STATE_MANAGER_README.md) | ComponentStore + HTTP + WebSocket + IndexedDB | CRUD with auto state sync & real-time |
237
- | [`WebSocketManagerService`](./src/docs/WS_MANAGER_README.md) | Singleton WebSocket connection manager | Real-time messaging & notifications |
238
- | [`LocalStorageManagerService`](./src/docs/LOCAL_STORAGE_README.md) | Secure local/session storage with encryption | User preferences, session data |
239
- | [`DatabaseManagerService`](./src/docs/DATABASE_README.md) | IndexedDB wrapper via Dexie.js | Offline-first data access |
240
- | [`StoreStateManagerService`](./src/docs/COMPLETE_API_REFERENCE.md#storestatemanagerservice) | Persistent ComponentStore with localStorage sync | Application state persistence |
241
- | [`UtilsService`](./src/docs/UTILS_README.md) | Utilities: encryption, headers, merging, path/query | Helper functions |
234
+ | [`HTTPManagerService`](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/HTTP_MANAGER_README.md) | Observable-based HTTP client with retry, polling, streaming | Simple API calls with loading states |
235
+ | [`HTTPManagerSignalsService`](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/HTTP_SINGNALS_MANAGER_README.md) | Signal-based HTTP client for modern reactive UI | Modern Angular with Signals |
236
+ | [`HTTPManagerStateService`](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/HTTP_STATE_MANAGER_README.md) | ComponentStore + HTTP + WebSocket + IndexedDB | CRUD with auto state sync & real-time |
237
+ | [`WebSocketManagerService`](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/WS_MANAGER_README.md) | Singleton WebSocket connection manager | Real-time messaging & notifications |
238
+ | [`LocalStorageManagerService`](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/LOCAL_STORAGE_README.md) | Secure local/session storage with encryption | User preferences, session data |
239
+ | [`DatabaseManagerService`](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/DATABASE_README.md) | IndexedDB wrapper via Dexie.js | Offline-first data access |
240
+ | [`StoreStateManagerService`](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/COMPLETE_API_REFERENCE.md#storestatemanagerservice) | Persistent ComponentStore with localStorage sync | Application state persistence |
241
+ | [`UtilsService`](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/UTILS_README.md) | Utilities: encryption, headers, merging, path/query | Helper functions |
242
242
 
243
243
  ### Common Use Cases
244
244
 
@@ -261,7 +261,7 @@ export class AppModule { }
261
261
 
262
262
  For detailed system architecture, data flows, and design patterns, see:
263
263
 
264
- 📋 **[Architecture Documentation](./src/docs/ARCHITECTURE.md)**
264
+ 📋 **[Architecture Documentation](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/ARCHITECTURE.md)**
265
265
 
266
266
  ### System Overview
267
267
 
@@ -313,7 +313,7 @@ For detailed system architecture, data flows, and design patterns, see:
313
313
 
314
314
  The library provides several HTTP interceptors that are automatically configured:
315
315
 
316
- 📋 **[Interceptors Documentation](./src/docs/INTERCEPTOR_README.md)**
316
+ 📋 **[Interceptors Documentation](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/INTERCEPTOR_README.md)**
317
317
 
318
318
  ### Available Interceptors
319
319
 
@@ -359,26 +359,26 @@ For in-depth documentation on each service and component, refer to the following
359
359
 
360
360
  | Documentation | Description |
361
361
  |---------------|-------------|
362
- | 📖 [HTTP Manager Service](./src/docs/HTTP_MANAGER_README.md) | Observable-based HTTP client with retry, polling, streaming, and error handling |
363
- | 📖 [HTTP Manager Signals Service](./src/docs/HTTP_SINGNALS_MANAGER_README.md) | Signal-based HTTP client for modern reactive UI with Angular Signals |
364
- | 📖 [HTTP Manager State Service](./src/docs/HTTP_STATE_MANAGER_README.md) | ComponentStore integration with automatic CRUD state updates and WebSocket sync |
365
- | 📖 [WebSocket Manager Service](./src/docs/WS_MANAGER_README.md) | WebSocket connection management with channel-based messaging and notifications |
366
- | 📖 [Local Storage Manager Service](./src/docs/LOCAL_STORAGE_README.md) | Secure local/session storage with encryption and expiration |
367
- | 📖 [Database Manager Service](./src/docs/DATABASE_README.md) | IndexedDB wrapper via Dexie.js with Observable API for offline-first apps |
368
- | 📖 [Store State Manager Service](./src/docs/COMPLETE_API_REFERENCE.md#storestatemanagerservice) | Persistent ComponentStore synchronized with local/session storage |
369
- | 📖 [Utils Service](./src/docs/UTILS_README.md) | Utility functions for JSON handling, encryption, headers, and validation |
362
+ | 📖 [HTTP Manager Service](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/HTTP_MANAGER_README.md) | Observable-based HTTP client with retry, polling, streaming, and error handling |
363
+ | 📖 [HTTP Manager Signals Service](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/HTTP_SINGNALS_MANAGER_README.md) | Signal-based HTTP client for modern reactive UI with Angular Signals |
364
+ | 📖 [HTTP Manager State Service](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/HTTP_STATE_MANAGER_README.md) | ComponentStore integration with automatic CRUD state updates and WebSocket sync |
365
+ | 📖 [WebSocket Manager Service](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/WS_MANAGER_README.md) | WebSocket connection management with channel-based messaging and notifications |
366
+ | 📖 [Local Storage Manager Service](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/LOCAL_STORAGE_README.md) | Secure local/session storage with encryption and expiration |
367
+ | 📖 [Database Manager Service](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/DATABASE_README.md) | IndexedDB wrapper via Dexie.js with Observable API for offline-first apps |
368
+ | 📖 [Store State Manager Service](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/COMPLETE_API_REFERENCE.md#storestatemanagerservice) | Persistent ComponentStore synchronized with local/session storage |
369
+ | 📖 [Utils Service](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/UTILS_README.md) | Utility functions for JSON handling, encryption, headers, and validation |
370
370
 
371
371
  ### Core Components
372
372
 
373
373
  | Documentation | Description |
374
374
  |---------------|-------------|
375
- | 🏗️ [Architecture](./src/docs/ARCHITECTURE.md) | System architecture, data flows, and design patterns |
376
- | 🔧 [Interceptors](./src/docs/INTERCEPTOR_README.md) | HTTP interceptors for error handling, headers, authentication, and debugging |
375
+ | 🏗️ [Architecture](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/ARCHITECTURE.md) | System architecture, data flows, and design patterns |
376
+ | 🔧 [Interceptors](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/INTERCEPTOR_README.md) | HTTP interceptors for error handling, headers, authentication, and debugging |
377
377
 
378
378
  ### Additional Resources
379
379
 
380
- - **Request Manager Services** - Detailed API documentation for the request manager services ([`src/lib/services/request-manager-services/README.md`](src/lib/services/request-manager-services/README.md))
381
- - **Encryption Utils** - Encryption utility documentation ([`src/lib/services/utils/encryption/README.md`](src/lib/services/utils/encryption/README.md))
380
+ - **Request Manager Services** - Detailed API documentation for the request manager services ([`src/lib/services/request-manager-services/README.md`](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/lib/services/request-manager-services/README.md))
381
+ - **Encryption Utils** - Encryption utility documentation ([`src/lib/services/utils/encryption/README.md`](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/lib/services/utils/encryption/README.md))
382
382
 
383
383
  ## 🎮 Demo Examples
384
384
 
@@ -386,7 +386,7 @@ Comprehensive demo components showcase all library features in action:
386
386
 
387
387
  ### Available Demos
388
388
 
389
- Located in [`src/lib/http-request-services-demo/`](src/lib/http-request-services-demo/):
389
+ Located in [`src/lib/http-request-services-demo/`](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/lib/http-request-services-demo/):
390
390
 
391
391
  | Demo Component | Features Demonstrated |
392
392
  |----------------|----------------------|
@@ -524,17 +524,17 @@ All models follow the `<Name>Interface` + `<Name>Model` pattern with static `ada
524
524
 
525
525
  | Model | Description | Documentation |
526
526
  |-------|-------------|---------------|
527
- | **ApiRequest** | HTTP request configuration | [`Models Guide`](./src/docs/MODELS_README.md#apirequest) |
528
- | **RetryOptions** | Retry behavior settings | [`Models Guide`](./src/docs/MODELS_README.md#retryoptions) |
529
- | **DataType** | Data structure type (ARRAY, OBJECT) | [`Models Guide`](./src/docs/MODELS_README.md#datatype) |
530
- | **DatabaseStorage** | IndexedDB configuration | [`Models Guide`](./src/docs/MODELS_README.md#databasestorage) |
531
- | **SettingOptions** | Storage settings | [`Models Guide`](./src/docs/MODELS_README.md#settingoptions) |
532
- | **WSOptions** | WebSocket configuration | [`Models Guide`](./src/docs/MODELS_README.md#wsoptions) |
533
- | **ConfigOptions** | Global library configuration | [`Models Guide`](./src/docs/MODELS_README.md#configoptions) |
534
- | **StateStorageOptions** | Persistent state configuration | [`Models Guide`](./src/docs/MODELS_README.md#statestorageoptions) |
535
- | **TableSchemaDef** | Database table schema | [`Models Guide`](./src/docs/MODELS_README.md#tableschemadef) |
536
- | **ChannelMessage** | WebSocket message structure | [`Models Guide`](./src/docs/MODELS_README.md#channelmessage) |
537
- | **WSUser** | WebSocket user info | [`Models Guide`](./src/docs/MODELS_README.md#wsuser) |
527
+ | **ApiRequest** | HTTP request configuration | [`Models Guide`](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/MODELS_README.md#apirequest) |
528
+ | **RetryOptions** | Retry behavior settings | [`Models Guide`](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/MODELS_README.md#retryoptions) |
529
+ | **DataType** | Data structure type (ARRAY, OBJECT) | [`Models Guide`](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/MODELS_README.md#datatype) |
530
+ | **DatabaseStorage** | IndexedDB configuration | [`Models Guide`](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/MODELS_README.md#databasestorage) |
531
+ | **SettingOptions** | Storage settings | [`Models Guide`](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/MODELS_README.md#settingoptions) |
532
+ | **WSOptions** | WebSocket configuration | [`Models Guide`](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/MODELS_README.md#wsoptions) |
533
+ | **ConfigOptions** | Global library configuration | [`Models Guide`](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/MODELS_README.md#configoptions) |
534
+ | **StateStorageOptions** | Persistent state configuration | [`Models Guide`](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/MODELS_README.md#statestorageoptions) |
535
+ | **TableSchemaDef** | Database table schema | [`Models Guide`](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/MODELS_README.md#tableschemadef) |
536
+ | **ChannelMessage** | WebSocket message structure | [`Models Guide`](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/MODELS_README.md#channelmessage) |
537
+ | **WSUser** | WebSocket user info | [`Models Guide`](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/MODELS_README.md#wsuser) |
538
538
 
539
539
  ### Enums
540
540
 
@@ -557,7 +557,7 @@ All models follow the `<Name>Interface` + `<Name>Model` pattern with static `ada
557
557
  ### Complete API Documentation
558
558
 
559
559
  For comprehensive API reference with all methods, parameters, and examples:
560
- 📋 **[Complete API Reference](./src/docs/COMPLETE_API_REFERENCE.md)**
560
+ 📋 **[Complete API Reference](https://github.com/micheleboni/npm-angular/tree/main/projects/http-request-manager/src/docs/COMPLETE_API_REFERENCE.md)**
561
561
 
562
562
  ## 🤝 Contributing
563
563