@techextensor/tab-core-utility 2.2.187 → 2.2.188

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.187",
+  "version": "2.2.188",
   "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"