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

package/lib/cjs/ElementAspectExportCoordinator.js

@@ -0,0 +1,148 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ElementAspectExportCoordinator = void 0;
+/** Coordinates scoped batches of accepted ElementAspect owners, including preparation before aspect export.
+ * @internal
+ */
+class ElementAspectExportCoordinator {
+    _defaultBatchSize;
+    _excludedClassFullNames;
+    _exportAspects;
+    _resetCaches;
+    _acceptedOwnerIds = new Set();
+    _processedOwnerIds = new Set();
+    _batchSize;
+    _depth = 0;
+    _prepare;
+    constructor(_defaultBatchSize, _excludedClassFullNames, _exportAspects, _resetCaches = () => { }) {
+        this._defaultBatchSize = _defaultBatchSize;
+        this._excludedClassFullNames = _excludedClassFullNames;
+        this._exportAspects = _exportAspects;
+        this._resetCaches = _resetCaches;
+        this._batchSize = _defaultBatchSize;
+    }
+    /** Whether an accepted-owner collection scope is active. */
+    get isActive() {
+        return this._depth > 0;
+    }
+    /** Sets the callback that prepares each accepted-owner group before its aspects are exported. */
+    setPreparation(prepare) {
+        this._prepare = prepare;
+    }
+    /** Begins an accepted-owner collection scope.
+     * Nested scopes share the outer scope's state and batch size.
+     */
+    begin(batchSize = this._defaultBatchSize) {
+        if (this._depth === 0) {
+            this.resetScopeState();
+            this._resetCaches();
+            this._batchSize = batchSize;
+        }
+        this._depth++;
+    }
+    /** Ends an accepted-owner collection scope.
+     * Ending the outermost scope exports pending owners and resets all scope state.
+     */
+    async end() {
+        if (this._depth === 0) {
+            throw new Error("No scoped element export is active.");
+        }
+        this._depth--;
+        if (this._depth > 0)
+            return;
+        try {
+            if (this._acceptedOwnerIds.size > 0) {
+                await this.flush();
+            }
+        }
+        finally {
+            this.reset();
+        }
+    }
+    /** Discards the active scope and its pending owner state without exporting it. */
+    abort() {
+        this.reset();
+    }
+    /** Runs element export within an accepted-owner collection scope.
+     * A scope created by this call is aborted if element export fails; an existing outer scope remains responsible for its own failure handling.
+     */
+    async run(exportElements) {
+        if (this.isActive) {
+            await exportElements();
+            return;
+        }
+        this.begin();
+        try {
+            await exportElements();
+        }
+        catch (error) {
+            this.abort();
+            throw error;
+        }
+        await this.end();
+    }
+    /** Adds an accepted source owner to the current group and exports the group when it reaches the configured batch size. */
+    async addAcceptedOwner(elementId) {
+        if (!this.isActive || this._processedOwnerIds.has(elementId))
+            return;
+        this._acceptedOwnerIds.add(elementId);
+        if (this._acceptedOwnerIds.size >= this._batchSize) {
+            await this.flush();
+        }
+    }
+    /** Runs preparation and aspect export for an explicit owner set in bounded groups. */
+    async exportOwners(ownerElementIds) {
+        let ownerIds = ownerElementIds;
+        if (this.isActive && ownerElementIds.size > 0) {
+            const unprocessedOwnerIds = new Set();
+            for (const elementId of ownerElementIds) {
+                if (!this._processedOwnerIds.has(elementId)) {
+                    unprocessedOwnerIds.add(elementId);
+                    this._processedOwnerIds.add(elementId);
+                }
+            }
+            if (unprocessedOwnerIds.size === 0)
+                return;
+            ownerIds = unprocessedOwnerIds;
+        }
+        if (ownerIds.size <= this._defaultBatchSize) {
+            await this.exportOwnerBatch(ownerIds);
+            return;
+        }
+        let ownerBatch = new Set();
+        for (const elementId of ownerIds) {
+            ownerBatch.add(elementId);
+            if (ownerBatch.size === this._defaultBatchSize) {
+                await this.exportOwnerBatch(ownerBatch);
+                ownerBatch = new Set();
+            }
+        }
+        if (ownerBatch.size > 0) {
+            await this.exportOwnerBatch(ownerBatch);
+        }
+    }
+    async exportOwnerBatch(ownerElementIds) {
+        await this._prepare?.(this._excludedClassFullNames(), ownerElementIds);
+        await this._exportAspects(ownerElementIds);
+    }
+    async flush() {
+        const ownerElementIds = new Set(this._acceptedOwnerIds);
+        this._acceptedOwnerIds.clear();
+        await this.exportOwners(ownerElementIds);
+    }
+    resetScopeState() {
+        this._acceptedOwnerIds.clear();
+        this._processedOwnerIds.clear();
+    }
+    reset() {
+        this._depth = 0;
+        this.resetScopeState();
+        this._batchSize = this._defaultBatchSize;
+    }
+}
+exports.ElementAspectExportCoordinator = ElementAspectExportCoordinator;
+//# sourceMappingURL=ElementAspectExportCoordinator.js.map

