@itwin/core-backend 5.9.0-dev.1 → 5.9.0-dev.11

package/lib/esm/test/TestEditTxn.d.ts

@@ -0,0 +1,8 @@
+import { SaveChangesArgs } from "@itwin/core-common";
+import { EditTxn } from "../EditTxn";
+import type { IModelDb } from "../IModelDb";
+export declare function withEditTxn<T>(iModel: IModelDb, fn: (txn: EditTxn) => T): T;
+export declare function withEditTxn<T>(iModel: IModelDb, saveArgs: string | SaveChangesArgs, fn: (txn: EditTxn) => T): T;
+export declare function withEditTxn<T>(iModel: IModelDb, fn: (txn: EditTxn) => Promise<T>): Promise<T>;
+export declare function withEditTxn<T>(iModel: IModelDb, saveArgs: string | SaveChangesArgs, fn: (txn: EditTxn) => Promise<T>): Promise<T>;
+//# sourceMappingURL=TestEditTxn.d.ts.map

package/lib/esm/test/TestEditTxn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestEditTxn.d.ts","sourceRoot":"","sources":["../../../src/test/TestEditTxn.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC;AAC7E,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC;AACjH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAC/F,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC"}

package/lib/esm/test/TestEditTxn.js

@@ -0,0 +1,34 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+import { EditTxn } from "../EditTxn";
+export function withEditTxn(iModel, saveArgsOrFn, maybeFn) {
+    const saveArgs = "function" === typeof saveArgsOrFn ? undefined : saveArgsOrFn;
+    const fn = "function" === typeof saveArgsOrFn ? saveArgsOrFn : maybeFn;
+    if (undefined === fn)
+        throw new Error("withEditTxn requires a callback");
+    const txn = new EditTxn(iModel, "test");
+    txn.start();
+    try {
+        const result = fn(txn);
+        if (result instanceof Promise) {
+            return result.then((value) => {
+                txn.end("save", saveArgs);
+                return value;
+            }, (err) => {
+                if (txn.isActive)
+                    txn.end("abandon");
+                throw err;
+            });
+        }
+        txn.end("save", saveArgs);
+        return result;
+    }
+    catch (err) {
+        if (txn.isActive)
+            txn.end("abandon");
+        throw err;
+    }
+}
+//# sourceMappingURL=TestEditTxn.js.map

package/lib/esm/test/TestEditTxn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestEditTxn.js","sourceRoot":"","sources":["../../../src/test/TestEditTxn.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAG/F,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAOrC,MAAM,UAAU,WAAW,CAAI,MAAgB,EAAE,YAA2E,EAAE,OAA0C;IACtK,MAAM,QAAQ,GAAG,UAAU,KAAK,OAAO,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC;IAC/E,MAAM,EAAE,GAAG,UAAU,KAAK,OAAO,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC;IAEvE,IAAI,SAAS,KAAK,EAAE;QAClB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IAErD,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,GAAG,CAAC,KAAK,EAAE,CAAC;IAEZ,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;QACvB,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;YAC9B,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;gBAC3B,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;gBAC1B,OAAO,KAAK,CAAC;YACf,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE;gBACT,IAAI,GAAG,CAAC,QAAQ;oBACd,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;gBAErB,MAAM,GAAG,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC;QAED,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC1B,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,CAAC,QAAQ;YACd,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAErB,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC","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 { SaveChangesArgs } from \"@itwin/core-common\";\r\nimport { EditTxn } from \"../EditTxn\";\r\nimport type { IModelDb } from \"../IModelDb\";\r\n\r\nexport function withEditTxn<T>(iModel: IModelDb, fn: (txn: EditTxn) => T): T;\r\nexport function withEditTxn<T>(iModel: IModelDb, saveArgs: string | SaveChangesArgs, fn: (txn: EditTxn) => T): T;\r\nexport function withEditTxn<T>(iModel: IModelDb, fn: (txn: EditTxn) => Promise<T>): Promise<T>;\r\nexport function withEditTxn<T>(iModel: IModelDb, saveArgs: string | SaveChangesArgs, fn: (txn: EditTxn) => Promise<T>): Promise<T>;\r\nexport function withEditTxn<T>(iModel: IModelDb, saveArgsOrFn: string | SaveChangesArgs | ((txn: EditTxn) => T | Promise<T>), maybeFn?: (txn: EditTxn) => T | Promise<T>): T | Promise<T> {\r\n  const saveArgs = \"function\" === typeof saveArgsOrFn ? undefined : saveArgsOrFn;\r\n  const fn = \"function\" === typeof saveArgsOrFn ? saveArgsOrFn : maybeFn;\r\n\r\n  if (undefined === fn)\r\n    throw new Error(\"withEditTxn requires a callback\");\r\n\r\n  const txn = new EditTxn(iModel, \"test\");\r\n  txn.start();\r\n\r\n  try {\r\n    const result = fn(txn);\r\n    if (result instanceof Promise) {\r\n      return result.then((value) => {\r\n        txn.end(\"save\", saveArgs);\r\n        return value;\r\n      }, (err) => {\r\n        if (txn.isActive)\r\n          txn.end(\"abandon\");\r\n\r\n        throw err;\r\n      });\r\n    }\r\n\r\n    txn.end(\"save\", saveArgs);\r\n    return result;\r\n  } catch (err) {\r\n    if (txn.isActive)\r\n      txn.end(\"abandon\");\r\n\r\n    throw err;\r\n  }\r\n}\r\n\r\n"]}

package/lib/esm/test/TestUtils.d.ts

