@itwin/core-backend 4.0.0-dev.52 → 4.0.0-dev.55

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

@@ -1 +1 @@
-{"version":3,"file":"IModelTileRpcImpl.js","sourceRoot":"","sources":["../../../src/rpc-impl/IModelTileRpcImpl.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAGH,sDAAyF;AACzF,oDAI4B;AAC5B,oEAAiE;AACjE,0CAAuC;AACvC,8CAA2C;AAC3C,wDAAuE;AACvE,4CAA0C;AAC1C,+DAA4D;AAQ5D,SAAS,sBAAsB,CAAC,KAAuB;IACrD,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC;IAC/B,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC;QACvB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,WAAW,EAAE,KAAK,CAAC,SAAS,EAAE,EAAE;KACjC,CAAC,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;AACvB,CAAC;AAED,MAAe,mBAA4D,SAAQ,iCAAuB;IAaxG,YAAsB,SAA4C,EAAE,aAAuC;QACzG,KAAK,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QAbjB,oBAAe,GAAG,6CAAqB,CAAC,oBAAoB,CAAC;IAc9E,CAAC;IARO,YAAY,CAAC,KAAY;QAC/B,MAAM,IAAI,GAAG,EAAE,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC;QACrC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAMe,OAAO,CAAC,KAAY;QAClC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAEe,cAAc,CAAC,KAAY;QACzC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAEO,GAAG,CAAC,MAAc,EAAE,KAAY;QACtC,MAAM,KAAK,GAAG,GAAG,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC;QACjE,qBAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,eAAe,EAAE,WAAW,MAAM,IAAI,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;IACtG,CAAC;IAES,KAAK,CAAC,OAAO,CAAC,KAAY;QAClC,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAE5B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAEnC,MAAM,yBAAU,CAAC,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;QAClF,+EAA+E;QAE/E,IAAI,MAAM,CAAC,SAAS,EAAE;YACpB,IAAI,CAAC,GAAG,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;YAC9C,MAAM,IAAI,gCAAkB,EAAE,CAAC,CAAC,8CAA8C;SAC/E;QAED,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAE3B,IAAI,MAAM,CAAC,WAAW,EAAE;YACtB,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YAC7B,IAAA,qBAAM,EAAC,SAAS,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC;YACpC,OAAO,MAAM,CAAC,MAAM,CAAC;SACtB;QAED,IAAA,qBAAM,EAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC1B,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAC5B,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC,uCAAuC;IAC7D,CAAC;CACF;AAED,KAAK,UAAU,gBAAgB,CAAC,KAAuB;IACrD,IAAA,qBAAM,EAAC,SAAS,KAAK,KAAK,CAAC,WAAW,CAAC,CAAC;IACxC,MAAM,EAAE,GAAG,MAAM,yCAAmB,CAAC,cAAc,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IACzF,OAAO,EAAE,CAAC,KAAK,CAAC,oBAAoB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,4BAA6B,SAAQ,mBAA0D;IAUnG;QACE,KAAK,CAAC,gBAAgB,EAAE,sBAAsB,CAAC,CAAC;QAChD,uBAAU,CAAC,gBAAgB,CAAC,OAAO,CAAC,GAAG,EAAE;YACvC,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,4BAA4B,CAAC,SAAS,GAAG,SAAS,CAAC;QACrD,CAAC,CAAC,CAAC;IACL,CAAC;IAfD,IAAc,oBAAoB,KAAK,OAAO,uBAAU,CAAC,sBAAsB,CAAC,CAAC,CAAC;IAClF,IAAc,cAAc,KAAK,OAAO,sBAAsB,CAAC,CAAC,CAAC;IACvD,SAAS,CAAC,KAAuB,IAAY,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACnE,WAAW,CAAC,IAAS,EAAE,KAAuB;QACtD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC7B,CAAC;IAYM,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,KAAuB;QACjD,IAAI,SAAS,KAAK,IAAI,CAAC,SAAS;YAC9B,IAAI,CAAC,SAAS,GAAG,IAAI,4BAA4B,EAAE,CAAC;QAEtD,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;CACF;AAOD,KAAK,UAAU,cAAc,CAAC,KAA8B;IAC1D,IAAA,qBAAM,EAAC,SAAS,KAAK,KAAK,CAAC,WAAW,CAAC,CAAC;IACxC,MAAM,EAAE,GAAG,MAAM,yCAAmB,CAAC,cAAc,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IACzF,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,kBAAkB,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAE9E,2FAA2F;IAC3F,IAAI,uBAAU,CAAC,sBAAsB,EAAE;QACrC,MAAM,uBAAU,CAAC,WAAW,EAAE,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE;YAC9H,WAAW,EAAE,uBAAU,CAAC,aAAa;YACrC,kBAAkB,EAAE,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE;YAClD,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,EAAE;SAC7C,CAAC,CAAC;QAEH,OAAO,+BAAiB,CAAC,aAAa,CAAC;KACxC;IAED,OAAO,+BAAiB,CAAC,OAAO,CAAC;AACnC,CAAC;AAED,SAAS,sBAAsB,CAAC,KAA8B;IAC5D,OAAO,GAAG,sBAAsB,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;AAC/D,CAAC;AAED,MAAM,0BAA2B,SAAQ,mBAA+D;IAWtG;QACE,KAAK,CAAC,cAAc,EAAE,sBAAsB,CAAC,CAAC;QAC9C,uBAAU,CAAC,gBAAgB,CAAC,OAAO,CAAC,GAAG,EAAE;YACvC,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,0BAA0B,CAAC,SAAS,GAAG,SAAS,CAAC;QACnD,CAAC,CAAC,CAAC;IACL,CAAC;IAhBD,IAAc,oBAAoB,KAAK,OAAO,uBAAU,CAAC,yBAAyB,CAAC,CAAC,CAAC;IACrF,IAAc,cAAc,KAAK,OAAO,oBAAoB,CAAC,CAAC,CAAC;IACrD,SAAS,CAAC,KAA8B,IAAY,OAAO,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IAClG,WAAW,CAAC,IAAS,EAAE,KAA8B;QAC7D,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;IACnC,CAAC;IAYM,MAAM,KAAK,QAAQ;QACxB,IAAI,SAAS,KAAK,IAAI,CAAC,SAAS;YAC9B,IAAI,CAAC,SAAS,GAAG,IAAI,0BAA0B,EAAE,CAAC;QAEpD,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,KAA8B;QACxD,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;CACF;AAED,SAAS,eAAe;IACtB,OAAO,kBAAQ,CAAC,qBAAqB,CAAC,CAAC,8CAA8C;AACvF,CAAC;AAED,gBAAgB;AAChB,MAAa,iBAAkB,SAAQ,0BAAY;IAC1C,MAAM,CAAC,QAAQ,KAAK,wBAAU,CAAC,YAAY,CAAC,oCAAsB,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAEzF,KAAK,CAAC,oBAAoB,CAAC,UAA0B,EAAE,MAAc;QAC1E,OAAO,4BAA4B,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;IAClH,CAAC;IAEM,KAAK,CAAC,cAAc,CAAC,UAA0B,EAAE,QAA+B;QACrF,0CAA0C;QAC1C,IAAI,IAAI,KAAK,QAAQ;YACnB,QAAQ,GAAG,SAAS,CAAC;QAEvB,MAAM,EAAE,GAAG,MAAM,yCAAmB,CAAC,cAAc,CAAC,eAAe,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QAC/F,OAAO,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAEM,KAAK,CAAC,mBAAmB,CAAC,UAA0B,EAAE,MAAc,EAAE,SAAiB,EAAE,IAAwB;QACtH,OAAO,0BAA0B,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACjI,CAAC;IAEM,KAAK,CAAC,mBAAmB,CAAC,UAA0B,EAAE,GAA0B;QACrF,MAAM,EAAE,GAAG,MAAM,yCAAmB,CAAC,cAAc,CAAC,eAAe,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QAC/F,OAAO,EAAE,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;IAC5D,CAAC;IAEM,KAAK,CAAC,kBAAkB,CAAC,UAA0B;QACxD,IAAI,uBAAU,CAAC,WAAW,KAAK,SAAS;YACtC,OAAO,SAAS,CAAC;QACnB,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,IAAI,CAAC,MAAM,yCAAmB,CAAC,cAAc,CAAC,eAAe,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC;QACvI,OAAO,uBAAU,CAAC,WAAW,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC5D,CAAC;IAED,4CAA4C;IACrC,KAAK,CAAC,wBAAwB,CAAC,WAA2B,EAAE,EAAmC;QACpG,MAAM,UAAU,GAAG,2BAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAE/C,IAAI,CAAC,uBAAU,CAAC,sBAAsB,EAAE;YACtC,OAAO,sCAAwB,CAAC,KAAK,EAAE,CAAC;SACzC;QAED,MAAM,MAAM,GAAG,mCAAqB,CAAC,QAAQ,EAAE,CAAC,2BAA2B,CAAC,EAAE,CAAC,CAAC;QAChF,MAAM,QAAQ,GAAG,CAAC,uBAAU,CAAC,0BAA0B,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACtH,oEAAoE;QACpE,OAAO,uBAAU,CAAC,gBAAiB,CAAC,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC/E,CAAC;IAEM,KAAK,CAAC,wBAAwB;QACnC,OAAO,uBAAU,CAAC,gBAAgB,KAAK,SAAS,CAAC;IACnD,CAAC;IACD,2CAA2C;IAEpC,KAAK,CAAC,gBAAgB;QAC3B,OAAO,uBAAU,CAAC,QAAQ,CAAC,kBAAkB,EAAE,CAAC;IAClD,CAAC;IAED,gBAAgB;IACT,KAAK,CAAC,sBAAsB,CAAC,QAAwB,EAAE,OAAoC;QAChG,MAAM,MAAM,GAAG,MAAM,yCAAmB,CAAC,cAAc,CAAC,eAAe,EAAE,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QACjG,OAAO,MAAM,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACjD,CAAC;CACF;AA5DD,8CA4DC;AAED,gBAAgB;AACT,KAAK,UAAU,yBAAyB,CAAC,UAA0B,EAAE,UAAgC;IAC1G,MAAM,MAAM,GAAG,mBAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAClD,MAAM,KAAK,GAA4B,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAEjF,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE;QAC9B,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC5B,KAAK,MAAM,SAAS,IAAI,KAAK,CAAC,UAAU,EAAE;YACxC,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;YAC5B,0BAA0B,CAAC,QAAQ,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;SAC3D;QAED,MAAM,CAAC,QAAQ,CAAC,yBAAyB,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;KAC3E;AACH,CAAC;AAbD,8DAaC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module RpcInterface\r\n */\r\n\r\nimport type { TransferConfig } from \"@itwin/object-storage-core\";\r\nimport { AccessToken, assert, BeDuration, Id64Array, Logger } from \"@itwin/core-bentley\";\r\nimport {\r\n  CloudStorageContainerDescriptor, CloudStorageContainerUrl, CloudStorageTileCache, ElementGraphicsRequestProps, IModelRpcProps,\r\n  IModelTileRpcInterface, IModelTileTreeProps, RpcInterface, RpcInvocation, RpcManager, RpcPendingResponse, TileContentIdentifier,\r\n  TileContentSource, TileTreeContentIds, TileVersionInfo,\r\n} from \"@itwin/core-common\";\r\nimport { BackendLoggerCategory } from \"../BackendLoggerCategory\";\r\nimport { IModelDb } from \"../IModelDb\";\r\nimport { IModelHost } from \"../IModelHost\";\r\nimport { PromiseMemoizer, QueryablePromise } from \"../PromiseMemoizer\";\r\nimport { RpcTrace } from \"../rpc/tracing\";\r\nimport { RpcBriefcaseUtility } from \"./RpcBriefcaseUtility\";\r\n\r\ninterface TileRequestProps {\r\n  accessToken?: AccessToken;\r\n  tokenProps: IModelRpcProps;\r\n  treeId: string;\r\n}\r\n\r\nfunction generateTileRequestKey(props: TileRequestProps): string {\r\n  const token = props.tokenProps;\r\n  return `${JSON.stringify({\r\n    key: token.key,\r\n    iTwinId: token.iTwinId,\r\n    iModelId: token.iModelId,\r\n    changesetId: token.changeset?.id,\r\n  })}:${props.treeId}`;\r\n}\r\n\r\nabstract class TileRequestMemoizer<Result, Props extends TileRequestProps> extends PromiseMemoizer<Result> {\r\n  private readonly _loggerCategory = BackendLoggerCategory.IModelTileRequestRpc;\r\n  protected abstract get _operationName(): string;\r\n  protected abstract addMetadata(metadata: any, props: Props): void;\r\n  protected abstract stringify(props: Props): string;\r\n  protected abstract get _timeoutMilliseconds(): number;\r\n\r\n  private makeMetadata(props: Props): any {\r\n    const meta = { ...props.tokenProps };\r\n    this.addMetadata(meta, props);\r\n    return meta;\r\n  }\r\n\r\n  protected constructor(memoizeFn: (props: Props) => Promise<Result>, generateKeyFn: (props: Props) => string) {\r\n    super(memoizeFn, generateKeyFn);\r\n  }\r\n\r\n  public override memoize(props: Props): QueryablePromise<Result> {\r\n    return super.memoize(props);\r\n  }\r\n\r\n  public override deleteMemoized(props: Props) {\r\n    super.deleteMemoized(props);\r\n  }\r\n\r\n  private log(status: string, props: Props): void {\r\n    const descr = `${this._operationName}(${this.stringify(props)})`;\r\n    Logger.logTrace(this._loggerCategory, `Backend ${status} ${descr}`, () => this.makeMetadata(props));\r\n  }\r\n\r\n  protected async perform(props: Props): Promise<Result> {\r\n    this.log(\"received\", props);\r\n\r\n    const tileQP = this.memoize(props);\r\n\r\n    await BeDuration.race(this._timeoutMilliseconds, tileQP.promise).catch(() => { });\r\n    // Note: Rejections must be caught so that the memoization entry can be deleted\r\n\r\n    if (tileQP.isPending) {\r\n      this.log(\"issuing pending status for\", props);\r\n      throw new RpcPendingResponse(); // eslint-disable-line deprecation/deprecation\r\n    }\r\n\r\n    this.deleteMemoized(props);\r\n\r\n    if (tileQP.isFulfilled) {\r\n      this.log(\"completed\", props);\r\n      assert(undefined !== tileQP.result);\r\n      return tileQP.result;\r\n    }\r\n\r\n    assert(tileQP.isRejected);\r\n    this.log(\"rejected\", props);\r\n    throw tileQP.error; // eslint-disable-line no-throw-literal\r\n  }\r\n}\r\n\r\nasync function getTileTreeProps(props: TileRequestProps): Promise<IModelTileTreeProps> {\r\n  assert(undefined !== props.accessToken);\r\n  const db = await RpcBriefcaseUtility.findOpenIModel(props.accessToken, props.tokenProps);\r\n  return db.tiles.requestTileTreeProps(props.treeId);\r\n}\r\n\r\nclass RequestTileTreePropsMemoizer extends TileRequestMemoizer<IModelTileTreeProps, TileRequestProps> {\r\n  protected get _timeoutMilliseconds() { return IModelHost.tileTreeRequestTimeout; }\r\n  protected get _operationName() { return \"requestTileTreeProps\"; }\r\n  protected stringify(props: TileRequestProps): string { return props.treeId; }\r\n  protected addMetadata(meta: any, props: TileRequestProps): void {\r\n    meta.treeId = props.treeId;\r\n  }\r\n\r\n  private static _instance?: RequestTileTreePropsMemoizer;\r\n\r\n  private constructor() {\r\n    super(getTileTreeProps, generateTileRequestKey);\r\n    IModelHost.onBeforeShutdown.addOnce(() => {\r\n      this.dispose();\r\n      RequestTileTreePropsMemoizer._instance = undefined;\r\n    });\r\n  }\r\n\r\n  public static async perform(props: TileRequestProps): Promise<IModelTileTreeProps> {\r\n    if (undefined === this._instance)\r\n      this._instance = new RequestTileTreePropsMemoizer();\r\n\r\n    return this._instance.perform(props);\r\n  }\r\n}\r\n\r\ninterface TileContentRequestProps extends TileRequestProps {\r\n  contentId: string;\r\n  guid?: string;\r\n}\r\n\r\nasync function getTileContent(props: TileContentRequestProps): Promise<TileContentSource> {\r\n  assert(undefined !== props.accessToken);\r\n  const db = await RpcBriefcaseUtility.findOpenIModel(props.accessToken, props.tokenProps);\r\n  const tile = await db.tiles.requestTileContent(props.treeId, props.contentId);\r\n\r\n  // ###TODO: Verify the guid supplied by the front-end matches the guid stored in the model?\r\n  if (IModelHost.usingExternalTileCache) {\r\n    await IModelHost.tileStorage?.uploadTile(db.iModelId, db.changeset.id, props.treeId, props.contentId, tile.content, props.guid, {\r\n      backendName: IModelHost.applicationId,\r\n      tileGenerationTime: tile.elapsedSeconds.toString(),\r\n      tileSize: tile.content.byteLength.toString(),\r\n    });\r\n\r\n    return TileContentSource.ExternalCache;\r\n  }\r\n\r\n  return TileContentSource.Backend;\r\n}\r\n\r\nfunction generateTileContentKey(props: TileContentRequestProps): string {\r\n  return `${generateTileRequestKey(props)}:${props.contentId}`;\r\n}\r\n\r\nclass RequestTileContentMemoizer extends TileRequestMemoizer<TileContentSource, TileContentRequestProps> {\r\n  protected get _timeoutMilliseconds() { return IModelHost.tileContentRequestTimeout; }\r\n  protected get _operationName() { return \"requestTileContent\"; }\r\n  protected stringify(props: TileContentRequestProps): string { return `${props.treeId}:${props.contentId}`; }\r\n  protected addMetadata(meta: any, props: TileContentRequestProps): void {\r\n    meta.treeId = props.treeId;\r\n    meta.contentId = props.contentId;\r\n  }\r\n\r\n  private static _instance?: RequestTileContentMemoizer;\r\n\r\n  private constructor() {\r\n    super(getTileContent, generateTileContentKey);\r\n    IModelHost.onBeforeShutdown.addOnce(() => {\r\n      this.dispose();\r\n      RequestTileContentMemoizer._instance = undefined;\r\n    });\r\n  }\r\n\r\n  public static get instance() {\r\n    if (undefined === this._instance)\r\n      this._instance = new RequestTileContentMemoizer();\r\n\r\n    return this._instance;\r\n  }\r\n\r\n  public static async perform(props: TileContentRequestProps): Promise<TileContentSource> {\r\n    return this.instance.perform(props);\r\n  }\r\n}\r\n\r\nfunction currentActivity() {\r\n  return RpcTrace.expectCurrentActivity; // eslint-disable-line deprecation/deprecation\r\n}\r\n\r\n/** @internal */\r\nexport class IModelTileRpcImpl extends RpcInterface implements IModelTileRpcInterface { // eslint-disable-line deprecation/deprecation\r\n  public static register() { RpcManager.registerImpl(IModelTileRpcInterface, IModelTileRpcImpl); }\r\n\r\n  public async requestTileTreeProps(tokenProps: IModelRpcProps, treeId: string): Promise<IModelTileTreeProps> {\r\n    return RequestTileTreePropsMemoizer.perform({ accessToken: currentActivity().accessToken, tokenProps, treeId });\r\n  }\r\n\r\n  public async purgeTileTrees(tokenProps: IModelRpcProps, modelIds: Id64Array | undefined): Promise<void> {\r\n    // `undefined` gets forwarded as `null`...\r\n    if (null === modelIds)\r\n      modelIds = undefined;\r\n\r\n    const db = await RpcBriefcaseUtility.findOpenIModel(currentActivity().accessToken, tokenProps);\r\n    return db.nativeDb.purgeTileTrees(modelIds);\r\n  }\r\n\r\n  public async generateTileContent(tokenProps: IModelRpcProps, treeId: string, contentId: string, guid: string | undefined): Promise<TileContentSource> {\r\n    return RequestTileContentMemoizer.perform({ accessToken: currentActivity().accessToken, tokenProps, treeId, contentId, guid });\r\n  }\r\n\r\n  public async retrieveTileContent(tokenProps: IModelRpcProps, key: TileContentIdentifier): Promise<Uint8Array> {\r\n    const db = await RpcBriefcaseUtility.findOpenIModel(currentActivity().accessToken, tokenProps);\r\n    return db.tiles.getTileContent(key.treeId, key.contentId);\r\n  }\r\n\r\n  public async getTileCacheConfig(tokenProps: IModelRpcProps): Promise<TransferConfig | undefined> {\r\n    if (IModelHost.tileStorage === undefined)\r\n      return undefined;\r\n    const iModelId = tokenProps.iModelId ?? (await RpcBriefcaseUtility.findOpenIModel(currentActivity().accessToken, tokenProps)).iModelId;\r\n    return IModelHost.tileStorage.getDownloadConfig(iModelId);\r\n  }\r\n\r\n  /* eslint-disable deprecation/deprecation */\r\n  public async getTileCacheContainerUrl(_tokenProps: IModelRpcProps, id: CloudStorageContainerDescriptor): Promise<CloudStorageContainerUrl> {\r\n    const invocation = RpcInvocation.current(this);\r\n\r\n    if (!IModelHost.usingExternalTileCache) {\r\n      return CloudStorageContainerUrl.empty();\r\n    }\r\n\r\n    const expiry = CloudStorageTileCache.getCache().supplyExpiryForContainerUrl(id);\r\n    const clientIp = (IModelHost.restrictTileUrlsByClientIp && invocation.request.ip) ? invocation.request.ip : undefined;\r\n    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\r\n    return IModelHost.tileCacheService!.obtainContainerUrl(id, expiry, clientIp);\r\n  }\r\n\r\n  public async isUsingExternalTileCache(): Promise<boolean> { // eslint-disable-line @itwin/prefer-get\r\n    return IModelHost.tileCacheService !== undefined;\r\n  }\r\n  /* eslint-enable deprecation/deprecation */\r\n\r\n  public async queryVersionInfo(): Promise<TileVersionInfo> {\r\n    return IModelHost.platform.getTileVersionInfo();\r\n  }\r\n\r\n  /** @internal */\r\n  public async requestElementGraphics(rpcProps: IModelRpcProps, request: ElementGraphicsRequestProps): Promise<Uint8Array | undefined> {\r\n    const iModel = await RpcBriefcaseUtility.findOpenIModel(currentActivity().accessToken, rpcProps);\r\n    return iModel.generateElementGraphics(request);\r\n  }\r\n}\r\n\r\n/** @internal */\r\nexport async function cancelTileContentRequests(tokenProps: IModelRpcProps, contentIds: TileTreeContentIds[]): Promise<void> {\r\n  const iModel = IModelDb.findByKey(tokenProps.key);\r\n  const props: TileContentRequestProps = { tokenProps, treeId: \"\", contentId: \"\" };\r\n\r\n  for (const entry of contentIds) {\r\n    props.treeId = entry.treeId;\r\n    for (const contentId of entry.contentIds) {\r\n      props.contentId = contentId;\r\n      RequestTileContentMemoizer.instance.deleteMemoized(props);\r\n    }\r\n\r\n    iModel.nativeDb.cancelTileContentRequests(entry.treeId, entry.contentIds);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"IModelTileRpcImpl.js","sourceRoot":"","sources":["../../../src/rpc-impl/IModelTileRpcImpl.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAGH,sDAAyF;AACzF,oDAI4B;AAC5B,oEAAiE;AACjE,0CAAuC;AACvC,8CAA2C;AAC3C,wDAAuE;AACvE,4CAA0C;AAC1C,+DAA4D;AAQ5D,SAAS,sBAAsB,CAAC,KAAuB;IACrD,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC;IAC/B,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC;QACvB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,WAAW,EAAE,KAAK,CAAC,SAAS,EAAE,EAAE;KACjC,CAAC,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;AACvB,CAAC;AAED,MAAe,mBAA4D,SAAQ,iCAAuB;IAOhG,YAAY,CAAC,KAAY;QAC/B,MAAM,IAAI,GAAG,EAAE,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC;QACrC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,YAAsB,SAA4C,EAAE,aAAuC;QACzG,KAAK,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QAbjB,oBAAe,GAAG,6CAAqB,CAAC,oBAAoB,CAAC;IAc9E,CAAC;IAEe,OAAO,CAAC,KAAY;QAClC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAEe,cAAc,CAAC,KAAY;QACzC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAEO,GAAG,CAAC,MAAc,EAAE,KAAY;QACtC,MAAM,KAAK,GAAG,GAAG,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC;QACjE,qBAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,eAAe,EAAE,WAAW,MAAM,IAAI,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;IACtG,CAAC;IAES,KAAK,CAAC,OAAO,CAAC,KAAY;QAClC,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAE5B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAEnC,MAAM,yBAAU,CAAC,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;QAClF,+EAA+E;QAE/E,IAAI,MAAM,CAAC,SAAS,EAAE;YACpB,IAAI,CAAC,GAAG,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;YAC9C,MAAM,IAAI,gCAAkB,EAAE,CAAC,CAAC,8CAA8C;SAC/E;QAED,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAE3B,IAAI,MAAM,CAAC,WAAW,EAAE;YACtB,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YAC7B,IAAA,qBAAM,EAAC,SAAS,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC;YACpC,OAAO,MAAM,CAAC,MAAM,CAAC;SACtB;QAED,IAAA,qBAAM,EAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC1B,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAC5B,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC,uCAAuC;IAC7D,CAAC;CACF;AAED,KAAK,UAAU,gBAAgB,CAAC,KAAuB;IACrD,IAAA,qBAAM,EAAC,SAAS,KAAK,KAAK,CAAC,WAAW,CAAC,CAAC;IACxC,MAAM,EAAE,GAAG,MAAM,yCAAmB,CAAC,cAAc,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IACzF,OAAO,EAAE,CAAC,KAAK,CAAC,oBAAoB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,4BAA6B,SAAQ,mBAA0D;IACnG,IAAc,oBAAoB,KAAK,OAAO,uBAAU,CAAC,sBAAsB,CAAC,CAAC,CAAC;IAClF,IAAc,cAAc,KAAK,OAAO,sBAAsB,CAAC,CAAC,CAAC;IACvD,SAAS,CAAC,KAAuB,IAAY,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACnE,WAAW,CAAC,IAAS,EAAE,KAAuB;QACtD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC7B,CAAC;IAID;QACE,KAAK,CAAC,gBAAgB,EAAE,sBAAsB,CAAC,CAAC;QAChD,uBAAU,CAAC,gBAAgB,CAAC,OAAO,CAAC,GAAG,EAAE;YACvC,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,4BAA4B,CAAC,SAAS,GAAG,SAAS,CAAC;QACrD,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,KAAuB;QACjD,IAAI,SAAS,KAAK,IAAI,CAAC,SAAS;YAC9B,IAAI,CAAC,SAAS,GAAG,IAAI,4BAA4B,EAAE,CAAC;QAEtD,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;CACF;AAOD,KAAK,UAAU,cAAc,CAAC,KAA8B;IAC1D,IAAA,qBAAM,EAAC,SAAS,KAAK,KAAK,CAAC,WAAW,CAAC,CAAC;IACxC,MAAM,EAAE,GAAG,MAAM,yCAAmB,CAAC,cAAc,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IACzF,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,kBAAkB,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAE9E,2FAA2F;IAC3F,IAAI,uBAAU,CAAC,sBAAsB,EAAE;QACrC,MAAM,uBAAU,CAAC,WAAW,EAAE,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE;YAC9H,WAAW,EAAE,uBAAU,CAAC,aAAa;YACrC,kBAAkB,EAAE,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE;YAClD,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,EAAE;SAC7C,CAAC,CAAC;QAEH,OAAO,+BAAiB,CAAC,aAAa,CAAC;KACxC;IAED,OAAO,+BAAiB,CAAC,OAAO,CAAC;AACnC,CAAC;AAED,SAAS,sBAAsB,CAAC,KAA8B;IAC5D,OAAO,GAAG,sBAAsB,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;AAC/D,CAAC;AAED,MAAM,0BAA2B,SAAQ,mBAA+D;IACtG,IAAc,oBAAoB,KAAK,OAAO,uBAAU,CAAC,yBAAyB,CAAC,CAAC,CAAC;IACrF,IAAc,cAAc,KAAK,OAAO,oBAAoB,CAAC,CAAC,CAAC;IACrD,SAAS,CAAC,KAA8B,IAAY,OAAO,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IAClG,WAAW,CAAC,IAAS,EAAE,KAA8B;QAC7D,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;IACnC,CAAC;IAID;QACE,KAAK,CAAC,cAAc,EAAE,sBAAsB,CAAC,CAAC;QAC9C,uBAAU,CAAC,gBAAgB,CAAC,OAAO,CAAC,GAAG,EAAE;YACvC,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,0BAA0B,CAAC,SAAS,GAAG,SAAS,CAAC;QACnD,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,MAAM,KAAK,QAAQ;QACxB,IAAI,SAAS,KAAK,IAAI,CAAC,SAAS;YAC9B,IAAI,CAAC,SAAS,GAAG,IAAI,0BAA0B,EAAE,CAAC;QAEpD,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,KAA8B;QACxD,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;CACF;AAED,SAAS,eAAe;IACtB,OAAO,kBAAQ,CAAC,qBAAqB,CAAC,CAAC,8CAA8C;AACvF,CAAC;AAED,gBAAgB;AAChB,MAAa,iBAAkB,SAAQ,0BAAY;IAC1C,MAAM,CAAC,QAAQ,KAAK,wBAAU,CAAC,YAAY,CAAC,oCAAsB,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAEzF,KAAK,CAAC,oBAAoB,CAAC,UAA0B,EAAE,MAAc;QAC1E,OAAO,4BAA4B,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;IAClH,CAAC;IAEM,KAAK,CAAC,cAAc,CAAC,UAA0B,EAAE,QAA+B;QACrF,0CAA0C;QAC1C,IAAI,IAAI,KAAK,QAAQ;YACnB,QAAQ,GAAG,SAAS,CAAC;QAEvB,MAAM,EAAE,GAAG,MAAM,yCAAmB,CAAC,cAAc,CAAC,eAAe,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QAC/F,OAAO,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAEM,KAAK,CAAC,mBAAmB,CAAC,UAA0B,EAAE,MAAc,EAAE,SAAiB,EAAE,IAAwB;QACtH,OAAO,0BAA0B,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACjI,CAAC;IAEM,KAAK,CAAC,mBAAmB,CAAC,UAA0B,EAAE,GAA0B;QACrF,MAAM,EAAE,GAAG,MAAM,yCAAmB,CAAC,cAAc,CAAC,eAAe,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QAC/F,OAAO,EAAE,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;IAC5D,CAAC;IAEM,KAAK,CAAC,kBAAkB,CAAC,UAA0B;QACxD,IAAI,uBAAU,CAAC,WAAW,KAAK,SAAS;YACtC,OAAO,SAAS,CAAC;QACnB,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,IAAI,CAAC,MAAM,yCAAmB,CAAC,cAAc,CAAC,eAAe,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC;QACvI,OAAO,uBAAU,CAAC,WAAW,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC5D,CAAC;IAED,4CAA4C;IACrC,KAAK,CAAC,wBAAwB,CAAC,WAA2B,EAAE,EAAmC;QACpG,MAAM,UAAU,GAAG,2BAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAE/C,IAAI,CAAC,uBAAU,CAAC,sBAAsB,EAAE;YACtC,OAAO,sCAAwB,CAAC,KAAK,EAAE,CAAC;SACzC;QAED,MAAM,MAAM,GAAG,mCAAqB,CAAC,QAAQ,EAAE,CAAC,2BAA2B,CAAC,EAAE,CAAC,CAAC;QAChF,MAAM,QAAQ,GAAG,CAAC,uBAAU,CAAC,0BAA0B,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACtH,oEAAoE;QACpE,OAAO,uBAAU,CAAC,gBAAiB,CAAC,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC/E,CAAC;IAEM,KAAK,CAAC,wBAAwB;QACnC,OAAO,uBAAU,CAAC,gBAAgB,KAAK,SAAS,CAAC;IACnD,CAAC;IACD,2CAA2C;IAEpC,KAAK,CAAC,gBAAgB;QAC3B,OAAO,uBAAU,CAAC,QAAQ,CAAC,kBAAkB,EAAE,CAAC;IAClD,CAAC;IAED,gBAAgB;IACT,KAAK,CAAC,sBAAsB,CAAC,QAAwB,EAAE,OAAoC;QAChG,MAAM,MAAM,GAAG,MAAM,yCAAmB,CAAC,cAAc,CAAC,eAAe,EAAE,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QACjG,OAAO,MAAM,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACjD,CAAC;CACF;AA5DD,8CA4DC;AAED,gBAAgB;AACT,KAAK,UAAU,yBAAyB,CAAC,UAA0B,EAAE,UAAgC;IAC1G,MAAM,MAAM,GAAG,mBAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAClD,MAAM,KAAK,GAA4B,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAEjF,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE;QAC9B,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC5B,KAAK,MAAM,SAAS,IAAI,KAAK,CAAC,UAAU,EAAE;YACxC,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;YAC5B,0BAA0B,CAAC,QAAQ,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;SAC3D;QAED,MAAM,CAAC,QAAQ,CAAC,yBAAyB,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;KAC3E;AACH,CAAC;AAbD,8DAaC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module RpcInterface\r\n */\r\n\r\nimport type { TransferConfig } from \"@itwin/object-storage-core\";\r\nimport { AccessToken, assert, BeDuration, Id64Array, Logger } from \"@itwin/core-bentley\";\r\nimport {\r\n  CloudStorageContainerDescriptor, CloudStorageContainerUrl, CloudStorageTileCache, ElementGraphicsRequestProps, IModelRpcProps,\r\n  IModelTileRpcInterface, IModelTileTreeProps, RpcInterface, RpcInvocation, RpcManager, RpcPendingResponse, TileContentIdentifier,\r\n  TileContentSource, TileTreeContentIds, TileVersionInfo,\r\n} from \"@itwin/core-common\";\r\nimport { BackendLoggerCategory } from \"../BackendLoggerCategory\";\r\nimport { IModelDb } from \"../IModelDb\";\r\nimport { IModelHost } from \"../IModelHost\";\r\nimport { PromiseMemoizer, QueryablePromise } from \"../PromiseMemoizer\";\r\nimport { RpcTrace } from \"../rpc/tracing\";\r\nimport { RpcBriefcaseUtility } from \"./RpcBriefcaseUtility\";\r\n\r\ninterface TileRequestProps {\r\n  accessToken?: AccessToken;\r\n  tokenProps: IModelRpcProps;\r\n  treeId: string;\r\n}\r\n\r\nfunction generateTileRequestKey(props: TileRequestProps): string {\r\n  const token = props.tokenProps;\r\n  return `${JSON.stringify({\r\n    key: token.key,\r\n    iTwinId: token.iTwinId,\r\n    iModelId: token.iModelId,\r\n    changesetId: token.changeset?.id,\r\n  })}:${props.treeId}`;\r\n}\r\n\r\nabstract class TileRequestMemoizer<Result, Props extends TileRequestProps> extends PromiseMemoizer<Result> {\r\n  private readonly _loggerCategory = BackendLoggerCategory.IModelTileRequestRpc;\r\n  protected abstract get _operationName(): string;\r\n  protected abstract addMetadata(metadata: any, props: Props): void;\r\n  protected abstract stringify(props: Props): string;\r\n  protected abstract get _timeoutMilliseconds(): number;\r\n\r\n  private makeMetadata(props: Props): any {\r\n    const meta = { ...props.tokenProps };\r\n    this.addMetadata(meta, props);\r\n    return meta;\r\n  }\r\n\r\n  protected constructor(memoizeFn: (props: Props) => Promise<Result>, generateKeyFn: (props: Props) => string) {\r\n    super(memoizeFn, generateKeyFn);\r\n  }\r\n\r\n  public override memoize(props: Props): QueryablePromise<Result> {\r\n    return super.memoize(props);\r\n  }\r\n\r\n  public override deleteMemoized(props: Props) {\r\n    super.deleteMemoized(props);\r\n  }\r\n\r\n  private log(status: string, props: Props): void {\r\n    const descr = `${this._operationName}(${this.stringify(props)})`;\r\n    Logger.logTrace(this._loggerCategory, `Backend ${status} ${descr}`, () => this.makeMetadata(props));\r\n  }\r\n\r\n  protected async perform(props: Props): Promise<Result> {\r\n    this.log(\"received\", props);\r\n\r\n    const tileQP = this.memoize(props);\r\n\r\n    await BeDuration.race(this._timeoutMilliseconds, tileQP.promise).catch(() => { });\r\n    // Note: Rejections must be caught so that the memoization entry can be deleted\r\n\r\n    if (tileQP.isPending) {\r\n      this.log(\"issuing pending status for\", props);\r\n      throw new RpcPendingResponse(); // eslint-disable-line deprecation/deprecation\r\n    }\r\n\r\n    this.deleteMemoized(props);\r\n\r\n    if (tileQP.isFulfilled) {\r\n      this.log(\"completed\", props);\r\n      assert(undefined !== tileQP.result);\r\n      return tileQP.result;\r\n    }\r\n\r\n    assert(tileQP.isRejected);\r\n    this.log(\"rejected\", props);\r\n    throw tileQP.error; // eslint-disable-line no-throw-literal\r\n  }\r\n}\r\n\r\nasync function getTileTreeProps(props: TileRequestProps): Promise<IModelTileTreeProps> {\r\n  assert(undefined !== props.accessToken);\r\n  const db = await RpcBriefcaseUtility.findOpenIModel(props.accessToken, props.tokenProps);\r\n  return db.tiles.requestTileTreeProps(props.treeId);\r\n}\r\n\r\nclass RequestTileTreePropsMemoizer extends TileRequestMemoizer<IModelTileTreeProps, TileRequestProps> {\r\n  protected get _timeoutMilliseconds() { return IModelHost.tileTreeRequestTimeout; }\r\n  protected get _operationName() { return \"requestTileTreeProps\"; }\r\n  protected stringify(props: TileRequestProps): string { return props.treeId; }\r\n  protected addMetadata(meta: any, props: TileRequestProps): void {\r\n    meta.treeId = props.treeId;\r\n  }\r\n\r\n  private static _instance?: RequestTileTreePropsMemoizer;\r\n\r\n  private constructor() {\r\n    super(getTileTreeProps, generateTileRequestKey);\r\n    IModelHost.onBeforeShutdown.addOnce(() => {\r\n      this.dispose();\r\n      RequestTileTreePropsMemoizer._instance = undefined;\r\n    });\r\n  }\r\n\r\n  public static async perform(props: TileRequestProps): Promise<IModelTileTreeProps> {\r\n    if (undefined === this._instance)\r\n      this._instance = new RequestTileTreePropsMemoizer();\r\n\r\n    return this._instance.perform(props);\r\n  }\r\n}\r\n\r\ninterface TileContentRequestProps extends TileRequestProps {\r\n  contentId: string;\r\n  guid?: string;\r\n}\r\n\r\nasync function getTileContent(props: TileContentRequestProps): Promise<TileContentSource> {\r\n  assert(undefined !== props.accessToken);\r\n  const db = await RpcBriefcaseUtility.findOpenIModel(props.accessToken, props.tokenProps);\r\n  const tile = await db.tiles.requestTileContent(props.treeId, props.contentId);\r\n\r\n  // ###TODO: Verify the guid supplied by the front-end matches the guid stored in the model?\r\n  if (IModelHost.usingExternalTileCache) {\r\n    await IModelHost.tileStorage?.uploadTile(db.iModelId, db.changeset.id, props.treeId, props.contentId, tile.content, props.guid, {\r\n      backendName: IModelHost.applicationId,\r\n      tileGenerationTime: tile.elapsedSeconds.toString(),\r\n      tileSize: tile.content.byteLength.toString(),\r\n    });\r\n\r\n    return TileContentSource.ExternalCache;\r\n  }\r\n\r\n  return TileContentSource.Backend;\r\n}\r\n\r\nfunction generateTileContentKey(props: TileContentRequestProps): string {\r\n  return `${generateTileRequestKey(props)}:${props.contentId}`;\r\n}\r\n\r\nclass RequestTileContentMemoizer extends TileRequestMemoizer<TileContentSource, TileContentRequestProps> {\r\n  protected get _timeoutMilliseconds() { return IModelHost.tileContentRequestTimeout; }\r\n  protected get _operationName() { return \"requestTileContent\"; }\r\n  protected stringify(props: TileContentRequestProps): string { return `${props.treeId}:${props.contentId}`; }\r\n  protected addMetadata(meta: any, props: TileContentRequestProps): void {\r\n    meta.treeId = props.treeId;\r\n    meta.contentId = props.contentId;\r\n  }\r\n\r\n  private static _instance?: RequestTileContentMemoizer;\r\n\r\n  private constructor() {\r\n    super(getTileContent, generateTileContentKey);\r\n    IModelHost.onBeforeShutdown.addOnce(() => {\r\n      this.dispose();\r\n      RequestTileContentMemoizer._instance = undefined;\r\n    });\r\n  }\r\n\r\n  public static get instance() {\r\n    if (undefined === this._instance)\r\n      this._instance = new RequestTileContentMemoizer();\r\n\r\n    return this._instance;\r\n  }\r\n\r\n  public static async perform(props: TileContentRequestProps): Promise<TileContentSource> {\r\n    return this.instance.perform(props);\r\n  }\r\n}\r\n\r\nfunction currentActivity() {\r\n  return RpcTrace.expectCurrentActivity; // eslint-disable-line deprecation/deprecation\r\n}\r\n\r\n/** @internal */\r\nexport class IModelTileRpcImpl extends RpcInterface implements IModelTileRpcInterface { // eslint-disable-line deprecation/deprecation\r\n  public static register() { RpcManager.registerImpl(IModelTileRpcInterface, IModelTileRpcImpl); }\r\n\r\n  public async requestTileTreeProps(tokenProps: IModelRpcProps, treeId: string): Promise<IModelTileTreeProps> {\r\n    return RequestTileTreePropsMemoizer.perform({ accessToken: currentActivity().accessToken, tokenProps, treeId });\r\n  }\r\n\r\n  public async purgeTileTrees(tokenProps: IModelRpcProps, modelIds: Id64Array | undefined): Promise<void> {\r\n    // `undefined` gets forwarded as `null`...\r\n    if (null === modelIds)\r\n      modelIds = undefined;\r\n\r\n    const db = await RpcBriefcaseUtility.findOpenIModel(currentActivity().accessToken, tokenProps);\r\n    return db.nativeDb.purgeTileTrees(modelIds);\r\n  }\r\n\r\n  public async generateTileContent(tokenProps: IModelRpcProps, treeId: string, contentId: string, guid: string | undefined): Promise<TileContentSource> {\r\n    return RequestTileContentMemoizer.perform({ accessToken: currentActivity().accessToken, tokenProps, treeId, contentId, guid });\r\n  }\r\n\r\n  public async retrieveTileContent(tokenProps: IModelRpcProps, key: TileContentIdentifier): Promise<Uint8Array> {\r\n    const db = await RpcBriefcaseUtility.findOpenIModel(currentActivity().accessToken, tokenProps);\r\n    return db.tiles.getTileContent(key.treeId, key.contentId);\r\n  }\r\n\r\n  public async getTileCacheConfig(tokenProps: IModelRpcProps): Promise<TransferConfig | undefined> {\r\n    if (IModelHost.tileStorage === undefined)\r\n      return undefined;\r\n    const iModelId = tokenProps.iModelId ?? (await RpcBriefcaseUtility.findOpenIModel(currentActivity().accessToken, tokenProps)).iModelId;\r\n    return IModelHost.tileStorage.getDownloadConfig(iModelId);\r\n  }\r\n\r\n  /* eslint-disable deprecation/deprecation */\r\n  public async getTileCacheContainerUrl(_tokenProps: IModelRpcProps, id: CloudStorageContainerDescriptor): Promise<CloudStorageContainerUrl> {\r\n    const invocation = RpcInvocation.current(this);\r\n\r\n    if (!IModelHost.usingExternalTileCache) {\r\n      return CloudStorageContainerUrl.empty();\r\n    }\r\n\r\n    const expiry = CloudStorageTileCache.getCache().supplyExpiryForContainerUrl(id);\r\n    const clientIp = (IModelHost.restrictTileUrlsByClientIp && invocation.request.ip) ? invocation.request.ip : undefined;\r\n    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\r\n    return IModelHost.tileCacheService!.obtainContainerUrl(id, expiry, clientIp);\r\n  }\r\n\r\n  public async isUsingExternalTileCache(): Promise<boolean> { // eslint-disable-line @itwin/prefer-get\r\n    return IModelHost.tileCacheService !== undefined;\r\n  }\r\n  /* eslint-enable deprecation/deprecation */\r\n\r\n  public async queryVersionInfo(): Promise<TileVersionInfo> {\r\n    return IModelHost.platform.getTileVersionInfo();\r\n  }\r\n\r\n  /** @internal */\r\n  public async requestElementGraphics(rpcProps: IModelRpcProps, request: ElementGraphicsRequestProps): Promise<Uint8Array | undefined> {\r\n    const iModel = await RpcBriefcaseUtility.findOpenIModel(currentActivity().accessToken, rpcProps);\r\n    return iModel.generateElementGraphics(request);\r\n  }\r\n}\r\n\r\n/** @internal */\r\nexport async function cancelTileContentRequests(tokenProps: IModelRpcProps, contentIds: TileTreeContentIds[]): Promise<void> {\r\n  const iModel = IModelDb.findByKey(tokenProps.key);\r\n  const props: TileContentRequestProps = { tokenProps, treeId: \"\", contentId: \"\" };\r\n\r\n  for (const entry of contentIds) {\r\n    props.treeId = entry.treeId;\r\n    for (const contentId of entry.contentIds) {\r\n      props.contentId = contentId;\r\n      RequestTileContentMemoizer.instance.deleteMemoized(props);\r\n    }\r\n\r\n    iModel.nativeDb.cancelTileContentRequests(entry.treeId, entry.contentIds);\r\n  }\r\n}\r\n"]}

