Added new API's for adding custom changes into IModelExporter.sourceDbChanges

change/@itwin-imodel-transformer-e69e7651-40c7-4476-9e9e-6026f430c36c.json

@@ -0,0 +1,7 @@
+{
+  "type": "prerelease",
+  "comment": "Add new APIs to support providing custom changes ( not found in a changeset ) to the transformer",
+  "packageName": "@itwin/imodel-transformer",
+  "email": "22119573+nick4598@users.noreply.github.com, JulijaRamoskiene@users.noreply.github.com",
+  "dependentChangeType": "patch"
+}

common/api/imodel-transformer.api.md

@@ -22,6 +22,7 @@ import { EntityReference } from '@itwin/core-common';
 import { ExternalSourceAspect } from '@itwin/core-backend';
 import { ExternalSourceAspectProps } from '@itwin/core-common';
 import { FontProps } from '@itwin/core-common';
+import { Id64Arg } from '@itwin/core-bentley';
 import { Id64Array } from '@itwin/core-bentley';
 import { Id64Set } from '@itwin/core-bentley';
 import { Id64String } from '@itwin/core-bentley';
@@ -36,11 +37,18 @@ import { Relationship } from '@itwin/core-backend';
 import { RelationshipProps } from '@itwin/core-backend';
 import { Schema } from '@itwin/ecschema-metadata';
 import { SchemaKey } from '@itwin/ecschema-metadata';
+import { SqliteChangeOp } from '@itwin/core-backend';
 
 // @public
 export class ChangedInstanceIds {
     constructor(db: IModelDb);
     addChange(change: ChangedECInstance): Promise<void>;
+    // @beta
+    addCustomAspectChange(changeType: SqliteChangeOp, ids: Id64Arg): void;
+    // @beta
+    addCustomElementChange(changeType: SqliteChangeOp, ids: Id64Arg): Promise<void>;
+    // @beta
+    addCustomModelChange(changeType: SqliteChangeOp, ids: Id64Arg): Promise<void>;
     // (undocumented)
     aspect: ChangedInstanceOps;
     // (undocumented)
@@ -49,6 +57,7 @@ export class ChangedInstanceIds {
     element: ChangedInstanceOps;
     // (undocumented)
     font: ChangedInstanceOps;
+    get hasChanges(): boolean;
     static initialize(opts: ChangedInstanceIdsInitOptions): Promise<ChangedInstanceIds | undefined>;
     // (undocumented)
     model: ChangedInstanceOps;
@@ -68,6 +77,7 @@ export class ChangedInstanceOps {
     deleteIds: Set<string>;
     // (undocumented)
     insertIds: Set<string>;
+    get isEmpty(): boolean;
     // (undocumented)
     updateIds: Set<string>;
 }
@@ -232,6 +242,7 @@ export interface IModelImportOptions {
 // @beta
 export class IModelTransformer extends IModelExportHandler {
     constructor(source: IModelDb | IModelExporter, target: IModelDb | IModelImporter, options?: IModelTransformOptions);
+    protected addCustomChanges(_sourceDbChanges: ChangedInstanceIds): Promise<void>;
     combineElements(sourceElementIds: Id64Array, targetElementId: Id64String): void;
     // (undocumented)
     protected completePartiallyCommittedAspects(): void;

packages/test-app/src/IModelHubUtils.ts

@@ -97,12 +97,14 @@ export namespace IModelHubUtils {
   ): Promise<ChangesetId> {
     return (
       // eslint-disable-next-line @itwin/no-internal
-      await IModelHost.hubAccess.queryChangeset({
-        accessToken,
-        iModelId,
-        changeset: { index: changesetIndex },
-      })
-    ).id;
+      (
+        await IModelHost.hubAccess.queryChangeset({
+          accessToken,
+          iModelId,
+          changeset: { index: changesetIndex },
+        })
+      ).id
+    );
   }
 
   /** Temporarily needed to convert from the legacy ChangesetId to the now preferred ChangeSetIndex.
@@ -201,8 +203,8 @@ export namespace IModelHubUtils {
     return BriefcaseDb.open({
       fileName: briefcaseProps.fileName,
       readonly: briefcaseArg.briefcaseId
-        // eslint-disable-next-line @typescript-eslint/no-unsafe-enum-comparison
-        ? briefcaseArg.briefcaseId === BriefcaseIdValue.Unassigned
+        ? // eslint-disable-next-line @typescript-eslint/no-unsafe-enum-comparison
+          briefcaseArg.briefcaseId === BriefcaseIdValue.Unassigned
         : false,
     });
   }