@itwin/core-backend 5.1.0-dev.27 → 5.1.0-dev.29

package/lib/cjs/IModelDb.js

@@ -1481,7 +1481,7 @@ function processSchemaWriteStatus(status) {
 /** @public */
 (function (IModelDb) {
     /** The collection of models in an [[IModelDb]].
-     * @public
+     * @public @preview
      */
     class Models {
         _iModel;
@@ -1635,7 +1635,9 @@ function processSchemaWriteStatus(status) {
                 return props.id = this._iModel[Symbols_1._nativeDb].insertModel(props);
             }
             catch (err) {
-                throw new core_common_1.IModelError(err.errorNumber, `Error inserting model [${err.message}], class=${props.classFullName}`);
+                const error = new core_common_1.IModelError(err.errorNumber, `Error inserting model [${err.message}], class=${props.classFullName}`);
+                error.cause = err;
+                throw error;
             }
         }
         /** Update an existing model.
@@ -1649,7 +1651,9 @@ function processSchemaWriteStatus(status) {
                 this._iModel[Symbols_1._nativeDb].updateModel(props);
             }
             catch (err) {
-                throw new core_common_1.IModelError(err.errorNumber, `error updating model [${err.message}] id=${props.id}`);
+                const error = new core_common_1.IModelError(err.errorNumber, `Error updating model [${err.message}], id: ${props.id}`);
+                error.cause = err;
+                throw error;
             }
         }
         /** Mark the geometry of [[GeometricModel]] as having changed, by recording an indirect change to its GeometryGuid property.
@@ -1665,7 +1669,7 @@ function processSchemaWriteStatus(status) {
             this._iModel.models[Symbols_1._cache].delete(modelId);
             const error = this._iModel[Symbols_1._nativeDb].updateModelGeometryGuid(modelId);
             if (error !== core_bentley_1.IModelStatus.Success)
-                throw new core_common_1.IModelError(error, `updating geometry guid for model ${modelId}`);
+                throw new core_common_1.IModelError(error, `Error updating geometry guid for model ${modelId}`);
         }
         /** Delete one or more existing models.
          * @param ids The Ids of the models to be deleted
@@ -1678,7 +1682,9 @@ function processSchemaWriteStatus(status) {
                     this._iModel[Symbols_1._nativeDb].deleteModel(id);
                 }
                 catch (err) {
-                    throw new core_common_1.IModelError(err.errorNumber, `error deleting model [${err.message}] id ${id}`);
+                    const error = new core_common_1.IModelError(err.errorNumber, `Error deleting model [${err.message}], id: ${id}`);
+                    error.cause = err;
+                    throw error;
                 }
             });
         }
@@ -1708,7 +1714,7 @@ function processSchemaWriteStatus(status) {
     }
     IModelDb.Models = Models;
     /** The collection of elements in an [[IModelDb]].
-     * @public
+     * @public @preview
      */
     class Elements {
         _iModel;
@@ -1886,7 +1892,7 @@ function processSchemaWriteStatus(status) {
         /** Insert a new element into the iModel.
          * @param elProps The properties of the new element.
          * @returns The newly inserted element's Id.
-         * @throws [[IModelError]] if unable to insert the element.
+         * @throws [[ITwinError]] if unable to insert the element.
          * @note For convenience, the value of `elProps.id` is updated to reflect the resultant element's id.
          * However when `elProps.federationGuid` is not present or undefined, a new Guid will be generated and stored on the resultant element. But
          * the value of `elProps.federationGuid` is *not* updated. Generally, it is best to re-read the element after inserting (e.g. via [[getElementProps]])
@@ -1916,7 +1922,7 @@ function processSchemaWriteStatus(status) {
          * @param elProps the properties of the element to update.
          * @note The values of `classFullName` and `model` *may not be changed* by this method. Further, it will permute the `elProps` object by adding or
          * overwriting their values to the correct values.
-         * @throws [[IModelError]] if unable to update the element.
+         * @throws [[ITwinError]] if unable to update the element.
          */
         updateElement(elProps) {
             try {
@@ -1935,7 +1941,7 @@ function processSchemaWriteStatus(status) {
         }
         /** Delete one or more elements from this iModel.
          * @param ids The set of Ids of the element(s) to be deleted
-         * @throws [[IModelError]]
+         * @throws [[ITwinError]]
          * @see deleteDefinitionElements
          */
         deleteElement(ids) {
@@ -2222,7 +2228,9 @@ function processSchemaWriteStatus(status) {
                 return this._iModel[Symbols_1._nativeDb].insertElementAspect(aspectProps);
             }
             catch (err) {
-                throw new core_common_1.IModelError(err.errorNumber, `Error inserting ElementAspect [${err.message}], class: ${aspectProps.classFullName}`);
+                const error = new core_common_1.IModelError(err.errorNumber, `Error inserting ElementAspect [${err.message}], class: ${aspectProps.classFullName}`, aspectProps);
+                error.cause = err;
+                throw error;
             }
         }
         /** Update an exist ElementAspect within the iModel.
@@ -2234,7 +2242,9 @@ function processSchemaWriteStatus(status) {
                 this._iModel[Symbols_1._nativeDb].updateElementAspect(aspectProps);
             }
             catch (err) {
-                throw new core_common_1.IModelError(err.errorNumber, `Error updating ElementAspect [${err.message}], id: ${aspectProps.id}`);
+                const error = new core_common_1.IModelError(err.errorNumber, `Error updating ElementAspect [${err.message}], id: ${aspectProps.id}`, aspectProps);
+                error.cause = err;
+                throw error;
             }
         }
         /** Delete one or more ElementAspects from this iModel.
@@ -2248,14 +2258,16 @@ function processSchemaWriteStatus(status) {
                     iModel[Symbols_1._nativeDb].deleteElementAspect(aspectInstanceId);
                 }
                 catch (err) {
-                    throw new core_common_1.IModelError(err.errorNumber, `Error deleting ElementAspect [${err.message}], id: ${aspectInstanceId}`);
+                    const error = new core_common_1.IModelError(err.errorNumber, `Error deleting ElementAspect [${err.message}], id: ${aspectInstanceId}`);
+                    error.cause = err;
+                    throw error;
                 }
             });
         }
     }
     IModelDb.Elements = Elements;
     /** The collection of views in an [[IModelDb]].
-     * @public
+     * @public @preview
      */
     class Views {
         _iModel;
@@ -2281,7 +2293,7 @@ function processSchemaWriteStatus(status) {
             if (undefined === props) {
                 const propsString = this._iModel.queryFilePropertyString(Views.viewStoreProperty);
                 if (!propsString)
-                    throw new Error("iModel does not have a default ViewStore");
+                    core_common_1.ViewStoreError.throwError("no-viewstore", { message: "iModel does not have a default ViewStore" });
                 props = JSON.parse(propsString);
             }
             const accessToken = await CloudSqlite_1.CloudSqlite.requestToken({
@@ -2402,7 +2414,7 @@ function processSchemaWriteStatus(status) {
         }
         getViewThumbnailArg(viewDefinitionId) {
             if (!core_bentley_1.Id64.isValid(viewDefinitionId))
-                throw new Error("illegal thumbnail id");
+                throw new core_common_1.IModelError(core_bentley_1.IModelStatus.BadArg, "illegal thumbnail id");
             return { namespace: "dgn_View", name: "Thumbnail", id: viewDefinitionId };
         }
         /** Get the thumbnail for a view.