package/lib/cjs/rpc-impl/RpcBriefcaseUtility.d.ts

@@ -1,37 +1,37 @@
-/** @packageDocumentation
- * @module RpcInterface
- */
-import { AccessToken } from "@itwin/core-bentley";
-import { BriefcaseProps, IModelConnectionProps, IModelRpcOpenProps, IModelRpcProps, RpcActivity, SyncMode } from "@itwin/core-common";
-import { IModelDb } from "../IModelDb";
-/** @internal */
-export interface DownloadAndOpenArgs {
-    activity: RpcActivity;
-    tokenProps: IModelRpcOpenProps;
-    syncMode: SyncMode;
-    fileNameResolvers?: ((arg: BriefcaseProps) => string)[];
-    timeout?: number;
-    forceDownload?: boolean;
-}
-/**
- * Utility to open the iModel for RPC interfaces
- * @internal
- */
-export declare class RpcBriefcaseUtility {
-    private static downloadAndOpen;
-    private static _briefcasePromise;
-    private static openBriefcase;
-    /** find a previously opened iModel for RPC.
-     * @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
-     * to refresh the daemon, even though it will be used for all authorized users.
-     * @param the IModelRpcProps to locate the opened iModel.
-     */
-    static findOpenIModel(accessToken: AccessToken, iModel: IModelRpcProps): Promise<IModelDb>;
-    /**
-     * Download and open a checkpoint or briefcase, ensuring the operation completes within a default timeout. If the time to open exceeds the timeout period,
-     * a RpcPendingResponse exception is thrown
-     */
-    static open(args: DownloadAndOpenArgs): Promise<IModelDb>;
-    static openWithTimeout(activity: RpcActivity, tokenProps: IModelRpcOpenProps, syncMode: SyncMode, timeout?: number): Promise<IModelConnectionProps>;
-}
+/** @packageDocumentation
+ * @module RpcInterface
+ */
+import { AccessToken } from "@itwin/core-bentley";
+import { BriefcaseProps, IModelConnectionProps, IModelRpcOpenProps, IModelRpcProps, RpcActivity, SyncMode } from "@itwin/core-common";
+import { IModelDb } from "../IModelDb";
+/** @internal */
+export interface DownloadAndOpenArgs {
+    activity: RpcActivity;
+    tokenProps: IModelRpcOpenProps;
+    syncMode: SyncMode;
+    fileNameResolvers?: ((arg: BriefcaseProps) => string)[];
+    timeout?: number;
+    forceDownload?: boolean;
+}
+/**
+ * Utility to open the iModel for RPC interfaces
+ * @internal
+ */
+export declare class RpcBriefcaseUtility {
+    private static downloadAndOpen;
+    private static _briefcasePromise;
+    private static openBriefcase;
+    /** find a previously opened iModel for RPC.
+     * @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
+     * to refresh the daemon, even though it will be used for all authorized users.
+     * @param the IModelRpcProps to locate the opened iModel.
+     */
+    static findOpenIModel(accessToken: AccessToken, iModel: IModelRpcProps): Promise<IModelDb>;
+    /**
+     * Download and open a checkpoint or briefcase, ensuring the operation completes within a default timeout. If the time to open exceeds the timeout period,
+     * a RpcPendingResponse exception is thrown
+     */
+    static open(args: DownloadAndOpenArgs): Promise<IModelDb>;
+    static openWithTimeout(activity: RpcActivity, tokenProps: IModelRpcOpenProps, syncMode: SyncMode, timeout?: number): Promise<IModelConnectionProps>;
+}
 //# sourceMappingURL=RpcBriefcaseUtility.d.ts.map

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

