@xh/hoist 72.0.0-SNAPSHOT.1737472364423 → 72.0.0-SNAPSHOT.1737670838944

package/admin/columns/Tracking.ts

@@ -37,6 +37,16 @@ export const browser: ColumnSpec = {
     width: 100
 };
 
+export const severity: ColumnSpec = {
+    field: {
+        name: 'severity',
+        type: 'string',
+        isDimension: true,
+        aggregator: 'UNIQUE'
+    },
+    width: 80
+};
+
 export const category: ColumnSpec = {
     field: {
         name: 'category',

package/admin/tabs/activity/tracking/ActivityTrackingModel.ts

@@ -87,6 +87,7 @@ export class ActivityTrackingModel extends HoistModel {
             fields: [
                 Col.browser.field,
                 Col.category.field,
+                Col.severity.field,
                 Col.correlationId.field,
                 Col.data.field,
                 {...(Col.dateCreated.field as FieldSpec), displayName: 'Timestamp'},
@@ -131,6 +132,7 @@ export class ActivityTrackingModel extends HoistModel {
                 {field: 'userAgent'},
                 {field: 'url', displayName: 'URL'},
                 {field: 'instance'},
+                {field: 'severity'},
                 {field: 'appVersion'},
                 {field: 'appEnvironment', displayName: 'Environment'}
             ]

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

@@ -58,6 +58,7 @@ export class ActivityDetailModel extends HoistModel {
                 {...Col.url},
                 {...Col.correlationId},
                 {...Col.instance, hidden},
+                {...Col.severity, hidden},
                 {...Col.elapsed},
                 {...Col.dateCreatedWithSec, displayName: 'Timestamp'}
             ]

package/admin/tabs/userData/jsonblob/JsonBlobPanel.ts

@@ -5,9 +5,13 @@
  * Copyright © 2025 Extremely Heavy Industries Inc.
  */
 
-import {fragment} from '@xh/hoist/cmp/layout';
+import * as Col from '@xh/hoist/admin/columns/Rest';
+import * as AdminCol from '@xh/hoist/admin/columns';
+import {hframe} from '@xh/hoist/cmp/layout';
 import {creates, hoistCmp} from '@xh/hoist/core';
 import {button} from '@xh/hoist/desktop/cmp/button';
+import {jsonSearchPanel} from '@xh/hoist/desktop/cmp/jsonsearch/JsonSearchPanel';
+import {panel} from '@xh/hoist/desktop/cmp/panel';
 import {restGrid} from '@xh/hoist/desktop/cmp/rest';
 import {Icon} from '@xh/hoist/icon';
 import {differ} from '../../../differ/Differ';
@@ -17,14 +21,48 @@ export const jsonBlobPanel = hoistCmp.factory({
     model: creates(JsonBlobModel),
 
     render({model}) {
-        return fragment(
-            restGrid({
-                extraToolbarItems: () => {
-                    return button({
-                        icon: Icon.diff(),
-                        text: 'Compare w/ Remote',
-                        onClick: () => model.openDiffer()
-                    });
+        return hframe(
+            panel({
+                item: restGrid({
+                    extraToolbarItems: () => {
+                        return button({
+                            icon: Icon.diff(),
+                            text: 'Compare w/ Remote',
+                            onClick: () => model.openDiffer()
+                        });
+                    }
+                })
+            }),
+            jsonSearchPanel({
+                docSearchUrl: 'jsonBlobSearchAdmin/searchByJsonPath',
+                matchingNodesUrl: 'jsonBlobSearchAdmin/getMatchingNodes',
+                gridModelConfig: {
+                    sortBy: ['owner', 'name'],
+                    store: {
+                        idSpec: 'token'
+                    },
+                    groupBy: 'type',
+                    columns: [
+                        {
+                            field: {name: 'token', type: 'string'},
+                            hidden: true,
+                            width: 100
+                        },
+                        {
+                            field: {name: 'type', type: 'string'},
+                            width: 200
+                        },
+                        {
+                            field: {name: 'owner', type: 'string'},
+                            width: 200
+                        },
+                        {...Col.lastUpdated},
+                        {
+                            field: {name: 'json', type: 'string'},
+                            hidden: true
+                        },
+                        {...AdminCol.name}
+                    ]
                 }
             }),
             differ({omit: !model.differModel})

package/admin/tabs/userData/prefs/UserPreferencePanel.ts

@@ -4,10 +4,14 @@
  *
  * Copyright © 2025 Extremely Heavy Industries Inc.
  */
+import * as Col from '@xh/hoist/admin/columns/Rest';
+import * as AdminCol from '@xh/hoist/admin/columns';
 import {prefEditorDialog} from '@xh/hoist/admin/tabs/userData/prefs/editor/PrefEditorDialog';
 import {UserPreferenceModel} from '@xh/hoist/admin/tabs/userData/prefs/UserPreferenceModel';
+import {hframe} from '@xh/hoist/cmp/layout';
 import {creates, hoistCmp} from '@xh/hoist/core';
 import {button} from '@xh/hoist/desktop/cmp/button';
+import {jsonSearchPanel} from '@xh/hoist/desktop/cmp/jsonsearch/JsonSearchPanel';
 import {panel} from '@xh/hoist/desktop/cmp/panel';
 import {restGrid} from '@xh/hoist/desktop/cmp/rest';
 import {Icon} from '@xh/hoist/icon';
@@ -16,20 +20,47 @@ export const userPreferencePanel = hoistCmp.factory({
     model: creates(UserPreferenceModel),
 
     render({model}) {
-        return panel({
-            items: [
-                restGrid({
-                    extraToolbarItems: () => {
-                        return button({
-                            icon: Icon.gear(),
-                            text: 'Configure',
-                            onClick: () => (model.showEditorDialog = true)
-                        });
-                    }
-                }),
-                prefEditorDialog()
-            ],
-            mask: 'onLoad'
-        });
+        return hframe(
+            panel({
+                items: [
+                    restGrid({
+                        extraToolbarItems: () => {
+                            return button({
+                                icon: Icon.gear(),
+                                text: 'Configure',
+                                onClick: () => (model.showEditorDialog = true)
+                            });
+                        }
+                    }),
+                    prefEditorDialog()
+                ],
+                mask: 'onLoad'
+            }),
+            jsonSearchPanel({
+                docSearchUrl: 'preferenceJsonSearchAdmin/searchByJsonPath',
+                matchingNodesUrl: 'preferenceJsonSearchAdmin/getMatchingNodes',
+                gridModelConfig: {
+                    sortBy: ['name'],
+                    groupBy: 'groupName',
+                    columns: [
+                        {
+                            field: {name: 'type', type: 'string'},
+                            width: 200
+                        },
+                        {
+                            field: {name: 'owner', type: 'string'},
+                            width: 200
+                        },
+                        {...Col.lastUpdated},
+                        {
+                            field: {name: 'json', type: 'string'},
+                            hidden: true
+                        },
+                        {...AdminCol.name},
+                        {...AdminCol.groupName}
+                    ]
+                }
+            })
+        );
     }
 });

package/build/types/admin/columns/Tracking.d.ts

@@ -2,6 +2,7 @@ import { ColumnSpec } from '@xh/hoist/cmp/grid/columns';
 export declare const appEnvironment: ColumnSpec;
 export declare const appVersion: ColumnSpec;
 export declare const browser: ColumnSpec;
+export declare const severity: ColumnSpec;
 export declare const category: ColumnSpec;
 export declare const data: ColumnSpec;
 export declare const day: ColumnSpec;

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

@@ -153,6 +153,10 @@ export interface AppOptionSpec {
     /** Optional flag to omit displaying option. */
     omit?: Thunkable<boolean>;
 }
+/**
+ * Severity levels for tracking.  Default is 'INFO'.
+ */
+export type TrackSeverity = 'DEBUG' | 'INFO' | 'WARN';
 /**
  * Options for tracking activity on the server via TrackService.
  */
@@ -174,11 +178,16 @@ export interface TrackOptions {
      */
     logData?: boolean | string[];
     /**
-     * Flag to indicate relative importance of activity.
-     * Default 'INFO'. Note, errors should be tracked via {@link XH.handleException}, which
+     * Flag to indicate relative importance of activity. Default 'INFO'.
+     *
+     * Allows conditional saving of messages depending on the currently active
+     * level configuration for the category/user.  See HoistCore's 'TrackService' for
+     * more information.
+     *
+     * Note, errors should be tracked via {@link XH.handleException}, which
      * will post to the server for dedicated logging if requested.
      */
-    severity?: string;
+    severity?: TrackSeverity;
     /**
      * Set to true to log this message only once during the current session. The category and
      * message text will be used as a compound key to identify repeated messages.

package/build/types/desktop/cmp/jsonsearch/JsonSearchPanel.d.ts

@@ -0,0 +1,3 @@
+/// <reference types="react" />
+import { JsonBlobModel } from '@xh/hoist/admin/tabs/userData/jsonblob/JsonBlobModel';
+export declare const JsonSearchPanel: import("react").FC<import("@xh/hoist/core").DefaultHoistProps<JsonBlobModel>>, jsonSearchPanel: import("@xh/hoist/core").ElementFactory<import("@xh/hoist/core").DefaultHoistProps<JsonBlobModel>>;

package/build/types/desktop/cmp/jsonsearch/impl/JsonSearchPanelImplModel.d.ts

@@ -0,0 +1,27 @@
+import { GridModel } from '@xh/hoist/cmp/grid';
+import { HoistModel, TaskObserver } from '@xh/hoist/core';
+/**
+ * @internal
+ */
+export declare class JsonSearchPanelImplModel extends HoistModel {
+    xhImpl: boolean;
+    gridModel: GridModel;
+    docLoadTask: TaskObserver;
+    nodeLoadTask: TaskObserver;
+    error: any;
+    path: string;
+    pathOrValue: 'path' | 'value';
+    pathFormat: 'XPath' | 'JSONPath';
+    matchingNodes: string;
+    matchingNodeCount: number;
+    get asPathList(): boolean;
+    get queryBuffer(): number;
+    get docSearchUrl(): string;
+    get matchingNodesUrl(): string;
+    get gridModelConfig(): any;
+    constructor();
+    onLinked(): void;
+    loadJsonDocsAsync(): Promise<void>;
+    private loadJsonNodesAsync;
+    private convertToPath;
+}

package/core/types/Interfaces.ts

@@ -193,6 +193,11 @@ export interface AppOptionSpec {
     omit?: Thunkable<boolean>;
 }
 
+/**
+ * Severity levels for tracking.  Default is 'INFO'.
+ */
+export type TrackSeverity = 'DEBUG' | 'INFO' | 'WARN';
+
 /**
  * Options for tracking activity on the server via TrackService.
  */
@@ -219,11 +224,16 @@ export interface TrackOptions {
     logData?: boolean | string[];
 
     /**
-     * Flag to indicate relative importance of activity.
-     * Default 'INFO'. Note, errors should be tracked via {@link XH.handleException}, which
+     * Flag to indicate relative importance of activity. Default 'INFO'.
+     *
+     * Allows conditional saving of messages depending on the currently active
+     * level configuration for the category/user.  See HoistCore's 'TrackService' for
+     * more information.
+     *
+     * Note, errors should be tracked via {@link XH.handleException}, which
      * will post to the server for dedicated logging if requested.
      */
-    severity?: string;
+    severity?: TrackSeverity;
 
     /**
      * Set to true to log this message only once during the current session. The category and

package/desktop/cmp/jsonsearch/JsonSearchPanel.ts

@@ -0,0 +1,209 @@
+/*
+ * This file belongs to Hoist, an application development toolkit
+ * developed by Extremely Heavy Industries (www.xh.io | info@xh.io)
+ *
+ * Copyright © 2025 Extremely Heavy Industries Inc.
+ */
+
+import {toolbar, toolbarSep} from '@xh/hoist/desktop/cmp/toolbar';
+import {errorMessage} from '@xh/hoist/cmp/error';
+import {JsonBlobModel} from '@xh/hoist/admin/tabs/userData/jsonblob/JsonBlobModel';
+import {grid, gridCountLabel} from '@xh/hoist/cmp/grid';
+import {a, box, filler, h4, hframe, label, li, span, ul, vbox} from '@xh/hoist/cmp/layout';
+import {hoistCmp, useLocalModel} from '@xh/hoist/core';
+import {button} from '@xh/hoist/desktop/cmp/button';
+import {buttonGroupInput, jsonInput, textInput} from '@xh/hoist/desktop/cmp/input';
+import {panel} from '@xh/hoist/desktop/cmp/panel';
+import {Icon} from '@xh/hoist/icon';
+import {popover} from '@xh/hoist/kit/blueprint';
+import {clipboardButton} from '@xh/hoist/desktop/cmp/clipboard';
+import {startCase} from 'lodash';
+
+import {JsonSearchPanelImplModel} from './impl/JsonSearchPanelImplModel';
+
+export const [JsonSearchPanel, jsonSearchPanel] = hoistCmp.withFactory<JsonBlobModel>({
+    render() {
+        const impl = useLocalModel(JsonSearchPanelImplModel),
+            {error} = impl;
+
+        return panel({
+            title: 'JSON Path Search',
+            icon: Icon.json(),
+            modelConfig: {
+                side: 'right',
+                defaultSize: '75%',
+                collapsible: true,
+                defaultCollapsed: true
+            },
+            compactHeader: true,
+            tbar: searchTbar({model: impl}),
+            flex: 1,
+            item: panel({
+                mask: impl.docLoadTask,
+                items: [
+                    errorMessage({
+                        error,
+                        title: error?.name ? startCase(error.name) : undefined
+                    }),
+                    hframe({
+                        omit: impl.error,
+                        items: [
+                            panel({
+                                item: grid({model: impl.gridModel})
+                            }),
+                            panel({
+                                mask: impl.nodeLoadTask,
+                                tbar: nodeTbar({model: impl}),
+                                bbar: nodeBbar({
+                                    omit: !impl.asPathList,
+                                    model: impl
+                                }),
+                                item: jsonInput({
+                                    model: impl,
+                                    bind: 'matchingNodes',
+                                    flex: 1,
+                                    width: '100%',
+                                    readonly: true,
+                                    showCopyButton: true
+                                })
+                            })
+                        ]
+                    })
+                ]
+            })
+        });
+    }
+});
+
+const searchTbar = hoistCmp.factory<JsonSearchPanelImplModel>(({model}) => {
+    return toolbar(
+        pathField({model}),
+        helpButton(),
+        toolbarSep(),
+        gridCountLabel({
+            gridModel: model.gridModel,
+            unit: 'document'
+        })
+    );
+});
+
+const pathField = hoistCmp.factory<JsonSearchPanelImplModel>({
+    render({model}) {
+        return textInput({
+            bind: 'path',
+            autoFocus: true,
+            commitOnChange: true,
+            leftIcon: Icon.search(),
+            enableClear: true,
+            placeholder:
+                "JSON Path - e.g. $..[?(@.colId == 'trader')] - type a path and hit ENTER to search",
+            width: null,
+            flex: 1,
+            onKeyDown: e => {
+                if (e.key === 'Enter') model.loadJsonDocsAsync();
+            }
+        });
+    }
+});
+
+const helpButton = hoistCmp.factory({
+    model: false,
+    render() {
+        return popover({
+            item: button({
+                icon: Icon.questionCircle(),
+                outlined: true
+            }),
+            content: vbox({
+                style: {
+                    padding: '0px 20px 10px 20px'
+                },
+                items: [
+                    h4('Sample Queries'),
+                    ul({
+                        style: {listStyleType: 'none'},
+                        items: [
+                            {
+                                query: "$..[?(@.colId == 'trader')]",
+                                explanation:
+                                    'Find all nodes with a property "colId" equal to "trader"'
+                            }
+                        ].map(({query, explanation}) =>
+                            li({
+                                key: query,
+                                items: [
+                                    span({
+                                        className: 'xh-bg-alt xh-gray-dark xh-font-family-mono',
+                                        item: query
+                                    }),
+                                    ' ',
+                                    clipboardButton({
+                                        text: null,
+                                        icon: Icon.copy(),
+                                        getCopyText: () => query,
+                                        successMessage: 'Query copied to clipboard.'
+                                    }),
+                                    ' ',
+                                    explanation
+                                ]
+                            })
+                        )
+                    }),
+                    a({
+                        href: 'https://github.com/json-path/JsonPath?tab=readme-ov-file#operators',
+                        target: '_blank',
+                        item: 'Path Syntax Docs & More Examples'
+                    })
+                ]
+            })
+        });
+    }
+});
+
+const nodeTbar = hoistCmp.factory<JsonSearchPanelImplModel>(({model}) => {
+    return toolbar(
+        buttonGroupInput({
+            model,
+            bind: 'pathOrValue',
+            minimal: true,
+            outlined: true,
+            items: [
+                button({
+                    text: 'Path',
+                    value: 'path'
+                }),
+                button({
+                    text: 'Value',
+                    value: 'value'
+                })
+            ]
+        }),
+        filler(),
+        box({
+            omit: !model.matchingNodeCount,
+            item: `${model.matchingNodeCount} ${model.matchingNodeCount === 1 ? 'match' : 'matches'}`
+        })
+    );
+});
+
+const nodeBbar = hoistCmp.factory<JsonSearchPanelImplModel>(({model}) => {
+    return toolbar(
+        label('Path Format:'),
+        buttonGroupInput({
+            model,
+            bind: 'pathFormat',
+            minimal: true,
+            outlined: true,
+            items: [
+                button({
+                    text: 'XPath',
+                    value: 'XPath'
+                }),
+                button({
+                    text: 'JSONPath',
+                    value: 'JSONPath'
+                })
+            ]
+        })
+    );
+});

package/desktop/cmp/jsonsearch/impl/JsonSearchPanelImplModel.ts

@@ -0,0 +1,130 @@
+/*
+ * This file belongs to Hoist, an application development toolkit
+ * developed by Extremely Heavy Industries (www.xh.io | info@xh.io)
+ *
+ * Copyright © 2025 Extremely Heavy Industries Inc.
+ */
+
+import {GridModel} from '@xh/hoist/cmp/grid';
+import {HoistModel, managed, TaskObserver, XH} from '@xh/hoist/core';
+import {bindable, makeObservable} from '@xh/hoist/mobx';
+import {isEmpty} from 'lodash';
+
+/**
+ * @internal
+ */
+export class JsonSearchPanelImplModel extends HoistModel {
+    override xhImpl = true;
+
+    @managed gridModel: GridModel;
+    @managed docLoadTask: TaskObserver = TaskObserver.trackLast();
+    @managed nodeLoadTask: TaskObserver = TaskObserver.trackLast();
+
+    @bindable.ref error = null;
+    @bindable path: string = '';
+    @bindable pathOrValue: 'path' | 'value' = 'value';
+    @bindable pathFormat: 'XPath' | 'JSONPath' = 'XPath';
+    @bindable matchingNodes: string = '';
+    @bindable matchingNodeCount: number = 0;
+
+    get asPathList(): boolean {
+        return this.pathOrValue === 'path';
+    }
+
+    get queryBuffer(): number {
+        return this.componentProps.queryBuffer ?? 200;
+    }
+
+    get docSearchUrl(): string {
+        return this.componentProps.docSearchUrl;
+    }
+
+    get matchingNodesUrl(): string {
+        return this.componentProps.matchingNodesUrl;
+    }
+
+    get gridModelConfig() {
+        return this.componentProps.gridModelConfig;
+    }
+
+    constructor() {
+        super();
+        makeObservable(this);
+    }
+
+    override onLinked() {
+        this.gridModel = new GridModel({
+            ...this.gridModelConfig,
+            selModel: 'single'
+        });
+
+        this.addReaction(
+            {
+                track: () => this.path,
+                run: path => {
+                    if (isEmpty(path)) {
+                        this.error = null;
+                        this.gridModel.clear();
+                    }
+                }
+            },
+            {
+                track: () => [this.gridModel.selectedRecord, this.pathOrValue, this.pathFormat],
+                run: () => this.loadJsonNodesAsync(),
+                debounce: 300
+            }
+        );
+    }
+
+    async loadJsonDocsAsync() {
+        if (isEmpty(this.path)) {
+            this.error = null;
+            this.gridModel.clear();
+            return;
+        }
+
+        try {
+            const data = await XH.fetchJson({
+                url: this.docSearchUrl,
+                params: {path: this.path}
+            }).linkTo(this.docLoadTask);
+
+            this.error = null;
+            this.gridModel.loadData(data);
+            this.gridModel.selectFirstAsync();
+        } catch (e) {
+            this.gridModel.clear();
+            this.error = e;
+        }
+    }
+
+    private async loadJsonNodesAsync() {
+        if (!this.gridModel.selectedRecord) {
+            this.matchingNodeCount = 0;
+            this.matchingNodes = '';
+            return;
+        }
+
+        let nodes = await XH.fetchJson({
+            url: this.matchingNodesUrl,
+            params: {
+                path: this.path,
+                asPathList: this.pathOrValue === 'path',
+                json: this.gridModel.selectedRecord.data.json
+            }
+        }).linkTo(this.nodeLoadTask);
+
+        this.matchingNodeCount = nodes.length;
+        if (this.asPathList && this.pathFormat === 'XPath') {
+            nodes = nodes.map(it => this.convertToPath(it));
+        }
+        this.matchingNodes = JSON.stringify(nodes, null, 2);
+    }
+
+    private convertToPath(JSONPath: string): string {
+        return JSONPath.replaceAll(/^\$\['?/g, '/')
+            .replaceAll(/^\$/g, '')
+            .replaceAll(/'?]\['?/g, '/')
+            .replaceAll(/'?]$/g, '');
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xh/hoist",
-  "version": "72.0.0-SNAPSHOT.1737472364423",
+  "version": "72.0.0-SNAPSHOT.1737670838944",
   "description": "Hoist add-on for building and deploying React Applications.",
   "repository": "github:xh/hoist-react",
   "homepage": "https://xh.io",
@@ -97,7 +97,7 @@
     "@ag-grid-community/react": "31.x",
     "@types/react": "18.x",
     "@types/react-dom": "18.x",
-    "@xh/hoist-dev-utils": "9.x",
+    "@xh/hoist-dev-utils": "10.x",
     "csstype": "3.x",
     "eslint": "8.x",
     "eslint-config-prettier": "9.x",