package/lib/cjs/ElementAspectExportCoordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElementAspectExportCoordinator.js","sourceRoot":"","sources":["../../src/ElementAspectExportCoordinator.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n\nimport { Id64String } from \"@itwin/core-bentley\";\n\nexport type ElementAspectExportPreparation = (\n  excludedElementAspectClassFullNames: ReadonlySet<string>,\n  ownerElementIds: ReadonlySet<Id64String>\n) => Promise<void>;\n\n/** Coordinates scoped batches of accepted ElementAspect owners, including preparation before aspect export.\n * @internal\n */\nexport class ElementAspectExportCoordinator {\n  private readonly _acceptedOwnerIds = new Set<Id64String>();\n  private readonly _processedOwnerIds = new Set<Id64String>();\n  private _batchSize: number;\n  private _depth = 0;\n  private _prepare?: ElementAspectExportPreparation;\n\n  public constructor(\n    private readonly _defaultBatchSize: number,\n    private readonly _excludedClassFullNames: () => ReadonlySet<string>,\n    private readonly _exportAspects: (\n      ownerElementIds: ReadonlySet<Id64String>\n    ) => Promise<void>,\n    private readonly _resetCaches: () => void = () => {}\n  ) {\n    this._batchSize = _defaultBatchSize;\n  }\n\n  /** Whether an accepted-owner collection scope is active. */\n  public get isActive(): boolean {\n    return this._depth > 0;\n  }\n\n  /** Sets the callback that prepares each accepted-owner group before its aspects are exported. */\n  public setPreparation(prepare: ElementAspectExportPreparation): void {\n    this._prepare = prepare;\n  }\n\n  /** Begins an accepted-owner collection scope.\n   * Nested scopes share the outer scope's state and batch size.\n   */\n  public begin(batchSize = this._defaultBatchSize): void {\n    if (this._depth === 0) {\n      this.resetScopeState();\n      this._resetCaches();\n      this._batchSize = batchSize;\n    }\n    this._depth++;\n  }\n\n  /** Ends an accepted-owner collection scope.\n   * Ending the outermost scope exports pending owners and resets all scope state.\n   */\n  public async end(): Promise<void> {\n    if (this._depth === 0) {\n      throw new Error(\"No scoped element export is active.\");\n    }\n\n    this._depth--;\n    if (this._depth > 0) return;\n\n    try {\n      if (this._acceptedOwnerIds.size > 0) {\n        await this.flush();\n      }\n    } finally {\n      this.reset();\n    }\n  }\n\n  /** Discards the active scope and its pending owner state without exporting it. */\n  public abort(): void {\n    this.reset();\n  }\n\n  /** Runs element export within an accepted-owner collection scope.\n   * A scope created by this call is aborted if element export fails; an existing outer scope remains responsible for its own failure handling.\n   */\n  public async run(exportElements: () => Promise<void>): Promise<void> {\n    if (this.isActive) {\n      await exportElements();\n      return;\n    }\n\n    this.begin();\n    try {\n      await exportElements();\n    } catch (error) {\n      this.abort();\n      throw error;\n    }\n    await this.end();\n  }\n\n  /** Adds an accepted source owner to the current group and exports the group when it reaches the configured batch size. */\n  public async addAcceptedOwner(elementId: Id64String): Promise<void> {\n    if (!this.isActive || this._processedOwnerIds.has(elementId)) return;\n\n    this._acceptedOwnerIds.add(elementId);\n    if (this._acceptedOwnerIds.size >= this._batchSize) {\n      await this.flush();\n    }\n  }\n\n  /** Runs preparation and aspect export for an explicit owner set in bounded groups. */\n  public async exportOwners(\n    ownerElementIds: ReadonlySet<Id64String>\n  ): Promise<void> {\n    let ownerIds = ownerElementIds;\n    if (this.isActive && ownerElementIds.size > 0) {\n      const unprocessedOwnerIds = new Set<Id64String>();\n      for (const elementId of ownerElementIds) {\n        if (!this._processedOwnerIds.has(elementId)) {\n          unprocessedOwnerIds.add(elementId);\n          this._processedOwnerIds.add(elementId);\n        }\n      }\n      if (unprocessedOwnerIds.size === 0) return;\n      ownerIds = unprocessedOwnerIds;\n    }\n\n    if (ownerIds.size <= this._defaultBatchSize) {\n      await this.exportOwnerBatch(ownerIds);\n      return;\n    }\n\n    let ownerBatch = new Set<Id64String>();\n    for (const elementId of ownerIds) {\n      ownerBatch.add(elementId);\n      if (ownerBatch.size === this._defaultBatchSize) {\n        await this.exportOwnerBatch(ownerBatch);\n        ownerBatch = new Set<Id64String>();\n      }\n    }\n    if (ownerBatch.size > 0) {\n      await this.exportOwnerBatch(ownerBatch);\n    }\n  }\n\n  private async exportOwnerBatch(\n    ownerElementIds: ReadonlySet<Id64String>\n  ): Promise<void> {\n    await this._prepare?.(this._excludedClassFullNames(), ownerElementIds);\n    await this._exportAspects(ownerElementIds);\n  }\n\n  private async flush(): Promise<void> {\n    const ownerElementIds = new Set(this._acceptedOwnerIds);\n    this._acceptedOwnerIds.clear();\n    await this.exportOwners(ownerElementIds);\n  }\n\n  private resetScopeState(): void {\n    this._acceptedOwnerIds.clear();\n    this._processedOwnerIds.clear();\n  }\n\n  private reset(): void {\n    this._depth = 0;\n    this.resetScopeState();\n    this._batchSize = this._defaultBatchSize;\n  }\n}\n"]}

package/lib/cjs/ElementAspectExportProcessor.d.ts

