@itwin/imodel-transformer 2.0.0-dev.7 → 2.0.0-dev.70

package/README.md

@@ -4,47 +4,33 @@ Copyright © Bentley Systems, Incorporated. All rights reserved. See LICENSE.md
 
 ## Description
 
-The __@itwin/imodel-transformer__ package contains classes that handle traversing iModels for exporting and importing their parts.
+The **@itwin/imodel-transformer** package contains classes that handle traversing iModels for exporting and importing their parts.
 
 ## Documentation
 
 See the [iTwin.js](https://www.itwinjs.org) documentation for more information.
 
+### Transformation context
+
+Retrieve the supported transformation context from an `IModelTransformer`. Depend on `IModelTransformContext` when passing the context to helpers or creating test doubles; `IModelCloneContext` is an implementation detail.
+
+```ts
+import type { IModelTransformContext } from "@itwin/imodel-transformer";
+
+const context: IModelTransformContext = transformer.context;
+```
+
 ## Versioning
 
 This package, for the time being, relies on @internal APIs in iTwin.js, and therefore has very strict peerDependencies versions.
 We perform a version check at runtime to ensure this. Every new iTwin.js version must be validated, and fixes are rarely ported
 to old versions currently, you must request this in an issue. Removing Dependencies on internal APIs is ongoing.
-You can find the latest @itwin/imodel-transformer version for your iTwin.js version by copy and pasting this into a bash shell
-
-(use git bash on windows).
-
-```sh
-MY_ITWINJS_VERSION="3.6.0" # edit me
-pnpm -s --package=semver -c dlx node <<EOF
-json=""
-require("https").get("https://registry.npmjs.org/@itwin/imodel-transformer", r=>r.setEncoding("utf8").on("data", d=>json+=d).on("end", ()=>{
-  semver=require(process.env.PATH.split(":").find(x=>x.includes(".bin"))+"/../semver")
-  console.log(Object.entries(JSON.parse(json).versions)
-              .filter(([,v])=>semver.satisfies("$MY_ITWINJS_VERSION", v.peerDependencies["@itwin/core-backend"]))
-              .map(([k,v])=>k).reverse())
-}))
-EOF
-```
-
 ## Environment Variables
 
 ### TRANSFORMER_NO_STRICT_DEP_CHECK
 
-Set this variable to `1` to disable strict dependency checks in `packages/transformer/src/transformer.ts`. The strict dependency check validates that the version of @itwinjs/core-backend provided falls in the range defined by the peerDependencies of the transformer package.
-
-### SUGGEST_TRANSFORMER_VERSIONS
-
-Set this variable to `1` to enable `packages/transformer/src/transformer.ts` to suggest compatible versions if dependencies are not in the specified peer dependency range of this package.
+Set this variable to `1` to disable strict dependency checks in `packages/transformer/src/imodel-transformer.ts`. The strict dependency check validates that the version of `@itwin/core-backend` provided falls in the range defined by the peer dependencies of the transformer package.
 
 ```dotenv
-# Disable strict dependency checks in transformer.ts
 TRANSFORMER_NO_STRICT_DEP_CHECK=1
-
-# Enable version suggestions in transformer.ts
-SUGGEST_TRANSFORMER_VERSIONS=1
+```

package/lib/cjs/Algo.d.ts

@@ -7,8 +7,4 @@
  * @internal
  */
 export declare function rangesFromRangeAndSkipped(start: number, end: number, skipped: number[]): [number, number][];
-/**
- * @internal
- */
-export declare function renderRanges(ranges: [number, number][]): number[];
 //# sourceMappingURL=Algo.d.ts.map

package/lib/cjs/Algo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Algo.d.ts","sourceRoot":"","sources":["../../src/Algo.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EAAE,GAChB,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CA2BpB;AAoBD;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,CAKjE"}
+{"version":3,"file":"Algo.d.ts","sourceRoot":"","sources":["../../src/Algo.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EAAE,GAChB,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CA2BpB"}

package/lib/cjs/Algo.js

@@ -8,7 +8,6 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.rangesFromRangeAndSkipped = rangesFromRangeAndSkipped;
-exports.renderRanges = renderRanges;
 /** given a discrete inclusive range [start, end] e.g. [-10, 12] and several "skipped" values", e.g.
  * (-10, 1, -3, 5, 15), return the ordered set of subranges of the original range that exclude
  * those values
@@ -58,14 +57,4 @@ function findRangeContaining(pt, inRanges) {
     }
     return -1;
 }
-/**
- * @internal
- */
-function renderRanges(ranges) {
-    const result = [];
-    for (const range of ranges)
-        for (let i = range[0]; i <= range[1]; ++i)
-            result.push(i);
-    return result;
-}
 //# sourceMappingURL=Algo.js.map

package/lib/cjs/Algo.js.map

@@ -1 +1 @@
-{"version":3,"file":"Algo.js","sourceRoot":"","sources":["../../src/Algo.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/** @packageDocumentation\n * @module Utils\n */\n\n/** given a discrete inclusive range [start, end] e.g. [-10, 12] and several \"skipped\" values\", e.g.\n * (-10, 1, -3, 5, 15), return the ordered set of subranges of the original range that exclude\n * those values\n * @internal\n */\nexport function rangesFromRangeAndSkipped(\n  start: number,\n  end: number,\n  skipped: number[]\n): [number, number][] {\n  function validRange(range: [number, number]): boolean {\n    return range[0] <= range[1];\n  }\n\n  const firstRange = [start, end] as [number, number];\n\n  if (!validRange(firstRange))\n    throw RangeError(`invalid range: [${start}, ${end}]`);\n\n  const ranges = [firstRange];\n  for (const skip of skipped) {\n    const rangeIndex = findRangeContaining(skip, ranges);\n    if (rangeIndex === -1) continue;\n    const range = ranges[rangeIndex];\n    // If the range we find ourselves in is just a single point (range[0] === range[1]) then we need to remove it if (range[0] === skip)\n    if (range[0] === range[1] && skip === range[0])\n      ranges.splice(rangeIndex, 1);\n    const leftRange = [range[0], skip - 1] as [number, number];\n    const rightRange = [skip + 1, range[1]] as [number, number];\n    if (validRange(leftRange) && validRange(rightRange))\n      ranges.splice(rangeIndex, 1, leftRange, rightRange);\n    else if (validRange(leftRange)) ranges.splice(rangeIndex, 1, leftRange);\n    else if (validRange(rightRange)) ranges.splice(rangeIndex, 1, rightRange);\n  }\n\n  return ranges;\n}\n\nfunction findRangeContaining(pt: number, inRanges: [number, number][]): number {\n  let begin = 0;\n  let end = inRanges.length - 1;\n  while (end >= begin) {\n    const mid = begin + Math.floor((end - begin) / 2);\n    const range = inRanges[mid];\n\n    if (pt >= range[0] && pt <= range[1]) return mid;\n\n    if (pt < range[0]) {\n      end = mid - 1;\n    } else {\n      begin = mid + 1;\n    }\n  }\n  return -1;\n}\n\n/**\n * @internal\n */\nexport function renderRanges(ranges: [number, number][]): number[] {\n  const result = [];\n  for (const range of ranges)\n    for (let i = range[0]; i <= range[1]; ++i) result.push(i);\n  return result;\n}\n"]}
+{"version":3,"file":"Algo.js","sourceRoot":"","sources":["../../src/Algo.ts"],"names":[],"mappings":";AAAA;;;gGAGgG;AAChG;;GAEG;;;AAEH;;;;GAIG;AACH,mCACE,KAAa,EACb,GAAW,EACX,OAAiB;IAEjB,SAAS,UAAU,CAAC,KAAuB;QACzC,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,UAAU,GAAG,CAAC,KAAK,EAAE,GAAG,CAAqB,CAAC;IAEpD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QACzB,MAAM,UAAU,CAAC,mBAAmB,KAAK,KAAK,GAAG,GAAG,CAAC,CAAC;IAExD,MAAM,MAAM,GAAG,CAAC,UAAU,CAAC,CAAC;IAC5B,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAG,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACrD,IAAI,UAAU,KAAK,CAAC,CAAC;YAAE,SAAS;QAChC,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;QACjC,oIAAoI;QACpI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC;YAC5C,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;QAC/B,MAAM,SAAS,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,CAAqB,CAAC;QAC3D,MAAM,UAAU,GAAG,CAAC,IAAI,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAqB,CAAC;QAC5D,IAAI,UAAU,CAAC,SAAS,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC;YACjD,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;aACjD,IAAI,UAAU,CAAC,SAAS,CAAC;YAAE,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;aACnE,IAAI,UAAU,CAAC,UAAU,CAAC;YAAE,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC;IAC5E,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,mBAAmB,CAAC,EAAU,EAAE,QAA4B;IACnE,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,GAAG,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9B,OAAO,GAAG,IAAI,KAAK,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QAClD,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QAE5B,IAAI,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC;YAAE,OAAO,GAAG,CAAC;QAEjD,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YAClB,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;QAChB,CAAC;aAAM,CAAC;YACN,KAAK,GAAG,GAAG,GAAG,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,CAAC,CAAC,CAAC;AACZ,CAAC","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/** @packageDocumentation\n * @module Utils\n */\n\n/** given a discrete inclusive range [start, end] e.g. [-10, 12] and several \"skipped\" values\", e.g.\n * (-10, 1, -3, 5, 15), return the ordered set of subranges of the original range that exclude\n * those values\n * @internal\n */\nexport function rangesFromRangeAndSkipped(\n  start: number,\n  end: number,\n  skipped: number[]\n): [number, number][] {\n  function validRange(range: [number, number]): boolean {\n    return range[0] <= range[1];\n  }\n\n  const firstRange = [start, end] as [number, number];\n\n  if (!validRange(firstRange))\n    throw RangeError(`invalid range: [${start}, ${end}]`);\n\n  const ranges = [firstRange];\n  for (const skip of skipped) {\n    const rangeIndex = findRangeContaining(skip, ranges);\n    if (rangeIndex === -1) continue;\n    const range = ranges[rangeIndex];\n    // If the range we find ourselves in is just a single point (range[0] === range[1]) then we need to remove it if (range[0] === skip)\n    if (range[0] === range[1] && skip === range[0])\n      ranges.splice(rangeIndex, 1);\n    const leftRange = [range[0], skip - 1] as [number, number];\n    const rightRange = [skip + 1, range[1]] as [number, number];\n    if (validRange(leftRange) && validRange(rightRange))\n      ranges.splice(rangeIndex, 1, leftRange, rightRange);\n    else if (validRange(leftRange)) ranges.splice(rangeIndex, 1, leftRange);\n    else if (validRange(rightRange)) ranges.splice(rangeIndex, 1, rightRange);\n  }\n\n  return ranges;\n}\n\nfunction findRangeContaining(pt: number, inRanges: [number, number][]): number {\n  let begin = 0;\n  let end = inRanges.length - 1;\n  while (end >= begin) {\n    const mid = begin + Math.floor((end - begin) / 2);\n    const range = inRanges[mid];\n\n    if (pt >= range[0] && pt <= range[1]) return mid;\n\n    if (pt < range[0]) {\n      end = mid - 1;\n    } else {\n      begin = mid + 1;\n    }\n  }\n  return -1;\n}\n"]}

package/lib/cjs/BigMap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BigMap.d.ts","sourceRoot":"","sources":["../../src/BigMap.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD;;;;;;GAMG;AACH,qBAAa,MAAM,CAAC,CAAC,CAAE,YAAW,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;IAClD,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,KAAK,CAAS;IAEtB,IAAW,IAAI,IAAI,MAAM,CAExB;;IAwBM,KAAK,IAAI,IAAI;IAKb,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO;IAShC,OAAO,CACZ,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,KAAK,IAAI,EACxE,OAAO,CAAC,EAAE,GAAG,GACZ,IAAI;IAMA,GAAG,CAAC,GAAG,EAAE,UAAU,GAAG,CAAC,GAAG,SAAS;IAInC,GAAG,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO;IAI7B,GAAG,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAWpC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,WAAW,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IAIxD,IAAW,CAAC,MAAM,CAAC,WAAW,CAAC,WAE9B;IAEO,OAAO,IAAI,WAAW,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IAOvC,IAAI,IAAI,WAAW,CAAC,UAAU,CAAC;IAO/B,MAAM,IAAI,WAAW,CAAC,CAAC,CAAC;CAMjC"}
+{"version":3,"file":"BigMap.d.ts","sourceRoot":"","sources":["../../src/BigMap.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD;;;;;;GAMG;AACH,qBAAa,MAAM,CAAC,CAAC,CAAE,YAAW,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;IAClD,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,KAAK,CAAS;IAEtB,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,cAoBC;IAEM,KAAK,IAAI,IAAI,CAGnB;IAEM,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAOtC;IAEM,OAAO,CACZ,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,KAAK,IAAI,EACxE,OAAO,CAAC,EAAE,GAAG,GACZ,IAAI,CAIN;IAEM,GAAG,CAAC,GAAG,EAAE,UAAU,GAAG,CAAC,GAAG,SAAS,CAEzC;IAEM,GAAG,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAEnC;IAEM,GAAG,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAS1C;IAEM,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,WAAW,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAEvD;IAED,IAAW,CAAC,MAAM,CAAC,WAAW,CAAC,WAE9B;IAEO,OAAO,IAAI,WAAW,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAK9C;IAEO,IAAI,IAAI,WAAW,CAAC,UAAU,CAAC,CAKtC;IAEO,MAAM,IAAI,WAAW,CAAC,CAAC,CAAC,CAK/B;CACF"}

package/lib/cjs/BigMap.js.map

@@ -1 +1 @@
-{"version":3,"file":"BigMap.js","sourceRoot":"","sources":["../../src/BigMap.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/** @packageDocumentation\n * @module Utils\n */\nimport { Id64String } from \"@itwin/core-bentley\";\n\n/**\n * This class serves as a temporary solution to address the issue of the V8 JavaScript engine's Map implementation,\n * which is limited to approximately 16.7 million elements. Currently, only Id64 string representations are\n * supported by this Map; any other type will lead to errors. It's worth noting that our future plan is to\n * replace this stopgap with a more robust solution, utilizing a temporary SQLite database (https://github.com/iTwin/imodel-transformer/issues/83).\n * @internal\n */\nexport class BigMap<V> implements Map<Id64String, V> {\n  private _maps: Record<string, Map<string, V>>;\n  private _size: number;\n\n  public get size(): number {\n    return this._size;\n  }\n\n  public constructor() {\n    this._maps = {\n      0: new Map(),\n      1: new Map(),\n      2: new Map(),\n      3: new Map(),\n      4: new Map(),\n      5: new Map(),\n      6: new Map(),\n      7: new Map(),\n      8: new Map(),\n      9: new Map(),\n      a: new Map(),\n      b: new Map(),\n      c: new Map(),\n      d: new Map(),\n      e: new Map(),\n      f: new Map(),\n    };\n    this._size = 0;\n  }\n\n  public clear(): void {\n    Object.values(this._maps).forEach((m) => m.clear());\n    this._size = 0;\n  }\n\n  public delete(key: Id64String): boolean {\n    const wasDeleted = this._maps[key[key.length - 1]].delete(key);\n    if (wasDeleted) {\n      this._size--;\n    }\n\n    return wasDeleted;\n  }\n\n  public forEach(\n    callbackfn: (value: V, key: Id64String, map: Map<Id64String, V>) => void,\n    thisArg?: any\n  ): void {\n    Object.values(this._maps).forEach((m) => {\n      m.forEach(callbackfn, thisArg);\n    });\n  }\n\n  public get(key: Id64String): V | undefined {\n    return this._maps[key[key.length - 1]].get(key);\n  }\n\n  public has(key: Id64String): boolean {\n    return this._maps[key[key.length - 1]].has(key);\n  }\n\n  public set(key: Id64String, value: V): this {\n    const mapForKey = this._maps[key[key.length - 1]];\n    if (mapForKey === undefined)\n      throw Error(`Tried to set ${key}, but that key has no submap`);\n    const beforeSize = mapForKey.size;\n    mapForKey.set(key, value);\n    const afterSize = mapForKey.size;\n    this._size += afterSize - beforeSize;\n    return this;\n  }\n\n  public [Symbol.iterator](): MapIterator<[Id64String, V]> {\n    return this.entries();\n  }\n\n  public get [Symbol.toStringTag]() {\n    return \"BigMap\";\n  }\n\n  public *entries(): MapIterator<[Id64String, V]> {\n    const maps = Object.values(this._maps);\n    for (const map of maps) {\n      for (const [key, value] of map.entries()) yield [key, value];\n    }\n  }\n\n  public *keys(): MapIterator<Id64String> {\n    const maps = Object.values(this._maps);\n    for (const map of maps) {\n      for (const key of map.keys()) yield key;\n    }\n  }\n\n  public *values(): MapIterator<V> {\n    const maps = Object.values(this._maps);\n    for (const map of maps) {\n      for (const value of map.values()) yield value;\n    }\n  }\n}\n"]}
+{"version":3,"file":"BigMap.js","sourceRoot":"","sources":["../../src/BigMap.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/** @packageDocumentation\n * @module Utils\n */\nimport { Id64String } from \"@itwin/core-bentley\";\n\n/**\n * This class serves as a temporary solution to address the issue of the V8 JavaScript engine's Map implementation,\n * which is limited to approximately 16.7 million elements. Currently, only Id64 string representations are\n * supported by this Map; any other type will lead to errors. It's worth noting that our future plan is to\n * replace this stopgap with a more robust solution, utilizing a temporary SQLite database (https://github.com/iTwin/imodel-transformer/issues/83).\n * @internal\n */\nexport class BigMap<V> implements Map<Id64String, V> {\n  private _maps: Record<string, Map<string, V>>;\n  private _size: number;\n\n  public get size(): number {\n    return this._size;\n  }\n\n  public constructor() {\n    this._maps = {\n      0: new Map(),\n      1: new Map(),\n      2: new Map(),\n      3: new Map(),\n      4: new Map(),\n      5: new Map(),\n      6: new Map(),\n      7: new Map(),\n      8: new Map(),\n      9: new Map(),\n      a: new Map(),\n      b: new Map(),\n      c: new Map(),\n      d: new Map(),\n      e: new Map(),\n      f: new Map(),\n    };\n    this._size = 0;\n  }\n\n  public clear(): void {\n    Object.values(this._maps).forEach((m) => m.clear());\n    this._size = 0;\n  }\n\n  public delete(key: Id64String): boolean {\n    const wasDeleted = this._maps[key[key.length - 1]].delete(key);\n    if (wasDeleted) {\n      this._size--;\n    }\n\n    return wasDeleted;\n  }\n\n  public forEach(\n    callbackfn: (value: V, key: Id64String, map: Map<Id64String, V>) => void,\n    thisArg?: any\n  ): void {\n    Object.values(this._maps).forEach((m) => {\n      m.forEach(callbackfn, thisArg);\n    });\n  }\n\n  public get(key: Id64String): V | undefined {\n    return this._maps[key[key.length - 1]].get(key);\n  }\n\n  public has(key: Id64String): boolean {\n    return this._maps[key[key.length - 1]].has(key);\n  }\n\n  public set(key: Id64String, value: V): this {\n    const mapForKey = this._maps[key[key.length - 1]];\n    if (mapForKey === undefined)\n      throw Error(`Tried to set ${key}, but that key has no submap`);\n    const beforeSize = mapForKey.size;\n    mapForKey.set(key, value);\n    const afterSize = mapForKey.size;\n    this._size += afterSize - beforeSize;\n    return this;\n  }\n\n  public [Symbol.iterator](): MapIterator<[Id64String, V]> {\n    return this.entries();\n  }\n\n  public get [Symbol.toStringTag]() {\n    return \"BigMap\";\n  }\n\n  public *entries(): MapIterator<[Id64String, V]> {\n    const maps = Object.values(this._maps);\n    for (const map of maps) {\n      for (const [key, value] of map.entries()) yield [key, value];\n    }\n  }\n\n  public *keys(): MapIterator<Id64String> {\n    const maps = Object.values(this._maps);\n    for (const map of maps) {\n      for (const key of map.keys()) yield key;\n    }\n  }\n\n  public *values(): MapIterator<V> {\n    const maps = Object.values(this._maps);\n    for (const map of maps) {\n      for (const value of map.values()) yield value;\n    }\n  }\n}\n"]}

package/lib/cjs/BranchProvenanceInitializer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BranchProvenanceInitializer.d.ts","sourceRoot":"","sources":["../../src/BranchProvenanceInitializer.ts"],"names":[],"mappings":"AAIA,OAAO,EAIL,QAAQ,EAGT,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAY,UAAU,EAAoB,MAAM,qBAAqB,CAAC;AAS7E;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,8DAA8D;IAC9D,MAAM,EAAE,QAAQ,CAAC;IACjB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,MAAM,EAAE,QAAQ,CAAC;IACjB;;;;;;;OAOG;IACH,uBAAuB,CAAC,EAAE,IAAI,GAAG,KAAK,GAAG,kBAAkB,CAAC;CAC7D;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,oBAAoB,EAAE,UAAU,CAAC;IACjC,sBAAsB,EAAE,UAAU,CAAC;IACnC,sBAAsB,EAAE,UAAU,CAAC;CACpC;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,oBAAoB,CAAC,CAiJ/B"}
+{"version":3,"file":"BranchProvenanceInitializer.d.ts","sourceRoot":"","sources":["../../src/BranchProvenanceInitializer.ts"],"names":[],"mappings":"AAIA,OAAO,EAKL,QAAQ,EAGT,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAY,UAAU,EAAoB,MAAM,qBAAqB,CAAC;AAW7E;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,8DAA8D;IAC9D,MAAM,EAAE,QAAQ,CAAC;IACjB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,MAAM,EAAE,QAAQ,CAAC;IACjB;;;;;;;OAOG;IACH,uBAAuB,CAAC,EAAE,IAAI,GAAG,KAAK,GAAG,kBAAkB,CAAC;CAC7D;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,oBAAoB,EAAE,UAAU,CAAC;IACjC,sBAAsB,EAAE,UAAU,CAAC;IACnC,sBAAsB,EAAE,UAAU,CAAC;CACpC;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,oBAAoB,CAAC,CAqJ/B"}

package/lib/cjs/BranchProvenanceInitializer.js

@@ -8,13 +8,16 @@ exports.initializeBranchProvenance = initializeBranchProvenance;
 const core_backend_1 = require("@itwin/core-backend");
 const core_bentley_1 = require("@itwin/core-bentley");
 const core_common_1 = require("@itwin/core-common");
-const assert = require("assert");
-const IModelTransformer_1 = require("./IModelTransformer");
-const url_1 = require("url");
+const node_assert_1 = require("node:assert");
+const ProvenanceManager_1 = require("./ProvenanceManager");
+const node_url_1 = require("node:url");
+const TransformerPackageMetadata_1 = require("./TransformerPackageMetadata");
 /**
  * @alpha
  */
 async function initializeBranchProvenance(args) {
+    let editTxn = new core_backend_1.EditTxn(args.branch, "initializeBranchProvenance");
+    editTxn.start();
     if (args.createFedGuidsForMaster) {
         // FIXME<LOW>: Consider enforcing that the master and branch dbs passed as part of ProvenanceInitArgs to this function
         // are identical. https://github.com/iTwin/imodel-transformer/issues/138
@@ -22,33 +25,27 @@ async function initializeBranchProvenance(args) {
         UPDATE bis_Element
         SET FederationGuid=randomblob(16)
         WHERE FederationGuid IS NULL
-      `, 
-        // eslint-disable-next-line @itwin/no-internal
-        (s) => assert(s.step() === core_bentley_1.DbResult.BE_SQLITE_DONE, args.branch.getLastError()));
+      `, (s) => (0, node_assert_1.strict)(s.step() === core_bentley_1.DbResult.BE_SQLITE_DONE, args.master.getLastError()));
         const masterPath = args.master.pathName;
         const reopenMaster = makeDbReopener(args.master);
         args.master.close(); // prevent busy
-        args.branch.withSqliteStatement(`ATTACH DATABASE '${(0, url_1.pathToFileURL)(`${masterPath}`)}?mode=ro' AS master`, 
-        // eslint-disable-next-line @itwin/no-internal
-        (s) => assert(s.step() === core_bentley_1.DbResult.BE_SQLITE_DONE, args.branch.getLastError()));
+        args.branch.withSqliteStatement(`ATTACH DATABASE '${(0, node_url_1.pathToFileURL)(`${masterPath}`)}?mode=ro' AS master`, (s) => (0, node_assert_1.strict)(s.step() === core_bentley_1.DbResult.BE_SQLITE_DONE, args.branch.getLastError()));
         args.branch.withSqliteStatement(`
       UPDATE main.bis_Element
       SET FederationGuid = (
         SELECT m.FederationGuid
         FROM master.bis_Element m
         WHERE m.Id=main.bis_Element.Id
-      )`, 
-        // eslint-disable-next-line @itwin/no-internal
-        (s) => assert(s.step() === core_bentley_1.DbResult.BE_SQLITE_DONE, args.branch.getLastError()));
+      )`, (s) => (0, node_assert_1.strict)(s.step() === core_bentley_1.DbResult.BE_SQLITE_DONE, args.branch.getLastError()));
         args.branch.clearCaches(); // statements write lock attached db (clearing statement cache does not fix this)
-        args.branch.saveChanges();
+        editTxn.saveChanges();
+        editTxn.end();
         args.branch.withSqliteStatement("DETACH DATABASE master", (s) => {
             const res = s.step();
             if (res !== core_bentley_1.DbResult.BE_SQLITE_DONE)
                 core_bentley_1.Logger.logTrace("initializeBranchProvenance", `Error detaching db (we will close anyway): ${args.branch.getLastError()}`);
             // this is the case until native side changes
-            // eslint-disable-next-line @itwin/no-internal
-            assert(res === core_bentley_1.DbResult.BE_SQLITE_ERROR, args.branch.getLastError());
+            (0, node_assert_1.strict)(res === core_bentley_1.DbResult.BE_SQLITE_ERROR, args.branch.getLastError());
         });
         args.branch.performCheckpoint();
         const reopenBranch = makeDbReopener(args.branch);
@@ -58,9 +55,12 @@ async function initializeBranchProvenance(args) {
             reopenMaster(),
             reopenBranch(),
         ]);
+        // Recreate editTxn on the reopened branch db
+        editTxn = new core_backend_1.EditTxn(args.branch, "initializeBranchProvenance");
+        editTxn.start();
     }
     // create an external source and owning repository link to use as our *Target Scope Element* for future synchronizations
-    const masterRepoLinkId = args.branch.elements.insertElement({
+    const masterRepoLinkId = editTxn.insertElement({
         classFullName: core_backend_1.RepositoryLink.classFullName,
         code: core_backend_1.RepositoryLink.createCode(args.branch, core_backend_1.IModelDb.repositoryModelId, "example-code-value"),
         model: core_backend_1.IModelDb.repositoryModelId,
@@ -69,15 +69,13 @@ async function initializeBranchProvenance(args) {
         repositoryGuid: args.master.iModelId,
         description: args.masterDescription,
     });
-    const masterExternalSourceId = args.branch.elements.insertElement({
+    const masterExternalSourceId = editTxn.insertElement({
         classFullName: core_backend_1.ExternalSource.classFullName,
         model: core_backend_1.IModelDb.rootSubjectId,
         code: core_common_1.Code.createEmpty(),
         repository: new core_backend_1.ExternalSourceIsInRepository(masterRepoLinkId),
-        /* eslint-disable @typescript-eslint/no-require-imports */
-        connectorName: require("../../package.json").name,
-        connectorVersion: require("../../package.json").version,
-        /* eslint-enable @typescript-eslint/no-require-imports */
+        connectorName: TransformerPackageMetadata_1.transformerPackageMetadata.name,
+        connectorVersion: TransformerPackageMetadata_1.transformerPackageMetadata.version,
     });
     const fedGuidlessElemsSql = `
     SELECT ECInstanceId AS id
@@ -88,13 +86,13 @@ async function initializeBranchProvenance(args) {
     const elemReader = args.branch.createQueryReader(fedGuidlessElemsSql, undefined, { usePrimaryConn: true });
     for await (const row of elemReader) {
         const id = row.id;
-        const aspectProps = IModelTransformer_1.IModelTransformer.initElementProvenanceOptions(id, id, {
+        const aspectProps = ProvenanceManager_1.ProvenanceManager.initElementProvenanceOptions(id, id, {
             isReverseSynchronization: false,
             targetScopeElementId: masterExternalSourceId,
             sourceDb: args.master,
             targetDb: args.branch,
         });
-        args.branch.elements.insertAspect(aspectProps);
+        editTxn.insertAspect(aspectProps);
     }
     const fedGuidlessRelsSql = `
     SELECT erte.ECInstanceId as id
@@ -108,15 +106,17 @@ async function initializeBranchProvenance(args) {
     const relReader = args.branch.createQueryReader(fedGuidlessRelsSql, undefined, { usePrimaryConn: true });
     for await (const row of relReader) {
         const id = row.id;
-        const aspectProps = await IModelTransformer_1.IModelTransformer.initRelationshipProvenanceOptions(id, id, {
+        const aspectProps = await ProvenanceManager_1.ProvenanceManager.initRelationshipProvenanceOptions(id, id, {
             isReverseSynchronization: false,
             targetScopeElementId: masterExternalSourceId,
             sourceDb: args.master,
             targetDb: args.branch,
             forceOldRelationshipProvenanceMethod: false,
         });
-        args.branch.elements.insertAspect(aspectProps);
+        editTxn.insertAspect(aspectProps);
     }
+    editTxn.saveChanges();
+    editTxn.end();
     if (args.createFedGuidsForMaster === true) {
         args.master.close();
         args.branch.close();
@@ -139,7 +139,7 @@ function makeDbReopener(db) {
     else if (db instanceof core_backend_1.StandaloneDb)
         reopenDb = (mode = originalMode) => core_backend_1.StandaloneDb.openFile(dbPath, mode);
     else
-        assert(false, `db type '${db.constructor.name}' not supported`);
+        (0, node_assert_1.strict)(false, `db type '${db.constructor.name}' not supported`);
     return reopenDb;
 }
 //# sourceMappingURL=BranchProvenanceInitializer.js.map

package/lib/cjs/BranchProvenanceInitializer.js.map

@@ -1 +1 @@
-{"version":3,"file":"BranchProvenanceInitializer.js","sourceRoot":"","sources":["../../src/BranchProvenanceInitializer.ts"],"names":[],"mappings":";;AA2DA,gEAmJC;AA9MD;;;gGAGgG;AAChG,sDAO6B;AAC7B,sDAA6E;AAC7E,oDAI4B;AAC5B,iCAAiC;AACjC,2DAAwD;AACxD,6BAAoC;AAoCpC;;GAEG;AACI,KAAK,UAAU,0BAA0B,CAC9C,IAAwB;IAExB,IAAI,IAAI,CAAC,uBAAuB,EAAE,CAAC;QACjC,sHAAsH;QACtH,wEAAwE;QACxE,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAC7B;;;;OAIC;QACD,8CAA8C;QAC9C,CAAC,CAAC,EAAE,EAAE,CACJ,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,uBAAQ,CAAC,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,CAC3E,CAAC;QACF,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;QACxC,MAAM,YAAY,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,eAAe;QACpC,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAC7B,oBAAoB,IAAA,mBAAa,EAAC,GAAG,UAAU,EAAE,CAAC,qBAAqB;QACvE,8CAA8C;QAC9C,CAAC,CAAC,EAAE,EAAE,CACJ,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,uBAAQ,CAAC,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,CAC3E,CAAC;QACF,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAC7B;;;;;;QAME;QAEF,8CAA8C;QAC9C,CAAC,CAAC,EAAE,EAAE,CACJ,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,uBAAQ,CAAC,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,CAC3E,CAAC;QACF,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,iFAAiF;QAC5G,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QAC1B,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,wBAAwB,EAAE,CAAC,CAAC,EAAE,EAAE;YAC9D,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;YACrB,IAAI,GAAG,KAAK,uBAAQ,CAAC,cAAc;gBACjC,qBAAM,CAAC,QAAQ,CACb,4BAA4B,EAC5B,8CAA8C,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,CAC3E,CAAC;YACJ,6CAA6C;YAC7C,8CAA8C;YAC9C,MAAM,CAAC,GAAG,KAAK,uBAAQ,CAAC,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;QACvE,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;QAEhC,MAAM,YAAY,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACjD,mDAAmD;QACnD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC7C,YAAY,EAAE;YACd,YAAY,EAAE;SACf,CAAC,CAAC;IACL,CAAC;IAED,wHAAwH;IACxH,MAAM,gBAAgB,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC;QAC1D,aAAa,EAAE,6BAAc,CAAC,aAAa;QAC3C,IAAI,EAAE,6BAAc,CAAC,UAAU,CAC7B,IAAI,CAAC,MAAM,EACX,uBAAQ,CAAC,iBAAiB,EAC1B,oBAAoB,CACrB;QACD,KAAK,EAAE,uBAAQ,CAAC,iBAAiB;QACjC,GAAG,EAAE,IAAI,CAAC,SAAS;QACnB,MAAM,EAAE,QAAQ;QAChB,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;QACpC,WAAW,EAAE,IAAI,CAAC,iBAAiB;KACb,CAAC,CAAC;IAE1B,MAAM,sBAAsB,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC;QAChE,aAAa,EAAE,6BAAc,CAAC,aAAa;QAC3C,KAAK,EAAE,uBAAQ,CAAC,aAAa;QAC7B,IAAI,EAAE,kBAAI,CAAC,WAAW,EAAE;QACxB,UAAU,EAAE,IAAI,2CAA4B,CAAC,gBAAgB,CAAC;QAC9D,0DAA0D;QAC1D,aAAa,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC,IAAI;QACjD,gBAAgB,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC,OAAO;QACvD,yDAAyD;KACnC,CAAC,CAAC;IAE1B,MAAM,mBAAmB,GAAG;;;;;GAK3B,CAAC;IACF,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAC9C,mBAAmB,EACnB,SAAS,EACT,EAAE,cAAc,EAAE,IAAI,EAAE,CACzB,CAAC;IACF,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,EAAE,GAAW,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,WAAW,GAAG,qCAAiB,CAAC,4BAA4B,CAAC,EAAE,EAAE,EAAE,EAAE;YACzE,wBAAwB,EAAE,KAAK;YAC/B,oBAAoB,EAAE,sBAAsB;YAC5C,QAAQ,EAAE,IAAI,CAAC,MAAM;YACrB,QAAQ,EAAE,IAAI,CAAC,MAAM;SACtB,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,kBAAkB,GAAG;;;;;;;;mCAQM,CAAC;IAClC,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAC7C,kBAAkB,EAClB,SAAS,EACT,EAAE,cAAc,EAAE,IAAI,EAAE,CACzB,CAAC;IACF,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAClC,MAAM,EAAE,GAAW,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,WAAW,GACf,MAAM,qCAAiB,CAAC,iCAAiC,CAAC,EAAE,EAAE,EAAE,EAAE;YAChE,wBAAwB,EAAE,KAAK;YAC/B,oBAAoB,EAAE,sBAAsB;YAC5C,QAAQ,EAAE,IAAI,CAAC,MAAM;YACrB,QAAQ,EAAE,IAAI,CAAC,MAAM;YACrB,oCAAoC,EAAE,KAAK;SAC5C,CAAC,CAAC;QACL,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,IAAI,CAAC,uBAAuB,KAAK,IAAI,EAAE,CAAC;QAC1C,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;IAED,OAAO;QACL,oBAAoB,EAAE,sBAAsB;QAC5C,sBAAsB;QACtB,sBAAsB,EAAE,gBAAgB;KACzC,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,EAAY;IAClC,MAAM,YAAY,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,uBAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,uBAAQ,CAAC,SAAS,CAAC;IAC5E,MAAM,MAAM,GAAG,EAAE,CAAC,QAAQ,CAAC;IAC3B,IAAI,QAA2D,CAAC;IAChE,IAAI,EAAE,YAAY,0BAAW;QAC3B,QAAQ,GAAG,KAAK,EAAE,IAAI,GAAG,YAAY,EAAE,EAAE,CACvC,0BAAW,CAAC,IAAI,CAAC;YACf,QAAQ,EAAE,MAAM;YAChB,QAAQ,EAAE,IAAI,KAAK,uBAAQ,CAAC,QAAQ;SACrC,CAAC,CAAC;SACF,IAAI,EAAE,YAAY,2BAAY;QACjC,QAAQ,GAAG,CAAC,IAAI,GAAG,YAAY,EAAE,EAAE,CAAC,2BAAY,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;;QACrE,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,CAAC,WAAW,CAAC,IAAI,iBAAiB,CAAC,CAAC;IACrE,OAAO,QAAQ,CAAC;AAClB,CAAC","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 *--------------------------------------------------------------------------------------------*/\nimport {\n  BriefcaseDb,\n  ExternalSource,\n  ExternalSourceIsInRepository,\n  IModelDb,\n  RepositoryLink,\n  StandaloneDb,\n} from \"@itwin/core-backend\";\nimport { DbResult, Id64String, Logger, OpenMode } from \"@itwin/core-bentley\";\nimport {\n  Code,\n  ExternalSourceProps,\n  RepositoryLinkProps,\n} from \"@itwin/core-common\";\nimport * as assert from \"assert\";\nimport { IModelTransformer } from \"./IModelTransformer\";\nimport { pathToFileURL } from \"url\";\n/**\n * @alpha\n */\nexport interface ProvenanceInitArgs {\n  /** the master iModel which is the source of the provenance */\n  master: IModelDb;\n  /** the canonical url of the master iModel */\n  masterUrl?: string;\n  /** the description of the master iModel */\n  masterDescription?: string;\n  /**\n   * @param {IModelDb} branchDb - the branch iModel which is the container of the provenance\n   *                              Must be opened Read/Write\n   */\n  branch: IModelDb;\n  /**\n   * insert Federation Guids in all lacking elements in the master database, which will prevent\n   * needing to insert External Source Aspects for provenance tracking\n   * @note requires a read/write master\n   * @note closes both the master and branch iModels to reset caches, so you must reopen them.\n   *       If you pass `\"keep-reopened-db\"`, this object's `master` and `branch` properties will\n   *       be set to new, open databases.\n   */\n  createFedGuidsForMaster?: true | false | \"keep-reopened-db\";\n}\n\n/**\n * @alpha\n */\nexport interface ProvenanceInitResult {\n  targetScopeElementId: Id64String;\n  masterExternalSourceId: Id64String;\n  masterRepositoryLinkId: Id64String;\n}\n\n/**\n * @alpha\n */\nexport async function initializeBranchProvenance(\n  args: ProvenanceInitArgs\n): Promise<ProvenanceInitResult> {\n  if (args.createFedGuidsForMaster) {\n    // FIXME<LOW>: Consider enforcing that the master and branch dbs passed as part of ProvenanceInitArgs to this function\n    // are identical. https://github.com/iTwin/imodel-transformer/issues/138\n    args.master.withSqliteStatement(\n      `\n        UPDATE bis_Element\n        SET FederationGuid=randomblob(16)\n        WHERE FederationGuid IS NULL\n      `,\n      // eslint-disable-next-line @itwin/no-internal\n      (s) =>\n        assert(s.step() === DbResult.BE_SQLITE_DONE, args.branch.getLastError())\n    );\n    const masterPath = args.master.pathName;\n    const reopenMaster = makeDbReopener(args.master);\n    args.master.close(); // prevent busy\n    args.branch.withSqliteStatement(\n      `ATTACH DATABASE '${pathToFileURL(`${masterPath}`)}?mode=ro' AS master`,\n      // eslint-disable-next-line @itwin/no-internal\n      (s) =>\n        assert(s.step() === DbResult.BE_SQLITE_DONE, args.branch.getLastError())\n    );\n    args.branch.withSqliteStatement(\n      `\n      UPDATE main.bis_Element\n      SET FederationGuid = (\n        SELECT m.FederationGuid\n        FROM master.bis_Element m\n        WHERE m.Id=main.bis_Element.Id\n      )`,\n\n      // eslint-disable-next-line @itwin/no-internal\n      (s) =>\n        assert(s.step() === DbResult.BE_SQLITE_DONE, args.branch.getLastError())\n    );\n    args.branch.clearCaches(); // statements write lock attached db (clearing statement cache does not fix this)\n    args.branch.saveChanges();\n    args.branch.withSqliteStatement(\"DETACH DATABASE master\", (s) => {\n      const res = s.step();\n      if (res !== DbResult.BE_SQLITE_DONE)\n        Logger.logTrace(\n          \"initializeBranchProvenance\",\n          `Error detaching db (we will close anyway): ${args.branch.getLastError()}`\n        );\n      // this is the case until native side changes\n      // eslint-disable-next-line @itwin/no-internal\n      assert(res === DbResult.BE_SQLITE_ERROR, args.branch.getLastError());\n    });\n    args.branch.performCheckpoint();\n\n    const reopenBranch = makeDbReopener(args.branch);\n    // close dbs because element cache could be invalid\n    args.branch.close();\n    [args.master, args.branch] = await Promise.all([\n      reopenMaster(),\n      reopenBranch(),\n    ]);\n  }\n\n  // create an external source and owning repository link to use as our *Target Scope Element* for future synchronizations\n  const masterRepoLinkId = args.branch.elements.insertElement({\n    classFullName: RepositoryLink.classFullName,\n    code: RepositoryLink.createCode(\n      args.branch,\n      IModelDb.repositoryModelId,\n      \"example-code-value\"\n    ),\n    model: IModelDb.repositoryModelId,\n    url: args.masterUrl,\n    format: \"iModel\",\n    repositoryGuid: args.master.iModelId,\n    description: args.masterDescription,\n  } as RepositoryLinkProps);\n\n  const masterExternalSourceId = args.branch.elements.insertElement({\n    classFullName: ExternalSource.classFullName,\n    model: IModelDb.rootSubjectId,\n    code: Code.createEmpty(),\n    repository: new ExternalSourceIsInRepository(masterRepoLinkId),\n    /* eslint-disable @typescript-eslint/no-require-imports */\n    connectorName: require(\"../../package.json\").name,\n    connectorVersion: require(\"../../package.json\").version,\n    /* eslint-enable @typescript-eslint/no-require-imports */\n  } as ExternalSourceProps);\n\n  const fedGuidlessElemsSql = `\n    SELECT ECInstanceId AS id\n    FROM Bis.Element\n    WHERE FederationGuid IS NULL\n      AND ECInstanceId NOT IN (0x1, 0xe, 0x10) /* ignore special elems */\n  `;\n  const elemReader = args.branch.createQueryReader(\n    fedGuidlessElemsSql,\n    undefined,\n    { usePrimaryConn: true }\n  );\n  for await (const row of elemReader) {\n    const id: string = row.id;\n    const aspectProps = IModelTransformer.initElementProvenanceOptions(id, id, {\n      isReverseSynchronization: false,\n      targetScopeElementId: masterExternalSourceId,\n      sourceDb: args.master,\n      targetDb: args.branch,\n    });\n    args.branch.elements.insertAspect(aspectProps);\n  }\n\n  const fedGuidlessRelsSql = `\n    SELECT erte.ECInstanceId as id\n    FROM Bis.ElementRefersToElements erte\n    JOIN bis.Element se\n      ON se.ECInstanceId=erte.SourceECInstanceId\n    JOIN bis.Element te\n      ON te.ECInstanceId=erte.TargetECInstanceId\n      WHERE se.FederationGuid IS NULL\n      OR te.FederationGuid IS NULL`;\n  const relReader = args.branch.createQueryReader(\n    fedGuidlessRelsSql,\n    undefined,\n    { usePrimaryConn: true }\n  );\n  for await (const row of relReader) {\n    const id: string = row.id;\n    const aspectProps =\n      await IModelTransformer.initRelationshipProvenanceOptions(id, id, {\n        isReverseSynchronization: false,\n        targetScopeElementId: masterExternalSourceId,\n        sourceDb: args.master,\n        targetDb: args.branch,\n        forceOldRelationshipProvenanceMethod: false,\n      });\n    args.branch.elements.insertAspect(aspectProps);\n  }\n\n  if (args.createFedGuidsForMaster === true) {\n    args.master.close();\n    args.branch.close();\n  }\n\n  return {\n    targetScopeElementId: masterExternalSourceId,\n    masterExternalSourceId,\n    masterRepositoryLinkId: masterRepoLinkId,\n  };\n}\n\nfunction makeDbReopener(db: IModelDb) {\n  const originalMode = db.isReadonly ? OpenMode.Readonly : OpenMode.ReadWrite;\n  const dbPath = db.pathName;\n  let reopenDb: (mode?: OpenMode) => IModelDb | Promise<IModelDb>;\n  if (db instanceof BriefcaseDb)\n    reopenDb = async (mode = originalMode) =>\n      BriefcaseDb.open({\n        fileName: dbPath,\n        readonly: mode === OpenMode.Readonly,\n      });\n  else if (db instanceof StandaloneDb)\n    reopenDb = (mode = originalMode) => StandaloneDb.openFile(dbPath, mode);\n  else assert(false, `db type '${db.constructor.name}' not supported`);\n  return reopenDb;\n}\n"]}
+{"version":3,"file":"BranchProvenanceInitializer.js","sourceRoot":"","sources":["../../src/BranchProvenanceInitializer.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 *--------------------------------------------------------------------------------------------*/\nimport {\n  BriefcaseDb,\n  EditTxn,\n  ExternalSource,\n  ExternalSourceIsInRepository,\n  IModelDb,\n  RepositoryLink,\n  StandaloneDb,\n} from \"@itwin/core-backend\";\nimport { DbResult, Id64String, Logger, OpenMode } from \"@itwin/core-bentley\";\nimport {\n  Code,\n  ExternalSourceProps,\n  RepositoryLinkProps,\n} from \"@itwin/core-common\";\nimport { strict as assert } from \"node:assert\";\nimport { ProvenanceManager } from \"./ProvenanceManager\";\nimport { pathToFileURL } from \"node:url\";\nimport { transformerPackageMetadata } from \"./TransformerPackageMetadata\";\n\n/**\n * @alpha\n */\nexport interface ProvenanceInitArgs {\n  /** the master iModel which is the source of the provenance */\n  master: IModelDb;\n  /** the canonical url of the master iModel */\n  masterUrl?: string;\n  /** the description of the master iModel */\n  masterDescription?: string;\n  /**\n   * @param {IModelDb} branchDb - the branch iModel which is the container of the provenance\n   *                              Must be opened Read/Write\n   */\n  branch: IModelDb;\n  /**\n   * insert Federation Guids in all lacking elements in the master database, which will prevent\n   * needing to insert External Source Aspects for provenance tracking\n   * @note requires a read/write master\n   * @note closes both the master and branch iModels to reset caches, so you must reopen them.\n   *       If you pass `\"keep-reopened-db\"`, this object's `master` and `branch` properties will\n   *       be set to new, open databases.\n   */\n  createFedGuidsForMaster?: true | false | \"keep-reopened-db\";\n}\n\n/**\n * @alpha\n */\nexport interface ProvenanceInitResult {\n  targetScopeElementId: Id64String;\n  masterExternalSourceId: Id64String;\n  masterRepositoryLinkId: Id64String;\n}\n\n/**\n * @alpha\n */\nexport async function initializeBranchProvenance(\n  args: ProvenanceInitArgs\n): Promise<ProvenanceInitResult> {\n  let editTxn = new EditTxn(args.branch, \"initializeBranchProvenance\");\n  editTxn.start();\n\n  if (args.createFedGuidsForMaster) {\n    // FIXME<LOW>: Consider enforcing that the master and branch dbs passed as part of ProvenanceInitArgs to this function\n    // are identical. https://github.com/iTwin/imodel-transformer/issues/138\n    args.master.withSqliteStatement(\n      `\n        UPDATE bis_Element\n        SET FederationGuid=randomblob(16)\n        WHERE FederationGuid IS NULL\n      `,\n      (s) =>\n        assert(s.step() === DbResult.BE_SQLITE_DONE, args.master.getLastError())\n    );\n    const masterPath = args.master.pathName;\n    const reopenMaster = makeDbReopener(args.master);\n    args.master.close(); // prevent busy\n    args.branch.withSqliteStatement(\n      `ATTACH DATABASE '${pathToFileURL(`${masterPath}`)}?mode=ro' AS master`,\n      (s) =>\n        assert(s.step() === DbResult.BE_SQLITE_DONE, args.branch.getLastError())\n    );\n    args.branch.withSqliteStatement(\n      `\n      UPDATE main.bis_Element\n      SET FederationGuid = (\n        SELECT m.FederationGuid\n        FROM master.bis_Element m\n        WHERE m.Id=main.bis_Element.Id\n      )`,\n\n      (s) =>\n        assert(s.step() === DbResult.BE_SQLITE_DONE, args.branch.getLastError())\n    );\n    args.branch.clearCaches(); // statements write lock attached db (clearing statement cache does not fix this)\n    editTxn.saveChanges();\n    editTxn.end();\n    args.branch.withSqliteStatement(\"DETACH DATABASE master\", (s) => {\n      const res = s.step();\n      if (res !== DbResult.BE_SQLITE_DONE)\n        Logger.logTrace(\n          \"initializeBranchProvenance\",\n          `Error detaching db (we will close anyway): ${args.branch.getLastError()}`\n        );\n      // this is the case until native side changes\n      assert(res === DbResult.BE_SQLITE_ERROR, args.branch.getLastError());\n    });\n    args.branch.performCheckpoint();\n\n    const reopenBranch = makeDbReopener(args.branch);\n    // close dbs because element cache could be invalid\n    args.branch.close();\n    [args.master, args.branch] = await Promise.all([\n      reopenMaster(),\n      reopenBranch(),\n    ]);\n    // Recreate editTxn on the reopened branch db\n    editTxn = new EditTxn(args.branch, \"initializeBranchProvenance\");\n    editTxn.start();\n  }\n\n  // create an external source and owning repository link to use as our *Target Scope Element* for future synchronizations\n  const masterRepoLinkId = editTxn.insertElement({\n    classFullName: RepositoryLink.classFullName,\n    code: RepositoryLink.createCode(\n      args.branch,\n      IModelDb.repositoryModelId,\n      \"example-code-value\"\n    ),\n    model: IModelDb.repositoryModelId,\n    url: args.masterUrl,\n    format: \"iModel\",\n    repositoryGuid: args.master.iModelId,\n    description: args.masterDescription,\n  } as RepositoryLinkProps);\n\n  const masterExternalSourceId = editTxn.insertElement({\n    classFullName: ExternalSource.classFullName,\n    model: IModelDb.rootSubjectId,\n    code: Code.createEmpty(),\n    repository: new ExternalSourceIsInRepository(masterRepoLinkId),\n    connectorName: transformerPackageMetadata.name,\n    connectorVersion: transformerPackageMetadata.version,\n  } as ExternalSourceProps);\n\n  const fedGuidlessElemsSql = `\n    SELECT ECInstanceId AS id\n    FROM Bis.Element\n    WHERE FederationGuid IS NULL\n      AND ECInstanceId NOT IN (0x1, 0xe, 0x10) /* ignore special elems */\n  `;\n  const elemReader = args.branch.createQueryReader(\n    fedGuidlessElemsSql,\n    undefined,\n    { usePrimaryConn: true }\n  );\n  for await (const row of elemReader) {\n    const id: string = row.id;\n    const aspectProps = ProvenanceManager.initElementProvenanceOptions(id, id, {\n      isReverseSynchronization: false,\n      targetScopeElementId: masterExternalSourceId,\n      sourceDb: args.master,\n      targetDb: args.branch,\n    });\n    editTxn.insertAspect(aspectProps);\n  }\n\n  const fedGuidlessRelsSql = `\n    SELECT erte.ECInstanceId as id\n    FROM Bis.ElementRefersToElements erte\n    JOIN bis.Element se\n      ON se.ECInstanceId=erte.SourceECInstanceId\n    JOIN bis.Element te\n      ON te.ECInstanceId=erte.TargetECInstanceId\n      WHERE se.FederationGuid IS NULL\n      OR te.FederationGuid IS NULL`;\n  const relReader = args.branch.createQueryReader(\n    fedGuidlessRelsSql,\n    undefined,\n    { usePrimaryConn: true }\n  );\n  for await (const row of relReader) {\n    const id: string = row.id;\n    const aspectProps =\n      await ProvenanceManager.initRelationshipProvenanceOptions(id, id, {\n        isReverseSynchronization: false,\n        targetScopeElementId: masterExternalSourceId,\n        sourceDb: args.master,\n        targetDb: args.branch,\n        forceOldRelationshipProvenanceMethod: false,\n      });\n    editTxn.insertAspect(aspectProps);\n  }\n\n  editTxn.saveChanges();\n  editTxn.end();\n\n  if (args.createFedGuidsForMaster === true) {\n    args.master.close();\n    args.branch.close();\n  }\n\n  return {\n    targetScopeElementId: masterExternalSourceId,\n    masterExternalSourceId,\n    masterRepositoryLinkId: masterRepoLinkId,\n  };\n}\n\nfunction makeDbReopener(db: IModelDb) {\n  const originalMode = db.isReadonly ? OpenMode.Readonly : OpenMode.ReadWrite;\n  const dbPath = db.pathName;\n  let reopenDb: (mode?: OpenMode) => IModelDb | Promise<IModelDb>;\n  if (db instanceof BriefcaseDb)\n    reopenDb = async (mode = originalMode) =>\n      BriefcaseDb.open({\n        fileName: dbPath,\n        readonly: mode === OpenMode.Readonly,\n      });\n  else if (db instanceof StandaloneDb)\n    reopenDb = (mode = originalMode) => StandaloneDb.openFile(dbPath, mode);\n  else assert(false, `db type '${db.constructor.name}' not supported`);\n  return reopenDb;\n}\n"]}

package/lib/cjs/ChangedElementForest.d.ts

@@ -0,0 +1,14 @@
+import { IModelDb } from "@itwin/core-backend";
+import { Id64String } from "@itwin/core-bentley";
+/** The minimal parent-child forest containing changed or excluded elements and their ancestors. */
+export declare class ChangedElementForest {
+    private readonly _rootsByModel;
+    private readonly _childrenByParent;
+    private constructor();
+    static create(sourceDb: IModelDb, ownedCandidateIds: Id64String[], maximumElementCount: number): Promise<ChangedElementForest | undefined>;
+    /** Gets the indexed root element IDs for a model. */
+    getModelRoots(modelId: Id64String): readonly Id64String[];
+    /** Gets the indexed child element IDs for a parent element. */
+    getChildren(parentId: Id64String): readonly Id64String[];
+}
+//# sourceMappingURL=ChangedElementForest.d.ts.map

package/lib/cjs/ChangedElementForest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChangedElementForest.d.ts","sourceRoot":"","sources":["../../src/ChangedElementForest.ts"],"names":[],"mappings":"AAKA,OAAO,EAGL,QAAQ,EACT,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAuB,MAAM,qBAAqB,CAAC;AAGtE,mGAAmG;AACnG,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAI9B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IALpC,OAAO,eASH;IAEJ,OAAoB,MAAM,CACxB,QAAQ,EAAE,QAAQ,EAClB,iBAAiB,EAAE,UAAU,EAAE,EAC/B,mBAAmB,EAAE,MAAM,GAC1B,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAwD3C;IAED,qDAAqD;IAC9C,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,UAAU,EAAE,CAE/D;IAED,+DAA+D;IACxD,WAAW,CAAC,QAAQ,EAAE,UAAU,GAAG,SAAS,UAAU,EAAE,CAE9D;CACF"}

package/lib/cjs/ChangedElementForest.js

@@ -0,0 +1,86 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChangedElementForest = void 0;
+const core_backend_1 = require("@itwin/core-backend");
+const core_bentley_1 = require("@itwin/core-bentley");
+const core_common_1 = require("@itwin/core-common");
+/** The minimal parent-child forest containing changed or excluded elements and their ancestors. */
+class ChangedElementForest {
+    _rootsByModel;
+    _childrenByParent;
+    constructor(_rootsByModel, _childrenByParent) {
+        this._rootsByModel = _rootsByModel;
+        this._childrenByParent = _childrenByParent;
+    }
+    static async create(sourceDb, ownedCandidateIds, maximumElementCount) {
+        if (ownedCandidateIds.length === 0) {
+            return new ChangedElementForest(new Map(), new Map());
+        }
+        const sql = `
+      WITH RECURSIVE ChangedElementHierarchy (ECInstanceId, ParentId, ModelId) AS (
+        SELECT e.ECInstanceId, e.Parent.Id, e.Model.Id
+        FROM ${core_backend_1.Element.classFullName} e
+        INNER JOIN IdSet(:candidateIds) ids ON ids.id = e.ECInstanceId
+        UNION
+        SELECT p.ECInstanceId, p.Parent.Id, p.Model.Id
+        FROM ${core_backend_1.Element.classFullName} p
+        INNER JOIN ChangedElementHierarchy c ON p.ECInstanceId = c.ParentId
+      )
+      SELECT ECInstanceId, ParentId, ModelId FROM ChangedElementHierarchy
+      LIMIT :resultLimit
+    `;
+        core_bentley_1.OrderedId64Iterable.sortArray(ownedCandidateIds);
+        const params = new core_common_1.QueryBinder()
+            .bindIdSet("candidateIds", ownedCandidateIds)
+            .bindInt("resultLimit", maximumElementCount + 1);
+        // QueryBinder serializes the IdSet synchronously, so release this temporary copy before retaining the hierarchy.
+        ownedCandidateIds.length = 0;
+        const rootsByModel = new Map();
+        const childrenByParent = new Map();
+        let elementCount = 0;
+        let elementLimitExceeded = false;
+        for await (const row of sourceDb.createQueryReader(sql, params, {
+            usePrimaryConn: true,
+        })) {
+            if (elementCount >= maximumElementCount) {
+                // Consume the single overflow row so the ECSqlReader reaches done; it has no disposal API.
+                elementLimitExceeded = true;
+                continue;
+            }
+            elementCount++;
+            const elementId = row[0];
+            const parentId = row[1] ?? undefined;
+            const modelId = row[2];
+            const index = parentId === undefined ? rootsByModel : childrenByParent;
+            const key = parentId ?? modelId;
+            const siblings = index.get(key);
+            if (siblings === undefined)
+                index.set(key, [elementId]);
+            else
+                siblings.push(elementId);
+        }
+        if (elementLimitExceeded)
+            return undefined;
+        for (const siblings of rootsByModel.values()) {
+            core_bentley_1.OrderedId64Iterable.sortArray(siblings);
+        }
+        for (const siblings of childrenByParent.values()) {
+            core_bentley_1.OrderedId64Iterable.sortArray(siblings);
+        }
+        return new ChangedElementForest(rootsByModel, childrenByParent);
+    }
+    /** Gets the indexed root element IDs for a model. */
+    getModelRoots(modelId) {
+        return this._rootsByModel.get(modelId) ?? [];
+    }
+    /** Gets the indexed child element IDs for a parent element. */
+    getChildren(parentId) {
+        return this._childrenByParent.get(parentId) ?? [];
+    }
+}
+exports.ChangedElementForest = ChangedElementForest;
+//# sourceMappingURL=ChangedElementForest.js.map

package/lib/cjs/ChangedElementForest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChangedElementForest.js","sourceRoot":"","sources":["../../src/ChangedElementForest.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 {\n  // eslint-disable-next-line @typescript-eslint/no-redeclare\n  Element,\n  IModelDb,\n} from \"@itwin/core-backend\";\nimport { Id64String, OrderedId64Iterable } from \"@itwin/core-bentley\";\nimport { QueryBinder } from \"@itwin/core-common\";\n\n/** The minimal parent-child forest containing changed or excluded elements and their ancestors. */\nexport class ChangedElementForest {\n  private constructor(\n    private readonly _rootsByModel: ReadonlyMap<\n      Id64String,\n      readonly Id64String[]\n    >,\n    private readonly _childrenByParent: ReadonlyMap<\n      Id64String,\n      readonly Id64String[]\n    >\n  ) {}\n\n  public static async create(\n    sourceDb: IModelDb,\n    ownedCandidateIds: Id64String[],\n    maximumElementCount: number\n  ): Promise<ChangedElementForest | undefined> {\n    if (ownedCandidateIds.length === 0) {\n      return new ChangedElementForest(new Map(), new Map());\n    }\n\n    const sql = `\n      WITH RECURSIVE ChangedElementHierarchy (ECInstanceId, ParentId, ModelId) AS (\n        SELECT e.ECInstanceId, e.Parent.Id, e.Model.Id\n        FROM ${Element.classFullName} e\n        INNER JOIN IdSet(:candidateIds) ids ON ids.id = e.ECInstanceId\n        UNION\n        SELECT p.ECInstanceId, p.Parent.Id, p.Model.Id\n        FROM ${Element.classFullName} p\n        INNER JOIN ChangedElementHierarchy c ON p.ECInstanceId = c.ParentId\n      )\n      SELECT ECInstanceId, ParentId, ModelId FROM ChangedElementHierarchy\n      LIMIT :resultLimit\n    `;\n    OrderedId64Iterable.sortArray(ownedCandidateIds);\n    const params = new QueryBinder()\n      .bindIdSet(\"candidateIds\", ownedCandidateIds)\n      .bindInt(\"resultLimit\", maximumElementCount + 1);\n    // QueryBinder serializes the IdSet synchronously, so release this temporary copy before retaining the hierarchy.\n    ownedCandidateIds.length = 0;\n    const rootsByModel = new Map<Id64String, Id64String[]>();\n    const childrenByParent = new Map<Id64String, Id64String[]>();\n    let elementCount = 0;\n    let elementLimitExceeded = false;\n    for await (const row of sourceDb.createQueryReader(sql, params, {\n      usePrimaryConn: true,\n    })) {\n      if (elementCount >= maximumElementCount) {\n        // Consume the single overflow row so the ECSqlReader reaches done; it has no disposal API.\n        elementLimitExceeded = true;\n        continue;\n      }\n      elementCount++;\n      const elementId: Id64String = row[0];\n      const parentId: Id64String | undefined = row[1] ?? undefined;\n      const modelId: Id64String = row[2];\n      const index = parentId === undefined ? rootsByModel : childrenByParent;\n      const key = parentId ?? modelId;\n      const siblings = index.get(key);\n      if (siblings === undefined) index.set(key, [elementId]);\n      else siblings.push(elementId);\n    }\n\n    if (elementLimitExceeded) return undefined;\n\n    for (const siblings of rootsByModel.values()) {\n      OrderedId64Iterable.sortArray(siblings);\n    }\n    for (const siblings of childrenByParent.values()) {\n      OrderedId64Iterable.sortArray(siblings);\n    }\n    return new ChangedElementForest(rootsByModel, childrenByParent);\n  }\n\n  /** Gets the indexed root element IDs for a model. */\n  public getModelRoots(modelId: Id64String): readonly Id64String[] {\n    return this._rootsByModel.get(modelId) ?? [];\n  }\n\n  /** Gets the indexed child element IDs for a parent element. */\n  public getChildren(parentId: Id64String): readonly Id64String[] {\n    return this._childrenByParent.get(parentId) ?? [];\n  }\n}\n"]}