@xh/hoist 73.0.0-SNAPSHOT.1746647745931 → 73.0.0-SNAPSHOT.1746798376611

package/admin/tabs/client/ClientTab.ts

@@ -1,24 +0,0 @@
-/*
- * 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 {clientErrorsPanel} from '@xh/hoist/admin/tabs/client/errors/ClientErrorsPanel';
-import {tabContainer} from '@xh/hoist/cmp/tab';
-import {hoistCmp} from '@xh/hoist/core';
-import {Icon} from '@xh/hoist/icon';
-import {clientsPanel} from './clients/ClientsPanel';
-
-export const clientTab = hoistCmp.factory(() =>
-    tabContainer({
-        modelConfig: {
-            route: 'default.clients',
-            switcher: {orientation: 'left', testId: 'client-tab-switcher'},
-            tabs: [
-                {id: 'connections', icon: Icon.diff(), content: clientsPanel},
-                {id: 'errors', icon: Icon.warning(), content: clientErrorsPanel}
-            ]
-        }
-    })
-);

package/admin/tabs/client/errors/ClientErrorDetail.ts

@@ -1,129 +0,0 @@
-/*
- * 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 {correlationId, instance} from '@xh/hoist/admin/columns';
-import {form} from '@xh/hoist/cmp/form';
-import {a, div, h3, hframe, span, vbox} from '@xh/hoist/cmp/layout';
-import {hoistCmp} from '@xh/hoist/core';
-import {formField} from '@xh/hoist/desktop/cmp/form';
-import {jsonInput} from '@xh/hoist/desktop/cmp/input';
-import {panel} from '@xh/hoist/desktop/cmp/panel';
-import {fmtDateTimeSec} from '@xh/hoist/format';
-import {Icon} from '@xh/hoist/icon';
-import {isNil} from 'lodash';
-import {ClientErrorsModel} from './ClientErrorsModel';
-
-export const clientErrorDetail = hoistCmp.factory<ClientErrorsModel>(({model}) => {
-    const {selectedRecord, formattedErrorJson, formModel} = model,
-        userMsg = formModel.values.msg;
-
-    if (!selectedRecord) return null;
-
-    return panel({
-        className: 'xh-admin-client-errors-detail',
-        collapsedTitle: 'Error Details',
-        collapsedIcon: Icon.info(),
-        compactHeader: true,
-        modelConfig: {
-            side: 'bottom',
-            defaultSize: 400
-        },
-        item: form({
-            fieldDefaults: {inline: true, readonlyRenderer: valOrNa},
-            item: hframe(
-                div({
-                    className: 'xh-admin-client-errors-detail__form',
-                    style: {width: '400px'},
-                    items: [
-                        h3(Icon.info(), 'Error Info'),
-                        formField({
-                            field: 'username',
-                            readonlyRenderer: username => {
-                                if (!username) return naSpan();
-                                const {impersonating} = formModel.values,
-                                    impSpan = impersonating
-                                        ? span({
-                                              className: 'xh-text-color-accent',
-                                              item: ` (impersonating ${impersonating})`
-                                          })
-                                        : null;
-                                return span(username, impSpan);
-                            }
-                        }),
-                        formField({
-                            field: 'appVersion',
-                            readonlyRenderer: appVersion => {
-                                if (!appVersion) return naSpan();
-                                const {appEnvironment} = formModel.values;
-                                return `${appVersion} (${appEnvironment})`;
-                            }
-                        }),
-                        formField({
-                            field: 'userAlerted',
-                            label: 'User Alerted?'
-                        }),
-                        formField({
-                            field: 'url',
-                            readonlyRenderer: hyperlinkVal
-                        }),
-                        formField({
-                            field: 'instance',
-                            readonlyRenderer: v => instance.renderer(v, null)
-                        }),
-                        formField({
-                            field: 'correlationId',
-                            readonlyRenderer: v => correlationId.renderer(v, null)
-                        }),
-                        formField({
-                            field: 'dateCreated',
-                            readonlyRenderer: v => fmtDateTimeSec(v)
-                        }),
-                        h3(Icon.desktop(), 'Device / Browser'),
-                        formField({field: 'device'}),
-                        formField({field: 'browser'}),
-                        formField({field: 'userAgent'})
-                    ]
-                }),
-                vbox({
-                    flex: 1,
-                    className: 'xh-border-left',
-                    items: [
-                        panel({
-                            flex: 0.5,
-                            className: 'xh-border-bottom',
-                            items: [
-                                h3(Icon.comment(), 'User Message'),
-                                div({
-                                    className: `xh-pad`,
-                                    style: {overflowY: 'auto'},
-                                    item: userMsg
-                                })
-                            ],
-                            omit: !userMsg
-                        }),
-                        panel({
-                            flex: 1,
-                            items: [
-                                h3(Icon.json(), 'Additional Data'),
-                                jsonInput({
-                                    readonly: true,
-                                    width: '100%',
-                                    height: '100%',
-                                    showCopyButton: true,
-                                    value: formattedErrorJson ?? '{}'
-                                })
-                            ]
-                        })
-                    ]
-                })
-            )
-        })
-    });
-});
-
-const valOrNa = v => (!isNil(v) ? v.toString() : naSpan());
-const naSpan = () => span({item: 'N/A', className: 'xh-text-color-muted'});
-const hyperlinkVal = v => (v ? a({href: v, item: v, target: '_blank'}) : '-');

package/admin/tabs/client/errors/ClientErrors.scss

@@ -1,52 +0,0 @@
-/*
- * 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.
- */
-
-.xh-admin-client-errors-detail {
-  &__form {
-    overflow-y: auto;
-
-    .xh-form-field {
-      margin: 0;
-      padding: 2px var(--xh-pad-px);
-
-      &.xh-form-field-readonly .xh-form-field-readonly-display {
-        padding: var(--xh-pad-half-px);
-      }
-
-      &:nth-child(odd) {
-        background-color: var(--xh-grid-bg-odd);
-      }
-    }
-
-    .xh-form-field-label {
-      font-size: var(--xh-font-size-small-px);
-      padding: 0;
-    }
-  }
-
-  h3 {
-    color: var(--xh-text-color-headings);
-    background-color: var(--xh-blue-gray-light);
-    margin: 0 !important;
-    font-size: var(--xh-font-size-px);
-    font-weight: normal;
-    padding: var(--xh-pad-half-px) !important;
-    border-bottom: var(--xh-border-solid);
-
-    &:not(:first-child) {
-      border-top: var(--xh-border-solid);
-    }
-
-    .xh-dark & {
-      background-color: var(--xh-blue-gray-dark);
-    }
-
-    .xh-icon {
-      margin-right: var(--xh-pad-px);
-    }
-  }
-}

