@itwin/core-backend 3.0.0-dev.100

package/lib/cjs/BisCoreSchema.js

@@ -0,0 +1,61 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Schema
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BisCoreSchema = void 0;
+const path = require("path");
+const categoryMod = require("./Category");
+const ClassRegistry_1 = require("./ClassRegistry");
+const elementMod = require("./Element");
+const aspectMod = require("./ElementAspect");
+const externalSourceMod = require("./ExternalSource");
+const IModelHost_1 = require("./IModelHost");
+const materialMod = require("./Material");
+const modelMod = require("./Model");
+const linkMod = require("./Relationship");
+const Schema_1 = require("./Schema");
+const textureMod = require("./Texture");
+const viewMod = require("./ViewDefinition");
+const displayStyleMod = require("./DisplayStyle");
+/**
+ * The [BisCore]($docs/bis/intro/schemas-domains.md) schema is the lowest level Schema in an iModel.
+ *
+ * It is automatically registered when [[IModelHost.startup]] is called.
+ *
+ * ** Example:**
+ * ``` ts
+ * [[include:BisCore.registerSchemaAndGetClass]]
+ * ```
+ * @public
+ */
+class BisCoreSchema extends Schema_1.Schema {
+    static get schemaName() { return "BisCore"; }
+    static get schemaFilePath() { return path.join(IModelHost_1.KnownLocations.nativeAssetsDir, "ECSchemas", "Dgn", `${BisCoreSchema.schemaName}.ecschema.xml`); }
+    /** @internal */
+    static registerSchema() {
+        if (this === Schema_1.Schemas.getRegisteredSchema(this.schemaName))
+            return;
+        Schema_1.Schemas.unregisterSchema(this.schemaName);
+        Schema_1.Schemas.registerSchema(this);
+        // this list should include all backend .ts files with implementations of Entity-based classes. Order does not matter.
+        [
+            elementMod,
+            aspectMod,
+            modelMod,
+            categoryMod,
+            viewMod,
+            linkMod,
+            textureMod,
+            materialMod,
+            externalSourceMod,
+            displayStyleMod,
+        ].forEach((module) => ClassRegistry_1.ClassRegistry.registerModule(module, this));
+    }
+}
+exports.BisCoreSchema = BisCoreSchema;
+//# sourceMappingURL=BisCoreSchema.js.map

package/lib/cjs/BisCoreSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BisCoreSchema.js","sourceRoot":"","sources":["../../src/BisCoreSchema.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,6BAA6B;AAC7B,0CAA0C;AAC1C,mDAAgD;AAChD,wCAAwC;AACxC,6CAA6C;AAC7C,sDAAsD;AACtD,6CAA8C;AAC9C,0CAA0C;AAC1C,oCAAoC;AACpC,0CAA0C;AAC1C,qCAA2C;AAC3C,wCAAwC;AACxC,4CAA4C;AAC5C,kDAAkD;AAElD;;;;;;;;;;GAUG;AACH,MAAa,aAAc,SAAQ,eAAM;IAChC,MAAM,KAAc,UAAU,KAAa,OAAO,SAAS,CAAC,CAAC,CAAC;IAC9D,MAAM,KAAK,cAAc,KAAa,OAAO,IAAI,CAAC,IAAI,CAAC,2BAAc,CAAC,eAAe,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,aAAa,CAAC,UAAU,eAAe,CAAC,CAAC,CAAC,CAAC;IAEhK,gBAAgB;IACT,MAAM,CAAC,cAAc;QAC1B,IAAI,IAAI,KAAK,gBAAO,CAAC,mBAAmB,CAAC,IAAI,CAAC,UAAU,CAAC;YACvD,OAAO;QAET,gBAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC1C,gBAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAE7B,sHAAsH;QACtH;YACE,UAAU;YACV,SAAS;YACT,QAAQ;YACR,WAAW;YACX,OAAO;YACP,OAAO;YACP,UAAU;YACV,WAAW;YACX,iBAAiB;YACjB,eAAe;SAChB,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,6BAAa,CAAC,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IACpE,CAAC;CACF;AA1BD,sCA0BC","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 Schema\r\n */\r\n\r\nimport * as path from \"path\";\r\nimport * as categoryMod from \"./Category\";\r\nimport { ClassRegistry } from \"./ClassRegistry\";\r\nimport * as elementMod from \"./Element\";\r\nimport * as aspectMod from \"./ElementAspect\";\r\nimport * as externalSourceMod from \"./ExternalSource\";\r\nimport { KnownLocations } from \"./IModelHost\";\r\nimport * as materialMod from \"./Material\";\r\nimport * as modelMod from \"./Model\";\r\nimport * as linkMod from \"./Relationship\";\r\nimport { Schema, Schemas } from \"./Schema\";\r\nimport * as textureMod from \"./Texture\";\r\nimport * as viewMod from \"./ViewDefinition\";\r\nimport * as displayStyleMod from \"./DisplayStyle\";\r\n\r\n/**\r\n * The [BisCore]($docs/bis/intro/schemas-domains.md) schema is the lowest level Schema in an iModel.\r\n *\r\n * It is automatically registered when [[IModelHost.startup]] is called.\r\n *\r\n * ** Example:**\r\n * ``` ts\r\n * [[include:BisCore.registerSchemaAndGetClass]]\r\n * ```\r\n * @public\r\n */\r\nexport class BisCoreSchema extends Schema {\r\n  public static override get schemaName(): string { return \"BisCore\"; }\r\n  public static get schemaFilePath(): string { return path.join(KnownLocations.nativeAssetsDir, \"ECSchemas\", \"Dgn\", `${BisCoreSchema.schemaName}.ecschema.xml`); }\r\n\r\n  /** @internal */\r\n  public static registerSchema() {\r\n    if (this === Schemas.getRegisteredSchema(this.schemaName))\r\n      return;\r\n\r\n    Schemas.unregisterSchema(this.schemaName);\r\n    Schemas.registerSchema(this);\r\n\r\n    // this list should include all backend .ts files with implementations of Entity-based classes. Order does not matter.\r\n    [\r\n      elementMod,\r\n      aspectMod,\r\n      modelMod,\r\n      categoryMod,\r\n      viewMod,\r\n      linkMod,\r\n      textureMod,\r\n      materialMod,\r\n      externalSourceMod,\r\n      displayStyleMod,\r\n    ].forEach((module) => ClassRegistry.registerModule(module, this));\r\n  }\r\n}\r\n"]}

