@itwin/core-backend 5.9.0-dev.10 → 5.9.0-dev.12

package/lib/cjs/internal/IntegrityCheck.js

@@ -19,61 +19,61 @@ exports.integrityCheckTypeMap = {
         name: "Check Data Columns",
         resultType: "CheckDataColumnsResultRow",
         sqlCommand: "check_data_columns",
-        sqlQuery: `PRAGMA integrity_check(check_data_columns) options enable_experimental_features`,
+        sqlQuery: `PRAGMA integrity_check(check_data_columns) ECSQLOPTIONS ENABLE_EXPERIMENTAL_FEATURES`,
     },
     checkECProfile: {
         name: "Check EC Profile",
         resultType: "CheckECProfileResultRow",
         sqlCommand: "check_ec_profile",
-        sqlQuery: `PRAGMA integrity_check(check_ec_profile) options enable_experimental_features`,
+        sqlQuery: `PRAGMA integrity_check(check_ec_profile) ECSQLOPTIONS ENABLE_EXPERIMENTAL_FEATURES`,
     },
     checkNavigationClassIds: {
         name: "Check Navigation Class Ids",
         resultType: "CheckNavClassIdsResultRow",
         sqlCommand: "check_nav_class_ids",
-        sqlQuery: `PRAGMA integrity_check(check_nav_class_ids) options enable_experimental_features`,
+        sqlQuery: `PRAGMA integrity_check(check_nav_class_ids) ECSQLOPTIONS ENABLE_EXPERIMENTAL_FEATURES`,
     },
     checkNavigationIds: {
         name: "Check Navigation Ids",
         resultType: "CheckNavIdsResultRow",
         sqlCommand: "check_nav_ids",
-        sqlQuery: `PRAGMA integrity_check(check_nav_ids) options enable_experimental_features`,
+        sqlQuery: `PRAGMA integrity_check(check_nav_ids) ECSQLOPTIONS ENABLE_EXPERIMENTAL_FEATURES`,
     },
     checkLinktableForeignKeyClassIds: {
         name: "Check Link Table Foreign Key Class Ids",
         resultType: "CheckLinkTableFkClassIdsResultRow",
         sqlCommand: "check_linktable_fk_class_ids",
-        sqlQuery: `PRAGMA integrity_check(check_linktable_fk_class_ids) options enable_experimental_features`,
+        sqlQuery: `PRAGMA integrity_check(check_linktable_fk_class_ids) ECSQLOPTIONS ENABLE_EXPERIMENTAL_FEATURES`,
     },
     checkLinktableForeignKeyIds: {
         name: "Check Link Table Foreign Key Ids",
         resultType: "CheckLinkTableFkIdsResultRow",
         sqlCommand: "check_linktable_fk_ids",
-        sqlQuery: `PRAGMA integrity_check(check_linktable_fk_ids) options enable_experimental_features`,
+        sqlQuery: `PRAGMA integrity_check(check_linktable_fk_ids) ECSQLOPTIONS ENABLE_EXPERIMENTAL_FEATURES`,
     },
     checkClassIds: {
         name: "Check Class Ids",
         resultType: "CheckClassIdsResultRow",
         sqlCommand: "check_class_ids",
-        sqlQuery: `PRAGMA integrity_check(check_class_ids) options enable_experimental_features`,
+        sqlQuery: `PRAGMA integrity_check(check_class_ids) ECSQLOPTIONS ENABLE_EXPERIMENTAL_FEATURES`,
     },
     checkDataSchema: {
         name: "Check Data Schema",
         resultType: "CheckDataSchemaResultRow",
         sqlCommand: "check_data_schema",
-        sqlQuery: `PRAGMA integrity_check(check_data_schema) options enable_experimental_features`,
+        sqlQuery: `PRAGMA integrity_check(check_data_schema) ECSQLOPTIONS ENABLE_EXPERIMENTAL_FEATURES`,
     },
     checkSchemaLoad: {
         name: "Check Schema Load",
         resultType: "CheckSchemaLoadResultRow",
         sqlCommand: "check_schema_load",
-        sqlQuery: `PRAGMA integrity_check(check_schema_load) options enable_experimental_features`,
+        sqlQuery: `PRAGMA integrity_check(check_schema_load) ECSQLOPTIONS ENABLE_EXPERIMENTAL_FEATURES`,
     },
     checkMissingChildRows: {
         name: "Check Missing Child Rows",
         resultType: "CheckMissingChildRowsResultRow",
         sqlCommand: "check_missing_child_rows",
-        sqlQuery: `PRAGMA integrity_check(check_missing_child_rows) options enable_experimental_features`,
+        sqlQuery: `PRAGMA integrity_check(check_missing_child_rows) ECSQLOPTIONS ENABLE_EXPERIMENTAL_FEATURES`,
     },
 };
 /**
@@ -106,9 +106,9 @@ function getIntegrityCheckName(check) {
  * @internal
  */
 async function performQuickIntegrityCheck(iModel) {
-    const integrityCheckQuery = "PRAGMA integrity_check options enable_experimental_features";
+    const integrityCheckQuery = "PRAGMA integrity_check ECSQLOPTIONS ENABLE_EXPERIMENTAL_FEATURES";
     const integrityCheckResults = [];
-    for await (const row of iModel.createQueryReader(integrityCheckQuery)) {
+    for await (const row of iModel.createQueryReader(integrityCheckQuery, undefined, { usePrimaryConn: true })) {
         integrityCheckResults.push({ check: getIntegrityCheckName(row.check), passed: row.result, elapsedSeconds: row.elapsed_sec });
     }
     ;
@@ -118,70 +118,70 @@ async function performSpecificIntegrityCheck(iModel, check) {
     switch (check) {
         case "checkDataColumns": {
             const results = [];
-            for await (const row of iModel.createQueryReader(exports.integrityCheckTypeMap.checkDataColumns.sqlQuery)) {
+            for await (const row of iModel.createQueryReader(exports.integrityCheckTypeMap.checkDataColumns.sqlQuery, undefined, { usePrimaryConn: true })) {
                 results.push({ sno: row.sno, table: row.table, column: row.column });
             }
             return results;
         }
         case "checkECProfile": {
             const results = [];
-            for await (const row of iModel.createQueryReader(exports.integrityCheckTypeMap.checkECProfile.sqlQuery)) {
+            for await (const row of iModel.createQueryReader(exports.integrityCheckTypeMap.checkECProfile.sqlQuery, undefined, { usePrimaryConn: true })) {
                 results.push({ sno: row.sno, type: row.type, name: row.name, issue: row.issue });
             }
             return results;
         }
         case "checkNavigationClassIds": {
             const results = [];
-            for await (const row of iModel.createQueryReader(exports.integrityCheckTypeMap.checkNavigationClassIds.sqlQuery)) {
+            for await (const row of iModel.createQueryReader(exports.integrityCheckTypeMap.checkNavigationClassIds.sqlQuery, undefined, { usePrimaryConn: true })) {
                 results.push({ sno: row.sno, id: row.id, class: row.class, property: row.property, navId: row.nav_id, navClassId: row.nav_classId });
             }
             return results;
         }
         case "checkNavigationIds": {
             const results = [];
-            for await (const row of iModel.createQueryReader(exports.integrityCheckTypeMap.checkNavigationIds.sqlQuery)) {
+            for await (const row of iModel.createQueryReader(exports.integrityCheckTypeMap.checkNavigationIds.sqlQuery, undefined, { usePrimaryConn: true })) {
                 results.push({ sno: row.sno, id: row.id, class: row.class, property: row.property, navId: row.nav_id, primaryClass: row.primary_class });
             }
             return results;
         }
         case "checkLinktableForeignKeyClassIds": {
             const results = [];
-            for await (const row of iModel.createQueryReader(exports.integrityCheckTypeMap.checkLinktableForeignKeyClassIds.sqlQuery)) {
+            for await (const row of iModel.createQueryReader(exports.integrityCheckTypeMap.checkLinktableForeignKeyClassIds.sqlQuery, undefined, { usePrimaryConn: true })) {
                 results.push({ sno: row.sno, id: row.id, relationship: row.relationship, property: row.property, keyId: row.key_id, keyClassId: row.key_classId });
             }
             return results;
         }
         case "checkLinktableForeignKeyIds": {
             const results = [];
-            for await (const row of iModel.createQueryReader(exports.integrityCheckTypeMap.checkLinktableForeignKeyIds.sqlQuery)) {
+            for await (const row of iModel.createQueryReader(exports.integrityCheckTypeMap.checkLinktableForeignKeyIds.sqlQuery, undefined, { usePrimaryConn: true })) {
                 results.push({ sno: row.sno, id: row.id, relationship: row.relationship, property: row.property, keyId: row.key_id, primaryClass: row.primary_class });
             }
             return results;
         }
         case "checkClassIds": {
             const results = [];
-            for await (const row of iModel.createQueryReader(exports.integrityCheckTypeMap.checkClassIds.sqlQuery)) {
+            for await (const row of iModel.createQueryReader(exports.integrityCheckTypeMap.checkClassIds.sqlQuery, undefined, { usePrimaryConn: true })) {
                 results.push({ sno: row.sno, class: row.class, id: row.id, classId: row.class_id, type: row.type });
             }
             return results;
         }
         case "checkDataSchema": {
             const results = [];
-            for await (const row of iModel.createQueryReader(exports.integrityCheckTypeMap.checkDataSchema.sqlQuery)) {
+            for await (const row of iModel.createQueryReader(exports.integrityCheckTypeMap.checkDataSchema.sqlQuery, undefined, { usePrimaryConn: true })) {
                 results.push({ sno: row.sno, type: row.type, name: row.name });
             }
             return results;
         }
         case "checkSchemaLoad": {
             const results = [];
-            for await (const row of iModel.createQueryReader(exports.integrityCheckTypeMap.checkSchemaLoad.sqlQuery)) {
+            for await (const row of iModel.createQueryReader(exports.integrityCheckTypeMap.checkSchemaLoad.sqlQuery, undefined, { usePrimaryConn: true })) {
                 results.push({ sno: row.sno, schema: row.schema });
             }
             return results;
         }
         case "checkMissingChildRows": {
             const results = [];
-            for await (const row of iModel.createQueryReader(exports.integrityCheckTypeMap.checkMissingChildRows.sqlQuery)) {
+            for await (const row of iModel.createQueryReader(exports.integrityCheckTypeMap.checkMissingChildRows.sqlQuery, undefined, { usePrimaryConn: true })) {
                 results.push({ sno: row.sno, class: row.class, id: row.id, classId: row.class_id, missingRowInTables: row.MissingRowInTables });
             }
             return results;

package/lib/cjs/internal/IntegrityCheck.js.map

@@ -1 +1 @@
-{"version":3,"file":"IntegrityCheck.js","sourceRoot":"","sources":["../../../src/internal/IntegrityCheck.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\nimport { IModelStatus } from \"@itwin/core-bentley\";\nimport { IModelError } from \"@itwin/core-common\";\nimport { IModelDb } from \"../IModelDb\";\n\n/**\n * Information about each integrity check type, including the name, expected result type, and SQL query to execute\n * @internal\n */\nexport const integrityCheckTypeMap = {\n  checkDataColumns: {\n    name: \"Check Data Columns\",\n    resultType: \"CheckDataColumnsResultRow\",\n    sqlCommand: \"check_data_columns\",\n    sqlQuery: `PRAGMA integrity_check(check_data_columns) options enable_experimental_features`,\n  },\n  checkECProfile: {\n    name: \"Check EC Profile\",\n    resultType: \"CheckECProfileResultRow\",\n    sqlCommand: \"check_ec_profile\",\n    sqlQuery: `PRAGMA integrity_check(check_ec_profile) options enable_experimental_features`,\n  },\n  checkNavigationClassIds: {\n    name: \"Check Navigation Class Ids\",\n    resultType: \"CheckNavClassIdsResultRow\",\n    sqlCommand: \"check_nav_class_ids\",\n    sqlQuery: `PRAGMA integrity_check(check_nav_class_ids) options enable_experimental_features`,\n  },\n  checkNavigationIds: {\n    name: \"Check Navigation Ids\",\n    resultType: \"CheckNavIdsResultRow\",\n    sqlCommand: \"check_nav_ids\",\n    sqlQuery: `PRAGMA integrity_check(check_nav_ids) options enable_experimental_features`,\n  },\n  checkLinktableForeignKeyClassIds: {\n    name: \"Check Link Table Foreign Key Class Ids\",\n    resultType: \"CheckLinkTableFkClassIdsResultRow\",\n    sqlCommand: \"check_linktable_fk_class_ids\",\n    sqlQuery: `PRAGMA integrity_check(check_linktable_fk_class_ids) options enable_experimental_features`,\n  },\n  checkLinktableForeignKeyIds: {\n    name: \"Check Link Table Foreign Key Ids\",\n    resultType: \"CheckLinkTableFkIdsResultRow\",\n    sqlCommand: \"check_linktable_fk_ids\",\n    sqlQuery: `PRAGMA integrity_check(check_linktable_fk_ids) options enable_experimental_features`,\n  },\n  checkClassIds: {\n    name: \"Check Class Ids\",\n    resultType: \"CheckClassIdsResultRow\",\n    sqlCommand: \"check_class_ids\",\n    sqlQuery: `PRAGMA integrity_check(check_class_ids) options enable_experimental_features`,\n  },\n  checkDataSchema: {\n    name: \"Check Data Schema\",\n    resultType: \"CheckDataSchemaResultRow\",\n    sqlCommand: \"check_data_schema\",\n    sqlQuery: `PRAGMA integrity_check(check_data_schema) options enable_experimental_features`,\n  },\n  checkSchemaLoad: {\n    name: \"Check Schema Load\",\n    resultType: \"CheckSchemaLoadResultRow\",\n    sqlCommand: \"check_schema_load\",\n    sqlQuery: `PRAGMA integrity_check(check_schema_load) options enable_experimental_features`,\n  },\n  checkMissingChildRows: {\n    name: \"Check Missing Child Rows\",\n    resultType: \"CheckMissingChildRowsResultRow\",\n    sqlCommand: \"check_missing_child_rows\",\n    sqlQuery: `PRAGMA integrity_check(check_missing_child_rows) options enable_experimental_features`,\n  },\n} as const;\n\n/**\n * Type representing the keys of the integrityCheckType map, which correspond to the different types of integrity checks that can be performed.\n */\nexport type IntegrityCheckKey = keyof typeof integrityCheckTypeMap;\n\n/** Map of integrity check keys to their result row types */\ninterface IntegrityCheckResultTypeMap {\n  checkDataColumns: CheckDataColumnsResultRow;\n  checkECProfile: CheckECProfileResultRow;\n  checkNavigationClassIds: CheckNavClassIdsResultRow;\n  checkNavigationIds: CheckNavIdsResultRow;\n  checkLinktableForeignKeyClassIds: CheckLinkTableFkClassIdsResultRow;\n  checkLinktableForeignKeyIds: CheckLinkTableFkIdsResultRow;\n  checkClassIds: CheckClassIdsResultRow;\n  checkDataSchema: CheckDataSchemaResultRow;\n  checkSchemaLoad: CheckSchemaLoadResultRow;\n  checkMissingChildRows: CheckMissingChildRowsResultRow;\n}\n\n/** Checks the Map to give the return type of a specific integrity check */\ntype IntegrityCheckResultRow<K extends IntegrityCheckKey> = IntegrityCheckResultTypeMap[K];\n\n/**\n * Return type for quick integrity check\n */\nexport interface QuickIntegrityCheckResultRow {\n  check: string;\n  passed: boolean;\n  elapsedSeconds: string;\n}\n\n/**\n * Return type for Check Data Columns integrity check\n */\nexport interface CheckDataColumnsResultRow {\n  sno: number;\n  table: string;\n  column: string;\n}\n\n/**\n * Return type for Check EC Profile integrity check\n */\nexport interface CheckECProfileResultRow {\n  sno: number;\n  type: string;\n  name: string;\n  issue: string;\n}\n\n/**\n * Return type for Check Navigation Class Ids integrity check\n */\nexport interface CheckNavClassIdsResultRow {\n  sno: number;\n  id: string;\n  class: string;\n  property: string;\n  navId: string;\n  navClassId: string;\n}\n\n/**\n * Return type for Check Navigation Ids integrity check\n */\nexport interface CheckNavIdsResultRow {\n  sno: number;\n  id: string;\n  class: string;\n  property: string;\n  navId: string;\n  primaryClass: string;\n}\n\n/**\n * Return type for Check Link Table Foreign Key Class Ids integrity check\n */\nexport interface CheckLinkTableFkClassIdsResultRow {\n  sno: number;\n  id: string;\n  relationship: string;\n  property: string;\n  keyId: string;\n  keyClassId: string;\n}\n\n/**\n * Return type for Check Link Table Foreign Key Ids integrity check\n */\nexport interface CheckLinkTableFkIdsResultRow {\n  sno: number;\n  id: string;\n  relationship: string;\n  property: string;\n  keyId: string;\n  primaryClass: string;\n}\n\n/**\n * Return type for Check Class Ids integrity check\n */\nexport interface CheckClassIdsResultRow {\n  sno: number;\n  class: string;\n  id: string;\n  classId: string;\n  type: string;\n}\n\n/**\n * Return type for Check Data Schema integrity check\n */\nexport interface CheckDataSchemaResultRow {\n  sno: number;\n  type: string;\n  name: string;\n}\n\n/**\n * Return type for Check Schema Load integrity check\n */\nexport interface CheckSchemaLoadResultRow {\n  sno: number;\n  schema: string;\n}\n\n/**\n * Return type for Check Missing Child Rows integrity check\n */\nexport interface CheckMissingChildRowsResultRow {\n  sno: number;\n  class: string;\n  id: string;\n  classId: string;\n  missingRowInTables: string;\n}\n\n/**\n * Return type for integrity check results, including the check name, whether it passed, and the specific results (if any)\n */\nexport interface IntegrityCheckResult {\n  /** The name of the integrity check that was performed */\n  check: string;\n  /** Whether the integrity check passed (i.e. no issues were found = true) */\n  passed: boolean;\n  /** The specific results returned by the integrity check, which may include details about any issues that were found.\n   * In the case where issues are found, this will be an array of result rows specific to the type of check that was performed,\n   * or an array of quick integrity check results if it was a quick check. */\n  results: IntegrityCheckResultRow<IntegrityCheckKey>[] | QuickIntegrityCheckResultRow[];\n}\n\n/**\n * Gets the user-friendly name of an integrity check based on its key or SQL command.\n * It first attempts to find a direct match for the key in the integrityCheckTypeMap. If not found, it searches for a match based on the SQL command.\n * If still not found, it returns the original check string.\n * @param check - The integrity check key or SQL command to get the name of\n * @returns The user-friendly name of the integrity check, or the original check string if no match is found\n * @internal\n */\nexport function getIntegrityCheckName(check: string): string {\n  // First try direct lookup by key\n  const directLookup = integrityCheckTypeMap[check as IntegrityCheckKey];\n  if (directLookup) {\n    return directLookup.name;\n  }\n  // If not found, search by sqlCommand\n  for (const [, value] of Object.entries(integrityCheckTypeMap)) {\n    if (value.sqlCommand === check) {\n      return value.name;\n    }\n  }\n  // Fallback to the original check string\n  return check;\n}\n\n/**\n * Performs a quick integrity check on the given iModel.\n * @param iModel The IModelDb instance to perform the integrity check on\n * @returns An array of results for each check performed, including the check name, whether it passed, and the elapsed time in seconds\n * @internal\n */\nexport async function performQuickIntegrityCheck(iModel: IModelDb): Promise<QuickIntegrityCheckResultRow[]> {\n  const integrityCheckQuery = \"PRAGMA integrity_check options enable_experimental_features\";\n  const integrityCheckResults: QuickIntegrityCheckResultRow[] = [];\n  for await (const row of iModel.createQueryReader(integrityCheckQuery)) {\n    integrityCheckResults.push({ check: getIntegrityCheckName(row.check), passed: row.result, elapsedSeconds: row.elapsed_sec});\n  };\n  return integrityCheckResults;\n}\n\n/**\n * Performs a specific integrity check on the given iModel based on the provided check key, and returns the results specific to that check type.\n * @param iModel The IModelDb instance to perform the integrity check on\n * @param check The key of the specific integrity check to perform\n * @return An array of results specific to the integrity check that was performed. The type of the result rows will depend on the check that was executed.\n * @throws IModelError with status BadRequest if an unknown integrity check key is provided\n * @internal\n */\nexport async function performSpecificIntegrityCheck(iModel: IModelDb, check: \"checkDataColumns\"): Promise<IntegrityCheckResultRow<\"checkDataColumns\">[]>;\nexport async function performSpecificIntegrityCheck(iModel: IModelDb, check: \"checkECProfile\"): Promise<IntegrityCheckResultRow<\"checkECProfile\">[]>;\nexport async function performSpecificIntegrityCheck(iModel: IModelDb, check: \"checkNavigationClassIds\"): Promise<IntegrityCheckResultRow<\"checkNavigationClassIds\">[]>;\nexport async function performSpecificIntegrityCheck(iModel: IModelDb, check: \"checkNavigationIds\"): Promise<IntegrityCheckResultRow<\"checkNavigationIds\">[]>;\nexport async function performSpecificIntegrityCheck(iModel: IModelDb, check: \"checkLinktableForeignKeyClassIds\"): Promise<IntegrityCheckResultRow<\"checkLinktableForeignKeyClassIds\">[]>;\nexport async function performSpecificIntegrityCheck(iModel: IModelDb, check: \"checkLinktableForeignKeyIds\"): Promise<IntegrityCheckResultRow<\"checkLinktableForeignKeyIds\">[]>;\nexport async function performSpecificIntegrityCheck(iModel: IModelDb, check: \"checkClassIds\"): Promise<IntegrityCheckResultRow<\"checkClassIds\">[]>;\nexport async function performSpecificIntegrityCheck(iModel: IModelDb, check: \"checkDataSchema\"): Promise<IntegrityCheckResultRow<\"checkDataSchema\">[]>;\nexport async function performSpecificIntegrityCheck(iModel: IModelDb, check: \"checkSchemaLoad\"): Promise<IntegrityCheckResultRow<\"checkSchemaLoad\">[]>;\nexport async function performSpecificIntegrityCheck(iModel: IModelDb, check: \"checkMissingChildRows\"): Promise<IntegrityCheckResultRow<\"checkMissingChildRows\">[]>;\nexport async function performSpecificIntegrityCheck<K extends IntegrityCheckKey>(iModel: IModelDb, check: K): Promise<IntegrityCheckResultRow<K>[]>;\nexport async function performSpecificIntegrityCheck(iModel: IModelDb, check: IntegrityCheckKey): Promise<IntegrityCheckResultRow<IntegrityCheckKey>[]> {\n  switch (check) {\n    case \"checkDataColumns\": {\n      const results: CheckDataColumnsResultRow[] = [];\n      for await (const row of iModel.createQueryReader(integrityCheckTypeMap.checkDataColumns.sqlQuery)) {\n        results.push({ sno: row.sno, table: row.table, column: row.column });\n      }\n      return results;\n    }\n    case \"checkECProfile\": {\n      const results: CheckECProfileResultRow[] = [];\n      for await (const row of iModel.createQueryReader(integrityCheckTypeMap.checkECProfile.sqlQuery)) {\n        results.push({ sno: row.sno, type: row.type, name: row.name, issue: row.issue });\n      }\n      return results;\n    }\n    case \"checkNavigationClassIds\": {\n      const results: CheckNavClassIdsResultRow[] = [];\n      for await (const row of iModel.createQueryReader(integrityCheckTypeMap.checkNavigationClassIds.sqlQuery)) {\n        results.push({ sno: row.sno, id: row.id, class: row.class, property: row.property, navId: row.nav_id, navClassId: row.nav_classId });\n      }\n      return results;\n    }\n    case \"checkNavigationIds\": {\n      const results: CheckNavIdsResultRow[] = [];\n      for await (const row of iModel.createQueryReader(integrityCheckTypeMap.checkNavigationIds.sqlQuery)) {\n        results.push({ sno: row.sno, id: row.id, class: row.class, property: row.property, navId: row.nav_id, primaryClass: row.primary_class });\n      }\n      return results;\n    }\n    case \"checkLinktableForeignKeyClassIds\": {\n      const results: CheckLinkTableFkClassIdsResultRow[] = [];\n      for await (const row of iModel.createQueryReader(integrityCheckTypeMap.checkLinktableForeignKeyClassIds.sqlQuery)) {\n        results.push({ sno: row.sno, id: row.id, relationship: row.relationship, property: row.property, keyId: row.key_id, keyClassId: row.key_classId });\n      }\n      return results;\n    }\n    case \"checkLinktableForeignKeyIds\": {\n      const results: CheckLinkTableFkIdsResultRow[] = [];\n      for await (const row of iModel.createQueryReader(integrityCheckTypeMap.checkLinktableForeignKeyIds.sqlQuery)) {\n        results.push({ sno: row.sno, id: row.id, relationship: row.relationship, property: row.property, keyId: row.key_id, primaryClass: row.primary_class });\n      }\n      return results;\n    }\n    case \"checkClassIds\": {\n      const results: CheckClassIdsResultRow[] = [];\n      for await (const row of iModel.createQueryReader(integrityCheckTypeMap.checkClassIds.sqlQuery)) {\n        results.push({ sno: row.sno, class: row.class, id: row.id, classId: row.class_id, type: row.type });\n      }\n      return results;\n    }\n    case \"checkDataSchema\": {\n      const results: CheckDataSchemaResultRow[] = [];\n      for await (const row of iModel.createQueryReader(integrityCheckTypeMap.checkDataSchema.sqlQuery)) {\n        results.push({ sno: row.sno, type: row.type, name: row.name });\n      }\n      return results;\n    }\n    case \"checkSchemaLoad\": {\n      const results: CheckSchemaLoadResultRow[] = [];\n      for await (const row of iModel.createQueryReader(integrityCheckTypeMap.checkSchemaLoad.sqlQuery)) {\n        results.push({ sno: row.sno, schema: row.schema });\n      }\n      return results;\n    }\n    case \"checkMissingChildRows\": {\n      const results: CheckMissingChildRowsResultRow[] = [];\n      for await (const row of iModel.createQueryReader(integrityCheckTypeMap.checkMissingChildRows.sqlQuery)) {\n        results.push({ sno: row.sno, class: row.class, id: row.id, classId: row.class_id, missingRowInTables: row.MissingRowInTables });\n      }\n      return results;\n    }\n    default:\n      throw new IModelError(IModelStatus.BadRequest, `Unknown integrity check type`);\n  }\n}"]}
+{"version":3,"file":"IntegrityCheck.js","sourceRoot":"","sources":["../../../src/internal/IntegrityCheck.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\nimport { IModelStatus } from \"@itwin/core-bentley\";\nimport { IModelError } from \"@itwin/core-common\";\nimport { IModelDb } from \"../IModelDb\";\n\n/**\n * Information about each integrity check type, including the name, expected result type, and SQL query to execute\n * @internal\n */\nexport const integrityCheckTypeMap = {\n  checkDataColumns: {\n    name: \"Check Data Columns\",\n    resultType: \"CheckDataColumnsResultRow\",\n    sqlCommand: \"check_data_columns\",\n    sqlQuery: `PRAGMA integrity_check(check_data_columns) ECSQLOPTIONS ENABLE_EXPERIMENTAL_FEATURES`,\n  },\n  checkECProfile: {\n    name: \"Check EC Profile\",\n    resultType: \"CheckECProfileResultRow\",\n    sqlCommand: \"check_ec_profile\",\n    sqlQuery: `PRAGMA integrity_check(check_ec_profile) ECSQLOPTIONS ENABLE_EXPERIMENTAL_FEATURES`,\n  },\n  checkNavigationClassIds: {\n    name: \"Check Navigation Class Ids\",\n    resultType: \"CheckNavClassIdsResultRow\",\n    sqlCommand: \"check_nav_class_ids\",\n    sqlQuery: `PRAGMA integrity_check(check_nav_class_ids) ECSQLOPTIONS ENABLE_EXPERIMENTAL_FEATURES`,\n  },\n  checkNavigationIds: {\n    name: \"Check Navigation Ids\",\n    resultType: \"CheckNavIdsResultRow\",\n    sqlCommand: \"check_nav_ids\",\n    sqlQuery: `PRAGMA integrity_check(check_nav_ids) ECSQLOPTIONS ENABLE_EXPERIMENTAL_FEATURES`,\n  },\n  checkLinktableForeignKeyClassIds: {\n    name: \"Check Link Table Foreign Key Class Ids\",\n    resultType: \"CheckLinkTableFkClassIdsResultRow\",\n    sqlCommand: \"check_linktable_fk_class_ids\",\n    sqlQuery: `PRAGMA integrity_check(check_linktable_fk_class_ids) ECSQLOPTIONS ENABLE_EXPERIMENTAL_FEATURES`,\n  },\n  checkLinktableForeignKeyIds: {\n    name: \"Check Link Table Foreign Key Ids\",\n    resultType: \"CheckLinkTableFkIdsResultRow\",\n    sqlCommand: \"check_linktable_fk_ids\",\n    sqlQuery: `PRAGMA integrity_check(check_linktable_fk_ids) ECSQLOPTIONS ENABLE_EXPERIMENTAL_FEATURES`,\n  },\n  checkClassIds: {\n    name: \"Check Class Ids\",\n    resultType: \"CheckClassIdsResultRow\",\n    sqlCommand: \"check_class_ids\",\n    sqlQuery: `PRAGMA integrity_check(check_class_ids) ECSQLOPTIONS ENABLE_EXPERIMENTAL_FEATURES`,\n  },\n  checkDataSchema: {\n    name: \"Check Data Schema\",\n    resultType: \"CheckDataSchemaResultRow\",\n    sqlCommand: \"check_data_schema\",\n    sqlQuery: `PRAGMA integrity_check(check_data_schema) ECSQLOPTIONS ENABLE_EXPERIMENTAL_FEATURES`,\n  },\n  checkSchemaLoad: {\n    name: \"Check Schema Load\",\n    resultType: \"CheckSchemaLoadResultRow\",\n    sqlCommand: \"check_schema_load\",\n    sqlQuery: `PRAGMA integrity_check(check_schema_load) ECSQLOPTIONS ENABLE_EXPERIMENTAL_FEATURES`,\n  },\n  checkMissingChildRows: {\n    name: \"Check Missing Child Rows\",\n    resultType: \"CheckMissingChildRowsResultRow\",\n    sqlCommand: \"check_missing_child_rows\",\n    sqlQuery: `PRAGMA integrity_check(check_missing_child_rows) ECSQLOPTIONS ENABLE_EXPERIMENTAL_FEATURES`,\n  },\n} as const;\n\n/**\n * Type representing the keys of the integrityCheckType map, which correspond to the different types of integrity checks that can be performed.\n */\nexport type IntegrityCheckKey = keyof typeof integrityCheckTypeMap;\n\n/** Map of integrity check keys to their result row types */\ninterface IntegrityCheckResultTypeMap {\n  checkDataColumns: CheckDataColumnsResultRow;\n  checkECProfile: CheckECProfileResultRow;\n  checkNavigationClassIds: CheckNavClassIdsResultRow;\n  checkNavigationIds: CheckNavIdsResultRow;\n  checkLinktableForeignKeyClassIds: CheckLinkTableFkClassIdsResultRow;\n  checkLinktableForeignKeyIds: CheckLinkTableFkIdsResultRow;\n  checkClassIds: CheckClassIdsResultRow;\n  checkDataSchema: CheckDataSchemaResultRow;\n  checkSchemaLoad: CheckSchemaLoadResultRow;\n  checkMissingChildRows: CheckMissingChildRowsResultRow;\n}\n\n/** Checks the Map to give the return type of a specific integrity check */\ntype IntegrityCheckResultRow<K extends IntegrityCheckKey> = IntegrityCheckResultTypeMap[K];\n\n/**\n * Return type for quick integrity check\n */\nexport interface QuickIntegrityCheckResultRow {\n  check: string;\n  passed: boolean;\n  elapsedSeconds: string;\n}\n\n/**\n * Return type for Check Data Columns integrity check\n */\nexport interface CheckDataColumnsResultRow {\n  sno: number;\n  table: string;\n  column: string;\n}\n\n/**\n * Return type for Check EC Profile integrity check\n */\nexport interface CheckECProfileResultRow {\n  sno: number;\n  type: string;\n  name: string;\n  issue: string;\n}\n\n/**\n * Return type for Check Navigation Class Ids integrity check\n */\nexport interface CheckNavClassIdsResultRow {\n  sno: number;\n  id: string;\n  class: string;\n  property: string;\n  navId: string;\n  navClassId: string;\n}\n\n/**\n * Return type for Check Navigation Ids integrity check\n */\nexport interface CheckNavIdsResultRow {\n  sno: number;\n  id: string;\n  class: string;\n  property: string;\n  navId: string;\n  primaryClass: string;\n}\n\n/**\n * Return type for Check Link Table Foreign Key Class Ids integrity check\n */\nexport interface CheckLinkTableFkClassIdsResultRow {\n  sno: number;\n  id: string;\n  relationship: string;\n  property: string;\n  keyId: string;\n  keyClassId: string;\n}\n\n/**\n * Return type for Check Link Table Foreign Key Ids integrity check\n */\nexport interface CheckLinkTableFkIdsResultRow {\n  sno: number;\n  id: string;\n  relationship: string;\n  property: string;\n  keyId: string;\n  primaryClass: string;\n}\n\n/**\n * Return type for Check Class Ids integrity check\n */\nexport interface CheckClassIdsResultRow {\n  sno: number;\n  class: string;\n  id: string;\n  classId: string;\n  type: string;\n}\n\n/**\n * Return type for Check Data Schema integrity check\n */\nexport interface CheckDataSchemaResultRow {\n  sno: number;\n  type: string;\n  name: string;\n}\n\n/**\n * Return type for Check Schema Load integrity check\n */\nexport interface CheckSchemaLoadResultRow {\n  sno: number;\n  schema: string;\n}\n\n/**\n * Return type for Check Missing Child Rows integrity check\n */\nexport interface CheckMissingChildRowsResultRow {\n  sno: number;\n  class: string;\n  id: string;\n  classId: string;\n  missingRowInTables: string;\n}\n\n/**\n * Return type for integrity check results, including the check name, whether it passed, and the specific results (if any)\n */\nexport interface IntegrityCheckResult {\n  /** The name of the integrity check that was performed */\n  check: string;\n  /** Whether the integrity check passed (i.e. no issues were found = true) */\n  passed: boolean;\n  /** The specific results returned by the integrity check, which may include details about any issues that were found.\n   * In the case where issues are found, this will be an array of result rows specific to the type of check that was performed,\n   * or an array of quick integrity check results if it was a quick check. */\n  results: IntegrityCheckResultRow<IntegrityCheckKey>[] | QuickIntegrityCheckResultRow[];\n}\n\n/**\n * Gets the user-friendly name of an integrity check based on its key or SQL command.\n * It first attempts to find a direct match for the key in the integrityCheckTypeMap. If not found, it searches for a match based on the SQL command.\n * If still not found, it returns the original check string.\n * @param check - The integrity check key or SQL command to get the name of\n * @returns The user-friendly name of the integrity check, or the original check string if no match is found\n * @internal\n */\nexport function getIntegrityCheckName(check: string): string {\n  // First try direct lookup by key\n  const directLookup = integrityCheckTypeMap[check as IntegrityCheckKey];\n  if (directLookup) {\n    return directLookup.name;\n  }\n  // If not found, search by sqlCommand\n  for (const [, value] of Object.entries(integrityCheckTypeMap)) {\n    if (value.sqlCommand === check) {\n      return value.name;\n    }\n  }\n  // Fallback to the original check string\n  return check;\n}\n\n/**\n * Performs a quick integrity check on the given iModel.\n * @param iModel The IModelDb instance to perform the integrity check on\n * @returns An array of results for each check performed, including the check name, whether it passed, and the elapsed time in seconds\n * @internal\n */\nexport async function performQuickIntegrityCheck(iModel: IModelDb): Promise<QuickIntegrityCheckResultRow[]> {\n  const integrityCheckQuery = \"PRAGMA integrity_check ECSQLOPTIONS ENABLE_EXPERIMENTAL_FEATURES\";\n  const integrityCheckResults: QuickIntegrityCheckResultRow[] = [];\n  for await (const row of iModel.createQueryReader(integrityCheckQuery, undefined, { usePrimaryConn: true })) {\n    integrityCheckResults.push({ check: getIntegrityCheckName(row.check), passed: row.result, elapsedSeconds: row.elapsed_sec});\n  };\n  return integrityCheckResults;\n}\n\n/**\n * Performs a specific integrity check on the given iModel based on the provided check key, and returns the results specific to that check type.\n * @param iModel The IModelDb instance to perform the integrity check on\n * @param check The key of the specific integrity check to perform\n * @return An array of results specific to the integrity check that was performed. The type of the result rows will depend on the check that was executed.\n * @throws IModelError with status BadRequest if an unknown integrity check key is provided\n * @internal\n */\nexport async function performSpecificIntegrityCheck(iModel: IModelDb, check: \"checkDataColumns\"): Promise<IntegrityCheckResultRow<\"checkDataColumns\">[]>;\nexport async function performSpecificIntegrityCheck(iModel: IModelDb, check: \"checkECProfile\"): Promise<IntegrityCheckResultRow<\"checkECProfile\">[]>;\nexport async function performSpecificIntegrityCheck(iModel: IModelDb, check: \"checkNavigationClassIds\"): Promise<IntegrityCheckResultRow<\"checkNavigationClassIds\">[]>;\nexport async function performSpecificIntegrityCheck(iModel: IModelDb, check: \"checkNavigationIds\"): Promise<IntegrityCheckResultRow<\"checkNavigationIds\">[]>;\nexport async function performSpecificIntegrityCheck(iModel: IModelDb, check: \"checkLinktableForeignKeyClassIds\"): Promise<IntegrityCheckResultRow<\"checkLinktableForeignKeyClassIds\">[]>;\nexport async function performSpecificIntegrityCheck(iModel: IModelDb, check: \"checkLinktableForeignKeyIds\"): Promise<IntegrityCheckResultRow<\"checkLinktableForeignKeyIds\">[]>;\nexport async function performSpecificIntegrityCheck(iModel: IModelDb, check: \"checkClassIds\"): Promise<IntegrityCheckResultRow<\"checkClassIds\">[]>;\nexport async function performSpecificIntegrityCheck(iModel: IModelDb, check: \"checkDataSchema\"): Promise<IntegrityCheckResultRow<\"checkDataSchema\">[]>;\nexport async function performSpecificIntegrityCheck(iModel: IModelDb, check: \"checkSchemaLoad\"): Promise<IntegrityCheckResultRow<\"checkSchemaLoad\">[]>;\nexport async function performSpecificIntegrityCheck(iModel: IModelDb, check: \"checkMissingChildRows\"): Promise<IntegrityCheckResultRow<\"checkMissingChildRows\">[]>;\nexport async function performSpecificIntegrityCheck<K extends IntegrityCheckKey>(iModel: IModelDb, check: K): Promise<IntegrityCheckResultRow<K>[]>;\nexport async function performSpecificIntegrityCheck(iModel: IModelDb, check: IntegrityCheckKey): Promise<IntegrityCheckResultRow<IntegrityCheckKey>[]> {\n  switch (check) {\n    case \"checkDataColumns\": {\n      const results: CheckDataColumnsResultRow[] = [];\n      for await (const row of iModel.createQueryReader(integrityCheckTypeMap.checkDataColumns.sqlQuery, undefined, { usePrimaryConn: true })) {\n        results.push({ sno: row.sno, table: row.table, column: row.column });\n      }\n      return results;\n    }\n    case \"checkECProfile\": {\n      const results: CheckECProfileResultRow[] = [];\n      for await (const row of iModel.createQueryReader(integrityCheckTypeMap.checkECProfile.sqlQuery, undefined, { usePrimaryConn: true })) {\n        results.push({ sno: row.sno, type: row.type, name: row.name, issue: row.issue });\n      }\n      return results;\n    }\n    case \"checkNavigationClassIds\": {\n      const results: CheckNavClassIdsResultRow[] = [];\n      for await (const row of iModel.createQueryReader(integrityCheckTypeMap.checkNavigationClassIds.sqlQuery, undefined, { usePrimaryConn: true })) {\n        results.push({ sno: row.sno, id: row.id, class: row.class, property: row.property, navId: row.nav_id, navClassId: row.nav_classId });\n      }\n      return results;\n    }\n    case \"checkNavigationIds\": {\n      const results: CheckNavIdsResultRow[] = [];\n      for await (const row of iModel.createQueryReader(integrityCheckTypeMap.checkNavigationIds.sqlQuery, undefined, { usePrimaryConn: true })) {\n        results.push({ sno: row.sno, id: row.id, class: row.class, property: row.property, navId: row.nav_id, primaryClass: row.primary_class });\n      }\n      return results;\n    }\n    case \"checkLinktableForeignKeyClassIds\": {\n      const results: CheckLinkTableFkClassIdsResultRow[] = [];\n      for await (const row of iModel.createQueryReader(integrityCheckTypeMap.checkLinktableForeignKeyClassIds.sqlQuery, undefined, { usePrimaryConn: true })) {\n        results.push({ sno: row.sno, id: row.id, relationship: row.relationship, property: row.property, keyId: row.key_id, keyClassId: row.key_classId });\n      }\n      return results;\n    }\n    case \"checkLinktableForeignKeyIds\": {\n      const results: CheckLinkTableFkIdsResultRow[] = [];\n      for await (const row of iModel.createQueryReader(integrityCheckTypeMap.checkLinktableForeignKeyIds.sqlQuery, undefined, { usePrimaryConn: true })) {\n        results.push({ sno: row.sno, id: row.id, relationship: row.relationship, property: row.property, keyId: row.key_id, primaryClass: row.primary_class });\n      }\n      return results;\n    }\n    case \"checkClassIds\": {\n      const results: CheckClassIdsResultRow[] = [];\n      for await (const row of iModel.createQueryReader(integrityCheckTypeMap.checkClassIds.sqlQuery, undefined, { usePrimaryConn: true })) {\n        results.push({ sno: row.sno, class: row.class, id: row.id, classId: row.class_id, type: row.type });\n      }\n      return results;\n    }\n    case \"checkDataSchema\": {\n      const results: CheckDataSchemaResultRow[] = [];\n      for await (const row of iModel.createQueryReader(integrityCheckTypeMap.checkDataSchema.sqlQuery, undefined, { usePrimaryConn: true })) {\n        results.push({ sno: row.sno, type: row.type, name: row.name });\n      }\n      return results;\n    }\n    case \"checkSchemaLoad\": {\n      const results: CheckSchemaLoadResultRow[] = [];\n      for await (const row of iModel.createQueryReader(integrityCheckTypeMap.checkSchemaLoad.sqlQuery, undefined, { usePrimaryConn: true })) {\n        results.push({ sno: row.sno, schema: row.schema });\n      }\n      return results;\n    }\n    case \"checkMissingChildRows\": {\n      const results: CheckMissingChildRowsResultRow[] = [];\n      for await (const row of iModel.createQueryReader(integrityCheckTypeMap.checkMissingChildRows.sqlQuery, undefined, { usePrimaryConn: true })) {\n        results.push({ sno: row.sno, class: row.class, id: row.id, classId: row.class_id, missingRowInTables: row.MissingRowInTables });\n      }\n      return results;\n    }\n    default:\n      throw new IModelError(IModelStatus.BadRequest, `Unknown integrity check type`);\n  }\n}"]}

package/lib/esm/EditTxn.d.ts

@@ -97,6 +97,14 @@ export declare class EditTxn {
      * @throws [[ITwinError]] if deletion fails.
      */
     deleteElement(ids: Id64Arg): void;
+    /**
+     * Delete multiple elements from the iModel.
+     * @param ids The ids of the elements to delete. All ids must be well-formed and valid [[Id64String]]s.
+     * @returns A set of ids for any elements that could not be deleted.
+     * @throws [[ITwinError]] if any of the supplied ids are not well-formed/valid [[Id64String]]s.
+     * @beta
+     */
+    deleteElements(ids: Id64Array): Id64Set;
     /** Insert a new aspect into the iModel.
      * @param aspectProps The properties of the new aspect.
      * @returns The newly inserted aspect Id.

package/lib/esm/EditTxn.d.ts.map

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

package/lib/esm/EditTxn.js

@@ -5,7 +5,7 @@
 /** @packageDocumentation
  * @module iModels
  */
-import { DbResult, Id64, IModelStatus, OpenMode } from "@itwin/core-bentley";
+import { DbResult, Id64, IModelStatus, ITwinError, OpenMode } from "@itwin/core-bentley";
 import { EcefLocation, EditTxnError, IModelError } from "@itwin/core-common";
 import { Range3d } from "@itwin/core-geometry";
 import { _activeTxn, _cache, _instanceKeyCache, _nativeDb } from "./internal/Symbols";
@@ -194,6 +194,33 @@ export class EditTxn {
             }
         });
     }
+    /**
+     * Delete multiple elements from the iModel.
+     * @param ids The ids of the elements to delete. All ids must be well-formed and valid [[Id64String]]s.
+     * @returns A set of ids for any elements that could not be deleted.
+     * @throws [[ITwinError]] if any of the supplied ids are not well-formed/valid [[Id64String]]s.
+     * @beta
+     */
+    deleteElements(ids) {
+        this.verifyWriteable();
+        const invalidIds = new Set();
+        for (const id of ids) {
+            if (!Id64.isValidId64(id))
+                invalidIds.add(id);
+        }
+        if (invalidIds.size > 0) {
+            ITwinError.throwError({ message: `Invalid element ids: ${Array.from(invalidIds).join(", ")}`, iTwinErrorId: { scope: "imodel", key: "invalid-arguments" } });
+        }
+        const failedToDelete = this.iModel[_nativeDb].deleteElements(ids);
+        const failedToDeleteSet = failedToDelete ? Id64.toIdSet(failedToDelete) : new Set();
+        for (const id of ids) {
+            if (!failedToDeleteSet.has(id)) {
+                this.iModel.elements[_cache].delete({ id });
+                this.iModel.elements[_instanceKeyCache].deleteById(id);
+            }
+        }
+        return failedToDeleteSet;
+    }
     /** Insert a new aspect into the iModel.
      * @param aspectProps The properties of the new aspect.
      * @returns The newly inserted aspect Id.

package/lib/esm/EditTxn.js.map

@@ -1 +1 @@
-{"version":3,"file":"EditTxn.js","sourceRoot":"","sources":["../../src/EditTxn.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\n/** @packageDocumentation\n * @module iModels\n */\n\nimport { DbResult, Id64, Id64Arg, Id64Array, Id64Set, Id64String, IModelStatus, OpenMode } from \"@itwin/core-bentley\";\nimport { EcefLocation, EcefLocationProps, EditTxnError, ElementAspectProps, ElementProps, FilePropertyProps, IModelError, ModelProps, RelationshipProps, SaveChangesArgs } from \"@itwin/core-common\";\nimport { Range3d, Range3dProps } from \"@itwin/core-geometry\";\nimport type { CloudSqlite } from \"./CloudSqlite\";\nimport type { ImplicitWriteEnforcement } from \"./IModelHost\";\nimport type { IModelDb, InsertElementOptions, UpdateModelOptions } from \"./IModelDb\";\nimport type { SettingsContainer } from \"./workspace/Settings\";\nimport { _activeTxn, _cache, _instanceKeyCache, _nativeDb } from \"./internal/Symbols\";\n\n/**\n * Represents an explicit editing transaction for an iModel.\n *\n * An explicit EditTxn lets callers define a deliberate unit of work by choosing when editing\n * starts (`start`) and how it ends (`end()` / `end(\"save\")` or `end(\"abandon\")`). This avoids mixing\n * unrelated edits into one implicit unit of work and makes save/rollback boundaries explicit.\n *\n * Explicit EditTxn instances must be active before mutating operations are performed, regardless of enforcement level.\n * In other words, explicit transaction behavior is independent of `implicitWriteEnforcement`.\n *\n * @see [EditTxn transaction model and migration guidance]($docs/learning/backend/EditTxn.md)\n *\n * *During indirect changes (commit processing):* Use callback args (`indirectEditTxn`) in callbacks like\n * [[Relationship.onRootChangedArg]] and [[Relationship.onDeletedDependencyArg]] that fire during indirect processing.\n *\n * @beta\n */\nexport class EditTxn {\n  /** Controls how writes through the implicit transaction are handled.\n   *\n   * This does not relax activation requirements for explicit transactions: explicit EditTxn writes\n   * must always come from the active EditTxn.\n   *\n   * - `allow`: allow implicit writes for backwards compatibility, even while an explicit EditTxn is active.\n   * - `log`: allow implicit writes but log `implicit-txn-write-disallowed` errors.\n   * - `throw`: reject implicit writes with `implicit-txn-write-disallowed`.\n   *\n   * This is initialized from [[IModelHostOptions.implicitWriteEnforcement]] during [[IModelHost.startup]].\n   *\n   * Defaults to `allow` for backwards compatibility.\n   * @beta\n   */\n  public static implicitWriteEnforcement: ImplicitWriteEnforcement = \"allow\";\n\n  /** The iModel this EditTxn may modify. */\n  public readonly iModel: IModelDb;\n\n  /** Default description passed to [[saveChanges]] when saving this transaction. */\n  public description: string;\n\n  /** True if this transaction currently owns the iModel write surface. */\n  public get isActive(): boolean {\n    return this.iModel[_activeTxn] === this;\n  }\n\n  public constructor(iModel: IModelDb, description: string) {\n    this.iModel = iModel;\n    this.description = description;\n  }\n\n  public verifyWriteable(): void {\n    // Explicit transactions must always be active before writing.\n    if (!this.isActive)\n      EditTxnError.throwError(\"not-active\", \"EditTxn is not active\", this.iModel.key);\n  }\n\n  /** Start this EditTxn, making it the active transaction for the iModel.\n   * @throws EditTxnError if this EditTxn is already active, another EditTxn is already active, or if unsaved changes are present.\n   */\n  public start(): void {\n    if (this.isActive)\n      EditTxnError.throwError(\"already-active\", \"This EditTxn is already active\", this.iModel.key);\n\n    const activeTxn = this.iModel[_activeTxn];\n    if (undefined !== activeTxn)\n      EditTxnError.throwError(\"already-active\", \"Cannot start EditTxn while another EditTxn is active\", this.iModel.key, activeTxn.description);\n\n    if (this.iModel[_nativeDb].hasUnsavedChanges())\n      EditTxnError.throwError(\"unsaved-changes\", \"Cannot start a new EditTxn with unsaved changes\", this.iModel.key);\n\n    this.iModel[_activeTxn] = this;\n  }\n\n  /** End this EditTxn, either by saving or abandoning the changes.\n   * @param mode Whether to \"save\" or \"abandon\" the changes. Defaults to \"save\".\n   * @param args Save changes arguments when saving.\n   * @throws EditTxnError if this EditTxn is not active.\n   * @throws IModelError if saving changes fails.\n   */\n  public end(): void;\n  public end(mode: \"save\" | \"abandon\", args?: string | SaveChangesArgs): void;\n  public end(mode: \"save\" | \"abandon\" = \"save\", args?: string | SaveChangesArgs): void {\n    if (!this.isActive)\n      EditTxnError.throwError(\"not-active\", \"EditTxn is not active\", this.iModel.key);\n\n    if (mode === \"save\") {\n      this.saveChanges(args);\n    } else {\n      this.abandonChanges();\n    }\n    this.iModel[_activeTxn] = undefined;\n  }\n\n  /** Invoked when the owning iModel is closing.\n   * The base implementation commits unsaved changes. Subclasses may override to customize how\n   * their changes are handled before the iModel closes.\n   * @throws EditTxnError if this EditTxn is not active.\n   * @throws IModelError if saving on close fails.\n   */\n  public onClose(): void {\n    if (!this.iModel.isReadonly && this.iModel[_nativeDb].hasUnsavedChanges())\n      this.saveChanges();\n  }\n\n  /** Abandon database changes while keeping this EditTxn active.\n   * @throws EditTxnError if this EditTxn is not active.\n   */\n  public abandonChanges(): void {\n    this.verifyWriteable();\n    this.iModel.clearCaches({ instanceCachesOnly: true });\n    this.iModel[_nativeDb].abandonChanges();\n  }\n\n  /** Save changes with additional arguments.\n   * @param args Save changes arguments.\n   * @throws EditTxnError if this EditTxn is not active.\n   * @throws IModelError if the iModel is readonly, if indirect changes are active, or if the native save fails.\n   */\n  public saveChanges(args?: string | SaveChangesArgs): void {\n    this.verifyWriteable();\n    const iModel = this.iModel;\n    if (iModel.openMode === OpenMode.Readonly)\n      throw new IModelError(IModelStatus.ReadOnly, \"IModelDb was opened read-only\");\n\n    if (iModel.isBriefcaseDb() && iModel.txns.isIndirectChanges)\n      throw new IModelError(IModelStatus.BadRequest, \"Cannot save changes while in an indirect change scope\");\n\n    args ??= this.description;\n    const saveArgs = typeof args === \"string\" ? { description: args } : args;\n    const stat = iModel[_nativeDb].saveChanges(JSON.stringify(saveArgs));\n    if (DbResult.BE_SQLITE_ERROR_PropagateChangesFailed === stat)\n      throw new IModelError(stat, \"Could not save changes due to propagation failure.\");\n\n    if (DbResult.BE_SQLITE_OK !== stat)\n      throw new IModelError(stat, `Could not save changes (${saveArgs.description})`);\n  }\n\n  /** Insert a new element into the iModel.\n   * @param elProps The properties of the new element.\n   * @returns The newly inserted element's Id.\n   * @throws EditTxnError if this EditTxn is not active.\n   * @throws [[ITwinError]] if insertion fails.\n   */\n  public insertElement(elProps: ElementProps, options?: InsertElementOptions): Id64String {\n    this.verifyWriteable();\n    try {\n      this.iModel.elements[_cache].delete({\n        id: elProps.id,\n        federationGuid: elProps.federationGuid,\n        code: elProps.code,\n      });\n      return elProps.id = this.iModel[_nativeDb].insertElement(elProps, options);\n    } catch (err: any) {\n      err.message = `Error inserting element [${err.message}]`;\n      err.metadata = { elProps };\n      throw err;\n    }\n  }\n\n  /** Update an existing element in the iModel.\n   * @param elProps The properties to update.\n   * @throws EditTxnError if this EditTxn is not active.\n   * @throws [[ITwinError]] if update fails.\n   */\n  public updateElement<T extends ElementProps>(elProps: Partial<T>): void {\n    this.verifyWriteable();\n    try {\n      if (elProps.id) {\n        this.iModel.elements[_instanceKeyCache].deleteById(elProps.id);\n      } else {\n        this.iModel.elements[_instanceKeyCache].delete({\n          federationGuid: elProps.federationGuid,\n          code: elProps.code,\n        });\n      }\n      this.iModel.elements[_cache].delete({\n        id: elProps.id,\n        federationGuid: elProps.federationGuid,\n        code: elProps.code,\n      });\n      this.iModel[_nativeDb].updateElement(elProps);\n    } catch (err: any) {\n      err.message = `Error updating element [${err.message}], id: ${elProps.id}`;\n      err.metadata = { elProps };\n      throw err;\n    }\n  }\n\n  /** Delete elements from the iModel.\n   * @param ids The Ids of the elements to delete.\n   * @throws EditTxnError if this EditTxn is not active.\n   * @throws [[ITwinError]] if deletion fails.\n   */\n  public deleteElement(ids: Id64Arg): void {\n    this.verifyWriteable();\n    const iModel = this.iModel;\n    Id64.toIdSet(ids).forEach((id) => {\n      try {\n        this.iModel.elements[_cache].delete({ id });\n        this.iModel.elements[_instanceKeyCache].deleteById(id);\n        iModel[_nativeDb].deleteElement(id);\n      } catch (err: any) {\n        err.message = `Error deleting element [${err.message}], id: ${id}`;\n        err.metadata = { elementId: id };\n        throw err;\n      }\n    });\n  }\n\n  /** Insert a new aspect into the iModel.\n   * @param aspectProps The properties of the new aspect.\n   * @returns The newly inserted aspect Id.\n   * @throws EditTxnError if this EditTxn is not active.\n   * @throws IModelError if insertion fails.\n   */\n  public insertAspect(aspectProps: ElementAspectProps): Id64String {\n    this.verifyWriteable();\n    try {\n      return this.iModel[_nativeDb].insertElementAspect(aspectProps);\n    } catch (err: any) {\n      const error = new IModelError(err.errorNumber, `Error inserting ElementAspect [${err.message}], class: ${aspectProps.classFullName}`, aspectProps);\n      error.cause = err;\n      throw error;\n    }\n  }\n\n  /** Update an existing aspect in the iModel.\n   * @param aspectProps The properties of the aspect to update.\n   * @throws EditTxnError if this EditTxn is not active.\n   * @throws IModelError if update fails.\n   */\n  public updateAspect(aspectProps: ElementAspectProps): void {\n    this.verifyWriteable();\n    try {\n      this.iModel[_nativeDb].updateElementAspect(aspectProps);\n    } catch (err: any) {\n      const error = new IModelError(err.errorNumber, `Error updating ElementAspect [${err.message}], id: ${aspectProps.id}`, aspectProps);\n      error.cause = err;\n      throw error;\n    }\n  }\n\n  /** Delete one or more aspects from the iModel.\n   * @param aspectInstanceIds The Ids of the aspects to delete.\n   * @throws EditTxnError if this EditTxn is not active.\n   * @throws IModelError if deletion fails.\n   */\n  public deleteAspect(aspectInstanceIds: Id64Arg): void {\n    this.verifyWriteable();\n    Id64.toIdSet(aspectInstanceIds).forEach((aspectInstanceId) => {\n      try {\n        this.iModel[_nativeDb].deleteElementAspect(aspectInstanceId);\n      } catch (err: any) {\n        const error = new IModelError(err.errorNumber, `Error deleting ElementAspect [${err.message}], id: ${aspectInstanceId}`);\n        error.cause = err;\n        throw error;\n      }\n    });\n  }\n\n  /** Delete definition elements from the iModel when they are not referenced.\n   * @param definitionElementIds The Ids of the definition elements to attempt to delete.\n   * @returns The set of definition elements that were still in use and therefore not deleted.\n   * @throws EditTxnError if this EditTxn is not active.\n   * @throws IModelError if usage queries fail.\n   */\n  public deleteDefinitionElements(definitionElementIds: Id64Array): Id64Set {\n    this.verifyWriteable();\n    const usageInfo = this.iModel[_nativeDb].queryDefinitionElementUsage(definitionElementIds);\n    if (!usageInfo)\n      throw new IModelError(IModelStatus.BadRequest, \"Error querying for DefinitionElement usage\");\n\n    const usedIdSet = usageInfo.usedIds ? Id64.toIdSet(usageInfo.usedIds) : new Set<Id64String>();\n    const deleteIfUnused = (ids: Id64Array | undefined, used: Id64Set): void => {\n      ids?.forEach((id) => {\n        if (!used.has(id))\n          this.deleteElement(id);\n      });\n    };\n\n    try {\n      this.iModel[_nativeDb].beginPurgeOperation();\n      deleteIfUnused(usageInfo.spatialCategoryIds, usedIdSet);\n      deleteIfUnused(usageInfo.drawingCategoryIds, usedIdSet);\n      deleteIfUnused(usageInfo.viewDefinitionIds, usedIdSet);\n      deleteIfUnused(usageInfo.geometryPartIds, usedIdSet);\n      deleteIfUnused(usageInfo.lineStyleIds, usedIdSet);\n      deleteIfUnused(usageInfo.renderMaterialIds, usedIdSet);\n      deleteIfUnused(usageInfo.subCategoryIds, usedIdSet);\n      deleteIfUnused(usageInfo.textureIds, usedIdSet);\n      deleteIfUnused(usageInfo.displayStyleIds, usedIdSet);\n      deleteIfUnused(usageInfo.categorySelectorIds, usedIdSet);\n      deleteIfUnused(usageInfo.modelSelectorIds, usedIdSet);\n      if (usageInfo.otherDefinitionElementIds)\n        this.deleteElement(usageInfo.otherDefinitionElementIds);\n    } finally {\n      this.iModel[_nativeDb].endPurgeOperation();\n    }\n\n    if (usageInfo.viewDefinitionIds) {\n      // Recheck view-related definitions after deleting view definitions that may have been their last reference.\n      let viewRelatedIds: Id64Array = [];\n      if (usageInfo.displayStyleIds)\n        viewRelatedIds = viewRelatedIds.concat(usageInfo.displayStyleIds.filter((id) => usedIdSet.has(id)));\n\n      if (usageInfo.categorySelectorIds)\n        viewRelatedIds = viewRelatedIds.concat(usageInfo.categorySelectorIds.filter((id) => usedIdSet.has(id)));\n\n      if (usageInfo.modelSelectorIds)\n        viewRelatedIds = viewRelatedIds.concat(usageInfo.modelSelectorIds.filter((id) => usedIdSet.has(id)));\n\n      if (viewRelatedIds.length > 0) {\n        const viewRelatedUsageInfo = this.iModel[_nativeDb].queryDefinitionElementUsage(viewRelatedIds);\n        if (viewRelatedUsageInfo) {\n          const usedViewRelatedIdSet: Id64Set = viewRelatedUsageInfo.usedIds ? Id64.toIdSet(viewRelatedUsageInfo.usedIds) : new Set<Id64String>();\n          try {\n            this.iModel[_nativeDb].beginPurgeOperation();\n            deleteIfUnused(viewRelatedUsageInfo.displayStyleIds, usedViewRelatedIdSet);\n            deleteIfUnused(viewRelatedUsageInfo.categorySelectorIds, usedViewRelatedIdSet);\n            deleteIfUnused(viewRelatedUsageInfo.modelSelectorIds, usedViewRelatedIdSet);\n          } finally {\n            this.iModel[_nativeDb].endPurgeOperation();\n          }\n\n          viewRelatedIds.forEach((id) => {\n            if (!usedViewRelatedIdSet.has(id))\n              usedIdSet.delete(id);\n          });\n        }\n      }\n    }\n\n    return usedIdSet;\n  }\n\n  /** Insert a new model into the iModel.\n   * @param props The data for the new model.\n   * @returns The newly inserted model's Id.\n   * @throws EditTxnError if this EditTxn is not active.\n   * @throws IModelError if insertion fails.\n   */\n  public insertModel(props: ModelProps): Id64String {\n    this.verifyWriteable();\n    try {\n      return props.id = this.iModel[_nativeDb].insertModel(props);\n    } catch (err: any) {\n      const error = new IModelError(err.errorNumber, `Error inserting model [${err.message}], class=${props.classFullName}`);\n      error.cause = err;\n      throw error;\n    }\n  }\n\n  /** Update an existing model in the iModel.\n   * @param props the properties of the model to change\n   * @throws EditTxnError if this EditTxn is not active.\n   * @throws IModelError if update fails.\n   */\n  public updateModel(props: UpdateModelOptions): void {\n    this.verifyWriteable();\n    try {\n      if (props.id)\n        this.iModel.models[_cache].delete(props.id);\n\n      this.iModel[_nativeDb].updateModel(props);\n    } catch (err: any) {\n      const error = new IModelError(err.errorNumber, `Error updating model [${err.message}], id: ${props.id}`);\n      error.cause = err;\n      throw error;\n    }\n  }\n\n  /** Update the geometry guid of a model.\n   * @param modelId The Id of the model to update.\n   * @throws EditTxnError if this EditTxn is not active.\n   * @throws IModelError if the update fails.\n   */\n  public updateGeometryGuid(modelId: Id64String): void {\n    this.verifyWriteable();\n    this.iModel.models[_cache].delete(modelId);\n    const error = this.iModel[_nativeDb].updateModelGeometryGuid(modelId);\n    if (error !== IModelStatus.Success)\n      throw new IModelError(error, `Error updating geometry guid for model ${modelId}`);\n  }\n\n  /** Delete models from the iModel.\n   * @param ids The Ids of the models to delete.\n   * @throws EditTxnError if this EditTxn is not active.\n   * @throws IModelError if deletion fails.\n   */\n  public deleteModel(ids: Id64Arg): void {\n    this.verifyWriteable();\n    Id64.toIdSet(ids).forEach((id) => {\n      try {\n        this.iModel.models[_cache].delete(id);\n        this.iModel.models[_instanceKeyCache].deleteById(id);\n        this.iModel[_nativeDb].deleteModel(id);\n      } catch (err: any) {\n        const error = new IModelError(err.errorNumber, `Error deleting model [${err.message}], id: ${id}`);\n        error.cause = err;\n        throw error;\n      }\n    });\n  }\n\n  /** Insert a new relationship into the iModel.\n   * @param props The properties of the new relationship.\n   * @returns The Id of the newly inserted relationship.\n   * @throws EditTxnError if this EditTxn is not active.\n   * @throws IModelError if the class is invalid for link-table insertion.\n   */\n  public insertRelationship(props: RelationshipProps): Id64String {\n    this.verifyWriteable();\n    if (!this.iModel[_nativeDb].isLinkTableRelationship(props.classFullName.replace(\".\", \":\")))\n      throw new IModelError(DbResult.BE_SQLITE_ERROR, `Class '${props.classFullName}' must be a relationship class and it should be subclass of BisCore:ElementRefersToElements or BisCore:ElementDrivesElement.`);\n\n    return props.id = this.iModel[_nativeDb].insertLinkTableRelationship(props);\n  }\n\n  /** Update an existing relationship in the iModel.\n   * @param props the properties of the relationship to update.\n   * @throws EditTxnError if this EditTxn is not active.\n   */\n  public updateRelationship(props: RelationshipProps): void {\n    this.verifyWriteable();\n    this.iModel[_nativeDb].updateLinkTableRelationship(props);\n  }\n\n  /** Delete a relationship from the iModel.\n   * @param props The properties of the relationship to delete.\n   * @throws EditTxnError if this EditTxn is not active.\n   */\n  public deleteRelationship(props: RelationshipProps): void {\n    this.verifyWriteable();\n    this.iModel[_nativeDb].deleteLinkTableRelationship(props);\n  }\n\n  /** Delete multiple relationships from the iModel.\n   * @param props The properties of the relationships to delete.\n   * @throws EditTxnError if this EditTxn is not active.\n   */\n  public deleteRelationships(props: ReadonlyArray<RelationshipProps>): void {\n    this.verifyWriteable();\n    this.iModel[_nativeDb].deleteLinkTableRelationships(props);\n  }\n\n\n  /** Save a file property to the iModel.\n   * @param prop The file property to save.\n   * @param strValue String value.\n   * @param blobVal Blob value.\n   * @throws EditTxnError if this EditTxn is not active.\n   */\n  public saveFileProperty(prop: FilePropertyProps, strValue: string | undefined, blobVal?: Uint8Array): void {\n    this.verifyWriteable();\n    const imodel = this.iModel;\n    if (imodel.isBriefcaseDb()) {\n      if (imodel.txns.isIndirectChanges) {\n        throw new IModelError(IModelStatus.BadRequest, \"Cannot save file property while in an indirect change scope\");\n      }\n    }\n    imodel[_nativeDb].saveFileProperty(prop, strValue, blobVal);\n  }\n\n  /** Delete a file property from the iModel.\n   * @param prop The file property to delete.\n   * @throws EditTxnError if this EditTxn is not active.\n   */\n  public deleteFileProperty(prop: FilePropertyProps): void {\n    this.saveFileProperty(prop, undefined, undefined);\n  }\n\n  /** Update the project extents of the iModel.\n   * @param newExtents The new project extents.\n   * @throws EditTxnError if this EditTxn is not active.\n   * @throws IModelError if extents are invalid.\n   */\n  public updateProjectExtents(newExtents: Range3dProps): void {\n    this.verifyWriteable();\n    const extents = Range3d.fromJSON(newExtents);\n    if (extents.isNull)\n      throw new IModelError(DbResult.BE_SQLITE_ERROR, \"Invalid project extents\");\n\n    this.iModel.projectExtents = extents;\n    this.updateIModelProps();\n  }\n\n  /** Update the ECEF location of the iModel.\n   * @param ecef The new ECEF location.\n   * @throws EditTxnError if this EditTxn is not active.\n   */\n  public updateEcefLocation(ecef: EcefLocationProps): void {\n    this.verifyWriteable();\n    this.iModel.setEcefLocation(new EcefLocation(ecef));\n    this.updateIModelProps();\n  }\n\n  /** Update the iModel props in the database from the current in-memory state.\n   * @throws EditTxnError if this EditTxn is not active.\n   */\n  public updateIModelProps(): void {\n    this.verifyWriteable();\n    this.iModel[_nativeDb].updateIModelProps(this.iModel.toJSON());\n  }\n\n  private static readonly _settingPropNamespace = \"settings\";\n  private static readonly _viewStoreProperty: FilePropertyProps = { namespace: \"itwinjs\", name: \"DefaultViewStore\" };\n\n  /** Save a `SettingDictionary` in this iModel.\n   * @param name The name for the SettingDictionary. If a dictionary by that name already exists, its value is replaced.\n   * @param dict The SettingDictionary object to stringify and save.\n   * @throws EditTxnError if this EditTxn is not active.\n   * @beta\n   */\n  public saveSettingDictionary(name: string, dict: SettingsContainer): void {\n    this.verifyWriteable();\n    this.iModel.withSqliteStatement(\"REPLACE INTO be_Prop(id,SubId,TxnMode,Namespace,Name,strData) VALUES(0,0,0,?,?,?)\", (stmt) => {\n      stmt.bindString(1, EditTxn._settingPropNamespace);\n      stmt.bindString(2, name);\n      stmt.bindString(3, JSON.stringify(dict));\n      stmt.stepForWrite();\n    });\n    this.saveChanges(\"add settings\");\n  }\n\n  /** Delete a SettingDictionary from this iModel.\n   * @param name The name of the dictionary to delete.\n   * @throws EditTxnError if this EditTxn is not active.\n   * @beta\n   */\n  public deleteSettingDictionary(name: string): void {\n    this.verifyWriteable();\n    this.iModel.withSqliteStatement(\"DELETE FROM be_Prop WHERE Namespace=? AND Name=?\", (stmt) => {\n      stmt.bindString(1, EditTxn._settingPropNamespace);\n      stmt.bindString(2, name);\n      stmt.stepForWrite();\n    });\n    this.saveChanges(\"delete settings\");\n  }\n\n  /** Save a default ViewStore container reference in this iModel.\n   * @param arg The cloud container properties for the ViewStore.\n   * @throws EditTxnError if this EditTxn is not active.\n   * @beta\n   */\n  public saveDefaultViewStore(arg: CloudSqlite.ContainerProps): void {\n    this.verifyWriteable();\n    const props = { baseUri: arg.baseUri, containerId: arg.containerId, storageType: arg.storageType }; // sanitize to only known properties\n    this.saveFileProperty(EditTxn._viewStoreProperty, JSON.stringify(props));\n    this.saveChanges(\"update default ViewStore\");\n  }\n}\n\n/** Execute a callback within an explicit editing transaction. A new [[EditTxn]] is created, started,\n * and passed to `fn`. If `fn` returns normally (or its returned Promise resolves), the transaction\n * is committed. If `fn` throws (or its returned Promise rejects), the transaction is abandoned —\n * none of the changes made during the callback are saved — and the error is re-thrown.\n *\n * This is the recommended way to perform a scoped unit of work on an iModel. It ensures that\n * edits are committed atomically on success and rolled back on failure, without the caller needing\n * to manage `start` / `end` manually.\n *\n * @param iModel The iModel to edit.\n * @param fn A callback that receives the active [[EditTxn]] and performs edits.\n * @returns The value returned by `fn`.\n * @throws EditTxnError if the transaction cannot be started (e.g. unsaved changes or another EditTxn is active).\n * @throws Re-throws any error thrown by `fn` after abandoning the transaction.\n * @beta\n */\nexport function withEditTxn<T>(iModel: IModelDb, fn: (txn: EditTxn) => T): T;\n/** Execute a callback within an explicit editing transaction, supplying commit arguments.\n * @param iModel The iModel to edit.\n * @param saveArgs Description or structured arguments passed to [[EditTxn.saveChanges]] on save.\n * @param fn A callback that receives the active [[EditTxn]] and performs edits.\n * @returns The value returned by `fn`.\n * @beta\n */\nexport function withEditTxn<T>(iModel: IModelDb, saveArgs: string | SaveChangesArgs, fn: (txn: EditTxn) => T): T;\n/** Execute an async callback within an explicit editing transaction.\n * @param iModel The iModel to edit.\n * @param fn An async callback that receives the active [[EditTxn]] and performs edits.\n * @returns A Promise that resolves to the value returned by `fn`.\n * @beta\n */\nexport function withEditTxn<T>(iModel: IModelDb, fn: (txn: EditTxn) => Promise<T>): Promise<T>;\n/** Execute an async callback within an explicit editing transaction, supplying commit arguments.\n * @param iModel The iModel to edit.\n * @param saveArgs Description or structured arguments passed to [[EditTxn.saveChanges]] on save.\n * @param fn An async callback that receives the active [[EditTxn]] and performs edits.\n * @returns A Promise that resolves to the value returned by `fn`.\n * @beta\n */\nexport function withEditTxn<T>(iModel: IModelDb, saveArgs: string | SaveChangesArgs, fn: (txn: EditTxn) => Promise<T>): Promise<T>;\nexport function withEditTxn<T>(iModel: IModelDb, saveArgsOrFn: string | SaveChangesArgs | ((txn: EditTxn) => T | Promise<T>), maybeFn?: (txn: EditTxn) => T | Promise<T>): T | Promise<T> {\n  const saveArgs = \"function\" === typeof saveArgsOrFn ? undefined : saveArgsOrFn;\n  const fn = \"function\" === typeof saveArgsOrFn ? saveArgsOrFn : maybeFn;\n\n  if (undefined === fn)\n    throw new Error(\"withEditTxn requires a callback\");\n\n  const txn = new EditTxn(iModel, \"\");\n  txn.start();\n\n  try {\n    const result = fn(txn);\n    if (result instanceof Promise) {\n      return result.then((value) => {\n        txn.end(\"save\", saveArgs);\n        return value;\n      }, (err) => {\n        if (txn.isActive)\n          txn.end(\"abandon\");\n\n        throw err;\n      });\n    }\n\n    txn.end(\"save\", saveArgs);\n    return result;\n  } catch (err) {\n    if (txn.isActive)\n      txn.end(\"abandon\");\n\n    throw err;\n  }\n}\n"]}
+{"version":3,"file":"EditTxn.js","sourceRoot":"","sources":["../../src/EditTxn.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\n/** @packageDocumentation\n * @module iModels\n */\n\nimport { DbResult, Id64, Id64Arg, Id64Array, Id64Set, Id64String, IModelStatus, ITwinError, OpenMode } from \"@itwin/core-bentley\";\nimport { EcefLocation, EcefLocationProps, EditTxnError, ElementAspectProps, ElementProps, FilePropertyProps, IModelError, ModelProps, RelationshipProps, SaveChangesArgs } from \"@itwin/core-common\";\nimport { Range3d, Range3dProps } from \"@itwin/core-geometry\";\nimport type { CloudSqlite } from \"./CloudSqlite\";\nimport type { ImplicitWriteEnforcement } from \"./IModelHost\";\nimport type { IModelDb, InsertElementOptions, UpdateModelOptions } from \"./IModelDb\";\nimport type { SettingsContainer } from \"./workspace/Settings\";\nimport { _activeTxn, _cache, _instanceKeyCache, _nativeDb } from \"./internal/Symbols\";\n\n/**\n * Represents an explicit editing transaction for an iModel.\n *\n * An explicit EditTxn lets callers define a deliberate unit of work by choosing when editing\n * starts (`start`) and how it ends (`end()` / `end(\"save\")` or `end(\"abandon\")`). This avoids mixing\n * unrelated edits into one implicit unit of work and makes save/rollback boundaries explicit.\n *\n * Explicit EditTxn instances must be active before mutating operations are performed, regardless of enforcement level.\n * In other words, explicit transaction behavior is independent of `implicitWriteEnforcement`.\n *\n * @see [EditTxn transaction model and migration guidance]($docs/learning/backend/EditTxn.md)\n *\n * *During indirect changes (commit processing):* Use callback args (`indirectEditTxn`) in callbacks like\n * [[Relationship.onRootChangedArg]] and [[Relationship.onDeletedDependencyArg]] that fire during indirect processing.\n *\n * @beta\n */\nexport class EditTxn {\n  /** Controls how writes through the implicit transaction are handled.\n   *\n   * This does not relax activation requirements for explicit transactions: explicit EditTxn writes\n   * must always come from the active EditTxn.\n   *\n   * - `allow`: allow implicit writes for backwards compatibility, even while an explicit EditTxn is active.\n   * - `log`: allow implicit writes but log `implicit-txn-write-disallowed` errors.\n   * - `throw`: reject implicit writes with `implicit-txn-write-disallowed`.\n   *\n   * This is initialized from [[IModelHostOptions.implicitWriteEnforcement]] during [[IModelHost.startup]].\n   *\n   * Defaults to `allow` for backwards compatibility.\n   * @beta\n   */\n  public static implicitWriteEnforcement: ImplicitWriteEnforcement = \"allow\";\n\n  /** The iModel this EditTxn may modify. */\n  public readonly iModel: IModelDb;\n\n  /** Default description passed to [[saveChanges]] when saving this transaction. */\n  public description: string;\n\n  /** True if this transaction currently owns the iModel write surface. */\n  public get isActive(): boolean {\n    return this.iModel[_activeTxn] === this;\n  }\n\n  public constructor(iModel: IModelDb, description: string) {\n    this.iModel = iModel;\n    this.description = description;\n  }\n\n  public verifyWriteable(): void {\n    // Explicit transactions must always be active before writing.\n    if (!this.isActive)\n      EditTxnError.throwError(\"not-active\", \"EditTxn is not active\", this.iModel.key);\n  }\n\n  /** Start this EditTxn, making it the active transaction for the iModel.\n   * @throws EditTxnError if this EditTxn is already active, another EditTxn is already active, or if unsaved changes are present.\n   */\n  public start(): void {\n    if (this.isActive)\n      EditTxnError.throwError(\"already-active\", \"This EditTxn is already active\", this.iModel.key);\n\n    const activeTxn = this.iModel[_activeTxn];\n    if (undefined !== activeTxn)\n      EditTxnError.throwError(\"already-active\", \"Cannot start EditTxn while another EditTxn is active\", this.iModel.key, activeTxn.description);\n\n    if (this.iModel[_nativeDb].hasUnsavedChanges())\n      EditTxnError.throwError(\"unsaved-changes\", \"Cannot start a new EditTxn with unsaved changes\", this.iModel.key);\n\n    this.iModel[_activeTxn] = this;\n  }\n\n  /** End this EditTxn, either by saving or abandoning the changes.\n   * @param mode Whether to \"save\" or \"abandon\" the changes. Defaults to \"save\".\n   * @param args Save changes arguments when saving.\n   * @throws EditTxnError if this EditTxn is not active.\n   * @throws IModelError if saving changes fails.\n   */\n  public end(): void;\n  public end(mode: \"save\" | \"abandon\", args?: string | SaveChangesArgs): void;\n  public end(mode: \"save\" | \"abandon\" = \"save\", args?: string | SaveChangesArgs): void {\n    if (!this.isActive)\n      EditTxnError.throwError(\"not-active\", \"EditTxn is not active\", this.iModel.key);\n\n    if (mode === \"save\") {\n      this.saveChanges(args);\n    } else {\n      this.abandonChanges();\n    }\n    this.iModel[_activeTxn] = undefined;\n  }\n\n  /** Invoked when the owning iModel is closing.\n   * The base implementation commits unsaved changes. Subclasses may override to customize how\n   * their changes are handled before the iModel closes.\n   * @throws EditTxnError if this EditTxn is not active.\n   * @throws IModelError if saving on close fails.\n   */\n  public onClose(): void {\n    if (!this.iModel.isReadonly && this.iModel[_nativeDb].hasUnsavedChanges())\n      this.saveChanges();\n  }\n\n  /** Abandon database changes while keeping this EditTxn active.\n   * @throws EditTxnError if this EditTxn is not active.\n   */\n  public abandonChanges(): void {\n    this.verifyWriteable();\n    this.iModel.clearCaches({ instanceCachesOnly: true });\n    this.iModel[_nativeDb].abandonChanges();\n  }\n\n  /** Save changes with additional arguments.\n   * @param args Save changes arguments.\n   * @throws EditTxnError if this EditTxn is not active.\n   * @throws IModelError if the iModel is readonly, if indirect changes are active, or if the native save fails.\n   */\n  public saveChanges(args?: string | SaveChangesArgs): void {\n    this.verifyWriteable();\n    const iModel = this.iModel;\n    if (iModel.openMode === OpenMode.Readonly)\n      throw new IModelError(IModelStatus.ReadOnly, \"IModelDb was opened read-only\");\n\n    if (iModel.isBriefcaseDb() && iModel.txns.isIndirectChanges)\n      throw new IModelError(IModelStatus.BadRequest, \"Cannot save changes while in an indirect change scope\");\n\n    args ??= this.description;\n    const saveArgs = typeof args === \"string\" ? { description: args } : args;\n    const stat = iModel[_nativeDb].saveChanges(JSON.stringify(saveArgs));\n    if (DbResult.BE_SQLITE_ERROR_PropagateChangesFailed === stat)\n      throw new IModelError(stat, \"Could not save changes due to propagation failure.\");\n\n    if (DbResult.BE_SQLITE_OK !== stat)\n      throw new IModelError(stat, `Could not save changes (${saveArgs.description})`);\n  }\n\n  /** Insert a new element into the iModel.\n   * @param elProps The properties of the new element.\n   * @returns The newly inserted element's Id.\n   * @throws EditTxnError if this EditTxn is not active.\n   * @throws [[ITwinError]] if insertion fails.\n   */\n  public insertElement(elProps: ElementProps, options?: InsertElementOptions): Id64String {\n    this.verifyWriteable();\n    try {\n      this.iModel.elements[_cache].delete({\n        id: elProps.id,\n        federationGuid: elProps.federationGuid,\n        code: elProps.code,\n      });\n      return elProps.id = this.iModel[_nativeDb].insertElement(elProps, options);\n    } catch (err: any) {\n      err.message = `Error inserting element [${err.message}]`;\n      err.metadata = { elProps };\n      throw err;\n    }\n  }\n\n  /** Update an existing element in the iModel.\n   * @param elProps The properties to update.\n   * @throws EditTxnError if this EditTxn is not active.\n   * @throws [[ITwinError]] if update fails.\n   */\n  public updateElement<T extends ElementProps>(elProps: Partial<T>): void {\n    this.verifyWriteable();\n    try {\n      if (elProps.id) {\n        this.iModel.elements[_instanceKeyCache].deleteById(elProps.id);\n      } else {\n        this.iModel.elements[_instanceKeyCache].delete({\n          federationGuid: elProps.federationGuid,\n          code: elProps.code,\n        });\n      }\n      this.iModel.elements[_cache].delete({\n        id: elProps.id,\n        federationGuid: elProps.federationGuid,\n        code: elProps.code,\n      });\n      this.iModel[_nativeDb].updateElement(elProps);\n    } catch (err: any) {\n      err.message = `Error updating element [${err.message}], id: ${elProps.id}`;\n      err.metadata = { elProps };\n      throw err;\n    }\n  }\n\n  /** Delete elements from the iModel.\n   * @param ids The Ids of the elements to delete.\n   * @throws EditTxnError if this EditTxn is not active.\n   * @throws [[ITwinError]] if deletion fails.\n   */\n  public deleteElement(ids: Id64Arg): void {\n    this.verifyWriteable();\n    const iModel = this.iModel;\n    Id64.toIdSet(ids).forEach((id) => {\n      try {\n        this.iModel.elements[_cache].delete({ id });\n        this.iModel.elements[_instanceKeyCache].deleteById(id);\n        iModel[_nativeDb].deleteElement(id);\n      } catch (err: any) {\n        err.message = `Error deleting element [${err.message}], id: ${id}`;\n        err.metadata = { elementId: id };\n        throw err;\n      }\n    });\n  }\n\n  /**\n   * Delete multiple elements from the iModel.\n   * @param ids The ids of the elements to delete. All ids must be well-formed and valid [[Id64String]]s.\n   * @returns A set of ids for any elements that could not be deleted.\n   * @throws [[ITwinError]] if any of the supplied ids are not well-formed/valid [[Id64String]]s.\n   * @beta\n   */\n  public deleteElements(ids: Id64Array): Id64Set {\n    this.verifyWriteable();\n    const invalidIds: Id64Set = new Set<Id64String>();\n    for (const id of ids) {\n      if (!Id64.isValidId64(id))\n        invalidIds.add(id);\n    }\n\n    if (invalidIds.size > 0) {\n      ITwinError.throwError({ message: `Invalid element ids: ${Array.from(invalidIds).join(\", \")}`, iTwinErrorId: { scope: \"imodel\", key: \"invalid-arguments\" } });\n    }\n\n    const failedToDelete = this.iModel[_nativeDb].deleteElements(ids);\n    const failedToDeleteSet = failedToDelete ? Id64.toIdSet(failedToDelete) : new Set<Id64String>();\n\n    for (const id of ids) {\n      if (!failedToDeleteSet.has(id)) {\n        this.iModel.elements[_cache].delete({ id });\n        this.iModel.elements[_instanceKeyCache].deleteById(id);\n      }\n    }\n\n    return failedToDeleteSet;\n  }\n\n  /** Insert a new aspect into the iModel.\n   * @param aspectProps The properties of the new aspect.\n   * @returns The newly inserted aspect Id.\n   * @throws EditTxnError if this EditTxn is not active.\n   * @throws IModelError if insertion fails.\n   */\n  public insertAspect(aspectProps: ElementAspectProps): Id64String {\n    this.verifyWriteable();\n    try {\n      return this.iModel[_nativeDb].insertElementAspect(aspectProps);\n    } catch (err: any) {\n      const error = new IModelError(err.errorNumber, `Error inserting ElementAspect [${err.message}], class: ${aspectProps.classFullName}`, aspectProps);\n      error.cause = err;\n      throw error;\n    }\n  }\n\n  /** Update an existing aspect in the iModel.\n   * @param aspectProps The properties of the aspect to update.\n   * @throws EditTxnError if this EditTxn is not active.\n   * @throws IModelError if update fails.\n   */\n  public updateAspect(aspectProps: ElementAspectProps): void {\n    this.verifyWriteable();\n    try {\n      this.iModel[_nativeDb].updateElementAspect(aspectProps);\n    } catch (err: any) {\n      const error = new IModelError(err.errorNumber, `Error updating ElementAspect [${err.message}], id: ${aspectProps.id}`, aspectProps);\n      error.cause = err;\n      throw error;\n    }\n  }\n\n  /** Delete one or more aspects from the iModel.\n   * @param aspectInstanceIds The Ids of the aspects to delete.\n   * @throws EditTxnError if this EditTxn is not active.\n   * @throws IModelError if deletion fails.\n   */\n  public deleteAspect(aspectInstanceIds: Id64Arg): void {\n    this.verifyWriteable();\n    Id64.toIdSet(aspectInstanceIds).forEach((aspectInstanceId) => {\n      try {\n        this.iModel[_nativeDb].deleteElementAspect(aspectInstanceId);\n      } catch (err: any) {\n        const error = new IModelError(err.errorNumber, `Error deleting ElementAspect [${err.message}], id: ${aspectInstanceId}`);\n        error.cause = err;\n        throw error;\n      }\n    });\n  }\n\n  /** Delete definition elements from the iModel when they are not referenced.\n   * @param definitionElementIds The Ids of the definition elements to attempt to delete.\n   * @returns The set of definition elements that were still in use and therefore not deleted.\n   * @throws EditTxnError if this EditTxn is not active.\n   * @throws IModelError if usage queries fail.\n   */\n  public deleteDefinitionElements(definitionElementIds: Id64Array): Id64Set {\n    this.verifyWriteable();\n    const usageInfo = this.iModel[_nativeDb].queryDefinitionElementUsage(definitionElementIds);\n    if (!usageInfo)\n      throw new IModelError(IModelStatus.BadRequest, \"Error querying for DefinitionElement usage\");\n\n    const usedIdSet = usageInfo.usedIds ? Id64.toIdSet(usageInfo.usedIds) : new Set<Id64String>();\n    const deleteIfUnused = (ids: Id64Array | undefined, used: Id64Set): void => {\n      ids?.forEach((id) => {\n        if (!used.has(id))\n          this.deleteElement(id);\n      });\n    };\n\n    try {\n      this.iModel[_nativeDb].beginPurgeOperation();\n      deleteIfUnused(usageInfo.spatialCategoryIds, usedIdSet);\n      deleteIfUnused(usageInfo.drawingCategoryIds, usedIdSet);\n      deleteIfUnused(usageInfo.viewDefinitionIds, usedIdSet);\n      deleteIfUnused(usageInfo.geometryPartIds, usedIdSet);\n      deleteIfUnused(usageInfo.lineStyleIds, usedIdSet);\n      deleteIfUnused(usageInfo.renderMaterialIds, usedIdSet);\n      deleteIfUnused(usageInfo.subCategoryIds, usedIdSet);\n      deleteIfUnused(usageInfo.textureIds, usedIdSet);\n      deleteIfUnused(usageInfo.displayStyleIds, usedIdSet);\n      deleteIfUnused(usageInfo.categorySelectorIds, usedIdSet);\n      deleteIfUnused(usageInfo.modelSelectorIds, usedIdSet);\n      if (usageInfo.otherDefinitionElementIds)\n        this.deleteElement(usageInfo.otherDefinitionElementIds);\n    } finally {\n      this.iModel[_nativeDb].endPurgeOperation();\n    }\n\n    if (usageInfo.viewDefinitionIds) {\n      // Recheck view-related definitions after deleting view definitions that may have been their last reference.\n      let viewRelatedIds: Id64Array = [];\n      if (usageInfo.displayStyleIds)\n        viewRelatedIds = viewRelatedIds.concat(usageInfo.displayStyleIds.filter((id) => usedIdSet.has(id)));\n\n      if (usageInfo.categorySelectorIds)\n        viewRelatedIds = viewRelatedIds.concat(usageInfo.categorySelectorIds.filter((id) => usedIdSet.has(id)));\n\n      if (usageInfo.modelSelectorIds)\n        viewRelatedIds = viewRelatedIds.concat(usageInfo.modelSelectorIds.filter((id) => usedIdSet.has(id)));\n\n      if (viewRelatedIds.length > 0) {\n        const viewRelatedUsageInfo = this.iModel[_nativeDb].queryDefinitionElementUsage(viewRelatedIds);\n        if (viewRelatedUsageInfo) {\n          const usedViewRelatedIdSet: Id64Set = viewRelatedUsageInfo.usedIds ? Id64.toIdSet(viewRelatedUsageInfo.usedIds) : new Set<Id64String>();\n          try {\n            this.iModel[_nativeDb].beginPurgeOperation();\n            deleteIfUnused(viewRelatedUsageInfo.displayStyleIds, usedViewRelatedIdSet);\n            deleteIfUnused(viewRelatedUsageInfo.categorySelectorIds, usedViewRelatedIdSet);\n            deleteIfUnused(viewRelatedUsageInfo.modelSelectorIds, usedViewRelatedIdSet);\n          } finally {\n            this.iModel[_nativeDb].endPurgeOperation();\n          }\n\n          viewRelatedIds.forEach((id) => {\n            if (!usedViewRelatedIdSet.has(id))\n              usedIdSet.delete(id);\n          });\n        }\n      }\n    }\n\n    return usedIdSet;\n  }\n\n  /** Insert a new model into the iModel.\n   * @param props The data for the new model.\n   * @returns The newly inserted model's Id.\n   * @throws EditTxnError if this EditTxn is not active.\n   * @throws IModelError if insertion fails.\n   */\n  public insertModel(props: ModelProps): Id64String {\n    this.verifyWriteable();\n    try {\n      return props.id = this.iModel[_nativeDb].insertModel(props);\n    } catch (err: any) {\n      const error = new IModelError(err.errorNumber, `Error inserting model [${err.message}], class=${props.classFullName}`);\n      error.cause = err;\n      throw error;\n    }\n  }\n\n  /** Update an existing model in the iModel.\n   * @param props the properties of the model to change\n   * @throws EditTxnError if this EditTxn is not active.\n   * @throws IModelError if update fails.\n   */\n  public updateModel(props: UpdateModelOptions): void {\n    this.verifyWriteable();\n    try {\n      if (props.id)\n        this.iModel.models[_cache].delete(props.id);\n\n      this.iModel[_nativeDb].updateModel(props);\n    } catch (err: any) {\n      const error = new IModelError(err.errorNumber, `Error updating model [${err.message}], id: ${props.id}`);\n      error.cause = err;\n      throw error;\n    }\n  }\n\n  /** Update the geometry guid of a model.\n   * @param modelId The Id of the model to update.\n   * @throws EditTxnError if this EditTxn is not active.\n   * @throws IModelError if the update fails.\n   */\n  public updateGeometryGuid(modelId: Id64String): void {\n    this.verifyWriteable();\n    this.iModel.models[_cache].delete(modelId);\n    const error = this.iModel[_nativeDb].updateModelGeometryGuid(modelId);\n    if (error !== IModelStatus.Success)\n      throw new IModelError(error, `Error updating geometry guid for model ${modelId}`);\n  }\n\n  /** Delete models from the iModel.\n   * @param ids The Ids of the models to delete.\n   * @throws EditTxnError if this EditTxn is not active.\n   * @throws IModelError if deletion fails.\n   */\n  public deleteModel(ids: Id64Arg): void {\n    this.verifyWriteable();\n    Id64.toIdSet(ids).forEach((id) => {\n      try {\n        this.iModel.models[_cache].delete(id);\n        this.iModel.models[_instanceKeyCache].deleteById(id);\n        this.iModel[_nativeDb].deleteModel(id);\n      } catch (err: any) {\n        const error = new IModelError(err.errorNumber, `Error deleting model [${err.message}], id: ${id}`);\n        error.cause = err;\n        throw error;\n      }\n    });\n  }\n\n  /** Insert a new relationship into the iModel.\n   * @param props The properties of the new relationship.\n   * @returns The Id of the newly inserted relationship.\n   * @throws EditTxnError if this EditTxn is not active.\n   * @throws IModelError if the class is invalid for link-table insertion.\n   */\n  public insertRelationship(props: RelationshipProps): Id64String {\n    this.verifyWriteable();\n    if (!this.iModel[_nativeDb].isLinkTableRelationship(props.classFullName.replace(\".\", \":\")))\n      throw new IModelError(DbResult.BE_SQLITE_ERROR, `Class '${props.classFullName}' must be a relationship class and it should be subclass of BisCore:ElementRefersToElements or BisCore:ElementDrivesElement.`);\n\n    return props.id = this.iModel[_nativeDb].insertLinkTableRelationship(props);\n  }\n\n  /** Update an existing relationship in the iModel.\n   * @param props the properties of the relationship to update.\n   * @throws EditTxnError if this EditTxn is not active.\n   */\n  public updateRelationship(props: RelationshipProps): void {\n    this.verifyWriteable();\n    this.iModel[_nativeDb].updateLinkTableRelationship(props);\n  }\n\n  /** Delete a relationship from the iModel.\n   * @param props The properties of the relationship to delete.\n   * @throws EditTxnError if this EditTxn is not active.\n   */\n  public deleteRelationship(props: RelationshipProps): void {\n    this.verifyWriteable();\n    this.iModel[_nativeDb].deleteLinkTableRelationship(props);\n  }\n\n  /** Delete multiple relationships from the iModel.\n   * @param props The properties of the relationships to delete.\n   * @throws EditTxnError if this EditTxn is not active.\n   */\n  public deleteRelationships(props: ReadonlyArray<RelationshipProps>): void {\n    this.verifyWriteable();\n    this.iModel[_nativeDb].deleteLinkTableRelationships(props);\n  }\n\n\n  /** Save a file property to the iModel.\n   * @param prop The file property to save.\n   * @param strValue String value.\n   * @param blobVal Blob value.\n   * @throws EditTxnError if this EditTxn is not active.\n   */\n  public saveFileProperty(prop: FilePropertyProps, strValue: string | undefined, blobVal?: Uint8Array): void {\n    this.verifyWriteable();\n    const imodel = this.iModel;\n    if (imodel.isBriefcaseDb()) {\n      if (imodel.txns.isIndirectChanges) {\n        throw new IModelError(IModelStatus.BadRequest, \"Cannot save file property while in an indirect change scope\");\n      }\n    }\n    imodel[_nativeDb].saveFileProperty(prop, strValue, blobVal);\n  }\n\n  /** Delete a file property from the iModel.\n   * @param prop The file property to delete.\n   * @throws EditTxnError if this EditTxn is not active.\n   */\n  public deleteFileProperty(prop: FilePropertyProps): void {\n    this.saveFileProperty(prop, undefined, undefined);\n  }\n\n  /** Update the project extents of the iModel.\n   * @param newExtents The new project extents.\n   * @throws EditTxnError if this EditTxn is not active.\n   * @throws IModelError if extents are invalid.\n   */\n  public updateProjectExtents(newExtents: Range3dProps): void {\n    this.verifyWriteable();\n    const extents = Range3d.fromJSON(newExtents);\n    if (extents.isNull)\n      throw new IModelError(DbResult.BE_SQLITE_ERROR, \"Invalid project extents\");\n\n    this.iModel.projectExtents = extents;\n    this.updateIModelProps();\n  }\n\n  /** Update the ECEF location of the iModel.\n   * @param ecef The new ECEF location.\n   * @throws EditTxnError if this EditTxn is not active.\n   */\n  public updateEcefLocation(ecef: EcefLocationProps): void {\n    this.verifyWriteable();\n    this.iModel.setEcefLocation(new EcefLocation(ecef));\n    this.updateIModelProps();\n  }\n\n  /** Update the iModel props in the database from the current in-memory state.\n   * @throws EditTxnError if this EditTxn is not active.\n   */\n  public updateIModelProps(): void {\n    this.verifyWriteable();\n    this.iModel[_nativeDb].updateIModelProps(this.iModel.toJSON());\n  }\n\n  private static readonly _settingPropNamespace = \"settings\";\n  private static readonly _viewStoreProperty: FilePropertyProps = { namespace: \"itwinjs\", name: \"DefaultViewStore\" };\n\n  /** Save a `SettingDictionary` in this iModel.\n   * @param name The name for the SettingDictionary. If a dictionary by that name already exists, its value is replaced.\n   * @param dict The SettingDictionary object to stringify and save.\n   * @throws EditTxnError if this EditTxn is not active.\n   * @beta\n   */\n  public saveSettingDictionary(name: string, dict: SettingsContainer): void {\n    this.verifyWriteable();\n    this.iModel.withSqliteStatement(\"REPLACE INTO be_Prop(id,SubId,TxnMode,Namespace,Name,strData) VALUES(0,0,0,?,?,?)\", (stmt) => {\n      stmt.bindString(1, EditTxn._settingPropNamespace);\n      stmt.bindString(2, name);\n      stmt.bindString(3, JSON.stringify(dict));\n      stmt.stepForWrite();\n    });\n    this.saveChanges(\"add settings\");\n  }\n\n  /** Delete a SettingDictionary from this iModel.\n   * @param name The name of the dictionary to delete.\n   * @throws EditTxnError if this EditTxn is not active.\n   * @beta\n   */\n  public deleteSettingDictionary(name: string): void {\n    this.verifyWriteable();\n    this.iModel.withSqliteStatement(\"DELETE FROM be_Prop WHERE Namespace=? AND Name=?\", (stmt) => {\n      stmt.bindString(1, EditTxn._settingPropNamespace);\n      stmt.bindString(2, name);\n      stmt.stepForWrite();\n    });\n    this.saveChanges(\"delete settings\");\n  }\n\n  /** Save a default ViewStore container reference in this iModel.\n   * @param arg The cloud container properties for the ViewStore.\n   * @throws EditTxnError if this EditTxn is not active.\n   * @beta\n   */\n  public saveDefaultViewStore(arg: CloudSqlite.ContainerProps): void {\n    this.verifyWriteable();\n    const props = { baseUri: arg.baseUri, containerId: arg.containerId, storageType: arg.storageType }; // sanitize to only known properties\n    this.saveFileProperty(EditTxn._viewStoreProperty, JSON.stringify(props));\n    this.saveChanges(\"update default ViewStore\");\n  }\n}\n\n/** Execute a callback within an explicit editing transaction. A new [[EditTxn]] is created, started,\n * and passed to `fn`. If `fn` returns normally (or its returned Promise resolves), the transaction\n * is committed. If `fn` throws (or its returned Promise rejects), the transaction is abandoned —\n * none of the changes made during the callback are saved — and the error is re-thrown.\n *\n * This is the recommended way to perform a scoped unit of work on an iModel. It ensures that\n * edits are committed atomically on success and rolled back on failure, without the caller needing\n * to manage `start` / `end` manually.\n *\n * @param iModel The iModel to edit.\n * @param fn A callback that receives the active [[EditTxn]] and performs edits.\n * @returns The value returned by `fn`.\n * @throws EditTxnError if the transaction cannot be started (e.g. unsaved changes or another EditTxn is active).\n * @throws Re-throws any error thrown by `fn` after abandoning the transaction.\n * @beta\n */\nexport function withEditTxn<T>(iModel: IModelDb, fn: (txn: EditTxn) => T): T;\n/** Execute a callback within an explicit editing transaction, supplying commit arguments.\n * @param iModel The iModel to edit.\n * @param saveArgs Description or structured arguments passed to [[EditTxn.saveChanges]] on save.\n * @param fn A callback that receives the active [[EditTxn]] and performs edits.\n * @returns The value returned by `fn`.\n * @beta\n */\nexport function withEditTxn<T>(iModel: IModelDb, saveArgs: string | SaveChangesArgs, fn: (txn: EditTxn) => T): T;\n/** Execute an async callback within an explicit editing transaction.\n * @param iModel The iModel to edit.\n * @param fn An async callback that receives the active [[EditTxn]] and performs edits.\n * @returns A Promise that resolves to the value returned by `fn`.\n * @beta\n */\nexport function withEditTxn<T>(iModel: IModelDb, fn: (txn: EditTxn) => Promise<T>): Promise<T>;\n/** Execute an async callback within an explicit editing transaction, supplying commit arguments.\n * @param iModel The iModel to edit.\n * @param saveArgs Description or structured arguments passed to [[EditTxn.saveChanges]] on save.\n * @param fn An async callback that receives the active [[EditTxn]] and performs edits.\n * @returns A Promise that resolves to the value returned by `fn`.\n * @beta\n */\nexport function withEditTxn<T>(iModel: IModelDb, saveArgs: string | SaveChangesArgs, fn: (txn: EditTxn) => Promise<T>): Promise<T>;\nexport function withEditTxn<T>(iModel: IModelDb, saveArgsOrFn: string | SaveChangesArgs | ((txn: EditTxn) => T | Promise<T>), maybeFn?: (txn: EditTxn) => T | Promise<T>): T | Promise<T> {\n  const saveArgs = \"function\" === typeof saveArgsOrFn ? undefined : saveArgsOrFn;\n  const fn = \"function\" === typeof saveArgsOrFn ? saveArgsOrFn : maybeFn;\n\n  if (undefined === fn)\n    throw new Error(\"withEditTxn requires a callback\");\n\n  const txn = new EditTxn(iModel, \"\");\n  txn.start();\n\n  try {\n    const result = fn(txn);\n    if (result instanceof Promise) {\n      return result.then((value) => {\n        txn.end(\"save\", saveArgs);\n        return value;\n      }, (err) => {\n        if (txn.isActive)\n          txn.end(\"abandon\");\n\n        throw err;\n      });\n    }\n\n    txn.end(\"save\", saveArgs);\n    return result;\n  } catch (err) {\n    if (txn.isActive)\n      txn.end(\"abandon\");\n\n    throw err;\n  }\n}\n"]}

package/lib/esm/IModelDb.d.ts

@@ -32,7 +32,7 @@ import { LockControl } from "./LockControl";
 import type { BlobContainer } from "./BlobContainerService";
 import { IModelDbFonts } from "./IModelDbFonts";
 import { _activeTxn, _cache, _implicitTxn, _instanceKeyCache, _nativeDb, _resetIModelDb } from "./internal/Symbols";
-import { ECVersion, SchemaContext } from "@itwin/ecschema-metadata";
+import { ECSpecVersion, ECVersion, SchemaContext } from "@itwin/ecschema-metadata";
 import { SchemaMap } from "./Schema";
 import { ElementLRUCache, InstanceKeyLRUCache } from "./internal/ElementLRUCache";
 import { IntegrityCheckResult } from "./internal/IntegrityCheck";
@@ -1135,6 +1135,13 @@ export declare abstract class IModelDb extends IModel {
      * @beta
      */
     exportSchemas(outputDirectory: LocalFileName): void;
+    /** Serializes the specified ECSchema to an XML string.
+     * @param schemaName The name of the schema to serialize.
+     * @param ecSpecVersion The ECXml specification version to use for the output XML.
+     * @returns The schema XML string, or `undefined` if the schema was not found or serialization failed.
+     * @beta
+     */
+    exportSchemaXmlString(schemaName: string, ecSpecVersion?: ECSpecVersion): string | undefined;
     /** Attempt to simplify the geometry stream of a single [[GeometricElement]] or [[GeometryPart]] as specified by `args`.
      * @beta
      */