package/admin/tabs/client/errors/ClientErrorsModel.ts

@@ -1,227 +0,0 @@
-/*
- * 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 {exportFilename} from '@xh/hoist/admin/AdminUtils';
-import * as Col from '@xh/hoist/admin/columns';
-import {FilterChooserModel} from '@xh/hoist/cmp/filter';
-import {FormModel} from '@xh/hoist/cmp/form';
-import {GridModel} from '@xh/hoist/cmp/grid';
-import {HoistModel, LoadSpec, managed, PlainObject, XH} from '@xh/hoist/core';
-import {StoreRecord} from '@xh/hoist/data';
-import {fmtJson} from '@xh/hoist/format';
-import {action, bindable, comparer, computed, makeObservable, observable} from '@xh/hoist/mobx';
-import {LocalDate} from '@xh/hoist/utils/datetime';
-
-export class ClientErrorsModel extends HoistModel {
-    override persistWith = {localStorageKey: 'xhAdminClientErrorsState'};
-
-    @bindable.ref startDay: LocalDate;
-    @bindable.ref endDay: LocalDate;
-
-    @managed gridModel: GridModel;
-    @managed formModel: FormModel;
-    @managed filterChooserModel: FilterChooserModel;
-
-    get selectedRecord() {
-        return this.gridModel.selectedRecord;
-    }
-
-    /** Parsed and JSON-formatted stacktrace / additional data for selected error. */
-    @observable formattedErrorJson: string;
-
-    constructor() {
-        super();
-        makeObservable(this);
-        this.startDay = this.defaultStartDay;
-        this.endDay = this.defaultEndDay;
-
-        const hidden = true,
-            pinned = true;
-
-        this.gridModel = new GridModel({
-            persistWith: this.persistWith,
-            colChooserModel: true,
-            enableExport: true,
-            exportOptions: {
-                filename: exportFilename('client-errors'),
-                columns: 'ALL'
-            },
-            emptyText: 'No errors reported...',
-            sortBy: 'dateCreated|desc',
-            columns: [
-                {...Col.entryId, hidden},
-                {...Col.userMessageFlag, pinned},
-                {...Col.userAlertedFlag, pinned},
-                {...Col.impersonatingFlag, pinned},
-                {...Col.username, pinned},
-                {...Col.impersonating, hidden},
-                {...Col.browser},
-                {...Col.device},
-                {...Col.userAgent, hidden},
-                {...Col.appVersion},
-                {...Col.appEnvironment},
-                {...Col.msg, displayName: 'User Message', hidden},
-                {...Col.errorName},
-                {...Col.errorMessage},
-                {...Col.error, hidden},
-                {...Col.url},
-                {...Col.correlationId},
-                {...Col.instance, hidden},
-                {...Col.day},
-                {...Col.dateCreatedWithSec, displayName: 'Timestamp'}
-            ]
-        });
-
-        const enableValues = true;
-        this.filterChooserModel = new FilterChooserModel({
-            fieldSpecs: [
-                {field: 'correlationId'},
-                {field: 'username', displayName: 'User', enableValues},
-                {field: 'browser', enableValues},
-                {field: 'device', enableValues},
-                {field: 'appVersion'},
-                {field: 'appEnvironment', displayName: 'Environment', enableValues},
-                {field: 'userAlerted'},
-                {field: 'userAgent'},
-                {field: 'msg', displayName: 'User Message'},
-                {field: 'error'},
-                {field: 'url', displayName: 'URL'},
-                {field: 'instance'},
-                {field: 'impersonating'}
-            ]
-        });
-
-        this.loadFieldSpecValues();
-
-        this.formModel = new FormModel({
-            readonly: true,
-            fields: this.gridModel
-                .getLeafColumns()
-                .map(it => ({name: it.field, displayName: it.headerName as string}))
-        });
-
-        this.addReaction({
-            track: () => this.query,
-            run: () => this.loadAsync(),
-            equals: comparer.structural
-        });
-
-        this.addReaction({
-            track: () => this.gridModel.selectedRecord,
-            run: detailRec => this.showEntryDetail(detailRec)
-        });
-    }
-
-    @action
-    resetQuery() {
-        this.startDay = this.defaultStartDay;
-        this.endDay = this.defaultEndDay;
-        this.filterChooserModel.setValue(null);
-    }
-
-    override async doLoadAsync(loadSpec: LoadSpec) {
-        const {query, gridModel} = this;
-
-        try {
-            const data: PlainObject[] = await XH.fetchService.postJson({
-                url: 'clientErrorAdmin',
-                body: query,
-                loadSpec
-            });
-
-            // Parse name + message from JSON-serialized error object out to top-level properties.
-            data.forEach(it => {
-                try {
-                    const error = JSON.parse(it.error);
-                    it.errorName = error?.name;
-                    it.errorMessage = error?.message;
-                } catch (ignored) {}
-            });
-
-            gridModel.loadData(data);
-            await gridModel.preSelectFirstAsync();
-        } catch (e) {
-            if (loadSpec.isStale || loadSpec.isAutoRefresh) return;
-
-            gridModel.clear();
-            XH.handleException(e);
-        }
-    }
-
-    @action
-    showEntryDetail(detailRec: StoreRecord) {
-        const recData = detailRec?.data ?? {},
-            errorData = recData.error;
-
-        this.formModel.init(recData);
-
-        let formattedErrorJson = errorData;
-        if (formattedErrorJson) {
-            try {
-                formattedErrorJson = fmtJson(errorData);
-            } catch (ignored) {}
-        }
-
-        this.formattedErrorJson = formattedErrorJson;
-    }
-
-    @action
-    adjustDates(dir: 'subtract' | 'add') {
-        const appDay = LocalDate.currentAppDay(),
-            start = this.startDay,
-            end = this.endDay,
-            diff = end.diff(start),
-            incr = diff + 1;
-
-        let newStart = start[dir](incr),
-            newEnd = end[dir](incr);
-
-        if (newEnd > appDay) {
-            newStart = appDay.subtract(Math.abs(diff));
-            newEnd = appDay;
-        }
-
-        this.startDay = newStart;
-        this.endDay = newEnd;
-    }
-
-    // Set the start date by taking the end date and pushing back [value] [units] - then pushing
-    // forward one day as the day range query is inclusive.
-    @action
-    adjustStartDate(value, unit) {
-        this.startDay = this.endDay.subtract(value, unit).nextDay();
-    }
-
-    isInterval(value, unit) {
-        return this.startDay === this.endDay.subtract(value, unit).nextDay();
-    }
-
-    @computed
-    private get query() {
-        return {
-            startDay: this.startDay,
-            endDay: this.endDay,
-            filters: this.filterChooserModel.value
-        };
-    }
-
-    private get defaultStartDay() {
-        return LocalDate.currentAppDay();
-    }
-
-    private get defaultEndDay() {
-        return LocalDate.currentAppDay();
-    }
-
-    private async loadFieldSpecValues() {
-        const lookups = await XH.fetchJson({url: 'clientErrorAdmin/lookups'});
-
-        this.filterChooserModel.fieldSpecs.forEach(spec => {
-            const {field} = spec;
-            if (lookups[field]) spec.values = lookups[field];
-        });
-    }
-}

