http-request-manager 18.11.16 → 18.11.17

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "http-request-manager",
-  "version": "18.11.16",
+  "version": "18.11.17",
   "homepage": "https://wavecoders.ca",
   "author": "Mike Bonifacio <wavecoders@gmail.com> (http://wavecoders@gmail.com/)",
   "description": "This is an Angular Module containing Components/Services using Material",
@@ -11,20 +11,19 @@
     }
   ],
   "peerDependencies": {
-    "@angular/cdk": ">=18.0.0 <22.0.0",
-    "@angular/common": ">=18.0.0 <22.0.0",
-    "@angular/compiler": ">=18.0.0 <22.0.0",
-    "@angular/core": ">=18.0.0 <22.0.0",
-    "@angular/material": ">=18.0.0 <22.0.0",
-    "@ngrx/component-store": ">=18.0.0 <22.0.0",
-    "@ngx-translate/core": ">=17.0.0 <20.0.0",
-    "@ngx-translate/http-loader": ">=16.0.0 <20.0.0",
+    "@angular/cdk": "~18.2.14",
+    "@angular/common": "^18.2.13",
+    "@angular/compiler": "^18.2.13",
+    "@angular/core": "^18.2.13",
+    "@ngrx/component-store": "^18.0.0",
+    "@ngx-translate/core": "^17.0.0",
+    "@ngx-translate/http-loader": "^16.0.1",
     "@types/crypto-js": "^4.2.2",
     "crypto-js": "^4.2.0",
     "dexie": "^4.0.11",
-    "file-downloader-action": ">=18.0.0 <22.0.0",
-    "rxjs": ">=7.8.0 <9.0.0",
-    "toast-message-display": ">=18.0.0 <22.0.0"
+    "file-downloader-action": "^18.0.0",
+    "rxjs": "~7.8.0",
+    "toast-message-display": "^18.0.6"
   },
   "dependencies": {
     "tslib": "^2.3.0"

package/types/http-request-manager.d.ts

@@ -7,7 +7,7 @@ import { HttpClient, HttpHeaders, HttpInterceptor, HttpRequest, HttpHandler, Htt
 import * as i17 from 'toast-message-display';
 import { ToastMessageDisplayService } from 'toast-message-display';
 import Dexie, { Table } from 'dexie';
-import * as i34 from '@ngx-translate/core';
+import * as i35 from '@ngx-translate/core';
 import { TranslateService } from '@ngx-translate/core';
 import * as _angular_forms from '@angular/forms';
 import { FormArray, FormBuilder, FormControl } from '@angular/forms';
@@ -23,17 +23,18 @@ import * as i25 from '@angular/material/table';
 import * as i26 from '@angular/material/button-toggle';
 import * as i27 from '@angular/material/autocomplete';
 import * as i28 from '@angular/material/progress-bar';
-import * as i29 from '@angular/material/slide-toggle';
-import * as i30 from '@angular/material/divider';
-import * as i31 from '@angular/material/form-field';
-import * as i32 from '@angular/material/input';
-import * as i33 from '@angular/material/toolbar';
-import * as i35 from '@angular/material/sidenav';
-import * as i36 from '@angular/material/datepicker';
-import * as i37 from '@angular/material/core';
-import { ThemePalette } from '@angular/material/core';
 import * as i6 from '@angular/material/progress-spinner';
 import { ProgressSpinnerMode } from '@angular/material/progress-spinner';
+import * as i30 from '@angular/material/slide-toggle';
+import * as i31 from '@angular/material/divider';
+import * as i32 from '@angular/material/form-field';
+import * as i33 from '@angular/material/input';
+import * as i34 from '@angular/material/toolbar';
+import * as i36 from '@angular/material/sidenav';
+import * as i37 from '@angular/material/datepicker';
+import * as i38 from '@angular/material/core';
+import { ThemePalette } from '@angular/material/core';
+import * as i39 from '@angular/material/card';
 
 declare enum StorageType {
     GLOBAL = 0,
@@ -1041,6 +1042,77 @@ declare class RetryOptions implements RetryOptionsInterface {
     static adapt(item?: any): RetryOptions;
 }
 
+interface BatchOptionsInterface {
+    mode?: 'sequential' | 'parallel';
+    stopOnError?: boolean;
+    concurrency?: number;
+    ignoreErrors?: boolean;
+    logErrors?: boolean;
+}
+declare class BatchOptions implements BatchOptionsInterface {
+    mode: 'sequential' | 'parallel';
+    stopOnError: boolean;
+    concurrency: number;
+    ignoreErrors: boolean;
+    logErrors: boolean;
+    constructor(mode?: 'sequential' | 'parallel', stopOnError?: boolean, concurrency?: number, ignoreErrors?: boolean, logErrors?: boolean);
+    static adapt(item?: any): BatchOptions;
+}
+
+interface BatchResultInterface<T = any> {
+    request: any;
+    success: boolean;
+    data?: T;
+    error?: any;
+    index: number;
+    timestamp: number;
+}
+declare class BatchResult<T = any> implements BatchResultInterface<T> {
+    request: any;
+    success: boolean;
+    data?: T | undefined;
+    error?: any;
+    index: number;
+    timestamp: number;
+    constructor(request: any, success: boolean, data?: T | undefined, error?: any, index?: number, timestamp?: number);
+    static adapt<T>(item?: any): BatchResult<T>;
+}
+
+type BatchRequestState<T> = BatchPendingState | BatchSuccessState<T> | BatchErrorState;
+interface BatchPendingState {
+    index: number;
+    request: any;
+    isPending: true;
+    data?: undefined;
+    error?: undefined;
+}
+interface BatchSuccessState<T> {
+    index: number;
+    request: any;
+    isPending: false;
+    data: T;
+    error?: undefined;
+}
+interface BatchErrorState {
+    index: number;
+    request: any;
+    isPending: false;
+    data?: undefined;
+    error: any;
+}
+declare function isPendingState<T>(state: BatchRequestState<T>): state is BatchPendingState;
+declare function isSuccessState<T>(state: BatchRequestState<T>): state is BatchSuccessState<T>;
+declare function isErrorState<T>(state: BatchRequestState<T>): state is BatchErrorState;
+
+interface BatchProgress {
+    total: number;
+    pending: number;
+    completed: number;
+    failed: number;
+    percent: number;
+}
+declare function calculateBatchProgress<T>(states: BatchRequestState<T>[]): BatchProgress;
+
 declare enum DataType {
     ANY = 0,
     ARRAY = 1,
@@ -1401,6 +1473,44 @@ declare class HTTPManagerService<T> extends RequestService {
     private handleErrorWithSnackBar;
     private stopPolling;
     private defineReqOptions;
+    /**
+     * Execute multiple HTTP requests with configurable execution strategy
+     * @param requests Array of ApiRequest configurations
+     * @param options Optional batch configuration (all properties optional)
+     * @returns Observable emitting array of data in the order of requests provided
+     */
+    getBatchRequests<U = T>(requests: ApiRequest[], options?: BatchOptions): Observable<U[]>;
+    /**
+     * Execute requests sequentially (one at a time, in order)
+     * @param requests Array of ApiRequest configurations
+     * @param options Optional batch configuration
+     * @returns Observable emitting array of data when all requests complete
+     */
+    getSequentialRequest<U = T>(requests: ApiRequest[], options?: BatchOptions): Observable<U[]>;
+    /**
+     * Execute requests in parallel with concurrency control
+     * @param requests Array of ApiRequest configurations
+     * @param options Optional batch configuration with concurrency limit
+     * @returns Observable emitting array of data when all requests complete
+     */
+    getParallelRequest<U = T>(requests: ApiRequest[], options?: BatchOptions): Observable<U[]>;
+    /**
+     * Execute multiple HTTP requests and emit individual state changes in real-time
+     * @param requests Array of ApiRequest configurations
+     * @param options Optional batch configuration (all properties optional)
+     * @returns Observable stream of individual request states
+     */
+    getBatchRequestsStream<U = T>(requests: ApiRequest[], options?: BatchOptions): Observable<BatchRequestState<U>>;
+    /**
+     * Execute requests sequentially and emit state changes
+     */
+    private getSequentialStream;
+    /**
+     * Execute requests in parallel and emit state changes
+     */
+    private getParallelStream;
+    private handleSequentialError;
+    private handleParallelError;
     static ɵfac: i0.ɵɵFactoryDeclaration<HTTPManagerService<any>, [{ optional: true; }]>;
     static ɵprov: i0.ɵɵInjectableDeclaration<HTTPManagerService<any>>;
 }
@@ -1552,6 +1662,44 @@ declare class HTTPManagerSignalsService<T> extends RequestSignalsService {
     private handleErrorWithSnackBar;
     private stopPolling;
     private defineReqOptions;
+    /**
+     * Execute multiple HTTP requests with configurable execution strategy
+     * @param requests Array of ApiRequest configurations
+     * @param options Optional batch configuration (all properties optional)
+     * @returns Observable emitting array of data in the order of requests provided
+     */
+    getBatchRequests<U = T>(requests: ApiRequest[], options?: BatchOptions): Observable<U[]>;
+    /**
+     * Execute requests sequentially (one at a time, in order)
+     * @param requests Array of ApiRequest configurations
+     * @param options Optional batch configuration
+     * @returns Observable emitting array of data when all requests complete
+     */
+    getSequentialRequest<U = T>(requests: ApiRequest[], options?: BatchOptions): Observable<U[]>;
+    /**
+     * Execute requests in parallel with concurrency control
+     * @param requests Array of ApiRequest configurations
+     * @param options Optional batch configuration with concurrency limit
+     * @returns Observable emitting array of data when all requests complete
+     */
+    getParallelRequest<U = T>(requests: ApiRequest[], options?: BatchOptions): Observable<U[]>;
+    /**
+     * Execute multiple HTTP requests and emit individual state changes in real-time
+     * @param requests Array of ApiRequest configurations
+     * @param options Optional batch configuration (all properties optional)
+     * @returns Observable stream of individual request states
+     */
+    getBatchRequestsStream<U = T>(requests: ApiRequest[], options?: BatchOptions): Observable<BatchRequestState<U>>;
+    /**
+     * Execute requests sequentially and emit state changes
+     */
+    private getSequentialStream;
+    /**
+     * Execute requests in parallel and emit state changes
+     */
+    private getParallelStream;
+    private handleSequentialError;
+    private handleParallelError;
     static ɵfac: i0.ɵɵFactoryDeclaration<HTTPManagerSignalsService<any>, [{ optional: true; }]>;
     static ɵprov: i0.ɵɵInjectableDeclaration<HTTPManagerSignalsService<any>>;
 }
@@ -2300,6 +2448,26 @@ declare class RequestManagerDemoComponent implements OnInit {
     DELETE$?: Observable<any>;
     STREAM$?: Observable<any>;
     STREAM_AI$?: Observable<any>;
+    parallelBatch$?: Observable<any[]>;
+    sequentialBatch$?: Observable<any[]>;
+    parallelExecutionTime?: number;
+    sequentialExecutionTime?: number;
+    parallelResults?: any[];
+    sequentialResults?: any[];
+    isParallelLoading: boolean;
+    isSequentialLoading: boolean;
+    parallelError?: string;
+    sequentialError?: string;
+    parallelBatchStates: (BatchRequestState<any> | undefined)[];
+    sequentialBatchStates: (BatchRequestState<any> | undefined)[];
+    streamBatchStates: (BatchRequestState<any> | undefined)[];
+    streamProgress?: BatchProgress;
+    streamExecutionTime?: number;
+    isStreamLoading: boolean;
+    streamError?: string;
+    get filteredParallelStates(): BatchRequestState<any>[];
+    get filteredSequentialStates(): BatchRequestState<any>[];
+    get filteredStreamStates(): BatchRequestState<any>[];
     requestParams: {
         GET: ApiRequest;
         POST: ApiRequest;
@@ -2382,6 +2550,50 @@ declare class RequestManagerDemoComponent implements OnInit {
     onDownloadFailed(err: string): void;
     errorHandling(err: any, type: string): void;
     onSelectAIType(type: number): void;
+    /**
+     * Execute parallel batch request - fetch 5 users from JSONPlaceholder with individual states
+     */
+    onExecuteParallelBatch(): void;
+    /**
+     * Execute sequential batch request - fetch 5 todos from JSONPlaceholder with individual states
+     */
+    onExecuteSequentialBatch(): void;
+    /**
+     * Execute stream batch request - fetch 5 posts with real-time state updates
+     */
+    onExecuteStreamBatch(): void;
+    /**
+     * Type guard for pending state
+     */
+    isPendingState(state: BatchRequestState<any>): boolean;
+    /**
+     * Type guard for success state
+     */
+    isSuccessState(state: BatchRequestState<any>): boolean;
+    /**
+     * Type guard for error state
+     */
+    isErrorState(state: BatchRequestState<any>): boolean;
+    /**
+     * Helper to create batch requests from IDs
+     */
+    private createBatchRequests;
+    /**
+     * Check if result is successful (not undefined)
+     */
+    isSuccess(result: any): boolean;
+    /**
+     * Format execution time for display
+     */
+    formatTime(ms: number): string;
+    /**
+     * Get success count from results array
+     */
+    getSuccessCount(results?: any[]): number;
+    /**
+     * Get failure count from results array
+     */
+    getFailureCount(results?: any[]): number;
     static ɵfac: i0.ɵɵFactoryDeclaration<RequestManagerDemoComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<RequestManagerDemoComponent, "app-request-manager-demo", never, { "server": { "alias": "server"; "required": false; }; "adapter": { "alias": "adapter"; "required": false; }; "mapper": { "alias": "mapper"; "required": false; }; }, {}, never, never, false, never>;
 }
@@ -3311,7 +3523,7 @@ declare class FileDownloaderModule {
 declare class HttpRequestManagerModule {
     static forRoot(config?: ConfigOptions): ModuleWithProviders<HttpRequestManagerModule>;
     static ɵfac: i0.ɵɵFactoryDeclaration<HttpRequestManagerModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<HttpRequestManagerModule, [typeof RequestManagerBasicDemoComponent, typeof HttpRequestServicesDemoComponent, typeof RequestManagerStateDemoComponent, typeof RequestManagerDemoComponent, typeof RequestSignalsManagerDemoComponent, typeof LocalStorageDemoComponent, typeof LocalStorageSignalsDemoComponent, typeof RequestManagerWsDemoComponent, typeof StoreStateManagerDemoComponent, typeof DatabaseDataDemoComponent, typeof WsDataControlComponent, typeof WsMessagingComponent, typeof WsNotificationsComponent, typeof WsAiMessagingComponent, typeof WsChatsComponent], [typeof i4.CommonModule, typeof i17.ToastMessageDisplayModule, typeof _angular_forms.FormsModule, typeof _angular_forms.ReactiveFormsModule, typeof i7.MatButtonModule, typeof i20.MatTabsModule, typeof i21.MatSelectModule, typeof i22.MatChipsModule, typeof i23.MatMenuModule, typeof i5.MatIconModule, typeof i25.MatTableModule, typeof i26.MatButtonToggleModule, typeof i27.MatAutocompleteModule, typeof i28.MatProgressBarModule, typeof i29.MatSlideToggleModule, typeof i30.MatDividerModule, typeof i31.MatFormFieldModule, typeof i32.MatInputModule, typeof i33.MatToolbarModule, typeof i29.MatSlideToggleModule, typeof i34.TranslateModule, typeof i35.MatSidenavModule, typeof i36.MatDatepickerModule, typeof i37.MatNativeDateModule, typeof FileDownloaderModule], [typeof HttpRequestServicesDemoComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<HttpRequestManagerModule, [typeof RequestManagerBasicDemoComponent, typeof HttpRequestServicesDemoComponent, typeof RequestManagerStateDemoComponent, typeof RequestManagerDemoComponent, typeof RequestSignalsManagerDemoComponent, typeof LocalStorageDemoComponent, typeof LocalStorageSignalsDemoComponent, typeof RequestManagerWsDemoComponent, typeof StoreStateManagerDemoComponent, typeof DatabaseDataDemoComponent, typeof WsDataControlComponent, typeof WsMessagingComponent, typeof WsNotificationsComponent, typeof WsAiMessagingComponent, typeof WsChatsComponent], [typeof i4.CommonModule, typeof i17.ToastMessageDisplayModule, typeof _angular_forms.FormsModule, typeof _angular_forms.ReactiveFormsModule, typeof i7.MatButtonModule, typeof i20.MatTabsModule, typeof i21.MatSelectModule, typeof i22.MatChipsModule, typeof i23.MatMenuModule, typeof i5.MatIconModule, typeof i25.MatTableModule, typeof i26.MatButtonToggleModule, typeof i27.MatAutocompleteModule, typeof i28.MatProgressBarModule, typeof i6.MatProgressSpinnerModule, typeof i30.MatSlideToggleModule, typeof i31.MatDividerModule, typeof i32.MatFormFieldModule, typeof i33.MatInputModule, typeof i34.MatToolbarModule, typeof i30.MatSlideToggleModule, typeof i35.TranslateModule, typeof i36.MatSidenavModule, typeof i37.MatDatepickerModule, typeof i38.MatNativeDateModule, typeof i39.MatCardModule, typeof FileDownloaderModule], [typeof HttpRequestServicesDemoComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<HttpRequestManagerModule>;
 }
 
@@ -3330,5 +3542,5 @@ declare class StoreStateSignalsDemoComponent implements OnInit {
     static ɵcmp: i0.ɵɵComponentDeclaration<StoreStateSignalsDemoComponent, "app-store-state-signals-demo", never, {}, {}, never, never, false, never>;
 }
 
-export { ApiRequest, AppService, AsymmetricalEncryptionService, CONFIG_SETTINGS_TOKEN, ChannelType, ConfigHTTPOptions, ConfigOptions, DataType, DatabaseDataDemoComponent, DatabaseManagerService, DatabaseStorage, DbService, ErrorDisplaySettings, GlobalStoreOptions, HTTPManagerService, HTTPManagerSignalsService, HTTPManagerStateService, HeadersService, HttpRequestManagerModule, HttpRequestServicesDemoComponent, LocalStorageDemoComponent, LocalStorageManagerService, LocalStorageOptions, LocalStorageSignalsDemoComponent, LocalStorageSignalsManagerService, LoggerService, NotificationMessage, PathQueryService, PublicMessage, Random, RandomHSLColor, RandomHexColor, RandomNumber, RandomNumbers, RandomNumbersUnique, RandomPaletteColor, RandomSignature, RandomStr, RandomVisibleColor, RequestErrorInterceptor, RequestHeadersInterceptor, RequestManagerDemoComponent, RequestManagerStateDemoComponent, RequestOptions, RequestService, RequestSignalsService, RetryOptions, SettingOptions, StateMessage, StateStorageOptions, StorageData, StorageOption, StorageType, StoreStateManagerService, StoreStateManagerSignalsService, StoreStateSignalsDemoComponent, StreamType, SymmetricalEncryptionService, TableSchemaDef, UUID, UUID_STR, UserData, UtilsService, WSOptions, WebSocketMessageService, WithCredentialsInterceptor, countdown, createChannelName, delayedRetry, requestPolling, requestStreaming, streamAI, streamAuto, streamEvents, streamJSON, streamNDJSON };
-export type { APIStateManagerData, ApiRequestInterface, ConfigHTTPOptionsInterface, ConfigOptionsInterface, DatabaseStorageInterface, ErrorDisplaySettingsInterface, GlobalStoreOptionsInterface, LocalStorageOptionsInterface, NotificationMessageInterface, ParsingResult, PublicMessageInterface, RequestOptionsInterface, RetryOptionsInterface, SettingOptionsInterface, State, StateMessageInterface, StateStorageOptionsInterface, StateStoreManagerData$1 as StateStoreManagerData, StorageDataInterface, StorageOptionInterface, StreamConfig, StreamEvent, TableRecord, TableSchemaDefInterface, UserDataInterface, WSOptionsInterface };
+export { ApiRequest, AppService, AsymmetricalEncryptionService, BatchOptions, BatchResult, CONFIG_SETTINGS_TOKEN, ChannelType, ConfigHTTPOptions, ConfigOptions, DataType, DatabaseDataDemoComponent, DatabaseManagerService, DatabaseStorage, DbService, ErrorDisplaySettings, GlobalStoreOptions, HTTPManagerService, HTTPManagerSignalsService, HTTPManagerStateService, HeadersService, HttpRequestManagerModule, HttpRequestServicesDemoComponent, LocalStorageDemoComponent, LocalStorageManagerService, LocalStorageOptions, LocalStorageSignalsDemoComponent, LocalStorageSignalsManagerService, LoggerService, NotificationMessage, PathQueryService, PublicMessage, Random, RandomHSLColor, RandomHexColor, RandomNumber, RandomNumbers, RandomNumbersUnique, RandomPaletteColor, RandomSignature, RandomStr, RandomVisibleColor, RequestErrorInterceptor, RequestHeadersInterceptor, RequestManagerDemoComponent, RequestManagerStateDemoComponent, RequestOptions, RequestService, RequestSignalsService, RetryOptions, SettingOptions, StateMessage, StateStorageOptions, StorageData, StorageOption, StorageType, StoreStateManagerService, StoreStateManagerSignalsService, StoreStateSignalsDemoComponent, StreamType, SymmetricalEncryptionService, TableSchemaDef, UUID, UUID_STR, UserData, UtilsService, WSOptions, WebSocketMessageService, WithCredentialsInterceptor, calculateBatchProgress, countdown, createChannelName, delayedRetry, isErrorState, isPendingState, isSuccessState, requestPolling, requestStreaming, streamAI, streamAuto, streamEvents, streamJSON, streamNDJSON };
+export type { APIStateManagerData, ApiRequestInterface, BatchErrorState, BatchOptionsInterface, BatchPendingState, BatchProgress, BatchRequestState, BatchResultInterface, BatchSuccessState, ConfigHTTPOptionsInterface, ConfigOptionsInterface, DatabaseStorageInterface, ErrorDisplaySettingsInterface, GlobalStoreOptionsInterface, LocalStorageOptionsInterface, NotificationMessageInterface, ParsingResult, PublicMessageInterface, RequestOptionsInterface, RetryOptionsInterface, SettingOptionsInterface, State, StateMessageInterface, StateStorageOptionsInterface, StateStoreManagerData$1 as StateStoreManagerData, StorageDataInterface, StorageOptionInterface, StreamConfig, StreamEvent, TableRecord, TableSchemaDefInterface, UserDataInterface, WSOptionsInterface };