http-request-manager 18.7.10 → 18.7.12

package/package.json

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

@@ -174,6 +174,20 @@ 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[];
@@ -183,6 +197,7 @@ interface ApiRequestInterface {
     polling?: number;
     retry?: RetryOptions;
     stream?: boolean;
+    streamType?: StreamType;
     displayError?: boolean;
     saveAs?: string;
     fileContentHeader?: string;
@@ -197,11 +212,12 @@ declare class ApiRequest implements ApiRequestInterface {
     polling?: number | undefined;
     retry?: RetryOptions | undefined;
     stream?: boolean | undefined;
+    streamType?: StreamType | undefined;
     displayError?: boolean | undefined;
     saveAs?: string | undefined;
     fileContentHeader?: string | undefined;
     ws?: WSOptions | undefined;
-    constructor(server?: string, path?: any[] | undefined, headers?: any, adapter?: any, mapper?: any, polling?: number | undefined, retry?: RetryOptions | undefined, stream?: boolean | undefined, displayError?: boolean | undefined, saveAs?: string | undefined, fileContentHeader?: string | undefined, ws?: WSOptions | 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, saveAs?: string | undefined, fileContentHeader?: string | undefined, ws?: WSOptions | undefined);
     static adapt(item?: any): ApiRequest;
 }
 
@@ -232,6 +248,28 @@ declare class WSUser implements WSUserInterface {
     static adapt(item?: any): WSUser;
 }
 
+interface ChannelMessageDataInterface {
+    channel: string;
+    users: WSUser[];
+}
+declare class ChannelMessageData implements ChannelMessageDataInterface {
+    channel: string;
+    users: WSUser[];
+    constructor(channel: string, users?: WSUser[]);
+    static adapt(item?: any): ChannelMessageData;
+}
+
+interface ChannelMessageInterface {
+    sessionId: any;
+    content: any;
+}
+declare class ChannelMessage implements ChannelMessageInterface {
+    sessionId: any;
+    content: any;
+    constructor(sessionId?: any, content?: any);
+    static adapt(item?: any): ChannelMessage;
+}
+
 declare enum CommunicationType {
     MESSAGE = 0,
     ALERT = 1,
@@ -327,17 +365,6 @@ declare class DatabaseManagerService extends DbService {
     static ɵprov: i0.ɵɵInjectableDeclaration<DatabaseManagerService>;
 }
 
-interface ChannelMessageInterface {
-    sessionId: any;
-    content: any;
-}
-declare class ChannelMessage implements ChannelMessageInterface {
-    sessionId: any;
-    content: any;
-    constructor(sessionId?: any, content?: any);
-    static adapt(item?: any): ChannelMessage;
-}
-
 /**
  * Channel type enum for different communication purposes
  * - STATE: Private channels for state synchronization (SYS- prefix)
@@ -809,7 +836,33 @@ declare function delayedRetry<T>(delayMs: number, maxRetry?: number): (src: Obse
 
 declare function requestPolling<T>(pollInterval: number, stopCondition$: Observable<any>, isPending$: any): (source: Observable<T>) => Observable<T>;
 
-declare function requestStreaming(): OperatorFunction<any, any>;
+interface StreamConfig {
+    streamType: StreamType;
+    addMetadata?: boolean;
+}
+/**
+ * COMPREHENSIVE REQUEST STREAMING OPERATOR - FULLY ABSTRACTED
+ *
+ * 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(config?: StreamConfig): OperatorFunction<any, any>;
+/**
+ * Convenience functions for common use cases
+ */
+declare function streamJSON(): OperatorFunction<any, any>;
+declare function streamNDJSON(): OperatorFunction<any, any>;
+declare function streamAI(): OperatorFunction<any, any>;
+declare function streamEvents(): OperatorFunction<any, any>;
+declare function streamAuto(): OperatorFunction<any, any>;
 
 interface State {
     localStores: StorageData[];
@@ -988,6 +1041,35 @@ declare class PathQueryService {
     static ɵprov: i0.ɵɵInjectableDeclaration<PathQueryService>;
 }
 
+/**
+ * Generate a random hex color code
+ * @returns A random hex color string (e.g., "#FF5733")
+ */
+declare const RandomHexColor: () => string;
+/**
+ * Generate a random hex color with constraints to ensure good visibility
+ * @param options Optional constraints for color generation
+ * @returns A random hex color string with good contrast
+ */
+declare const RandomVisibleColor: (options?: {
+    minBrightness?: number;
+    maxBrightness?: number;
+}) => string;
+/**
+ * Generate a random color from a predefined palette
+ * @returns A hex color from a set of visually distinct colors
+ */
+declare const RandomPaletteColor: () => string;
+/**
+ * Generate a random HSL color
+ * @param options Optional constraints for HSL generation
+ * @returns A random HSL color string (e.g., "hsl(120, 100%, 50%)")
+ */
+declare const RandomHSLColor: (options?: {
+    saturation?: [number, number];
+    lightness?: [number, number];
+}) => string;
+
 declare class AsymmetricalEncryptionService {
     constructor();
     generateKeyPair(modulusLength?: number): Observable<CryptoKeyPair>;
@@ -1056,12 +1138,14 @@ interface UserDataInterface {
     ldap: string;
     name: string;
     email: string;
+    color: string;
 }
 declare class UserData implements UserDataInterface {
     ldap: string;
     name: string;
     email: string;
-    constructor(ldap?: string, name?: string, email?: string);
+    color: string;
+    constructor(ldap?: string, name?: string, email?: string, color?: string);
     static adapt(item?: any): UserData;
 }
 
@@ -1162,6 +1246,11 @@ declare class RequestManagerStateDemoComponent implements OnInit {
     displayedColumns: string[];
     selectedRecord$?: Observable<ClientInfo$1 | null>;
     fb: FormBuilder;
+    streamTypes: {
+        id: string;
+        value: string;
+    }[];
+    streamType: string;
     httpManagerService: HTTPManagerService<any>;
     isPending$: Observable<boolean>;
     error$: Observable<boolean>;
@@ -1250,6 +1339,7 @@ declare class RequestManagerStateDemoComponent implements OnInit {
     props: (adapter: any) => any;
     constructor();
     ngOnInit(): void;
+    onStreamType(type: string): void;
     addHeader(): void;
     removeHeader(index: number): void;
     compileRequest(): {
@@ -1299,6 +1389,11 @@ declare class RequestManagerDemoComponent implements OnInit {
         DELETE: ApiRequest;
         STREAM: ApiRequest;
     };
+    streamTypes: {
+        id: string;
+        value: string;
+    }[];
+    streamType: string;
     failedState: any;
     pollingState: any;
     questionControl: _angular_forms.FormControl<string | null>;
@@ -1353,6 +1448,7 @@ declare class RequestManagerDemoComponent implements OnInit {
     arrayObjectsToObjects: (arr: any[]) => any;
     constructor();
     ngOnInit(): void;
+    onStreamType(type: string): void;
     addHeader(): void;
     removeHeader(index: number): void;
     compileRequest(): {
@@ -1800,12 +1896,12 @@ declare class RequestManagerWsDemoComponent implements OnInit {
     user: any;
     path: string[];
     wsChannel: string;
-    user$: Observable<WSUser | null>;
-    attempts$: Observable<number>;
-    nextRetry$: Observable<number>;
-    connectionStatus$: Observable<boolean>;
-    data$: Observable<any>;
-    isPending$: Observable<boolean>;
+    user$: rxjs.Observable<WSUser | null>;
+    attempts$: rxjs.Observable<number>;
+    nextRetry$: rxjs.Observable<number>;
+    connectionStatus$: rxjs.Observable<boolean>;
+    data$: rxjs.Observable<any>;
+    isPending$: rxjs.Observable<boolean>;
     ngOnInit(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<RequestManagerWsDemoComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<RequestManagerWsDemoComponent, "app-request-manager-ws-demo", never, { "server": { "alias": "server"; "required": false; }; "wsServer": { "alias": "wsServer"; "required": false; }; "jwtToken": { "alias": "jwtToken"; "required": false; }; "user": { "alias": "user"; "required": false; }; "path": { "alias": "path"; "required": false; }; "wsChannel": { "alias": "wsChannel"; "required": false; }; }, {}, never, never, false, never>;
@@ -2155,5 +2251,5 @@ declare class HttpRequestManagerModule {
     static ɵinj: i0.ɵɵInjectorDeclaration<HttpRequestManagerModule>;
 }
 
-export { ApiRequest, AppService, AsymmetricalEncryptionService, CONFIG_SETTINGS_TOKEN, ChannelInfo, ChannelType, CommunicationType, ConfigHTTPOptions, ConfigOptions, DataType, DatabaseDataDemoComponent, DatabaseManagerService, DatabaseStorage, DbService, ErrorDisplaySettings, GlobalStoreOptions, HTTPManagerService, HTTPManagerSignalsService, HTTPManagerStateService, HeadersService, HttpRequestManagerModule, HttpRequestServicesDemoComponent, LocalStorageDemoComponent, LocalStorageManagerService, LocalStorageOptions, LocalStorageSignalsManagerService, PathQueryService, Random, RandomNumber, RandomNumbers, RandomNumbersUnique, RandomSignature, RandomStr, RequestErrorInterceptor, RequestHeadersInterceptor, RequestManagerDemoComponent, RequestManagerStateDemoComponent, RequestOptions, RequestService, RequestSignalsService, RetryOptions, SettingOptions, StateStorageOptions, StorageData, StorageOption, StorageType, StoreStateManagerService, SymmetricalEncryptionService, TableSchemaDef, UUID, UUID_STR, UtilsService, WSOptions, WSUser, WebsocketService, WithCredentialsInterceptor, countdown, createChannelName, delayedRetry, requestPolling, requestStreaming };
-export type { APIStateManagerData, ApiRequestInterface, ChannelInfoInterface, ConfigHTTPOptionsInterface, ConfigOptionsInterface, DatabaseStorageInterface, ErrorDisplaySettingsInterface, GlobalStoreOptionsInterface, LocalStorageOptionsInterface, RequestOptionsInterface, RetryOptionsInterface, SettingOptionsInterface, State, StateStorageOptionsInterface, StateStoreManagerData, StorageDataInterface, StorageOptionInterface, TableRecord, TableSchemaDefInterface, WSOptionsInterface, WSUserInterface };
+export { ApiRequest, AppService, AsymmetricalEncryptionService, CONFIG_SETTINGS_TOKEN, ChannelInfo, ChannelMessage, ChannelMessageData, ChannelType, CommunicationType, ConfigHTTPOptions, ConfigOptions, DataType, DatabaseDataDemoComponent, DatabaseManagerService, DatabaseStorage, DbService, ErrorDisplaySettings, GlobalStoreOptions, HTTPManagerService, HTTPManagerSignalsService, HTTPManagerStateService, HeadersService, HttpRequestManagerModule, HttpRequestServicesDemoComponent, LocalStorageDemoComponent, LocalStorageManagerService, LocalStorageOptions, LocalStorageSignalsDemoComponent, LocalStorageSignalsManagerService, PathQueryService, Random, RandomHSLColor, RandomHexColor, RandomNumber, RandomNumbers, RandomNumbersUnique, RandomPaletteColor, RandomSignature, RandomStr, RandomVisibleColor, RequestErrorInterceptor, RequestHeadersInterceptor, RequestManagerDemoComponent, RequestManagerStateDemoComponent, RequestManagerWsDemoComponent, RequestOptions, RequestService, RequestSignalsManagerDemoComponent, RequestSignalsService, RetryOptions, SettingOptions, StateStorageOptions, StorageData, StorageOption, StorageType, StoreStateManagerDemoComponent, StoreStateManagerService, StreamType, SymmetricalEncryptionService, TableSchemaDef, UUID, UUID_STR, UtilsService, WSOptions, WSUser, WebsocketService, WithCredentialsInterceptor, countdown, createChannelName, delayedRetry, requestPolling, requestStreaming, streamAI, streamAuto, streamEvents, streamJSON, streamNDJSON };
+export type { APIStateManagerData, ApiRequestInterface, ChannelInfoInterface, ChannelMessageDataInterface, ChannelMessageInterface, ConfigHTTPOptionsInterface, ConfigOptionsInterface, DatabaseStorageInterface, ErrorDisplaySettingsInterface, GlobalStoreOptionsInterface, LocalStorageOptionsInterface, RequestOptionsInterface, RetryOptionsInterface, SettingOptionsInterface, State, StateStorageOptionsInterface, StateStoreManagerData, StorageDataInterface, StorageOptionInterface, StreamConfig, TableRecord, TableSchemaDefInterface, WSOptionsInterface, WSUserInterface };