@@ -0,0 +1,43 @@
+import { ElementAspect, ElementMultiAspect, ElementUniqueAspect, IModelDb } from "@itwin/core-backend";
+import { Id64String } from "@itwin/core-bentley";
+interface AspectChanges {
+    readonly insertIds: ReadonlySet<Id64String>;
+    readonly updateIds: ReadonlySet<Id64String>;
+}
+export interface ElementAspectExportProcessorHandler {
+    shouldExportElementAspect(aspect: ElementAspect): Promise<boolean>;
+    onExportElementUniqueAspect(uniqueAspect: ElementUniqueAspect, isUpdate?: boolean | undefined): Promise<void>;
+    onExportElementMultiAspects(multiAspects: ElementMultiAspect[]): Promise<void>;
+    trackProgress: () => Promise<void>;
+}
+/** Queries and exports ElementAspects for accepted source owners, applying class and handler filters and grouping multi-aspects by owner.
+ * @internal
+ */
+export declare class ElementAspectExportProcessor {
+    /** ElementAspect classes excluded from source queries. */
+    private readonly _excludedElementAspectClassFullNames;
+    private _hasExportableAspects;
+    private _aspectChanges;
+    /** ElementAspect class names excluded from source queries. */
+    get excludedElementAspectClassFullNames(): ReadonlySet<string>;
+    private readonly _sourceDb;
+    private readonly _handler;
+    constructor(sourceDb: IModelDb, handler: ElementAspectExportProcessorHandler);
+    /** Exports ElementAspects owned by the supplied elements.
+     * Multi-aspects are emitted in one callback group per owner.
+     */
+    exportAllElementAspects(ownerElementIds: ReadonlySet<Id64String>): Promise<void>;
+    /** Sets the aspect changes used to distinguish inserted and updated unique aspects during change export. */
+    setAspectChanges(aspectChanges?: AspectChanges): void;
+    /** Clears source schema and content caches at an outer export-scope boundary. */
+    resetCaches(): void;
+    /** Excludes an ElementAspect class from subsequent queries and export callbacks. */
+    excludeElementAspectClass(classFullName: string): void;
+    private getExcludedClassFilter;
+    private getHasExportableAspects;
+    private queryHasExportableAspects;
+    private getAspectProps;
+    private queryAspects;
+}
+export {};
+//# sourceMappingURL=ElementAspectExportProcessor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ElementAspectExportProcessor.d.ts","sourceRoot":"","sources":["../../src/ElementAspectExportProcessor.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,QAAQ,EACT,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAa,MAAM,qBAAqB,CAAC;AAS5D,UAAU,aAAa;IACrB,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,mCAAmC;IAClD,yBAAyB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnE,2BAA2B,CACzB,YAAY,EAAE,mBAAmB,EACjC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,GAC7B,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,2BAA2B,CACzB,YAAY,EAAE,kBAAkB,EAAE,GACjC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,qBAAa,4BAA4B;IACvC,0DAA0D;IAC1D,OAAO,CAAC,QAAQ,CAAC,oCAAoC,CAAqB;IAC1E,OAAO,CAAC,qBAAqB,CAA+B;IAC5D,OAAO,CAAC,cAAc,CAA4B;IAElD,8DAA8D;IAC9D,IAAW,mCAAmC,IAAI,WAAW,CAAC,MAAM,CAAC,CAEpE;IACD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsC;IAE/D,YACE,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,mCAAmC,EAI7C;IAED;;OAEG;IACU,uBAAuB,CAClC,eAAe,EAAE,WAAW,CAAC,UAAU,CAAC,GACvC,OAAO,CAAC,IAAI,CAAC,CA2Cf;IAED,4GAA4G;IACrG,gBAAgB,CAAC,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAE3D;IAED,iFAAiF;IAC1E,WAAW,IAAI,IAAI,CAEzB;IAED,oFAAoF;IAC7E,yBAAyB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAI5D;IAED,OAAO,CAAC,sBAAsB;YAkBhB,uBAAuB;YAKvB,yBAAyB;IAuBvC,OAAO,CAAC,cAAc;YA4BP,YAAY;CAqC5B"}

package/lib/cjs/ElementAspectExportProcessor.js

