@itwin/presentation-hierarchies 2.0.0-alpha.16 → 2.0.0-alpha.17

package/lib/cjs/hierarchies/imodel/IModelHierarchyProvider.js

@@ -1,657 +0,0 @@
-"use strict";
-/*---------------------------------------------------------------------------------------------
- * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
- * See LICENSE.md in the project root for license terms and full copyright notice.
- *--------------------------------------------------------------------------------------------*/
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createIModelHierarchyProvider = createIModelHierarchyProvider;
-exports.createMergedIModelHierarchyProvider = createMergedIModelHierarchyProvider;
-require("../internal/DisposePolyfill.js");
-const rxjs_1 = require("rxjs");
-const core_bentley_1 = require("@itwin/core-bentley");
-const presentation_shared_1 = require("@itwin/presentation-shared");
-const HierarchyErrors_js_1 = require("../HierarchyErrors.js");
-const HierarchyNode_js_1 = require("../HierarchyNode.js");
-const HierarchyNodeKey_js_1 = require("../HierarchyNodeKey.js");
-const HierarchySearch_js_1 = require("../HierarchySearch.js");
-const Common_js_1 = require("../internal/Common.js");
-const EachValueFrom_js_1 = require("../internal/EachValueFrom.js");
-const LoggingUtils_js_1 = require("../internal/LoggingUtils.js");
-const Partition_js_1 = require("../internal/operators/Partition.js");
-const ReduceToMergeMap_js_1 = require("../internal/operators/ReduceToMergeMap.js");
-const ShareReplayWithErrors_js_1 = require("../internal/operators/ShareReplayWithErrors.js");
-const Sorting_js_1 = require("../internal/operators/Sorting.js");
-const RxjsHierarchyDefinition_js_1 = require("../internal/RxjsHierarchyDefinition.js");
-const SubscriptionScheduler_js_1 = require("../internal/SubscriptionScheduler.js");
-const HierarchyCache_js_1 = require("./HierarchyCache.js");
-const IModelHierarchyDefinition_js_1 = require("./IModelHierarchyDefinition.js");
-const NodeSelectQueryFactory_js_1 = require("./NodeSelectQueryFactory.js");
-const DetermineChildren_js_1 = require("./operators/DetermineChildren.js");
-const Grouping_js_1 = require("./operators/Grouping.js");
-const HideIfNoChildren_js_1 = require("./operators/HideIfNoChildren.js");
-const HideNodesInHierarchy_js_1 = require("./operators/HideNodesInHierarchy.js");
-const SearchHierarchyDefinition_js_1 = require("./SearchHierarchyDefinition.js");
-const TreeNodesReader_js_1 = require("./TreeNodesReader.js");
-const Utils_js_1 = require("./Utils.js");
-const LOGGING_NAMESPACE = `${Common_js_1.LOGGING_NAMESPACE}.IModelHierarchyProvider`;
-const LOGGING_NAMESPACE_INTERNAL = `${Common_js_1.LOGGING_NAMESPACE_INTERNAL}.IModelHierarchyProvider`;
-const LOGGING_NAMESPACE_PERFORMANCE = `${Common_js_1.LOGGING_NAMESPACE_PERFORMANCE}.IModelHierarchyProvider`;
-const DEFAULT_QUERY_CONCURRENCY = 10;
-const DEFAULT_QUERY_CACHE_SIZE = 1;
-/**
- * Creates an instance of `HierarchyProvider` that creates a hierarchy based on given the iModel and
- * a hierarchy definition, which defines each hierarchy level through ECSQL queries.
- *
- * @public
- */
-function createIModelHierarchyProvider(props) {
-    const { imodelAccess, imodelChanged, instanceLabelSelectClauseFactory, ...restProps } = props;
-    return createMergedIModelHierarchyProvider({
-        ...restProps,
-        imodels: [{ imodelAccess, imodelChanged, instanceLabelSelectClauseFactory }],
-    });
-}
-/**
- * Creates an instance of `HierarchyProvider` that creates a hierarchy based on multiple version of **the same** iModel
- * and a hierarchy definition, which defines each hierarchy level through ECSQL queries.
- *
- * **Warning:** This is an experimental API that **should not be used in production**.
- *
- * @alpha
- */
-function createMergedIModelHierarchyProvider(props) {
-    return new IModelHierarchyProviderImpl(props);
-}
-class IModelHierarchyProviderImpl {
-    _imodels;
-    _hierarchyChanged;
-    _valuesFormatter;
-    _sourceHierarchyDefinition;
-    _activeHierarchyDefinition;
-    _localizedStrings;
-    _queryConcurrency;
-    _querySchedulers;
-    _nodesCache;
-    _unsubscribe;
-    _dispose = new rxjs_1.Subject();
-    #componentId;
-    #componentName;
-    #sourceName;
-    constructor(props) {
-        if (props.imodels.length === 0) {
-            throw new Error(`Creating an iModel hierarchy provider requires at least one iModel.`);
-        }
-        this.#componentId = core_bentley_1.Guid.createValue();
-        this.#componentName = "IModelHierarchyProviderImpl";
-        this.#sourceName = props.sourceName ?? `${this.#componentName}:${this.#componentId}`;
-        this._imodels = props.imodels.map(({ imodelAccess, imodelChanged, instanceLabelSelectClauseFactory }) => {
-            if (!instanceLabelSelectClauseFactory) {
-                instanceLabelSelectClauseFactory = (0, presentation_shared_1.createIModelInstanceLabelSelectClauseFactory)({ imodelAccess });
-            }
-            const nodeSelectClauseFactory = (0, NodeSelectQueryFactory_js_1.createNodesQueryClauseFactory)({ imodelAccess, instanceLabelSelectClauseFactory });
-            return { imodelAccess, imodelChanged, nodeSelectClauseFactory };
-        });
-        this._hierarchyChanged = new core_bentley_1.BeEvent();
-        this._activeHierarchyDefinition = this._sourceHierarchyDefinition = (0, RxjsHierarchyDefinition_js_1.getRxjsHierarchyDefinition)(props.hierarchyDefinition);
-        this._valuesFormatter = props.formatter ?? (0, presentation_shared_1.createDefaultValueFormatter)();
-        this._localizedStrings = { other: "Other", unspecified: "Not specified", ...props.localizedStrings };
-        this._queryConcurrency = props.queryConcurrency ?? DEFAULT_QUERY_CONCURRENCY;
-        this._querySchedulers = new Map();
-        this.setHierarchySearch(props.search);
-        const queryCacheSize = props.queryCacheSize ?? DEFAULT_QUERY_CACHE_SIZE;
-        if (queryCacheSize !== 0) {
-            this._nodesCache = new HierarchyCache_js_1.HierarchyCache({
-                // we divide the size by 2, because each variation also counts as a query that we cache
-                size: Math.ceil(queryCacheSize / 2),
-                variationsCount: 1,
-            });
-        }
-        const imodelChangeSubscription = (0, rxjs_1.from)(this._imodels)
-            .pipe((0, rxjs_1.mergeMap)(({ imodelAccess, imodelChanged }) => imodelChanged
-            ? (0, rxjs_1.fromEventPattern)((handler) => imodelChanged.addListener(handler), (handler) => imodelChanged.removeListener(handler), () => imodelAccess)
-            : rxjs_1.EMPTY))
-            .subscribe(({ imodelKey }) => {
-            this.invalidateHierarchyCache(`Data source changed: "${imodelKey}"`);
-            this._dispose.next();
-            this._hierarchyChanged.raiseEvent({});
-        });
-        this._unsubscribe = () => {
-            imodelChangeSubscription.unsubscribe();
-        };
-    }
-    [Symbol.dispose]() {
-        this._dispose.next();
-        this._unsubscribe?.();
-    }
-    /* v8 ignore next -- @preserve */
-    dispose() {
-        this[Symbol.dispose]();
-    }
-    get hierarchyChanged() {
-        return this._hierarchyChanged;
-    }
-    getQueryScheduler(imodelKey) {
-        let scheduler = this._querySchedulers.get(imodelKey);
-        if (!scheduler) {
-            scheduler = new SubscriptionScheduler_js_1.SubscriptionScheduler(this._queryConcurrency);
-            this._querySchedulers.set(imodelKey, scheduler);
-        }
-        return scheduler;
-    }
-    getPrimaryIModelAccess() {
-        return this._imodels[this._imodels.length - 1].imodelAccess;
-    }
-    invalidateHierarchyCache(reason) {
-        /* v8 ignore next -- @preserve */
-        (0, LoggingUtils_js_1.doLog)({
-            category: `${LOGGING_NAMESPACE}.Events`,
-            message: () => (reason ? `${reason}: clear hierarchy cache` : `Clear hierarchy cache`),
-        });
-        this._nodesCache?.clear();
-    }
-    /**
-     * Sets `HierarchyProvider` values formatter that formats nodes' labels. If provided `undefined`, then defaults to the
-     * result of `createDefaultValueFormatter` called with default parameters.
-     */
-    setFormatter(formatter) {
-        this._valuesFormatter = formatter ?? (0, presentation_shared_1.createDefaultValueFormatter)();
-        this._hierarchyChanged.raiseEvent({ formatterChange: { newFormatter: this._valuesFormatter } });
-    }
-    setHierarchySearch(props) {
-        if (!props) {
-            if (this._sourceHierarchyDefinition !== this._activeHierarchyDefinition) {
-                this._activeHierarchyDefinition = this._sourceHierarchyDefinition;
-                this.invalidateHierarchyCache("Hierarchy search reset");
-            }
-            this._hierarchyChanged.raiseEvent({ searchChange: { newSearch: undefined } });
-            return;
-        }
-        this._activeHierarchyDefinition = new SearchHierarchyDefinition_js_1.SearchHierarchyDefinition({
-            imodelAccess: this.getPrimaryIModelAccess(),
-            source: this._sourceHierarchyDefinition,
-            sourceName: this.#sourceName,
-            targetPaths: props.paths,
-        });
-        this.invalidateHierarchyCache("Hierarchy search set");
-        this._dispose.next();
-        this._hierarchyChanged.raiseEvent({ searchChange: { newSearch: props } });
-    }
-    onGroupingNodeCreated(groupingNode, props) {
-        this._nodesCache?.set({ ...props, parentNode: groupingNode }, { observable: (0, rxjs_1.from)(groupingNode.children), processingStatus: "pre-processed" });
-    }
-    createHierarchyLevelDefinitionsObservable(props) {
-        const { requestContext, ...defineHierarchyLevelProps } = props;
-        /* v8 ignore next -- @preserve */
-        (0, LoggingUtils_js_1.doLog)({
-            category: LOGGING_NAMESPACE_PERFORMANCE,
-            message: () => `[${requestContext.requestId}] Requesting hierarchy level definitions for ${(0, Common_js_1.createNodeIdentifierForLogging)(props.parentNode)}`,
-        });
-        return (0, rxjs_1.from)(this._imodels).pipe((0, rxjs_1.mergeMap)(({ imodelAccess, nodeSelectClauseFactory }, imodelAccessIndex) => {
-            let parentNode = props.parentNode;
-            if (parentNode &&
-                HierarchyNode_js_1.HierarchyNode.isGeneric(parentNode) &&
-                parentNode.key.source &&
-                parentNode.key.source !== this.#sourceName) {
-                return rxjs_1.EMPTY;
-            }
-            if (parentNode && HierarchyNode_js_1.HierarchyNode.isInstancesNode(parentNode)) {
-                parentNode = {
-                    ...parentNode,
-                    key: {
-                        ...parentNode.key,
-                        instanceKeys: parentNode.key.instanceKeys.filter((ik) => !ik.imodelKey || ik.imodelKey === imodelAccess.imodelKey),
-                    },
-                };
-                (0, core_bentley_1.assert)(HierarchyNodeKey_js_1.HierarchyNodeKey.isInstances(parentNode.key));
-                if (parentNode.key.instanceKeys.length === 0) {
-                    return rxjs_1.EMPTY;
-                }
-            }
-            return this._activeHierarchyDefinition
-                .defineHierarchyLevel({
-                ...defineHierarchyLevelProps,
-                createSelectClause: async (selectClauseProps) => nodeSelectClauseFactory.createSelectClause(selectClauseProps),
-                /* v8 ignore start */
-                createFilterClauses: async (filterClausesProps) => nodeSelectClauseFactory.createFilterClauses(filterClausesProps),
-                /* v8 ignore stop */
-                parentNode,
-                imodelAccess,
-            })
-                .pipe((0, rxjs_1.mergeAll)(), (0, rxjs_1.map)(
-            /* Using `as` to work around TS not understanding that `{ x: A, y: B | C }` is the same as `{ x: A } & ({ y: B } | { y: C })` */
-            (hierarchyNodesDefinition) => ({ imodelAccess, imodelAccessIndex, hierarchyNodesDefinition })));
-        }), (0, rxjs_1.finalize)(() => {
-            /* v8 ignore next -- @preserve */
-            (0, LoggingUtils_js_1.doLog)({
-                category: LOGGING_NAMESPACE_PERFORMANCE,
-                message: () => `[${requestContext.requestId}] Received all hierarchy level definitions for ${(0, Common_js_1.createNodeIdentifierForLogging)(props.parentNode)}`,
-            });
-        }));
-    }
-    createSourceNodesObservable(props) {
-        const createSourceNodesFromDefinition = (imodelAccess, def) => {
-            if (IModelHierarchyDefinition_js_1.HierarchyNodesDefinition.isGenericNode(def)) {
-                return (0, rxjs_1.of)({ ...def.node, key: { type: "generic", id: def.node.key, source: this.#sourceName } });
-            }
-            const query = createInstanceKeysFilteredQuery(def.query, props.targetInstanceKeys);
-            return this.getQueryScheduler(imodelAccess.imodelKey).scheduleSubscription((0, TreeNodesReader_js_1.readNodes)({
-                queryExecutor: imodelAccess,
-                query,
-                limit: props.hierarchyLevelSizeLimit,
-                parser: this._activeHierarchyDefinition.parseNode
-                    ? ({ row }) => this._activeHierarchyDefinition.parseNode({
-                        row,
-                        parentNode: props.parentNode,
-                        imodelKey: imodelAccess.imodelKey,
-                    })
-                    : undefined,
-            }).pipe((0, rxjs_1.map)((node) => ({
-                ...node,
-                key: {
-                    ...node.key,
-                    instanceKeys: node.key.instanceKeys.map((key) => ({ ...key, imodelKey: imodelAccess.imodelKey })),
-                },
-            }))));
-        };
-        const definitions = this.createHierarchyLevelDefinitionsObservable(props);
-        let sourceNodes;
-        if (this._imodels.length === 1) {
-            sourceNodes = definitions.pipe((0, rxjs_1.mergeMap)(({ imodelAccess, hierarchyNodesDefinition: def }) => createSourceNodesFromDefinition(imodelAccess, def)));
-        }
-        else {
-            sourceNodes = definitions.pipe((0, rxjs_1.mergeMap)(({ imodelAccess, imodelAccessIndex, hierarchyNodesDefinition: def }) => createSourceNodesFromDefinition(imodelAccess, def).pipe((0, rxjs_1.map)((node) => ({ imodelAccess, imodelAccessIndex, node })))), mergeNodes, (0, rxjs_1.map)(({ node }) => node));
-        }
-        return sourceNodes.pipe((0, rxjs_1.finalize)(() => {
-            /* v8 ignore next -- @preserve */
-            (0, LoggingUtils_js_1.doLog)({
-                category: LOGGING_NAMESPACE_PERFORMANCE,
-                message: () => `[${props.requestContext.requestId}] Read all child nodes ${(0, Common_js_1.createNodeIdentifierForLogging)(props.parentNode)}`,
-            });
-        }), (0, ShareReplayWithErrors_js_1.shareReplayWithErrors)());
-    }
-    createPreProcessedNodesObservable(queryNodesObservable, props) {
-        return queryNodesObservable.pipe(
-        // we're going to be mutating the nodes, but don't want to mutate the original one, so just clone it here once
-        (0, rxjs_1.map)((node) => ({ ...node })), 
-        // set parent node keys on the source node
-        (0, rxjs_1.map)((node) => Object.assign(node, { parentKeys: createParentNodeKeysList(props.parentNode) })), 
-        // format `ConcatenatedValue` labels into string labels
-        (0, rxjs_1.mergeMap)((node) => applyLabelsFormatting(node, this._valuesFormatter)), 
-        // we have `ProcessedHierarchyNode` from here
-        // let consumers step-in
-        preProcessNodes(this._activeHierarchyDefinition, props.parentNode), 
-        // process hiding
-        (0, HideIfNoChildren_js_1.createHideIfNoChildrenOperator)((n) => this.getChildNodesObservables({ parentNode: n, requestContext: props.requestContext }).hasNodes), (0, HideNodesInHierarchy_js_1.createHideNodesInHierarchyOperator)(
-        // note: for child nodes created because of hidden parent, we want to use parent's request props (instance filter, limit)
-        (n) => this.getChildNodesObservables({ ...props, parentNode: n }).processedNodes, false), (0, rxjs_1.finalize)(() => {
-            /* v8 ignore next -- @preserve */
-            (0, LoggingUtils_js_1.doLog)({
-                category: LOGGING_NAMESPACE_PERFORMANCE,
-                message: () => `[${props.requestContext.requestId}] Finished pre-processing child nodes for ${(0, Common_js_1.createNodeIdentifierForLogging)(props.parentNode)}`,
-            });
-        }));
-    }
-    createProcessedNodesObservable(preprocessedNodesObservable, props) {
-        return preprocessedNodesObservable.pipe((0, Grouping_js_1.createGroupingOperator)(this.getPrimaryIModelAccess(), props.parentNode, this._valuesFormatter, this._localizedStrings, undefined, (gn) => this.onGroupingNodeCreated(gn, props)), (0, rxjs_1.finalize)(() => {
-            /* v8 ignore next -- @preserve */
-            (0, LoggingUtils_js_1.doLog)({
-                category: LOGGING_NAMESPACE_PERFORMANCE,
-                message: () => `[${props.requestContext.requestId}] Finished grouping child nodes for ${(0, Common_js_1.createNodeIdentifierForLogging)(props.parentNode)}`,
-            });
-        }));
-    }
-    createFinalizedNodesObservable(processedNodesObservable, props) {
-        return processedNodesObservable.pipe((0, DetermineChildren_js_1.createDetermineChildrenOperator)((n) => this.getChildNodesObservables({ parentNode: n, requestContext: props.requestContext }).hasNodes), postProcessNodes(this._activeHierarchyDefinition, props.parentNode), Sorting_js_1.sortNodesByLabelOperator, (0, rxjs_1.map)((n) => {
-            if ("processingParams" in n) {
-                delete n.processingParams;
-            }
-            return { ...n, children: (0, Common_js_1.hasChildren)(n) };
-        }), (0, rxjs_1.takeUntil)(this._dispose), (0, rxjs_1.finalize)(() => {
-            /* v8 ignore next -- @preserve */
-            (0, LoggingUtils_js_1.doLog)({
-                category: LOGGING_NAMESPACE_PERFORMANCE,
-                message: () => `[${props.requestContext.requestId}] Finished finalizing child nodes for ${(0, Common_js_1.createNodeIdentifierForLogging)(props.parentNode)}`,
-            });
-        }));
-    }
-    createHasNodesObservable(preprocessedNodesObservable, possiblyKnownChildrenObservable, props) {
-        const loggingCategory = `${LOGGING_NAMESPACE_INTERNAL}.HasNodes`;
-        return (0, rxjs_1.concat)((possiblyKnownChildrenObservable ?? rxjs_1.EMPTY).pipe((0, rxjs_1.filter)((n) => (0, Common_js_1.hasChildren)(n))), preprocessedNodesObservable).pipe(
-        /* v8 ignore next -- @preserve */
-        (0, LoggingUtils_js_1.log)({
-            category: loggingCategory,
-            message: (n) => `[${props.requestContext.requestId}] Node before mapping to 'true': ${(0, Common_js_1.createNodeIdentifierForLogging)(n)}`,
-        }), (0, rxjs_1.take)(1), (0, rxjs_1.map)(() => true), (0, rxjs_1.defaultIfEmpty)(false), (0, rxjs_1.catchError)((e) => {
-            /* v8 ignore next -- @preserve */
-            (0, LoggingUtils_js_1.doLog)({
-                category: loggingCategory,
-                message: () => `[${props.requestContext.requestId}] Error while determining children: ${e.message}`,
-            });
-            if (e instanceof HierarchyErrors_js_1.RowsLimitExceededError) {
-                return (0, rxjs_1.of)(true);
-            }
-            throw e;
-        }), 
-        /* v8 ignore next -- @preserve */
-        (0, LoggingUtils_js_1.log)({ category: loggingCategory, message: (r) => `[${props.requestContext.requestId}] Result: ${r}` }));
-    }
-    getCachedObservableEntry(props) {
-        const loggingCategory = `${LOGGING_NAMESPACE}.QueryResultsCache`;
-        const { parentNode, ...restProps } = props;
-        const cached = props.ignoreCache || !this._nodesCache ? undefined : this._nodesCache.get(props);
-        if (cached) {
-            /* v8 ignore next -- @preserve */
-            (0, LoggingUtils_js_1.doLog)({
-                category: loggingCategory,
-                message: () => `[${props.requestContext.requestId}] Found query nodes observable for ${(0, Common_js_1.createNodeIdentifierForLogging)(parentNode)}`,
-            });
-            return cached;
-        }
-        // if we don't find an entry for a grouping node, we load its instances by getting a query and applying
-        // a search based on grouped instance keys
-        let targetInstanceKeys;
-        let parentNonGroupingNode;
-        if (parentNode) {
-            if (HierarchyNode_js_1.HierarchyNode.isGroupingNode(parentNode)) {
-                parentNonGroupingNode = parentNode.nonGroupingAncestor;
-                targetInstanceKeys = parentNode.groupedInstanceKeys;
-            }
-            else {
-                // not sure why type checker doesn't pick this up
-                (0, core_bentley_1.assert)(HierarchyNode_js_1.HierarchyNode.isGeneric(parentNode) || HierarchyNode_js_1.HierarchyNode.isInstancesNode(parentNode));
-                parentNonGroupingNode = parentNode;
-            }
-        }
-        const nonGroupingNodeChildrenRequestProps = {
-            ...restProps,
-            parentNode: parentNonGroupingNode,
-            ...(targetInstanceKeys ? { targetInstanceKeys } : undefined),
-        };
-        const value = {
-            observable: this.createSourceNodesObservable(nonGroupingNodeChildrenRequestProps),
-            processingStatus: "none",
-        };
-        this._nodesCache?.set(nonGroupingNodeChildrenRequestProps, value);
-        /* v8 ignore next -- @preserve */
-        (0, LoggingUtils_js_1.doLog)({
-            category: loggingCategory,
-            message: () => `[${props.requestContext.requestId}] Saved query nodes observable for ${(0, Common_js_1.createNodeIdentifierForLogging)(parentNode)}`,
-        });
-        return value;
-    }
-    getChildNodesObservables(props) {
-        const entry = this.getCachedObservableEntry(props);
-        switch (entry.processingStatus) {
-            case "none": {
-                const pre = this.createPreProcessedNodesObservable(entry.observable, props);
-                const post = this.createProcessedNodesObservable(pre, props);
-                return {
-                    processedNodes: post,
-                    hasNodes: this.createHasNodesObservable(pre, entry.observable, props),
-                    finalizedNodes: this.createFinalizedNodesObservable(post, props),
-                };
-            }
-            case "pre-processed": {
-                const post = this.createProcessedNodesObservable(entry.observable, props);
-                return {
-                    processedNodes: post,
-                    hasNodes: this.createHasNodesObservable(entry.observable, undefined, props),
-                    finalizedNodes: this.createFinalizedNodesObservable(post, props),
-                };
-            }
-        }
-    }
-    /**
-     * Creates and runs a query based on provided props, then processes retrieved nodes and returns them.
-     */
-    getNodes(props) {
-        const requestContext = { requestId: core_bentley_1.Guid.createValue() };
-        const loggingCategory = `${LOGGING_NAMESPACE}.GetNodes`;
-        const timer = new core_bentley_1.StopWatch(undefined, true);
-        let error;
-        let nodesCount = 0;
-        /* v8 ignore next -- @preserve */
-        (0, LoggingUtils_js_1.doLog)({
-            category: loggingCategory,
-            message: () => `[${requestContext.requestId}] Requesting child nodes for ${(0, Common_js_1.createNodeIdentifierForLogging)(props.parentNode)}`,
-        });
-        return (0, EachValueFrom_js_1.eachValueFrom)(this.getChildNodesObservables({ ...props, requestContext }).finalizedNodes.pipe((0, rxjs_1.tap)(() => ++nodesCount), (0, rxjs_1.catchError)((e) => {
-            error = e;
-            throw e;
-        }), (0, rxjs_1.finalize)(() => {
-            /* v8 ignore next -- @preserve */
-            (0, LoggingUtils_js_1.doLog)({
-                category: loggingCategory,
-                message: () => error
-                    ? `[${requestContext.requestId}] Error creating child nodes for ${(0, Common_js_1.createNodeIdentifierForLogging)(props.parentNode)}: ${error instanceof Error ? error.message : error.toString()}`
-                    : `[${requestContext.requestId}] Returned ${nodesCount} child nodes for ${(0, Common_js_1.createNodeIdentifierForLogging)(props.parentNode)} in ${timer.currentSeconds.toFixed(2)} s.`,
-            });
-        })));
-    }
-    getNodeInstanceKeysObs(props) {
-        const { parentNode, instanceFilter, hierarchyLevelSizeLimit = "unbounded", requestContext } = props;
-        if (parentNode && HierarchyNode_js_1.HierarchyNode.isGroupingNode(parentNode)) {
-            return (0, rxjs_1.from)(parentNode.groupedInstanceKeys);
-        }
-        (0, core_bentley_1.assert)(!parentNode || HierarchyNode_js_1.HierarchyNode.isGeneric(parentNode) || HierarchyNode_js_1.HierarchyNode.isInstancesNode(parentNode));
-        // split the definitions based on whether they're for generic nodes or for instance nodes
-        const hierarchyLevelDefinitions = this.createHierarchyLevelDefinitionsObservable({
-            parentNode,
-            instanceFilter,
-            requestContext,
-        });
-        const [instanceDefs, genericDefs] = (0, Partition_js_1.partition)(hierarchyLevelDefinitions, (x) => IModelHierarchyDefinition_js_1.HierarchyNodesDefinition.isInstanceNodesQuery(x.hierarchyNodesDefinition));
-        // query instance keys and a flag whether they should be hidden
-        const instanceKeys = instanceDefs.pipe((0, rxjs_1.mergeMap)(({ imodelAccess, hierarchyNodesDefinition: def }) => this.getQueryScheduler(imodelAccess.imodelKey).scheduleSubscription((0, rxjs_1.of)(def.query).pipe((0, rxjs_1.mergeMap)(async (query) => {
-            const ecsql = `
-                SELECT
-                  ${NodeSelectQueryFactory_js_1.NodeSelectClauseColumnNames.FullClassName},
-                  ${NodeSelectQueryFactory_js_1.NodeSelectClauseColumnNames.ECInstanceId},
-                  ${NodeSelectQueryFactory_js_1.NodeSelectClauseColumnNames.HideNodeInHierarchy}
-                FROM (
-                  ${query.ecsql}
-                )
-              `;
-            const reader = imodelAccess.createQueryReader({ ...query, ecsql }, {
-                rowFormat: "Indexes",
-                limit: hierarchyLevelSizeLimit,
-                restartToken: `${this.#componentName}/${this.#componentId}/node-instance-keys/${core_bentley_1.Guid.createValue()}`,
-            });
-            return (0, rxjs_1.from)(reader).pipe((0, rxjs_1.map)((row) => ({
-                key: {
-                    className: (0, presentation_shared_1.normalizeFullClassName)(row[0]),
-                    id: row[1],
-                    imodelKey: imodelAccess.imodelKey,
-                },
-                hide: !!row[2],
-            })));
-        }), (0, rxjs_1.mergeAll)()))));
-        // split the instance keys observable based on whether they should be hidden or not
-        const [visibleNodeInstanceKeys, hiddenNodeInstanceKeys] = (0, Partition_js_1.partition)(instanceKeys, ({ hide }) => !hide);
-        // hidden items' handling:
-        // - if a generic node is hidden, we'll want to retrieve instance keys of its children, otherwise we don't care about it,
-        // - if an instance key is hidden, we want to create a merged node similar to what we do in `createHideNodesInHierarchyOperator`
-        const hiddenParentNodes = (0, rxjs_1.merge)(genericDefs.pipe((0, rxjs_1.filter)(({ hierarchyNodesDefinition }) => !!hierarchyNodesDefinition.node.processingParams?.hideInHierarchy), (0, rxjs_1.map)(({ hierarchyNodesDefinition }) => ({
-            type: "generic",
-            id: hierarchyNodesDefinition.node.key,
-            source: this.#sourceName,
-        }))), hiddenNodeInstanceKeys.pipe(
-        // first merge all keys by class
-        (0, ReduceToMergeMap_js_1.reduceToMergeMapList)(({ key }) => key.className, ({ key }) => key), 
-        // then, for each class, create an instance key
-        (0, rxjs_1.mergeMap)((mergedMap) => [...mergedMap.entries()].map(([className, keys]) => ({
-            type: "instances",
-            instanceKeys: keys.map(({ id, imodelKey }) => ({ className, id, imodelKey })),
-        }))))).pipe((0, rxjs_1.map)((key) => ({ key, parentKeys: [], label: "" })));
-        // merge visible instance keys from this level & the ones we get recursively requesting from deeper levels
-        return (0, rxjs_1.merge)(visibleNodeInstanceKeys.pipe((0, rxjs_1.map)(({ key }) => key)), hiddenParentNodes.pipe((0, rxjs_1.mergeMap)((hiddenNode) => this.getNodeInstanceKeysObs({ parentNode: hiddenNode, requestContext })))).pipe((0, rxjs_1.takeUntil)(this._dispose));
-    }
-    /**
-     * Creates an iterator for all child hierarchy level instance keys, taking into account any hidden hierarchy levels
-     * that there may be under the given parent node.
-     */
-    getNodeInstanceKeys(props) {
-        const requestContext = { requestId: core_bentley_1.Guid.createValue() };
-        const loggingCategory = `${LOGGING_NAMESPACE}.GetNodeInstanceKeys`;
-        const timer = new core_bentley_1.StopWatch(undefined, true);
-        /* v8 ignore next -- @preserve */
-        (0, LoggingUtils_js_1.doLog)({
-            category: loggingCategory,
-            message: () => `[${requestContext.requestId}] Requesting keys for ${(0, Common_js_1.createNodeIdentifierForLogging)(props.parentNode)}`,
-        });
-        let error;
-        let keysCount = 0;
-        return (0, EachValueFrom_js_1.eachValueFrom)(this.getNodeInstanceKeysObs({ ...props, requestContext }).pipe((0, rxjs_1.tap)(() => ++keysCount), (0, rxjs_1.catchError)((e) => {
-            error = e;
-            throw e;
-        }), (0, rxjs_1.finalize)(() => {
-            /* v8 ignore next -- @preserve */
-            (0, LoggingUtils_js_1.doLog)({
-                category: loggingCategory,
-                message: () => error
-                    ? `[${requestContext.requestId}] Error creating node instance keys for ${(0, Common_js_1.createNodeIdentifierForLogging)(props.parentNode)}: ${error instanceof Error ? error.message : error.toString()}`
-                    : `[${requestContext.requestId}] Returned ${keysCount} instance keys for ${(0, Common_js_1.createNodeIdentifierForLogging)(props.parentNode)} in ${timer.currentSeconds.toFixed(2)} s.`,
-            });
-        })));
-    }
-}
-function preProcessNodes(hierarchyFactory, parentNode) {
-    return hierarchyFactory.preProcessNode ? processNodes(hierarchyFactory.preProcessNode, parentNode) : rxjs_1.identity;
-}
-function postProcessNodes(hierarchyFactory, parentNode) {
-    return hierarchyFactory.postProcessNode ? processNodes(hierarchyFactory.postProcessNode, parentNode) : rxjs_1.identity;
-}
-function processNodes(processor, parentNode) {
-    return (nodes) => nodes.pipe((0, rxjs_1.mergeMap)((node) => processor({ node, parentNode })));
-}
-function applyLabelsFormatting(node, valueFormatter) {
-    return (0, rxjs_1.from)((0, presentation_shared_1.formatConcatenatedValue)({ value: node.label, valueFormatter })).pipe((0, rxjs_1.map)((label) => ({ ...node, label })));
-}
-function createParentNodeKeysList(parentNode) {
-    if (!parentNode) {
-        return [];
-    }
-    return [...parentNode.parentKeys, parentNode.key];
-}
-function createInstanceKeysFilteredQuery(query, targetInstanceKeys) {
-    if (!targetInstanceKeys || !targetInstanceKeys.length) {
-        return query;
-    }
-    if (Array.isArray(query.bindings)) {
-        return {
-            ...query,
-            ecsql: `
-        SELECT *
-        FROM (${query.ecsql}) q
-        JOIN IdSet(?) targetInstanceKeys ON targetInstanceKeys.id = q.ECInstanceId
-        ECSQLOPTIONS ENABLE_EXPERIMENTAL_FEATURES
-      `,
-            bindings: [...query.bindings, { type: "idset", value: targetInstanceKeys.map((k) => k.id) }],
-        };
-    }
-    const ecsqlVarTargetInstanceKeys = `${Utils_js_1.ECSQL_PREFIX}targetInstanceKeys`;
-    return {
-        ...query,
-        ecsql: `
-      SELECT *
-      FROM (${query.ecsql}) q
-      JOIN IdSet(:${ecsqlVarTargetInstanceKeys}) targetInstanceKeys ON targetInstanceKeys.id = q.ECInstanceId
-      ECSQLOPTIONS ENABLE_EXPERIMENTAL_FEATURES
-    `,
-        bindings: {
-            ...query.bindings,
-            [ecsqlVarTargetInstanceKeys]: { type: "idset", value: targetInstanceKeys.map((k) => k.id) },
-        },
-    };
-}
-// TODO: MISSING_COVERAGE
-/* v8 ignore start */
-function mergeNodes(source) {
-    return (0, rxjs_1.from)(source).pipe((0, rxjs_1.reduce)((acc, input) => {
-        for (let i = 0; i < acc.length; ++i) {
-            if (input.imodelAccess === acc[i].imodelAccess) {
-                // don't attempt to merge nodes if they come from the same provider
-                continue;
-            }
-            // the first argument for `tryMergeNodes` acts as the primary data source, so we have to make sure we pass
-            // the node with higher `imodelAccessIndex` first
-            const candidates = input.imodelAccessIndex > acc[i].imodelAccessIndex
-                ? {
-                    imodelAccess: input.imodelAccess,
-                    imodelAccessIndex: input.imodelAccessIndex,
-                    primary: input.node,
-                    secondary: acc[i].node,
-                }
-                : {
-                    imodelAccess: acc[i].imodelAccess,
-                    imodelAccessIndex: acc[i].imodelAccessIndex,
-                    primary: acc[i].node,
-                    secondary: input.node,
-                };
-            const merged = tryMergeNodes(candidates.primary, candidates.secondary);
-            if (merged) {
-                acc[i] = {
-                    node: merged,
-                    imodelAccess: candidates.imodelAccess,
-                    imodelAccessIndex: candidates.imodelAccessIndex,
-                };
-                return acc;
-            }
-        }
-        acc.push(input);
-        return acc;
-    }, new Array()), (0, rxjs_1.mergeAll)());
-}
-function mergeSearchAttribute(primary, secondary) {
-    if (!primary) {
-        return secondary;
-    }
-    if (!secondary) {
-        return primary;
-    }
-    const hasSearchTargetAncestor = primary.hasSearchTargetAncestor || secondary.hasSearchTargetAncestor;
-    const isSearchTarget = primary.isSearchTarget || secondary.isSearchTarget;
-    const searchOptions = HierarchySearch_js_1.HierarchySearchTree.mergeOptions(primary.options, secondary.options);
-    const childrenTargetPathsBuilder = HierarchySearch_js_1.HierarchySearchTree.createBuilder();
-    primary.childrenTargetPaths?.forEach((tree) => childrenTargetPathsBuilder.accept({ tree }));
-    secondary.childrenTargetPaths?.forEach((tree) => childrenTargetPathsBuilder.accept({ tree }));
-    const childrenTargetPaths = childrenTargetPathsBuilder.getTree();
-    return {
-        ...(hasSearchTargetAncestor ? { hasSearchTargetAncestor } : undefined),
-        ...(childrenTargetPaths.length ? { childrenTargetPaths } : undefined),
-        ...(isSearchTarget ? { isSearchTarget } : undefined),
-        ...(searchOptions ? { options: searchOptions } : undefined),
-    };
-}
-function mergeBaseNodeAttributes(primary, secondary) {
-    const search = mergeSearchAttribute(primary.search, secondary.search);
-    return {
-        ...(primary.autoExpand || secondary.autoExpand ? { autoExpand: true } : undefined),
-        ...(primary.children && secondary.children ? { children: true } : undefined),
-        ...(primary.supportsFiltering || secondary.supportsFiltering ? { supportsFiltering: true } : undefined),
-        ...(search ? { search } : undefined),
-    };
-}
-function tryMergeInstanceNodes(primary, secondary) {
-    if (HierarchyNode_js_1.HierarchyNode.isInstancesNode(primary) &&
-        HierarchyNode_js_1.HierarchyNode.isInstancesNode(secondary) &&
-        primary.key.instanceKeys.some((lhsKey) => secondary.key.instanceKeys.some((rhsKey) => presentation_shared_1.InstanceKey.equals(lhsKey, rhsKey)))) {
-        return {
-            ...primary,
-            key: { type: "instances", instanceKeys: primary.key.instanceKeys.concat(secondary.key.instanceKeys) },
-            ...mergeBaseNodeAttributes(primary, secondary),
-        };
-    }
-    return undefined;
-}
-function tryMergeGenericNodes(primary, secondary) {
-    if (HierarchyNode_js_1.HierarchyNode.isGeneric(primary) && HierarchyNode_js_1.HierarchyNode.isGeneric(secondary) && primary.key.id === secondary.key.id) {
-        return { ...primary, ...mergeBaseNodeAttributes(primary, secondary) };
-    }
-    return undefined;
-}
-function tryMergeNodes(primary, secondary) {
-    return tryMergeInstanceNodes(primary, secondary) ?? tryMergeGenericNodes(primary, secondary) ?? undefined;
-}
-/* v8 ignore stop */
-//# sourceMappingURL=IModelHierarchyProvider.js.map