package/lib/cjs/BriefcaseManager.d.ts

@@ -0,0 +1,167 @@
+/** @packageDocumentation
+ * @module iModels
+ */
+import { AccessToken, BeDuration, GuidString } from "@itwin/core-bentley";
+import { BriefcaseId, BriefcaseProps, ChangesetIndex, LocalBriefcaseProps, LocalDirName, LocalFileName, RequestNewBriefcaseProps, RpcActivity } from "@itwin/core-common";
+import { AcquireNewBriefcaseIdArg } from "./BackendHubAccess";
+import { ProgressFunction } from "./CheckpointManager";
+import { BriefcaseDb, IModelDb, TokenArg } from "./IModelDb";
+/** The argument for [[BriefcaseManager.downloadBriefcase]]
+ * @public
+*/
+export interface RequestNewBriefcaseArg extends TokenArg, RequestNewBriefcaseProps {
+    /** If present, a function called periodically during the download to indicate progress.
+     * @note return non-zero from this function to abort the download.
+     */
+    onProgress?: ProgressFunction;
+}
+/**
+ * Parameters for pushing changesets to iModelHub
+ * @public
+ */
+export interface PushChangesArgs extends TokenArg {
+    /** A description of the changes. This is visible on the iModel's timeline. */
+    description: string;
+    /** if present, the locks are retained after the operation. Otherwise, *all* locks are released after the changeset is successfully pushed. */
+    retainLocks?: true;
+    /** number of times to retry pull/merge if other users are pushing at the same time. Default is 5 */
+    mergeRetryCount?: number;
+    /** delay to wait between pull/merge retry attempts. Default is 3 seconds */
+    mergeRetryDelay?: BeDuration;
+    /** the number of time to attempt to retry to push the changeset upon failure. Default is 3 */
+    pushRetryCount?: number;
+    /** The delay to wait between retry attempts on failed pushes. Default is 3 seconds. */
+    pushRetryDelay?: BeDuration;
+}
+/**
+ * Specifies a specific index for pulling changes.
+ * @public
+ */
+export interface ToChangesetArgs extends TokenArg {
+    /** The last ChangesetIndex to pull. If not present, pull *all* newer changesets. */
+    toIndex?: ChangesetIndex;
+}
+/** Arguments for [[BriefcaseManager.pullAndApplyChangesets]]
+ * @public
+ */
+export declare type PullChangesArgs = ToChangesetArgs;
+/** Manages downloading Briefcases and downloading and uploading changesets.
+ * @public
+ */
+export declare class BriefcaseManager {
+    /** Get the local path of the folder storing files that are associated with an imodel */
+    static getIModelPath(iModelId: GuidString): LocalDirName;
+    /** @internal */
+    static getChangeSetsPath(iModelId: GuidString): LocalDirName;
+    /** @internal */
+    static getChangeCachePathName(iModelId: GuidString): LocalFileName;
+    /** @internal */
+    static getChangedElementsPathName(iModelId: GuidString): LocalFileName;
+    private static _briefcaseSubDir;
+    /** @internal */
+    static getBriefcaseBasePath(iModelId: GuidString): LocalDirName;
+    /** Get the name of the local file that holds, or will hold, a local briefcase in the briefcase cache.
+     * @note The briefcase cache is a local directory established in the call to [[BriefcaseManager.initialize]].
+     * @param briefcase the iModelId and BriefcaseId for the filename
+     * @see getIModelPath
+     */
+    static getFileName(briefcase: BriefcaseProps): LocalFileName;
+    private static setupCacheDir;
+    private static _initialized?;
+    /** Initialize BriefcaseManager
+     * @param cacheRootDir The root directory for storing a cache of downloaded briefcase files on the local computer.
+     * Briefcases are stored relative to this path in sub-folders organized by IModelId.
+     * @note It is perfectly valid for applications to store briefcases in locations they manage, outside of `cacheRootDir`.
+     */
+    static initialize(cacheRootDir: LocalDirName): void;
+    private static finalize;
+    /** Get a list of the local briefcase held in the briefcase cache, optionally for a single iModelId
+     * @param iModelId if present, only briefcases for this iModelId are returned, otherwise all briefcases for all
+     * iModels in the briefcase cache are returned.
+     * @note usually there should only be one briefcase per iModel.
+     */
+    static getCachedBriefcases(iModelId?: GuidString): LocalBriefcaseProps[];
+    private static _cacheDir;
+    /** Get the root directory for the briefcase cache */
+    static get cacheDir(): LocalDirName;
+    /** Determine whether the supplied briefcaseId is in the range of assigned BriefcaseIds issued by iModelHub
+     * @note this does check whether the id was actually acquired by the caller.
+     */
+    static isValidBriefcaseId(id: BriefcaseId): boolean;
+    /** Acquire a new briefcaseId from iModelHub for the supplied iModelId
+     * @note usually there should only be one briefcase per iModel per user. If a single user acquires more than one briefcaseId,
+     * it's a good idea to supply different aliases for each of them.
+     */
+    static acquireNewBriefcaseId(arg: AcquireNewBriefcaseIdArg): Promise<BriefcaseId>;
+    /** Download a new briefcase from iModelHub for the supplied iModelId.
+     *
+     * The process of downloading a briefcase file involves first obtaining a valid BriefcaseId from IModelHub. For each IModel, IModelHub maintains
+     * a list of BriefcaseIds assigned to users, to ensure that no two users have the same BriefcaseId. Typically a given user will have only
+     * one briefcase on their machine for a given iModelId. Rarely, it may be necessary to use more than one briefcase to make isolated independent sets of changes,
+     * but that is exceedingly complicated and rare. If no BriefcaseId is supplied, a new one is acquired from iModelHub.
+     *
+     * Then, a Checkpoint file (as of a ChangeSetId, typically "Latest") is downloaded from IModelHub. After the download completes,
+     * the briefcaseId in the local file is changed to acquired briefcaseId, changing the checkpoint file into a briefcase file.
+     *
+     * Each of these steps requires a valid `AuthorizedClientRequestContext` to provide the user's credentials for the requests.
+     *
+     * @param request The properties that specify the briefcase file to be downloaded.
+     * @returns The properties of the local briefcase in a Promise that is resolved after the briefcase is fully downloaded and the briefcase file is ready for use via [BriefcaseDb.open]($backend).
+     * @note The location of the local file to hold the briefcase is arbitrary and may be any valid *local* path on your machine. If you don't supply
+     * a filename, the local briefcase cache is used by creating a file with the briefcaseId as its name in the `briefcases` folder below the folder named
+     * for the IModelId.
+     * @note *It is invalid to edit briefcases on a shared network drive* and that is a sure way to corrupt your briefcase (see https://www.sqlite.org/howtocorrupt.html)
+     * @note The special briefcaseId [[BriefcaseIdValue.Unassigned]] (0) can be used for a local briefcase that can accept changesets but may not be generate changesets.
+     * @see CheckpointManager.downloadCheckpoint
+     */
+    static downloadBriefcase(arg: RequestNewBriefcaseArg): Promise<LocalBriefcaseProps>;
+    /** Deletes change sets of an iModel from local disk
+     * @internal
+     */
+    static deleteChangeSetsFromLocalDisk(iModelId: string): void;
+    /** Releases a briefcaseId from iModelHub. After this call it is illegal to generate changesets for the released briefcaseId.
+     * @note generally, this method should not be called directly. Instead use [[deleteBriefcaseFiles]].
+     * @see deleteBriefcaseFiles
+     */
+    static releaseBriefcase(accessToken: AccessToken, briefcase: BriefcaseProps): Promise<void>;
+    /**
+     * Delete and clean up a briefcase and all of its associated files. First, this method opens the supplied filename to determine its briefcaseId.
+     * Then, if a requestContext is supplied, it releases a BriefcaseId from iModelHub. Finally it deletes the local briefcase file and
+     * associated files (that is, all files in the same directory that start with the briefcase name).
+     * @param filePath the full file name of the Briefcase to delete
+     * @param accessToken for releasing the briefcaseId
+     */
+    static deleteBriefcaseFiles(filePath: LocalFileName, accessToken?: AccessToken): Promise<void>;
+    /** Deletes a file
+     *  - Does not throw any error, but logs it instead
+     *  - Returns true if the delete was successful
+     */
+    private static deleteFile;
+    /** Deletes a folder, checking if it's empty
+     *  - Does not throw any error, but logs it instead
+     *  - Returns true if the delete was successful
+     */
+    private static deleteFolderIfEmpty;
+    /** Deletes the contents of a folder, but not the folder itself
+     *  - Does not throw any errors, but logs them.
+     *  - returns true if the delete was successful.
+     */
+    private static deleteFolderContents;
+    /** Deletes a folder and all it's contents.
+     *  - Does not throw any errors, but logs them.
+     *  - returns true if the delete was successful.
+     */
+    private static deleteFolderAndContents;
+    private static applySingleChangeset;
+    /** @internal */
+    static pullAndApplyChangesets(db: IModelDb, arg: ToChangesetArgs): Promise<void>;
+    /** create a changeset from the current changes, and push it to iModelHub */
+    private static pushChanges;
+    /** Pull/merge (if necessary), then push all local changes as a changeset. Called by [[BriefcaseDb.pushChanges]]
+     * @internal
+     */
+    static pullMergePush(db: BriefcaseDb, arg: PushChangesArgs): Promise<void>;
+    /** @internal */
+    static logUsage(imodel: IModelDb, activity?: RpcActivity): void;
+}
+//# sourceMappingURL=BriefcaseManager.d.ts.map

