@itwin/imodel-transformer 2.0.0-experimental.0 → 2.0.0-experimental.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/lib/cjs/IModelTransformer.d.ts.map +1 -1
- package/lib/cjs/IModelTransformer.js +1 -1
- package/lib/cjs/IModelTransformer.js.map +1 -1
- package/lib/cjs/ProvenanceManager.d.ts +5 -4
- package/lib/cjs/ProvenanceManager.d.ts.map +1 -1
- package/lib/cjs/ProvenanceManager.js +10 -10
- package/lib/cjs/ProvenanceManager.js.map +1 -1
- package/package.json +1 -1
|
@@ -178,14 +178,15 @@ export declare class ProvenanceManager {
|
|
|
178
178
|
* @internal
|
|
179
179
|
*/
|
|
180
180
|
export declare function queryTargetScopeElementIds(db: IModelDb): Promise<Set<Id64String>>;
|
|
181
|
-
/** Whether an aspect is transformer provenance:
|
|
182
|
-
*
|
|
181
|
+
/** Whether an aspect is transformer provenance: the Scope ExternalSourceAspect owned by `currentScopeElementId`, or an Element or Relationship ExternalSourceAspect scoped to one of `targetScopeElementIds`.
|
|
182
|
+
* Element and Relationship provenance of every target scope counts, not just the current one: an element shared by several target scopes, such as one source imported in parts, carries each scope's provenance.
|
|
183
|
+
* A Scope aspect on any other element counts only for the current scope. With `includeSourceProvenance`, a source that was itself a transformation target carries Scope aspects on ordinary elements, and they must follow the source.
|
|
183
184
|
* Cleanup never deletes transformer provenance.
|
|
184
185
|
* @internal
|
|
185
186
|
*/
|
|
186
|
-
export declare function isTransformerProvenanceAspect(aspect: ElementAspect, targetScopeElementIds: ReadonlySet<Id64String
|
|
187
|
+
export declare function isTransformerProvenanceAspect(aspect: ElementAspect, targetScopeElementIds: ReadonlySet<Id64String>, currentScopeElementId: Id64String): aspect is ExternalSourceAspect;
|
|
187
188
|
/** Returns the `importElementMultiAspects` filter for a transformation that includes source provenance.
|
|
188
|
-
*
|
|
189
|
+
* Element and Relationship provenance cloned from another transformation looks exactly like another target scope's provenance, so such an aspect is only eligible for reuse when an incoming ExternalSourceAspect has the same kind, scope, and identifier.
|
|
189
190
|
* The current scope's own provenance is never eligible: the transformer maintains it separately.
|
|
190
191
|
* @internal
|
|
191
192
|
*/
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ProvenanceManager.d.ts","sourceRoot":"","sources":["../../src/ProvenanceManager.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,UAAU,EAGX,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,OAAO,EACP,aAAa,EACb,kBAAkB,EAElB,KAAK,MAAM,EAEX,oBAAoB,EAGpB,QAAQ,EAET,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,yBAAyB,EAG1B,MAAM,oBAAoB,CAAC;AAG5B,OAAO,KAAK,EACV,sBAAsB,EAEvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAQvE,KAAK,iBAAiB,GAAG,IAAI,CAAC,sBAAsB,EAAE,qBAAqB,CAAC,GAAG;IAC7E,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;CAC7B,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAC7C,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAa;IACnD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAyB;IAC7D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAmB;IACrD,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAGzC;IAEF,6EAA6E;IAC7E,OAAO,CAAC,2BAA2B,CAIT;IAE1B,OAAO,CAAC,6BAA6B,CACzB;IAEZ,OAAO,CAAC,8BAA8B,CAA6B;IAEnE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAU;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAU;IAE1C,YACE,oBAAoB,EAAE,UAAU,EAChC,kBAAkB,EAAE,sBAAsB,EAC1C,OAAO,EAAE,iBAAiB,EAC1B,gBAAgB,EAAE,gBAAgB,EAClC,aAAa,EAAE,OAAO,EACtB,aAAa,CAAC,EAAE,OAAO,EA4BxB;YAEa,yBAAyB;YAIzB,iBAAiB;YAmCjB,yBAAyB;YAczB,cAAc;IA8B5B,iFAAiF;IACjF,WAAkB,wBAAwB,IAAI,CAAC,OAAO,MAAM,CAAC,EAAE,CAO9D;IAED,wFAAwF;IACxF,WAAkB,8BAA8B,IAAI,CAAC,OAAO,MAAM,CAAC,EAAE,CAEpE;IAID;;;;;OAKG;IACH,OAAoB,qBAAqB,CAAC,IAAI,EAAE;QAC9C,kBAAkB,EAAE,QAAQ,CAAC;QAC7B,YAAY,EAAE,QAAQ,CAAC;QACvB,oBAAoB,EAAE,UAAU,CAAC;QACjC,wBAAwB,EAAE,OAAO,CAAC;QAClC,EAAE,EAAE,CAAC,eAAe,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,KAAK,IAAI,CAAC;QACvE,kCAAkC,EAAE,OAAO,CAAC;KAC7C,GAAG,OAAO,CAAC,IAAI,CAAC,
|
|
1
|
+
{"version":3,"file":"ProvenanceManager.d.ts","sourceRoot":"","sources":["../../src/ProvenanceManager.ts"],"names":[],"mappings":"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"}
|
|
@@ -730,23 +730,24 @@ async function queryTargetScopeElementIds(db) {
|
|
|
730
730
|
ids.add(row.id);
|
|
731
731
|
return ids;
|
|
732
732
|
}
|
|
733
|
-
/** Whether an aspect is transformer provenance:
|
|
734
|
-
*
|
|
733
|
+
/** Whether an aspect is transformer provenance: the Scope ExternalSourceAspect owned by `currentScopeElementId`, or an Element or Relationship ExternalSourceAspect scoped to one of `targetScopeElementIds`.
|
|
734
|
+
* Element and Relationship provenance of every target scope counts, not just the current one: an element shared by several target scopes, such as one source imported in parts, carries each scope's provenance.
|
|
735
|
+
* A Scope aspect on any other element counts only for the current scope. With `includeSourceProvenance`, a source that was itself a transformation target carries Scope aspects on ordinary elements, and they must follow the source.
|
|
735
736
|
* Cleanup never deletes transformer provenance.
|
|
736
737
|
* @internal
|
|
737
738
|
*/
|
|
738
|
-
function isTransformerProvenanceAspect(aspect, targetScopeElementIds) {
|
|
739
|
+
function isTransformerProvenanceAspect(aspect, targetScopeElementIds, currentScopeElementId) {
|
|
739
740
|
if (!(aspect instanceof core_backend_1.ExternalSourceAspect))
|
|
740
741
|
return false;
|
|
741
742
|
if (aspect.kind === core_backend_1.ExternalSourceAspect.Kind.Scope)
|
|
742
|
-
return
|
|
743
|
+
return aspect.element.id === currentScopeElementId;
|
|
743
744
|
return ((aspect.kind === core_backend_1.ExternalSourceAspect.Kind.Element ||
|
|
744
745
|
aspect.kind === core_backend_1.ExternalSourceAspect.Kind.Relationship) &&
|
|
745
746
|
aspect.scope !== undefined &&
|
|
746
747
|
targetScopeElementIds.has(aspect.scope.id));
|
|
747
748
|
}
|
|
748
749
|
/** Returns the `importElementMultiAspects` filter for a transformation that includes source provenance.
|
|
749
|
-
*
|
|
750
|
+
* Element and Relationship provenance cloned from another transformation looks exactly like another target scope's provenance, so such an aspect is only eligible for reuse when an incoming ExternalSourceAspect has the same kind, scope, and identifier.
|
|
750
751
|
* The current scope's own provenance is never eligible: the transformer maintains it separately.
|
|
751
752
|
* @internal
|
|
752
753
|
*/
|
|
@@ -755,12 +756,11 @@ function sourceProvenanceMatchFilter(incoming, targetScopeElementIds, currentSco
|
|
|
755
756
|
.filter((props) => (0, ElementAspectCleanup_1.isSameClass)(props, core_backend_1.ExternalSourceAspect.classFullName))
|
|
756
757
|
.map((props) => externalSourceAspectKey(props)));
|
|
757
758
|
return (aspect) => {
|
|
758
|
-
if (!isTransformerProvenanceAspect(aspect, targetScopeElementIds))
|
|
759
|
+
if (!isTransformerProvenanceAspect(aspect, targetScopeElementIds, currentScopeElementId))
|
|
759
760
|
return true;
|
|
760
|
-
|
|
761
|
-
|
|
762
|
-
|
|
763
|
-
return (scopeElementId !== currentScopeElementId &&
|
|
761
|
+
// The current scope's Scope aspect is the only Scope aspect that counts as provenance.
|
|
762
|
+
return (aspect.kind !== core_backend_1.ExternalSourceAspect.Kind.Scope &&
|
|
763
|
+
aspect.scope?.id !== currentScopeElementId &&
|
|
764
764
|
incomingKeys.has(externalSourceAspectKey(aspect)));
|
|
765
765
|
};
|
|
766
766
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ProvenanceManager.js","sourceRoot":"","sources":["../../src/ProvenanceManager.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 GuidString,\n Id64String,\n ITwinError,\n Logger,\n} from \"@itwin/core-bentley\";\nimport {\n EditTxn,\n ElementAspect,\n ElementMultiAspect,\n ElementOwnsExternalSourceAspects,\n type Entity,\n ExternalSource,\n ExternalSourceAspect,\n ExternalSourceAttachment,\n FolderLink,\n IModelDb,\n SynchronizationConfigLink,\n} from \"@itwin/core-backend\";\nimport {\n ChangesetIndexAndId,\n ElementAspectProps,\n ExternalSourceAspectProps,\n IModel,\n QueryBinder,\n} from \"@itwin/core-common\";\nimport { isSameClass } from \"./ElementAspectCleanup\";\nimport { TransformerLoggerCategory } from \"./TransformerLoggerCategory\";\nimport type {\n IModelTransformOptions,\n TargetScopeProvenanceJsonProps,\n} from \"./IModelTransformer\";\nimport type { SyncTypeResolver } from \"./SyncTypeResolver\";\nimport type { IModelTransformContext } from \"./IModelTransformContext\";\nimport {\n IModelTransformerError,\n IModelTransformerErrorScope,\n} from \"./IModelTransformerError\";\n\nconst loggerCategory: string = TransformerLoggerCategory.IModelTransformer;\n\ntype ProvenanceContext = Pick<IModelTransformContext, \"findTargetElementId\"> & {\n readonly sourceDb: IModelDb;\n readonly targetDb: IModelDb;\n};\n\n/**\n * Manages provenance scope aspects and synchronization versioning.\n * Encapsulates all ESA scope management, sync version tracking, and\n * provenance DB direction logic extracted from IModelTransformer.\n * @internal\n */\nexport class ProvenanceManager {\n private readonly _context: ProvenanceContext;\n private readonly _targetScopeElementId: Id64String;\n private readonly _transformerOptions: IModelTransformOptions;\n private readonly _syncTypeResolver: SyncTypeResolver;\n private readonly _startingChangesetIndices?: {\n target: number;\n source: number;\n };\n\n /** NOTE: the json properties must be converted to string before insertion */\n private _targetScopeProvenanceProps:\n | (Omit<ExternalSourceAspectProps, \"jsonProperties\"> & {\n jsonProperties: TargetScopeProvenanceJsonProps;\n })\n | undefined = undefined;\n\n private _cachedSynchronizationVersion: ChangesetIndexAndId | undefined =\n undefined;\n\n private _targetClassNameToClassIdCache = new Map<string, string>();\n\n private readonly _targetEditTxn: EditTxn;\n private readonly _sourceEditTxn?: EditTxn;\n\n public constructor(\n targetScopeElementId: Id64String,\n transformerOptions: IModelTransformOptions,\n context: ProvenanceContext,\n syncTypeResolver: SyncTypeResolver,\n targetEditTxn: EditTxn,\n sourceEditTxn?: EditTxn\n ) {\n this._targetScopeElementId = targetScopeElementId;\n this._transformerOptions = transformerOptions;\n this._context = context;\n this._syncTypeResolver = syncTypeResolver;\n this._targetEditTxn = targetEditTxn;\n this._sourceEditTxn = sourceEditTxn;\n\n const sourceDb = this._context.sourceDb;\n const targetDb = this._context.targetDb;\n if (sourceDb.isBriefcase && targetDb.isBriefcase) {\n if (\n sourceDb.changeset.index === undefined ||\n targetDb.changeset.index === undefined\n )\n ITwinError.throwError({\n iTwinErrorId: {\n scope: IModelTransformerErrorScope,\n key: IModelTransformerError.ChangesetIndexUnavailable,\n },\n message: \"database has no changeset index\",\n });\n this._startingChangesetIndices = {\n target: targetDb.changeset.index,\n source: sourceDb.changeset.index,\n };\n }\n }\n\n private async _isReverseSynchronization(): Promise<boolean> {\n return (await this._syncTypeResolver.getSyncType()) === \"reverse\";\n }\n\n private async _queryTargetRelId(sourceRelInfo: {\n classFullName: string;\n sourceId: Id64String;\n targetId: Id64String;\n }): Promise<Id64String | undefined> {\n const targetRelInfo = {\n sourceId: this._context.findTargetElementId(sourceRelInfo.sourceId),\n targetId: this._context.findTargetElementId(sourceRelInfo.targetId),\n };\n if (\n targetRelInfo.sourceId === undefined ||\n targetRelInfo.targetId === undefined\n )\n return undefined;\n const sql = `\n select ecinstanceid\n from bis.elementreferstoelements\n where sourceecinstanceid=?\n and targetecinstanceid=?\n and ecclassid=?\n `;\n const params = new QueryBinder();\n params.bindId(1, targetRelInfo.sourceId);\n params.bindId(2, targetRelInfo.targetId);\n params.bindId(\n 3,\n await this._targetClassNameToClassId(sourceRelInfo.classFullName)\n );\n const result = this._context.targetDb.createQueryReader(sql, params, {\n usePrimaryConn: true,\n });\n if (await result.step()) return result.current.id;\n else return undefined;\n }\n\n private async _targetClassNameToClassId(\n classFullName: string\n ): Promise<Id64String> {\n let classId = this._targetClassNameToClassIdCache.get(classFullName);\n if (classId === undefined) {\n classId = await this._getRelClassId(\n this._context.targetDb,\n classFullName\n );\n this._targetClassNameToClassIdCache.set(classFullName, classId);\n }\n return classId;\n }\n\n private async _getRelClassId(\n db: IModelDb,\n classFullName: string\n ): Promise<Id64String> {\n const sql = `\n SELECT c.ECInstanceId\n FROM ECDbMeta.ECClassDef c\n JOIN ECDbMeta.ECSchemaDef s ON c.Schema.Id=s.ECInstanceId\n WHERE s.Name=? AND c.Name=?\n `;\n const [schemaName, className] =\n classFullName.indexOf(\".\") !== -1\n ? classFullName.split(\".\")\n : classFullName.split(\":\");\n const params = new QueryBinder();\n params.bindString(1, schemaName);\n params.bindString(2, className);\n const result = db.createQueryReader(sql, params, { usePrimaryConn: true });\n if (await result.step()) return result.current.id;\n ITwinError.throwError({\n iTwinErrorId: {\n scope: IModelTransformerErrorScope,\n key: IModelTransformerError.RelationshipClassNotFound,\n },\n message: `Could not find class ${classFullName} in the db`,\n });\n }\n\n // ── Static provenance metadata ──────────────────────────────────────────\n\n /** The element classes that are considered to define provenance in the iModel */\n public static get provenanceElementClasses(): (typeof Entity)[] {\n return [\n FolderLink,\n SynchronizationConfigLink,\n ExternalSource,\n ExternalSourceAttachment,\n ];\n }\n\n /** The element aspect classes that are considered to define provenance in the iModel */\n public static get provenanceElementAspectClasses(): (typeof Entity)[] {\n return [ExternalSourceAspect];\n }\n\n // ── Static provenance queries ──────────────────────────────────────────\n\n /**\n * Iterate all matching federation guids and ExternalSourceAspects in the provenance iModel (target unless reverse sync)\n * and call a function for each one.\n * @note provenance is done by federation guids where possible\n * @note this may execute on each element more than once! Only use in cases where that is handled\n */\n public static async forEachTrackedElement(args: {\n provenanceSourceDb: IModelDb;\n provenanceDb: IModelDb;\n targetScopeElementId: Id64String;\n isReverseSynchronization: boolean;\n fn: (sourceElementId: Id64String, targetElementId: Id64String) => void;\n skipPropagateChangesToRootElements: boolean;\n }): Promise<void> {\n if (args.provenanceDb === args.provenanceSourceDb) return;\n\n if (!args.provenanceDb.containsClass(ExternalSourceAspect.classFullName)) {\n ITwinError.throwError({\n iTwinErrorId: {\n scope: IModelTransformerErrorScope,\n key: IModelTransformerError.ProvenanceSchemaUnsupported,\n },\n message: \"The BisCore schema version of the target database is too old\",\n });\n }\n\n const sourceDb = args.isReverseSynchronization\n ? args.provenanceDb\n : args.provenanceSourceDb;\n const targetDb = args.isReverseSynchronization\n ? args.provenanceSourceDb\n : args.provenanceDb;\n\n // query for provenanceDb\n const elementIdByFedGuidQuery = `\n SELECT e.ECInstanceId, FederationGuid\n FROM bis.Element e\n ${\n args.skipPropagateChangesToRootElements\n ? \"WHERE e.ECInstanceId NOT IN (0x1, 0xe, 0x10) -- special static elements\"\n : \"\"\n }\n ORDER BY FederationGuid\n `;\n\n // iterate through sorted list of fed guids from both dbs to get the intersection\n // NOTE: if we exposed the native attach database support,\n // we could get the intersection of fed guids in one query, not sure if it would be faster\n // OR we could do a raw sqlite query...\n\n const sourceReader = sourceDb.createQueryReader(\n elementIdByFedGuidQuery,\n undefined,\n { usePrimaryConn: true }\n );\n const targetReader = targetDb.createQueryReader(\n elementIdByFedGuidQuery,\n undefined,\n { usePrimaryConn: true }\n );\n let hasSourceRow = await sourceReader.step();\n let hasTargetRow = await targetReader.step();\n while (hasSourceRow && hasTargetRow) {\n const sourceFedGuid = sourceReader.current.federationGuid as\n | GuidString\n | undefined;\n const targetFedGuid = targetReader.current.federationGuid as\n | GuidString\n | undefined;\n if (\n sourceFedGuid !== undefined &&\n targetFedGuid !== undefined &&\n sourceFedGuid === targetFedGuid\n ) {\n // data flow direction is always sourceDb -> targetDb and it does not depend on where the explicit element provenance is stored\n args.fn(\n sourceReader.current.id as Id64String,\n targetReader.current.id as Id64String\n );\n }\n if (\n targetFedGuid === undefined ||\n (sourceFedGuid !== undefined && sourceFedGuid >= targetFedGuid)\n ) {\n hasTargetRow = await targetReader.step();\n }\n if (\n sourceFedGuid === undefined ||\n (targetFedGuid !== undefined && sourceFedGuid <= targetFedGuid)\n ) {\n hasSourceRow = await sourceReader.step();\n }\n }\n\n // query for provenanceDb\n const provenanceAspectsQuery = `\n SELECT esa.Identifier, Element.Id\n FROM bis.ExternalSourceAspect esa\n WHERE Scope.Id=:scopeId\n AND Kind=:kind\n ORDER BY esa.Identifier, esa.ECInstanceId DESC\n `;\n\n // Technically this will a second time call the function (as documented) on\n // victims of the old provenance method that have both fedguids and an inserted aspect.\n // But this is a private function with one known caller where that doesn't matter\n\n const runFnInDataFlowDirection = (\n sourceId: Id64String,\n targetId: Id64String\n ) =>\n args.isReverseSynchronization\n ? args.fn(sourceId, targetId)\n : args.fn(targetId, sourceId);\n const params = new QueryBinder();\n params.bindId(\"scopeId\", args.targetScopeElementId);\n params.bindString(\"kind\", ExternalSourceAspect.Kind.Element);\n const provenanceReader = args.provenanceDb.createQueryReader(\n provenanceAspectsQuery,\n params,\n { usePrimaryConn: true }\n );\n for await (const row of provenanceReader) {\n // ExternalSourceAspect.Identifier is of type string\n const aspectIdentifier: Id64String = row[0];\n const elementId: Id64String = row.id;\n runFnInDataFlowDirection(elementId, aspectIdentifier);\n }\n }\n\n /**\n * Queries for an ESA which matches the props in the provided aspectProps.\n * @param dbToQuery db to run the query on\n * @param aspectProps aspectProps to search for\n */\n public static async queryScopeExternalSourceAspect(\n dbToQuery: IModelDb,\n aspectProps: ExternalSourceAspectProps\n ): Promise<\n | {\n aspectId: Id64String;\n version?: string;\n /** stringified json */\n jsonProperties?: string;\n }\n | undefined\n > {\n const sql = `\n SELECT ECInstanceId, Version, JsonProperties\n FROM ${ExternalSourceAspect.classFullName}\n WHERE Element.Id=:elementId\n AND Scope.Id=:scopeId\n AND Kind=:kind\n AND Identifier=:identifier\n LIMIT 1\n `;\n\n if (aspectProps.scope === undefined) return undefined;\n\n const params = new QueryBinder()\n .bindId(\"elementId\", aspectProps.element.id)\n .bindId(\"scopeId\", aspectProps.scope.id)\n .bindString(\"kind\", aspectProps.kind)\n .bindString(\"identifier\", aspectProps.identifier);\n\n return dbToQuery.withQueryReader(\n sql,\n (reader) => {\n if (!reader.step()) return undefined;\n const aspectId = reader.current[0] as Id64String;\n const version = reader.current[1] as string | undefined;\n const jsonProperties = reader.current[2] as string | undefined;\n return { aspectId, version, jsonProperties };\n },\n params\n );\n }\n\n // ── Provenance DB direction ────────────────────────────────────────────\n\n /** Return the IModelDb where provenance is stored (for reads/queries).\n * This will be targetDb except when it is a reverse synchronization, in which case it will be sourceDb.\n */\n private async getProvenanceDb(): Promise<IModelDb> {\n return (await this._isReverseSynchronization())\n ? this._context.sourceDb\n : this._context.targetDb;\n }\n\n /** Return the EditTxn for writing provenance.\n * This will be targetEditTxn except when it is a reverse synchronization, in which case it will be sourceEditTxn.\n */\n public async getProvenanceEditTxn(): Promise<EditTxn> {\n if (await this._isReverseSynchronization()) {\n if (!this._sourceEditTxn) {\n ITwinError.throwError({\n iTwinErrorId: {\n scope: IModelTransformerErrorScope,\n key: IModelTransformerError.SourceEditTxnRequired,\n },\n message:\n \"A reverse synchronization requires a sourceEditTxn to write provenance back to the source iModel. \" +\n \"Pass sourceEditTxn in IModelTransformOptions.\",\n });\n }\n return this._sourceEditTxn;\n }\n return this._targetEditTxn;\n }\n\n /** Return the IModelDb where entities referred to by stored provenance live.\n * This will be sourceDb except when it is a reverse synchronization, in which case it will be targetDb.\n */\n public async getProvenanceSourceDb(): Promise<IModelDb> {\n return (await this._isReverseSynchronization())\n ? this._context.targetDb\n : this._context.sourceDb;\n }\n\n // ── Scope aspect management ────────────────────────────────────────────\n\n /**\n * @returns provenance scope aspect if it exists in the provenanceDb.\n * Provenance scope aspect is created and inserted into provenanceDb when [[initScopeProvenance]] is invoked.\n */\n public async tryGetProvenanceScopeAspect(): Promise<\n ExternalSourceAspect | undefined\n > {\n const scopeProvenanceAspectProps =\n await ProvenanceManager.queryScopeExternalSourceAspect(\n await this.getProvenanceDb(),\n {\n id: undefined,\n classFullName: ExternalSourceAspect.classFullName,\n scope: { id: IModel.rootSubjectId },\n kind: ExternalSourceAspect.Kind.Scope,\n element: {\n id: this._targetScopeElementId ?? IModel.rootSubjectId,\n },\n identifier: (await this.getProvenanceSourceDb()).iModelId,\n }\n );\n\n return scopeProvenanceAspectProps !== undefined\n ? ((await this.getProvenanceDb()).elements.getAspect(\n scopeProvenanceAspectProps.aspectId\n ) as ExternalSourceAspect)\n : undefined;\n }\n\n /**\n * Make sure there are no conflicting other scope-type external source aspects on the target scope element.\n * If there are none at all, insert one (this must be a first synchronization).\n */\n public async initScopeProvenance(): Promise<void> {\n const provenanceDb = await this.getProvenanceDb();\n const provenanceEditTxn = await this.getProvenanceEditTxn();\n const sourceProvenanceDb = await this.getProvenanceSourceDb();\n const aspectProps = {\n id: undefined as string | undefined,\n version: undefined as string | undefined,\n classFullName: ExternalSourceAspect.classFullName,\n element: {\n id: this._targetScopeElementId,\n relClassName: ElementOwnsExternalSourceAspects.classFullName,\n },\n scope: { id: IModel.rootSubjectId },\n identifier: sourceProvenanceDb.iModelId,\n kind: ExternalSourceAspect.Kind.Scope,\n jsonProperties: undefined as TargetScopeProvenanceJsonProps | undefined,\n };\n\n const foundEsaProps =\n await ProvenanceManager.queryScopeExternalSourceAspect(\n provenanceDb,\n aspectProps\n );\n\n if (foundEsaProps === undefined) {\n aspectProps.version = \"\";\n aspectProps.jsonProperties = {\n pendingReverseSyncChangesetIndices: [],\n pendingSyncChangesetIndices: [],\n reverseSyncVersion: \"\",\n };\n\n // query without \"identifier\" to find possible conflicts\n const sql = `\n SELECT ECInstanceId\n FROM ${ExternalSourceAspect.classFullName}\n WHERE Element.Id=:elementId\n AND Scope.Id=:scopeId\n AND Kind=:kind\n LIMIT 1\n `;\n\n const params = new QueryBinder();\n params.bindId(\"elementId\", aspectProps.element.id);\n params.bindId(\"scopeId\", aspectProps.scope.id);\n params.bindString(\"kind\", aspectProps.kind);\n const reader = provenanceDb.createQueryReader(sql, params, {\n usePrimaryConn: true,\n });\n const hasConflictingScope = await reader.step();\n\n if (hasConflictingScope) {\n ITwinError.throwError({\n iTwinErrorId: {\n scope: IModelTransformerErrorScope,\n key: IModelTransformerError.ProvenanceScopeConflict,\n },\n message: \"Provenance scope conflict\",\n });\n }\n if (!this._transformerOptions.noProvenance) {\n const id = provenanceEditTxn.insertAspect({\n ...aspectProps,\n jsonProperties: JSON.stringify(aspectProps.jsonProperties) as any,\n });\n aspectProps.id = id;\n this.clearCachedSynchronizationVersion();\n }\n } else {\n aspectProps.id = foundEsaProps.aspectId;\n aspectProps.version = foundEsaProps.version;\n aspectProps.jsonProperties = foundEsaProps.jsonProperties\n ? JSON.parse(foundEsaProps.jsonProperties)\n : undefined;\n const oldProps = JSON.parse(JSON.stringify(aspectProps));\n if (this.handleUnsafeMigrate(aspectProps)) {\n Logger.logInfo(\n loggerCategory,\n \"Unsafe migrate made a change to the target scope's external source aspect. Updating aspect in database.\",\n { oldProps, newProps: aspectProps }\n );\n provenanceEditTxn.updateAspect({\n ...aspectProps,\n jsonProperties: JSON.stringify(aspectProps.jsonProperties) as any,\n });\n this.clearCachedSynchronizationVersion();\n }\n }\n\n this._targetScopeProvenanceProps =\n aspectProps as typeof this._targetScopeProvenanceProps;\n }\n\n /** Returns true if a change was made to the aspectProps. */\n private handleUnsafeMigrate(aspectProps: {\n version?: string;\n jsonProperties?: TargetScopeProvenanceJsonProps;\n }): boolean {\n let madeChange = false;\n if (\n this._transformerOptions.branchRelationshipDataBehavior !==\n \"unsafe-migrate\"\n )\n return madeChange;\n const fallbackSyncVersionToUse =\n this._transformerOptions.argsForProcessChanges\n ?.unsafeFallbackSyncVersion ?? \"\";\n const fallbackReverseSyncVersionToUse =\n this._transformerOptions.argsForProcessChanges\n ?.unsafeFallbackReverseSyncVersion ?? \"\";\n\n if (\n aspectProps.version === undefined ||\n (aspectProps.version === \"\" &&\n aspectProps.version !== fallbackSyncVersionToUse)\n ) {\n aspectProps.version = fallbackSyncVersionToUse;\n madeChange = true;\n }\n\n if (aspectProps.jsonProperties === undefined) {\n aspectProps.jsonProperties = {\n pendingReverseSyncChangesetIndices: [],\n pendingSyncChangesetIndices: [],\n reverseSyncVersion: fallbackReverseSyncVersionToUse,\n };\n madeChange = true;\n } else if (\n aspectProps.jsonProperties.reverseSyncVersion === undefined ||\n (aspectProps.jsonProperties.reverseSyncVersion === \"\" &&\n aspectProps.jsonProperties.reverseSyncVersion !==\n fallbackReverseSyncVersionToUse)\n ) {\n aspectProps.jsonProperties.reverseSyncVersion =\n fallbackReverseSyncVersionToUse;\n madeChange = true;\n }\n\n if (\n aspectProps.jsonProperties.pendingReverseSyncChangesetIndices ===\n undefined\n ) {\n Logger.logWarning(\n loggerCategory,\n \"Property pendingReverseSyncChangesetIndices missing on the jsonProperties of the scoping ESA. Setting to [].\"\n );\n aspectProps.jsonProperties.pendingReverseSyncChangesetIndices = [];\n madeChange = true;\n }\n if (aspectProps.jsonProperties.pendingSyncChangesetIndices === undefined) {\n Logger.logWarning(\n loggerCategory,\n \"Property pendingSyncChangesetIndices missing on the jsonProperties of the scoping ESA. Setting to [].\"\n );\n aspectProps.jsonProperties.pendingSyncChangesetIndices = [];\n madeChange = true;\n }\n return madeChange;\n }\n\n // ── Synchronization version ────────────────────────────────────────────\n\n /**\n * We cache the synchronization version to avoid querying the target scoping ESA multiple times.\n * Clears the cached value so the next call to getSynchronizationVersion re-queries.\n */\n public clearCachedSynchronizationVersion() {\n this._cachedSynchronizationVersion = undefined;\n }\n\n /** The changeset version in the scoping element's source version found for this transformation.\n * @note the version depends on whether this is a reverse synchronization or not.\n * @note empty string and -1 for changeset and index if it has never been transformed.\n */\n public async getSynchronizationVersion(): Promise<ChangesetIndexAndId> {\n if (this._cachedSynchronizationVersion === undefined) {\n const provenanceScopeAspect = await this.tryGetProvenanceScopeAspect();\n if (!provenanceScopeAspect) {\n return { index: -1, id: \"\" };\n }\n\n const version = (await this._isReverseSynchronization())\n ? (\n JSON.parse(\n provenanceScopeAspect.jsonProperties ?? \"{}\"\n ) as TargetScopeProvenanceJsonProps\n ).reverseSyncVersion\n : provenanceScopeAspect.version;\n if (\n !version &&\n this._transformerOptions.branchRelationshipDataBehavior ===\n \"unsafe-migrate\"\n ) {\n return { index: -1, id: \"\" };\n }\n if (version === undefined) {\n ITwinError.throwError({\n iTwinErrorId: {\n scope: IModelTransformerErrorScope,\n key: IModelTransformerError.SynchronizationVersionMissing,\n },\n message: `Could not find synchronization version in scope aspect. This may be due to the last successful run of the transformer being done with an older version.\n Consider running the transformer with branchRelationshipDataBehavior set to 'unsafe-migrate'`,\n });\n }\n const [id, index] = version === \"\" ? [\"\", -1] : version.split(\";\");\n if (Number.isNaN(Number(index)))\n throw new Error(\"Could not parse version data from scope aspect\");\n this._cachedSynchronizationVersion = { index: Number(index), id };\n }\n return this._cachedSynchronizationVersion;\n }\n\n /**\n * Returns the pending changeset indices to skip for the current synchronization direction.\n * Used by changeset initialization to determine which changesets have already been processed.\n */\n public async getChangesetsToSkip(): Promise<number[]> {\n if (this._targetScopeProvenanceProps === undefined)\n throw new Error(\"_targetScopeProvenanceProps should be set by now\");\n const props = this._targetScopeProvenanceProps;\n return (await this._isReverseSynchronization())\n ? props.jsonProperties.pendingReverseSyncChangesetIndices\n : props.jsonProperties.pendingSyncChangesetIndices;\n }\n\n /**\n * Updates the synchronization version on the scope ESA.\n *\n * Called at the end of a transformation, updates the target scope element to record\n * that transformation up through the source's changeset has been performed. Also stores\n * all changesets that occurred during the transformation as \"pending synchronization\n * changeset indices\" @see TargetScopeProvenanceJsonProps\n *\n * @param initializeReverseSyncVersion When true, saves the reverse sync version as the\n * current changeset of the targetDb. This is typically used for the first transformation\n * between a master and branch iModel. Setting this to true has the effect of making it so\n * any changesets in the branch iModel at the time of the first transformation will be\n * ignored during any future reverse synchronizations from the branch to the master iModel.\n *\n * Note that typically, the reverseSyncVersion is saved as the last changeset merged from\n * the branch into master. Setting initializeReverseSyncVersion to true during a forward\n * transformation could overwrite this correct reverseSyncVersion and should only be done\n * during the first transformation between a master and branch iModel.\n *\n * @param sourceChangeDataState The current state of change data — used to skip updates\n * when there are no changes.\n */\n public async updateSynchronizationVersion({\n initializeReverseSyncVersion = false,\n sourceChangeDataState,\n }: {\n initializeReverseSyncVersion?: boolean;\n sourceChangeDataState:\n | \"uninited\"\n | \"has-changes\"\n | \"no-changes\"\n | \"unconnected\";\n }) {\n const shouldSkipSyncVersionUpdate =\n !initializeReverseSyncVersion && sourceChangeDataState !== \"has-changes\";\n if (shouldSkipSyncVersionUpdate) return;\n\n // If noProvenance is set, there's no scope ESA to update\n if (this._transformerOptions.noProvenance) return;\n\n if (this._targetScopeProvenanceProps === undefined)\n throw new Error(\"_targetScopeProvenanceProps should be set by now\");\n const scopeProps = this._targetScopeProvenanceProps;\n\n const sourceVersion = `${this._context.sourceDb.changeset.id};${this._context.sourceDb.changeset.index}`;\n const targetVersion = `${this._context.targetDb.changeset.id};${this._context.targetDb.changeset.index}`;\n\n if (await this._isReverseSynchronization()) {\n const oldVersion = scopeProps.jsonProperties.reverseSyncVersion;\n\n Logger.logInfo(\n loggerCategory,\n `updating reverse version from ${oldVersion} to ${sourceVersion}`\n );\n scopeProps.jsonProperties.reverseSyncVersion = sourceVersion;\n } else {\n Logger.logInfo(\n loggerCategory,\n `updating sync version from ${scopeProps.version} to ${sourceVersion}`\n );\n scopeProps.version = sourceVersion;\n\n if (initializeReverseSyncVersion) {\n Logger.logInfo(\n loggerCategory,\n `updating reverse sync version from ${scopeProps.jsonProperties.reverseSyncVersion} to ${targetVersion}`\n );\n scopeProps.jsonProperties.reverseSyncVersion = targetVersion;\n }\n }\n\n const startingChangesetIndices = this._startingChangesetIndices;\n if (\n !!this._transformerOptions.argsForProcessChanges ||\n (startingChangesetIndices && initializeReverseSyncVersion)\n ) {\n if (\n this._context.targetDb.changeset.index === undefined ||\n startingChangesetIndices === undefined\n )\n throw new Error(\n \"updateSynchronizationVersion was called without change history\"\n );\n\n const jsonProps = scopeProps.jsonProperties;\n\n Logger.logTrace(\n loggerCategory,\n `previous pendingReverseSyncChanges: ${String(jsonProps.pendingReverseSyncChangesetIndices)}`\n );\n Logger.logTrace(\n loggerCategory,\n `previous pendingSyncChanges: ${String(jsonProps.pendingSyncChangesetIndices)}`\n );\n\n const pendingSyncChangesetIndicesKey =\n \"pendingSyncChangesetIndices\" as const;\n const pendingReverseSyncChangesetIndicesKey =\n \"pendingReverseSyncChangesetIndices\" as const;\n\n let syncChangesetsToClearKey;\n let syncChangesetsToUpdateKey;\n\n if (await this._isReverseSynchronization()) {\n syncChangesetsToClearKey = pendingReverseSyncChangesetIndicesKey;\n syncChangesetsToUpdateKey = pendingSyncChangesetIndicesKey;\n } else {\n syncChangesetsToClearKey = pendingSyncChangesetIndicesKey;\n syncChangesetsToUpdateKey = pendingReverseSyncChangesetIndicesKey;\n }\n\n for (\n let i = startingChangesetIndices.target + 1;\n i <= this._context.targetDb.changeset.index + 1;\n i++\n )\n jsonProps[syncChangesetsToUpdateKey].push(i);\n jsonProps[syncChangesetsToClearKey] = jsonProps[\n syncChangesetsToClearKey\n ].filter((csIndex) => {\n return csIndex > startingChangesetIndices.source;\n });\n\n if (await this._isReverseSynchronization()) {\n if (this._context.sourceDb.changeset.index === undefined)\n throw new Error(\"changeset didn't exist\");\n for (\n let i = startingChangesetIndices.source + 1;\n i <= this._context.sourceDb.changeset.index + 1;\n i++\n )\n jsonProps.pendingReverseSyncChangesetIndices.push(i);\n }\n\n Logger.logTrace(\n loggerCategory,\n `new pendingReverseSyncChanges: ${String(jsonProps.pendingReverseSyncChangesetIndices)}`\n );\n Logger.logTrace(\n loggerCategory,\n `new pendingSyncChanges: ${String(jsonProps.pendingSyncChangesetIndices)}`\n );\n }\n\n (await this.getProvenanceEditTxn()).updateAspect({\n ...scopeProps,\n jsonProperties: JSON.stringify(scopeProps.jsonProperties) as any,\n });\n this.clearCachedSynchronizationVersion();\n }\n\n // ── Element/Relationship provenance creation ───────────────────────────\n\n /** Create ExternalSourceAspectProps for an element in an iModel → iModel transformation. */\n public static initElementProvenanceOptions(\n sourceElementId: Id64String,\n targetElementId: Id64String,\n args: {\n sourceDb: IModelDb;\n targetDb: IModelDb;\n isReverseSynchronization: boolean;\n targetScopeElementId: Id64String;\n }\n ): ExternalSourceAspectProps {\n const elementId = args.isReverseSynchronization\n ? sourceElementId\n : targetElementId;\n const version = args.isReverseSynchronization\n ? args.targetDb.elements.queryLastModifiedTime(targetElementId)\n : args.sourceDb.elements.queryLastModifiedTime(sourceElementId);\n const aspectIdentifier = args.isReverseSynchronization\n ? targetElementId\n : sourceElementId;\n const aspectProps: ExternalSourceAspectProps = {\n classFullName: ExternalSourceAspect.classFullName,\n element: {\n id: elementId,\n relClassName: ElementOwnsExternalSourceAspects.classFullName,\n },\n scope: { id: args.targetScopeElementId },\n identifier: aspectIdentifier,\n kind: ExternalSourceAspect.Kind.Element,\n version,\n };\n return aspectProps;\n }\n\n /** Create ExternalSourceAspectProps for a relationship in an iModel → iModel transformation. */\n public static async initRelationshipProvenanceOptions(\n sourceRelInstanceId: Id64String,\n targetRelInstanceId: Id64String,\n args: {\n sourceDb: IModelDb;\n targetDb: IModelDb;\n isReverseSynchronization: boolean;\n targetScopeElementId: Id64String;\n forceOldRelationshipProvenanceMethod: boolean;\n /** Already-known source-endpoint element ids of the relationships, used to skip the\n * per-relationship endpoint query when the caller knows the needed id.\n */\n knownEndpoints?: {\n /** `SourceECInstanceId` of the relationship identified by `sourceRelInstanceId` in `sourceDb`. */\n sourceRelSourceElementId?: Id64String;\n /** `SourceECInstanceId` of the relationship identified by `targetRelInstanceId` in `targetDb`. */\n targetRelSourceElementId?: Id64String;\n };\n }\n ): Promise<ExternalSourceAspectProps> {\n const provenanceDb = args.isReverseSynchronization\n ? args.sourceDb\n : args.targetDb;\n const aspectIdentifier = args.isReverseSynchronization\n ? targetRelInstanceId\n : sourceRelInstanceId;\n const provenanceRelInstanceId = args.isReverseSynchronization\n ? sourceRelInstanceId\n : targetRelInstanceId;\n\n // the provenance relationship lives in the provenanceDb, so its known source-endpoint id is\n // the source rel's on reverse synchronization and the target rel's otherwise\n let elementId = args.isReverseSynchronization\n ? args.knownEndpoints?.sourceRelSourceElementId\n : args.knownEndpoints?.targetRelSourceElementId;\n if (undefined === elementId) {\n const sql =\n \"SELECT SourceECInstanceId FROM bis.ElementRefersToElements WHERE ECInstanceId=?\";\n const params = new QueryBinder().bindId(1, provenanceRelInstanceId);\n const reader = provenanceDb.createQueryReader(sql, params, {\n usePrimaryConn: true,\n });\n if (!(await reader.step()))\n ITwinError.throwError({\n iTwinErrorId: {\n scope: IModelTransformerErrorScope,\n key: IModelTransformerError.RelationshipProvenanceNotFound,\n },\n message: \"relationship provenance query returned no rows\",\n });\n elementId = reader.current[0] as Id64String;\n }\n\n const jsonProperties = args.forceOldRelationshipProvenanceMethod\n ? { targetRelInstanceId }\n : { provenanceRelInstanceId };\n\n const aspectProps: ExternalSourceAspectProps = {\n classFullName: ExternalSourceAspect.classFullName,\n element: {\n id: elementId,\n relClassName: ElementOwnsExternalSourceAspects.classFullName,\n },\n scope: { id: args.targetScopeElementId },\n identifier: aspectIdentifier,\n kind: ExternalSourceAspect.Kind.Relationship,\n jsonProperties: JSON.stringify(jsonProperties),\n };\n\n return aspectProps;\n }\n\n /** Create an ExternalSourceAspectProps for an element using this manager's context. */\n public async initElementProvenance(\n sourceElementId: Id64String,\n targetElementId: Id64String\n ): Promise<ExternalSourceAspectProps> {\n return ProvenanceManager.initElementProvenanceOptions(\n sourceElementId,\n targetElementId,\n {\n isReverseSynchronization: await this._isReverseSynchronization(),\n targetScopeElementId: this._targetScopeElementId,\n sourceDb: this._context.sourceDb,\n targetDb: this._context.targetDb,\n }\n );\n }\n\n /** Create an ExternalSourceAspectProps for a relationship using this manager's context. */\n public async initRelationshipProvenance(\n sourceRelInstanceId: Id64String,\n targetRelInstanceId: Id64String,\n forceOldRelationshipProvenanceMethod: boolean,\n knownEndpoints?: {\n sourceRelSourceElementId?: Id64String;\n targetRelSourceElementId?: Id64String;\n }\n ): Promise<ExternalSourceAspectProps> {\n return ProvenanceManager.initRelationshipProvenanceOptions(\n sourceRelInstanceId,\n targetRelInstanceId,\n {\n sourceDb: this._context.sourceDb,\n targetDb: this._context.targetDb,\n isReverseSynchronization: await this._isReverseSynchronization(),\n targetScopeElementId: this._targetScopeElementId,\n forceOldRelationshipProvenanceMethod,\n knownEndpoints,\n }\n );\n }\n\n // ── Provenance queries ─────────────────────────────────────────────────\n\n /**\n * Queries the provenanceDb for an ESA whose identifier matches the provided relationship ID.\n * @param entityInProvenanceSourceId ID of the relationship in the provenanceSourceDb\n * @param sourceRelInfo Source relationship class and endpoint info (for legacy fallback)\n */\n public async queryProvenanceForRelationship(\n entityInProvenanceSourceId: Id64String,\n sourceRelInfo: {\n classFullName: string;\n sourceId: Id64String;\n targetId: Id64String;\n }\n ): Promise<\n | {\n aspectId: Id64String;\n /** if undefined, the relationship could not be found, perhaps it was deleted */\n relationshipId: Id64String | undefined;\n }\n | undefined\n > {\n const sql = `\n SELECT\n ECInstanceId,\n JSON_EXTRACT(JsonProperties, '$.provenanceRelInstanceId') AS provenanceRelInstId\n FROM Bis.ExternalSourceAspect\n WHERE Kind=?\n AND Scope.Id=?\n AND Identifier=?\n `;\n const params = new QueryBinder();\n params.bindString(1, ExternalSourceAspect.Kind.Relationship);\n params.bindId(2, this._targetScopeElementId);\n params.bindString(3, entityInProvenanceSourceId);\n const result = (await this.getProvenanceDb()).createQueryReader(\n sql,\n params,\n {\n usePrimaryConn: true,\n }\n );\n if (await result.step()) {\n const aspectId = result.current.id;\n const provenanceRelInstId = result.current.provenanceRelInstId;\n const provenanceRelInstanceId =\n provenanceRelInstId !== undefined\n ? (provenanceRelInstId as string)\n : await this._queryTargetRelId(sourceRelInfo);\n return {\n aspectId,\n relationshipId: provenanceRelInstanceId,\n };\n } else return undefined;\n }\n\n /** Instance convenience that calls the static forEachTrackedElement with this manager's context. */\n public async forEachTrackedElement(\n fn: (sourceElementId: Id64String, targetElementId: Id64String) => void\n ): Promise<void> {\n return ProvenanceManager.forEachTrackedElement({\n provenanceSourceDb: await this.getProvenanceSourceDb(),\n provenanceDb: await this.getProvenanceDb(),\n targetScopeElementId: this._targetScopeElementId,\n isReverseSynchronization: await this._isReverseSynchronization(),\n fn,\n skipPropagateChangesToRootElements:\n this._transformerOptions.skipPropagateChangesToRootElements ?? true,\n });\n }\n}\n\n/** Returns the target scope elements: those that own a Scope ExternalSourceAspect.\n * A transformation creates its target scope's Scope aspect before it exports any aspect, so the result includes the current target scope.\n * @internal\n */\nexport async function queryTargetScopeElementIds(\n db: IModelDb\n): Promise<Set<Id64String>> {\n const ids = new Set<Id64String>();\n for await (const row of db.createQueryReader(\n `SELECT Element.Id id FROM ${ExternalSourceAspect.classFullName} WHERE Kind = :scopeKind`,\n new QueryBinder().bindString(\"scopeKind\", ExternalSourceAspect.Kind.Scope),\n { usePrimaryConn: true }\n ))\n ids.add(row.id);\n return ids;\n}\n\n/** Whether an aspect is transformer provenance: a Scope ExternalSourceAspect, or an Element or Relationship ExternalSourceAspect scoped to one of `targetScopeElementIds`.\n * Every target scope counts, not just the current one: an element shared by several target scopes, such as one source imported in parts, carries each scope's provenance.\n * Cleanup never deletes transformer provenance.\n * @internal\n */\nexport function isTransformerProvenanceAspect(\n aspect: ElementAspect,\n targetScopeElementIds: ReadonlySet<Id64String>\n): aspect is ExternalSourceAspect {\n if (!(aspect instanceof ExternalSourceAspect)) return false;\n if (aspect.kind === ExternalSourceAspect.Kind.Scope) return true;\n return (\n (aspect.kind === ExternalSourceAspect.Kind.Element ||\n aspect.kind === ExternalSourceAspect.Kind.Relationship) &&\n aspect.scope !== undefined &&\n targetScopeElementIds.has(aspect.scope.id)\n );\n}\n\n/** Returns the `importElementMultiAspects` filter for a transformation that includes source provenance.\n * Source provenance cloned from another transformation looks exactly like another target scope's provenance, so a transformer provenance aspect is only eligible for reuse when an incoming ExternalSourceAspect has the same kind, scope, and identifier.\n * The current scope's own provenance is never eligible: the transformer maintains it separately.\n * @internal\n */\nexport function sourceProvenanceMatchFilter(\n incoming: readonly ElementAspectProps[],\n targetScopeElementIds: ReadonlySet<Id64String>,\n currentScopeElementId: Id64String\n): (aspect: ElementMultiAspect) => boolean {\n const incomingKeys = new Set(\n incoming\n .filter((props) => isSameClass(props, ExternalSourceAspect.classFullName))\n .map((props) =>\n externalSourceAspectKey(props as ExternalSourceAspectProps)\n )\n );\n return (aspect) => {\n if (!isTransformerProvenanceAspect(aspect, targetScopeElementIds))\n return true;\n const scopeElementId =\n aspect.kind === ExternalSourceAspect.Kind.Scope\n ? aspect.element.id\n : aspect.scope?.id;\n return (\n scopeElementId !== currentScopeElementId &&\n incomingKeys.has(externalSourceAspectKey(aspect))\n );\n };\n}\n\n/** The natural key of an ExternalSourceAspect on its owner. Kinds and IDs never contain `|`, and the identifier comes last, so distinct keys can't collide. */\nfunction externalSourceAspectKey(\n aspect: Pick<ExternalSourceAspectProps, \"kind\" | \"scope\" | \"identifier\">\n): string {\n return `${aspect.kind}|${aspect.scope?.id}|${aspect.identifier}`;\n}\n"]}
|
|
1
|
+
{"version":3,"file":"ProvenanceManager.js","sourceRoot":"","sources":["../../src/ProvenanceManager.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 GuidString,\n Id64String,\n ITwinError,\n Logger,\n} from \"@itwin/core-bentley\";\nimport {\n EditTxn,\n ElementAspect,\n ElementMultiAspect,\n ElementOwnsExternalSourceAspects,\n type Entity,\n ExternalSource,\n ExternalSourceAspect,\n ExternalSourceAttachment,\n FolderLink,\n IModelDb,\n SynchronizationConfigLink,\n} from \"@itwin/core-backend\";\nimport {\n ChangesetIndexAndId,\n ElementAspectProps,\n ExternalSourceAspectProps,\n IModel,\n QueryBinder,\n} from \"@itwin/core-common\";\nimport { isSameClass } from \"./ElementAspectCleanup\";\nimport { TransformerLoggerCategory } from \"./TransformerLoggerCategory\";\nimport type {\n IModelTransformOptions,\n TargetScopeProvenanceJsonProps,\n} from \"./IModelTransformer\";\nimport type { SyncTypeResolver } from \"./SyncTypeResolver\";\nimport type { IModelTransformContext } from \"./IModelTransformContext\";\nimport {\n IModelTransformerError,\n IModelTransformerErrorScope,\n} from \"./IModelTransformerError\";\n\nconst loggerCategory: string = TransformerLoggerCategory.IModelTransformer;\n\ntype ProvenanceContext = Pick<IModelTransformContext, \"findTargetElementId\"> & {\n readonly sourceDb: IModelDb;\n readonly targetDb: IModelDb;\n};\n\n/**\n * Manages provenance scope aspects and synchronization versioning.\n * Encapsulates all ESA scope management, sync version tracking, and\n * provenance DB direction logic extracted from IModelTransformer.\n * @internal\n */\nexport class ProvenanceManager {\n private readonly _context: ProvenanceContext;\n private readonly _targetScopeElementId: Id64String;\n private readonly _transformerOptions: IModelTransformOptions;\n private readonly _syncTypeResolver: SyncTypeResolver;\n private readonly _startingChangesetIndices?: {\n target: number;\n source: number;\n };\n\n /** NOTE: the json properties must be converted to string before insertion */\n private _targetScopeProvenanceProps:\n | (Omit<ExternalSourceAspectProps, \"jsonProperties\"> & {\n jsonProperties: TargetScopeProvenanceJsonProps;\n })\n | undefined = undefined;\n\n private _cachedSynchronizationVersion: ChangesetIndexAndId | undefined =\n undefined;\n\n private _targetClassNameToClassIdCache = new Map<string, string>();\n\n private readonly _targetEditTxn: EditTxn;\n private readonly _sourceEditTxn?: EditTxn;\n\n public constructor(\n targetScopeElementId: Id64String,\n transformerOptions: IModelTransformOptions,\n context: ProvenanceContext,\n syncTypeResolver: SyncTypeResolver,\n targetEditTxn: EditTxn,\n sourceEditTxn?: EditTxn\n ) {\n this._targetScopeElementId = targetScopeElementId;\n this._transformerOptions = transformerOptions;\n this._context = context;\n this._syncTypeResolver = syncTypeResolver;\n this._targetEditTxn = targetEditTxn;\n this._sourceEditTxn = sourceEditTxn;\n\n const sourceDb = this._context.sourceDb;\n const targetDb = this._context.targetDb;\n if (sourceDb.isBriefcase && targetDb.isBriefcase) {\n if (\n sourceDb.changeset.index === undefined ||\n targetDb.changeset.index === undefined\n )\n ITwinError.throwError({\n iTwinErrorId: {\n scope: IModelTransformerErrorScope,\n key: IModelTransformerError.ChangesetIndexUnavailable,\n },\n message: \"database has no changeset index\",\n });\n this._startingChangesetIndices = {\n target: targetDb.changeset.index,\n source: sourceDb.changeset.index,\n };\n }\n }\n\n private async _isReverseSynchronization(): Promise<boolean> {\n return (await this._syncTypeResolver.getSyncType()) === \"reverse\";\n }\n\n private async _queryTargetRelId(sourceRelInfo: {\n classFullName: string;\n sourceId: Id64String;\n targetId: Id64String;\n }): Promise<Id64String | undefined> {\n const targetRelInfo = {\n sourceId: this._context.findTargetElementId(sourceRelInfo.sourceId),\n targetId: this._context.findTargetElementId(sourceRelInfo.targetId),\n };\n if (\n targetRelInfo.sourceId === undefined ||\n targetRelInfo.targetId === undefined\n )\n return undefined;\n const sql = `\n select ecinstanceid\n from bis.elementreferstoelements\n where sourceecinstanceid=?\n and targetecinstanceid=?\n and ecclassid=?\n `;\n const params = new QueryBinder();\n params.bindId(1, targetRelInfo.sourceId);\n params.bindId(2, targetRelInfo.targetId);\n params.bindId(\n 3,\n await this._targetClassNameToClassId(sourceRelInfo.classFullName)\n );\n const result = this._context.targetDb.createQueryReader(sql, params, {\n usePrimaryConn: true,\n });\n if (await result.step()) return result.current.id;\n else return undefined;\n }\n\n private async _targetClassNameToClassId(\n classFullName: string\n ): Promise<Id64String> {\n let classId = this._targetClassNameToClassIdCache.get(classFullName);\n if (classId === undefined) {\n classId = await this._getRelClassId(\n this._context.targetDb,\n classFullName\n );\n this._targetClassNameToClassIdCache.set(classFullName, classId);\n }\n return classId;\n }\n\n private async _getRelClassId(\n db: IModelDb,\n classFullName: string\n ): Promise<Id64String> {\n const sql = `\n SELECT c.ECInstanceId\n FROM ECDbMeta.ECClassDef c\n JOIN ECDbMeta.ECSchemaDef s ON c.Schema.Id=s.ECInstanceId\n WHERE s.Name=? AND c.Name=?\n `;\n const [schemaName, className] =\n classFullName.indexOf(\".\") !== -1\n ? classFullName.split(\".\")\n : classFullName.split(\":\");\n const params = new QueryBinder();\n params.bindString(1, schemaName);\n params.bindString(2, className);\n const result = db.createQueryReader(sql, params, { usePrimaryConn: true });\n if (await result.step()) return result.current.id;\n ITwinError.throwError({\n iTwinErrorId: {\n scope: IModelTransformerErrorScope,\n key: IModelTransformerError.RelationshipClassNotFound,\n },\n message: `Could not find class ${classFullName} in the db`,\n });\n }\n\n // ── Static provenance metadata ──────────────────────────────────────────\n\n /** The element classes that are considered to define provenance in the iModel */\n public static get provenanceElementClasses(): (typeof Entity)[] {\n return [\n FolderLink,\n SynchronizationConfigLink,\n ExternalSource,\n ExternalSourceAttachment,\n ];\n }\n\n /** The element aspect classes that are considered to define provenance in the iModel */\n public static get provenanceElementAspectClasses(): (typeof Entity)[] {\n return [ExternalSourceAspect];\n }\n\n // ── Static provenance queries ──────────────────────────────────────────\n\n /**\n * Iterate all matching federation guids and ExternalSourceAspects in the provenance iModel (target unless reverse sync)\n * and call a function for each one.\n * @note provenance is done by federation guids where possible\n * @note this may execute on each element more than once! Only use in cases where that is handled\n */\n public static async forEachTrackedElement(args: {\n provenanceSourceDb: IModelDb;\n provenanceDb: IModelDb;\n targetScopeElementId: Id64String;\n isReverseSynchronization: boolean;\n fn: (sourceElementId: Id64String, targetElementId: Id64String) => void;\n skipPropagateChangesToRootElements: boolean;\n }): Promise<void> {\n if (args.provenanceDb === args.provenanceSourceDb) return;\n\n if (!args.provenanceDb.containsClass(ExternalSourceAspect.classFullName)) {\n ITwinError.throwError({\n iTwinErrorId: {\n scope: IModelTransformerErrorScope,\n key: IModelTransformerError.ProvenanceSchemaUnsupported,\n },\n message: \"The BisCore schema version of the target database is too old\",\n });\n }\n\n const sourceDb = args.isReverseSynchronization\n ? args.provenanceDb\n : args.provenanceSourceDb;\n const targetDb = args.isReverseSynchronization\n ? args.provenanceSourceDb\n : args.provenanceDb;\n\n // query for provenanceDb\n const elementIdByFedGuidQuery = `\n SELECT e.ECInstanceId, FederationGuid\n FROM bis.Element e\n ${\n args.skipPropagateChangesToRootElements\n ? \"WHERE e.ECInstanceId NOT IN (0x1, 0xe, 0x10) -- special static elements\"\n : \"\"\n }\n ORDER BY FederationGuid\n `;\n\n // iterate through sorted list of fed guids from both dbs to get the intersection\n // NOTE: if we exposed the native attach database support,\n // we could get the intersection of fed guids in one query, not sure if it would be faster\n // OR we could do a raw sqlite query...\n\n const sourceReader = sourceDb.createQueryReader(\n elementIdByFedGuidQuery,\n undefined,\n { usePrimaryConn: true }\n );\n const targetReader = targetDb.createQueryReader(\n elementIdByFedGuidQuery,\n undefined,\n { usePrimaryConn: true }\n );\n let hasSourceRow = await sourceReader.step();\n let hasTargetRow = await targetReader.step();\n while (hasSourceRow && hasTargetRow) {\n const sourceFedGuid = sourceReader.current.federationGuid as\n GuidString | undefined;\n const targetFedGuid = targetReader.current.federationGuid as\n GuidString | undefined;\n if (\n sourceFedGuid !== undefined &&\n targetFedGuid !== undefined &&\n sourceFedGuid === targetFedGuid\n ) {\n // data flow direction is always sourceDb -> targetDb and it does not depend on where the explicit element provenance is stored\n args.fn(\n sourceReader.current.id as Id64String,\n targetReader.current.id as Id64String\n );\n }\n if (\n targetFedGuid === undefined ||\n (sourceFedGuid !== undefined && sourceFedGuid >= targetFedGuid)\n ) {\n hasTargetRow = await targetReader.step();\n }\n if (\n sourceFedGuid === undefined ||\n (targetFedGuid !== undefined && sourceFedGuid <= targetFedGuid)\n ) {\n hasSourceRow = await sourceReader.step();\n }\n }\n\n // query for provenanceDb\n const provenanceAspectsQuery = `\n SELECT esa.Identifier, Element.Id\n FROM bis.ExternalSourceAspect esa\n WHERE Scope.Id=:scopeId\n AND Kind=:kind\n ORDER BY esa.Identifier, esa.ECInstanceId DESC\n `;\n\n // Technically this will a second time call the function (as documented) on\n // victims of the old provenance method that have both fedguids and an inserted aspect.\n // But this is a private function with one known caller where that doesn't matter\n\n const runFnInDataFlowDirection = (\n sourceId: Id64String,\n targetId: Id64String\n ) =>\n args.isReverseSynchronization\n ? args.fn(sourceId, targetId)\n : args.fn(targetId, sourceId);\n const params = new QueryBinder();\n params.bindId(\"scopeId\", args.targetScopeElementId);\n params.bindString(\"kind\", ExternalSourceAspect.Kind.Element);\n const provenanceReader = args.provenanceDb.createQueryReader(\n provenanceAspectsQuery,\n params,\n { usePrimaryConn: true }\n );\n for await (const row of provenanceReader) {\n // ExternalSourceAspect.Identifier is of type string\n const aspectIdentifier: Id64String = row[0];\n const elementId: Id64String = row.id;\n runFnInDataFlowDirection(elementId, aspectIdentifier);\n }\n }\n\n /**\n * Queries for an ESA which matches the props in the provided aspectProps.\n * @param dbToQuery db to run the query on\n * @param aspectProps aspectProps to search for\n */\n public static async queryScopeExternalSourceAspect(\n dbToQuery: IModelDb,\n aspectProps: ExternalSourceAspectProps\n ): Promise<\n | {\n aspectId: Id64String;\n version?: string;\n /** stringified json */\n jsonProperties?: string;\n }\n | undefined\n > {\n const sql = `\n SELECT ECInstanceId, Version, JsonProperties\n FROM ${ExternalSourceAspect.classFullName}\n WHERE Element.Id=:elementId\n AND Scope.Id=:scopeId\n AND Kind=:kind\n AND Identifier=:identifier\n LIMIT 1\n `;\n\n if (aspectProps.scope === undefined) return undefined;\n\n const params = new QueryBinder()\n .bindId(\"elementId\", aspectProps.element.id)\n .bindId(\"scopeId\", aspectProps.scope.id)\n .bindString(\"kind\", aspectProps.kind)\n .bindString(\"identifier\", aspectProps.identifier);\n\n return dbToQuery.withQueryReader(\n sql,\n (reader) => {\n if (!reader.step()) return undefined;\n const aspectId = reader.current[0] as Id64String;\n const version = reader.current[1] as string | undefined;\n const jsonProperties = reader.current[2] as string | undefined;\n return { aspectId, version, jsonProperties };\n },\n params\n );\n }\n\n // ── Provenance DB direction ────────────────────────────────────────────\n\n /** Return the IModelDb where provenance is stored (for reads/queries).\n * This will be targetDb except when it is a reverse synchronization, in which case it will be sourceDb.\n */\n private async getProvenanceDb(): Promise<IModelDb> {\n return (await this._isReverseSynchronization())\n ? this._context.sourceDb\n : this._context.targetDb;\n }\n\n /** Return the EditTxn for writing provenance.\n * This will be targetEditTxn except when it is a reverse synchronization, in which case it will be sourceEditTxn.\n */\n public async getProvenanceEditTxn(): Promise<EditTxn> {\n if (await this._isReverseSynchronization()) {\n if (!this._sourceEditTxn) {\n ITwinError.throwError({\n iTwinErrorId: {\n scope: IModelTransformerErrorScope,\n key: IModelTransformerError.SourceEditTxnRequired,\n },\n message:\n \"A reverse synchronization requires a sourceEditTxn to write provenance back to the source iModel. \" +\n \"Pass sourceEditTxn in IModelTransformOptions.\",\n });\n }\n return this._sourceEditTxn;\n }\n return this._targetEditTxn;\n }\n\n /** Return the IModelDb where entities referred to by stored provenance live.\n * This will be sourceDb except when it is a reverse synchronization, in which case it will be targetDb.\n */\n public async getProvenanceSourceDb(): Promise<IModelDb> {\n return (await this._isReverseSynchronization())\n ? this._context.targetDb\n : this._context.sourceDb;\n }\n\n // ── Scope aspect management ────────────────────────────────────────────\n\n /**\n * @returns provenance scope aspect if it exists in the provenanceDb.\n * Provenance scope aspect is created and inserted into provenanceDb when [[initScopeProvenance]] is invoked.\n */\n public async tryGetProvenanceScopeAspect(): Promise<\n ExternalSourceAspect | undefined\n > {\n const scopeProvenanceAspectProps =\n await ProvenanceManager.queryScopeExternalSourceAspect(\n await this.getProvenanceDb(),\n {\n id: undefined,\n classFullName: ExternalSourceAspect.classFullName,\n scope: { id: IModel.rootSubjectId },\n kind: ExternalSourceAspect.Kind.Scope,\n element: {\n id: this._targetScopeElementId ?? IModel.rootSubjectId,\n },\n identifier: (await this.getProvenanceSourceDb()).iModelId,\n }\n );\n\n return scopeProvenanceAspectProps !== undefined\n ? ((await this.getProvenanceDb()).elements.getAspect(\n scopeProvenanceAspectProps.aspectId\n ) as ExternalSourceAspect)\n : undefined;\n }\n\n /**\n * Make sure there are no conflicting other scope-type external source aspects on the target scope element.\n * If there are none at all, insert one (this must be a first synchronization).\n */\n public async initScopeProvenance(): Promise<void> {\n const provenanceDb = await this.getProvenanceDb();\n const provenanceEditTxn = await this.getProvenanceEditTxn();\n const sourceProvenanceDb = await this.getProvenanceSourceDb();\n const aspectProps = {\n id: undefined as string | undefined,\n version: undefined as string | undefined,\n classFullName: ExternalSourceAspect.classFullName,\n element: {\n id: this._targetScopeElementId,\n relClassName: ElementOwnsExternalSourceAspects.classFullName,\n },\n scope: { id: IModel.rootSubjectId },\n identifier: sourceProvenanceDb.iModelId,\n kind: ExternalSourceAspect.Kind.Scope,\n jsonProperties: undefined as TargetScopeProvenanceJsonProps | undefined,\n };\n\n const foundEsaProps =\n await ProvenanceManager.queryScopeExternalSourceAspect(\n provenanceDb,\n aspectProps\n );\n\n if (foundEsaProps === undefined) {\n aspectProps.version = \"\";\n aspectProps.jsonProperties = {\n pendingReverseSyncChangesetIndices: [],\n pendingSyncChangesetIndices: [],\n reverseSyncVersion: \"\",\n };\n\n // query without \"identifier\" to find possible conflicts\n const sql = `\n SELECT ECInstanceId\n FROM ${ExternalSourceAspect.classFullName}\n WHERE Element.Id=:elementId\n AND Scope.Id=:scopeId\n AND Kind=:kind\n LIMIT 1\n `;\n\n const params = new QueryBinder();\n params.bindId(\"elementId\", aspectProps.element.id);\n params.bindId(\"scopeId\", aspectProps.scope.id);\n params.bindString(\"kind\", aspectProps.kind);\n const reader = provenanceDb.createQueryReader(sql, params, {\n usePrimaryConn: true,\n });\n const hasConflictingScope = await reader.step();\n\n if (hasConflictingScope) {\n ITwinError.throwError({\n iTwinErrorId: {\n scope: IModelTransformerErrorScope,\n key: IModelTransformerError.ProvenanceScopeConflict,\n },\n message: \"Provenance scope conflict\",\n });\n }\n if (!this._transformerOptions.noProvenance) {\n const id = provenanceEditTxn.insertAspect({\n ...aspectProps,\n jsonProperties: JSON.stringify(aspectProps.jsonProperties) as any,\n });\n aspectProps.id = id;\n this.clearCachedSynchronizationVersion();\n }\n } else {\n aspectProps.id = foundEsaProps.aspectId;\n aspectProps.version = foundEsaProps.version;\n aspectProps.jsonProperties = foundEsaProps.jsonProperties\n ? JSON.parse(foundEsaProps.jsonProperties)\n : undefined;\n const oldProps = JSON.parse(JSON.stringify(aspectProps));\n if (this.handleUnsafeMigrate(aspectProps)) {\n Logger.logInfo(\n loggerCategory,\n \"Unsafe migrate made a change to the target scope's external source aspect. Updating aspect in database.\",\n { oldProps, newProps: aspectProps }\n );\n provenanceEditTxn.updateAspect({\n ...aspectProps,\n jsonProperties: JSON.stringify(aspectProps.jsonProperties) as any,\n });\n this.clearCachedSynchronizationVersion();\n }\n }\n\n this._targetScopeProvenanceProps =\n aspectProps as typeof this._targetScopeProvenanceProps;\n }\n\n /** Returns true if a change was made to the aspectProps. */\n private handleUnsafeMigrate(aspectProps: {\n version?: string;\n jsonProperties?: TargetScopeProvenanceJsonProps;\n }): boolean {\n let madeChange = false;\n if (\n this._transformerOptions.branchRelationshipDataBehavior !==\n \"unsafe-migrate\"\n )\n return madeChange;\n const fallbackSyncVersionToUse =\n this._transformerOptions.argsForProcessChanges\n ?.unsafeFallbackSyncVersion ?? \"\";\n const fallbackReverseSyncVersionToUse =\n this._transformerOptions.argsForProcessChanges\n ?.unsafeFallbackReverseSyncVersion ?? \"\";\n\n if (\n aspectProps.version === undefined ||\n (aspectProps.version === \"\" &&\n aspectProps.version !== fallbackSyncVersionToUse)\n ) {\n aspectProps.version = fallbackSyncVersionToUse;\n madeChange = true;\n }\n\n if (aspectProps.jsonProperties === undefined) {\n aspectProps.jsonProperties = {\n pendingReverseSyncChangesetIndices: [],\n pendingSyncChangesetIndices: [],\n reverseSyncVersion: fallbackReverseSyncVersionToUse,\n };\n madeChange = true;\n } else if (\n aspectProps.jsonProperties.reverseSyncVersion === undefined ||\n (aspectProps.jsonProperties.reverseSyncVersion === \"\" &&\n aspectProps.jsonProperties.reverseSyncVersion !==\n fallbackReverseSyncVersionToUse)\n ) {\n aspectProps.jsonProperties.reverseSyncVersion =\n fallbackReverseSyncVersionToUse;\n madeChange = true;\n }\n\n if (\n aspectProps.jsonProperties.pendingReverseSyncChangesetIndices ===\n undefined\n ) {\n Logger.logWarning(\n loggerCategory,\n \"Property pendingReverseSyncChangesetIndices missing on the jsonProperties of the scoping ESA. Setting to [].\"\n );\n aspectProps.jsonProperties.pendingReverseSyncChangesetIndices = [];\n madeChange = true;\n }\n if (aspectProps.jsonProperties.pendingSyncChangesetIndices === undefined) {\n Logger.logWarning(\n loggerCategory,\n \"Property pendingSyncChangesetIndices missing on the jsonProperties of the scoping ESA. Setting to [].\"\n );\n aspectProps.jsonProperties.pendingSyncChangesetIndices = [];\n madeChange = true;\n }\n return madeChange;\n }\n\n // ── Synchronization version ────────────────────────────────────────────\n\n /**\n * We cache the synchronization version to avoid querying the target scoping ESA multiple times.\n * Clears the cached value so the next call to getSynchronizationVersion re-queries.\n */\n public clearCachedSynchronizationVersion() {\n this._cachedSynchronizationVersion = undefined;\n }\n\n /** The changeset version in the scoping element's source version found for this transformation.\n * @note the version depends on whether this is a reverse synchronization or not.\n * @note empty string and -1 for changeset and index if it has never been transformed.\n */\n public async getSynchronizationVersion(): Promise<ChangesetIndexAndId> {\n if (this._cachedSynchronizationVersion === undefined) {\n const provenanceScopeAspect = await this.tryGetProvenanceScopeAspect();\n if (!provenanceScopeAspect) {\n return { index: -1, id: \"\" };\n }\n\n const version = (await this._isReverseSynchronization())\n ? (\n JSON.parse(\n provenanceScopeAspect.jsonProperties ?? \"{}\"\n ) as TargetScopeProvenanceJsonProps\n ).reverseSyncVersion\n : provenanceScopeAspect.version;\n if (\n !version &&\n this._transformerOptions.branchRelationshipDataBehavior ===\n \"unsafe-migrate\"\n ) {\n return { index: -1, id: \"\" };\n }\n if (version === undefined) {\n ITwinError.throwError({\n iTwinErrorId: {\n scope: IModelTransformerErrorScope,\n key: IModelTransformerError.SynchronizationVersionMissing,\n },\n message: `Could not find synchronization version in scope aspect. This may be due to the last successful run of the transformer being done with an older version.\n Consider running the transformer with branchRelationshipDataBehavior set to 'unsafe-migrate'`,\n });\n }\n const [id, index] = version === \"\" ? [\"\", -1] : version.split(\";\");\n if (Number.isNaN(Number(index)))\n throw new Error(\"Could not parse version data from scope aspect\");\n this._cachedSynchronizationVersion = { index: Number(index), id };\n }\n return this._cachedSynchronizationVersion;\n }\n\n /**\n * Returns the pending changeset indices to skip for the current synchronization direction.\n * Used by changeset initialization to determine which changesets have already been processed.\n */\n public async getChangesetsToSkip(): Promise<number[]> {\n if (this._targetScopeProvenanceProps === undefined)\n throw new Error(\"_targetScopeProvenanceProps should be set by now\");\n const props = this._targetScopeProvenanceProps;\n return (await this._isReverseSynchronization())\n ? props.jsonProperties.pendingReverseSyncChangesetIndices\n : props.jsonProperties.pendingSyncChangesetIndices;\n }\n\n /**\n * Updates the synchronization version on the scope ESA.\n *\n * Called at the end of a transformation, updates the target scope element to record\n * that transformation up through the source's changeset has been performed. Also stores\n * all changesets that occurred during the transformation as \"pending synchronization\n * changeset indices\" @see TargetScopeProvenanceJsonProps\n *\n * @param initializeReverseSyncVersion When true, saves the reverse sync version as the\n * current changeset of the targetDb. This is typically used for the first transformation\n * between a master and branch iModel. Setting this to true has the effect of making it so\n * any changesets in the branch iModel at the time of the first transformation will be\n * ignored during any future reverse synchronizations from the branch to the master iModel.\n *\n * Note that typically, the reverseSyncVersion is saved as the last changeset merged from\n * the branch into master. Setting initializeReverseSyncVersion to true during a forward\n * transformation could overwrite this correct reverseSyncVersion and should only be done\n * during the first transformation between a master and branch iModel.\n *\n * @param sourceChangeDataState The current state of change data — used to skip updates\n * when there are no changes.\n */\n public async updateSynchronizationVersion({\n initializeReverseSyncVersion = false,\n sourceChangeDataState,\n }: {\n initializeReverseSyncVersion?: boolean;\n sourceChangeDataState:\n \"uninited\" | \"has-changes\" | \"no-changes\" | \"unconnected\";\n }) {\n const shouldSkipSyncVersionUpdate =\n !initializeReverseSyncVersion && sourceChangeDataState !== \"has-changes\";\n if (shouldSkipSyncVersionUpdate) return;\n\n // If noProvenance is set, there's no scope ESA to update\n if (this._transformerOptions.noProvenance) return;\n\n if (this._targetScopeProvenanceProps === undefined)\n throw new Error(\"_targetScopeProvenanceProps should be set by now\");\n const scopeProps = this._targetScopeProvenanceProps;\n\n const sourceVersion = `${this._context.sourceDb.changeset.id};${this._context.sourceDb.changeset.index}`;\n const targetVersion = `${this._context.targetDb.changeset.id};${this._context.targetDb.changeset.index}`;\n\n if (await this._isReverseSynchronization()) {\n const oldVersion = scopeProps.jsonProperties.reverseSyncVersion;\n\n Logger.logInfo(\n loggerCategory,\n `updating reverse version from ${oldVersion} to ${sourceVersion}`\n );\n scopeProps.jsonProperties.reverseSyncVersion = sourceVersion;\n } else {\n Logger.logInfo(\n loggerCategory,\n `updating sync version from ${scopeProps.version} to ${sourceVersion}`\n );\n scopeProps.version = sourceVersion;\n\n if (initializeReverseSyncVersion) {\n Logger.logInfo(\n loggerCategory,\n `updating reverse sync version from ${scopeProps.jsonProperties.reverseSyncVersion} to ${targetVersion}`\n );\n scopeProps.jsonProperties.reverseSyncVersion = targetVersion;\n }\n }\n\n const startingChangesetIndices = this._startingChangesetIndices;\n if (\n !!this._transformerOptions.argsForProcessChanges ||\n (startingChangesetIndices && initializeReverseSyncVersion)\n ) {\n if (\n this._context.targetDb.changeset.index === undefined ||\n startingChangesetIndices === undefined\n )\n throw new Error(\n \"updateSynchronizationVersion was called without change history\"\n );\n\n const jsonProps = scopeProps.jsonProperties;\n\n Logger.logTrace(\n loggerCategory,\n `previous pendingReverseSyncChanges: ${String(jsonProps.pendingReverseSyncChangesetIndices)}`\n );\n Logger.logTrace(\n loggerCategory,\n `previous pendingSyncChanges: ${String(jsonProps.pendingSyncChangesetIndices)}`\n );\n\n const pendingSyncChangesetIndicesKey =\n \"pendingSyncChangesetIndices\" as const;\n const pendingReverseSyncChangesetIndicesKey =\n \"pendingReverseSyncChangesetIndices\" as const;\n\n let syncChangesetsToClearKey;\n let syncChangesetsToUpdateKey;\n\n if (await this._isReverseSynchronization()) {\n syncChangesetsToClearKey = pendingReverseSyncChangesetIndicesKey;\n syncChangesetsToUpdateKey = pendingSyncChangesetIndicesKey;\n } else {\n syncChangesetsToClearKey = pendingSyncChangesetIndicesKey;\n syncChangesetsToUpdateKey = pendingReverseSyncChangesetIndicesKey;\n }\n\n for (\n let i = startingChangesetIndices.target + 1;\n i <= this._context.targetDb.changeset.index + 1;\n i++\n )\n jsonProps[syncChangesetsToUpdateKey].push(i);\n jsonProps[syncChangesetsToClearKey] = jsonProps[\n syncChangesetsToClearKey\n ].filter((csIndex) => {\n return csIndex > startingChangesetIndices.source;\n });\n\n if (await this._isReverseSynchronization()) {\n if (this._context.sourceDb.changeset.index === undefined)\n throw new Error(\"changeset didn't exist\");\n for (\n let i = startingChangesetIndices.source + 1;\n i <= this._context.sourceDb.changeset.index + 1;\n i++\n )\n jsonProps.pendingReverseSyncChangesetIndices.push(i);\n }\n\n Logger.logTrace(\n loggerCategory,\n `new pendingReverseSyncChanges: ${String(jsonProps.pendingReverseSyncChangesetIndices)}`\n );\n Logger.logTrace(\n loggerCategory,\n `new pendingSyncChanges: ${String(jsonProps.pendingSyncChangesetIndices)}`\n );\n }\n\n (await this.getProvenanceEditTxn()).updateAspect({\n ...scopeProps,\n jsonProperties: JSON.stringify(scopeProps.jsonProperties) as any,\n });\n this.clearCachedSynchronizationVersion();\n }\n\n // ── Element/Relationship provenance creation ───────────────────────────\n\n /** Create ExternalSourceAspectProps for an element in an iModel → iModel transformation. */\n public static initElementProvenanceOptions(\n sourceElementId: Id64String,\n targetElementId: Id64String,\n args: {\n sourceDb: IModelDb;\n targetDb: IModelDb;\n isReverseSynchronization: boolean;\n targetScopeElementId: Id64String;\n }\n ): ExternalSourceAspectProps {\n const elementId = args.isReverseSynchronization\n ? sourceElementId\n : targetElementId;\n const version = args.isReverseSynchronization\n ? args.targetDb.elements.queryLastModifiedTime(targetElementId)\n : args.sourceDb.elements.queryLastModifiedTime(sourceElementId);\n const aspectIdentifier = args.isReverseSynchronization\n ? targetElementId\n : sourceElementId;\n const aspectProps: ExternalSourceAspectProps = {\n classFullName: ExternalSourceAspect.classFullName,\n element: {\n id: elementId,\n relClassName: ElementOwnsExternalSourceAspects.classFullName,\n },\n scope: { id: args.targetScopeElementId },\n identifier: aspectIdentifier,\n kind: ExternalSourceAspect.Kind.Element,\n version,\n };\n return aspectProps;\n }\n\n /** Create ExternalSourceAspectProps for a relationship in an iModel → iModel transformation. */\n public static async initRelationshipProvenanceOptions(\n sourceRelInstanceId: Id64String,\n targetRelInstanceId: Id64String,\n args: {\n sourceDb: IModelDb;\n targetDb: IModelDb;\n isReverseSynchronization: boolean;\n targetScopeElementId: Id64String;\n forceOldRelationshipProvenanceMethod: boolean;\n /** Already-known source-endpoint element ids of the relationships, used to skip the\n * per-relationship endpoint query when the caller knows the needed id.\n */\n knownEndpoints?: {\n /** `SourceECInstanceId` of the relationship identified by `sourceRelInstanceId` in `sourceDb`. */\n sourceRelSourceElementId?: Id64String;\n /** `SourceECInstanceId` of the relationship identified by `targetRelInstanceId` in `targetDb`. */\n targetRelSourceElementId?: Id64String;\n };\n }\n ): Promise<ExternalSourceAspectProps> {\n const provenanceDb = args.isReverseSynchronization\n ? args.sourceDb\n : args.targetDb;\n const aspectIdentifier = args.isReverseSynchronization\n ? targetRelInstanceId\n : sourceRelInstanceId;\n const provenanceRelInstanceId = args.isReverseSynchronization\n ? sourceRelInstanceId\n : targetRelInstanceId;\n\n // the provenance relationship lives in the provenanceDb, so its known source-endpoint id is\n // the source rel's on reverse synchronization and the target rel's otherwise\n let elementId = args.isReverseSynchronization\n ? args.knownEndpoints?.sourceRelSourceElementId\n : args.knownEndpoints?.targetRelSourceElementId;\n if (undefined === elementId) {\n const sql =\n \"SELECT SourceECInstanceId FROM bis.ElementRefersToElements WHERE ECInstanceId=?\";\n const params = new QueryBinder().bindId(1, provenanceRelInstanceId);\n const reader = provenanceDb.createQueryReader(sql, params, {\n usePrimaryConn: true,\n });\n if (!(await reader.step()))\n ITwinError.throwError({\n iTwinErrorId: {\n scope: IModelTransformerErrorScope,\n key: IModelTransformerError.RelationshipProvenanceNotFound,\n },\n message: \"relationship provenance query returned no rows\",\n });\n elementId = reader.current[0] as Id64String;\n }\n\n const jsonProperties = args.forceOldRelationshipProvenanceMethod\n ? { targetRelInstanceId }\n : { provenanceRelInstanceId };\n\n const aspectProps: ExternalSourceAspectProps = {\n classFullName: ExternalSourceAspect.classFullName,\n element: {\n id: elementId,\n relClassName: ElementOwnsExternalSourceAspects.classFullName,\n },\n scope: { id: args.targetScopeElementId },\n identifier: aspectIdentifier,\n kind: ExternalSourceAspect.Kind.Relationship,\n jsonProperties: JSON.stringify(jsonProperties),\n };\n\n return aspectProps;\n }\n\n /** Create an ExternalSourceAspectProps for an element using this manager's context. */\n public async initElementProvenance(\n sourceElementId: Id64String,\n targetElementId: Id64String\n ): Promise<ExternalSourceAspectProps> {\n return ProvenanceManager.initElementProvenanceOptions(\n sourceElementId,\n targetElementId,\n {\n isReverseSynchronization: await this._isReverseSynchronization(),\n targetScopeElementId: this._targetScopeElementId,\n sourceDb: this._context.sourceDb,\n targetDb: this._context.targetDb,\n }\n );\n }\n\n /** Create an ExternalSourceAspectProps for a relationship using this manager's context. */\n public async initRelationshipProvenance(\n sourceRelInstanceId: Id64String,\n targetRelInstanceId: Id64String,\n forceOldRelationshipProvenanceMethod: boolean,\n knownEndpoints?: {\n sourceRelSourceElementId?: Id64String;\n targetRelSourceElementId?: Id64String;\n }\n ): Promise<ExternalSourceAspectProps> {\n return ProvenanceManager.initRelationshipProvenanceOptions(\n sourceRelInstanceId,\n targetRelInstanceId,\n {\n sourceDb: this._context.sourceDb,\n targetDb: this._context.targetDb,\n isReverseSynchronization: await this._isReverseSynchronization(),\n targetScopeElementId: this._targetScopeElementId,\n forceOldRelationshipProvenanceMethod,\n knownEndpoints,\n }\n );\n }\n\n // ── Provenance queries ─────────────────────────────────────────────────\n\n /**\n * Queries the provenanceDb for an ESA whose identifier matches the provided relationship ID.\n * @param entityInProvenanceSourceId ID of the relationship in the provenanceSourceDb\n * @param sourceRelInfo Source relationship class and endpoint info (for legacy fallback)\n */\n public async queryProvenanceForRelationship(\n entityInProvenanceSourceId: Id64String,\n sourceRelInfo: {\n classFullName: string;\n sourceId: Id64String;\n targetId: Id64String;\n }\n ): Promise<\n | {\n aspectId: Id64String;\n /** if undefined, the relationship could not be found, perhaps it was deleted */\n relationshipId: Id64String | undefined;\n }\n | undefined\n > {\n const sql = `\n SELECT\n ECInstanceId,\n JSON_EXTRACT(JsonProperties, '$.provenanceRelInstanceId') AS provenanceRelInstId\n FROM Bis.ExternalSourceAspect\n WHERE Kind=?\n AND Scope.Id=?\n AND Identifier=?\n `;\n const params = new QueryBinder();\n params.bindString(1, ExternalSourceAspect.Kind.Relationship);\n params.bindId(2, this._targetScopeElementId);\n params.bindString(3, entityInProvenanceSourceId);\n const result = (await this.getProvenanceDb()).createQueryReader(\n sql,\n params,\n {\n usePrimaryConn: true,\n }\n );\n if (await result.step()) {\n const aspectId = result.current.id;\n const provenanceRelInstId = result.current.provenanceRelInstId;\n const provenanceRelInstanceId =\n provenanceRelInstId !== undefined\n ? (provenanceRelInstId as string)\n : await this._queryTargetRelId(sourceRelInfo);\n return {\n aspectId,\n relationshipId: provenanceRelInstanceId,\n };\n } else return undefined;\n }\n\n /** Instance convenience that calls the static forEachTrackedElement with this manager's context. */\n public async forEachTrackedElement(\n fn: (sourceElementId: Id64String, targetElementId: Id64String) => void\n ): Promise<void> {\n return ProvenanceManager.forEachTrackedElement({\n provenanceSourceDb: await this.getProvenanceSourceDb(),\n provenanceDb: await this.getProvenanceDb(),\n targetScopeElementId: this._targetScopeElementId,\n isReverseSynchronization: await this._isReverseSynchronization(),\n fn,\n skipPropagateChangesToRootElements:\n this._transformerOptions.skipPropagateChangesToRootElements ?? true,\n });\n }\n}\n\n/** Returns the target scope elements: those that own a Scope ExternalSourceAspect.\n * A transformation creates its target scope's Scope aspect before it exports any aspect, so the result includes the current target scope.\n * @internal\n */\nexport async function queryTargetScopeElementIds(\n db: IModelDb\n): Promise<Set<Id64String>> {\n const ids = new Set<Id64String>();\n for await (const row of db.createQueryReader(\n `SELECT Element.Id id FROM ${ExternalSourceAspect.classFullName} WHERE Kind = :scopeKind`,\n new QueryBinder().bindString(\"scopeKind\", ExternalSourceAspect.Kind.Scope),\n { usePrimaryConn: true }\n ))\n ids.add(row.id);\n return ids;\n}\n\n/** Whether an aspect is transformer provenance: the Scope ExternalSourceAspect owned by `currentScopeElementId`, or an Element or Relationship ExternalSourceAspect scoped to one of `targetScopeElementIds`.\n * Element and Relationship provenance of every target scope counts, not just the current one: an element shared by several target scopes, such as one source imported in parts, carries each scope's provenance.\n * A Scope aspect on any other element counts only for the current scope. With `includeSourceProvenance`, a source that was itself a transformation target carries Scope aspects on ordinary elements, and they must follow the source.\n * Cleanup never deletes transformer provenance.\n * @internal\n */\nexport function isTransformerProvenanceAspect(\n aspect: ElementAspect,\n targetScopeElementIds: ReadonlySet<Id64String>,\n currentScopeElementId: Id64String\n): aspect is ExternalSourceAspect {\n if (!(aspect instanceof ExternalSourceAspect)) return false;\n if (aspect.kind === ExternalSourceAspect.Kind.Scope)\n return aspect.element.id === currentScopeElementId;\n return (\n (aspect.kind === ExternalSourceAspect.Kind.Element ||\n aspect.kind === ExternalSourceAspect.Kind.Relationship) &&\n aspect.scope !== undefined &&\n targetScopeElementIds.has(aspect.scope.id)\n );\n}\n\n/** Returns the `importElementMultiAspects` filter for a transformation that includes source provenance.\n * Element and Relationship provenance cloned from another transformation looks exactly like another target scope's provenance, so such an aspect is only eligible for reuse when an incoming ExternalSourceAspect has the same kind, scope, and identifier.\n * The current scope's own provenance is never eligible: the transformer maintains it separately.\n * @internal\n */\nexport function sourceProvenanceMatchFilter(\n incoming: readonly ElementAspectProps[],\n targetScopeElementIds: ReadonlySet<Id64String>,\n currentScopeElementId: Id64String\n): (aspect: ElementMultiAspect) => boolean {\n const incomingKeys = new Set(\n incoming\n .filter((props) => isSameClass(props, ExternalSourceAspect.classFullName))\n .map((props) =>\n externalSourceAspectKey(props as ExternalSourceAspectProps)\n )\n );\n return (aspect) => {\n if (\n !isTransformerProvenanceAspect(\n aspect,\n targetScopeElementIds,\n currentScopeElementId\n )\n )\n return true;\n // The current scope's Scope aspect is the only Scope aspect that counts as provenance.\n return (\n aspect.kind !== ExternalSourceAspect.Kind.Scope &&\n aspect.scope?.id !== currentScopeElementId &&\n incomingKeys.has(externalSourceAspectKey(aspect))\n );\n };\n}\n\n/** The natural key of an ExternalSourceAspect on its owner. Kinds and IDs never contain `|`, and the identifier comes last, so distinct keys can't collide. */\nfunction externalSourceAspectKey(\n aspect: Pick<ExternalSourceAspectProps, \"kind\" | \"scope\" | \"identifier\">\n): string {\n return `${aspect.kind}|${aspect.scope?.id}|${aspect.identifier}`;\n}\n"]}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@itwin/imodel-transformer",
|
|
3
|
-
"version": "2.0.0-experimental.
|
|
3
|
+
"version": "2.0.0-experimental.1",
|
|
4
4
|
"description": "API for exporting an iModel's parts and also importing them into another iModel",
|
|
5
5
|
"main": "lib/cjs/imodel-transformer.js",
|
|
6
6
|
"typings": "lib/cjs/imodel-transformer.d.ts",
|