@@ -1,167 +1,167 @@
-"use strict";
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module RpcInterface
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RpcBriefcaseUtility = void 0;
-const core_bentley_1 = require("@itwin/core-bentley");
-const core_common_1 = require("@itwin/core-common");
-const BackendLoggerCategory_1 = require("../BackendLoggerCategory");
-const BriefcaseManager_1 = require("../BriefcaseManager");
-const CheckpointManager_1 = require("../CheckpointManager");
-const IModelDb_1 = require("../IModelDb");
-const IModelHost_1 = require("../IModelHost");
-const IModelJsFs_1 = require("../IModelJsFs");
-const loggerCategory = BackendLoggerCategory_1.BackendLoggerCategory.IModelDb;
-/**
- * Utility to open the iModel for RPC interfaces
- * @internal
- */
-class RpcBriefcaseUtility {
-    static async downloadAndOpen(args) {
-        const { activity, tokenProps } = args;
-        const accessToken = activity.accessToken;
-        (0, core_bentley_1.assert)(undefined !== tokenProps.iModelId);
-        const iModelId = tokenProps.iModelId;
-        let myBriefcaseIds;
-        if (args.syncMode === core_common_1.SyncMode.PullOnly) {
-            myBriefcaseIds = [0]; // PullOnly means briefcaseId 0
-        }
-        else {
-            // check with iModelHub and see if we already have acquired any briefcaseIds
-            myBriefcaseIds = await IModelHost_1.IModelHost.hubAccess.getMyBriefcaseIds({ accessToken, iModelId });
-        }
-        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) {
-                for (const briefcaseId of myBriefcaseIds) {
-                    const fileName = resolver({ briefcaseId, iModelId });
-                    if (IModelJsFs_1.IModelJsFs.existsSync(fileName)) {
-                        const briefcaseDb = IModelDb_1.BriefcaseDb.findByFilename(fileName);
-                        if (briefcaseDb !== undefined)
-                            return briefcaseDb;
-                        try {
-                            if (args.forceDownload)
-                                throw new Error(); // causes delete below
-                            const db = await IModelDb_1.BriefcaseDb.open({ fileName });
-                            if (db.changeset.id !== tokenProps.changeset?.id) {
-                                (0, core_bentley_1.assert)(undefined !== tokenProps.changeset);
-                                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;
-                        }
-                        catch (error) {
-                            if (!(error.errorNumber === core_bentley_1.IModelStatus.AlreadyOpen))
-                                // somehow we have this briefcaseId and the file exists, but we can't open it. Delete it.
-                                await BriefcaseManager_1.BriefcaseManager.deleteBriefcaseFiles(fileName, accessToken);
-                        }
-                    }
-                }
-            }
-        }
-        // no local briefcase available. Download one and open it.
-        (0, core_bentley_1.assert)(undefined !== tokenProps.iTwinId);
-        const request = {
-            accessToken,
-            iTwinId: tokenProps.iTwinId,
-            iModelId,
-            briefcaseId: args.syncMode === core_common_1.SyncMode.PullOnly ? 0 : undefined, // if briefcaseId is undefined, we'll acquire a new one.
-        };
-        const props = await BriefcaseManager_1.BriefcaseManager.downloadBriefcase(request);
-        return IModelDb_1.BriefcaseDb.open(props);
-    }
-    static async openBriefcase(args) {
-        if (this._briefcasePromise)
-            return this._briefcasePromise;
-        try {
-            this._briefcasePromise = this.downloadAndOpen(args); // save the fact that we're working on downloading so if we timeout, we'll reuse this request.
-            return await this._briefcasePromise;
-        }
-        finally {
-            this._briefcasePromise = undefined; // the download and open is now done
-        }
-    }
-    /** find a previously opened iModel for RPC.
-     * @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
-     * to refresh the daemon, even though it will be used for all authorized users.
-     * @param the IModelRpcProps to locate the opened iModel.
-     */
-    static async findOpenIModel(accessToken, iModel) {
-        const iModelDb = IModelDb_1.IModelDb.findByKey(iModel.key);
-        // call refreshContainerSas, just in case this is a V2 checkpoint whose sasToken is about to expire.
-        await iModelDb.refreshContainerSas(accessToken);
-        return iModelDb;
-    }
-    /**
-     * Download and open a checkpoint or briefcase, ensuring the operation completes within a default timeout. If the time to open exceeds the timeout period,
-     * a RpcPendingResponse exception is thrown
-     */
-    static async open(args) {
-        const { activity, tokenProps, syncMode } = args;
-        core_bentley_1.Logger.logTrace(loggerCategory, "RpcBriefcaseUtility.open", () => ({ ...tokenProps }));
-        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) {
-                core_bentley_1.Logger.logTrace(loggerCategory, "Open briefcase - pending", () => ({ ...tokenProps }));
-                throw new core_common_1.RpcPendingResponse(); // eslint-disable-line deprecation/deprecation
-            }
-            // note: usage is logged in the function BriefcaseManager.downloadNewBriefcaseAndOpen
-            return briefcaseDb;
-        }
-        (0, core_bentley_1.assert)(undefined !== tokenProps.iModelId);
-        (0, core_bentley_1.assert)(undefined !== tokenProps.iTwinId);
-        (0, core_bentley_1.assert)(undefined !== tokenProps.changeset);
-        const checkpoint = {
-            iModelId: tokenProps.iModelId,
-            iTwinId: tokenProps.iTwinId,
-            changeset: tokenProps.changeset,
-            accessToken: activity.accessToken,
-        };
-        // opening a checkpoint, readonly.
-        let db;
-        // first check if it's already open
-        db = IModelDb_1.SnapshotDb.tryFindByKey(CheckpointManager_1.CheckpointManager.getKey(checkpoint));
-        if (db) {
-            core_bentley_1.Logger.logTrace(loggerCategory, "Checkpoint was already open", () => ({ ...tokenProps }));
-            BriefcaseManager_1.BriefcaseManager.logUsage(db);
-            return db;
-        }
-        try {
-            // now try V2 checkpoint
-            db = await IModelDb_1.SnapshotDb.openCheckpointV2(checkpoint);
-            core_bentley_1.Logger.logTrace(loggerCategory, "using V2 checkpoint briefcase", () => ({ ...tokenProps }));
-        }
-        catch (e) {
-            core_bentley_1.Logger.logTrace(loggerCategory, "unable to open V2 checkpoint - falling back to V1 checkpoint", () => ({ error: core_bentley_1.BentleyError.getErrorProps(e), ...tokenProps }));
-            // 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.
-            const request = {
-                checkpoint,
-                localFile: CheckpointManager_1.V1CheckpointManager.getFileName(checkpoint),
-                aliasFiles: [],
-            };
-            db = await core_bentley_1.BeDuration.race(timeout, CheckpointManager_1.V1CheckpointManager.getCheckpointDb(request));
-            if (db === undefined) {
-                core_bentley_1.Logger.logTrace(loggerCategory, "Open V1 checkpoint - pending", () => ({ ...tokenProps }));
-                throw new core_common_1.RpcPendingResponse(); // eslint-disable-line deprecation/deprecation
-            }
-            core_bentley_1.Logger.logTrace(loggerCategory, "Opened V1 checkpoint", () => ({ ...tokenProps }));
-        }
-        BriefcaseManager_1.BriefcaseManager.logUsage(db, activity);
-        return db;
-    }
-    static async openWithTimeout(activity, tokenProps, syncMode, timeout = 1000) {
-        if (tokenProps.iModelId)
-            await IModelHost_1.IModelHost.tileStorage?.initialize(tokenProps.iModelId);
-        return (await this.open({ activity, tokenProps, syncMode, timeout })).toJSON();
-    }
-}
-exports.RpcBriefcaseUtility = RpcBriefcaseUtility;
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module RpcInterface
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RpcBriefcaseUtility = void 0;
+const core_bentley_1 = require("@itwin/core-bentley");
+const core_common_1 = require("@itwin/core-common");
+const BackendLoggerCategory_1 = require("../BackendLoggerCategory");
+const BriefcaseManager_1 = require("../BriefcaseManager");
+const CheckpointManager_1 = require("../CheckpointManager");
+const IModelDb_1 = require("../IModelDb");
+const IModelHost_1 = require("../IModelHost");
+const IModelJsFs_1 = require("../IModelJsFs");
+const loggerCategory = BackendLoggerCategory_1.BackendLoggerCategory.IModelDb;
+/**
+ * Utility to open the iModel for RPC interfaces
+ * @internal
+ */
+class RpcBriefcaseUtility {
+    static async downloadAndOpen(args) {
+        const { activity, tokenProps } = args;
+        const accessToken = activity.accessToken;
+        (0, core_bentley_1.assert)(undefined !== tokenProps.iModelId);
+        const iModelId = tokenProps.iModelId;
+        let myBriefcaseIds;
+        if (args.syncMode === core_common_1.SyncMode.PullOnly) {
+            myBriefcaseIds = [0]; // PullOnly means briefcaseId 0
+        }
+        else {
+            // check with iModelHub and see if we already have acquired any briefcaseIds
+            myBriefcaseIds = await IModelHost_1.IModelHost.hubAccess.getMyBriefcaseIds({ accessToken, iModelId });
+        }
+        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) {
+                for (const briefcaseId of myBriefcaseIds) {
+                    const fileName = resolver({ briefcaseId, iModelId });
+                    if (IModelJsFs_1.IModelJsFs.existsSync(fileName)) {
+                        const briefcaseDb = IModelDb_1.BriefcaseDb.findByFilename(fileName);
+                        if (briefcaseDb !== undefined)
+                            return briefcaseDb;
+                        try {
+                            if (args.forceDownload)
+                                throw new Error(); // causes delete below
+                            const db = await IModelDb_1.BriefcaseDb.open({ fileName });
+                            if (db.changeset.id !== tokenProps.changeset?.id) {
+                                (0, core_bentley_1.assert)(undefined !== tokenProps.changeset);
+                                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;
+                        }
+                        catch (error) {
+                            if (!(error.errorNumber === core_bentley_1.IModelStatus.AlreadyOpen))
+                                // somehow we have this briefcaseId and the file exists, but we can't open it. Delete it.
+                                await BriefcaseManager_1.BriefcaseManager.deleteBriefcaseFiles(fileName, accessToken);
+                        }
+                    }
+                }
+            }
+        }
+        // no local briefcase available. Download one and open it.
+        (0, core_bentley_1.assert)(undefined !== tokenProps.iTwinId);
+        const request = {
+            accessToken,
+            iTwinId: tokenProps.iTwinId,
+            iModelId,
+            briefcaseId: args.syncMode === core_common_1.SyncMode.PullOnly ? 0 : undefined, // if briefcaseId is undefined, we'll acquire a new one.
+        };
+        const props = await BriefcaseManager_1.BriefcaseManager.downloadBriefcase(request);
+        return IModelDb_1.BriefcaseDb.open(props);
+    }
+    static async openBriefcase(args) {
+        if (this._briefcasePromise)
+            return this._briefcasePromise;
+        try {
+            this._briefcasePromise = this.downloadAndOpen(args); // save the fact that we're working on downloading so if we timeout, we'll reuse this request.
+            return await this._briefcasePromise;
+        }
+        finally {
+            this._briefcasePromise = undefined; // the download and open is now done
+        }
+    }
+    /** find a previously opened iModel for RPC.
+     * @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
+     * to refresh the daemon, even though it will be used for all authorized users.
+     * @param the IModelRpcProps to locate the opened iModel.
+     */
+    static async findOpenIModel(accessToken, iModel) {
+        const iModelDb = IModelDb_1.IModelDb.findByKey(iModel.key);
+        // call refreshContainerSas, just in case this is a V2 checkpoint whose sasToken is about to expire.
+        await iModelDb.refreshContainerSas(accessToken);
+        return iModelDb;
+    }
+    /**
+     * Download and open a checkpoint or briefcase, ensuring the operation completes within a default timeout. If the time to open exceeds the timeout period,
+     * a RpcPendingResponse exception is thrown
+     */
+    static async open(args) {
+        const { activity, tokenProps, syncMode } = args;
+        core_bentley_1.Logger.logTrace(loggerCategory, "RpcBriefcaseUtility.open", () => ({ ...tokenProps }));
+        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) {
+                core_bentley_1.Logger.logTrace(loggerCategory, "Open briefcase - pending", () => ({ ...tokenProps }));
+                throw new core_common_1.RpcPendingResponse(); // eslint-disable-line deprecation/deprecation
+            }
+            // note: usage is logged in the function BriefcaseManager.downloadNewBriefcaseAndOpen
+            return briefcaseDb;
+        }
+        (0, core_bentley_1.assert)(undefined !== tokenProps.iModelId);
+        (0, core_bentley_1.assert)(undefined !== tokenProps.iTwinId);
+        (0, core_bentley_1.assert)(undefined !== tokenProps.changeset);
+        const checkpoint = {
+            iModelId: tokenProps.iModelId,
+            iTwinId: tokenProps.iTwinId,
+            changeset: tokenProps.changeset,
+            accessToken: activity.accessToken,
+        };
+        // opening a checkpoint, readonly.
+        let db;
+        // first check if it's already open
+        db = IModelDb_1.SnapshotDb.tryFindByKey(CheckpointManager_1.CheckpointManager.getKey(checkpoint));
+        if (db) {
+            core_bentley_1.Logger.logTrace(loggerCategory, "Checkpoint was already open", () => ({ ...tokenProps }));
+            BriefcaseManager_1.BriefcaseManager.logUsage(db);
+            return db;
+        }
+        try {
+            // now try V2 checkpoint
+            db = await IModelDb_1.SnapshotDb.openCheckpointV2(checkpoint);
+            core_bentley_1.Logger.logTrace(loggerCategory, "using V2 checkpoint briefcase", () => ({ ...tokenProps }));
+        }
+        catch (e) {
+            core_bentley_1.Logger.logTrace(loggerCategory, "unable to open V2 checkpoint - falling back to V1 checkpoint", () => ({ error: core_bentley_1.BentleyError.getErrorProps(e), ...tokenProps }));
+            // 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.
+            const request = {
+                checkpoint,
+                localFile: CheckpointManager_1.V1CheckpointManager.getFileName(checkpoint),
+                aliasFiles: [],
+            };
+            db = await core_bentley_1.BeDuration.race(timeout, CheckpointManager_1.V1CheckpointManager.getCheckpointDb(request));
+            if (db === undefined) {
+                core_bentley_1.Logger.logTrace(loggerCategory, "Open V1 checkpoint - pending", () => ({ ...tokenProps }));
+                throw new core_common_1.RpcPendingResponse(); // eslint-disable-line deprecation/deprecation
+            }
+            core_bentley_1.Logger.logTrace(loggerCategory, "Opened V1 checkpoint", () => ({ ...tokenProps }));
+        }
+        BriefcaseManager_1.BriefcaseManager.logUsage(db, activity);
+        return db;
+    }
+    static async openWithTimeout(activity, tokenProps, syncMode, timeout = 1000) {
+        if (tokenProps.iModelId)
+            await IModelHost_1.IModelHost.tileStorage?.initialize(tokenProps.iModelId);
+        return (await this.open({ activity, tokenProps, syncMode, timeout })).toJSON();
+    }
+}
+exports.RpcBriefcaseUtility = RpcBriefcaseUtility;
 //# sourceMappingURL=RpcBriefcaseUtility.js.map

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

