@itwin/core-backend 5.15.0-dev.1 → 5.15.0-dev.3

package/lib/esm/test/ecdb/ECSqlSyncReader.test.js

@@ -56,6 +56,7 @@ var __disposeResources = (this && this.__disposeResources) || (function (Suppres
 });
 import { assert, expect } from "chai";
 import * as sinon from "sinon";
+import * as path from "node:path";
 import { QueryBinder, QueryOptionsBuilder, QueryRowFormat } from "@itwin/core-common";
 import { SnapshotDb } from "../../IModelDb";
 import { IModelTestUtils } from "../IModelTestUtils";
@@ -63,6 +64,8 @@ import { Id64 } from "@itwin/core-bentley";
 import { ECSqlStatement } from "../../ECSqlStatement";
 import { ECDbTestHelper } from "./ECDbTestHelper";
 import { KnownTestLocations } from "../KnownTestLocations";
+import { IModelNative } from "../../internal/NativePlatform";
+import { IModelJsFs } from "../../IModelJsFs";
 describe("WithQueryReaderTests", () => {
     let iModel;
     before(async () => {
@@ -257,5 +260,142 @@ describe("WithQueryReaderTests", () => {
             }
         });
     });
+    describe("metadata caching", () => {
+        // Column metadata depends only on the prepared statement and the row-adaptor options, so it is cached
+        // on the cached ECSqlStatement instead of being fetched from native code on every withQueryReader call.
+        const sql = "SELECT ECInstanceId, ECClassId, CodeValue, GeometryStream FROM bis.GeometricElement3d WHERE ECInstanceId=?";
+        let elementId;
+        before(() => {
+            elementId = iModel.withQueryReader("SELECT ECInstanceId FROM bis.GeometricElement3d WHERE GeometryStream IS NOT NULL LIMIT 1", (reader) => {
+                assert.isTrue(reader.step());
+                return reader.current[0];
+            });
+        });
+        afterEach(() => sinon.restore());
+        function readMetadata(options) {
+            return iModel.withQueryReader(sql, (reader) => {
+                assert.isTrue(reader.step());
+                return { meta: reader.getMetaData(), row: reader.current.toRow() };
+            }, new QueryBinder().bindId(1, elementId), options);
+        }
+        it("returns metadata matching the row options when the same statement is reused with different options", () => {
+            const optionSets = [
+                // eslint-disable-next-line @typescript-eslint/no-deprecated
+                { rowFormat: QueryRowFormat.UseJsPropertyNames },
+                { rowFormat: QueryRowFormat.UseECSqlPropertyNames },
+                // eslint-disable-next-line @typescript-eslint/no-deprecated
+                { rowFormat: QueryRowFormat.UseJsPropertyNames, abbreviateBlobs: true },
+                { rowFormat: QueryRowFormat.UseECSqlPropertyNames, abbreviateBlobs: true },
+                { rowFormat: QueryRowFormat.UseECSqlPropertyNames, convertClassIdsToClassNames: true },
+            ];
+            // Expected metadata comes from a freshly prepared statement for each option set.
+            const expected = optionSets.map((options) => {
+                iModel.clearCaches();
+                return readMetadata({ ...options }).meta;
+            });
+            expect(expected[0].map((p) => p.jsonName)).to.deep.equal(["id", "className", "codeValue", "geometryStream"]);
+            expect(expected[1].map((p) => p.name)).to.deep.equal(["ECInstanceId", "ECClassId", "CodeValue", "GeometryStream"]);
+            iModel.clearCaches();
+            for (let pass = 0; pass < 2; pass++) {
+                optionSets.forEach((options, i) => {
+                    const { meta, row } = readMetadata({ ...options });
+                    expect(meta).to.deep.equal(expected[i]);
+                    const geometryStream = row[options.rowFormat === QueryRowFormat.UseECSqlPropertyNames ? "GeometryStream" : "geometryStream"];
+                    if (options.abbreviateBlobs)
+                        expect(geometryStream).to.be.a("string").and.match(/^\{"bytes":\d+\}$/);
+                    else
+                        expect(geometryStream).to.be.instanceOf(Uint8Array);
+                });
+            }
+        });
+        it("fetches native metadata once per statement and row options", () => {
+            // Native prototype methods cannot be spied on directly, so count calls through a subclass.
+            const getMetadataSpy = sinon.spy();
+            const nativeStatement = IModelNative.platform.ECSqlStatement;
+            sinon.replace(IModelNative.platform, "ECSqlStatement", class extends nativeStatement {
+                getMetadata(...args) {
+                    getMetadataSpy();
+                    return super.getMetadata(...args);
+                }
+            });
+            iModel.clearCaches();
+            const options = { rowFormat: QueryRowFormat.UseECSqlPropertyNames };
+            for (let i = 0; i < 10; i++)
+                readMetadata({ ...options });
+            expect(getMetadataSpy.callCount).to.equal(1);
+            readMetadata({ ...options, abbreviateBlobs: true });
+            readMetadata({ ...options, abbreviateBlobs: true });
+            expect(getMetadataSpy.callCount).to.equal(2, "different row options need their own metadata");
+            iModel.clearCaches();
+            readMetadata({ ...options });
+            expect(getMetadataSpy.callCount).to.equal(3, "a re-prepared statement must not reuse cached metadata");
+        });
+        it("does not share metadata objects between calls", () => {
+            iModel.clearCaches();
+            const options = { rowFormat: QueryRowFormat.UseECSqlPropertyNames };
+            const expected = structuredClone(readMetadata({ ...options }).meta);
+            iModel.withQueryReader(sql, (reader) => {
+                assert.isTrue(reader.step());
+                const readerMeta = reader.getMetaData();
+                readerMeta[0].name = "Changed";
+                readerMeta[0].index = 3;
+                readerMeta.reverse();
+                const proxyMeta = reader.current.getMetaData();
+                proxyMeta.push({ ...proxyMeta[0], name: "Extra" });
+            }, new QueryBinder().bindId(1, elementId), options);
+            const { meta, row } = readMetadata({ ...options });
+            expect(meta).to.deep.equal(expected);
+            expect(row.ECInstanceId).to.equal(elementId);
+        });
+        it("returns metadata for queries that produce no rows", () => {
+            iModel.clearCaches();
+            const options = { rowFormat: QueryRowFormat.UseECSqlPropertyNames };
+            const expected = readMetadata({ ...options }).meta;
+            for (let i = 0; i < 3; i++) {
+                iModel.withQueryReader(sql, (reader) => {
+                    expect(reader.step()).to.be.false;
+                    expect(reader.getMetaData()).to.deep.equal(expected);
+                }, new QueryBinder().bindId(1, "0xffffff"), options);
+                iModel.withQueryReader(sql, (reader) => {
+                    expect(reader.getMetaData()).to.deep.equal(expected);
+                    expect(reader.toArray()).to.deep.equal([]);
+                }, new QueryBinder().bindId(1, "0xffffff"), options);
+            }
+        });
+        it("reflects a schema import between calls", () => {
+            const env_2 = { stack: [], error: void 0, hasError: false };
+            try {
+                const schemaXml = (version, extraProperty) => `<ECSchema schemaName="Test" alias="ts" version="${version}" xmlns="http://www.bentley.com/schemas/Bentley.ECXML.3.2">
+          <ECEntityClass typeName="Foo" modifier="Sealed">
+            <ECProperty propertyName="n" typeName="int"/>
+            ${extraProperty}
+          </ECEntityClass>
+        </ECSchema>`;
+                const ecdb = __addDisposableResource(env_2, ECDbTestHelper.createECDb(KnownTestLocations.outputDir, "syncReaderMetadataCache.ecdb", schemaXml("01.00.00", "")), false);
+                ecdb.withCachedWriteStatement("INSERT INTO ts.Foo(n) VALUES(1)", (stmt) => stmt.stepForInsert());
+                ecdb.saveChanges();
+                const fooSql = "SELECT * FROM ts.Foo";
+                const options = { rowFormat: QueryRowFormat.UseECSqlPropertyNames };
+                const readNames = () => ecdb.withQueryReader(fooSql, (reader) => {
+                    assert.isTrue(reader.step());
+                    return reader.getMetaData().map((p) => p.name);
+                }, undefined, options);
+                expect(readNames()).to.deep.equal(["ECInstanceId", "ECClassId", "n"]);
+                expect(readNames()).to.deep.equal(["ECInstanceId", "ECClassId", "n"]);
+                const schemaPath = path.join(KnownTestLocations.outputDir, "syncReaderMetadataCache.ecschema.xml");
+                IModelJsFs.writeFileSync(schemaPath, schemaXml("01.00.01", `<ECProperty propertyName="m" typeName="string"/>`));
+                ecdb.importSchema(schemaPath);
+                ecdb.saveChanges();
+                expect(readNames()).to.deep.equal(["ECInstanceId", "ECClassId", "n", "m"]);
+            }
+            catch (e_2) {
+                env_2.error = e_2;
+                env_2.hasError = true;
+            }
+            finally {
+                __disposeResources(env_2);
+            }
+        });
+    });
 });
 //# sourceMappingURL=ECSqlSyncReader.test.js.map

