http-request-manager 18.12.3 → 18.12.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "http-request-manager",
-  "version": "18.12.3",
+  "version": "18.12.4",
   "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",

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

@@ -1,5 +1,5 @@
 import * as rxjs from 'rxjs';
-import { Observable, Subscription, BehaviorSubject, OperatorFunction } from 'rxjs';
+import { Observable, OperatorFunction, Subscription, BehaviorSubject } from 'rxjs';
 import * as i0 from '@angular/core';
 import { InjectionToken, OnDestroy, Injector, OnInit, EventEmitter, ModuleWithProviders } from '@angular/core';
 import { ComponentStore } from '@ngrx/component-store';
@@ -11,6 +11,7 @@ import * as i36 from '@ngx-translate/core';
 import { TranslateService } from '@ngx-translate/core';
 import * as _angular_forms from '@angular/forms';
 import { FormArray, FormBuilder, FormControl } from '@angular/forms';
+import * as http_request_manager from 'http-request-manager';
 import { DataSource } from '@angular/cdk/collections';
 import * as i4 from '@angular/common';
 import * as i7 from '@angular/material/button';
@@ -153,6 +154,88 @@ declare class AppService {
     static ɵprov: i0.ɵɵInjectableDeclaration<AppService>;
 }
 
+declare function countdown(duration: number): Observable<number>;
+
+declare function delayedRetry<T>(delayMs: number, maxRetry?: number): (src: Observable<T>) => Observable<T>;
+
+declare function requestPolling<T>(pollInterval: number, stopCondition$: Observable<any>, isPending$: any): (source: Observable<T>) => Observable<T>;
+
+/**
+ * Enum representing valid streaming format types
+ *
+ * This enum defines all supported streaming formats for HTTP requests.
+ * Each enum value corresponds to a specific data format and parsing strategy.
+ */
+declare enum StreamType {
+    JSON = "json",
+    NDJSON = "ndjson",
+    AI_STREAMING = "ai_streaming",
+    EVENT_STREAM = "event_stream",
+    AUTO = "auto"
+}
+
+interface StreamConfig {
+    streamType: StreamType;
+    totalHeader?: string;
+}
+/**
+ * Progress information for streaming responses
+ */
+interface StreamProgress {
+    received: number;
+    total?: number;
+    percent: number;
+    stage: 'connecting' | 'streaming' | 'complete' | 'error';
+    bytesLoaded?: number;
+    bytesTotal?: number;
+}
+/**
+ * Combined output from streaming operators
+ */
+interface StreamOutput<T> {
+    data: T[];
+    progress: StreamProgress;
+    endpoint?: string;
+}
+interface StreamEvent<T = any> {
+    type: 'progress' | 'complete' | 'data';
+    data: T;
+    metadata?: {
+        timestamp: Date;
+        streamType: StreamType;
+        contentLength?: number;
+    };
+}
+interface ParsingResult<T = any> {
+    success: boolean;
+    data?: T[];
+    error?: string;
+}
+/**
+ * COMPREHENSIVE REQUEST STREAMING OPERATOR - FULLY ABSTRACTED
+ * Refactored for better type safety and memory management
+ *
+ * Single function that handles ALL streaming formats without hardcoded assumptions:
+ * - JSON format (Individual JSON objects)
+ * - NDJSON format (Newline delimited JSON)
+ * - AI streaming format (Real-time AI responses)
+ * - Server-Sent Events format
+ * - Auto-detection mode
+ *
+ * Usage:
+ *   this.http.get(url, options).pipe(requestStreaming()).subscribe(data => {...})
+ *   this.http.get(url, options).pipe(requestStreaming({ streamType: StreamType.NDJSON })).subscribe(data => {...})
+ */
+declare function requestStreaming<T = any>(config?: StreamConfig): OperatorFunction<any, StreamOutput<T>>;
+/**
+ * Convenience functions for common use cases
+ */
+declare function streamJSON<T = any>(): OperatorFunction<any, StreamOutput<T>>;
+declare function streamNDJSON<T = any>(): OperatorFunction<any, StreamOutput<T>>;
+declare function streamAI<T = any>(): OperatorFunction<any, StreamOutput<T>>;
+declare function streamEvents<T = any>(): OperatorFunction<any, StreamOutput<T>>;
+declare function streamAuto<T = any>(): OperatorFunction<any, StreamOutput<T>>;
+
 interface WSOptionsInterface {
     id: string;
     wsServer: string;
@@ -176,20 +259,6 @@ declare class WSOptions implements WSOptionsInterface {
     static adapt(item?: any): WSOptions;
 }
 
-/**
- * Enum representing valid streaming format types
- *
- * This enum defines all supported streaming formats for HTTP requests.
- * Each enum value corresponds to a specific data format and parsing strategy.
- */
-declare enum StreamType {
-    JSON = "json",
-    NDJSON = "ndjson",
-    AI_STREAMING = "ai_streaming",
-    EVENT_STREAM = "event_stream",
-    AUTO = "auto"
-}
-
 interface ApiRequestInterface {
     server: string;
     path?: any[];
@@ -200,6 +269,7 @@ interface ApiRequestInterface {
     retry?: RetryOptions;
     stream?: boolean;
     streamType?: StreamType;
+    totalHeader?: string;
     displayError?: boolean;
     displaySuccess?: boolean;
     successMessage?: string;
@@ -225,6 +295,7 @@ declare class ApiRequest implements ApiRequestInterface {
     retry?: RetryOptions | undefined;
     stream?: boolean | undefined;
     streamType?: StreamType | undefined;
+    totalHeader?: string | undefined;
     displayError?: boolean | undefined;
     displaySuccess?: boolean | undefined;
     successMessage?: string | undefined;
@@ -239,7 +310,7 @@ declare class ApiRequest implements ApiRequestInterface {
     allowedTypes?: string[] | undefined;
     maxFileSize?: number | undefined;
     maxTotalSize?: number | undefined;
-    constructor(server?: string, path?: any[] | undefined, headers?: any, adapter?: any, mapper?: any, polling?: number | undefined, retry?: RetryOptions | undefined, stream?: boolean | undefined, streamType?: StreamType | undefined, displayError?: boolean | undefined, displaySuccess?: boolean | undefined, successMessage?: string | undefined, errorMessage?: string | undefined, saveAs?: string | undefined, fileContentHeader?: string | undefined, ws?: WSOptions | undefined, env?: string | undefined, uploadFiles?: (File | File[]) | undefined, uploadFieldName?: string | undefined, uploadHttpMethod?: ("POST" | "PUT") | undefined, allowedTypes?: string[] | undefined, maxFileSize?: number | undefined, maxTotalSize?: number | undefined);
+    constructor(server?: string, path?: any[] | undefined, headers?: any, adapter?: any, mapper?: any, polling?: number | undefined, retry?: RetryOptions | undefined, stream?: boolean | undefined, streamType?: StreamType | undefined, totalHeader?: string | undefined, displayError?: boolean | undefined, displaySuccess?: boolean | undefined, successMessage?: string | undefined, errorMessage?: string | undefined, saveAs?: string | undefined, fileContentHeader?: string | undefined, ws?: WSOptions | undefined, env?: string | undefined, uploadFiles?: (File | File[]) | undefined, uploadFieldName?: string | undefined, uploadHttpMethod?: ("POST" | "PUT") | undefined, allowedTypes?: string[] | undefined, maxFileSize?: number | undefined, maxTotalSize?: number | undefined);
     static adapt(item?: any): ApiRequest;
 }
 
@@ -551,6 +622,8 @@ declare class HTTPManagerStateService<T extends {
     logger: LoggerService;
     error$: Observable<boolean>;
     isPending$: Observable<boolean>;
+    progress$: Observable<number>;
+    streamProgress$: Observable<StreamProgress>;
     private operationSuccess;
     operationSuccess$: Observable<OperationResultModel | null>;
     private page;
@@ -568,6 +641,7 @@ declare class HTTPManagerStateService<T extends {
     private databaseOptions?;
     private wsRetryAttempts;
     wsRetryAttempts$: Observable<number>;
+    private activeStream$;
     private wsNextRetry;
     wsNextRetry$: Observable<number>;
     private messages;
@@ -1031,8 +1105,12 @@ declare class RequestService extends WebsocketService {
     private headersService;
     isPending: BehaviorSubject<boolean>;
     isPending$: Observable<boolean>;
+    isStreamingPending: BehaviorSubject<boolean>;
+    isStreamingPending$: Observable<boolean>;
     progress: BehaviorSubject<number>;
     progress$: Observable<number>;
+    streamProgress: BehaviorSubject<StreamProgress>;
+    streamProgress$: Observable<StreamProgress>;
     getRecordRequest<T>(options: ApiRequest): Observable<T>;
     getRecordRequest<T>(options: ApiRequest): Observable<T>;
     getRecordRequest<T>(options: ApiRequest & {
@@ -1057,6 +1135,7 @@ declare class RequestService extends WebsocketService {
     uploadFileRequest(options: ApiRequest): Observable<any>;
     private validateUploadFiles;
     private buildFormData;
+    private streamProgressReset;
     private handleFinalize;
     private downloadFile;
     private createFileType;
@@ -1238,21 +1317,6 @@ declare class UploadValidationErrorModel implements UploadValidationErrorInterfa
     static adapt(item?: any): UploadValidationErrorModel;
 }
 
-interface UserDataInterface {
-    ldap: string;
-    name: string;
-    email: string;
-    color: string;
-}
-declare class UserData implements UserDataInterface {
-    ldap: string;
-    name: string;
-    email: string;
-    color: string;
-    constructor(ldap?: string, name?: string, email?: string, color?: string);
-    static adapt(item?: any): UserData;
-}
-
 declare class ObjectMergerService {
     private configOptions?;
     utils: UtilsService;
@@ -1438,6 +1502,7 @@ declare class HTTPManagerService<T> extends RequestService {
     data$: Observable<any>;
     private polling$;
     config: ApiRequest;
+    streamProgress$: Observable<StreamProgress>;
     constructor(configOptions?: ConfigOptions | undefined);
     /**
      * Connect to WebSocket server
@@ -1588,9 +1653,14 @@ declare class RequestSignalsService extends WebsocketService {
     private http;
     private pathQueryService;
     private headersService;
-    isPending: i0.WritableSignal<boolean>;
+    private _activeRequestCount;
+    isPending: i0.Signal<boolean>;
     progress: i0.WritableSignal<number>;
-    isIdle: i0.Signal<boolean>;
+    private activeRequests;
+    private activeMethod;
+    private activeStreamMethod;
+    private requestQueue;
+    private destroy$;
     getRecordRequest<T>(options: ApiRequest): Observable<T>;
     getRecordRequest<T>(options: ApiRequest & {
         stream: true;
@@ -1601,6 +1671,20 @@ declare class RequestSignalsService extends WebsocketService {
     }, data: any): Observable<T[]>;
     updateRecordRequest<T>(options: ApiRequest, data: any): Observable<T>;
     deleteRecordRequest<T>(options: ApiRequest): Observable<T>;
+    /**
+     * Queue a request to ensure FIFO processing:
+     * - All requests are queued and processed sequentially
+     * - Streams are protected - non-stream requests wait for active streams
+     */
+    private queueRequest;
+    /**
+     * Start processing a request
+     */
+    private startRequest;
+    /**
+     * Clean up completed request and process next in queue
+     */
+    private cleanupAndProcessNext;
     private buildUrlPath;
     private buildHeaders;
     private buildCombinedHeaders;
@@ -1610,7 +1694,6 @@ declare class RequestSignalsService extends WebsocketService {
     uploadFileRequest(options: ApiRequest): Observable<any>;
     private validateUploadFiles;
     private buildFormData;
-    private handleFinalize;
     private downloadFile;
     private createFileType;
     private combineHeaders;
@@ -1778,54 +1861,6 @@ declare class HTTPManagerSignalsService<T> extends RequestSignalsService {
     static ɵprov: i0.ɵɵInjectableDeclaration<HTTPManagerSignalsService<any>>;
 }
 
-declare function countdown(duration: number): Observable<number>;
-
-declare function delayedRetry<T>(delayMs: number, maxRetry?: number): (src: Observable<T>) => Observable<T>;
-
-declare function requestPolling<T>(pollInterval: number, stopCondition$: Observable<any>, isPending$: any): (source: Observable<T>) => Observable<T>;
-
-interface StreamConfig {
-    streamType: StreamType;
-}
-interface StreamEvent<T = any> {
-    type: 'progress' | 'complete' | 'data';
-    data: T;
-    metadata?: {
-        timestamp: Date;
-        streamType: StreamType;
-        contentLength?: number;
-    };
-}
-interface ParsingResult<T = any> {
-    success: boolean;
-    data?: T[];
-    error?: string;
-}
-/**
- * COMPREHENSIVE REQUEST STREAMING OPERATOR - FULLY ABSTRACTED
- * Refactored for better type safety and memory management
- *
- * Single function that handles ALL streaming formats without hardcoded assumptions:
- * - JSON format (Individual JSON objects)
- * - NDJSON format (Newline delimited JSON)
- * - AI streaming format (Real-time AI responses)
- * - Server-Sent Events format
- * - Auto-detection mode
- *
- * Usage:
- *   this.http.get(url, options).pipe(requestStreaming()).subscribe(data => {...})
- *   this.http.get(url, options).pipe(requestStreaming({ streamType: StreamType.NDJSON })).subscribe(data => {...})
- */
-declare function requestStreaming<T = any>(config?: StreamConfig): OperatorFunction<any, T[]>;
-/**
- * Convenience functions for common use cases
- */
-declare function streamJSON<T = any>(): OperatorFunction<any, T[]>;
-declare function streamNDJSON<T = any>(): OperatorFunction<any, T[]>;
-declare function streamAI<T = any>(): OperatorFunction<any, T[]>;
-declare function streamEvents<T = any>(): OperatorFunction<any, T[]>;
-declare function streamAuto<T = any>(): OperatorFunction<any, T[]>;
-
 interface State {
     localStores: StorageData[];
     sessionStores: StorageData[];
@@ -2305,6 +2340,21 @@ declare class RequestManagerBasicDemoComponent implements OnInit {
     static ɵcmp: i0.ɵɵComponentDeclaration<RequestManagerBasicDemoComponent, "app-request-manager-basic-demo", never, {}, {}, never, never, false, never>;
 }
 
+interface UserDataInterface {
+    ldap: string;
+    name: string;
+    email: string;
+    color: string;
+}
+declare class UserData implements UserDataInterface {
+    ldap: string;
+    name: string;
+    email: string;
+    color: string;
+    constructor(ldap?: string, name?: string, email?: string, color?: string);
+    static adapt(item?: any): UserData;
+}
+
 declare class HttpRequestServicesDemoComponent implements OnInit {
     private configOptions?;
     wsServer: string;
@@ -2410,6 +2460,7 @@ declare class RequestManagerStateDemoComponent implements OnInit {
     adapter?: Function;
     mapper?: Function;
     stateManagerDemoService: StateManagerDemoService;
+    progress$: Observable<http_request_manager.StreamProgress>;
     displayedColumns: string[];
     getColumnsFromData(data: any[]): string[];
     updateDisplayedColumns(data: any[]): void;
@@ -2424,6 +2475,7 @@ declare class RequestManagerStateDemoComponent implements OnInit {
     streamType: string;
     httpManagerService: HTTPManagerService<any>;
     isPending$: Observable<boolean>;
+    isStreamingPending$: Observable<boolean>;
     error$: Observable<boolean>;
     countdown$: Observable<number>;
     GET_error$: BehaviorSubject<string>;
@@ -2543,7 +2595,9 @@ declare class RequestManagerDemoComponent implements OnInit {
     private toastMessage;
     questionControl: _angular_forms.FormControl<string | null>;
     httpManagerService: HTTPManagerService<any>;
+    progress$: Observable<StreamProgress>;
     isPending$: Observable<boolean>;
+    isStreamingPending$: Observable<boolean>;
     countdown$: Observable<number>;
     GET_error$: BehaviorSubject<string>;
     POST_error$: BehaviorSubject<string>;
@@ -2751,7 +2805,7 @@ declare class RequestSignalsManagerDemoComponent implements OnInit {
     private fb;
     private toastMessage;
     httpManagerSignalsService: HTTPManagerSignalsService<any>;
-    isPending: i0.WritableSignal<boolean>;
+    isPending: i0.Signal<boolean>;
     countdown: i0.WritableSignal<number>;
     GET_result: any;
     POST_result: any;
@@ -3688,4 +3742,4 @@ declare class StoreStateSignalsDemoComponent implements OnInit {
 }
 
 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, InvalidFileInfoModel, LocalStorageDemoComponent, LocalStorageManagerService, LocalStorageOptions, LocalStorageSignalsDemoComponent, LocalStorageSignalsManagerService, LoggerService, NotificationMessage, OperationResultModel, PathQueryService, PublicMessage, Random, RandomHSLColor, RandomHexColor, RandomNumber, RandomNumbers, RandomNumbersUnique, RandomPaletteColor, RandomSignature, RandomStr, RandomVisibleColor, RequestErrorInterceptor, RequestHeadersInterceptor, RequestManagerDemoComponent, RequestManagerStateDemoComponent, RequestOptions, RequestService, RequestSignalsService, RetryOptions, SettingOptions, StateMessage, StateOperationResult, StateStorageOptions, StorageData, StorageOption, StorageType, StoreStateManagerService, StoreStateManagerSignalsService, StoreStateSignalsDemoComponent, StreamType, SymmetricalEncryptionService, TableSchemaDef, UUID, UUID_STR, UploadDemoComponent, UploadValidationErrorModel, 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, InvalidFileInfoInterface, LocalStorageOptionsInterface, NotificationMessageInterface, OperationResultInterface, ParsingResult, PublicMessageInterface, RequestOptionsInterface, RetryOptionsInterface, SettingOptionsInterface, State, StateMessageInterface, StateOperationResultInterface, StateStorageOptionsInterface, StateStoreManagerData$1 as StateStoreManagerData, StorageDataInterface, StorageOptionInterface, StreamConfig, StreamEvent, TableRecord, TableSchemaDefInterface, UploadValidationErrorInterface, UserDataInterface, WSOptionsInterface };
+export type { APIStateManagerData, ApiRequestInterface, BatchErrorState, BatchOptionsInterface, BatchPendingState, BatchProgress, BatchRequestState, BatchResultInterface, BatchSuccessState, ConfigHTTPOptionsInterface, ConfigOptionsInterface, DatabaseStorageInterface, ErrorDisplaySettingsInterface, GlobalStoreOptionsInterface, InvalidFileInfoInterface, LocalStorageOptionsInterface, NotificationMessageInterface, OperationResultInterface, ParsingResult, PublicMessageInterface, RequestOptionsInterface, RetryOptionsInterface, SettingOptionsInterface, State, StateMessageInterface, StateOperationResultInterface, StateStorageOptionsInterface, StateStoreManagerData$1 as StateStoreManagerData, StorageDataInterface, StorageOptionInterface, StreamConfig, StreamEvent, StreamOutput, StreamProgress, TableRecord, TableSchemaDefInterface, UploadValidationErrorInterface, UserDataInterface, WSOptionsInterface };