@@ -1,17 +1,17 @@
-/** @packageDocumentation
- * @module RpcInterface
- */
-import { IModelConnectionProps, IModelRpcProps, RpcInterface, SnapshotIModelRpcInterface, SnapshotOpenOptions } from "@itwin/core-common";
-/** The backend implementation of SnapshotIModelRpcInterface.
- * @internal
- */
-export declare class SnapshotIModelRpcImpl extends RpcInterface implements SnapshotIModelRpcInterface {
-    static register(): void;
-    /** Ask the backend to open a snapshot iModel from a file name that is resolved by the backend. */
-    openFile(filePath: string, opts?: SnapshotOpenOptions): Promise<IModelConnectionProps>;
-    /** Ask the backend to open a snapshot iModel from a key that is resolved by the backend. */
-    openRemote(fileKey: string, opts?: SnapshotOpenOptions): Promise<IModelConnectionProps>;
-    /** Ask the backend to close a snapshot iModel. */
-    close(tokenProps: IModelRpcProps): Promise<boolean>;
-}
+/** @packageDocumentation
+ * @module RpcInterface
+ */
+import { IModelConnectionProps, IModelRpcProps, RpcInterface, SnapshotIModelRpcInterface, SnapshotOpenOptions } from "@itwin/core-common";
+/** The backend implementation of SnapshotIModelRpcInterface.
+ * @internal
+ */
+export declare class SnapshotIModelRpcImpl extends RpcInterface implements SnapshotIModelRpcInterface {
+    static register(): void;
+    /** Ask the backend to open a snapshot iModel from a file name that is resolved by the backend. */
+    openFile(filePath: string, opts?: SnapshotOpenOptions): Promise<IModelConnectionProps>;
+    /** Ask the backend to open a snapshot iModel from a key that is resolved by the backend. */
+    openRemote(fileKey: string, opts?: SnapshotOpenOptions): Promise<IModelConnectionProps>;
+    /** Ask the backend to close a snapshot iModel. */
+    close(tokenProps: IModelRpcProps): Promise<boolean>;
+}
 //# sourceMappingURL=SnapshotIModelRpcImpl.d.ts.map

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

