@itwin/core-backend 3.4.0-dev.3 → 3.4.0-dev.33

package/lib/cjs/IModelDb.js

@@ -16,11 +16,14 @@ const BackendLoggerCategory_1 = require("./BackendLoggerCategory");
 const BriefcaseManager_1 = require("./BriefcaseManager");
 const CheckpointManager_1 = require("./CheckpointManager");
 const ClassRegistry_1 = require("./ClassRegistry");
+const CodeService_1 = require("./CodeService");
 const CodeSpecs_1 = require("./CodeSpecs");
 const ConcurrentQuery_1 = require("./ConcurrentQuery");
 const ECSqlStatement_1 = require("./ECSqlStatement");
+const Element_1 = require("./Element");
 const ElementAspect_1 = require("./ElementAspect");
 const ElementGraphics_1 = require("./ElementGraphics");
+const GeoCoordConfig_1 = require("./GeoCoordConfig");
 const IModelHost_1 = require("./IModelHost");
 const IModelJsFs_1 = require("./IModelJsFs");
 const IpcHost_1 = require("./IpcHost");
@@ -32,7 +35,7 @@ const TxnManager_1 = require("./TxnManager");
 const ViewDefinition_1 = require("./ViewDefinition");
 const Settings_1 = require("./workspace/Settings");
 const Workspace_1 = require("./workspace/Workspace");
-const GeoCoordConfig_1 = require("./GeoCoordConfig");
+// spell:ignore fontid fontmap
 const loggerCategory = BackendLoggerCategory_1.BackendLoggerCategory.IModelDb;
 /** A null-implementation of LockControl that does not attempt to limit access between briefcases. This relies on change-merging to resolve conflicts. */
 class NoLocks {
@@ -119,6 +122,8 @@ class IModelDb extends core_common_1.IModel {
             });
         }
     }
