@itwin/core-backend 5.9.0-dev.8 → 5.9.0

package/lib/esm/NativeHost.js.map

@@ -1 +1 @@
-{"version":3,"file":"NativeHost.js","sourceRoot":"","sources":["../../src/NativeHost.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module NativeApp\r\n */\r\n\r\nimport { join } from \"path\";\r\nimport { AccessToken, assert, BeEvent, GuidString, ProcessDetector } from \"@itwin/core-bentley\";\r\nimport {\r\n  BriefcaseProps, InternetConnectivityStatus, LocalBriefcaseProps, NativeAppFunctions, nativeAppIpcStrings, NativeAppNotifications,\r\n  OverriddenBy, RequestNewBriefcaseProps, StorageValue,\r\n} from \"@itwin/core-common\";\r\nimport { BriefcaseManager, RequestNewBriefcaseArg } from \"./BriefcaseManager\";\r\nimport { Downloads, ProgressFunction, ProgressStatus } from \"./CheckpointManager\";\r\nimport { IModelHost } from \"./IModelHost\";\r\nimport { IpcHandler, IpcHost, IpcHostOpts, throttleProgressCallback } from \"./IpcHost\";\r\nimport { NativeAppStorage } from \"./NativeAppStorage\";\r\nimport { CatalogIModelHandler } from \"./CatalogDb\";\r\nimport { setOnlineStatus } from \"./internal/OnlineStatus\";\r\n\r\n/**\r\n * Implementation of NativeAppFunctions\r\n */\r\nclass NativeAppHandler extends IpcHandler implements NativeAppFunctions {\r\n  public get channelName() { return nativeAppIpcStrings.channelName; }\r\n\r\n  public async getAccessToken(): Promise<AccessToken | undefined> {\r\n    return IModelHost.authorizationClient?.getAccessToken();\r\n  }\r\n\r\n  public async checkInternetConnectivity(): Promise<InternetConnectivityStatus> {\r\n    return NativeHost.checkInternetConnectivity();\r\n  }\r\n  public async overrideInternetConnectivity(by: OverriddenBy, status: InternetConnectivityStatus): Promise<void> {\r\n    NativeHost.overrideInternetConnectivity(by, status);\r\n  }\r\n  public async acquireNewBriefcaseId(iModelId: GuidString): Promise<number> {\r\n    return BriefcaseManager.acquireNewBriefcaseId({ iModelId });\r\n  }\r\n  public async getBriefcaseFileName(props: BriefcaseProps): Promise<string> {\r\n    return BriefcaseManager.getFileName(props);\r\n  }\r\n  public async downloadBriefcase(request: RequestNewBriefcaseProps, reportProgress: boolean, progressInterval?: number): Promise<LocalBriefcaseProps> {\r\n    const args: RequestNewBriefcaseArg = {\r\n      ...request,\r\n      accessToken: await this.getAccessToken(),\r\n      onProgress: (_a: number, _b: number) => checkAbort(),\r\n    };\r\n\r\n    const checkAbort = () => {\r\n      assert(undefined !== args.fileName);\r\n      const job = Downloads.isInProgress(args.fileName);\r\n      return (job && (job.request as any).abort === 1) ? ProgressStatus.Abort : ProgressStatus.Continue;\r\n    };\r\n\r\n    if (reportProgress) {\r\n      const progressCallback: ProgressFunction = (loaded, total) => {\r\n        IpcHost.send(`nativeApp.progress-${request.iModelId}`, { loaded, total });\r\n        return checkAbort();\r\n      };\r\n      args.onProgress = throttleProgressCallback(progressCallback, checkAbort, progressInterval);\r\n    }\r\n\r\n    return BriefcaseManager.downloadBriefcase(args);\r\n  }\r\n\r\n  public async requestCancelDownloadBriefcase(fileName: string): Promise<boolean> {\r\n    const job = Downloads.isInProgress(fileName);\r\n    if (job)\r\n      (job.request as any).abort = 1;\r\n    return job !== undefined;\r\n  }\r\n\r\n  public async deleteBriefcaseFiles(fileName: string): Promise<void> {\r\n    await BriefcaseManager.deleteBriefcaseFiles(fileName, await IModelHost.getAccessToken());\r\n  }\r\n\r\n  public async getCachedBriefcases(iModelId?: GuidString): Promise<LocalBriefcaseProps[]> {\r\n    return BriefcaseManager.getCachedBriefcases(iModelId);\r\n  }\r\n\r\n  public async storageMgrOpen(storageId: string): Promise<string> {\r\n    return NativeAppStorage.open(storageId).id;\r\n  }\r\n\r\n  public async storageMgrClose(storageId: string, deleteIt: boolean): Promise<void> {\r\n    NativeAppStorage.find(storageId).close(deleteIt);\r\n  }\r\n\r\n  public async storageMgrNames(): Promise<string[]> {\r\n    return NativeAppStorage.getStorageNames();\r\n  }\r\n\r\n  public async storageGetValueType(storageId: string, key: string): Promise<\"number\" | \"string\" | \"boolean\" | \"Uint8Array\" | \"null\" | undefined> {\r\n    return NativeAppStorage.find(storageId).getValueType(key);\r\n  }\r\n\r\n  public async storageGet(storageId: string, key: string): Promise<StorageValue | undefined> {\r\n    return NativeAppStorage.find(storageId).getData(key);\r\n  }\r\n\r\n  public async storageSet(storageId: string, key: string, value: StorageValue): Promise<void> {\r\n    NativeAppStorage.find(storageId).setData(key, value);\r\n  }\r\n\r\n  public async storageRemove(storageId: string, key: string): Promise<void> {\r\n    NativeAppStorage.find(storageId).removeData(key);\r\n  }\r\n\r\n  public async storageKeys(storageId: string): Promise<string[]> {\r\n    return NativeAppStorage.find(storageId).getKeys();\r\n  }\r\n\r\n  public async storageRemoveAll(storageId: string): Promise<void> {\r\n    NativeAppStorage.find(storageId).removeAll();\r\n  }\r\n}\r\n\r\n/** Options for [[NativeHost.startup]]\r\n * @public\r\n */\r\nexport interface NativeHostOpts extends IpcHostOpts {\r\n  nativeHost?: {\r\n    /** Application name. Used, for example, to name the settings file. If not supplied, defaults to \"iTwinApp\". */\r\n    applicationName?: string;\r\n  };\r\n}\r\n\r\n/**\r\n * Backend for desktop/mobile native applications\r\n * @public\r\n */\r\nexport class NativeHost {\r\n  private static _reachability?: InternetConnectivityStatus;\r\n  private static _applicationName: string;\r\n  private constructor() { } // no instances - static methods only\r\n\r\n  /** Event called when the internet connectivity changes, if known. */\r\n  public static readonly onInternetConnectivityChanged = new BeEvent<(status: InternetConnectivityStatus) => void>();\r\n\r\n  private static _appSettingsCacheDir?: string;\r\n\r\n  /** Get the local cache folder for application settings */\r\n  public static get appSettingsCacheDir(): string {\r\n    return this._appSettingsCacheDir ??= join(IModelHost.cacheDir, \"appSettings\");\r\n  }\r\n\r\n  /** Send a notification to the NativeApp connected to this NativeHost. */\r\n  public static notifyNativeFrontend<T extends keyof NativeAppNotifications>(methodName: T, ...args: Parameters<NativeAppNotifications[T]>) {\r\n    return IpcHost.send(nativeAppIpcStrings.notifyChannel, methodName, ...args);\r\n  }\r\n\r\n  private static _isValid = false;\r\n  public static get isValid(): boolean { return this._isValid; }\r\n  public static get applicationName() { return this._applicationName; }\r\n  /** Get the settings store for this NativeHost. */\r\n  public static get settingsStore() {\r\n    return NativeAppStorage.open(this.applicationName);\r\n  }\r\n\r\n  /**\r\n   * Start the backend of a native app.\r\n   * @note this method calls [[IpcHost.startup]] internally.\r\n   */\r\n  public static async startup(opt?: NativeHostOpts): Promise<void> {\r\n    if (!this.isValid) {\r\n      this._isValid = true;\r\n      this.onInternetConnectivityChanged.addListener((status: InternetConnectivityStatus) =>\r\n        NativeHost.notifyNativeFrontend(\"notifyInternetConnectivityChanged\", status));\r\n      this._applicationName = opt?.nativeHost?.applicationName ?? \"iTwinApp\";\r\n    }\r\n\r\n    await IpcHost.startup(opt);\r\n    if (IpcHost.isValid) {  // for tests, we use NativeHost but don't have a frontend\r\n      NativeAppHandler.register();\r\n      CatalogIModelHandler.register();\r\n    }\r\n  }\r\n\r\n  /** Shutdown native app backend. Also calls [[IpcHost.shutdown]] */\r\n  public static async shutdown(): Promise<void> {\r\n    this._isValid = false;\r\n    this.onInternetConnectivityChanged.clear();\r\n    await IpcHost.shutdown();\r\n  }\r\n\r\n  /** get current value of internet connectivity */\r\n  public static checkInternetConnectivity(): InternetConnectivityStatus {\r\n    return this._reachability ?? InternetConnectivityStatus.Online;\r\n  }\r\n\r\n  /**\r\n   * Override internet connectivity state\r\n   * @param _overridenBy who overrode the value.\r\n   * @internal\r\n   */\r\n  public static overrideInternetConnectivity(_overridenBy: OverriddenBy, status: InternetConnectivityStatus): void {\r\n    if (this._reachability !== status) {\r\n      this._reachability = status;\r\n      this.onInternetConnectivityChanged.raiseEvent(status);\r\n      if (ProcessDetector.isMobileAppBackend) {\r\n        // Merely referencing NativeHost from a non-native backend causes a runtime exception (even\r\n        // inside an if statement that checks that the backend is a mobile backend). This allows code\r\n        // that needs to check connectivity to do so without referencing NativeHost directly.\r\n        setOnlineStatus(status === InternetConnectivityStatus.Online);\r\n      }\r\n    }\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"NativeHost.js","sourceRoot":"","sources":["../../src/NativeHost.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 NativeApp\n */\n\nimport { join } from \"path\";\nimport { AccessToken, assert, BeEvent, GuidString, ProcessDetector } from \"@itwin/core-bentley\";\nimport {\n  BriefcaseProps, InternetConnectivityStatus, LocalBriefcaseProps, NativeAppFunctions, nativeAppIpcStrings, NativeAppNotifications,\n  OverriddenBy, RequestNewBriefcaseProps, StorageValue,\n} from \"@itwin/core-common\";\nimport { BriefcaseManager, RequestNewBriefcaseArg } from \"./BriefcaseManager\";\nimport { Downloads, ProgressFunction, ProgressStatus } from \"./CheckpointManager\";\nimport { IModelHost } from \"./IModelHost\";\nimport { IpcHandler, IpcHost, IpcHostOpts, throttleProgressCallback } from \"./IpcHost\";\nimport { NativeAppStorage } from \"./NativeAppStorage\";\nimport { CatalogIModelHandler } from \"./CatalogDb\";\nimport { setOnlineStatus } from \"./internal/OnlineStatus\";\n\n/**\n * Implementation of NativeAppFunctions\n */\nclass NativeAppHandler extends IpcHandler implements NativeAppFunctions {\n  public get channelName() { return nativeAppIpcStrings.channelName; }\n\n  public async getAccessToken(): Promise<AccessToken | undefined> {\n    return IModelHost.authorizationClient?.getAccessToken();\n  }\n\n  public async checkInternetConnectivity(): Promise<InternetConnectivityStatus> {\n    return NativeHost.checkInternetConnectivity();\n  }\n  public async overrideInternetConnectivity(by: OverriddenBy, status: InternetConnectivityStatus): Promise<void> {\n    NativeHost.overrideInternetConnectivity(by, status);\n  }\n  public async acquireNewBriefcaseId(iModelId: GuidString): Promise<number> {\n    return BriefcaseManager.acquireNewBriefcaseId({ iModelId });\n  }\n  public async getBriefcaseFileName(props: BriefcaseProps): Promise<string> {\n    return BriefcaseManager.getFileName(props);\n  }\n  public async downloadBriefcase(request: RequestNewBriefcaseProps, reportProgress: boolean, progressInterval?: number): Promise<LocalBriefcaseProps> {\n    const args: RequestNewBriefcaseArg = {\n      ...request,\n      accessToken: await this.getAccessToken(),\n      onProgress: (_a: number, _b: number) => checkAbort(),\n    };\n\n    const checkAbort = () => {\n      assert(undefined !== args.fileName);\n      const job = Downloads.isInProgress(args.fileName);\n      return (job && (job.request as any).abort === 1) ? ProgressStatus.Abort : ProgressStatus.Continue;\n    };\n\n    if (reportProgress) {\n      const progressCallback: ProgressFunction = (loaded, total) => {\n        IpcHost.send(`nativeApp.progress-${request.iModelId}`, { loaded, total });\n        return checkAbort();\n      };\n      args.onProgress = throttleProgressCallback(progressCallback, checkAbort, progressInterval);\n    }\n\n    return BriefcaseManager.downloadBriefcase(args);\n  }\n\n  public async requestCancelDownloadBriefcase(fileName: string): Promise<boolean> {\n    const job = Downloads.isInProgress(fileName);\n    if (job)\n      (job.request as any).abort = 1;\n    return job !== undefined;\n  }\n\n  public async deleteBriefcaseFiles(fileName: string): Promise<void> {\n    await BriefcaseManager.deleteBriefcaseFiles(fileName, await IModelHost.getAccessToken());\n  }\n\n  public async getCachedBriefcases(iModelId?: GuidString): Promise<LocalBriefcaseProps[]> {\n    return BriefcaseManager.getCachedBriefcases(iModelId);\n  }\n\n  public async storageMgrOpen(storageId: string): Promise<string> {\n    return NativeAppStorage.open(storageId).id;\n  }\n\n  public async storageMgrClose(storageId: string, deleteIt: boolean): Promise<void> {\n    NativeAppStorage.find(storageId).close(deleteIt);\n  }\n\n  public async storageMgrNames(): Promise<string[]> {\n    return NativeAppStorage.getStorageNames();\n  }\n\n  public async storageGetValueType(storageId: string, key: string): Promise<\"number\" | \"string\" | \"boolean\" | \"Uint8Array\" | \"null\" | undefined> {\n    return NativeAppStorage.find(storageId).getValueType(key);\n  }\n\n  public async storageGet(storageId: string, key: string): Promise<StorageValue | undefined> {\n    return NativeAppStorage.find(storageId).getData(key);\n  }\n\n  public async storageSet(storageId: string, key: string, value: StorageValue): Promise<void> {\n    NativeAppStorage.find(storageId).setData(key, value);\n  }\n\n  public async storageRemove(storageId: string, key: string): Promise<void> {\n    NativeAppStorage.find(storageId).removeData(key);\n  }\n\n  public async storageKeys(storageId: string): Promise<string[]> {\n    return NativeAppStorage.find(storageId).getKeys();\n  }\n\n  public async storageRemoveAll(storageId: string): Promise<void> {\n    NativeAppStorage.find(storageId).removeAll();\n  }\n}\n\n/** Options for [[NativeHost.startup]]\n * @public\n */\nexport interface NativeHostOpts extends IpcHostOpts {\n  nativeHost?: {\n    /** Application name. Used, for example, to name the settings file. If not supplied, defaults to \"iTwinApp\". */\n    applicationName?: string;\n  };\n}\n\n/**\n * Backend for desktop/mobile native applications\n * @public\n */\nexport class NativeHost {\n  private static _reachability?: InternetConnectivityStatus;\n  private static _applicationName: string;\n  private constructor() { } // no instances - static methods only\n\n  /** Event called when the internet connectivity changes, if known. */\n  public static readonly onInternetConnectivityChanged = new BeEvent<(status: InternetConnectivityStatus) => void>();\n\n  private static _appSettingsCacheDir?: string;\n\n  /** Get the local cache folder for application settings */\n  public static get appSettingsCacheDir(): string {\n    return this._appSettingsCacheDir ??= join(IModelHost.cacheDir, \"appSettings\");\n  }\n\n  /** Send a notification to the NativeApp connected to this NativeHost. */\n  public static notifyNativeFrontend<T extends keyof NativeAppNotifications>(methodName: T, ...args: Parameters<NativeAppNotifications[T]>) {\n    return IpcHost.send(nativeAppIpcStrings.notifyChannel, methodName, ...args);\n  }\n\n  private static _isValid = false;\n  public static get isValid(): boolean { return this._isValid; }\n  public static get applicationName() { return this._applicationName; }\n  /** Get the settings store for this NativeHost. */\n  public static get settingsStore() {\n    return NativeAppStorage.open(this.applicationName);\n  }\n\n  /**\n   * Start the backend of a native app.\n   * @note this method calls [[IpcHost.startup]] internally.\n   */\n  public static async startup(opt?: NativeHostOpts): Promise<void> {\n    if (!this.isValid) {\n      this._isValid = true;\n      this.onInternetConnectivityChanged.addListener((status: InternetConnectivityStatus) =>\n        NativeHost.notifyNativeFrontend(\"notifyInternetConnectivityChanged\", status));\n      this._applicationName = opt?.nativeHost?.applicationName ?? \"iTwinApp\";\n    }\n\n    await IpcHost.startup(opt);\n    if (IpcHost.isValid) {  // for tests, we use NativeHost but don't have a frontend\n      NativeAppHandler.register();\n      CatalogIModelHandler.register();\n    }\n  }\n\n  /** Shutdown native app backend. Also calls [[IpcHost.shutdown]] */\n  public static async shutdown(): Promise<void> {\n    this._isValid = false;\n    this.onInternetConnectivityChanged.clear();\n    await IpcHost.shutdown();\n  }\n\n  /** get current value of internet connectivity */\n  public static checkInternetConnectivity(): InternetConnectivityStatus {\n    return this._reachability ?? InternetConnectivityStatus.Online;\n  }\n\n  /**\n   * Override internet connectivity state\n   * @param _overridenBy who overrode the value.\n   * @internal\n   */\n  public static overrideInternetConnectivity(_overridenBy: OverriddenBy, status: InternetConnectivityStatus): void {\n    if (this._reachability !== status) {\n      this._reachability = status;\n      this.onInternetConnectivityChanged.raiseEvent(status);\n      if (ProcessDetector.isMobileAppBackend) {\n        // Merely referencing NativeHost from a non-native backend causes a runtime exception (even\n        // inside an if statement that checks that the backend is a mobile backend). This allows code\n        // that needs to check connectivity to do so without referencing NativeHost directly.\n        setOnlineStatus(status === InternetConnectivityStatus.Online);\n      }\n    }\n  }\n}\n"]}