@@ -1,43 +1,43 @@
-"use strict";
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module RpcInterface
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SnapshotIModelRpcImpl = void 0;
-const core_common_1 = require("@itwin/core-common");
-const IModelDb_1 = require("../IModelDb");
-const IModelHost_1 = require("../IModelHost");
-/** The backend implementation of SnapshotIModelRpcInterface.
- * @internal
- */
-class SnapshotIModelRpcImpl extends core_common_1.RpcInterface {
-    static register() { core_common_1.RpcManager.registerImpl(core_common_1.SnapshotIModelRpcInterface, SnapshotIModelRpcImpl); }
-    /** Ask the backend to open a snapshot iModel from a file name that is resolved by the backend. */
-    async openFile(filePath, opts) {
-        let resolvedFileName = filePath;
-        if (IModelHost_1.IModelHost.snapshotFileNameResolver) {
-            resolvedFileName = IModelHost_1.IModelHost.snapshotFileNameResolver.tryResolveFileName(filePath);
-            if (undefined === resolvedFileName)
-                throw new core_common_1.IModelNotFoundResponse();
-        }
-        return IModelDb_1.SnapshotDb.openFile(resolvedFileName, opts).getConnectionProps();
-    }
-    /** Ask the backend to open a snapshot iModel from a key that is resolved by the backend. */
-    async openRemote(fileKey, opts) {
-        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();
-    }
-    /** Ask the backend to close a snapshot iModel. */
-    async close(tokenProps) {
-        IModelDb_1.SnapshotDb.findByKey(tokenProps.key).close();
-        return true;
-    }
-}
-exports.SnapshotIModelRpcImpl = SnapshotIModelRpcImpl;
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module RpcInterface
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SnapshotIModelRpcImpl = void 0;
+const core_common_1 = require("@itwin/core-common");
+const IModelDb_1 = require("../IModelDb");
+const IModelHost_1 = require("../IModelHost");
+/** The backend implementation of SnapshotIModelRpcInterface.
+ * @internal
+ */
+class SnapshotIModelRpcImpl extends core_common_1.RpcInterface {
+    static register() { core_common_1.RpcManager.registerImpl(core_common_1.SnapshotIModelRpcInterface, SnapshotIModelRpcImpl); }
+    /** Ask the backend to open a snapshot iModel from a file name that is resolved by the backend. */
+    async openFile(filePath, opts) {
+        let resolvedFileName = filePath;
+        if (IModelHost_1.IModelHost.snapshotFileNameResolver) {
+            resolvedFileName = IModelHost_1.IModelHost.snapshotFileNameResolver.tryResolveFileName(filePath);
+            if (undefined === resolvedFileName)
+                throw new core_common_1.IModelNotFoundResponse();
+        }
+        return IModelDb_1.SnapshotDb.openFile(resolvedFileName, opts).getConnectionProps();
+    }
+    /** Ask the backend to open a snapshot iModel from a key that is resolved by the backend. */
+    async openRemote(fileKey, opts) {
+        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();
+    }
+    /** Ask the backend to close a snapshot iModel. */
+    async close(tokenProps) {
+        IModelDb_1.SnapshotDb.findByKey(tokenProps.key).close();
+        return true;
+    }
+}
+exports.SnapshotIModelRpcImpl = SnapshotIModelRpcImpl;
 //# sourceMappingURL=SnapshotIModelRpcImpl.js.map