@itwin/core-backend 4.0.0-dev.10 → 4.0.0-dev.101

package/lib/cjs/ChangedElementsManager.js

@@ -1,89 +1,89 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ChangedElementsManager = void 0;
-const BriefcaseManager_1 = require("./BriefcaseManager");
-const ChangedElementsDb_1 = require("./ChangedElementsDb");
-const IModelJsFs_1 = require("./IModelJsFs");
-/** Utilities for querying changed elements caches */
-/** @internal */
-class ChangedElementsManager {
-    static getChangedElementsPathName(iModelId) { return BriefcaseManager_1.BriefcaseManager.getChangedElementsPathName(iModelId); }
-    /** Get changed elements Db */
-    static getChangedElementsDb(iModelId) {
-        if (this._entry && this._entry.iModelId === iModelId)
-            return this._entry.db;
-        if (this._entry && this._entry.iModelId !== iModelId) {
-            this._entry.db.closeDb();
-            this._entry.db.cleanCaches();
-            this._entry = undefined;
-        }
-        if (!this._entry) {
-            const path = ChangedElementsManager.getChangedElementsPathName(iModelId);
-            if (!IModelJsFs_1.IModelJsFs.existsSync(path))
-                return undefined;
-            const db = ChangedElementsDb_1.ChangedElementsDb.openDb(path);
-            this._entry = {
-                iModelId,
-                db,
-            };
-            return db;
-        }
-        return undefined;
-    }
-    static cleanUp() {
-        if (this._entry) {
-            this._entry.db.closeDb();
-            this._entry.db.cleanCaches();
-            this._entry = undefined;
-        }
-    }
-    /** Gets the changed elements from the cache if found
-     * @param iModelId Id of the iModel
-     * @param startChangesetId Start changeset Id
-     * @param endChangesetId End changeset Id
-     * @returns Changed elements if found
-     */
-    static getChangedElements(iModelId, startChangesetId, endChangesetId) {
-        const db = ChangedElementsManager.getChangedElementsDb(iModelId);
-        if (!db)
-            return undefined;
-        return db.getChangedElements(startChangesetId, endChangesetId);
-    }
-    /** Gets the changed models from the cache if found
-     * @param iModelId Id of the iModel
-     * @param startChangesetId Start changeset Id
-     * @param endChangesetId End changeset Id
-     * @returns Changed models if found
-     */
-    static getChangedModels(iModelId, startChangesetId, endChangesetId) {
-        const db = ChangedElementsManager.getChangedElementsDb(iModelId);
-        if (!db)
-            return undefined;
-        return db.getChangedModels(startChangesetId, endChangesetId);
-    }
-    /** Gets the change data (models and elements) from the cache if found
-     * @param iModelId Id of the iModel
-     * @param startChangesetId Start changeset Id
-     * @param endChangesetId End changeset Id
-     * @returns Changed models if found
-     */
-    static getChangeData(iModelId, startChangesetId, endChangesetId) {
-        const db = ChangedElementsManager.getChangedElementsDb(iModelId);
-        if (!db)
-            return undefined;
-        return db.getChangeData(startChangesetId, endChangesetId);
-    }
-    /** Checks if the cache contains information about the changeset
-     * @param iModelId Id of the iModel
-     * @param changesetId Changeset to check for
-     * @returns true if the changeset has been processed and exists in the cache
-     */
-    static isProcessed(iModelId, changesetId) {
-        const db = ChangedElementsManager.getChangedElementsDb(iModelId);
-        if (!db)
-            return false;
-        return db.isProcessed(changesetId);
-    }
-}
-exports.ChangedElementsManager = ChangedElementsManager;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChangedElementsManager = void 0;
+const BriefcaseManager_1 = require("./BriefcaseManager");
+const ChangedElementsDb_1 = require("./ChangedElementsDb");
+const IModelJsFs_1 = require("./IModelJsFs");
+/** Utilities for querying changed elements caches */
+/** @internal */
+class ChangedElementsManager {
+    static getChangedElementsPathName(iModelId) { return BriefcaseManager_1.BriefcaseManager.getChangedElementsPathName(iModelId); }
+    /** Get changed elements Db */
+    static getChangedElementsDb(iModelId) {
+        if (this._entry && this._entry.iModelId === iModelId)
+            return this._entry.db;
+        if (this._entry && this._entry.iModelId !== iModelId) {
+            this._entry.db.closeDb();
+            this._entry.db.cleanCaches();
+            this._entry = undefined;
+        }
+        if (!this._entry) {
+            const path = ChangedElementsManager.getChangedElementsPathName(iModelId);
+            if (!IModelJsFs_1.IModelJsFs.existsSync(path))
+                return undefined;
+            const db = ChangedElementsDb_1.ChangedElementsDb.openDb(path);
+            this._entry = {
+                iModelId,
+                db,
+            };
+            return db;
+        }
+        return undefined;
+    }
+    static cleanUp() {
+        if (this._entry) {
+            this._entry.db.closeDb();
+            this._entry.db.cleanCaches();
+            this._entry = undefined;
+        }
+    }
+    /** Gets the changed elements from the cache if found
+     * @param iModelId Id of the iModel
+     * @param startChangesetId Start changeset Id
+     * @param endChangesetId End changeset Id
+     * @returns Changed elements if found
+     */
+    static getChangedElements(iModelId, startChangesetId, endChangesetId) {
+        const db = ChangedElementsManager.getChangedElementsDb(iModelId);
+        if (!db)
+            return undefined;
+        return db.getChangedElements(startChangesetId, endChangesetId);
+    }
+    /** Gets the changed models from the cache if found
+     * @param iModelId Id of the iModel
+     * @param startChangesetId Start changeset Id
+     * @param endChangesetId End changeset Id
+     * @returns Changed models if found
+     */
+    static getChangedModels(iModelId, startChangesetId, endChangesetId) {
+        const db = ChangedElementsManager.getChangedElementsDb(iModelId);
+        if (!db)
+            return undefined;
+        return db.getChangedModels(startChangesetId, endChangesetId);
+    }
+    /** Gets the change data (models and elements) from the cache if found
+     * @param iModelId Id of the iModel
+     * @param startChangesetId Start changeset Id
+     * @param endChangesetId End changeset Id
+     * @returns Changed models if found
+     */
+    static getChangeData(iModelId, startChangesetId, endChangesetId) {
+        const db = ChangedElementsManager.getChangedElementsDb(iModelId);
+        if (!db)
+            return undefined;
+        return db.getChangeData(startChangesetId, endChangesetId);
+    }
+    /** Checks if the cache contains information about the changeset
+     * @param iModelId Id of the iModel
+     * @param changesetId Changeset to check for
+     * @returns true if the changeset has been processed and exists in the cache
+     */
+    static isProcessed(iModelId, changesetId) {
+        const db = ChangedElementsManager.getChangedElementsDb(iModelId);
+        if (!db)
+            return false;
+        return db.isProcessed(changesetId);
+    }
+}
+exports.ChangedElementsManager = ChangedElementsManager;
 //# sourceMappingURL=ChangedElementsManager.js.map

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.d.ts