package/lib/esm/test/ecdb/ECSqlSyncReader.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"ECSqlSyncReader.test.js","sourceRoot":"","sources":["../../../../src/test/ecdb/ECSqlSyncReader.test.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\nimport { assert, expect } from \"chai\";\r\nimport * as sinon from \"sinon\";\r\nimport { QueryBinder, QueryOptionsBuilder, QueryRowFormat } from \"@itwin/core-common\";\r\nimport { SnapshotDb } from \"../../IModelDb\";\r\nimport { IModelTestUtils } from \"../IModelTestUtils\";\r\nimport { Id64 } from \"@itwin/core-bentley\";\r\nimport { ECSqlStatement } from \"../../ECSqlStatement\";\r\nimport { ECDbTestHelper } from \"./ECDbTestHelper\";\r\nimport { KnownTestLocations } from \"../KnownTestLocations\";\r\n\r\ndescribe(\"WithQueryReaderTests\", () => {\r\n  let iModel: SnapshotDb;\r\n\r\n  before(async () => {\r\n    iModel = SnapshotDb.openFile(IModelTestUtils.resolveAssetFile(\"test.bim\"));\r\n  });\r\n\r\n  after(async () => {\r\n    iModel.close();\r\n  });\r\n  it(\"check behvaiour if we call clearCaches in between\", () => {\r\n    let actualRowCount = 0;\r\n    const expectedInstanceIds = [\"0x1\", \"0xe\", \"0x10\", \"0x11\", \"0x12\",\r\n      \"0x13\", \"0x14\", \"0x15\", \"0x16\", \"0x17\"];\r\n\r\n    expect(() => iModel.withQueryReader(\"SELECT * FROM bis.Element\", (reader) => {\r\n      let loopCount = 0;\r\n      // First loop - read first 10 rows\r\n      while (loopCount < 10) {\r\n        reader.step()\r\n        actualRowCount++;\r\n        loopCount++;\r\n        assert.isDefined(reader.current[0]);\r\n        assert.equal(reader.current[0], expectedInstanceIds[actualRowCount - 1]);\r\n      }\r\n      assert.equal(loopCount, 10);\r\n      iModel.clearCaches();\r\n\r\n      reader.step(); // step should fail after clearCaches\r\n    })).to.throw(\"Step failed\");\r\n  });\r\n  it(\"should throw error if we try to step on a closed iModelDb object\", () => {\r\n    const imodelPath = iModel.pathName;\r\n    expect(() => iModel.withQueryReader(\"SELECT * FROM bis.Element\", (reader) => {\r\n      let loopCount = 0;\r\n      while (loopCount < 10) {\r\n        reader.step();\r\n        assert.isDefined(reader.current[0]);\r\n        loopCount++;\r\n      }\r\n      assert.equal(loopCount, 10);\r\n      iModel.close();\r\n\r\n      iModel = SnapshotDb.openFile(imodelPath);\r\n      assert.isDefined(reader.current[0]);\r\n      reader.step(); // step should fail after iModelDb is closed\r\n    })).to.throw(\"Statement is not prepared\");\r\n  });\r\n  it(\"returning reader from withQueryReader callback should throw error if we try to step on it\", () => {\r\n    const readerObj = iModel.withQueryReader(\"SELECT * FROM bis.Element\", (reader) => {\r\n      reader.step();\r\n      return reader;\r\n    });\r\n    expect(readerObj.current[0]).to.equal(\"0x1\"); // will not throw error as we are just accessing current row\r\n    expect(() => readerObj.step()).to.throw(\"Statement is not prepared\");\r\n  });\r\n  it(\"checking rowFormat unspecified case - values accessed by index\", () => {\r\n    // Default rowFormat is UseECSqlPropertyIndexes: columns are accessed by their SELECT-order index.\r\n    iModel.withQueryReader(\"SELECT ECInstanceId, ECClassId FROM bis.Element\", (reader) => {\r\n      assert.isTrue(reader.step());\r\n      const id: string = reader.current[0];\r\n      const classId: string = reader.current[1];\r\n      assert.isTrue(Id64.isValid(classId));\r\n      assert.isTrue(Id64.isValid(id));\r\n      assert.equal(id, \"0x19\");\r\n    });\r\n  });\r\n\r\n  it(\"checking rowFormat UseECSqlPropertyIndexes - values accessed by index\", () => {\r\n    const config = new QueryOptionsBuilder().setRowFormat(QueryRowFormat.UseECSqlPropertyIndexes).getOptions();\r\n    iModel.withQueryReader(\"SELECT ECInstanceId, ECClassId FROM bis.Element\", (reader) => {\r\n      assert.isTrue(reader.step());\r\n      // Index 0 → ECInstanceId, index 1 → ECClassId\r\n      const id: string = reader.current[0];\r\n      const classId: string = reader.current[1];\r\n      assert.equal(id, \"0x19\");\r\n      assert.isTrue(Id64.isValid(classId));\r\n      // Swapping column order changes index, not value\r\n    }, undefined, config);\r\n  });\r\n\r\n  it(\"checking rowFormat UseECSqlPropertyNames - values accessed by ECSQL property name\", () => {\r\n    const config = new QueryOptionsBuilder().setRowFormat(QueryRowFormat.UseECSqlPropertyNames).getOptions();\r\n    iModel.withQueryReader(\"SELECT ECInstanceId, ECClassId FROM bis.Element\", (reader) => {\r\n      assert.isTrue(reader.step());\r\n      const id: string = reader.current.ECInstanceId;\r\n      const classId: string = reader.current.ECClassId;\r\n      assert.equal(id, \"0x19\");\r\n      assert.isTrue(Id64.isValid(classId));\r\n    }, undefined, config);\r\n  });\r\n\r\n  it(\"checking rowFormat UseJsPropertyNames - values accessed by JavaScript property name\", () => {\r\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\r\n    const config = new QueryOptionsBuilder().setRowFormat(QueryRowFormat.UseJsPropertyNames).getOptions();\r\n    iModel.withQueryReader(\"SELECT ECInstanceId, ECClassId FROM bis.Element\", (reader) => {\r\n      assert.isTrue(reader.step());\r\n      // ECInstanceId → id, ECClassId → className (resolved to a fully-qualified class name string)\r\n      const id: string = reader.current.id;\r\n      const className: string = reader.current.className;\r\n      assert.equal(id, \"0x19\");\r\n      // className should be in the form \"SchemaName.ClassName\"\r\n      assert.equal(className, \"BisCore.DrawingCategory\");\r\n    }, undefined, config);\r\n  });\r\n\r\n  it(\"checking rowFormat UseECSqlPropertyNames with convertClassIdsToClassNames - ECClassId returned as class name string\", () => {\r\n    const config = new QueryOptionsBuilder()\r\n      .setRowFormat(QueryRowFormat.UseECSqlPropertyNames)\r\n      // eslint-disable-next-line @typescript-eslint/no-deprecated\r\n      .setConvertClassIdsToNames(true)\r\n      .getOptions();\r\n    iModel.withQueryReader(\"SELECT ECInstanceId, ECClassId FROM bis.Element\", (reader) => {\r\n      assert.isTrue(reader.step());\r\n      const id: string = reader.current.ECInstanceId;\r\n      const classId: string = reader.current.ECClassId;\r\n      assert.equal(id, \"0x19\");\r\n      // With convertClassIdsToClassNames, ECClassId is resolved to \"SchemaName.ClassName\" instead of an Id\r\n      assert.equal(classId, \"BisCore.DrawingCategory\");\r\n    }, undefined, config);\r\n  });\r\n\r\n  describe(\"statement caching (regression)\", () => {\r\n    // `withQueryReader` used to build a fresh `ECSqlStatement` and re-compile the ECSQL on every\r\n    // call (via `ECSqlRowExecutor`), with no caching. Callers such as `IModelTransformer` invoke\r\n    // per-element helpers (e.g. `hasSubModel`) once per element, so on large models this turned one\r\n    // cached ECSQL prepare into N full native compiles - a significant performance regression. The\r\n    // reader now reuses a prepared statement from the owning db's `_statementCache`.\r\n    const sql = \"SELECT ECInstanceId FROM bis.Element WHERE ECInstanceId=?\";\r\n\r\n    afterEach(() => sinon.restore());\r\n\r\n    it(\"reuses a single prepared statement across repeated calls instead of re-preparing\", () => {\r\n      iModel.clearCaches();\r\n      const prepareSpy = sinon.spy(ECSqlStatement.prototype, \"prepare\"); // eslint-disable-line @typescript-eslint/no-deprecated\r\n      for (let i = 0; i < 20; i++) {\r\n        iModel.withQueryReader(sql, (reader) => {\r\n          reader.step();\r\n        }, new QueryBinder().bindId(1, \"0x1\"));\r\n      }\r\n      expect(prepareSpy.callCount).to.equal(1, \"queries with identical ECSQL text should re-use one cached prepared statement\");\r\n    });\r\n\r\n    it(\"keeps nested withQueryReader calls on the same SQL independent\", () => {\r\n      iModel.clearCaches();\r\n      // A nested reader on the same SQL must get its own statement (findAndRemove hands the outer\r\n      // reader's statement out of the cache), so results do not corrupt each other.\r\n      const outerId = iModel.withQueryReader(sql, (outer) => {\r\n        assert.isTrue(outer.step());\r\n        const innerId = iModel.withQueryReader(sql, (inner) => {\r\n          assert.isTrue(inner.step());\r\n          return inner.current[0] as string;\r\n        }, new QueryBinder().bindId(1, \"0xe\"));\r\n        expect(innerId).to.equal(\"0xe\");\r\n        // Outer reader's cursor must be unaffected by the nested reader.\r\n        return outer.current[0] as string;\r\n      }, new QueryBinder().bindId(1, \"0x1\"));\r\n      expect(outerId).to.equal(\"0x1\");\r\n    });\r\n\r\n    it(\"recovers from a prepare failure without poisoning the cache\", () => {\r\n      iModel.clearCaches();\r\n      const invalidSql = \"SELECT * FROM bis.ThisClassDoesNotExist\";\r\n      const prepareSpy = sinon.spy(ECSqlStatement.prototype, \"prepare\"); // eslint-disable-line @typescript-eslint/no-deprecated\r\n      expect(() => iModel.withQueryReader(invalidSql, (reader) => reader.step())).to.throw();\r\n      expect(() => iModel.withQueryReader(invalidSql, (reader) => reader.step())).to.throw();\r\n      expect(prepareSpy.callCount).to.equal(2, \"a statement that failed to prepare must not be cached\");\r\n\r\n      iModel.withQueryReader(sql, (reader) => {\r\n        assert.isTrue(reader.step());\r\n        expect(reader.current[0]).to.equal(\"0x1\");\r\n      }, new QueryBinder().bindId(1, \"0x1\"));\r\n    });\r\n\r\n    it(\"releases the executor and cached statement when binding fails during reader construction\", () => {\r\n      iModel.clearCaches();\r\n      const prepareSpy = sinon.spy(ECSqlStatement.prototype, \"prepare\"); // eslint-disable-line @typescript-eslint/no-deprecated\r\n      iModel.withQueryReader(sql, (reader) => reader.step(), new QueryBinder().bindId(1, \"0x1\"));\r\n      const listenerCount = iModel.onBeforeClose.numberOfListeners;\r\n\r\n      const bindStub = sinon.stub(ECSqlStatement.prototype, \"bindParams\").throws(new Error(\"Expected bind failure\")); // eslint-disable-line @typescript-eslint/no-deprecated\r\n      expect(() => iModel.withQueryReader(sql, () => undefined, new QueryBinder().bindId(1, \"0x1\"))).to.throw(\"Expected bind failure\");\r\n      bindStub.restore();\r\n      expect(iModel.onBeforeClose.numberOfListeners).to.equal(listenerCount);\r\n\r\n      iModel.withQueryReader(sql, (reader) => reader.step(), new QueryBinder().bindId(1, \"0x1\"));\r\n      expect(prepareSpy.callCount).to.equal(1, \"the statement checked out before the bind failure should be returned to the cache\");\r\n    });\r\n\r\n    it(\"also caches for ECDb.withQueryReader (shared ECSqlRowExecutor path)\", () => {\r\n      using ecdb = ECDbTestHelper.createECDb(KnownTestLocations.outputDir, \"syncReaderStmtCache.ecdb\",\r\n        `<ECSchema schemaName=\"Test\" alias=\"ts\" version=\"01.00.00\" xmlns=\"http://www.bentley.com/schemas/Bentley.ECXML.3.2\">\r\n          <ECEntityClass typeName=\"Foo\" modifier=\"Sealed\">\r\n            <ECProperty propertyName=\"n\" typeName=\"int\"/>\r\n          </ECEntityClass>\r\n        </ECSchema>`);\r\n      ecdb.saveChanges();\r\n      const ecdbSql = \"SELECT ECInstanceId FROM meta.ECClassDef WHERE ECInstanceId=?\";\r\n      const prepareSpy = sinon.spy(ECSqlStatement.prototype, \"prepare\"); // eslint-disable-line @typescript-eslint/no-deprecated\r\n      for (let i = 0; i < 10; i++)\r\n        ecdb.withQueryReader(ecdbSql, (reader) => reader.step(), new QueryBinder().bindId(1, \"0x1\"));\r\n      expect(prepareSpy.callCount).to.equal(1, \"ECDb.withQueryReader should also reuse a cached prepared statement\");\r\n    });\r\n  });\r\n});\r\n"]}
+{"version":3,"file":"ECSqlSyncReader.test.js","sourceRoot":"","sources":["../../../../src/test/ecdb/ECSqlSyncReader.test.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\nimport { assert, expect } from \"chai\";\r\nimport * as sinon from \"sinon\";\r\nimport * as path from \"node:path\";\r\nimport { QueryBinder, QueryOptionsBuilder, QueryPropertyMetaData, QueryRowFormat } from \"@itwin/core-common\";\r\nimport { SnapshotDb } from \"../../IModelDb\";\r\nimport { IModelTestUtils } from \"../IModelTestUtils\";\r\nimport { Id64 } from \"@itwin/core-bentley\";\r\nimport { ECSqlStatement } from \"../../ECSqlStatement\";\r\nimport { ECDbTestHelper } from \"./ECDbTestHelper\";\r\nimport { KnownTestLocations } from \"../KnownTestLocations\";\r\nimport { IModelNative } from \"../../internal/NativePlatform\";\r\nimport { IModelJsFs } from \"../../IModelJsFs\";\r\nimport { SynchronousQueryOptions } from \"../../ECSqlSyncReader\";\r\n\r\ndescribe(\"WithQueryReaderTests\", () => {\r\n  let iModel: SnapshotDb;\r\n\r\n  before(async () => {\r\n    iModel = SnapshotDb.openFile(IModelTestUtils.resolveAssetFile(\"test.bim\"));\r\n  });\r\n\r\n  after(async () => {\r\n    iModel.close();\r\n  });\r\n  it(\"check behvaiour if we call clearCaches in between\", () => {\r\n    let actualRowCount = 0;\r\n    const expectedInstanceIds = [\"0x1\", \"0xe\", \"0x10\", \"0x11\", \"0x12\",\r\n      \"0x13\", \"0x14\", \"0x15\", \"0x16\", \"0x17\"];\r\n\r\n    expect(() => iModel.withQueryReader(\"SELECT * FROM bis.Element\", (reader) => {\r\n      let loopCount = 0;\r\n      // First loop - read first 10 rows\r\n      while (loopCount < 10) {\r\n        reader.step()\r\n        actualRowCount++;\r\n        loopCount++;\r\n        assert.isDefined(reader.current[0]);\r\n        assert.equal(reader.current[0], expectedInstanceIds[actualRowCount - 1]);\r\n      }\r\n      assert.equal(loopCount, 10);\r\n      iModel.clearCaches();\r\n\r\n      reader.step(); // step should fail after clearCaches\r\n    })).to.throw(\"Step failed\");\r\n  });\r\n  it(\"should throw error if we try to step on a closed iModelDb object\", () => {\r\n    const imodelPath = iModel.pathName;\r\n    expect(() => iModel.withQueryReader(\"SELECT * FROM bis.Element\", (reader) => {\r\n      let loopCount = 0;\r\n      while (loopCount < 10) {\r\n        reader.step();\r\n        assert.isDefined(reader.current[0]);\r\n        loopCount++;\r\n      }\r\n      assert.equal(loopCount, 10);\r\n      iModel.close();\r\n\r\n      iModel = SnapshotDb.openFile(imodelPath);\r\n      assert.isDefined(reader.current[0]);\r\n      reader.step(); // step should fail after iModelDb is closed\r\n    })).to.throw(\"Statement is not prepared\");\r\n  });\r\n  it(\"returning reader from withQueryReader callback should throw error if we try to step on it\", () => {\r\n    const readerObj = iModel.withQueryReader(\"SELECT * FROM bis.Element\", (reader) => {\r\n      reader.step();\r\n      return reader;\r\n    });\r\n    expect(readerObj.current[0]).to.equal(\"0x1\"); // will not throw error as we are just accessing current row\r\n    expect(() => readerObj.step()).to.throw(\"Statement is not prepared\");\r\n  });\r\n  it(\"checking rowFormat unspecified case - values accessed by index\", () => {\r\n    // Default rowFormat is UseECSqlPropertyIndexes: columns are accessed by their SELECT-order index.\r\n    iModel.withQueryReader(\"SELECT ECInstanceId, ECClassId FROM bis.Element\", (reader) => {\r\n      assert.isTrue(reader.step());\r\n      const id: string = reader.current[0];\r\n      const classId: string = reader.current[1];\r\n      assert.isTrue(Id64.isValid(classId));\r\n      assert.isTrue(Id64.isValid(id));\r\n      assert.equal(id, \"0x19\");\r\n    });\r\n  });\r\n\r\n  it(\"checking rowFormat UseECSqlPropertyIndexes - values accessed by index\", () => {\r\n    const config = new QueryOptionsBuilder().setRowFormat(QueryRowFormat.UseECSqlPropertyIndexes).getOptions();\r\n    iModel.withQueryReader(\"SELECT ECInstanceId, ECClassId FROM bis.Element\", (reader) => {\r\n      assert.isTrue(reader.step());\r\n      // Index 0 → ECInstanceId, index 1 → ECClassId\r\n      const id: string = reader.current[0];\r\n      const classId: string = reader.current[1];\r\n      assert.equal(id, \"0x19\");\r\n      assert.isTrue(Id64.isValid(classId));\r\n      // Swapping column order changes index, not value\r\n    }, undefined, config);\r\n  });\r\n\r\n  it(\"checking rowFormat UseECSqlPropertyNames - values accessed by ECSQL property name\", () => {\r\n    const config = new QueryOptionsBuilder().setRowFormat(QueryRowFormat.UseECSqlPropertyNames).getOptions();\r\n    iModel.withQueryReader(\"SELECT ECInstanceId, ECClassId FROM bis.Element\", (reader) => {\r\n      assert.isTrue(reader.step());\r\n      const id: string = reader.current.ECInstanceId;\r\n      const classId: string = reader.current.ECClassId;\r\n      assert.equal(id, \"0x19\");\r\n      assert.isTrue(Id64.isValid(classId));\r\n    }, undefined, config);\r\n  });\r\n\r\n  it(\"checking rowFormat UseJsPropertyNames - values accessed by JavaScript property name\", () => {\r\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\r\n    const config = new QueryOptionsBuilder().setRowFormat(QueryRowFormat.UseJsPropertyNames).getOptions();\r\n    iModel.withQueryReader(\"SELECT ECInstanceId, ECClassId FROM bis.Element\", (reader) => {\r\n      assert.isTrue(reader.step());\r\n      // ECInstanceId → id, ECClassId → className (resolved to a fully-qualified class name string)\r\n      const id: string = reader.current.id;\r\n      const className: string = reader.current.className;\r\n      assert.equal(id, \"0x19\");\r\n      // className should be in the form \"SchemaName.ClassName\"\r\n      assert.equal(className, \"BisCore.DrawingCategory\");\r\n    }, undefined, config);\r\n  });\r\n\r\n  it(\"checking rowFormat UseECSqlPropertyNames with convertClassIdsToClassNames - ECClassId returned as class name string\", () => {\r\n    const config = new QueryOptionsBuilder()\r\n      .setRowFormat(QueryRowFormat.UseECSqlPropertyNames)\r\n      // eslint-disable-next-line @typescript-eslint/no-deprecated\r\n      .setConvertClassIdsToNames(true)\r\n      .getOptions();\r\n    iModel.withQueryReader(\"SELECT ECInstanceId, ECClassId FROM bis.Element\", (reader) => {\r\n      assert.isTrue(reader.step());\r\n      const id: string = reader.current.ECInstanceId;\r\n      const classId: string = reader.current.ECClassId;\r\n      assert.equal(id, \"0x19\");\r\n      // With convertClassIdsToClassNames, ECClassId is resolved to \"SchemaName.ClassName\" instead of an Id\r\n      assert.equal(classId, \"BisCore.DrawingCategory\");\r\n    }, undefined, config);\r\n  });\r\n\r\n  describe(\"statement caching (regression)\", () => {\r\n    // `withQueryReader` used to build a fresh `ECSqlStatement` and re-compile the ECSQL on every\r\n    // call (via `ECSqlRowExecutor`), with no caching. Callers such as `IModelTransformer` invoke\r\n    // per-element helpers (e.g. `hasSubModel`) once per element, so on large models this turned one\r\n    // cached ECSQL prepare into N full native compiles - a significant performance regression. The\r\n    // reader now reuses a prepared statement from the owning db's `_statementCache`.\r\n    const sql = \"SELECT ECInstanceId FROM bis.Element WHERE ECInstanceId=?\";\r\n\r\n    afterEach(() => sinon.restore());\r\n\r\n    it(\"reuses a single prepared statement across repeated calls instead of re-preparing\", () => {\r\n      iModel.clearCaches();\r\n      const prepareSpy = sinon.spy(ECSqlStatement.prototype, \"prepare\"); // eslint-disable-line @typescript-eslint/no-deprecated\r\n      for (let i = 0; i < 20; i++) {\r\n        iModel.withQueryReader(sql, (reader) => {\r\n          reader.step();\r\n        }, new QueryBinder().bindId(1, \"0x1\"));\r\n      }\r\n      expect(prepareSpy.callCount).to.equal(1, \"queries with identical ECSQL text should re-use one cached prepared statement\");\r\n    });\r\n\r\n    it(\"keeps nested withQueryReader calls on the same SQL independent\", () => {\r\n      iModel.clearCaches();\r\n      // A nested reader on the same SQL must get its own statement (findAndRemove hands the outer\r\n      // reader's statement out of the cache), so results do not corrupt each other.\r\n      const outerId = iModel.withQueryReader(sql, (outer) => {\r\n        assert.isTrue(outer.step());\r\n        const innerId = iModel.withQueryReader(sql, (inner) => {\r\n          assert.isTrue(inner.step());\r\n          return inner.current[0] as string;\r\n        }, new QueryBinder().bindId(1, \"0xe\"));\r\n        expect(innerId).to.equal(\"0xe\");\r\n        // Outer reader's cursor must be unaffected by the nested reader.\r\n        return outer.current[0] as string;\r\n      }, new QueryBinder().bindId(1, \"0x1\"));\r\n      expect(outerId).to.equal(\"0x1\");\r\n    });\r\n\r\n    it(\"recovers from a prepare failure without poisoning the cache\", () => {\r\n      iModel.clearCaches();\r\n      const invalidSql = \"SELECT * FROM bis.ThisClassDoesNotExist\";\r\n      const prepareSpy = sinon.spy(ECSqlStatement.prototype, \"prepare\"); // eslint-disable-line @typescript-eslint/no-deprecated\r\n      expect(() => iModel.withQueryReader(invalidSql, (reader) => reader.step())).to.throw();\r\n      expect(() => iModel.withQueryReader(invalidSql, (reader) => reader.step())).to.throw();\r\n      expect(prepareSpy.callCount).to.equal(2, \"a statement that failed to prepare must not be cached\");\r\n\r\n      iModel.withQueryReader(sql, (reader) => {\r\n        assert.isTrue(reader.step());\r\n        expect(reader.current[0]).to.equal(\"0x1\");\r\n      }, new QueryBinder().bindId(1, \"0x1\"));\r\n    });\r\n\r\n    it(\"releases the executor and cached statement when binding fails during reader construction\", () => {\r\n      iModel.clearCaches();\r\n      const prepareSpy = sinon.spy(ECSqlStatement.prototype, \"prepare\"); // eslint-disable-line @typescript-eslint/no-deprecated\r\n      iModel.withQueryReader(sql, (reader) => reader.step(), new QueryBinder().bindId(1, \"0x1\"));\r\n      const listenerCount = iModel.onBeforeClose.numberOfListeners;\r\n\r\n      const bindStub = sinon.stub(ECSqlStatement.prototype, \"bindParams\").throws(new Error(\"Expected bind failure\")); // eslint-disable-line @typescript-eslint/no-deprecated\r\n      expect(() => iModel.withQueryReader(sql, () => undefined, new QueryBinder().bindId(1, \"0x1\"))).to.throw(\"Expected bind failure\");\r\n      bindStub.restore();\r\n      expect(iModel.onBeforeClose.numberOfListeners).to.equal(listenerCount);\r\n\r\n      iModel.withQueryReader(sql, (reader) => reader.step(), new QueryBinder().bindId(1, \"0x1\"));\r\n      expect(prepareSpy.callCount).to.equal(1, \"the statement checked out before the bind failure should be returned to the cache\");\r\n    });\r\n\r\n    it(\"also caches for ECDb.withQueryReader (shared ECSqlRowExecutor path)\", () => {\r\n      using ecdb = ECDbTestHelper.createECDb(KnownTestLocations.outputDir, \"syncReaderStmtCache.ecdb\",\r\n        `<ECSchema schemaName=\"Test\" alias=\"ts\" version=\"01.00.00\" xmlns=\"http://www.bentley.com/schemas/Bentley.ECXML.3.2\">\r\n          <ECEntityClass typeName=\"Foo\" modifier=\"Sealed\">\r\n            <ECProperty propertyName=\"n\" typeName=\"int\"/>\r\n          </ECEntityClass>\r\n        </ECSchema>`);\r\n      ecdb.saveChanges();\r\n      const ecdbSql = \"SELECT ECInstanceId FROM meta.ECClassDef WHERE ECInstanceId=?\";\r\n      const prepareSpy = sinon.spy(ECSqlStatement.prototype, \"prepare\"); // eslint-disable-line @typescript-eslint/no-deprecated\r\n      for (let i = 0; i < 10; i++)\r\n        ecdb.withQueryReader(ecdbSql, (reader) => reader.step(), new QueryBinder().bindId(1, \"0x1\"));\r\n      expect(prepareSpy.callCount).to.equal(1, \"ECDb.withQueryReader should also reuse a cached prepared statement\");\r\n    });\r\n  });\r\n\r\n  describe(\"metadata caching\", () => {\r\n    // Column metadata depends only on the prepared statement and the row-adaptor options, so it is cached\r\n    // on the cached ECSqlStatement instead of being fetched from native code on every withQueryReader call.\r\n    const sql = \"SELECT ECInstanceId, ECClassId, CodeValue, GeometryStream FROM bis.GeometricElement3d WHERE ECInstanceId=?\";\r\n    let elementId: string;\r\n\r\n    before(() => {\r\n      elementId = iModel.withQueryReader(\"SELECT ECInstanceId FROM bis.GeometricElement3d WHERE GeometryStream IS NOT NULL LIMIT 1\", (reader) => {\r\n        assert.isTrue(reader.step());\r\n        return reader.current[0] as string;\r\n      });\r\n    });\r\n\r\n    afterEach(() => sinon.restore());\r\n\r\n    function readMetadata(options: SynchronousQueryOptions): { meta: QueryPropertyMetaData[], row: any } {\r\n      return iModel.withQueryReader(sql, (reader) => {\r\n        assert.isTrue(reader.step());\r\n        return { meta: reader.getMetaData(), row: reader.current.toRow() };\r\n      }, new QueryBinder().bindId(1, elementId), options);\r\n    }\r\n\r\n    it(\"returns metadata matching the row options when the same statement is reused with different options\", () => {\r\n      const optionSets: SynchronousQueryOptions[] = [\r\n        // eslint-disable-next-line @typescript-eslint/no-deprecated\r\n        { rowFormat: QueryRowFormat.UseJsPropertyNames },\r\n        { rowFormat: QueryRowFormat.UseECSqlPropertyNames },\r\n        // eslint-disable-next-line @typescript-eslint/no-deprecated\r\n        { rowFormat: QueryRowFormat.UseJsPropertyNames, abbreviateBlobs: true },\r\n        { rowFormat: QueryRowFormat.UseECSqlPropertyNames, abbreviateBlobs: true },\r\n        { rowFormat: QueryRowFormat.UseECSqlPropertyNames, convertClassIdsToClassNames: true },\r\n      ];\r\n\r\n      // Expected metadata comes from a freshly prepared statement for each option set.\r\n      const expected = optionSets.map((options) => {\r\n        iModel.clearCaches();\r\n        return readMetadata({ ...options }).meta;\r\n      });\r\n      expect(expected[0].map((p) => p.jsonName)).to.deep.equal([\"id\", \"className\", \"codeValue\", \"geometryStream\"]);\r\n      expect(expected[1].map((p) => p.name)).to.deep.equal([\"ECInstanceId\", \"ECClassId\", \"CodeValue\", \"GeometryStream\"]);\r\n\r\n      iModel.clearCaches();\r\n      for (let pass = 0; pass < 2; pass++) {\r\n        optionSets.forEach((options, i) => {\r\n          const { meta, row } = readMetadata({ ...options });\r\n          expect(meta).to.deep.equal(expected[i]);\r\n          const geometryStream = row[options.rowFormat === QueryRowFormat.UseECSqlPropertyNames ? \"GeometryStream\" : \"geometryStream\"];\r\n          if (options.abbreviateBlobs)\r\n            expect(geometryStream).to.be.a(\"string\").and.match(/^\\{\"bytes\":\\d+\\}$/);\r\n          else\r\n            expect(geometryStream).to.be.instanceOf(Uint8Array);\r\n        });\r\n      }\r\n    });\r\n\r\n    it(\"fetches native metadata once per statement and row options\", () => {\r\n      // Native prototype methods cannot be spied on directly, so count calls through a subclass.\r\n      const getMetadataSpy = sinon.spy();\r\n      const nativeStatement = IModelNative.platform.ECSqlStatement;\r\n      sinon.replace(IModelNative.platform, \"ECSqlStatement\", class extends nativeStatement {\r\n        public override getMetadata(...args: Parameters<typeof nativeStatement.prototype.getMetadata>) {\r\n          getMetadataSpy();\r\n          return super.getMetadata(...args);\r\n        }\r\n      });\r\n      iModel.clearCaches();\r\n      const options = { rowFormat: QueryRowFormat.UseECSqlPropertyNames };\r\n      for (let i = 0; i < 10; i++)\r\n        readMetadata({ ...options });\r\n      expect(getMetadataSpy.callCount).to.equal(1);\r\n\r\n      readMetadata({ ...options, abbreviateBlobs: true });\r\n      readMetadata({ ...options, abbreviateBlobs: true });\r\n      expect(getMetadataSpy.callCount).to.equal(2, \"different row options need their own metadata\");\r\n\r\n      iModel.clearCaches();\r\n      readMetadata({ ...options });\r\n      expect(getMetadataSpy.callCount).to.equal(3, \"a re-prepared statement must not reuse cached metadata\");\r\n    });\r\n\r\n    it(\"does not share metadata objects between calls\", () => {\r\n      iModel.clearCaches();\r\n      const options = { rowFormat: QueryRowFormat.UseECSqlPropertyNames };\r\n      const expected = structuredClone(readMetadata({ ...options }).meta);\r\n\r\n      iModel.withQueryReader(sql, (reader) => {\r\n        assert.isTrue(reader.step());\r\n        const readerMeta = reader.getMetaData();\r\n        readerMeta[0].name = \"Changed\";\r\n        readerMeta[0].index = 3;\r\n        readerMeta.reverse();\r\n        const proxyMeta = reader.current.getMetaData();\r\n        proxyMeta.push({ ...proxyMeta[0], name: \"Extra\" });\r\n      }, new QueryBinder().bindId(1, elementId), options);\r\n\r\n      const { meta, row } = readMetadata({ ...options });\r\n      expect(meta).to.deep.equal(expected);\r\n      expect(row.ECInstanceId).to.equal(elementId);\r\n    });\r\n\r\n    it(\"returns metadata for queries that produce no rows\", () => {\r\n      iModel.clearCaches();\r\n      const options = { rowFormat: QueryRowFormat.UseECSqlPropertyNames };\r\n      const expected = readMetadata({ ...options }).meta;\r\n      for (let i = 0; i < 3; i++) {\r\n        iModel.withQueryReader(sql, (reader) => {\r\n          expect(reader.step()).to.be.false;\r\n          expect(reader.getMetaData()).to.deep.equal(expected);\r\n        }, new QueryBinder().bindId(1, \"0xffffff\"), options);\r\n        iModel.withQueryReader(sql, (reader) => {\r\n          expect(reader.getMetaData()).to.deep.equal(expected);\r\n          expect(reader.toArray()).to.deep.equal([]);\r\n        }, new QueryBinder().bindId(1, \"0xffffff\"), options);\r\n      }\r\n    });\r\n\r\n    it(\"reflects a schema import between calls\", () => {\r\n      const schemaXml = (version: string, extraProperty: string) => `<ECSchema schemaName=\"Test\" alias=\"ts\" version=\"${version}\" xmlns=\"http://www.bentley.com/schemas/Bentley.ECXML.3.2\">\r\n          <ECEntityClass typeName=\"Foo\" modifier=\"Sealed\">\r\n            <ECProperty propertyName=\"n\" typeName=\"int\"/>\r\n            ${extraProperty}\r\n          </ECEntityClass>\r\n        </ECSchema>`;\r\n      using ecdb = ECDbTestHelper.createECDb(KnownTestLocations.outputDir, \"syncReaderMetadataCache.ecdb\", schemaXml(\"01.00.00\", \"\"));\r\n      ecdb.withCachedWriteStatement(\"INSERT INTO ts.Foo(n) VALUES(1)\", (stmt) => stmt.stepForInsert());\r\n      ecdb.saveChanges();\r\n\r\n      const fooSql = \"SELECT * FROM ts.Foo\";\r\n      const options = { rowFormat: QueryRowFormat.UseECSqlPropertyNames };\r\n      const readNames = () => ecdb.withQueryReader(fooSql, (reader) => {\r\n        assert.isTrue(reader.step());\r\n        return reader.getMetaData().map((p) => p.name);\r\n      }, undefined, options);\r\n      expect(readNames()).to.deep.equal([\"ECInstanceId\", \"ECClassId\", \"n\"]);\r\n      expect(readNames()).to.deep.equal([\"ECInstanceId\", \"ECClassId\", \"n\"]);\r\n\r\n      const schemaPath = path.join(KnownTestLocations.outputDir, \"syncReaderMetadataCache.ecschema.xml\");\r\n      IModelJsFs.writeFileSync(schemaPath, schemaXml(\"01.00.01\", `<ECProperty propertyName=\"m\" typeName=\"string\"/>`));\r\n      ecdb.importSchema(schemaPath);\r\n      ecdb.saveChanges();\r\n\r\n      expect(readNames()).to.deep.equal([\"ECInstanceId\", \"ECClassId\", \"n\", \"m\"]);\r\n    });\r\n  });\r\n});\r\n"]}