@@ -0,0 +1,167 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ElementAspectExportProcessor = void 0;
+const core_backend_1 = require("@itwin/core-backend");
+const core_bentley_1 = require("@itwin/core-bentley");
+const ECSqlReaderAsyncIterableIteratorAdapter_1 = require("./ECSqlReaderAsyncIterableIteratorAdapter");
+const core_common_1 = require("@itwin/core-common");
+/** Queries and exports ElementAspects for accepted source owners, applying class and handler filters and grouping multi-aspects by owner.
+ * @internal
+ */
+class ElementAspectExportProcessor {
+    /** ElementAspect classes excluded from source queries. */
+    _excludedElementAspectClassFullNames = new Set();
+    _hasExportableAspects;
+    _aspectChanges;
+    /** ElementAspect class names excluded from source queries. */
+    get excludedElementAspectClassFullNames() {
+        return this._excludedElementAspectClassFullNames;
+    }
+    _sourceDb;
+    _handler;
+    constructor(sourceDb, handler) {
+        this._sourceDb = sourceDb;
+        this._handler = handler;
+    }
+    /** Exports ElementAspects owned by the supplied elements.
+     * Multi-aspects are emitted in one callback group per owner.
+     */
+    async exportAllElementAspects(ownerElementIds) {
+        if (ownerElementIds.size === 0 || !(await this.getHasExportableAspects()))
+            return;
+        let multiAspectOwnerId;
+        let multiAspects = [];
+        const exportMultiAspects = async () => {
+            if (multiAspects.length === 0)
+                return;
+            await this._handler.onExportElementMultiAspects(multiAspects);
+            await this._handler.trackProgress();
+            multiAspects = [];
+            multiAspectOwnerId = undefined;
+        };
+        for await (const aspect of this.queryAspects(ownerElementIds)) {
+            if (!(await this._handler.shouldExportElementAspect(aspect)))
+                continue;
+            if (multiAspectOwnerId !== undefined &&
+                multiAspectOwnerId !== aspect.element.id) {
+                await exportMultiAspects();
+            }
+            if (aspect instanceof core_backend_1.ElementUniqueAspect) {
+                const isUpdate = this._aspectChanges?.updateIds.has(aspect.id)
+                    ? true
+                    : this._aspectChanges?.insertIds.has(aspect.id)
+                        ? false
+                        : undefined;
+                await this._handler.onExportElementUniqueAspect(aspect, isUpdate);
+                await this._handler.trackProgress();
+            }
+            else if (aspect instanceof core_backend_1.ElementMultiAspect) {
+                multiAspectOwnerId = aspect.element.id;
+                multiAspects.push(aspect);
+            }
+            else {
+                throw new Error(`Unexpected ElementAspect type ${aspect.classFullName}`);
+            }
+        }
+        await exportMultiAspects();
+    }
+    /** Sets the aspect changes used to distinguish inserted and updated unique aspects during change export. */
+    setAspectChanges(aspectChanges) {
+        this._aspectChanges = aspectChanges;
+    }
+    /** Clears source schema and content caches at an outer export-scope boundary. */
+    resetCaches() {
+        this._hasExportableAspects = undefined;
+    }
+    /** Excludes an ElementAspect class from subsequent queries and export callbacks. */
+    excludeElementAspectClass(classFullName) {
+        if (this._excludedElementAspectClassFullNames.has(classFullName))
+            return;
+        this._excludedElementAspectClassFullNames.add(classFullName);
+        this.resetCaches();
+    }
+    getExcludedClassFilter(queryParams) {
+        const excludedClassParameters = [];
+        let excludedClassIndex = 0;
+        for (const classFullName of this._excludedElementAspectClassFullNames) {
+            const parameterName = `excludedAspectClass${excludedClassIndex++}`;
+            excludedClassParameters.push(`ec_classid(:${parameterName})`);
+            queryParams.bindString(parameterName, classFullName.replace(".", ":"));
+        }
+        return excludedClassParameters.length === 0
+            ? ""
+            : `AND NOT EXISTS (
+          SELECT 1 FROM meta.ClassHasAllBaseClasses excluded
+          WHERE excluded.SourceECInstanceId = aspect.ECClassId
+            AND excluded.TargetECInstanceId IN (${excludedClassParameters.join(",")})
+        )`;
+    }
+    async getHasExportableAspects() {
+        this._hasExportableAspects ??= this.queryHasExportableAspects();
+        return this._hasExportableAspects;
+    }
+    async queryHasExportableAspects() {
+        const queryParams = new core_common_1.QueryBinder();
+        const excludedClassFilter = this.getExcludedClassFilter(queryParams);
+        const reader = this._sourceDb.createQueryReader(`SELECT ECInstanceId FROM (
+         SELECT aspect.ECInstanceId
+         FROM Bis.ElementMultiAspect aspect
+         WHERE TRUE ${excludedClassFilter}
+         UNION ALL
+         SELECT aspect.ECInstanceId
+         FROM Bis.ElementUniqueAspect aspect
+         WHERE TRUE ${excludedClassFilter}
+       )
+       LIMIT 1`, queryParams, { usePrimaryConn: true });
+        for await (const _row of (0, ECSqlReaderAsyncIterableIteratorAdapter_1.ensureECSqlReaderIsAsyncIterableIterator)(reader))
+            return true;
+        return false;
+    }
+    getAspectProps(rawInstance) {
+        const parsedRow = typeof rawInstance === "string"
+            ? JSON.parse(rawInstance, core_common_1.Base64EncodedString.reviver)
+            : rawInstance;
+        if (!core_bentley_1.JsonUtils.isObject(parsedRow))
+            throw new Error("Expected an ElementAspect instance query to return an object");
+        const row = {};
+        for (const [key, value] of Object.entries(parsedRow)) {
+            const ecPropertyName = key.length === 0 ? key : key[0].toUpperCase() + key.substring(1);
+            row[core_common_1.ECJsNames.toJsName(ecPropertyName)] = value;
+        }
+        const className = row.className;
+        if (typeof className !== "string")
+            throw new Error("Expected an ElementAspect instance query to return a className");
+        row.classFullName = className.replace(".", ":");
+        delete row.className;
+        return row;
+    }
+    async *queryAspects(ownerElementIds) {
+        const queryParams = new core_common_1.QueryBinder().bindIdSet("ownerElementIds", ownerElementIds);
+        const excludedClassFilter = this.getExcludedClassFilter(queryParams);
+        const aspectQueryReader = this._sourceDb.createQueryReader(`WITH OwnerIds AS (SELECT id FROM IdSet(:ownerElementIds))
+       SELECT $ FROM (
+         SELECT aspect.ECInstanceId, aspect.ECClassId,
+           aspect.Element.Id AS OwnerId, 1 AS AspectKind
+         FROM OwnerIds owners
+         CROSS JOIN Bis.ElementMultiAspect aspect
+         WHERE aspect.Element.Id = owners.id ${excludedClassFilter}
+         UNION ALL
+         SELECT aspect.ECInstanceId, aspect.ECClassId,
+           aspect.Element.Id AS OwnerId, 0 AS AspectKind
+         FROM OwnerIds owners
+         CROSS JOIN Bis.ElementUniqueAspect aspect
+         WHERE aspect.Element.Id = owners.id ${excludedClassFilter}
+       )
+       ORDER BY AspectKind, OwnerId, ECClassId, ECInstanceId
+       OPTIONS USE_JS_PROP_NAMES DO_NOT_TRUNCATE_BLOB`, queryParams, { usePrimaryConn: true });
+        for await (const rowProxy of (0, ECSqlReaderAsyncIterableIteratorAdapter_1.ensureECSqlReaderIsAsyncIterableIterator)(aspectQueryReader)) {
+            yield this._sourceDb.constructEntity(this.getAspectProps(rowProxy[0]));
+        }
+    }
+}
+exports.ElementAspectExportProcessor = ElementAspectExportProcessor;
+//# sourceMappingURL=ElementAspectExportProcessor.js.map

