@itwin/imodel-transformer 1.0.0-dev.2 → 1.0.0-dev.21

package/lib/cjs/IModelCloneContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"IModelCloneContext.js","sourceRoot":"","sources":["../../src/IModelCloneContext.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module iModels\n */\nimport * as assert from \"assert\";\nimport { DbResult, Id64, Id64String, Logger } from \"@itwin/core-bentley\";\nimport {\n  Code,\n  CodeScopeSpec,\n  ConcreteEntityTypes,\n  ElementAspectProps,\n  ElementProps,\n  EntityReference,\n  IModel,\n  IModelError,\n  PrimitiveTypeCode,\n  PropertyMetaData,\n  RelatedElement,\n  RelatedElementProps,\n} from \"@itwin/core-common\";\nimport {\n  Element,\n  ElementAspect,\n  EntityReferences,\n  IModelElementCloneContext,\n  IModelJsNative,\n  SQLiteDb,\n} from \"@itwin/core-backend\";\nimport { ECReferenceTypesCache } from \"./ECReferenceTypesCache\";\nimport { EntityUnifier } from \"./EntityUnifier\";\nimport { TransformerLoggerCategory } from \"./TransformerLoggerCategory\";\n\nconst loggerCategory: string = TransformerLoggerCategory.IModelCloneContext;\n\n/** The context for transforming a *source* Element to a *target* Element and remapping internal identifiers to the target iModel.\n * @beta\n */\nexport class IModelCloneContext extends IModelElementCloneContext {\n  private _refTypesCache = new ECReferenceTypesCache();\n  private _aspectRemapTable = new Map<Id64String, Id64String>();\n\n  /** perform necessary initialization to use a clone context, namely caching the reference types in the source's schemas */\n  public override async initialize() {\n    await this._refTypesCache.initAllSchemasInIModel(this.sourceDb);\n  }\n\n  /** Clone the specified source Element into ElementProps for the target iModel.\n   * @internal\n   */\n  public override cloneElement(\n    sourceElement: Element,\n    cloneOptions?: IModelJsNative.CloneElementOptions\n  ): ElementProps {\n    const targetElementProps: ElementProps = this[\n      \"_nativeContext\"\n    ].cloneElement(sourceElement.id, cloneOptions);\n    // Ensure that all NavigationProperties in targetElementProps have a defined value so \"clearing\" changes will be part of the JSON used for update\n    sourceElement.forEachProperty(\n      (propertyName: string, meta: PropertyMetaData) => {\n        if (\n          meta.isNavigation &&\n          undefined === (sourceElement as any)[propertyName]\n        ) {\n          (targetElementProps as any)[propertyName] = RelatedElement.none;\n        }\n      },\n      false\n    ); // exclude custom because C++ has already handled them\n    if (this.isBetweenIModels) {\n      // The native C++ cloneElement strips off federationGuid, want to put it back if transformation is between iModels\n      targetElementProps.federationGuid = sourceElement.federationGuid;\n      const targetElementCodeScopeType = this.targetDb.codeSpecs.getById(\n        targetElementProps.code.spec\n      ).scopeType;\n      if (\n        CodeScopeSpec.Type.Repository === targetElementCodeScopeType &&\n        targetElementProps.code.scope !== IModel.rootSubjectId\n      ) {\n        Logger.logWarning(\n          loggerCategory,\n          `Incorrect CodeScope '${targetElementCodeScopeType}' is set for target element ${targetElementProps.id}`\n        );\n      }\n    }\n    // unlike other references, code cannot be null. If it is null, use an empty code instead\n    // this will be updated back later as the transformer resolves references\n    if (\n      targetElementProps.code.scope === Id64.invalid ||\n      targetElementProps.code.spec === Id64.invalid\n    ) {\n      targetElementProps.code = Code.createEmpty();\n    }\n    const jsClass = this.sourceDb.getJsClass<typeof Element>(\n      sourceElement.classFullName\n    );\n    jsClass[\"onCloned\"](this, sourceElement.toJSON(), targetElementProps);\n    return targetElementProps;\n  }\n\n  /** Add a rule that remaps the specified source ElementAspect to the specified target ElementAspect. */\n  public remapElementAspect(\n    aspectSourceId: Id64String,\n    aspectTargetId: Id64String\n  ): void {\n    this._aspectRemapTable.set(aspectSourceId, aspectTargetId);\n  }\n\n  /** Remove a rule that remaps the specified source ElementAspect */\n  public removeElementAspect(aspectSourceId: Id64String): void {\n    this._aspectRemapTable.delete(aspectSourceId);\n  }\n\n  /** Look up a target AspectId from the source AspectId.\n   * @returns the target AspectId or [Id64.invalid]($bentley) if a mapping not found.\n   */\n  public findTargetAspectId(sourceAspectId: Id64String): Id64String {\n    return this._aspectRemapTable.get(sourceAspectId) ?? Id64.invalid;\n  }\n\n  /** Look up a target [EntityReference]($bentley) from a source [EntityReference]($bentley)\n   * @returns the target CodeSpecId or a [EntityReference]($bentley) containing [Id64.invalid]($bentley) if a mapping is not found.\n   */\n  public findTargetEntityId(sourceEntityId: EntityReference): EntityReference {\n    const [type, rawId] = EntityReferences.split(sourceEntityId);\n    if (Id64.isValid(rawId)) {\n      switch (type) {\n        case ConcreteEntityTypes.Model: {\n          const targetId = `m${this.findTargetElementId(rawId)}` as const;\n          // Check if the model exists, `findTargetElementId` may have worked because the element exists when the model doesn't.\n          // That can occur in the transformer since a submodeled element is imported before its submodel.\n          if (\n            EntityUnifier.exists(this.targetDb, { entityReference: targetId })\n          )\n            return targetId;\n          break;\n        }\n        case ConcreteEntityTypes.Element:\n          return `e${this.findTargetElementId(rawId)}`;\n        case ConcreteEntityTypes.ElementAspect:\n          return `a${this.findTargetAspectId(rawId)}`;\n        case ConcreteEntityTypes.Relationship: {\n          const makeGetConcreteEntityTypeSql = (property: string) => `\n            CASE\n              WHEN [${property}] IS (BisCore.ElementUniqueAspect) OR [${property}] IS (BisCore.ElementMultiAspect)\n                THEN 'a'\n              WHEN [${property}] IS (BisCore.Element)\n                THEN 'e'\n              WHEN [${property}] IS (BisCore.Model)\n                THEN 'm'\n              WHEN [${property}] IS (BisCore.CodeSpec)\n                THEN 'c'\n              WHEN [${property}] IS (BisCore.ElementRefersToElements) -- TODO: ElementDrivesElement still not handled by the transformer\n                THEN 'r'\n              ELSE 'error'\n            END\n          `;\n          const relInSource = this.sourceDb.withPreparedStatement(\n            `\n            SELECT\n              SourceECInstanceId,\n              TargetECInstanceId,\n              (${makeGetConcreteEntityTypeSql(\n                \"SourceECClassId\"\n              )}) AS SourceType,\n              (${makeGetConcreteEntityTypeSql(\"TargetECClassId\")}) AS TargetType\n            FROM BisCore:ElementRefersToElements\n            WHERE ECInstanceId=?\n            `,\n            (stmt) => {\n              stmt.bindId(1, rawId);\n              let status: DbResult;\n              while ((status = stmt.step()) === DbResult.BE_SQLITE_ROW) {\n                const sourceId = stmt.getValue(0).getId();\n                const targetId = stmt.getValue(1).getId();\n                const sourceType = stmt.getValue(2).getString() as\n                  | ConcreteEntityTypes\n                  | \"error\";\n                const targetType = stmt.getValue(3).getString() as\n                  | ConcreteEntityTypes\n                  | \"error\";\n                if (sourceType === \"error\" || targetType === \"error\")\n                  throw Error(\"relationship end had unknown root class\");\n                return {\n                  sourceId: `${sourceType}${sourceId}`,\n                  targetId: `${targetType}${targetId}`,\n                } as const;\n              }\n              if (status !== DbResult.BE_SQLITE_DONE)\n                throw new IModelError(status, \"unexpected query failure\");\n              return undefined;\n            }\n          );\n          if (relInSource === undefined) break;\n          // just in case prevent recursion\n          if (\n            relInSource.sourceId === sourceEntityId ||\n            relInSource.targetId === sourceEntityId\n          )\n            throw Error(\n              \"link table relationship end was resolved to itself. This should be impossible\"\n            );\n          const relInTarget = {\n            sourceId: this.findTargetEntityId(relInSource.sourceId),\n            targetId: this.findTargetEntityId(relInSource.targetId),\n          };\n          // return a null\n          if (\n            !EntityReferences.isValid(relInTarget.sourceId) ||\n            !EntityReferences.isValid(relInTarget.targetId)\n          )\n            break;\n          const relInTargetId = this.targetDb.withPreparedStatement(\n            `\n            SELECT ECInstanceId\n            FROM BisCore:ElementRefersToElements\n            WHERE SourceECInstanceId=?\n              AND TargetECInstanceId=?\n            `,\n            (stmt) => {\n              stmt.bindId(1, EntityReferences.toId64(relInTarget.sourceId));\n              stmt.bindId(2, EntityReferences.toId64(relInTarget.targetId));\n              const status: DbResult = stmt.step();\n              if (status === DbResult.BE_SQLITE_ROW)\n                return stmt.getValue(0).getId();\n              if (status !== DbResult.BE_SQLITE_DONE)\n                throw new IModelError(status, \"unexpected query failure\");\n              return Id64.invalid;\n            }\n          );\n          return `r${relInTargetId}`;\n        }\n      }\n    }\n    return `${type}${Id64.invalid}`;\n  }\n\n  /** Clone the specified source Element into ElementProps for the target iModel.\n   * @internal\n   */\n  public cloneElementAspect(\n    sourceElementAspect: ElementAspect\n  ): ElementAspectProps {\n    const targetElementAspectProps: ElementAspectProps =\n      sourceElementAspect.toJSON();\n    targetElementAspectProps.id = undefined;\n    sourceElementAspect.forEachProperty((propertyName, propertyMetaData) => {\n      if (propertyMetaData.isNavigation) {\n        const sourceNavProp: RelatedElementProps | undefined =\n          sourceElementAspect.asAny[propertyName];\n        if (sourceNavProp?.id) {\n          const navPropRefType = this._refTypesCache.getNavPropRefType(\n            sourceElementAspect.schemaName,\n            sourceElementAspect.className,\n            propertyName\n          );\n          assert(\n            navPropRefType !== undefined,\n            `nav prop ref type for '${propertyName}' was not in the cache, this is a bug.`\n          );\n          const targetEntityReference = this.findTargetEntityId(\n            EntityReferences.fromEntityType(sourceNavProp.id, navPropRefType)\n          );\n          const targetEntityId = EntityReferences.toId64(targetEntityReference);\n          // spread the property in case toJSON did not deep-clone\n          (targetElementAspectProps as any)[propertyName] = {\n            ...(targetElementAspectProps as any)[propertyName],\n            id: targetEntityId,\n          };\n        }\n      } else if (\n        PrimitiveTypeCode.Long === propertyMetaData.primitiveType &&\n        \"Id\" === propertyMetaData.extendedType\n      ) {\n        (targetElementAspectProps as any)[propertyName] =\n          this.findTargetElementId(sourceElementAspect.asAny[propertyName]);\n      }\n    });\n    return targetElementAspectProps;\n  }\n}\n"]}
+{"version":3,"file":"IModelCloneContext.js","sourceRoot":"","sources":["../../src/IModelCloneContext.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module iModels\n */\nimport * as assert from \"assert\";\nimport { DbResult, Id64, Id64String, Logger } from \"@itwin/core-bentley\";\nimport {\n  Code,\n  CodeScopeSpec,\n  ConcreteEntityTypes,\n  ElementAspectProps,\n  ElementProps,\n  EntityReference,\n  IModel,\n  IModelError,\n  PrimitiveTypeCode,\n  PropertyMetaData,\n  RelatedElement,\n  RelatedElementProps,\n} from \"@itwin/core-common\";\nimport {\n  // eslint-disable-next-line @typescript-eslint/no-redeclare\n  Element,\n  ElementAspect,\n  EntityReferences,\n  IModelElementCloneContext,\n  IModelJsNative,\n} from \"@itwin/core-backend\";\nimport { ECReferenceTypesCache } from \"./ECReferenceTypesCache\";\nimport { EntityUnifier } from \"./EntityUnifier\";\nimport { TransformerLoggerCategory } from \"./TransformerLoggerCategory\";\n\nconst loggerCategory: string = TransformerLoggerCategory.IModelCloneContext;\n\n/** The context for transforming a *source* Element to a *target* Element and remapping internal identifiers to the target iModel.\n * @beta\n */\nexport class IModelCloneContext extends IModelElementCloneContext {\n  private _refTypesCache = new ECReferenceTypesCache();\n  private _aspectRemapTable = new Map<Id64String, Id64String>();\n\n  /** perform necessary initialization to use a clone context, namely caching the reference types in the source's schemas */\n  public override async initialize() {\n    await this._refTypesCache.initAllSchemasInIModel(this.sourceDb);\n  }\n\n  /** Clone the specified source Element into ElementProps for the target iModel.\n   * @internal\n   */\n  public override cloneElement(\n    sourceElement: Element,\n    cloneOptions?: IModelJsNative.CloneElementOptions\n  ): ElementProps {\n    const targetElementProps: ElementProps = this[\n      \"_nativeContext\"\n    ].cloneElement(sourceElement.id, cloneOptions);\n    // Ensure that all NavigationProperties in targetElementProps have a defined value so \"clearing\" changes will be part of the JSON used for update\n    sourceElement.forEachProperty(\n      (propertyName: string, meta: PropertyMetaData) => {\n        if (\n          meta.isNavigation &&\n          undefined === (sourceElement as any)[propertyName]\n        ) {\n          (targetElementProps as any)[propertyName] = RelatedElement.none;\n        }\n      },\n      false\n    ); // exclude custom because C++ has already handled them\n    if (this.isBetweenIModels) {\n      // The native C++ cloneElement strips off federationGuid, want to put it back if transformation is between iModels\n      targetElementProps.federationGuid = sourceElement.federationGuid;\n      const targetElementCodeScopeType = this.targetDb.codeSpecs.getById(\n        targetElementProps.code.spec\n      ).scopeType;\n      if (\n        CodeScopeSpec.Type.Repository === targetElementCodeScopeType &&\n        targetElementProps.code.scope !== IModel.rootSubjectId\n      ) {\n        Logger.logWarning(\n          loggerCategory,\n          `Incorrect CodeScope '${targetElementCodeScopeType}' is set for target element ${targetElementProps.id}`\n        );\n      }\n    }\n    // unlike other references, code cannot be null. If it is null, use an empty code instead\n    // this will be updated back later as the transformer resolves references\n    if (\n      targetElementProps.code.scope === Id64.invalid ||\n      targetElementProps.code.spec === Id64.invalid\n    ) {\n      targetElementProps.code = Code.createEmpty();\n    }\n    const jsClass = this.sourceDb.getJsClass<typeof Element>(\n      sourceElement.classFullName\n    );\n    jsClass[\"onCloned\"](this, sourceElement.toJSON(), targetElementProps);\n    return targetElementProps;\n  }\n\n  /** Add a rule that remaps the specified source ElementAspect to the specified target ElementAspect. */\n  public remapElementAspect(\n    aspectSourceId: Id64String,\n    aspectTargetId: Id64String\n  ): void {\n    this._aspectRemapTable.set(aspectSourceId, aspectTargetId);\n  }\n\n  /** Remove a rule that remaps the specified source ElementAspect */\n  public removeElementAspect(aspectSourceId: Id64String): void {\n    this._aspectRemapTable.delete(aspectSourceId);\n  }\n\n  /** Look up a target AspectId from the source AspectId.\n   * @returns the target AspectId or [Id64.invalid]($bentley) if a mapping not found.\n   */\n  public findTargetAspectId(sourceAspectId: Id64String): Id64String {\n    return this._aspectRemapTable.get(sourceAspectId) ?? Id64.invalid;\n  }\n\n  /** Look up a target [EntityReference]($bentley) from a source [EntityReference]($bentley)\n   * @returns the target CodeSpecId or a [EntityReference]($bentley) containing [Id64.invalid]($bentley) if a mapping is not found.\n   */\n  public findTargetEntityId(sourceEntityId: EntityReference): EntityReference {\n    const [type, rawId] = EntityReferences.split(sourceEntityId);\n    if (Id64.isValid(rawId)) {\n      switch (type) {\n        case ConcreteEntityTypes.Model: {\n          let targetId;\n          /**\n           * The repository model is a singleton container which exists in all iModels which has a modelId of 0x1.\n           * It is possible to remap the root subject (id 0x1) to some other non root subject, but this is not possible for the repository model.\n           * The RepositoryModel only contains bis:Subject elements and bis:InformationpartitionElement instances (https://www.itwinjs.org/bis/domains/biscore.ecschema/#repositorymodel)\n           * The system handler for both bis:InformationPartitionElement and bis:Subject will only permit instances to be inserted into the RepositoryModel.\n           * https://www.itwinjs.org/bis/domains/biscore.ecschema/#informationpartitionelement\n           * https://www.itwinjs.org/bis/domains/biscore.ecschema/#subject\n           * Since there is a chance that the root subject is remapped to some other subject which has the same id as the repositoryModel, we need to ignore the remapping for the repository model.\n           */\n          if (rawId === IModel.repositoryModelId) {\n            targetId = `m${IModel.repositoryModelId}` as const;\n          } else {\n            targetId = `m${this.findTargetElementId(rawId)}` as const;\n          }\n          // Check if the model exists, `findTargetElementId` may have worked because the element exists when the model doesn't.\n          // That can occur in the transformer since a submodeled element is imported before its submodel.\n          if (\n            EntityUnifier.exists(this.targetDb, { entityReference: targetId })\n          )\n            return targetId;\n          break;\n        }\n        case ConcreteEntityTypes.Element:\n          return `e${this.findTargetElementId(rawId)}`;\n        case ConcreteEntityTypes.ElementAspect:\n          return `a${this.findTargetAspectId(rawId)}`;\n        case ConcreteEntityTypes.Relationship: {\n          const makeGetConcreteEntityTypeSql = (property: string) => `\n            CASE\n              WHEN [${property}] IS (BisCore.ElementUniqueAspect) OR [${property}] IS (BisCore.ElementMultiAspect)\n                THEN 'a'\n              WHEN [${property}] IS (BisCore.Element)\n                THEN 'e'\n              WHEN [${property}] IS (BisCore.Model)\n                THEN 'm'\n              WHEN [${property}] IS (BisCore.CodeSpec)\n                THEN 'c'\n              WHEN [${property}] IS (BisCore.ElementRefersToElements) -- TODO: ElementDrivesElement still not handled by the transformer\n                THEN 'r'\n              ELSE 'error'\n            END\n          `;\n          const relInSource = this.sourceDb.withPreparedStatement(\n            `\n            SELECT\n              SourceECInstanceId,\n              TargetECInstanceId,\n              (${makeGetConcreteEntityTypeSql(\n                \"SourceECClassId\"\n              )}) AS SourceType,\n              (${makeGetConcreteEntityTypeSql(\"TargetECClassId\")}) AS TargetType\n            FROM BisCore:ElementRefersToElements\n            WHERE ECInstanceId=?\n            `,\n            (stmt) => {\n              stmt.bindId(1, rawId);\n              let status: DbResult;\n              while ((status = stmt.step()) === DbResult.BE_SQLITE_ROW) {\n                const sourceId = stmt.getValue(0).getId();\n                const targetId = stmt.getValue(1).getId();\n                const sourceType = stmt.getValue(2).getString() as\n                  | ConcreteEntityTypes\n                  | \"error\";\n                const targetType = stmt.getValue(3).getString() as\n                  | ConcreteEntityTypes\n                  | \"error\";\n                if (sourceType === \"error\" || targetType === \"error\")\n                  throw Error(\"relationship end had unknown root class\");\n                return {\n                  sourceId: `${sourceType}${sourceId}`,\n                  targetId: `${targetType}${targetId}`,\n                } as const;\n              }\n              if (status !== DbResult.BE_SQLITE_DONE)\n                throw new IModelError(status, \"unexpected query failure\");\n              return undefined;\n            }\n          );\n          if (relInSource === undefined) break;\n          // just in case prevent recursion\n          if (\n            relInSource.sourceId === sourceEntityId ||\n            relInSource.targetId === sourceEntityId\n          )\n            throw Error(\n              \"link table relationship end was resolved to itself. This should be impossible\"\n            );\n          const relInTarget = {\n            sourceId: this.findTargetEntityId(relInSource.sourceId),\n            targetId: this.findTargetEntityId(relInSource.targetId),\n          };\n          // return a null\n          if (\n            !EntityReferences.isValid(relInTarget.sourceId) ||\n            !EntityReferences.isValid(relInTarget.targetId)\n          )\n            break;\n          const relInTargetId = this.targetDb.withPreparedStatement(\n            `\n            SELECT ECInstanceId\n            FROM BisCore:ElementRefersToElements\n            WHERE SourceECInstanceId=?\n              AND TargetECInstanceId=?\n            `,\n            (stmt) => {\n              stmt.bindId(1, EntityReferences.toId64(relInTarget.sourceId));\n              stmt.bindId(2, EntityReferences.toId64(relInTarget.targetId));\n              const status: DbResult = stmt.step();\n              if (status === DbResult.BE_SQLITE_ROW)\n                return stmt.getValue(0).getId();\n              if (status !== DbResult.BE_SQLITE_DONE)\n                throw new IModelError(status, \"unexpected query failure\");\n              return Id64.invalid;\n            }\n          );\n          return `r${relInTargetId}`;\n        }\n      }\n    }\n    return `${type}${Id64.invalid}`;\n  }\n\n  /** Clone the specified source Element into ElementProps for the target iModel.\n   * @internal\n   */\n  public cloneElementAspect(\n    sourceElementAspect: ElementAspect\n  ): ElementAspectProps {\n    const targetElementAspectProps: ElementAspectProps =\n      sourceElementAspect.toJSON();\n    targetElementAspectProps.id = undefined;\n    sourceElementAspect.forEachProperty((propertyName, propertyMetaData) => {\n      if (propertyMetaData.isNavigation) {\n        const sourceNavProp: RelatedElementProps | undefined =\n          sourceElementAspect.asAny[propertyName];\n        if (sourceNavProp?.id) {\n          const navPropRefType = this._refTypesCache.getNavPropRefType(\n            sourceElementAspect.schemaName,\n            sourceElementAspect.className,\n            propertyName\n          );\n          assert(\n            navPropRefType !== undefined,\n            `nav prop ref type for '${propertyName}' was not in the cache, this is a bug.`\n          );\n          const targetEntityReference = this.findTargetEntityId(\n            EntityReferences.fromEntityType(sourceNavProp.id, navPropRefType)\n          );\n          const targetEntityId = EntityReferences.toId64(targetEntityReference);\n          // spread the property in case toJSON did not deep-clone\n          (targetElementAspectProps as any)[propertyName] = {\n            ...(targetElementAspectProps as any)[propertyName],\n            id: targetEntityId,\n          };\n        }\n      } else if (\n        PrimitiveTypeCode.Long === propertyMetaData.primitiveType &&\n        \"Id\" === propertyMetaData.extendedType\n      ) {\n        (targetElementAspectProps as any)[propertyName] =\n          this.findTargetElementId(sourceElementAspect.asAny[propertyName]);\n      }\n    });\n    return targetElementAspectProps;\n  }\n}\n"]}

