@techextensor/tab-core-utility 2.2.192 → 2.2.193

package/lib/tab-core-utility/core/http-client/api.service.d.ts

@@ -1,5 +1,6 @@
 import { HttpParams, HttpHeaders } from '@angular/common/http';
 import { Observable } from 'rxjs';
+import { APIServiceName, CommonApiResponse } from '../../app/interfaces/common.interface';
 import * as i0 from "@angular/core";
 export declare class ApiService {
     private readonly http;
@@ -81,6 +82,51 @@ export declare class ApiService {
      * @returns An Observable emitting the response data of type T.
      */
     deleteByUrl<T>(url: string, options?: any): Observable<any>;
+    /**
+     * Makes an HTTP GET request to a specific microservice
+     * @param serviceName - Name of the microservice (e.g., 'crudService', 'metadataService')
+     * @param endPointName - Endpoint path relative to the service
+     * @param params - Query parameters for the request
+     * @param reqHeader - Custom headers for the request
+     * @returns An Observable emitting the response data (auto-normalized to CommonApiResponse format)
+     */
+    getFromService(serviceName: APIServiceName, endPointName: string, params?: HttpParams, reqHeader?: HttpHeaders): Observable<CommonApiResponse>;
+    /**
+     * Makes an HTTP POST request to a specific microservice
+     * @param serviceName - Name of the microservice (e.g., 'crudService', 'formioService')
+     * @param endPointName - Endpoint path relative to the service
+     * @param data - Data to send with the request
+     * @param reqHeader - Custom headers for the request
+     * @returns An Observable emitting the response data (auto-normalized to CommonApiResponse format)
+     */
+    postToService<T, D>(serviceName: APIServiceName, endPointName: string, data?: D, reqHeader?: HttpHeaders): Observable<CommonApiResponse>;
+    /**
+     * Makes an HTTP PUT request to a specific microservice
+     * @param serviceName - Name of the microservice
+     * @param endPointName - Endpoint path relative to the service
+     * @param data - Data to send with the request
+     * @param reqHeader - Custom headers for the request
+     * @returns An Observable emitting the response data (auto-normalized to CommonApiResponse format)
+     */
+    putToService<T, D>(serviceName: APIServiceName, endPointName: string, data: D, reqHeader?: HttpHeaders): Observable<CommonApiResponse>;
+    /**
+     * Makes an HTTP DELETE request to a specific microservice
+     * @param serviceName - Name of the microservice
+     * @param endPointName - Endpoint path relative to the service
+     * @param data - Data to send with the request (optional, for DELETE with body)
+     * @param reqHeader - Custom headers for the request
+     * @returns An Observable emitting the response data (auto-normalized to CommonApiResponse format)
+     */
+    deleteFromService<D>(serviceName: APIServiceName, endPointName: string, data?: D, reqHeader?: HttpHeaders): Observable<CommonApiResponse>;
+    /**
+     * Makes an HTTP POST request to a specific microservice and returns a Blob response
+     * @param serviceName - Name of the microservice (e.g., 'reportService')
+     * @param endPointName - Endpoint path relative to the service
+     * @param data - Data to send with the request
+     * @param reqHeader - Custom headers for the request
+     * @returns An Observable emitting the response as a Blob
+     */
+    postBlobToService<D>(serviceName: APIServiceName, endPointName: string, data?: D, reqHeader?: HttpHeaders): Observable<Blob>;
     static ɵfac: i0.ɵɵFactoryDeclaration<ApiService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<ApiService>;
 }

package/lib/tab-core-utility/core/service/signalr/operation-tracker.service.d.ts

@@ -0,0 +1,40 @@
+import { Observable } from 'rxjs';
+import { CrudNotification, PendingOperation } from '../../../app/interfaces/signalr.interface';
+import * as i0 from "@angular/core";
+/**
+ * Operation Tracker Service
+ * Tracks async operations by correlationId and matches them with SignalR notifications
+ * Used by TabFormioService for handling async processRequest operations
+ */
+export declare class OperationTrackerService {
+    private pendingOperations;
+    private operationCompleted$;
+    /**
+     * Register an async operation for tracking
+     */
+    registerOperation(operation: PendingOperation): void;
+    /**
+     * Wait for operation to complete via SignalR notification
+     * Returns Observable that emits when notification with matching correlationId is received
+     */
+    waitForOperation(correlationId: string, timeoutMs?: number): Observable<CrudNotification>;
+    /**
+     * Handle incoming SignalR notification
+     * Called by SignalRService when notification is received
+     */
+    handleNotification(notification: CrudNotification): void;
+    /**
+     * Check if operation is pending
+     */
+    isPending(correlationId: string): boolean;
+    /**
+     * Get pending operations count (for debugging)
+     */
+    getPendingCount(): number;
+    /**
+     * Get all pending operations (for debugging)
+     */
+    getAllPending(): PendingOperation[];
+    static ɵfac: i0.ɵɵFactoryDeclaration<OperationTrackerService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<OperationTrackerService>;
+}

package/lib/tab-core-utility/core/service/signalr/signalr-infrastructure.service.d.ts

@@ -0,0 +1,73 @@
+import { Subject } from 'rxjs';
+import { ConnectionState, CrudNotification } from '../../../app/interfaces/signalr.interface';
+import { SessionStorageService } from '../../../auth/session-storage.service';
+import { LocalStorageService } from '../../../auth/local-storage.service';
+import * as i0 from "@angular/core";
+/**
+ * SignalR Infrastructure Service
+ * Handles low-level WebSocket connection, group management, and reconnection
+ * Internal use only - components should use SignalRService instead
+ */
+export declare class SignalRInfrastructure {
+    private hubConnection;
+    readonly sessionStorageService: SessionStorageService;
+    readonly localStorageService: LocalStorageService;
+    readonly connectionState: import("@angular/core").WritableSignal<ConnectionState>;
+    readonly notifications$: Subject<CrudNotification>;
+    private activeGroups;
+    /**
+     * Helper method to get value from storage
+     * @param type The type of storage, 'Session' or 'Local'
+     * @param key The key to retrieve the value for
+     * @returns The value from storage, or null if not available
+     */
+    private getFromStorage;
+    get appId(): string | null;
+    get environmentId(): string | null;
+    get tenantId(): string | null;
+    get token(): string | null;
+    /**
+     * Connect to SignalR hub
+     */
+    connect(): Promise<void>;
+    /**
+     * Register SignalR event handlers for CRUD notifications
+     */
+    private registerEventHandlers;
+    /**
+     * Extract notification from SignalR callback args
+     * Handles both unwrapped (direct object) and wrapped ({ type, target, arguments }) formats
+     */
+    private extractNotification;
+    /**
+     * Register connection lifecycle handlers
+     */
+    private registerConnectionLifecycle;
+    /**
+     * Join SignalR group for an AppObject
+     */
+    joinGroup(appObjectId: string): Promise<void>;
+    /**
+     * Leave SignalR group
+     */
+    leaveGroup(appObjectId: string): Promise<void>;
+    /**
+     * Rejoin all active groups after reconnection
+     * This ensures components continue receiving notifications after network interruption
+     */
+    private rejoinGroups;
+    /**
+     * Check if connected
+     */
+    isConnected(): boolean;
+    /**
+     * Disconnect from SignalR hub (cleanup)
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Get active groups (for debugging)
+     */
+    getActiveGroups(): string[];
+    static ɵfac: i0.ɵɵFactoryDeclaration<SignalRInfrastructure, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SignalRInfrastructure>;
+}

package/lib/tab-core-utility/core/service/signalr/signalr.service.d.ts

@@ -0,0 +1,122 @@
+import { Observable } from 'rxjs';
+import { CrudNotification, NotificationCallback, PendingOperation } from '../../../app/interfaces/signalr.interface';
+import * as i0 from "@angular/core";
+/**
+ * SignalR Service
+ * Public API for:
+ * 1. Components to register for real-time CRUD notifications
+ * 2. Services (TabFormioService) to track async operations
+ *
+ * Usage in components:
+ * ```typescript
+ * ngOnInit() {
+ *   this.signalRService.register(
+ *     this.componentId,
+ *     this.appObjectId,
+ *     (notification) => this.handleNotification(notification)
+ *   );
+ * }
+ *
+ * ngOnDestroy() {
+ *   this.signalRService.unregister(this.componentId, this.appObjectId);
+ * }
+ * ```
+ *
+ * Usage in services (TabFormioService):
+ * ```typescript
+ * const correlationId = response.correlationId;
+ * this.signalRService.waitForOperation(correlationId).subscribe(notification => {
+ *   // Handle completed operation
+ * });
+ * ```
+ */
+export declare class SignalRService {
+    private infrastructure;
+    private operationTracker;
+    private componentRegistry;
+    /**
+     * Get connection state (for UI indicators)
+     */
+    readonly connectionState: import("@angular/core").WritableSignal<import("../../../app/interfaces/signalr.interface").ConnectionState>;
+    /**
+     * Check if currently connected
+     */
+    readonly isConnected: import("@angular/core").Signal<boolean>;
+    constructor();
+    /**
+     * Establish a connection to the SignalR hub
+     *
+     * This method is idempotent - if the connection is already established, it will not be re-established.
+     * Hub URL is read from Common.signalRHubUrl (set during app initialization via Common.init())
+     */
+    connect(): void;
+    /**
+     * Register component for real-time notifications
+     *
+     * @param componentId - Unique component identifier (generated by component)
+     * @param appObjectId - AppObject ID to subscribe to
+     * @param callback - Function to call when notification received
+     */
+    register(componentId: string, appObjectId: string, callback: NotificationCallback): void;
+    /**
+     * Unregister component (cleanup on component destroy)
+     *
+     * @param componentId - Component identifier to remove
+     * @param appObjectId - AppObject ID to unsubscribe from
+     */
+    unregister(componentId: string, appObjectId: string): void;
+    /**
+     * Wait for specific async operation to complete
+     * Used by TabFormioService for async processRequest operations
+     *
+     * @param correlationId - Correlation ID from backend response
+     * @param timeout - Optional timeout in milliseconds
+     * @returns Observable that emits when operation completes
+     */
+    waitForOperation(correlationId: string, timeout?: number): Observable<CrudNotification>;
+    /**
+     * Register async operation for tracking
+     * Optional - waitForOperation handles registration automatically
+     *
+     * @param operation - Pending operation details
+     */
+    registerOperation(operation: PendingOperation): void;
+    /**
+     * Check if operation is pending
+     */
+    isOperationPending(correlationId: string): boolean;
+    /**
+     * Notify all registered components for an AppObject
+     * Called when notification received from SignalR hub
+     */
+    private notifyComponents;
+    /**
+     * Get active AppObject groups (for debugging)
+     */
+    getActiveGroups(): string[];
+    /**
+     * Get component count for an AppObject (for debugging)
+     */
+    getComponentCount(appObjectId: string): number;
+    /**
+     * Get total registered components across all AppObjects (for debugging)
+     */
+    getTotalComponentCount(): number;
+    /**
+     * Get registry state (for debugging)
+     */
+    getRegistryState(): {
+        appObjectId: string;
+        componentCount: number;
+    }[];
+    /**
+     * Get pending operations count (for debugging)
+     */
+    getPendingOperationsCount(): number;
+    /**
+     * Get all pending operations (for debugging)
+     */
+    getPendingOperations(): PendingOperation[];
+    static ɵfac: i0.ɵɵFactoryDeclaration<SignalRService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SignalRService>;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@techextensor/tab-core-utility",
-  "version": "2.2.192",
+  "version": "2.2.193",
   "peerDependencies": {
     "@angular/common": "^19.2.15",
     "@angular/core": "^19.2.15",
@@ -11,7 +11,8 @@
     "idb": "^8.0.2",
     "liquidjs": "^10.20.3",
     "cypress": "^13.17.0",
-    "crypto-js": "^4.2.0"
+    "crypto-js": "^4.2.0",
+    "@microsoft/signalr": "^10.0.0"
   },
   "dependencies": {
     "tslib": "^2.8.1"