package/lib/cjs/ElementAspectExportProcessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElementAspectExportProcessor.js","sourceRoot":"","sources":["../../src/ElementAspectExportProcessor.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n\nimport {\n  ElementAspect,\n  ElementMultiAspect,\n  ElementUniqueAspect,\n  IModelDb,\n} from \"@itwin/core-backend\";\nimport { Id64String, JsonUtils } from \"@itwin/core-bentley\";\nimport { ensureECSqlReaderIsAsyncIterableIterator } from \"./ECSqlReaderAsyncIterableIteratorAdapter\";\nimport {\n  Base64EncodedString,\n  ECJsNames,\n  ElementAspectProps,\n  QueryBinder,\n} from \"@itwin/core-common\";\n\ninterface AspectChanges {\n  readonly insertIds: ReadonlySet<Id64String>;\n  readonly updateIds: ReadonlySet<Id64String>;\n}\n\nexport interface ElementAspectExportProcessorHandler {\n  shouldExportElementAspect(aspect: ElementAspect): Promise<boolean>;\n  onExportElementUniqueAspect(\n    uniqueAspect: ElementUniqueAspect,\n    isUpdate?: boolean | undefined\n  ): Promise<void>;\n  onExportElementMultiAspects(\n    multiAspects: ElementMultiAspect[]\n  ): Promise<void>;\n  trackProgress: () => Promise<void>;\n}\n\n/** Queries and exports ElementAspects for accepted source owners, applying class and handler filters and grouping multi-aspects by owner.\n * @internal\n */\nexport class ElementAspectExportProcessor {\n  /** ElementAspect classes excluded from source queries. */\n  private readonly _excludedElementAspectClassFullNames = new Set<string>();\n  private _hasExportableAspects: Promise<boolean> | undefined;\n  private _aspectChanges: AspectChanges | undefined;\n\n  /** ElementAspect class names excluded from source queries. */\n  public get excludedElementAspectClassFullNames(): ReadonlySet<string> {\n    return this._excludedElementAspectClassFullNames;\n  }\n  private readonly _sourceDb: IModelDb;\n  private readonly _handler: ElementAspectExportProcessorHandler;\n\n  public constructor(\n    sourceDb: IModelDb,\n    handler: ElementAspectExportProcessorHandler\n  ) {\n    this._sourceDb = sourceDb;\n    this._handler = handler;\n  }\n\n  /** Exports ElementAspects owned by the supplied elements.\n   * Multi-aspects are emitted in one callback group per owner.\n   */\n  public async exportAllElementAspects(\n    ownerElementIds: ReadonlySet<Id64String>\n  ): Promise<void> {\n    if (ownerElementIds.size === 0 || !(await this.getHasExportableAspects()))\n      return;\n\n    let multiAspectOwnerId: Id64String | undefined;\n    let multiAspects: ElementMultiAspect[] = [];\n    const exportMultiAspects = async () => {\n      if (multiAspects.length === 0) return;\n      await this._handler.onExportElementMultiAspects(multiAspects);\n      await this._handler.trackProgress();\n      multiAspects = [];\n      multiAspectOwnerId = undefined;\n    };\n\n    for await (const aspect of this.queryAspects(ownerElementIds)) {\n      if (!(await this._handler.shouldExportElementAspect(aspect))) continue;\n\n      if (\n        multiAspectOwnerId !== undefined &&\n        multiAspectOwnerId !== aspect.element.id\n      ) {\n        await exportMultiAspects();\n      }\n\n      if (aspect instanceof ElementUniqueAspect) {\n        const isUpdate = this._aspectChanges?.updateIds.has(aspect.id)\n          ? true\n          : this._aspectChanges?.insertIds.has(aspect.id)\n            ? false\n            : undefined;\n        await this._handler.onExportElementUniqueAspect(aspect, isUpdate);\n        await this._handler.trackProgress();\n      } else if (aspect instanceof ElementMultiAspect) {\n        multiAspectOwnerId = aspect.element.id;\n        multiAspects.push(aspect);\n      } else {\n        throw new Error(\n          `Unexpected ElementAspect type ${aspect.classFullName}`\n        );\n      }\n    }\n\n    await exportMultiAspects();\n  }\n\n  /** Sets the aspect changes used to distinguish inserted and updated unique aspects during change export. */\n  public setAspectChanges(aspectChanges?: AspectChanges): void {\n    this._aspectChanges = aspectChanges;\n  }\n\n  /** Clears source schema and content caches at an outer export-scope boundary. */\n  public resetCaches(): void {\n    this._hasExportableAspects = undefined;\n  }\n\n  /** Excludes an ElementAspect class from subsequent queries and export callbacks. */\n  public excludeElementAspectClass(classFullName: string): void {\n    if (this._excludedElementAspectClassFullNames.has(classFullName)) return;\n    this._excludedElementAspectClassFullNames.add(classFullName);\n    this.resetCaches();\n  }\n\n  private getExcludedClassFilter(queryParams: QueryBinder): string {\n    const excludedClassParameters: string[] = [];\n    let excludedClassIndex = 0;\n    for (const classFullName of this._excludedElementAspectClassFullNames) {\n      const parameterName = `excludedAspectClass${excludedClassIndex++}`;\n      excludedClassParameters.push(`ec_classid(:${parameterName})`);\n      queryParams.bindString(parameterName, classFullName.replace(\".\", \":\"));\n    }\n\n    return excludedClassParameters.length === 0\n      ? \"\"\n      : `AND NOT EXISTS (\n          SELECT 1 FROM meta.ClassHasAllBaseClasses excluded\n          WHERE excluded.SourceECInstanceId = aspect.ECClassId\n            AND excluded.TargetECInstanceId IN (${excludedClassParameters.join(\",\")})\n        )`;\n  }\n\n  private async getHasExportableAspects(): Promise<boolean> {\n    this._hasExportableAspects ??= this.queryHasExportableAspects();\n    return this._hasExportableAspects;\n  }\n\n  private async queryHasExportableAspects(): Promise<boolean> {\n    const queryParams = new QueryBinder();\n    const excludedClassFilter = this.getExcludedClassFilter(queryParams);\n    const reader = this._sourceDb.createQueryReader(\n      `SELECT ECInstanceId FROM (\n         SELECT aspect.ECInstanceId\n         FROM Bis.ElementMultiAspect aspect\n         WHERE TRUE ${excludedClassFilter}\n         UNION ALL\n         SELECT aspect.ECInstanceId\n         FROM Bis.ElementUniqueAspect aspect\n         WHERE TRUE ${excludedClassFilter}\n       )\n       LIMIT 1`,\n      queryParams,\n      { usePrimaryConn: true }\n    );\n\n    for await (const _row of ensureECSqlReaderIsAsyncIterableIterator(reader))\n      return true;\n    return false;\n  }\n\n  private getAspectProps(rawInstance: unknown): ElementAspectProps {\n    const parsedRow: unknown =\n      typeof rawInstance === \"string\"\n        ? JSON.parse(rawInstance, Base64EncodedString.reviver)\n        : rawInstance;\n    if (!JsonUtils.isObject(parsedRow))\n      throw new Error(\n        \"Expected an ElementAspect instance query to return an object\"\n      );\n\n    const row: Record<string, unknown> = {};\n    for (const [key, value] of Object.entries(parsedRow)) {\n      const ecPropertyName =\n        key.length === 0 ? key : key[0].toUpperCase() + key.substring(1);\n      row[ECJsNames.toJsName(ecPropertyName)] = value;\n    }\n\n    const className = row.className;\n    if (typeof className !== \"string\")\n      throw new Error(\n        \"Expected an ElementAspect instance query to return a className\"\n      );\n\n    row.classFullName = className.replace(\".\", \":\");\n    delete row.className;\n    return row as unknown as ElementAspectProps;\n  }\n\n  private async *queryAspects(\n    ownerElementIds: ReadonlySet<Id64String>\n  ): AsyncIterableIterator<ElementAspect> {\n    const queryParams = new QueryBinder().bindIdSet(\n      \"ownerElementIds\",\n      ownerElementIds\n    );\n    const excludedClassFilter = this.getExcludedClassFilter(queryParams);\n    const aspectQueryReader = this._sourceDb.createQueryReader(\n      `WITH OwnerIds AS (SELECT id FROM IdSet(:ownerElementIds))\n       SELECT $ FROM (\n         SELECT aspect.ECInstanceId, aspect.ECClassId,\n           aspect.Element.Id AS OwnerId, 1 AS AspectKind\n         FROM OwnerIds owners\n         CROSS JOIN Bis.ElementMultiAspect aspect\n         WHERE aspect.Element.Id = owners.id ${excludedClassFilter}\n         UNION ALL\n         SELECT aspect.ECInstanceId, aspect.ECClassId,\n           aspect.Element.Id AS OwnerId, 0 AS AspectKind\n         FROM OwnerIds owners\n         CROSS JOIN Bis.ElementUniqueAspect aspect\n         WHERE aspect.Element.Id = owners.id ${excludedClassFilter}\n       )\n       ORDER BY AspectKind, OwnerId, ECClassId, ECInstanceId\n       OPTIONS USE_JS_PROP_NAMES DO_NOT_TRUNCATE_BLOB`,\n      queryParams,\n      { usePrimaryConn: true }\n    );\n\n    for await (const rowProxy of ensureECSqlReaderIsAsyncIterableIterator(\n      aspectQueryReader\n    )) {\n      yield this._sourceDb.constructEntity<ElementAspect>(\n        this.getAspectProps(rowProxy[0])\n      );\n    }\n  }\n}\n"]}