package/lib/cjs/BriefcaseManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BriefcaseManager.d.ts","sourceRoot":"","sources":["../../src/BriefcaseManager.ts"],"names":[],"mappings":"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"}

package/lib/cjs/BriefcaseManager.js

@@ -0,0 +1,406 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module iModels
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BriefcaseManager = void 0;
+// cspell:ignore cset csets ecchanges
+const path = require("path");
+const core_bentley_1 = require("@itwin/core-bentley");
+const core_common_1 = require("@itwin/core-common");
+const telemetry_client_1 = require("@bentley/telemetry-client");
+const BackendLoggerCategory_1 = require("./BackendLoggerCategory");
+const CheckpointManager_1 = require("./CheckpointManager");
+const IModelDb_1 = require("./IModelDb");
+const IModelHost_1 = require("./IModelHost");
+const IModelJsFs_1 = require("./IModelJsFs");
+const loggerCategory = BackendLoggerCategory_1.BackendLoggerCategory.IModelDb;
+/** Manages downloading Briefcases and downloading and uploading changesets.
+ * @public
+ */
+class BriefcaseManager {
+    /** Get the local path of the folder storing files that are associated with an imodel */
+    static getIModelPath(iModelId) { return path.join(this._cacheDir, iModelId); }
+    /** @internal */
+    static getChangeSetsPath(iModelId) { return path.join(this.getIModelPath(iModelId), "changesets"); }
+    /** @internal */
+    static getChangeCachePathName(iModelId) { return path.join(this.getIModelPath(iModelId), iModelId.concat(".bim.ecchanges")); }
+    /** @internal */
+    static getChangedElementsPathName(iModelId) { return path.join(this.getIModelPath(iModelId), iModelId.concat(".bim.elems")); }
+    /** @internal */
+    static getBriefcaseBasePath(iModelId) {
+        return path.join(this.getIModelPath(iModelId), this._briefcaseSubDir);
+    }
+    /** Get the name of the local file that holds, or will hold, a local briefcase in the briefcase cache.
+     * @note The briefcase cache is a local directory established in the call to [[BriefcaseManager.initialize]].
+     * @param briefcase the iModelId and BriefcaseId for the filename
+     * @see getIModelPath
+     */
+    static getFileName(briefcase) {
+        return path.join(this.getBriefcaseBasePath(briefcase.iModelId), `${briefcase.briefcaseId}.bim`);
+    }
+    static setupCacheDir(cacheRootDir) {
+        this._cacheDir = cacheRootDir;
+        IModelJsFs_1.IModelJsFs.recursiveMkDirSync(this._cacheDir);
+    }
+    /** Initialize BriefcaseManager
+     * @param cacheRootDir The root directory for storing a cache of downloaded briefcase files on the local computer.
+     * Briefcases are stored relative to this path in sub-folders organized by IModelId.
+     * @note It is perfectly valid for applications to store briefcases in locations they manage, outside of `cacheRootDir`.
+     */
+    static initialize(cacheRootDir) {
+        if (this._initialized)
+            return;
+        this.setupCacheDir(cacheRootDir);
+        IModelHost_1.IModelHost.onBeforeShutdown.addOnce(this.finalize, this);
+        this._initialized = true;
+    }
+    static finalize() {
+        this._initialized = false;
+    }
+    /** Get a list of the local briefcase held in the briefcase cache, optionally for a single iModelId
+     * @param iModelId if present, only briefcases for this iModelId are returned, otherwise all briefcases for all
+     * iModels in the briefcase cache are returned.
+     * @note usually there should only be one briefcase per iModel.
+     */
+    static getCachedBriefcases(iModelId) {
+        var _a, _b, _c;
+        const briefcaseList = [];
+        const iModelDirs = IModelJsFs_1.IModelJsFs.readdirSync(this._cacheDir);
+        for (const iModelDir of iModelDirs) {
+            if (iModelId && iModelId !== iModelDir)
+                continue;
+            const bcPath = path.join(this._cacheDir, iModelDir, this._briefcaseSubDir);
+            try {
+                if (!((_a = IModelJsFs_1.IModelJsFs.lstatSync(bcPath)) === null || _a === void 0 ? void 0 : _a.isDirectory))
+                    continue;
+            }
+            catch (err) {
+                continue;
+            }
+            const briefcases = IModelJsFs_1.IModelJsFs.readdirSync(bcPath);
+            for (const briefcaseName of briefcases) {
+                if (briefcaseName.endsWith(".bim")) {
+                    try {
+                        const fileName = path.join(bcPath, briefcaseName);
+                        const fileSize = (_c = (_b = IModelJsFs_1.IModelJsFs.lstatSync(fileName)) === null || _b === void 0 ? void 0 : _b.size) !== null && _c !== void 0 ? _c : 0;
+                        const db = IModelDb_1.IModelDb.openDgnDb({ path: fileName }, core_bentley_1.OpenMode.Readonly);
+                        briefcaseList.push({ fileName, iTwinId: db.getITwinId(), iModelId: db.getIModelId(), briefcaseId: db.getBriefcaseId(), changeset: db.getCurrentChangeset(), fileSize });
+                        db.closeIModel();
+                    }
+                    catch (_err) {
+                    }
+                }
+            }
+        }
+        return briefcaseList;
+    }
+    /** Get the root directory for the briefcase cache */
+    static get cacheDir() { return this._cacheDir; }
+    /** Determine whether the supplied briefcaseId is in the range of assigned BriefcaseIds issued by iModelHub
+     * @note this does check whether the id was actually acquired by the caller.
+     */
+    static isValidBriefcaseId(id) {
+        return id >= core_common_1.BriefcaseIdValue.FirstValid && id <= core_common_1.BriefcaseIdValue.LastValid;
+    }
+    /** Acquire a new briefcaseId from iModelHub for the supplied iModelId
+     * @note usually there should only be one briefcase per iModel per user. If a single user acquires more than one briefcaseId,
+     * it's a good idea to supply different aliases for each of them.
+     */
+    static async acquireNewBriefcaseId(arg) {
+        return IModelHost_1.IModelHost.hubAccess.acquireNewBriefcaseId(arg);
+    }
+    /** Download a new briefcase from iModelHub for the supplied iModelId.
+     *
+     * The process of downloading a briefcase file involves first obtaining a valid BriefcaseId from IModelHub. For each IModel, IModelHub maintains
+     * a list of BriefcaseIds assigned to users, to ensure that no two users have the same BriefcaseId. Typically a given user will have only
+     * one briefcase on their machine for a given iModelId. Rarely, it may be necessary to use more than one briefcase to make isolated independent sets of changes,
+     * but that is exceedingly complicated and rare. If no BriefcaseId is supplied, a new one is acquired from iModelHub.
+     *
+     * Then, a Checkpoint file (as of a ChangeSetId, typically "Latest") is downloaded from IModelHub. After the download completes,
+     * the briefcaseId in the local file is changed to acquired briefcaseId, changing the checkpoint file into a briefcase file.
+     *
+     * Each of these steps requires a valid `AuthorizedClientRequestContext` to provide the user's credentials for the requests.
+     *
+     * @param request The properties that specify the briefcase file to be downloaded.
+     * @returns The properties of the local briefcase in a Promise that is resolved after the briefcase is fully downloaded and the briefcase file is ready for use via [BriefcaseDb.open]($backend).
+     * @note The location of the local file to hold the briefcase is arbitrary and may be any valid *local* path on your machine. If you don't supply
+     * a filename, the local briefcase cache is used by creating a file with the briefcaseId as its name in the `briefcases` folder below the folder named
+     * for the IModelId.
+     * @note *It is invalid to edit briefcases on a shared network drive* and that is a sure way to corrupt your briefcase (see https://www.sqlite.org/howtocorrupt.html)
+     * @note The special briefcaseId [[BriefcaseIdValue.Unassigned]] (0) can be used for a local briefcase that can accept changesets but may not be generate changesets.
+     * @see CheckpointManager.downloadCheckpoint
+     */
+    static async downloadBriefcase(arg) {
+        var _a, _b, _c, _d, _e;
+        const briefcaseId = arg.briefcaseId = (_a = arg.briefcaseId) !== null && _a !== void 0 ? _a : await this.acquireNewBriefcaseId(arg);
+        const fileName = (_b = arg.fileName) !== null && _b !== void 0 ? _b : this.getFileName(arg);
+        if (IModelJsFs_1.IModelJsFs.existsSync(fileName))
+            throw new core_common_1.IModelError(core_bentley_1.IModelStatus.FileAlreadyExists, `Briefcase "${fileName}" already exists`);
+        const asOf = (_c = arg.asOf) !== null && _c !== void 0 ? _c : core_common_1.IModelVersion.latest().toJSON();
+        const changeset = await IModelHost_1.IModelHost.hubAccess.getChangesetFromVersion({ ...arg, version: core_common_1.IModelVersion.fromJSON(asOf) });
+        const checkpoint = { ...arg, changeset };
+        await CheckpointManager_1.CheckpointManager.downloadCheckpoint({ localFile: fileName, checkpoint, onProgress: arg.onProgress });
+        const fileSize = (_e = (_d = IModelJsFs_1.IModelJsFs.lstatSync(fileName)) === null || _d === void 0 ? void 0 : _d.size) !== null && _e !== void 0 ? _e : 0;
+        const response = {
+            fileName,
+            briefcaseId,
+            iModelId: arg.iModelId,
+            iTwinId: arg.iTwinId,
+            changeset: checkpoint.changeset,
+            fileSize,
+        };
+        // now open the downloaded checkpoint and reset its BriefcaseId
+        const nativeDb = new IModelHost_1.IModelHost.platform.DgnDb();
+        try {
+            nativeDb.openIModel(fileName, core_bentley_1.OpenMode.ReadWrite);
+        }
+        catch (err) {
+            throw new core_common_1.IModelError(err.errorNumber, `Could not open downloaded briefcase for write access: ${fileName}, err=${err.message}`);
+        }
+        try {
+            nativeDb.resetBriefcaseId(briefcaseId);
+            if (nativeDb.getCurrentChangeset().id !== checkpoint.changeset.id)
+                throw new core_common_1.IModelError(core_bentley_1.IModelStatus.InvalidId, `Downloaded briefcase has wrong changesetId: ${fileName}`);
+        }
+        finally {
+            nativeDb.saveChanges();
+            nativeDb.closeIModel();
+        }
+        return response;
+    }
+    /** Deletes change sets of an iModel from local disk
+     * @internal
+     */
+    static deleteChangeSetsFromLocalDisk(iModelId) {
+        const changesetsPath = BriefcaseManager.getChangeSetsPath(iModelId);
+        BriefcaseManager.deleteFolderAndContents(changesetsPath);
+    }
+    /** Releases a briefcaseId from iModelHub. After this call it is illegal to generate changesets for the released briefcaseId.
+     * @note generally, this method should not be called directly. Instead use [[deleteBriefcaseFiles]].
+     * @see deleteBriefcaseFiles
+     */
+    static async releaseBriefcase(accessToken, briefcase) {
+        if (this.isValidBriefcaseId(briefcase.briefcaseId))
+            return IModelHost_1.IModelHost.hubAccess.releaseBriefcase({ accessToken, iModelId: briefcase.iModelId, briefcaseId: briefcase.briefcaseId });
+    }
+    /**
+     * Delete and clean up a briefcase and all of its associated files. First, this method opens the supplied filename to determine its briefcaseId.
+     * Then, if a requestContext is supplied, it releases a BriefcaseId from iModelHub. Finally it deletes the local briefcase file and
+     * associated files (that is, all files in the same directory that start with the briefcase name).
+     * @param filePath the full file name of the Briefcase to delete
+     * @param accessToken for releasing the briefcaseId
+     */
+    static async deleteBriefcaseFiles(filePath, accessToken) {
+        try {
+            const db = IModelDb_1.IModelDb.openDgnDb({ path: filePath }, core_bentley_1.OpenMode.Readonly);
+            const briefcase = {
+                iModelId: db.getIModelId(),
+                briefcaseId: db.getBriefcaseId(),
+            };
+            db.closeIModel();
+            if (accessToken) {
+                if (this.isValidBriefcaseId(briefcase.briefcaseId)) {
+                    await BriefcaseManager.releaseBriefcase(accessToken, briefcase);
+                }
+            }
+        }
+        catch (error) {
+        }
+        // first try to delete the briefcase file
+        try {
+            if (IModelJsFs_1.IModelJsFs.existsSync(filePath))
+                IModelJsFs_1.IModelJsFs.unlinkSync(filePath);
+        }
+        catch (err) {
+            throw new core_common_1.IModelError(core_bentley_1.IModelStatus.BadRequest, `cannot delete briefcase file ${err}`);
+        }
+        // next, delete all files that start with the briefcase's filePath (e.g. "a.bim-locks", "a.bim-journal", etc.)
+        try {
+            const dirName = path.dirname(filePath);
+            const fileName = path.basename(filePath);
+            const files = IModelJsFs_1.IModelJsFs.readdirSync(dirName);
+            for (const file of files) {
+                if (file.startsWith(fileName))
+                    this.deleteFile(path.join(dirName, file)); // don't throw on error
+            }
+        }
+        catch (err) {
+        }
+    }
+    /** Deletes a file
+     *  - Does not throw any error, but logs it instead
+     *  - Returns true if the delete was successful
+     */
+    static deleteFile(pathname) {
+        try {
+            IModelJsFs_1.IModelJsFs.unlinkSync(pathname);
+        }
+        catch (error) {
+            core_bentley_1.Logger.logError(loggerCategory, `Cannot delete file ${pathname}, ${error}`);
+            return false;
+        }
+        return true;
+    }
+    /** Deletes a folder, checking if it's empty
+     *  - Does not throw any error, but logs it instead
+     *  - Returns true if the delete was successful
+     */
+    static deleteFolderIfEmpty(folderPathname) {
+        try {
+            const files = IModelJsFs_1.IModelJsFs.readdirSync(folderPathname);
+            if (files.length > 0)
+                return false;
+            IModelJsFs_1.IModelJsFs.rmdirSync(folderPathname);
+        }
+        catch (error) {
+            core_bentley_1.Logger.logError(loggerCategory, `Cannot delete folder: ${folderPathname}`);
+            return false;
+        }
+        return true;
+    }
+    /** Deletes the contents of a folder, but not the folder itself
+     *  - Does not throw any errors, but logs them.
+     *  - returns true if the delete was successful.
+     */
+    static deleteFolderContents(folderPathname) {
+        if (!IModelJsFs_1.IModelJsFs.existsSync(folderPathname))
+            return false;
+        let status = true;
+        const files = IModelJsFs_1.IModelJsFs.readdirSync(folderPathname);
+        for (const file of files) {
+            const curPath = path.join(folderPathname, file);
+            const locStatus = (IModelJsFs_1.IModelJsFs.lstatSync(curPath).isDirectory) ? BriefcaseManager.deleteFolderAndContents(curPath) : BriefcaseManager.deleteFile(curPath);
+            if (!locStatus)
+                status = false;
+        }
+        return status;
+    }
+    /** Deletes a folder and all it's contents.
+     *  - Does not throw any errors, but logs them.
+     *  - returns true if the delete was successful.
+     */
+    static deleteFolderAndContents(folderPathname) {
+        if (!IModelJsFs_1.IModelJsFs.existsSync(folderPathname))
+            return true;
+        let status = false;
+        status = BriefcaseManager.deleteFolderContents(folderPathname);
+        if (!status)
+            return false;
+        status = BriefcaseManager.deleteFolderIfEmpty(folderPathname);
+        return status;
+    }
+    static async applySingleChangeset(db, changesetFile) {
+        if (changesetFile.changesType === core_common_1.ChangesetType.Schema)
+            db.clearCaches(); // for schema changesets, statement caches may become invalid. Do this *before* applying, in case db needs to be closed (open statements hold db open.)
+        db.nativeDb.applyChangeset(changesetFile);
+        db.changeset = db.nativeDb.getCurrentChangeset();
+        // we're done with this changeset, delete it
+        IModelJsFs_1.IModelJsFs.removeSync(changesetFile.pathname);
+    }
+    /** @internal */
+    static async pullAndApplyChangesets(db, arg) {
+        if (!db.isOpen || db.nativeDb.isReadonly()) // don't use db.isReadonly - we reopen the file writable just for this operation but db.isReadonly is still true
+            throw new core_common_1.IModelError(core_bentley_1.ChangeSetStatus.ApplyError, "Briefcase must be open ReadWrite to process change sets");
+        let currentIndex = db.changeset.index;
+        if (currentIndex === undefined)
+            currentIndex = (await IModelHost_1.IModelHost.hubAccess.queryChangeset({ accessToken: arg.accessToken, iModelId: db.iModelId, changeset: { id: db.changeset.id } })).index;
+        const reverse = (arg.toIndex && arg.toIndex < currentIndex) ? true : false;
+        // Download change sets
+        const changesets = await IModelHost_1.IModelHost.hubAccess.downloadChangesets({
+            accessToken: arg.accessToken,
+            iModelId: db.iModelId,
+            range: { first: reverse ? arg.toIndex + 1 : currentIndex + 1, end: reverse ? currentIndex : arg.toIndex },
+            targetDir: BriefcaseManager.getChangeSetsPath(db.iModelId),
+        });
+        if (changesets.length === 0)
+            return; // nothing to apply
+        if (reverse)
+            changesets.reverse();
+        for (const changeset of changesets)
+            await this.applySingleChangeset(db, changeset);
+        // notify listeners
+        db.notifyChangesetApplied();
+    }
+    /** create a changeset from the current changes, and push it to iModelHub */
+    static async pushChanges(db, arg) {
+        var _a, _b;
+        const changesetProps = db.nativeDb.startCreateChangeset();
+        changesetProps.briefcaseId = db.briefcaseId;
+        changesetProps.description = arg.description;
+        changesetProps.size = (_a = IModelJsFs_1.IModelJsFs.lstatSync(changesetProps.pathname)) === null || _a === void 0 ? void 0 : _a.size;
+        if (!changesetProps.size) // either undefined or 0 means error
+            throw new core_common_1.IModelError(core_bentley_1.IModelStatus.NoContent, "error creating changeset");
+        let retryCount = (_b = arg.pushRetryCount) !== null && _b !== void 0 ? _b : 3;
+        while (true) {
+            try {
+                const accessToken = await IModelHost_1.IModelHost.getAccessToken();
+                const index = await IModelHost_1.IModelHost.hubAccess.pushChangeset({ accessToken, iModelId: db.iModelId, changesetProps });
+                db.nativeDb.completeCreateChangeset({ index });
+                db.changeset = db.nativeDb.getCurrentChangeset();
+                if (!arg.retainLocks)
+                    await db.locks.releaseAllLocks();
+                return;
+            }
+            catch (err) {
+                const shouldRetry = () => {
+                    if (retryCount-- <= 0)
+                        return false;
+                    switch (err.errorNumber) {
+                        case core_bentley_1.IModelHubStatus.AnotherUserPushing:
+                        case core_bentley_1.IModelHubStatus.DatabaseTemporarilyLocked:
+                        case core_bentley_1.IModelHubStatus.OperationFailed:
+                            return true;
+                    }
+                    return false;
+                };
+                if (!shouldRetry()) {
+                    db.nativeDb.abandonCreateChangeset();
+                    throw err;
+                }
+            }
+            finally {
+                IModelJsFs_1.IModelJsFs.removeSync(changesetProps.pathname);
+            }
+        }
+    }
+    /** Pull/merge (if necessary), then push all local changes as a changeset. Called by [[BriefcaseDb.pushChanges]]
+     * @internal
+     */
+    static async pullMergePush(db, arg) {
+        var _a, _b;
+        let retryCount = (_a = arg.mergeRetryCount) !== null && _a !== void 0 ? _a : 5;
+        while (true) {
+            try {
+                await BriefcaseManager.pullAndApplyChangesets(db, arg);
+                return await BriefcaseManager.pushChanges(db, arg);
+            }
+            catch (err) {
+                if (retryCount-- <= 0 || err.errorNumber !== core_bentley_1.IModelHubStatus.PullIsRequired)
+                    throw (err);
+                await ((_b = arg.mergeRetryDelay) !== null && _b !== void 0 ? _b : core_bentley_1.BeDuration.fromSeconds(3)).wait();
+            }
+        }
+    }
+    /** @internal */
+    static logUsage(imodel, activity) {
+        var _a;
+        const telemetryEvent = new telemetry_client_1.TelemetryEvent("core-backend - Open iModel", "7a6424d1-2114-4e89-b13b-43670a38ccd4", // Feature: "iModel Use"
+        imodel.iTwinId, imodel.iModelId, (_a = imodel.changeset) === null || _a === void 0 ? void 0 : _a.id);
+        activity = activity !== null && activity !== void 0 ? activity : {
+            activityId: "",
+            applicationId: IModelHost_1.IModelHost.applicationId,
+            applicationVersion: IModelHost_1.IModelHost.applicationVersion,
+            sessionId: IModelHost_1.IModelHost.sessionId,
+            accessToken: "", // IModelHost.getAccessToken(); ACCESS_TOKEN_NEEDS_WORK
+        };
+        IModelHost_1.IModelHost.telemetry.postTelemetry(activity, telemetryEvent); // eslint-disable-line @typescript-eslint/no-floating-promises
+    }
+}
+exports.BriefcaseManager = BriefcaseManager;
+BriefcaseManager._briefcaseSubDir = "briefcases";
+//# sourceMappingURL=BriefcaseManager.js.map