@itwin/imodel-transformer 2.0.0-dev.5 → 2.0.0-dev.50

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.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":"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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"]}

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,CAsJ/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,50 +8,45 @@ 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
-        /* eslint-disable @typescript-eslint/no-deprecated */
         args.master.withSqliteStatement(`
         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());
         });
-        /* eslint-enable @typescript-eslint/no-deprecated */
         args.branch.performCheckpoint();
         const reopenBranch = makeDbReopener(args.branch);
         // close dbs because element cache could be invalid
@@ -60,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,
@@ -71,34 +69,32 @@ 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 = `
+    const fedGuidlessElemsSql = `
     SELECT ECInstanceId AS id
     FROM Bis.Element
     WHERE FederationGuid IS NULL
       AND ECInstanceId NOT IN (0x1, 0xe, 0x10) /* ignore special elems */
   `;
-    const elemReader = args.branch.createQueryReader(fedGuidLessElemsSql, undefined, { usePrimaryConn: true });
-    while (await elemReader.step()) {
-        const id = elemReader.current.toRow().id;
-        const aspectProps = IModelTransformer_1.IModelTransformer.initElementProvenanceOptions(id, id, {
+    const elemReader = args.branch.createQueryReader(fedGuidlessElemsSql, undefined, { usePrimaryConn: true });
+    for await (const row of elemReader) {
+        const id = row.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 = `
+    const fedGuidlessRelsSql = `
     SELECT erte.ECInstanceId as id
     FROM Bis.ElementRefersToElements erte
     JOIN bis.Element se
@@ -107,18 +103,20 @@ async function initializeBranchProvenance(args) {
       ON te.ECInstanceId=erte.TargetECInstanceId
       WHERE se.FederationGuid IS NULL
       OR te.FederationGuid IS NULL`;
-    const relReader = args.branch.createQueryReader(fedGuidLessRelsSql, undefined, { usePrimaryConn: true });
-    while (await relReader.step()) {
-        const id = relReader.current.toRow().id;
-        const aspectProps = IModelTransformer_1.IModelTransformer.initRelationshipProvenanceOptions(id, id, {
+    const relReader = args.branch.createQueryReader(fedGuidlessRelsSql, undefined, { usePrimaryConn: true });
+    for await (const row of relReader) {
+        const id = row.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();
@@ -141,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":"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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  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    /* eslint-disable @typescript-eslint/no-deprecated */\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    /* eslint-enable @typescript-eslint/no-deprecated */\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  while (await elemReader.step()) {\n    const id: string = elemReader.current.toRow().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  while (await relReader.step()) {\n    const id: string = relReader.current.toRow().id;\n    const aspectProps = IModelTransformer.initRelationshipProvenanceOptions(\n      id,\n      id,\n      {\n        isReverseSynchronization: false,\n        targetScopeElementId: masterExternalSourceId,\n        sourceDb: args.master,\n        targetDb: args.branch,\n        forceOldRelationshipProvenanceMethod: false,\n      }\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/ChangesetScanner.d.ts

@@ -0,0 +1,60 @@
+import { IModelDb } from "@itwin/core-backend";
+import { Id64String } from "@itwin/core-bentley";
+import { ChangesetFileProps } from "@itwin/core-common";
+import type { ChangedInstanceIds } from "./IModelExporter";
+/**
+ * Metadata retained from a deleted EC instance for later target remapping.
+ * Properties are optional when the deleted instance did not contain that value.
+ * @internal
+ */
+export interface ChangesetDeletionRecord {
+    /** ID of the deleted source instance. */
+    ecInstanceId: Id64String;
+    /** EC class ID of the deleted source instance. */
+    ecClassId: Id64String;
+    /** Full EC class name resolved from [[ecClassId]]. */
+    classFullName?: string;
+    /** Federation GUID used to find the corresponding target element. */
+    federationGuid?: string;
+    /** Source endpoint of a deleted relationship. */
+    sourceECInstanceId?: Id64String;
+    /** Target endpoint of a deleted relationship. */
+    targetECInstanceId?: Id64String;
+    /** Scope of a deleted ExternalSourceAspect. */
+    scopeId?: Id64String;
+    /** Element owning a deleted ElementAspect. */
+    elementId?: Id64String;
+    /** Kind of a deleted ExternalSourceAspect. */
+    kind?: string;
+    /** Identifier of a deleted ExternalSourceAspect. */
+    identifier?: string;
+}
+/**
+ * Pre-delete properties grouped by changeset. [[ChangedInstanceIds]] retains
+ * operation sets but not the properties needed to remap deleted instances.
+ * Grouping keeps scoped ExternalSourceAspect metadata paired with deletions
+ * from the same changeset.
+ * @internal
+ */
+export type ChangesetDeletionRecordsByChangeset = ChangesetDeletionRecord[][];
+/**
+ * Reads each changeset once, unifies table changes into EC instance changes,
+ * normalizes overflow-only inserts and deletes to updates, writes all operations
+ * to [[ChangedInstanceIds]], and retains properties needed to process deletions.
+ * @internal
+ */
+export declare class ChangesetScanner {
+    /**
+     * Scans each changeset file in order with one reader and unifier per file.
+     * @param iModel Database used to resolve EC class names.
+     * @param csFileProps Ordered changeset files to scan.
+     * @param changedInstanceIds Aggregate updated with the unified changes unless disabled by [[options]].
+     * @param options Controls whether the aggregate is populated while deletion records are collected.
+     * @returns Deleted-instance properties needed after the scan; changed IDs are written to [[changedInstanceIds]].
+     */
+    static scan(iModel: IModelDb, csFileProps: ChangesetFileProps[], changedInstanceIds: ChangedInstanceIds, options?: {
+        populateChangedInstanceIds?: boolean;
+    }): Promise<ChangesetDeletionRecordsByChangeset>;
+    private static toDeletionRecord;
+}
+//# sourceMappingURL=ChangesetScanner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChangesetScanner.d.ts","sourceRoot":"","sources":["../../src/ChangesetScanner.ts"],"names":[],"mappings":"AAKA,OAAO,EAGL,QAAQ,EAGT,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAc,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAM3D;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,yCAAyC;IACzC,YAAY,EAAE,UAAU,CAAC;IACzB,kDAAkD;IAClD,SAAS,EAAE,UAAU,CAAC;IACtB,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qEAAqE;IACrE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,kBAAkB,CAAC,EAAE,UAAU,CAAC;IAChC,iDAAiD;IACjD,kBAAkB,CAAC,EAAE,UAAU,CAAC;IAChC,+CAA+C;IAC/C,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,mCAAmC,GAAG,uBAAuB,EAAE,EAAE,CAAC;AAE9E;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC3B;;;;;;;OAOG;IACH,OAAoB,IAAI,CACtB,MAAM,EAAE,QAAQ,EAChB,WAAW,EAAE,kBAAkB,EAAE,EACjC,kBAAkB,EAAE,kBAAkB,EACtC,OAAO,GAAE;QAAE,0BAA0B,CAAC,EAAE,OAAO,CAAA;KAAO,GACrD,OAAO,CAAC,mCAAmC,CAAC,CAiD9C;IAED,OAAO,CAAC,MAAM,CAAC,gBAAgB;CA4BhC"}

package/lib/cjs/ChangesetScanner.js

@@ -0,0 +1,101 @@
+"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.ChangesetScanner = void 0;
+const core_backend_1 = require("@itwin/core-backend");
+const core_bentley_1 = require("@itwin/core-bentley");
+const IModelTransformerError_1 = require("./IModelTransformerError");
+/**
+ * Reads each changeset once, unifies table changes into EC instance changes,
+ * normalizes overflow-only inserts and deletes to updates, writes all operations
+ * to [[ChangedInstanceIds]], and retains properties needed to process deletions.
+ * @internal
+ */
+class ChangesetScanner {
+    /**
+     * Scans each changeset file in order with one reader and unifier per file.
+     * @param iModel Database used to resolve EC class names.
+     * @param csFileProps Ordered changeset files to scan.
+     * @param changedInstanceIds Aggregate updated with the unified changes unless disabled by [[options]].
+     * @param options Controls whether the aggregate is populated while deletion records are collected.
+     * @returns Deleted-instance properties needed after the scan; changed IDs are written to [[changedInstanceIds]].
+     */
+    static async scan(iModel, csFileProps, changedInstanceIds, options = {}) {
+        const deletionRecordsByChangeset = [];
+        for (const csFile of csFileProps) {
+            const csReader = core_backend_1.ChangesetReader.openFile({
+                fileName: csFile.pathname,
+                db: iModel,
+                propFilter: core_backend_1.PropertyFilter.BisCoreElement,
+            });
+            const changeUnifier = new core_backend_1.PartialChangeUnifier();
+            try {
+                while (csReader.step())
+                    changeUnifier.appendFrom(csReader);
+                const deletionRecords = [];
+                for (const change of changeUnifier.instances) {
+                    const ecClassId = change.ECClassId;
+                    if (ecClassId === undefined)
+                        core_bentley_1.ITwinError.throwError({
+                            iTwinErrorId: {
+                                scope: IModelTransformerError_1.IModelTransformerErrorScope,
+                                key: IModelTransformerError_1.IModelTransformerError.ChangedInstanceMetadataMissing,
+                            },
+                            message: `ECClassId was not found for id: ${change.ECInstanceId}! Table is : ${change.$meta.tables}`,
+                        });
+                    // Change is recorded at table level, not EC entity level.
+                    // This normalizes overflow-table expansion records so they do not
+                    // appear as element inserts or deletes.
+                    if ((change.$meta.op === "Inserted" || change.$meta.op === "Deleted") &&
+                        change.$meta.tables.every((table) => table.endsWith("Overflow"))) {
+                        change.$meta.op = "Updated";
+                    }
+                    if (options.populateChangedInstanceIds !== false)
+                        await changedInstanceIds.addChange(change);
+                    if (change.$meta.op === "Deleted") {
+                        deletionRecords.push(this.toDeletionRecord(iModel, change));
+                    }
+                }
+                deletionRecordsByChangeset.push(deletionRecords);
+            }
+            finally {
+                try {
+                    changeUnifier[Symbol.dispose]();
+                }
+                finally {
+                    csReader[Symbol.dispose]();
+                }
+            }
+        }
+        return deletionRecordsByChangeset;
+    }
+    static toDeletionRecord(iModel, change) {
+        const ecClassId = change.ECClassId;
+        if (ecClassId === undefined) {
+            core_bentley_1.ITwinError.throwError({
+                iTwinErrorId: {
+                    scope: IModelTransformerError_1.IModelTransformerErrorScope,
+                    key: IModelTransformerError_1.IModelTransformerError.ChangedInstanceMetadataMissing,
+                },
+                message: `ECClassId was not found for id: ${change.ECInstanceId}! Table is : ${change.$meta.tables}`,
+            });
+        }
+        return {
+            ecInstanceId: change.ECInstanceId,
+            ecClassId,
+            classFullName: iModel.getClassNameFromId(ecClassId),
+            federationGuid: change.FederationGuid,
+            sourceECInstanceId: change.SourceECInstanceId,
+            targetECInstanceId: change.TargetECInstanceId,
+            scopeId: change.Scope?.Id,
+            elementId: change.Element?.Id,
+            kind: change.Kind,
+            identifier: change.Identifier,
+        };
+    }
+}
+exports.ChangesetScanner = ChangesetScanner;
+//# sourceMappingURL=ChangesetScanner.js.map

package/lib/cjs/ChangesetScanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChangesetScanner.js","sourceRoot":"","sources":["../../src/ChangesetScanner.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  ChangeInstance,\n  ChangesetReader,\n  IModelDb,\n  PartialChangeUnifier,\n  PropertyFilter,\n} from \"@itwin/core-backend\";\nimport { Id64String, ITwinError } from \"@itwin/core-bentley\";\nimport { ChangesetFileProps } from \"@itwin/core-common\";\nimport type { ChangedInstanceIds } from \"./IModelExporter\";\nimport {\n  IModelTransformerError,\n  IModelTransformerErrorScope,\n} from \"./IModelTransformerError\";\n\n/**\n * Metadata retained from a deleted EC instance for later target remapping.\n * Properties are optional when the deleted instance did not contain that value.\n * @internal\n */\nexport interface ChangesetDeletionRecord {\n  /** ID of the deleted source instance. */\n  ecInstanceId: Id64String;\n  /** EC class ID of the deleted source instance. */\n  ecClassId: Id64String;\n  /** Full EC class name resolved from [[ecClassId]]. */\n  classFullName?: string;\n  /** Federation GUID used to find the corresponding target element. */\n  federationGuid?: string;\n  /** Source endpoint of a deleted relationship. */\n  sourceECInstanceId?: Id64String;\n  /** Target endpoint of a deleted relationship. */\n  targetECInstanceId?: Id64String;\n  /** Scope of a deleted ExternalSourceAspect. */\n  scopeId?: Id64String;\n  /** Element owning a deleted ElementAspect. */\n  elementId?: Id64String;\n  /** Kind of a deleted ExternalSourceAspect. */\n  kind?: string;\n  /** Identifier of a deleted ExternalSourceAspect. */\n  identifier?: string;\n}\n\n/**\n * Pre-delete properties grouped by changeset. [[ChangedInstanceIds]] retains\n * operation sets but not the properties needed to remap deleted instances.\n * Grouping keeps scoped ExternalSourceAspect metadata paired with deletions\n * from the same changeset.\n * @internal\n */\nexport type ChangesetDeletionRecordsByChangeset = ChangesetDeletionRecord[][];\n\n/**\n * Reads each changeset once, unifies table changes into EC instance changes,\n * normalizes overflow-only inserts and deletes to updates, writes all operations\n * to [[ChangedInstanceIds]], and retains properties needed to process deletions.\n * @internal\n */\nexport class ChangesetScanner {\n  /**\n   * Scans each changeset file in order with one reader and unifier per file.\n   * @param iModel Database used to resolve EC class names.\n   * @param csFileProps Ordered changeset files to scan.\n   * @param changedInstanceIds Aggregate updated with the unified changes unless disabled by [[options]].\n   * @param options Controls whether the aggregate is populated while deletion records are collected.\n   * @returns Deleted-instance properties needed after the scan; changed IDs are written to [[changedInstanceIds]].\n   */\n  public static async scan(\n    iModel: IModelDb,\n    csFileProps: ChangesetFileProps[],\n    changedInstanceIds: ChangedInstanceIds,\n    options: { populateChangedInstanceIds?: boolean } = {}\n  ): Promise<ChangesetDeletionRecordsByChangeset> {\n    const deletionRecordsByChangeset: ChangesetDeletionRecord[][] = [];\n    for (const csFile of csFileProps) {\n      const csReader = ChangesetReader.openFile({\n        fileName: csFile.pathname,\n        db: iModel,\n        propFilter: PropertyFilter.BisCoreElement,\n      });\n      const changeUnifier = new PartialChangeUnifier();\n      try {\n        while (csReader.step()) changeUnifier.appendFrom(csReader);\n        const deletionRecords: ChangesetDeletionRecord[] = [];\n        for (const change of changeUnifier.instances) {\n          const ecClassId = change.ECClassId;\n          if (ecClassId === undefined)\n            ITwinError.throwError({\n              iTwinErrorId: {\n                scope: IModelTransformerErrorScope,\n                key: IModelTransformerError.ChangedInstanceMetadataMissing,\n              },\n              message: `ECClassId was not found for id: ${change.ECInstanceId}! Table is : ${change.$meta.tables}`,\n            });\n          // Change is recorded at table level, not EC entity level.\n          // This normalizes overflow-table expansion records so they do not\n          // appear as element inserts or deletes.\n          if (\n            (change.$meta.op === \"Inserted\" || change.$meta.op === \"Deleted\") &&\n            change.$meta.tables.every((table) => table.endsWith(\"Overflow\"))\n          ) {\n            change.$meta.op = \"Updated\";\n          }\n\n          if (options.populateChangedInstanceIds !== false)\n            await changedInstanceIds.addChange(change);\n          if (change.$meta.op === \"Deleted\") {\n            deletionRecords.push(this.toDeletionRecord(iModel, change));\n          }\n        }\n        deletionRecordsByChangeset.push(deletionRecords);\n      } finally {\n        try {\n          changeUnifier[Symbol.dispose]();\n        } finally {\n          csReader[Symbol.dispose]();\n        }\n      }\n    }\n\n    return deletionRecordsByChangeset;\n  }\n\n  private static toDeletionRecord(\n    iModel: IModelDb,\n    change: ChangeInstance\n  ): ChangesetDeletionRecord {\n    const ecClassId = change.ECClassId;\n    if (ecClassId === undefined) {\n      ITwinError.throwError({\n        iTwinErrorId: {\n          scope: IModelTransformerErrorScope,\n          key: IModelTransformerError.ChangedInstanceMetadataMissing,\n        },\n        message: `ECClassId was not found for id: ${change.ECInstanceId}! Table is : ${change.$meta.tables}`,\n      });\n    }\n\n    return {\n      ecInstanceId: change.ECInstanceId,\n      ecClassId,\n      classFullName: iModel.getClassNameFromId(ecClassId),\n      federationGuid: change.FederationGuid,\n      sourceECInstanceId: change.SourceECInstanceId,\n      targetECInstanceId: change.TargetECInstanceId,\n      scopeId: change.Scope?.Id,\n      elementId: change.Element?.Id,\n      kind: change.Kind,\n      identifier: change.Identifier,\n    };\n  }\n}\n"]}

package/lib/cjs/ECReferenceTypesCache.d.ts

@@ -22,9 +22,6 @@ export declare class ECReferenceTypesCache {
     private _propQualifierToRefType;
     private _relClassNameEndToRefTypes;
     private _initedSchemas;
-    private _rootBisClassCache;
-    private _relationshipInfoCache;
-    private _constraintClassCache;
     private static bisRootClassToRefType;
     private getRootBisClass;
     private getAbstractConstraintClass;

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

@@ -1 +1 @@
-{"version":3,"file":"ECReferenceTypesCache.d.ts","sourceRoot":"","sources":["../../src/ECReferenceTypesCache.ts"],"names":[],"mappings":"AAIA;;GAEG;AAGH,OAAO,EACL,mBAAmB,EAEnB,WAAW,EACZ,MAAM,oBAAoB,CAAC;AAY5B,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAG/C;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;;CAI7C;AAED;;;;;;;GAOG;AACH,qBAAa,qBAAqB;IAChC,uGAAuG;IACvG,OAAO,CAAC,uBAAuB,CAG3B;IACJ,OAAO,CAAC,0BAA0B,CAG9B;IACJ,OAAO,CAAC,cAAc,CAAgC;IAGtD,OAAO,CAAC,kBAAkB,CAA8B;IACxD,OAAO,CAAC,sBAAsB,CAA8C;IAC5E,OAAO,CAAC,qBAAqB,CAA8B;IAE3D,OAAO,CAAC,MAAM,CAAC,qBAAqB,CAalC;YAEY,eAAe;YAmCf,0BAA0B;IAqBxC,8CAA8C;IACjC,sBAAsB,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;YAuDtD,kBAAkB;YAalB,UAAU;YAwFV,mBAAmB;IA4D1B,iBAAiB,CACtB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,SAAS,GAAG,mBAAmB;IAS3B,sBAAsB,CAC3B,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,SAAS,GAAG,WAAW;IAQnB,KAAK;CAQb"}
+{"version":3,"file":"ECReferenceTypesCache.d.ts","sourceRoot":"","sources":["../../src/ECReferenceTypesCache.ts"],"names":[],"mappings":"AAIA;;GAEG;AAGH,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAYtE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAO/C;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,cAEC;CACF;AAED;;;;;;;GAOG;AACH,qBAAa,qBAAqB;IAChC,uGAAuG;IACvG,OAAO,CAAC,uBAAuB,CAG3B;IACJ,OAAO,CAAC,0BAA0B,CAG9B;IACJ,OAAO,CAAC,cAAc,CAAgC;IAEtD,OAAO,CAAC,MAAM,CAAC,qBAAqB,CAalC;YAEY,eAAe;YA2Bf,0BAA0B;IAaxC,8CAA8C;IACjC,sBAAsB,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BnE;YAEa,kBAAkB;YAalB,UAAU;YAoEV,mBAAmB;IA4D1B,iBAAiB,CACtB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,SAAS,GAAG,mBAAmB,CAOjC;IAEM,sBAAsB,CAC3B,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,SAAS,GAAG,WAAW,CAMzB;IAEM,KAAK,SAIX;CACF"}