package/lib/cjs/ElementCascadingDeleter.d.ts

@@ -1,13 +1,13 @@
 /** @packageDocumentation
  * @module iModels
  */
-import { ElementTreeDeleter, ElementTreeWalkerScope, IModelDb } from "@itwin/core-backend";
+import { EditTxn, ElementTreeDeleter, ElementTreeWalkerScope } from "@itwin/core-backend";
 import { Id64String } from "@itwin/core-bentley";
 /** Deletes an element tree and code scope references starting with the specified top element. The top element is also deleted. Uses ElementCascadeDeleter.
- * @param iModel The iModel
+ * @param editTxn The active EditTxn for the iModel
  * @param topElement The parent of the sub-tree
  */
-export declare function deleteElementTreeCascade(iModel: IModelDb, topElement: Id64String): void;
+export declare function deleteElementTreeCascade(editTxn: EditTxn, topElement: Id64String): void;
 /** Deletes an entire element tree, including sub-models, child elements and code scope references.
  * Items are deleted in bottom-up order. Definitions and Subjects are deleted after normal elements.
  * Call deleteNormalElements on each tree. Then call deleteSpecialElements.

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

@@ -1 +1 @@
-{"version":3,"file":"ElementCascadingDeleter.d.ts","sourceRoot":"","sources":["../../src/ElementCascadingDeleter.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,QAAQ,EACT,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAY,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE3D;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,QAAQ,EAChB,UAAU,EAAE,UAAU,GACrB,IAAI,CAIN;AAED;;;GAGG;AACH,qBAAa,uBAAwB,SAAQ,kBAAkB;IAC7D,SAAS,CAAC,qBAAqB,CAC7B,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,sBAAsB;IAKhC,qCAAqC;cAClB,kBAAkB,CACnC,OAAO,EAAE,UAAU,EACnB,KAAK,EAAE,sBAAsB,GAC5B,IAAI;IAMP,oCAAoC;IACpC,OAAO,CAAC,kBAAkB;CAsB3B"}
+{"version":3,"file":"ElementCascadingDeleter.d.ts","sourceRoot":"","sources":["../../src/ElementCascadingDeleter.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,OAAO,EACL,OAAO,EACP,kBAAkB,EAClB,sBAAsB,EACvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGjD;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,UAAU,GACrB,IAAI,CAIN;AAED;;;GAGG;AACH,qBAAa,uBAAwB,SAAQ,kBAAkB;IAC7D,SAAS,CAAC,qBAAqB,CAC7B,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,sBAAsB,WAG/B;IAED,qCAAqC;IACrC,UAAmB,kBAAkB,CACnC,OAAO,EAAE,UAAU,EACnB,KAAK,EAAE,sBAAsB,GAC5B,IAAI,CAKN;IACD,oCAAoC;IACpC,OAAO,CAAC,kBAAkB;CAyB3B"}

package/lib/cjs/ElementCascadingDeleter.js

@@ -10,13 +10,13 @@ exports.deleteElementTreeCascade = deleteElementTreeCascade;
  * @module iModels
  */
 const core_backend_1 = require("@itwin/core-backend");
-const core_bentley_1 = require("@itwin/core-bentley");
+const core_common_1 = require("@itwin/core-common");
 /** Deletes an element tree and code scope references starting with the specified top element. The top element is also deleted. Uses ElementCascadeDeleter.
- * @param iModel The iModel
+ * @param editTxn The active EditTxn for the iModel
  * @param topElement The parent of the sub-tree
  */
-function deleteElementTreeCascade(iModel, topElement) {
-    const del = new ElementCascadingDeleter(iModel);
+function deleteElementTreeCascade(editTxn, topElement) {
+    const del = new ElementCascadingDeleter(editTxn);
     del.deleteNormalElements(topElement);
     del.deleteSpecialElements();
 }
@@ -38,19 +38,19 @@ class ElementCascadingDeleter extends core_backend_1.ElementTreeDeleter {
     /** Process code scope references */
     _processCodeScopes(element, scope) {
         const newScope = new core_backend_1.ElementTreeWalkerScope(scope, element);
-        // eslint-disable-next-line @itwin/no-internal, @typescript-eslint/no-deprecated
-        this._iModel.withPreparedStatement(`
+        const query = `
       SELECT ECInstanceId
       FROM bis.Element
-      WHERE CodeScope.id=?
+      WHERE CodeScope.id=:scopeId
         AND Parent.id IS NULL
-    `, (stmt) => {
-            stmt.bindId(1, element);
-            while (stmt.step() === core_bentley_1.DbResult.BE_SQLITE_ROW) {
-                const elementId = stmt.getValue(0).getId();
+    `;
+        const params = new core_common_1.QueryBinder().bindId("scopeId", element);
+        this.txn.iModel.withQueryReader(query, (reader) => {
+            for (const row of reader) {
+                const elementId = row[0];
                 this.processElementTree(elementId, newScope);
             }
-        });
+        }, params);
     }
 }
 exports.ElementCascadingDeleter = ElementCascadingDeleter;