@@ -0,0 +1,70 @@
+/** @packageDocumentation
+ * @module Elements
+ */
+import { Id64String } from "@itwin/core-bentley";
+import { IModelDb } from "./IModelDb";
+/** The key for a channel. Used for "allowed channels" in [[ChannelControl]]
+ * @beta
+ */
+export type ChannelKey = string;
+/**
+ * Controls which channels of an iModel are permitted for write operations. An implementation of this interface is
+ * available via [[IModelDb.channels]].
+ * @see [Working With Channels]($docs/learning/backend/Channel.md) for details
+ * @beta
+ */
+export interface ChannelControl {
+    /** Determine whether this [[IModelDb]] has any channels in it. */
+    get hasChannels(): boolean;
+    /** Add a new channel to the list of allowed channels of the [[IModelDb]] for this session.
+     * @param channelKey The key for the channel to become editable in this session.
+     */
+    addAllowedChannel(channelKey: ChannelKey): void;
+    /** Remove a channel from the list of allowed channels of the [[IModelDb]] for this session.
+     * @param channelKey The key of the channel that should no longer be editable in this session.
+     */
+    removeAllowedChannel(channelKey: ChannelKey): void;
+    /** Get the channelKey of the channel for an element by ElementId.
+     * @throws if the element does not exist
+     */
+    getChannelKey(elementId: Id64String): ChannelKey;
+    /** Insert a new Subject element that defines a new Channel in this iModel.
+     * @returns the ElementId of the new Subject element.
+     */
+    insertChannelSubject(args: {
+        /** The name of the new Subject element */
+        subjectName: string;
+        /** The channel key for the new [[Subject]]. This is the string to pass to [[addAllowedChannel]]*/
+        channelKey: ChannelKey;
+        /** the Id of the parent of the new Subject. Default is [[IModel.rootSubjectId]]. */
+        parentSubjectId?: Id64String;
+        /** Optional description for new Subject. */
+        description?: string;
+    }): Id64String;
+    /** @internal */
+    verifyChannel(modelId: Id64String): void;
+}
+/** @internal */
+export declare class ChannelAdmin implements ChannelControl {
+    private _iModel;
+    /** the name of the special "shared" channel holding information that is editable by any application. */
+    static readonly sharedChannel = "shared";
+    static readonly channelClassName = "bis:ChannelRootAspect";
+    private _allowedChannels;
+    private _allowedModels;
+    private _deniedModels;
+    private _hasChannels?;
+    constructor(_iModel: IModelDb);
+    addAllowedChannel(channelKey: ChannelKey): void;
+    removeAllowedChannel(channelKey: ChannelKey): void;
+    get hasChannels(): boolean;
+    getChannelKey(elementId: Id64String): ChannelKey;
+    verifyChannel(modelId: Id64String): void;
+    insertChannelSubject(args: {
+        subjectName: string;
+        channelKey: ChannelKey;
+        parentSubjectId?: Id64String;
+        description?: string;
+    }): Id64String;
+}
+//# sourceMappingURL=ChannelControl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChannelControl.d.ts","sourceRoot":"","sources":["../../src/ChannelControl.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAY,UAAU,EAAkC,MAAM,qBAAqB,CAAC;AAG3F,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAEhC;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,IAAI,WAAW,IAAI,OAAO,CAAC;IAC3B;;OAEG;IACH,iBAAiB,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAChD;;OAEG;IACH,oBAAoB,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IACnD;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,UAAU,GAAG,UAAU,CAAC;IACjD;;OAEG;IACH,oBAAoB,CAAC,IAAI,EAAE;QACzB,0CAA0C;QAC1C,WAAW,EAAE,MAAM,CAAC;QACpB,kGAAkG;QAClG,UAAU,EAAE,UAAU,CAAC;QACvB,oFAAoF;QACpF,eAAe,CAAC,EAAE,UAAU,CAAC;QAC7B,4CAA4C;QAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,UAAU,CAAC;IAEf,gBAAgB;IAChB,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;CAC1C;AAED,gBAAgB;AAChB,qBAAa,YAAa,YAAW,cAAc;IAS9B,OAAO,CAAC,OAAO;IARlC,wGAAwG;IACxG,gBAAuB,aAAa,YAAY;IAChD,gBAAuB,gBAAgB,2BAA2B;IAClE,OAAO,CAAC,gBAAgB,CAAyB;IACjD,OAAO,CAAC,cAAc,CAAyB;IAC/C,OAAO,CAAC,aAAa,CAAqC;IAC1D,OAAO,CAAC,YAAY,CAAC,CAAU;gBAEJ,OAAO,EAAE,QAAQ;IAGrC,iBAAiB,CAAC,UAAU,EAAE,UAAU;IAIxC,oBAAoB,CAAC,UAAU,EAAE,UAAU;IAIlD,IAAW,WAAW,IAAI,OAAO,CAUhC;IACM,aAAa,CAAC,SAAS,EAAE,UAAU,GAAG,UAAU;IAkBhD,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI;IAiBxC,oBAAoB,CAAC,IAAI,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,UAAU,CAAC;QAAC,eAAe,CAAC,EAAE,UAAU,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,UAAU;CAUnJ"}

