@xh/hoist 72.3.0 → 72.5.0

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. */
+    loadId: string;
+    /**
+     * Unique id for this browser tab/window on this domain.
+     * Corresponds to the scope of the built-in sessionStorage object.
+     */
+    tabId: 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 genLoadId;
+    private genTabId;
 }
 /** The app-wide singleton instance. */
 export declare const XH: XHApi;

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

@@ -1,5 +1,5 @@
 import { RuleLike } from '@xh/hoist/data';
-import { ReactElement, ReactNode } from 'react';
+import { MouseEvent, ReactElement, ReactNode } from 'react';
 import { LoadSpec } from '../load';
 import { Intent, PlainObject, Thunkable } from './Types';
 /**
@@ -226,7 +226,7 @@ export interface MenuItem {
     /** Css class name to be added when rendering the menu item. */
     className?: string;
     /** Executed when the user clicks the menu item. */
-    actionFn?: () => void;
+    actionFn?: (e: MouseEvent | PointerEvent) => void;
     /** Executed before the item is shown.  Use to adjust properties dynamically. */
     prepareFn?: (me: MenuItem) => void;
     /** Child menu items. */

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

@@ -12,28 +12,3 @@ export interface AccessTokenSpec {
     scopes: string[];
 }
 export type TokenMap = Record<string, Token>;
-/** Aggregated telemetry results, produced by {@link MsalClient} when enabled via config. */
-export interface TelemetryResults {
-    /** Stats by event type - */
-    events: Record<string, TelemetryEventResults>;
-}
-/** Aggregated telemetry results for a single type of event. */
-export interface TelemetryEventResults {
-    firstTime: Date;
-    lastTime: Date;
-    successCount: number;
-    failureCount: number;
-    /** Timing info (in ms) for event instances reported with duration. */
-    duration: {
-        count: number;
-        total: number;
-        average: number;
-        worst: number;
-    };
-    lastFailure?: {
-        time: Date;
-        duration: number;
-        code: string;
-        name: string;
-    };
-}

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

@@ -1,8 +1,9 @@
 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';
+import { AccessTokenSpec, TokenMap } from '../Types';
 export interface MsalClientConfig extends BaseOAuthClientConfig<MsalTokenSpec> {
     /**
      * Authority for your organization's tenant: `https://login.microsoftonline.com/[tenantId]`.
@@ -18,8 +19,7 @@ export interface MsalClientConfig extends BaseOAuthClientConfig<MsalTokenSpec> {
     domainHint?: string;
     /**
      * True to enable support for built-in telemetry provided by this class's internal MSAL client.
-     * Captured performance events will be summarized via {@link telemetryResults}.
-     * See https://github.com/AzureAD/microsoft-authentication-library-for-js/blob/dev/lib/msal-browser/docs/performance.md
+     * Captured performance events will be summarized as {@link MsalClientTelemetry}.
      */
     enableTelemetry?: boolean;
     /**
@@ -87,7 +87,7 @@ export declare class MsalClient extends BaseOAuthClient<MsalClientConfig, MsalTo
     private account;
     private initialTokenLoad;
     /** Enable telemetry via `enableTelemetry` ctor config, or via {@link enableTelemetry}. */
-    telemetryResults: TelemetryResults;
+    telemetry: MsalClientTelemetry;
     private _telemetryCbHandle;
     constructor(config: MsalClientConfig);
     protected doInitAsync(): Promise<TokenMap>;
@@ -96,6 +96,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;
@@ -106,3 +107,40 @@ export declare class MsalClient extends BaseOAuthClient<MsalClientConfig, MsalTo
     private get refreshOffsetArgs();
     private noteUserAuthenticated;
 }
