@itwin/core-backend 4.0.0-dev.48 → 4.0.0-dev.50

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":["/*---------------------------------------------------------------------------------------------\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"]}
+{"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"]}

package/lib/cjs/ChannelControl.d.ts

@@ -1,70 +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 declare 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;
-}
+/** @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 declare 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.js

@@ -1,89 +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;
-    }
-}
-exports.ChannelAdmin = ChannelAdmin;
-/** the name of the special "shared" channel holding information that is editable by any application. */
-ChannelAdmin.sharedChannel = "shared";
-ChannelAdmin.channelClassName = "bis:ChannelRootAspect";
+"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;
+    }
+}
+exports.ChannelAdmin = ChannelAdmin;
+/** the name of the special "shared" channel holding information that is editable by any application. */
+ChannelAdmin.sharedChannel = "shared";
+ChannelAdmin.channelClassName = "bis:ChannelRootAspect";
 //# sourceMappingURL=ChannelControl.js.map

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":["/*---------------------------------------------------------------------------------------------\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"]}
+{"version":3,"file":"ChannelControl.js","sourceRoot":"","sources":["../../src/ChannelControl.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,sDAA2F;AAC3F,oDAAiF;AACjF,uCAAoC;AA+CpC,gBAAgB;AAChB,MAAa,YAAY;IASvB,YAA2B,OAAiB;QAAjB,YAAO,GAAP,OAAO,CAAU;QALpC,qBAAgB,GAAG,IAAI,GAAG,EAAc,CAAC;QACzC,mBAAc,GAAG,IAAI,GAAG,EAAc,CAAC;QACvC,kBAAa,GAAG,IAAI,GAAG,EAA0B,CAAC;QAIxD,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;IACxD,CAAC;IACM,iBAAiB,CAAC,UAAsB;QAC7C,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACtC,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;IACM,oBAAoB,CAAC,UAAsB;QAChD,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACzC,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;IAC9B,CAAC;IACD,IAAW,WAAW;QACpB,IAAI,SAAS,KAAK,IAAI,CAAC,YAAY,EAAE;YACnC,IAAI;gBACF,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,iBAAiB,YAAY,CAAC,gBAAgB,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,uBAAQ,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;aAC3J;YAAC,OAAO,CAAC,EAAE;gBACV,sDAAsD;gBACtD,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;aAC3B;SACF;QACD,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IACM,aAAa,CAAC,SAAqB;QACxC,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,SAAS,KAAK,oBAAM,CAAC,aAAa;YACzD,OAAO,YAAY,CAAC,aAAa,CAAC;QAEpC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,qBAAqB,YAAY,CAAC,gBAAgB,qBAAqB,EAAE,CAAC,IAAI,EAAE,EAAE;YACnI,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;YAC1B,OAAO,uBAAQ,CAAC,aAAa,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAC3F,CAAC,CAAC,CAAC;QACH,IAAI,OAAO,KAAK,SAAS;YACvB,OAAO,OAAO,CAAC;QACjB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,2BAA2B,CAAC,qDAAqD,EAAE,CAAC,IAAI,EAAE,EAAE;YACxH,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;YAC1B,IAAI,uBAAQ,CAAC,aAAa,KAAK,IAAI,CAAC,IAAI,EAAE;gBACxC,MAAM,IAAI,yBAAW,CAAC,2BAAY,CAAC,QAAQ,EAAE,wBAAwB,CAAC,CAAC;YACzE,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,sCAAsC;QACzF,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IACM,aAAa,CAAC,OAAmB;QACtC,6DAA6D;QAC7D,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,EAAE;YACpG,OAAO;QAET,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACtD,IAAI,SAAS,KAAK,aAAa;YAC7B,MAAM,IAAI,yBAAW,CAAC,+BAAgB,CAAC,0BAA0B,EAAE,YAAY,aAAa,kBAAkB,CAAC,CAAC;QAElH,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE;YACtC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACjC,OAAO;SACR;QACD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IACM,oBAAoB,CAAC,IAAyG;QACnI,IAAI,IAAI,CAAC,eAAe,IAAI,YAAY,CAAC,aAAa,KAAK,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,eAAe,CAAC;YACjG,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAE3C,MAAM,SAAS,GAAG,iBAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,eAAe,IAAI,oBAAM,CAAC,aAAa,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QACjI,MAAM,KAAK,GAA2B,EAAE,aAAa,EAAE,YAAY,CAAC,gBAAgB,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;QAC3I,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAC1C,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,OAAO,SAAS,CAAC;IACnB,CAAC;;AA3EH,oCA4EC;AA3EC,wGAAwG;AACjF,0BAAa,GAAG,QAAQ,CAAC;AACzB,6BAAgB,GAAG,uBAAuB,CAAC","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"]}