package/admin/tabs/client/errors/ClientErrorsPanel.ts

@@ -1,101 +0,0 @@
-/*
- * 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 {grid, gridCountLabel} from '@xh/hoist/cmp/grid';
-import {hspacer} from '@xh/hoist/cmp/layout';
-import {creates, hoistCmp} from '@xh/hoist/core';
-import {button, buttonGroup, colChooserButton, exportButton} from '@xh/hoist/desktop/cmp/button';
-import {filterChooser} from '@xh/hoist/desktop/cmp/filter';
-import {dateInput, DateInputProps} from '@xh/hoist/desktop/cmp/input';
-import {panel} from '@xh/hoist/desktop/cmp/panel';
-import {toolbar} from '@xh/hoist/desktop/cmp/toolbar';
-import {Icon} from '@xh/hoist/icon';
-import {LocalDate} from '@xh/hoist/utils/datetime';
-import {clientErrorDetail} from './ClientErrorDetail';
-import {ClientErrorsModel} from './ClientErrorsModel';
-import './ClientErrors.scss';
-
-export const clientErrorsPanel = hoistCmp.factory({
-    model: creates(ClientErrorsModel),
-
-    render() {
-        return panel({
-            className: 'xh-admin-client-errors-panel',
-            tbar: tbar(),
-            items: [grid(), clientErrorDetail()],
-            mask: 'onLoad'
-        });
-    }
-});
-
-const tbar = hoistCmp.factory<ClientErrorsModel>(({model}) => {
-    return toolbar(
-        button({
-            icon: Icon.angleLeft(),
-            onClick: () => model.adjustDates('subtract')
-        }),
-        dateInput({bind: 'startDay', ...dateInputProps}),
-        Icon.caretRight(),
-        dateInput({bind: 'endDay', ...dateInputProps}),
-        button({
-            icon: Icon.angleRight(),
-            onClick: () => model.adjustDates('add'),
-            disabled: model.endDay >= LocalDate.currentAppDay()
-        }),
-        buttonGroup(
-            button({
-                text: '6m',
-                outlined: true,
-                width: 40,
-                onClick: () => model.adjustStartDate(6, 'months'),
-                active: model.isInterval(6, 'months')
-            }),
-            button({
-                text: '1m',
-                outlined: true,
-                width: 40,
-                onClick: () => model.adjustStartDate(1, 'months'),
-                active: model.isInterval(1, 'months')
-            }),
-            button({
-                text: '7d',
-                outlined: true,
-                width: 40,
-                onClick: () => model.adjustStartDate(7, 'days'),
-                active: model.isInterval(7, 'days')
-            }),
-            button({
-                text: '1d',
-                outlined: true,
-                width: 40,
-                onClick: () => model.adjustStartDate(1, 'days'),
-                active: model.isInterval(1, 'days')
-            })
-        ),
-        hspacer(),
-        filterChooser({
-            flex: 1,
-            enableClear: true
-        }),
-        button({
-            icon: Icon.reset(),
-            intent: 'danger',
-            title: 'Reset query to defaults',
-            onClick: () => model.resetQuery()
-        }),
-        '-',
-        gridCountLabel({unit: 'error'}),
-        '-',
-        colChooserButton(),
-        exportButton()
-    );
-});
-
-const dateInputProps: DateInputProps = {
-    popoverPosition: 'bottom',
-    valueType: 'localDate',
-    width: 120
-};

package/admin/tabs/general/feedback/FeedbackPanel.ts

@@ -1,61 +0,0 @@
-/*
- * 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 {exportFilenameWithDate} from '@xh/hoist/admin/AdminUtils';
-import {AppModel} from '@xh/hoist/admin/AppModel';
-import * as Col from '@xh/hoist/admin/columns';
-import {hoistCmp} from '@xh/hoist/core';
-import {FieldSpec} from '@xh/hoist/data';
-import {textArea} from '@xh/hoist/desktop/cmp/input';
-import {deleteAction, restGrid, RestGridConfig} from '@xh/hoist/desktop/cmp/rest';
-
-export const feedbackPanel = hoistCmp.factory(() =>
-    restGrid({modelConfig: {...modelSpec, readonly: AppModel.readonly}})
-);
-
-const modelSpec: RestGridConfig = {
-    persistWith: {localStorageKey: 'xhAdminFeedbackState'},
-    colChooserModel: true,
-    enableExport: true,
-    exportOptions: {filename: exportFilenameWithDate('feedback')},
-    emptyText: 'No feedback reported...',
-    store: {
-        url: 'rest/feedbackAdmin',
-        fields: [
-            Col.username.field,
-            Col.msg.field,
-            Col.browser.field,
-            Col.device.field,
-            Col.appEnvironment.field,
-            {...(Col.appVersion.field as FieldSpec), displayName: 'Version'},
-            {...(Col.dateCreated.field as FieldSpec), displayName: 'Date'}
-        ]
-    },
-    toolbarActions: [deleteAction],
-    menuActions: [deleteAction],
-    formActions: [deleteAction],
-    unit: 'report',
-    sortBy: 'dateCreated|desc',
-    filterFields: ['username', 'msg'],
-    columns: [
-        {...Col.username},
-        {...Col.browser},
-        {...Col.device},
-        {...Col.appVersion, displayName: 'Version'},
-        {...Col.appEnvironment},
-        {...Col.msg},
-        {...Col.dateCreated, displayName: 'Date'}
-    ],
-    editors: [
-        {field: 'username'},
-        {field: 'msg', formField: {item: textArea({height: 100})}},
-        {field: 'browser'},
-        {field: 'device'},
-        {field: 'appVersion'},
-        {field: 'appEnvironment'},
-        {field: 'dateCreated'}
-    ]
-};

package/build/types/admin/tabs/client/ClientTab.d.ts

@@ -1 +0,0 @@
-export declare const clientTab: import("@xh/hoist/core").ElementFactory<import("@xh/hoist/core").DefaultHoistProps<import("@xh/hoist/core").HoistModel>>;

package/build/types/admin/tabs/client/errors/ClientErrorDetail.d.ts

@@ -1,2 +0,0 @@
-import { ClientErrorsModel } from './ClientErrorsModel';
-export declare const clientErrorDetail: import("@xh/hoist/core").ElementFactory<import("@xh/hoist/core").DefaultHoistProps<ClientErrorsModel>>;

package/build/types/admin/tabs/client/errors/ClientErrorsModel.d.ts

@@ -1,30 +0,0 @@
-import { FilterChooserModel } from '@xh/hoist/cmp/filter';
-import { FormModel } from '@xh/hoist/cmp/form';
-import { GridModel } from '@xh/hoist/cmp/grid';
-import { HoistModel, LoadSpec } from '@xh/hoist/core';
-import { StoreRecord } from '@xh/hoist/data';
-import { LocalDate } from '@xh/hoist/utils/datetime';
-export declare class ClientErrorsModel extends HoistModel {
-    persistWith: {
-        localStorageKey: string;
-    };
-    startDay: LocalDate;
-    endDay: LocalDate;
-    gridModel: GridModel;
-    formModel: FormModel;
-    filterChooserModel: FilterChooserModel;
-    get selectedRecord(): StoreRecord;
-    /** Parsed and JSON-formatted stacktrace / additional data for selected error. */
-    formattedErrorJson: string;
-    constructor();
-    resetQuery(): void;
-    doLoadAsync(loadSpec: LoadSpec): Promise<void>;
-    showEntryDetail(detailRec: StoreRecord): void;
-    adjustDates(dir: 'subtract' | 'add'): void;
-    adjustStartDate(value: any, unit: any): void;
-    isInterval(value: any, unit: any): boolean;
-    private get query();
-    private get defaultStartDay();
-    private get defaultEndDay();
-    private loadFieldSpecValues;
-}

package/build/types/admin/tabs/client/errors/ClientErrorsPanel.d.ts

@@ -1,3 +0,0 @@
-import { ClientErrorsModel } from './ClientErrorsModel';
-import './ClientErrors.scss';
-export declare const clientErrorsPanel: import("@xh/hoist/core").ElementFactory<import("@xh/hoist/core").DefaultHoistProps<ClientErrorsModel>>;

package/build/types/admin/tabs/general/feedback/FeedbackPanel.d.ts

@@ -1 +0,0 @@
-export declare const feedbackPanel: import("@xh/hoist/core").ElementFactory<import("@xh/hoist/core").DefaultHoistProps<import("@xh/hoist/core").HoistModel>>;