package/lib/cjs/ElementCascadingDeleter.js.map

@@ -1 +1 @@
-{"version":3,"file":"ElementCascadingDeleter.js","sourceRoot":"","sources":["../../src/ElementCascadingDeleter.ts"],"names":[],"mappings":";;;AAkBA,4DAOC;AAzBD;;;gGAGgG;AAChG;;GAEG;AACH,sDAI6B;AAC7B,sDAA2D;AAE3D;;;GAGG;AACH,SAAgB,wBAAwB,CACtC,MAAgB,EAChB,UAAsB;IAEtB,MAAM,GAAG,GAAG,IAAI,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAChD,GAAG,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACrC,GAAG,CAAC,qBAAqB,EAAE,CAAC;AAC9B,CAAC;AAED;;;GAGG;AACH,MAAa,uBAAwB,SAAQ,iCAAkB;IACnD,qBAAqB,CAC7B,UAAsB,EACtB,MAA8B;QAE9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,qCAAqC;IAClB,kBAAkB,CACnC,OAAmB,EACnB,KAA6B;QAE7B,IAAI,IAAI,CAAC,qBAAqB,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC;YAC/C,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC1C,CAAC;QACD,KAAK,CAAC,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;IACD,oCAAoC;IAC5B,kBAAkB,CACxB,OAAmB,EACnB,KAA6B;QAE7B,MAAM,QAAQ,GAAG,IAAI,qCAAsB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC5D,gFAAgF;QAChF,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAChC;;;;;KAKD,EACC,CAAC,IAAI,EAAE,EAAE;YACP,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YACxB,OAAO,IAAI,CAAC,IAAI,EAAE,KAAK,uBAAQ,CAAC,aAAa,EAAE,CAAC;gBAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;gBAC3C,IAAI,CAAC,kBAAkB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC;CACF;AAzCD,0DAyCC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module iModels\n */\nimport {\n  ElementTreeDeleter,\n  ElementTreeWalkerScope,\n  IModelDb,\n} from \"@itwin/core-backend\";\nimport { DbResult, Id64String } from \"@itwin/core-bentley\";\n\n/** Deletes an element tree and code scope references starting with the specified top element. The top element is also deleted. Uses ElementCascadeDeleter.\n * @param iModel The iModel\n * @param topElement The parent of the sub-tree\n */\nexport function deleteElementTreeCascade(\n  iModel: IModelDb,\n  topElement: Id64String\n): void {\n  const del = new ElementCascadingDeleter(iModel);\n  del.deleteNormalElements(topElement);\n  del.deleteSpecialElements();\n}\n\n/** Deletes an entire element tree, including sub-models, child elements and code scope references.\n * Items are deleted in bottom-up order. Definitions and Subjects are deleted after normal elements.\n * Call deleteNormalElements on each tree. Then call deleteSpecialElements.\n */\nexport class ElementCascadingDeleter extends ElementTreeDeleter {\n  protected shouldVisitCodeScopes(\n    _elementId: Id64String,\n    _scope: ElementTreeWalkerScope\n  ) {\n    return true;\n  }\n\n  /** The main tree-walking function */\n  protected override processElementTree(\n    element: Id64String,\n    scope: ElementTreeWalkerScope\n  ): void {\n    if (this.shouldVisitCodeScopes(element, scope)) {\n      this._processCodeScopes(element, scope);\n    }\n    super.processElementTree(element, scope);\n  }\n  /** Process code scope references */\n  private _processCodeScopes(\n    element: Id64String,\n    scope: ElementTreeWalkerScope\n  ) {\n    const newScope = new ElementTreeWalkerScope(scope, element);\n    // eslint-disable-next-line @itwin/no-internal, @typescript-eslint/no-deprecated\n    this._iModel.withPreparedStatement(\n      `\n      SELECT ECInstanceId\n      FROM bis.Element\n      WHERE CodeScope.id=?\n        AND Parent.id IS NULL\n    `,\n      (stmt) => {\n        stmt.bindId(1, element);\n        while (stmt.step() === DbResult.BE_SQLITE_ROW) {\n          const elementId = stmt.getValue(0).getId();\n          this.processElementTree(elementId, newScope);\n        }\n      }\n    );\n  }\n}\n"]}
+{"version":3,"file":"ElementCascadingDeleter.js","sourceRoot":"","sources":["../../src/ElementCascadingDeleter.ts"],"names":[],"mappings":";;;;AAAA;;;gGAGgG;AAChG;;GAEG;AACH,sDAI6B;AAE7B,oDAAiD;AAEjD;;;GAGG;AACH,kCACE,OAAgB,EAChB,UAAsB;IAEtB,MAAM,GAAG,GAAG,IAAI,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACjD,GAAG,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACrC,GAAG,CAAC,qBAAqB,EAAE,CAAC;AAC9B,CAAC;AAED;;;GAGG;AACH,6BAAqC,SAAQ,iCAAkB;IACnD,qBAAqB,CAC7B,UAAsB,EACtB,MAA8B;QAE9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,qCAAqC;IAClB,kBAAkB,CACnC,OAAmB,EACnB,KAA6B;QAE7B,IAAI,IAAI,CAAC,qBAAqB,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC;YAC/C,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC1C,CAAC;QACD,KAAK,CAAC,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;IACD,oCAAoC;IAC5B,kBAAkB,CACxB,OAAmB,EACnB,KAA6B;QAE7B,MAAM,QAAQ,GAAG,IAAI,qCAAsB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC5D,MAAM,KAAK,GAAG;;;;;KAKb,CAAC;QAEF,MAAM,MAAM,GAAG,IAAI,yBAAW,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAE5D,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,eAAe,CAC7B,KAAK,EACL,CAAC,MAAM,EAAE,EAAE;YACT,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;gBACzB,MAAM,SAAS,GAAG,GAAG,CAAC,CAAC,CAAe,CAAC;gBACvC,IAAI,CAAC,kBAAkB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC,EACD,MAAM,CACP,CAAC;IACJ,CAAC;CACF","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module iModels\n */\nimport {\n  EditTxn,\n  ElementTreeDeleter,\n  ElementTreeWalkerScope,\n} from \"@itwin/core-backend\";\nimport { Id64String } from \"@itwin/core-bentley\";\nimport { QueryBinder } from \"@itwin/core-common\";\n\n/** Deletes an element tree and code scope references starting with the specified top element. The top element is also deleted. Uses ElementCascadeDeleter.\n * @param editTxn The active EditTxn for the iModel\n * @param topElement The parent of the sub-tree\n */\nexport function deleteElementTreeCascade(\n  editTxn: EditTxn,\n  topElement: Id64String\n): void {\n  const del = new ElementCascadingDeleter(editTxn);\n  del.deleteNormalElements(topElement);\n  del.deleteSpecialElements();\n}\n\n/** Deletes an entire element tree, including sub-models, child elements and code scope references.\n * Items are deleted in bottom-up order. Definitions and Subjects are deleted after normal elements.\n * Call deleteNormalElements on each tree. Then call deleteSpecialElements.\n */\nexport class ElementCascadingDeleter extends ElementTreeDeleter {\n  protected shouldVisitCodeScopes(\n    _elementId: Id64String,\n    _scope: ElementTreeWalkerScope\n  ) {\n    return true;\n  }\n\n  /** The main tree-walking function */\n  protected override processElementTree(\n    element: Id64String,\n    scope: ElementTreeWalkerScope\n  ): void {\n    if (this.shouldVisitCodeScopes(element, scope)) {\n      this._processCodeScopes(element, scope);\n    }\n    super.processElementTree(element, scope);\n  }\n  /** Process code scope references */\n  private _processCodeScopes(\n    element: Id64String,\n    scope: ElementTreeWalkerScope\n  ) {\n    const newScope = new ElementTreeWalkerScope(scope, element);\n    const query = `\n      SELECT ECInstanceId\n      FROM bis.Element\n      WHERE CodeScope.id=:scopeId\n        AND Parent.id IS NULL\n    `;\n\n    const params = new QueryBinder().bindId(\"scopeId\", element);\n\n    this.txn.iModel.withQueryReader(\n      query,\n      (reader) => {\n        for (const row of reader) {\n          const elementId = row[0] as Id64String;\n          this.processElementTree(elementId, newScope);\n        }\n      },\n      params\n    );\n  }\n}\n"]}