@@ -20,6 +20,7 @@ export declare class DisableNativeAssertions implements Disposable {
     dispose(): void;
 }
 export declare class TestUtils {
+    private static shouldLogToConsole;
     static getCacheDir(fallback?: string | undefined): string | undefined;
     /** Handles the startup of IModelHost.
      * The provided config is used and will override any of the default values used in this method.

package/lib/esm/test/TestUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TestUtils.d.ts","sourceRoot":"","sources":["../../../src/test/TestUtils.ts"],"names":[],"mappings":"AASA,OAAO,EAAc,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAG9D,mCAAmC;AACnC,qBAAa,KAAK;IAChB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAO;gBACT,KAAK,EAAE,MAAM;IAKlB,GAAG;CAMX;AAED;;;;;GAKG;AACH,qBAAa,uBAAwB,YAAW,UAAU;IACxD,OAAO,CAAC,OAAO,CAAqD;;IAM7D,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;IAQ/B,qGAAqG;IAC9F,OAAO,IAAI,IAAI;CAGvB;AAED,qBAAa,SAAS;WACN,WAAW,CAAC,QAAQ,GAAE,MAAM,GAAG,SAAqB;IAOlE;;;;;;OAMG;WACiB,YAAY,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;WAOvD,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;WAItC,YAAY;IAK1B,OAAO,CAAC,MAAM,CAAC,kBAAkB;WAUnB,mBAAmB;WAInB,mBAAmB;CAGlC"}
+{"version":3,"file":"TestUtils.d.ts","sourceRoot":"","sources":["../../../src/test/TestUtils.ts"],"names":[],"mappings":"AASA,OAAO,EAAc,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAG9D,mCAAmC;AACnC,qBAAa,KAAK;IAChB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAO;gBACT,KAAK,EAAE,MAAM;IAKlB,GAAG;CAMX;AAED;;;;;GAKG;AACH,qBAAa,uBAAwB,YAAW,UAAU;IACxD,OAAO,CAAC,OAAO,CAAqD;;IAM7D,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;IAQ/B,qGAAqG;IAC9F,OAAO,IAAI,IAAI;CAGvB;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAC,kBAAkB;WAInB,WAAW,CAAC,QAAQ,GAAE,MAAM,GAAG,SAAqB;IAOlE;;;;;;OAMG;WACiB,YAAY,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;WAQvD,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;WAItC,YAAY;IAQ1B,OAAO,CAAC,MAAM,CAAC,kBAAkB;WAUnB,mBAAmB;WAInB,mBAAmB;CAGlC"}

package/lib/esm/test/TestUtils.js

@@ -46,6 +46,9 @@ export class DisableNativeAssertions {
     }
 }
 export class TestUtils {
+    static shouldLogToConsole() {
+        return process.env.ITWINJS_CORE_BACKEND_TEST_LOG_TO_CONSOLE === "1";
+    }
     static getCacheDir(fallback = undefined) {
         if (ProcessDetector.isMobileAppBackend) {
             return undefined; // Let the native side handle the cache.
@@ -63,13 +66,17 @@ export class TestUtils {
         const cfg = config ?? {};
         cfg.cacheDir = TestUtils.getCacheDir(cfg.cacheDir);
         cfg.allowSharedChannel ??= false; // Override default to test shared channel enforcement. Remove in version 5.0.
+        cfg.implicitWriteEnforcement ??= "throw";
         await IModelHost.startup(cfg);
     }
     static async shutdownBackend() {
         return IModelHost.shutdown();
     }
     static setupLogging() {
-        Logger.initializeToConsole();
+        if (TestUtils.shouldLogToConsole())
+            Logger.initializeToConsole();
+        else
+            Logger.initialize();
         Logger.setLevelDefault(LogLevel.Error);
     }
     static initDebugLogLevels(reset) {

package/lib/esm/test/TestUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"TestUtils.js","sourceRoot":"","sources":["../../../src/test/TestUtils.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 * as path from \"path\";\nimport { IModelJsNative, NativeLoggerCategory } from \"@bentley/imodeljs-native\";\nimport { BentleyLoggerCategory, Logger, LogLevel, ProcessDetector } from \"@itwin/core-bentley\";\nimport { BackendLoggerCategory } from \"../BackendLoggerCategory\";\nimport { IModelHost, IModelHostOptions } from \"../IModelHost\";\nimport { IModelNative } from \"../internal/NativePlatform\";\n\n/** Class for simple test timing */\nexport class Timer {\n  private _label: string;\n  private _start: Date;\n  constructor(label: string) {\n    this._label = `\\t${label}`;\n    this._start = new Date();\n  }\n\n  public end() {\n    const stop = new Date();\n    const elapsed = stop.getTime() - this._start.getTime();\n    // eslint-disable-next-line no-console\n    console.log(`${this._label}: ${elapsed}ms`);\n  }\n}\n\n/**\n * Disables native code assertions from firing. This can be used by tests that intentionally\n * test failing operations. If those failing operations raise assertions in native code, the test\n * would fail unexpectedly in a debug build. In that case the native code assertions can be disabled with\n * this class.\n */\nexport class DisableNativeAssertions implements Disposable {\n  private _native: IModelJsNative.DisableNativeAssertions | undefined;\n\n  constructor() {\n    this._native = new IModelNative.platform.DisableNativeAssertions();\n  }\n\n  public [Symbol.dispose](): void {\n    if (!this._native)\n      return;\n\n    this._native.dispose();\n    this._native = undefined;\n  }\n\n  /** @deprecated in 5.0 - will not be removed until after 2026-06-13. Use [Symbol.dispose] instead. */\n  public dispose(): void {\n    this[Symbol.dispose]();\n  }\n}\n\nexport class TestUtils {\n  public static getCacheDir(fallback: string | undefined = undefined) {\n    if (ProcessDetector.isMobileAppBackend) {\n      return undefined; // Let the native side handle the cache.\n    }\n    return fallback ?? path.join(__dirname, \".cache\"); // Set the cache dir to be under the lib directory.\n  }\n\n  /** Handles the startup of IModelHost.\n   * The provided config is used and will override any of the default values used in this method.\n   *\n   * The default includes:\n   * - cacheDir = path.join(__dirname, \".cache\")\n   * - allowSharedChannel = false;\n   */\n  public static async startBackend(config?: IModelHostOptions): Promise<void> {\n    const cfg = config ?? {};\n    cfg.cacheDir = TestUtils.getCacheDir(cfg.cacheDir);\n    cfg.allowSharedChannel ??= false; // Override default to test shared channel enforcement. Remove in version 5.0.\n    await IModelHost.startup(cfg);\n  }\n\n  public static async shutdownBackend(): Promise<void> {\n    return IModelHost.shutdown();\n  }\n\n  public static setupLogging() {\n    Logger.initializeToConsole();\n    Logger.setLevelDefault(LogLevel.Error);\n  }\n\n  private static initDebugLogLevels(reset?: boolean) {\n    Logger.setLevelDefault(reset ? LogLevel.Error : LogLevel.Warning);\n    Logger.setLevel(BentleyLoggerCategory.Performance, reset ? LogLevel.Error : LogLevel.Info);\n    Logger.setLevel(BackendLoggerCategory.IModelDb, reset ? LogLevel.Error : LogLevel.Trace);\n    Logger.setLevel(NativeLoggerCategory.DgnCore, reset ? LogLevel.Error : LogLevel.Trace);\n    Logger.setLevel(NativeLoggerCategory.BeSQLite, reset ? LogLevel.Error : LogLevel.Trace);\n  }\n\n  // Setup typical programmatic log level overrides here\n  // Convenience method used to debug specific tests/fixtures\n  public static setupDebugLogLevels() {\n    TestUtils.initDebugLogLevels(false);\n  }\n\n  public static resetDebugLogLevels() {\n    TestUtils.initDebugLogLevels(true);\n  }\n}\n\n// The very first \"before\" run to initially setup the logging and initial backend.\nbefore(async () => {\n  TestUtils.setupLogging();\n  await TestUtils.startBackend();\n});\n\nafter(async () => {\n  await TestUtils.shutdownBackend();\n});\n\n"]}
+{"version":3,"file":"TestUtils.js","sourceRoot":"","sources":["../../../src/test/TestUtils.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 * as path from \"path\";\r\nimport { IModelJsNative, NativeLoggerCategory } from \"@bentley/imodeljs-native\";\r\nimport { BentleyLoggerCategory, Logger, LogLevel, ProcessDetector } from \"@itwin/core-bentley\";\r\nimport { BackendLoggerCategory } from \"../BackendLoggerCategory\";\r\nimport { IModelHost, IModelHostOptions } from \"../IModelHost\";\r\nimport { IModelNative } from \"../internal/NativePlatform\";\r\n\r\n/** Class for simple test timing */\r\nexport class Timer {\r\n  private _label: string;\r\n  private _start: Date;\r\n  constructor(label: string) {\r\n    this._label = `\\t${label}`;\r\n    this._start = new Date();\r\n  }\r\n\r\n  public end() {\r\n    const stop = new Date();\r\n    const elapsed = stop.getTime() - this._start.getTime();\r\n    // eslint-disable-next-line no-console\r\n    console.log(`${this._label}: ${elapsed}ms`);\r\n  }\r\n}\r\n\r\n/**\r\n * Disables native code assertions from firing. This can be used by tests that intentionally\r\n * test failing operations. If those failing operations raise assertions in native code, the test\r\n * would fail unexpectedly in a debug build. In that case the native code assertions can be disabled with\r\n * this class.\r\n */\r\nexport class DisableNativeAssertions implements Disposable {\r\n  private _native: IModelJsNative.DisableNativeAssertions | undefined;\r\n\r\n  constructor() {\r\n    this._native = new IModelNative.platform.DisableNativeAssertions();\r\n  }\r\n\r\n  public [Symbol.dispose](): void {\r\n    if (!this._native)\r\n      return;\r\n\r\n    this._native.dispose();\r\n    this._native = undefined;\r\n  }\r\n\r\n  /** @deprecated in 5.0 - will not be removed until after 2026-06-13. Use [Symbol.dispose] instead. */\r\n  public dispose(): void {\r\n    this[Symbol.dispose]();\r\n  }\r\n}\r\n\r\nexport class TestUtils {\r\n  private static shouldLogToConsole(): boolean {\r\n    return process.env.ITWINJS_CORE_BACKEND_TEST_LOG_TO_CONSOLE === \"1\";\r\n  }\r\n\r\n  public static getCacheDir(fallback: string | undefined = undefined) {\r\n    if (ProcessDetector.isMobileAppBackend) {\r\n      return undefined; // Let the native side handle the cache.\r\n    }\r\n    return fallback ?? path.join(__dirname, \".cache\"); // Set the cache dir to be under the lib directory.\r\n  }\r\n\r\n  /** Handles the startup of IModelHost.\r\n   * The provided config is used and will override any of the default values used in this method.\r\n   *\r\n   * The default includes:\r\n   * - cacheDir = path.join(__dirname, \".cache\")\r\n   * - allowSharedChannel = false;\r\n   */\r\n  public static async startBackend(config?: IModelHostOptions): Promise<void> {\r\n    const cfg = config ?? {};\r\n    cfg.cacheDir = TestUtils.getCacheDir(cfg.cacheDir);\r\n    cfg.allowSharedChannel ??= false; // Override default to test shared channel enforcement. Remove in version 5.0.\r\n    cfg.implicitWriteEnforcement ??= \"throw\";\r\n    await IModelHost.startup(cfg);\r\n  }\r\n\r\n  public static async shutdownBackend(): Promise<void> {\r\n    return IModelHost.shutdown();\r\n  }\r\n\r\n  public static setupLogging() {\r\n    if (TestUtils.shouldLogToConsole())\r\n      Logger.initializeToConsole();\r\n    else\r\n      Logger.initialize();\r\n    Logger.setLevelDefault(LogLevel.Error);\r\n  }\r\n\r\n  private static initDebugLogLevels(reset?: boolean) {\r\n    Logger.setLevelDefault(reset ? LogLevel.Error : LogLevel.Warning);\r\n    Logger.setLevel(BentleyLoggerCategory.Performance, reset ? LogLevel.Error : LogLevel.Info);\r\n    Logger.setLevel(BackendLoggerCategory.IModelDb, reset ? LogLevel.Error : LogLevel.Trace);\r\n    Logger.setLevel(NativeLoggerCategory.DgnCore, reset ? LogLevel.Error : LogLevel.Trace);\r\n    Logger.setLevel(NativeLoggerCategory.BeSQLite, reset ? LogLevel.Error : LogLevel.Trace);\r\n  }\r\n\r\n  // Setup typical programmatic log level overrides here\r\n  // Convenience method used to debug specific tests/fixtures\r\n  public static setupDebugLogLevels() {\r\n    TestUtils.initDebugLogLevels(false);\r\n  }\r\n\r\n  public static resetDebugLogLevels() {\r\n    TestUtils.initDebugLogLevels(true);\r\n  }\r\n}\r\n\r\n// The very first \"before\" run to initially setup the logging and initial backend.\r\nbefore(async () => {\r\n  TestUtils.setupLogging();\r\n  await TestUtils.startBackend();\r\n});\r\n\r\nafter(async () => {\r\n  await TestUtils.shutdownBackend();\r\n});\r\n\r\n"]}

package/lib/esm/test/annotations/Fields.test.js

@@ -15,13 +15,14 @@ import { ClassRegistry } from "../../ClassRegistry";
 import { PhysicalElement } from "../../Element";
 import { ElementOwnsUniqueAspect, ElementUniqueAspect, FontFile, IModelElementCloneContext, TextAnnotation3d } from "../../core-backend";
 import { ElementDrivesTextAnnotation, TextAnnotationUsesTextStyleByDefault } from "../../annotations/ElementDrivesTextAnnotation";
+import { withEditTxn } from "../../EditTxn";
 function isIntlSupported() {
     // Node in the mobile add-on does not include Intl, so this test fails. Right now, mobile
     // users are not expected to do any editing, but long term we will attempt to find a better
     // solution.
     return !ProcessDetector.isMobileAppBackend;
 }
-function createTestElement(imodel, model, category, overrides, aspectProp = 999) {
+function insertTestElement(txn, model, category, overrides, aspectProp = 999) {
     const props = {
         classFullName: "Fields:TestElement",
         model,
@@ -60,15 +61,14 @@ function createTestElement(imodel, model, category, overrides, aspectProp = 999)
         },
         ...overrides,
     };
-    const id = imodel.elements.insertElement(props);
+    const elemId = txn.insertElement(props);
     const aspectProps = {
         classFullName: TestAspect.classFullName,
         aspectProp,
-        element: new ElementOwnsUniqueAspect(id),
+        element: new ElementOwnsUniqueAspect(elemId),
     };
-    imodel.elements.insertAspect(aspectProps);
-    imodel.saveChanges();
-    return id;
+    txn.insertAspect(aspectProps);
+    return elemId;
 }
 describe("updateField", () => {
     const mockElementId = "0x1";
@@ -152,59 +152,59 @@ describe("updateField", () => {
         expect(fieldRun.cachedContent).to.equal(FieldRun.invalidContentIndicator);
     });
 });
-const fieldsSchemaXml = `
-<?xml version="1.0" encoding="UTF-8"?>
-<ECSchema schemaName="Fields" alias="ts" version="01.00.00" xmlns="http://www.bentley.com/schemas/Bentley.ECXML.3.2">
-  <ECSchemaReference name="BisCore" version="01.00.04" alias="bis"/>
-  <ECSchemaReference name='ECDbMap' version='02.00.04' alias='ecdbmap' />
-
-  <ECEnumeration typeName="IntEnum" backingTypeName="int">
-    <ECEnumerator name="one" displayLabel="One" value="1" />
-    <ECEnumerator name="two" displayLabel="Two" value="2"/>
-  </ECEnumeration>
-
-  <ECStructClass typeName="InnerStruct" modifier="None">
-    <ECProperty propertyName="bool" typeName="boolean"/>
-    <ECArrayProperty propertyName="doubles" typeName="double" minOccurs="0" maxOccurs="unbounded"/>
-  </ECStructClass>
-
-  <ECStructClass typeName="OuterStruct" modifier="None">
-    <ECStructProperty propertyName="innerStruct" typeName="InnerStruct"/>
-    <ECStructArrayProperty propertyName="innerStructs" typeName="InnerStruct" minOccurs="0" maxOccurs="unbounded"/>
-  </ECStructClass>
-
-  <ECEntityClass typeName="TestElement" modifier="None">
-    <BaseClass>bis:PhysicalElement</BaseClass>
-    <ECProperty propertyName="intProp" typeName="int"/>
-    <ECProperty propertyName="point" typeName="point3d"/>
-    <ECProperty propertyName="maybeNull" typeName="int"/>
-    <ECProperty propertyName="datetime" typeName="dateTime"/>
-    <ECArrayProperty propertyName="strings" typeName="string" minOccurs="0" maxOccurs="unbounded"/>
-    <ECStructProperty propertyName="outerStruct" typeName="OuterStruct"/>
-    <ECStructArrayProperty propertyName="outerStructs" typeName="OuterStruct" minOccurs="0" maxOccurs="unbounded"/>
-    <ECProperty propertyName="intEnum" typeName="IntEnum"/>
-  </ECEntityClass>
-
-  <ECEntityClass typeName="TestAspect" modifier="None">
-    <BaseClass>bis:ElementUniqueAspect</BaseClass>
-    <ECProperty propertyName="aspectProp" typeName="int"/>
-  </ECEntityClass>
-
-  <ECEntityClass typeName="TestElementStringProp" modifier="Abstract">
-    <ECCustomAttributes>
-      <QueryView xmlns="ECDbMap.02.00.04">
-        <Query>
-          SELECT
-            jo.ECInstanceId,
-            ec_classid('Fields', 'TestElementStringProp') [ECClassId],
-            json_extract(jo.jsonProperties, '$.stringProp') [StringProp]
-          FROM Fields.TestElement jo
-        </Query>
-      </QueryView>
-    </ECCustomAttributes>
-    <ECProperty propertyName="StringProp" typeName="string" />
-  </ECEntityClass>
-</ECSchema>
+const fieldsSchemaXml = `
+<?xml version="1.0" encoding="UTF-8"?>
+<ECSchema schemaName="Fields" alias="ts" version="01.00.00" xmlns="http://www.bentley.com/schemas/Bentley.ECXML.3.2">
+  <ECSchemaReference name="BisCore" version="01.00.04" alias="bis"/>
+  <ECSchemaReference name='ECDbMap' version='02.00.04' alias='ecdbmap' />
+
+  <ECEnumeration typeName="IntEnum" backingTypeName="int">
+    <ECEnumerator name="one" displayLabel="One" value="1" />
+    <ECEnumerator name="two" displayLabel="Two" value="2"/>
+  </ECEnumeration>
+
+  <ECStructClass typeName="InnerStruct" modifier="None">
+    <ECProperty propertyName="bool" typeName="boolean"/>
+    <ECArrayProperty propertyName="doubles" typeName="double" minOccurs="0" maxOccurs="unbounded"/>
+  </ECStructClass>
+
+  <ECStructClass typeName="OuterStruct" modifier="None">
+    <ECStructProperty propertyName="innerStruct" typeName="InnerStruct"/>
+    <ECStructArrayProperty propertyName="innerStructs" typeName="InnerStruct" minOccurs="0" maxOccurs="unbounded"/>
+  </ECStructClass>
+
+  <ECEntityClass typeName="TestElement" modifier="None">
+    <BaseClass>bis:PhysicalElement</BaseClass>
+    <ECProperty propertyName="intProp" typeName="int"/>
+    <ECProperty propertyName="point" typeName="point3d"/>
+    <ECProperty propertyName="maybeNull" typeName="int"/>
+    <ECProperty propertyName="datetime" typeName="dateTime"/>
+    <ECArrayProperty propertyName="strings" typeName="string" minOccurs="0" maxOccurs="unbounded"/>
+    <ECStructProperty propertyName="outerStruct" typeName="OuterStruct"/>
+    <ECStructArrayProperty propertyName="outerStructs" typeName="OuterStruct" minOccurs="0" maxOccurs="unbounded"/>
+    <ECProperty propertyName="intEnum" typeName="IntEnum"/>
+  </ECEntityClass>
+
+  <ECEntityClass typeName="TestAspect" modifier="None">
+    <BaseClass>bis:ElementUniqueAspect</BaseClass>
+    <ECProperty propertyName="aspectProp" typeName="int"/>
+  </ECEntityClass>
+
+  <ECEntityClass typeName="TestElementStringProp" modifier="Abstract">
+    <ECCustomAttributes>
+      <QueryView xmlns="ECDbMap.02.00.04">
+        <Query>
+          SELECT
+            jo.ECInstanceId,
+            ec_classid('Fields', 'TestElementStringProp') [ECClassId],
+            json_extract(jo.jsonProperties, '$.stringProp') [StringProp]
+          FROM Fields.TestElement jo
+        </Query>
+      </QueryView>
+    </ECCustomAttributes>
+    <ECProperty propertyName="StringProp" typeName="string" />
+  </ECEntityClass>
+</ECSchema>
 `;
 class TestElement extends PhysicalElement {
     static get className() { return "TestElement"; }
@@ -222,7 +222,6 @@ async function registerTestSchema(iModel) {
         ClassRegistry.register(TestAspect, FieldsSchema);
     }
     await iModel.importSchemaStrings([fieldsSchemaXml]);
-    iModel.saveChanges();
 }
 describe("Field evaluation", () => {
     let imodel;
@@ -233,19 +232,18 @@ describe("Field evaluation", () => {
         const iModelPath = IModelTestUtils.prepareOutputFile("UpdateFieldsContext", "test.bim");
         imodel = StandaloneDb.createEmpty(iModelPath, { rootSubject: { name: "UpdateFieldsContext" }, enableTransactions: true });
         await registerTestSchema(imodel);
-        model = IModelTestUtils.createAndInsertPhysicalPartitionAndModel(imodel, Code.createEmpty(), true)[1];
-        category = SpatialCategory.insert(imodel, StandaloneDb.dictionaryId, "UpdateFieldsContextCategory", new SubCategoryAppearance());
-        sourceElementId = insertTestElement();
-        await imodel.fonts.embedFontFile({
-            file: FontFile.createFromTrueTypeFileName(IModelTestUtils.resolveFontFile("Karla-Regular.ttf"))
+        await withEditTxn(imodel, async (txn) => {
+            model = IModelTestUtils.createAndInsertPhysicalPartitionAndModel(txn, Code.createEmpty(), true)[1];
+            category = SpatialCategory.insert(txn, StandaloneDb.dictionaryId, "UpdateFieldsContextCategory", new SubCategoryAppearance());
+            await imodel.fonts.embedFontFile({
+                file: FontFile.createFromTrueTypeFileName(IModelTestUtils.resolveFontFile("Karla-Regular.ttf"))
+            });
+            sourceElementId = insertTestElement(txn, model, category);
         });
     });
     after(() => {
         imodel.close();
     });
-    function insertTestElement(overrides, aspectProp) {
-        return createTestElement(imodel, model, category, overrides, aspectProp);
-    }
     function evaluateField(propertyPath, propertyHost, deletedDependency = false) {
         if (typeof propertyHost === "string") {
             propertyHost = { schemaName: "Fields", className: "TestElement", elementId: propertyHost };
@@ -449,7 +447,7 @@ describe("Field evaluation", () => {
     }
     function insertAnnotationElement(textBlock) {
         const elem = createAnnotationElement(textBlock);
-        return elem.insert();
+        return withEditTxn(imodel, (txn) => txn.insertElement(elem.toJSON()));
     }
     describe("ElementDrivesTextAnnotation", () => {
         function expectNumRelationships(expected, targetId) {
@@ -471,7 +469,7 @@ describe("Field evaluation", () => {
             const targetAnno = imodel.elements.getElement(targetId);
             expect(targetAnno).instanceof(TextAnnotation3d);
             const rel = ElementDrivesTextAnnotation.create(imodel, sourceElementId, targetId);
-            const relId = rel.insert();
+            const relId = withEditTxn(imodel, (txn) => txn.insertRelationship(rel.toJSON()));
             expect(relId).not.to.equal(Id64.invalid);
             expectNumRelationships(1);
             const relationship = imodel.relationships.getInstance("BisCore:ElementDrivesTextAnnotation", relId);
@@ -491,40 +489,35 @@ describe("Field evaluation", () => {
         }
         describe("updateFieldDependencies", () => {
             it("creates exactly one relationship for each unique source element on insert and update", () => {
-                const source1 = insertTestElement();
+                const source1 = withEditTxn(imodel, (editTxn) => insertTestElement(editTxn, model, category));
                 const block = TextBlock.create();
                 block.appendRun(createField(source1, "1"));
                 const targetId = insertAnnotationElement(block);
-                imodel.saveChanges();
                 expectNumRelationships(1, targetId);
-                const source2 = insertTestElement();
+                const source2 = withEditTxn(imodel, (editTxn) => insertTestElement(editTxn, model, category));
                 const target = imodel.elements.getElement(targetId);
                 const anno = target.getAnnotation();
                 anno.textBlock.appendRun(createField(source2, "2a"));
                 target.setAnnotation(anno);
-                target.update();
-                imodel.saveChanges();
+                withEditTxn(imodel, (txn) => target.update(txn));
                 expectNumRelationships(2, targetId);
                 anno.textBlock.appendRun(createField(source2, "2b"));
                 target.setAnnotation(anno);
-                target.update();
-                imodel.saveChanges();
+                withEditTxn(imodel, (txn) => target.update(txn));
                 expectNumRelationships(2, targetId);
-                const source3 = insertTestElement();
+                const source3 = withEditTxn(imodel, (editTxn) => insertTestElement(editTxn, model, category));
                 anno.textBlock.appendRun(createField(source3, "3"));
                 target.setAnnotation(anno);
-                target.update();
-                imodel.saveChanges();
+                withEditTxn(imodel, (txn) => target.update(txn));
                 expectNumRelationships(3, targetId);
             });
             it("deletes stale relationships", () => {
-                const sourceA = insertTestElement();
-                const sourceB = insertTestElement();
+                const sourceA = withEditTxn(imodel, (editTxn) => insertTestElement(editTxn, model, category));
+                const sourceB = withEditTxn(imodel, (editTxn) => insertTestElement(editTxn, model, category));
                 const block = TextBlock.create();
                 block.appendRun(createField(sourceA, "A"));
                 block.appendRun(createField(sourceB, "B"));
                 const targetId = insertAnnotationElement(block);
-                imodel.saveChanges();
                 expectNumRelationships(2, targetId);
                 expect(imodel.relationships.tryGetInstance(ElementDrivesTextAnnotation.classFullName, { targetId, sourceId: sourceA })).not.to.be.undefined;
                 expect(imodel.relationships.tryGetInstance(ElementDrivesTextAnnotation.classFullName, { targetId, sourceId: sourceB })).not.to.be.undefined;
@@ -534,16 +527,14 @@ describe("Field evaluation", () => {
                 const p1 = anno.textBlock.children[0];
                 p1.children.shift();
                 target.setAnnotation(anno);
-                target.update();
-                imodel.saveChanges();
+                withEditTxn(imodel, (txn) => target.update(txn));
                 expectNumRelationships(1, targetId);
                 expect(imodel.relationships.tryGetInstance(ElementDrivesTextAnnotation.classFullName, { targetId, sourceId: sourceA })).to.be.undefined;
                 expect(imodel.relationships.tryGetInstance(ElementDrivesTextAnnotation.classFullName, { targetId, sourceId: sourceB })).not.to.be.undefined;
                 anno.textBlock.children.length = 0;
                 anno.textBlock.appendRun(createField(sourceA, "A2"));
                 target.setAnnotation(anno);
-                target.update();
-                imodel.saveChanges();
+                withEditTxn(imodel, (txn) => target.update(txn));
                 expectNumRelationships(1, targetId);
                 expect(imodel.relationships.tryGetInstance(ElementDrivesTextAnnotation.classFullName, { targetId, sourceId: sourceA })).not.to.be.undefined;
                 expect(imodel.relationships.tryGetInstance(ElementDrivesTextAnnotation.classFullName, { targetId, sourceId: sourceB })).to.be.undefined;
@@ -553,20 +544,18 @@ describe("Field evaluation", () => {
                     content: "not a field",
                 }));
                 target.setAnnotation(anno);
-                target.update();
-                imodel.saveChanges();
+                withEditTxn(imodel, (txn) => target.update(txn));
                 expectNumRelationships(0, targetId);
                 expect(imodel.relationships.tryGetInstance(ElementDrivesTextAnnotation.classFullName, { targetId, sourceId: sourceA })).to.be.undefined;
                 expect(imodel.relationships.tryGetInstance(ElementDrivesTextAnnotation.classFullName, { targetId, sourceId: sourceB })).to.be.undefined;
             });
             it("ignores invalid source element Ids", () => {
-                const source = insertTestElement();
+                const source = withEditTxn(imodel, (editTxn) => insertTestElement(editTxn, model, category));
                 const block = TextBlock.create();
                 block.appendRun(createField(Id64.invalid, "invalid"));
                 block.appendRun(createField("0xbaadf00d", "non-existent"));
                 block.appendRun(createField(source, "valid"));
                 const targetId = insertAnnotationElement(block);
-                imodel.saveChanges();
                 expectNumRelationships(1, targetId);
             });
         });
@@ -578,116 +567,114 @@ describe("Field evaluation", () => {
             expect(actual).to.equal(expected);
         }
         it("evaluates cachedContent when annotation element is inserted", () => {
-            const sourceId = insertTestElement();
+            const sourceId = withEditTxn(imodel, (editTxn) => insertTestElement(editTxn, model, category));
             const block = TextBlock.create();
             block.appendRun(createField(sourceId, "initial cached content"));
             expect(block.stringify()).to.equal("initial cached content");
             const targetId = insertAnnotationElement(block);
-            imodel.saveChanges();
             const target = imodel.elements.getElement(targetId);
             expect(target.getAnnotation().textBlock.stringify()).to.equal("100");
         });
         it("updates fields when source element is modified or deleted", () => {
-            const sourceId = insertTestElement();
+            const sourceId = withEditTxn(imodel, (editTxn) => insertTestElement(editTxn, model, category));
             const block = TextBlock.create();
             block.appendRun(createField(sourceId, "old value"));
             ;
             const targetId = insertAnnotationElement(block);
-            imodel.saveChanges();
             const target = imodel.elements.getElement(targetId);
             expect(target.getAnnotation()).not.to.be.undefined;
             expectText("100", targetId);
             let source = imodel.elements.getElement(sourceId);
             source.intProp = 50;
-            source.update();
             expectText("100", targetId);
-            imodel.saveChanges();
-            source = imodel.elements.getElement(sourceId);
-            expect(source.intProp).to.equal(50);
-            expectText("50", targetId);
-            imodel.elements.deleteElement(sourceId);
-            expectText("50", targetId);
-            imodel.saveChanges();
+            withEditTxn(imodel, "delete source element fields", (txn) => {
+                source.update(txn);
+                expectText("100", targetId);
+                txn.saveChanges("update source element fields");
+                source = imodel.elements.getElement(sourceId);
+                expect(source.intProp).to.equal(50);
+                expectText("50", targetId);
+                source.delete(txn);
+                expectText("50", targetId);
+            });
             expectText(FieldRun.invalidContentIndicator, targetId);
         });
         it("updates fields when source element aspect is modified, deleted, or recreated", () => {
-            const sourceId = insertTestElement();
+            const sourceId = withEditTxn(imodel, (editTxn) => insertTestElement(editTxn, model, category));
             const block = TextBlock.create();
             block.appendRun(createField({ elementId: sourceId, schemaName: "Fields", className: "TestAspect" }, "", "aspectProp"));
             const targetId = insertAnnotationElement(block);
-            imodel.saveChanges();
             expectText("999", targetId);
             const aspects = imodel.elements.getAspects(sourceId, "Fields:TestAspect");
             expect(aspects.length).to.equal(1);
             const aspect = aspects[0];
             expect(aspect.aspectProp).to.equal(999);
             aspect.aspectProp = 12345;
-            imodel.elements.updateAspect(aspect.toJSON());
-            imodel.saveChanges();
-            expectText("12345", targetId);
-            imodel.elements.deleteAspect([aspect.id]);
-            imodel.saveChanges();
-            expectText(FieldRun.invalidContentIndicator, targetId);
             const newAspect = {
                 element: new ElementOwnsUniqueAspect(sourceId),
                 classFullName: TestAspect.classFullName,
                 aspectProp: 42,
             };
-            imodel.elements.insertAspect(newAspect);
-            imodel.saveChanges();
-            expectText("42", targetId);
+            withEditTxn(imodel, "recreate source aspect fields", (txn) => {
+                txn.updateAspect(aspect.toJSON());
+                txn.saveChanges("update source aspect fields");
+                expectText("12345", targetId);
+                txn.deleteAspect([aspect.id]);
+                txn.saveChanges("delete source aspect fields");
+                expectText(FieldRun.invalidContentIndicator, targetId);
+                txn.insertAspect(newAspect);
+                txn.saveChanges("recreate source aspect fields");
+                expectText("42", targetId);
+            });
         });
         it("updates only fields for specific modified element", () => {
-            const sourceA = insertTestElement();
-            const sourceB = insertTestElement();
+            const sourceA = withEditTxn(imodel, (editTxn) => insertTestElement(editTxn, model, category));
+            const sourceB = withEditTxn(imodel, (editTxn) => insertTestElement(editTxn, model, category));
             const block = TextBlock.create();
             block.appendRun(createField(sourceA, "A"));
             block.appendRun(createField(sourceB, "B"));
             const targetId = insertAnnotationElement(block);
-            imodel.saveChanges();
             expectText("100100", targetId);
             const sourceElem = imodel.elements.getElement(sourceB);
             sourceElem.intProp = 123;
-            sourceElem.update();
-            imodel.saveChanges();
+            withEditTxn(imodel, (txn) => sourceElem.update(txn));
             expectText("100123", targetId);
         });
         it("supports complex property paths", () => {
-            const sourceId = insertTestElement();
+            const sourceId = withEditTxn(imodel, (editTxn) => insertTestElement(editTxn, model, category));
             const block = TextBlock.create();
             block.appendRun(createField(sourceId, "", "outerStruct", ["innerStructs", 1, "doubles", -2]));
             const targetId = insertAnnotationElement(block);
-            imodel.saveChanges();
             expectText("2", targetId);
             const source = imodel.elements.getElement(sourceId);
             source.outerStruct.innerStructs[1].doubles[3] = 12.5;
-            source.update();
-            imodel.saveChanges();
+            withEditTxn(imodel, (txn) => source.update(txn));
             expectText("12.5", targetId);
         });
         it("updates EC view fields when the element changes if the EC view queries the element directly", () => {
-            const sourceId = insertTestElement();
+            const sourceId = withEditTxn(imodel, (editTxn) => insertTestElement(editTxn, model, category));
             const block = TextBlock.create();
             block.appendRun(createField({
                 elementId: sourceId, schemaName: "Fields", className: "TestElementStringProp",
             }, "cached-content", "StringProp"));
             const targetId = insertAnnotationElement(block);
-            imodel.saveChanges();
             const target = imodel.elements.getElement(targetId);
             expect(target.getAnnotation()).not.to.be.undefined;
             expectText("abc", targetId);
             let source = imodel.elements.getElement(sourceId);
             source.jsonProperties.stringProp = "zyx";
-            source.update();
             expectText("abc", targetId);
-            imodel.saveChanges();
-            expectText("zyx", targetId);
-            source = imodel.elements.getElement(sourceId);
-            expect(source.jsonProperties.stringProp).to.equal("zyx");
-            expectText("zyx", targetId);
-            imodel.elements.deleteElement(sourceId);
-            expectText("zyx", targetId);
-            imodel.saveChanges();
+            withEditTxn(imodel, "delete EC view fields", (txn) => {
+                source.update(txn);
+                expectText("abc", targetId);
+                txn.saveChanges("update EC view fields");
+                expectText("zyx", targetId);
+                source = imodel.elements.getElement(sourceId);
+                expect(source.jsonProperties.stringProp).to.equal("zyx");
+                expectText("zyx", targetId);
+                source.delete(txn);
+                expectText("zyx", targetId);
+            });
             expectText(FieldRun.invalidContentIndicator, targetId);
         });
         describe("remapFields", () => {
@@ -700,21 +687,26 @@ describe("Field evaluation", () => {
                 dstIModel = StandaloneDb.createEmpty(path, { rootSubject: { name: `RemapFields-dst` }, enableTransactions: true });
                 await registerTestSchema(dstIModel);
                 // Insert additional unused elements to ensure element Ids differ between src and dst iModels
-                for (let i = 0; i < 3; i++) {
-                    IModelTestUtils.createAndInsertPhysicalPartitionAndModel(dstIModel, Code.createEmpty(), true);
-                }
-                const modelAndElement = IModelTestUtils.createAndInsertPhysicalPartitionAndModel(dstIModel, Code.createEmpty(), true);
+                const modelAndElement = withEditTxn(dstIModel, (txn) => {
+                    for (let i = 0; i < 3; i++) {
+                        IModelTestUtils.createAndInsertPhysicalPartitionAndModel(txn, Code.createEmpty(), true);
+                    }
+                    const ids = IModelTestUtils.createAndInsertPhysicalPartitionAndModel(txn, Code.createEmpty(), true);
+                    dstCategory = SpatialCategory.insert(txn, StandaloneDb.dictionaryId, `dstCat`, new SubCategoryAppearance());
+                    return ids;
+                });
                 expect(modelAndElement[0]).to.equal(modelAndElement[1]);
                 dstModel = modelAndElement[1];
-                dstCategory = SpatialCategory.insert(dstIModel, StandaloneDb.dictionaryId, `dstCat`, new SubCategoryAppearance());
-                dstSourceElementId = createTestElement(dstIModel, dstModel, dstCategory, {
+                dstSourceElementId = withEditTxn(dstIModel, (txn) => insertTestElement(txn, dstModel, dstCategory, {
                     intProp: 200,
                     point: { x: -1, y: -2, z: -3 },
                     strings: ["x", "y", "z"],
                     intEnum: 2,
-                }, 1234);
-                await dstIModel.fonts.embedFontFile({
-                    file: FontFile.createFromTrueTypeFileName(IModelTestUtils.resolveFontFile("Karla-Regular.ttf"))
+                }, 1234));
+                await withEditTxn(dstIModel, async () => {
+                    await dstIModel.fonts.embedFontFile({
+                        file: FontFile.createFromTrueTypeFileName(IModelTestUtils.resolveFontFile("Karla-Regular.ttf"))
+                    });
                 });
                 expect(dstCategory).not.to.equal(category);
                 expect(dstModel).not.to.equal(model);