package/lib/esm/NavigationRelationship.js.map

@@ -1 +1 @@
-{"version":3,"file":"NavigationRelationship.js","sourceRoot":"","sources":["../../src/NavigationRelationship.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Relationships\r\n */\r\n\r\n// NOTE: A NavigationRelationship is not an Entity, so is not registered in the ClassRegistry.\r\n// NOTE: It does, however, have a classFullName property for consistency with Entity subclasses.\r\n\r\nimport { Id64String } from \"@itwin/core-bentley\";\r\nimport { RelatedElement, TypeDefinition } from \"@itwin/core-common\";\r\n\r\n/** Relates a parent Element to child Elements which represent parts of the Entity modeled by the parent Element.\r\n * @public\r\n */\r\nexport class ElementOwnsChildElements extends RelatedElement {\r\n  public static classFullName = \"BisCore:ElementOwnsChildElements\";\r\n  public constructor(parentId: Id64String, relClassName: string = ElementOwnsChildElements.classFullName) {\r\n    super({ id: parentId, relClassName });\r\n  }\r\n}\r\n\r\n/** Relates a parent [[Subject]] to [[Subject]] child elements.\r\n * @public\r\n */\r\nexport class SubjectOwnsSubjects extends ElementOwnsChildElements {\r\n  public static override classFullName = \"BisCore:SubjectOwnsSubjects\";\r\n  public constructor(parentId: Id64String, relClassName: string = SubjectOwnsSubjects.classFullName) {\r\n    super(parentId, relClassName);\r\n  }\r\n}\r\n\r\n/** Relates a parent [[Subject]] to [[InformationPartitionElement]] child elements.\r\n * @public\r\n */\r\nexport class SubjectOwnsPartitionElements extends ElementOwnsChildElements {\r\n  public static override classFullName = \"BisCore:SubjectOwnsPartitionElements\";\r\n  public constructor(parentId: Id64String, relClassName: string = SubjectOwnsPartitionElements.classFullName) {\r\n    super(parentId, relClassName);\r\n  }\r\n}\r\n\r\n/** Relates a parent [[Category]] to [[SubCategory]] child elements.\r\n * @public\r\n */\r\nexport class CategoryOwnsSubCategories extends ElementOwnsChildElements {\r\n  public static override classFullName = \"BisCore:CategoryOwnsSubCategories\";\r\n  public constructor(parentId: Id64String, relClassName: string = CategoryOwnsSubCategories.classFullName) {\r\n    super(parentId, relClassName);\r\n  }\r\n}\r\n\r\n/** Relates a parent [[RenderMaterial]] to [[RenderMaterial]] child elements.\r\n * @public\r\n */\r\nexport class RenderMaterialOwnsRenderMaterials extends ElementOwnsChildElements {\r\n  public static override classFullName = \"BisCore:RenderMaterialOwnsRenderMaterials\";\r\n  public constructor(parentId: Id64String, relClassName: string = RenderMaterialOwnsRenderMaterials.classFullName) {\r\n    super(parentId, relClassName);\r\n  }\r\n}\r\n\r\n/** Relates a parent Element to child Elements which represent **hidden** parts of the Entity.\r\n * @public\r\n */\r\nexport class ElementEncapsulatesElements extends ElementOwnsChildElements {\r\n  public static override classFullName = \"BisCore:ElementEncapsulatesElements\";\r\n  public constructor(parentId: Id64String, relClassName: string = ElementEncapsulatesElements.classFullName) {\r\n    super(parentId, relClassName);\r\n  }\r\n}\r\n\r\n/** Relates a parent [[PhysicalElement]] to [[PhysicalElement]] children that it assembles.\r\n * @public\r\n */\r\nexport class PhysicalElementAssemblesElements extends ElementOwnsChildElements {\r\n  public static override classFullName = \"BisCore:PhysicalElementAssemblesElements\";\r\n  public constructor(parentId: Id64String, relClassName: string = PhysicalElementAssemblesElements.classFullName) {\r\n    super(parentId, relClassName);\r\n  }\r\n}\r\n\r\n/** Relates a parent [[ExternalSource]] to its [[ExternalSourceAttachment]] children.\r\n * @note The associated ECClass was added to the BisCore schema in version 1.0.13\r\n * @beta\r\n */\r\nexport class ExternalSourceOwnsAttachments extends ElementOwnsChildElements {\r\n  public static override classFullName = \"BisCore:ExternalSourceOwnsAttachments\";\r\n  public constructor(parentId: Id64String, relClassName: string = ExternalSourceOwnsAttachments.classFullName) {\r\n    super(parentId, relClassName);\r\n  }\r\n}\r\n\r\n/** Relates a parent [[FolderLink]] to its [[RepositoryLink]] children.\r\n * @note The associated ECClass was added to the BisCore schema in version 1.0.13\r\n * @beta\r\n */\r\nexport class FolderContainsRepositories extends ElementOwnsChildElements {\r\n  public static override classFullName = \"BisCore:FolderContainsRepositories\";\r\n  public constructor(parentId: Id64String, relClassName: string = FolderContainsRepositories.classFullName) {\r\n    super(parentId, relClassName);\r\n  }\r\n}\r\n\r\n/** Relates a [[SheetIndexFolder]] to the [[SheetIndexEntry]]'s that it contains.\r\n * @beta\r\n */\r\nexport class SheetIndexFolderOwnsEntries extends ElementOwnsChildElements {\r\n  public static override classFullName = \"BisCore:SheetIndexFolderOwnsEntries\";\r\n  public constructor(parentId: Id64String, relClassName: string = SheetIndexFolderOwnsEntries.classFullName) {\r\n    super(parentId, relClassName);\r\n  }\r\n}\r\n\r\n/** Relates a [[SheetIndex]] to the [SheetIndexEntry]]'s that it contains.\r\n * @beta\r\n */\r\nexport class SheetIndexOwnsEntries extends ElementOwnsChildElements {\r\n  public static override classFullName = \"BisCore:SheetIndexOwnsEntries\";\r\n  public constructor(parentId: Id64String, relClassName: string = SheetIndexOwnsEntries.classFullName) {\r\n    super(parentId, relClassName);\r\n  }\r\n}\r\n\r\n/** Relates a [[GeometricElement2d]] to its [[TypeDefinitionElement]]\r\n * @public\r\n */\r\nexport class GeometricElement2dHasTypeDefinition extends TypeDefinition {\r\n  public static classFullName = \"BisCore:GeometricElement2dHasTypeDefinition\";\r\n  public constructor(id: Id64String, relClassName: string = GeometricElement2dHasTypeDefinition.classFullName) {\r\n    super({ id, relClassName });\r\n  }\r\n}\r\n\r\n/** Relates a [[GraphicalElement2d]] to its [[GraphicalType2d]]\r\n * @public\r\n */\r\nexport class GraphicalElement2dIsOfType extends GeometricElement2dHasTypeDefinition {\r\n  public static override classFullName = \"BisCore:GraphicalElement2dIsOfType\";\r\n  public constructor(id: Id64String, relClassName: string = GraphicalElement2dIsOfType.classFullName) {\r\n    super(id, relClassName);\r\n  }\r\n}\r\n\r\n/** Relates a [[GeometricElement3d]] to its [[TypeDefinitionElement]]\r\n * @public\r\n */\r\nexport class GeometricElement3dHasTypeDefinition extends TypeDefinition {\r\n  public static classFullName = \"BisCore:GeometricElement3dHasTypeDefinition\";\r\n  public constructor(id: Id64String, relClassName: string = GeometricElement3dHasTypeDefinition.classFullName) {\r\n    super({ id, relClassName });\r\n  }\r\n}\r\n\r\n/** Relates a [[SpatialLocationElement]] to its [[SpatialLocationType]]\r\n * @public\r\n */\r\nexport class SpatialLocationIsOfType extends GeometricElement3dHasTypeDefinition {\r\n  public static override classFullName = \"BisCore:SpatialLocationIsOfType\";\r\n  public constructor(id: Id64String, relClassName: string = SpatialLocationIsOfType.classFullName) {\r\n    super(id, relClassName);\r\n  }\r\n}\r\n\r\n/** Relates a [[PhysicalElement]] to its [[PhysicalType]]\r\n * @public\r\n */\r\nexport class PhysicalElementIsOfType extends GeometricElement3dHasTypeDefinition {\r\n  public static override classFullName = \"BisCore:PhysicalElementIsOfType\";\r\n  public constructor(id: Id64String, relClassName: string = PhysicalElementIsOfType.classFullName) {\r\n    super(id, relClassName);\r\n  }\r\n}\r\n\r\n/** Relates a [[PhysicalElement]] to its [[PhysicalMaterial]]\r\n * @public\r\n */\r\nexport class PhysicalElementIsOfPhysicalMaterial extends RelatedElement {\r\n  public static classFullName = \"BisCore:PhysicalElementIsOfPhysicalMaterial\";\r\n  public constructor(id: Id64String) {\r\n    super({ id });\r\n  }\r\n}\r\n\r\n/** Relates a [[PhysicalType]] to its [[PhysicalMaterial]]\r\n * @public\r\n */\r\nexport class PhysicalTypeIsOfPhysicalMaterial extends RelatedElement {\r\n  public static classFullName = \"BisCore:PhysicalTypeIsOfPhysicalMaterial\";\r\n  public constructor(id: Id64String) {\r\n    super({ id });\r\n  }\r\n}\r\n\r\n/** Relates an [[Element]] and an [[ElementUniqueAspect]] that it owns.\r\n * @public\r\n */\r\nexport class ElementOwnsUniqueAspect extends RelatedElement {\r\n  public static classFullName = \"BisCore:ElementOwnsUniqueAspect\";\r\n  public constructor(elementId: Id64String, relClassName: string = ElementOwnsUniqueAspect.classFullName) {\r\n    super({ id: elementId, relClassName });\r\n  }\r\n}\r\n\r\n/** Relates an [[Element]] and an [[ElementMultiAspect]] that it owns.\r\n * @public\r\n */\r\nexport class ElementOwnsMultiAspects extends RelatedElement {\r\n  public static classFullName = \"BisCore:ElementOwnsMultiAspects\";\r\n  public constructor(elementId: Id64String, relClassName: string = ElementOwnsMultiAspects.classFullName) {\r\n    super({ id: elementId, relClassName });\r\n  }\r\n}\r\n\r\n/** Relates an [[Element]] and an [[ExternalSourceAspect]] that it owns.\r\n * @public\r\n */\r\nexport class ElementOwnsExternalSourceAspects extends ElementOwnsMultiAspects {\r\n  public static override classFullName = \"BisCore:ElementOwnsExternalSourceAspects\";\r\n  public constructor(elementId: Id64String, relClassName: string = ElementOwnsExternalSourceAspects.classFullName) {\r\n    super(elementId, relClassName);\r\n  }\r\n}\r\n\r\n/** Relates an [[ExternalSource]] to the [[RepositoryLink]] that it is persisted in.\r\n * @note The associated ECClass was added to the BisCore schema in version 1.0.13\r\n * @beta\r\n */\r\nexport class ExternalSourceIsInRepository extends RelatedElement {\r\n  public static classFullName = \"BisCore:ExternalSourceIsInRepository\";\r\n  public constructor(repositoryId: Id64String, relClassName: string = ExternalSourceIsInRepository.classFullName) {\r\n    super({ id: repositoryId, relClassName });\r\n  }\r\n}\r\n\r\n/** Relates an [[ExternalSource]] to the [[RepositoryLink]] that it is persisted in.\r\n * @note The associated ECClass was added to the BisCore schema in version 1.0.13\r\n * @beta\r\n */\r\nexport class ExternalSourceAttachmentAttachesSource extends RelatedElement {\r\n  public static classFullName = \"BisCore:ExternalSourceAttachmentAttachesSource\";\r\n  public constructor(externalSourceId: Id64String, relClassName: string = ExternalSourceAttachmentAttachesSource.classFullName) {\r\n    super({ id: externalSourceId, relClassName });\r\n  }\r\n}\r\n\r\n/** Relates a [[SheetReference]] and [[Sheet]] that it refers.\r\n * @beta\r\n */\r\nexport class SheetReferenceRefersToSheet extends RelatedElement {\r\n  public static classFullName = \"BisCore:SheetReferenceRefersToSheet\";\r\n  public constructor(sheetId: Id64String, relClassName: string = SheetReferenceRefersToSheet.classFullName) {\r\n    super({ id: sheetId, relClassName });\r\n  }\r\n}\r\n\r\n/** Relates a [[SheetIndexReference]] to a [[SheetIndex]] it refers.\r\n * @beta\r\n */\r\nexport class SheetIndexReferenceRefersToSheetIndex extends RelatedElement {\r\n  public static classFullName = \"BisCore:SheetIndexReferenceRefersToSheetIndex\";\r\n  public constructor(sheetIndexId: Id64String, relClassName: string = SheetIndexReferenceRefersToSheetIndex.classFullName) {\r\n    super({ id: sheetIndexId, relClassName });\r\n  }\r\n}\r\n\r\n/** Relates a [[Subject]] to the [[ProjectInformationRecord]] that describes its project-level properties.\r\n * @beta\r\n */\r\nexport class SubjectOwnsProjectInformationRecord extends ElementOwnsChildElements {\r\n  public static override classFullName = \"BisCore:SubjectOwnsProjectInformationRecord\";\r\n  public constructor(parentId: Id64String, relClassName = SubjectOwnsProjectInformationRecord.classFullName) {\r\n    super(parentId, relClassName);\r\n  }\r\n}\r\n\r\n/** Relates a [[Sheet]] to the [[SheetInformationAspect]] that hosts its basic [SheetInformation]($common).\r\n * @see [[SheetInformationAspect.setSheetInformation]] to create an instance of this relationship.\r\n * @beta\r\n */\r\nexport class SheetOwnsSheetInformationAspect extends ElementOwnsUniqueAspect {\r\n  public static override classFullName = \"BisCore:SheetOwnsSheetInformationAspect\";\r\n\r\n  public constructor(sheetId: Id64String, relClassName = SheetOwnsSheetInformationAspect.classFullName) {\r\n    super(sheetId, relClassName);\r\n  }\r\n}\r\n\r\n/** Relates an [[Element]] to the [[ChannelRootAspect]] that identifies it as a channel root.\r\n * @see [[ChannelControl.makeChannelRoot]] to create an instance of this relationship.\r\n * @public\r\n */\r\nexport class ElementOwnsChannelRootAspect extends ElementOwnsUniqueAspect {\r\n  public static override classFullName = \"BisCore:ElementOwnsChannelRootAspect\";\r\n\r\n  public constructor(elementId: Id64String, relClassName = ElementOwnsChannelRootAspect.classFullName) {\r\n    super(elementId, relClassName);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"NavigationRelationship.js","sourceRoot":"","sources":["../../src/NavigationRelationship.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 Relationships\n */\n\n// NOTE: A NavigationRelationship is not an Entity, so is not registered in the ClassRegistry.\n// NOTE: It does, however, have a classFullName property for consistency with Entity subclasses.\n\nimport { Id64String } from \"@itwin/core-bentley\";\nimport { RelatedElement, TypeDefinition } from \"@itwin/core-common\";\n\n/** Relates a parent Element to child Elements which represent parts of the Entity modeled by the parent Element.\n * @public\n */\nexport class ElementOwnsChildElements extends RelatedElement {\n  public static classFullName = \"BisCore:ElementOwnsChildElements\";\n  public constructor(parentId: Id64String, relClassName: string = ElementOwnsChildElements.classFullName) {\n    super({ id: parentId, relClassName });\n  }\n}\n\n/** Relates a parent [[Subject]] to [[Subject]] child elements.\n * @public\n */\nexport class SubjectOwnsSubjects extends ElementOwnsChildElements {\n  public static override classFullName = \"BisCore:SubjectOwnsSubjects\";\n  public constructor(parentId: Id64String, relClassName: string = SubjectOwnsSubjects.classFullName) {\n    super(parentId, relClassName);\n  }\n}\n\n/** Relates a parent [[Subject]] to [[InformationPartitionElement]] child elements.\n * @public\n */\nexport class SubjectOwnsPartitionElements extends ElementOwnsChildElements {\n  public static override classFullName = \"BisCore:SubjectOwnsPartitionElements\";\n  public constructor(parentId: Id64String, relClassName: string = SubjectOwnsPartitionElements.classFullName) {\n    super(parentId, relClassName);\n  }\n}\n\n/** Relates a parent [[Category]] to [[SubCategory]] child elements.\n * @public\n */\nexport class CategoryOwnsSubCategories extends ElementOwnsChildElements {\n  public static override classFullName = \"BisCore:CategoryOwnsSubCategories\";\n  public constructor(parentId: Id64String, relClassName: string = CategoryOwnsSubCategories.classFullName) {\n    super(parentId, relClassName);\n  }\n}\n\n/** Relates a parent [[RenderMaterial]] to [[RenderMaterial]] child elements.\n * @public\n */\nexport class RenderMaterialOwnsRenderMaterials extends ElementOwnsChildElements {\n  public static override classFullName = \"BisCore:RenderMaterialOwnsRenderMaterials\";\n  public constructor(parentId: Id64String, relClassName: string = RenderMaterialOwnsRenderMaterials.classFullName) {\n    super(parentId, relClassName);\n  }\n}\n\n/** Relates a parent Element to child Elements which represent **hidden** parts of the Entity.\n * @public\n */\nexport class ElementEncapsulatesElements extends ElementOwnsChildElements {\n  public static override classFullName = \"BisCore:ElementEncapsulatesElements\";\n  public constructor(parentId: Id64String, relClassName: string = ElementEncapsulatesElements.classFullName) {\n    super(parentId, relClassName);\n  }\n}\n\n/** Relates a parent [[PhysicalElement]] to [[PhysicalElement]] children that it assembles.\n * @public\n */\nexport class PhysicalElementAssemblesElements extends ElementOwnsChildElements {\n  public static override classFullName = \"BisCore:PhysicalElementAssemblesElements\";\n  public constructor(parentId: Id64String, relClassName: string = PhysicalElementAssemblesElements.classFullName) {\n    super(parentId, relClassName);\n  }\n}\n\n/** Relates a parent [[ExternalSource]] to its [[ExternalSourceAttachment]] children.\n * @note The associated ECClass was added to the BisCore schema in version 1.0.13\n * @beta\n */\nexport class ExternalSourceOwnsAttachments extends ElementOwnsChildElements {\n  public static override classFullName = \"BisCore:ExternalSourceOwnsAttachments\";\n  public constructor(parentId: Id64String, relClassName: string = ExternalSourceOwnsAttachments.classFullName) {\n    super(parentId, relClassName);\n  }\n}\n\n/** Relates a parent [[FolderLink]] to its [[RepositoryLink]] children.\n * @note The associated ECClass was added to the BisCore schema in version 1.0.13\n * @beta\n */\nexport class FolderContainsRepositories extends ElementOwnsChildElements {\n  public static override classFullName = \"BisCore:FolderContainsRepositories\";\n  public constructor(parentId: Id64String, relClassName: string = FolderContainsRepositories.classFullName) {\n    super(parentId, relClassName);\n  }\n}\n\n/** Relates a [[SheetIndexFolder]] to the [[SheetIndexEntry]]'s that it contains.\n * @beta\n */\nexport class SheetIndexFolderOwnsEntries extends ElementOwnsChildElements {\n  public static override classFullName = \"BisCore:SheetIndexFolderOwnsEntries\";\n  public constructor(parentId: Id64String, relClassName: string = SheetIndexFolderOwnsEntries.classFullName) {\n    super(parentId, relClassName);\n  }\n}\n\n/** Relates a [[SheetIndex]] to the [SheetIndexEntry]]'s that it contains.\n * @beta\n */\nexport class SheetIndexOwnsEntries extends ElementOwnsChildElements {\n  public static override classFullName = \"BisCore:SheetIndexOwnsEntries\";\n  public constructor(parentId: Id64String, relClassName: string = SheetIndexOwnsEntries.classFullName) {\n    super(parentId, relClassName);\n  }\n}\n\n/** Relates a [[GeometricElement2d]] to its [[TypeDefinitionElement]]\n * @public\n */\nexport class GeometricElement2dHasTypeDefinition extends TypeDefinition {\n  public static classFullName = \"BisCore:GeometricElement2dHasTypeDefinition\";\n  public constructor(id: Id64String, relClassName: string = GeometricElement2dHasTypeDefinition.classFullName) {\n    super({ id, relClassName });\n  }\n}\n\n/** Relates a [[GraphicalElement2d]] to its [[GraphicalType2d]]\n * @public\n */\nexport class GraphicalElement2dIsOfType extends GeometricElement2dHasTypeDefinition {\n  public static override classFullName = \"BisCore:GraphicalElement2dIsOfType\";\n  public constructor(id: Id64String, relClassName: string = GraphicalElement2dIsOfType.classFullName) {\n    super(id, relClassName);\n  }\n}\n\n/** Relates a [[GeometricElement3d]] to its [[TypeDefinitionElement]]\n * @public\n */\nexport class GeometricElement3dHasTypeDefinition extends TypeDefinition {\n  public static classFullName = \"BisCore:GeometricElement3dHasTypeDefinition\";\n  public constructor(id: Id64String, relClassName: string = GeometricElement3dHasTypeDefinition.classFullName) {\n    super({ id, relClassName });\n  }\n}\n\n/** Relates a [[SpatialLocationElement]] to its [[SpatialLocationType]]\n * @public\n */\nexport class SpatialLocationIsOfType extends GeometricElement3dHasTypeDefinition {\n  public static override classFullName = \"BisCore:SpatialLocationIsOfType\";\n  public constructor(id: Id64String, relClassName: string = SpatialLocationIsOfType.classFullName) {\n    super(id, relClassName);\n  }\n}\n\n/** Relates a [[PhysicalElement]] to its [[PhysicalType]]\n * @public\n */\nexport class PhysicalElementIsOfType extends GeometricElement3dHasTypeDefinition {\n  public static override classFullName = \"BisCore:PhysicalElementIsOfType\";\n  public constructor(id: Id64String, relClassName: string = PhysicalElementIsOfType.classFullName) {\n    super(id, relClassName);\n  }\n}\n\n/** Relates a [[PhysicalElement]] to its [[PhysicalMaterial]]\n * @public\n */\nexport class PhysicalElementIsOfPhysicalMaterial extends RelatedElement {\n  public static classFullName = \"BisCore:PhysicalElementIsOfPhysicalMaterial\";\n  public constructor(id: Id64String) {\n    super({ id });\n  }\n}\n\n/** Relates a [[PhysicalType]] to its [[PhysicalMaterial]]\n * @public\n */\nexport class PhysicalTypeIsOfPhysicalMaterial extends RelatedElement {\n  public static classFullName = \"BisCore:PhysicalTypeIsOfPhysicalMaterial\";\n  public constructor(id: Id64String) {\n    super({ id });\n  }\n}\n\n/** Relates an [[Element]] and an [[ElementUniqueAspect]] that it owns.\n * @public\n */\nexport class ElementOwnsUniqueAspect extends RelatedElement {\n  public static classFullName = \"BisCore:ElementOwnsUniqueAspect\";\n  public constructor(elementId: Id64String, relClassName: string = ElementOwnsUniqueAspect.classFullName) {\n    super({ id: elementId, relClassName });\n  }\n}\n\n/** Relates an [[Element]] and an [[ElementMultiAspect]] that it owns.\n * @public\n */\nexport class ElementOwnsMultiAspects extends RelatedElement {\n  public static classFullName = \"BisCore:ElementOwnsMultiAspects\";\n  public constructor(elementId: Id64String, relClassName: string = ElementOwnsMultiAspects.classFullName) {\n    super({ id: elementId, relClassName });\n  }\n}\n\n/** Relates an [[Element]] and an [[ExternalSourceAspect]] that it owns.\n * @public\n */\nexport class ElementOwnsExternalSourceAspects extends ElementOwnsMultiAspects {\n  public static override classFullName = \"BisCore:ElementOwnsExternalSourceAspects\";\n  public constructor(elementId: Id64String, relClassName: string = ElementOwnsExternalSourceAspects.classFullName) {\n    super(elementId, relClassName);\n  }\n}\n\n/** Relates an [[ExternalSource]] to the [[RepositoryLink]] that it is persisted in.\n * @note The associated ECClass was added to the BisCore schema in version 1.0.13\n * @beta\n */\nexport class ExternalSourceIsInRepository extends RelatedElement {\n  public static classFullName = \"BisCore:ExternalSourceIsInRepository\";\n  public constructor(repositoryId: Id64String, relClassName: string = ExternalSourceIsInRepository.classFullName) {\n    super({ id: repositoryId, relClassName });\n  }\n}\n\n/** Relates an [[ExternalSource]] to the [[RepositoryLink]] that it is persisted in.\n * @note The associated ECClass was added to the BisCore schema in version 1.0.13\n * @beta\n */\nexport class ExternalSourceAttachmentAttachesSource extends RelatedElement {\n  public static classFullName = \"BisCore:ExternalSourceAttachmentAttachesSource\";\n  public constructor(externalSourceId: Id64String, relClassName: string = ExternalSourceAttachmentAttachesSource.classFullName) {\n    super({ id: externalSourceId, relClassName });\n  }\n}\n\n/** Relates a [[SheetReference]] and [[Sheet]] that it refers.\n * @beta\n */\nexport class SheetReferenceRefersToSheet extends RelatedElement {\n  public static classFullName = \"BisCore:SheetReferenceRefersToSheet\";\n  public constructor(sheetId: Id64String, relClassName: string = SheetReferenceRefersToSheet.classFullName) {\n    super({ id: sheetId, relClassName });\n  }\n}\n\n/** Relates a [[SheetIndexReference]] to a [[SheetIndex]] it refers.\n * @beta\n */\nexport class SheetIndexReferenceRefersToSheetIndex extends RelatedElement {\n  public static classFullName = \"BisCore:SheetIndexReferenceRefersToSheetIndex\";\n  public constructor(sheetIndexId: Id64String, relClassName: string = SheetIndexReferenceRefersToSheetIndex.classFullName) {\n    super({ id: sheetIndexId, relClassName });\n  }\n}\n\n/** Relates a [[Subject]] to the [[ProjectInformationRecord]] that describes its project-level properties.\n * @beta\n */\nexport class SubjectOwnsProjectInformationRecord extends ElementOwnsChildElements {\n  public static override classFullName = \"BisCore:SubjectOwnsProjectInformationRecord\";\n  public constructor(parentId: Id64String, relClassName = SubjectOwnsProjectInformationRecord.classFullName) {\n    super(parentId, relClassName);\n  }\n}\n\n/** Relates a [[Sheet]] to the [[SheetInformationAspect]] that hosts its basic [SheetInformation]($common).\n * @see [[SheetInformationAspect.setSheetInformation]] to create an instance of this relationship.\n * @beta\n */\nexport class SheetOwnsSheetInformationAspect extends ElementOwnsUniqueAspect {\n  public static override classFullName = \"BisCore:SheetOwnsSheetInformationAspect\";\n\n  public constructor(sheetId: Id64String, relClassName = SheetOwnsSheetInformationAspect.classFullName) {\n    super(sheetId, relClassName);\n  }\n}\n\n/** Relates an [[Element]] to the [[ChannelRootAspect]] that identifies it as a channel root.\n * @see [[ChannelControl.makeChannelRoot]] to create an instance of this relationship.\n * @public\n */\nexport class ElementOwnsChannelRootAspect extends ElementOwnsUniqueAspect {\n  public static override classFullName = \"BisCore:ElementOwnsChannelRootAspect\";\n\n  public constructor(elementId: Id64String, relClassName = ElementOwnsChannelRootAspect.classFullName) {\n    super(elementId, relClassName);\n  }\n}\n"]}

package/lib/esm/PartialChangeUnifier.d.ts

@@ -0,0 +1,77 @@
+import { ChangeInstance, ChangeSource } from "./ChangesetReaderTypes";
+/**
+ * Cache used by [[PartialChangeUnifier]] to accumulate and merge
+ * partial EC change instances.
+ * @beta
+ */
+export interface ChangeCache extends Disposable {
+    /** Retrieve a cached instance by key, or `undefined` if absent. */
+    get(key: string): ChangeInstance | undefined;
+    /** Insert or replace a cached instance. */
+    set(key: string, value: ChangeInstance): void;
+    /** Iterate over all cached instances. */
+    all(): IterableIterator<ChangeInstance>;
+    /** Number of instances currently in the cache. */
+    count(): number;
+}
+/** @beta */
+export declare namespace ChangeUnifierCache {
+    /**
+     * Creates an in-memory cache backed by a `Map`.
+     * Fast, but may exhaust memory for very large changesets.
+     * @returns An [[ChangeCache]] backed by an in-memory `Map`.
+     * @beta
+     */
+    function createInMemoryCache(): ChangeCache;
+    /**
+     * Creates a SQLite-backed cache stored in a temporary SQlite database.
+     * Slower than in-memory but useful in handling large changesets.
+     * Temporary SQlite database is first created in memory and
+     * parts of a temporary database might be flushed to disk if the database becomes large or
+     * if SQLite comes under memory pressure.
+     * @param bufferedReadInstanceSizeInBytes Read-batch size in bytes (default 10 MB).
+     * @returns An [[ChangeCache]] backed by a SQLite temp table.
+     * @beta
+     */
+    function createSqliteBackedCache(bufferedReadInstanceSizeInBytes?: number): ChangeCache;
+}
+/**
+ * Combines partial EC change instances (one per SQLite table row) into complete
+ * instances that span all tables mapping to a single EC entity.
+ *
+ * The merge key is derived from the `instanceKey` and `stage` stored in `$meta.instanceKey` and `$meta.stage`.
+ *
+ * **Usage:**
+ * ```ts
+ * using reader = ChangesetReader.openFile({ fileName, db });
+ * using unifier = new PartialChangeUnifier();
+ * while (reader.step()) {
+ *   unifier.appendFrom(reader);
+ * }
+ * for (const instance of unifier.instances) { ... }
+ * ```
+ * @beta
+ */
+export declare class PartialChangeUnifier implements Disposable {
+    private readonly _cache;
+    constructor(_cache?: ChangeCache);
+    /** Releases the underlying cache. */
+    [Symbol.dispose](): void;
+    /** Number of complete (merged) instances currently accumulated. */
+    get instanceCount(): number;
+    /**
+     * Append partial changes from the current reader row and merge them into the cache.
+     *
+     * @param source Any [ChangeSource]($backend) positioned on a valid row.
+     * @beta
+     */
+    appendFrom(source: ChangeSource): void;
+    /**
+     * Iterator over all fully-merged EC change instances.
+     * @beta
+     */
+    get instances(): IterableIterator<ChangeInstance>;
+    private buildKey;
+    private combine;
+}
+//# sourceMappingURL=PartialChangeUnifier.d.ts.map

package/lib/esm/PartialChangeUnifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PartialChangeUnifier.d.ts","sourceRoot":"","sources":["../../src/PartialChangeUnifier.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAQtE;;;;GAIG;AACH,MAAM,WAAW,WAAY,SAAQ,UAAU;IAC7C,mEAAmE;IACnE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;IAC7C,2CAA2C;IAC3C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IAC9C,yCAAyC;IACzC,GAAG,IAAI,gBAAgB,CAAC,cAAc,CAAC,CAAC;IACxC,kDAAkD;IAClD,KAAK,IAAI,MAAM,CAAC;CACjB;AAED,YAAY;AACZ,yBAAiB,kBAAkB,CAAC;IAClC;;;;;OAKG;IACH,SAAgB,mBAAmB,IAAI,WAAW,CAEjD;IAED;;;;;;;;;OASG;IACH,SAAgB,uBAAuB,CACrC,+BAA+B,SAAmB,GACjD,WAAW,CAEb;CACF;AAuID;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,oBAAqB,YAAW,UAAU;IAEnD,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,GAAE,WAAiC;IAG5D,qCAAqC;IAC9B,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;IAI/B,mEAAmE;IACnE,IAAW,aAAa,IAAI,MAAM,CAEjC;IAED;;;;;OAKG;IACI,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAa7C;;;OAGG;IACH,IAAW,SAAS,IAAI,gBAAgB,CAAC,cAAc,CAAC,CAEvD;IAMD,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,OAAO;CAiBhB"}

package/lib/esm/PartialChangeUnifier.js

@@ -0,0 +1,230 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module ECDb
+ */
+import { DbResult, Guid, OpenMode } from "@itwin/core-bentley";
+import { Base64EncodedString } from "@itwin/core-common";
+import { SQLiteDb } from "./SQLiteDb";
+/** @beta */
+export var ChangeUnifierCache;
+(function (ChangeUnifierCache) {
+    /**
+     * Creates an in-memory cache backed by a `Map`.
+     * Fast, but may exhaust memory for very large changesets.
+     * @returns An [[ChangeCache]] backed by an in-memory `Map`.
+     * @beta
+     */
+    function createInMemoryCache() {
+        return new InMemoryCache();
+    }
+    ChangeUnifierCache.createInMemoryCache = createInMemoryCache;
+    /**
+     * Creates a SQLite-backed cache stored in a temporary SQlite database.
+     * Slower than in-memory but useful in handling large changesets.
+     * Temporary SQlite database is first created in memory and
+     * parts of a temporary database might be flushed to disk if the database becomes large or
+     * if SQLite comes under memory pressure.
+     * @param bufferedReadInstanceSizeInBytes Read-batch size in bytes (default 10 MB).
+     * @returns An [[ChangeCache]] backed by a SQLite temp table.
+     * @beta
+     */
+    function createSqliteBackedCache(bufferedReadInstanceSizeInBytes = 1024 * 1024 * 10) {
+        return new SqliteBackedCache(bufferedReadInstanceSizeInBytes);
+    }
+    ChangeUnifierCache.createSqliteBackedCache = createSqliteBackedCache;
+})(ChangeUnifierCache || (ChangeUnifierCache = {}));
+// ---------------------------------------------------------------------------
+// Private: InMemoryCache
+// ---------------------------------------------------------------------------
+class InMemoryCache {
+    _cache = new Map();
+    get(key) {
+        return this._cache.get(key);
+    }
+    set(key, value) {
+        // Remove undefined meta keys to keep serialised form compact.
+        const meta = value.$meta;
+        if (meta) {
+            Object.keys(meta).forEach((k) => meta[k] === undefined && delete meta[k]);
+        }
+        this._cache.set(key, value);
+    }
+    *all() {
+        for (const key of Array.from(this._cache.keys()).sort()) {
+            const instance = this._cache.get(key);
+            if (instance)
+                yield instance;
+        }
+    }
+    count() {
+        return this._cache.size;
+    }
+    [Symbol.dispose]() {
+        this._cache.clear();
+    }
+}
+// ---------------------------------------------------------------------------
+// Private: NativeSqliteBackedInstanceCache
+// ---------------------------------------------------------------------------
+class SqliteBackedCache {
+    bufferedReadInstanceSizeInBytes;
+    _cacheTable = `[${Guid.createValue()}]`;
+    static defaultBufferSize = 1024 * 1024 * 10; // 10 MB
+    _db;
+    constructor(bufferedReadInstanceSizeInBytes = SqliteBackedCache.defaultBufferSize) {
+        this.bufferedReadInstanceSizeInBytes = bufferedReadInstanceSizeInBytes;
+        this._db = new SQLiteDb();
+        this._db.openDb("", { skipFileCheck: true, rawSQLite: true, openMode: OpenMode.ReadWrite }); // creating temp sqlite db https://sqlite.org/inmemorydb.html#:~:text=Temporary%20Databases,under%20the%20default%20SQLite%20configuration.
+        if (bufferedReadInstanceSizeInBytes <= 0)
+            throw new Error("bufferedReadInstanceSizeInBytes must be greater than 0");
+        this.createTempTable();
+    }
+    createTempTable() {
+        this._db.withSqliteStatement(`CREATE TABLE ${this._cacheTable} ([key] text primary key, [value] text)`, (stmt) => {
+            if (DbResult.BE_SQLITE_DONE !== stmt.step())
+                throw new Error("unable to create temp cache table");
+        });
+    }
+    get(key) {
+        return this._db.withPreparedSqliteStatement(`SELECT [value] FROM ${this._cacheTable} WHERE [key]=?`, (stmt) => {
+            stmt.reset();
+            stmt.clearBindings();
+            stmt.bindString(1, key);
+            if (stmt.step() === DbResult.BE_SQLITE_ROW)
+                return JSON.parse(stmt.getValueString(0), Base64EncodedString.reviver);
+            return undefined;
+        });
+    }
+    set(key, value) {
+        const shallowCopy = Object.assign({}, value);
+        this._db.withPreparedSqliteStatement(`INSERT INTO ${this._cacheTable} ([key], [value]) VALUES (?, ?) ON CONFLICT ([key]) DO UPDATE SET [value] = [excluded].[value]`, (stmt) => {
+            stmt.reset();
+            stmt.clearBindings();
+            stmt.bindString(1, key);
+            stmt.bindString(2, JSON.stringify(shallowCopy, Base64EncodedString.replacer));
+            stmt.step();
+        });
+    }
+    *all() {
+        const sql = `
+      SELECT JSON_GROUP_ARRAY(JSON([value]))
+      FROM (
+        SELECT [value],
+               SUM(LENGTH([value])) OVER (ORDER BY [key] ROWS UNBOUNDED PRECEDING) / ${this.bufferedReadInstanceSizeInBytes} AS [bucket]
+        FROM ${this._cacheTable}
+      )
+      GROUP BY [bucket]`;
+        const stmt = this._db.prepareSqliteStatement(sql);
+        try {
+            while (stmt.step() === DbResult.BE_SQLITE_ROW) {
+                const bucket = JSON.parse(stmt.getValueString(0), Base64EncodedString.reviver);
+                for (const instance of bucket)
+                    yield instance;
+            }
+        }
+        finally {
+            stmt[Symbol.dispose]();
+        }
+    }
+    count() {
+        return this._db.withPreparedSqliteStatement(`SELECT COUNT(*) FROM ${this._cacheTable}`, (stmt) => {
+            stmt.reset();
+            if (stmt.step() === DbResult.BE_SQLITE_ROW)
+                return stmt.getValue(0).getInteger();
+            return 0;
+        });
+    }
+    [Symbol.dispose]() {
+        this._db.closeDb();
+    }
+}
+// ---------------------------------------------------------------------------
+// PartialChangeUnifier
+// ---------------------------------------------------------------------------
+/**
+ * Combines partial EC change instances (one per SQLite table row) into complete
+ * instances that span all tables mapping to a single EC entity.
+ *
+ * The merge key is derived from the `instanceKey` and `stage` stored in `$meta.instanceKey` and `$meta.stage`.
+ *
+ * **Usage:**
+ * ```ts
+ * using reader = ChangesetReader.openFile({ fileName, db });
+ * using unifier = new PartialChangeUnifier();
+ * while (reader.step()) {
+ *   unifier.appendFrom(reader);
+ * }
+ * for (const instance of unifier.instances) { ... }
+ * ```
+ * @beta
+ */
+export class PartialChangeUnifier {
+    _cache;
+    constructor(_cache = new InMemoryCache()) {
+        this._cache = _cache;
+    }
+    /** Releases the underlying cache. */
+    [Symbol.dispose]() {
+        this._cache[Symbol.dispose]();
+    }
+    /** Number of complete (merged) instances currently accumulated. */
+    get instanceCount() {
+        return this._cache.count();
+    }
+    /**
+     * Append partial changes from the current reader row and merge them into the cache.
+     *
+     * @param source Any [ChangeSource]($backend) positioned on a valid row.
+     * @beta
+     */
+    appendFrom(source) {
+        if (source.op === "Updated") {
+            if (source.inserted)
+                this.combine(source.inserted);
+            if (source.deleted)
+                this.combine(source.deleted);
+        }
+        else if (source.op === "Inserted" && source.inserted) {
+            this.combine(source.inserted);
+        }
+        else if (source.op === "Deleted" && source.deleted) {
+            this.combine(source.deleted);
+        }
+    }
+    /**
+     * Iterator over all fully-merged EC change instances.
+     * @beta
+     */
+    get instances() {
+        return this._cache.all();
+    }
+    // ---------------------------------------------------------------------------
+    // Private helpers
+    // ---------------------------------------------------------------------------
+    buildKey(instance) {
+        const { instanceKey, stage } = instance.$meta;
+        return `${instanceKey}-${stage}`.toLowerCase();
+    }
+    combine(rhs) {
+        const key = this.buildKey(rhs);
+        const lhs = this._cache.get(key);
+        if (lhs) {
+            // Merge data fields — rhs wins for any overlapping columns.
+            const { $meta: _rhsMeta, ...rhsData } = rhs;
+            Object.assign(lhs, rhsData);
+            // Accumulate per-table metadata lists.
+            lhs.$meta.tables = [...lhs.$meta.tables, ...rhs.$meta.tables];
+            lhs.$meta.changeIndexes = [...lhs.$meta.changeIndexes, ...rhs.$meta.changeIndexes];
+            // ECInstanceId will be part of changeset fetchedProps for every table, so we should not include multiple of those in the final list
+            lhs.$meta.changeFetchedPropNames = [...new Set([...lhs.$meta.changeFetchedPropNames, ...rhs.$meta.changeFetchedPropNames])];
+            this._cache.set(key, lhs);
+        }
+        else {
+            this._cache.set(key, rhs);
+        }
+    }
+}
+//# sourceMappingURL=PartialChangeUnifier.js.map

package/lib/esm/PartialChangeUnifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PartialChangeUnifier.js","sourceRoot":"","sources":["../../src/PartialChangeUnifier.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 ECDb\n */\nimport { DbResult, Guid, OpenMode } from \"@itwin/core-bentley\";\nimport { Base64EncodedString } from \"@itwin/core-common\";\nimport { SqliteStatement } from \"./SqliteStatement\";\nimport { ChangeInstance, ChangeSource } from \"./ChangesetReaderTypes\";\nimport { _nativeDb } from \"./internal/Symbols\";\nimport { SQLiteDb } from \"./SQLiteDb\";\n\n// ---------------------------------------------------------------------------\n// ChangeCache — interface + factory\n// ---------------------------------------------------------------------------\n\n/**\n * Cache used by [[PartialChangeUnifier]] to accumulate and merge\n * partial EC change instances.\n * @beta\n */\nexport interface ChangeCache extends Disposable {\n  /** Retrieve a cached instance by key, or `undefined` if absent. */\n  get(key: string): ChangeInstance | undefined;\n  /** Insert or replace a cached instance. */\n  set(key: string, value: ChangeInstance): void;\n  /** Iterate over all cached instances. */\n  all(): IterableIterator<ChangeInstance>;\n  /** Number of instances currently in the cache. */\n  count(): number;\n}\n\n/** @beta */\nexport namespace ChangeUnifierCache {\n  /**\n   * Creates an in-memory cache backed by a `Map`.\n   * Fast, but may exhaust memory for very large changesets.\n   * @returns An [[ChangeCache]] backed by an in-memory `Map`.\n   * @beta\n   */\n  export function createInMemoryCache(): ChangeCache {\n    return new InMemoryCache();\n  }\n\n  /**\n   * Creates a SQLite-backed cache stored in a temporary SQlite database.\n   * Slower than in-memory but useful in handling large changesets.\n   * Temporary SQlite database is first created in memory and\n   * parts of a temporary database might be flushed to disk if the database becomes large or\n   * if SQLite comes under memory pressure.\n   * @param bufferedReadInstanceSizeInBytes Read-batch size in bytes (default 10 MB).\n   * @returns An [[ChangeCache]] backed by a SQLite temp table.\n   * @beta\n   */\n  export function createSqliteBackedCache(\n    bufferedReadInstanceSizeInBytes = 1024 * 1024 * 10,\n  ): ChangeCache {\n    return new SqliteBackedCache(bufferedReadInstanceSizeInBytes);\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Private: InMemoryCache\n// ---------------------------------------------------------------------------\n\nclass InMemoryCache implements ChangeCache {\n  private readonly _cache = new Map<string, ChangeInstance>();\n\n  public get(key: string): ChangeInstance | undefined {\n    return this._cache.get(key);\n  }\n\n  public set(key: string, value: ChangeInstance): void {\n    // Remove undefined meta keys to keep serialised form compact.\n    const meta = value.$meta as any;\n    if (meta) {\n      Object.keys(meta).forEach((k) => meta[k] === undefined && delete meta[k]);\n    }\n    this._cache.set(key, value);\n  }\n\n  public *all(): IterableIterator<ChangeInstance> {\n    for (const key of Array.from(this._cache.keys()).sort()) {\n      const instance = this._cache.get(key);\n      if (instance)\n        yield instance;\n    }\n  }\n\n  public count(): number {\n    return this._cache.size;\n  }\n\n  public [Symbol.dispose](): void {\n    this._cache.clear();\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Private: NativeSqliteBackedInstanceCache\n// ---------------------------------------------------------------------------\n\nclass SqliteBackedCache implements ChangeCache {\n  private readonly _cacheTable = `[${Guid.createValue()}]`;\n  public static readonly defaultBufferSize = 1024 * 1024 * 10; // 10 MB\n  private _db: SQLiteDb;\n  public constructor(\n    public readonly bufferedReadInstanceSizeInBytes: number = SqliteBackedCache.defaultBufferSize,\n  ) {\n    this._db = new SQLiteDb();\n    this._db.openDb(\"\", { skipFileCheck: true, rawSQLite: true, openMode: OpenMode.ReadWrite }); // creating temp sqlite db https://sqlite.org/inmemorydb.html#:~:text=Temporary%20Databases,under%20the%20default%20SQLite%20configuration.\n    if (bufferedReadInstanceSizeInBytes <= 0)\n      throw new Error(\"bufferedReadInstanceSizeInBytes must be greater than 0\");\n    this.createTempTable();\n  }\n\n  private createTempTable(): void {\n    this._db.withSqliteStatement(`CREATE TABLE ${this._cacheTable} ([key] text primary key, [value] text)`, (stmt: SqliteStatement) => {\n      if (DbResult.BE_SQLITE_DONE !== stmt.step())\n        throw new Error(\"unable to create temp cache table\");\n    });\n  }\n\n  public get(key: string): ChangeInstance | undefined {\n    return this._db.withPreparedSqliteStatement(\n      `SELECT [value] FROM ${this._cacheTable} WHERE [key]=?`,\n      (stmt: SqliteStatement) => {\n        stmt.reset();\n        stmt.clearBindings();\n        stmt.bindString(1, key);\n        if (stmt.step() === DbResult.BE_SQLITE_ROW)\n          return JSON.parse(stmt.getValueString(0), Base64EncodedString.reviver) as ChangeInstance;\n        return undefined;\n      },\n    );\n  }\n\n  public set(key: string, value: ChangeInstance): void {\n    const shallowCopy = Object.assign({}, value);\n    this._db.withPreparedSqliteStatement(\n      `INSERT INTO ${this._cacheTable} ([key], [value]) VALUES (?, ?) ON CONFLICT ([key]) DO UPDATE SET [value] = [excluded].[value]`,\n      (stmt: SqliteStatement) => {\n        stmt.reset();\n        stmt.clearBindings();\n        stmt.bindString(1, key);\n        stmt.bindString(2, JSON.stringify(shallowCopy, Base64EncodedString.replacer));\n        stmt.step();\n      },\n    );\n  }\n\n  public *all(): IterableIterator<ChangeInstance> {\n    const sql = `\n      SELECT JSON_GROUP_ARRAY(JSON([value]))\n      FROM (\n        SELECT [value],\n               SUM(LENGTH([value])) OVER (ORDER BY [key] ROWS UNBOUNDED PRECEDING) / ${this.bufferedReadInstanceSizeInBytes} AS [bucket]\n        FROM ${this._cacheTable}\n      )\n      GROUP BY [bucket]`;\n\n    const stmt = this._db.prepareSqliteStatement(sql);\n    try {\n      while (stmt.step() === DbResult.BE_SQLITE_ROW) {\n        const bucket = JSON.parse(stmt.getValueString(0), Base64EncodedString.reviver) as ChangeInstance[];\n        for (const instance of bucket)\n          yield instance;\n      }\n    } finally {\n      stmt[Symbol.dispose]();\n    }\n  }\n\n  public count(): number {\n    return this._db.withPreparedSqliteStatement(\n      `SELECT COUNT(*) FROM ${this._cacheTable}`,\n      (stmt: SqliteStatement) => {\n        stmt.reset();\n        if (stmt.step() === DbResult.BE_SQLITE_ROW)\n          return stmt.getValue(0).getInteger();\n        return 0;\n      },\n    );\n  }\n\n  public [Symbol.dispose](): void {\n    this._db.closeDb();\n  }\n}\n\n// ---------------------------------------------------------------------------\n// PartialChangeUnifier\n// ---------------------------------------------------------------------------\n\n/**\n * Combines partial EC change instances (one per SQLite table row) into complete\n * instances that span all tables mapping to a single EC entity.\n *\n * The merge key is derived from the `instanceKey` and `stage` stored in `$meta.instanceKey` and `$meta.stage`.\n *\n * **Usage:**\n * ```ts\n * using reader = ChangesetReader.openFile({ fileName, db });\n * using unifier = new PartialChangeUnifier();\n * while (reader.step()) {\n *   unifier.appendFrom(reader);\n * }\n * for (const instance of unifier.instances) { ... }\n * ```\n * @beta\n */\nexport class PartialChangeUnifier implements Disposable {\n  public constructor(\n    private readonly _cache: ChangeCache = new InMemoryCache(),\n  ) { }\n\n  /** Releases the underlying cache. */\n  public [Symbol.dispose](): void {\n    this._cache[Symbol.dispose]();\n  }\n\n  /** Number of complete (merged) instances currently accumulated. */\n  public get instanceCount(): number {\n    return this._cache.count();\n  }\n\n  /**\n   * Append partial changes from the current reader row and merge them into the cache.\n   *\n   * @param source Any [ChangeSource]($backend) positioned on a valid row.\n   * @beta\n   */\n  public appendFrom(source: ChangeSource): void {\n    if (source.op === \"Updated\") {\n      if (source.inserted)\n        this.combine(source.inserted);\n      if (source.deleted)\n        this.combine(source.deleted);\n    } else if (source.op === \"Inserted\" && source.inserted) {\n      this.combine(source.inserted);\n    } else if (source.op === \"Deleted\" && source.deleted) {\n      this.combine(source.deleted);\n    }\n  }\n\n  /**\n   * Iterator over all fully-merged EC change instances.\n   * @beta\n   */\n  public get instances(): IterableIterator<ChangeInstance> {\n    return this._cache.all();\n  }\n\n  // ---------------------------------------------------------------------------\n  // Private helpers\n  // ---------------------------------------------------------------------------\n\n  private buildKey(instance: ChangeInstance): string {\n    const { instanceKey, stage } = instance.$meta;\n    return `${instanceKey}-${stage}`.toLowerCase();\n  }\n\n  private combine(rhs: ChangeInstance): void {\n    const key = this.buildKey(rhs);\n    const lhs = this._cache.get(key);\n    if (lhs) {\n      // Merge data fields — rhs wins for any overlapping columns.\n      const { $meta: _rhsMeta, ...rhsData } = rhs;\n      Object.assign(lhs, rhsData);\n      // Accumulate per-table metadata lists.\n      lhs.$meta.tables = [...lhs.$meta.tables, ...rhs.$meta.tables];\n      lhs.$meta.changeIndexes = [...lhs.$meta.changeIndexes, ...rhs.$meta.changeIndexes];\n      // ECInstanceId will be part of changeset fetchedProps for every table, so we should not include multiple of those in the final list\n      lhs.$meta.changeFetchedPropNames = [...new Set([...lhs.$meta.changeFetchedPropNames, ...rhs.$meta.changeFetchedPropNames])];\n      this._cache.set(key, lhs);\n    } else {\n      this._cache.set(key, rhs);\n    }\n  }\n}\n"]}