+    /** @alpha */
+    get codeService() { return this._codeService; }
     /**
      * Get the [[LockControl]] for this iModel.
      * @beta
@@ -130,7 +135,7 @@ class IModelDb extends core_common_1.IModel {
      */
     get workspace() {
         if (undefined === this._workspace)
-            this._workspace = new Workspace_1.ITwinWorkspace(new IModelSettings(), IModelHost_1.IModelHost.appWorkspace);
+            this._workspace = new Workspace_1.ITwinWorkspace(new IModelSettings());
         return this._workspace;
     }
     /** Acquire the exclusive schema lock on this iModel.
@@ -185,7 +190,7 @@ class IModelDb extends core_common_1.IModel {
     get pathName() { return this.nativeDb.getFilePath(); }
     /** Close this IModel, if it is currently open. */
     close() {
-        var _a;
+        var _a, _b;
         if (!this.isOpen)
             return; // don't continue if already closed
         this.beforeClose();
@@ -193,6 +198,8 @@ class IModelDb extends core_common_1.IModel {
         (_a = this._workspace) === null || _a === void 0 ? void 0 : _a.close();
         this.locks.close();
         this._locks = undefined;
+        (_b = this._codeService) === null || _b === void 0 ? void 0 : _b.close();
+        this._codeService = undefined;
         this.nativeDb.closeIModel();
         this._nativeDb = undefined; // the underlying nativeDb has been freed by closeIModel
     }
@@ -833,6 +840,14 @@ class IModelDb extends core_common_1.IModel {
         if (metaData.baseClasses !== undefined && metaData.baseClasses.length > 0)
             metaData.baseClasses.forEach((baseClassName) => this.loadMetaData(baseClassName));
     }
+    /** Returns the full schema for the input name.
+     * @param name The name of the schema e.g. 'BisCore'
+     * @returns The SchemaProps for the requested schema
+     * @throws if the schema can not be found or loaded.
+     */
+    getSchemaProps(name) {
+        return this.nativeDb.getSchemaProps(name);
+    }
     /** Query if this iModel contains the definition of the specified class.
      * @param classFullName The full name of the class, for example, SomeSchema:SomeClass
      * @returns true if the iModel contains the class definition or false if not.
@@ -1289,11 +1304,14 @@ IModelDb._settingPropNamespace = "settings";
          * @throws [[IModelError]] if the element is not found or cannot be loaded.
          * @see tryGetElementProps
          */
-        getElementProps(elementId) {
-            const elementProps = this.tryGetElementProps(elementId);
-            if (undefined === elementProps)
-                throw new core_common_1.IModelError(core_bentley_1.IModelStatus.NotFound, `reading element=${elementId}`);
-            return elementProps;
+        getElementProps(props) {
+            if (typeof props === "string") {
+                props = core_bentley_1.Id64.isId64(props) ? { id: props } : { federationGuid: props };
+            }
+            else if (props instanceof core_common_1.Code) {
+                props = { code: props };
+            }
+            return this._iModel.nativeDb.getElement(props);
         }
         /** Get properties of an Element by Id, FederationGuid, or Code
          * @returns The properties of the element or `undefined` if the element is not found.
@@ -1335,6 +1353,8 @@ IModelDb._settingPropNamespace = "settings";
                 elementId = core_bentley_1.Id64.isId64(elementId) ? { id: elementId } : { federationGuid: elementId };
             else if (elementId instanceof core_common_1.Code)
                 elementId = { code: elementId };
+            else
+                elementId.onlyBaseProperties = false; // we must load all properties to construct the element.
             const elementProps = this.tryGetElementJson(elementId);
             if (undefined === elementProps)
                 return undefined; // no Element with that elementId found
@@ -1395,7 +1415,8 @@ IModelDb._settingPropNamespace = "settings";
                 return elProps.id = this._iModel.nativeDb.insertElement(elProps);
             }
             catch (err) {
-                throw new core_common_1.IModelError(err.errorNumber, `insertElement with class=${elProps.classFullName}: ${err.message}`);
+                err.message = `error inserting element: ${err.message}`;
+                throw err;
             }
         }
         /** Update some properties of an existing element.
@@ -1410,7 +1431,8 @@ IModelDb._settingPropNamespace = "settings";
                 this._iModel.nativeDb.updateElement(elProps);
             }
             catch (err) {
-                throw new core_common_1.IModelError(err.errorNumber, `Error updating element [${err.message}], id:${elProps.id}`);
+                err.message = `error updating element: ${err.message}`;
+                throw err;
             }
         }
         /** Delete one or more elements from this iModel.
@@ -1425,7 +1447,8 @@ IModelDb._settingPropNamespace = "settings";
                     iModel.nativeDb.deleteElement(id);
                 }
                 catch (err) {
-                    throw new core_common_1.IModelError(err.errorNumber, `Error deleting element [${err.message}], id:${id}`);
+                    err.message = `error deleting element: ${err.message}`;
+                    throw err;
                 }
             });
         }
@@ -1520,6 +1543,20 @@ IModelDb._settingPropNamespace = "settings";
                 return childIds;
             });
         }
+        /** Query for the parent of the specified element.
+         * @param elementId The element to check for a parent
+         * @returns The identifier of the element's parent or undefined if the element has no parent
+         * @throws [[IModelError]] if the element does not exist
+         */
+        queryParent(elementId) {
+            return this._iModel.withPreparedStatement(`select parent.id from ${Element_1.Element.classFullName} where ecinstanceid=?`, (stmt) => {
+                stmt.bindId(1, elementId);
+                if (stmt.step() !== core_bentley_1.DbResult.BE_SQLITE_ROW)
+                    throw new core_common_1.IModelError(core_bentley_1.IModelStatus.NotFound, `Element=${elementId}`);
+                const value = stmt.getValue(0);
+                return value.isNull ? undefined : value.getId();
+            });
+        }
         /** Returns true if the specified Element has a sub-model.
          * @see [[IModelDb.Models.getSubModel]]
          */
@@ -1950,6 +1987,17 @@ class BriefcaseDb extends IModelDb {
         const openMode = args.readonly ? core_bentley_1.OpenMode.Readonly : core_bentley_1.OpenMode.ReadWrite;
         const nativeDb = this.openDgnDb(file, openMode, undefined, args);
         const briefcaseDb = new BriefcaseDb({ nativeDb, key: (_a = file.key) !== null && _a !== void 0 ? _a : core_bentley_1.Guid.createValue(), openMode, briefcaseId: nativeDb.getBriefcaseId() });
+        if (openMode === core_bentley_1.OpenMode.ReadWrite && CodeService_1.CodeService.createForIModel) {
+            try {
+                const codeService = CodeService_1.CodeService.createForIModel(briefcaseDb);
+                briefcaseDb._codeService = codeService;
+                this.onCodeServiceCreated.raiseEvent(codeService);
+            }
+            catch (e) {
+                if (e.errorId !== "NoCodeIndex") // no code index means iModel isn't enforcing codes.
+                    throw e;
+            }
+        }
         BriefcaseManager_1.BriefcaseManager.logUsage(briefcaseDb);
         this.onOpened.raiseEvent(briefcaseDb, args);
         return briefcaseDb;
@@ -2007,6 +2055,8 @@ BriefcaseDb.onOpen = new core_bentley_1.BeEvent();
  * ```
  */
 BriefcaseDb.onOpened = new core_bentley_1.BeEvent();
+/** @alpha */
+BriefcaseDb.onCodeServiceCreated = new core_bentley_1.BeEvent();
 /** Used to reattach Daemon from a user's accessToken for V2 checkpoints.
  * @note Reattach only happens if the previous access token either has expired or is about to expire within an application-supplied safety duration.
  */