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

package/lib/esm/rpc-impl/RpcBriefcaseUtility.js.map

@@ -1 +1 @@
-{"version":3,"file":"RpcBriefcaseUtility.js","sourceRoot":"","sources":["../../../src/rpc-impl/RpcBriefcaseUtility.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/** @packageDocumentation\n * @module RpcInterface\n */\n\nimport { AccessToken, assert, BeDuration, IModelStatus, Logger } from \"@itwin/core-bentley\";\nimport {\n  BriefcaseProps, IModelConnectionProps, IModelError, IModelRpcOpenProps, IModelRpcProps, IModelVersion, RpcActivity, RpcPendingResponse, SyncMode,\n} from \"@itwin/core-common\";\nimport { BackendLoggerCategory } from \"../BackendLoggerCategory\";\nimport { BriefcaseManager, RequestNewBriefcaseArg } from \"../BriefcaseManager\";\nimport { CheckpointManager } from \"../CheckpointManager\";\nimport { BriefcaseDb, IModelDb, SnapshotDb } from \"../IModelDb\";\nimport { IModelHost } from \"../IModelHost\";\nimport { IModelJsFs } from \"../IModelJsFs\";\nimport { _hubAccess } from \"../internal/Symbols\";\n\nconst loggerCategory: string = BackendLoggerCategory.IModelDb;\n\n/** @internal */\nexport interface DownloadAndOpenArgs {\n  activity: RpcActivity;\n  tokenProps: IModelRpcOpenProps;\n  syncMode: SyncMode;\n  fileNameResolvers?: ((arg: BriefcaseProps) => string)[];\n  timeout?: number;\n  forceDownload?: boolean;\n}\n/**\n * Utility to open the iModel for RPC interfaces\n * @internal\n */\nexport class RpcBriefcaseUtility {\n  private static async downloadAndOpen(args: DownloadAndOpenArgs): Promise<BriefcaseDb> {\n    const { activity, tokenProps } = args;\n    const accessToken = activity.accessToken;\n    assert(undefined !== tokenProps.iModelId);\n\n    const iModelId = tokenProps.iModelId;\n    let myBriefcaseIds: number[];\n    if (args.syncMode === SyncMode.PullOnly) {\n      myBriefcaseIds = [0]; // PullOnly means briefcaseId 0\n    } else {\n      // check with iModelHub and see if we already have acquired any briefcaseIds\n      myBriefcaseIds = await IModelHost[_hubAccess].getMyBriefcaseIds({ accessToken, iModelId });\n    }\n\n    const resolvers = args.fileNameResolvers ?? [(arg) => BriefcaseManager.getFileName(arg)];\n\n    // see if we can open any of the briefcaseIds we already acquired from iModelHub\n    if (resolvers) {\n      for (const resolver of resolvers) {\n        for (const briefcaseId of myBriefcaseIds) {\n          const fileName = resolver({ briefcaseId, iModelId });\n          if (IModelJsFs.existsSync(fileName)) {\n            const briefcaseDb = BriefcaseDb.findByFilename(fileName);\n            if (briefcaseDb !== undefined) {\n              if (briefcaseDb.isBriefcaseDb()) {\n                return briefcaseDb;\n              } else {\n                throw new IModelError(IModelStatus.AlreadyOpen, \"iModel is already open as a SnapshotDb\");\n              }\n            }\n            try {\n              if (args.forceDownload)\n                throw new Error(); // causes delete below\n              const db = await BriefcaseDb.open({ fileName });\n              if (db.changeset.id !== tokenProps.changeset?.id) {\n                assert(undefined !== tokenProps.changeset);\n                const toIndex = tokenProps.changeset?.index ??\n                  (await IModelHost[_hubAccess].getChangesetFromVersion({ accessToken, iModelId, version: IModelVersion.asOfChangeSet(tokenProps.changeset.id) })).index;\n                await BriefcaseManager.pullAndApplyChangesets(db, { accessToken, toIndex });\n              }\n              return db;\n            } catch (error: any) {\n              if (!(error.errorNumber === IModelStatus.AlreadyOpen))\n                // somehow we have this briefcaseId and the file exists, but we can't open it. Delete it.\n                await BriefcaseManager.deleteBriefcaseFiles(fileName, accessToken);\n            }\n          }\n        }\n      }\n    }\n\n    // no local briefcase available. Download one and open it.\n    assert(undefined !== tokenProps.iTwinId);\n    const request: RequestNewBriefcaseArg = {\n      accessToken,\n      iTwinId: tokenProps.iTwinId,\n      iModelId,\n      briefcaseId: args.syncMode === SyncMode.PullOnly ? 0 : undefined, // if briefcaseId is undefined, we'll acquire a new one.\n    };\n\n    const props = await BriefcaseManager.downloadBriefcase(request);\n    return BriefcaseDb.open(props);\n  }\n\n  private static _briefcasePromises: Map<string, Promise<BriefcaseDb>> = new Map();\n  private static async openBriefcase(args: DownloadAndOpenArgs): Promise<BriefcaseDb> {\n    const key = `${args.tokenProps.iModelId}:${args.tokenProps.changeset?.id}:${args.tokenProps.changeset?.index}:${args.syncMode}`;\n    const cachedPromise = this._briefcasePromises.get(key);\n    if (cachedPromise)\n      return cachedPromise;\n\n    try {\n      const briefcasePromise = this.downloadAndOpen(args); // save the fact that we're working on downloading so if we timeout, we'll reuse this request.\n      this._briefcasePromises.set(key, briefcasePromise);\n      return await briefcasePromise;\n    } finally {\n      this._briefcasePromises.delete(key);  // the download and open is now done\n    }\n  }\n\n  /** find a previously opened iModel for RPC.\n   * @param accessToken necessary (only) for V2 checkpoints to refresh access token in daemon if it has expired. We use the accessToken of the current RPC request\n   * to refresh the daemon, even though it will be used for all authorized users.\n   * @param the IModelRpcProps to locate the opened iModel.\n   */\n  public static async findOpenIModel(accessToken: AccessToken, iModel: IModelRpcProps) {\n    const iModelDb = IModelDb.findByKey(iModel.key);\n\n    // call refreshContainer, just in case this is a V2 checkpoint whose sasToken is about to expire, or its default transaction is about to be restarted.\n    await iModelDb.refreshContainerForRpc(accessToken);\n    return iModelDb;\n  }\n\n  public static async open(args: DownloadAndOpenArgs & { syncMode: SyncMode.FixedVersion }): Promise<IModelDb>;\n  /**\n   * @deprecated in 4.4.0 - will not be removed until after 2026-06-13. Only `SyncMode.FixedVersion` should be used in RPC backends\n   */\n  public static async open(args: DownloadAndOpenArgs & { syncMode: Exclude<SyncMode, \"FixedVersion\"> }): Promise<IModelDb>;\n  /**\n   * Download and open a checkpoint or briefcase, ensuring the operation completes within a default timeout. If the time to open exceeds the timeout period,\n   * a RpcPendingResponse exception is thrown\n   */\n  public static async open(args: DownloadAndOpenArgs): Promise<IModelDb> {\n    const { activity, tokenProps, syncMode } = args;\n    Logger.logTrace(loggerCategory, \"RpcBriefcaseUtility.open\", tokenProps);\n\n    const timeout = args.timeout ?? 1000;\n    if (syncMode === SyncMode.PullOnly || syncMode === SyncMode.PullAndPush) {\n      const briefcaseDb = await BeDuration.race(timeout, this.openBriefcase(args));\n\n      if (briefcaseDb === undefined) {\n        Logger.logTrace(loggerCategory, \"Open briefcase - pending\", tokenProps);\n        throw new RpcPendingResponse(); // eslint-disable-line @typescript-eslint/only-throw-error\n      }\n      // note: usage is logged in the function BriefcaseManager.downloadNewBriefcaseAndOpen\n      return briefcaseDb;\n    }\n    if (!tokenProps.iModelId || !tokenProps.iTwinId || !tokenProps.changeset)\n      throw new IModelError(IModelStatus.BadArg, \"invalid arguments\");\n\n    const checkpoint = {\n      iModelId: tokenProps.iModelId,\n      iTwinId: tokenProps.iTwinId,\n      changeset: tokenProps.changeset,\n      accessToken: activity.accessToken,\n    };\n\n    // opening a checkpoint.\n    let db: SnapshotDb | void;\n    // first check if it's already open\n    db = SnapshotDb.tryFindByKey(CheckpointManager.getKey(checkpoint));\n    if (db) {\n      Logger.logTrace(loggerCategory, \"Checkpoint was already open\", tokenProps);\n      return db;\n    }\n\n    // now try V2 checkpoint\n    db = await SnapshotDb.openCheckpointFromRpc(checkpoint);\n    Logger.logTrace(loggerCategory, \"using V2 checkpoint\", tokenProps);\n\n    return db;\n  }\n\n  public static async openWithTimeout(activity: RpcActivity, tokenProps: IModelRpcOpenProps, syncMode: SyncMode.FixedVersion, timeout?: number): Promise<IModelConnectionProps>;\n  /**\n   * @deprecated in 4.4.0 - will not be removed until after 2026-06-13. Only `SyncMode.FixedVersion` should be used in RPC backends\n   */\n  public static async openWithTimeout(activity: RpcActivity, tokenProps: IModelRpcOpenProps, syncMode: Exclude<SyncMode, \"FixedVersion\">, timeout?: number): Promise<IModelConnectionProps>;\n  public static async openWithTimeout(activity: RpcActivity, tokenProps: IModelRpcOpenProps, syncMode: SyncMode, timeout: number = 1000): Promise<IModelConnectionProps> {\n    if (tokenProps.iModelId)\n      await IModelHost.tileStorage?.initialize(tokenProps.iModelId);\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\n    return (await this.open({ activity, tokenProps, syncMode, timeout })).toJSON();\n  }\n\n}\n"]}
+{"version":3,"file":"RpcBriefcaseUtility.js","sourceRoot":"","sources":["../../../src/rpc-impl/RpcBriefcaseUtility.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/** @packageDocumentation\n * @module RpcInterface\n */\n\nimport { AccessToken, assert, BeDuration, IModelStatus, Logger } from \"@itwin/core-bentley\";\nimport {\n  BriefcaseProps, IModelConnectionProps, IModelError, IModelRpcOpenProps, IModelRpcProps, IModelVersion, RpcActivity, RpcPendingResponse, SyncMode,\n} from \"@itwin/core-common\";\nimport { BackendLoggerCategory } from \"../BackendLoggerCategory\";\nimport { BriefcaseManager, RequestNewBriefcaseArg } from \"../BriefcaseManager\";\nimport { CheckpointManager } from \"../CheckpointManager\";\nimport { BriefcaseDb, IModelDb, SnapshotDb } from \"../IModelDb\";\nimport { IModelHost } from \"../IModelHost\";\nimport { IModelJsFs } from \"../IModelJsFs\";\nimport { _hubAccess } from \"../internal/Symbols\";\n\nconst loggerCategory: string = BackendLoggerCategory.IModelDb;\n\n/** @internal */\nexport interface DownloadAndOpenArgs {\n  activity: RpcActivity;\n  tokenProps: IModelRpcOpenProps;\n  syncMode: SyncMode;\n  fileNameResolvers?: ((arg: BriefcaseProps) => string)[];\n  timeout?: number;\n  forceDownload?: boolean;\n}\n/**\n * Utility to open the iModel for RPC interfaces\n * @internal\n */\nexport class RpcBriefcaseUtility {\n  private static async downloadAndOpen(args: DownloadAndOpenArgs): Promise<BriefcaseDb> {\n    const { activity, tokenProps } = args;\n    const accessToken = activity.accessToken;\n    assert(undefined !== tokenProps.iModelId);\n\n    const iModelId = tokenProps.iModelId;\n    let myBriefcaseIds: number[];\n    if (args.syncMode === SyncMode.PullOnly) {\n      myBriefcaseIds = [0]; // PullOnly means briefcaseId 0\n    } else {\n      // check with iModelHub and see if we already have acquired any briefcaseIds\n      myBriefcaseIds = await IModelHost[_hubAccess].getMyBriefcaseIds({ accessToken, iModelId });\n    }\n\n    const resolvers = args.fileNameResolvers ?? [(arg) => BriefcaseManager.getFileName(arg)];\n\n    // see if we can open any of the briefcaseIds we already acquired from iModelHub\n    if (resolvers) {\n      for (const resolver of resolvers) {\n        for (const briefcaseId of myBriefcaseIds) {\n          const fileName = resolver({ briefcaseId, iModelId });\n          if (IModelJsFs.existsSync(fileName)) {\n            const briefcaseDb = BriefcaseDb.findByFilename(fileName);\n            if (briefcaseDb !== undefined) {\n              if (briefcaseDb.isBriefcaseDb()) {\n                return briefcaseDb;\n              } else {\n                throw new IModelError(IModelStatus.AlreadyOpen, \"iModel is already open as a SnapshotDb\");\n              }\n            }\n            try {\n              if (args.forceDownload)\n                throw new Error(); // causes delete below\n              const db = await BriefcaseDb.open({ fileName });\n              if (db.changeset.id !== tokenProps.changeset?.id) {\n                assert(undefined !== tokenProps.changeset);\n                const toIndex = tokenProps.changeset?.index ??\n                  (await IModelHost[_hubAccess].getChangesetFromVersion({ accessToken, iModelId, version: IModelVersion.asOfChangeSet(tokenProps.changeset.id) })).index;\n                await BriefcaseManager.pullAndApplyChangesets(db, { accessToken, toIndex });\n              }\n              return db;\n            } catch (error: any) {\n              if (!(error.errorNumber === IModelStatus.AlreadyOpen))\n                // somehow we have this briefcaseId and the file exists, but we can't open it. Delete it.\n                await BriefcaseManager.deleteBriefcaseFiles(fileName, accessToken);\n            }\n          }\n        }\n      }\n    }\n\n    // no local briefcase available. Download one and open it.\n    assert(undefined !== tokenProps.iTwinId);\n    const request: RequestNewBriefcaseArg = {\n      accessToken,\n      iTwinId: tokenProps.iTwinId,\n      iModelId,\n      briefcaseId: args.syncMode === SyncMode.PullOnly ? 0 : undefined, // if briefcaseId is undefined, we'll acquire a new one.\n    };\n\n    const props = await BriefcaseManager.downloadBriefcase(request);\n    return BriefcaseDb.open(props);\n  }\n\n  private static _briefcasePromises: Map<string, Promise<BriefcaseDb>> = new Map();\n  private static async openBriefcase(args: DownloadAndOpenArgs): Promise<BriefcaseDb> {\n    const key = `${args.tokenProps.iModelId}:${args.tokenProps.changeset?.id}:${args.tokenProps.changeset?.index}:${args.syncMode}`;\n    const cachedPromise = this._briefcasePromises.get(key);\n    if (cachedPromise)\n      return cachedPromise;\n\n    try {\n      const briefcasePromise = this.downloadAndOpen(args); // save the fact that we're working on downloading so if we timeout, we'll reuse this request.\n      this._briefcasePromises.set(key, briefcasePromise);\n      return await briefcasePromise;\n    } finally {\n      this._briefcasePromises.delete(key);  // the download and open is now done\n    }\n  }\n\n  /** find a previously opened iModel for RPC.\n   * @param accessToken necessary (only) for V2 checkpoints to refresh access token in daemon if it has expired. We use the accessToken of the current RPC request\n   * to refresh the daemon, even though it will be used for all authorized users.\n   * @param the IModelRpcProps to locate the opened iModel.\n   */\n  public static async findOpenIModel(accessToken: AccessToken, iModel: IModelRpcProps) {\n    const iModelDb = IModelDb.findByKey(iModel.key);\n\n    // call refreshContainer, just in case this is a V2 checkpoint whose sasToken is about to expire, or its default transaction is about to be restarted.\n    await iModelDb.refreshContainerForRpc(accessToken);\n    return iModelDb;\n  }\n\n  public static async open(args: DownloadAndOpenArgs & { syncMode: SyncMode.FixedVersion }): Promise<IModelDb>;\n  /**\n   * @deprecated in 4.4.0 - might be removed in next major version. Only `SyncMode.FixedVersion` should be used in RPC backends\n   */\n  public static async open(args: DownloadAndOpenArgs & { syncMode: Exclude<SyncMode, \"FixedVersion\"> }): Promise<IModelDb>;\n  /**\n   * Download and open a checkpoint or briefcase, ensuring the operation completes within a default timeout. If the time to open exceeds the timeout period,\n   * a RpcPendingResponse exception is thrown\n   */\n  public static async open(args: DownloadAndOpenArgs): Promise<IModelDb> {\n    const { activity, tokenProps, syncMode } = args;\n    Logger.logTrace(loggerCategory, \"RpcBriefcaseUtility.open\", tokenProps);\n\n    const timeout = args.timeout ?? 1000;\n    if (syncMode === SyncMode.PullOnly || syncMode === SyncMode.PullAndPush) {\n      const briefcaseDb = await BeDuration.race(timeout, this.openBriefcase(args));\n\n      if (briefcaseDb === undefined) {\n        Logger.logTrace(loggerCategory, \"Open briefcase - pending\", tokenProps);\n        throw new RpcPendingResponse(); // eslint-disable-line @typescript-eslint/only-throw-error\n      }\n      // note: usage is logged in the function BriefcaseManager.downloadNewBriefcaseAndOpen\n      return briefcaseDb;\n    }\n    if (!tokenProps.iModelId || !tokenProps.iTwinId || !tokenProps.changeset)\n      throw new IModelError(IModelStatus.BadArg, \"invalid arguments\");\n\n    const checkpoint = {\n      iModelId: tokenProps.iModelId,\n      iTwinId: tokenProps.iTwinId,\n      changeset: tokenProps.changeset,\n      accessToken: activity.accessToken,\n    };\n\n    // opening a checkpoint.\n    let db: SnapshotDb | void;\n    // first check if it's already open\n    db = SnapshotDb.tryFindByKey(CheckpointManager.getKey(checkpoint));\n    if (db) {\n      Logger.logTrace(loggerCategory, \"Checkpoint was already open\", tokenProps);\n      return db;\n    }\n\n    // now try V2 checkpoint\n    db = await SnapshotDb.openCheckpointFromRpc(checkpoint);\n    Logger.logTrace(loggerCategory, \"using V2 checkpoint\", tokenProps);\n\n    return db;\n  }\n\n  public static async openWithTimeout(activity: RpcActivity, tokenProps: IModelRpcOpenProps, syncMode: SyncMode.FixedVersion, timeout?: number): Promise<IModelConnectionProps>;\n  /**\n   * @deprecated in 4.4.0 - might be removed in next major version. Only `SyncMode.FixedVersion` should be used in RPC backends\n   */\n  public static async openWithTimeout(activity: RpcActivity, tokenProps: IModelRpcOpenProps, syncMode: Exclude<SyncMode, \"FixedVersion\">, timeout?: number): Promise<IModelConnectionProps>;\n  public static async openWithTimeout(activity: RpcActivity, tokenProps: IModelRpcOpenProps, syncMode: SyncMode, timeout: number = 1000): Promise<IModelConnectionProps> {\n    if (tokenProps.iModelId)\n      await IModelHost.tileStorage?.initialize(tokenProps.iModelId);\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\n    return (await this.open({ activity, tokenProps, syncMode, timeout })).toJSON();\n  }\n\n}\n"]}

