@itwin/core-backend 4.0.0-dev.23 → 4.0.0-dev.28

package/lib/cjs/rpc-impl/IModelTileRpcImpl.js.map

@@ -1 +1 @@
-{"version":3,"file":"IModelTileRpcImpl.js","sourceRoot":"","sources":["../../../src/rpc-impl/IModelTileRpcImpl.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 type { TransferConfig } from \"@itwin/object-storage-core\";\nimport { AccessToken, assert, BeDuration, Id64Array, Logger } from \"@itwin/core-bentley\";\nimport {\n  CloudStorageContainerDescriptor, CloudStorageContainerUrl, CloudStorageTileCache, ElementGraphicsRequestProps, IModelRpcProps,\n  IModelTileRpcInterface, IModelTileTreeProps, RpcInterface, RpcInvocation, RpcManager, RpcPendingResponse, TileContentIdentifier,\n  TileContentSource, TileTreeContentIds, TileVersionInfo,\n} from \"@itwin/core-common\";\nimport { BackendLoggerCategory } from \"../BackendLoggerCategory\";\nimport { IModelDb } from \"../IModelDb\";\nimport { IModelHost } from \"../IModelHost\";\nimport { PromiseMemoizer, QueryablePromise } from \"../PromiseMemoizer\";\nimport { RpcTrace } from \"../rpc/tracing\";\nimport { RpcBriefcaseUtility } from \"./RpcBriefcaseUtility\";\n\ninterface TileRequestProps {\n  accessToken?: AccessToken;\n  tokenProps: IModelRpcProps;\n  treeId: string;\n}\n\nfunction generateTileRequestKey(props: TileRequestProps): string {\n  const token = props.tokenProps;\n  return `${JSON.stringify({\n    key: token.key,\n    iTwinId: token.iTwinId,\n    iModelId: token.iModelId,\n    changesetId: token.changeset?.id,\n  })}:${props.treeId}`;\n}\n\nabstract class TileRequestMemoizer<Result, Props extends TileRequestProps> extends PromiseMemoizer<Result> {\n  private readonly _loggerCategory = BackendLoggerCategory.IModelTileRequestRpc;\n  protected abstract get _operationName(): string;\n  protected abstract addMetadata(metadata: any, props: Props): void;\n  protected abstract stringify(props: Props): string;\n  protected abstract get _timeoutMilliseconds(): number;\n\n  private makeMetadata(props: Props): any {\n    const meta = { ...props.tokenProps };\n    this.addMetadata(meta, props);\n    return meta;\n  }\n\n  protected constructor(memoizeFn: (props: Props) => Promise<Result>, generateKeyFn: (props: Props) => string) {\n    super(memoizeFn, generateKeyFn);\n  }\n\n  public override memoize(props: Props): QueryablePromise<Result> {\n    return super.memoize(props);\n  }\n\n  public override deleteMemoized(props: Props) {\n    super.deleteMemoized(props);\n  }\n\n  private log(status: string, props: Props): void {\n    const descr = `${this._operationName}(${this.stringify(props)})`;\n    Logger.logTrace(this._loggerCategory, `Backend ${status} ${descr}`, () => this.makeMetadata(props));\n  }\n\n  protected async perform(props: Props): Promise<Result> {\n    this.log(\"received\", props);\n\n    const tileQP = this.memoize(props);\n\n    await BeDuration.race(this._timeoutMilliseconds, tileQP.promise).catch(() => { });\n    // Note: Rejections must be caught so that the memoization entry can be deleted\n\n    if (tileQP.isPending) {\n      this.log(\"issuing pending status for\", props);\n      throw new RpcPendingResponse(); // eslint-disable-line deprecation/deprecation\n    }\n\n    this.deleteMemoized(props);\n\n    if (tileQP.isFulfilled) {\n      this.log(\"completed\", props);\n      assert(undefined !== tileQP.result);\n      return tileQP.result;\n    }\n\n    assert(tileQP.isRejected);\n    this.log(\"rejected\", props);\n    throw tileQP.error; // eslint-disable-line no-throw-literal\n  }\n}\n\nasync function getTileTreeProps(props: TileRequestProps): Promise<IModelTileTreeProps> {\n  assert(undefined !== props.accessToken);\n  const db = await RpcBriefcaseUtility.findOpenIModel(props.accessToken, props.tokenProps);\n  return db.tiles.requestTileTreeProps(props.treeId);\n}\n\nclass RequestTileTreePropsMemoizer extends TileRequestMemoizer<IModelTileTreeProps, TileRequestProps> {\n  protected get _timeoutMilliseconds() { return IModelHost.tileTreeRequestTimeout; }\n  protected get _operationName() { return \"requestTileTreeProps\"; }\n  protected stringify(props: TileRequestProps): string { return props.treeId; }\n  protected addMetadata(meta: any, props: TileRequestProps): void {\n    meta.treeId = props.treeId;\n  }\n\n  private static _instance?: RequestTileTreePropsMemoizer;\n\n  private constructor() {\n    super(getTileTreeProps, generateTileRequestKey);\n    IModelHost.onBeforeShutdown.addOnce(() => {\n      this.dispose();\n      RequestTileTreePropsMemoizer._instance = undefined;\n    });\n  }\n\n  public static async perform(props: TileRequestProps): Promise<IModelTileTreeProps> {\n    if (undefined === this._instance)\n      this._instance = new RequestTileTreePropsMemoizer();\n\n    return this._instance.perform(props);\n  }\n}\n\ninterface TileContentRequestProps extends TileRequestProps {\n  contentId: string;\n  guid?: string;\n}\n\nasync function getTileContent(props: TileContentRequestProps): Promise<TileContentSource> {\n  assert(undefined !== props.accessToken);\n  const db = await RpcBriefcaseUtility.findOpenIModel(props.accessToken, props.tokenProps);\n  const tile = await db.tiles.requestTileContent(props.treeId, props.contentId);\n\n  // ###TODO: Verify the guid supplied by the front-end matches the guid stored in the model?\n  if (IModelHost.usingExternalTileCache) {\n    await IModelHost.tileStorage?.uploadTile(db.iModelId, db.changeset.id, props.treeId, props.contentId, tile.content, props.guid, {\n      backendName: IModelHost.applicationId,\n      tileGenerationTime: tile.elapsedSeconds.toString(),\n      tileSize: tile.content.byteLength.toString(),\n    });\n\n    return TileContentSource.ExternalCache;\n  }\n\n  return TileContentSource.Backend;\n}\n\nfunction generateTileContentKey(props: TileContentRequestProps): string {\n  return `${generateTileRequestKey(props)}:${props.contentId}`;\n}\n\nclass RequestTileContentMemoizer extends TileRequestMemoizer<TileContentSource, TileContentRequestProps> {\n  protected get _timeoutMilliseconds() { return IModelHost.tileContentRequestTimeout; }\n  protected get _operationName() { return \"requestTileContent\"; }\n  protected stringify(props: TileContentRequestProps): string { return `${props.treeId}:${props.contentId}`; }\n  protected addMetadata(meta: any, props: TileContentRequestProps): void {\n    meta.treeId = props.treeId;\n    meta.contentId = props.contentId;\n  }\n\n  private static _instance?: RequestTileContentMemoizer;\n\n  private constructor() {\n    super(getTileContent, generateTileContentKey);\n    IModelHost.onBeforeShutdown.addOnce(() => {\n      this.dispose();\n      RequestTileContentMemoizer._instance = undefined;\n    });\n  }\n\n  public static get instance() {\n    if (undefined === this._instance)\n      this._instance = new RequestTileContentMemoizer();\n\n    return this._instance;\n  }\n\n  public static async perform(props: TileContentRequestProps): Promise<TileContentSource> {\n    return this.instance.perform(props);\n  }\n}\n\nfunction currentActivity() {\n  return RpcTrace.expectCurrentActivity; // eslint-disable-line deprecation/deprecation\n}\n\n/** @internal */\nexport class IModelTileRpcImpl extends RpcInterface implements IModelTileRpcInterface { // eslint-disable-line deprecation/deprecation\n  public static register() { RpcManager.registerImpl(IModelTileRpcInterface, IModelTileRpcImpl); }\n\n  public async requestTileTreeProps(tokenProps: IModelRpcProps, treeId: string): Promise<IModelTileTreeProps> {\n    return RequestTileTreePropsMemoizer.perform({ accessToken: currentActivity().accessToken, tokenProps, treeId });\n  }\n\n  public async purgeTileTrees(tokenProps: IModelRpcProps, modelIds: Id64Array | undefined): Promise<void> {\n    // `undefined` gets forwarded as `null`...\n    if (null === modelIds)\n      modelIds = undefined;\n\n    const db = await RpcBriefcaseUtility.findOpenIModel(currentActivity().accessToken, tokenProps);\n    return db.nativeDb.purgeTileTrees(modelIds);\n  }\n\n  public async generateTileContent(tokenProps: IModelRpcProps, treeId: string, contentId: string, guid: string | undefined): Promise<TileContentSource> {\n    return RequestTileContentMemoizer.perform({ accessToken: currentActivity().accessToken, tokenProps, treeId, contentId, guid });\n  }\n\n  public async retrieveTileContent(tokenProps: IModelRpcProps, key: TileContentIdentifier): Promise<Uint8Array> {\n    const db = await RpcBriefcaseUtility.findOpenIModel(currentActivity().accessToken, tokenProps);\n    return db.tiles.getTileContent(key.treeId, key.contentId);\n  }\n\n  public async getTileCacheConfig(tokenProps: IModelRpcProps): Promise<TransferConfig | undefined> {\n    if (IModelHost.tileStorage === undefined)\n      return undefined;\n    const iModelId = tokenProps.iModelId ?? (await RpcBriefcaseUtility.findOpenIModel(currentActivity().accessToken, tokenProps)).iModelId;\n    return IModelHost.tileStorage.getDownloadConfig(iModelId);\n  }\n\n  /* eslint-disable deprecation/deprecation */\n  public async getTileCacheContainerUrl(_tokenProps: IModelRpcProps, id: CloudStorageContainerDescriptor): Promise<CloudStorageContainerUrl> {\n    const invocation = RpcInvocation.current(this);\n\n    if (!IModelHost.usingExternalTileCache) {\n      return CloudStorageContainerUrl.empty();\n    }\n\n    const expiry = CloudStorageTileCache.getCache().supplyExpiryForContainerUrl(id);\n    const clientIp = (IModelHost.restrictTileUrlsByClientIp && invocation.request.ip) ? invocation.request.ip : undefined;\n    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n    return IModelHost.tileCacheService!.obtainContainerUrl(id, expiry, clientIp);\n  }\n\n  public async isUsingExternalTileCache(): Promise<boolean> { // eslint-disable-line @itwin/prefer-get\n    return IModelHost.tileCacheService !== undefined;\n  }\n  /* eslint-enable deprecation/deprecation */\n\n  public async queryVersionInfo(): Promise<TileVersionInfo> {\n    return IModelHost.platform.getTileVersionInfo();\n  }\n\n  /** @internal */\n  public async requestElementGraphics(rpcProps: IModelRpcProps, request: ElementGraphicsRequestProps): Promise<Uint8Array | undefined> {\n    const iModel = await RpcBriefcaseUtility.findOpenIModel(currentActivity().accessToken, rpcProps);\n    return iModel.generateElementGraphics(request);\n  }\n}\n\n/** @internal */\nexport async function cancelTileContentRequests(tokenProps: IModelRpcProps, contentIds: TileTreeContentIds[]): Promise<void> {\n  const iModel = IModelDb.findByKey(tokenProps.key);\n  const props: TileContentRequestProps = { tokenProps, treeId: \"\", contentId: \"\" };\n\n  for (const entry of contentIds) {\n    props.treeId = entry.treeId;\n    for (const contentId of entry.contentIds) {\n      props.contentId = contentId;\n      RequestTileContentMemoizer.instance.deleteMemoized(props);\n    }\n\n    iModel.nativeDb.cancelTileContentRequests(entry.treeId, entry.contentIds);\n  }\n}\n"]}
+{"version":3,"file":"IModelTileRpcImpl.js","sourceRoot":"","sources":["../../../src/rpc-impl/IModelTileRpcImpl.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 type { TransferConfig } from \"@itwin/object-storage-core\";\nimport { AccessToken, assert, BeDuration, Id64Array, Logger } from \"@itwin/core-bentley\";\nimport {\n  CloudStorageContainerDescriptor, CloudStorageContainerUrl, CloudStorageTileCache, ElementGraphicsRequestProps, IModelRpcProps,\n  IModelTileRpcInterface, IModelTileTreeProps, RpcInterface, RpcInvocation, RpcManager, RpcPendingResponse, TileContentIdentifier,\n  TileContentSource, TileTreeContentIds, TileVersionInfo,\n} from \"@itwin/core-common\";\nimport { BackendLoggerCategory } from \"../BackendLoggerCategory\";\nimport { IModelDb } from \"../IModelDb\";\nimport { IModelHost } from \"../IModelHost\";\nimport { PromiseMemoizer, QueryablePromise } from \"../PromiseMemoizer\";\nimport { RpcTrace } from \"../rpc/tracing\";\nimport { RpcBriefcaseUtility } from \"./RpcBriefcaseUtility\";\n\ninterface TileRequestProps {\n  accessToken?: AccessToken;\n  tokenProps: IModelRpcProps;\n  treeId: string;\n}\n\nfunction generateTileRequestKey(props: TileRequestProps): string {\n  const token = props.tokenProps;\n  return `${JSON.stringify({\n    key: token.key,\n    iTwinId: token.iTwinId,\n    iModelId: token.iModelId,\n    changesetId: token.changeset?.id,\n  })}:${props.treeId}`;\n}\n\nabstract class TileRequestMemoizer<Result, Props extends TileRequestProps> extends PromiseMemoizer<Result> {\n  private readonly _loggerCategory = BackendLoggerCategory.IModelTileRequestRpc;\n  protected abstract get _operationName(): string;\n  protected abstract addMetadata(metadata: any, props: Props): void;\n  protected abstract stringify(props: Props): string;\n  protected abstract get _timeoutMilliseconds(): number;\n\n  private makeMetadata(props: Props): any {\n    const meta = { ...props.tokenProps };\n    this.addMetadata(meta, props);\n    return meta;\n  }\n\n  protected constructor(memoizeFn: (props: Props) => Promise<Result>, generateKeyFn: (props: Props) => string) {\n    super(memoizeFn, generateKeyFn);\n  }\n\n  public override memoize(props: Props): QueryablePromise<Result> {\n    return super.memoize(props);\n  }\n\n  public override deleteMemoized(props: Props) {\n    super.deleteMemoized(props);\n  }\n\n  private log(status: string, props: Props): void {\n    const descr = `${this._operationName}(${this.stringify(props)})`;\n    Logger.logTrace(this._loggerCategory, `Backend ${status} ${descr}`, () => this.makeMetadata(props));\n  }\n\n  protected async perform(props: Props): Promise<Result> {\n    this.log(\"received\", props);\n\n    const tileQP = this.memoize(props);\n\n    await BeDuration.race(this._timeoutMilliseconds, tileQP.promise).catch(() => { });\n    // Note: Rejections must be caught so that the memoization entry can be deleted\n\n    if (tileQP.isPending) {\n      this.log(\"issuing pending status for\", props);\n      throw new RpcPendingResponse(); // eslint-disable-line deprecation/deprecation\n    }\n\n    this.deleteMemoized(props);\n\n    if (tileQP.isFulfilled) {\n      this.log(\"completed\", props);\n      assert(undefined !== tileQP.result);\n      return tileQP.result;\n    }\n\n    assert(tileQP.isRejected);\n    this.log(\"rejected\", props);\n    throw tileQP.error; // eslint-disable-line no-throw-literal\n  }\n}\n\nasync function getTileTreeProps(props: TileRequestProps): Promise<IModelTileTreeProps> {\n  assert(undefined !== props.accessToken);\n  const db = await RpcBriefcaseUtility.findOpenIModel(props.accessToken, props.tokenProps);\n  return db.tiles.requestTileTreeProps(props.treeId);\n}\n\nclass RequestTileTreePropsMemoizer extends TileRequestMemoizer<IModelTileTreeProps, TileRequestProps> {\n  protected get _timeoutMilliseconds() { return IModelHost.tileTreeRequestTimeout; }\n  protected get _operationName() { return \"requestTileTreeProps\"; }\n  protected stringify(props: TileRequestProps): string { return props.treeId; }\n  protected addMetadata(meta: any, props: TileRequestProps): void {\n    meta.treeId = props.treeId;\n  }\n\n  private static _instance?: RequestTileTreePropsMemoizer;\n\n  private constructor() {\n    super(getTileTreeProps, generateTileRequestKey);\n    IModelHost.onBeforeShutdown.addOnce(() => {\n      this.dispose();\n      RequestTileTreePropsMemoizer._instance = undefined;\n    });\n  }\n\n  public static async perform(props: TileRequestProps): Promise<IModelTileTreeProps> {\n    if (undefined === this._instance)\n      this._instance = new RequestTileTreePropsMemoizer();\n\n    return this._instance.perform(props);\n  }\n}\n\ninterface TileContentRequestProps extends TileRequestProps {\n  contentId: string;\n  guid?: string;\n}\n\nasync function getTileContent(props: TileContentRequestProps): Promise<TileContentSource> {\n  assert(undefined !== props.accessToken);\n  const db = await RpcBriefcaseUtility.findOpenIModel(props.accessToken, props.tokenProps);\n  const tile = await db.tiles.requestTileContent(props.treeId, props.contentId);\n\n  // ###TODO: Verify the guid supplied by the front-end matches the guid stored in the model?\n  if (IModelHost.usingExternalTileCache) {\n    await IModelHost.tileStorage?.uploadTile(db.iModelId, db.changeset.id, props.treeId, props.contentId, tile.content, props.guid, {\n      backendName: IModelHost.applicationId,\n      tileGenerationTime: tile.elapsedSeconds.toString(),\n      tileSize: tile.content.byteLength.toString(),\n    });\n\n    return TileContentSource.ExternalCache;\n  }\n\n  return TileContentSource.Backend;\n}\n\nfunction generateTileContentKey(props: TileContentRequestProps): string {\n  return `${generateTileRequestKey(props)}:${props.contentId}`;\n}\n\nclass RequestTileContentMemoizer extends TileRequestMemoizer<TileContentSource, TileContentRequestProps> {\n  protected get _timeoutMilliseconds() { return IModelHost.tileContentRequestTimeout; }\n  protected get _operationName() { return \"requestTileContent\"; }\n  protected stringify(props: TileContentRequestProps): string { return `${props.treeId}:${props.contentId}`; }\n  protected addMetadata(meta: any, props: TileContentRequestProps): void {\n    meta.treeId = props.treeId;\n    meta.contentId = props.contentId;\n  }\n\n  private static _instance?: RequestTileContentMemoizer;\n\n  private constructor() {\n    super(getTileContent, generateTileContentKey);\n    IModelHost.onBeforeShutdown.addOnce(() => {\n      this.dispose();\n      RequestTileContentMemoizer._instance = undefined;\n    });\n  }\n\n  public static get instance() {\n    if (undefined === this._instance)\n      this._instance = new RequestTileContentMemoizer();\n\n    return this._instance;\n  }\n\n  public static async perform(props: TileContentRequestProps): Promise<TileContentSource> {\n    return this.instance.perform(props);\n  }\n}\n\nfunction currentActivity() {\n  return RpcTrace.expectCurrentActivity; // eslint-disable-line deprecation/deprecation\n}\n\n/** @internal */\nexport class IModelTileRpcImpl extends RpcInterface implements IModelTileRpcInterface { // eslint-disable-line deprecation/deprecation\n  public static register() { RpcManager.registerImpl(IModelTileRpcInterface, IModelTileRpcImpl); }\n\n  public async requestTileTreeProps(tokenProps: IModelRpcProps, treeId: string): Promise<IModelTileTreeProps> {\n    return RequestTileTreePropsMemoizer.perform({ accessToken: currentActivity().accessToken, tokenProps, treeId });\n  }\n\n  public async purgeTileTrees(tokenProps: IModelRpcProps, modelIds: Id64Array | undefined): Promise<void> {\n    // `undefined` gets forwarded as `null`...\n    if (null === modelIds)\n      modelIds = undefined;\n\n    const db = await RpcBriefcaseUtility.findOpenIModel(currentActivity().accessToken, tokenProps);\n    return db.nativeDb.purgeTileTrees(modelIds);\n  }\n\n  public async generateTileContent(tokenProps: IModelRpcProps, treeId: string, contentId: string, guid: string | undefined): Promise<TileContentSource> {\n    return RequestTileContentMemoizer.perform({ accessToken: currentActivity().accessToken, tokenProps, treeId, contentId, guid });\n  }\n\n  public async retrieveTileContent(tokenProps: IModelRpcProps, key: TileContentIdentifier): Promise<Uint8Array> {\n    const db = await RpcBriefcaseUtility.findOpenIModel(currentActivity().accessToken, tokenProps);\n    return db.tiles.getTileContent(key.treeId, key.contentId);\n  }\n\n  public async getTileCacheConfig(tokenProps: IModelRpcProps): Promise<TransferConfig | undefined> {\n    if (IModelHost.tileStorage === undefined)\n      return undefined;\n    const iModelId = tokenProps.iModelId ?? (await RpcBriefcaseUtility.findOpenIModel(currentActivity().accessToken, tokenProps)).iModelId;\n    return IModelHost.tileStorage.getDownloadConfig(iModelId);\n  }\n\n  /* eslint-disable deprecation/deprecation */\n  public async getTileCacheContainerUrl(_tokenProps: IModelRpcProps, id: CloudStorageContainerDescriptor): Promise<CloudStorageContainerUrl> {\n    const invocation = RpcInvocation.current(this);\n\n    if (!IModelHost.usingExternalTileCache) {\n      return CloudStorageContainerUrl.empty();\n    }\n\n    const expiry = CloudStorageTileCache.getCache().supplyExpiryForContainerUrl(id);\n    const clientIp = (IModelHost.restrictTileUrlsByClientIp && invocation.request.ip) ? invocation.request.ip : undefined;\n    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n    return IModelHost.tileCacheService!.obtainContainerUrl(id, expiry, clientIp);\n  }\n\n  public async isUsingExternalTileCache(): Promise<boolean> { // eslint-disable-line @itwin/prefer-get\n    return IModelHost.tileCacheService !== undefined;\n  }\n  /* eslint-enable deprecation/deprecation */\n\n  public async queryVersionInfo(): Promise<TileVersionInfo> {\n    return IModelHost.platform.getTileVersionInfo();\n  }\n\n  /** @internal */\n  public async requestElementGraphics(rpcProps: IModelRpcProps, request: ElementGraphicsRequestProps): Promise<Uint8Array | undefined> {\n    const iModel = await RpcBriefcaseUtility.findOpenIModel(currentActivity().accessToken, rpcProps);\n    return iModel.generateElementGraphics(request);\n  }\n}\n\n/** @internal */\nexport async function cancelTileContentRequests(tokenProps: IModelRpcProps, contentIds: TileTreeContentIds[]): Promise<void> {\n  const iModel = IModelDb.findByKey(tokenProps.key);\n  const props: TileContentRequestProps = { tokenProps, treeId: \"\", contentId: \"\" };\n\n  for (const entry of contentIds) {\n    props.treeId = entry.treeId;\n    for (const contentId of entry.contentIds) {\n      props.contentId = contentId;\n      RequestTileContentMemoizer.instance.deleteMemoized(props);\n    }\n\n    iModel.nativeDb.cancelTileContentRequests(entry.treeId, entry.contentIds);\n  }\n}\n"]}

