@xh/hoist 72.3.0 → 72.4.0

package/CHANGELOG.md

@@ -1,12 +1,24 @@
 # Changelog
 
+## v72.4.0 - 2025-04-09
+
+### 🎁 New Features
+* New methods for formatting timestamps within nested JSON objects.  See `withFormattedTimestamps`
+  and `timestampReplacer` in the `@xh/hoist/format` package.
+* `ViewManagerConfig` takes new optional key `viewMenuItemFn` to allow ViewManager implementations
+  to customize the menu items for views in the view manager menu.
+
+### ⚙️ Technical
+* Added dedicated `ClientHealthService` for managing client health report. Additional enhancements
+  to health report to include information about web sockets, idle time, and page state.
+
 ## v72.3.0 - 2025-04-08
 
 ### 🎁 New Features
 
 * Added support for posting a "Client Health Report" track message on a configurable interval. This
   message will include basic client information, and can be extended to include any other desired
-  data via `XH.trackService.addClientHealthReportSource()`. Enable by updating your app's
+  data via `XH.clientHealthService.addSource()`. Enable by updating your app's
   `xhActivityTrackingConfig` to include `clientHealthReport: {intervalMins: XXXX}`.
 * Enabled opt-in support for telemetry in `MsalClient`, leveraging hooks built-in to MSAL to collect
   timing and success/failure count for all events emitted by the library.

package/admin/tabs/activity/tracking/detail/ActivityDetailModel.ts

@@ -9,9 +9,9 @@ import * as Col from '@xh/hoist/admin/columns';
 import {FormModel} from '@xh/hoist/cmp/form';
 import {GridModel} from '@xh/hoist/cmp/grid';
 import {HoistModel, lookup, managed} from '@xh/hoist/core';
-import {fmtJson} from '@xh/hoist/format';
 import {action, computed, makeObservable, observable} from '@xh/hoist/mobx';
 import {ActivityTrackingModel} from '../ActivityTrackingModel';
