http-request-manager 18.12.3 → 18.12.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "http-request-manager",
-  "version": "18.12.3",
+  "version": "18.12.5",
   "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",
@@ -44,5 +44,6 @@
       "types": "./types/http-request-manager.d.ts",
       "default": "./fesm2022/http-request-manager.mjs"
     }
-  }
+  },
+  "type": "module"
 }

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';
@@ -153,6 +153,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 +258,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[];
@@ -365,11 +433,13 @@ declare class DatabaseStorage implements DatabaseStorageInterface {
 interface RequestOptionsInterface {
     path: any[];
     headers: any;
+    forceRefresh?: boolean;
 }
 declare class RequestOptions implements RequestOptionsInterface {
     path: any[];
     headers: {};
-    constructor(path?: any[], headers?: {});
+    forceRefresh?: boolean | undefined;
+    constructor(path?: any[], headers?: {}, forceRefresh?: boolean | undefined);
     static adapt(item?: any): RequestOptions;
 }
 
@@ -435,15 +505,9 @@ declare class DatabaseManagerService extends DbService {
     getTableRecords(table: string): Observable<unknown>;
     getTableRecord(table: string, id: number): Observable<any>;
     createTableRecord(table: string, record: any): Observable<any>;
-    createTableRecords(table: string, records: any[]): Observable<{
-        [key: string]: any;
-    }[]>;
-    updateTableRecord(table: string, record: any): Observable<{
-        [key: string]: any;
-    } | null>;
-    updateTableRecords(table: string, records: any[]): Observable<{
-        [key: string]: any;
-    }[]>;
+    createTableRecords(table: string, records: any[]): Observable<any[]>;
+    updateTableRecord(table: string, record: any): Observable<any>;
+    updateTableRecords(table: string, records: any[]): Observable<any[]>;
     deleteTableRecord<T>(table: string, id: number): Observable<number | null>;
     deleteTableRecords(table: string, ids: number[]): Observable<number[]>;
     clearTable(table: string): Observable<never[]>;
@@ -566,6 +630,7 @@ declare class HTTPManagerStateService<T extends {
     private shouldRetry;
     private connectionStatusSubscription?;
     private databaseOptions?;
+    private readonly volatileHeaders;
     private wsRetryAttempts;
     wsRetryAttempts$: Observable<number>;
     private wsNextRetry;
@@ -631,6 +696,9 @@ declare class HTTPManagerStateService<T extends {
     readonly clearRecords: (observableOrValue?: void | Observable<void> | undefined) => Subscription;
     readonly fetchRecords: (options?: RequestOptions) => ((observableOrValue?: any) => Subscription) | ((observableOrValue: any) => Subscription);
     private initDBStorageAsync;
+    private buildSchemaFromAdapter;
+    private buildSchemaFromSample;
+    private persistStreamDataToDb;
     readonly fetchRecord: (options: RequestOptions, method: string) => ((observableOrValue?: any) => Subscription) | ((observableOrValue: any) => Subscription);
     readonly createRecord: (data: any | null, options?: RequestOptions) => ((observableOrValue?: any) => Subscription) | ((observableOrValue: any) => Subscription);
     readonly updateRecord: (data: any | null, options?: RequestOptions) => ((observableOrValue?: any) => Subscription) | ((observableOrValue: any) => Subscription);
@@ -736,6 +804,17 @@ declare class HTTPManagerStateService<T extends {
     clearDatabase(): void;
     private isEmpty;
     private updateRequestOptions;
+    private normalizeObject;
+    private filterHeaders;
+    private resolvePath;
+    private getEffectiveParams;
+    private buildRequestSignature;
+    private buildSchemaSignature;
+    private getRequestCacheMetadata;
+    private getStoredSchemaSignature;
+    private saveSchemaSignature;
+    private saveRequestCacheMetadata;
+    private clearRequestCacheMetadata;
     static ɵfac: i0.ɵɵFactoryDeclaration<HTTPManagerStateService<any>, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<HTTPManagerStateService<any>>;
 }
@@ -1033,6 +1112,8 @@ declare class RequestService extends WebsocketService {
     isPending$: 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 & {
@@ -1238,21 +1319,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 +1504,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
@@ -1778,54 +1845,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 +2324,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;
@@ -2376,7 +2410,7 @@ declare class StateManagerDemoService extends HTTPManagerStateService<any> {
     createClient(data: any): void;
     updateClient(data: ClientInfo$1): void;
     deleteClient(data: ClientInfo$1): void;
-    streamRequest(): void;
+    streamRequest(options?: RequestOptions): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<StateManagerDemoService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<StateManagerDemoService>;
 }
@@ -3688,4 +3722,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 };