package/lib/cjs/ChannelControl.js

@@ -0,0 +1,89 @@
+"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 Elements
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChannelAdmin = void 0;
+const core_bentley_1 = require("@itwin/core-bentley");
+const core_common_1 = require("@itwin/core-common");
+const Element_1 = require("./Element");
+/** @internal */
+class ChannelAdmin {
+    constructor(_iModel) {
+        this._iModel = _iModel;
+        this._allowedChannels = new Set();
+        this._allowedModels = new Set();
+        this._deniedModels = new Map();
+        this._allowedChannels.add(ChannelAdmin.sharedChannel);
+    }
+    addAllowedChannel(channelKey) {
+        this._allowedChannels.add(channelKey);
+        this._deniedModels.clear();
+    }
+    removeAllowedChannel(channelKey) {
+        this._allowedChannels.delete(channelKey);
+        this._allowedModels.clear();
+    }
+    get hasChannels() {
+        if (undefined === this._hasChannels) {
+            try {
+                this._hasChannels = this._iModel.withStatement(`SELECT 1 FROM ${ChannelAdmin.channelClassName}`, (stmt) => stmt.step() === core_bentley_1.DbResult.BE_SQLITE_ROW, false);
+            }
+            catch (e) {
+                // iModel doesn't have channel class in its BIS schema
+                this._hasChannels = false;
+            }
+        }
+        return this._hasChannels;
+    }
+    getChannelKey(elementId) {
+        if (!this.hasChannels || elementId === core_common_1.IModel.rootSubjectId)
+            return ChannelAdmin.sharedChannel;
+        const channel = this._iModel.withPreparedStatement(`SELECT Owner FROM ${ChannelAdmin.channelClassName} WHERE Element.Id=?`, (stmt) => {
+            stmt.bindId(1, elementId);
+            return core_bentley_1.DbResult.BE_SQLITE_ROW === stmt.step() ? stmt.getValue(0).getString() : undefined;
+        });
+        if (channel !== undefined)
+            return channel;
+        const parentId = this._iModel.withPreparedSqliteStatement("SELECT ParentId,ModelId FROM bis_Element WHERE id=?", (stmt) => {
+            stmt.bindId(1, elementId);
+            if (core_bentley_1.DbResult.BE_SQLITE_ROW !== stmt.step())
+                throw new core_common_1.IModelError(core_bentley_1.IModelStatus.NotFound, "Element does not exist");
+            return stmt.getValueId(0) ?? stmt.getValueId(1); // if parent is undefined, use modelId
+        });
+        return this.getChannelKey(parentId);
+    }
+    verifyChannel(modelId) {
+        // Note: indirect changes are permitted to change any channel
+        if (!this.hasChannels || this._allowedModels.has(modelId) || this._iModel.nativeDb.isIndirectChanges())
+            return;
+        const deniedChannel = this._deniedModels.get(modelId);
+        if (undefined !== deniedChannel)
+            throw new core_common_1.IModelError(core_bentley_1.RepositoryStatus.ChannelConstraintViolation, `channel "${deniedChannel}" is not allowed`);
+        const channel = this.getChannelKey(modelId);
+        if (this._allowedChannels.has(channel)) {
+            this._allowedModels.add(modelId);
+            return;
+        }
+        this._deniedModels.set(modelId, channel);
+        return this.verifyChannel(modelId);
+    }
+    insertChannelSubject(args) {
+        if (args.parentSubjectId && ChannelAdmin.sharedChannel !== this.getChannelKey(args.parentSubjectId))
+            throw new Error("channels may not nest");
+        const subjectId = Element_1.Subject.insert(this._iModel, args.parentSubjectId ?? core_common_1.IModel.rootSubjectId, args.subjectName, args.description);
+        const props = { classFullName: ChannelAdmin.channelClassName, element: { id: subjectId }, owner: args.channelKey };
+        this._iModel.elements.insertAspect(props);
+        this._hasChannels = true;
+        return subjectId;
+    }
+}
+/** the name of the special "shared" channel holding information that is editable by any application. */
+ChannelAdmin.sharedChannel = "shared";
+ChannelAdmin.channelClassName = "bis:ChannelRootAspect";
+exports.ChannelAdmin = ChannelAdmin;
+//# sourceMappingURL=ChannelControl.js.map

