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

package/lib/cjs/IModelTransformer.js

@@ -110,7 +110,7 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
      * @param dbToQuery db to run the query on for scope external source
      * @param aspectProps aspectProps to search for @see ExternalSourceAspectProps
      */
-    static queryScopeExternalSourceAspect(dbToQuery, aspectProps) {
+    static async queryScopeExternalSourceAspect(dbToQuery, aspectProps) {
         const sql = `
       SELECT ECInstanceId, Version, JsonProperties
       FROM ${core_backend_1.ExternalSourceAspect.classFullName}
@@ -121,25 +121,19 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
       LIMIT 1
     `;
         // if (aspectProps.scope === undefined) return undefined;
-        // const params = new QueryBinder().bindId("elementId", aspectProps.element.id);
+        // const params = new QueryBinder();
+        // params.bindId("elementId", aspectProps.element.id);
         // params.bindId("scopeId", aspectProps.scope.id);
         // params.bindString("kind", aspectProps.kind);
         // params.bindString("identifier", aspectProps.identifier);
-        // const result = await dbToQuery.createQueryReader(sql);
-        // if (result) {
-        //   const aspectId = result.current.id;
-        //   const versionValue = result.current[1];
-        //   const version = versionValue.isNull
-        //     ? undefined
-        //     : versionValue.getString();
-        //   const jsonPropsValue = result.current[2];
-        //   const jsonProperties = jsonPropsValue.isNull
-        //     ? undefined
-        //     : jsonPropsValue.getString();
+        // const reader = dbToQuery.createQueryReader(sql, params, {usePrimaryConn: true});
+        // if (await reader.step()) {
+        //   const aspectId = reader.current.id;
+        //   const version = reader.current.version as string | undefined;
+        //   const jsonProperties = reader.current.jsonProperties as string | undefined;
         //   return { aspectId, version, jsonProperties };
         // }
-        // else
-        //   return undefined;
+        // return undefined;
         // eslint-disable-next-line @itwin/no-internal, @typescript-eslint/no-deprecated
         return dbToQuery.withPreparedStatement(sql, (statement) => {
             statement.bindId("elementId", aspectProps.element.id);
@@ -169,7 +163,7 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
      * @throws if no scoping ESA can be found in either the sourceDb or targetDb which describes a master branch relationship between the two databases.
      * @returns "forward" or "reverse"
      */
-    static determineSyncType(sourceDb, targetDb, 
+    static async determineSyncType(sourceDb, targetDb, 
     /** @see [[IModelTransformOptions.targetScopeElementId]] */
     targetScopeElementId) {
         const aspectProps = {
@@ -186,19 +180,19 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
             jsonProperties: undefined,
         };
         /** First check if the targetDb is the branch (branch is the @see provenanceDb) */
-        const esaPropsFromTargetDb = this.queryScopeExternalSourceAspect(targetDb, aspectProps);
+        const esaPropsFromTargetDb = await this.queryScopeExternalSourceAspect(targetDb, aspectProps);
         if (esaPropsFromTargetDb !== undefined) {
             return "forward"; // we found an esa assuming targetDb is the provenanceDb/branch so this is a forward sync.
         }
         // Now check if the sourceDb is the branch
         aspectProps.identifier = targetDb.iModelId;
-        const esaPropsFromSourceDb = this.queryScopeExternalSourceAspect(sourceDb, aspectProps);
+        const esaPropsFromSourceDb = await this.queryScopeExternalSourceAspect(sourceDb, aspectProps);
         if (esaPropsFromSourceDb !== undefined) {
             return "reverse"; // we found an esa assuming sourceDb is the provenanceDb/branch so this is a reverse sync.
         }
         throw new Error(this.noEsaSyncDirectionErrorMessage);
     }
-    determineSyncType() {
+    async determineSyncType() {
         if (this._isProvenanceInitTransform) {
             return "forward";
         }
@@ -206,7 +200,7 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
             return "not-sync";
         }
         try {
-            return IModelTransformer.determineSyncType(this.sourceDb, this.targetDb, this.targetScopeElementId);
+            return await IModelTransformer.determineSyncType(this.sourceDb, this.targetDb, this.targetScopeElementId);
         }
         catch (err) {
             if (err instanceof Error &&
@@ -217,14 +211,14 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
             throw err;
         }
     }
-    get isReverseSynchronization() {
+    async getIsReverseSynchronization() {
         if (this._syncType === undefined)
-            this._syncType = this.determineSyncType();
+            this._syncType = await this.determineSyncType();
         return this._syncType === "reverse";
     }
-    get isForwardSynchronization() {
+    async getIsForwardSynchronization() {
         if (this._syncType === undefined)
-            this._syncType = this.determineSyncType();
+            this._syncType = await this.determineSyncType();
         return this._syncType === "forward";
     }
     _changesetRanges = undefined;
@@ -371,14 +365,18 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
     /** Return the IModelDb where IModelTransformer will store its provenance.
      * @note This will be [[targetDb]] except when it is a reverse synchronization. In that case it be [[sourceDb]].
      */
-    get provenanceDb() {
-        return this.isReverseSynchronization ? this.sourceDb : this.targetDb;
+    async provenanceDb() {
+        return (await this.getIsReverseSynchronization())
+            ? this.sourceDb
+            : this.targetDb;
     }
     /** Return the IModelDb where IModelTransformer looks for entities referred to by stored provenance.
      * @note This will be [[sourceDb]] except when it is a reverse synchronization. In that case it be [[targetDb]].
      */
-    get provenanceSourceDb() {
-        return this.isReverseSynchronization ? this.targetDb : this.sourceDb;
+    async provenanceSourceDb() {
+        return (await this.getIsReverseSynchronization())
+            ? this.targetDb
+            : this.sourceDb;
     }
     /** Create an ExternalSourceAspectProps in a standard way for an Element in an iModel --> iModel transformation. */
     static initElementProvenanceOptions(sourceElementId, targetElementId, args) {
@@ -445,9 +443,9 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
      */
     _forceOldRelationshipProvenanceMethod = false;
     /** Create an ExternalSourceAspectProps in a standard way for an Element in an iModel --> iModel transformation. */
-    initElementProvenance(sourceElementId, targetElementId) {
+    async initElementProvenance(sourceElementId, targetElementId) {
         return IModelTransformer.initElementProvenanceOptions(sourceElementId, targetElementId, {
-            isReverseSynchronization: this.isReverseSynchronization,
+            isReverseSynchronization: await this.getIsReverseSynchronization(),
             targetScopeElementId: this.targetScopeElementId,
             sourceDb: this.sourceDb,
             targetDb: this.targetDb,
@@ -459,10 +457,10 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
      * The ECInstanceId of the relationship in the branch iModel will be stored in the JsonProperties of the ExternalSourceAspect.
      */
     async initRelationshipProvenance(sourceRelationship, targetRelInstanceId) {
-        return await IModelTransformer.initRelationshipProvenanceOptions(sourceRelationship.id, targetRelInstanceId, {
+        return IModelTransformer.initRelationshipProvenanceOptions(sourceRelationship.id, targetRelInstanceId, {
             sourceDb: this.sourceDb,
             targetDb: this.targetDb,
-            isReverseSynchronization: this.isReverseSynchronization,
+            isReverseSynchronization: await this.getIsReverseSynchronization(),
             targetScopeElementId: this.targetScopeElementId,
             forceOldRelationshipProvenanceMethod: this._forceOldRelationshipProvenanceMethod,
         });
@@ -490,13 +488,13 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
      * @note empty string and -1 for changeset and index if it was transformed before federation guid update (pre 1.x) and @see [[IModelTransformOptions.branchRelationshipDataBehavior]] === "unsafe-migrate".
      * @throws if the version is not found in a preexisting scope aspect and @see [[IModelTransformOptions.branchRelationshipDataBehavior]] !== "unsafe-migrate"
      */
-    get synchronizationVersion() {
+    async synchronizationVersion() {
         if (this._cachedSynchronizationVersion === undefined) {
-            const provenanceScopeAspect = this.tryGetProvenanceScopeAspect();
+            const provenanceScopeAspect = await this.tryGetProvenanceScopeAspect();
             if (!provenanceScopeAspect) {
                 return { index: -1, id: "" }; // first synchronization.
             }
-            const version = this.isReverseSynchronization
+            const version = (await this.getIsReverseSynchronization())
                 ? JSON.parse(provenanceScopeAspect.jsonProperties ?? "{}").reverseSyncVersion
                 : provenanceScopeAspect.version;
             if (!version &&
@@ -518,17 +516,17 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
      * @returns provenance scope aspect if it exists in the provenanceDb.
      * Provenance scope aspect is created and inserted into provenanceDb when [[initScopeProvenance]] is invoked.
      */
-    tryGetProvenanceScopeAspect() {
-        const scopeProvenanceAspectProps = IModelTransformer.queryScopeExternalSourceAspect(this.provenanceDb, {
+    async tryGetProvenanceScopeAspect() {
+        const scopeProvenanceAspectProps = await IModelTransformer.queryScopeExternalSourceAspect(await this.provenanceDb(), {
             id: undefined,
             classFullName: core_backend_1.ExternalSourceAspect.classFullName,
             scope: { id: core_common_1.IModel.rootSubjectId },
             kind: core_backend_1.ExternalSourceAspect.Kind.Scope,
             element: { id: this.targetScopeElementId ?? core_common_1.IModel.rootSubjectId },
-            identifier: this.provenanceSourceDb.iModelId,
+            identifier: (await this.provenanceSourceDb()).iModelId,
         });
         return scopeProvenanceAspectProps !== undefined
-            ? this.provenanceDb.elements.getAspect(scopeProvenanceAspectProps.aspectId)
+            ? (await this.provenanceDb()).elements.getAspect(scopeProvenanceAspectProps.aspectId)
             : undefined;
     }
     /**
@@ -538,6 +536,8 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
      *          if this was a [BriefcaseDb]($backend)
      */
     async initScopeProvenance() {
+        const provenanceDb = await this.provenanceDb();
+        const sourceProvenanceDb = await this.provenanceSourceDb();
         const aspectProps = {
             id: undefined,
             version: undefined,
@@ -547,11 +547,11 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
                 relClassName: core_backend_1.ElementOwnsExternalSourceAspects.classFullName,
             },
             scope: { id: core_common_1.IModel.rootSubjectId }, // the root Subject scopes scope elements
-            identifier: this.provenanceSourceDb.iModelId,
+            identifier: sourceProvenanceDb.iModelId,
             kind: core_backend_1.ExternalSourceAspect.Kind.Scope,
             jsonProperties: undefined,
         };
-        const foundEsaProps = IModelTransformer.queryScopeExternalSourceAspect(this.provenanceDb, aspectProps); // this query includes "identifier"
+        const foundEsaProps = await IModelTransformer.queryScopeExternalSourceAspect(provenanceDb, aspectProps); // this query includes "identifier"
         if (foundEsaProps === undefined) {
             aspectProps.version = ""; // empty since never before transformed. Will be updated in [[finalizeTransformation]]
             aspectProps.jsonProperties = {
@@ -572,7 +572,7 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
             params.bindId("elementId", aspectProps.element.id);
             params.bindId("scopeId", aspectProps.scope.id); // this scope.id can never be invalid, we create it above
             params.bindString("kind", aspectProps.kind);
-            const reader = this.provenanceDb.createQueryReader(sql, params, {
+            const reader = provenanceDb.createQueryReader(sql, params, {
                 usePrimaryConn: true,
             });
             const hasConflictingScope = await reader.step();
@@ -580,7 +580,7 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
                 throw new core_common_1.IModelError(core_bentley_1.IModelStatus.InvalidId, "Provenance scope conflict");
             }
             if (!this._options.noProvenance) {
-                const id = this.provenanceDb.elements.insertAspect({
+                const id = provenanceDb.elements.insertAspect({
                     ...aspectProps,
                     jsonProperties: JSON.stringify(aspectProps.jsonProperties),
                 });
@@ -600,7 +600,7 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
             const oldProps = JSON.parse(JSON.stringify(aspectProps));
             if (this.handleUnsafeMigrate(aspectProps)) {
                 core_bentley_1.Logger.logInfo(loggerCategory, "Unsafe migrate made a change to the target scope's external source aspect. Updating aspect in database.", { oldProps, newProps: aspectProps });
-                this.provenanceDb.elements.updateAspect({
+                provenanceDb.elements.updateAspect({
                     ...aspectProps,
                     jsonProperties: JSON.stringify(aspectProps.jsonProperties),
                 });
@@ -739,11 +739,11 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
         }
     }
     async forEachTrackedElement(fn) {
-        return await IModelTransformer.forEachTrackedElement({
-            provenanceSourceDb: this.provenanceSourceDb,
-            provenanceDb: this.provenanceDb,
+        return IModelTransformer.forEachTrackedElement({
+            provenanceSourceDb: await this.provenanceSourceDb(),
+            provenanceDb: await this.provenanceDb(),
             targetScopeElementId: this.targetScopeElementId,
-            isReverseSynchronization: this.isReverseSynchronization,
+            isReverseSynchronization: await this.getIsReverseSynchronization(),
             fn,
             skipPropagateChangesToRootElements: this._options.skipPropagateChangesToRootElements ?? true,
         });
@@ -756,7 +756,6 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
      * @returns the elementId that the ESA is stored on, esa.Element.Id
      */
     async _queryProvenanceForElement(entityInProvenanceSourceId) {
-        // eslint-disable-next-line @itwin/no-internal, @typescript-eslint/no-deprecated
         const sql = `
         SELECT esa.Element.Id
         FROM Bis.ExternalSourceAspect esa
@@ -768,7 +767,7 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
         params.bindString(1, core_backend_1.ExternalSourceAspect.Kind.Element);
         params.bindId(2, this.targetScopeElementId);
         params.bindString(3, entityInProvenanceSourceId);
-        const result = this.provenanceDb.createQueryReader(sql, params);
+        const result = (await this.provenanceDb()).createQueryReader(sql, params);
         if (await result.step()) {
             return result.current.id;
         }
@@ -796,7 +795,7 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
         params.bindString(1, core_backend_1.ExternalSourceAspect.Kind.Relationship);
         params.bindId(2, this.targetScopeElementId);
         params.bindString(3, entityInProvenanceSourceId);
-        const result = this.provenanceDb.createQueryReader(sql, params);
+        const result = (await this.provenanceDb()).createQueryReader(sql, params);
         if (await result.step()) {
             const aspectId = result.current.id;
             const provenanceRelInstId = result.current.provenanceRelInstId;
@@ -886,41 +885,42 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
     /**
      * Detect Element deletes using ExternalSourceAspects in the target iModel and a *brute force* comparison against Elements
      * in the source iModel.
-     * @deprecated in 1.x. Do not use this. // FIXME<MIKE>: how to better explain this?
+     * deprecated in 1.x. Do not use this. // FIXME<MIKE>: how to better explain this?
      * This method is only called during [[process]] when [[IModelTransformOptions.argsForProcessChanges]] is undefined and the option
      * [[IModelTransformOptions.forceExternalSourceAspectProvenance]] is enabled. It is not
      * necessary when calling [[process]] with [[IModelTransformOptions.argsForProcessChanges]] defined, since changeset information is sufficient.
      * @note you do not need to call this directly unless processing a subset of an iModel.
      * @throws [[IModelError]] If the required provenance information is not available to detect deletes.
      */
-    async detectElementDeletes() {
-        const sql = `
-      SELECT Identifier, Element.Id
-      FROM BisCore.ExternalSourceAspect
-      WHERE Scope.Id=:scopeId
-        AND Kind=:kind
-    `;
-        nodeAssert(!this.isReverseSynchronization, "synchronizations with processChanges already detect element deletes, don't call detectElementDeletes");
-        // Reported issue: https://github.com/iTwin/itwinjs-core/issues/7989
-        // eslint-disable-next-line @itwin/no-internal, @typescript-eslint/no-deprecated
-        this.provenanceDb.withPreparedStatement(sql, (stmt) => {
-            stmt.bindId("scopeId", this.targetScopeElementId);
-            stmt.bindString("kind", core_backend_1.ExternalSourceAspect.Kind.Element);
-            while (core_bentley_1.DbResult.BE_SQLITE_ROW === stmt.step()) {
-                // ExternalSourceAspect.Identifier is of type string
-                const aspectIdentifier = stmt.getValue(0).getString();
-                if (!core_bentley_1.Id64.isValidId64(aspectIdentifier)) {
-                    continue;
-                }
-                const targetElemId = stmt.getValue(1).getId();
-                const wasDeletedInSource = !EntityUnifier_1.EntityUnifier.exists(this.sourceDb, {
-                    entityReference: `e${aspectIdentifier}`,
-                });
-                if (wasDeletedInSource)
-                    this.importer.deleteElement(targetElemId);
-            }
-        });
-    }
+    // public async detectElementDeletes(): Promise<void> {
+    //   const sql = `
+    //     SELECT Identifier, Element.Id
+    //     FROM BisCore.ExternalSourceAspect
+    //     WHERE Scope.Id=:scopeId
+    //       AND Kind=:kind
+    //   `;
+    //   nodeAssert(
+    //     !this.isReverseSynchronization,
+    //     "synchronizations with processChanges already detect element deletes, don't call detectElementDeletes"
+    //   );
+    //   // Reported issue: https://github.com/iTwin/itwinjs-core/issues/7989
+    //   this.provenanceDb.withPreparedStatement(sql, (stmt) => {
+    //     stmt.bindId("scopeId", this.targetScopeElementId);
+    //     stmt.bindString("kind", ExternalSourceAspect.Kind.Element);
+    //     while (DbResult.BE_SQLITE_ROW === stmt.step()) {
+    //       // ExternalSourceAspect.Identifier is of type string
+    //       const aspectIdentifier = stmt.getValue(0).getString();
+    //       if (!Id64.isValidId64(aspectIdentifier)) {
+    //         continue;
+    //       }
+    //       const targetElemId = stmt.getValue(1).getId();
+    //       const wasDeletedInSource = !EntityUnifier.exists(this.sourceDb, {
+    //         entityReference: `e${aspectIdentifier}`,
+    //       });
+    //       if (wasDeletedInSource) this.importer.deleteElement(targetElemId);
+    //     }
+    //   });
+    // }
     /** Transform the specified sourceElement into ElementProps for the target iModel.
      * @param sourceElement The Element from the source iModel to transform.
      * @returns ElementProps for the target iModel.
@@ -1090,13 +1090,13 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
                 allReferencesExist = false;
             }
             if (this._options.danglingReferencesBehavior === "reject") {
-                this.assertReferenceExistsInSource(referenceId, entity);
+                await this.assertReferenceExistsInSource(referenceId, entity);
             }
         }
         return allReferencesExist;
     }
-    assertReferenceExistsInSource(referenceId, entity) {
-        const referencedExistsInSource = EntityUnifier_1.EntityUnifier.exists(this.sourceDb, {
+    async assertReferenceExistsInSource(referenceId, entity) {
+        const referencedExistsInSource = await EntityUnifier_1.EntityUnifier.exists(this.sourceDb, {
             entityReference: referenceId,
         });
         if (!referencedExistsInSource) {
@@ -1176,7 +1176,7 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
             .flat();
         if (unresolvedReferences.length > 0) {
             for (const reference of unresolvedReferences) {
-                const processState = this.getElemTransformState(reference);
+                const processState = await this.getElemTransformState(reference);
                 // must export element first
                 if (processState.needsElemImport)
                     await this.exporter.exportElement(reference);
@@ -1185,16 +1185,16 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
             }
         }
     }
-    getElemTransformState(elementId) {
-        const dbHasModel = (db, id) => {
+    async getElemTransformState(elementId) {
+        const dbHasModel = async (db, id) => {
             const maybeModelId = core_backend_1.EntityReferences.fromEntityType(id, core_common_1.ConcreteEntityTypes.Model);
             return EntityUnifier_1.EntityUnifier.exists(db, { entityReference: maybeModelId });
         };
-        const isSubModeled = dbHasModel(this.sourceDb, elementId);
+        const isSubModeled = await dbHasModel(this.sourceDb, elementId);
         const idOfElemInTarget = this.context.findTargetElementId(elementId);
         const isElemInTarget = core_bentley_1.Id64.invalid !== idOfElemInTarget;
         const needsModelImport = isSubModeled &&
-            (!isElemInTarget || !dbHasModel(this.targetDb, idOfElemInTarget));
+            (!isElemInTarget || !(await dbHasModel(this.targetDb, idOfElemInTarget)));
         return { needsElemImport: !isElemInTarget, needsModelImport };
     }
     /** Override of [IModelExportHandler.onExportElement]($transformer) that imports an element into the target iModel when it is exported from the source iModel.
@@ -1288,20 +1288,21 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
         // physical consolidation is an example of a 'joining' transform
         // FIXME: verify at finalization time that we don't lose provenance on new elements
         // FIXME: make public and improve `initElementProvenance` API for usage by consolidators
+        const provenanceDb = await this.provenanceDb();
         if (!this._options.noProvenance) {
             let provenance = this._options.forceExternalSourceAspectProvenance ||
                 this._elementsWithExplicitlyTrackedProvenance.has(sourceElement.id)
                 ? undefined
                 : sourceElement.federationGuid;
             if (!provenance) {
-                const aspectProps = this.initElementProvenance(sourceElement.id, targetElementProps.id);
-                const foundEsaProps = IModelTransformer.queryScopeExternalSourceAspect(this.provenanceDb, aspectProps);
+                const aspectProps = await this.initElementProvenance(sourceElement.id, targetElementProps.id);
+                const foundEsaProps = await IModelTransformer.queryScopeExternalSourceAspect(provenanceDb, aspectProps);
                 if (foundEsaProps === undefined)
-                    aspectProps.id = this.provenanceDb.elements.insertAspect(aspectProps);
+                    aspectProps.id = provenanceDb.elements.insertAspect(aspectProps);
                 else {
                     // Since initElementProvenance sets a property 'version' on the aspectProps that we wish to persist in the provenanceDb, only grab the id from the foundEsaProps.
                     aspectProps.id = foundEsaProps.aspectId;
-                    this.provenanceDb.elements.updateAspect(aspectProps);
+                    provenanceDb.elements.updateAspect(aspectProps);
                 }
                 provenance = aspectProps;
             }
@@ -1466,7 +1467,7 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
      * Note that typically, the reverseSyncVersion is saved as the last changeset merged from the branch into master.
      * Setting initializeReverseSyncVersion to true during a forward transformation could overwrite this correct reverseSyncVersion and should only be done during the first transformation between a master and branch iModel.
      */
-    updateSynchronizationVersion({ initializeReverseSyncVersion = false, } = {}) {
+    async updateSynchronizationVersion({ initializeReverseSyncVersion = false, } = {}) {
         const shouldSkipSyncVersionUpdate = !initializeReverseSyncVersion &&
             this._sourceChangeDataState !== "has-changes";
         if (shouldSkipSyncVersionUpdate)
@@ -1474,7 +1475,7 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
         nodeAssert(this._targetScopeProvenanceProps);
         const sourceVersion = `${this.sourceDb.changeset.id};${this.sourceDb.changeset.index}`;
         const targetVersion = `${this.targetDb.changeset.id};${this.targetDb.changeset.index}`;
-        if (this.isReverseSynchronization) {
+        if (await this.getIsReverseSynchronization()) {
             const oldVersion = this._targetScopeProvenanceProps.jsonProperties.reverseSyncVersion;
             core_bentley_1.Logger.logInfo(loggerCategory, `updating reverse version from ${oldVersion} to ${sourceVersion}`);
             this._targetScopeProvenanceProps.jsonProperties.reverseSyncVersion =
@@ -1504,7 +1505,7 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
             // Determine which keys to clear and update based on the synchronization direction
             let syncChangesetsToClearKey;
             let syncChangesetsToUpdateKey;
-            if (this.isReverseSynchronization) {
+            if (await this.getIsReverseSynchronization()) {
                 syncChangesetsToClearKey = pendingReverseSyncChangesetIndicesKey;
                 syncChangesetsToUpdateKey = pendingSyncChangesetIndicesKey;
             }
@@ -1523,7 +1524,7 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
                 return csIndex > startingChangesetIndices.source;
             });
             // if reverse sync then we may have received provenance changes which should be marked as sync changes
-            if (this.isReverseSynchronization) {
+            if (await this.getIsReverseSynchronization()) {
                 nodeAssert(this.sourceDb.changeset.index !== undefined, "changeset didn't exist");
                 for (let i = startingChangesetIndices.source + 1; i <= this.sourceDb.changeset.index + 1; i++)
                     jsonProps.pendingReverseSyncChangesetIndices.push(i);
@@ -1531,16 +1532,16 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
             core_bentley_1.Logger.logTrace(loggerCategory, `new pendingReverseSyncChanges: ${jsonProps.pendingReverseSyncChangesetIndices}`);
             core_bentley_1.Logger.logTrace(loggerCategory, `new pendingSyncChanges: ${jsonProps.pendingSyncChangesetIndices}`);
         }
-        this.provenanceDb.elements.updateAspect({
+        (await this.provenanceDb()).elements.updateAspect({
             ...this._targetScopeProvenanceProps,
             jsonProperties: JSON.stringify(this._targetScopeProvenanceProps.jsonProperties),
         });
         this.clearCachedSynchronizationVersion();
     }
     // FIXME<MIKE>: is this necessary when manually using low level transform APIs? (document if so)
-    finalizeTransformation() {
+    async finalizeTransformation() {
         this.importer.finalize();
-        this.updateSynchronizationVersion({
+        await this.updateSynchronizationVersion({
             initializeReverseSyncVersion: this._isProvenanceInitTransform,
         });
         // TODO: ignore if we remove change cache usage
@@ -1578,6 +1579,7 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
         const targetFedGuid = this.sourceDb.elements.getFederationGuidFromId(sourceRelationship.targetId);
         const targetRelationshipProps = this.onTransformRelationship(sourceRelationship);
         const targetRelationshipInstanceId = this.importer.importRelationship(targetRelationshipProps);
+        const provenanceDb = await this.provenanceDb();
         if (!this._options.noProvenance &&
             core_bentley_1.Id64.isValid(targetRelationshipInstanceId)) {
             let provenance = !this._options.forceExternalSourceAspectProvenance
@@ -1585,10 +1587,10 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
                 : undefined;
             if (!provenance) {
                 const aspectProps = await this.initRelationshipProvenance(sourceRelationship, targetRelationshipInstanceId);
-                const foundEsaProps = IModelTransformer.queryScopeExternalSourceAspect(this.provenanceDb, aspectProps);
+                const foundEsaProps = await IModelTransformer.queryScopeExternalSourceAspect(provenanceDb, aspectProps);
                 // onExportRelationship doesn't need to call updateAspect if esaProps were found, because relationship provenance doesn't have the same concept of a version as element provenance (which uses last mod time on the elements).
                 if (undefined === foundEsaProps) {
-                    aspectProps.id = this.provenanceDb.elements.insertAspect(aspectProps);
+                    aspectProps.id = provenanceDb.elements.insertAspect(aspectProps);
                 }
                 provenance = aspectProps;
             }
@@ -1598,7 +1600,7 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
     /** Override of [IModelExportHandler.onDeleteRelationship]($transformer) that is called when [IModelExporter]($transformer) detects that a [Relationship]($backend) has been deleted from the source iModel.
      * This override propagates the delete to the target iModel via [IModelImporter.deleteRelationship]($transformer).
      */
-    onDeleteRelationship(sourceRelInstanceId) {
+    async onDeleteRelationship(sourceRelInstanceId) {
         nodeAssert(this._deletedSourceRelationshipData, "should be defined at initialization by now");
         const deletedRelData = this._deletedSourceRelationshipData.get(sourceRelInstanceId);
         if (!deletedRelData) {
@@ -1619,7 +1621,7 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
         }
         if (deletedRelData.provenanceAspectId) {
             try {
-                this.provenanceDb.elements.deleteAspect(deletedRelData.provenanceAspectId);
+                (await this.provenanceDb()).elements.deleteAspect(deletedRelData.provenanceAspectId);
             }
             catch (error) {
                 // This aspect may no longer exist if it was deleted at some other point during the transformation. This is fine.
@@ -1636,40 +1638,52 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
      * @note This method is called from [[process]] when [[IModelTransformOptions.argsForProcessChanges]] are undefined, so it only needs to be called directly when processing a subset of an iModel.
      * @throws [[IModelError]] If the required provenance information is not available to detect deletes.
      */
-    async detectRelationshipDeletes() {
-        if (this.isReverseSynchronization) {
-            throw new core_common_1.IModelError(core_bentley_1.IModelStatus.BadRequest, "Cannot detect deletes when isReverseSynchronization=true");
-        }
-        const aspectDeleteIds = [];
-        const sql = `
-      SELECT ECInstanceId, Identifier, JsonProperties
-      FROM ${core_backend_1.ExternalSourceAspect.classFullName} aspect
-      WHERE aspect.Scope.Id=:scopeId
-        AND aspect.Kind=:kind
-    `;
-        const params = new core_common_1.QueryBinder().bindId("scopeId", this.targetScopeElementId);
-        params.bindString("kind", core_backend_1.ExternalSourceAspect.Kind.Relationship);
-        for await (const row of this.targetDb.createQueryReader(sql, params)) {
-            const sourceRelInstanceId = core_bentley_1.Id64.fromJSON(row[1]);
-            if (undefined ===
-                this.sourceDb.relationships.tryGetInstanceProps(core_backend_1.ElementRefersToElements.classFullName, sourceRelInstanceId)) {
-                // this function exists only to support some in-imodel transformations, which must
-                // use the old (external source aspect) provenance method anyway so we don't need to support
-                // new provenance
-                const json = JSON.parse(row[2]);
-                const targetRelInstanceId = json.targetRelInstanceId ?? json.provenanceRelInstanceId;
-                if (targetRelInstanceId) {
-                    this.importer.deleteRelationship({
-                        id: targetRelInstanceId,
-                        classFullName: core_backend_1.ElementRefersToElements.classFullName,
-                    });
-                }
-                aspectDeleteIds.push(row.id);
-            }
-            await this._yieldManager.allowYield();
-        }
-        this.targetDb.elements.deleteAspect(aspectDeleteIds);
-    }
+    // public async detectRelationshipDeletes(): Promise<void> {
+    //   if (this.isReverseSynchronization) {
+    //     throw new IModelError(
+    //       IModelStatus.BadRequest,
+    //       "Cannot detect deletes when isReverseSynchronization=true"
+    //     );
+    //   }
+    //   const aspectDeleteIds: Id64String[] = [];
+    //   const sql = `
+    //     SELECT ECInstanceId, Identifier, JsonProperties
+    //     FROM ${ExternalSourceAspect.classFullName} aspect
+    //     WHERE aspect.Scope.Id=:scopeId
+    //       AND aspect.Kind=:kind
+    //   `;
+    //   const params = new QueryBinder().bindId(
+    //     "scopeId",
+    //     this.targetScopeElementId
+    //   );
+    //   params.bindString("kind", ExternalSourceAspect.Kind.Relationship);
+    //   for await (const row of this.targetDb.createQueryReader(sql, params)) {
+    //     const sourceRelInstanceId: Id64String = Id64.fromJSON(row[1]);
+    //     if (
+    //       undefined ===
+    //       this.sourceDb.relationships.tryGetInstanceProps(
+    //         ElementRefersToElements.classFullName,
+    //         sourceRelInstanceId
+    //       )
+    //     ) {
+    //       // this function exists only to support some in-imodel transformations, which must
+    //       // use the old (external source aspect) provenance method anyway so we don't need to support
+    //       // new provenance
+    //       const json: any = JSON.parse(row[2]);
+    //       const targetRelInstanceId =
+    //         json.targetRelInstanceId ?? json.provenanceRelInstanceId;
+    //       if (targetRelInstanceId) {
+    //         this.importer.deleteRelationship({
+    //           id: targetRelInstanceId,
+    //           classFullName: ElementRefersToElements.classFullName,
+    //         });
+    //       }
+    //       aspectDeleteIds.push(row.id);
+    //     }
+    //     await this._yieldManager.allowYield();
+    //   }
+    //   this.targetDb.elements.deleteAspect(aspectDeleteIds);
+    // }
     /** Transform the specified sourceRelationship into RelationshipProps for the target iModel.
      * @param sourceRelationship The Relationship from the source iModel to be transformed.
      * @returns RelationshipProps for the target iModel.
@@ -1710,7 +1724,7 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
      */
     async onExportElementMultiAspects(sourceAspects) {
         // Transform source ElementMultiAspects into target ElementAspectProps
-        const targetAspectPropsArray = sourceAspects.map(async (srcA) => await this.onTransformElementAspect(srcA));
+        const targetAspectPropsArray = sourceAspects.map(async (srcA) => this.onTransformElementAspect(srcA));
         sourceAspects.forEach(async (a) => {
             if (!(await this.doAllReferencesExistInTarget(a))) {
                 this._partiallyCommittedAspectIds.add(a.id);
@@ -1883,7 +1897,7 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
         await this._tryInitChangesetData(this._options.argsForProcessChanges);
         await this.context.initialize();
         // need exporter initialized to do remapdeletedsourceentities.
-        await this.exporter.initialize(this.getExportInitOpts(this._options.argsForProcessChanges ?? {}));
+        await this.exporter.initialize(await this.getExportInitOpts(this._options.argsForProcessChanges ?? {}));
         // Exporter must be initialized prior to processing changesets in order to properly handle entity recreations (an entity delete followed by an insert of that same entity).
         await this.processChangesets();
         this._initialized = true;
@@ -1995,7 +2009,8 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
     async processDeletedOp(change, mapOfDeletedElemIdToScopeEsas, isRelationship, alreadyImportedElementInserts, alreadyImportedModelInserts) {
         // we need a connected iModel with changes to remap elements with deletions
         const notConnectedModel = this.sourceDb.iTwinId === undefined;
-        const noChanges = this.synchronizationVersion.index === this.sourceDb.changeset.index &&
+        const noChanges = (await this.synchronizationVersion()).index ===
+            this.sourceDb.changeset.index &&
             (this.exporter.sourceDbChanges === undefined ||
                 !this.exporter.sourceDbChanges.hasChanges);
         if (notConnectedModel || noChanges)
@@ -2004,7 +2019,7 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
          * if our ChangedECInstance is in the provenanceDb, then we can use the ids we find in the ChangedECInstance to query for ESAs.
          * This is because the ESAs are stored on an element Id thats present in the provenanceDb.
          */
-        const changeDataInProvenanceDb = this.sourceDb === this.provenanceDb;
+        const changeDataInProvenanceDb = this.sourceDb === (await this.provenanceDb());
         const getTargetIdFromSourceId = async (id) => {
             let identifierValue;
             let element;
@@ -2052,7 +2067,7 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
                     targetIdInTarget: targetIdOfRelationshipInTarget,
                 });
             }
-            else if (this.sourceDb === this.provenanceSourceDb) {
+            else if (this.sourceDb === (await this.provenanceSourceDb())) {
                 const relProvenance = await this._queryProvenanceForRelationship(changedInstanceId, {
                     classFullName: classFullName ?? "",
                     sourceId: sourceIdOfRelationshipInSource,
@@ -2068,7 +2083,8 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
         }
         else {
             let targetId = await getTargetIdFromSourceId(changedInstanceId);
-            if (targetId === undefined && this.sourceDb === this.provenanceSourceDb) {
+            if (targetId === undefined &&
+                this.sourceDb === (await this.provenanceSourceDb())) {
                 targetId = await this._queryProvenanceForElement(changedInstanceId);
             }
             // since we are processing one changeset at a time, we can see local source deletes
@@ -2097,7 +2113,8 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
             this._sourceChangeDataState = "unconnected";
             return;
         }
-        const noChanges = this.synchronizationVersion.index === this.sourceDb.changeset.index;
+        const syncVersion = await this.synchronizationVersion();
+        const noChanges = syncVersion.index === this.sourceDb.changeset.index;
         if (noChanges) {
             this._sourceChangeDataState = "no-changes";
             this._csFileProps = [];
@@ -2106,9 +2123,7 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
         const startChangeset = "startChangeset" in args ? args.startChangeset : undefined;
         // NOTE: that we do NOT download the changesummary for the last transformed version, we want
         // to ignore those already processed changes
-        const startChangesetIndexOrId = startChangeset?.index ??
-            startChangeset?.id ??
-            this.synchronizationVersion.index + 1;
+        const startChangesetIndexOrId = startChangeset?.index ?? startChangeset?.id ?? syncVersion.index + 1;
         const endChangesetId = this.sourceDb.changeset.id;
         const [startChangesetIndex, endChangesetIndex] = await Promise.all([startChangesetIndexOrId, endChangesetId].map(async (indexOrId) => typeof indexOrId === "number"
             ? indexOrId
@@ -2116,21 +2131,21 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
                 iModelId: this.sourceDb.iModelId,
                 changeset: { id: indexOrId },
             }).then((changeset) => changeset.index)));
-        const missingChangesets = startChangesetIndex > this.synchronizationVersion.index + 1;
+        const missingChangesets = startChangesetIndex > syncVersion.index + 1;
         if (!this._options.argsForProcessChanges
             ?.ignoreMissingChangesetsInSynchronizations &&
-            startChangesetIndex !== this.synchronizationVersion.index + 1 &&
-            this.synchronizationVersion.index !== -1) {
+            startChangesetIndex !== syncVersion.index + 1 &&
+            syncVersion.index !== -1) {
             throw Error(`synchronization is ${missingChangesets ? "missing changesets" : ""},` +
                 " startChangesetId should be" +
                 " exactly the first changeset *after* the previous synchronization to not miss data." +
                 ` You specified '${startChangesetIndexOrId}' which is changeset #${startChangesetIndex}` +
-                ` but the previous synchronization for this targetScopeElement was '${this.synchronizationVersion.id}'` +
-                ` which is changeset #${this.synchronizationVersion.index}. The transformer expected` +
-                ` #${this.synchronizationVersion.index + 1}.`);
+                ` but the previous synchronization for this targetScopeElem ${syncVersion.id}'` +
+                ` which is changeset #${syncVersion.index}. The transformer expected` +
+                ` #${syncVersion.index + 1}.`);
         }
         nodeAssert(this._targetScopeProvenanceProps, "_targetScopeProvenanceProps should be set by now");
-        const changesetsToSkip = this.isReverseSynchronization
+        const changesetsToSkip = (await this.getIsReverseSynchronization())
             ? this._targetScopeProvenanceProps.jsonProperties
                 .pendingReverseSyncChangesetIndices
             : this._targetScopeProvenanceProps.jsonProperties
@@ -2204,15 +2219,14 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
         await this.exporter.exportRelationships(core_backend_1.ElementRefersToElements.classFullName);
         if (this._options.forceExternalSourceAspectProvenance &&
             this.shouldDetectDeletes()) {
-            // eslint-disable-next-line @typescript-eslint/no-deprecated
-            await this.detectElementDeletes();
-            // eslint-disable-next-line @typescript-eslint/no-deprecated
-            await this.detectRelationshipDeletes();
+            core_bentley_1.Logger.logWarning(loggerCategory, "This workflows was deprecated in v1 and is no longer supported");
+            //   await this.detectElementDeletes();
+            //   await this.detectRelationshipDeletes();
         }
         if (this._options.optimizeGeometry)
             this.importer.optimizeGeometry(this._options.optimizeGeometry);
         this.importer.computeProjectExtents();
-        this.finalizeTransformation();
+        await this.finalizeTransformation();
     }
     /** previous provenance, either a federation guid, a `${sourceFedGuid}/${targetFedGuid}` pair, or required aspect props */
     _lastProvenanceEntityInfo = nullLastProvenanceEntityInfo;
@@ -2240,13 +2254,13 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
      */
     async processChanges(options) {
         // must wait for initialization of synchronization provenance data
-        await this.exporter.exportChanges(this.getExportInitOpts(options));
+        await this.exporter.exportChanges(await this.getExportInitOpts(options));
         await this.completePartiallyCommittedElements();
         await this.completePartiallyCommittedAspects();
         if (this._options.optimizeGeometry)
             this.importer.optimizeGeometry(this._options.optimizeGeometry);
         this.importer.computeProjectExtents();
-        this.finalizeTransformation();
+        await this.finalizeTransformation();
         const defaultSaveTargetChanges = () => {
             this.targetDb.saveChanges();
         };
@@ -2255,7 +2269,7 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
     /** Changeset data must be initialized in order to build correct changeOptions.
      * Call [[IModelTransformer.initialize]] for initialization of synchronization provenance data
      */
-    getExportInitOpts(opts) {
+    async getExportInitOpts(opts) {
         if (!this._options.argsForProcessChanges)
             return {};
         const startChangeset = "startChangeset" in opts ? opts.startChangeset : undefined;
@@ -2269,7 +2283,7 @@ class IModelTransformer extends IModelExporter_1.IModelExportHandler {
                         ? { startChangeset }
                         : {
                             startChangeset: {
-                                index: this.synchronizationVersion.index + 1,
+                                index: (await this.synchronizationVersion()).index + 1,
                             },
                         }),
         };
@@ -2389,18 +2403,16 @@ class TemplateModelCloner extends IModelTransformer {
 }
 exports.TemplateModelCloner = TemplateModelCloner;
 //Deprecate in preference of imodeldb.elements.getFederationGuidFromId()?
-function queryElemFedGuid(db, elemId) {
-    // eslint-disable-next-line @itwin/no-internal, @typescript-eslint/no-deprecated
-    return db.withPreparedStatement(`
+async function queryElemFedGuid(db, elemId) {
+    const sql = `
     SELECT FederationGuid
     FROM bis.Element
     WHERE ECInstanceId=?
-  `, (stmt) => {
-        stmt.bindId(1, elemId);
-        (0, core_bentley_1.assert)(stmt.step() === core_bentley_1.DbResult.BE_SQLITE_ROW);
-        const result = stmt.getValue(0).getGuid();
-        (0, core_bentley_1.assert)(stmt.step() === core_bentley_1.DbResult.BE_SQLITE_DONE);
-        return result;
-    });
+  `;
+    const params = new core_common_1.QueryBinder().bindId(1, elemId);
+    const reader = db.createQueryReader(sql, params);
+    (0, core_bentley_1.assert)(await reader.step(), "element not found");
+    const result = reader.current.federationGuid;
+    return result;
 }
 //# sourceMappingURL=IModelTransformer.js.map