@xh/hoist 73.0.0-SNAPSHOT.1744391471093 → 73.0.0-SNAPSHOT.1744587856582

package/CHANGELOG.md

@@ -8,6 +8,7 @@
   connected clients.
 * Enabled telemetry reporting from `WebSocketService`.
 * Updated `MenuItem.actionFn()` to receive the click event as an additional argument.
+* Support for reporting App Build, Tab Id, and Load Id in websocket admin page.
 
 ## v72.4.0 - 2025-04-09
 

package/admin/tabs/cluster/instances/websocket/WebSocketColumns.ts

@@ -73,11 +73,33 @@ export const lastReceivedTime: ColumnSpec = {
     width: 140
 };
 
-export const clientAppVersion: ColumnSpec = {
+export const appVersion: ColumnSpec = {
     field: {
-        name: 'clientAppVersion',
+        name: 'appVersion',
         type: 'string',
         displayName: 'Client Version'
     },
     width: 120
 };
+
+export const appBuild: ColumnSpec = {
+    field: {
+        name: 'appBuild',
+        type: 'string'
+    },
+    width: 120
+};
+export const loadId: ColumnSpec = {
+    field: {
+        name: 'loadId',
+        type: 'string'
+    },
+    width: 120
+};
+export const tabId: ColumnSpec = {
+    field: {
+        name: 'tabId',
+        type: 'string'
+    },
+    width: 120
+};

package/admin/tabs/cluster/instances/websocket/WebSocketModel.ts

@@ -92,7 +92,10 @@ export class WebSocketModel extends BaseInstanceModel {
                 WSCol.lastSentTime,
                 WSCol.receivedMessageCount,
                 WSCol.lastReceivedTime,
-                WSCol.clientAppVersion
+                WSCol.appVersion,
+                WSCol.appBuild,
+                WSCol.loadId,
+                WSCol.tabId
             ]
         });
 

package/build/types/admin/tabs/cluster/instances/websocket/WebSocketColumns.d.ts

@@ -6,4 +6,7 @@ export declare const sentMessageCount: ColumnSpec;
 export declare const lastSentTime: ColumnSpec;
 export declare const receivedMessageCount: ColumnSpec;
 export declare const lastReceivedTime: ColumnSpec;
-export declare const clientAppVersion: ColumnSpec;
+export declare const appVersion: ColumnSpec;
+export declare const appBuild: ColumnSpec;
+export declare const loadId: ColumnSpec;
+export declare const tabId: ColumnSpec;

package/build/types/svc/WebSocketService.d.ts

@@ -28,6 +28,7 @@ export declare class WebSocketService extends HoistService {
     readonly REG_SUCCESS_TOPIC = "xhRegistrationSuccess";
     readonly FORCE_APP_SUSPEND_TOPIC = "xhForceAppSuspend";
     readonly REQ_CLIENT_HEALTH_RPT_TOPIC = "xhRequestClientHealthReport";
+    readonly METADATA_FOR_HANDSHAKE: string[];
     /** True if WebSockets generally enabled - set statically in code via {@link AppSpec}. */
     enabled: boolean;
     /** Unique channel assigned by server upon successful connection. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xh/hoist",
-  "version": "73.0.0-SNAPSHOT.1744391471093",
+  "version": "73.0.0-SNAPSHOT.1744587856582",
   "description": "Hoist add-on for building and deploying React Applications.",
   "repository": "github:xh/hoist-react",
   "homepage": "https://xh.io",

package/svc/WebSocketService.ts

@@ -42,6 +42,7 @@ export class WebSocketService extends HoistService {
     readonly REG_SUCCESS_TOPIC = 'xhRegistrationSuccess';
     readonly FORCE_APP_SUSPEND_TOPIC = 'xhForceAppSuspend';
     readonly REQ_CLIENT_HEALTH_RPT_TOPIC = 'xhRequestClientHealthReport';
+    readonly METADATA_FOR_HANDSHAKE = ['appVersion', 'appBuild', 'loadId', 'tabId'];
 
     /** True if WebSockets generally enabled - set statically in code via {@link AppSpec}. */
     enabled: boolean = XH.appSpec.webSocketsEnabled;
@@ -304,7 +305,7 @@ export class WebSocketService extends HoistService {
 
     private buildWebSocketUrl() {
         const protocol = window.location.protocol == 'https:' ? 'wss:' : 'ws:',
-            endpoint = 'xhWebSocket?clientAppVersion=' + XH.appVersion;
+            endpoint = `xhWebSocket?${this.METADATA_FOR_HANDSHAKE.map(key => `${key}=${XH[key]}`).join('&')}`;
         return XH.isDevelopmentMode
             ? `${protocol}//${XH.baseUrl.split('//')[1]}${endpoint}`
             : `${protocol}//${window.location.host}${XH.baseUrl}${endpoint}`;