package/lib/cjs/ChannelControl.js.map

@@ -0,0 +1 @@
+{"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.d.ts

@@ -1,122 +1,122 @@
-/** @packageDocumentation
- * @module iModels
- */
-import { BeEvent, GuidString } from "@itwin/core-bentley";
-import { ChangesetId, ChangesetIdWithIndex, LocalDirName, LocalFileName } from "@itwin/core-common";
-import { CloudSqlite } from "./CloudSqlite";
-import { SnapshotDb, TokenArg } from "./IModelDb";
-/**
- * Properties of a checkpoint
- * @public
- */
-export interface CheckpointProps extends TokenArg {
-    readonly expectV2?: boolean;
-    /** iTwin that the iModel belongs to */
-    readonly iTwinId: GuidString;
-    /** Id of the iModel */
-    readonly iModelId: GuidString;
-    /** changeset for the checkpoint */
-    readonly changeset: ChangesetIdWithIndex;
-    /** If true, then the latest successful v2 checkpoint at or before the provided changeset will be returned when calling queryV2Checkpoint.  */
-    readonly allowPreceding?: boolean;
-    /** The number of seconds before the current token expires to attempt to reacquire a new token. Default is 1 hour. */
-    readonly reattachSafetySeconds?: number;
-}
-/** Return value from [[ProgressFunction]].
- *  @public
- */
-export declare enum ProgressStatus {
-    /** Continue download. */
-    Continue = 0,
-    /** Abort download. */
-    Abort = 1
-}
-/** Called to show progress during a download. If this function returns non-zero, the download is aborted.
- *  @public
- */
-export declare type ProgressFunction = (loaded: number, total: number) => ProgressStatus;
-/** The parameters that specify a request to download a checkpoint file from iModelHub.
- * @internal
- */
-export interface DownloadRequest {
-    /** name of local file to hold the downloaded data. */
-    localFile: LocalFileName;
-    /** A list of full fileName paths to test before downloading. If a valid file exists by one of these names,
-     * no download is performed and `localFile` is updated to reflect the fact that the file exists with that name.
-     * This can be used, for example, to look for checkpoints from previous versions if the naming strategy changes.
-     */
-    readonly aliasFiles?: ReadonlyArray<string>;
-    /** Properties of the checkpoint to be downloaded */
-    readonly checkpoint: CheckpointProps;
-    /** If present, this function will be called to indicate progress as the briefcase is downloaded. If this
-     * function returns a non-zero value, the download is aborted.
-     */
-    readonly onProgress?: ProgressFunction;
-}
-/** @internal */
-export interface DownloadJob {
-    request: DownloadRequest;
-    promise?: Promise<any>;
-}
-/** @internal */
-export declare class Downloads {
-    private static _active;
-    private static process;
-    static isInProgress(pathName: LocalFileName): DownloadJob | undefined;
-    static download<T>(request: DownloadRequest, downloadFn: (job: DownloadJob) => Promise<T>): Promise<any>;
-}
-/**
- * Utility class for opening V2 checkpoints from cloud containers, and also for downloading them.
- * @internal
-*/
-export declare class V2CheckpointManager {
-    static readonly cloudCacheName = "v2Checkpoints";
-    private static _cloudCache?;
-    private static containers;
-    static getFolder(): LocalDirName;
-    static cleanup(): void;
-    static getFileName(checkpoint: CheckpointProps): LocalFileName;
-    private static get cloudCache();
-    /** Member names differ slightly between the V2Checkpoint api and the CloudSqlite api. Add aliases `accessName` for `accountName` and `accessToken` for `sasToken` */
-    private static toCloudContainerProps;
-    private static getContainer;
-    static attach(checkpoint: CheckpointProps): Promise<{
-        dbName: string;
-        container: CloudSqlite.CloudContainer;
-    }>;
-    private static performDownload;
-    /** Fully download a V2 checkpoint to a local file that can be used to create a briefcase or to work offline.
-     * @returns a Promise that is resolved when the download completes with the changesetId of the downloaded checkpoint (which will
-     * be the same as the requested changesetId or the most recent checkpoint before it.)
-     */
-    static downloadCheckpoint(request: DownloadRequest): Promise<ChangesetId>;
-}
-/** Utility class to deal with downloading V1 checkpoints from iModelHub.
- * @internal
- */
-export declare class V1CheckpointManager {
-    static getFolder(iModelId: GuidString): LocalDirName;
-    static getFileName(checkpoint: CheckpointProps): LocalFileName;
-    static getCheckpointDb(request: DownloadRequest): Promise<SnapshotDb>;
-    /** Download a V1 checkpoint */
-    static downloadCheckpoint(request: DownloadRequest): Promise<ChangesetId>;
-    private static downloadAndOpen;
-    private static performDownload;
-}
-/** @internal  */
-export declare class CheckpointManager {
-    static readonly onDownloadV1: BeEvent<(job: DownloadJob) => void>;
-    static readonly onDownloadV2: BeEvent<(job: DownloadJob) => void>;
-    static getKey(checkpoint: CheckpointProps): string;
-    private static doDownload;
-    static updateToRequestedVersion(request: DownloadRequest): Promise<void>;
-    /** Download a checkpoint file from iModelHub into a local file specified in the request parameters. */
-    static downloadCheckpoint(request: DownloadRequest): Promise<void>;
-    /** checks a file's dbGuid & iTwinId for consistency, and updates the dbGuid when possible */
-    static validateCheckpointGuids(checkpoint: CheckpointProps, snapshotDb: SnapshotDb): void;
-    /** @returns true if the file is the checkpoint requested */
-    static verifyCheckpoint(checkpoint: CheckpointProps, fileName: LocalFileName): boolean;
-    /** try to open an existing local file to satisfy a download request */
-    static tryOpenLocalFile(request: DownloadRequest): SnapshotDb | undefined;
-}
+/** @packageDocumentation
+ * @module iModels
+ */
+import { BeEvent, GuidString } from "@itwin/core-bentley";
+import { ChangesetId, ChangesetIdWithIndex, LocalDirName, LocalFileName } from "@itwin/core-common";
+import { CloudSqlite } from "./CloudSqlite";
+import { SnapshotDb, TokenArg } from "./IModelDb";
+/**
+ * Properties of a checkpoint
+ * @public
+ */
+export interface CheckpointProps extends TokenArg {
+    readonly expectV2?: boolean;
+    /** iTwin that the iModel belongs to */
+    readonly iTwinId: GuidString;
+    /** Id of the iModel */
+    readonly iModelId: GuidString;
+    /** changeset for the checkpoint */
+    readonly changeset: ChangesetIdWithIndex;
+    /** If true, then the latest successful v2 checkpoint at or before the provided changeset will be returned when calling queryV2Checkpoint.  */
+    readonly allowPreceding?: boolean;
+    /** The number of seconds before the current token expires to attempt to reacquire a new token. Default is 1 hour. */
+    readonly reattachSafetySeconds?: number;
+}
+/** Return value from [[ProgressFunction]].
+ *  @public
+ */
+export declare enum ProgressStatus {
+    /** Continue download. */
+    Continue = 0,
+    /** Abort download. */
+    Abort = 1
+}
+/** Called to show progress during a download. If this function returns non-zero, the download is aborted.
+ *  @public
+ */
+export type ProgressFunction = (loaded: number, total: number) => ProgressStatus;
+/** The parameters that specify a request to download a checkpoint file from iModelHub.
+ * @internal
+ */
+export interface DownloadRequest {
+    /** name of local file to hold the downloaded data. */
+    localFile: LocalFileName;
+    /** A list of full fileName paths to test before downloading. If a valid file exists by one of these names,
+     * no download is performed and `localFile` is updated to reflect the fact that the file exists with that name.
+     * This can be used, for example, to look for checkpoints from previous versions if the naming strategy changes.
+     */
+    readonly aliasFiles?: ReadonlyArray<string>;
+    /** Properties of the checkpoint to be downloaded */
+    readonly checkpoint: CheckpointProps;
+    /** If present, this function will be called to indicate progress as the briefcase is downloaded. If this
+     * function returns a non-zero value, the download is aborted.
+     */
+    readonly onProgress?: ProgressFunction;
+}
+/** @internal */
+export interface DownloadJob {
+    request: DownloadRequest;
+    promise?: Promise<any>;
+}
+/** @internal */
+export declare class Downloads {
+    private static _active;
+    private static process;
+    static isInProgress(pathName: LocalFileName): DownloadJob | undefined;
+    static download<T>(request: DownloadRequest, downloadFn: (job: DownloadJob) => Promise<T>): Promise<any>;
+}
+/**
+ * Utility class for opening V2 checkpoints from cloud containers, and also for downloading them.
+ * @internal
+*/
+export declare class V2CheckpointManager {
+    static readonly cloudCacheName = "v2Checkpoints";
+    private static _cloudCache?;
+    private static containers;
+    static getFolder(): LocalDirName;
+    static cleanup(): void;
+    static getFileName(checkpoint: CheckpointProps): LocalFileName;
+    private static get cloudCache();
+    /** Member names differ slightly between the V2Checkpoint api and the CloudSqlite api. Add aliases `accessName` for `accountName` and `accessToken` for `sasToken` */
+    private static toCloudContainerProps;
+    private static getContainer;
+    static attach(checkpoint: CheckpointProps): Promise<{
+        dbName: string;
+        container: CloudSqlite.CloudContainer;
+    }>;
+    private static performDownload;
+    /** Fully download a V2 checkpoint to a local file that can be used to create a briefcase or to work offline.
+     * @returns a Promise that is resolved when the download completes with the changesetId of the downloaded checkpoint (which will
+     * be the same as the requested changesetId or the most recent checkpoint before it.)
+     */
+    static downloadCheckpoint(request: DownloadRequest): Promise<ChangesetId>;
+}
+/** Utility class to deal with downloading V1 checkpoints from iModelHub.
+ * @internal
+ */
+export declare class V1CheckpointManager {
+    static getFolder(iModelId: GuidString): LocalDirName;
+    static getFileName(checkpoint: CheckpointProps): LocalFileName;
+    static getCheckpointDb(request: DownloadRequest): Promise<SnapshotDb>;
+    /** Download a V1 checkpoint */
+    static downloadCheckpoint(request: DownloadRequest): Promise<ChangesetId>;
+    private static downloadAndOpen;
+    private static performDownload;
+}
+/** @internal  */
+export declare class CheckpointManager {
+    static readonly onDownloadV1: BeEvent<(job: DownloadJob) => void>;
+    static readonly onDownloadV2: BeEvent<(job: DownloadJob) => void>;
+    static getKey(checkpoint: CheckpointProps): string;
+    private static doDownload;
+    static updateToRequestedVersion(request: DownloadRequest): Promise<void>;
+    /** Download a checkpoint file from iModelHub into a local file specified in the request parameters. */
+    static downloadCheckpoint(request: DownloadRequest): Promise<void>;
+    /** checks a file's dbGuid & iTwinId for consistency, and updates the dbGuid when possible */
+    static validateCheckpointGuids(checkpoint: CheckpointProps, snapshotDb: SnapshotDb): void;
+    /** @returns true if the file is the checkpoint requested */
+    static verifyCheckpoint(checkpoint: CheckpointProps, fileName: LocalFileName): boolean;
+    /** try to open an existing local file to satisfy a download request */
+    static tryOpenLocalFile(request: DownloadRequest): SnapshotDb | undefined;
+}
 //# sourceMappingURL=CheckpointManager.d.ts.map