@itwin/presentation-hierarchies 0.1.5 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,85 @@
 # @itwin/presentation-hierarchies
 
+## 0.2.0
+
+### Minor Changes
+
+- [#642](https://github.com/iTwin/presentation/pull/642): Added `onlyIfNotHandled` flag to hierarchy level definitions that are passed to `createClassBasedHierarchyDefinition`.
+  This flag allows to skip instance node hierarchy level definitions if previous ones have defined hierarchy levels for a more specific class.
+  This can help to reduce repetition having to check if class doesn't match those of the more specific definitions.
+
+  Before:
+
+  ```ts
+  createClassBasedHierarchyDefinition({
+    classHierarchyInspector: inspector,
+    hierarchy: {
+      childNodes: [
+        {
+          parentNodeClassName: "BisCore.PhysicalElement",
+          definitions: async ({ parentNode }) => getPhysicalElementChildren(parentNode),
+        },
+        {
+          parentNodeClassName: "BisCore.SpatialElement",
+          definitions: async ({ parentNode, parentNodeClassName }) => {
+            if (await inspector.classDerivesFrom(parentNodeClassName, "BisCore.PhysicalElement")) {
+              return [];
+            }
+
+            return getSpatialElementChildren(parentNode);
+          },
+        },
+        {
+          parentNodeClassName: "BisCore.GeometricElement3d",
+          definitions: async ({ parentNode, parentNodeClassName }) => {
+            if (await inspector.classDerivesFrom(parentNodeClassName, "BisCore.PhysicalElement")) {
+              return [];
+            }
+
+            if (await inspector.classDerivesFrom(parentNodeClassName, "BisCore.SpatialElement")) {
+              return [];
+            }
+
+            return getGeometricElement3dChildren(parentNode);
+          },
+        },
+      ],
+    },
+  });
+  ```
+
+  After:
+
+  ```ts
+  createClassBasedHierarchyDefinition({
+    classHierarchyInspector,
+    hierarchy: {
+      childNodes: [
+        {
+          parentNodeClassName: "BisCore.PhysicalElement",
+          definitions: async ({ parentNode }) => getPhysicalElementChildren(parentNode),
+        },
+        {
+          parentNodeClassName: "BisCore.SpatialElement",
+          onlyIfNotHandled: true,
+          definitions: async ({ parentNode }) => getSpatialElementChildren(parentNode),
+        },
+        {
+          parentNodeClassName: "BisCore.GeometricElement3d",
+          onlyIfNotHandled: true,
+          definitions: async ({ parentNode }) => getGeometricElement3dChildren(parentNode),
+        },
+      ],
+    },
+  });
+  ```
+
+## 0.1.6
+
+### Patch Changes
+
+- [#634](https://github.com/iTwin/presentation/pull/634): `NodeSelectQueryFactory.createWhereClause`: Fixed `like` operator not matching substrings.
+
 ## 0.1.5
 
 ### Patch Changes

package/lib/cjs/hierarchies/HierarchyDefinition.d.ts

@@ -157,6 +157,24 @@ interface InstancesNodeChildHierarchyLevelDefinition {
      * Called to create a hierarchy level definition when the class check passes (see `parentNodeClassName`).
      */
     definitions: (requestProps: DefineInstanceNodeChildHierarchyLevelProps) => Promise<HierarchyLevelDefinition>;
+    /**
+     * If set to true, and node matches at least one of the previous definitions, this definition will not be applied.
+     *
+     * For example:
+     * ```ts
+     * {
+     *   parentNodeClassName: "BisCore.GeometricElement3d",
+     *   definitions: () => ...,
+     * },
+     * // This will apply to all elements, that are not BisCore.GeometricElement3d
+     * {
+     *   parentNodeClassName: "BisCore.Element",
+     *   onlyIfNotHandled: true,
+     *   definitions: () => ...,
+     * }
+     * ```
+     */
+    onlyIfNotHandled?: boolean;
 }
 /**
  * Props for defining child hierarchy level for specific parent custom node.

package/lib/cjs/hierarchies/HierarchyDefinition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HierarchyDefinition.d.ts","sourceRoot":"","sources":["../../../src/hierarchies/HierarchyDefinition.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"HierarchyDefinition.d.ts","sourceRoot":"","sources":["../../../src/hierarchies/HierarchyDefinition.ts"],"names":[],"mappings":"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"}

package/lib/cjs/hierarchies/HierarchyDefinition.js

@@ -6,6 +6,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createClassBasedHierarchyDefinition = exports.HierarchyNodesDefinition = void 0;
 const HierarchyNode_1 = require("./HierarchyNode");
+const rxjs_1 = require("rxjs");
 /** @beta */
 // eslint-disable-next-line @typescript-eslint/no-redeclare
 var HierarchyNodesDefinition;
@@ -66,12 +67,13 @@ class ClassBasedHierarchyDefinition {
     }
 }
 async function createHierarchyLevelDefinitions(classHierarchy, defs, requestProps) {
-    return (await Promise.all(defs.map(async (def) => {
+    const obs = (0, rxjs_1.from)(defs).pipe((0, rxjs_1.mergeMap)(async (def, idx) => {
         if (await classHierarchy.classDerivesFrom(requestProps.parentNodeClassName, def.parentNodeClassName)) {
-            return def.definitions(requestProps);
+            return { def, idx };
         }
-        return [];
-    }))).flat();
+        return undefined;
+    }), (0, rxjs_1.filter)((x) => !!x), (0, rxjs_1.toArray)(), (0, rxjs_1.concatMap)((x) => x.sort((a, b) => a.idx - b.idx).map(({ def }) => def)), (0, rxjs_1.filter)((def, idx) => !def.onlyIfNotHandled || idx === 0), (0, rxjs_1.mergeMap)(async (def) => def.definitions(requestProps)), (0, rxjs_1.mergeAll)());
+    return (0, rxjs_1.firstValueFrom)(obs.pipe((0, rxjs_1.toArray)()));
 }
 function groupInstanceIdsByClass(instanceKeys) {
     const instanceIdsByClass = new Map();

package/lib/cjs/hierarchies/HierarchyDefinition.js.map

@@ -1 +1 @@
-{"version":3,"file":"HierarchyDefinition.js","sourceRoot":"","sources":["../../../src/hierarchies/HierarchyDefinition.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n\nimport { Id64String } from \"@itwin/core-bentley\";\nimport { GenericInstanceFilter } from \"@itwin/core-common\";\nimport { ECClassHierarchyInspector, ECSqlQueryDef, InstanceKey } from \"@itwin/presentation-shared\";\nimport {\n  HierarchyNode,\n  NonGroupingHierarchyNode,\n  ParsedCustomHierarchyNode,\n  ParsedInstanceHierarchyNode,\n  ProcessedCustomHierarchyNode,\n  ProcessedHierarchyNode,\n  ProcessedInstanceHierarchyNode,\n} from \"./HierarchyNode\";\nimport { InstancesNodeKey } from \"./HierarchyNodeKey\";\n\n/** A nodes definition that returns a single custom defined node. */\nexport interface CustomHierarchyNodeDefinition {\n  /** The node to be created in the hierarchy level */\n  node: ParsedCustomHierarchyNode;\n}\n\n/** A nodes definition that returns an ECSQL query for selecting nodes from an iModel. */\nexport interface InstanceNodesQueryDefinition {\n  /**\n   * Full name of the class whose instances are going to be returned. It's okay if the attribute\n   * points to a base class of multiple different classes of instances returned by the query, however\n   * the more specific this class is, the more efficient hierarchy building process is.\n   */\n  fullClassName: string;\n  /**\n   * An ECSQL query that selects nodes from an iModel. `SELECT` clause of the query is expected\n   * to be built using `NodeSelectQueryFactory.createSelectClause`.\n   */\n  query: ECSqlQueryDef;\n}\n\n/**\n * A definition of nodes included in a hierarchy level.\n * @beta\n */\nexport type HierarchyNodesDefinition = CustomHierarchyNodeDefinition | InstanceNodesQueryDefinition;\n/** @beta */\n// eslint-disable-next-line @typescript-eslint/no-redeclare\nexport namespace HierarchyNodesDefinition {\n  export function isCustomNode(def: HierarchyNodesDefinition): def is CustomHierarchyNodeDefinition {\n    return !!(def as CustomHierarchyNodeDefinition).node;\n  }\n  export function isInstanceNodesQuery(def: HierarchyNodesDefinition): def is InstanceNodesQueryDefinition {\n    return !!(def as InstanceNodesQueryDefinition).query;\n  }\n}\n\n/**\n * A definition of a hierarchy level, which may consist of multiple node definitions.\n * @beta\n */\nexport type HierarchyLevelDefinition = HierarchyNodesDefinition[];\n\n/**\n * A type for a function that parses a `ParsedInstanceHierarchyNode` from provided ECSQL `row` object.\n * @beta\n */\nexport type NodeParser = (row: { [columnName: string]: any }) => ParsedInstanceHierarchyNode;\n\n/**\n * A type for a function that pre-processes given node. Unless the function decides not to make any modifications,\n * it should return a new - modified - node, rather than modifying the given one. Returning `undefined` omits the node\n * from the hierarchy.\n *\n * @beta\n */\nexport type NodePreProcessor = <TNode extends ProcessedCustomHierarchyNode | ProcessedInstanceHierarchyNode>(node: TNode) => Promise<TNode | undefined>;\n\n/**\n * A type for a function that post-processes given node. Unless the function decides not to make any modifications,\n * it should return a new - modified - node, rather than modifying the given one.\n *\n * @beta\n */\nexport type NodePostProcessor = (node: ProcessedHierarchyNode) => Promise<ProcessedHierarchyNode>;\n\n/**\n * A type of node that can be passed to `HierarchyDefinition.defineHierarchyLevel`. This basically means\n * a `HierarchyNode` that:\n * - knows nothing about its children,\n * - is either an instances node (key is of `InstancesNodeKey` type) or a custom node (key is of `string` type).\n */\ntype HierarchyDefinitionParentNode = Omit<NonGroupingHierarchyNode, \"children\">;\n\n/**\n * Props for `HierarchyDefinition.defineHierarchyLevel`.\n * @beta\n */\nexport interface DefineHierarchyLevelProps {\n  /** Parent node to get children for. Pass `undefined` to get root nodes. */\n  parentNode: HierarchyDefinitionParentNode | undefined;\n\n  /** Optional hierarchy level filter. */\n  instanceFilter?: GenericInstanceFilter;\n}\n\n/**\n * An interface for a factory that knows how define a hierarchy based on a given parent node.\n * @beta\n */\nexport interface HierarchyDefinition {\n  /**\n   * An optional function for parsing ECInstance node from ECSQL row.\n   *\n   * Should be used in situations when the `HierarchyDefinition` implementation\n   * introduces additional ECSQL columns into the select clause and wants to assign additional\n   * data to the nodes it produces.\n   *\n   * Defaults to a function that parses all `HierarchyNode` attributes from a query, whose SELECT\n   * clause is created using `NodeSelectQueryFactory.createSelectClause`.\n   */\n  parseNode?: NodeParser;\n\n  /**\n   * An optional function for pre-processing nodes.\n   *\n   * Pre-processing happens immediately after the nodes are loaded based on `HierarchyLevelDefinition`\n   * returned by this `HierarchyDefinition` and before their processing (hiding, grouping, sorting, etc.) starts.\n   * The step allows assigning nodes additional data or excluding them from the hierarchy based on some attributes.\n   */\n  preProcessNode?: NodePreProcessor;\n\n  /**\n   * An optional function for post-processing nodes.\n   *\n   * Post-processing happens after the loaded nodes go through all the merging, hiding and grouping\n   * steps, but before sorting them. This step allows `HierarchyDefinition` implementations to assign additional data\n   * to nodes after they're processed. This is especially true for grouping nodes as they're only created during\n   * processing.\n   */\n  postProcessNode?: NodePostProcessor;\n\n  /** A function to create a hierarchy level definition for given parent node. */\n  defineHierarchyLevel(props: DefineHierarchyLevelProps): Promise<HierarchyLevelDefinition>;\n}\n\n/**\n * Props for defining child hierarchy level for specific parent instance node.\n * @see `createClassBasedHierarchyDefinition`\n * @beta\n */\nexport type DefineInstanceNodeChildHierarchyLevelProps = Omit<DefineHierarchyLevelProps, \"parentNode\"> & {\n  /** The parent instance node. */\n  parentNode: Omit<HierarchyDefinitionParentNode, \"key\"> & { key: InstancesNodeKey };\n\n  /**\n   * Full name of the parent instance node class.\n   *\n   * The `parentNode.key` also contains information about the instances the parent node is based on. However,\n   * an instance node may be based on instances of multiple classes. In case that happens, parent node's instance\n   * keys are grouped by class and a hierarchy level definition is requested for each combination of class and\n   * instance IDs (with the same `parentNode`).\n   */\n  parentNodeClassName: string;\n\n  /**\n   * ECInstanceIds of the parent instance node.\n   *\n   * The `parentNode.key` also contains information about the instances the parent node is based on. However,\n   * an instance node may be based on instances of multiple classes. In case that happens, parent node's instance\n   * keys are grouped by class and a hierarchy level definition is requested for each combination of class and\n   * instance IDs (with the same `parentNode`).\n   */\n  parentNodeInstanceIds: Id64String[];\n};\n\n/**\n * A definition of a hierarchy level that should be used for specific class of parent instance nodes.\n */\ninterface InstancesNodeChildHierarchyLevelDefinition {\n  /**\n   * Full name of the parent instance node's class to match against when checking if this hierarchy\n   * level should be used for specific parent instance node.\n   *\n   * The check is polymorphic, so `BisCore.Element` class would match `BisCore.GeometricElement`, `BisCore.Category` and\n   * all other element classes.\n   */\n  parentNodeClassName: string;\n\n  /**\n   * Called to create a hierarchy level definition when the class check passes (see `parentNodeClassName`).\n   */\n  definitions: (requestProps: DefineInstanceNodeChildHierarchyLevelProps) => Promise<HierarchyLevelDefinition>;\n}\n\n/**\n * Props for defining child hierarchy level for specific parent custom node.\n * @see `createClassBasedHierarchyDefinition`\n * @beta\n */\nexport type DefineCustomNodeChildHierarchyLevelProps = Omit<DefineHierarchyLevelProps, \"parentNode\"> & {\n  /** The parent custom node. */\n  parentNode: Omit<HierarchyDefinitionParentNode, \"key\"> & { key: string };\n};\n\n/**\n * A definition of a hierarchy level for that should be used for specific custom parent nodes.\n */\ninterface CustomNodeChildHierarchyLevelDefinition {\n  /**\n   * `HierarchyNode.key` of the custom node that this child hierarchy level definition should be used for.\n   */\n  customParentNodeKey: string;\n\n  /**\n   * Called to create a hierarchy level definition when the node key check passes (see `customParentNodeKey`).\n   */\n  definitions: (requestProps: DefineCustomNodeChildHierarchyLevelProps) => Promise<HierarchyLevelDefinition>;\n}\n\n/**\n * A hierarchy level definition associated with either parent instance node's class or custom\n * node's key.\n */\ntype ClassBasedHierarchyLevelDefinition = InstancesNodeChildHierarchyLevelDefinition | CustomNodeChildHierarchyLevelDefinition;\n\n/**\n * Props for defining root hierarchy level.\n * @see `createClassBasedHierarchyDefinition`\n * @beta\n */\nexport type DefineRootHierarchyLevelProps = Omit<DefineHierarchyLevelProps, \"parentNode\">;\n\n/**\n * Props for `createClassBasedHierarchyDefinition`.\n */\ninterface ClassBasedHierarchyDefinitionProps {\n  /** Access to ECClass hierarchy in the iModel */\n  classHierarchyInspector: ECClassHierarchyInspector;\n\n  /** Hierarchy level definitions based on parent instance node's class or custom node's key. */\n  hierarchy: {\n    /** Called to create the root hierarchy level definition. */\n    rootNodes: (props: DefineRootHierarchyLevelProps) => Promise<HierarchyLevelDefinition>;\n\n    /**\n     * Called to get child hierarchy level definitions based on parent instance node's class\n     * or custom node's key.\n     */\n    childNodes: ClassBasedHierarchyLevelDefinition[];\n  };\n}\n\n/**\n * Creates an instance of `HierarchyDefinition` that uses a somewhat declarative approach to define the\n * hierarchy - each hierarchy level is assigned either an instance node's class or custom node's\n * key and they're used to assign hierarchy level definitions based on parent node.\n *\n * @beta\n */\nexport function createClassBasedHierarchyDefinition(props: ClassBasedHierarchyDefinitionProps): HierarchyDefinition {\n  return new ClassBasedHierarchyDefinition(props);\n}\n\nclass ClassBasedHierarchyDefinition implements HierarchyDefinition {\n  public constructor(private _props: ClassBasedHierarchyDefinitionProps) {}\n\n  /**\n   * Create hierarchy level definitions for specific hierarchy level.\n   * @param parentNode Parent node to create children definitions for.\n   */\n  public async defineHierarchyLevel(props: DefineHierarchyLevelProps): Promise<HierarchyLevelDefinition> {\n    const { parentNode } = props;\n    if (!parentNode) {\n      return this._props.hierarchy.rootNodes(props);\n    }\n\n    if (HierarchyNode.isCustom(parentNode)) {\n      const defs = this._props.hierarchy.childNodes\n        .filter(isCustomNodeChildHierarchyLevelDefinition)\n        .filter((def) => def.customParentNodeKey === parentNode.key);\n      return (await Promise.all(defs.map(async (def) => def.definitions({ ...props, parentNode })))).flat();\n    }\n\n    // istanbul ignore else\n    if (HierarchyNode.isInstancesNode(parentNode)) {\n      const instanceIdsByClass = groupInstanceIdsByClass(parentNode.key.instanceKeys);\n      const instancesParentNodeDefs = this._props.hierarchy.childNodes.filter(isInstancesNodeChildHierarchyLevelDefinition);\n      return (\n        await Promise.all(\n          [...instanceIdsByClass.entries()].map(async ([parentNodeClassName, parentNodeInstanceIds]) =>\n            createHierarchyLevelDefinitions(this._props.classHierarchyInspector, instancesParentNodeDefs, {\n              ...props,\n              parentNodeClassName,\n              parentNodeInstanceIds,\n              parentNode,\n            }),\n          ),\n        )\n      ).flat();\n    }\n\n    // istanbul ignore next\n    return [];\n  }\n}\n\nasync function createHierarchyLevelDefinitions(\n  classHierarchy: ECClassHierarchyInspector,\n  defs: InstancesNodeChildHierarchyLevelDefinition[],\n  requestProps: DefineInstanceNodeChildHierarchyLevelProps,\n) {\n  return (\n    await Promise.all(\n      defs.map(async (def) => {\n        if (await classHierarchy.classDerivesFrom(requestProps.parentNodeClassName, def.parentNodeClassName)) {\n          return def.definitions(requestProps);\n        }\n        return [];\n      }),\n    )\n  ).flat();\n}\n\nfunction groupInstanceIdsByClass(instanceKeys: InstanceKey[]) {\n  const instanceIdsByClass = new Map<string, Id64String[]>();\n  instanceKeys.forEach((key) => {\n    let instanceIds = instanceIdsByClass.get(key.className);\n    if (!instanceIds) {\n      instanceIds = [];\n      instanceIdsByClass.set(key.className, instanceIds);\n    }\n    instanceIds.push(key.id);\n  });\n  return instanceIdsByClass;\n}\n\nfunction isCustomNodeChildHierarchyLevelDefinition(def: ClassBasedHierarchyLevelDefinition): def is CustomNodeChildHierarchyLevelDefinition {\n  return !!(def as CustomNodeChildHierarchyLevelDefinition).customParentNodeKey;\n}\n\nfunction isInstancesNodeChildHierarchyLevelDefinition(def: ClassBasedHierarchyLevelDefinition): def is InstancesNodeChildHierarchyLevelDefinition {\n  return !!(def as InstancesNodeChildHierarchyLevelDefinition).parentNodeClassName;\n}\n"]}
+{"version":3,"file":"HierarchyDefinition.js","sourceRoot":"","sources":["../../../src/hierarchies/HierarchyDefinition.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n\nimport { Id64String } from \"@itwin/core-bentley\";\nimport { GenericInstanceFilter } from \"@itwin/core-common\";\nimport { ECClassHierarchyInspector, ECSqlQueryDef, InstanceKey } from \"@itwin/presentation-shared\";\nimport {\n  HierarchyNode,\n  NonGroupingHierarchyNode,\n  ParsedCustomHierarchyNode,\n  ParsedInstanceHierarchyNode,\n  ProcessedCustomHierarchyNode,\n  ProcessedHierarchyNode,\n  ProcessedInstanceHierarchyNode,\n} from \"./HierarchyNode\";\nimport { InstancesNodeKey } from \"./HierarchyNodeKey\";\nimport { concatMap, filter, firstValueFrom, from, mergeAll, mergeMap, toArray } from \"rxjs\";\n\n/** A nodes definition that returns a single custom defined node. */\nexport interface CustomHierarchyNodeDefinition {\n  /** The node to be created in the hierarchy level */\n  node: ParsedCustomHierarchyNode;\n}\n\n/** A nodes definition that returns an ECSQL query for selecting nodes from an iModel. */\nexport interface InstanceNodesQueryDefinition {\n  /**\n   * Full name of the class whose instances are going to be returned. It's okay if the attribute\n   * points to a base class of multiple different classes of instances returned by the query, however\n   * the more specific this class is, the more efficient hierarchy building process is.\n   */\n  fullClassName: string;\n  /**\n   * An ECSQL query that selects nodes from an iModel. `SELECT` clause of the query is expected\n   * to be built using `NodeSelectQueryFactory.createSelectClause`.\n   */\n  query: ECSqlQueryDef;\n}\n\n/**\n * A definition of nodes included in a hierarchy level.\n * @beta\n */\nexport type HierarchyNodesDefinition = CustomHierarchyNodeDefinition | InstanceNodesQueryDefinition;\n/** @beta */\n// eslint-disable-next-line @typescript-eslint/no-redeclare\nexport namespace HierarchyNodesDefinition {\n  export function isCustomNode(def: HierarchyNodesDefinition): def is CustomHierarchyNodeDefinition {\n    return !!(def as CustomHierarchyNodeDefinition).node;\n  }\n  export function isInstanceNodesQuery(def: HierarchyNodesDefinition): def is InstanceNodesQueryDefinition {\n    return !!(def as InstanceNodesQueryDefinition).query;\n  }\n}\n\n/**\n * A definition of a hierarchy level, which may consist of multiple node definitions.\n * @beta\n */\nexport type HierarchyLevelDefinition = HierarchyNodesDefinition[];\n\n/**\n * A type for a function that parses a `ParsedInstanceHierarchyNode` from provided ECSQL `row` object.\n * @beta\n */\nexport type NodeParser = (row: { [columnName: string]: any }) => ParsedInstanceHierarchyNode;\n\n/**\n * A type for a function that pre-processes given node. Unless the function decides not to make any modifications,\n * it should return a new - modified - node, rather than modifying the given one. Returning `undefined` omits the node\n * from the hierarchy.\n *\n * @beta\n */\nexport type NodePreProcessor = <TNode extends ProcessedCustomHierarchyNode | ProcessedInstanceHierarchyNode>(node: TNode) => Promise<TNode | undefined>;\n\n/**\n * A type for a function that post-processes given node. Unless the function decides not to make any modifications,\n * it should return a new - modified - node, rather than modifying the given one.\n *\n * @beta\n */\nexport type NodePostProcessor = (node: ProcessedHierarchyNode) => Promise<ProcessedHierarchyNode>;\n\n/**\n * A type of node that can be passed to `HierarchyDefinition.defineHierarchyLevel`. This basically means\n * a `HierarchyNode` that:\n * - knows nothing about its children,\n * - is either an instances node (key is of `InstancesNodeKey` type) or a custom node (key is of `string` type).\n */\ntype HierarchyDefinitionParentNode = Omit<NonGroupingHierarchyNode, \"children\">;\n\n/**\n * Props for `HierarchyDefinition.defineHierarchyLevel`.\n * @beta\n */\nexport interface DefineHierarchyLevelProps {\n  /** Parent node to get children for. Pass `undefined` to get root nodes. */\n  parentNode: HierarchyDefinitionParentNode | undefined;\n\n  /** Optional hierarchy level filter. */\n  instanceFilter?: GenericInstanceFilter;\n}\n\n/**\n * An interface for a factory that knows how define a hierarchy based on a given parent node.\n * @beta\n */\nexport interface HierarchyDefinition {\n  /**\n   * An optional function for parsing ECInstance node from ECSQL row.\n   *\n   * Should be used in situations when the `HierarchyDefinition` implementation\n   * introduces additional ECSQL columns into the select clause and wants to assign additional\n   * data to the nodes it produces.\n   *\n   * Defaults to a function that parses all `HierarchyNode` attributes from a query, whose SELECT\n   * clause is created using `NodeSelectQueryFactory.createSelectClause`.\n   */\n  parseNode?: NodeParser;\n\n  /**\n   * An optional function for pre-processing nodes.\n   *\n   * Pre-processing happens immediately after the nodes are loaded based on `HierarchyLevelDefinition`\n   * returned by this `HierarchyDefinition` and before their processing (hiding, grouping, sorting, etc.) starts.\n   * The step allows assigning nodes additional data or excluding them from the hierarchy based on some attributes.\n   */\n  preProcessNode?: NodePreProcessor;\n\n  /**\n   * An optional function for post-processing nodes.\n   *\n   * Post-processing happens after the loaded nodes go through all the merging, hiding and grouping\n   * steps, but before sorting them. This step allows `HierarchyDefinition` implementations to assign additional data\n   * to nodes after they're processed. This is especially true for grouping nodes as they're only created during\n   * processing.\n   */\n  postProcessNode?: NodePostProcessor;\n\n  /** A function to create a hierarchy level definition for given parent node. */\n  defineHierarchyLevel(props: DefineHierarchyLevelProps): Promise<HierarchyLevelDefinition>;\n}\n\n/**\n * Props for defining child hierarchy level for specific parent instance node.\n * @see `createClassBasedHierarchyDefinition`\n * @beta\n */\nexport type DefineInstanceNodeChildHierarchyLevelProps = Omit<DefineHierarchyLevelProps, \"parentNode\"> & {\n  /** The parent instance node. */\n  parentNode: Omit<HierarchyDefinitionParentNode, \"key\"> & { key: InstancesNodeKey };\n\n  /**\n   * Full name of the parent instance node class.\n   *\n   * The `parentNode.key` also contains information about the instances the parent node is based on. However,\n   * an instance node may be based on instances of multiple classes. In case that happens, parent node's instance\n   * keys are grouped by class and a hierarchy level definition is requested for each combination of class and\n   * instance IDs (with the same `parentNode`).\n   */\n  parentNodeClassName: string;\n\n  /**\n   * ECInstanceIds of the parent instance node.\n   *\n   * The `parentNode.key` also contains information about the instances the parent node is based on. However,\n   * an instance node may be based on instances of multiple classes. In case that happens, parent node's instance\n   * keys are grouped by class and a hierarchy level definition is requested for each combination of class and\n   * instance IDs (with the same `parentNode`).\n   */\n  parentNodeInstanceIds: Id64String[];\n};\n\n/**\n * A definition of a hierarchy level that should be used for specific class of parent instance nodes.\n */\ninterface InstancesNodeChildHierarchyLevelDefinition {\n  /**\n   * Full name of the parent instance node's class to match against when checking if this hierarchy\n   * level should be used for specific parent instance node.\n   *\n   * The check is polymorphic, so `BisCore.Element` class would match `BisCore.GeometricElement`, `BisCore.Category` and\n   * all other element classes.\n   */\n  parentNodeClassName: string;\n\n  /**\n   * Called to create a hierarchy level definition when the class check passes (see `parentNodeClassName`).\n   */\n  definitions: (requestProps: DefineInstanceNodeChildHierarchyLevelProps) => Promise<HierarchyLevelDefinition>;\n\n  /**\n   * If set to true, and node matches at least one of the previous definitions, this definition will not be applied.\n   *\n   * For example:\n   * ```ts\n   * {\n   *   parentNodeClassName: \"BisCore.GeometricElement3d\",\n   *   definitions: () => ...,\n   * },\n   * // This will apply to all elements, that are not BisCore.GeometricElement3d\n   * {\n   *   parentNodeClassName: \"BisCore.Element\",\n   *   onlyIfNotHandled: true,\n   *   definitions: () => ...,\n   * }\n   * ```\n   */\n  onlyIfNotHandled?: boolean;\n}\n\n/**\n * Props for defining child hierarchy level for specific parent custom node.\n * @see `createClassBasedHierarchyDefinition`\n * @beta\n */\nexport type DefineCustomNodeChildHierarchyLevelProps = Omit<DefineHierarchyLevelProps, \"parentNode\"> & {\n  /** The parent custom node. */\n  parentNode: Omit<HierarchyDefinitionParentNode, \"key\"> & { key: string };\n};\n\n/**\n * A definition of a hierarchy level for that should be used for specific custom parent nodes.\n */\ninterface CustomNodeChildHierarchyLevelDefinition {\n  /**\n   * `HierarchyNode.key` of the custom node that this child hierarchy level definition should be used for.\n   */\n  customParentNodeKey: string;\n\n  /**\n   * Called to create a hierarchy level definition when the node key check passes (see `customParentNodeKey`).\n   */\n  definitions: (requestProps: DefineCustomNodeChildHierarchyLevelProps) => Promise<HierarchyLevelDefinition>;\n}\n\n/**\n * A hierarchy level definition associated with either parent instance node's class or custom\n * node's key.\n */\ntype ClassBasedHierarchyLevelDefinition = InstancesNodeChildHierarchyLevelDefinition | CustomNodeChildHierarchyLevelDefinition;\n\n/**\n * Props for defining root hierarchy level.\n * @see `createClassBasedHierarchyDefinition`\n * @beta\n */\nexport type DefineRootHierarchyLevelProps = Omit<DefineHierarchyLevelProps, \"parentNode\">;\n\n/**\n * Props for `createClassBasedHierarchyDefinition`.\n */\ninterface ClassBasedHierarchyDefinitionProps {\n  /** Access to ECClass hierarchy in the iModel */\n  classHierarchyInspector: ECClassHierarchyInspector;\n\n  /** Hierarchy level definitions based on parent instance node's class or custom node's key. */\n  hierarchy: {\n    /** Called to create the root hierarchy level definition. */\n    rootNodes: (props: DefineRootHierarchyLevelProps) => Promise<HierarchyLevelDefinition>;\n\n    /**\n     * Called to get child hierarchy level definitions based on parent instance node's class\n     * or custom node's key.\n     */\n    childNodes: ClassBasedHierarchyLevelDefinition[];\n  };\n}\n\n/**\n * Creates an instance of `HierarchyDefinition` that uses a somewhat declarative approach to define the\n * hierarchy - each hierarchy level is assigned either an instance node's class or custom node's\n * key and they're used to assign hierarchy level definitions based on parent node.\n *\n * @beta\n */\nexport function createClassBasedHierarchyDefinition(props: ClassBasedHierarchyDefinitionProps): HierarchyDefinition {\n  return new ClassBasedHierarchyDefinition(props);\n}\n\nclass ClassBasedHierarchyDefinition implements HierarchyDefinition {\n  public constructor(private _props: ClassBasedHierarchyDefinitionProps) {}\n\n  /**\n   * Create hierarchy level definitions for specific hierarchy level.\n   * @param parentNode Parent node to create children definitions for.\n   */\n  public async defineHierarchyLevel(props: DefineHierarchyLevelProps): Promise<HierarchyLevelDefinition> {\n    const { parentNode } = props;\n    if (!parentNode) {\n      return this._props.hierarchy.rootNodes(props);\n    }\n\n    if (HierarchyNode.isCustom(parentNode)) {\n      const defs = this._props.hierarchy.childNodes\n        .filter(isCustomNodeChildHierarchyLevelDefinition)\n        .filter((def) => def.customParentNodeKey === parentNode.key);\n      return (await Promise.all(defs.map(async (def) => def.definitions({ ...props, parentNode })))).flat();\n    }\n\n    // istanbul ignore else\n    if (HierarchyNode.isInstancesNode(parentNode)) {\n      const instanceIdsByClass = groupInstanceIdsByClass(parentNode.key.instanceKeys);\n      const instancesParentNodeDefs = this._props.hierarchy.childNodes.filter(isInstancesNodeChildHierarchyLevelDefinition);\n      return (\n        await Promise.all(\n          [...instanceIdsByClass.entries()].map(async ([parentNodeClassName, parentNodeInstanceIds]) =>\n            createHierarchyLevelDefinitions(this._props.classHierarchyInspector, instancesParentNodeDefs, {\n              ...props,\n              parentNodeClassName,\n              parentNodeInstanceIds,\n              parentNode,\n            }),\n          ),\n        )\n      ).flat();\n    }\n\n    // istanbul ignore next\n    return [];\n  }\n}\n\nasync function createHierarchyLevelDefinitions(\n  classHierarchy: ECClassHierarchyInspector,\n  defs: InstancesNodeChildHierarchyLevelDefinition[],\n  requestProps: DefineInstanceNodeChildHierarchyLevelProps,\n) {\n  const obs = from(defs).pipe(\n    mergeMap(async (def, idx) => {\n      if (await classHierarchy.classDerivesFrom(requestProps.parentNodeClassName, def.parentNodeClassName)) {\n        return { def, idx };\n      }\n      return undefined;\n    }),\n    filter((x): x is Exclude<typeof x, undefined> => !!x),\n    toArray(),\n    concatMap((x) => x.sort((a, b) => a.idx - b.idx).map(({ def }) => def)),\n    filter((def, idx) => !def.onlyIfNotHandled || idx === 0),\n    mergeMap(async (def) => def.definitions(requestProps)),\n    mergeAll(),\n  );\n  return firstValueFrom(obs.pipe(toArray()));\n}\n\nfunction groupInstanceIdsByClass(instanceKeys: InstanceKey[]) {\n  const instanceIdsByClass = new Map<string, Id64String[]>();\n  instanceKeys.forEach((key) => {\n    let instanceIds = instanceIdsByClass.get(key.className);\n    if (!instanceIds) {\n      instanceIds = [];\n      instanceIdsByClass.set(key.className, instanceIds);\n    }\n    instanceIds.push(key.id);\n  });\n  return instanceIdsByClass;\n}\n\nfunction isCustomNodeChildHierarchyLevelDefinition(def: ClassBasedHierarchyLevelDefinition): def is CustomNodeChildHierarchyLevelDefinition {\n  return !!(def as CustomNodeChildHierarchyLevelDefinition).customParentNodeKey;\n}\n\nfunction isInstancesNodeChildHierarchyLevelDefinition(def: ClassBasedHierarchyLevelDefinition): def is InstancesNodeChildHierarchyLevelDefinition {\n  return !!(def as InstancesNodeChildHierarchyLevelDefinition).parentNodeClassName;\n}\n"]}

package/lib/cjs/hierarchies/NodeSelectQueryFactory.js

@@ -329,7 +329,8 @@ async function createWhereClause(contentClassAlias, classLoader, rule) {
     }
     const value = rule.value.rawValue;
     if (rule.operator === "like" && typeof value === "string") {
-        return `${propertyValueSelector} ${ecsqlOperator} '${value}' ESCAPE '\\'`;
+        const escapedValue = value.replace(/[%_\\]/g, "\\$&");
+        return `${propertyValueSelector} ${ecsqlOperator} '%${escapedValue}%' ESCAPE '\\'`;
     }
     const propertyClass = await classLoader(sourceAlias);
     if (!propertyClass) {

package/lib/cjs/hierarchies/NodeSelectQueryFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"NodeSelectQueryFactory.js","sourceRoot":"","sources":["../../../src/hierarchies/NodeSelectQueryFactory.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n\nimport { assert, Id64String } from \"@itwin/core-bentley\";\nimport {\n  GenericInstanceFilter,\n  GenericInstanceFilterRelationshipStep,\n  GenericInstanceFilterRule,\n  GenericInstanceFilterRuleGroup,\n  GenericInstanceFilterRuleGroupOperator,\n  GenericInstanceFilterRuleOperator,\n  GenericInstanceFilterRuleValue,\n} from \"@itwin/core-common\";\nimport { EC, ECClassHierarchyInspector, ECSchemaProvider, ECSql, getClass, parseFullClassName, PrimitiveValue } from \"@itwin/presentation-shared\";\n\n/**\n * Column names of the SELECT clause created by `NodeSelectClauseFactory`. Order of the names matches the order of columns\n * created by the factory.\n *\n * @beta\n */\nexport enum NodeSelectClauseColumnNames {\n  /** Full class name of the instance the node represents. Type: `string` in format `{schema name}:{class name}`. */\n  FullClassName = \"FullClassName\",\n  /** ECInstance ID of the instance the node represents. Type: `Id64String`. */\n  ECInstanceId = \"ECInstanceId\",\n  /** Display label. Type: `string`. */\n  DisplayLabel = \"DisplayLabel\",\n  /**\n   * A flag indicating if the node has children. Type: `boolean`. Values:\n   * - `false` - node never has children.\n   * - `true` - node always has children.\n   * - NULL - unknown, needs to be determined by requesting children for the node.\n   */\n  HasChildren = \"HasChildren\",\n  /** A flag indicating that a node should be hidden if it has no children. Type: `boolean`. */\n  HideIfNoChildren = \"HideIfNoChildren\",\n  /** A flag indicating that a node should be hidden and its children should be displayed instead. Type: `boolean`. */\n  HideNodeInHierarchy = \"HideNodeInHierarchy\",\n  /** A serialized JSON object for providing grouping information. */\n  Grouping = \"Grouping\",\n  /** A serialized JSON object for associating a node with additional data. */\n  ExtendedData = \"ExtendedData\",\n  /** A flag indicating the node should be auto-expanded when it's loaded. */\n  AutoExpand = \"AutoExpand\",\n  /** A flag indicating the node supports child hierarchy level filtering. */\n  SupportsFiltering = \"SupportsFiltering\",\n}\n\n/**\n * A data structure for defining an ECSQL value selector.\n */\ninterface ECSqlValueSelector {\n  selector: string;\n}\n\n/**\n * Props for `NodeSelectClauseFactory.createSelectClause`.\n */\ninterface NodeSelectClauseProps {\n  ecClassId: Id64String | ECSqlValueSelector;\n  ecInstanceId: Id64String | ECSqlValueSelector;\n  nodeLabel: string | ECSqlValueSelector;\n  extendedData?: {\n    [key: string]: Id64String | string | number | boolean | ECSqlValueSelector;\n  };\n  autoExpand?: boolean | ECSqlValueSelector;\n  supportsFiltering?: boolean | ECSqlValueSelector;\n  hasChildren?: boolean | ECSqlValueSelector;\n  hideNodeInHierarchy?: boolean | ECSqlValueSelector;\n  hideIfNoChildren?: boolean | ECSqlValueSelector;\n  grouping?: ECSqlSelectClauseGroupingParams;\n}\n\n/**\n * A data structure for defining nodes' grouping requirements.\n */\ninterface ECSqlSelectClauseGroupingParams {\n  byLabel?: ECSqlSelectClauseLabelGroupingParams;\n  byClass?: boolean | ECSqlSelectClauseGroupingParamsBase | ECSqlValueSelector;\n  byBaseClasses?: ECSqlSelectClauseBaseClassGroupingParams;\n  byProperties?: ECSqlSelectClausePropertiesGroupingParams;\n}\n\n/**\n * A data structure for defining label grouping params.\n */\ninterface ECSqlSelectClauseLabelGroupingBaseParams {\n  /** Label grouping option that determines whether to group nodes or to merge them. Defaults to \"group\".*/\n  action?: \"group\" | \"merge\";\n  /** Id that needs to match for nodes to be grouped or merged.*/\n  groupId?: string | ECSqlValueSelector;\n}\n\n/**\n * A data structure for defining label merging.\n */\ninterface ECSqlSelectClauseLabelGroupingMergeParams extends ECSqlSelectClauseLabelGroupingBaseParams {\n  action: \"merge\";\n}\n\n/**\n * A data structure for defining label grouping.\n */\ninterface ECSqlSelectClauseLabelGroupingGroupParams extends ECSqlSelectClauseLabelGroupingBaseParams, ECSqlSelectClauseGroupingParamsBase {\n  action?: \"group\";\n}\n\n/**\n * A data structure for defining possible label grouping types.\n */\ntype ECSqlSelectClauseLabelGroupingParams =\n  | boolean\n  | ECSqlValueSelector\n  | ECSqlSelectClauseLabelGroupingMergeParams\n  | ECSqlSelectClauseLabelGroupingGroupParams;\n\n/**\n * A data structure for defining base grouping parameters shared across all types of grouping.\n */\ninterface ECSqlSelectClauseGroupingParamsBase {\n  hideIfNoSiblings?: boolean | ECSqlValueSelector;\n  hideIfOneGroupedNode?: boolean | ECSqlValueSelector;\n  autoExpand?: string | ECSqlValueSelector;\n}\n\n/**\n * A data structure for defining properties grouping.\n */\ninterface ECSqlSelectClausePropertiesGroupingParams extends ECSqlSelectClauseGroupingParamsBase {\n  /**\n   * Full name of a class whose properties are used to group the node. Only has effect if the node\n   * represents an instance of that class.\n   *\n   * Full class name format: `SchemaName.ClassName`.\n   */\n  propertiesClassName: string;\n  /**\n   * Property grouping option that determines whether to group nodes whose grouping value is not set or is set to an empty string.\n   *\n   * Label of the created grouping node will be `Not Specified`.\n   */\n  createGroupForUnspecifiedValues?: boolean | ECSqlValueSelector;\n  /**\n   * Property grouping option that determines whether to group nodes whose grouping value doesn't fit within any of the provided\n   * ranges, or is not a numeric value.\n   *\n   * Label of the created grouping node will be `Other`.\n   */\n  createGroupForOutOfRangeValues?: boolean | ECSqlValueSelector;\n  /**\n   * Properties of the specified class, by which the nodes should be grouped.\n   *\n   * Example usage:\n   * ```ts\n   * propertyGroups: [\n   *   {\n   *     propertyName: \"type\",\n   *     propertyClassAlias: \"this\"\n   *   },\n   *   {\n   *     propertyName: \"length\",\n   *     propertyClassAlias: \"x\",\n   *     ranges: [\n   *       { fromValue: 1, toValue: 10, rangeLabel: \"Small\" },\n   *       { fromValue: 11, toValue: 20, rangeLabel: \"Medium\" }\n   *     ]\n   *   },\n   * ]\n   * ```\n   */\n  propertyGroups: ECSqlSelectClausePropertyGroup[];\n}\n\n/**\n * A data structure for defining specific properties' grouping params.\n */\ninterface ECSqlSelectClausePropertyGroup {\n  /** A string indicating the name of the property to group by. */\n  propertyName: string;\n  /** Alias to of the class containing the property. Used to select the property value. */\n  propertyClassAlias: string;\n  /** Ranges are used to group nodes by numeric properties which are within specified bounds. */\n  ranges?: ECSqlSelectClausePropertyValueRange[];\n}\n\n/**\n * A data structure for defining boundaries for a value.\n */\ninterface ECSqlSelectClausePropertyValueRange {\n  /** Defines the lower bound of the range. */\n  fromValue: number | ECSqlValueSelector;\n  /** Defines the upper bound of the range. */\n  toValue: number | ECSqlValueSelector;\n  /** Defines the range label. Will be used as grouping node's display label. */\n  rangeLabel?: string | ECSqlValueSelector;\n}\n\n/**\n * A data structure for defining base class grouping.\n */\ninterface ECSqlSelectClauseBaseClassGroupingParams extends ECSqlSelectClauseGroupingParamsBase {\n  fullClassNames: string[] | ECSqlValueSelector[];\n}\n\n/**\n * An interface of a factory that knows how to create nodes' select ECSQL query.\n * @beta\n */\nexport interface NodesQueryClauseFactory {\n  /** Create a SELECT clause in a format understood by nodes query parser used by `HierarchyProvider`. */\n  createSelectClause(props: NodeSelectClauseProps): Promise<string>;\n\n  /** Create FROM, JOIN and WHERE clauses whose combination results in an ECSQL filter defined by given `GenericInstanceFilter`. */\n  createFilterClauses(props: {\n    contentClass: { fullName: string; alias: string };\n    filter: GenericInstanceFilter | undefined;\n  }): Promise<{ from: string; where: string; joins: string }>;\n}\n\n/**\n * Creates an instance of `NodeSelectQueryFactory` that .\n * @beta\n */\nexport function createNodesQueryClauseFactory(props: { imodelAccess: ECSchemaProvider & ECClassHierarchyInspector }): NodesQueryClauseFactory {\n  return new NodeSelectQueryFactory(props);\n}\n\n/** A factory for creating a nodes' select ECSQL query. */\nclass NodeSelectQueryFactory {\n  private _imodelAccess: ECSchemaProvider & ECClassHierarchyInspector;\n\n  public constructor(props: { imodelAccess: ECSchemaProvider & ECClassHierarchyInspector }) {\n    this._imodelAccess = props.imodelAccess;\n  }\n\n  /** Create a SELECT clause in a format understood by results reader of the library. */\n  public async createSelectClause(props: NodeSelectClauseProps) {\n    // note: the columns order must match the order in `NodeSelectClauseColumnNames`\n    return `\n      ec_ClassName(${createECSqlValueSelector(props.ecClassId)}) AS ${NodeSelectClauseColumnNames.FullClassName},\n      ${createECSqlValueSelector(props.ecInstanceId)} AS ${NodeSelectClauseColumnNames.ECInstanceId},\n      ${createECSqlValueSelector(props.nodeLabel)} AS ${NodeSelectClauseColumnNames.DisplayLabel},\n      CAST(${createECSqlValueSelector(props.hasChildren)} AS BOOLEAN) AS ${NodeSelectClauseColumnNames.HasChildren},\n      CAST(${createECSqlValueSelector(props.hideIfNoChildren)} AS BOOLEAN) AS ${NodeSelectClauseColumnNames.HideIfNoChildren},\n      CAST(${createECSqlValueSelector(props.hideNodeInHierarchy)} AS BOOLEAN) AS ${NodeSelectClauseColumnNames.HideNodeInHierarchy},\n      ${props.grouping ? createGroupingSelector(props.grouping) : \"CAST(NULL AS TEXT)\"} AS ${NodeSelectClauseColumnNames.Grouping},\n      ${\n        props.extendedData\n          ? `json_object(${Object.entries(props.extendedData)\n              .map(([key, value]) => `'${key}', ${createECSqlValueSelector(value)}`)\n              .join(\", \")})`\n          : \"CAST(NULL AS TEXT)\"\n      } AS ${NodeSelectClauseColumnNames.ExtendedData},\n      CAST(${createECSqlValueSelector(props.autoExpand)} AS BOOLEAN) AS ${NodeSelectClauseColumnNames.AutoExpand},\n      CAST(${createECSqlValueSelector(props.supportsFiltering)} AS BOOLEAN) AS ${NodeSelectClauseColumnNames.SupportsFiltering}\n    `;\n  }\n\n  /**\n   * Creates the necessary ECSQL snippets to create an instance filter described by the `def` argument.\n   * - `from` is set to either the `contentClass.fullName` or `def.propertyClassName`, depending on which is more specific.\n   * - `joins` is set to a number of `JOIN` clauses required to join all relationships described by `def.relatedInstances`.\n   * - `where` is set to a `WHERE` clause (without the `WHERE` keyword) that filters instances by classes on\n   * `def.filterClassNames` and by properties as described by `def.rules`.\n   *\n   * Special cases:\n   * - If `def` is `undefined`, `joins` and `where` are set to empty strings and `from` is set to `contentClass.fullName`.\n   * - If the provided content class doesn't intersect with the property class in provided filter, a special result\n   * is returned to make sure the resulting query is valid and doesn't return anything.\n   */\n  public async createFilterClauses(props: {\n    contentClass: { fullName: string; alias: string };\n    filter: GenericInstanceFilter | undefined;\n  }): Promise<{ from: string; where: string; joins: string }> {\n    const { contentClass, filter } = props;\n    if (!filter) {\n      // undefined filter means we don't want any filtering to be applied\n      return { from: contentClass.fullName, joins: \"\", where: \"\" };\n    }\n\n    const from = await specializeContentClass({\n      classHierarchyInspector: this._imodelAccess,\n      contentClassName: contentClass.fullName,\n      filterClassNames: filter.propertyClassNames,\n    });\n    if (!from) {\n      // filter class doesn't intersect with content class - make sure the query returns nothing by returning a `FALSE` WHERE clause\n      return { from: contentClass.fullName, joins: \"\", where: \"FALSE\" };\n    }\n\n    /**\n     * TODO:\n     * There may be similar related instance paths, e.g.:\n     * - A -> B -> C,\n     * - A -> B -> D.\n     * At this moment we're handling each path individually which means A and B would get joined twice. We could look into\n     * creating a join tree first, e.g.\n     *         C\n     *        /\n     * A -> B\n     *        \\\n     *         D\n     */\n    const joins = await Promise.all(\n      filter.relatedInstances.map(async (rel, i) =>\n        ECSql.createRelationshipPathJoinClause({\n          schemaProvider: this._imodelAccess,\n          path: assignRelationshipPathAliases(rel.path, i, contentClass.alias, rel.alias),\n        }),\n      ),\n    );\n\n    const whereConditions = new Array<string>();\n    if (filter.filteredClassNames && filter.filteredClassNames.length > 0) {\n      whereConditions.push(\n        `${ECSql.createRawPropertyValueSelector(contentClass.alias, \"ECClassId\")} IS (\n          ${filter.filteredClassNames\n            .map(parseFullClassName)\n            .map(({ schemaName, className }) => `[${schemaName}].[${className}]`)\n            .join(\", \")}\n        )`,\n      );\n    }\n    const classAliasMap = new Map<string, string>([[contentClass.alias, from]]);\n    filter.relatedInstances.forEach(({ path, alias }) => path.length > 0 && classAliasMap.set(alias, path[path.length - 1].targetClassName));\n    const propertiesFilter = await createWhereClause(\n      contentClass.alias,\n      async (alias) => {\n        const aliasClassName = classAliasMap.get(alias);\n        return aliasClassName ? getClass(this._imodelAccess, aliasClassName) : undefined;\n      },\n      filter.rules,\n    );\n    if (propertiesFilter) {\n      whereConditions.push(propertiesFilter);\n    }\n\n    return {\n      from,\n      joins: joins.join(\"\\n\"),\n      where: whereConditions.join(\" AND \"),\n    };\n  }\n}\n\nfunction createECSqlValueSelector(input: undefined | PrimitiveValue | ECSqlValueSelector) {\n  if (input === undefined) {\n    return \"NULL\";\n  }\n  if (isSelector(input)) {\n    return input.selector;\n  }\n  return ECSql.createRawPrimitiveValueSelector(input);\n}\n\nfunction isSelector(x: any): x is ECSqlValueSelector {\n  return !!x.selector;\n}\n\nfunction createGroupingSelector(grouping: ECSqlSelectClauseGroupingParams): string {\n  const groupingSelectors = new Array<{ key: string; selector: string }>();\n\n  grouping.byLabel &&\n    groupingSelectors.push({\n      key: \"byLabel\",\n      selector:\n        typeof grouping.byLabel === \"boolean\" || isSelector(grouping.byLabel)\n          ? createECSqlValueSelector(grouping.byLabel)\n          : serializeJsonObject(createLabelGroupingBaseParamsSelectors(grouping.byLabel)),\n    });\n\n  grouping.byClass &&\n    groupingSelectors.push({\n      key: \"byClass\",\n      selector:\n        typeof grouping.byClass === \"boolean\" || isSelector(grouping.byClass)\n          ? createECSqlValueSelector(grouping.byClass)\n          : serializeJsonObject(createBaseGroupingParamSelectors(grouping.byClass)),\n    });\n\n  grouping.byBaseClasses &&\n    groupingSelectors.push({\n      key: \"byBaseClasses\",\n      selector: serializeJsonObject([\n        {\n          key: \"fullClassNames\",\n          selector: `json_array(${grouping.byBaseClasses.fullClassNames.map((className) => createECSqlValueSelector(className)).join(\", \")})`,\n        },\n        ...createBaseGroupingParamSelectors(grouping.byBaseClasses),\n      ]),\n    });\n\n  grouping.byProperties &&\n    groupingSelectors.push({\n      key: \"byProperties\",\n      selector: serializeJsonObject([\n        {\n          key: \"propertiesClassName\",\n          selector: `${createECSqlValueSelector(grouping.byProperties.propertiesClassName)}`,\n        },\n        {\n          key: \"propertyGroups\",\n          selector: `json_array(${grouping.byProperties.propertyGroups\n            .map((propertyGroup) => serializeJsonObject(createPropertyGroupSelectors(propertyGroup)))\n            .join(\", \")})`,\n        },\n        ...(grouping.byProperties.createGroupForOutOfRangeValues !== undefined\n          ? [\n              {\n                key: \"createGroupForOutOfRangeValues\",\n                selector: `CAST(${createECSqlValueSelector(grouping.byProperties.createGroupForOutOfRangeValues)} AS BOOLEAN)`,\n              },\n            ]\n          : []),\n        ...(grouping.byProperties.createGroupForUnspecifiedValues !== undefined\n          ? [\n              {\n                key: \"createGroupForUnspecifiedValues\",\n                selector: `CAST(${createECSqlValueSelector(grouping.byProperties.createGroupForUnspecifiedValues)} AS BOOLEAN)`,\n              },\n            ]\n          : []),\n        ...createBaseGroupingParamSelectors(grouping.byProperties),\n      ]),\n    });\n\n  return serializeJsonObject(groupingSelectors);\n}\n\nfunction createLabelGroupingBaseParamsSelectors(byLabel: ECSqlSelectClauseLabelGroupingMergeParams | ECSqlSelectClauseLabelGroupingGroupParams) {\n  const selectors = new Array<{ key: string; selector: string }>();\n  if (byLabel.action !== undefined) {\n    selectors.push({\n      key: \"action\",\n      selector: `${createECSqlValueSelector(byLabel.action)}`,\n    });\n  }\n  if (byLabel.groupId !== undefined) {\n    selectors.push({\n      key: \"groupId\",\n      selector: createECSqlValueSelector(byLabel.groupId),\n    });\n  }\n  if (byLabel.action !== \"merge\") {\n    selectors.push(...createBaseGroupingParamSelectors(byLabel));\n  }\n\n  return selectors;\n}\n\nfunction createPropertyGroupSelectors(propertyGroup: ECSqlSelectClausePropertyGroup) {\n  const selectors = new Array<{ key: string; selector: string }>();\n  selectors.push(\n    {\n      key: \"propertyName\",\n      selector: `${createECSqlValueSelector(propertyGroup.propertyName)}`,\n    },\n    {\n      key: \"propertyValue\",\n      selector: `[${propertyGroup.propertyClassAlias}].[${propertyGroup.propertyName}]`,\n    },\n  );\n  if (propertyGroup.ranges) {\n    selectors.push(createRangeParamSelectors(propertyGroup.ranges));\n  }\n  return selectors;\n}\n\nfunction createRangeParamSelectors(ranges: ECSqlSelectClausePropertyValueRange[]) {\n  return {\n    key: \"ranges\",\n    selector: `json_array(${ranges\n      .map((range) =>\n        serializeJsonObject([\n          {\n            key: \"fromValue\",\n            selector: createECSqlValueSelector(range.fromValue),\n          },\n          {\n            key: \"toValue\",\n            selector: createECSqlValueSelector(range.toValue),\n          },\n          ...(range.rangeLabel\n            ? [\n                {\n                  key: \"rangeLabel\",\n                  selector: `${createECSqlValueSelector(range.rangeLabel)}`,\n                },\n              ]\n            : []),\n        ]),\n      )\n      .join(\", \")})`,\n  };\n}\n\nfunction createBaseGroupingParamSelectors(params: ECSqlSelectClauseGroupingParamsBase) {\n  const selectors = new Array<{ key: string; selector: string }>();\n  if (params.hideIfNoSiblings !== undefined) {\n    selectors.push({\n      key: \"hideIfNoSiblings\",\n      selector: createECSqlValueSelector(params.hideIfNoSiblings),\n    });\n  }\n  if (params.hideIfOneGroupedNode !== undefined) {\n    selectors.push({\n      key: \"hideIfOneGroupedNode\",\n      selector: createECSqlValueSelector(params.hideIfOneGroupedNode),\n    });\n  }\n  if (params.autoExpand !== undefined) {\n    selectors.push({\n      key: \"autoExpand\",\n      selector: createECSqlValueSelector(params.autoExpand),\n    });\n  }\n  return selectors;\n}\n\nfunction serializeJsonObject(selectors: Array<{ key: string; selector: string }>): string {\n  return `json_object(${selectors.map(({ key, selector }) => `'${key}', ${selector}`).join(\", \")})`;\n}\n\nasync function createWhereClause(\n  contentClassAlias: string,\n  classLoader: (alias: string) => Promise<EC.Class | undefined>,\n  rule: GenericInstanceFilterRule | GenericInstanceFilterRuleGroup,\n): Promise<string | undefined> {\n  if (GenericInstanceFilter.isFilterRuleGroup(rule)) {\n    const clause = (await Promise.all(rule.rules.map(async (r) => createWhereClause(contentClassAlias, classLoader, r))))\n      .filter((c) => !!c)\n      .join(` ${getECSqlLogicalOperator(rule.operator)} `);\n    return clause ? (rule.operator === \"or\" ? `(${clause})` : clause) : undefined;\n  }\n  const sourceAlias = rule.sourceAlias ? rule.sourceAlias : contentClassAlias;\n  const propertyValueSelector = ECSql.createRawPropertyValueSelector(sourceAlias, rule.propertyName);\n  if (isUnaryRuleOperator(rule.operator)) {\n    switch (rule.operator) {\n      case \"is-true\":\n        return propertyValueSelector;\n      case \"is-false\":\n        return `NOT ${propertyValueSelector}`;\n      case \"is-null\":\n        return `${propertyValueSelector} IS NULL`;\n      case \"is-not-null\":\n        return `${propertyValueSelector} IS NOT NULL`;\n    }\n  }\n  const ecsqlOperator = getECSqlComparisonOperator(rule.operator);\n  if (rule.value === undefined) {\n    throw new Error(`Rule \"${rule.propertyName}\" ${ecsqlOperator} is missing value.`);\n  }\n\n  const value = rule.value.rawValue;\n\n  if (rule.operator === \"like\" && typeof value === \"string\") {\n    return `${propertyValueSelector} ${ecsqlOperator} '${value}' ESCAPE '\\\\'`;\n  }\n  const propertyClass = await classLoader(sourceAlias);\n  if (!propertyClass) {\n    throw new Error(`Class with alias \"${sourceAlias}\" not found.`);\n  }\n  const property = await propertyClass.getProperty(rule.propertyName);\n  if (!property) {\n    throw new Error(`Property \"${rule.propertyName}\" not found in ECClass \"${propertyClass.fullName}\".`);\n  }\n  if (property.isNavigation()) {\n    assert(rule.value !== undefined && GenericInstanceFilterRuleValue.isInstanceKey(value));\n    return `${propertyValueSelector}.[Id] ${ecsqlOperator} ${ECSql.createRawPrimitiveValueSelector(value.id)}`;\n  }\n  if (property.isEnumeration()) {\n    assert(rule.value !== undefined && !GenericInstanceFilterRuleValue.isInstanceKey(value));\n    return `${propertyValueSelector} ${ecsqlOperator} ${ECSql.createRawPrimitiveValueSelector(value)}`;\n  }\n  if (property.isPrimitive()) {\n    assert(rule.value !== undefined && !GenericInstanceFilterRuleValue.isInstanceKey(value));\n    switch (property.primitiveType) {\n      case \"Point2d\": {\n        assert(rule.operator === \"is-equal\" || rule.operator === \"is-not-equal\");\n        assert(PrimitiveValue.isPoint2d(value));\n        const condition = `\n          ${createFloatingPointEqualityClause(`${propertyValueSelector}.[x]`, \"is-equal\", value.x)}\n          AND ${createFloatingPointEqualityClause(`${propertyValueSelector}.[y]`, \"is-equal\", value.y)}\n        `;\n        return rule.operator === \"is-equal\" ? condition : `NOT (${condition})`;\n      }\n      case \"Point3d\": {\n        assert(rule.operator === \"is-equal\" || rule.operator === \"is-not-equal\");\n        assert(PrimitiveValue.isPoint3d(value));\n        const condition = `\n          ${createFloatingPointEqualityClause(`${propertyValueSelector}.[x]`, \"is-equal\", value.x)}\n          AND ${createFloatingPointEqualityClause(`${propertyValueSelector}.[y]`, \"is-equal\", value.y)}\n          AND ${createFloatingPointEqualityClause(`${propertyValueSelector}.[z]`, \"is-equal\", value.z)}\n        `;\n        return rule.operator === \"is-equal\" ? condition : `NOT (${condition})`;\n      }\n      case \"Double\": {\n        assert(typeof value === \"number\");\n        if (rule.operator === \"is-equal\" || rule.operator === \"is-not-equal\") {\n          return `${createFloatingPointEqualityClause(propertyValueSelector, rule.operator, value)}`;\n        }\n        return `${propertyValueSelector} ${ecsqlOperator} ${ECSql.createRawPrimitiveValueSelector(value)}`;\n      }\n      default: {\n        return `${propertyValueSelector} ${ecsqlOperator} ${ECSql.createRawPrimitiveValueSelector(value)}`;\n      }\n    }\n  }\n  throw new Error(\"Struct and array properties are not supported for filtering\");\n}\n\nfunction createFloatingPointEqualityClause(valueSelector: string, operator: \"is-equal\" | \"is-not-equal\", value: number) {\n  const [from, to] = getFloatingPointValueRange(value);\n  return `${valueSelector} ${operator === \"is-not-equal\" ? \"NOT \" : \"\"} BETWEEN ${from} AND ${to}`;\n}\n\nfunction getFloatingPointValueRange(value: number): [number, number] {\n  return [value - Number.EPSILON, value + Number.EPSILON];\n}\n\nfunction getECSqlLogicalOperator(op: GenericInstanceFilterRuleGroupOperator) {\n  switch (op) {\n    case \"and\":\n      return \"AND\";\n    case \"or\":\n      return \"OR\";\n  }\n}\n\nfunction isUnaryRuleOperator(\n  op: GenericInstanceFilterRuleOperator,\n): op is Extract<GenericInstanceFilterRuleOperator, \"is-true\" | \"is-false\" | \"is-null\" | \"is-not-null\"> {\n  return op === \"is-true\" || op === \"is-false\" || op === \"is-null\" || op === \"is-not-null\";\n}\n\nfunction getECSqlComparisonOperator(op: Exclude<GenericInstanceFilterRuleOperator, \"is-true\" | \"is-false\" | \"is-null\" | \"is-not-null\">) {\n  switch (op) {\n    case \"is-equal\":\n      return `=`;\n    case \"is-not-equal\":\n      return `<>`;\n    case \"greater\":\n      return `>`;\n    case \"greater-or-equal\":\n      return `>=`;\n    case \"less\":\n      return `<`;\n    case \"less-or-equal\":\n      return `<=`;\n    case \"like\":\n      return `LIKE`;\n  }\n}\n\ntype JoinRelationshipPath = Parameters<typeof ECSql.createRelationshipPathJoinClause>[0][\"path\"];\nfunction assignRelationshipPathAliases(\n  path: GenericInstanceFilterRelationshipStep[],\n  pathIndex: number,\n  sourceAlias: string,\n  targetAlias: string,\n): JoinRelationshipPath {\n  function createAlias(fullClassName: string, index: number) {\n    return `rel_${pathIndex}_${fullClassName.replaceAll(/[\\.:]/g, \"_\")}_${index}`;\n  }\n  const result: JoinRelationshipPath = [];\n  path.forEach((step, i) => {\n    result.push({\n      targetClassName: step.targetClassName,\n      relationshipName: step.relationshipClassName,\n      sourceClassName: step.sourceClassName,\n      relationshipReverse: !step.isForwardRelationship,\n      sourceAlias: i === 0 ? sourceAlias : result[i - 1].targetAlias,\n      relationshipAlias: createAlias(step.relationshipClassName, i),\n      targetAlias: i === path.length - 1 ? targetAlias : createAlias(step.targetClassName, i),\n      joinType: \"inner\",\n    });\n  });\n  return result;\n}\n\ninterface SpecializeContentClassProps {\n  classHierarchyInspector: ECClassHierarchyInspector;\n  contentClassName: string;\n  filterClassNames: string[];\n}\nasync function specializeContentClass(props: SpecializeContentClassProps): Promise<string | undefined> {\n  const filterClass = await getSpecializedPropertyClass(props.classHierarchyInspector, props.filterClassNames);\n  if (!filterClass) {\n    return props.contentClassName;\n  }\n  if (await props.classHierarchyInspector.classDerivesFrom(filterClass, props.contentClassName)) {\n    return filterClass;\n  }\n  if (await props.classHierarchyInspector.classDerivesFrom(props.contentClassName, filterClass)) {\n    return props.contentClassName;\n  }\n  return undefined;\n}\n\nasync function getSpecializedPropertyClass(classHierarchyInspector: ECClassHierarchyInspector, classes: string[]): Promise<string | undefined> {\n  if (classes.length === 0) {\n    return undefined;\n  }\n  const [currClassName, ...restClasses] = classes;\n  let resolvedClassName = currClassName;\n  for (const propClassName of restClasses) {\n    if (await classHierarchyInspector.classDerivesFrom(propClassName, resolvedClassName)) {\n      resolvedClassName = propClassName;\n    }\n  }\n  return resolvedClassName;\n}\n"]}
+{"version":3,"file":"NodeSelectQueryFactory.js","sourceRoot":"","sources":["../../../src/hierarchies/NodeSelectQueryFactory.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n\nimport { assert, Id64String } from \"@itwin/core-bentley\";\nimport {\n  GenericInstanceFilter,\n  GenericInstanceFilterRelationshipStep,\n  GenericInstanceFilterRule,\n  GenericInstanceFilterRuleGroup,\n  GenericInstanceFilterRuleGroupOperator,\n  GenericInstanceFilterRuleOperator,\n  GenericInstanceFilterRuleValue,\n} from \"@itwin/core-common\";\nimport { EC, ECClassHierarchyInspector, ECSchemaProvider, ECSql, getClass, parseFullClassName, PrimitiveValue } from \"@itwin/presentation-shared\";\n\n/**\n * Column names of the SELECT clause created by `NodeSelectClauseFactory`. Order of the names matches the order of columns\n * created by the factory.\n *\n * @beta\n */\nexport enum NodeSelectClauseColumnNames {\n  /** Full class name of the instance the node represents. Type: `string` in format `{schema name}:{class name}`. */\n  FullClassName = \"FullClassName\",\n  /** ECInstance ID of the instance the node represents. Type: `Id64String`. */\n  ECInstanceId = \"ECInstanceId\",\n  /** Display label. Type: `string`. */\n  DisplayLabel = \"DisplayLabel\",\n  /**\n   * A flag indicating if the node has children. Type: `boolean`. Values:\n   * - `false` - node never has children.\n   * - `true` - node always has children.\n   * - NULL - unknown, needs to be determined by requesting children for the node.\n   */\n  HasChildren = \"HasChildren\",\n  /** A flag indicating that a node should be hidden if it has no children. Type: `boolean`. */\n  HideIfNoChildren = \"HideIfNoChildren\",\n  /** A flag indicating that a node should be hidden and its children should be displayed instead. Type: `boolean`. */\n  HideNodeInHierarchy = \"HideNodeInHierarchy\",\n  /** A serialized JSON object for providing grouping information. */\n  Grouping = \"Grouping\",\n  /** A serialized JSON object for associating a node with additional data. */\n  ExtendedData = \"ExtendedData\",\n  /** A flag indicating the node should be auto-expanded when it's loaded. */\n  AutoExpand = \"AutoExpand\",\n  /** A flag indicating the node supports child hierarchy level filtering. */\n  SupportsFiltering = \"SupportsFiltering\",\n}\n\n/**\n * A data structure for defining an ECSQL value selector.\n */\ninterface ECSqlValueSelector {\n  selector: string;\n}\n\n/**\n * Props for `NodeSelectClauseFactory.createSelectClause`.\n */\ninterface NodeSelectClauseProps {\n  ecClassId: Id64String | ECSqlValueSelector;\n  ecInstanceId: Id64String | ECSqlValueSelector;\n  nodeLabel: string | ECSqlValueSelector;\n  extendedData?: {\n    [key: string]: Id64String | string | number | boolean | ECSqlValueSelector;\n  };\n  autoExpand?: boolean | ECSqlValueSelector;\n  supportsFiltering?: boolean | ECSqlValueSelector;\n  hasChildren?: boolean | ECSqlValueSelector;\n  hideNodeInHierarchy?: boolean | ECSqlValueSelector;\n  hideIfNoChildren?: boolean | ECSqlValueSelector;\n  grouping?: ECSqlSelectClauseGroupingParams;\n}\n\n/**\n * A data structure for defining nodes' grouping requirements.\n */\ninterface ECSqlSelectClauseGroupingParams {\n  byLabel?: ECSqlSelectClauseLabelGroupingParams;\n  byClass?: boolean | ECSqlSelectClauseGroupingParamsBase | ECSqlValueSelector;\n  byBaseClasses?: ECSqlSelectClauseBaseClassGroupingParams;\n  byProperties?: ECSqlSelectClausePropertiesGroupingParams;\n}\n\n/**\n * A data structure for defining label grouping params.\n */\ninterface ECSqlSelectClauseLabelGroupingBaseParams {\n  /** Label grouping option that determines whether to group nodes or to merge them. Defaults to \"group\".*/\n  action?: \"group\" | \"merge\";\n  /** Id that needs to match for nodes to be grouped or merged.*/\n  groupId?: string | ECSqlValueSelector;\n}\n\n/**\n * A data structure for defining label merging.\n */\ninterface ECSqlSelectClauseLabelGroupingMergeParams extends ECSqlSelectClauseLabelGroupingBaseParams {\n  action: \"merge\";\n}\n\n/**\n * A data structure for defining label grouping.\n */\ninterface ECSqlSelectClauseLabelGroupingGroupParams extends ECSqlSelectClauseLabelGroupingBaseParams, ECSqlSelectClauseGroupingParamsBase {\n  action?: \"group\";\n}\n\n/**\n * A data structure for defining possible label grouping types.\n */\ntype ECSqlSelectClauseLabelGroupingParams =\n  | boolean\n  | ECSqlValueSelector\n  | ECSqlSelectClauseLabelGroupingMergeParams\n  | ECSqlSelectClauseLabelGroupingGroupParams;\n\n/**\n * A data structure for defining base grouping parameters shared across all types of grouping.\n */\ninterface ECSqlSelectClauseGroupingParamsBase {\n  hideIfNoSiblings?: boolean | ECSqlValueSelector;\n  hideIfOneGroupedNode?: boolean | ECSqlValueSelector;\n  autoExpand?: string | ECSqlValueSelector;\n}\n\n/**\n * A data structure for defining properties grouping.\n */\ninterface ECSqlSelectClausePropertiesGroupingParams extends ECSqlSelectClauseGroupingParamsBase {\n  /**\n   * Full name of a class whose properties are used to group the node. Only has effect if the node\n   * represents an instance of that class.\n   *\n   * Full class name format: `SchemaName.ClassName`.\n   */\n  propertiesClassName: string;\n  /**\n   * Property grouping option that determines whether to group nodes whose grouping value is not set or is set to an empty string.\n   *\n   * Label of the created grouping node will be `Not Specified`.\n   */\n  createGroupForUnspecifiedValues?: boolean | ECSqlValueSelector;\n  /**\n   * Property grouping option that determines whether to group nodes whose grouping value doesn't fit within any of the provided\n   * ranges, or is not a numeric value.\n   *\n   * Label of the created grouping node will be `Other`.\n   */\n  createGroupForOutOfRangeValues?: boolean | ECSqlValueSelector;\n  /**\n   * Properties of the specified class, by which the nodes should be grouped.\n   *\n   * Example usage:\n   * ```ts\n   * propertyGroups: [\n   *   {\n   *     propertyName: \"type\",\n   *     propertyClassAlias: \"this\"\n   *   },\n   *   {\n   *     propertyName: \"length\",\n   *     propertyClassAlias: \"x\",\n   *     ranges: [\n   *       { fromValue: 1, toValue: 10, rangeLabel: \"Small\" },\n   *       { fromValue: 11, toValue: 20, rangeLabel: \"Medium\" }\n   *     ]\n   *   },\n   * ]\n   * ```\n   */\n  propertyGroups: ECSqlSelectClausePropertyGroup[];\n}\n\n/**\n * A data structure for defining specific properties' grouping params.\n */\ninterface ECSqlSelectClausePropertyGroup {\n  /** A string indicating the name of the property to group by. */\n  propertyName: string;\n  /** Alias to of the class containing the property. Used to select the property value. */\n  propertyClassAlias: string;\n  /** Ranges are used to group nodes by numeric properties which are within specified bounds. */\n  ranges?: ECSqlSelectClausePropertyValueRange[];\n}\n\n/**\n * A data structure for defining boundaries for a value.\n */\ninterface ECSqlSelectClausePropertyValueRange {\n  /** Defines the lower bound of the range. */\n  fromValue: number | ECSqlValueSelector;\n  /** Defines the upper bound of the range. */\n  toValue: number | ECSqlValueSelector;\n  /** Defines the range label. Will be used as grouping node's display label. */\n  rangeLabel?: string | ECSqlValueSelector;\n}\n\n/**\n * A data structure for defining base class grouping.\n */\ninterface ECSqlSelectClauseBaseClassGroupingParams extends ECSqlSelectClauseGroupingParamsBase {\n  fullClassNames: string[] | ECSqlValueSelector[];\n}\n\n/**\n * An interface of a factory that knows how to create nodes' select ECSQL query.\n * @beta\n */\nexport interface NodesQueryClauseFactory {\n  /** Create a SELECT clause in a format understood by nodes query parser used by `HierarchyProvider`. */\n  createSelectClause(props: NodeSelectClauseProps): Promise<string>;\n\n  /** Create FROM, JOIN and WHERE clauses whose combination results in an ECSQL filter defined by given `GenericInstanceFilter`. */\n  createFilterClauses(props: {\n    contentClass: { fullName: string; alias: string };\n    filter: GenericInstanceFilter | undefined;\n  }): Promise<{ from: string; where: string; joins: string }>;\n}\n\n/**\n * Creates an instance of `NodeSelectQueryFactory` that .\n * @beta\n */\nexport function createNodesQueryClauseFactory(props: { imodelAccess: ECSchemaProvider & ECClassHierarchyInspector }): NodesQueryClauseFactory {\n  return new NodeSelectQueryFactory(props);\n}\n\n/** A factory for creating a nodes' select ECSQL query. */\nclass NodeSelectQueryFactory {\n  private _imodelAccess: ECSchemaProvider & ECClassHierarchyInspector;\n\n  public constructor(props: { imodelAccess: ECSchemaProvider & ECClassHierarchyInspector }) {\n    this._imodelAccess = props.imodelAccess;\n  }\n\n  /** Create a SELECT clause in a format understood by results reader of the library. */\n  public async createSelectClause(props: NodeSelectClauseProps) {\n    // note: the columns order must match the order in `NodeSelectClauseColumnNames`\n    return `\n      ec_ClassName(${createECSqlValueSelector(props.ecClassId)}) AS ${NodeSelectClauseColumnNames.FullClassName},\n      ${createECSqlValueSelector(props.ecInstanceId)} AS ${NodeSelectClauseColumnNames.ECInstanceId},\n      ${createECSqlValueSelector(props.nodeLabel)} AS ${NodeSelectClauseColumnNames.DisplayLabel},\n      CAST(${createECSqlValueSelector(props.hasChildren)} AS BOOLEAN) AS ${NodeSelectClauseColumnNames.HasChildren},\n      CAST(${createECSqlValueSelector(props.hideIfNoChildren)} AS BOOLEAN) AS ${NodeSelectClauseColumnNames.HideIfNoChildren},\n      CAST(${createECSqlValueSelector(props.hideNodeInHierarchy)} AS BOOLEAN) AS ${NodeSelectClauseColumnNames.HideNodeInHierarchy},\n      ${props.grouping ? createGroupingSelector(props.grouping) : \"CAST(NULL AS TEXT)\"} AS ${NodeSelectClauseColumnNames.Grouping},\n      ${\n        props.extendedData\n          ? `json_object(${Object.entries(props.extendedData)\n              .map(([key, value]) => `'${key}', ${createECSqlValueSelector(value)}`)\n              .join(\", \")})`\n          : \"CAST(NULL AS TEXT)\"\n      } AS ${NodeSelectClauseColumnNames.ExtendedData},\n      CAST(${createECSqlValueSelector(props.autoExpand)} AS BOOLEAN) AS ${NodeSelectClauseColumnNames.AutoExpand},\n      CAST(${createECSqlValueSelector(props.supportsFiltering)} AS BOOLEAN) AS ${NodeSelectClauseColumnNames.SupportsFiltering}\n    `;\n  }\n\n  /**\n   * Creates the necessary ECSQL snippets to create an instance filter described by the `def` argument.\n   * - `from` is set to either the `contentClass.fullName` or `def.propertyClassName`, depending on which is more specific.\n   * - `joins` is set to a number of `JOIN` clauses required to join all relationships described by `def.relatedInstances`.\n   * - `where` is set to a `WHERE` clause (without the `WHERE` keyword) that filters instances by classes on\n   * `def.filterClassNames` and by properties as described by `def.rules`.\n   *\n   * Special cases:\n   * - If `def` is `undefined`, `joins` and `where` are set to empty strings and `from` is set to `contentClass.fullName`.\n   * - If the provided content class doesn't intersect with the property class in provided filter, a special result\n   * is returned to make sure the resulting query is valid and doesn't return anything.\n   */\n  public async createFilterClauses(props: {\n    contentClass: { fullName: string; alias: string };\n    filter: GenericInstanceFilter | undefined;\n  }): Promise<{ from: string; where: string; joins: string }> {\n    const { contentClass, filter } = props;\n    if (!filter) {\n      // undefined filter means we don't want any filtering to be applied\n      return { from: contentClass.fullName, joins: \"\", where: \"\" };\n    }\n\n    const from = await specializeContentClass({\n      classHierarchyInspector: this._imodelAccess,\n      contentClassName: contentClass.fullName,\n      filterClassNames: filter.propertyClassNames,\n    });\n    if (!from) {\n      // filter class doesn't intersect with content class - make sure the query returns nothing by returning a `FALSE` WHERE clause\n      return { from: contentClass.fullName, joins: \"\", where: \"FALSE\" };\n    }\n\n    /**\n     * TODO:\n     * There may be similar related instance paths, e.g.:\n     * - A -> B -> C,\n     * - A -> B -> D.\n     * At this moment we're handling each path individually which means A and B would get joined twice. We could look into\n     * creating a join tree first, e.g.\n     *         C\n     *        /\n     * A -> B\n     *        \\\n     *         D\n     */\n    const joins = await Promise.all(\n      filter.relatedInstances.map(async (rel, i) =>\n        ECSql.createRelationshipPathJoinClause({\n          schemaProvider: this._imodelAccess,\n          path: assignRelationshipPathAliases(rel.path, i, contentClass.alias, rel.alias),\n        }),\n      ),\n    );\n\n    const whereConditions = new Array<string>();\n    if (filter.filteredClassNames && filter.filteredClassNames.length > 0) {\n      whereConditions.push(\n        `${ECSql.createRawPropertyValueSelector(contentClass.alias, \"ECClassId\")} IS (\n          ${filter.filteredClassNames\n            .map(parseFullClassName)\n            .map(({ schemaName, className }) => `[${schemaName}].[${className}]`)\n            .join(\", \")}\n        )`,\n      );\n    }\n    const classAliasMap = new Map<string, string>([[contentClass.alias, from]]);\n    filter.relatedInstances.forEach(({ path, alias }) => path.length > 0 && classAliasMap.set(alias, path[path.length - 1].targetClassName));\n    const propertiesFilter = await createWhereClause(\n      contentClass.alias,\n      async (alias) => {\n        const aliasClassName = classAliasMap.get(alias);\n        return aliasClassName ? getClass(this._imodelAccess, aliasClassName) : undefined;\n      },\n      filter.rules,\n    );\n    if (propertiesFilter) {\n      whereConditions.push(propertiesFilter);\n    }\n\n    return {\n      from,\n      joins: joins.join(\"\\n\"),\n      where: whereConditions.join(\" AND \"),\n    };\n  }\n}\n\nfunction createECSqlValueSelector(input: undefined | PrimitiveValue | ECSqlValueSelector) {\n  if (input === undefined) {\n    return \"NULL\";\n  }\n  if (isSelector(input)) {\n    return input.selector;\n  }\n  return ECSql.createRawPrimitiveValueSelector(input);\n}\n\nfunction isSelector(x: any): x is ECSqlValueSelector {\n  return !!x.selector;\n}\n\nfunction createGroupingSelector(grouping: ECSqlSelectClauseGroupingParams): string {\n  const groupingSelectors = new Array<{ key: string; selector: string }>();\n\n  grouping.byLabel &&\n    groupingSelectors.push({\n      key: \"byLabel\",\n      selector:\n        typeof grouping.byLabel === \"boolean\" || isSelector(grouping.byLabel)\n          ? createECSqlValueSelector(grouping.byLabel)\n          : serializeJsonObject(createLabelGroupingBaseParamsSelectors(grouping.byLabel)),\n    });\n\n  grouping.byClass &&\n    groupingSelectors.push({\n      key: \"byClass\",\n      selector:\n        typeof grouping.byClass === \"boolean\" || isSelector(grouping.byClass)\n          ? createECSqlValueSelector(grouping.byClass)\n          : serializeJsonObject(createBaseGroupingParamSelectors(grouping.byClass)),\n    });\n\n  grouping.byBaseClasses &&\n    groupingSelectors.push({\n      key: \"byBaseClasses\",\n      selector: serializeJsonObject([\n        {\n          key: \"fullClassNames\",\n          selector: `json_array(${grouping.byBaseClasses.fullClassNames.map((className) => createECSqlValueSelector(className)).join(\", \")})`,\n        },\n        ...createBaseGroupingParamSelectors(grouping.byBaseClasses),\n      ]),\n    });\n\n  grouping.byProperties &&\n    groupingSelectors.push({\n      key: \"byProperties\",\n      selector: serializeJsonObject([\n        {\n          key: \"propertiesClassName\",\n          selector: `${createECSqlValueSelector(grouping.byProperties.propertiesClassName)}`,\n        },\n        {\n          key: \"propertyGroups\",\n          selector: `json_array(${grouping.byProperties.propertyGroups\n            .map((propertyGroup) => serializeJsonObject(createPropertyGroupSelectors(propertyGroup)))\n            .join(\", \")})`,\n        },\n        ...(grouping.byProperties.createGroupForOutOfRangeValues !== undefined\n          ? [\n              {\n                key: \"createGroupForOutOfRangeValues\",\n                selector: `CAST(${createECSqlValueSelector(grouping.byProperties.createGroupForOutOfRangeValues)} AS BOOLEAN)`,\n              },\n            ]\n          : []),\n        ...(grouping.byProperties.createGroupForUnspecifiedValues !== undefined\n          ? [\n              {\n                key: \"createGroupForUnspecifiedValues\",\n                selector: `CAST(${createECSqlValueSelector(grouping.byProperties.createGroupForUnspecifiedValues)} AS BOOLEAN)`,\n              },\n            ]\n          : []),\n        ...createBaseGroupingParamSelectors(grouping.byProperties),\n      ]),\n    });\n\n  return serializeJsonObject(groupingSelectors);\n}\n\nfunction createLabelGroupingBaseParamsSelectors(byLabel: ECSqlSelectClauseLabelGroupingMergeParams | ECSqlSelectClauseLabelGroupingGroupParams) {\n  const selectors = new Array<{ key: string; selector: string }>();\n  if (byLabel.action !== undefined) {\n    selectors.push({\n      key: \"action\",\n      selector: `${createECSqlValueSelector(byLabel.action)}`,\n    });\n  }\n  if (byLabel.groupId !== undefined) {\n    selectors.push({\n      key: \"groupId\",\n      selector: createECSqlValueSelector(byLabel.groupId),\n    });\n  }\n  if (byLabel.action !== \"merge\") {\n    selectors.push(...createBaseGroupingParamSelectors(byLabel));\n  }\n\n  return selectors;\n}\n\nfunction createPropertyGroupSelectors(propertyGroup: ECSqlSelectClausePropertyGroup) {\n  const selectors = new Array<{ key: string; selector: string }>();\n  selectors.push(\n    {\n      key: \"propertyName\",\n      selector: `${createECSqlValueSelector(propertyGroup.propertyName)}`,\n    },\n    {\n      key: \"propertyValue\",\n      selector: `[${propertyGroup.propertyClassAlias}].[${propertyGroup.propertyName}]`,\n    },\n  );\n  if (propertyGroup.ranges) {\n    selectors.push(createRangeParamSelectors(propertyGroup.ranges));\n  }\n  return selectors;\n}\n\nfunction createRangeParamSelectors(ranges: ECSqlSelectClausePropertyValueRange[]) {\n  return {\n    key: \"ranges\",\n    selector: `json_array(${ranges\n      .map((range) =>\n        serializeJsonObject([\n          {\n            key: \"fromValue\",\n            selector: createECSqlValueSelector(range.fromValue),\n          },\n          {\n            key: \"toValue\",\n            selector: createECSqlValueSelector(range.toValue),\n          },\n          ...(range.rangeLabel\n            ? [\n                {\n                  key: \"rangeLabel\",\n                  selector: `${createECSqlValueSelector(range.rangeLabel)}`,\n                },\n              ]\n            : []),\n        ]),\n      )\n      .join(\", \")})`,\n  };\n}\n\nfunction createBaseGroupingParamSelectors(params: ECSqlSelectClauseGroupingParamsBase) {\n  const selectors = new Array<{ key: string; selector: string }>();\n  if (params.hideIfNoSiblings !== undefined) {\n    selectors.push({\n      key: \"hideIfNoSiblings\",\n      selector: createECSqlValueSelector(params.hideIfNoSiblings),\n    });\n  }\n  if (params.hideIfOneGroupedNode !== undefined) {\n    selectors.push({\n      key: \"hideIfOneGroupedNode\",\n      selector: createECSqlValueSelector(params.hideIfOneGroupedNode),\n    });\n  }\n  if (params.autoExpand !== undefined) {\n    selectors.push({\n      key: \"autoExpand\",\n      selector: createECSqlValueSelector(params.autoExpand),\n    });\n  }\n  return selectors;\n}\n\nfunction serializeJsonObject(selectors: Array<{ key: string; selector: string }>): string {\n  return `json_object(${selectors.map(({ key, selector }) => `'${key}', ${selector}`).join(\", \")})`;\n}\n\nasync function createWhereClause(\n  contentClassAlias: string,\n  classLoader: (alias: string) => Promise<EC.Class | undefined>,\n  rule: GenericInstanceFilterRule | GenericInstanceFilterRuleGroup,\n): Promise<string | undefined> {\n  if (GenericInstanceFilter.isFilterRuleGroup(rule)) {\n    const clause = (await Promise.all(rule.rules.map(async (r) => createWhereClause(contentClassAlias, classLoader, r))))\n      .filter((c) => !!c)\n      .join(` ${getECSqlLogicalOperator(rule.operator)} `);\n    return clause ? (rule.operator === \"or\" ? `(${clause})` : clause) : undefined;\n  }\n  const sourceAlias = rule.sourceAlias ? rule.sourceAlias : contentClassAlias;\n  const propertyValueSelector = ECSql.createRawPropertyValueSelector(sourceAlias, rule.propertyName);\n  if (isUnaryRuleOperator(rule.operator)) {\n    switch (rule.operator) {\n      case \"is-true\":\n        return propertyValueSelector;\n      case \"is-false\":\n        return `NOT ${propertyValueSelector}`;\n      case \"is-null\":\n        return `${propertyValueSelector} IS NULL`;\n      case \"is-not-null\":\n        return `${propertyValueSelector} IS NOT NULL`;\n    }\n  }\n  const ecsqlOperator = getECSqlComparisonOperator(rule.operator);\n  if (rule.value === undefined) {\n    throw new Error(`Rule \"${rule.propertyName}\" ${ecsqlOperator} is missing value.`);\n  }\n\n  const value = rule.value.rawValue;\n\n  if (rule.operator === \"like\" && typeof value === \"string\") {\n    const escapedValue = value.replace(/[%_\\\\]/g, \"\\\\$&\");\n    return `${propertyValueSelector} ${ecsqlOperator} '%${escapedValue}%' ESCAPE '\\\\'`;\n  }\n  const propertyClass = await classLoader(sourceAlias);\n  if (!propertyClass) {\n    throw new Error(`Class with alias \"${sourceAlias}\" not found.`);\n  }\n  const property = await propertyClass.getProperty(rule.propertyName);\n  if (!property) {\n    throw new Error(`Property \"${rule.propertyName}\" not found in ECClass \"${propertyClass.fullName}\".`);\n  }\n  if (property.isNavigation()) {\n    assert(rule.value !== undefined && GenericInstanceFilterRuleValue.isInstanceKey(value));\n    return `${propertyValueSelector}.[Id] ${ecsqlOperator} ${ECSql.createRawPrimitiveValueSelector(value.id)}`;\n  }\n  if (property.isEnumeration()) {\n    assert(rule.value !== undefined && !GenericInstanceFilterRuleValue.isInstanceKey(value));\n    return `${propertyValueSelector} ${ecsqlOperator} ${ECSql.createRawPrimitiveValueSelector(value)}`;\n  }\n  if (property.isPrimitive()) {\n    assert(rule.value !== undefined && !GenericInstanceFilterRuleValue.isInstanceKey(value));\n    switch (property.primitiveType) {\n      case \"Point2d\": {\n        assert(rule.operator === \"is-equal\" || rule.operator === \"is-not-equal\");\n        assert(PrimitiveValue.isPoint2d(value));\n        const condition = `\n          ${createFloatingPointEqualityClause(`${propertyValueSelector}.[x]`, \"is-equal\", value.x)}\n          AND ${createFloatingPointEqualityClause(`${propertyValueSelector}.[y]`, \"is-equal\", value.y)}\n        `;\n        return rule.operator === \"is-equal\" ? condition : `NOT (${condition})`;\n      }\n      case \"Point3d\": {\n        assert(rule.operator === \"is-equal\" || rule.operator === \"is-not-equal\");\n        assert(PrimitiveValue.isPoint3d(value));\n        const condition = `\n          ${createFloatingPointEqualityClause(`${propertyValueSelector}.[x]`, \"is-equal\", value.x)}\n          AND ${createFloatingPointEqualityClause(`${propertyValueSelector}.[y]`, \"is-equal\", value.y)}\n          AND ${createFloatingPointEqualityClause(`${propertyValueSelector}.[z]`, \"is-equal\", value.z)}\n        `;\n        return rule.operator === \"is-equal\" ? condition : `NOT (${condition})`;\n      }\n      case \"Double\": {\n        assert(typeof value === \"number\");\n        if (rule.operator === \"is-equal\" || rule.operator === \"is-not-equal\") {\n          return `${createFloatingPointEqualityClause(propertyValueSelector, rule.operator, value)}`;\n        }\n        return `${propertyValueSelector} ${ecsqlOperator} ${ECSql.createRawPrimitiveValueSelector(value)}`;\n      }\n      default: {\n        return `${propertyValueSelector} ${ecsqlOperator} ${ECSql.createRawPrimitiveValueSelector(value)}`;\n      }\n    }\n  }\n  throw new Error(\"Struct and array properties are not supported for filtering\");\n}\n\nfunction createFloatingPointEqualityClause(valueSelector: string, operator: \"is-equal\" | \"is-not-equal\", value: number) {\n  const [from, to] = getFloatingPointValueRange(value);\n  return `${valueSelector} ${operator === \"is-not-equal\" ? \"NOT \" : \"\"} BETWEEN ${from} AND ${to}`;\n}\n\nfunction getFloatingPointValueRange(value: number): [number, number] {\n  return [value - Number.EPSILON, value + Number.EPSILON];\n}\n\nfunction getECSqlLogicalOperator(op: GenericInstanceFilterRuleGroupOperator) {\n  switch (op) {\n    case \"and\":\n      return \"AND\";\n    case \"or\":\n      return \"OR\";\n  }\n}\n\nfunction isUnaryRuleOperator(\n  op: GenericInstanceFilterRuleOperator,\n): op is Extract<GenericInstanceFilterRuleOperator, \"is-true\" | \"is-false\" | \"is-null\" | \"is-not-null\"> {\n  return op === \"is-true\" || op === \"is-false\" || op === \"is-null\" || op === \"is-not-null\";\n}\n\nfunction getECSqlComparisonOperator(op: Exclude<GenericInstanceFilterRuleOperator, \"is-true\" | \"is-false\" | \"is-null\" | \"is-not-null\">) {\n  switch (op) {\n    case \"is-equal\":\n      return `=`;\n    case \"is-not-equal\":\n      return `<>`;\n    case \"greater\":\n      return `>`;\n    case \"greater-or-equal\":\n      return `>=`;\n    case \"less\":\n      return `<`;\n    case \"less-or-equal\":\n      return `<=`;\n    case \"like\":\n      return `LIKE`;\n  }\n}\n\ntype JoinRelationshipPath = Parameters<typeof ECSql.createRelationshipPathJoinClause>[0][\"path\"];\nfunction assignRelationshipPathAliases(\n  path: GenericInstanceFilterRelationshipStep[],\n  pathIndex: number,\n  sourceAlias: string,\n  targetAlias: string,\n): JoinRelationshipPath {\n  function createAlias(fullClassName: string, index: number) {\n    return `rel_${pathIndex}_${fullClassName.replaceAll(/[\\.:]/g, \"_\")}_${index}`;\n  }\n  const result: JoinRelationshipPath = [];\n  path.forEach((step, i) => {\n    result.push({\n      targetClassName: step.targetClassName,\n      relationshipName: step.relationshipClassName,\n      sourceClassName: step.sourceClassName,\n      relationshipReverse: !step.isForwardRelationship,\n      sourceAlias: i === 0 ? sourceAlias : result[i - 1].targetAlias,\n      relationshipAlias: createAlias(step.relationshipClassName, i),\n      targetAlias: i === path.length - 1 ? targetAlias : createAlias(step.targetClassName, i),\n      joinType: \"inner\",\n    });\n  });\n  return result;\n}\n\ninterface SpecializeContentClassProps {\n  classHierarchyInspector: ECClassHierarchyInspector;\n  contentClassName: string;\n  filterClassNames: string[];\n}\nasync function specializeContentClass(props: SpecializeContentClassProps): Promise<string | undefined> {\n  const filterClass = await getSpecializedPropertyClass(props.classHierarchyInspector, props.filterClassNames);\n  if (!filterClass) {\n    return props.contentClassName;\n  }\n  if (await props.classHierarchyInspector.classDerivesFrom(filterClass, props.contentClassName)) {\n    return filterClass;\n  }\n  if (await props.classHierarchyInspector.classDerivesFrom(props.contentClassName, filterClass)) {\n    return props.contentClassName;\n  }\n  return undefined;\n}\n\nasync function getSpecializedPropertyClass(classHierarchyInspector: ECClassHierarchyInspector, classes: string[]): Promise<string | undefined> {\n  if (classes.length === 0) {\n    return undefined;\n  }\n  const [currClassName, ...restClasses] = classes;\n  let resolvedClassName = currClassName;\n  for (const propClassName of restClasses) {\n    if (await classHierarchyInspector.classDerivesFrom(propClassName, resolvedClassName)) {\n      resolvedClassName = propClassName;\n    }\n  }\n  return resolvedClassName;\n}\n"]}

package/lib/esm/hierarchies/HierarchyDefinition.d.ts

@@ -157,6 +157,24 @@ interface InstancesNodeChildHierarchyLevelDefinition {
      * Called to create a hierarchy level definition when the class check passes (see `parentNodeClassName`).
      */
     definitions: (requestProps: DefineInstanceNodeChildHierarchyLevelProps) => Promise<HierarchyLevelDefinition>;
+    /**
+     * If set to true, and node matches at least one of the previous definitions, this definition will not be applied.
+     *
+     * For example:
+     * ```ts
+     * {
+     *   parentNodeClassName: "BisCore.GeometricElement3d",
+     *   definitions: () => ...,
+     * },
+     * // This will apply to all elements, that are not BisCore.GeometricElement3d
+     * {
+     *   parentNodeClassName: "BisCore.Element",
+     *   onlyIfNotHandled: true,
+     *   definitions: () => ...,
+     * }
+     * ```
+     */
+    onlyIfNotHandled?: boolean;
 }
 /**
  * Props for defining child hierarchy level for specific parent custom node.

package/lib/esm/hierarchies/HierarchyDefinition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HierarchyDefinition.d.ts","sourceRoot":"","sources":["../../../src/hierarchies/HierarchyDefinition.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"HierarchyDefinition.d.ts","sourceRoot":"","sources":["../../../src/hierarchies/HierarchyDefinition.ts"],"names":[],"mappings":"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"}

package/lib/esm/hierarchies/HierarchyDefinition.js

@@ -3,6 +3,7 @@
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
 import { HierarchyNode, } from "./HierarchyNode";
+import { concatMap, filter, firstValueFrom, from, mergeAll, mergeMap, toArray } from "rxjs";
 /** @beta */
 // eslint-disable-next-line @typescript-eslint/no-redeclare
 export var HierarchyNodesDefinition;
@@ -62,12 +63,13 @@ class ClassBasedHierarchyDefinition {
     }
 }
 async function createHierarchyLevelDefinitions(classHierarchy, defs, requestProps) {
-    return (await Promise.all(defs.map(async (def) => {
+    const obs = from(defs).pipe(mergeMap(async (def, idx) => {
         if (await classHierarchy.classDerivesFrom(requestProps.parentNodeClassName, def.parentNodeClassName)) {
-            return def.definitions(requestProps);
+            return { def, idx };
         }
-        return [];
-    }))).flat();
+        return undefined;
+    }), filter((x) => !!x), toArray(), concatMap((x) => x.sort((a, b) => a.idx - b.idx).map(({ def }) => def)), filter((def, idx) => !def.onlyIfNotHandled || idx === 0), mergeMap(async (def) => def.definitions(requestProps)), mergeAll());
+    return firstValueFrom(obs.pipe(toArray()));
 }
 function groupInstanceIdsByClass(instanceKeys) {
     const instanceIdsByClass = new Map();

package/lib/esm/hierarchies/HierarchyDefinition.js.map

@@ -1 +1 @@
-{"version":3,"file":"HierarchyDefinition.js","sourceRoot":"","sources":["../../../src/hierarchies/HierarchyDefinition.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n\nimport { Id64String } from \"@itwin/core-bentley\";\nimport { GenericInstanceFilter } from \"@itwin/core-common\";\nimport { ECClassHierarchyInspector, ECSqlQueryDef, InstanceKey } from \"@itwin/presentation-shared\";\nimport {\n  HierarchyNode,\n  NonGroupingHierarchyNode,\n  ParsedCustomHierarchyNode,\n  ParsedInstanceHierarchyNode,\n  ProcessedCustomHierarchyNode,\n  ProcessedHierarchyNode,\n  ProcessedInstanceHierarchyNode,\n} from \"./HierarchyNode\";\nimport { InstancesNodeKey } from \"./HierarchyNodeKey\";\n\n/** A nodes definition that returns a single custom defined node. */\nexport interface CustomHierarchyNodeDefinition {\n  /** The node to be created in the hierarchy level */\n  node: ParsedCustomHierarchyNode;\n}\n\n/** A nodes definition that returns an ECSQL query for selecting nodes from an iModel. */\nexport interface InstanceNodesQueryDefinition {\n  /**\n   * Full name of the class whose instances are going to be returned. It's okay if the attribute\n   * points to a base class of multiple different classes of instances returned by the query, however\n   * the more specific this class is, the more efficient hierarchy building process is.\n   */\n  fullClassName: string;\n  /**\n   * An ECSQL query that selects nodes from an iModel. `SELECT` clause of the query is expected\n   * to be built using `NodeSelectQueryFactory.createSelectClause`.\n   */\n  query: ECSqlQueryDef;\n}\n\n/**\n * A definition of nodes included in a hierarchy level.\n * @beta\n */\nexport type HierarchyNodesDefinition = CustomHierarchyNodeDefinition | InstanceNodesQueryDefinition;\n/** @beta */\n// eslint-disable-next-line @typescript-eslint/no-redeclare\nexport namespace HierarchyNodesDefinition {\n  export function isCustomNode(def: HierarchyNodesDefinition): def is CustomHierarchyNodeDefinition {\n    return !!(def as CustomHierarchyNodeDefinition).node;\n  }\n  export function isInstanceNodesQuery(def: HierarchyNodesDefinition): def is InstanceNodesQueryDefinition {\n    return !!(def as InstanceNodesQueryDefinition).query;\n  }\n}\n\n/**\n * A definition of a hierarchy level, which may consist of multiple node definitions.\n * @beta\n */\nexport type HierarchyLevelDefinition = HierarchyNodesDefinition[];\n\n/**\n * A type for a function that parses a `ParsedInstanceHierarchyNode` from provided ECSQL `row` object.\n * @beta\n */\nexport type NodeParser = (row: { [columnName: string]: any }) => ParsedInstanceHierarchyNode;\n\n/**\n * A type for a function that pre-processes given node. Unless the function decides not to make any modifications,\n * it should return a new - modified - node, rather than modifying the given one. Returning `undefined` omits the node\n * from the hierarchy.\n *\n * @beta\n */\nexport type NodePreProcessor = <TNode extends ProcessedCustomHierarchyNode | ProcessedInstanceHierarchyNode>(node: TNode) => Promise<TNode | undefined>;\n\n/**\n * A type for a function that post-processes given node. Unless the function decides not to make any modifications,\n * it should return a new - modified - node, rather than modifying the given one.\n *\n * @beta\n */\nexport type NodePostProcessor = (node: ProcessedHierarchyNode) => Promise<ProcessedHierarchyNode>;\n\n/**\n * A type of node that can be passed to `HierarchyDefinition.defineHierarchyLevel`. This basically means\n * a `HierarchyNode` that:\n * - knows nothing about its children,\n * - is either an instances node (key is of `InstancesNodeKey` type) or a custom node (key is of `string` type).\n */\ntype HierarchyDefinitionParentNode = Omit<NonGroupingHierarchyNode, \"children\">;\n\n/**\n * Props for `HierarchyDefinition.defineHierarchyLevel`.\n * @beta\n */\nexport interface DefineHierarchyLevelProps {\n  /** Parent node to get children for. Pass `undefined` to get root nodes. */\n  parentNode: HierarchyDefinitionParentNode | undefined;\n\n  /** Optional hierarchy level filter. */\n  instanceFilter?: GenericInstanceFilter;\n}\n\n/**\n * An interface for a factory that knows how define a hierarchy based on a given parent node.\n * @beta\n */\nexport interface HierarchyDefinition {\n  /**\n   * An optional function for parsing ECInstance node from ECSQL row.\n   *\n   * Should be used in situations when the `HierarchyDefinition` implementation\n   * introduces additional ECSQL columns into the select clause and wants to assign additional\n   * data to the nodes it produces.\n   *\n   * Defaults to a function that parses all `HierarchyNode` attributes from a query, whose SELECT\n   * clause is created using `NodeSelectQueryFactory.createSelectClause`.\n   */\n  parseNode?: NodeParser;\n\n  /**\n   * An optional function for pre-processing nodes.\n   *\n   * Pre-processing happens immediately after the nodes are loaded based on `HierarchyLevelDefinition`\n   * returned by this `HierarchyDefinition` and before their processing (hiding, grouping, sorting, etc.) starts.\n   * The step allows assigning nodes additional data or excluding them from the hierarchy based on some attributes.\n   */\n  preProcessNode?: NodePreProcessor;\n\n  /**\n   * An optional function for post-processing nodes.\n   *\n   * Post-processing happens after the loaded nodes go through all the merging, hiding and grouping\n   * steps, but before sorting them. This step allows `HierarchyDefinition` implementations to assign additional data\n   * to nodes after they're processed. This is especially true for grouping nodes as they're only created during\n   * processing.\n   */\n  postProcessNode?: NodePostProcessor;\n\n  /** A function to create a hierarchy level definition for given parent node. */\n  defineHierarchyLevel(props: DefineHierarchyLevelProps): Promise<HierarchyLevelDefinition>;\n}\n\n/**\n * Props for defining child hierarchy level for specific parent instance node.\n * @see `createClassBasedHierarchyDefinition`\n * @beta\n */\nexport type DefineInstanceNodeChildHierarchyLevelProps = Omit<DefineHierarchyLevelProps, \"parentNode\"> & {\n  /** The parent instance node. */\n  parentNode: Omit<HierarchyDefinitionParentNode, \"key\"> & { key: InstancesNodeKey };\n\n  /**\n   * Full name of the parent instance node class.\n   *\n   * The `parentNode.key` also contains information about the instances the parent node is based on. However,\n   * an instance node may be based on instances of multiple classes. In case that happens, parent node's instance\n   * keys are grouped by class and a hierarchy level definition is requested for each combination of class and\n   * instance IDs (with the same `parentNode`).\n   */\n  parentNodeClassName: string;\n\n  /**\n   * ECInstanceIds of the parent instance node.\n   *\n   * The `parentNode.key` also contains information about the instances the parent node is based on. However,\n   * an instance node may be based on instances of multiple classes. In case that happens, parent node's instance\n   * keys are grouped by class and a hierarchy level definition is requested for each combination of class and\n   * instance IDs (with the same `parentNode`).\n   */\n  parentNodeInstanceIds: Id64String[];\n};\n\n/**\n * A definition of a hierarchy level that should be used for specific class of parent instance nodes.\n */\ninterface InstancesNodeChildHierarchyLevelDefinition {\n  /**\n   * Full name of the parent instance node's class to match against when checking if this hierarchy\n   * level should be used for specific parent instance node.\n   *\n   * The check is polymorphic, so `BisCore.Element` class would match `BisCore.GeometricElement`, `BisCore.Category` and\n   * all other element classes.\n   */\n  parentNodeClassName: string;\n\n  /**\n   * Called to create a hierarchy level definition when the class check passes (see `parentNodeClassName`).\n   */\n  definitions: (requestProps: DefineInstanceNodeChildHierarchyLevelProps) => Promise<HierarchyLevelDefinition>;\n}\n\n/**\n * Props for defining child hierarchy level for specific parent custom node.\n * @see `createClassBasedHierarchyDefinition`\n * @beta\n */\nexport type DefineCustomNodeChildHierarchyLevelProps = Omit<DefineHierarchyLevelProps, \"parentNode\"> & {\n  /** The parent custom node. */\n  parentNode: Omit<HierarchyDefinitionParentNode, \"key\"> & { key: string };\n};\n\n/**\n * A definition of a hierarchy level for that should be used for specific custom parent nodes.\n */\ninterface CustomNodeChildHierarchyLevelDefinition {\n  /**\n   * `HierarchyNode.key` of the custom node that this child hierarchy level definition should be used for.\n   */\n  customParentNodeKey: string;\n\n  /**\n   * Called to create a hierarchy level definition when the node key check passes (see `customParentNodeKey`).\n   */\n  definitions: (requestProps: DefineCustomNodeChildHierarchyLevelProps) => Promise<HierarchyLevelDefinition>;\n}\n\n/**\n * A hierarchy level definition associated with either parent instance node's class or custom\n * node's key.\n */\ntype ClassBasedHierarchyLevelDefinition = InstancesNodeChildHierarchyLevelDefinition | CustomNodeChildHierarchyLevelDefinition;\n\n/**\n * Props for defining root hierarchy level.\n * @see `createClassBasedHierarchyDefinition`\n * @beta\n */\nexport type DefineRootHierarchyLevelProps = Omit<DefineHierarchyLevelProps, \"parentNode\">;\n\n/**\n * Props for `createClassBasedHierarchyDefinition`.\n */\ninterface ClassBasedHierarchyDefinitionProps {\n  /** Access to ECClass hierarchy in the iModel */\n  classHierarchyInspector: ECClassHierarchyInspector;\n\n  /** Hierarchy level definitions based on parent instance node's class or custom node's key. */\n  hierarchy: {\n    /** Called to create the root hierarchy level definition. */\n    rootNodes: (props: DefineRootHierarchyLevelProps) => Promise<HierarchyLevelDefinition>;\n\n    /**\n     * Called to get child hierarchy level definitions based on parent instance node's class\n     * or custom node's key.\n     */\n    childNodes: ClassBasedHierarchyLevelDefinition[];\n  };\n}\n\n/**\n * Creates an instance of `HierarchyDefinition` that uses a somewhat declarative approach to define the\n * hierarchy - each hierarchy level is assigned either an instance node's class or custom node's\n * key and they're used to assign hierarchy level definitions based on parent node.\n *\n * @beta\n */\nexport function createClassBasedHierarchyDefinition(props: ClassBasedHierarchyDefinitionProps): HierarchyDefinition {\n  return new ClassBasedHierarchyDefinition(props);\n}\n\nclass ClassBasedHierarchyDefinition implements HierarchyDefinition {\n  public constructor(private _props: ClassBasedHierarchyDefinitionProps) {}\n\n  /**\n   * Create hierarchy level definitions for specific hierarchy level.\n   * @param parentNode Parent node to create children definitions for.\n   */\n  public async defineHierarchyLevel(props: DefineHierarchyLevelProps): Promise<HierarchyLevelDefinition> {\n    const { parentNode } = props;\n    if (!parentNode) {\n      return this._props.hierarchy.rootNodes(props);\n    }\n\n    if (HierarchyNode.isCustom(parentNode)) {\n      const defs = this._props.hierarchy.childNodes\n        .filter(isCustomNodeChildHierarchyLevelDefinition)\n        .filter((def) => def.customParentNodeKey === parentNode.key);\n      return (await Promise.all(defs.map(async (def) => def.definitions({ ...props, parentNode })))).flat();\n    }\n\n    // istanbul ignore else\n    if (HierarchyNode.isInstancesNode(parentNode)) {\n      const instanceIdsByClass = groupInstanceIdsByClass(parentNode.key.instanceKeys);\n      const instancesParentNodeDefs = this._props.hierarchy.childNodes.filter(isInstancesNodeChildHierarchyLevelDefinition);\n      return (\n        await Promise.all(\n          [...instanceIdsByClass.entries()].map(async ([parentNodeClassName, parentNodeInstanceIds]) =>\n            createHierarchyLevelDefinitions(this._props.classHierarchyInspector, instancesParentNodeDefs, {\n              ...props,\n              parentNodeClassName,\n              parentNodeInstanceIds,\n              parentNode,\n            }),\n          ),\n        )\n      ).flat();\n    }\n\n    // istanbul ignore next\n    return [];\n  }\n}\n\nasync function createHierarchyLevelDefinitions(\n  classHierarchy: ECClassHierarchyInspector,\n  defs: InstancesNodeChildHierarchyLevelDefinition[],\n  requestProps: DefineInstanceNodeChildHierarchyLevelProps,\n) {\n  return (\n    await Promise.all(\n      defs.map(async (def) => {\n        if (await classHierarchy.classDerivesFrom(requestProps.parentNodeClassName, def.parentNodeClassName)) {\n          return def.definitions(requestProps);\n        }\n        return [];\n      }),\n    )\n  ).flat();\n}\n\nfunction groupInstanceIdsByClass(instanceKeys: InstanceKey[]) {\n  const instanceIdsByClass = new Map<string, Id64String[]>();\n  instanceKeys.forEach((key) => {\n    let instanceIds = instanceIdsByClass.get(key.className);\n    if (!instanceIds) {\n      instanceIds = [];\n      instanceIdsByClass.set(key.className, instanceIds);\n    }\n    instanceIds.push(key.id);\n  });\n  return instanceIdsByClass;\n}\n\nfunction isCustomNodeChildHierarchyLevelDefinition(def: ClassBasedHierarchyLevelDefinition): def is CustomNodeChildHierarchyLevelDefinition {\n  return !!(def as CustomNodeChildHierarchyLevelDefinition).customParentNodeKey;\n}\n\nfunction isInstancesNodeChildHierarchyLevelDefinition(def: ClassBasedHierarchyLevelDefinition): def is InstancesNodeChildHierarchyLevelDefinition {\n  return !!(def as InstancesNodeChildHierarchyLevelDefinition).parentNodeClassName;\n}\n"]}
+{"version":3,"file":"HierarchyDefinition.js","sourceRoot":"","sources":["../../../src/hierarchies/HierarchyDefinition.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n\nimport { Id64String } from \"@itwin/core-bentley\";\nimport { GenericInstanceFilter } from \"@itwin/core-common\";\nimport { ECClassHierarchyInspector, ECSqlQueryDef, InstanceKey } from \"@itwin/presentation-shared\";\nimport {\n  HierarchyNode,\n  NonGroupingHierarchyNode,\n  ParsedCustomHierarchyNode,\n  ParsedInstanceHierarchyNode,\n  ProcessedCustomHierarchyNode,\n  ProcessedHierarchyNode,\n  ProcessedInstanceHierarchyNode,\n} from \"./HierarchyNode\";\nimport { InstancesNodeKey } from \"./HierarchyNodeKey\";\nimport { concatMap, filter, firstValueFrom, from, mergeAll, mergeMap, toArray } from \"rxjs\";\n\n/** A nodes definition that returns a single custom defined node. */\nexport interface CustomHierarchyNodeDefinition {\n  /** The node to be created in the hierarchy level */\n  node: ParsedCustomHierarchyNode;\n}\n\n/** A nodes definition that returns an ECSQL query for selecting nodes from an iModel. */\nexport interface InstanceNodesQueryDefinition {\n  /**\n   * Full name of the class whose instances are going to be returned. It's okay if the attribute\n   * points to a base class of multiple different classes of instances returned by the query, however\n   * the more specific this class is, the more efficient hierarchy building process is.\n   */\n  fullClassName: string;\n  /**\n   * An ECSQL query that selects nodes from an iModel. `SELECT` clause of the query is expected\n   * to be built using `NodeSelectQueryFactory.createSelectClause`.\n   */\n  query: ECSqlQueryDef;\n}\n\n/**\n * A definition of nodes included in a hierarchy level.\n * @beta\n */\nexport type HierarchyNodesDefinition = CustomHierarchyNodeDefinition | InstanceNodesQueryDefinition;\n/** @beta */\n// eslint-disable-next-line @typescript-eslint/no-redeclare\nexport namespace HierarchyNodesDefinition {\n  export function isCustomNode(def: HierarchyNodesDefinition): def is CustomHierarchyNodeDefinition {\n    return !!(def as CustomHierarchyNodeDefinition).node;\n  }\n  export function isInstanceNodesQuery(def: HierarchyNodesDefinition): def is InstanceNodesQueryDefinition {\n    return !!(def as InstanceNodesQueryDefinition).query;\n  }\n}\n\n/**\n * A definition of a hierarchy level, which may consist of multiple node definitions.\n * @beta\n */\nexport type HierarchyLevelDefinition = HierarchyNodesDefinition[];\n\n/**\n * A type for a function that parses a `ParsedInstanceHierarchyNode` from provided ECSQL `row` object.\n * @beta\n */\nexport type NodeParser = (row: { [columnName: string]: any }) => ParsedInstanceHierarchyNode;\n\n/**\n * A type for a function that pre-processes given node. Unless the function decides not to make any modifications,\n * it should return a new - modified - node, rather than modifying the given one. Returning `undefined` omits the node\n * from the hierarchy.\n *\n * @beta\n */\nexport type NodePreProcessor = <TNode extends ProcessedCustomHierarchyNode | ProcessedInstanceHierarchyNode>(node: TNode) => Promise<TNode | undefined>;\n\n/**\n * A type for a function that post-processes given node. Unless the function decides not to make any modifications,\n * it should return a new - modified - node, rather than modifying the given one.\n *\n * @beta\n */\nexport type NodePostProcessor = (node: ProcessedHierarchyNode) => Promise<ProcessedHierarchyNode>;\n\n/**\n * A type of node that can be passed to `HierarchyDefinition.defineHierarchyLevel`. This basically means\n * a `HierarchyNode` that:\n * - knows nothing about its children,\n * - is either an instances node (key is of `InstancesNodeKey` type) or a custom node (key is of `string` type).\n */\ntype HierarchyDefinitionParentNode = Omit<NonGroupingHierarchyNode, \"children\">;\n\n/**\n * Props for `HierarchyDefinition.defineHierarchyLevel`.\n * @beta\n */\nexport interface DefineHierarchyLevelProps {\n  /** Parent node to get children for. Pass `undefined` to get root nodes. */\n  parentNode: HierarchyDefinitionParentNode | undefined;\n\n  /** Optional hierarchy level filter. */\n  instanceFilter?: GenericInstanceFilter;\n}\n\n/**\n * An interface for a factory that knows how define a hierarchy based on a given parent node.\n * @beta\n */\nexport interface HierarchyDefinition {\n  /**\n   * An optional function for parsing ECInstance node from ECSQL row.\n   *\n   * Should be used in situations when the `HierarchyDefinition` implementation\n   * introduces additional ECSQL columns into the select clause and wants to assign additional\n   * data to the nodes it produces.\n   *\n   * Defaults to a function that parses all `HierarchyNode` attributes from a query, whose SELECT\n   * clause is created using `NodeSelectQueryFactory.createSelectClause`.\n   */\n  parseNode?: NodeParser;\n\n  /**\n   * An optional function for pre-processing nodes.\n   *\n   * Pre-processing happens immediately after the nodes are loaded based on `HierarchyLevelDefinition`\n   * returned by this `HierarchyDefinition` and before their processing (hiding, grouping, sorting, etc.) starts.\n   * The step allows assigning nodes additional data or excluding them from the hierarchy based on some attributes.\n   */\n  preProcessNode?: NodePreProcessor;\n\n  /**\n   * An optional function for post-processing nodes.\n   *\n   * Post-processing happens after the loaded nodes go through all the merging, hiding and grouping\n   * steps, but before sorting them. This step allows `HierarchyDefinition` implementations to assign additional data\n   * to nodes after they're processed. This is especially true for grouping nodes as they're only created during\n   * processing.\n   */\n  postProcessNode?: NodePostProcessor;\n\n  /** A function to create a hierarchy level definition for given parent node. */\n  defineHierarchyLevel(props: DefineHierarchyLevelProps): Promise<HierarchyLevelDefinition>;\n}\n\n/**\n * Props for defining child hierarchy level for specific parent instance node.\n * @see `createClassBasedHierarchyDefinition`\n * @beta\n */\nexport type DefineInstanceNodeChildHierarchyLevelProps = Omit<DefineHierarchyLevelProps, \"parentNode\"> & {\n  /** The parent instance node. */\n  parentNode: Omit<HierarchyDefinitionParentNode, \"key\"> & { key: InstancesNodeKey };\n\n  /**\n   * Full name of the parent instance node class.\n   *\n   * The `parentNode.key` also contains information about the instances the parent node is based on. However,\n   * an instance node may be based on instances of multiple classes. In case that happens, parent node's instance\n   * keys are grouped by class and a hierarchy level definition is requested for each combination of class and\n   * instance IDs (with the same `parentNode`).\n   */\n  parentNodeClassName: string;\n\n  /**\n   * ECInstanceIds of the parent instance node.\n   *\n   * The `parentNode.key` also contains information about the instances the parent node is based on. However,\n   * an instance node may be based on instances of multiple classes. In case that happens, parent node's instance\n   * keys are grouped by class and a hierarchy level definition is requested for each combination of class and\n   * instance IDs (with the same `parentNode`).\n   */\n  parentNodeInstanceIds: Id64String[];\n};\n\n/**\n * A definition of a hierarchy level that should be used for specific class of parent instance nodes.\n */\ninterface InstancesNodeChildHierarchyLevelDefinition {\n  /**\n   * Full name of the parent instance node's class to match against when checking if this hierarchy\n   * level should be used for specific parent instance node.\n   *\n   * The check is polymorphic, so `BisCore.Element` class would match `BisCore.GeometricElement`, `BisCore.Category` and\n   * all other element classes.\n   */\n  parentNodeClassName: string;\n\n  /**\n   * Called to create a hierarchy level definition when the class check passes (see `parentNodeClassName`).\n   */\n  definitions: (requestProps: DefineInstanceNodeChildHierarchyLevelProps) => Promise<HierarchyLevelDefinition>;\n\n  /**\n   * If set to true, and node matches at least one of the previous definitions, this definition will not be applied.\n   *\n   * For example:\n   * ```ts\n   * {\n   *   parentNodeClassName: \"BisCore.GeometricElement3d\",\n   *   definitions: () => ...,\n   * },\n   * // This will apply to all elements, that are not BisCore.GeometricElement3d\n   * {\n   *   parentNodeClassName: \"BisCore.Element\",\n   *   onlyIfNotHandled: true,\n   *   definitions: () => ...,\n   * }\n   * ```\n   */\n  onlyIfNotHandled?: boolean;\n}\n\n/**\n * Props for defining child hierarchy level for specific parent custom node.\n * @see `createClassBasedHierarchyDefinition`\n * @beta\n */\nexport type DefineCustomNodeChildHierarchyLevelProps = Omit<DefineHierarchyLevelProps, \"parentNode\"> & {\n  /** The parent custom node. */\n  parentNode: Omit<HierarchyDefinitionParentNode, \"key\"> & { key: string };\n};\n\n/**\n * A definition of a hierarchy level for that should be used for specific custom parent nodes.\n */\ninterface CustomNodeChildHierarchyLevelDefinition {\n  /**\n   * `HierarchyNode.key` of the custom node that this child hierarchy level definition should be used for.\n   */\n  customParentNodeKey: string;\n\n  /**\n   * Called to create a hierarchy level definition when the node key check passes (see `customParentNodeKey`).\n   */\n  definitions: (requestProps: DefineCustomNodeChildHierarchyLevelProps) => Promise<HierarchyLevelDefinition>;\n}\n\n/**\n * A hierarchy level definition associated with either parent instance node's class or custom\n * node's key.\n */\ntype ClassBasedHierarchyLevelDefinition = InstancesNodeChildHierarchyLevelDefinition | CustomNodeChildHierarchyLevelDefinition;\n\n/**\n * Props for defining root hierarchy level.\n * @see `createClassBasedHierarchyDefinition`\n * @beta\n */\nexport type DefineRootHierarchyLevelProps = Omit<DefineHierarchyLevelProps, \"parentNode\">;\n\n/**\n * Props for `createClassBasedHierarchyDefinition`.\n */\ninterface ClassBasedHierarchyDefinitionProps {\n  /** Access to ECClass hierarchy in the iModel */\n  classHierarchyInspector: ECClassHierarchyInspector;\n\n  /** Hierarchy level definitions based on parent instance node's class or custom node's key. */\n  hierarchy: {\n    /** Called to create the root hierarchy level definition. */\n    rootNodes: (props: DefineRootHierarchyLevelProps) => Promise<HierarchyLevelDefinition>;\n\n    /**\n     * Called to get child hierarchy level definitions based on parent instance node's class\n     * or custom node's key.\n     */\n    childNodes: ClassBasedHierarchyLevelDefinition[];\n  };\n}\n\n/**\n * Creates an instance of `HierarchyDefinition` that uses a somewhat declarative approach to define the\n * hierarchy - each hierarchy level is assigned either an instance node's class or custom node's\n * key and they're used to assign hierarchy level definitions based on parent node.\n *\n * @beta\n */\nexport function createClassBasedHierarchyDefinition(props: ClassBasedHierarchyDefinitionProps): HierarchyDefinition {\n  return new ClassBasedHierarchyDefinition(props);\n}\n\nclass ClassBasedHierarchyDefinition implements HierarchyDefinition {\n  public constructor(private _props: ClassBasedHierarchyDefinitionProps) {}\n\n  /**\n   * Create hierarchy level definitions for specific hierarchy level.\n   * @param parentNode Parent node to create children definitions for.\n   */\n  public async defineHierarchyLevel(props: DefineHierarchyLevelProps): Promise<HierarchyLevelDefinition> {\n    const { parentNode } = props;\n    if (!parentNode) {\n      return this._props.hierarchy.rootNodes(props);\n    }\n\n    if (HierarchyNode.isCustom(parentNode)) {\n      const defs = this._props.hierarchy.childNodes\n        .filter(isCustomNodeChildHierarchyLevelDefinition)\n        .filter((def) => def.customParentNodeKey === parentNode.key);\n      return (await Promise.all(defs.map(async (def) => def.definitions({ ...props, parentNode })))).flat();\n    }\n\n    // istanbul ignore else\n    if (HierarchyNode.isInstancesNode(parentNode)) {\n      const instanceIdsByClass = groupInstanceIdsByClass(parentNode.key.instanceKeys);\n      const instancesParentNodeDefs = this._props.hierarchy.childNodes.filter(isInstancesNodeChildHierarchyLevelDefinition);\n      return (\n        await Promise.all(\n          [...instanceIdsByClass.entries()].map(async ([parentNodeClassName, parentNodeInstanceIds]) =>\n            createHierarchyLevelDefinitions(this._props.classHierarchyInspector, instancesParentNodeDefs, {\n              ...props,\n              parentNodeClassName,\n              parentNodeInstanceIds,\n              parentNode,\n            }),\n          ),\n        )\n      ).flat();\n    }\n\n    // istanbul ignore next\n    return [];\n  }\n}\n\nasync function createHierarchyLevelDefinitions(\n  classHierarchy: ECClassHierarchyInspector,\n  defs: InstancesNodeChildHierarchyLevelDefinition[],\n  requestProps: DefineInstanceNodeChildHierarchyLevelProps,\n) {\n  const obs = from(defs).pipe(\n    mergeMap(async (def, idx) => {\n      if (await classHierarchy.classDerivesFrom(requestProps.parentNodeClassName, def.parentNodeClassName)) {\n        return { def, idx };\n      }\n      return undefined;\n    }),\n    filter((x): x is Exclude<typeof x, undefined> => !!x),\n    toArray(),\n    concatMap((x) => x.sort((a, b) => a.idx - b.idx).map(({ def }) => def)),\n    filter((def, idx) => !def.onlyIfNotHandled || idx === 0),\n    mergeMap(async (def) => def.definitions(requestProps)),\n    mergeAll(),\n  );\n  return firstValueFrom(obs.pipe(toArray()));\n}\n\nfunction groupInstanceIdsByClass(instanceKeys: InstanceKey[]) {\n  const instanceIdsByClass = new Map<string, Id64String[]>();\n  instanceKeys.forEach((key) => {\n    let instanceIds = instanceIdsByClass.get(key.className);\n    if (!instanceIds) {\n      instanceIds = [];\n      instanceIdsByClass.set(key.className, instanceIds);\n    }\n    instanceIds.push(key.id);\n  });\n  return instanceIdsByClass;\n}\n\nfunction isCustomNodeChildHierarchyLevelDefinition(def: ClassBasedHierarchyLevelDefinition): def is CustomNodeChildHierarchyLevelDefinition {\n  return !!(def as CustomNodeChildHierarchyLevelDefinition).customParentNodeKey;\n}\n\nfunction isInstancesNodeChildHierarchyLevelDefinition(def: ClassBasedHierarchyLevelDefinition): def is InstancesNodeChildHierarchyLevelDefinition {\n  return !!(def as InstancesNodeChildHierarchyLevelDefinition).parentNodeClassName;\n}\n"]}

package/lib/esm/hierarchies/NodeSelectQueryFactory.js

@@ -325,7 +325,8 @@ async function createWhereClause(contentClassAlias, classLoader, rule) {
     }
     const value = rule.value.rawValue;
     if (rule.operator === "like" && typeof value === "string") {
-        return `${propertyValueSelector} ${ecsqlOperator} '${value}' ESCAPE '\\'`;
+        const escapedValue = value.replace(/[%_\\]/g, "\\$&");
+        return `${propertyValueSelector} ${ecsqlOperator} '%${escapedValue}%' ESCAPE '\\'`;
     }
     const propertyClass = await classLoader(sourceAlias);
     if (!propertyClass) {

package/lib/esm/hierarchies/NodeSelectQueryFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"NodeSelectQueryFactory.js","sourceRoot":"","sources":["../../../src/hierarchies/NodeSelectQueryFactory.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n\nimport { assert, Id64String } from \"@itwin/core-bentley\";\nimport {\n  GenericInstanceFilter,\n  GenericInstanceFilterRelationshipStep,\n  GenericInstanceFilterRule,\n  GenericInstanceFilterRuleGroup,\n  GenericInstanceFilterRuleGroupOperator,\n  GenericInstanceFilterRuleOperator,\n  GenericInstanceFilterRuleValue,\n} from \"@itwin/core-common\";\nimport { EC, ECClassHierarchyInspector, ECSchemaProvider, ECSql, getClass, parseFullClassName, PrimitiveValue } from \"@itwin/presentation-shared\";\n\n/**\n * Column names of the SELECT clause created by `NodeSelectClauseFactory`. Order of the names matches the order of columns\n * created by the factory.\n *\n * @beta\n */\nexport enum NodeSelectClauseColumnNames {\n  /** Full class name of the instance the node represents. Type: `string` in format `{schema name}:{class name}`. */\n  FullClassName = \"FullClassName\",\n  /** ECInstance ID of the instance the node represents. Type: `Id64String`. */\n  ECInstanceId = \"ECInstanceId\",\n  /** Display label. Type: `string`. */\n  DisplayLabel = \"DisplayLabel\",\n  /**\n   * A flag indicating if the node has children. Type: `boolean`. Values:\n   * - `false` - node never has children.\n   * - `true` - node always has children.\n   * - NULL - unknown, needs to be determined by requesting children for the node.\n   */\n  HasChildren = \"HasChildren\",\n  /** A flag indicating that a node should be hidden if it has no children. Type: `boolean`. */\n  HideIfNoChildren = \"HideIfNoChildren\",\n  /** A flag indicating that a node should be hidden and its children should be displayed instead. Type: `boolean`. */\n  HideNodeInHierarchy = \"HideNodeInHierarchy\",\n  /** A serialized JSON object for providing grouping information. */\n  Grouping = \"Grouping\",\n  /** A serialized JSON object for associating a node with additional data. */\n  ExtendedData = \"ExtendedData\",\n  /** A flag indicating the node should be auto-expanded when it's loaded. */\n  AutoExpand = \"AutoExpand\",\n  /** A flag indicating the node supports child hierarchy level filtering. */\n  SupportsFiltering = \"SupportsFiltering\",\n}\n\n/**\n * A data structure for defining an ECSQL value selector.\n */\ninterface ECSqlValueSelector {\n  selector: string;\n}\n\n/**\n * Props for `NodeSelectClauseFactory.createSelectClause`.\n */\ninterface NodeSelectClauseProps {\n  ecClassId: Id64String | ECSqlValueSelector;\n  ecInstanceId: Id64String | ECSqlValueSelector;\n  nodeLabel: string | ECSqlValueSelector;\n  extendedData?: {\n    [key: string]: Id64String | string | number | boolean | ECSqlValueSelector;\n  };\n  autoExpand?: boolean | ECSqlValueSelector;\n  supportsFiltering?: boolean | ECSqlValueSelector;\n  hasChildren?: boolean | ECSqlValueSelector;\n  hideNodeInHierarchy?: boolean | ECSqlValueSelector;\n  hideIfNoChildren?: boolean | ECSqlValueSelector;\n  grouping?: ECSqlSelectClauseGroupingParams;\n}\n\n/**\n * A data structure for defining nodes' grouping requirements.\n */\ninterface ECSqlSelectClauseGroupingParams {\n  byLabel?: ECSqlSelectClauseLabelGroupingParams;\n  byClass?: boolean | ECSqlSelectClauseGroupingParamsBase | ECSqlValueSelector;\n  byBaseClasses?: ECSqlSelectClauseBaseClassGroupingParams;\n  byProperties?: ECSqlSelectClausePropertiesGroupingParams;\n}\n\n/**\n * A data structure for defining label grouping params.\n */\ninterface ECSqlSelectClauseLabelGroupingBaseParams {\n  /** Label grouping option that determines whether to group nodes or to merge them. Defaults to \"group\".*/\n  action?: \"group\" | \"merge\";\n  /** Id that needs to match for nodes to be grouped or merged.*/\n  groupId?: string | ECSqlValueSelector;\n}\n\n/**\n * A data structure for defining label merging.\n */\ninterface ECSqlSelectClauseLabelGroupingMergeParams extends ECSqlSelectClauseLabelGroupingBaseParams {\n  action: \"merge\";\n}\n\n/**\n * A data structure for defining label grouping.\n */\ninterface ECSqlSelectClauseLabelGroupingGroupParams extends ECSqlSelectClauseLabelGroupingBaseParams, ECSqlSelectClauseGroupingParamsBase {\n  action?: \"group\";\n}\n\n/**\n * A data structure for defining possible label grouping types.\n */\ntype ECSqlSelectClauseLabelGroupingParams =\n  | boolean\n  | ECSqlValueSelector\n  | ECSqlSelectClauseLabelGroupingMergeParams\n  | ECSqlSelectClauseLabelGroupingGroupParams;\n\n/**\n * A data structure for defining base grouping parameters shared across all types of grouping.\n */\ninterface ECSqlSelectClauseGroupingParamsBase {\n  hideIfNoSiblings?: boolean | ECSqlValueSelector;\n  hideIfOneGroupedNode?: boolean | ECSqlValueSelector;\n  autoExpand?: string | ECSqlValueSelector;\n}\n\n/**\n * A data structure for defining properties grouping.\n */\ninterface ECSqlSelectClausePropertiesGroupingParams extends ECSqlSelectClauseGroupingParamsBase {\n  /**\n   * Full name of a class whose properties are used to group the node. Only has effect if the node\n   * represents an instance of that class.\n   *\n   * Full class name format: `SchemaName.ClassName`.\n   */\n  propertiesClassName: string;\n  /**\n   * Property grouping option that determines whether to group nodes whose grouping value is not set or is set to an empty string.\n   *\n   * Label of the created grouping node will be `Not Specified`.\n   */\n  createGroupForUnspecifiedValues?: boolean | ECSqlValueSelector;\n  /**\n   * Property grouping option that determines whether to group nodes whose grouping value doesn't fit within any of the provided\n   * ranges, or is not a numeric value.\n   *\n   * Label of the created grouping node will be `Other`.\n   */\n  createGroupForOutOfRangeValues?: boolean | ECSqlValueSelector;\n  /**\n   * Properties of the specified class, by which the nodes should be grouped.\n   *\n   * Example usage:\n   * ```ts\n   * propertyGroups: [\n   *   {\n   *     propertyName: \"type\",\n   *     propertyClassAlias: \"this\"\n   *   },\n   *   {\n   *     propertyName: \"length\",\n   *     propertyClassAlias: \"x\",\n   *     ranges: [\n   *       { fromValue: 1, toValue: 10, rangeLabel: \"Small\" },\n   *       { fromValue: 11, toValue: 20, rangeLabel: \"Medium\" }\n   *     ]\n   *   },\n   * ]\n   * ```\n   */\n  propertyGroups: ECSqlSelectClausePropertyGroup[];\n}\n\n/**\n * A data structure for defining specific properties' grouping params.\n */\ninterface ECSqlSelectClausePropertyGroup {\n  /** A string indicating the name of the property to group by. */\n  propertyName: string;\n  /** Alias to of the class containing the property. Used to select the property value. */\n  propertyClassAlias: string;\n  /** Ranges are used to group nodes by numeric properties which are within specified bounds. */\n  ranges?: ECSqlSelectClausePropertyValueRange[];\n}\n\n/**\n * A data structure for defining boundaries for a value.\n */\ninterface ECSqlSelectClausePropertyValueRange {\n  /** Defines the lower bound of the range. */\n  fromValue: number | ECSqlValueSelector;\n  /** Defines the upper bound of the range. */\n  toValue: number | ECSqlValueSelector;\n  /** Defines the range label. Will be used as grouping node's display label. */\n  rangeLabel?: string | ECSqlValueSelector;\n}\n\n/**\n * A data structure for defining base class grouping.\n */\ninterface ECSqlSelectClauseBaseClassGroupingParams extends ECSqlSelectClauseGroupingParamsBase {\n  fullClassNames: string[] | ECSqlValueSelector[];\n}\n\n/**\n * An interface of a factory that knows how to create nodes' select ECSQL query.\n * @beta\n */\nexport interface NodesQueryClauseFactory {\n  /** Create a SELECT clause in a format understood by nodes query parser used by `HierarchyProvider`. */\n  createSelectClause(props: NodeSelectClauseProps): Promise<string>;\n\n  /** Create FROM, JOIN and WHERE clauses whose combination results in an ECSQL filter defined by given `GenericInstanceFilter`. */\n  createFilterClauses(props: {\n    contentClass: { fullName: string; alias: string };\n    filter: GenericInstanceFilter | undefined;\n  }): Promise<{ from: string; where: string; joins: string }>;\n}\n\n/**\n * Creates an instance of `NodeSelectQueryFactory` that .\n * @beta\n */\nexport function createNodesQueryClauseFactory(props: { imodelAccess: ECSchemaProvider & ECClassHierarchyInspector }): NodesQueryClauseFactory {\n  return new NodeSelectQueryFactory(props);\n}\n\n/** A factory for creating a nodes' select ECSQL query. */\nclass NodeSelectQueryFactory {\n  private _imodelAccess: ECSchemaProvider & ECClassHierarchyInspector;\n\n  public constructor(props: { imodelAccess: ECSchemaProvider & ECClassHierarchyInspector }) {\n    this._imodelAccess = props.imodelAccess;\n  }\n\n  /** Create a SELECT clause in a format understood by results reader of the library. */\n  public async createSelectClause(props: NodeSelectClauseProps) {\n    // note: the columns order must match the order in `NodeSelectClauseColumnNames`\n    return `\n      ec_ClassName(${createECSqlValueSelector(props.ecClassId)}) AS ${NodeSelectClauseColumnNames.FullClassName},\n      ${createECSqlValueSelector(props.ecInstanceId)} AS ${NodeSelectClauseColumnNames.ECInstanceId},\n      ${createECSqlValueSelector(props.nodeLabel)} AS ${NodeSelectClauseColumnNames.DisplayLabel},\n      CAST(${createECSqlValueSelector(props.hasChildren)} AS BOOLEAN) AS ${NodeSelectClauseColumnNames.HasChildren},\n      CAST(${createECSqlValueSelector(props.hideIfNoChildren)} AS BOOLEAN) AS ${NodeSelectClauseColumnNames.HideIfNoChildren},\n      CAST(${createECSqlValueSelector(props.hideNodeInHierarchy)} AS BOOLEAN) AS ${NodeSelectClauseColumnNames.HideNodeInHierarchy},\n      ${props.grouping ? createGroupingSelector(props.grouping) : \"CAST(NULL AS TEXT)\"} AS ${NodeSelectClauseColumnNames.Grouping},\n      ${\n        props.extendedData\n          ? `json_object(${Object.entries(props.extendedData)\n              .map(([key, value]) => `'${key}', ${createECSqlValueSelector(value)}`)\n              .join(\", \")})`\n          : \"CAST(NULL AS TEXT)\"\n      } AS ${NodeSelectClauseColumnNames.ExtendedData},\n      CAST(${createECSqlValueSelector(props.autoExpand)} AS BOOLEAN) AS ${NodeSelectClauseColumnNames.AutoExpand},\n      CAST(${createECSqlValueSelector(props.supportsFiltering)} AS BOOLEAN) AS ${NodeSelectClauseColumnNames.SupportsFiltering}\n    `;\n  }\n\n  /**\n   * Creates the necessary ECSQL snippets to create an instance filter described by the `def` argument.\n   * - `from` is set to either the `contentClass.fullName` or `def.propertyClassName`, depending on which is more specific.\n   * - `joins` is set to a number of `JOIN` clauses required to join all relationships described by `def.relatedInstances`.\n   * - `where` is set to a `WHERE` clause (without the `WHERE` keyword) that filters instances by classes on\n   * `def.filterClassNames` and by properties as described by `def.rules`.\n   *\n   * Special cases:\n   * - If `def` is `undefined`, `joins` and `where` are set to empty strings and `from` is set to `contentClass.fullName`.\n   * - If the provided content class doesn't intersect with the property class in provided filter, a special result\n   * is returned to make sure the resulting query is valid and doesn't return anything.\n   */\n  public async createFilterClauses(props: {\n    contentClass: { fullName: string; alias: string };\n    filter: GenericInstanceFilter | undefined;\n  }): Promise<{ from: string; where: string; joins: string }> {\n    const { contentClass, filter } = props;\n    if (!filter) {\n      // undefined filter means we don't want any filtering to be applied\n      return { from: contentClass.fullName, joins: \"\", where: \"\" };\n    }\n\n    const from = await specializeContentClass({\n      classHierarchyInspector: this._imodelAccess,\n      contentClassName: contentClass.fullName,\n      filterClassNames: filter.propertyClassNames,\n    });\n    if (!from) {\n      // filter class doesn't intersect with content class - make sure the query returns nothing by returning a `FALSE` WHERE clause\n      return { from: contentClass.fullName, joins: \"\", where: \"FALSE\" };\n    }\n\n    /**\n     * TODO:\n     * There may be similar related instance paths, e.g.:\n     * - A -> B -> C,\n     * - A -> B -> D.\n     * At this moment we're handling each path individually which means A and B would get joined twice. We could look into\n     * creating a join tree first, e.g.\n     *         C\n     *        /\n     * A -> B\n     *        \\\n     *         D\n     */\n    const joins = await Promise.all(\n      filter.relatedInstances.map(async (rel, i) =>\n        ECSql.createRelationshipPathJoinClause({\n          schemaProvider: this._imodelAccess,\n          path: assignRelationshipPathAliases(rel.path, i, contentClass.alias, rel.alias),\n        }),\n      ),\n    );\n\n    const whereConditions = new Array<string>();\n    if (filter.filteredClassNames && filter.filteredClassNames.length > 0) {\n      whereConditions.push(\n        `${ECSql.createRawPropertyValueSelector(contentClass.alias, \"ECClassId\")} IS (\n          ${filter.filteredClassNames\n            .map(parseFullClassName)\n            .map(({ schemaName, className }) => `[${schemaName}].[${className}]`)\n            .join(\", \")}\n        )`,\n      );\n    }\n    const classAliasMap = new Map<string, string>([[contentClass.alias, from]]);\n    filter.relatedInstances.forEach(({ path, alias }) => path.length > 0 && classAliasMap.set(alias, path[path.length - 1].targetClassName));\n    const propertiesFilter = await createWhereClause(\n      contentClass.alias,\n      async (alias) => {\n        const aliasClassName = classAliasMap.get(alias);\n        return aliasClassName ? getClass(this._imodelAccess, aliasClassName) : undefined;\n      },\n      filter.rules,\n    );\n    if (propertiesFilter) {\n      whereConditions.push(propertiesFilter);\n    }\n\n    return {\n      from,\n      joins: joins.join(\"\\n\"),\n      where: whereConditions.join(\" AND \"),\n    };\n  }\n}\n\nfunction createECSqlValueSelector(input: undefined | PrimitiveValue | ECSqlValueSelector) {\n  if (input === undefined) {\n    return \"NULL\";\n  }\n  if (isSelector(input)) {\n    return input.selector;\n  }\n  return ECSql.createRawPrimitiveValueSelector(input);\n}\n\nfunction isSelector(x: any): x is ECSqlValueSelector {\n  return !!x.selector;\n}\n\nfunction createGroupingSelector(grouping: ECSqlSelectClauseGroupingParams): string {\n  const groupingSelectors = new Array<{ key: string; selector: string }>();\n\n  grouping.byLabel &&\n    groupingSelectors.push({\n      key: \"byLabel\",\n      selector:\n        typeof grouping.byLabel === \"boolean\" || isSelector(grouping.byLabel)\n          ? createECSqlValueSelector(grouping.byLabel)\n          : serializeJsonObject(createLabelGroupingBaseParamsSelectors(grouping.byLabel)),\n    });\n\n  grouping.byClass &&\n    groupingSelectors.push({\n      key: \"byClass\",\n      selector:\n        typeof grouping.byClass === \"boolean\" || isSelector(grouping.byClass)\n          ? createECSqlValueSelector(grouping.byClass)\n          : serializeJsonObject(createBaseGroupingParamSelectors(grouping.byClass)),\n    });\n\n  grouping.byBaseClasses &&\n    groupingSelectors.push({\n      key: \"byBaseClasses\",\n      selector: serializeJsonObject([\n        {\n          key: \"fullClassNames\",\n          selector: `json_array(${grouping.byBaseClasses.fullClassNames.map((className) => createECSqlValueSelector(className)).join(\", \")})`,\n        },\n        ...createBaseGroupingParamSelectors(grouping.byBaseClasses),\n      ]),\n    });\n\n  grouping.byProperties &&\n    groupingSelectors.push({\n      key: \"byProperties\",\n      selector: serializeJsonObject([\n        {\n          key: \"propertiesClassName\",\n          selector: `${createECSqlValueSelector(grouping.byProperties.propertiesClassName)}`,\n        },\n        {\n          key: \"propertyGroups\",\n          selector: `json_array(${grouping.byProperties.propertyGroups\n            .map((propertyGroup) => serializeJsonObject(createPropertyGroupSelectors(propertyGroup)))\n            .join(\", \")})`,\n        },\n        ...(grouping.byProperties.createGroupForOutOfRangeValues !== undefined\n          ? [\n              {\n                key: \"createGroupForOutOfRangeValues\",\n                selector: `CAST(${createECSqlValueSelector(grouping.byProperties.createGroupForOutOfRangeValues)} AS BOOLEAN)`,\n              },\n            ]\n          : []),\n        ...(grouping.byProperties.createGroupForUnspecifiedValues !== undefined\n          ? [\n              {\n                key: \"createGroupForUnspecifiedValues\",\n                selector: `CAST(${createECSqlValueSelector(grouping.byProperties.createGroupForUnspecifiedValues)} AS BOOLEAN)`,\n              },\n            ]\n          : []),\n        ...createBaseGroupingParamSelectors(grouping.byProperties),\n      ]),\n    });\n\n  return serializeJsonObject(groupingSelectors);\n}\n\nfunction createLabelGroupingBaseParamsSelectors(byLabel: ECSqlSelectClauseLabelGroupingMergeParams | ECSqlSelectClauseLabelGroupingGroupParams) {\n  const selectors = new Array<{ key: string; selector: string }>();\n  if (byLabel.action !== undefined) {\n    selectors.push({\n      key: \"action\",\n      selector: `${createECSqlValueSelector(byLabel.action)}`,\n    });\n  }\n  if (byLabel.groupId !== undefined) {\n    selectors.push({\n      key: \"groupId\",\n      selector: createECSqlValueSelector(byLabel.groupId),\n    });\n  }\n  if (byLabel.action !== \"merge\") {\n    selectors.push(...createBaseGroupingParamSelectors(byLabel));\n  }\n\n  return selectors;\n}\n\nfunction createPropertyGroupSelectors(propertyGroup: ECSqlSelectClausePropertyGroup) {\n  const selectors = new Array<{ key: string; selector: string }>();\n  selectors.push(\n    {\n      key: \"propertyName\",\n      selector: `${createECSqlValueSelector(propertyGroup.propertyName)}`,\n    },\n    {\n      key: \"propertyValue\",\n      selector: `[${propertyGroup.propertyClassAlias}].[${propertyGroup.propertyName}]`,\n    },\n  );\n  if (propertyGroup.ranges) {\n    selectors.push(createRangeParamSelectors(propertyGroup.ranges));\n  }\n  return selectors;\n}\n\nfunction createRangeParamSelectors(ranges: ECSqlSelectClausePropertyValueRange[]) {\n  return {\n    key: \"ranges\",\n    selector: `json_array(${ranges\n      .map((range) =>\n        serializeJsonObject([\n          {\n            key: \"fromValue\",\n            selector: createECSqlValueSelector(range.fromValue),\n          },\n          {\n            key: \"toValue\",\n            selector: createECSqlValueSelector(range.toValue),\n          },\n          ...(range.rangeLabel\n            ? [\n                {\n                  key: \"rangeLabel\",\n                  selector: `${createECSqlValueSelector(range.rangeLabel)}`,\n                },\n              ]\n            : []),\n        ]),\n      )\n      .join(\", \")})`,\n  };\n}\n\nfunction createBaseGroupingParamSelectors(params: ECSqlSelectClauseGroupingParamsBase) {\n  const selectors = new Array<{ key: string; selector: string }>();\n  if (params.hideIfNoSiblings !== undefined) {\n    selectors.push({\n      key: \"hideIfNoSiblings\",\n      selector: createECSqlValueSelector(params.hideIfNoSiblings),\n    });\n  }\n  if (params.hideIfOneGroupedNode !== undefined) {\n    selectors.push({\n      key: \"hideIfOneGroupedNode\",\n      selector: createECSqlValueSelector(params.hideIfOneGroupedNode),\n    });\n  }\n  if (params.autoExpand !== undefined) {\n    selectors.push({\n      key: \"autoExpand\",\n      selector: createECSqlValueSelector(params.autoExpand),\n    });\n  }\n  return selectors;\n}\n\nfunction serializeJsonObject(selectors: Array<{ key: string; selector: string }>): string {\n  return `json_object(${selectors.map(({ key, selector }) => `'${key}', ${selector}`).join(\", \")})`;\n}\n\nasync function createWhereClause(\n  contentClassAlias: string,\n  classLoader: (alias: string) => Promise<EC.Class | undefined>,\n  rule: GenericInstanceFilterRule | GenericInstanceFilterRuleGroup,\n): Promise<string | undefined> {\n  if (GenericInstanceFilter.isFilterRuleGroup(rule)) {\n    const clause = (await Promise.all(rule.rules.map(async (r) => createWhereClause(contentClassAlias, classLoader, r))))\n      .filter((c) => !!c)\n      .join(` ${getECSqlLogicalOperator(rule.operator)} `);\n    return clause ? (rule.operator === \"or\" ? `(${clause})` : clause) : undefined;\n  }\n  const sourceAlias = rule.sourceAlias ? rule.sourceAlias : contentClassAlias;\n  const propertyValueSelector = ECSql.createRawPropertyValueSelector(sourceAlias, rule.propertyName);\n  if (isUnaryRuleOperator(rule.operator)) {\n    switch (rule.operator) {\n      case \"is-true\":\n        return propertyValueSelector;\n      case \"is-false\":\n        return `NOT ${propertyValueSelector}`;\n      case \"is-null\":\n        return `${propertyValueSelector} IS NULL`;\n      case \"is-not-null\":\n        return `${propertyValueSelector} IS NOT NULL`;\n    }\n  }\n  const ecsqlOperator = getECSqlComparisonOperator(rule.operator);\n  if (rule.value === undefined) {\n    throw new Error(`Rule \"${rule.propertyName}\" ${ecsqlOperator} is missing value.`);\n  }\n\n  const value = rule.value.rawValue;\n\n  if (rule.operator === \"like\" && typeof value === \"string\") {\n    return `${propertyValueSelector} ${ecsqlOperator} '${value}' ESCAPE '\\\\'`;\n  }\n  const propertyClass = await classLoader(sourceAlias);\n  if (!propertyClass) {\n    throw new Error(`Class with alias \"${sourceAlias}\" not found.`);\n  }\n  const property = await propertyClass.getProperty(rule.propertyName);\n  if (!property) {\n    throw new Error(`Property \"${rule.propertyName}\" not found in ECClass \"${propertyClass.fullName}\".`);\n  }\n  if (property.isNavigation()) {\n    assert(rule.value !== undefined && GenericInstanceFilterRuleValue.isInstanceKey(value));\n    return `${propertyValueSelector}.[Id] ${ecsqlOperator} ${ECSql.createRawPrimitiveValueSelector(value.id)}`;\n  }\n  if (property.isEnumeration()) {\n    assert(rule.value !== undefined && !GenericInstanceFilterRuleValue.isInstanceKey(value));\n    return `${propertyValueSelector} ${ecsqlOperator} ${ECSql.createRawPrimitiveValueSelector(value)}`;\n  }\n  if (property.isPrimitive()) {\n    assert(rule.value !== undefined && !GenericInstanceFilterRuleValue.isInstanceKey(value));\n    switch (property.primitiveType) {\n      case \"Point2d\": {\n        assert(rule.operator === \"is-equal\" || rule.operator === \"is-not-equal\");\n        assert(PrimitiveValue.isPoint2d(value));\n        const condition = `\n          ${createFloatingPointEqualityClause(`${propertyValueSelector}.[x]`, \"is-equal\", value.x)}\n          AND ${createFloatingPointEqualityClause(`${propertyValueSelector}.[y]`, \"is-equal\", value.y)}\n        `;\n        return rule.operator === \"is-equal\" ? condition : `NOT (${condition})`;\n      }\n      case \"Point3d\": {\n        assert(rule.operator === \"is-equal\" || rule.operator === \"is-not-equal\");\n        assert(PrimitiveValue.isPoint3d(value));\n        const condition = `\n          ${createFloatingPointEqualityClause(`${propertyValueSelector}.[x]`, \"is-equal\", value.x)}\n          AND ${createFloatingPointEqualityClause(`${propertyValueSelector}.[y]`, \"is-equal\", value.y)}\n          AND ${createFloatingPointEqualityClause(`${propertyValueSelector}.[z]`, \"is-equal\", value.z)}\n        `;\n        return rule.operator === \"is-equal\" ? condition : `NOT (${condition})`;\n      }\n      case \"Double\": {\n        assert(typeof value === \"number\");\n        if (rule.operator === \"is-equal\" || rule.operator === \"is-not-equal\") {\n          return `${createFloatingPointEqualityClause(propertyValueSelector, rule.operator, value)}`;\n        }\n        return `${propertyValueSelector} ${ecsqlOperator} ${ECSql.createRawPrimitiveValueSelector(value)}`;\n      }\n      default: {\n        return `${propertyValueSelector} ${ecsqlOperator} ${ECSql.createRawPrimitiveValueSelector(value)}`;\n      }\n    }\n  }\n  throw new Error(\"Struct and array properties are not supported for filtering\");\n}\n\nfunction createFloatingPointEqualityClause(valueSelector: string, operator: \"is-equal\" | \"is-not-equal\", value: number) {\n  const [from, to] = getFloatingPointValueRange(value);\n  return `${valueSelector} ${operator === \"is-not-equal\" ? \"NOT \" : \"\"} BETWEEN ${from} AND ${to}`;\n}\n\nfunction getFloatingPointValueRange(value: number): [number, number] {\n  return [value - Number.EPSILON, value + Number.EPSILON];\n}\n\nfunction getECSqlLogicalOperator(op: GenericInstanceFilterRuleGroupOperator) {\n  switch (op) {\n    case \"and\":\n      return \"AND\";\n    case \"or\":\n      return \"OR\";\n  }\n}\n\nfunction isUnaryRuleOperator(\n  op: GenericInstanceFilterRuleOperator,\n): op is Extract<GenericInstanceFilterRuleOperator, \"is-true\" | \"is-false\" | \"is-null\" | \"is-not-null\"> {\n  return op === \"is-true\" || op === \"is-false\" || op === \"is-null\" || op === \"is-not-null\";\n}\n\nfunction getECSqlComparisonOperator(op: Exclude<GenericInstanceFilterRuleOperator, \"is-true\" | \"is-false\" | \"is-null\" | \"is-not-null\">) {\n  switch (op) {\n    case \"is-equal\":\n      return `=`;\n    case \"is-not-equal\":\n      return `<>`;\n    case \"greater\":\n      return `>`;\n    case \"greater-or-equal\":\n      return `>=`;\n    case \"less\":\n      return `<`;\n    case \"less-or-equal\":\n      return `<=`;\n    case \"like\":\n      return `LIKE`;\n  }\n}\n\ntype JoinRelationshipPath = Parameters<typeof ECSql.createRelationshipPathJoinClause>[0][\"path\"];\nfunction assignRelationshipPathAliases(\n  path: GenericInstanceFilterRelationshipStep[],\n  pathIndex: number,\n  sourceAlias: string,\n  targetAlias: string,\n): JoinRelationshipPath {\n  function createAlias(fullClassName: string, index: number) {\n    return `rel_${pathIndex}_${fullClassName.replaceAll(/[\\.:]/g, \"_\")}_${index}`;\n  }\n  const result: JoinRelationshipPath = [];\n  path.forEach((step, i) => {\n    result.push({\n      targetClassName: step.targetClassName,\n      relationshipName: step.relationshipClassName,\n      sourceClassName: step.sourceClassName,\n      relationshipReverse: !step.isForwardRelationship,\n      sourceAlias: i === 0 ? sourceAlias : result[i - 1].targetAlias,\n      relationshipAlias: createAlias(step.relationshipClassName, i),\n      targetAlias: i === path.length - 1 ? targetAlias : createAlias(step.targetClassName, i),\n      joinType: \"inner\",\n    });\n  });\n  return result;\n}\n\ninterface SpecializeContentClassProps {\n  classHierarchyInspector: ECClassHierarchyInspector;\n  contentClassName: string;\n  filterClassNames: string[];\n}\nasync function specializeContentClass(props: SpecializeContentClassProps): Promise<string | undefined> {\n  const filterClass = await getSpecializedPropertyClass(props.classHierarchyInspector, props.filterClassNames);\n  if (!filterClass) {\n    return props.contentClassName;\n  }\n  if (await props.classHierarchyInspector.classDerivesFrom(filterClass, props.contentClassName)) {\n    return filterClass;\n  }\n  if (await props.classHierarchyInspector.classDerivesFrom(props.contentClassName, filterClass)) {\n    return props.contentClassName;\n  }\n  return undefined;\n}\n\nasync function getSpecializedPropertyClass(classHierarchyInspector: ECClassHierarchyInspector, classes: string[]): Promise<string | undefined> {\n  if (classes.length === 0) {\n    return undefined;\n  }\n  const [currClassName, ...restClasses] = classes;\n  let resolvedClassName = currClassName;\n  for (const propClassName of restClasses) {\n    if (await classHierarchyInspector.classDerivesFrom(propClassName, resolvedClassName)) {\n      resolvedClassName = propClassName;\n    }\n  }\n  return resolvedClassName;\n}\n"]}
+{"version":3,"file":"NodeSelectQueryFactory.js","sourceRoot":"","sources":["../../../src/hierarchies/NodeSelectQueryFactory.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n\nimport { assert, Id64String } from \"@itwin/core-bentley\";\nimport {\n  GenericInstanceFilter,\n  GenericInstanceFilterRelationshipStep,\n  GenericInstanceFilterRule,\n  GenericInstanceFilterRuleGroup,\n  GenericInstanceFilterRuleGroupOperator,\n  GenericInstanceFilterRuleOperator,\n  GenericInstanceFilterRuleValue,\n} from \"@itwin/core-common\";\nimport { EC, ECClassHierarchyInspector, ECSchemaProvider, ECSql, getClass, parseFullClassName, PrimitiveValue } from \"@itwin/presentation-shared\";\n\n/**\n * Column names of the SELECT clause created by `NodeSelectClauseFactory`. Order of the names matches the order of columns\n * created by the factory.\n *\n * @beta\n */\nexport enum NodeSelectClauseColumnNames {\n  /** Full class name of the instance the node represents. Type: `string` in format `{schema name}:{class name}`. */\n  FullClassName = \"FullClassName\",\n  /** ECInstance ID of the instance the node represents. Type: `Id64String`. */\n  ECInstanceId = \"ECInstanceId\",\n  /** Display label. Type: `string`. */\n  DisplayLabel = \"DisplayLabel\",\n  /**\n   * A flag indicating if the node has children. Type: `boolean`. Values:\n   * - `false` - node never has children.\n   * - `true` - node always has children.\n   * - NULL - unknown, needs to be determined by requesting children for the node.\n   */\n  HasChildren = \"HasChildren\",\n  /** A flag indicating that a node should be hidden if it has no children. Type: `boolean`. */\n  HideIfNoChildren = \"HideIfNoChildren\",\n  /** A flag indicating that a node should be hidden and its children should be displayed instead. Type: `boolean`. */\n  HideNodeInHierarchy = \"HideNodeInHierarchy\",\n  /** A serialized JSON object for providing grouping information. */\n  Grouping = \"Grouping\",\n  /** A serialized JSON object for associating a node with additional data. */\n  ExtendedData = \"ExtendedData\",\n  /** A flag indicating the node should be auto-expanded when it's loaded. */\n  AutoExpand = \"AutoExpand\",\n  /** A flag indicating the node supports child hierarchy level filtering. */\n  SupportsFiltering = \"SupportsFiltering\",\n}\n\n/**\n * A data structure for defining an ECSQL value selector.\n */\ninterface ECSqlValueSelector {\n  selector: string;\n}\n\n/**\n * Props for `NodeSelectClauseFactory.createSelectClause`.\n */\ninterface NodeSelectClauseProps {\n  ecClassId: Id64String | ECSqlValueSelector;\n  ecInstanceId: Id64String | ECSqlValueSelector;\n  nodeLabel: string | ECSqlValueSelector;\n  extendedData?: {\n    [key: string]: Id64String | string | number | boolean | ECSqlValueSelector;\n  };\n  autoExpand?: boolean | ECSqlValueSelector;\n  supportsFiltering?: boolean | ECSqlValueSelector;\n  hasChildren?: boolean | ECSqlValueSelector;\n  hideNodeInHierarchy?: boolean | ECSqlValueSelector;\n  hideIfNoChildren?: boolean | ECSqlValueSelector;\n  grouping?: ECSqlSelectClauseGroupingParams;\n}\n\n/**\n * A data structure for defining nodes' grouping requirements.\n */\ninterface ECSqlSelectClauseGroupingParams {\n  byLabel?: ECSqlSelectClauseLabelGroupingParams;\n  byClass?: boolean | ECSqlSelectClauseGroupingParamsBase | ECSqlValueSelector;\n  byBaseClasses?: ECSqlSelectClauseBaseClassGroupingParams;\n  byProperties?: ECSqlSelectClausePropertiesGroupingParams;\n}\n\n/**\n * A data structure for defining label grouping params.\n */\ninterface ECSqlSelectClauseLabelGroupingBaseParams {\n  /** Label grouping option that determines whether to group nodes or to merge them. Defaults to \"group\".*/\n  action?: \"group\" | \"merge\";\n  /** Id that needs to match for nodes to be grouped or merged.*/\n  groupId?: string | ECSqlValueSelector;\n}\n\n/**\n * A data structure for defining label merging.\n */\ninterface ECSqlSelectClauseLabelGroupingMergeParams extends ECSqlSelectClauseLabelGroupingBaseParams {\n  action: \"merge\";\n}\n\n/**\n * A data structure for defining label grouping.\n */\ninterface ECSqlSelectClauseLabelGroupingGroupParams extends ECSqlSelectClauseLabelGroupingBaseParams, ECSqlSelectClauseGroupingParamsBase {\n  action?: \"group\";\n}\n\n/**\n * A data structure for defining possible label grouping types.\n */\ntype ECSqlSelectClauseLabelGroupingParams =\n  | boolean\n  | ECSqlValueSelector\n  | ECSqlSelectClauseLabelGroupingMergeParams\n  | ECSqlSelectClauseLabelGroupingGroupParams;\n\n/**\n * A data structure for defining base grouping parameters shared across all types of grouping.\n */\ninterface ECSqlSelectClauseGroupingParamsBase {\n  hideIfNoSiblings?: boolean | ECSqlValueSelector;\n  hideIfOneGroupedNode?: boolean | ECSqlValueSelector;\n  autoExpand?: string | ECSqlValueSelector;\n}\n\n/**\n * A data structure for defining properties grouping.\n */\ninterface ECSqlSelectClausePropertiesGroupingParams extends ECSqlSelectClauseGroupingParamsBase {\n  /**\n   * Full name of a class whose properties are used to group the node. Only has effect if the node\n   * represents an instance of that class.\n   *\n   * Full class name format: `SchemaName.ClassName`.\n   */\n  propertiesClassName: string;\n  /**\n   * Property grouping option that determines whether to group nodes whose grouping value is not set or is set to an empty string.\n   *\n   * Label of the created grouping node will be `Not Specified`.\n   */\n  createGroupForUnspecifiedValues?: boolean | ECSqlValueSelector;\n  /**\n   * Property grouping option that determines whether to group nodes whose grouping value doesn't fit within any of the provided\n   * ranges, or is not a numeric value.\n   *\n   * Label of the created grouping node will be `Other`.\n   */\n  createGroupForOutOfRangeValues?: boolean | ECSqlValueSelector;\n  /**\n   * Properties of the specified class, by which the nodes should be grouped.\n   *\n   * Example usage:\n   * ```ts\n   * propertyGroups: [\n   *   {\n   *     propertyName: \"type\",\n   *     propertyClassAlias: \"this\"\n   *   },\n   *   {\n   *     propertyName: \"length\",\n   *     propertyClassAlias: \"x\",\n   *     ranges: [\n   *       { fromValue: 1, toValue: 10, rangeLabel: \"Small\" },\n   *       { fromValue: 11, toValue: 20, rangeLabel: \"Medium\" }\n   *     ]\n   *   },\n   * ]\n   * ```\n   */\n  propertyGroups: ECSqlSelectClausePropertyGroup[];\n}\n\n/**\n * A data structure for defining specific properties' grouping params.\n */\ninterface ECSqlSelectClausePropertyGroup {\n  /** A string indicating the name of the property to group by. */\n  propertyName: string;\n  /** Alias to of the class containing the property. Used to select the property value. */\n  propertyClassAlias: string;\n  /** Ranges are used to group nodes by numeric properties which are within specified bounds. */\n  ranges?: ECSqlSelectClausePropertyValueRange[];\n}\n\n/**\n * A data structure for defining boundaries for a value.\n */\ninterface ECSqlSelectClausePropertyValueRange {\n  /** Defines the lower bound of the range. */\n  fromValue: number | ECSqlValueSelector;\n  /** Defines the upper bound of the range. */\n  toValue: number | ECSqlValueSelector;\n  /** Defines the range label. Will be used as grouping node's display label. */\n  rangeLabel?: string | ECSqlValueSelector;\n}\n\n/**\n * A data structure for defining base class grouping.\n */\ninterface ECSqlSelectClauseBaseClassGroupingParams extends ECSqlSelectClauseGroupingParamsBase {\n  fullClassNames: string[] | ECSqlValueSelector[];\n}\n\n/**\n * An interface of a factory that knows how to create nodes' select ECSQL query.\n * @beta\n */\nexport interface NodesQueryClauseFactory {\n  /** Create a SELECT clause in a format understood by nodes query parser used by `HierarchyProvider`. */\n  createSelectClause(props: NodeSelectClauseProps): Promise<string>;\n\n  /** Create FROM, JOIN and WHERE clauses whose combination results in an ECSQL filter defined by given `GenericInstanceFilter`. */\n  createFilterClauses(props: {\n    contentClass: { fullName: string; alias: string };\n    filter: GenericInstanceFilter | undefined;\n  }): Promise<{ from: string; where: string; joins: string }>;\n}\n\n/**\n * Creates an instance of `NodeSelectQueryFactory` that .\n * @beta\n */\nexport function createNodesQueryClauseFactory(props: { imodelAccess: ECSchemaProvider & ECClassHierarchyInspector }): NodesQueryClauseFactory {\n  return new NodeSelectQueryFactory(props);\n}\n\n/** A factory for creating a nodes' select ECSQL query. */\nclass NodeSelectQueryFactory {\n  private _imodelAccess: ECSchemaProvider & ECClassHierarchyInspector;\n\n  public constructor(props: { imodelAccess: ECSchemaProvider & ECClassHierarchyInspector }) {\n    this._imodelAccess = props.imodelAccess;\n  }\n\n  /** Create a SELECT clause in a format understood by results reader of the library. */\n  public async createSelectClause(props: NodeSelectClauseProps) {\n    // note: the columns order must match the order in `NodeSelectClauseColumnNames`\n    return `\n      ec_ClassName(${createECSqlValueSelector(props.ecClassId)}) AS ${NodeSelectClauseColumnNames.FullClassName},\n      ${createECSqlValueSelector(props.ecInstanceId)} AS ${NodeSelectClauseColumnNames.ECInstanceId},\n      ${createECSqlValueSelector(props.nodeLabel)} AS ${NodeSelectClauseColumnNames.DisplayLabel},\n      CAST(${createECSqlValueSelector(props.hasChildren)} AS BOOLEAN) AS ${NodeSelectClauseColumnNames.HasChildren},\n      CAST(${createECSqlValueSelector(props.hideIfNoChildren)} AS BOOLEAN) AS ${NodeSelectClauseColumnNames.HideIfNoChildren},\n      CAST(${createECSqlValueSelector(props.hideNodeInHierarchy)} AS BOOLEAN) AS ${NodeSelectClauseColumnNames.HideNodeInHierarchy},\n      ${props.grouping ? createGroupingSelector(props.grouping) : \"CAST(NULL AS TEXT)\"} AS ${NodeSelectClauseColumnNames.Grouping},\n      ${\n        props.extendedData\n          ? `json_object(${Object.entries(props.extendedData)\n              .map(([key, value]) => `'${key}', ${createECSqlValueSelector(value)}`)\n              .join(\", \")})`\n          : \"CAST(NULL AS TEXT)\"\n      } AS ${NodeSelectClauseColumnNames.ExtendedData},\n      CAST(${createECSqlValueSelector(props.autoExpand)} AS BOOLEAN) AS ${NodeSelectClauseColumnNames.AutoExpand},\n      CAST(${createECSqlValueSelector(props.supportsFiltering)} AS BOOLEAN) AS ${NodeSelectClauseColumnNames.SupportsFiltering}\n    `;\n  }\n\n  /**\n   * Creates the necessary ECSQL snippets to create an instance filter described by the `def` argument.\n   * - `from` is set to either the `contentClass.fullName` or `def.propertyClassName`, depending on which is more specific.\n   * - `joins` is set to a number of `JOIN` clauses required to join all relationships described by `def.relatedInstances`.\n   * - `where` is set to a `WHERE` clause (without the `WHERE` keyword) that filters instances by classes on\n   * `def.filterClassNames` and by properties as described by `def.rules`.\n   *\n   * Special cases:\n   * - If `def` is `undefined`, `joins` and `where` are set to empty strings and `from` is set to `contentClass.fullName`.\n   * - If the provided content class doesn't intersect with the property class in provided filter, a special result\n   * is returned to make sure the resulting query is valid and doesn't return anything.\n   */\n  public async createFilterClauses(props: {\n    contentClass: { fullName: string; alias: string };\n    filter: GenericInstanceFilter | undefined;\n  }): Promise<{ from: string; where: string; joins: string }> {\n    const { contentClass, filter } = props;\n    if (!filter) {\n      // undefined filter means we don't want any filtering to be applied\n      return { from: contentClass.fullName, joins: \"\", where: \"\" };\n    }\n\n    const from = await specializeContentClass({\n      classHierarchyInspector: this._imodelAccess,\n      contentClassName: contentClass.fullName,\n      filterClassNames: filter.propertyClassNames,\n    });\n    if (!from) {\n      // filter class doesn't intersect with content class - make sure the query returns nothing by returning a `FALSE` WHERE clause\n      return { from: contentClass.fullName, joins: \"\", where: \"FALSE\" };\n    }\n\n    /**\n     * TODO:\n     * There may be similar related instance paths, e.g.:\n     * - A -> B -> C,\n     * - A -> B -> D.\n     * At this moment we're handling each path individually which means A and B would get joined twice. We could look into\n     * creating a join tree first, e.g.\n     *         C\n     *        /\n     * A -> B\n     *        \\\n     *         D\n     */\n    const joins = await Promise.all(\n      filter.relatedInstances.map(async (rel, i) =>\n        ECSql.createRelationshipPathJoinClause({\n          schemaProvider: this._imodelAccess,\n          path: assignRelationshipPathAliases(rel.path, i, contentClass.alias, rel.alias),\n        }),\n      ),\n    );\n\n    const whereConditions = new Array<string>();\n    if (filter.filteredClassNames && filter.filteredClassNames.length > 0) {\n      whereConditions.push(\n        `${ECSql.createRawPropertyValueSelector(contentClass.alias, \"ECClassId\")} IS (\n          ${filter.filteredClassNames\n            .map(parseFullClassName)\n            .map(({ schemaName, className }) => `[${schemaName}].[${className}]`)\n            .join(\", \")}\n        )`,\n      );\n    }\n    const classAliasMap = new Map<string, string>([[contentClass.alias, from]]);\n    filter.relatedInstances.forEach(({ path, alias }) => path.length > 0 && classAliasMap.set(alias, path[path.length - 1].targetClassName));\n    const propertiesFilter = await createWhereClause(\n      contentClass.alias,\n      async (alias) => {\n        const aliasClassName = classAliasMap.get(alias);\n        return aliasClassName ? getClass(this._imodelAccess, aliasClassName) : undefined;\n      },\n      filter.rules,\n    );\n    if (propertiesFilter) {\n      whereConditions.push(propertiesFilter);\n    }\n\n    return {\n      from,\n      joins: joins.join(\"\\n\"),\n      where: whereConditions.join(\" AND \"),\n    };\n  }\n}\n\nfunction createECSqlValueSelector(input: undefined | PrimitiveValue | ECSqlValueSelector) {\n  if (input === undefined) {\n    return \"NULL\";\n  }\n  if (isSelector(input)) {\n    return input.selector;\n  }\n  return ECSql.createRawPrimitiveValueSelector(input);\n}\n\nfunction isSelector(x: any): x is ECSqlValueSelector {\n  return !!x.selector;\n}\n\nfunction createGroupingSelector(grouping: ECSqlSelectClauseGroupingParams): string {\n  const groupingSelectors = new Array<{ key: string; selector: string }>();\n\n  grouping.byLabel &&\n    groupingSelectors.push({\n      key: \"byLabel\",\n      selector:\n        typeof grouping.byLabel === \"boolean\" || isSelector(grouping.byLabel)\n          ? createECSqlValueSelector(grouping.byLabel)\n          : serializeJsonObject(createLabelGroupingBaseParamsSelectors(grouping.byLabel)),\n    });\n\n  grouping.byClass &&\n    groupingSelectors.push({\n      key: \"byClass\",\n      selector:\n        typeof grouping.byClass === \"boolean\" || isSelector(grouping.byClass)\n          ? createECSqlValueSelector(grouping.byClass)\n          : serializeJsonObject(createBaseGroupingParamSelectors(grouping.byClass)),\n    });\n\n  grouping.byBaseClasses &&\n    groupingSelectors.push({\n      key: \"byBaseClasses\",\n      selector: serializeJsonObject([\n        {\n          key: \"fullClassNames\",\n          selector: `json_array(${grouping.byBaseClasses.fullClassNames.map((className) => createECSqlValueSelector(className)).join(\", \")})`,\n        },\n        ...createBaseGroupingParamSelectors(grouping.byBaseClasses),\n      ]),\n    });\n\n  grouping.byProperties &&\n    groupingSelectors.push({\n      key: \"byProperties\",\n      selector: serializeJsonObject([\n        {\n          key: \"propertiesClassName\",\n          selector: `${createECSqlValueSelector(grouping.byProperties.propertiesClassName)}`,\n        },\n        {\n          key: \"propertyGroups\",\n          selector: `json_array(${grouping.byProperties.propertyGroups\n            .map((propertyGroup) => serializeJsonObject(createPropertyGroupSelectors(propertyGroup)))\n            .join(\", \")})`,\n        },\n        ...(grouping.byProperties.createGroupForOutOfRangeValues !== undefined\n          ? [\n              {\n                key: \"createGroupForOutOfRangeValues\",\n                selector: `CAST(${createECSqlValueSelector(grouping.byProperties.createGroupForOutOfRangeValues)} AS BOOLEAN)`,\n              },\n            ]\n          : []),\n        ...(grouping.byProperties.createGroupForUnspecifiedValues !== undefined\n          ? [\n              {\n                key: \"createGroupForUnspecifiedValues\",\n                selector: `CAST(${createECSqlValueSelector(grouping.byProperties.createGroupForUnspecifiedValues)} AS BOOLEAN)`,\n              },\n            ]\n          : []),\n        ...createBaseGroupingParamSelectors(grouping.byProperties),\n      ]),\n    });\n\n  return serializeJsonObject(groupingSelectors);\n}\n\nfunction createLabelGroupingBaseParamsSelectors(byLabel: ECSqlSelectClauseLabelGroupingMergeParams | ECSqlSelectClauseLabelGroupingGroupParams) {\n  const selectors = new Array<{ key: string; selector: string }>();\n  if (byLabel.action !== undefined) {\n    selectors.push({\n      key: \"action\",\n      selector: `${createECSqlValueSelector(byLabel.action)}`,\n    });\n  }\n  if (byLabel.groupId !== undefined) {\n    selectors.push({\n      key: \"groupId\",\n      selector: createECSqlValueSelector(byLabel.groupId),\n    });\n  }\n  if (byLabel.action !== \"merge\") {\n    selectors.push(...createBaseGroupingParamSelectors(byLabel));\n  }\n\n  return selectors;\n}\n\nfunction createPropertyGroupSelectors(propertyGroup: ECSqlSelectClausePropertyGroup) {\n  const selectors = new Array<{ key: string; selector: string }>();\n  selectors.push(\n    {\n      key: \"propertyName\",\n      selector: `${createECSqlValueSelector(propertyGroup.propertyName)}`,\n    },\n    {\n      key: \"propertyValue\",\n      selector: `[${propertyGroup.propertyClassAlias}].[${propertyGroup.propertyName}]`,\n    },\n  );\n  if (propertyGroup.ranges) {\n    selectors.push(createRangeParamSelectors(propertyGroup.ranges));\n  }\n  return selectors;\n}\n\nfunction createRangeParamSelectors(ranges: ECSqlSelectClausePropertyValueRange[]) {\n  return {\n    key: \"ranges\",\n    selector: `json_array(${ranges\n      .map((range) =>\n        serializeJsonObject([\n          {\n            key: \"fromValue\",\n            selector: createECSqlValueSelector(range.fromValue),\n          },\n          {\n            key: \"toValue\",\n            selector: createECSqlValueSelector(range.toValue),\n          },\n          ...(range.rangeLabel\n            ? [\n                {\n                  key: \"rangeLabel\",\n                  selector: `${createECSqlValueSelector(range.rangeLabel)}`,\n                },\n              ]\n            : []),\n        ]),\n      )\n      .join(\", \")})`,\n  };\n}\n\nfunction createBaseGroupingParamSelectors(params: ECSqlSelectClauseGroupingParamsBase) {\n  const selectors = new Array<{ key: string; selector: string }>();\n  if (params.hideIfNoSiblings !== undefined) {\n    selectors.push({\n      key: \"hideIfNoSiblings\",\n      selector: createECSqlValueSelector(params.hideIfNoSiblings),\n    });\n  }\n  if (params.hideIfOneGroupedNode !== undefined) {\n    selectors.push({\n      key: \"hideIfOneGroupedNode\",\n      selector: createECSqlValueSelector(params.hideIfOneGroupedNode),\n    });\n  }\n  if (params.autoExpand !== undefined) {\n    selectors.push({\n      key: \"autoExpand\",\n      selector: createECSqlValueSelector(params.autoExpand),\n    });\n  }\n  return selectors;\n}\n\nfunction serializeJsonObject(selectors: Array<{ key: string; selector: string }>): string {\n  return `json_object(${selectors.map(({ key, selector }) => `'${key}', ${selector}`).join(\", \")})`;\n}\n\nasync function createWhereClause(\n  contentClassAlias: string,\n  classLoader: (alias: string) => Promise<EC.Class | undefined>,\n  rule: GenericInstanceFilterRule | GenericInstanceFilterRuleGroup,\n): Promise<string | undefined> {\n  if (GenericInstanceFilter.isFilterRuleGroup(rule)) {\n    const clause = (await Promise.all(rule.rules.map(async (r) => createWhereClause(contentClassAlias, classLoader, r))))\n      .filter((c) => !!c)\n      .join(` ${getECSqlLogicalOperator(rule.operator)} `);\n    return clause ? (rule.operator === \"or\" ? `(${clause})` : clause) : undefined;\n  }\n  const sourceAlias = rule.sourceAlias ? rule.sourceAlias : contentClassAlias;\n  const propertyValueSelector = ECSql.createRawPropertyValueSelector(sourceAlias, rule.propertyName);\n  if (isUnaryRuleOperator(rule.operator)) {\n    switch (rule.operator) {\n      case \"is-true\":\n        return propertyValueSelector;\n      case \"is-false\":\n        return `NOT ${propertyValueSelector}`;\n      case \"is-null\":\n        return `${propertyValueSelector} IS NULL`;\n      case \"is-not-null\":\n        return `${propertyValueSelector} IS NOT NULL`;\n    }\n  }\n  const ecsqlOperator = getECSqlComparisonOperator(rule.operator);\n  if (rule.value === undefined) {\n    throw new Error(`Rule \"${rule.propertyName}\" ${ecsqlOperator} is missing value.`);\n  }\n\n  const value = rule.value.rawValue;\n\n  if (rule.operator === \"like\" && typeof value === \"string\") {\n    const escapedValue = value.replace(/[%_\\\\]/g, \"\\\\$&\");\n    return `${propertyValueSelector} ${ecsqlOperator} '%${escapedValue}%' ESCAPE '\\\\'`;\n  }\n  const propertyClass = await classLoader(sourceAlias);\n  if (!propertyClass) {\n    throw new Error(`Class with alias \"${sourceAlias}\" not found.`);\n  }\n  const property = await propertyClass.getProperty(rule.propertyName);\n  if (!property) {\n    throw new Error(`Property \"${rule.propertyName}\" not found in ECClass \"${propertyClass.fullName}\".`);\n  }\n  if (property.isNavigation()) {\n    assert(rule.value !== undefined && GenericInstanceFilterRuleValue.isInstanceKey(value));\n    return `${propertyValueSelector}.[Id] ${ecsqlOperator} ${ECSql.createRawPrimitiveValueSelector(value.id)}`;\n  }\n  if (property.isEnumeration()) {\n    assert(rule.value !== undefined && !GenericInstanceFilterRuleValue.isInstanceKey(value));\n    return `${propertyValueSelector} ${ecsqlOperator} ${ECSql.createRawPrimitiveValueSelector(value)}`;\n  }\n  if (property.isPrimitive()) {\n    assert(rule.value !== undefined && !GenericInstanceFilterRuleValue.isInstanceKey(value));\n    switch (property.primitiveType) {\n      case \"Point2d\": {\n        assert(rule.operator === \"is-equal\" || rule.operator === \"is-not-equal\");\n        assert(PrimitiveValue.isPoint2d(value));\n        const condition = `\n          ${createFloatingPointEqualityClause(`${propertyValueSelector}.[x]`, \"is-equal\", value.x)}\n          AND ${createFloatingPointEqualityClause(`${propertyValueSelector}.[y]`, \"is-equal\", value.y)}\n        `;\n        return rule.operator === \"is-equal\" ? condition : `NOT (${condition})`;\n      }\n      case \"Point3d\": {\n        assert(rule.operator === \"is-equal\" || rule.operator === \"is-not-equal\");\n        assert(PrimitiveValue.isPoint3d(value));\n        const condition = `\n          ${createFloatingPointEqualityClause(`${propertyValueSelector}.[x]`, \"is-equal\", value.x)}\n          AND ${createFloatingPointEqualityClause(`${propertyValueSelector}.[y]`, \"is-equal\", value.y)}\n          AND ${createFloatingPointEqualityClause(`${propertyValueSelector}.[z]`, \"is-equal\", value.z)}\n        `;\n        return rule.operator === \"is-equal\" ? condition : `NOT (${condition})`;\n      }\n      case \"Double\": {\n        assert(typeof value === \"number\");\n        if (rule.operator === \"is-equal\" || rule.operator === \"is-not-equal\") {\n          return `${createFloatingPointEqualityClause(propertyValueSelector, rule.operator, value)}`;\n        }\n        return `${propertyValueSelector} ${ecsqlOperator} ${ECSql.createRawPrimitiveValueSelector(value)}`;\n      }\n      default: {\n        return `${propertyValueSelector} ${ecsqlOperator} ${ECSql.createRawPrimitiveValueSelector(value)}`;\n      }\n    }\n  }\n  throw new Error(\"Struct and array properties are not supported for filtering\");\n}\n\nfunction createFloatingPointEqualityClause(valueSelector: string, operator: \"is-equal\" | \"is-not-equal\", value: number) {\n  const [from, to] = getFloatingPointValueRange(value);\n  return `${valueSelector} ${operator === \"is-not-equal\" ? \"NOT \" : \"\"} BETWEEN ${from} AND ${to}`;\n}\n\nfunction getFloatingPointValueRange(value: number): [number, number] {\n  return [value - Number.EPSILON, value + Number.EPSILON];\n}\n\nfunction getECSqlLogicalOperator(op: GenericInstanceFilterRuleGroupOperator) {\n  switch (op) {\n    case \"and\":\n      return \"AND\";\n    case \"or\":\n      return \"OR\";\n  }\n}\n\nfunction isUnaryRuleOperator(\n  op: GenericInstanceFilterRuleOperator,\n): op is Extract<GenericInstanceFilterRuleOperator, \"is-true\" | \"is-false\" | \"is-null\" | \"is-not-null\"> {\n  return op === \"is-true\" || op === \"is-false\" || op === \"is-null\" || op === \"is-not-null\";\n}\n\nfunction getECSqlComparisonOperator(op: Exclude<GenericInstanceFilterRuleOperator, \"is-true\" | \"is-false\" | \"is-null\" | \"is-not-null\">) {\n  switch (op) {\n    case \"is-equal\":\n      return `=`;\n    case \"is-not-equal\":\n      return `<>`;\n    case \"greater\":\n      return `>`;\n    case \"greater-or-equal\":\n      return `>=`;\n    case \"less\":\n      return `<`;\n    case \"less-or-equal\":\n      return `<=`;\n    case \"like\":\n      return `LIKE`;\n  }\n}\n\ntype JoinRelationshipPath = Parameters<typeof ECSql.createRelationshipPathJoinClause>[0][\"path\"];\nfunction assignRelationshipPathAliases(\n  path: GenericInstanceFilterRelationshipStep[],\n  pathIndex: number,\n  sourceAlias: string,\n  targetAlias: string,\n): JoinRelationshipPath {\n  function createAlias(fullClassName: string, index: number) {\n    return `rel_${pathIndex}_${fullClassName.replaceAll(/[\\.:]/g, \"_\")}_${index}`;\n  }\n  const result: JoinRelationshipPath = [];\n  path.forEach((step, i) => {\n    result.push({\n      targetClassName: step.targetClassName,\n      relationshipName: step.relationshipClassName,\n      sourceClassName: step.sourceClassName,\n      relationshipReverse: !step.isForwardRelationship,\n      sourceAlias: i === 0 ? sourceAlias : result[i - 1].targetAlias,\n      relationshipAlias: createAlias(step.relationshipClassName, i),\n      targetAlias: i === path.length - 1 ? targetAlias : createAlias(step.targetClassName, i),\n      joinType: \"inner\",\n    });\n  });\n  return result;\n}\n\ninterface SpecializeContentClassProps {\n  classHierarchyInspector: ECClassHierarchyInspector;\n  contentClassName: string;\n  filterClassNames: string[];\n}\nasync function specializeContentClass(props: SpecializeContentClassProps): Promise<string | undefined> {\n  const filterClass = await getSpecializedPropertyClass(props.classHierarchyInspector, props.filterClassNames);\n  if (!filterClass) {\n    return props.contentClassName;\n  }\n  if (await props.classHierarchyInspector.classDerivesFrom(filterClass, props.contentClassName)) {\n    return filterClass;\n  }\n  if (await props.classHierarchyInspector.classDerivesFrom(props.contentClassName, filterClass)) {\n    return props.contentClassName;\n  }\n  return undefined;\n}\n\nasync function getSpecializedPropertyClass(classHierarchyInspector: ECClassHierarchyInspector, classes: string[]): Promise<string | undefined> {\n  if (classes.length === 0) {\n    return undefined;\n  }\n  const [currClassName, ...restClasses] = classes;\n  let resolvedClassName = currClassName;\n  for (const propClassName of restClasses) {\n    if (await classHierarchyInspector.classDerivesFrom(propClassName, resolvedClassName)) {\n      resolvedClassName = propClassName;\n    }\n  }\n  return resolvedClassName;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itwin/presentation-hierarchies",
-  "version": "0.1.5",
+  "version": "0.2.0",
   "description": "A package for creating hierarchies based on data in iTwin.js iModels.",
   "license": "MIT",
   "author": {
@@ -33,7 +33,7 @@
     "@itwin/presentation-shared": "^0.3.1"
   },
   "devDependencies": {
-    "@itwin/build-tools": "^4.6.0",
+    "@itwin/build-tools": "^4.7.1",
     "@itwin/eslint-plugin": "^4.0.0",
     "@types/chai": "^4.3.14",
     "@types/chai-as-promised": "^7.1.8",