package/lib/esm/PromiseMemoizer.js.map

@@ -1 +1 @@
-{"version":3,"file":"PromiseMemoizer.js","sourceRoot":"","sources":["../../src/PromiseMemoizer.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\nimport { Logger } from \"@itwin/core-bentley\";\r\nimport { BackendLoggerCategory } from \"./BackendLoggerCategory\";\r\n\r\n/** Wrapper around a promise that allows synchronous queries of it's state\r\n * @internal\r\n */\r\nexport class QueryablePromise<T> {\r\n  public result?: T;\r\n  public error?: any;\r\n\r\n  private _fulfilled: boolean = false;\r\n  private _rejected: boolean = false;\r\n\r\n  public get isPending(): boolean { return !this.isFulfilled && !this.isRejected; }\r\n  public get isFulfilled(): boolean { return this._fulfilled; }\r\n  public get isRejected(): boolean { return this._rejected; }\r\n  public constructor(public readonly promise: Promise<T>) {\r\n    this.promise.then((res: T) => {\r\n      this.result = res;\r\n      this._fulfilled = true;\r\n    }).catch((err: any) => {\r\n      this.error = err;\r\n      this._rejected = true;\r\n    });\r\n  }\r\n}\r\n\r\n/** @internal */\r\nexport type MemoizeFnType<T> = (...args: any[]) => Promise<T>;\r\n/** @internal */\r\nexport type GenerateKeyFnType = (...args: any[]) => string;\r\n\r\n/** Utility to cache and retrieve results of long running asynchronous functions.\r\n * The cache is keyed on the input arguments passed to these functions\r\n * @internal\r\n */\r\nexport class PromiseMemoizer<T> implements Disposable {\r\n  private readonly _cachedPromises: Map<string, QueryablePromise<T>> = new Map<string, QueryablePromise<T>>();\r\n  private readonly _timers: Map<string, NodeJS.Timeout> = new Map<string, NodeJS.Timeout>();\r\n  private readonly _memoizeFn: MemoizeFnType<T>;\r\n  private readonly _generateKeyFn: GenerateKeyFnType;\r\n  private readonly _maxCacheSize: number;\r\n  private readonly _cacheTimeout: number;\r\n\r\n  /**\r\n   * Constructor\r\n   * @param memoizeFn Function to memoize\r\n   * @param generateKeyFn Function to generate the key for the memoized function\r\n   * @param maxCacheSize Maximum size of the memoizer cache.\r\n   * If the maximum cache size is exceeded, fulfilled/rejected entries are first discarded - these\r\n   * may have been unclaimed/orphaned promises. If the cache size is still above the maxCacheSize\r\n   * threshold, the entire cache is then cleared.\r\n   */\r\n  public constructor(memoizeFn: MemoizeFnType<T>, generateKeyFn: GenerateKeyFnType, maxCacheSize: number = 500, cacheTimeout: number = 30000) {\r\n    this._memoizeFn = memoizeFn;\r\n    this._generateKeyFn = generateKeyFn;\r\n    this._maxCacheSize = maxCacheSize;\r\n    this._cacheTimeout = cacheTimeout;\r\n  }\r\n\r\n  /** Call the memoized function */\r\n  public memoize(...args: any[]): QueryablePromise<T> {\r\n    const key: string = this._generateKeyFn(...args);\r\n    let qp: QueryablePromise<T> | undefined = this._cachedPromises.get(key);\r\n    if (qp)\r\n      return qp;\r\n\r\n    if (this._cachedPromises.size >= this._maxCacheSize) {\r\n      if (this._maxCacheSize > 1)\r\n        Logger.logError(BackendLoggerCategory.PromiseMemoizer, \"Cleared too many unresolved entries in memoizer cache\");\r\n      this.clearCache();\r\n    }\r\n\r\n    const removeCachedPromise = (v: T) => {\r\n      const cleanUp = () => {\r\n        this._cachedPromises.delete(key);\r\n        this._timers.delete(key);\r\n      };\r\n      this._timers.set(key, setTimeout(cleanUp, this._cacheTimeout));\r\n      return v;\r\n    };\r\n\r\n    const p = this._memoizeFn(...args).then(removeCachedPromise, (e) => {\r\n      throw removeCachedPromise(e); // eslint-disable-line @typescript-eslint/only-throw-error\r\n    });\r\n\r\n    qp = new QueryablePromise<T>(p);\r\n    this._cachedPromises.set(key, qp);\r\n    return qp;\r\n  }\r\n\r\n  /** Delete the memoized function */\r\n  public deleteMemoized(...args: any[]) {\r\n    const key: string = this._generateKeyFn(...args);\r\n    this._cachedPromises.delete(key);\r\n    const timer = this._timers.get(key);\r\n    if (timer)\r\n      clearTimeout(timer);\r\n  }\r\n\r\n  /** Clear all entries in the memoizer cache */\r\n  public clearCache() {\r\n    this._cachedPromises.clear();\r\n  }\r\n\r\n  public [Symbol.dispose]() {\r\n    for (const timer of this._timers.values())\r\n      clearTimeout(timer);\r\n\r\n    this._timers.clear();\r\n    this.clearCache();\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"PromiseMemoizer.js","sourceRoot":"","sources":["../../src/PromiseMemoizer.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;GAEG;AACH,MAAM,OAAO,gBAAgB;IAUQ;IAT5B,MAAM,CAAK;IACX,KAAK,CAAO;IAEX,UAAU,GAAY,KAAK,CAAC;IAC5B,SAAS,GAAY,KAAK,CAAC;IAEnC,IAAW,SAAS,KAAc,OAAO,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IACjF,IAAW,WAAW,KAAc,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IAC7D,IAAW,UAAU,KAAc,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IAC3D,YAAmC,OAAmB;QAAnB,YAAO,GAAP,OAAO,CAAY;QACpD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAM,EAAE,EAAE;YAC3B,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC;YAClB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACzB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAQ,EAAE,EAAE;YACpB,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC;YACjB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACxB,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAOD;;;GAGG;AACH,MAAM,OAAO,eAAe;IACT,eAAe,GAAqC,IAAI,GAAG,EAA+B,CAAC;IAC3F,OAAO,GAAgC,IAAI,GAAG,EAA0B,CAAC;IACzE,UAAU,CAAmB;IAC7B,cAAc,CAAoB;IAClC,aAAa,CAAS;IACtB,aAAa,CAAS;IAEvC;;;;;;;;OAQG;IACH,YAAmB,SAA2B,EAAE,aAAgC,EAAE,eAAuB,GAAG,EAAE,eAAuB,KAAK;QACxI,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,cAAc,GAAG,aAAa,CAAC;QACpC,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC;QAClC,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC;IACpC,CAAC;IAED,iCAAiC;IAC1B,OAAO,CAAC,GAAG,IAAW;QAC3B,MAAM,GAAG,GAAW,IAAI,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC,CAAC;QACjD,IAAI,EAAE,GAAoC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACxE,IAAI,EAAE;YACJ,OAAO,EAAE,CAAC;QAEZ,IAAI,IAAI,CAAC,eAAe,CAAC,IAAI,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACpD,IAAI,IAAI,CAAC,aAAa,GAAG,CAAC;gBACxB,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAC,eAAe,EAAE,uDAAuD,CAAC,CAAC;YAClH,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,CAAC;QAED,MAAM,mBAAmB,GAAG,CAAC,CAAI,EAAE,EAAE;YACnC,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACjC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC3B,CAAC,CAAC;YACF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;YAC/D,OAAO,CAAC,CAAC;QACX,CAAC,CAAC;QAEF,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC,CAAC,EAAE,EAAE;YACjE,MAAM,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,0DAA0D;QAC1F,CAAC,CAAC,CAAC;QAEH,EAAE,GAAG,IAAI,gBAAgB,CAAI,CAAC,CAAC,CAAC;QAChC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAClC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,mCAAmC;IAC5B,cAAc,CAAC,GAAG,IAAW;QAClC,MAAM,GAAG,GAAW,IAAI,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,KAAK;YACP,YAAY,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IAED,8CAA8C;IACvC,UAAU;QACf,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;IAEM,CAAC,MAAM,CAAC,OAAO,CAAC;QACrB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;YACvC,YAAY,CAAC,KAAK,CAAC,CAAC;QAEtB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,UAAU,EAAE,CAAC;IACpB,CAAC;CACF","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\nimport { Logger } from \"@itwin/core-bentley\";\nimport { BackendLoggerCategory } from \"./BackendLoggerCategory\";\n\n/** Wrapper around a promise that allows synchronous queries of it's state\n * @internal\n */\nexport class QueryablePromise<T> {\n  public result?: T;\n  public error?: any;\n\n  private _fulfilled: boolean = false;\n  private _rejected: boolean = false;\n\n  public get isPending(): boolean { return !this.isFulfilled && !this.isRejected; }\n  public get isFulfilled(): boolean { return this._fulfilled; }\n  public get isRejected(): boolean { return this._rejected; }\n  public constructor(public readonly promise: Promise<T>) {\n    this.promise.then((res: T) => {\n      this.result = res;\n      this._fulfilled = true;\n    }).catch((err: any) => {\n      this.error = err;\n      this._rejected = true;\n    });\n  }\n}\n\n/** @internal */\nexport type MemoizeFnType<T> = (...args: any[]) => Promise<T>;\n/** @internal */\nexport type GenerateKeyFnType = (...args: any[]) => string;\n\n/** Utility to cache and retrieve results of long running asynchronous functions.\n * The cache is keyed on the input arguments passed to these functions\n * @internal\n */\nexport class PromiseMemoizer<T> implements Disposable {\n  private readonly _cachedPromises: Map<string, QueryablePromise<T>> = new Map<string, QueryablePromise<T>>();\n  private readonly _timers: Map<string, NodeJS.Timeout> = new Map<string, NodeJS.Timeout>();\n  private readonly _memoizeFn: MemoizeFnType<T>;\n  private readonly _generateKeyFn: GenerateKeyFnType;\n  private readonly _maxCacheSize: number;\n  private readonly _cacheTimeout: number;\n\n  /**\n   * Constructor\n   * @param memoizeFn Function to memoize\n   * @param generateKeyFn Function to generate the key for the memoized function\n   * @param maxCacheSize Maximum size of the memoizer cache.\n   * If the maximum cache size is exceeded, fulfilled/rejected entries are first discarded - these\n   * may have been unclaimed/orphaned promises. If the cache size is still above the maxCacheSize\n   * threshold, the entire cache is then cleared.\n   */\n  public constructor(memoizeFn: MemoizeFnType<T>, generateKeyFn: GenerateKeyFnType, maxCacheSize: number = 500, cacheTimeout: number = 30000) {\n    this._memoizeFn = memoizeFn;\n    this._generateKeyFn = generateKeyFn;\n    this._maxCacheSize = maxCacheSize;\n    this._cacheTimeout = cacheTimeout;\n  }\n\n  /** Call the memoized function */\n  public memoize(...args: any[]): QueryablePromise<T> {\n    const key: string = this._generateKeyFn(...args);\n    let qp: QueryablePromise<T> | undefined = this._cachedPromises.get(key);\n    if (qp)\n      return qp;\n\n    if (this._cachedPromises.size >= this._maxCacheSize) {\n      if (this._maxCacheSize > 1)\n        Logger.logError(BackendLoggerCategory.PromiseMemoizer, \"Cleared too many unresolved entries in memoizer cache\");\n      this.clearCache();\n    }\n\n    const removeCachedPromise = (v: T) => {\n      const cleanUp = () => {\n        this._cachedPromises.delete(key);\n        this._timers.delete(key);\n      };\n      this._timers.set(key, setTimeout(cleanUp, this._cacheTimeout));\n      return v;\n    };\n\n    const p = this._memoizeFn(...args).then(removeCachedPromise, (e) => {\n      throw removeCachedPromise(e); // eslint-disable-line @typescript-eslint/only-throw-error\n    });\n\n    qp = new QueryablePromise<T>(p);\n    this._cachedPromises.set(key, qp);\n    return qp;\n  }\n\n  /** Delete the memoized function */\n  public deleteMemoized(...args: any[]) {\n    const key: string = this._generateKeyFn(...args);\n    this._cachedPromises.delete(key);\n    const timer = this._timers.get(key);\n    if (timer)\n      clearTimeout(timer);\n  }\n\n  /** Clear all entries in the memoizer cache */\n  public clearCache() {\n    this._cachedPromises.clear();\n  }\n\n  public [Symbol.dispose]() {\n    for (const timer of this._timers.values())\n      clearTimeout(timer);\n\n    this._timers.clear();\n    this.clearCache();\n  }\n}\n"]}