package/lib/esm/test/hubaccess/CodeSwap.test.js

@@ -336,6 +336,84 @@ describe("Code value management: null, swap, undo/redo, and cross-briefcase pull
             HubMock.shutdown();
         }
     });
+    // Regression for iTwin/itwinjs-backlog#2435: rebasing a code swap must not cascade-delete derived-class rows.
+    it("preserves both drawing graphics when rebasing a local code swap over an unrelated incoming change", async () => {
+        HubMock.startup("CodeSwapRebaseCascadeTest", KnownTestLocations.outputDir);
+        let far;
+        let local;
+        try {
+            const iModelId = await HubMock.createNewIModel({
+                accessToken: "far-user",
+                iTwinId: HubMock.iTwinId,
+                iModelName: "CodeSwapRebaseCascadeTest",
+                description: "CodeSwapRebaseCascadeTest",
+            });
+            const source = far = await HubWrappers.downloadAndOpenBriefcase({ accessToken: "far-user", iTwinId: HubMock.iTwinId, iModelId });
+            source.channels.addAllowedChannel(ChannelControl.sharedChannelName);
+            await source.locks.acquireLocks({ shared: IModel.dictionaryId });
+            const { drawingModelId, drawingCategoryId, codeSpecId } = withEditTxn(source, "setup code swap rebase", (txn) => {
+                const [, modelId] = IModelTestUtils.createAndInsertDrawingPartitionAndModel(txn, IModelTestUtils.getUniqueModelCode(source, "DrawingModel"));
+                const categoryId = DrawingCategory.insert(txn, IModel.dictionaryId, "MyDrawingCategory", new SubCategoryAppearance());
+                const specId = source.codeSpecs.insert(txn, "CodeSwapRebaseCascadeCodeSpec", CodeScopeSpec.Type.Model);
+                return { drawingModelId: modelId, drawingCategoryId: categoryId, codeSpecId: specId };
+            });
+            await source.pushChanges({ description: "setup" });
+            const target = local = await HubWrappers.downloadAndOpenBriefcase({ accessToken: "local-user", iTwinId: HubMock.iTwinId, iModelId });
+            target.channels.addAllowedChannel(ChannelControl.sharedChannelName);
+            const codeA = new Code({ spec: codeSpecId, scope: drawingModelId, value: "CODE_A" });
+            const codeB = new Code({ spec: codeSpecId, scope: drawingModelId, value: "CODE_B" });
+            await source.locks.acquireLocks({ shared: drawingModelId });
+            const { elementA, elementB, unrelatedId } = withEditTxn(source, "insert code swap elements", (txn) => {
+                const props = {
+                    classFullName: "BisCore:DrawingGraphic",
+                    model: drawingModelId,
+                    category: drawingCategoryId,
+                    code: Code.createEmpty(),
+                };
+                return {
+                    elementA: txn.insertElement({ ...props, code: codeA }),
+                    elementB: txn.insertElement({ ...props, code: codeB }),
+                    unrelatedId: txn.insertElement(props),
+                };
+            });
+            await source.pushChanges({ description: "insert code swap elements" });
+            await target.pullChanges();
+            await target.locks.acquireLocks({ exclusive: [elementA, elementB] });
+            withEditTxn(target, "local code swap", (txn) => {
+                // The session captures only the net swap, discarding this temporary value.
+                txn.updateElement({ id: elementA, code: new Code({ spec: codeSpecId, scope: drawingModelId, value: "CODE_TEMP" }) });
+                txn.updateElement({ id: elementB, code: codeA });
+                txn.updateElement({ id: elementA, code: codeB });
+            });
+            chai.expect(target.txns.hasPendingTxns).to.be.true;
+            // Force a genuine rebase of the local swap, rather than a fast-forward pull.
+            await source.locks.acquireLocks({ exclusive: unrelatedId });
+            withEditTxn(source, "unrelated incoming change", (txn) => {
+                txn.updateElement({ id: unrelatedId, userLabel: "remote update" });
+            });
+            await source.pushChanges({ description: "unrelated incoming change" });
+            let rebaseCount = 0;
+            target.txns.rebaser.onRebaseBegin.addListener(() => { ++rebaseCount; });
+            await target.pullChanges();
+            chai.expect(rebaseCount).to.equal(1);
+            chai.expect(target.txns.hasPendingTxns).to.be.true;
+            target.clearCaches();
+            const a = target.elements.getElementProps(elementA);
+            const b = target.elements.getElementProps(elementB);
+            chai.expect(a.code).to.deep.equal(codeB.toJSON());
+            chai.expect(b.code).to.deep.equal(codeA.toJSON());
+            chai.expect(a.category).to.equal(drawingCategoryId);
+            chai.expect(b.category).to.equal(drawingCategoryId);
+            chai.expect(a.model).to.equal(drawingModelId);
+            chai.expect(b.model).to.equal(drawingModelId);
+            chai.expect(target.elements.getElementProps(unrelatedId).userLabel).to.equal("remote update");
+        }
+        finally {
+            far?.close();
+            local?.close();
+            HubMock.shutdown();
+        }
+    });
     it("single-transaction code swap reverts to old behaviour (swap not applied) when noUpdateLoop is true", async () => {
         HubMock.startup("CodeSwapNoUpdateLoopTest", KnownTestLocations.outputDir);
         let b1;