package/lib/cjs/IModelExporter.d.ts

@@ -2,10 +2,9 @@
  * @module iModels
  */
 import { BriefcaseDb, ChangedECInstance, Element, ElementAspect, ElementMultiAspect, ElementUniqueAspect, IModelDb, IModelJsNative, Model, Relationship } from "@itwin/core-backend";
-import { AccessToken, Id64String } from "@itwin/core-bentley";
+import { Id64String } from "@itwin/core-bentley";
 import { ChangesetFileProps, CodeSpec, FontProps } from "@itwin/core-common";
 import { Schema, SchemaKey } from "@itwin/ecschema-metadata";
-import type { InitOptions } from "./IModelTransformer";
 import { ElementAspectsHandler, ExportElementAspectsStrategy } from "./ExportElementAspectsStrategy";
 /**
  * @beta
@@ -25,7 +24,7 @@ export type ExporterInitOptions = ExportChangesOptions;
  * Arguments for [[IModelExporter.exportChanges]]
  * @public
  */
-export type ExportChangesOptions = Omit<InitOptions, "startChangeset"> & {
+export type ExportChangesOptions = {
     skipPropagateChangesToRootElements?: boolean;
 } /**
  * an array of ChangesetFileProps which are used to read the changesets and populate the ChangedInstanceIds using [[ChangedInstanceIds.initialize]] in [[IModelExporter.exportChanges]]
@@ -96,7 +95,9 @@ export declare abstract class IModelExportHandler {
      * @note This method can optionally be overridden to exclude an individual Element (and its children and ElementAspects) from the export. The base implementation always returns `true`.
      */
     shouldExportElement(_element: Element): boolean;
-    /** Called when element is skipped instead of exported. */
+    /** Called when element is skipped instead of exported.
+     * @note When an element is skipped, exporter will not export any of its child elements. Because of this, [[onSkipElement]] will not be invoked for any children of a "skipped" element.
+     */
     onSkipElement(_elementId: Id64String): void;
     /** Called when an element should be exported.
      * @param element The element to export
@@ -255,8 +256,6 @@ export declare class IModelExporter {
      *       for consecutive calls
      */
     exportChanges(args?: ExportChangesOptions): Promise<void>;
-    /** @deprecated in 0.1.x, use a single [[ExportChangesOptions]] object instead */
-    exportChanges(accessToken?: AccessToken, startChangesetId?: string, args?: ExportChangesOptions): Promise<void>;
     private _resetChangeDataOnExport;
     /** Export schemas from the source iModel.
      * @note This must be called separately from [[exportAll]] or [[exportChanges]].

package/lib/cjs/IModelExporter.d.ts.map

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

package/lib/cjs/IModelExporter.js

@@ -55,7 +55,9 @@ class IModelExportHandler {
     shouldExportElement(_element) {
         return true;
     }
-    /** Called when element is skipped instead of exported. */
+    /** Called when element is skipped instead of exported.
+     * @note When an element is skipped, exporter will not export any of its child elements. Because of this, [[onSkipElement]] will not be invoked for any children of a "skipped" element.
+     */
     onSkipElement(_elementId) { }
     /** Called when an element should be exported.
      * @param element The element to export
@@ -252,19 +254,24 @@ class IModelExporter {
         await this.exportModel(core_common_1.IModel.repositoryModelId);
         await this.exportRelationships(core_backend_1.ElementRefersToElements.classFullName);
     }
-    async exportChanges(accessTokenOrOpts, startChangesetId) {
+    /** Export changes from the source iModel.
+     * Inserts, updates, and deletes are determined by inspecting the changeset(s).
+     * @note To form a range of versions to process, set `startChangesetId` for the start (inclusive) of the desired
+     *       range and open the source iModel as of the end (inclusive) of the desired range.
+     * @note the changedInstanceIds are just for this call to exportChanges, so you must continue to pass it in
+     *       for consecutive calls
+     */
+    async exportChanges(args) {
         if (!this.sourceDb.isBriefcaseDb())
             throw new core_common_1.IModelError(core_bentley_1.IModelStatus.BadRequest, "Must be a briefcase to export changes");
         if ("" === this.sourceDb.changeset.id) {
             await this.exportAll(); // no changesets, so revert to exportAll
             return;
         }
-        const initOpts = typeof accessTokenOrOpts === "object"
-            ? accessTokenOrOpts
-            : {
-                accessToken: accessTokenOrOpts,
-                startChangeset: { id: startChangesetId },
-            };
+        const startChangeset = args && "startChangeset" in args ? args.startChangeset : undefined;
+        const initOpts = {
+            startChangeset: { id: startChangeset?.id },
+        };
         await this.initialize(initOpts);
         // _sourceDbChanges are initialized in this.initialize
         nodeAssert(this._sourceDbChanges !== undefined, "sourceDbChanges must be initialized.");
@@ -844,7 +851,6 @@ class ChangedInstanceIds {
         if ("changedInstanceIds" in opts)
             return opts.changedInstanceIds;
         const iModelId = opts.iModel.iModelId;
-        const accessToken = opts.accessToken;
         const startChangeset = "startChangeset" in opts ? opts.startChangeset : undefined;
         const changesetRanges = startChangeset !== undefined
             ? [
@@ -855,13 +861,11 @@ class ChangedInstanceIds {
                             changeset: {
                                 id: startChangeset.id ?? opts.iModel.changeset.id,
                             },
-                            accessToken,
                         })).index,
                     opts.iModel.changeset.index ??
                         (await core_backend_1.IModelHost.hubAccess.queryChangeset({
                             iModelId,
                             changeset: { id: opts.iModel.changeset.id },
-                            accessToken,
                         })).index,
                 ],
             ]
@@ -870,7 +874,6 @@ class ChangedInstanceIds {
                 : undefined;
         const csFileProps = changesetRanges !== undefined
             ? (await Promise.all(changesetRanges.map(async ([first, end]) => core_backend_1.IModelHost.hubAccess.downloadChangesets({
-                accessToken,
                 iModelId,
                 range: { first, end },
                 targetDir: core_backend_1.BriefcaseManager.getChangeSetsPath(iModelId),