+/**
+ * Telemetry produced by this client (if enabled) + included in {@link ClientHealthService}
+ * reporting. Leverages MSAL's opt-in support for emitting performance events.
+ * See https://github.com/AzureAD/microsoft-authentication-library-for-js/blob/dev/lib/msal-browser/docs/performance.md
+ */
+interface MsalClientTelemetry {
+    /** Stats across all events */
+    summary: {
+        successCount: number;
+        failureCount: number;
+        maxDuration: number;
+        lastFailureTime: number;
+    };
+    /** Stats by event type */
+    events: Record<string, MsalEventTelemetry>;
+}
+/** Aggregated telemetry results for a single type of event. */
+interface MsalEventTelemetry {
+    firstTime: number;
+    lastTime: number;
+    successCount: number;
+    failureCount: number;
+    /** Timing info (in ms) for event instances reported with duration. */
+    duration?: {
+        count: number;
+        total: number;
+        average: number;
+        max: number;
+    };
+    lastFailure?: {
+        time: number;
+        duration: number;
+        code: string;
+        name: string;
+    };
+}
+export {};

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

@@ -0,0 +1,64 @@
+import { HoistService, PageState, PlainObject } from '@xh/hoist/core';
+import { WebSocketTelemetry } from '@xh/hoist/svc/WebSocketService';
+/**
+ * Service for gathering data about the current state and health of the client app, for submission
+ * to the server or review on the console during interactive troubleshooting.
+ *
+ * Hoist sends this data once on application load and can be configured to send at regular intervals
+ * throughout a user's session via the `xhActivityTracking.clientHealthReport` app config. Reports
+ * are submitted via activity tracking for review within the Admin Console.
+ */
+export declare class ClientHealthService extends HoistService {
+    static instance: ClientHealthService;
+    private sources;
+    initAsync(): Promise<void>;
+    get enabled(): boolean;
+    /** @returns a customizable report with metrics capturing client app/session state. */
+    getReport(): ClientHealthReport;
+    /** @returns a report, formatted for easier viewing in console. **/
+    getFormattedReport(): PlainObject;
+    /**
+     * Register a new source for app-specific data to be sent with each report.
+     * @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;
+    /**
+     * Generate and submit a report to the server, via TrackService.
+     *
+     * For ad-hoc troubleshooting. Apps may also configure this service to
+     * submit on regular intervals.
+     */
+    sendReportAsync(): Promise<void>;
+    getGeneral(): GeneralData;
+    getConnection(): ConnectionData;
+    getMemory(): MemoryData;
+    getCustom(): PlainObject;
+    private sendReportInternal;
+}
+export interface GeneralData {
+    startTime: number;
+    durationMins: number;
+    idleMins: number;
+    pageState: PageState;
+}
+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;
+    webSockets: WebSocketTelemetry;
+}

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>;
@@ -15,20 +14,13 @@ export declare class TrackService extends HoistService {
     /** 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.
+     * Flush the queue of pending activity tracking messages to the server.
+     * @internal - apps should generally allow this service to manage w/its internal debounce.
      */
-    addClientHealthReportSource(key: string, callback: () => any): void;
-    /** Unregister a previously-enabled source for client health report data. */
-    removeClientHealthReportSource(key: string): void;
-    private pushPendingAsync;
+    pushPendingAsync(): Promise<void>;
     private pushPendingBuffered;
     private toServerJson;
     private logMessage;
-    private sendClientHealthReport;
 }
 interface ActivityTrackingConfig {
     clientHealthReport?: Partial<TrackOptions> & {

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

@@ -1,4 +1,4 @@
-import { HoistService } from '@xh/hoist/core';
+import { HoistService, PlainObject } from '@xh/hoist/core';
 /**
  * Establishes and maintains a websocket connection to the Hoist server, if enabled via `AppSpec`.
  *
@@ -27,6 +27,10 @@ export declare class WebSocketService extends HoistService {
     readonly HEARTBEAT_TOPIC = "xhHeartbeat";
     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. */
     channelKey: string;
     /** Last time a message was received, including heartbeat messages. */
@@ -35,10 +39,10 @@ export declare class WebSocketService extends HoistService {
     get connected(): boolean;
     /** Set to true to log all sent/received messages - very chatty. */
     logMessages: boolean;
+    telemetry: WebSocketTelemetry;
     private _timer;
     private _socket;
     private _subsByTopic;
-    enabled: boolean;
     constructor();
     initAsync(): Promise<void>;
     /**
@@ -61,23 +65,24 @@ export declare class WebSocketService extends HoistService {
      * Send a message back to the server via the connected websocket.
      */
     sendMessage(message: WebSocketMessage): void;
-    connect(): void;
-    disconnect(): void;
-    heartbeatOrReconnect(): void;
-    private onServerInstanceChange;
     shutdown(): void;
+    getFormattedTelemetry(): PlainObject;
+    private connect;
+    private disconnect;
+    private heartbeatOrReconnect;
+    private onServerInstanceChange;
     onOpen(ev: any): void;
     onClose(ev: any): void;
     onError(ev: any): void;
-    onMessage(rawMsg: any): void;
-    notifySubscribers(message: any): void;
-    getSubsForTopic(topic: any): WebSocketSubscription[];
-    updateConnectedStatus(): void;
-    installChannelKey(key: any): void;
-    updateLastMessageTime(): void;
-    buildWebSocketUrl(): string;
-    showTestMessageAlert(message: any): void;
-    maybeLogMessage(...args: any[]): void;
+    onMessage(rawMsg: MessageEvent): void;
+    private notifySubscribers;
+    private getSubsForTopic;
+    private updateConnectedStatus;
+    private installChannelKey;
+    private updateLastMessageTime;
+    private buildWebSocketUrl;
+    private maybeLogMessage;
+    private noteTelemetryEvent;
 }
 /**
  * Wrapper class to encapsulate and manage a subscription to messages for a given topic + handler.
@@ -93,3 +98,21 @@ export interface WebSocketMessage {
     topic: string;
     data?: any;
 }
+/** Telemetry collected by this service + included in {@link ClientHealthService} reporting. */
+export interface WebSocketTelemetry {
+    channelKey: string;
+    subscriptionCount: number;
+    events: {
+        connOpened?: WebSocketEventTelemetry;
+        connClosed?: WebSocketEventTelemetry;
+        connError?: WebSocketEventTelemetry;
+        msgReceived?: WebSocketEventTelemetry;
+        msgSent?: WebSocketEventTelemetry;
+        heartbeatReconnectAttempt?: WebSocketEventTelemetry;
+        instanceChangeReconnectAttempt?: WebSocketEventTelemetry;
+    };
+}
+export interface WebSocketEventTelemetry {
+    count: number;
+    lastTime: number;
+}

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;

package/core/XH.ts

@@ -28,7 +28,8 @@ import {
     PrefService,
     SessionStorageService,
     TrackService,
-    WebSocketService
+    WebSocketService,
+    ClientHealthService
 } from '@xh/hoist/svc';
 import {camelCase, flatten, isString, uniqueId} from 'lodash';
 import {Router, State} from 'router5';
@@ -64,6 +65,7 @@ import {
 import {installServicesAsync} from './impl/InstallServices';
 import {instanceManager} from './impl/InstanceManager';
 import {HoistModel, ModelSelector, RefreshContextModel} from './model';
+import ShortUniqueId from 'short-unique-id';
 
 export const MIN_HOIST_CORE_VERSION = '28.0';
 
@@ -84,6 +86,15 @@ declare const xhIsDevelopmentMode: boolean;
  * Available via import as `XH` - also installed as `window.XH` for troubleshooting purposes.
  */
 export class XHApi {
+    /** Unique id for this loaded instance of the app.  Unique for every refresh of document. */
+    loadId: string = this.genLoadId();
+
+    /**
+     * Unique id for this browser tab/window on this domain.
+     * Corresponds to the scope of the built-in sessionStorage object.
+     */
+    tabId: string = this.genTabId();
+
     //--------------------------
     // Implementation Delegates
     //--------------------------
@@ -131,6 +142,7 @@ export class XHApi {
     alertBannerService: AlertBannerService;
     autoRefreshService: AutoRefreshService;
     changelogService: ChangelogService;
+    clientHealthService: ClientHealthService;
     configService: ConfigService;
     environmentService: EnvironmentService;
     fetchService: FetchService;
@@ -794,6 +806,19 @@ export class XHApi {
     private get acm(): AppContainerModel {
         return this.appContainerModel;
     }
+
+    private genLoadId(): string {
+        return new ShortUniqueId({length: 8}).rnd();
+    }
+
+    private genTabId(): string {
+        let ret = window.sessionStorage?.getItem('xhTabId');
+        if (!ret) {
+            ret = new ShortUniqueId({length: 8}).rnd();
+            window.sessionStorage?.setItem('xhTabId', ret);
+        }
+        return ret;
+    }
 }
 
 /** The app-wide singleton instance. */

package/core/types/Interfaces.ts

@@ -6,7 +6,7 @@
  */
 
 import {RuleLike} from '@xh/hoist/data';
-import {ReactElement, ReactNode} from 'react';
+import {MouseEvent, ReactElement, ReactNode} from 'react';
 import {LoadSpec} from '../load';
 import {Intent, PlainObject, Thunkable} from './Types';
 
@@ -284,7 +284,7 @@ export interface MenuItem {
     className?: string;
 
     /** Executed when the user clicks the menu item. */
-    actionFn?: () => void;
+    actionFn?: (e: MouseEvent | PointerEvent) => void;
 
     /** Executed before the item is shown.  Use to adjust properties dynamically. */
     prepareFn?: (me: MenuItem) => void;

package/data/filter/BaseFilterFieldSpec.ts

@@ -6,7 +6,7 @@
  */
 import {HoistBase} from '@xh/hoist/core';
 import {Field, Store, FieldFilter, FieldType, genDisplayName, View} from '@xh/hoist/data';
-import {isEmpty} from 'lodash';
+import {compact, isArray, isEmpty} from 'lodash';
 import {FieldFilterOperator} from './Types';
 
 export interface BaseFilterFieldSpecConfig {
@@ -72,7 +72,11 @@ export abstract class BaseFilterFieldSpec extends HoistBase {
         this.displayName = displayName ?? sourceField?.displayName ?? genDisplayName(field);
         this.ops = this.parseOperators(ops);
         this.forceSelection = forceSelection ?? false;
-        this.values = values ?? (this.isBoolFieldType ? [true, false] : null);
+        this.values = isArray(values)
+            ? compact(values)
+            : this.isBoolFieldType
+              ? [true, false]
+              : null;
         this.hasExplicitValues = !isEmpty(this.values);
         this.enableValues = this.hasExplicitValues || (enableValues ?? this.isEnumerableByDefault);
     }

package/desktop/appcontainer/AboutDialog.ts

@@ -42,10 +42,24 @@ export const aboutDialog = hoistCmp.factory({
                     item: model.getTable()
                 }),
                 toolbar(
+                    button({
+                        text: 'Send Client Health Report',
+                        icon: Icon.health(),
+                        omit: !XH.clientHealthService.enabled,
+                        onClick: async () => {
+                            try {
+                                await XH.clientHealthService.sendReportAsync();
+                                XH.successToast('Client health report successfully submitted.');
+                            } catch (e) {
+                                XH.handleException('Error sending client health report', e);
+                            }
+                        }
+                    }),
                     filler(),
                     button({
                         text: 'Close',
                         intent: 'primary',
+                        outlined: true,
                         onClick: onClose
                     })
                 )

package/desktop/cmp/button/AppMenuButton.ts

@@ -202,7 +202,7 @@ function parseMenuItems(items: MenuItemLike[]): ReactNode[] {
                 icon: item.icon,
                 intent: item.intent,
                 className: item.className,
-                onClick: actionFn ? () => wait().then(actionFn) : null, // do async to allow menu to close
+                onClick: actionFn ? e => wait().then(() => actionFn(e)) : null, // do async to allow menu to close
                 disabled: item.disabled
             };
 

package/desktop/cmp/contextmenu/ContextMenu.ts

@@ -70,7 +70,7 @@ function parseItems(items: MenuItemLike[]): ReactNode[] {
                 icon: item.icon,
                 intent: item.intent,
                 className: item.className,
-                onClick: item.actionFn ? () => wait().then(item.actionFn) : null, // do async to allow menu to close
+                onClick: item.actionFn ? e => wait().then(() => item.actionFn(e)) : null, // do async to allow menu to close
                 popoverProps: {usePortal: true},
                 disabled: item.disabled,
                 items