+import {fmtJson, timestampReplacer} from '@xh/hoist/format';
 
 export class ActivityDetailModel extends HoistModel {
     @lookup(ActivityTrackingModel) activityTrackingModel: ActivityTrackingModel;
@@ -118,7 +118,7 @@ export class ActivityDetailModel extends HoistModel {
         let formattedTrackData = trackData;
         if (formattedTrackData) {
             try {
-                formattedTrackData = fmtJson(trackData);
+                formattedTrackData = fmtJson(trackData, {replacer: timestampReplacer()});
             } catch (ignored) {}
         }
 

package/admin/tabs/cluster/instances/BaseInstanceModel.ts

@@ -5,10 +5,7 @@
  * Copyright © 2025 Extremely Heavy Industries Inc.
  */
 import {InstancesTabModel} from '@xh/hoist/admin/tabs/cluster/instances/InstancesTabModel';
-import {HoistModel, LoadSpec, lookup, PlainObject, XH} from '@xh/hoist/core';
-import {fmtDateTimeSec, fmtJson} from '@xh/hoist/format';
-import {DAYS} from '@xh/hoist/utils/datetime';
-import {cloneDeep, forOwn, isArray, isNumber, isPlainObject} from 'lodash';
+import {HoistModel, LoadSpec, lookup, XH} from '@xh/hoist/core';
 import {createRef} from 'react';
 import {isDisplayed} from '@xh/hoist/utils/js';
 
@@ -21,12 +18,6 @@ export class BaseInstanceModel extends HoistModel {
         return this.parent.instanceName;
     }
 
-    fmtStats(stats: PlainObject): string {
-        stats = cloneDeep(stats);
-        this.processTimestamps(stats);
-        return fmtJson(JSON.stringify(stats));
-    }
-
     handleLoadException(e: unknown, loadSpec: LoadSpec) {
         const instanceNotFound = this.isInstanceNotFound(e),
             connDown = this.parent.lastLoadException,
@@ -49,23 +40,4 @@ export class BaseInstanceModel extends HoistModel {
     private isInstanceNotFound(e: unknown): boolean {
         return e['name'] == 'InstanceNotFoundException';
     }
-
-    private processTimestamps(stats: PlainObject) {
-        forOwn(stats, (v, k) => {
-            // Convert numbers that look like recent timestamps to date values.
-            if (
-                (k.endsWith('Time') ||
-                    k.endsWith('Date') ||
-                    k.endsWith('Timestamp') ||
-                    k == 'timestamp') &&
-                isNumber(v) &&
-                v > Date.now() - 365 * DAYS
-            ) {
-                stats[k] = v ? fmtDateTimeSec(v, {fmt: 'MMM DD HH:mm:ss.SSS'}) : null;
-            }
-            if (isPlainObject(v) || isArray(v)) {
-                this.processTimestamps(v);
-            }
-        });
-    }
 }

package/admin/tabs/cluster/instances/services/DetailsPanel.ts

@@ -12,6 +12,7 @@ import {panel} from '@xh/hoist/desktop/cmp/panel';
 import {jsonInput} from '@xh/hoist/desktop/cmp/input';
 import {Icon} from '@xh/hoist/icon';
 import {isEmpty} from 'lodash';
+import {fmtJson, timestampReplacer} from '@xh/hoist/format';
 
 export const detailsPanel = hoistCmp.factory({
     model: creates(DetailsModel),
@@ -57,7 +58,7 @@ const stats = hoistCmp.factory<DetailsModel>({
                       enableSearch: true,
                       showFullscreenButton: false,
                       editorProps: {lineNumbers: false},
-                      value: model.parent.fmtStats(stats)
+                      value: fmtJson(stats, {replacer: timestampReplacer()})
                   })
               );
     }

package/admin/tabs/cluster/objects/DetailModel.ts

@@ -6,21 +6,11 @@
  */
 import {ClusterObjectsModel} from '@xh/hoist/admin/tabs/cluster/objects/ClusterObjectsModel';
 import {ColumnSpec, GridModel} from '@xh/hoist/cmp/grid';
-import {HoistModel, lookup, managed, PlainObject, XH} from '@xh/hoist/core';
+import {HoistModel, lookup, managed, XH} from '@xh/hoist/core';
 import {StoreRecord} from '@xh/hoist/data';
-import {fmtDateTimeSec, fmtJson} from '@xh/hoist/format';
 import {action, makeObservable, observable} from '@xh/hoist/mobx';
-import {DAYS} from '@xh/hoist/utils/datetime';
-import {
-    cloneDeep,
-    forOwn,
-    isArray,
-    isEmpty,
-    isEqual,
-    isNumber,
-    isPlainObject,
-    without
-} from 'lodash';
+import {isEmpty, isEqual, without} from 'lodash';
+import {withFormattedTimestamps} from '@xh/hoist/format';
 
 export class DetailModel extends HoistModel {
     @lookup(ClusterObjectsModel)
@@ -66,12 +56,6 @@ export class DetailModel extends HoistModel {
         });
     }
 
-    fmtStats(stats: PlainObject): string {
-        stats = cloneDeep(stats);
-        this.processTimestamps(stats);
-        return fmtJson(JSON.stringify(stats));
-    }
-
     //----------------------
     // Implementation
     //----------------------
@@ -95,8 +79,7 @@ export class DetailModel extends HoistModel {
         const gridModel = this.createGridModel(diffFields, otherFields);
         gridModel.loadData(
             instanceNames.map(instanceName => {
-                const data = cloneDeep(adminStatsByInstance[instanceName] ?? {});
-                this.processTimestamps(data);
+                const data = withFormattedTimestamps(adminStatsByInstance[instanceName] ?? {});
                 return {instanceName, ...data};
             })
         );
@@ -136,23 +119,4 @@ export class DetailModel extends HoistModel {
         }
         return ret;
     }
-
-    private processTimestamps(stats: PlainObject) {
-        forOwn(stats, (v, k) => {
-            // Convert numbers that look like recent timestamps to date values.
-            if (
-                (k.endsWith('Time') ||
-                    k.endsWith('Date') ||
-                    k.endsWith('Timestamp') ||
-                    k == 'timestamp') &&
-                isNumber(v) &&
-                v > Date.now() - 365 * DAYS
-            ) {
-                stats[k] = v ? fmtDateTimeSec(v, {fmt: 'MMM DD HH:mm:ss.SSS'}) : null;
-            }
-            if (isPlainObject(v) || isArray(v)) {
-                this.processTimestamps(v);
-            }
-        });
-    }
 }

package/admin/tabs/cluster/objects/DetailPanel.ts

@@ -12,6 +12,7 @@ import {panel} from '@xh/hoist/desktop/cmp/panel';
 import {Icon} from '@xh/hoist/icon';
 import {DetailModel} from './DetailModel';
 import './ClusterObjects.scss';
+import {fmtJson, timestampReplacer} from '@xh/hoist/format';
 
 export const detailPanel = hoistCmp.factory({
     model: creates(DetailModel),
@@ -42,7 +43,7 @@ export const detailPanel = hoistCmp.factory({
                         height: '100%',
                         showFullscreenButton: false,
                         editorProps: {lineNumbers: false},
-                        value: model.fmtStats(selectedAdminStats)
+                        value: fmtJson(selectedAdminStats, {replacer: timestampReplacer()})
                     })
                 })
             ]

