@itwin/core-backend 5.11.0-dev.9 → 5.11.0

package/lib/esm/test/TestUtils.js

@@ -8,6 +8,8 @@ import { BentleyLoggerCategory, Logger, LogLevel, ProcessDetector } from "@itwin
 import { BackendLoggerCategory } from "../BackendLoggerCategory";
 import { IModelHost } from "../IModelHost";
 import { IModelNative } from "../internal/NativePlatform";
+import { GeoCoordConfig } from "../GeoCoordConfig";
+import { SettingsPriority } from "../workspace/Settings";
 /** Class for simple test timing */
 export class Timer {
     _label;
@@ -40,7 +42,7 @@ export class DisableNativeAssertions {
         this._native.dispose();
         this._native = undefined;
     }
-    /** @deprecated in 5.0 - will not be removed until after 2026-06-13. Use [Symbol.dispose] instead. */
+    /** @deprecated in 5.0 - might be removed in next major version. Use [Symbol.dispose] instead. */
     dispose() {
         this[Symbol.dispose]();
     }
@@ -55,19 +57,36 @@ export class TestUtils {
         }
         return fallback ?? path.join(__dirname, ".cache"); // Set the cache dir to be under the lib directory.
     }
-    /** Handles the startup of IModelHost.
+    /** Handles the startup of IModelHost for unit tests.
      * The provided config is used and will override any of the default values used in this method.
      *
      * The default includes:
      * - cacheDir = path.join(__dirname, ".cache")
      * - allowSharedChannel = false;
+     *
+     * GCS (Geographic Coordinate System) workspace loading is disabled by default, since unit tests
+     * should not make network requests. Pass `loadGcsWorkspaces: true` for the rare test that genuinely
+     * needs GCS data (which then belongs in the integration suite). This flag is test-only and is not
+     * forwarded to `IModelHost.startup`.
      */
     static async startBackend(config) {
-        const cfg = config ?? {};
+        const { loadGcsWorkspaces, ...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);
+        if (!loadGcsWorkspaces)
+            TestUtils.disableGcsWorkspaces();
+    }
+    /**
+     * Suppress loading of Geographic Coordinate System (GCS) workspaces from cloud containers (and the
+     * network requests they issue when iModels are opened) by overriding the existing GeoCoordConfig
+     * setting. Unit tests should not make network calls; tests that genuinely require GCS data belong
+     * in the integration suite. GCS workspaces load lazily on first iModel open, so overriding the
+     * setting any time after `IModelHost.startup` is sufficient.
+     */
+    static disableGcsWorkspaces() {
+        IModelHost.appWorkspace.settings.addDictionary({ name: "test-gcs-disable-override", priority: SettingsPriority.application }, { [GeoCoordConfig.settingName.disableWorkspaces]: true });
     }
     static async shutdownBackend() {
         return IModelHost.shutdown();

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

@@ -1 +1 @@
-{"version":3,"file":"TestUtils.js","sourceRoot":"","sources":["../../../src/test/TestUtils.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAE/F,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAkB,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,EAAE,qBAAqB,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC/F,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,UAAU,EAAqB,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,mCAAmC;AACnC,MAAM,OAAO,KAAK;IACR,MAAM,CAAS;IACf,MAAM,CAAO;IACrB,YAAY,KAAa;QACvB,IAAI,CAAC,MAAM,GAAG,KAAK,KAAK,EAAE,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;IAC3B,CAAC;IAEM,GAAG;QACR,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACvD,sCAAsC;QACtC,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,KAAK,OAAO,IAAI,CAAC,CAAC;IAC9C,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,uBAAuB;IAC1B,OAAO,CAAqD;IAEpE;QACE,IAAI,CAAC,OAAO,GAAG,IAAI,YAAY,CAAC,QAAQ,CAAC,uBAAuB,EAAE,CAAC;IACrE,CAAC;IAEM,CAAC,MAAM,CAAC,OAAO,CAAC;QACrB,IAAI,CAAC,IAAI,CAAC,OAAO;YACf,OAAO;QAET,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;IAC3B,CAAC;IAED,qGAAqG;IAC9F,OAAO;QACZ,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;IACzB,CAAC;CACF;AAED,MAAM,OAAO,SAAS;IACZ,MAAM,CAAC,kBAAkB;QAC/B,OAAO,OAAO,CAAC,GAAG,CAAC,wCAAwC,KAAK,GAAG,CAAC;IACtE,CAAC;IAEM,MAAM,CAAC,WAAW,CAAC,WAA+B,SAAS;QAChE,IAAI,eAAe,CAAC,kBAAkB,EAAE,CAAC;YACvC,OAAO,SAAS,CAAC,CAAC,wCAAwC;QAC5D,CAAC;QACD,OAAO,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,mDAAmD;IACxG,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,MAA0B;QACzD,MAAM,GAAG,GAAG,MAAM,IAAI,EAAE,CAAC;QACzB,GAAG,CAAC,QAAQ,GAAG,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACnD,GAAG,CAAC,kBAAkB,KAAK,KAAK,CAAC,CAAC,8EAA8E;QAChH,GAAG,CAAC,wBAAwB,KAAK,OAAO,CAAC;QACzC,MAAM,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,eAAe;QACjC,OAAO,UAAU,CAAC,QAAQ,EAAE,CAAC;IAC/B,CAAC;IAEM,MAAM,CAAC,YAAY;QACxB,IAAI,SAAS,CAAC,kBAAkB,EAAE;YAChC,MAAM,CAAC,mBAAmB,EAAE,CAAC;;YAE7B,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IAEO,MAAM,CAAC,kBAAkB,CAAC,KAAe;QAC/C,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAClE,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC3F,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACzF,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACvF,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC1F,CAAC;IAED,sDAAsD;IACtD,2DAA2D;IACpD,MAAM,CAAC,mBAAmB;QAC/B,SAAS,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAEM,MAAM,CAAC,mBAAmB;QAC/B,SAAS,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;CACF;AAED,kFAAkF;AAClF,MAAM,CAAC,KAAK,IAAI,EAAE;IAChB,SAAS,CAAC,YAAY,EAAE,CAAC;IACzB,MAAM,SAAS,CAAC,YAAY,EAAE,CAAC;AACjC,CAAC,CAAC,CAAC;AAEH,KAAK,CAAC,KAAK,IAAI,EAAE;IACf,MAAM,SAAS,CAAC,eAAe,EAAE,CAAC;AACpC,CAAC,CAAC,CAAC","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  private static shouldLogToConsole(): boolean {\n    return process.env.ITWINJS_CORE_BACKEND_TEST_LOG_TO_CONSOLE === \"1\";\n  }\n\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    cfg.implicitWriteEnforcement ??= \"throw\";\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    if (TestUtils.shouldLogToConsole())\n      Logger.initializeToConsole();\n    else\n      Logger.initialize();\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":["/*---------------------------------------------------------------------------------------------\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\";\nimport { GeoCoordConfig } from \"../GeoCoordConfig\";\nimport { SettingsPriority } from \"../workspace/Settings\";\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 - might be removed in next major version. Use [Symbol.dispose] instead. */\n  public dispose(): void {\n    this[Symbol.dispose]();\n  }\n}\n\nexport class TestUtils {\n  private static shouldLogToConsole(): boolean {\n    return process.env.ITWINJS_CORE_BACKEND_TEST_LOG_TO_CONSOLE === \"1\";\n  }\n\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 for unit tests.\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   * GCS (Geographic Coordinate System) workspace loading is disabled by default, since unit tests\n   * should not make network requests. Pass `loadGcsWorkspaces: true` for the rare test that genuinely\n   * needs GCS data (which then belongs in the integration suite). This flag is test-only and is not\n   * forwarded to `IModelHost.startup`.\n   */\n  public static async startBackend(config?: IModelHostOptions & { loadGcsWorkspaces?: boolean }): Promise<void> {\n    const { loadGcsWorkspaces, ...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    cfg.implicitWriteEnforcement ??= \"throw\";\n    await IModelHost.startup(cfg);\n    if (!loadGcsWorkspaces)\n      TestUtils.disableGcsWorkspaces();\n  }\n\n  /**\n   * Suppress loading of Geographic Coordinate System (GCS) workspaces from cloud containers (and the\n   * network requests they issue when iModels are opened) by overriding the existing GeoCoordConfig\n   * setting. Unit tests should not make network calls; tests that genuinely require GCS data belong\n   * in the integration suite. GCS workspaces load lazily on first iModel open, so overriding the\n   * setting any time after `IModelHost.startup` is sufficient.\n   */\n  public static disableGcsWorkspaces(): void {\n    IModelHost.appWorkspace.settings.addDictionary(\n      { name: \"test-gcs-disable-override\", priority: SettingsPriority.application },\n      { [GeoCoordConfig.settingName.disableWorkspaces]: true },\n    );\n  }\n\n  public static async shutdownBackend(): Promise<void> {\n    return IModelHost.shutdown();\n  }\n\n  public static setupLogging() {\n    if (TestUtils.shouldLogToConsole())\n      Logger.initializeToConsole();\n    else\n      Logger.initialize();\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"]}

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

@@ -1,3 +1,55 @@
+var __addDisposableResource = (this && this.__addDisposableResource) || function (env, value, async) {
+    if (value !== null && value !== void 0) {
+        if (typeof value !== "object" && typeof value !== "function") throw new TypeError("Object expected.");
+        var dispose, inner;
+        if (async) {
+            if (!Symbol.asyncDispose) throw new TypeError("Symbol.asyncDispose is not defined.");
+            dispose = value[Symbol.asyncDispose];
+        }
+        if (dispose === void 0) {
+            if (!Symbol.dispose) throw new TypeError("Symbol.dispose is not defined.");
+            dispose = value[Symbol.dispose];
+            if (async) inner = dispose;
+        }
+        if (typeof dispose !== "function") throw new TypeError("Object not disposable.");
+        if (inner) dispose = function() { try { inner.call(this); } catch (e) { return Promise.reject(e); } };
+        env.stack.push({ value: value, dispose: dispose, async: async });
+    }
+    else if (async) {
+        env.stack.push({ async: true });
+    }
+    return value;
+};
+var __disposeResources = (this && this.__disposeResources) || (function (SuppressedError) {
+    return function (env) {
+        function fail(e) {
+            env.error = env.hasError ? new SuppressedError(e, env.error, "An error was suppressed during disposal.") : e;
+            env.hasError = true;
+        }
+        var r, s = 0;
+        function next() {
+            while (r = env.stack.pop()) {
+                try {
+                    if (!r.async && s === 1) return s = 0, env.stack.push(r), Promise.resolve().then(next);
+                    if (r.dispose) {
+                        var result = r.dispose.call(r.value);
+                        if (r.async) return s |= 2, Promise.resolve(result).then(next, function(e) { fail(e); return next(); });
+                    }
+                    else s |= 1;
+                }
+                catch (e) {
+                    fail(e);
+                }
+            }
+            if (s === 1) return env.hasError ? Promise.reject(env.error) : Promise.resolve();
+            if (env.hasError) throw env.error;
+        }
+        return next();
+    };
+})(typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+});
 /*---------------------------------------------------------------------------------------------
 * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
 * See LICENSE.md in the project root for license terms and full copyright notice.
@@ -21,6 +73,7 @@ import { layoutTextBlock, TextStyleResolver } from "../../annotations/TextBlockL
 import { appendTextAnnotationGeometry } from "../../annotations/TextAnnotationGeometry";
 import { IModelElementCloneContext } from "../../IModelElementCloneContext";
 import { EditTxn, withEditTxn } from "../../EditTxn";
+import { DisableNativeAssertions } from "../TestUtils";
 import * as fs from "fs";
 function mockIModel() {
     const iModel = {
@@ -521,24 +574,36 @@ describe("TextAnnotation element", () => {
                         expect(para.children[1].propertyHost.elementId).to.equal("0xabc");
                     });
                     it("leaves default text style intact", async () => {
-                        async function clone(styleId, expectedStyleId) {
-                            const elem = insertStyledElement(styleId, imodel);
-                            const context = new IModelElementCloneContext(imodel);
-                            context.remapElement(createElement2dArgs.model, createElement2dArgs.model);
-                            const props = await context.cloneElement(elem);
-                            expect(props.defaultTextStyle?.id).to.equal(expectedStyleId);
-                            if (styleId) {
-                                // Even an explicit remapping is ignored when cloning within a single iModel
-                                // (per the examples set by most other elements, excluding RenderMaterial).
-                                context.remapElement(styleId, "0x99887");
-                                const props2 = await context.cloneElement(elem);
-                                expect(props2.defaultTextStyle?.id).to.equal(expectedStyleId);
+                        const env_1 = { stack: [], error: void 0, hasError: false };
+                        try {
+                            async function clone(styleId, expectedStyleId) {
+                                const elem = insertStyledElement(styleId, imodel);
+                                const context = new IModelElementCloneContext(imodel);
+                                context.remapElement(createElement2dArgs.model, createElement2dArgs.model);
+                                const props = await context.cloneElement(elem);
+                                expect(props.defaultTextStyle?.id).to.equal(expectedStyleId);
+                                if (styleId) {
+                                    // Even an explicit remapping is ignored when cloning within a single iModel
+                                    // (per the examples set by most other elements, excluding RenderMaterial).
+                                    context.remapElement(styleId, "0x99887");
+                                    const props2 = await context.cloneElement(elem);
+                                    expect(props2.defaultTextStyle?.id).to.equal(expectedStyleId);
+                                }
                             }
+                            await clone(seedStyleId, seedStyleId);
+                            await clone(undefined, undefined);
+                            await clone("0x12345", "0x12345");
+                            // The native code asserts on an invalid ID. Suppress this.
+                            const _disableAssertions = __addDisposableResource(env_1, new DisableNativeAssertions(), false);
+                            await clone(Id64.invalid, undefined);
+                        }
+                        catch (e_1) {
+                            env_1.error = e_1;
+                            env_1.hasError = true;
+                        }
+                        finally {
+                            __disposeResources(env_1);
                         }
-                        await clone(seedStyleId, seedStyleId);
-                        await clone(undefined, undefined);
-                        await clone("0x12345", "0x12345");
-                        await clone(Id64.invalid, undefined);
                     });
                 });
                 describe("between iModels", () => {