package/lib/cjs/rpc-impl/RpcBriefcaseUtility.js

@@ -23,7 +23,6 @@ const loggerCategory = BackendLoggerCategory_1.BackendLoggerCategory.IModelDb;
  */
 class RpcBriefcaseUtility {
     static async downloadAndOpen(args) {
-        var _a, _b, _c, _d;
         const { activity, tokenProps } = args;
         const accessToken = activity.accessToken;
         (0, core_bentley_1.assert)(undefined !== tokenProps.iModelId);
@@ -36,7 +35,7 @@ class RpcBriefcaseUtility {
             // check with iModelHub and see if we already have acquired any briefcaseIds
             myBriefcaseIds = await IModelHost_1.IModelHost.hubAccess.getMyBriefcaseIds({ accessToken, iModelId });
         }
-        const resolvers = (_a = args.fileNameResolvers) !== null && _a !== void 0 ? _a : [(arg) => BriefcaseManager_1.BriefcaseManager.getFileName(arg)];
+        const resolvers = args.fileNameResolvers ?? [(arg) => BriefcaseManager_1.BriefcaseManager.getFileName(arg)];
         // see if we can open any of the briefcaseIds we already acquired from iModelHub
         if (resolvers) {
             for (const resolver of resolvers) {
@@ -50,9 +49,10 @@ class RpcBriefcaseUtility {
                             if (args.forceDownload)
                                 throw new Error(); // causes delete below
                             const db = await IModelDb_1.BriefcaseDb.open({ fileName });
-                            if (db.changeset.id !== ((_b = tokenProps.changeset) === null || _b === void 0 ? void 0 : _b.id)) {
+                            if (db.changeset.id !== tokenProps.changeset?.id) {
                                 (0, core_bentley_1.assert)(undefined !== tokenProps.changeset);
-                                const toIndex = (_d = (_c = tokenProps.changeset) === null || _c === void 0 ? void 0 : _c.index) !== null && _d !== void 0 ? _d : (await IModelHost_1.IModelHost.hubAccess.getChangesetFromVersion({ accessToken, iModelId, version: core_common_1.IModelVersion.asOfChangeSet(tokenProps.changeset.id) })).index;
+                                const toIndex = tokenProps.changeset?.index ??
+                                    (await IModelHost_1.IModelHost.hubAccess.getChangesetFromVersion({ accessToken, iModelId, version: core_common_1.IModelVersion.asOfChangeSet(tokenProps.changeset.id) })).index;
                                 await BriefcaseManager_1.BriefcaseManager.pullAndApplyChangesets(db, { accessToken, toIndex });
                             }
                             return db;
@@ -104,10 +104,9 @@ class RpcBriefcaseUtility {
      * a RpcPendingResponse exception is thrown
      */
     static async open(args) {
-        var _a;
         const { activity, tokenProps, syncMode } = args;
         core_bentley_1.Logger.logTrace(loggerCategory, "RpcBriefcaseUtility.open", () => ({ ...tokenProps }));
-        const timeout = (_a = args.timeout) !== null && _a !== void 0 ? _a : 1000;
+        const timeout = args.timeout ?? 1000;
         if (syncMode === core_common_1.SyncMode.PullOnly || syncMode === core_common_1.SyncMode.PullAndPush) {
             const briefcaseDb = await core_bentley_1.BeDuration.race(timeout, this.openBriefcase(args));
             if (briefcaseDb === undefined) {
@@ -159,9 +158,8 @@ class RpcBriefcaseUtility {
         return db;
     }
     static async openWithTimeout(activity, tokenProps, syncMode, timeout = 1000) {
-        var _a;
         if (tokenProps.iModelId)
-            await ((_a = IModelHost_1.IModelHost.tileStorage) === null || _a === void 0 ? void 0 : _a.initialize(tokenProps.iModelId));
+            await IModelHost_1.IModelHost.tileStorage?.initialize(tokenProps.iModelId);
         return (await this.open({ activity, tokenProps, syncMode, timeout })).toJSON();
     }
 }

package/lib/cjs/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, BentleyError, IModelStatus, Logger } from \"@itwin/core-bentley\";\nimport {\n  BriefcaseProps, IModelConnectionProps, IModelRpcOpenProps, IModelRpcProps, IModelVersion, RpcActivity, RpcPendingResponse, SyncMode,\n} from \"@itwin/core-common\";\nimport { BackendLoggerCategory } from \"../BackendLoggerCategory\";\nimport { BriefcaseManager, RequestNewBriefcaseArg } from \"../BriefcaseManager\";\nimport { CheckpointManager, CheckpointProps, V1CheckpointManager } from \"../CheckpointManager\";\nimport { BriefcaseDb, IModelDb, SnapshotDb } from \"../IModelDb\";\nimport { IModelHost } from \"../IModelHost\";\nimport { IModelJsFs } from \"../IModelJsFs\";\n\nconst loggerCategory: string = BackendLoggerCategory.IModelDb;\n\n/** @internal */\nexport interface DownloadAndOpenArgs {\n  activity: RpcActivity; // eslint-disable-line deprecation/deprecation\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\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              return briefcaseDb as BriefcaseDb;\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 _briefcasePromise: Promise<BriefcaseDb> | undefined;\n  private static async openBriefcase(args: DownloadAndOpenArgs): Promise<BriefcaseDb> {\n    if (this._briefcasePromise)\n      return this._briefcasePromise;\n\n    try {\n      this._briefcasePromise = this.downloadAndOpen(args); // save the fact that we're working on downloading so if we timeout, we'll reuse this request.\n      return await this._briefcasePromise;\n    } finally {\n      this._briefcasePromise = undefined;  // 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 refreshContainerSas, just in case this is a V2 checkpoint whose sasToken is about to expire.\n    await iModelDb.refreshContainerSas(accessToken);\n    return iModelDb;\n  }\n\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 deprecation/deprecation\n      }\n      // note: usage is logged in the function BriefcaseManager.downloadNewBriefcaseAndOpen\n      return briefcaseDb;\n    }\n\n    assert(undefined !== tokenProps.iModelId);\n    assert(undefined !== tokenProps.iTwinId);\n    assert(undefined !== tokenProps.changeset);\n\n    const checkpoint: CheckpointProps = {\n      iModelId: tokenProps.iModelId,\n      iTwinId: tokenProps.iTwinId,\n      changeset: tokenProps.changeset,\n      accessToken: activity.accessToken,\n    };\n\n    // opening a checkpoint, readonly.\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      BriefcaseManager.logUsage(db);\n      return db;\n    }\n\n    try {\n      // now try V2 checkpoint\n      db = await SnapshotDb.openCheckpointV2(checkpoint);\n      Logger.logTrace(loggerCategory, \"using V2 checkpoint briefcase\", () => ({ ...tokenProps }));\n    } catch (e) {\n      Logger.logTrace(loggerCategory, \"unable to open V2 checkpoint - falling back to V1 checkpoint\", () => ({ error: BentleyError.getErrorProps(e), ...tokenProps }));\n\n      // this isn't a v2 checkpoint. Set up a race between the specified timeout period and the open. Throw an RpcPendingResponse exception if the timeout happens first.\n      const request = {\n        checkpoint,\n        localFile: V1CheckpointManager.getFileName(checkpoint),\n        aliasFiles: [],\n      };\n      db = await BeDuration.race(timeout, V1CheckpointManager.getCheckpointDb(request));\n\n      if (db === undefined) {\n        Logger.logTrace(loggerCategory, \"Open V1 checkpoint - pending\", () => ({ ...tokenProps }));\n        throw new RpcPendingResponse(); // eslint-disable-line deprecation/deprecation\n      }\n      Logger.logTrace(loggerCategory, \"Opened V1 checkpoint\", () => ({ ...tokenProps }));\n    }\n\n    BriefcaseManager.logUsage(db, activity);\n    return db;\n  }\n\n  public static async openWithTimeout(activity: RpcActivity, tokenProps: IModelRpcOpenProps, syncMode: SyncMode, timeout: number = 1000): Promise<IModelConnectionProps> { // eslint-disable-line deprecation/deprecation\n    if (tokenProps.iModelId)\n      await IModelHost.tileStorage?.initialize(tokenProps.iModelId);\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, BentleyError, IModelStatus, Logger } from \"@itwin/core-bentley\";\nimport {\n  BriefcaseProps, IModelConnectionProps, IModelRpcOpenProps, IModelRpcProps, IModelVersion, RpcActivity, RpcPendingResponse, SyncMode,\n} from \"@itwin/core-common\";\nimport { BackendLoggerCategory } from \"../BackendLoggerCategory\";\nimport { BriefcaseManager, RequestNewBriefcaseArg } from \"../BriefcaseManager\";\nimport { CheckpointManager, CheckpointProps, V1CheckpointManager } from \"../CheckpointManager\";\nimport { BriefcaseDb, IModelDb, SnapshotDb } from \"../IModelDb\";\nimport { IModelHost } from \"../IModelHost\";\nimport { IModelJsFs } from \"../IModelJsFs\";\n\nconst loggerCategory: string = BackendLoggerCategory.IModelDb;\n\n/** @internal */\nexport interface DownloadAndOpenArgs {\n  activity: RpcActivity; // eslint-disable-line deprecation/deprecation\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\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              return briefcaseDb as BriefcaseDb;\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 _briefcasePromise: Promise<BriefcaseDb> | undefined;\n  private static async openBriefcase(args: DownloadAndOpenArgs): Promise<BriefcaseDb> {\n    if (this._briefcasePromise)\n      return this._briefcasePromise;\n\n    try {\n      this._briefcasePromise = this.downloadAndOpen(args); // save the fact that we're working on downloading so if we timeout, we'll reuse this request.\n      return await this._briefcasePromise;\n    } finally {\n      this._briefcasePromise = undefined;  // 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 refreshContainerSas, just in case this is a V2 checkpoint whose sasToken is about to expire.\n    await iModelDb.refreshContainerSas(accessToken);\n    return iModelDb;\n  }\n\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 deprecation/deprecation\n      }\n      // note: usage is logged in the function BriefcaseManager.downloadNewBriefcaseAndOpen\n      return briefcaseDb;\n    }\n\n    assert(undefined !== tokenProps.iModelId);\n    assert(undefined !== tokenProps.iTwinId);\n    assert(undefined !== tokenProps.changeset);\n\n    const checkpoint: CheckpointProps = {\n      iModelId: tokenProps.iModelId,\n      iTwinId: tokenProps.iTwinId,\n      changeset: tokenProps.changeset,\n      accessToken: activity.accessToken,\n    };\n\n    // opening a checkpoint, readonly.\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      BriefcaseManager.logUsage(db);\n      return db;\n    }\n\n    try {\n      // now try V2 checkpoint\n      db = await SnapshotDb.openCheckpointV2(checkpoint);\n      Logger.logTrace(loggerCategory, \"using V2 checkpoint briefcase\", () => ({ ...tokenProps }));\n    } catch (e) {\n      Logger.logTrace(loggerCategory, \"unable to open V2 checkpoint - falling back to V1 checkpoint\", () => ({ error: BentleyError.getErrorProps(e), ...tokenProps }));\n\n      // this isn't a v2 checkpoint. Set up a race between the specified timeout period and the open. Throw an RpcPendingResponse exception if the timeout happens first.\n      const request = {\n        checkpoint,\n        localFile: V1CheckpointManager.getFileName(checkpoint),\n        aliasFiles: [],\n      };\n      db = await BeDuration.race(timeout, V1CheckpointManager.getCheckpointDb(request));\n\n      if (db === undefined) {\n        Logger.logTrace(loggerCategory, \"Open V1 checkpoint - pending\", () => ({ ...tokenProps }));\n        throw new RpcPendingResponse(); // eslint-disable-line deprecation/deprecation\n      }\n      Logger.logTrace(loggerCategory, \"Opened V1 checkpoint\", () => ({ ...tokenProps }));\n    }\n\n    BriefcaseManager.logUsage(db, activity);\n    return db;\n  }\n\n  public static async openWithTimeout(activity: RpcActivity, tokenProps: IModelRpcOpenProps, syncMode: SyncMode, timeout: number = 1000): Promise<IModelConnectionProps> { // eslint-disable-line deprecation/deprecation\n    if (tokenProps.iModelId)\n      await IModelHost.tileStorage?.initialize(tokenProps.iModelId);\n    return (await this.open({ activity, tokenProps, syncMode, timeout })).toJSON();\n  }\n\n}\n"]}

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

@@ -28,8 +28,7 @@ class SnapshotIModelRpcImpl extends core_common_1.RpcInterface {
     }
     /** Ask the backend to open a snapshot iModel from a key that is resolved by the backend. */
     async openRemote(fileKey, opts) {
-        var _a;
-        const resolvedFileName = (_a = IModelHost_1.IModelHost.snapshotFileNameResolver) === null || _a === void 0 ? void 0 : _a.resolveKey(fileKey);
+        const resolvedFileName = IModelHost_1.IModelHost.snapshotFileNameResolver?.resolveKey(fileKey);
         if (undefined === resolvedFileName)
             throw new core_common_1.IModelNotFoundResponse();
         return IModelDb_1.SnapshotDb.openFile(resolvedFileName, { key: fileKey, ...opts }).getConnectionProps();

package/lib/cjs/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,oDAE4B;AAC5B,0CAAyC;AACzC,8CAA2C;AAE3C;;GAEG;AACH,MAAa,qBAAsB,SAAQ,0BAAY;IAC9C,MAAM,CAAC,QAAQ,KAAK,wBAAU,CAAC,YAAY,CAAC,wCAA0B,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAExG,kGAAkG;IAC3F,KAAK,CAAC,QAAQ,CAAC,QAAgB,EAAE,IAA0B;QAChE,IAAI,gBAAgB,GAAuB,QAAQ,CAAC;QACpD,IAAI,uBAAU,CAAC,wBAAwB,EAAE;YACvC,gBAAgB,GAAG,uBAAU,CAAC,wBAAwB,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;YACpF,IAAI,SAAS,KAAK,gBAAgB;gBAChC,MAAM,IAAI,oCAAsB,EAAE,CAAC;SACtC;QACD,OAAO,qBAAU,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,MAAA,uBAAU,CAAC,wBAAwB,0CAAE,UAAU,CAAC,OAAO,CAAC,CAAC;QAClF,IAAI,SAAS,KAAK,gBAAgB;YAChC,MAAM,IAAI,oCAAsB,EAAE,CAAC;QAErC,OAAO,qBAAU,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,qBAAU,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AA5BD,sDA4BC","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/** The backend implementation of SnapshotIModelRpcInterface.\n * @internal\n */\nexport class SnapshotIModelRpcImpl extends RpcInterface implements SnapshotIModelRpcInterface { // eslint-disable-line deprecation/deprecation\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();\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();\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,oDAE4B;AAC5B,0CAAyC;AACzC,8CAA2C;AAE3C;;GAEG;AACH,MAAa,qBAAsB,SAAQ,0BAAY;IAC9C,MAAM,CAAC,QAAQ,KAAK,wBAAU,CAAC,YAAY,CAAC,wCAA0B,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAExG,kGAAkG;IAC3F,KAAK,CAAC,QAAQ,CAAC,QAAgB,EAAE,IAA0B;QAChE,IAAI,gBAAgB,GAAuB,QAAQ,CAAC;QACpD,IAAI,uBAAU,CAAC,wBAAwB,EAAE;YACvC,gBAAgB,GAAG,uBAAU,CAAC,wBAAwB,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;YACpF,IAAI,SAAS,KAAK,gBAAgB;gBAChC,MAAM,IAAI,oCAAsB,EAAE,CAAC;SACtC;QACD,OAAO,qBAAU,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,uBAAU,CAAC,wBAAwB,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;QAClF,IAAI,SAAS,KAAK,gBAAgB;YAChC,MAAM,IAAI,oCAAsB,EAAE,CAAC;QAErC,OAAO,qBAAU,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,qBAAU,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AA5BD,sDA4BC","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/** The backend implementation of SnapshotIModelRpcInterface.\n * @internal\n */\nexport class SnapshotIModelRpcImpl extends RpcInterface implements SnapshotIModelRpcInterface { // eslint-disable-line deprecation/deprecation\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();\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();\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/cjs/workspace/Settings.js

@@ -117,8 +117,7 @@ class BaseSettings {
         return defaultValue;
     }
     getSetting(name, defaultValue) {
-        var _a;
-        return (_a = this.resolveSetting(name, (val) => deepClone(val))) !== null && _a !== void 0 ? _a : defaultValue;
+        return this.resolveSetting(name, (val) => deepClone(val)) ?? defaultValue;
     }
     /** for debugging. Returns an array of all values for a setting, sorted by priority.
      * @note values are not cloned. Do not modify objects or arrays.

package/lib/cjs/workspace/Settings.js.map

@@ -1 +1 @@
-{"version":3,"file":"Settings.js","sourceRoot":"","sources":["../../../src/workspace/Settings.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 Workspace\n */\n\nimport * as fs from \"fs-extra\";\nimport { parse } from \"json5\";\nimport { extname, join } from \"path\";\nimport { BeEvent, JSONSchemaType } from \"@itwin/core-bentley\";\nimport { LocalDirName, LocalFileName } from \"@itwin/core-common\";\nimport { IModelJsFs } from \"../IModelJsFs\";\n\n/** The type of a Setting, according to its schema\n * @beta\n */\nexport type SettingType = JSONSchemaType;\n\n/**\n * The name of a Setting. SettingNames must be valid JavaScript property names, defined in a [[SettingSchema]].\n * @see [SettingName]($docs/learning/backend/Workspace#settingnames)\n * @beta\n */\nexport type SettingName = string;\n\n/** The name of a [[SettingDictionary]]. `SettingDictionary`s are stored in [[Settings]] and may be removed by DictionaryName.\n * DictionaryNames must be valid JavaScript property names.\n * @beta\n */\nexport type DictionaryName = string;\n\n/**\n * A function called by [[Settings.resolveSetting]] for every SettingDictionary with a Setting that matches a name. The\n * SettingDictionaries are sorted by priority and this function is called in priority order with the highest priority first.\n * When this function returns a non-undefined value, the iteration is stopped and that value is returned. In this way,\n * applications can \"combine\" the prioritized Setting values as appropriate. The default implementation of this function\n * used by [[Settings.getSetting]] merely returns a clone of the value the first time it is called, so the highest priority\n * value is returned.\n * @beta\n */\nexport type SettingResolver<T> = (val: T, dict: DictionaryName, priority: SettingsPriority) => T | undefined;\n\n/** An entry in the array returned by [[Settings.inspectSetting]]\n * @beta\n *\n */\nexport interface SettingInspector<T> { value: T, dictionary: DictionaryName, priority: number }\n\n/** An object with string-named members (as opposed to an array object).\n * @beta\n */\nexport interface SettingObject {\n  [name: string]: SettingType;\n}\n\n/**\n * An object with Settings as its members. A SettingDictionary also has a name and generally comes from a parsed JSON file, but\n * may also be created in memory by applications\n * @beta\n */\nexport type SettingDictionary = SettingObject;\n\n/**\n * Values for SettingsPriority determine the sort order for Settings. Higher values take precedence over lower values.\n * @beta\n*/\nexport enum SettingsPriority {\n  /** values supplied default-settings files */\n  defaults = 100,\n  /** values supplied by applications at runtime */\n  application = 200,\n  /** values that apply to all iTwins for an organization. */\n  organization = 300,\n  /** values that apply to all iModels in an iTwin. */\n  iTwin = 400,\n  /** values that apply to a single iModel. */\n  iModel = 500,\n}\n\n/** The current set of Settings for a Workspace.\n * @beta\n */\nexport interface Settings {\n  /** @internal */\n  close(): void;\n\n  /** Event raised whenever a SettingsDictionary is added or removed. */\n  readonly onSettingsChanged: BeEvent<() => void>;\n\n  /** Add a SettingDictionary from a local settings file. The file should be in [JSON5](https://json5.org/) format. It is read\n   * and parsed and the fileName is used as the DictionaryName.\n   * @param fileName the name of a local settings file of the SettingDictionary. This becomes the DictionaryName.\n   * @param priority the SettingsPriority for the SettingDictionary\n   * @note If the SettingDictionary was previously added, the new content overrides the old content.\n   */\n  addFile(fileName: LocalFileName, priority: SettingsPriority): void;\n\n  /** Add all files in the supplied directory with the extension \".json\" or \".json5\"\n   * @param dirName the name of a local settings directory\n   */\n  addDirectory(dirName: LocalDirName, priority: SettingsPriority): void;\n\n  /** Add a SettingDictionary from a JSON5 stringified string. The string is parsed and the resultant object is added as a SettingDictionary.\n   * @param dictionaryName the name of the SettingDictionary\n   * @param priority the SettingsPriority for the SettingDictionary\n   * @param settingsJson the JSON5 stringified string to be parsed.\n   * @note If the SettingDictionary was previously added, the new content overrides the old content.\n   */\n  addJson(dictionaryName: DictionaryName, priority: SettingsPriority, settingsJson: string): void;\n\n  /** Add a SettingDictionary object.\n   * @param dictionaryName the name of the SettingDictionary\n   * @param priority the SettingsPriority for the SettingDictionary\n   * @param settings the SettingDictionary object to be added.\n   * @note If the SettingDictionary was previously added, the new content overrides the old content.\n   */\n  addDictionary(dictionaryName: DictionaryName, priority: SettingsPriority, settings: SettingDictionary): void;\n\n  /** Remove a SettingDictionary by name. */\n  dropDictionary(dictionaryName: DictionaryName): void;\n\n  /**\n   * Resolve a setting, by name, using a SettingResolver.\n   * @param settingName The name of the setting to resolve\n   * @param resolver function to be called for each SettingDictionary with a matching Setting. Iteration stops when it returns a non-undefined value.\n   * @param defaultValue value returned if settingName is not present in any SettingDictionary or resolver never returned a value.\n   * @returns the resolved setting value.\n   */\n  resolveSetting<T extends SettingType>(settingName: SettingName, resolver: SettingResolver<T>, defaultValue: T): T;\n  resolveSetting<T extends SettingType>(settingName: SettingName, resolver: SettingResolver<T>, defaultValue?: T): T | undefined;\n\n  /** Get the highest priority setting for a SettingName.\n   * @param settingName The name of the setting\n   * @param defaultValue value returned if settingName is not present in any SettingDictionary.\n   * @note This method is generic on SettingType, but no type checking is actually performed at run time. So, if you\n   * use this method to get a setting with an expected type, but its value is a different type, the return type of this method will be wrong.\n   * You must always type check the result. Use the non-generic \"get\" methods (e.g. [[getString]]) if you only want the value\n   * if its type is correct.\n   */\n  getSetting<T extends SettingType>(settingName: SettingName, defaultValue?: T): T | undefined;\n\n  /** Get a string setting by SettingName.\n   * @param settingName The name of the setting\n   * @param defaultValue value returned if settingName is not present in any SettingDictionary, or if the highest priority setting is not a string.\n   */\n  getString(settingName: SettingName, defaultValue: string): string;\n  getString(settingName: SettingName, defaultValue?: string): string | undefined;\n\n  /** Get a boolean setting by SettingName.\n  * @param settingName The name of the setting\n  * @param defaultValue value returned if settingName is not present in any SettingDictionary, or if the highest priority setting is not a boolean.\n  */\n  getBoolean(settingName: SettingName, defaultValue: boolean): boolean;\n  getBoolean(settingName: SettingName, defaultValue?: boolean): boolean | undefined;\n\n  /** Get a number setting by SettingName.\n  * @param settingName The name of the setting\n  * @param defaultValue value returned if settingName is not present in any SettingDictionary, or if the highest priority setting is not a number.\n  */\n  getNumber(settingName: SettingName, defaultValue: number): number;\n  getNumber(settingName: SettingName): number | undefined;\n\n  /** Get an object setting by SettingName.\n  * @param settingName The name of the setting\n  * @param defaultValue value returned if settingName is not present in any SettingDictionary, or if the highest priority setting is not an object.\n  */\n  getObject<T extends object>(settingName: SettingName, defaultValue: T): T;\n  getObject<T extends object>(settingName: SettingName): T | undefined;\n\n  /** Get an array setting by SettingName.\n  * @param settingName The name of the setting\n  * @param defaultValue value returned if settingName is not present in any SettingDictionary, or if the highest priority setting is not an array.\n  */\n  getArray<T extends SettingType>(settingName: SettingName, defaultValue: Array<T>): Array<T>;\n  getArray<T extends SettingType>(settingName: SettingName): Array<T> | undefined;\n\n  /** Get an array of [[SettingInspector] objects, sorted in priority order, for all Settings that match a SettingName.\n   * @note this method is mainly for debugging and diagnostics.\n   */\n  inspectSetting<T extends SettingType>(name: SettingName): SettingInspector<T>[];\n}\n\n/** @internal */\nfunction deepClone<T extends SettingType>(obj: any): T {\n  if (!obj || typeof obj !== \"object\")\n    return obj;\n\n  const result = Array.isArray(obj) ? [] : {} as any;\n  Object.keys(obj).forEach((key: string) => {\n    const val = obj[key];\n    if (val && typeof val === \"object\") {\n      result[key] = deepClone(val);\n    } else {\n      result[key] = val;\n    }\n  });\n  return result;\n}\n\nclass SettingsDictionary {\n  public constructor(public readonly name: string, public readonly priority: SettingsPriority, public readonly settings: SettingDictionary) { }\n  public getSetting<T extends SettingType>(settingName: string): SettingType | undefined {\n    return this.settings[settingName] as T | undefined;\n  }\n}\n\n/**\n * Internal implementation of Settings interface.\n * @internal\n */\nexport class BaseSettings implements Settings {\n  private _dictionaries: SettingsDictionary[] = [];\n  protected verifyPriority(_priority: SettingsPriority) { }\n  public close() { }\n  public readonly onSettingsChanged = new BeEvent<() => void>();\n\n  public addFile(fileName: LocalFileName, priority: SettingsPriority) {\n    this.addJson(fileName, priority, fs.readFileSync(fileName, \"utf-8\"));\n  }\n\n  public addDirectory(dirName: LocalDirName, priority: SettingsPriority) {\n    for (const fileName of IModelJsFs.readdirSync(dirName)) {\n      const ext = extname(fileName);\n      if (ext === \".json5\" || ext === \".json\")\n        this.addFile(join(dirName, fileName), priority);\n    }\n  }\n\n  public addJson(dictionaryName: string, priority: SettingsPriority, settingsJson: string) {\n    this.addDictionary(dictionaryName, priority, parse(settingsJson));\n  }\n\n  public addDictionary(dictionaryName: string, priority: SettingsPriority, settings: SettingDictionary) {\n    this.verifyPriority(priority);\n    this.dropDictionary(dictionaryName, false); // make sure we don't have the same dictionary twice\n    const file = new SettingsDictionary(dictionaryName, priority, settings);\n    const doAdd = () => {\n      for (let i = 0; i < this._dictionaries.length; ++i) {\n        if (this._dictionaries[i].priority <= file.priority) {\n          this._dictionaries.splice(i, 0, file);\n          return;\n        }\n      }\n      this._dictionaries.push(file);\n    };\n    doAdd();\n    this.onSettingsChanged.raiseEvent();\n  }\n\n  public dropDictionary(dictionaryName: DictionaryName, raiseEvent = true) {\n    for (let i = 0; i < this._dictionaries.length; ++i) {\n      if (this._dictionaries[i].name === dictionaryName) {\n        this._dictionaries.splice(i, 1);\n        if (raiseEvent)\n          this.onSettingsChanged.raiseEvent();\n        return true;\n      }\n    }\n    return false;\n  }\n\n  public resolveSetting<T extends SettingType>(name: SettingName, resolver: SettingResolver<T>, defaultValue?: T): T | undefined {\n    for (const dict of this._dictionaries) {\n      const val = dict.getSetting(name) as T | undefined;\n      const resolved = val && resolver(val, dict.name, dict.priority);\n      if (undefined !== resolved)\n        return resolved;\n    }\n    return defaultValue;\n  }\n\n  public getSetting<T extends SettingType>(name: SettingName, defaultValue?: T): T | undefined {\n    return this.resolveSetting(name, (val) => deepClone<T>(val)) ?? defaultValue;\n  }\n\n  /** for debugging. Returns an array of all values for a setting, sorted by priority.\n   * @note values are not cloned. Do not modify objects or arrays.\n   */\n  public inspectSetting<T extends SettingType>(name: SettingName): SettingInspector<T>[] {\n    const all: SettingInspector<T>[] = [];\n    this.resolveSetting<T>(name, (value, dictionary, priority) => {\n      all.push({ value, dictionary, priority });\n      return undefined;\n    });\n\n    return all;\n  }\n\n  public getString(name: SettingName, defaultValue: string): string;\n  public getString(name: SettingName): string | undefined;\n  public getString(name: SettingName, defaultValue?: string): string | undefined {\n    const out = this.getSetting<string>(name);\n    return typeof out === \"string\" ? out : defaultValue;\n  }\n  public getBoolean(name: SettingName, defaultValue: boolean): boolean;\n  public getBoolean(name: SettingName): boolean | undefined;\n  public getBoolean(name: SettingName, defaultValue?: boolean): boolean | undefined {\n    const out = this.getSetting<boolean>(name);\n    return typeof out === \"boolean\" ? out : defaultValue;\n  }\n  public getNumber(name: SettingName, defaultValue: number): number;\n  public getNumber(name: SettingName): number | undefined;\n  public getNumber(name: SettingName, defaultValue?: number): number | undefined {\n    const out = this.getSetting<number>(name);\n    return typeof out === \"number\" ? out : defaultValue;\n  }\n  public getObject<T extends object>(name: SettingName, defaultValue: T): T;\n  public getObject<T extends object>(name: SettingName): T | undefined;\n  public getObject<T extends object>(name: SettingName, defaultValue?: T): T | undefined {\n    const out = this.getSetting<SettingObject>(name);\n    return typeof out === \"object\" ? out as T : defaultValue;\n  }\n  public getArray<T extends SettingType>(name: SettingName, defaultValue: Array<T>): Array<T>;\n  public getArray<T extends SettingType>(name: SettingName): Array<T> | undefined;\n  public getArray<T extends SettingType>(name: SettingName, defaultValue?: Array<T>): Array<T> | undefined {\n    const out = this.getSetting<Array<T>>(name);\n    return Array.isArray(out) ? out : defaultValue;\n  }\n}\n"]}
+{"version":3,"file":"Settings.js","sourceRoot":"","sources":["../../../src/workspace/Settings.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 Workspace\n */\n\nimport * as fs from \"fs-extra\";\nimport { parse } from \"json5\";\nimport { extname, join } from \"path\";\nimport { BeEvent, JSONSchemaType } from \"@itwin/core-bentley\";\nimport { LocalDirName, LocalFileName } from \"@itwin/core-common\";\nimport { IModelJsFs } from \"../IModelJsFs\";\n\n/** The type of a Setting, according to its schema\n * @beta\n */\nexport type SettingType = JSONSchemaType;\n\n/**\n * The name of a Setting. SettingNames must be valid JavaScript property names, defined in a [[SettingSchema]].\n * @see [SettingName]($docs/learning/backend/Workspace#settingnames)\n * @beta\n */\nexport type SettingName = string;\n\n/** The name of a [[SettingDictionary]]. `SettingDictionary`s are stored in [[Settings]] and may be removed by DictionaryName.\n * DictionaryNames must be valid JavaScript property names.\n * @beta\n */\nexport type DictionaryName = string;\n\n/**\n * A function called by [[Settings.resolveSetting]] for every SettingDictionary with a Setting that matches a name. The\n * SettingDictionaries are sorted by priority and this function is called in priority order with the highest priority first.\n * When this function returns a non-undefined value, the iteration is stopped and that value is returned. In this way,\n * applications can \"combine\" the prioritized Setting values as appropriate. The default implementation of this function\n * used by [[Settings.getSetting]] merely returns a clone of the value the first time it is called, so the highest priority\n * value is returned.\n * @beta\n */\nexport type SettingResolver<T> = (val: T, dict: DictionaryName, priority: SettingsPriority) => T | undefined;\n\n/** An entry in the array returned by [[Settings.inspectSetting]]\n * @beta\n *\n */\nexport interface SettingInspector<T> { value: T, dictionary: DictionaryName, priority: number }\n\n/** An object with string-named members (as opposed to an array object).\n * @beta\n */\nexport interface SettingObject {\n  [name: string]: SettingType;\n}\n\n/**\n * An object with Settings as its members. A SettingDictionary also has a name and generally comes from a parsed JSON file, but\n * may also be created in memory by applications\n * @beta\n */\nexport type SettingDictionary = SettingObject;\n\n/**\n * Values for SettingsPriority determine the sort order for Settings. Higher values take precedence over lower values.\n * @beta\n*/\nexport enum SettingsPriority {\n  /** values supplied default-settings files */\n  defaults = 100,\n  /** values supplied by applications at runtime */\n  application = 200,\n  /** values that apply to all iTwins for an organization. */\n  organization = 300,\n  /** values that apply to all iModels in an iTwin. */\n  iTwin = 400,\n  /** values that apply to a single iModel. */\n  iModel = 500,\n}\n\n/** The current set of Settings for a Workspace.\n * @beta\n */\nexport interface Settings {\n  /** @internal */\n  close(): void;\n\n  /** Event raised whenever a SettingsDictionary is added or removed. */\n  readonly onSettingsChanged: BeEvent<() => void>;\n\n  /** Add a SettingDictionary from a local settings file. The file should be in [JSON5](https://json5.org/) format. It is read\n   * and parsed and the fileName is used as the DictionaryName.\n   * @param fileName the name of a local settings file of the SettingDictionary. This becomes the DictionaryName.\n   * @param priority the SettingsPriority for the SettingDictionary\n   * @note If the SettingDictionary was previously added, the new content overrides the old content.\n   */\n  addFile(fileName: LocalFileName, priority: SettingsPriority): void;\n\n  /** Add all files in the supplied directory with the extension \".json\" or \".json5\"\n   * @param dirName the name of a local settings directory\n   */\n  addDirectory(dirName: LocalDirName, priority: SettingsPriority): void;\n\n  /** Add a SettingDictionary from a JSON5 stringified string. The string is parsed and the resultant object is added as a SettingDictionary.\n   * @param dictionaryName the name of the SettingDictionary\n   * @param priority the SettingsPriority for the SettingDictionary\n   * @param settingsJson the JSON5 stringified string to be parsed.\n   * @note If the SettingDictionary was previously added, the new content overrides the old content.\n   */\n  addJson(dictionaryName: DictionaryName, priority: SettingsPriority, settingsJson: string): void;\n\n  /** Add a SettingDictionary object.\n   * @param dictionaryName the name of the SettingDictionary\n   * @param priority the SettingsPriority for the SettingDictionary\n   * @param settings the SettingDictionary object to be added.\n   * @note If the SettingDictionary was previously added, the new content overrides the old content.\n   */\n  addDictionary(dictionaryName: DictionaryName, priority: SettingsPriority, settings: SettingDictionary): void;\n\n  /** Remove a SettingDictionary by name. */\n  dropDictionary(dictionaryName: DictionaryName): void;\n\n  /**\n   * Resolve a setting, by name, using a SettingResolver.\n   * @param settingName The name of the setting to resolve\n   * @param resolver function to be called for each SettingDictionary with a matching Setting. Iteration stops when it returns a non-undefined value.\n   * @param defaultValue value returned if settingName is not present in any SettingDictionary or resolver never returned a value.\n   * @returns the resolved setting value.\n   */\n  resolveSetting<T extends SettingType>(settingName: SettingName, resolver: SettingResolver<T>, defaultValue: T): T;\n  resolveSetting<T extends SettingType>(settingName: SettingName, resolver: SettingResolver<T>, defaultValue?: T): T | undefined;\n\n  /** Get the highest priority setting for a SettingName.\n   * @param settingName The name of the setting\n   * @param defaultValue value returned if settingName is not present in any SettingDictionary.\n   * @note This method is generic on SettingType, but no type checking is actually performed at run time. So, if you\n   * use this method to get a setting with an expected type, but its value is a different type, the return type of this method will be wrong.\n   * You must always type check the result. Use the non-generic \"get\" methods (e.g. [[getString]]) if you only want the value\n   * if its type is correct.\n   */\n  getSetting<T extends SettingType>(settingName: SettingName, defaultValue?: T): T | undefined;\n\n  /** Get a string setting by SettingName.\n   * @param settingName The name of the setting\n   * @param defaultValue value returned if settingName is not present in any SettingDictionary, or if the highest priority setting is not a string.\n   */\n  getString(settingName: SettingName, defaultValue: string): string;\n  getString(settingName: SettingName, defaultValue?: string): string | undefined;\n\n  /** Get a boolean setting by SettingName.\n  * @param settingName The name of the setting\n  * @param defaultValue value returned if settingName is not present in any SettingDictionary, or if the highest priority setting is not a boolean.\n  */\n  getBoolean(settingName: SettingName, defaultValue: boolean): boolean;\n  getBoolean(settingName: SettingName, defaultValue?: boolean): boolean | undefined;\n\n  /** Get a number setting by SettingName.\n  * @param settingName The name of the setting\n  * @param defaultValue value returned if settingName is not present in any SettingDictionary, or if the highest priority setting is not a number.\n  */\n  getNumber(settingName: SettingName, defaultValue: number): number;\n  getNumber(settingName: SettingName): number | undefined;\n\n  /** Get an object setting by SettingName.\n  * @param settingName The name of the setting\n  * @param defaultValue value returned if settingName is not present in any SettingDictionary, or if the highest priority setting is not an object.\n  */\n  getObject<T extends object>(settingName: SettingName, defaultValue: T): T;\n  getObject<T extends object>(settingName: SettingName): T | undefined;\n\n  /** Get an array setting by SettingName.\n  * @param settingName The name of the setting\n  * @param defaultValue value returned if settingName is not present in any SettingDictionary, or if the highest priority setting is not an array.\n  */\n  getArray<T extends SettingType>(settingName: SettingName, defaultValue: Array<T>): Array<T>;\n  getArray<T extends SettingType>(settingName: SettingName): Array<T> | undefined;\n\n  /** Get an array of [[SettingInspector] objects, sorted in priority order, for all Settings that match a SettingName.\n   * @note this method is mainly for debugging and diagnostics.\n   */\n  inspectSetting<T extends SettingType>(name: SettingName): SettingInspector<T>[];\n}\n\n/** @internal */\nfunction deepClone<T extends SettingType>(obj: any): T {\n  if (!obj || typeof obj !== \"object\")\n    return obj;\n\n  const result = Array.isArray(obj) ? [] : {} as any;\n  Object.keys(obj).forEach((key: string) => {\n    const val = obj[key];\n    if (val && typeof val === \"object\") {\n      result[key] = deepClone(val);\n    } else {\n      result[key] = val;\n    }\n  });\n  return result;\n}\n\nclass SettingsDictionary {\n  public constructor(public readonly name: string, public readonly priority: SettingsPriority, public readonly settings: SettingDictionary) { }\n  public getSetting<T extends SettingType>(settingName: string): SettingType | undefined {\n    return this.settings[settingName] as T | undefined;\n  }\n}\n\n/**\n * Internal implementation of Settings interface.\n * @internal\n */\nexport class BaseSettings implements Settings {\n  private _dictionaries: SettingsDictionary[] = [];\n  protected verifyPriority(_priority: SettingsPriority) { }\n  public close() { }\n  public readonly onSettingsChanged = new BeEvent<() => void>();\n\n  public addFile(fileName: LocalFileName, priority: SettingsPriority) {\n    this.addJson(fileName, priority, fs.readFileSync(fileName, \"utf-8\"));\n  }\n\n  public addDirectory(dirName: LocalDirName, priority: SettingsPriority) {\n    for (const fileName of IModelJsFs.readdirSync(dirName)) {\n      const ext = extname(fileName);\n      if (ext === \".json5\" || ext === \".json\")\n        this.addFile(join(dirName, fileName), priority);\n    }\n  }\n\n  public addJson(dictionaryName: string, priority: SettingsPriority, settingsJson: string) {\n    this.addDictionary(dictionaryName, priority, parse(settingsJson));\n  }\n\n  public addDictionary(dictionaryName: string, priority: SettingsPriority, settings: SettingDictionary) {\n    this.verifyPriority(priority);\n    this.dropDictionary(dictionaryName, false); // make sure we don't have the same dictionary twice\n    const file = new SettingsDictionary(dictionaryName, priority, settings);\n    const doAdd = () => {\n      for (let i = 0; i < this._dictionaries.length; ++i) {\n        if (this._dictionaries[i].priority <= file.priority) {\n          this._dictionaries.splice(i, 0, file);\n          return;\n        }\n      }\n      this._dictionaries.push(file);\n    };\n    doAdd();\n    this.onSettingsChanged.raiseEvent();\n  }\n\n  public dropDictionary(dictionaryName: DictionaryName, raiseEvent = true) {\n    for (let i = 0; i < this._dictionaries.length; ++i) {\n      if (this._dictionaries[i].name === dictionaryName) {\n        this._dictionaries.splice(i, 1);\n        if (raiseEvent)\n          this.onSettingsChanged.raiseEvent();\n        return true;\n      }\n    }\n    return false;\n  }\n\n  public resolveSetting<T extends SettingType>(name: SettingName, resolver: SettingResolver<T>, defaultValue?: T): T | undefined {\n    for (const dict of this._dictionaries) {\n      const val = dict.getSetting(name) as T | undefined;\n      const resolved = val && resolver(val, dict.name, dict.priority);\n      if (undefined !== resolved)\n        return resolved;\n    }\n    return defaultValue;\n  }\n\n  public getSetting<T extends SettingType>(name: SettingName, defaultValue?: T): T | undefined {\n    return this.resolveSetting(name, (val) => deepClone<T>(val)) ?? defaultValue;\n  }\n\n  /** for debugging. Returns an array of all values for a setting, sorted by priority.\n   * @note values are not cloned. Do not modify objects or arrays.\n   */\n  public inspectSetting<T extends SettingType>(name: SettingName): SettingInspector<T>[] {\n    const all: SettingInspector<T>[] = [];\n    this.resolveSetting<T>(name, (value, dictionary, priority) => {\n      all.push({ value, dictionary, priority });\n      return undefined;\n    });\n\n    return all;\n  }\n\n  public getString(name: SettingName, defaultValue: string): string;\n  public getString(name: SettingName): string | undefined;\n  public getString(name: SettingName, defaultValue?: string): string | undefined {\n    const out = this.getSetting<string>(name);\n    return typeof out === \"string\" ? out : defaultValue;\n  }\n  public getBoolean(name: SettingName, defaultValue: boolean): boolean;\n  public getBoolean(name: SettingName): boolean | undefined;\n  public getBoolean(name: SettingName, defaultValue?: boolean): boolean | undefined {\n    const out = this.getSetting<boolean>(name);\n    return typeof out === \"boolean\" ? out : defaultValue;\n  }\n  public getNumber(name: SettingName, defaultValue: number): number;\n  public getNumber(name: SettingName): number | undefined;\n  public getNumber(name: SettingName, defaultValue?: number): number | undefined {\n    const out = this.getSetting<number>(name);\n    return typeof out === \"number\" ? out : defaultValue;\n  }\n  public getObject<T extends object>(name: SettingName, defaultValue: T): T;\n  public getObject<T extends object>(name: SettingName): T | undefined;\n  public getObject<T extends object>(name: SettingName, defaultValue?: T): T | undefined {\n    const out = this.getSetting<SettingObject>(name);\n    return typeof out === \"object\" ? out as T : defaultValue;\n  }\n  public getArray<T extends SettingType>(name: SettingName, defaultValue: Array<T>): Array<T>;\n  public getArray<T extends SettingType>(name: SettingName): Array<T> | undefined;\n  public getArray<T extends SettingType>(name: SettingName, defaultValue?: Array<T>): Array<T> | undefined {\n    const out = this.getSetting<Array<T>>(name);\n    return Array.isArray(out) ? out : defaultValue;\n  }\n}\n"]}

package/lib/cjs/workspace/SettingsSchemas.js

@@ -32,7 +32,7 @@ class SettingsSchemas {
     /** @internal */
     static validateArrayObject(val, schemaName, msg) {
         const schema = this.allSchemas.get(schemaName);
-        const items = schema === null || schema === void 0 ? void 0 : schema.items;
+        const items = schema?.items;
         if (undefined === items)
             return val;
         const required = items.required;
@@ -96,7 +96,7 @@ class SettingsSchemas {
     }
     static doRemove(groupName) {
         const group = this._allGroups.get(groupName);
-        if (undefined !== (group === null || group === void 0 ? void 0 : group.properties)) {
+        if (undefined !== group?.properties) {
             for (const key of Object.keys(group.properties))
                 this.allSchemas.delete(key);
         }
@@ -152,7 +152,6 @@ class SettingsSchemas {
         }
     }
     static validateAndAdd(group) {
-        var _a;
         const properties = group.properties;
         if (undefined === properties)
             throw new Error(`group ${group.groupName} has no properties`);
@@ -160,7 +159,7 @@ class SettingsSchemas {
             this.validateName(key);
             this.validateProperty(key, properties[key]);
             const property = properties[key];
-            property.default = (_a = property.default) !== null && _a !== void 0 ? _a : this.getDefaultValue(property.type);
+            property.default = property.default ?? this.getDefaultValue(property.type);
             this.allSchemas.set(key, property);
         }
     }

package/lib/cjs/workspace/SettingsSchemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"SettingsSchemas.js","sourceRoot":"","sources":["../../../src/workspace/SettingsSchemas.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 Workspace\n */\n\nimport * as fs from \"fs-extra\";\nimport { parse } from \"json5\";\nimport { extname, join } from \"path\";\nimport { BeEvent, JSONSchema, JSONSchemaType, JSONSchemaTypeName, Mutable } from \"@itwin/core-bentley\";\nimport { LocalDirName, LocalFileName } from \"@itwin/core-common\";\nimport { IModelJsFs } from \"../IModelJsFs\";\n\n/**\n * The properties of a single Setting, used by the settings editor. This interface also includes the\n * default value if it is not specified in any Settings file.\n * This interface includes all members of [JSONSchema]($bentley) with the extensions added by VSCode.\n * @note the `type` member is marked optional in JSONSchema but is required for Settings.\n * @beta\n */\nexport interface SettingSchema extends Readonly<JSONSchema> {\n  readonly items?: SettingSchema; // must be single object, not array\n  readonly type: JSONSchemaTypeName; // type is required for settings\n  readonly properties?: { [name: string]: SettingSchema };\n\n  /** whether the setting replaces lower priority entries with the same name or combines with them. */\n  readonly cumulative?: true;\n}\n\n/**\n * The properties of a group of [[SettingSchema]]s for an application. Groups can be added and removed from [[SettingsSchemas]]\n * and are identified by their (required) `groupName` member\n * @beta\n */\nexport interface SettingSchemaGroup {\n  readonly groupName: string;\n  readonly properties: { [name: string]: SettingSchema };\n  readonly order?: number;\n  readonly title?: string;\n  readonly description?: string;\n  readonly extensionId?: string;\n}\n\n/**\n * The registry of available [[SettingSchemaGroup]]s.\n * The registry is used for editing Settings files and for finding default values for settings.\n * @beta\n */\nexport class SettingsSchemas {\n  private constructor() { } // singleton\n  private static readonly _allGroups = new Map<string, SettingSchemaGroup>();\n  /** a map of all registered [[SettingSchema]]s */\n  public static readonly allSchemas = new Map<string, SettingSchema>();\n  /** event that signals that the values in [[allSchemas]] have changed in some way. */\n  public static readonly onSchemaChanged = new BeEvent<() => void>();\n\n  /** Clear the contents of the registry and remove all event listeners.\n   * @note This is really only necessary for tests of the Settings system.\n   * @internal\n   */\n  public static reset() {\n    this._allGroups.clear();\n    this.allSchemas.clear();\n    this.onSchemaChanged.clear();\n  }\n\n  /** @internal */\n  public static validateArrayObject<T>(val: T, schemaName: string, msg: string): T {\n    const schema = this.allSchemas.get(schemaName);\n    const items = schema?.items;\n    if (undefined === items)\n      return val;\n    const required = items.required;\n    const properties = items.properties;\n    if (undefined === required || undefined === properties)\n      return val;\n\n    for (const entry of required) {\n      const entryType = properties[entry].type;\n      const value = (val as any)[entry];\n      if (entryType === \"array\" && Array.isArray(value))\n        continue;\n      if (typeof value !== entryType)\n        throw new Error(`invalid \"${schemaName}\" setting entry for \"${msg}\": ${entry} is ${value}`);\n    }\n    return val;\n  }\n\n  /**\n   * Add one or more [[SettingSchemaGroup]]s. `SettingSchemaGroup`s must include a `groupName` member that is used\n   * to identify the group. If a group with the same name is already registered, the old values are first removed and then the new group is added.\n   */\n  public static addGroup(settingsGroup: SettingSchemaGroup | SettingSchemaGroup[]): void {\n    if (!Array.isArray(settingsGroup))\n      settingsGroup = [settingsGroup];\n\n    this.doAdd(settingsGroup);\n    this.onSchemaChanged.raiseEvent();\n  }\n\n  /** Add a [[SettingSchemaGroup]] from stringified json5. */\n  public static addJson(settingSchema: string): void {\n    this.addGroup(parse(settingSchema));\n  }\n\n  /** Add a [[SettingSchemaGroup]] from a json5 file. */\n  public static addFile(fileName: LocalFileName): void {\n    try {\n      this.addJson(fs.readFileSync(fileName, \"utf-8\"));\n    } catch (e: any) {\n      throw new Error(`parsing SettingSchema file \"${fileName}\": ${e.message}\"`);\n    }\n  }\n\n  /** Add all files with a either \".json\" or \".json5\" extension from a supplied directory. */\n  public static addDirectory(dirName: LocalDirName) {\n    for (const fileName of IModelJsFs.readdirSync(dirName)) {\n      const ext = extname(fileName);\n      if (ext === \".json5\" || ext === \".json\")\n        this.addFile(join(dirName, fileName));\n    }\n  }\n\n  /** Remove a previously added [[SettingSchemaGroup]] by groupName */\n  public static removeGroup(groupName: string): void {\n    this.doRemove(groupName);\n    this.onSchemaChanged.raiseEvent();\n  }\n\n  private static doAdd(settingsGroup: SettingSchemaGroup[]) {\n    settingsGroup.forEach((group) => {\n      if (undefined === group.groupName)\n        throw new Error(`settings group has no \"groupName\" member`);\n\n      this.doRemove(group.groupName);\n      this.validateAndAdd(group);\n      this._allGroups.set(group.groupName, group);\n    });\n  }\n\n  private static doRemove(groupName: string) {\n    const group = this._allGroups.get(groupName);\n    if (undefined !== group?.properties) {\n      for (const key of Object.keys(group.properties))\n        this.allSchemas.delete(key);\n    }\n    this._allGroups.delete(groupName);\n  }\n\n  private static validateName(name: string) {\n    if (!name.trim())\n      throw new Error(`empty property name`);\n    if (this.allSchemas.has(name))\n      throw new Error(`property \"${name}\" is already defined`);\n  }\n\n  private static validateProperty(name: string, property: SettingSchema | undefined) {\n    if (!property)\n      throw new Error(`missing required property ${name}`);\n\n    if (!property.type)\n      throw new Error(`property ${name} has no type`);\n\n    switch (property.type) {\n      case \"boolean\":\n      case \"integer\":\n      case \"null\":\n      case \"number\":\n      case \"string\":\n        return;\n\n      case \"object\":\n        const required = property.required;\n        const props = property.properties;\n        if (required && props) {\n          for (const entry of required)\n            this.validateProperty(entry, props[entry]);\n        }\n        if (props) {\n          for (const key of Object.keys(props))\n            try {\n              this.validateProperty(key, props[key]);\n            } catch (e: any) {\n              throw new Error(`property ${key} of ${name}: ${e.message}`);\n            }\n        }\n        return;\n\n      case \"array\":\n        if (typeof property.items !== \"object\")\n          throw new Error(`array property ${name} has no items member`);\n        try {\n          this.validateProperty(\"items\", property.items);\n        } catch (e: any) {\n          throw new Error(`array property ${name}: ${e.message}`);\n        }\n        return;\n\n      default:\n        throw new Error(`property ${name} has illegal type \"${property.type}\"`);\n    }\n  }\n\n  private static validateAndAdd(group: SettingSchemaGroup) {\n    const properties = group.properties;\n    if (undefined === properties)\n      throw new Error(`group ${group.groupName} has no properties`);\n\n    for (const key of Object.keys(properties)) {\n      this.validateName(key);\n      this.validateProperty(key, properties[key]);\n      const property: Mutable<SettingSchema> = properties[key];\n      property.default = property.default ?? this.getDefaultValue(property.type);\n      this.allSchemas.set(key, property);\n    }\n  }\n\n  private static getDefaultValue(type: JSONSchemaTypeName | JSONSchemaTypeName[]): JSONSchemaType | undefined {\n    type = Array.isArray(type) ? type[0] : type;\n    switch (type) {\n      case \"boolean\":\n        return false;\n      case \"integer\":\n      case \"number\":\n        return 0;\n      case \"string\":\n        return \"\";\n      case \"array\":\n        return [];\n      case \"object\":\n        return {};\n      default:\n        return undefined;\n    }\n  }\n}\n"]}
+{"version":3,"file":"SettingsSchemas.js","sourceRoot":"","sources":["../../../src/workspace/SettingsSchemas.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 Workspace\n */\n\nimport * as fs from \"fs-extra\";\nimport { parse } from \"json5\";\nimport { extname, join } from \"path\";\nimport { BeEvent, JSONSchema, JSONSchemaType, JSONSchemaTypeName, Mutable } from \"@itwin/core-bentley\";\nimport { LocalDirName, LocalFileName } from \"@itwin/core-common\";\nimport { IModelJsFs } from \"../IModelJsFs\";\n\n/**\n * The properties of a single Setting, used by the settings editor. This interface also includes the\n * default value if it is not specified in any Settings file.\n * This interface includes all members of [JSONSchema]($bentley) with the extensions added by VSCode.\n * @note the `type` member is marked optional in JSONSchema but is required for Settings.\n * @beta\n */\nexport interface SettingSchema extends Readonly<JSONSchema> {\n  readonly items?: SettingSchema; // must be single object, not array\n  readonly type: JSONSchemaTypeName; // type is required for settings\n  readonly properties?: { [name: string]: SettingSchema };\n\n  /** whether the setting replaces lower priority entries with the same name or combines with them. */\n  readonly cumulative?: true;\n}\n\n/**\n * The properties of a group of [[SettingSchema]]s for an application. Groups can be added and removed from [[SettingsSchemas]]\n * and are identified by their (required) `groupName` member\n * @beta\n */\nexport interface SettingSchemaGroup {\n  readonly groupName: string;\n  readonly properties: { [name: string]: SettingSchema };\n  readonly order?: number;\n  readonly title?: string;\n  readonly description?: string;\n  readonly extensionId?: string;\n}\n\n/**\n * The registry of available [[SettingSchemaGroup]]s.\n * The registry is used for editing Settings files and for finding default values for settings.\n * @beta\n */\nexport class SettingsSchemas {\n  private constructor() { } // singleton\n  private static readonly _allGroups = new Map<string, SettingSchemaGroup>();\n  /** a map of all registered [[SettingSchema]]s */\n  public static readonly allSchemas = new Map<string, SettingSchema>();\n  /** event that signals that the values in [[allSchemas]] have changed in some way. */\n  public static readonly onSchemaChanged = new BeEvent<() => void>();\n\n  /** Clear the contents of the registry and remove all event listeners.\n   * @note This is really only necessary for tests of the Settings system.\n   * @internal\n   */\n  public static reset() {\n    this._allGroups.clear();\n    this.allSchemas.clear();\n    this.onSchemaChanged.clear();\n  }\n\n  /** @internal */\n  public static validateArrayObject<T>(val: T, schemaName: string, msg: string): T {\n    const schema = this.allSchemas.get(schemaName);\n    const items = schema?.items;\n    if (undefined === items)\n      return val;\n    const required = items.required;\n    const properties = items.properties;\n    if (undefined === required || undefined === properties)\n      return val;\n\n    for (const entry of required) {\n      const entryType = properties[entry].type;\n      const value = (val as any)[entry];\n      if (entryType === \"array\" && Array.isArray(value))\n        continue;\n      if (typeof value !== entryType)\n        throw new Error(`invalid \"${schemaName}\" setting entry for \"${msg}\": ${entry} is ${value}`);\n    }\n    return val;\n  }\n\n  /**\n   * Add one or more [[SettingSchemaGroup]]s. `SettingSchemaGroup`s must include a `groupName` member that is used\n   * to identify the group. If a group with the same name is already registered, the old values are first removed and then the new group is added.\n   */\n  public static addGroup(settingsGroup: SettingSchemaGroup | SettingSchemaGroup[]): void {\n    if (!Array.isArray(settingsGroup))\n      settingsGroup = [settingsGroup];\n\n    this.doAdd(settingsGroup);\n    this.onSchemaChanged.raiseEvent();\n  }\n\n  /** Add a [[SettingSchemaGroup]] from stringified json5. */\n  public static addJson(settingSchema: string): void {\n    this.addGroup(parse(settingSchema));\n  }\n\n  /** Add a [[SettingSchemaGroup]] from a json5 file. */\n  public static addFile(fileName: LocalFileName): void {\n    try {\n      this.addJson(fs.readFileSync(fileName, \"utf-8\"));\n    } catch (e: any) {\n      throw new Error(`parsing SettingSchema file \"${fileName}\": ${e.message}\"`);\n    }\n  }\n\n  /** Add all files with a either \".json\" or \".json5\" extension from a supplied directory. */\n  public static addDirectory(dirName: LocalDirName) {\n    for (const fileName of IModelJsFs.readdirSync(dirName)) {\n      const ext = extname(fileName);\n      if (ext === \".json5\" || ext === \".json\")\n        this.addFile(join(dirName, fileName));\n    }\n  }\n\n  /** Remove a previously added [[SettingSchemaGroup]] by groupName */\n  public static removeGroup(groupName: string): void {\n    this.doRemove(groupName);\n    this.onSchemaChanged.raiseEvent();\n  }\n\n  private static doAdd(settingsGroup: SettingSchemaGroup[]) {\n    settingsGroup.forEach((group) => {\n      if (undefined === group.groupName)\n        throw new Error(`settings group has no \"groupName\" member`);\n\n      this.doRemove(group.groupName);\n      this.validateAndAdd(group);\n      this._allGroups.set(group.groupName, group);\n    });\n  }\n\n  private static doRemove(groupName: string) {\n    const group = this._allGroups.get(groupName);\n    if (undefined !== group?.properties) {\n      for (const key of Object.keys(group.properties))\n        this.allSchemas.delete(key);\n    }\n    this._allGroups.delete(groupName);\n  }\n\n  private static validateName(name: string) {\n    if (!name.trim())\n      throw new Error(`empty property name`);\n    if (this.allSchemas.has(name))\n      throw new Error(`property \"${name}\" is already defined`);\n  }\n\n  private static validateProperty(name: string, property: SettingSchema | undefined) {\n    if (!property)\n      throw new Error(`missing required property ${name}`);\n\n    if (!property.type)\n      throw new Error(`property ${name} has no type`);\n\n    switch (property.type) {\n      case \"boolean\":\n      case \"integer\":\n      case \"null\":\n      case \"number\":\n      case \"string\":\n        return;\n\n      case \"object\":\n        const required = property.required;\n        const props = property.properties;\n        if (required && props) {\n          for (const entry of required)\n            this.validateProperty(entry, props[entry]);\n        }\n        if (props) {\n          for (const key of Object.keys(props))\n            try {\n              this.validateProperty(key, props[key]);\n            } catch (e: any) {\n              throw new Error(`property ${key} of ${name}: ${e.message}`);\n            }\n        }\n        return;\n\n      case \"array\":\n        if (typeof property.items !== \"object\")\n          throw new Error(`array property ${name} has no items member`);\n        try {\n          this.validateProperty(\"items\", property.items);\n        } catch (e: any) {\n          throw new Error(`array property ${name}: ${e.message}`);\n        }\n        return;\n\n      default:\n        throw new Error(`property ${name} has illegal type \"${property.type}\"`);\n    }\n  }\n\n  private static validateAndAdd(group: SettingSchemaGroup) {\n    const properties = group.properties;\n    if (undefined === properties)\n      throw new Error(`group ${group.groupName} has no properties`);\n\n    for (const key of Object.keys(properties)) {\n      this.validateName(key);\n      this.validateProperty(key, properties[key]);\n      const property: Mutable<SettingSchema> = properties[key];\n      property.default = property.default ?? this.getDefaultValue(property.type);\n      this.allSchemas.set(key, property);\n    }\n  }\n\n  private static getDefaultValue(type: JSONSchemaTypeName | JSONSchemaTypeName[]): JSONSchemaType | undefined {\n    type = Array.isArray(type) ? type[0] : type;\n    switch (type) {\n      case \"boolean\":\n        return false;\n      case \"integer\":\n      case \"number\":\n        return 0;\n      case \"string\":\n        return \"\";\n      case \"array\":\n        return [];\n      case \"object\":\n        return {};\n      default:\n        return undefined;\n    }\n  }\n}\n"]}

package/lib/cjs/workspace/Workspace.js

@@ -33,12 +33,11 @@ exports.WorkspaceSetting = {
 /** @internal */
 class ITwinWorkspace {
     constructor(settings, opts) {
-        var _a;
         this._containers = new Map();
         this.settings = settings;
-        this.containerDir = (_a = opts === null || opts === void 0 ? void 0 : opts.containerDir) !== null && _a !== void 0 ? _a : (0, path_1.join)(IModelHost_1.IModelHost.cacheDir, "Workspace");
-        this._cloudCache = opts === null || opts === void 0 ? void 0 : opts.testCloudCache;
-        let settingsFiles = opts === null || opts === void 0 ? void 0 : opts.settingsFiles;
+        this.containerDir = opts?.containerDir ?? (0, path_1.join)(IModelHost_1.IModelHost.cacheDir, "Workspace");
+        this._cloudCache = opts?.testCloudCache;
+        let settingsFiles = opts?.settingsFiles;
         if (settingsFiles) {
             if (typeof settingsFiles === "string")
                 settingsFiles = [settingsFiles];
@@ -73,8 +72,7 @@ class ITwinWorkspace {
         return this._containers.get(containerId);
     }
     getContainer(props, account) {
-        var _a;
-        return (_a = this.findContainer(props.containerId)) !== null && _a !== void 0 ? _a : new ITwinWorkspaceContainer(this, props, account);
+        return this.findContainer(props.containerId) ?? new ITwinWorkspaceContainer(this, props, account);
     }
     getWorkspaceDbFromProps(dbProps, containerProps, account) {
         return this.getContainer(containerProps, account).getWorkspaceDb(dbProps);
@@ -89,7 +87,7 @@ class ITwinWorkspace {
                 containerProps.accessToken = await tokenFunc(containerProps, account);
             container = this.getContainer(containerProps, account);
         }
-        return container === null || container === void 0 ? void 0 : container.getWorkspaceDb(dbProps);
+        return container?.getWorkspaceDb(dbProps);
     }
     loadSettingsDictionary(settingRsc, db, priority) {
         const setting = db.getString(settingRsc);
@@ -154,7 +152,7 @@ class ITwinWorkspaceContainer {
         ITwinWorkspaceContainer.validateContainerId(props.containerId);
         this.workspace = workspace;
         this.id = props.containerId;
-        if ((account === null || account === void 0 ? void 0 : account.accessName) && account.storageType)
+        if (account?.accessName && account.storageType)
             this.cloudContainer = CloudSqlite_1.CloudSqlite.createCloudContainer({ accessToken: "", ...props, ...account });
         workspace.addContainer(this);
         this.filesDir = (0, path_1.join)(this.dirName, "Files");
@@ -191,12 +189,11 @@ class ITwinWorkspaceContainer {
         this.noLeadingOrTrailingSpaces(dbName, "dbName");
     }
     static validateVersion(version) {
-        var _a, _b;
-        version = version !== null && version !== void 0 ? version : "1.0.0";
+        version = version ?? "1.0.0";
         if (version) {
             const opts = { loose: true, includePrerelease: true };
             // clean allows prerelease, so try it first. If that fails attempt to coerce it (coerce strips prerelease even if you say not to.)
-            const semVersion = (_a = semver.clean(version, opts)) !== null && _a !== void 0 ? _a : (_b = semver.coerce(version, opts)) === null || _b === void 0 ? void 0 : _b.version;
+            const semVersion = semver.clean(version, opts) ?? semver.coerce(version, opts)?.version;
             if (!semVersion)
                 throw new Error("invalid version specification");
             version = semVersion;
@@ -211,7 +208,6 @@ class ITwinWorkspaceContainer {
         return `${dbName}:${this.validateVersion(version)}`;
     }
     static resolveCloudFileName(cloudContainer, props) {
-        var _a;
         const dbName = props.dbName;
         const dbs = cloudContainer.queryDatabases(`${dbName}*`); // get all databases that start with dbName
         const versions = [];
@@ -222,7 +218,7 @@ class ITwinWorkspaceContainer {
         }
         if (versions.length === 0)
             versions[0] = "1.0.0";
-        const range = (_a = props.version) !== null && _a !== void 0 ? _a : "*";
+        const range = props.version ?? "*";
         try {
             const version = semver.maxSatisfying(versions, range, { loose: true, includePrerelease: props.includePrerelease });
             if (version)
@@ -266,8 +262,7 @@ class ITwinWorkspaceContainer {
         this._wsDbs.set(toAdd.dbName, toAdd);
     }
     getWorkspaceDb(props) {
-        var _a;
-        const db = (_a = this._wsDbs.get(props.dbName)) !== null && _a !== void 0 ? _a : new ITwinWorkspaceDb(props, this);
+        const db = this._wsDbs.get(props.dbName) ?? new ITwinWorkspaceDb(props, this);
         if (!db.isOpen)
             db.open();
         return db;
@@ -281,11 +276,10 @@ class ITwinWorkspaceContainer {
         }
     }
     close() {
-        var _a;
         for (const [_name, db] of this._wsDbs)
             db.close();
         this._wsDbs.clear();
-        (_a = this.cloudContainer) === null || _a === void 0 ? void 0 : _a.disconnect();
+        this.cloudContainer?.disconnect();
     }
     /** Delete all local files extracted by [[WorkspaceDb.getFile]] for this container. */
     purgeContainerFiles() {
@@ -359,7 +353,7 @@ class ITwinWorkspaceDb {
         if (!file)
             return undefined;
         const info = file.info;
-        const localFileName = targetFileName !== null && targetFileName !== void 0 ? targetFileName : file.localFileName;
+        const localFileName = targetFileName ?? file.localFileName;
         // check whether the file is already up to date.
         const stat = fs.existsSync(localFileName) && fs.statSync(localFileName);
         if (stat && Math.round(stat.mtimeMs) === info.date && stat.size === info.size)
@@ -411,7 +405,7 @@ class EditableWorkspaceDb extends ITwinWorkspaceDb {
     performWriteSql(rscName, sql, bind) {
         this.sqliteDb.withSqliteStatement(sql, (stmt) => {
             stmt.bindString(1, rscName);
-            bind === null || bind === void 0 ? void 0 : bind(stmt);
+            bind?.(stmt);
             const rc = stmt.step();
             if (core_bentley_1.DbResult.BE_SQLITE_DONE !== rc) {
                 if (core_bentley_1.DbResult.BE_SQLITE_CONSTRAINT_PRIMARYKEY === rc)
@@ -516,8 +510,8 @@ class EditableWorkspaceDb extends ITwinWorkspaceDb {
      */
     addFile(rscName, localFileName, fileExt) {
         EditableWorkspaceDb.validateResourceName(rscName);
-        fileExt = fileExt !== null && fileExt !== void 0 ? fileExt : (0, path_1.extname)(localFileName);
-        if ((fileExt === null || fileExt === void 0 ? void 0 : fileExt[0]) === ".")
+        fileExt = fileExt ?? (0, path_1.extname)(localFileName);
+        if (fileExt?.[0] === ".")
             fileExt = fileExt.slice(1);
         this.sqliteDb.nativeDb.embedFile({ name: rscName, localFileName, date: this.getFileModifiedTime(localFileName), fileExt });
     }