package/appcontainer/AppContainerModel.ts

@@ -25,6 +25,7 @@ import {
     AlertBannerService,
     AutoRefreshService,
     ChangelogService,
+    ClientHealthService,
     ConfigService,
     EnvironmentService,
     FetchService,
@@ -237,6 +238,7 @@ export class AppContainerModel extends HoistModel {
                 AlertBannerService,
                 AutoRefreshService,
                 ChangelogService,
+                ClientHealthService,
                 IdleService,
                 InspectorService,
                 GridAutosizeService,

package/appcontainer/AppStateModel.ts

@@ -4,11 +4,10 @@
  *
  * Copyright © 2025 Extremely Heavy Industries Inc.
  */
-import {AppState, AppSuspendData, HoistModel, XH} from '@xh/hoist/core';
+import {AppState, AppSuspendData, HoistModel, PlainObject, XH} from '@xh/hoist/core';
 import {action, makeObservable, observable} from '@xh/hoist/mobx';
 import {Timer} from '@xh/hoist/utils/async';
-import {getClientDeviceInfo} from '@xh/hoist/utils/js';
-import {camelCase, isBoolean, isString, mapKeys} from 'lodash';
+import {camelCase, isBoolean, isString, mapKeys, pick} from 'lodash';
 
 /**
  * Support for Core Hoist Application state and loading.
@@ -93,13 +92,14 @@ export class AppStateModel extends HoistModel {
                     timestamp: loadStarted,
                     elapsed: Date.now() - loadStarted - (timings.LOGIN_REQUIRED ?? 0),
                     data: {
-                        appVersion: XH.appVersion,
-                        appBuild: XH.appBuild,
-                        locationHref: window.location.href,
+                        clientId: XH.clientId,
+                        sessionId: XH.sessionId,
                         timings: mapKeys(timings, (v, k) => camelCase(k)),
-                        ...getClientDeviceInfo()
+                        clientHealth: XH.clientHealthService.getReport(),
+                        window: this.getWindowData(),
+                        screen: this.getScreenData()
                     },
-                    logData: ['appVersion', 'appBuild'],
+                    logData: ['clientId', 'sessionId'],
                     omit: !XH.appSpec.trackAppLoad
                 })
         });
@@ -115,4 +115,36 @@ export class AppStateModel extends HoistModel {
             });
         });
     }
+
+    private getScreenData(): PlainObject {
+        const screen = window.screen as any;
+        if (!screen) return null;
+
+        const ret: PlainObject = pick(screen, [
+            'availWidth',
+            'availHeight',
+            'width',
+            'height',
+            'colorDepth',
+            'pixelDepth',
+            'availLeft',
+            'availTop'
+        ]);
+        if (screen.orientation) {
+            ret.orientation = pick(screen.orientation, ['angle', 'type']);
+        }
+        return ret;
+    }
+
+    private getWindowData(): PlainObject {
+        return pick(window, [
+            'devicePixelRatio',
+            'screenX',
+            'screenY',
+            'innerWidth',
+            'innerHeight',
+            'outerWidth',
+            'outerHeight'
+        ]);
+    }
 }

package/build/types/admin/tabs/cluster/instances/BaseInstanceModel.d.ts

@@ -1,13 +1,11 @@
 /// <reference types="react" />
 import { InstancesTabModel } from '@xh/hoist/admin/tabs/cluster/instances/InstancesTabModel';
-import { HoistModel, LoadSpec, PlainObject } from '@xh/hoist/core';
+import { HoistModel, LoadSpec } from '@xh/hoist/core';
 export declare class BaseInstanceModel extends HoistModel {
     viewRef: import("react").RefObject<HTMLElement>;
     parent: InstancesTabModel;
     get instanceName(): string;
-    fmtStats(stats: PlainObject): string;
     handleLoadException(e: unknown, loadSpec: LoadSpec): void;
     get isVisible(): boolean;
     private isInstanceNotFound;
-    private processTimestamps;
 }

package/build/types/admin/tabs/cluster/objects/DetailModel.d.ts

@@ -1,6 +1,6 @@
 import { ClusterObjectsModel } from '@xh/hoist/admin/tabs/cluster/objects/ClusterObjectsModel';
 import { GridModel } from '@xh/hoist/cmp/grid';
-import { HoistModel, PlainObject } from '@xh/hoist/core';
+import { HoistModel } from '@xh/hoist/core';
 import { StoreRecord } from '@xh/hoist/data';
 export declare class DetailModel extends HoistModel {
     parent: ClusterObjectsModel;
@@ -11,9 +11,7 @@ export declare class DetailModel extends HoistModel {
     get instanceName(): string;
     get selectedAdminStats(): any;
     constructor();
-    fmtStats(stats: PlainObject): string;
     private updateGridModel;
     private createGridModel;
     private createColSpec;
-    private processTimestamps;
 }

package/build/types/appcontainer/AppStateModel.d.ts

@@ -23,4 +23,6 @@ export declare class AppStateModel extends HoistModel {
     checkAccess(): boolean;
     private trackLoad;
     private createActivityListeners;
+    private getScreenData;
+    private getWindowData;
 }

package/build/types/cmp/viewmanager/ViewManagerModel.d.ts

@@ -1,5 +1,6 @@
 import { HoistModel, LoadSpec, PlainObject, TaskObserver, Thunkable } from '@xh/hoist/core';
 import type { ViewManagerProvider } from '@xh/hoist/core';
+import { ReactNode } from 'react';
 import { ViewInfo } from './ViewInfo';
 import { View } from './View';
 export interface ViewCreateSpec {
@@ -85,6 +86,11 @@ export interface ViewManagerConfig {
      * Optional user-facing display name for describing global views. Defaults to 'global'
      */
     globalDisplayName?: string;
+    /**
+     * Optional key to pass a method that returns a customized BlueprintJS `menuItem` for listing
+     * views in the ViewManager menu.
+     */
+    viewMenuItemFn?: (view: ViewInfo, model: ViewManagerModel) => ReactNode;
 }
 /**
  *  ViewManagerModel coordinates the loading, saving, and management of user-defined bundles of
@@ -121,6 +127,7 @@ export declare class ViewManagerModel<T = PlainObject> extends HoistModel {
     readonly instance: string;
     readonly typeDisplayName: string;
     readonly globalDisplayName: string;
+    readonly viewMenuItemFn: (view: ViewInfo, model: ViewManagerModel) => ReactNode;
     readonly enableAutoSave: boolean;
     readonly enableDefault: boolean;
     readonly enableGlobal: boolean;

package/build/types/core/XH.d.ts

@@ -1,7 +1,7 @@
 import { RouterModel } from '@xh/hoist/appcontainer/RouterModel';
 import { HoistAuthModel } from '@xh/hoist/core/HoistAuthModel';
 import { Store } from '@xh/hoist/data';
-import { AlertBannerService, AutoRefreshService, ChangelogService, ConfigService, EnvironmentService, FetchOptions, FetchService, GridAutosizeService, GridExportService, IdentityService, IdleService, InspectorService, JsonBlobService, LocalStorageService, PrefService, SessionStorageService, TrackService, WebSocketService } from '@xh/hoist/svc';
+import { AlertBannerService, AutoRefreshService, ChangelogService, ConfigService, EnvironmentService, FetchOptions, FetchService, GridAutosizeService, GridExportService, IdentityService, IdleService, InspectorService, JsonBlobService, LocalStorageService, PrefService, SessionStorageService, TrackService, WebSocketService, ClientHealthService } from '@xh/hoist/svc';
 import { Router, State } from 'router5';
 import { CancelFn } from 'router5/types/types/base';
 import { SetOptional } from 'type-fest';
@@ -21,6 +21,13 @@ export declare const MIN_HOIST_CORE_VERSION = "28.0";
  * Available via import as `XH` - also installed as `window.XH` for troubleshooting purposes.
  */
 export declare class XHApi {
+    /** Unique id for this loaded instance of the app.  Unique for every refresh of document. */
+    clientId: string;
+    /**
+     * Unique id for this browser tab/window on this domain.
+     * Corresponds to the scope of the built-in sessionStorage object.
+     */
+    sessionId: string;
     /** Core implementation model hosting all application state. */
     appContainerModel: AppContainerModel;
     /** Provider of centralized exception handling for the app. */
@@ -47,6 +54,7 @@ export declare class XHApi {
     alertBannerService: AlertBannerService;
     autoRefreshService: AutoRefreshService;
     changelogService: ChangelogService;
+    clientHealthService: ClientHealthService;
     configService: ConfigService;
     environmentService: EnvironmentService;
     fetchService: FetchService;
@@ -404,6 +412,8 @@ export declare class XHApi {
      */
     genId(): string;
     private get acm();
+    private genClientId;
+    private genSessionId;
 }
 /** The app-wide singleton instance. */
 export declare const XH: XHApi;

package/build/types/format/FormatDate.d.ts

@@ -1,5 +1,5 @@
 import { ReactNode } from 'react';
-import { DateLike } from '../core/types/Types';
+import { DateLike, PlainObject } from '../core/types/Types';
 import { FormatOptions } from './FormatMisc';
 export declare const DATE_FMT = "YYYY-MM-DD", DATETIME_FMT = "YYYY-MM-DD h:mma", DATETIMESEC_FMT = "YYYY-MM-DD h:mm:ssa", TIME_FMT = "h:mma", MONTH_DAY_FMT = "MMM D";
 /**
@@ -49,4 +49,25 @@ export interface CompactDateFormatOptions extends FormatOptions<DateLike> {
  * Render dates formatted based on distance in time from current day.
  */
 export declare function fmtCompactDate(v: DateLike, opts?: CompactDateFormatOptions): ReactNode;
+export interface TimestampReplacerConfig {
+    /**
+     * Suffixes used to identify keys that may hold timestamps.
+     * Defaults to ['time', 'date', 'timestamp']
+     */
+    suffixes?: string[];
+    /**
+     * Format for replaced timestamp.
+     * Defaults to 'MMM DD HH:mm:ss.SSS'
+     */
+    format?: string;
+}
+/**
+ * Replace timestamps in an Object with formatted strings.
+ */
+export declare function withFormattedTimestamps(obj: PlainObject, config?: TimestampReplacerConfig): PlainObject;
+/**
+ * Create a replacer, suitable for JSON.stringify, that will replace timestamps with
+ * formatted strings.
+ */
+export declare function timestampReplacer(config?: TimestampReplacerConfig): (k: string, v: any) => any;
 export declare const dateRenderer: (obj?: string | DateFormatOptions) => (v: DateLike) => ReactNode, dateTimeRenderer: (obj?: string | DateFormatOptions) => (v: any) => ReactNode, dateTimeSecRenderer: (obj?: string | DateFormatOptions) => (v: DateLike) => ReactNode, timeRenderer: (obj?: string | DateFormatOptions) => (v: DateLike) => ReactNode, compactDateRenderer: (obj?: CompactDateFormatOptions) => (v: DateLike) => ReactNode;

package/build/types/format/FormatMisc.d.ts

@@ -1,4 +1,5 @@
 import { CSSProperties, ReactNode } from 'react';
+import { PlainObject } from '@xh/hoist/core';
 export interface FormatOptions<T = any> {
     /** Display value for null values. */
     nullDisplay?: ReactNode;
@@ -32,9 +33,9 @@ export interface JSONFormatOptions {
     space?: number | string;
 }
 /**
- * Pretty-print a JSON string, adding line breaks and indentation.
+ * Pretty-print a JSON string or (JSON Object), adding line breaks and indentation.
  */
-export declare function fmtJson(str: string, opts?: JSONFormatOptions): string;
+export declare function fmtJson(v: string | PlainObject, opts?: JSONFormatOptions): string;
 /**
  * Basic util for splitting a string (via ' ') and capitalizing each word - e.g. for names.
  * Not intended to handle more advanced usages such as HTML or other word boundary characters.

package/build/types/security/Types.d.ts

@@ -19,8 +19,8 @@ export interface TelemetryResults {
 }
 /** Aggregated telemetry results for a single type of event. */
 export interface TelemetryEventResults {
-    firstTime: Date;
-    lastTime: Date;
+    firstTime: number;
+    lastTime: number;
     successCount: number;
     failureCount: number;
     /** Timing info (in ms) for event instances reported with duration. */
@@ -31,7 +31,7 @@ export interface TelemetryEventResults {
         worst: number;
     };
     lastFailure?: {
-        time: Date;
+        time: number;
         duration: number;
         code: string;
         name: string;

package/build/types/security/msal/MsalClient.d.ts

@@ -1,5 +1,6 @@
 import * as msal from '@azure/msal-browser';
 import { LogLevel } from '@azure/msal-browser';
+import { PlainObject } from '@xh/hoist/core';
 import { Token } from '@xh/hoist/security/Token';
 import { BaseOAuthClient, BaseOAuthClientConfig } from '../BaseOAuthClient';
 import { AccessTokenSpec, TelemetryResults, TokenMap } from '../Types';
@@ -96,6 +97,7 @@ export declare class MsalClient extends BaseOAuthClient<MsalClientConfig, MsalTo
     protected fetchIdTokenAsync(useCache?: boolean): Promise<Token>;
     protected fetchAccessTokenAsync(spec: MsalTokenSpec, useCache?: boolean): Promise<Token>;
     protected doLogoutAsync(): Promise<void>;
+    getFormattedTelemetry(): PlainObject;
     enableTelemetry(): void;
     disableTelemetry(): void;
     private loginSsoAsync;

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

@@ -0,0 +1,58 @@
+import { HoistService, PageState, PlainObject } from '@xh/hoist/core';
+/**
+ * Service for gathering data about client health.
+ *
+ * Hoist sends this data once on application load, and can be configured to send
+ * it at regularly scheduled intervals.  Configure via soft-config property
+ * 'xhActivityTracking.clientHealthReport'.
+ */
+export declare class ClientHealthService extends HoistService {
+    static instance: ClientHealthService;
+    private sources;
+    initAsync(): Promise<void>;
+    /**
+     * Main entry point.  Return a default report of client health.
+     */
+    getReport(): ClientHealthReport;
+    /** Get report, suitable for viewing in console. **/
+    getFormattedReport(): PlainObject;
+    /**
+     * Register a new source for client health report data. No-op if background health report is
+     * not generally enabled via `xhActivityTrackingConfig.clientHealthReport.intervalMins`.
+     *
+     * @param key - key under which to report the data - can be used to remove this source later.
+     * @param callback - function returning serializable to include with each report.
+     */
+    addSource(key: string, callback: () => any): void;
+    /** Unregister a previously-enabled source for client health report data. */
+    removeSource(key: string): void;
+    getGeneral(): GeneralData;
+    getConnection(): ConnectionData;
+    getMemory(): MemoryData;
+    getCustom(): PlainObject;
+    private sendReport;
+}
+export interface GeneralData {
+    startTime: number;
+    durationMins: number;
+    idleMins: number;
+    pageState: PageState;
+    webSocket: string;
+}
+export interface ConnectionData {
+    downlink: number;
+    effectiveType: string;
+    rtt: number;
+}
+export interface MemoryData {
+    modelCount: number;
+    usedPctLimit?: number;
+    jsHeapSizeLimit?: number;
+    totalJSHeapSize?: number;
+    usedJSHeapSize?: number;
+}
+export interface ClientHealthReport {
+    general: GeneralData;
+    connection: ConnectionData;
+    memory: MemoryData;
+}

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

@@ -6,7 +6,6 @@ import { HoistService, TrackOptions } from '@xh/hoist/core';
  */
 export declare class TrackService extends HoistService {
     static instance: TrackService;
-    private clientHealthReportSources;
     private oncePerSessionSent;
     private pending;
     initAsync(): Promise<void>;
@@ -14,21 +13,10 @@ export declare class TrackService extends HoistService {
     get enabled(): boolean;
     /** Track User Activity. */
     track(options: TrackOptions | string): void;
-    /**
-     * Register a new source for client health report data. No-op if background health report is
-     * not generally enabled via `xhActivityTrackingConfig.clientHealthReport.intervalMins`.
-     *
-     * @param key - key under which to report the data - can be used to remove this source later.
-     * @param callback - function returning serializable to include with each report.
-     */
-    addClientHealthReportSource(key: string, callback: () => any): void;
-    /** Unregister a previously-enabled source for client health report data. */
-    removeClientHealthReportSource(key: string): void;
     private pushPendingAsync;
     private pushPendingBuffered;
     private toServerJson;
     private logMessage;
-    private sendClientHealthReport;
 }
 interface ActivityTrackingConfig {
     clientHealthReport?: Partial<TrackOptions> & {

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

@@ -13,5 +13,6 @@ export * from './JsonBlobService';
 export * from './PrefService';
 export * from './TrackService';
 export * from './WebSocketService';
+export * from './ClientHealthService';
 export * from './storage/LocalStorageService';
 export * from './storage/SessionStorageService';

package/build/types/utils/js/index.d.ts

@@ -3,6 +3,5 @@ export * from './LangUtils';
 export * from './Decorators';
 export * from './LogUtils';
 export * from './DomUtils';
-export * from './BrowserUtils';
 export * from './TestUtils';
 export * from './VersionUtils';

package/cmp/viewmanager/ViewManagerModel.ts

@@ -123,6 +123,12 @@ export interface ViewManagerConfig {
      * Optional user-facing display name for describing global views. Defaults to 'global'
      */
     globalDisplayName?: string;
+
+    /**
+     * Optional key to pass a method that returns a customized BlueprintJS `menuItem` for listing
+     * views in the ViewManager menu.
+     */
+    viewMenuItemFn?: (view: ViewInfo, model: ViewManagerModel) => ReactNode;
 }
 
 /**
@@ -165,6 +171,7 @@ export class ViewManagerModel<T = PlainObject> extends HoistModel {
     readonly instance: string;
     readonly typeDisplayName: string;
     readonly globalDisplayName: string;
+    readonly viewMenuItemFn: (view: ViewInfo, model: ViewManagerModel) => ReactNode;
     readonly enableAutoSave: boolean;
     readonly enableDefault: boolean;
     readonly enableGlobal: boolean;
@@ -283,6 +290,7 @@ export class ViewManagerModel<T = PlainObject> extends HoistModel {
         instance = 'default',
         typeDisplayName,
         globalDisplayName = 'global',
+        viewMenuItemFn,
         manageGlobal = false,
         enableAutoSave = true,
         enableDefault = true,
@@ -296,13 +304,14 @@ export class ViewManagerModel<T = PlainObject> extends HoistModel {
 
         throwIf(
             !enableDefault && !initialViewSpec,
-            "ViewManagerModel requires 'initialViewSpec' if `enableDefault` is false."
+            "ViewManagerModel requires 'initialViewSpec' if 'enableDefault' is false."
         );
 
         this.type = type;
         this.instance = instance;
         this.typeDisplayName = lowerCase(typeDisplayName ?? genDisplayName(type));
         this.globalDisplayName = globalDisplayName;
+        this.viewMenuItemFn = viewMenuItemFn;
         this.manageGlobal = executeIfFunction(manageGlobal) ?? false;
         this.enableDefault = enableDefault;
         this.enableGlobal = enableGlobal;