@xh/hoist 72.2.0 → 72.4.0

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.
@@ -24,8 +23,13 @@ export class AppStateModel extends HoistModel {
     suspendData: AppSuspendData;
     accessDeniedMessage: string = 'Access Denied';
 
+    /**
+     * Timestamp when the app first started loading, prior to even JS download/eval.
+     * Read from timestamp set on window within index.html.
+     */
+    readonly loadStarted: number = window['_xhLoadTimestamp'];
+
     private timings: Record<AppState, number> = {} as Record<AppState, number>;
-    private loadStarted: number = window['_xhLoadTimestamp']; // set in index.html
     private lastStateChangeTime: number = this.loadStarted;
 
     constructor() {
@@ -88,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
                 })
         });
@@ -110,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/activity/tracking/ActivityTrackingModel.d.ts

@@ -26,7 +26,10 @@ export declare class ActivityTrackingModel extends HoistModel {
      */
     get queryDisplayString(): string;
     get endDay(): LocalDate;
-    get maxRowOptions(): any;
+    get maxRowOptions(): {
+        value: number;
+        label: string;
+    }[];
     get maxRows(): number;
     /** True if data loaded from the server has been topped by maxRows. */
     get maxRowsReached(): boolean;

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/instances/services/DetailsModel.d.ts

@@ -1,11 +1,10 @@
 import { HoistModel, LoadSpec, PlainObject } from '@xh/hoist/core';
-import { StoreRecord } from '@xh/hoist/data';
 import { ServiceModel } from './ServiceModel';
 export declare class DetailsModel extends HoistModel {
     parent: ServiceModel;
-    svcName: StoreRecord;
+    svcName: String;
     stats: PlainObject;
-    get selectedRecord(): StoreRecord;
+    get selectedRecord(): import("../../../../../data").StoreRecord;
     onLinked(): void;
     doLoadAsync(loadSpec: LoadSpec): Promise<void>;
 }

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

@@ -6,3 +6,4 @@ 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;

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

@@ -10,8 +10,12 @@ export declare class AppStateModel extends HoistModel {
     lastActivityMs: number;
     suspendData: AppSuspendData;
     accessDeniedMessage: string;
+    /**
+     * Timestamp when the app first started loading, prior to even JS download/eval.
+     * Read from timestamp set on window within index.html.
+     */
+    readonly loadStarted: number;
     private timings;
-    private loadStarted;
     private lastStateChangeTime;
     constructor();
     setAppState(nextState: AppState): void;
@@ -19,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/desktop/cmp/tab/TabSwitcher.d.ts

@@ -10,6 +10,6 @@ import '@xh/hoist/desktop/register';
  *
  * Overflowing tabs can be displayed in a dropdown menu if `enableOverflow` is true.
  * Note that in order for tabs to overflow, the TabSwitcher or it's wrapper must have a
- * a maximum width.
+ * maximum width.
  */
 export declare const TabSwitcher: import("react").FC<TabSwitcherProps>, tabSwitcher: import("@xh/hoist/core").ElementFactory<TabSwitcherProps>;

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/BaseOAuthClient.d.ts

@@ -40,14 +40,13 @@ export interface BaseOAuthClientConfig<S extends AccessTokenSpec> {
      */
     idScopes?: string[];
     /**
-     * Optional map of access tokens to be loaded and maintained.
+     * Optional spec for access tokens to be loaded and maintained to support access to one or more
+     * different back-end resources, distinct from the core Hoist auth flow via ID token.
      *
-     * Map of code to a spec for an access token.  The code is app-determined and
-     * will simply be used to get the loaded token via tha getAccessToken() method. The
-     * spec is implementation specific, but will typically include scopes to be loaded
-     * for the access token and potentially other meta-data required by the underlying provider.
-     *
-     * Use this map to gain targeted access tokens for different back-end resources.
+     * Map of key to a spec for an access token. The key is an arbitrary, app-determined string
+     * used to retrieve the loaded token via {@link getAccessTokenAsync}. The spec is implementation
+     * specific, but will typically include scopes to be loaded for the access token and potentially
+     * other metadata required by the underlying provider.
      */
     accessTokens?: Record<string, S>;
 }

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

@@ -1,12 +1,39 @@
 import { Token } from './Token';
-export type TokenMap = Record<string, Token>;
 export interface AccessTokenSpec {
     /**
-     * Mode governing when the access token should be requested from provider.
-     *      eager (default) - initiate lookup on initialization, but do not block on failure.
-     *      lazy - lookup when requested by client.
+     * Mode governing when the access token should be requested from provider:
+     *      - eager (or undefined) - load on overall initialization, but do not block on failure.
+     *        Useful for tokens that an app is almost certain to require during a user session.
+     *      - lazy - defer loading until first requested by client. Useful for tokens that might
+     *        never be needed by the app during a given user session.
      */
-    fetchMode: 'eager' | 'lazy';
+    fetchMode?: 'eager' | 'lazy';
     /** Scopes for the desired access token.*/
     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: number;
+    lastTime: number;
+    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: number;
+        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 { AccessTokenSpec, TokenMap } from '../Types';
 import { BaseOAuthClient, BaseOAuthClientConfig } from '../BaseOAuthClient';
+import { AccessTokenSpec, TelemetryResults, TokenMap } from '../Types';
 export interface MsalClientConfig extends BaseOAuthClientConfig<MsalTokenSpec> {
     /**
      * Authority for your organization's tenant: `https://login.microsoftonline.com/[tenantId]`.
@@ -16,6 +17,12 @@ export interface MsalClientConfig extends BaseOAuthClientConfig<MsalTokenSpec> {
      * The value of the domain hint is a registered domain for the tenant.
      */
     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
+     */
+    enableTelemetry?: boolean;
     /**
      * If specified, the client will use this value when initializing the app to enforce a minimum
      * amount of time during which no further auth flow with the provider should be necessary.
@@ -80,6 +87,9 @@ export declare class MsalClient extends BaseOAuthClient<MsalClientConfig, MsalTo
     private client;
     private account;
     private initialTokenLoad;
+    /** Enable telemetry via `enableTelemetry` ctor config, or via {@link enableTelemetry}. */
+    telemetryResults: TelemetryResults;
+    private _telemetryCbHandle;
     constructor(config: MsalClientConfig);
     protected doInitAsync(): Promise<TokenMap>;
     protected doLoginPopupAsync(): Promise<void>;
@@ -87,6 +97,9 @@ 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;
     private createClientAsync;
     private logFromMsal;

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

@@ -9,7 +9,7 @@ export declare class TrackService extends HoistService {
     private oncePerSessionSent;
     private pending;
     initAsync(): Promise<void>;
-    get conf(): any;
+    get conf(): ActivityTrackingConfig;
     get enabled(): boolean;
     /** Track User Activity. */
     track(options: TrackOptions | string): void;
@@ -18,3 +18,21 @@ export declare class TrackService extends HoistService {
     private toServerJson;
     private logMessage;
 }
+interface ActivityTrackingConfig {
+    clientHealthReport?: Partial<TrackOptions> & {
+        intervalMins: number;
+    };
+    enabled: boolean;
+    logData: boolean;
+    maxDataLength: number;
+    maxRows?: {
+        default: number;
+        options: number[];
+    };
+    levels?: Array<{
+        username: string | '*';
+        category: string | '*';
+        severity: 'DEBUG' | 'INFO' | 'WARN';
+    }>;
+}
+export {};

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. */
+    clientId: string = this.genClientId();
+
+    /**
+     * Unique id for this browser tab/window on this domain.
+     * Corresponds to the scope of the built-in sessionStorage object.
+     */
+    sessionId: string = this.genSessionId();
+
     //--------------------------
     // 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 genClientId(): string {
+        return new ShortUniqueId({length: 8}).rnd();
+    }
+
+    private genSessionId(): string {
+        let ret = window.sessionStorage?.getItem('xhSessionId');
+        if (!ret) {
+            ret = new ShortUniqueId({length: 8}).rnd();
+            window.sessionStorage?.setItem('xhSessionId', ret);
+        }
+        return ret;
+    }
 }
 
 /** The app-wide singleton instance. */

package/data/Store.ts

@@ -18,6 +18,7 @@ import {
     isEmpty,
     isFunction,
     isNil,
+    isNull,
     isString,
     values,
     remove as lodashRemove,
@@ -692,6 +693,8 @@ export class Store extends HoistBase {
      * for backwards compat with app code predating support for multiple {@link summaryRecords}.
      */
     get summaryRecord(): StoreRecord {
+        if (isNull(this.summaryRecords)) return null;
+
         throwIf(
             this.summaryRecords.length > 1,
             'Store has multiple summary records - must access via Store.summaryRecords.'