@itwin/core-backend 4.0.0-dev.99 → 4.0.2

package/lib/cjs/ChangeSummaryManager.js

@@ -68,105 +68,6 @@ class ChangeSummaryManager {
         if (res !== core_bentley_1.DbResult.BE_SQLITE_OK)
             throw new core_common_1.IModelError(res, `Failed to detach Change Cache file from ${iModel.pathName}.`);
     }
-    /** Extracts change summaries from the specified iModel.
-     * Change summaries are extracted from the version the iModel was opened with up through the specified start version.
-     * If no start version has been specified, the first version will be used.
-     * @param accessToken A valid access token string
-     * @param iModel iModel to extract change summaries for. The iModel must not be a standalone iModel.
-     * Note: For every version to extract a summary from, the method moves the iModel to that version before extraction. After
-     * the extraction has completed, the iModel is moved back to the original version.
-     * @param options Extraction options
-     * @return the Ids of the extracted change summaries.
-     * @throws [IModelError]($common) if the iModel is standalone
-     * @deprecated in 2.x. Use [ChangeSummaryManager.createChangeSummaries]($core-backend) instead
-     */
-    static async extractChangeSummaries(accessToken, iModel, options) {
-        if (!iModel?.isOpen)
-            throw new core_common_1.IModelError(core_bentley_1.IModelStatus.BadRequest, "Briefcase must be open");
-        const iModelId = iModel.iModelId;
-        const endChangeSetId = iModel.changeset.id;
-        (0, core_bentley_1.assert)(endChangeSetId.length !== 0);
-        let startChangeSetId = "";
-        if (options) {
-            if (options.startVersion) {
-                startChangeSetId = (await IModelHost_1.IModelHost.hubAccess.getChangesetFromVersion({ version: options.startVersion, accessToken, iModelId })).id;
-            }
-            else if (options.currentVersionOnly) {
-                startChangeSetId = endChangeSetId;
-            }
-        }
-        core_bentley_1.Logger.logInfo(loggerCategory, "Started Change Summary extraction...", () => ({ iModelId, startChangeSetId, endChangeSetId }));
-        const totalPerf = new core_bentley_1.PerfLogger(`ChangeSummaryManager.extractChangeSummaries [ChangeSets: ${startChangeSetId} through ${endChangeSetId}, iModel: ${iModelId}]`);
-        // download necessary changesets if they were not downloaded before and retrieve infos about those changesets
-        let perfLogger = new core_bentley_1.PerfLogger("ChangeSummaryManager.extractChangeSummaries>Retrieve ChangeSetInfos and download Changesets from Hub");
-        const first = (await IModelHost_1.IModelHost.hubAccess.queryChangeset({ iModelId, changeset: { id: startChangeSetId }, accessToken })).index;
-        const end = (await IModelHost_1.IModelHost.hubAccess.queryChangeset({ iModelId, changeset: { id: endChangeSetId }, accessToken })).index;
-        const changeSetInfos = await IModelHost_1.IModelHost.hubAccess.downloadChangesets({ accessToken, iModelId, range: { first, end }, targetDir: BriefcaseManager_1.BriefcaseManager.getChangeSetsPath(iModelId) });
-        perfLogger.dispose();
-        core_bentley_1.Logger.logTrace(loggerCategory, "Retrieved changesets to extract from from cache or from hub.", () => ({ iModelId, startChangeSetId, endChangeSetId, changeSets: changeSetInfos }));
-        // Ensure change cache is detached as it's being written to during the extraction
-        if (this.isChangeCacheAttached(iModel)) {
-            throw new core_common_1.IModelError(core_bentley_1.DbResult.BE_SQLITE_ERROR, "Change cache must be detached before extraction");
-        }
-        perfLogger = new core_bentley_1.PerfLogger("ChangeSummaryManager.extractChangeSummaries>Open or create local Change Cache file");
-        const changesFile = ChangeSummaryManager.openOrCreateChangesFile(iModel);
-        (0, core_bentley_1.assert)(changesFile.nativeDb !== undefined, "Should not happen as an exception should have been thrown in that case");
-        perfLogger.dispose();
-        core_bentley_1.Logger.logTrace(loggerCategory, "Opened or created Changes Cachefile.", () => ({ iModelId, startChangeSetId, endChangeSetId }));
-        try {
-            // extract summaries from end changeset through start changeset, so that we only have to go back in history
-            const changeSetCount = changeSetInfos.length;
-            const endChangeSetIx = changeSetCount - 1;
-            const summaries = [];
-            for (let i = endChangeSetIx; i >= 0; i--) {
-                const currentChangeSetInfo = changeSetInfos[i];
-                const currentChangeSetId = currentChangeSetInfo.id;
-                core_bentley_1.Logger.logInfo(loggerCategory, `Started Change Summary extraction for changeset #${i + 1}...`, () => ({ iModelId, changeSetId: currentChangeSetId }));
-                const existingSummaryId = ChangeSummaryManager.isSummaryAlreadyExtracted(changesFile, currentChangeSetId);
-                if (!!existingSummaryId) {
-                    core_bentley_1.Logger.logInfo(loggerCategory, `Change Summary for changeset #${i + 1} already exists. It is not extracted again.`, () => ({ iModelId, changeSetId: currentChangeSetId }));
-                    summaries.push(existingSummaryId);
-                    continue;
-                }
-                // iModel is at end changeset, so no need to reverse for it.
-                if (i !== endChangeSetIx) {
-                    perfLogger = new core_bentley_1.PerfLogger("ChangeSummaryManager.extractChangeSummaries>Roll iModel to previous changeset");
-                    await iModel.pullChanges({ accessToken, toIndex: currentChangeSetInfo.index });
-                    perfLogger.dispose();
-                    core_bentley_1.Logger.logTrace(loggerCategory, `Moved iModel to changeset #${i + 1} to extract summary from.`, () => ({ iModelId, changeSetId: currentChangeSetId }));
-                }
-                const changeSetFilePath = currentChangeSetInfo.pathname;
-                if (!IModelJsFs_1.IModelJsFs.existsSync(changeSetFilePath))
-                    throw new core_common_1.IModelError(core_bentley_1.IModelStatus.FileNotFound, `Failed to extract change summary: ChangeSet file "${changeSetFilePath}" does not exist.`);
-                perfLogger = new core_bentley_1.PerfLogger("ChangeSummaryManager.extractChangeSummaries>Extract ChangeSummary");
-                const stat = iModel.nativeDb.extractChangeSummary(changesFile.nativeDb, changeSetFilePath);
-                perfLogger.dispose();
-                if (stat.error && stat.error.status !== core_bentley_1.DbResult.BE_SQLITE_OK)
-                    throw new core_common_1.IModelError(stat.error.status, stat.error.message);
-                core_bentley_1.Logger.logTrace(loggerCategory, `Actual Change summary extraction done for changeset #${i + 1}.`, () => ({ iModelId, changeSetId: currentChangeSetId }));
-                perfLogger = new core_bentley_1.PerfLogger("ChangeSummaryManager.extractChangeSummaries>Add ChangeSet info to ChangeSummary");
-                (0, core_bentley_1.assert)(undefined !== stat.result);
-                const changeSummaryId = stat.result;
-                summaries.push(changeSummaryId);
-                ChangeSummaryManager.addExtendedInfos(changesFile, changeSummaryId, currentChangeSetId, currentChangeSetInfo.parentId, currentChangeSetInfo.description, currentChangeSetInfo.pushDate, currentChangeSetInfo.userCreated);
-                perfLogger.dispose();
-                core_bentley_1.Logger.logTrace(loggerCategory, `Added extended infos to Change Summary for changeset #${i + 1}.`, () => ({ iModelId, changeSetId: currentChangeSetId }));
-                core_bentley_1.Logger.logInfo(loggerCategory, `Finished Change Summary extraction for changeset #${i + 1}.`, () => ({ iModelId, changeSetId: currentChangeSetId }));
-            }
-            changesFile.saveChanges();
-            return summaries;
-        }
-        finally {
-            changesFile.dispose();
-            perfLogger = new core_bentley_1.PerfLogger("ChangeSummaryManager.extractChangeSummaries>Move iModel to original changeset");
-            if (iModel.changeset.id !== endChangeSetId)
-                await iModel.pullChanges({ accessToken });
-            perfLogger.dispose();
-            core_bentley_1.Logger.logTrace(loggerCategory, "Moved iModel to initial changeset (the end changeset).", () => ({ iModelId, startChangeSetId, endChangeSetId }));
-            totalPerf.dispose();
-            core_bentley_1.Logger.logInfo(loggerCategory, "Finished Change Summary extraction.", () => ({ iModelId, startChangeSetId, endChangeSetId }));
-        }
-    }
     static openOrCreateChangesFile(iModel) {
         if (!iModel?.isOpen)
             throw new core_common_1.IModelError(core_bentley_1.IModelStatus.BadArg, "Invalid iModel handle. iModel must be open.");
@@ -272,8 +173,8 @@ class ChangeSummaryManager {
         if (!ChangeSummaryManager.isChangeCacheAttached(iModel))
             throw new core_common_1.IModelError(core_bentley_1.IModelStatus.BadArg, "Change Cache file must be attached to iModel.");
         // query instance changes
-        const instanceChange = iModel.withPreparedStatement(`SELECT ic.Summary.Id summaryId, s.Name changedInstanceSchemaName, c.Name changedInstanceClassName, ic.ChangedInstance.Id changedInstanceId,
-       ic.OpCode, ic.IsIndirect FROM ecchange.change.InstanceChange ic JOIN main.meta.ECClassDef c ON c.ECInstanceId = ic.ChangedInstance.ClassId
+        const instanceChange = iModel.withPreparedStatement(`SELECT ic.Summary.Id summaryId, s.Name changedInstanceSchemaName, c.Name changedInstanceClassName, ic.ChangedInstance.Id changedInstanceId,
+       ic.OpCode, ic.IsIndirect FROM ecchange.change.InstanceChange ic JOIN main.meta.ECClassDef c ON c.ECInstanceId = ic.ChangedInstance.ClassId
        JOIN main.meta.ECSchemaDef s ON c.Schema.Id = s.ECInstanceId WHERE ic.ECInstanceId =? `, (stmt) => {
             stmt.bindId(1, instanceChangeId);
             if (stmt.step() !== core_bentley_1.DbResult.BE_SQLITE_ROW)

package/lib/cjs/ChangeSummaryManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"ChangeSummaryManager.js","sourceRoot":"","sources":["../../src/ChangeSummaryManager.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 iModels\r\n */\r\n\r\nimport { AccessToken, assert, DbResult, GuidString, Id64String, IModelStatus, Logger, PerfLogger, using } from \"@itwin/core-bentley\";\r\nimport { ChangedValueState, ChangeOpCode, ChangesetRange, IModelError, IModelVersion } from \"@itwin/core-common\";\r\nimport * as path from \"path\";\r\nimport { BackendLoggerCategory } from \"./BackendLoggerCategory\";\r\nimport { BriefcaseManager } from \"./BriefcaseManager\";\r\nimport { ECDb, ECDbOpenMode } from \"./ECDb\";\r\nimport { ECSqlStatement } from \"./ECSqlStatement\";\r\nimport { BriefcaseDb, IModelDb, TokenArg } from \"./IModelDb\";\r\nimport { IModelHost, KnownLocations } from \"./IModelHost\";\r\nimport { IModelJsFs } from \"./IModelJsFs\";\r\n\r\nconst loggerCategory: string = BackendLoggerCategory.ECDb;\r\n\r\n/** Represents an instance of the `ChangeSummary` ECClass from the `ECDbChange` ECSchema\r\n * combined with the information from the related `Changeset` instance (from the `IModelChange` ECSchema) from\r\n * which the Change Summary was extracted.\r\n *\r\n * See also\r\n * - [ChangeSummaryManager.queryChangeSummary]($backend)\r\n * - [ChangeSummary Overview]($docs/learning/ChangeSummaries)\r\n * @beta\r\n */\r\nexport interface ChangeSummary {\r\n  id: Id64String;\r\n  changeSet: { wsgId: GuidString, parentWsgId: GuidString, description: string, pushDate: string, userCreated: GuidString };\r\n}\r\n\r\n/** Represents an instance of the `InstanceChange` ECClass from the `ECDbChange` ECSchema\r\n *\r\n * See also\r\n * - [ChangeSummaryManager.queryInstanceChange]($backend)\r\n * - [ChangeSummary Overview]($docs/learning/ChangeSummaries)\r\n * @beta\r\n */\r\nexport interface InstanceChange {\r\n  id: Id64String;\r\n  summaryId: Id64String;\r\n  changedInstance: { id: Id64String, className: string };\r\n  opCode: ChangeOpCode;\r\n  isIndirect: boolean;\r\n}\r\n\r\n/** Options for [ChangeSummaryManager.extractChangeSummaries]($backend).\r\n * @beta\r\n * @deprecated in 2.x. Use [CreateChangeSummaryArgs]($core-backend) instead\r\n */\r\nexport interface ChangeSummaryExtractOptions {\r\n  /** If specified, change summaries are extracted from the start version to the current version as of which the iModel\r\n   *  was opened. If undefined, the extraction starts at the first version of the iModel.\r\n   */\r\n  startVersion?: IModelVersion;\r\n  /** If specified, the change summary will be extracted only for current version as of which the iModel\r\n   *  was opened.\r\n   */\r\n  currentVersionOnly?: boolean;\r\n}\r\n\r\n/** Options for [ChangeSummaryManager.createChangeSummaries]($backend).\r\n * @beta\r\n */\r\nexport interface CreateChangeSummaryArgs extends TokenArg {\r\n  /** Id of the iTwin that contains the iModel */\r\n  iTwinId: GuidString;\r\n\r\n  /** Id of the iModel */\r\n  iModelId: GuidString;\r\n\r\n  /**\r\n   * Range of change sets\r\n   * - the Change Summary for the first and last versions are also included\r\n   * - if unspecified, all change sets until the latest version are processed\r\n   */\r\n  range: ChangesetRange;\r\n}\r\n\r\n/** Class to extract Change Summaries for a briefcase.\r\n *\r\n * See also:\r\n * - [ChangeSummary Overview]($docs/learning/ChangeSummaries)\r\n * @beta\r\n */\r\nexport class ChangeSummaryManager {\r\n  private static readonly _currentIModelChangeSchemaVersion = { read: 2, write: 0, minor: 0 };\r\n\r\n  /** Determines whether the *Change Cache file* is attached to the specified iModel or not\r\n   * @param iModel iModel to check whether a *Change Cache file* is attached\r\n   * @returns Returns true if the *Change Cache file* is attached to the iModel. false otherwise\r\n   */\r\n  public static isChangeCacheAttached(iModel: IModelDb): boolean {\r\n    if (!iModel || !iModel.isOpen)\r\n      throw new IModelError(IModelStatus.BadRequest, \"Briefcase must be open\");\r\n\r\n    return iModel.nativeDb.isChangeCacheAttached();\r\n  }\r\n\r\n  /** Attaches the *Change Cache file* to the specified iModel if it hasn't been attached yet.\r\n   * A new *Change Cache file* will be created for the iModel if it hasn't existed before.\r\n   * @param iModel iModel to attach the *Change Cache file* file to\r\n   * @throws [IModelError]($common)\r\n   */\r\n  public static attachChangeCache(iModel: IModelDb): void {\r\n    if (!iModel || !iModel.isOpen)\r\n      throw new IModelError(IModelStatus.BadRequest, \"Briefcase must be open\");\r\n\r\n    if (ChangeSummaryManager.isChangeCacheAttached(iModel))\r\n      return;\r\n\r\n    const changesCacheFilePath: string = BriefcaseManager.getChangeCachePathName(iModel.iModelId);\r\n    if (!IModelJsFs.existsSync(changesCacheFilePath)) {\r\n      using(new ECDb(), (changeCacheFile: ECDb) => {\r\n        ChangeSummaryManager.createChangeCacheFile(iModel, changeCacheFile, changesCacheFilePath);\r\n      });\r\n    }\r\n\r\n    assert(IModelJsFs.existsSync(changesCacheFilePath));\r\n    const res: DbResult = iModel.nativeDb.attachChangeCache(changesCacheFilePath);\r\n    if (res !== DbResult.BE_SQLITE_OK)\r\n      throw new IModelError(res, `Failed to attach Change Cache file to ${iModel.pathName}.`);\r\n  }\r\n\r\n  /** Detaches the *Change Cache file* from the specified iModel.\r\n   * - note that this method will cause any pending (currently running or queued) queries to fail\r\n   * @param iModel iModel to detach the *Change Cache file* to\r\n   * @throws [IModelError]($common) in case of errors, e.g. if no *Change Cache file* was attached before.\r\n   */\r\n  public static detachChangeCache(iModel: IModelDb): void {\r\n    if (!iModel || !iModel.isOpen)\r\n      throw new IModelError(IModelStatus.BadRequest, \"Briefcase must be open\");\r\n\r\n    iModel.clearCaches();\r\n    const res: DbResult = iModel.nativeDb.detachChangeCache();\r\n    if (res !== DbResult.BE_SQLITE_OK)\r\n      throw new IModelError(res, `Failed to detach Change Cache file from ${iModel.pathName}.`);\r\n  }\r\n\r\n  /** Extracts change summaries from the specified iModel.\r\n   * Change summaries are extracted from the version the iModel was opened with up through the specified start version.\r\n   * If no start version has been specified, the first version will be used.\r\n   * @param accessToken A valid access token string\r\n   * @param iModel iModel to extract change summaries for. The iModel must not be a standalone iModel.\r\n   * Note: For every version to extract a summary from, the method moves the iModel to that version before extraction. After\r\n   * the extraction has completed, the iModel is moved back to the original version.\r\n   * @param options Extraction options\r\n   * @return the Ids of the extracted change summaries.\r\n   * @throws [IModelError]($common) if the iModel is standalone\r\n   * @deprecated in 2.x. Use [ChangeSummaryManager.createChangeSummaries]($core-backend) instead\r\n   */\r\n  public static async extractChangeSummaries(accessToken: AccessToken, iModel: BriefcaseDb, options?: ChangeSummaryExtractOptions): Promise<Id64String[]> { // eslint-disable-line deprecation/deprecation\r\n    if (!iModel?.isOpen)\r\n      throw new IModelError(IModelStatus.BadRequest, \"Briefcase must be open\");\r\n\r\n    const iModelId = iModel.iModelId;\r\n    const endChangeSetId = iModel.changeset.id;\r\n    assert(endChangeSetId.length !== 0);\r\n\r\n    let startChangeSetId = \"\";\r\n    if (options) {\r\n      if (options.startVersion) {\r\n        startChangeSetId = (await IModelHost.hubAccess.getChangesetFromVersion({ version: options.startVersion, accessToken, iModelId })).id;\r\n      } else if (options.currentVersionOnly) {\r\n        startChangeSetId = endChangeSetId;\r\n      }\r\n    }\r\n\r\n    Logger.logInfo(loggerCategory, \"Started Change Summary extraction...\", () => ({ iModelId, startChangeSetId, endChangeSetId }));\r\n    const totalPerf = new PerfLogger(`ChangeSummaryManager.extractChangeSummaries [ChangeSets: ${startChangeSetId} through ${endChangeSetId}, iModel: ${iModelId}]`);\r\n\r\n    // download necessary changesets if they were not downloaded before and retrieve infos about those changesets\r\n    let perfLogger = new PerfLogger(\"ChangeSummaryManager.extractChangeSummaries>Retrieve ChangeSetInfos and download Changesets from Hub\");\r\n\r\n    const first = (await IModelHost.hubAccess.queryChangeset({ iModelId, changeset: { id: startChangeSetId }, accessToken })).index;\r\n    const end = (await IModelHost.hubAccess.queryChangeset({ iModelId, changeset: { id: endChangeSetId }, accessToken })).index;\r\n    const changeSetInfos = await IModelHost.hubAccess.downloadChangesets({ accessToken, iModelId, range: { first, end }, targetDir: BriefcaseManager.getChangeSetsPath(iModelId) });\r\n    perfLogger.dispose();\r\n    Logger.logTrace(loggerCategory, \"Retrieved changesets to extract from from cache or from hub.\", () => ({ iModelId, startChangeSetId, endChangeSetId, changeSets: changeSetInfos }));\r\n\r\n    // Ensure change cache is detached as it's being written to during the extraction\r\n    if (this.isChangeCacheAttached(iModel)) {\r\n      throw new IModelError(DbResult.BE_SQLITE_ERROR, \"Change cache must be detached before extraction\");\r\n    }\r\n\r\n    perfLogger = new PerfLogger(\"ChangeSummaryManager.extractChangeSummaries>Open or create local Change Cache file\");\r\n    const changesFile = ChangeSummaryManager.openOrCreateChangesFile(iModel);\r\n    assert(changesFile.nativeDb !== undefined, \"Should not happen as an exception should have been thrown in that case\");\r\n    perfLogger.dispose();\r\n    Logger.logTrace(loggerCategory, \"Opened or created Changes Cachefile.\", () => ({ iModelId, startChangeSetId, endChangeSetId }));\r\n\r\n    try {\r\n      // extract summaries from end changeset through start changeset, so that we only have to go back in history\r\n      const changeSetCount: number = changeSetInfos.length;\r\n      const endChangeSetIx: number = changeSetCount - 1;\r\n      const summaries: Id64String[] = [];\r\n      for (let i = endChangeSetIx; i >= 0; i--) {\r\n        const currentChangeSetInfo = changeSetInfos[i];\r\n        const currentChangeSetId = currentChangeSetInfo.id;\r\n        Logger.logInfo(loggerCategory, `Started Change Summary extraction for changeset #${i + 1}...`, () => ({ iModelId, changeSetId: currentChangeSetId }));\r\n\r\n        const existingSummaryId: Id64String | undefined = ChangeSummaryManager.isSummaryAlreadyExtracted(changesFile, currentChangeSetId);\r\n        if (!!existingSummaryId) {\r\n          Logger.logInfo(loggerCategory, `Change Summary for changeset #${i + 1} already exists. It is not extracted again.`, () => ({ iModelId, changeSetId: currentChangeSetId }));\r\n          summaries.push(existingSummaryId);\r\n          continue;\r\n        }\r\n\r\n        // iModel is at end changeset, so no need to reverse for it.\r\n        if (i !== endChangeSetIx) {\r\n          perfLogger = new PerfLogger(\"ChangeSummaryManager.extractChangeSummaries>Roll iModel to previous changeset\");\r\n\r\n          await iModel.pullChanges({ accessToken, toIndex: currentChangeSetInfo.index });\r\n          perfLogger.dispose();\r\n          Logger.logTrace(loggerCategory, `Moved iModel to changeset #${i + 1} to extract summary from.`, () => ({ iModelId, changeSetId: currentChangeSetId }));\r\n        }\r\n\r\n        const changeSetFilePath = currentChangeSetInfo.pathname;\r\n        if (!IModelJsFs.existsSync(changeSetFilePath))\r\n          throw new IModelError(IModelStatus.FileNotFound, `Failed to extract change summary: ChangeSet file \"${changeSetFilePath}\" does not exist.`);\r\n\r\n        perfLogger = new PerfLogger(\"ChangeSummaryManager.extractChangeSummaries>Extract ChangeSummary\");\r\n        const stat = iModel.nativeDb.extractChangeSummary(changesFile.nativeDb, changeSetFilePath);\r\n        perfLogger.dispose();\r\n        if (stat.error && stat.error.status !== DbResult.BE_SQLITE_OK)\r\n          throw new IModelError(stat.error.status, stat.error.message);\r\n\r\n        Logger.logTrace(loggerCategory, `Actual Change summary extraction done for changeset #${i + 1}.`, () => ({ iModelId, changeSetId: currentChangeSetId }));\r\n\r\n        perfLogger = new PerfLogger(\"ChangeSummaryManager.extractChangeSummaries>Add ChangeSet info to ChangeSummary\");\r\n        assert(undefined !== stat.result);\r\n        const changeSummaryId = stat.result;\r\n        summaries.push(changeSummaryId);\r\n        ChangeSummaryManager.addExtendedInfos(changesFile, changeSummaryId, currentChangeSetId, currentChangeSetInfo.parentId, currentChangeSetInfo.description, currentChangeSetInfo.pushDate, currentChangeSetInfo.userCreated);\r\n        perfLogger.dispose();\r\n        Logger.logTrace(loggerCategory, `Added extended infos to Change Summary for changeset #${i + 1}.`, () => ({ iModelId, changeSetId: currentChangeSetId }));\r\n\r\n        Logger.logInfo(loggerCategory, `Finished Change Summary extraction for changeset #${i + 1}.`, () => ({ iModelId, changeSetId: currentChangeSetId }));\r\n      }\r\n\r\n      changesFile.saveChanges();\r\n      return summaries;\r\n    } finally {\r\n      changesFile.dispose();\r\n\r\n      perfLogger = new PerfLogger(\"ChangeSummaryManager.extractChangeSummaries>Move iModel to original changeset\");\r\n      if (iModel.changeset.id !== endChangeSetId)\r\n        await iModel.pullChanges({ accessToken });\r\n      perfLogger.dispose();\r\n      Logger.logTrace(loggerCategory, \"Moved iModel to initial changeset (the end changeset).\", () => ({ iModelId, startChangeSetId, endChangeSetId }));\r\n\r\n      totalPerf.dispose();\r\n      Logger.logInfo(loggerCategory, \"Finished Change Summary extraction.\", () => ({ iModelId, startChangeSetId, endChangeSetId }));\r\n    }\r\n  }\r\n\r\n  private static openOrCreateChangesFile(iModel: BriefcaseDb): ECDb {\r\n    if (!iModel?.isOpen)\r\n      throw new IModelError(IModelStatus.BadArg, \"Invalid iModel handle. iModel must be open.\");\r\n\r\n    const changesFile = new ECDb();\r\n    const changeCacheFilePath = BriefcaseManager.getChangeCachePathName(iModel.iModelId);\r\n    if (IModelJsFs.existsSync(changeCacheFilePath)) {\r\n      ChangeSummaryManager.openChangeCacheFile(changesFile, changeCacheFilePath);\r\n      return changesFile;\r\n    }\r\n\r\n    try {\r\n      ChangeSummaryManager.createChangeCacheFile(iModel, changesFile, changeCacheFilePath);\r\n      return changesFile;\r\n    } catch (e) {\r\n      // delete cache file again in case it was created but schema import failed\r\n      if (IModelJsFs.existsSync(changeCacheFilePath))\r\n        IModelJsFs.removeSync(changeCacheFilePath);\r\n\r\n      throw e;\r\n    }\r\n  }\r\n\r\n  private static createChangeCacheFile(iModel: IModelDb, changesFile: ECDb, changeCacheFilePath: string): void {\r\n    if (!iModel?.isOpen)\r\n      throw new IModelError(IModelStatus.BadArg, \"Invalid iModel object. iModel must be open.\");\r\n\r\n    const stat: DbResult = iModel.nativeDb.createChangeCache(changesFile.nativeDb, changeCacheFilePath);\r\n    if (stat !== DbResult.BE_SQLITE_OK)\r\n      throw new IModelError(stat, `Failed to create Change Cache file at \"${changeCacheFilePath}\".`);\r\n\r\n    // Extended information like changeset ids, push dates are persisted in the IModelChange ECSchema\r\n    changesFile.importSchema(ChangeSummaryManager.getExtendedSchemaPath());\r\n  }\r\n\r\n  private static openChangeCacheFile(changesFile: ECDb, changeCacheFilePath: string): void {\r\n    changesFile.openDb(changeCacheFilePath, ECDbOpenMode.FileUpgrade);\r\n\r\n    const actualSchemaVersion: { read: number, write: number, minor: number } = changesFile.withPreparedStatement(\"SELECT VersionMajor read,VersionWrite write,VersionMinor minor FROM meta.ECSchemaDef WHERE Name='IModelChange'\",\r\n      (stmt: ECSqlStatement) => {\r\n        if (stmt.step() !== DbResult.BE_SQLITE_ROW)\r\n          throw new IModelError(DbResult.BE_SQLITE_ERROR, \"File is not a valid Change Cache file.\");\r\n\r\n        return stmt.getRow();\r\n      });\r\n\r\n    if (actualSchemaVersion.read === ChangeSummaryManager._currentIModelChangeSchemaVersion.read &&\r\n      actualSchemaVersion.write === ChangeSummaryManager._currentIModelChangeSchemaVersion.write &&\r\n      actualSchemaVersion.minor === ChangeSummaryManager._currentIModelChangeSchemaVersion.minor)\r\n      return;\r\n\r\n    changesFile.importSchema(ChangeSummaryManager.getExtendedSchemaPath());\r\n  }\r\n\r\n  private static getExtendedSchemaPath(): string { return path.join(KnownLocations.packageAssetsDir, \"IModelChange.02.00.00.ecschema.xml\"); }\r\n\r\n  private static isSummaryAlreadyExtracted(changesFile: ECDb, changeSetId: GuidString): Id64String | undefined {\r\n    return changesFile.withPreparedStatement(\"SELECT Summary.Id summaryid FROM imodelchange.ChangeSet WHERE WsgId=?\",\r\n      (stmt: ECSqlStatement) => {\r\n        stmt.bindString(1, changeSetId);\r\n        if (DbResult.BE_SQLITE_ROW === stmt.step())\r\n          return stmt.getValue(0).getId();\r\n\r\n        return undefined;\r\n      });\r\n  }\r\n\r\n  private static addExtendedInfos(changesFile: ECDb, changeSummaryId: Id64String, changesetWsgId: GuidString, changesetParentWsgId?: GuidString, description?: string, changesetPushDate?: string, changeSetUserCreated?: GuidString): void {\r\n    changesFile.withPreparedStatement(\"INSERT INTO imodelchange.ChangeSet(Summary.Id,WsgId,ParentWsgId,Description,PushDate,UserCreated) VALUES(?,?,?,?,?,?)\",\r\n      (stmt: ECSqlStatement) => {\r\n        stmt.bindId(1, changeSummaryId);\r\n        stmt.bindString(2, changesetWsgId);\r\n        if (changesetParentWsgId)\r\n          stmt.bindString(3, changesetParentWsgId);\r\n\r\n        if (description)\r\n          stmt.bindString(4, description);\r\n\r\n        if (changesetPushDate)\r\n          stmt.bindDateTime(5, changesetPushDate);\r\n\r\n        if (changeSetUserCreated)\r\n          stmt.bindString(6, changeSetUserCreated);\r\n\r\n        const r: DbResult = stmt.step();\r\n        if (r !== DbResult.BE_SQLITE_DONE)\r\n          throw new IModelError(r, `Failed to add changeset information to extracted change summary ${changeSummaryId}`);\r\n      });\r\n  }\r\n\r\n  /** Queries the ChangeSummary for the specified change summary id\r\n   *\r\n   * See also\r\n   * - `ECDbChange.ChangeSummary` ECClass in the *ECDbChange* ECSchema\r\n   * - [Change Summary Overview]($docs/learning/ChangeSummaries)\r\n   * @param iModel iModel\r\n   * @param changeSummaryId ECInstanceId of the ChangeSummary\r\n   * @returns Returns the requested ChangeSummary object\r\n   * @throws [IModelError]($common) If change summary does not exist for the specified id, or if the\r\n   * change cache file hasn't been attached, or in case of other errors.\r\n   */\r\n  public static queryChangeSummary(iModel: BriefcaseDb, changeSummaryId: Id64String): ChangeSummary {\r\n    if (!ChangeSummaryManager.isChangeCacheAttached(iModel))\r\n      throw new IModelError(IModelStatus.BadArg, \"Change Cache file must be attached to iModel.\");\r\n\r\n    return iModel.withPreparedStatement(\"SELECT WsgId,ParentWsgId,Description,PushDate,UserCreated FROM ecchange.imodelchange.ChangeSet WHERE Summary.Id=?\",\r\n      (stmt: ECSqlStatement) => {\r\n        stmt.bindId(1, changeSummaryId);\r\n        if (stmt.step() !== DbResult.BE_SQLITE_ROW)\r\n          throw new IModelError(IModelStatus.BadArg, `No ChangeSet information found for ChangeSummary ${changeSummaryId}.`);\r\n\r\n        const row = stmt.getRow();\r\n        return { id: changeSummaryId, changeSet: { wsgId: row.wsgId, parentWsgId: row.parentWsgId, description: row.description, pushDate: row.pushDate, userCreated: row.userCreated } };\r\n      });\r\n  }\r\n\r\n  /** Queries the InstanceChange for the specified instance change id.\r\n   *\r\n   * See also\r\n   * - `ECDbChange.InstanceChange` ECClass in the *ECDbChange* ECSchema\r\n   * - [Change Summary Overview]($docs/learning/ChangeSummaries)\r\n   * @param iModel iModel\r\n   * @param instanceChangeId ECInstanceId of the InstanceChange (see `ECDbChange.InstanceChange` ECClass in the *ECDbChange* ECSchema)\r\n   * @returns Returns the requested InstanceChange object (see `ECDbChange.InstanceChange` ECClass in the *ECDbChange* ECSchema)\r\n   * @throws [IModelError]($common) if instance change does not exist for the specified id, or if the\r\n   * change cache file hasn't been attached, or in case of other errors.\r\n   */\r\n  public static queryInstanceChange(iModel: BriefcaseDb, instanceChangeId: Id64String): InstanceChange {\r\n    if (!ChangeSummaryManager.isChangeCacheAttached(iModel))\r\n      throw new IModelError(IModelStatus.BadArg, \"Change Cache file must be attached to iModel.\");\r\n\r\n    // query instance changes\r\n    const instanceChange: InstanceChange = iModel.withPreparedStatement(`SELECT ic.Summary.Id summaryId, s.Name changedInstanceSchemaName, c.Name changedInstanceClassName, ic.ChangedInstance.Id changedInstanceId,\r\n       ic.OpCode, ic.IsIndirect FROM ecchange.change.InstanceChange ic JOIN main.meta.ECClassDef c ON c.ECInstanceId = ic.ChangedInstance.ClassId\r\n       JOIN main.meta.ECSchemaDef s ON c.Schema.Id = s.ECInstanceId WHERE ic.ECInstanceId =? `, (stmt: ECSqlStatement) => {\r\n      stmt.bindId(1, instanceChangeId);\r\n      if (stmt.step() !== DbResult.BE_SQLITE_ROW)\r\n        throw new IModelError(IModelStatus.BadArg, `No InstanceChange found for id ${instanceChangeId}.`);\r\n\r\n      const row = stmt.getRow();\r\n      const changedInstanceId: Id64String = row.changedInstanceId;\r\n      const changedInstanceClassName: string = `[${row.changedInstanceSchemaName}].[${row.changedInstanceClassName}]`;\r\n      const op: ChangeOpCode = row.opCode as ChangeOpCode;\r\n\r\n      return {\r\n        id: instanceChangeId, summaryId: row.summaryId, changedInstance: { id: changedInstanceId, className: changedInstanceClassName },\r\n        opCode: op, isIndirect: row.isIndirect,\r\n      };\r\n    });\r\n\r\n    return instanceChange;\r\n  }\r\n\r\n  /** Retrieves the names of the properties whose values have changed for the given instance change\r\n   *\r\n   * See also [Change Summary Overview]($docs/learning/ChangeSummaries)\r\n   * @param iModel iModel\r\n   * @param instanceChangeId Id of the InstanceChange to query the properties whose values have changed\r\n   * @returns Returns names of the properties whose values have changed for the given instance change\r\n   * @throws [IModelError]($common) if the change cache file hasn't been attached, or in case of other errors.\r\n   */\r\n  public static getChangedPropertyValueNames(iModel: IModelDb, instanceChangeId: Id64String): string[] {\r\n    return iModel.withPreparedStatement(\"SELECT AccessString FROM ecchange.change.PropertyValueChange WHERE InstanceChange.Id=?\",\r\n      (stmt: ECSqlStatement) => {\r\n        stmt.bindId(1, instanceChangeId);\r\n\r\n        const selectClauseItems: string[] = [];\r\n        while (stmt.step() === DbResult.BE_SQLITE_ROW) {\r\n          // access string tokens need to be escaped as they might collide with reserved words in ECSQL or SQLite\r\n          const accessString: string = stmt.getValue(0).getString();\r\n          const accessStringTokens: string[] = accessString.split(\".\");\r\n          assert(accessStringTokens.length > 0);\r\n\r\n          let isFirstToken: boolean = true;\r\n          let item: string = \"\";\r\n          for (const token of accessStringTokens) {\r\n            if (!isFirstToken)\r\n              item += \".\";\r\n\r\n            item += `[${token}]`;\r\n            isFirstToken = false;\r\n          }\r\n          selectClauseItems.push(item);\r\n        }\r\n\r\n        return selectClauseItems;\r\n      });\r\n  }\r\n\r\n  /** Builds the ECSQL to query the property value changes for the specified instance change and the specified ChangedValueState.\r\n   *\r\n   * See also [Change Summary Overview]($docs/learning/ChangeSummaries)\r\n   * @param iModel iModel\r\n   * @param instanceChangeInfo InstanceChange to query the property value changes for\r\n   *        changedInstance.className must be fully qualified and schema and class name must be escaped with square brackets if they collide with reserved ECSQL words: `[schema name].[class name]`\r\n   * @param changedValueState The Changed State to query the values for. This must correspond to the [InstanceChange.OpCode]($backend) of the InstanceChange.\r\n   * @param changedPropertyNames List of the property names for which values have changed for the specified instance change.\r\n   *        The list can be obtained by calling [ChangeSummaryManager.getChangedPropertyValueNames]($core-backend).\r\n   *        If omitted, the method will call the above method by itself. The parameter allows for checking first whether\r\n   *        an instance change has any property value changes at all. If there are no property value changes, this method\r\n   *        should not be called, as it will throw an error.\r\n   * @returns Returns the ECSQL that will retrieve the property value changes\r\n   * @throws [IModelError]($common) if instance change does not exist, if there are not property value changes for the instance change,\r\n   *        if the change cache file hasn't been attached, or in case of other errors.\r\n   */\r\n  public static buildPropertyValueChangesECSql(iModel: IModelDb, instanceChangeInfo: { id: Id64String, summaryId: Id64String, changedInstance: { id: Id64String, className: string } }, changedValueState: ChangedValueState, changedPropertyNames?: string[]): string {\r\n    let selectClauseItems: string[];\r\n    if (!changedPropertyNames) {\r\n      // query property value changes just to build a SELECT statement against the class of the changed instance\r\n      selectClauseItems = ChangeSummaryManager.getChangedPropertyValueNames(iModel, instanceChangeInfo.id);\r\n    } else\r\n      selectClauseItems = changedPropertyNames;\r\n\r\n    if (selectClauseItems.length === 0)\r\n      throw new IModelError(IModelStatus.BadArg, `No property value changes found for InstanceChange ${instanceChangeInfo.id}.`);\r\n\r\n    let ecsql: string = \"SELECT \";\r\n    selectClauseItems.map((item: string, index: number) => {\r\n      if (index !== 0)\r\n        ecsql += \",\";\r\n\r\n      ecsql += item;\r\n    });\r\n\r\n    // Avoiding parameters in the Changes function speeds up performance because ECDb can do optimizations\r\n    // if it knows the function args at prepare time\r\n    ecsql += ` FROM main.${instanceChangeInfo.changedInstance.className}.Changes(${instanceChangeInfo.summaryId},${changedValueState}) WHERE ECInstanceId=${instanceChangeInfo.changedInstance.id}`;\r\n    return ecsql;\r\n  }\r\n\r\n  /**\r\n   * Creates a change summary for the last applied change set to the iModel\r\n   * @param accessToken A valid access token string\r\n   * @param iModel iModel to extract change summaries for. The iModel must not be a standalone iModel, and must have at least one change set applied to it.\r\n   * @returns The id of the extracted change summary.\r\n   * @beta\r\n   */\r\n  public static async createChangeSummary(accessToken: AccessToken, iModel: BriefcaseDb): Promise<Id64String> {\r\n    if (!iModel?.isOpen)\r\n      throw new IModelError(IModelStatus.BadRequest, \"Briefcase must be open\");\r\n    const changesetId = iModel.changeset.id;\r\n    if (!changesetId)\r\n      throw new IModelError(IModelStatus.BadRequest, \"No change set was applied to the iModel\");\r\n    if (this.isChangeCacheAttached(iModel))\r\n      throw new IModelError(IModelStatus.BadRequest, \"Change cache must be detached before extraction\");\r\n\r\n    const iModelId = iModel.iModelId;\r\n    const changesetsFolder: string = BriefcaseManager.getChangeSetsPath(iModelId);\r\n    const changeset = await IModelHost.hubAccess.downloadChangeset({ accessToken, iModelId, changeset: { id: iModel.changeset.id }, targetDir: changesetsFolder });\r\n\r\n    if (!IModelJsFs.existsSync(changeset.pathname))\r\n      throw new IModelError(IModelStatus.FileNotFound, `Failed to download change set: ${changeset.pathname}`);\r\n\r\n    let changesFile: ECDb | undefined;\r\n    try {\r\n      changesFile = ChangeSummaryManager.openOrCreateChangesFile(iModel);\r\n      assert(changesFile.nativeDb !== undefined, \"Invalid changesFile - should've caused an exception\");\r\n\r\n      let changeSummaryId = ChangeSummaryManager.isSummaryAlreadyExtracted(changesFile, changesetId);\r\n      if (changeSummaryId !== undefined) {\r\n        Logger.logInfo(loggerCategory, `Change Summary for changeset already exists. It is not extracted again.`, () => ({ iModelId, changeSetId: changesetId }));\r\n        return changeSummaryId;\r\n      }\r\n\r\n      const stat = iModel.nativeDb.extractChangeSummary(changesFile.nativeDb, changeset.pathname);\r\n      if (stat.error && stat.error.status !== DbResult.BE_SQLITE_OK)\r\n        throw new IModelError(stat.error.status, stat.error.message);\r\n\r\n      assert(undefined !== stat.result);\r\n      changeSummaryId = stat.result;\r\n      ChangeSummaryManager.addExtendedInfos(changesFile, changeSummaryId, changesetId, changeset.parentId, changeset.description, changeset.pushDate, changeset.userCreated);\r\n\r\n      changesFile.saveChanges();\r\n      return changeSummaryId;\r\n    } finally {\r\n      if (changesFile !== undefined)\r\n        changesFile.dispose();\r\n      IModelJsFs.unlinkSync(changeset.pathname);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Creates change summaries for the specified iModel and a specified range of versions\r\n   * @note This may be an expensive operation - downloads the first version and starts applying the change sets, extracting summaries one by one\r\n   * @param args Arguments including the range of versions for which Change Summaries are to be created, and other necessary input for creation\r\n   */\r\n  public static async createChangeSummaries(args: CreateChangeSummaryArgs): Promise<Id64String[]> {\r\n    const accessToken = args.accessToken ?? await IModelHost.getAccessToken() ?? \"\";\r\n    const { iModelId, iTwinId, range } = args;\r\n    range.end = range.end ?? (await IModelHost.hubAccess.getChangesetFromVersion({ accessToken, iModelId, version: IModelVersion.latest() })).index;\r\n    if (range.first > range.end)\r\n      throw new IModelError(IModelStatus.BadArg, \"Invalid range of changesets\");\r\n    if (range.first === 0 && range.end === 0)\r\n      return []; // no changesets exist, so the inclusive range is empty\r\n\r\n    const changesets = await IModelHost.hubAccess.queryChangesets({ accessToken, iModelId, range });\r\n\r\n    // Setup a temporary briefcase to help with extracting change summaries\r\n    const briefcasePath = BriefcaseManager.getBriefcaseBasePath(iModelId);\r\n    const fileName: string = path.join(briefcasePath, `ChangeSummaryBriefcase.bim`);\r\n    if (IModelJsFs.existsSync(fileName))\r\n      IModelJsFs.removeSync(fileName);\r\n\r\n    let iModel: BriefcaseDb | undefined;\r\n    try {\r\n      // Download a version that has the first change set applied\r\n      const props = await BriefcaseManager.downloadBriefcase({ accessToken, iTwinId, iModelId, asOf: { afterChangeSetId: changesets[0].id }, briefcaseId: 0, fileName });\r\n      iModel = await BriefcaseDb.open({ fileName: props.fileName });\r\n\r\n      const summaryIds = new Array<Id64String>();\r\n      for (let index = 0; index < changesets.length; index++) {\r\n        // Apply a change set if necessary\r\n        if (index > 0)\r\n          await iModel.pullChanges({ accessToken, toIndex: changesets[index].index });\r\n\r\n        // Create a change summary for the last change set that was applied\r\n        const summaryId = await this.createChangeSummary(accessToken, iModel);\r\n        summaryIds.push(summaryId);\r\n      }\r\n      return summaryIds;\r\n    } finally {\r\n      if (iModel !== undefined)\r\n        iModel.close();\r\n      IModelJsFs.removeSync(fileName);\r\n    }\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"ChangeSummaryManager.js","sourceRoot":"","sources":["../../src/ChangeSummaryManager.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 iModels\n */\n\nimport { AccessToken, assert, DbResult, GuidString, Id64String, IModelStatus, Logger, using } from \"@itwin/core-bentley\";\nimport { ChangedValueState, ChangeOpCode, ChangesetRange, IModelError, IModelVersion } from \"@itwin/core-common\";\nimport * as path from \"path\";\nimport { BackendLoggerCategory } from \"./BackendLoggerCategory\";\nimport { BriefcaseManager } from \"./BriefcaseManager\";\nimport { ECDb, ECDbOpenMode } from \"./ECDb\";\nimport { ECSqlStatement } from \"./ECSqlStatement\";\nimport { BriefcaseDb, IModelDb, TokenArg } from \"./IModelDb\";\nimport { IModelHost, KnownLocations } from \"./IModelHost\";\nimport { IModelJsFs } from \"./IModelJsFs\";\n\nconst loggerCategory: string = BackendLoggerCategory.ECDb;\n\n/** Represents an instance of the `ChangeSummary` ECClass from the `ECDbChange` ECSchema\n * combined with the information from the related `Changeset` instance (from the `IModelChange` ECSchema) from\n * which the Change Summary was extracted.\n *\n * See also\n * - [ChangeSummaryManager.queryChangeSummary]($backend)\n * - [ChangeSummary Overview]($docs/learning/ChangeSummaries)\n * @beta\n */\nexport interface ChangeSummary {\n  id: Id64String;\n  changeSet: { wsgId: GuidString, parentWsgId: GuidString, description: string, pushDate: string, userCreated: GuidString };\n}\n\n/** Represents an instance of the `InstanceChange` ECClass from the `ECDbChange` ECSchema\n *\n * See also\n * - [ChangeSummaryManager.queryInstanceChange]($backend)\n * - [ChangeSummary Overview]($docs/learning/ChangeSummaries)\n * @beta\n */\nexport interface InstanceChange {\n  id: Id64String;\n  summaryId: Id64String;\n  changedInstance: { id: Id64String, className: string };\n  opCode: ChangeOpCode;\n  isIndirect: boolean;\n}\n\n/** Options for [ChangeSummaryManager.createChangeSummaries]($backend).\n * @beta\n */\nexport interface CreateChangeSummaryArgs extends TokenArg {\n  /** Id of the iTwin that contains the iModel */\n  iTwinId: GuidString;\n\n  /** Id of the iModel */\n  iModelId: GuidString;\n\n  /**\n   * Range of change sets\n   * - the Change Summary for the first and last versions are also included\n   * - if unspecified, all change sets until the latest version are processed\n   */\n  range: ChangesetRange;\n}\n\n/** Class to extract Change Summaries for a briefcase.\n *\n * See also:\n * - [ChangeSummary Overview]($docs/learning/ChangeSummaries)\n * @beta\n */\nexport class ChangeSummaryManager {\n  private static readonly _currentIModelChangeSchemaVersion = { read: 2, write: 0, minor: 0 };\n\n  /** Determines whether the *Change Cache file* is attached to the specified iModel or not\n   * @param iModel iModel to check whether a *Change Cache file* is attached\n   * @returns Returns true if the *Change Cache file* is attached to the iModel. false otherwise\n   */\n  public static isChangeCacheAttached(iModel: IModelDb): boolean {\n    if (!iModel || !iModel.isOpen)\n      throw new IModelError(IModelStatus.BadRequest, \"Briefcase must be open\");\n\n    return iModel.nativeDb.isChangeCacheAttached();\n  }\n\n  /** Attaches the *Change Cache file* to the specified iModel if it hasn't been attached yet.\n   * A new *Change Cache file* will be created for the iModel if it hasn't existed before.\n   * @param iModel iModel to attach the *Change Cache file* file to\n   * @throws [IModelError]($common)\n   */\n  public static attachChangeCache(iModel: IModelDb): void {\n    if (!iModel || !iModel.isOpen)\n      throw new IModelError(IModelStatus.BadRequest, \"Briefcase must be open\");\n\n    if (ChangeSummaryManager.isChangeCacheAttached(iModel))\n      return;\n\n    const changesCacheFilePath: string = BriefcaseManager.getChangeCachePathName(iModel.iModelId);\n    if (!IModelJsFs.existsSync(changesCacheFilePath)) {\n      using(new ECDb(), (changeCacheFile: ECDb) => {\n        ChangeSummaryManager.createChangeCacheFile(iModel, changeCacheFile, changesCacheFilePath);\n      });\n    }\n\n    assert(IModelJsFs.existsSync(changesCacheFilePath));\n    const res: DbResult = iModel.nativeDb.attachChangeCache(changesCacheFilePath);\n    if (res !== DbResult.BE_SQLITE_OK)\n      throw new IModelError(res, `Failed to attach Change Cache file to ${iModel.pathName}.`);\n  }\n\n  /** Detaches the *Change Cache file* from the specified iModel.\n   * - note that this method will cause any pending (currently running or queued) queries to fail\n   * @param iModel iModel to detach the *Change Cache file* to\n   * @throws [IModelError]($common) in case of errors, e.g. if no *Change Cache file* was attached before.\n   */\n  public static detachChangeCache(iModel: IModelDb): void {\n    if (!iModel || !iModel.isOpen)\n      throw new IModelError(IModelStatus.BadRequest, \"Briefcase must be open\");\n\n    iModel.clearCaches();\n    const res: DbResult = iModel.nativeDb.detachChangeCache();\n    if (res !== DbResult.BE_SQLITE_OK)\n      throw new IModelError(res, `Failed to detach Change Cache file from ${iModel.pathName}.`);\n  }\n\n  private static openOrCreateChangesFile(iModel: BriefcaseDb): ECDb {\n    if (!iModel?.isOpen)\n      throw new IModelError(IModelStatus.BadArg, \"Invalid iModel handle. iModel must be open.\");\n\n    const changesFile = new ECDb();\n    const changeCacheFilePath = BriefcaseManager.getChangeCachePathName(iModel.iModelId);\n    if (IModelJsFs.existsSync(changeCacheFilePath)) {\n      ChangeSummaryManager.openChangeCacheFile(changesFile, changeCacheFilePath);\n      return changesFile;\n    }\n\n    try {\n      ChangeSummaryManager.createChangeCacheFile(iModel, changesFile, changeCacheFilePath);\n      return changesFile;\n    } catch (e) {\n      // delete cache file again in case it was created but schema import failed\n      if (IModelJsFs.existsSync(changeCacheFilePath))\n        IModelJsFs.removeSync(changeCacheFilePath);\n\n      throw e;\n    }\n  }\n\n  private static createChangeCacheFile(iModel: IModelDb, changesFile: ECDb, changeCacheFilePath: string): void {\n    if (!iModel?.isOpen)\n      throw new IModelError(IModelStatus.BadArg, \"Invalid iModel object. iModel must be open.\");\n\n    const stat: DbResult = iModel.nativeDb.createChangeCache(changesFile.nativeDb, changeCacheFilePath);\n    if (stat !== DbResult.BE_SQLITE_OK)\n      throw new IModelError(stat, `Failed to create Change Cache file at \"${changeCacheFilePath}\".`);\n\n    // Extended information like changeset ids, push dates are persisted in the IModelChange ECSchema\n    changesFile.importSchema(ChangeSummaryManager.getExtendedSchemaPath());\n  }\n\n  private static openChangeCacheFile(changesFile: ECDb, changeCacheFilePath: string): void {\n    changesFile.openDb(changeCacheFilePath, ECDbOpenMode.FileUpgrade);\n\n    const actualSchemaVersion: { read: number, write: number, minor: number } = changesFile.withPreparedStatement(\"SELECT VersionMajor read,VersionWrite write,VersionMinor minor FROM meta.ECSchemaDef WHERE Name='IModelChange'\",\n      (stmt: ECSqlStatement) => {\n        if (stmt.step() !== DbResult.BE_SQLITE_ROW)\n          throw new IModelError(DbResult.BE_SQLITE_ERROR, \"File is not a valid Change Cache file.\");\n\n        return stmt.getRow();\n      });\n\n    if (actualSchemaVersion.read === ChangeSummaryManager._currentIModelChangeSchemaVersion.read &&\n      actualSchemaVersion.write === ChangeSummaryManager._currentIModelChangeSchemaVersion.write &&\n      actualSchemaVersion.minor === ChangeSummaryManager._currentIModelChangeSchemaVersion.minor)\n      return;\n\n    changesFile.importSchema(ChangeSummaryManager.getExtendedSchemaPath());\n  }\n\n  private static getExtendedSchemaPath(): string { return path.join(KnownLocations.packageAssetsDir, \"IModelChange.02.00.00.ecschema.xml\"); }\n\n  private static isSummaryAlreadyExtracted(changesFile: ECDb, changeSetId: GuidString): Id64String | undefined {\n    return changesFile.withPreparedStatement(\"SELECT Summary.Id summaryid FROM imodelchange.ChangeSet WHERE WsgId=?\",\n      (stmt: ECSqlStatement) => {\n        stmt.bindString(1, changeSetId);\n        if (DbResult.BE_SQLITE_ROW === stmt.step())\n          return stmt.getValue(0).getId();\n\n        return undefined;\n      });\n  }\n\n  private static addExtendedInfos(changesFile: ECDb, changeSummaryId: Id64String, changesetWsgId: GuidString, changesetParentWsgId?: GuidString, description?: string, changesetPushDate?: string, changeSetUserCreated?: GuidString): void {\n    changesFile.withPreparedStatement(\"INSERT INTO imodelchange.ChangeSet(Summary.Id,WsgId,ParentWsgId,Description,PushDate,UserCreated) VALUES(?,?,?,?,?,?)\",\n      (stmt: ECSqlStatement) => {\n        stmt.bindId(1, changeSummaryId);\n        stmt.bindString(2, changesetWsgId);\n        if (changesetParentWsgId)\n          stmt.bindString(3, changesetParentWsgId);\n\n        if (description)\n          stmt.bindString(4, description);\n\n        if (changesetPushDate)\n          stmt.bindDateTime(5, changesetPushDate);\n\n        if (changeSetUserCreated)\n          stmt.bindString(6, changeSetUserCreated);\n\n        const r: DbResult = stmt.step();\n        if (r !== DbResult.BE_SQLITE_DONE)\n          throw new IModelError(r, `Failed to add changeset information to extracted change summary ${changeSummaryId}`);\n      });\n  }\n\n  /** Queries the ChangeSummary for the specified change summary id\n   *\n   * See also\n   * - `ECDbChange.ChangeSummary` ECClass in the *ECDbChange* ECSchema\n   * - [Change Summary Overview]($docs/learning/ChangeSummaries)\n   * @param iModel iModel\n   * @param changeSummaryId ECInstanceId of the ChangeSummary\n   * @returns Returns the requested ChangeSummary object\n   * @throws [IModelError]($common) If change summary does not exist for the specified id, or if the\n   * change cache file hasn't been attached, or in case of other errors.\n   */\n  public static queryChangeSummary(iModel: BriefcaseDb, changeSummaryId: Id64String): ChangeSummary {\n    if (!ChangeSummaryManager.isChangeCacheAttached(iModel))\n      throw new IModelError(IModelStatus.BadArg, \"Change Cache file must be attached to iModel.\");\n\n    return iModel.withPreparedStatement(\"SELECT WsgId,ParentWsgId,Description,PushDate,UserCreated FROM ecchange.imodelchange.ChangeSet WHERE Summary.Id=?\",\n      (stmt: ECSqlStatement) => {\n        stmt.bindId(1, changeSummaryId);\n        if (stmt.step() !== DbResult.BE_SQLITE_ROW)\n          throw new IModelError(IModelStatus.BadArg, `No ChangeSet information found for ChangeSummary ${changeSummaryId}.`);\n\n        const row = stmt.getRow();\n        return { id: changeSummaryId, changeSet: { wsgId: row.wsgId, parentWsgId: row.parentWsgId, description: row.description, pushDate: row.pushDate, userCreated: row.userCreated } };\n      });\n  }\n\n  /** Queries the InstanceChange for the specified instance change id.\n   *\n   * See also\n   * - `ECDbChange.InstanceChange` ECClass in the *ECDbChange* ECSchema\n   * - [Change Summary Overview]($docs/learning/ChangeSummaries)\n   * @param iModel iModel\n   * @param instanceChangeId ECInstanceId of the InstanceChange (see `ECDbChange.InstanceChange` ECClass in the *ECDbChange* ECSchema)\n   * @returns Returns the requested InstanceChange object (see `ECDbChange.InstanceChange` ECClass in the *ECDbChange* ECSchema)\n   * @throws [IModelError]($common) if instance change does not exist for the specified id, or if the\n   * change cache file hasn't been attached, or in case of other errors.\n   */\n  public static queryInstanceChange(iModel: BriefcaseDb, instanceChangeId: Id64String): InstanceChange {\n    if (!ChangeSummaryManager.isChangeCacheAttached(iModel))\n      throw new IModelError(IModelStatus.BadArg, \"Change Cache file must be attached to iModel.\");\n\n    // query instance changes\n    const instanceChange: InstanceChange = iModel.withPreparedStatement(`SELECT ic.Summary.Id summaryId, s.Name changedInstanceSchemaName, c.Name changedInstanceClassName, ic.ChangedInstance.Id changedInstanceId,\n       ic.OpCode, ic.IsIndirect FROM ecchange.change.InstanceChange ic JOIN main.meta.ECClassDef c ON c.ECInstanceId = ic.ChangedInstance.ClassId\n       JOIN main.meta.ECSchemaDef s ON c.Schema.Id = s.ECInstanceId WHERE ic.ECInstanceId =? `, (stmt: ECSqlStatement) => {\n      stmt.bindId(1, instanceChangeId);\n      if (stmt.step() !== DbResult.BE_SQLITE_ROW)\n        throw new IModelError(IModelStatus.BadArg, `No InstanceChange found for id ${instanceChangeId}.`);\n\n      const row = stmt.getRow();\n      const changedInstanceId: Id64String = row.changedInstanceId;\n      const changedInstanceClassName: string = `[${row.changedInstanceSchemaName}].[${row.changedInstanceClassName}]`;\n      const op: ChangeOpCode = row.opCode as ChangeOpCode;\n\n      return {\n        id: instanceChangeId, summaryId: row.summaryId, changedInstance: { id: changedInstanceId, className: changedInstanceClassName },\n        opCode: op, isIndirect: row.isIndirect,\n      };\n    });\n\n    return instanceChange;\n  }\n\n  /** Retrieves the names of the properties whose values have changed for the given instance change\n   *\n   * See also [Change Summary Overview]($docs/learning/ChangeSummaries)\n   * @param iModel iModel\n   * @param instanceChangeId Id of the InstanceChange to query the properties whose values have changed\n   * @returns Returns names of the properties whose values have changed for the given instance change\n   * @throws [IModelError]($common) if the change cache file hasn't been attached, or in case of other errors.\n   */\n  public static getChangedPropertyValueNames(iModel: IModelDb, instanceChangeId: Id64String): string[] {\n    return iModel.withPreparedStatement(\"SELECT AccessString FROM ecchange.change.PropertyValueChange WHERE InstanceChange.Id=?\",\n      (stmt: ECSqlStatement) => {\n        stmt.bindId(1, instanceChangeId);\n\n        const selectClauseItems: string[] = [];\n        while (stmt.step() === DbResult.BE_SQLITE_ROW) {\n          // access string tokens need to be escaped as they might collide with reserved words in ECSQL or SQLite\n          const accessString: string = stmt.getValue(0).getString();\n          const accessStringTokens: string[] = accessString.split(\".\");\n          assert(accessStringTokens.length > 0);\n\n          let isFirstToken: boolean = true;\n          let item: string = \"\";\n          for (const token of accessStringTokens) {\n            if (!isFirstToken)\n              item += \".\";\n\n            item += `[${token}]`;\n            isFirstToken = false;\n          }\n          selectClauseItems.push(item);\n        }\n\n        return selectClauseItems;\n      });\n  }\n\n  /** Builds the ECSQL to query the property value changes for the specified instance change and the specified ChangedValueState.\n   *\n   * See also [Change Summary Overview]($docs/learning/ChangeSummaries)\n   * @param iModel iModel\n   * @param instanceChangeInfo InstanceChange to query the property value changes for\n   *        changedInstance.className must be fully qualified and schema and class name must be escaped with square brackets if they collide with reserved ECSQL words: `[schema name].[class name]`\n   * @param changedValueState The Changed State to query the values for. This must correspond to the [InstanceChange.OpCode]($backend) of the InstanceChange.\n   * @param changedPropertyNames List of the property names for which values have changed for the specified instance change.\n   *        The list can be obtained by calling [ChangeSummaryManager.getChangedPropertyValueNames]($core-backend).\n   *        If omitted, the method will call the above method by itself. The parameter allows for checking first whether\n   *        an instance change has any property value changes at all. If there are no property value changes, this method\n   *        should not be called, as it will throw an error.\n   * @returns Returns the ECSQL that will retrieve the property value changes\n   * @throws [IModelError]($common) if instance change does not exist, if there are not property value changes for the instance change,\n   *        if the change cache file hasn't been attached, or in case of other errors.\n   */\n  public static buildPropertyValueChangesECSql(iModel: IModelDb, instanceChangeInfo: { id: Id64String, summaryId: Id64String, changedInstance: { id: Id64String, className: string } }, changedValueState: ChangedValueState, changedPropertyNames?: string[]): string {\n    let selectClauseItems: string[];\n    if (!changedPropertyNames) {\n      // query property value changes just to build a SELECT statement against the class of the changed instance\n      selectClauseItems = ChangeSummaryManager.getChangedPropertyValueNames(iModel, instanceChangeInfo.id);\n    } else\n      selectClauseItems = changedPropertyNames;\n\n    if (selectClauseItems.length === 0)\n      throw new IModelError(IModelStatus.BadArg, `No property value changes found for InstanceChange ${instanceChangeInfo.id}.`);\n\n    let ecsql: string = \"SELECT \";\n    selectClauseItems.map((item: string, index: number) => {\n      if (index !== 0)\n        ecsql += \",\";\n\n      ecsql += item;\n    });\n\n    // Avoiding parameters in the Changes function speeds up performance because ECDb can do optimizations\n    // if it knows the function args at prepare time\n    ecsql += ` FROM main.${instanceChangeInfo.changedInstance.className}.Changes(${instanceChangeInfo.summaryId},${changedValueState}) WHERE ECInstanceId=${instanceChangeInfo.changedInstance.id}`;\n    return ecsql;\n  }\n\n  /**\n   * Creates a change summary for the last applied change set to the iModel\n   * @param accessToken A valid access token string\n   * @param iModel iModel to extract change summaries for. The iModel must not be a standalone iModel, and must have at least one change set applied to it.\n   * @returns The id of the extracted change summary.\n   * @beta\n   */\n  public static async createChangeSummary(accessToken: AccessToken, iModel: BriefcaseDb): Promise<Id64String> {\n    if (!iModel?.isOpen)\n      throw new IModelError(IModelStatus.BadRequest, \"Briefcase must be open\");\n    const changesetId = iModel.changeset.id;\n    if (!changesetId)\n      throw new IModelError(IModelStatus.BadRequest, \"No change set was applied to the iModel\");\n    if (this.isChangeCacheAttached(iModel))\n      throw new IModelError(IModelStatus.BadRequest, \"Change cache must be detached before extraction\");\n\n    const iModelId = iModel.iModelId;\n    const changesetsFolder: string = BriefcaseManager.getChangeSetsPath(iModelId);\n    const changeset = await IModelHost.hubAccess.downloadChangeset({ accessToken, iModelId, changeset: { id: iModel.changeset.id }, targetDir: changesetsFolder });\n\n    if (!IModelJsFs.existsSync(changeset.pathname))\n      throw new IModelError(IModelStatus.FileNotFound, `Failed to download change set: ${changeset.pathname}`);\n\n    let changesFile: ECDb | undefined;\n    try {\n      changesFile = ChangeSummaryManager.openOrCreateChangesFile(iModel);\n      assert(changesFile.nativeDb !== undefined, \"Invalid changesFile - should've caused an exception\");\n\n      let changeSummaryId = ChangeSummaryManager.isSummaryAlreadyExtracted(changesFile, changesetId);\n      if (changeSummaryId !== undefined) {\n        Logger.logInfo(loggerCategory, `Change Summary for changeset already exists. It is not extracted again.`, () => ({ iModelId, changeSetId: changesetId }));\n        return changeSummaryId;\n      }\n\n      const stat = iModel.nativeDb.extractChangeSummary(changesFile.nativeDb, changeset.pathname);\n      if (stat.error && stat.error.status !== DbResult.BE_SQLITE_OK)\n        throw new IModelError(stat.error.status, stat.error.message);\n\n      assert(undefined !== stat.result);\n      changeSummaryId = stat.result;\n      ChangeSummaryManager.addExtendedInfos(changesFile, changeSummaryId, changesetId, changeset.parentId, changeset.description, changeset.pushDate, changeset.userCreated);\n\n      changesFile.saveChanges();\n      return changeSummaryId;\n    } finally {\n      if (changesFile !== undefined)\n        changesFile.dispose();\n      IModelJsFs.unlinkSync(changeset.pathname);\n    }\n  }\n\n  /**\n   * Creates change summaries for the specified iModel and a specified range of versions\n   * @note This may be an expensive operation - downloads the first version and starts applying the change sets, extracting summaries one by one\n   * @param args Arguments including the range of versions for which Change Summaries are to be created, and other necessary input for creation\n   */\n  public static async createChangeSummaries(args: CreateChangeSummaryArgs): Promise<Id64String[]> {\n    const accessToken = args.accessToken ?? await IModelHost.getAccessToken() ?? \"\";\n    const { iModelId, iTwinId, range } = args;\n    range.end = range.end ?? (await IModelHost.hubAccess.getChangesetFromVersion({ accessToken, iModelId, version: IModelVersion.latest() })).index;\n    if (range.first > range.end)\n      throw new IModelError(IModelStatus.BadArg, \"Invalid range of changesets\");\n    if (range.first === 0 && range.end === 0)\n      return []; // no changesets exist, so the inclusive range is empty\n\n    const changesets = await IModelHost.hubAccess.queryChangesets({ accessToken, iModelId, range });\n\n    // Setup a temporary briefcase to help with extracting change summaries\n    const briefcasePath = BriefcaseManager.getBriefcaseBasePath(iModelId);\n    const fileName: string = path.join(briefcasePath, `ChangeSummaryBriefcase.bim`);\n    if (IModelJsFs.existsSync(fileName))\n      IModelJsFs.removeSync(fileName);\n\n    let iModel: BriefcaseDb | undefined;\n    try {\n      // Download a version that has the first change set applied\n      const props = await BriefcaseManager.downloadBriefcase({ accessToken, iTwinId, iModelId, asOf: { afterChangeSetId: changesets[0].id }, briefcaseId: 0, fileName });\n      iModel = await BriefcaseDb.open({ fileName: props.fileName });\n\n      const summaryIds = new Array<Id64String>();\n      for (let index = 0; index < changesets.length; index++) {\n        // Apply a change set if necessary\n        if (index > 0)\n          await iModel.pullChanges({ accessToken, toIndex: changesets[index].index });\n\n        // Create a change summary for the last change set that was applied\n        const summaryId = await this.createChangeSummary(accessToken, iModel);\n        summaryIds.push(summaryId);\n      }\n      return summaryIds;\n    } finally {\n      if (iModel !== undefined)\n        iModel.close();\n      IModelJsFs.removeSync(fileName);\n    }\n  }\n}\n"]}

package/lib/cjs/ChangedElementsDb.js.map

@@ -1 +1 @@
-{"version":3,"file":"ChangedElementsDb.js","sourceRoot":"","sources":["../../src/ChangedElementsDb.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 ChangedElementsDb\r\n */\r\n\r\nimport { AccessToken, DbResult, IDisposable, IModelStatus, OpenMode } from \"@itwin/core-bentley\";\r\nimport { ChangeData, ChangedElements, ChangedModels, IModelError } from \"@itwin/core-common\";\r\nimport { IModelJsNative } from \"@bentley/imodeljs-native\";\r\nimport { BriefcaseManager } from \"./BriefcaseManager\";\r\nimport { ECDbOpenMode } from \"./ECDb\";\r\nimport { IModelDb } from \"./IModelDb\";\r\nimport { IModelHost } from \"./IModelHost\";\r\n\r\n/**\r\n * Options for processChangesets function\r\n * @internal\r\n * */\r\nexport interface ProcessChangesetOptions {\r\n  startChangesetId: string;\r\n  endChangesetId: string;\r\n  rulesetId: string;\r\n  filterSpatial?: boolean;\r\n  wantParents?: boolean;\r\n  wantPropertyChecksums?: boolean;\r\n  rulesetDir?: string;\r\n  tempDir?: string;\r\n  wantRelationshipCaching?: boolean;\r\n  relationshipCacheSize?: number;\r\n  wantChunkTraversal?: boolean;\r\n}\r\n\r\n/** An ChangedElementsDb file\r\n * @internal\r\n */\r\nexport class ChangedElementsDb implements IDisposable {\r\n  private _nativeDb: IModelJsNative.ChangedElementsECDb | undefined;\r\n\r\n  constructor() {\r\n    this._nativeDb = new IModelHost.platform.ChangedElementsECDb();\r\n  }\r\n\r\n  public dispose(): void {\r\n    if (!this._nativeDb)\r\n      return;\r\n\r\n    this.closeDb();\r\n    this._nativeDb.dispose();\r\n    this._nativeDb = undefined;\r\n  }\r\n\r\n  /** Create a ChangedElementsDb\r\n   * @param pathName The path to the ECDb file to create.\r\n   * @throws [IModelError]($common) if the operation failed.\r\n   */\r\n  private _createDb(briefcase: IModelDb, pathName: string): void {\r\n    const status: DbResult = this.nativeDb.createDb(briefcase.nativeDb, pathName);\r\n    if (status !== DbResult.BE_SQLITE_OK)\r\n      throw new IModelError(status, \"Failed to created ECDb\");\r\n  }\r\n\r\n  /** Open the Changed Elements Db.\r\n   * @param pathName The path to the ECDb file to open\r\n   * @param openMode Open mode\r\n   * @throws [IModelError]($common) if the operation failed.\r\n   */\r\n  private _openDb(pathName: string, openMode: ECDbOpenMode = ECDbOpenMode.Readonly): void {\r\n    const nativeOpenMode = openMode === ECDbOpenMode.Readonly ? OpenMode.Readonly : OpenMode.ReadWrite;\r\n    const tryUpgrade = openMode === ECDbOpenMode.FileUpgrade;\r\n    const status = this.nativeDb.openDb(pathName, nativeOpenMode, tryUpgrade);\r\n    if (status !== DbResult.BE_SQLITE_OK)\r\n      throw new IModelError(status, \"Failed to open ECDb\");\r\n  }\r\n\r\n  /** Open the Changed Elements Db.\r\n   * @param pathName The path to the ECDb file to open\r\n   * @param openMode Open mode\r\n   * @returns ChangedElementsDb\r\n   */\r\n  public static openDb(pathName: string, openMode: ECDbOpenMode = ECDbOpenMode.Readonly): ChangedElementsDb {\r\n    const cacheDb = new ChangedElementsDb();\r\n    cacheDb._openDb(pathName, openMode);\r\n    return cacheDb;\r\n  }\r\n\r\n  /** Create the changed elements cache db\r\n   * @param briefcase IModelDb to use\r\n   * @param pathName The path to the ECDb file to create.\r\n   * @returns The new cache db\r\n   */\r\n  public static createDb(briefcase: IModelDb, pathName: string): ChangedElementsDb {\r\n    const cacheDb = new ChangedElementsDb();\r\n    cacheDb._createDb(briefcase, pathName);\r\n    return cacheDb;\r\n  }\r\n\r\n  /** Processes a range of changesets and adds it to the changed elements cache\r\n   * @param briefcase iModel briefcase to use\r\n   * @param options Options for processing\r\n   */\r\n  public async processChangesets(accessToken: AccessToken, briefcase: IModelDb, options: ProcessChangesetOptions): Promise<DbResult> {\r\n    const iModelId = briefcase.iModelId;\r\n    const first = (await IModelHost.hubAccess.queryChangeset({ iModelId, changeset: { id: options.startChangesetId }, accessToken })).index;\r\n    const end = (await IModelHost.hubAccess.queryChangeset({ iModelId, changeset: { id: options.endChangesetId }, accessToken })).index;\r\n    const changesets = await IModelHost.hubAccess.downloadChangesets({ accessToken, iModelId, range: { first, end }, targetDir: BriefcaseManager.getChangeSetsPath(iModelId) });\r\n\r\n    // ChangeSets need to be processed from newest to oldest\r\n    changesets.reverse();\r\n    const status = this.nativeDb.processChangesets(\r\n      briefcase.nativeDb,\r\n      changesets,\r\n      options.rulesetId,\r\n      options.filterSpatial,\r\n      options.wantParents,\r\n      options.wantPropertyChecksums,\r\n      options.rulesetDir,\r\n      options.tempDir,\r\n      options.wantChunkTraversal,\r\n    );\r\n    if (status !== DbResult.BE_SQLITE_OK)\r\n      throw new IModelError(status, \"Failed to process changesets\");\r\n    return status;\r\n  }\r\n\r\n  /** Processes a range of changesets and adds it to the changed elements cache\r\n   * This call will close the IModelDb object as it is required for processing and applying changesets\r\n   * @param briefcase iModel briefcase to use\r\n   * @param options options for processing\r\n   */\r\n  public async processChangesetsAndRoll(accessToken: AccessToken, briefcase: IModelDb, options: ProcessChangesetOptions): Promise<DbResult> {\r\n    const iModelId = briefcase.iModelId;\r\n    const first = (await IModelHost.hubAccess.queryChangeset({ iModelId, changeset: { id: options.startChangesetId }, accessToken })).index;\r\n    const end = (await IModelHost.hubAccess.queryChangeset({ iModelId, changeset: { id: options.endChangesetId }, accessToken })).index;\r\n    const changesets = await IModelHost.hubAccess.downloadChangesets({ accessToken, iModelId, range: { first, end }, targetDir: BriefcaseManager.getChangeSetsPath(iModelId) });\r\n\r\n    // ChangeSets need to be processed from newest to oldest\r\n    changesets.reverse();\r\n    // Close briefcase before doing processing and rolling briefcase\r\n    const dbFilename = briefcase.pathName;\r\n    const dbGuid = briefcase.iModelId;\r\n    briefcase.close();\r\n    // Process changesets\r\n    const status = this.nativeDb.processChangesetsAndRoll(\r\n      dbFilename,\r\n      dbGuid,\r\n      changesets,\r\n      options.rulesetId,\r\n      options.filterSpatial,\r\n      options.wantParents,\r\n      options.wantPropertyChecksums,\r\n      options.rulesetDir,\r\n      options.tempDir,\r\n      options.wantRelationshipCaching,\r\n      options.relationshipCacheSize,\r\n      options.wantChunkTraversal,\r\n    );\r\n    if (status !== DbResult.BE_SQLITE_OK)\r\n      throw new IModelError(status, \"Failed to process changesets\");\r\n    return status;\r\n  }\r\n\r\n  /** Get changed elements between two changesets\r\n   * @param startChangesetId Start Changeset Id\r\n   * @param endChangesetId End Changeset Id\r\n   * @returns Returns the changed elements between the changesets provided\r\n   * @throws [IModelError]($common) if the operation failed.\r\n   */\r\n  public getChangedElements(startChangesetId: string, endChangesetId: string): ChangedElements | undefined {\r\n    const result = this.nativeDb.getChangedElements(startChangesetId, endChangesetId);\r\n    if (result.error || !result.result)\r\n      throw new IModelError(result.error ? result.error.status : -1, result.error ? result.error.message : \"Problem getting changed elements\");\r\n    return (result.result.changedElements) as ChangedElements;\r\n  }\r\n\r\n  /** Get changed models between two changesets\r\n   * @param startChangesetId Start Changeset Id\r\n   * @param endChangesetId End Changeset Id\r\n   * @returns Returns the changed models between the changesets provided\r\n   * @throws [IModelError]($common) if the operation failed.\r\n   */\r\n  public getChangedModels(startChangesetId: string, endChangesetId: string): ChangedModels | undefined {\r\n    const result = this.nativeDb.getChangedElements(startChangesetId, endChangesetId);\r\n    if (result.error || !result.result)\r\n      throw new IModelError(result.error ? result.error.status : -1, result.error ? result.error.message : \"Problem getting changed models\");\r\n    return (result.result.changedModels) as ChangedModels;\r\n  }\r\n\r\n  /** Get changed models between two changesets\r\n   * @param startChangesetId Start Changeset Id\r\n   * @param endChangesetId End Changeset Id\r\n   * @returns Returns the changed models between the changesets provided\r\n   * @throws [IModelError]($common) if the operation failed.\r\n   */\r\n  public getChangeData(startChangesetId: string, endChangesetId: string): ChangeData | undefined {\r\n    const result = this.nativeDb.getChangedElements(startChangesetId, endChangesetId);\r\n    if (result.error)\r\n      throw new IModelError(result.error.status, result.error.message);\r\n    return result.result as ChangeData;\r\n  }\r\n\r\n  /** Returns true if the Changed Elements Db is open */\r\n  public get isOpen(): boolean { return this.nativeDb.isOpen(); }\r\n\r\n  /** Returns true if the cache already contains this changeset Id */\r\n  public isProcessed(changesetId: string): boolean { return this.nativeDb.isProcessed(changesetId); }\r\n\r\n  /** Close the Db after saving any uncommitted changes.\r\n   * @throws [IModelError]($common) if the database is not open.\r\n   */\r\n  public closeDb(): void {\r\n    this.nativeDb.closeDb();\r\n  }\r\n\r\n  public cleanCaches(): void {\r\n    this.nativeDb.cleanCaches();\r\n  }\r\n\r\n  /** @internal */\r\n  public get nativeDb(): IModelJsNative.ChangedElementsECDb {\r\n    if (!this._nativeDb)\r\n      throw new IModelError(IModelStatus.BadRequest, \"ChangedElementsDb object has already been disposed.\");\r\n\r\n    return this._nativeDb;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"ChangedElementsDb.js","sourceRoot":"","sources":["../../src/ChangedElementsDb.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 ChangedElementsDb\n */\n\nimport { AccessToken, DbResult, IDisposable, IModelStatus, OpenMode } from \"@itwin/core-bentley\";\nimport { ChangeData, ChangedElements, ChangedModels, IModelError } from \"@itwin/core-common\";\nimport { IModelJsNative } from \"@bentley/imodeljs-native\";\nimport { BriefcaseManager } from \"./BriefcaseManager\";\nimport { ECDbOpenMode } from \"./ECDb\";\nimport { IModelDb } from \"./IModelDb\";\nimport { IModelHost } from \"./IModelHost\";\n\n/**\n * Options for processChangesets function\n * @internal\n * */\nexport interface ProcessChangesetOptions {\n  startChangesetId: string;\n  endChangesetId: string;\n  rulesetId: string;\n  filterSpatial?: boolean;\n  wantParents?: boolean;\n  wantPropertyChecksums?: boolean;\n  rulesetDir?: string;\n  tempDir?: string;\n  wantRelationshipCaching?: boolean;\n  relationshipCacheSize?: number;\n  wantChunkTraversal?: boolean;\n}\n\n/** An ChangedElementsDb file\n * @internal\n */\nexport class ChangedElementsDb implements IDisposable {\n  private _nativeDb: IModelJsNative.ChangedElementsECDb | undefined;\n\n  constructor() {\n    this._nativeDb = new IModelHost.platform.ChangedElementsECDb();\n  }\n\n  public dispose(): void {\n    if (!this._nativeDb)\n      return;\n\n    this.closeDb();\n    this._nativeDb.dispose();\n    this._nativeDb = undefined;\n  }\n\n  /** Create a ChangedElementsDb\n   * @param pathName The path to the ECDb file to create.\n   * @throws [IModelError]($common) if the operation failed.\n   */\n  private _createDb(briefcase: IModelDb, pathName: string): void {\n    const status: DbResult = this.nativeDb.createDb(briefcase.nativeDb, pathName);\n    if (status !== DbResult.BE_SQLITE_OK)\n      throw new IModelError(status, \"Failed to created ECDb\");\n  }\n\n  /** Open the Changed Elements Db.\n   * @param pathName The path to the ECDb file to open\n   * @param openMode Open mode\n   * @throws [IModelError]($common) if the operation failed.\n   */\n  private _openDb(pathName: string, openMode: ECDbOpenMode = ECDbOpenMode.Readonly): void {\n    const nativeOpenMode = openMode === ECDbOpenMode.Readonly ? OpenMode.Readonly : OpenMode.ReadWrite;\n    const tryUpgrade = openMode === ECDbOpenMode.FileUpgrade;\n    const status = this.nativeDb.openDb(pathName, nativeOpenMode, tryUpgrade);\n    if (status !== DbResult.BE_SQLITE_OK)\n      throw new IModelError(status, \"Failed to open ECDb\");\n  }\n\n  /** Open the Changed Elements Db.\n   * @param pathName The path to the ECDb file to open\n   * @param openMode Open mode\n   * @returns ChangedElementsDb\n   */\n  public static openDb(pathName: string, openMode: ECDbOpenMode = ECDbOpenMode.Readonly): ChangedElementsDb {\n    const cacheDb = new ChangedElementsDb();\n    cacheDb._openDb(pathName, openMode);\n    return cacheDb;\n  }\n\n  /** Create the changed elements cache db\n   * @param briefcase IModelDb to use\n   * @param pathName The path to the ECDb file to create.\n   * @returns The new cache db\n   */\n  public static createDb(briefcase: IModelDb, pathName: string): ChangedElementsDb {\n    const cacheDb = new ChangedElementsDb();\n    cacheDb._createDb(briefcase, pathName);\n    return cacheDb;\n  }\n\n  /** Processes a range of changesets and adds it to the changed elements cache\n   * @param briefcase iModel briefcase to use\n   * @param options Options for processing\n   */\n  public async processChangesets(accessToken: AccessToken, briefcase: IModelDb, options: ProcessChangesetOptions): Promise<DbResult> {\n    const iModelId = briefcase.iModelId;\n    const first = (await IModelHost.hubAccess.queryChangeset({ iModelId, changeset: { id: options.startChangesetId }, accessToken })).index;\n    const end = (await IModelHost.hubAccess.queryChangeset({ iModelId, changeset: { id: options.endChangesetId }, accessToken })).index;\n    const changesets = await IModelHost.hubAccess.downloadChangesets({ accessToken, iModelId, range: { first, end }, targetDir: BriefcaseManager.getChangeSetsPath(iModelId) });\n\n    // ChangeSets need to be processed from newest to oldest\n    changesets.reverse();\n    const status = this.nativeDb.processChangesets(\n      briefcase.nativeDb,\n      changesets,\n      options.rulesetId,\n      options.filterSpatial,\n      options.wantParents,\n      options.wantPropertyChecksums,\n      options.rulesetDir,\n      options.tempDir,\n      options.wantChunkTraversal,\n    );\n    if (status !== DbResult.BE_SQLITE_OK)\n      throw new IModelError(status, \"Failed to process changesets\");\n    return status;\n  }\n\n  /** Processes a range of changesets and adds it to the changed elements cache\n   * This call will close the IModelDb object as it is required for processing and applying changesets\n   * @param briefcase iModel briefcase to use\n   * @param options options for processing\n   */\n  public async processChangesetsAndRoll(accessToken: AccessToken, briefcase: IModelDb, options: ProcessChangesetOptions): Promise<DbResult> {\n    const iModelId = briefcase.iModelId;\n    const first = (await IModelHost.hubAccess.queryChangeset({ iModelId, changeset: { id: options.startChangesetId }, accessToken })).index;\n    const end = (await IModelHost.hubAccess.queryChangeset({ iModelId, changeset: { id: options.endChangesetId }, accessToken })).index;\n    const changesets = await IModelHost.hubAccess.downloadChangesets({ accessToken, iModelId, range: { first, end }, targetDir: BriefcaseManager.getChangeSetsPath(iModelId) });\n\n    // ChangeSets need to be processed from newest to oldest\n    changesets.reverse();\n    // Close briefcase before doing processing and rolling briefcase\n    const dbFilename = briefcase.pathName;\n    const dbGuid = briefcase.iModelId;\n    briefcase.close();\n    // Process changesets\n    const status = this.nativeDb.processChangesetsAndRoll(\n      dbFilename,\n      dbGuid,\n      changesets,\n      options.rulesetId,\n      options.filterSpatial,\n      options.wantParents,\n      options.wantPropertyChecksums,\n      options.rulesetDir,\n      options.tempDir,\n      options.wantRelationshipCaching,\n      options.relationshipCacheSize,\n      options.wantChunkTraversal,\n    );\n    if (status !== DbResult.BE_SQLITE_OK)\n      throw new IModelError(status, \"Failed to process changesets\");\n    return status;\n  }\n\n  /** Get changed elements between two changesets\n   * @param startChangesetId Start Changeset Id\n   * @param endChangesetId End Changeset Id\n   * @returns Returns the changed elements between the changesets provided\n   * @throws [IModelError]($common) if the operation failed.\n   */\n  public getChangedElements(startChangesetId: string, endChangesetId: string): ChangedElements | undefined {\n    const result = this.nativeDb.getChangedElements(startChangesetId, endChangesetId);\n    if (result.error || !result.result)\n      throw new IModelError(result.error ? result.error.status : -1, result.error ? result.error.message : \"Problem getting changed elements\");\n    return (result.result.changedElements) as ChangedElements;\n  }\n\n  /** Get changed models between two changesets\n   * @param startChangesetId Start Changeset Id\n   * @param endChangesetId End Changeset Id\n   * @returns Returns the changed models between the changesets provided\n   * @throws [IModelError]($common) if the operation failed.\n   */\n  public getChangedModels(startChangesetId: string, endChangesetId: string): ChangedModels | undefined {\n    const result = this.nativeDb.getChangedElements(startChangesetId, endChangesetId);\n    if (result.error || !result.result)\n      throw new IModelError(result.error ? result.error.status : -1, result.error ? result.error.message : \"Problem getting changed models\");\n    return (result.result.changedModels) as ChangedModels;\n  }\n\n  /** Get changed models between two changesets\n   * @param startChangesetId Start Changeset Id\n   * @param endChangesetId End Changeset Id\n   * @returns Returns the changed models between the changesets provided\n   * @throws [IModelError]($common) if the operation failed.\n   */\n  public getChangeData(startChangesetId: string, endChangesetId: string): ChangeData | undefined {\n    const result = this.nativeDb.getChangedElements(startChangesetId, endChangesetId);\n    if (result.error)\n      throw new IModelError(result.error.status, result.error.message);\n    return result.result as ChangeData;\n  }\n\n  /** Returns true if the Changed Elements Db is open */\n  public get isOpen(): boolean { return this.nativeDb.isOpen(); }\n\n  /** Returns true if the cache already contains this changeset Id */\n  public isProcessed(changesetId: string): boolean { return this.nativeDb.isProcessed(changesetId); }\n\n  /** Close the Db after saving any uncommitted changes.\n   * @throws [IModelError]($common) if the database is not open.\n   */\n  public closeDb(): void {\n    this.nativeDb.closeDb();\n  }\n\n  public cleanCaches(): void {\n    this.nativeDb.cleanCaches();\n  }\n\n  /** @internal */\n  public get nativeDb(): IModelJsNative.ChangedElementsECDb {\n    if (!this._nativeDb)\n      throw new IModelError(IModelStatus.BadRequest, \"ChangedElementsDb object has already been disposed.\");\n\n    return this._nativeDb;\n  }\n}\n"]}

package/lib/cjs/ChangedElementsManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"ChangedElementsManager.js","sourceRoot":"","sources":["../../src/ChangedElementsManager.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 { GuidString } from \"@itwin/core-bentley\";\r\nimport { ChangeData, ChangedElements, ChangedModels } from \"@itwin/core-common\";\r\nimport { BriefcaseManager } from \"./BriefcaseManager\";\r\nimport { ChangedElementsDb } from \"./ChangedElementsDb\";\r\nimport { IModelJsFs } from \"./IModelJsFs\";\r\n\r\n/** @internal */\r\ninterface ChangedElementsDbCacheEntry {\r\n  iModelId: GuidString;\r\n  db: ChangedElementsDb;\r\n}\r\n\r\n/** Utilities for querying changed elements caches */\r\n/** @internal */\r\nexport class ChangedElementsManager {\r\n  /** Maintains a single entry since we will only have a cache per iModel, which means a ChangedElementsDb per backend instance */\r\n  private static _entry: ChangedElementsDbCacheEntry | undefined;\r\n\r\n  public static getChangedElementsPathName(iModelId: GuidString): string { return BriefcaseManager.getChangedElementsPathName(iModelId); }\r\n\r\n  /** Get changed elements Db */\r\n  private static getChangedElementsDb(iModelId: GuidString): ChangedElementsDb | undefined {\r\n    if (this._entry && this._entry.iModelId === iModelId)\r\n      return this._entry.db;\r\n    if (this._entry && this._entry.iModelId !== iModelId) {\r\n      this._entry.db.closeDb();\r\n      this._entry.db.cleanCaches();\r\n      this._entry = undefined;\r\n    }\r\n    if (!this._entry) {\r\n      const path = ChangedElementsManager.getChangedElementsPathName(iModelId);\r\n      if (!IModelJsFs.existsSync(path))\r\n        return undefined;\r\n\r\n      const db: ChangedElementsDb = ChangedElementsDb.openDb(path);\r\n      this._entry = {\r\n        iModelId,\r\n        db,\r\n      };\r\n\r\n      return db;\r\n    }\r\n\r\n    return undefined;\r\n  }\r\n\r\n  public static cleanUp() {\r\n    if (this._entry) {\r\n      this._entry.db.closeDb();\r\n      this._entry.db.cleanCaches();\r\n      this._entry = undefined;\r\n    }\r\n  }\r\n\r\n  /** Gets the changed elements from the cache if found\r\n   * @param iModelId Id of the iModel\r\n   * @param startChangesetId Start changeset Id\r\n   * @param endChangesetId End changeset Id\r\n   * @returns Changed elements if found\r\n   */\r\n  public static getChangedElements(iModelId: GuidString, startChangesetId: string, endChangesetId: string): ChangedElements | undefined {\r\n    const db: ChangedElementsDb | undefined = ChangedElementsManager.getChangedElementsDb(iModelId);\r\n    if (!db)\r\n      return undefined;\r\n\r\n    return db.getChangedElements(startChangesetId, endChangesetId);\r\n  }\r\n\r\n  /** Gets the changed models from the cache if found\r\n   * @param iModelId Id of the iModel\r\n   * @param startChangesetId Start changeset Id\r\n   * @param endChangesetId End changeset Id\r\n   * @returns Changed models if found\r\n   */\r\n  public static getChangedModels(iModelId: GuidString, startChangesetId: string, endChangesetId: string): ChangedModels | undefined {\r\n    const db: ChangedElementsDb | undefined = ChangedElementsManager.getChangedElementsDb(iModelId);\r\n    if (!db)\r\n      return undefined;\r\n\r\n    return db.getChangedModels(startChangesetId, endChangesetId);\r\n  }\r\n\r\n  /** Gets the change data (models and elements) from the cache if found\r\n   * @param iModelId Id of the iModel\r\n   * @param startChangesetId Start changeset Id\r\n   * @param endChangesetId End changeset Id\r\n   * @returns Changed models if found\r\n   */\r\n  public static getChangeData(iModelId: GuidString, startChangesetId: string, endChangesetId: string): ChangeData | undefined {\r\n    const db: ChangedElementsDb | undefined = ChangedElementsManager.getChangedElementsDb(iModelId);\r\n    if (!db)\r\n      return undefined;\r\n\r\n    return db.getChangeData(startChangesetId, endChangesetId);\r\n  }\r\n\r\n  /** Checks if the cache contains information about the changeset\r\n   * @param iModelId Id of the iModel\r\n   * @param changesetId Changeset to check for\r\n   * @returns true if the changeset has been processed and exists in the cache\r\n   */\r\n  public static isProcessed(iModelId: GuidString, changesetId: string): boolean {\r\n    const db: ChangedElementsDb | undefined = ChangedElementsManager.getChangedElementsDb(iModelId);\r\n    if (!db)\r\n      return false;\r\n\r\n    return db.isProcessed(changesetId);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"ChangedElementsManager.js","sourceRoot":"","sources":["../../src/ChangedElementsManager.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*--------------------------------------------------------------------------------------------*/\nimport { GuidString } from \"@itwin/core-bentley\";\nimport { ChangeData, ChangedElements, ChangedModels } from \"@itwin/core-common\";\nimport { BriefcaseManager } from \"./BriefcaseManager\";\nimport { ChangedElementsDb } from \"./ChangedElementsDb\";\nimport { IModelJsFs } from \"./IModelJsFs\";\n\n/** @internal */\ninterface ChangedElementsDbCacheEntry {\n  iModelId: GuidString;\n  db: ChangedElementsDb;\n}\n\n/** Utilities for querying changed elements caches */\n/** @internal */\nexport class ChangedElementsManager {\n  /** Maintains a single entry since we will only have a cache per iModel, which means a ChangedElementsDb per backend instance */\n  private static _entry: ChangedElementsDbCacheEntry | undefined;\n\n  public static getChangedElementsPathName(iModelId: GuidString): string { return BriefcaseManager.getChangedElementsPathName(iModelId); }\n\n  /** Get changed elements Db */\n  private static getChangedElementsDb(iModelId: GuidString): ChangedElementsDb | undefined {\n    if (this._entry && this._entry.iModelId === iModelId)\n      return this._entry.db;\n    if (this._entry && this._entry.iModelId !== iModelId) {\n      this._entry.db.closeDb();\n      this._entry.db.cleanCaches();\n      this._entry = undefined;\n    }\n    if (!this._entry) {\n      const path = ChangedElementsManager.getChangedElementsPathName(iModelId);\n      if (!IModelJsFs.existsSync(path))\n        return undefined;\n\n      const db: ChangedElementsDb = ChangedElementsDb.openDb(path);\n      this._entry = {\n        iModelId,\n        db,\n      };\n\n      return db;\n    }\n\n    return undefined;\n  }\n\n  public static cleanUp() {\n    if (this._entry) {\n      this._entry.db.closeDb();\n      this._entry.db.cleanCaches();\n      this._entry = undefined;\n    }\n  }\n\n  /** Gets the changed elements from the cache if found\n   * @param iModelId Id of the iModel\n   * @param startChangesetId Start changeset Id\n   * @param endChangesetId End changeset Id\n   * @returns Changed elements if found\n   */\n  public static getChangedElements(iModelId: GuidString, startChangesetId: string, endChangesetId: string): ChangedElements | undefined {\n    const db: ChangedElementsDb | undefined = ChangedElementsManager.getChangedElementsDb(iModelId);\n    if (!db)\n      return undefined;\n\n    return db.getChangedElements(startChangesetId, endChangesetId);\n  }\n\n  /** Gets the changed models from the cache if found\n   * @param iModelId Id of the iModel\n   * @param startChangesetId Start changeset Id\n   * @param endChangesetId End changeset Id\n   * @returns Changed models if found\n   */\n  public static getChangedModels(iModelId: GuidString, startChangesetId: string, endChangesetId: string): ChangedModels | undefined {\n    const db: ChangedElementsDb | undefined = ChangedElementsManager.getChangedElementsDb(iModelId);\n    if (!db)\n      return undefined;\n\n    return db.getChangedModels(startChangesetId, endChangesetId);\n  }\n\n  /** Gets the change data (models and elements) from the cache if found\n   * @param iModelId Id of the iModel\n   * @param startChangesetId Start changeset Id\n   * @param endChangesetId End changeset Id\n   * @returns Changed models if found\n   */\n  public static getChangeData(iModelId: GuidString, startChangesetId: string, endChangesetId: string): ChangeData | undefined {\n    const db: ChangedElementsDb | undefined = ChangedElementsManager.getChangedElementsDb(iModelId);\n    if (!db)\n      return undefined;\n\n    return db.getChangeData(startChangesetId, endChangesetId);\n  }\n\n  /** Checks if the cache contains information about the changeset\n   * @param iModelId Id of the iModel\n   * @param changesetId Changeset to check for\n   * @returns true if the changeset has been processed and exists in the cache\n   */\n  public static isProcessed(iModelId: GuidString, changesetId: string): boolean {\n    const db: ChangedElementsDb | undefined = ChangedElementsManager.getChangedElementsDb(iModelId);\n    if (!db)\n      return false;\n\n    return db.isProcessed(changesetId);\n  }\n}\n"]}

package/lib/cjs/ChannelControl.js.map

@@ -1 +1 @@
-{"version":3,"file":"ChannelControl.js","sourceRoot":"","sources":["../../src/ChannelControl.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 Elements\r\n */\r\n\r\nimport { DbResult, Id64String, IModelStatus, RepositoryStatus } from \"@itwin/core-bentley\";\r\nimport { ChannelRootAspectProps, IModel, IModelError } from \"@itwin/core-common\";\r\nimport { Subject } from \"./Element\";\r\nimport { IModelDb } from \"./IModelDb\";\r\n\r\n/** The key for a channel. Used for \"allowed channels\" in [[ChannelControl]]\r\n * @beta\r\n */\r\nexport type ChannelKey = string;\r\n\r\n/**\r\n * Controls which channels of an iModel are permitted for write operations. An implementation of this interface is\r\n * available via [[IModelDb.channels]].\r\n * @see [Working With Channels]($docs/learning/backend/Channel.md) for details\r\n * @beta\r\n */\r\nexport interface ChannelControl {\r\n  /** Determine whether this [[IModelDb]] has any channels in it. */\r\n  get hasChannels(): boolean;\r\n  /** Add a new channel to the list of allowed channels of the [[IModelDb]] for this session.\r\n   * @param channelKey The key for the channel to become editable in this session.\r\n   */\r\n  addAllowedChannel(channelKey: ChannelKey): void;\r\n  /** Remove a channel from the list of allowed channels of the [[IModelDb]] for this session.\r\n   * @param channelKey The key of the channel that should no longer be editable in this session.\r\n   */\r\n  removeAllowedChannel(channelKey: ChannelKey): void;\r\n  /** Get the channelKey of the channel for an element by ElementId.\r\n   * @throws if the element does not exist\r\n   */\r\n  getChannelKey(elementId: Id64String): ChannelKey;\r\n  /** Insert a new Subject element that defines a new Channel in this iModel.\r\n   * @returns the ElementId of the new Subject element.\r\n   */\r\n  insertChannelSubject(args: {\r\n    /** The name of the new Subject element */\r\n    subjectName: string;\r\n    /** The channel key for the new [[Subject]]. This is the string to pass to [[addAllowedChannel]]*/\r\n    channelKey: ChannelKey;\r\n    /** the Id of the parent of the new Subject. Default is [[IModel.rootSubjectId]]. */\r\n    parentSubjectId?: Id64String;\r\n    /** Optional description for new Subject. */\r\n    description?: string;\r\n  }): Id64String;\r\n\r\n  /** @internal */\r\n  verifyChannel(modelId: Id64String): void;\r\n}\r\n\r\n/** @internal */\r\nexport class ChannelAdmin implements ChannelControl {\r\n  /** the name of the special \"shared\" channel holding information that is editable by any application. */\r\n  public static readonly sharedChannel = \"shared\";\r\n  public static readonly channelClassName = \"bis:ChannelRootAspect\";\r\n  private _allowedChannels = new Set<ChannelKey>();\r\n  private _allowedModels = new Set<Id64String>();\r\n  private _deniedModels = new Map<Id64String, ChannelKey>();\r\n  private _hasChannels?: boolean;\r\n\r\n  public constructor(private _iModel: IModelDb) {\r\n    this._allowedChannels.add(ChannelAdmin.sharedChannel);\r\n  }\r\n  public addAllowedChannel(channelKey: ChannelKey) {\r\n    this._allowedChannels.add(channelKey);\r\n    this._deniedModels.clear();\r\n  }\r\n  public removeAllowedChannel(channelKey: ChannelKey) {\r\n    this._allowedChannels.delete(channelKey);\r\n    this._allowedModels.clear();\r\n  }\r\n  public get hasChannels(): boolean {\r\n    if (undefined === this._hasChannels) {\r\n      try {\r\n        this._hasChannels = this._iModel.withStatement(`SELECT 1 FROM ${ChannelAdmin.channelClassName}`, (stmt) => stmt.step() === DbResult.BE_SQLITE_ROW, false);\r\n      } catch (e) {\r\n        // iModel doesn't have channel class in its BIS schema\r\n        this._hasChannels = false;\r\n      }\r\n    }\r\n    return this._hasChannels;\r\n  }\r\n  public getChannelKey(elementId: Id64String): ChannelKey {\r\n    if (!this.hasChannels || elementId === IModel.rootSubjectId)\r\n      return ChannelAdmin.sharedChannel;\r\n\r\n    const channel = this._iModel.withPreparedStatement(`SELECT Owner FROM ${ChannelAdmin.channelClassName} WHERE Element.Id=?`, (stmt) => {\r\n      stmt.bindId(1, elementId);\r\n      return DbResult.BE_SQLITE_ROW === stmt.step() ? stmt.getValue(0).getString() : undefined;\r\n    });\r\n    if (channel !== undefined)\r\n      return channel;\r\n    const parentId = this._iModel.withPreparedSqliteStatement(\"SELECT ParentId,ModelId FROM bis_Element WHERE id=?\", (stmt) => {\r\n      stmt.bindId(1, elementId);\r\n      if (DbResult.BE_SQLITE_ROW !== stmt.step())\r\n        throw new IModelError(IModelStatus.NotFound, \"Element does not exist\");\r\n      return stmt.getValueId(0) ?? stmt.getValueId(1); // if parent is undefined, use modelId\r\n    });\r\n    return this.getChannelKey(parentId);\r\n  }\r\n  public verifyChannel(modelId: Id64String): void {\r\n    // Note: indirect changes are permitted to change any channel\r\n    if (!this.hasChannels || this._allowedModels.has(modelId) || this._iModel.nativeDb.isIndirectChanges())\r\n      return;\r\n\r\n    const deniedChannel = this._deniedModels.get(modelId);\r\n    if (undefined !== deniedChannel)\r\n      throw new IModelError(RepositoryStatus.ChannelConstraintViolation, `channel \"${deniedChannel}\" is not allowed`);\r\n\r\n    const channel = this.getChannelKey(modelId);\r\n    if (this._allowedChannels.has(channel)) {\r\n      this._allowedModels.add(modelId);\r\n      return;\r\n    }\r\n    this._deniedModels.set(modelId, channel);\r\n    return this.verifyChannel(modelId);\r\n  }\r\n  public insertChannelSubject(args: { subjectName: string, channelKey: ChannelKey, parentSubjectId?: Id64String, description?: string }): Id64String {\r\n    if (args.parentSubjectId && ChannelAdmin.sharedChannel !== this.getChannelKey(args.parentSubjectId))\r\n      throw new Error(\"channels may not nest\");\r\n\r\n    const subjectId = Subject.insert(this._iModel, args.parentSubjectId ?? IModel.rootSubjectId, args.subjectName, args.description);\r\n    const props: ChannelRootAspectProps = { classFullName: ChannelAdmin.channelClassName, element: { id: subjectId }, owner: args.channelKey };\r\n    this._iModel.elements.insertAspect(props);\r\n    this._hasChannels = true;\r\n    return subjectId;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"ChannelControl.js","sourceRoot":"","sources":["../../src/ChannelControl.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 Elements\n */\n\nimport { DbResult, Id64String, IModelStatus, RepositoryStatus } from \"@itwin/core-bentley\";\nimport { ChannelRootAspectProps, IModel, IModelError } from \"@itwin/core-common\";\nimport { Subject } from \"./Element\";\nimport { IModelDb } from \"./IModelDb\";\n\n/** The key for a channel. Used for \"allowed channels\" in [[ChannelControl]]\n * @beta\n */\nexport type ChannelKey = string;\n\n/**\n * Controls which channels of an iModel are permitted for write operations. An implementation of this interface is\n * available via [[IModelDb.channels]].\n * @see [Working With Channels]($docs/learning/backend/Channel.md) for details\n * @beta\n */\nexport interface ChannelControl {\n  /** Determine whether this [[IModelDb]] has any channels in it. */\n  get hasChannels(): boolean;\n  /** Add a new channel to the list of allowed channels of the [[IModelDb]] for this session.\n   * @param channelKey The key for the channel to become editable in this session.\n   */\n  addAllowedChannel(channelKey: ChannelKey): void;\n  /** Remove a channel from the list of allowed channels of the [[IModelDb]] for this session.\n   * @param channelKey The key of the channel that should no longer be editable in this session.\n   */\n  removeAllowedChannel(channelKey: ChannelKey): void;\n  /** Get the channelKey of the channel for an element by ElementId.\n   * @throws if the element does not exist\n   */\n  getChannelKey(elementId: Id64String): ChannelKey;\n  /** Insert a new Subject element that defines a new Channel in this iModel.\n   * @returns the ElementId of the new Subject element.\n   */\n  insertChannelSubject(args: {\n    /** The name of the new Subject element */\n    subjectName: string;\n    /** The channel key for the new [[Subject]]. This is the string to pass to [[addAllowedChannel]]*/\n    channelKey: ChannelKey;\n    /** the Id of the parent of the new Subject. Default is [[IModel.rootSubjectId]]. */\n    parentSubjectId?: Id64String;\n    /** Optional description for new Subject. */\n    description?: string;\n  }): Id64String;\n\n  /** @internal */\n  verifyChannel(modelId: Id64String): void;\n}\n\n/** @internal */\nexport class ChannelAdmin implements ChannelControl {\n  /** the name of the special \"shared\" channel holding information that is editable by any application. */\n  public static readonly sharedChannel = \"shared\";\n  public static readonly channelClassName = \"bis:ChannelRootAspect\";\n  private _allowedChannels = new Set<ChannelKey>();\n  private _allowedModels = new Set<Id64String>();\n  private _deniedModels = new Map<Id64String, ChannelKey>();\n  private _hasChannels?: boolean;\n\n  public constructor(private _iModel: IModelDb) {\n    this._allowedChannels.add(ChannelAdmin.sharedChannel);\n  }\n  public addAllowedChannel(channelKey: ChannelKey) {\n    this._allowedChannels.add(channelKey);\n    this._deniedModels.clear();\n  }\n  public removeAllowedChannel(channelKey: ChannelKey) {\n    this._allowedChannels.delete(channelKey);\n    this._allowedModels.clear();\n  }\n  public get hasChannels(): boolean {\n    if (undefined === this._hasChannels) {\n      try {\n        this._hasChannels = this._iModel.withStatement(`SELECT 1 FROM ${ChannelAdmin.channelClassName}`, (stmt) => stmt.step() === DbResult.BE_SQLITE_ROW, false);\n      } catch (e) {\n        // iModel doesn't have channel class in its BIS schema\n        this._hasChannels = false;\n      }\n    }\n    return this._hasChannels;\n  }\n  public getChannelKey(elementId: Id64String): ChannelKey {\n    if (!this.hasChannels || elementId === IModel.rootSubjectId)\n      return ChannelAdmin.sharedChannel;\n\n    const channel = this._iModel.withPreparedStatement(`SELECT Owner FROM ${ChannelAdmin.channelClassName} WHERE Element.Id=?`, (stmt) => {\n      stmt.bindId(1, elementId);\n      return DbResult.BE_SQLITE_ROW === stmt.step() ? stmt.getValue(0).getString() : undefined;\n    });\n    if (channel !== undefined)\n      return channel;\n    const parentId = this._iModel.withPreparedSqliteStatement(\"SELECT ParentId,ModelId FROM bis_Element WHERE id=?\", (stmt) => {\n      stmt.bindId(1, elementId);\n      if (DbResult.BE_SQLITE_ROW !== stmt.step())\n        throw new IModelError(IModelStatus.NotFound, \"Element does not exist\");\n      return stmt.getValueId(0) ?? stmt.getValueId(1); // if parent is undefined, use modelId\n    });\n    return this.getChannelKey(parentId);\n  }\n  public verifyChannel(modelId: Id64String): void {\n    // Note: indirect changes are permitted to change any channel\n    if (!this.hasChannels || this._allowedModels.has(modelId) || this._iModel.nativeDb.isIndirectChanges())\n      return;\n\n    const deniedChannel = this._deniedModels.get(modelId);\n    if (undefined !== deniedChannel)\n      throw new IModelError(RepositoryStatus.ChannelConstraintViolation, `channel \"${deniedChannel}\" is not allowed`);\n\n    const channel = this.getChannelKey(modelId);\n    if (this._allowedChannels.has(channel)) {\n      this._allowedModels.add(modelId);\n      return;\n    }\n    this._deniedModels.set(modelId, channel);\n    return this.verifyChannel(modelId);\n  }\n  public insertChannelSubject(args: { subjectName: string, channelKey: ChannelKey, parentSubjectId?: Id64String, description?: string }): Id64String {\n    if (args.parentSubjectId && ChannelAdmin.sharedChannel !== this.getChannelKey(args.parentSubjectId))\n      throw new Error(\"channels may not nest\");\n\n    const subjectId = Subject.insert(this._iModel, args.parentSubjectId ?? IModel.rootSubjectId, args.subjectName, args.description);\n    const props: ChannelRootAspectProps = { classFullName: ChannelAdmin.channelClassName, element: { id: subjectId }, owner: args.channelKey };\n    this._iModel.elements.insertAspect(props);\n    this._hasChannels = true;\n    return subjectId;\n  }\n}\n"]}

package/lib/cjs/CheckpointManager.js

@@ -69,7 +69,7 @@ class V2CheckpointManager {
         }
         return cloudCachePath;
     }
-    /* only used by tests that reset the state of the v2checkpointmanager. all dbs should be closed before calling this function. */
+    /* only used by tests that reset the state of the v2CheckpointManager. all dbs should be closed before calling this function. */
     static cleanup() {
         for (const [_, value] of this.containers.entries()) {
             if (value.isConnected)
@@ -106,7 +106,7 @@ class V2CheckpointManager {
     }
     /** Member names differ slightly between the V2Checkpoint api and the CloudSqlite api. Add aliases `accessName` for `accountName` and `accessToken` for `sasToken` */
     static toCloudContainerProps(from) {
-        return { ...from, accessName: from.accountName, accessToken: from.sasToken };
+        return { ...from, baseUri: `https://${from.accountName}.blob.core.windows.net`, accessToken: from.sasToken, storageType: "azure" };
     }
     static getContainer(v2Props) {
         let container = this.containers.get(v2Props.containerId);