package/lib/esm/rpc-impl/SnapshotIModelRpcImpl.d.ts

@@ -4,7 +4,7 @@
 import { IModelConnectionProps, IModelRpcProps, RpcInterface, SnapshotIModelRpcInterface, SnapshotOpenOptions } from "@itwin/core-common";
 /** The backend implementation of SnapshotIModelRpcInterface.
  * @internal
- * @deprecated in 5.0 - will not be removed until after 2026-06-13. Check [[IpcAppFunctions]] for replacements.
+ * @deprecated in 5.0 - might be removed in next major version. Check [[IpcAppFunctions]] for replacements.
  */
 export declare class SnapshotIModelRpcImpl extends RpcInterface implements SnapshotIModelRpcInterface {
     static register(): void;

package/lib/esm/rpc-impl/SnapshotIModelRpcImpl.js

@@ -11,7 +11,7 @@ import { IModelHost } from "../IModelHost";
 /* eslint-disable @typescript-eslint/no-deprecated */
 /** The backend implementation of SnapshotIModelRpcInterface.
  * @internal
- * @deprecated in 5.0 - will not be removed until after 2026-06-13. Check [[IpcAppFunctions]] for replacements.
+ * @deprecated in 5.0 - might be removed in next major version. Check [[IpcAppFunctions]] for replacements.
  */
 export class SnapshotIModelRpcImpl extends RpcInterface {
     static register() { RpcManager.registerImpl(SnapshotIModelRpcInterface, SnapshotIModelRpcImpl); }

package/lib/esm/rpc-impl/SnapshotIModelRpcImpl.js.map

@@ -1 +1 @@
-{"version":3,"file":"SnapshotIModelRpcImpl.js","sourceRoot":"","sources":["../../../src/rpc-impl/SnapshotIModelRpcImpl.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAEH,OAAO,EACkB,sBAAsB,EAAkB,YAAY,EAAE,UAAU,EAAE,0BAA0B,GACpH,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,qDAAqD;AAErD;;;GAGG;AACH,MAAM,OAAO,qBAAsB,SAAQ,YAAY;IAC9C,MAAM,CAAC,QAAQ,KAAK,UAAU,CAAC,YAAY,CAAC,0BAA0B,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAExG,kGAAkG;IAC3F,KAAK,CAAC,QAAQ,CAAC,QAAgB,EAAE,IAA0B;QAChE,IAAI,gBAAgB,GAAuB,QAAQ,CAAC;QACpD,IAAI,UAAU,CAAC,wBAAwB,EAAE,CAAC;YACxC,gBAAgB,GAAG,UAAU,CAAC,wBAAwB,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;YACpF,IAAI,SAAS,KAAK,gBAAgB;gBAChC,MAAM,IAAI,sBAAsB,EAAE,CAAC,CAAC,0DAA0D;QAClG,CAAC;QACD,OAAO,UAAU,CAAC,QAAQ,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC,kBAAkB,EAAE,CAAC;IAC1E,CAAC;IAED,4FAA4F;IACrF,KAAK,CAAC,UAAU,CAAC,OAAe,EAAE,IAA0B;QACjE,MAAM,gBAAgB,GAAG,UAAU,CAAC,wBAAwB,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;QAClF,IAAI,SAAS,KAAK,gBAAgB;YAChC,MAAM,IAAI,sBAAsB,EAAE,CAAC,CAAC,0DAA0D;QAEhG,OAAO,UAAU,CAAC,QAAQ,CAAC,gBAAgB,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,kBAAkB,EAAE,CAAC;IAC/F,CAAC;IAED,kDAAkD;IAC3C,KAAK,CAAC,KAAK,CAAC,UAA0B;QAC3C,UAAU,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;CACF","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module RpcInterface\n */\n\nimport {\n  IModelConnectionProps, IModelNotFoundResponse, IModelRpcProps, RpcInterface, RpcManager, SnapshotIModelRpcInterface, SnapshotOpenOptions,\n} from \"@itwin/core-common\";\nimport { SnapshotDb } from \"../IModelDb\";\nimport { IModelHost } from \"../IModelHost\";\n\n/* eslint-disable @typescript-eslint/no-deprecated */\n\n/** The backend implementation of SnapshotIModelRpcInterface.\n * @internal\n * @deprecated in 5.0 - will not be removed until after 2026-06-13. Check [[IpcAppFunctions]] for replacements.\n */\nexport class SnapshotIModelRpcImpl extends RpcInterface implements SnapshotIModelRpcInterface {\n  public static register() { RpcManager.registerImpl(SnapshotIModelRpcInterface, SnapshotIModelRpcImpl); }\n\n  /** Ask the backend to open a snapshot iModel from a file name that is resolved by the backend. */\n  public async openFile(filePath: string, opts?: SnapshotOpenOptions): Promise<IModelConnectionProps> {\n    let resolvedFileName: string | undefined = filePath;\n    if (IModelHost.snapshotFileNameResolver) {\n      resolvedFileName = IModelHost.snapshotFileNameResolver.tryResolveFileName(filePath);\n      if (undefined === resolvedFileName)\n        throw new IModelNotFoundResponse(); // eslint-disable-line @typescript-eslint/only-throw-error\n    }\n    return SnapshotDb.openFile(resolvedFileName, opts).getConnectionProps();\n  }\n\n  /** Ask the backend to open a snapshot iModel from a key that is resolved by the backend. */\n  public async openRemote(fileKey: string, opts?: SnapshotOpenOptions): Promise<IModelConnectionProps> {\n    const resolvedFileName = IModelHost.snapshotFileNameResolver?.resolveKey(fileKey);\n    if (undefined === resolvedFileName)\n      throw new IModelNotFoundResponse(); // eslint-disable-line @typescript-eslint/only-throw-error\n\n    return SnapshotDb.openFile(resolvedFileName, { key: fileKey, ...opts }).getConnectionProps();\n  }\n\n  /** Ask the backend to close a snapshot iModel. */\n  public async close(tokenProps: IModelRpcProps): Promise<boolean> {\n    SnapshotDb.findByKey(tokenProps.key).close();\n    return true;\n  }\n}\n"]}
+{"version":3,"file":"SnapshotIModelRpcImpl.js","sourceRoot":"","sources":["../../../src/rpc-impl/SnapshotIModelRpcImpl.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAEH,OAAO,EACkB,sBAAsB,EAAkB,YAAY,EAAE,UAAU,EAAE,0BAA0B,GACpH,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,qDAAqD;AAErD;;;GAGG;AACH,MAAM,OAAO,qBAAsB,SAAQ,YAAY;IAC9C,MAAM,CAAC,QAAQ,KAAK,UAAU,CAAC,YAAY,CAAC,0BAA0B,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAExG,kGAAkG;IAC3F,KAAK,CAAC,QAAQ,CAAC,QAAgB,EAAE,IAA0B;QAChE,IAAI,gBAAgB,GAAuB,QAAQ,CAAC;QACpD,IAAI,UAAU,CAAC,wBAAwB,EAAE,CAAC;YACxC,gBAAgB,GAAG,UAAU,CAAC,wBAAwB,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;YACpF,IAAI,SAAS,KAAK,gBAAgB;gBAChC,MAAM,IAAI,sBAAsB,EAAE,CAAC,CAAC,0DAA0D;QAClG,CAAC;QACD,OAAO,UAAU,CAAC,QAAQ,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC,kBAAkB,EAAE,CAAC;IAC1E,CAAC;IAED,4FAA4F;IACrF,KAAK,CAAC,UAAU,CAAC,OAAe,EAAE,IAA0B;QACjE,MAAM,gBAAgB,GAAG,UAAU,CAAC,wBAAwB,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;QAClF,IAAI,SAAS,KAAK,gBAAgB;YAChC,MAAM,IAAI,sBAAsB,EAAE,CAAC,CAAC,0DAA0D;QAEhG,OAAO,UAAU,CAAC,QAAQ,CAAC,gBAAgB,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,kBAAkB,EAAE,CAAC;IAC/F,CAAC;IAED,kDAAkD;IAC3C,KAAK,CAAC,KAAK,CAAC,UAA0B;QAC3C,UAAU,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;CACF","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module RpcInterface\n */\n\nimport {\n  IModelConnectionProps, IModelNotFoundResponse, IModelRpcProps, RpcInterface, RpcManager, SnapshotIModelRpcInterface, SnapshotOpenOptions,\n} from \"@itwin/core-common\";\nimport { SnapshotDb } from \"../IModelDb\";\nimport { IModelHost } from \"../IModelHost\";\n\n/* eslint-disable @typescript-eslint/no-deprecated */\n\n/** The backend implementation of SnapshotIModelRpcInterface.\n * @internal\n * @deprecated in 5.0 - might be removed in next major version. Check [[IpcAppFunctions]] for replacements.\n */\nexport class SnapshotIModelRpcImpl extends RpcInterface implements SnapshotIModelRpcInterface {\n  public static register() { RpcManager.registerImpl(SnapshotIModelRpcInterface, SnapshotIModelRpcImpl); }\n\n  /** Ask the backend to open a snapshot iModel from a file name that is resolved by the backend. */\n  public async openFile(filePath: string, opts?: SnapshotOpenOptions): Promise<IModelConnectionProps> {\n    let resolvedFileName: string | undefined = filePath;\n    if (IModelHost.snapshotFileNameResolver) {\n      resolvedFileName = IModelHost.snapshotFileNameResolver.tryResolveFileName(filePath);\n      if (undefined === resolvedFileName)\n        throw new IModelNotFoundResponse(); // eslint-disable-line @typescript-eslint/only-throw-error\n    }\n    return SnapshotDb.openFile(resolvedFileName, opts).getConnectionProps();\n  }\n\n  /** Ask the backend to open a snapshot iModel from a key that is resolved by the backend. */\n  public async openRemote(fileKey: string, opts?: SnapshotOpenOptions): Promise<IModelConnectionProps> {\n    const resolvedFileName = IModelHost.snapshotFileNameResolver?.resolveKey(fileKey);\n    if (undefined === resolvedFileName)\n      throw new IModelNotFoundResponse(); // eslint-disable-line @typescript-eslint/only-throw-error\n\n    return SnapshotDb.openFile(resolvedFileName, { key: fileKey, ...opts }).getConnectionProps();\n  }\n\n  /** Ask the backend to close a snapshot iModel. */\n  public async close(tokenProps: IModelRpcProps): Promise<boolean> {\n    SnapshotDb.findByKey(tokenProps.key).close();\n    return true;\n  }\n}\n"]}

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

@@ -16,20 +16,35 @@ export declare class DisableNativeAssertions implements Disposable {
     private _native;
     constructor();
     [Symbol.dispose](): void;
-    /** @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(): void;
 }
 export declare class TestUtils {
     private static shouldLogToConsole;
     static getCacheDir(fallback?: string | undefined): string | undefined;
-    /** 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 startBackend(config?: IModelHostOptions & {
+        loadGcsWorkspaces?: boolean;
+    }): Promise<void>;
+    /**
+     * 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 startBackend(config?: IModelHostOptions): Promise<void>;
+    static disableGcsWorkspaces(): void;
     static shutdownBackend(): Promise<void>;
     static setupLogging(): void;
     private static initDebugLogLevels;

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;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"}
+{"version":3,"file":"TestUtils.d.ts","sourceRoot":"","sources":["../../../src/test/TestUtils.ts"],"names":[],"mappings":"AASA,OAAO,EAAc,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAK9D,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,iGAAiG;IAC1F,OAAO,IAAI,IAAI;CAGvB;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAC,kBAAkB;WAInB,WAAW,CAAC,QAAQ,GAAE,MAAM,GAAG,SAAqB;IAOlE;;;;;;;;;;;OAWG;WACiB,YAAY,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG;QAAE,iBAAiB,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAU7G;;;;;;OAMG;WACW,oBAAoB,IAAI,IAAI;WAOtB,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

@@ -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":"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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  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":"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;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,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,iGAAiG;IAC1F,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;;;;;;;;;;;OAWG;IACI,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,MAA4D;QAC3F,MAAM,EAAE,iBAAiB,EAAE,GAAG,GAAG,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QACnD,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;QAC9B,IAAI,CAAC,iBAAiB;YACpB,SAAS,CAAC,oBAAoB,EAAE,CAAC;IACrC,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,oBAAoB;QAChC,UAAU,CAAC,YAAY,CAAC,QAAQ,CAAC,aAAa,CAC5C,EAAE,IAAI,EAAE,2BAA2B,EAAE,QAAQ,EAAE,gBAAgB,CAAC,WAAW,EAAE,EAC7E,EAAE,CAAC,cAAc,CAAC,WAAW,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,CACzD,CAAC;IACJ,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\";\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", () => {