package/lib/cjs/EntityExistenceCache.d.ts

@@ -0,0 +1,43 @@
+/** @packageDocumentation
+ * @module Utils
+ */
+import { EntityReference } from "@itwin/core-common";
+import { IModelDb } from "@itwin/core-backend";
+/** A positive-only read-through cache of entity existence checks, scoped to a single transformation run.
+ *
+ * Entities are created continuously as a transformation progresses, so a negative
+ * ("does not exist") result may become stale at any moment — therefore only positive
+ * results are ever cached. Positive results can only be invalidated by deletes, which the
+ * transformer routes through [[invalidate]] and [[clearDb]].
+ *
+ * The cache is keyed by [IModelDb]($core-backend) instance, so same-iModel transformations
+ * (where sourceDb === targetDb) share a single set and source/target roles cannot be confused.
+ *
+ * [IModelImporter]($transformer) delete operations invalidate registered caches. Deletes performed
+ * directly through an `EditTxn` while a transformation is active are out-of-band and must not be
+ * mixed with transformer operations. A successful high-level `process()` clears the cache when the
+ * transformation finalizes; low-level or failed transformations clear it when the transformer is
+ * disposed.
+ * @internal
+ */
+export declare class EntityExistenceCache {
+    private _existsByDb;
+    private getDbSet;
+    /** Check whether an entity exists in `db`, consulting the cache first.
+     * A `true` result is cached; a `false` result is never cached and will be re-queried.
+     */
+    exists(db: IModelDb, entityReference: EntityReference): Promise<boolean>;
+    /** Read through the cache to check which of the supplied entities exist in `db`, populating it on a miss. */
+    existsAll(db: IModelDb, entityReferences: Iterable<EntityReference>): Promise<ReadonlySet<EntityReference>>;
+    /** Record that an entity is known to exist in `db` (e.g. it was just imported). */
+    markExists(db: IModelDb, entityReference: EntityReference): void;
+    /** Remove a single entity from the cache for `db`, forcing a re-query on next check. */
+    invalidate(db: IModelDb, entityReference: EntityReference): void;
+    /** Drop all cached results for `db`. Used when a delete may cascade to entities the
+     * caller cannot enumerate (e.g. element tree deletes that remove descendants and submodels).
+     */
+    clearDb(db: IModelDb): void;
+    /** Drop all cached results. */
+    clear(): void;
+}
+//# sourceMappingURL=EntityExistenceCache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EntityExistenceCache.d.ts","sourceRoot":"","sources":["../../src/EntityExistenceCache.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAG/C;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,WAAW,CAA6C;IAEhE,OAAO,CAAC,QAAQ;IAShB;;OAEG;IACU,MAAM,CACjB,EAAE,EAAE,QAAQ,EACZ,eAAe,EAAE,eAAe,GAC/B,OAAO,CAAC,OAAO,CAAC,CAMlB;IAED,6GAA6G;IAChG,SAAS,CACpB,EAAE,EAAE,QAAQ,EACZ,gBAAgB,EAAE,QAAQ,CAAC,eAAe,CAAC,GAC1C,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC,CAkBvC;IAED,mFAAmF;IAC5E,UAAU,CAAC,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,eAAe,GAAG,IAAI,CAEtE;IAED,wFAAwF;IACjF,UAAU,CAAC,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,eAAe,GAAG,IAAI,CAEtE;IAED;;OAEG;IACI,OAAO,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAEjC;IAED,+BAA+B;IACxB,KAAK,IAAI,IAAI,CAEnB;CACF"}