@itwin/core-common 4.0.0-dev.10 → 4.0.0-dev.100

package/lib/esm/BriefcaseTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"BriefcaseTypes.js","sourceRoot":"","sources":["../../src/BriefcaseTypes.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAaH;;;GAGG;AACH,MAAM,CAAN,IAAY,gBAyBX;AAzBD,WAAY,gBAAgB;IAC1B,+CAA+C;IAC/C,sEAAoB,CAAA;IAEpB,gDAAgD;IAChD,4DAAa,CAAA;IAEb,gFAAgF;IAChF,mEAAc,CAAA;IAEd,+EAA+E;IAC/E,wEAAqC,CAAA;IAErC;;;;;;;;;;OAUG;IACH,mEAAc,CAAA;AAChB,CAAC,EAzBW,gBAAgB,KAAhB,gBAAgB,QAyB3B;AAED;;;GAGG;AACH,MAAM,CAAN,IAAY,QAOX;AAPD,WAAY,QAAQ;IAClB,mIAAmI;IACnI,uDAAgB,CAAA;IAChB,0FAA0F;IAC1F,qDAAe,CAAA;IACf,qJAAqJ;IACrJ,+CAAY,CAAA;AACd,CAAC,EAPW,QAAQ,KAAR,QAAQ,QAOnB;AA6GD;;GAEG;AACH,MAAM,CAAN,IAAY,aAYX;AAZD,WAAY,aAAa;IACvB,qJAAqJ;IACrJ,mFAAyB,CAAA;IAEzB,iKAAiK;IACjK,yFAA4B,CAAA;IAE5B,sMAAsM;IACtM,uDAAW,CAAA;IAEX,qFAAqF;IACrF,2DAAa,CAAA;AACf,CAAC,EAZW,aAAa,KAAb,aAAa,QAYxB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,cAMX;AAND,WAAY,cAAc;IACxB,0GAA0G;IAC1G,mDAAQ,CAAA;IAER,qDAAqD;IACrD,yDAAW,CAAA;AACb,CAAC,EANW,cAAc,KAAd,cAAc,QAMzB;AAaD;;;;GAIG;AACH,MAAM,CAAN,IAAY,WAkBX;AAlBD,WAAY,WAAW;IACrB,sIAAsI;IACtI,qDAAQ,CAAA;IAER;;;OAGG;IACH,mEAAe,CAAA;IAEf,4IAA4I;IAC5I,yEAAkB,CAAA;IAElB,oIAAoI;IACpI,iDAAM,CAAA;IAEN,4FAA4F;IAC5F,iDAAM,CAAA;AACR,CAAC,EAlBW,WAAW,KAAX,WAAW,QAkBtB","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module iModels\r\n */\r\n\r\nimport { GuidString } from \"@itwin/core-bentley\";\r\nimport { ChangesetIdWithIndex, LocalFileName } from \"./ChangesetProps\";\r\nimport { IModelEncryptionProps, OpenDbKey } from \"./IModel\";\r\nimport { IModelVersionProps } from \"./IModelVersion\";\r\n\r\n/** The Id assigned to a briefcase by iModelHub, or [[BriefcaseIdValue.Unassigned]] .\r\n * @public\r\n * @extensions\r\n */\r\nexport type BriefcaseId = number;\r\n\r\n/** Values of [[BriefcaseId]] that have special meaning.\r\n * @public\r\n * @extensions\r\n */\r\nexport enum BriefcaseIdValue {\r\n  /** Indicates an invalid/illegal BriefcaseId */\r\n  Illegal = 0xffffffff,\r\n\r\n  /** BriefcaseIds must be less than this value */\r\n  Max = 1 << 24,\r\n\r\n  /** All valid iModelHub issued BriefcaseIds will be equal or higher than this */\r\n  FirstValid = 2,\r\n\r\n  /** All valid iModelHub issued BriefcaseIds will be equal or lower than this */\r\n  LastValid = BriefcaseIdValue.Max - 11,\r\n\r\n  /**\r\n   * The briefcase has not been assigned a unique Id by iModelHub. Only briefcases that have been assigned a unique BriefcaseId may create changesets,\r\n   * because BriefcaseId is used to create unique ElementIds for new elements.\r\n   *\r\n   * The `Unassigned` briefcaseId is used for several purposes:\r\n   *  - **Snapshots**. Snapshot files are immutable copies of an iModel for archival or data exchange purposes. They can neither generate nor accept new changesets.\r\n   *  - **Checkpoints**. Checkpoints are Snapshots that represent a specific version on an iModel's timeline.\r\n   *  - **PullOnly**. A local briefcase file that may be used to \"slide\" along a timeline by applying incoming changesets.\r\n   * They are always opened readonly except to apply changesets.\r\n   *  - **Standalone**. Standalone iModels are local files that are not connected to iModelHub, and therefore cannot accept or create changesets.\r\n   */\r\n  Unassigned = 0,\r\n}\r\n\r\n/** Whether a briefcase is editable or may only accept incoming changesets from iModelHub\r\n * @public\r\n * @extensions\r\n */\r\nexport enum SyncMode {\r\n  /** Use a fixed version (i.e. a checkpoint). See [CheckpointManager]($backend) for preferred approach to using checkpoint files. */\r\n  FixedVersion = 1,\r\n  /** A briefcase that can be edited. A unique briefcaseId must be assigned by iModelHub. */\r\n  PullAndPush = 2,\r\n  /** use [BriefcaseIdValue.Unassigned](%backend). This makes a briefcase that can accept changesets from iModelHub but can never create changesets. */\r\n  PullOnly = 3,\r\n}\r\n\r\n/**\r\n * Options to open a previously downloaded briefcase\r\n * @public\r\n */\r\nexport interface OpenBriefcaseOptions {\r\n  /** open briefcase Readonly */\r\n  readonly openAsReadOnly?: boolean;\r\n}\r\n\r\n/**\r\n * Properties that specify a briefcase within the local briefcase cache.\r\n * @see BriefcaseManager.getFileName\r\n * @public\r\n */\r\nexport interface BriefcaseProps {\r\n  /** Id of the iModel */\r\n  readonly iModelId: GuidString;\r\n\r\n  /** BriefcaseId of the briefcase */\r\n  readonly briefcaseId: BriefcaseId;\r\n}\r\n\r\n/** Properties for opening a local briefcase file via [BriefcaseDb.open]($backend)\r\n * @public\r\n */\r\nexport interface OpenBriefcaseProps extends IModelEncryptionProps, OpenDbKey { // eslint-disable-line deprecation/deprecation\r\n  /** the full path to the briefcase file  */\r\n  readonly fileName: LocalFileName;\r\n  /** If true, open the briefcase readonly */\r\n  readonly readonly?: boolean;\r\n}\r\n\r\n/** Properties of a local briefcase file, returned by [BriefcaseManager.getCachedBriefcases]($backend) and [BriefcaseManager.downloadBriefcase]($backend)\r\n * @public\r\n * @extensions\r\n */\r\nexport interface LocalBriefcaseProps {\r\n  /** Full path of local file. */\r\n  readonly fileName: LocalFileName;\r\n\r\n  /** The iTwin containing the iModel. */\r\n  readonly iTwinId: GuidString;\r\n\r\n  /** The iModelId. */\r\n  readonly iModelId: GuidString;\r\n\r\n  /** The briefcaseId. */\r\n  readonly briefcaseId: BriefcaseId;\r\n\r\n  /** The current changesetId.\r\n   * @note ChangeSet Ids are string hash values based on the ChangeSet's content and parent.\r\n   */\r\n  readonly changeset: ChangesetIdWithIndex;\r\n\r\n  /** Size of the briefcase file in bytes  */\r\n  readonly fileSize: number;\r\n}\r\n\r\n/** Properties for downloading a briefcase to a local file, from iModelHub.\r\n * @public\r\n * @extensions\r\n */\r\nexport interface RequestNewBriefcaseProps {\r\n  /** iTwin that the iModel belongs to. */\r\n  readonly iTwinId: GuidString;\r\n\r\n  /** The iModelId for the new briefcase. */\r\n  readonly iModelId: GuidString;\r\n\r\n  /** Full path of local file to store the briefcase. If undefined, a file will be created in the briefcase cache, and this member will be filled with the full path to the file.\r\n   * Callers can use this to open the briefcase after the download completes.\r\n   * @note this member is both an input and an output.\r\n   */\r\n  readonly fileName?: LocalFileName;\r\n\r\n  /**\r\n   * The BriefcaseId for the new briefcase. If undefined, a new BriefcaseId will be acquired from iModelHub before the download, and is returned in this member.\r\n   * @note To download a briefcase that can accept but not create new changesets (sometimes referred to as \"pull only\" briefcases), set this value to [[BriefcaseIdValue.Unassigned]].\r\n   * After downloading, you can merely delete unassigned briefcase files when they are no longer needed. Assigned BriefcaseIds should be released (via [BriefcaseManager.releaseBriefcase]($backend) )\r\n   * when you are done with them.\r\n   * @note this member is both an input and an output.\r\n   *\r\n   */\r\n  briefcaseId?: BriefcaseId;\r\n\r\n  /** Id of the change set of the new briefcase. If undefined, use latest. */\r\n  asOf?: IModelVersionProps;\r\n}\r\n\r\n/**\r\n * Manages the download of a briefcase\r\n * @public\r\n */\r\nexport interface BriefcaseDownloader {\r\n  /** Id of the briefcase being downloaded */\r\n  readonly briefcaseId: BriefcaseId;\r\n\r\n  /** the name of the local file for the briefcase */\r\n  readonly fileName: LocalFileName;\r\n\r\n  /** Promise that resolves when the download completes. await this to complete the download */\r\n  readonly downloadPromise: Promise<void>;\r\n\r\n  /** Request cancellation of the download */\r\n  readonly requestCancel: () => Promise<boolean>;\r\n}\r\n\r\n/** Option to control the validation and upgrade of domain schemas in the Db\r\n * @beta\r\n */\r\nexport enum DomainOptions {\r\n  /** Domain schemas will be validated for any required upgrades. Any errors will be reported back, and cause the application to fail opening the Db */\r\n  CheckRequiredUpgrades = 0,\r\n\r\n  /** Domain schemas will be validated for any required or optional upgrades. Any errors will be reported back, and cause the application to fail opening the Db */\r\n  CheckRecommendedUpgrades = 1,\r\n\r\n  /** Domain schemas will be upgraded if necessary. However, only compatible schema upgrades will be allowed - these are typically additions of classes, properties, and changes to custom attributes */\r\n  Upgrade = 2,\r\n\r\n  /** Domain schemas will neither be validated nor be upgraded. Used only internally */\r\n  SkipCheck = 3,\r\n}\r\n\r\n/** Options that control whether a profile upgrade should be performed when opening a Db\r\n * @beta\r\n */\r\nexport enum ProfileOptions {\r\n  /** No profile upgrade will be performed. If a profile upgrade was required, opening the file will fail */\r\n  None = 0,\r\n\r\n  /** Profile upgrade will be performed if necessary */\r\n  Upgrade = 1,\r\n}\r\n\r\n/** Arguments to validate and update the profile and domain schemas when opening a Db\r\n * @beta\r\n */\r\nexport interface UpgradeOptions {\r\n  /** Option to control the validation and upgrade of domain schemas in the Db */\r\n  readonly domain?: DomainOptions;\r\n\r\n  /** Options that control whether a profile upgrade should be performed when opening a file */\r\n  readonly profile?: ProfileOptions;\r\n}\r\n\r\n/**\r\n * The state of the schemas in the Db compared with what the current version of the software expects\r\n * Note: The state may vary depending on whether the Db is to be opened ReadOnly or ReadWrite.\r\n * @beta\r\n */\r\nexport enum SchemaState {\r\n  /** The schemas in the Db are up-to-date, and do not need to be upgraded before opening it with the current version of the software */\r\n  UpToDate,\r\n\r\n  /** It's required that the schemas in the Db be upgraded before it can be opened with the current version of the software.\r\n   * This may happen in read-write scenarios where the application requires a newer version of the schemas to be in place before\r\n   * it can write data based on that new schema.\r\n   */\r\n  UpgradeRequired,\r\n\r\n  /** It's recommended, but not necessary that the schemas in the Db be upgraded before opening it with the current version of the software */\r\n  UpgradeRecommended,\r\n\r\n  /** The schemas in the Db are too old to be opened by the current version of the software. Upgrade using the API is not possible. */\r\n  TooOld,\r\n\r\n  /** The schemas in the Db are too new to be opened by the current version of the software */\r\n  TooNew,\r\n}\r\n"]}
+{"version":3,"file":"BriefcaseTypes.js","sourceRoot":"","sources":["../../src/BriefcaseTypes.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAaH;;;GAGG;AACH,MAAM,CAAN,IAAY,gBAyBX;AAzBD,WAAY,gBAAgB;IAC1B,+CAA+C;IAC/C,sEAAoB,CAAA;IAEpB,gDAAgD;IAChD,4DAAa,CAAA;IAEb,gFAAgF;IAChF,mEAAc,CAAA;IAEd,+EAA+E;IAC/E,wEAAqC,CAAA;IAErC;;;;;;;;;;OAUG;IACH,mEAAc,CAAA;AAChB,CAAC,EAzBW,gBAAgB,KAAhB,gBAAgB,QAyB3B;AAED;;;GAGG;AACH,MAAM,CAAN,IAAY,QAOX;AAPD,WAAY,QAAQ;IAClB,mIAAmI;IACnI,uDAAgB,CAAA;IAChB,0FAA0F;IAC1F,qDAAe,CAAA;IACf,qJAAqJ;IACrJ,+CAAY,CAAA;AACd,CAAC,EAPW,QAAQ,KAAR,QAAQ,QAOnB;AA6GD;;GAEG;AACH,MAAM,CAAN,IAAY,aAYX;AAZD,WAAY,aAAa;IACvB,qJAAqJ;IACrJ,mFAAyB,CAAA;IAEzB,iKAAiK;IACjK,yFAA4B,CAAA;IAE5B,sMAAsM;IACtM,uDAAW,CAAA;IAEX,qFAAqF;IACrF,2DAAa,CAAA;AACf,CAAC,EAZW,aAAa,KAAb,aAAa,QAYxB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,cAMX;AAND,WAAY,cAAc;IACxB,0GAA0G;IAC1G,mDAAQ,CAAA;IAER,qDAAqD;IACrD,yDAAW,CAAA;AACb,CAAC,EANW,cAAc,KAAd,cAAc,QAMzB;AAgBD;;;;GAIG;AACH,MAAM,CAAN,IAAY,WAkBX;AAlBD,WAAY,WAAW;IACrB,sIAAsI;IACtI,qDAAQ,CAAA;IAER;;;OAGG;IACH,mEAAe,CAAA;IAEf,4IAA4I;IAC5I,yEAAkB,CAAA;IAElB,oIAAoI;IACpI,iDAAM,CAAA;IAEN,4FAA4F;IAC5F,iDAAM,CAAA;AACR,CAAC,EAlBW,WAAW,KAAX,WAAW,QAkBtB","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module iModels\r\n */\r\n\r\nimport { GuidString } from \"@itwin/core-bentley\";\r\nimport { ChangesetIdWithIndex, LocalFileName } from \"./ChangesetProps\";\r\nimport { IModelEncryptionProps, OpenDbKey } from \"./IModel\";\r\nimport { IModelVersionProps } from \"./IModelVersion\";\r\n\r\n/** The Id assigned to a briefcase by iModelHub, or [[BriefcaseIdValue.Unassigned]] .\r\n * @public\r\n * @extensions\r\n */\r\nexport type BriefcaseId = number;\r\n\r\n/** Values of [[BriefcaseId]] that have special meaning.\r\n * @public\r\n * @extensions\r\n */\r\nexport enum BriefcaseIdValue {\r\n  /** Indicates an invalid/illegal BriefcaseId */\r\n  Illegal = 0xffffffff,\r\n\r\n  /** BriefcaseIds must be less than this value */\r\n  Max = 1 << 24,\r\n\r\n  /** All valid iModelHub issued BriefcaseIds will be equal or higher than this */\r\n  FirstValid = 2,\r\n\r\n  /** All valid iModelHub issued BriefcaseIds will be equal or lower than this */\r\n  LastValid = BriefcaseIdValue.Max - 11,\r\n\r\n  /**\r\n   * The briefcase has not been assigned a unique Id by iModelHub. Only briefcases that have been assigned a unique BriefcaseId may create changesets,\r\n   * because BriefcaseId is used to create unique ElementIds for new elements.\r\n   *\r\n   * The `Unassigned` briefcaseId is used for several purposes:\r\n   *  - **Snapshots**. Snapshot files are immutable copies of an iModel for archival or data exchange purposes. They can neither generate nor accept new changesets.\r\n   *  - **Checkpoints**. Checkpoints are Snapshots that represent a specific version on an iModel's timeline.\r\n   *  - **PullOnly**. A local briefcase file that may be used to \"slide\" along a timeline by applying incoming changesets.\r\n   * They are always opened readonly except to apply changesets.\r\n   *  - **Standalone**. Standalone iModels are local files that are not connected to iModelHub, and therefore cannot accept or create changesets.\r\n   */\r\n  Unassigned = 0,\r\n}\r\n\r\n/** Whether a briefcase is editable or may only accept incoming changesets from iModelHub\r\n * @public\r\n * @extensions\r\n */\r\nexport enum SyncMode {\r\n  /** Use a fixed version (i.e. a checkpoint). See [CheckpointManager]($backend) for preferred approach to using checkpoint files. */\r\n  FixedVersion = 1,\r\n  /** A briefcase that can be edited. A unique briefcaseId must be assigned by iModelHub. */\r\n  PullAndPush = 2,\r\n  /** use [BriefcaseIdValue.Unassigned](%backend). This makes a briefcase that can accept changesets from iModelHub but can never create changesets. */\r\n  PullOnly = 3,\r\n}\r\n\r\n/**\r\n * Options to open a previously downloaded briefcase\r\n * @public\r\n */\r\nexport interface OpenBriefcaseOptions {\r\n  /** open briefcase Readonly */\r\n  readonly openAsReadOnly?: boolean;\r\n}\r\n\r\n/**\r\n * Properties that specify a briefcase within the local briefcase cache.\r\n * @see BriefcaseManager.getFileName\r\n * @public\r\n */\r\nexport interface BriefcaseProps {\r\n  /** Id of the iModel */\r\n  readonly iModelId: GuidString;\r\n\r\n  /** BriefcaseId of the briefcase */\r\n  readonly briefcaseId: BriefcaseId;\r\n}\r\n\r\n/** Properties for opening a local briefcase file via [BriefcaseDb.open]($backend)\r\n * @public\r\n */\r\nexport interface OpenBriefcaseProps extends IModelEncryptionProps, OpenDbKey { // eslint-disable-line deprecation/deprecation\r\n  /** the full path to the briefcase file  */\r\n  readonly fileName: LocalFileName;\r\n  /** If true, open the briefcase readonly */\r\n  readonly readonly?: boolean;\r\n}\r\n\r\n/** Properties of a local briefcase file, returned by [BriefcaseManager.getCachedBriefcases]($backend) and [BriefcaseManager.downloadBriefcase]($backend)\r\n * @public\r\n * @extensions\r\n */\r\nexport interface LocalBriefcaseProps {\r\n  /** Full path of local file. */\r\n  readonly fileName: LocalFileName;\r\n\r\n  /** The iTwin containing the iModel. */\r\n  readonly iTwinId: GuidString;\r\n\r\n  /** The iModelId. */\r\n  readonly iModelId: GuidString;\r\n\r\n  /** The briefcaseId. */\r\n  readonly briefcaseId: BriefcaseId;\r\n\r\n  /** The current changesetId.\r\n   * @note ChangeSet Ids are string hash values based on the ChangeSet's content and parent.\r\n   */\r\n  readonly changeset: ChangesetIdWithIndex;\r\n\r\n  /** Size of the briefcase file in bytes  */\r\n  readonly fileSize: number;\r\n}\r\n\r\n/** Properties for downloading a briefcase to a local file, from iModelHub.\r\n * @public\r\n * @extensions\r\n */\r\nexport interface RequestNewBriefcaseProps {\r\n  /** iTwin that the iModel belongs to. */\r\n  readonly iTwinId: GuidString;\r\n\r\n  /** The iModelId for the new briefcase. */\r\n  readonly iModelId: GuidString;\r\n\r\n  /** Full path of local file to store the briefcase. If undefined, a file will be created in the briefcase cache, and this member will be filled with the full path to the file.\r\n   * Callers can use this to open the briefcase after the download completes.\r\n   * @note this member is both an input and an output.\r\n   */\r\n  readonly fileName?: LocalFileName;\r\n\r\n  /**\r\n   * The BriefcaseId for the new briefcase. If undefined, a new BriefcaseId will be acquired from iModelHub before the download, and is returned in this member.\r\n   * @note To download a briefcase that can accept but not create new changesets (sometimes referred to as \"pull only\" briefcases), set this value to [[BriefcaseIdValue.Unassigned]].\r\n   * After downloading, you can merely delete unassigned briefcase files when they are no longer needed. Assigned BriefcaseIds should be released (via [BriefcaseManager.releaseBriefcase]($backend) )\r\n   * when you are done with them.\r\n   * @note this member is both an input and an output.\r\n   *\r\n   */\r\n  briefcaseId?: BriefcaseId;\r\n\r\n  /** Id of the change set of the new briefcase. If undefined, use latest. */\r\n  asOf?: IModelVersionProps;\r\n}\r\n\r\n/**\r\n * Manages the download of a briefcase\r\n * @public\r\n */\r\nexport interface BriefcaseDownloader {\r\n  /** Id of the briefcase being downloaded */\r\n  readonly briefcaseId: BriefcaseId;\r\n\r\n  /** the name of the local file for the briefcase */\r\n  readonly fileName: LocalFileName;\r\n\r\n  /** Promise that resolves when the download completes. await this to complete the download */\r\n  readonly downloadPromise: Promise<void>;\r\n\r\n  /** Request cancellation of the download */\r\n  readonly requestCancel: () => Promise<boolean>;\r\n}\r\n\r\n/** Option to control the validation and upgrade of domain schemas in the Db\r\n * @beta\r\n */\r\nexport enum DomainOptions {\r\n  /** Domain schemas will be validated for any required upgrades. Any errors will be reported back, and cause the application to fail opening the Db */\r\n  CheckRequiredUpgrades = 0,\r\n\r\n  /** Domain schemas will be validated for any required or optional upgrades. Any errors will be reported back, and cause the application to fail opening the Db */\r\n  CheckRecommendedUpgrades = 1,\r\n\r\n  /** Domain schemas will be upgraded if necessary. However, only compatible schema upgrades will be allowed - these are typically additions of classes, properties, and changes to custom attributes */\r\n  Upgrade = 2,\r\n\r\n  /** Domain schemas will neither be validated nor be upgraded. Used only internally */\r\n  SkipCheck = 3,\r\n}\r\n\r\n/** Options that control whether a profile upgrade should be performed when opening a Db\r\n * @beta\r\n */\r\nexport enum ProfileOptions {\r\n  /** No profile upgrade will be performed. If a profile upgrade was required, opening the file will fail */\r\n  None = 0,\r\n\r\n  /** Profile upgrade will be performed if necessary */\r\n  Upgrade = 1,\r\n}\r\n\r\n/** Arguments to validate and update the profile and domain schemas when opening a Db\r\n * @beta\r\n */\r\nexport interface UpgradeOptions {\r\n  /** Option to control the validation and upgrade of domain schemas in the Db */\r\n  readonly domain?: DomainOptions;\r\n\r\n  /** Options that control whether a profile upgrade should be performed when opening a file */\r\n  readonly profile?: ProfileOptions;\r\n\r\n  /** Options that will allow data transform during Profile/Domain schema upgrade */\r\n  readonly schemaLockHeld?: boolean;\r\n}\r\n\r\n/**\r\n * The state of the schemas in the Db compared with what the current version of the software expects\r\n * Note: The state may vary depending on whether the Db is to be opened ReadOnly or ReadWrite.\r\n * @beta\r\n */\r\nexport enum SchemaState {\r\n  /** The schemas in the Db are up-to-date, and do not need to be upgraded before opening it with the current version of the software */\r\n  UpToDate,\r\n\r\n  /** It's required that the schemas in the Db be upgraded before it can be opened with the current version of the software.\r\n   * This may happen in read-write scenarios where the application requires a newer version of the schemas to be in place before\r\n   * it can write data based on that new schema.\r\n   */\r\n  UpgradeRequired,\r\n\r\n  /** It's recommended, but not necessary that the schemas in the Db be upgraded before opening it with the current version of the software */\r\n  UpgradeRecommended,\r\n\r\n  /** The schemas in the Db are too old to be opened by the current version of the software. Upgrade using the API is not possible. */\r\n  TooOld,\r\n\r\n  /** The schemas in the Db are too new to be opened by the current version of the software */\r\n  TooNew,\r\n}\r\n"]}

package/lib/esm/Camera.d.ts

@@ -1,43 +1,43 @@
-/** @packageDocumentation
- * @module Views
- */
-import { Angle, AngleProps, Point3d, XYAndZ, XYZProps } from "@itwin/core-geometry";
-/** JSON representation of a [[Camera]].
- * @public
- * @extensions
- */
-export interface CameraProps {
-    lens: AngleProps;
-    focusDist: number;
-    eye: XYZProps;
-}
-/** The current position (eyepoint), lens angle, and focus distance of a camera.
- * @see [Views]($docs/learning/frontend/Views.md)
- * @public
- */
-export declare class Camera implements CameraProps {
-    readonly lens: Angle;
-    focusDist: number;
-    readonly eye: Point3d;
-    static isValidLensAngle(val: Angle): boolean;
-    static validateLensAngle(val: Angle): void;
-    invalidateFocus(): void;
-    get isFocusValid(): boolean;
-    getFocusDistance(): number;
-    setFocusDistance(dist: number): void;
-    get isLensValid(): boolean;
-    validateLens(): void;
-    getLensAngle(): Angle;
-    setLensAngle(angle: Angle): void;
-    getEyePoint(): Point3d;
-    setEyePoint(pt: XYAndZ): void;
-    get isValid(): boolean;
-    equals(other: Camera): boolean;
-    clone(): Camera;
-    setFrom(rhs: Camera): void;
-    /** Construct a Camera
-     * @param props The properties of the new camera. If undefined, create a camera with eye at {0,0,0}, 90 degree lens, 1 meter focus distance.
-     */
-    constructor(props?: CameraProps);
-}
+/** @packageDocumentation
+ * @module Views
+ */
+import { Angle, AngleProps, Point3d, XYAndZ, XYZProps } from "@itwin/core-geometry";
+/** JSON representation of a [[Camera]].
+ * @public
+ * @extensions
+ */
+export interface CameraProps {
+    lens: AngleProps;
+    focusDist: number;
+    eye: XYZProps;
+}
+/** The current position (eyepoint), lens angle, and focus distance of a camera.
+ * @see [Views]($docs/learning/frontend/Views.md)
+ * @public
+ */
+export declare class Camera implements CameraProps {
+    readonly lens: Angle;
+    focusDist: number;
+    readonly eye: Point3d;
+    static isValidLensAngle(val: Angle): boolean;
+    static validateLensAngle(val: Angle): void;
+    invalidateFocus(): void;
+    get isFocusValid(): boolean;
+    getFocusDistance(): number;
+    setFocusDistance(dist: number): void;
+    get isLensValid(): boolean;
+    validateLens(): void;
+    getLensAngle(): Angle;
+    setLensAngle(angle: Angle): void;
+    getEyePoint(): Point3d;
+    setEyePoint(pt: XYAndZ): void;
+    get isValid(): boolean;
+    equals(other: Camera): boolean;
+    clone(): Camera;
+    setFrom(rhs: Camera): void;
+    /** Construct a Camera
+     * @param props The properties of the new camera. If undefined, create a camera with eye at {0,0,0}, 90 degree lens, 1 meter focus distance.
+     */
+    constructor(props?: CameraProps);
+}
 //# sourceMappingURL=Camera.d.ts.map

package/lib/esm/Camera.js

@@ -1,59 +1,59 @@
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module Views
- */
-import { JsonUtils } from "@itwin/core-bentley";
-import { Angle, Point3d } from "@itwin/core-geometry";
-/** The current position (eyepoint), lens angle, and focus distance of a camera.
- * @see [Views]($docs/learning/frontend/Views.md)
- * @public
- */
-export class Camera {
-    /** Construct a Camera
-     * @param props The properties of the new camera. If undefined, create a camera with eye at {0,0,0}, 90 degree lens, 1 meter focus distance.
-     */
-    constructor(props) {
-        if (props !== undefined) {
-            this.lens = Angle.fromJSON(props.lens);
-            this.focusDist = JsonUtils.asDouble(props.focusDist);
-            this.eye = Point3d.fromJSON(props.eye);
-            return;
-        }
-        this.lens = Angle.createRadians(Math.PI / 2.0);
-        this.focusDist = 1;
-        this.eye = new Point3d();
-    }
-    static isValidLensAngle(val) {
-        return val.radians > (Math.PI / 8.0) && val.radians < Math.PI;
-    }
-    static validateLensAngle(val) {
-        if (!this.isValidLensAngle(val))
-            val.setRadians(Math.PI / 2.0);
-    }
-    invalidateFocus() { this.focusDist = 0.0; }
-    get isFocusValid() { return this.focusDist > 0.0 && this.focusDist < 1.0e14; }
-    getFocusDistance() { return this.focusDist; }
-    setFocusDistance(dist) { this.focusDist = dist; }
-    get isLensValid() { return Camera.isValidLensAngle(this.lens); }
-    validateLens() { Camera.validateLensAngle(this.lens); }
-    getLensAngle() { return this.lens; }
-    setLensAngle(angle) { this.lens.setFrom(angle); }
-    getEyePoint() { return this.eye; }
-    setEyePoint(pt) { this.eye.setFrom(pt); }
-    get isValid() { return this.isLensValid && this.isFocusValid; }
-    equals(other) {
-        return Math.abs(this.lens.radians - other.lens.radians) < .01 &&
-            Math.abs(this.focusDist - other.focusDist) < .1 &&
-            this.eye.isAlmostEqual(other.eye);
-    }
-    clone() { return new Camera(this); }
-    setFrom(rhs) {
-        this.lens.setFrom(rhs.lens);
-        this.focusDist = rhs.focusDist;
-        this.eye.setFrom(rhs.eye);
-    }
-}
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Views
+ */
+import { JsonUtils } from "@itwin/core-bentley";
+import { Angle, Point3d } from "@itwin/core-geometry";
+/** The current position (eyepoint), lens angle, and focus distance of a camera.
+ * @see [Views]($docs/learning/frontend/Views.md)
+ * @public
+ */
+export class Camera {
+    static isValidLensAngle(val) {
+        return val.radians > (Math.PI / 8.0) && val.radians < Math.PI;
+    }
+    static validateLensAngle(val) {
+        if (!this.isValidLensAngle(val))
+            val.setRadians(Math.PI / 2.0);
+    }
+    invalidateFocus() { this.focusDist = 0.0; }
+    get isFocusValid() { return this.focusDist > 0.0 && this.focusDist < 1.0e14; }
+    getFocusDistance() { return this.focusDist; }
+    setFocusDistance(dist) { this.focusDist = dist; }
+    get isLensValid() { return Camera.isValidLensAngle(this.lens); }
+    validateLens() { Camera.validateLensAngle(this.lens); }
+    getLensAngle() { return this.lens; }
+    setLensAngle(angle) { this.lens.setFrom(angle); }
+    getEyePoint() { return this.eye; }
+    setEyePoint(pt) { this.eye.setFrom(pt); }
+    get isValid() { return this.isLensValid && this.isFocusValid; }
+    equals(other) {
+        return Math.abs(this.lens.radians - other.lens.radians) < .01 &&
+            Math.abs(this.focusDist - other.focusDist) < .1 &&
+            this.eye.isAlmostEqual(other.eye);
+    }
+    clone() { return new Camera(this); }
+    setFrom(rhs) {
+        this.lens.setFrom(rhs.lens);
+        this.focusDist = rhs.focusDist;
+        this.eye.setFrom(rhs.eye);
+    }
+    /** Construct a Camera
+     * @param props The properties of the new camera. If undefined, create a camera with eye at {0,0,0}, 90 degree lens, 1 meter focus distance.
+     */
+    constructor(props) {
+        if (props !== undefined) {
+            this.lens = Angle.fromJSON(props.lens);
+            this.focusDist = JsonUtils.asDouble(props.focusDist);
+            this.eye = Point3d.fromJSON(props.eye);
+            return;
+        }
+        this.lens = Angle.createRadians(Math.PI / 2.0);
+        this.focusDist = 1;
+        this.eye = new Point3d();
+    }
+}
 //# sourceMappingURL=Camera.js.map

package/lib/esm/Camera.js.map

@@ -1 +1 @@
-{"version":3,"file":"Camera.js","sourceRoot":"","sources":["../../src/Camera.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Views\r\n */\r\n\r\nimport { JsonUtils } from \"@itwin/core-bentley\";\r\nimport { Angle, AngleProps, Point3d, XYAndZ, XYZProps } from \"@itwin/core-geometry\";\r\n\r\n/** JSON representation of a [[Camera]].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface CameraProps {\r\n  lens: AngleProps;\r\n  focusDist: number; // NOTE: this is abbreviated, do not change!\r\n  eye: XYZProps;\r\n}\r\n\r\n/** The current position (eyepoint), lens angle, and focus distance of a camera.\r\n * @see [Views]($docs/learning/frontend/Views.md)\r\n * @public\r\n */\r\nexport class Camera implements CameraProps {\r\n  public readonly lens: Angle;\r\n  public focusDist: number;\r\n  public readonly eye: Point3d;\r\n\r\n  public static isValidLensAngle(val: Angle) {\r\n    return val.radians > (Math.PI / 8.0) && val.radians < Math.PI;\r\n  }\r\n\r\n  public static validateLensAngle(val: Angle) {\r\n    if (!this.isValidLensAngle(val))\r\n      val.setRadians(Math.PI / 2.0);\r\n  }\r\n\r\n  public invalidateFocus() { this.focusDist = 0.0; }\r\n  public get isFocusValid() { return this.focusDist > 0.0 && this.focusDist < 1.0e14; }\r\n  public getFocusDistance() { return this.focusDist; }\r\n  public setFocusDistance(dist: number) { this.focusDist = dist; }\r\n  public get isLensValid() { return Camera.isValidLensAngle(this.lens); }\r\n  public validateLens() { Camera.validateLensAngle(this.lens); }\r\n  public getLensAngle() { return this.lens; }\r\n  public setLensAngle(angle: Angle) { this.lens.setFrom(angle); }\r\n  public getEyePoint() { return this.eye; }\r\n  public setEyePoint(pt: XYAndZ) { this.eye.setFrom(pt); }\r\n  public get isValid() { return this.isLensValid && this.isFocusValid; }\r\n  public equals(other: Camera) {\r\n    return Math.abs(this.lens.radians - other.lens.radians) < .01 &&\r\n      Math.abs(this.focusDist - other.focusDist) < .1 &&\r\n      this.eye.isAlmostEqual(other.eye);\r\n  }\r\n  public clone() { return new Camera(this); }\r\n  public setFrom(rhs: Camera) {\r\n    this.lens.setFrom(rhs.lens);\r\n    this.focusDist = rhs.focusDist;\r\n    this.eye.setFrom(rhs.eye);\r\n  }\r\n\r\n  /** Construct a Camera\r\n   * @param props The properties of the new camera. If undefined, create a camera with eye at {0,0,0}, 90 degree lens, 1 meter focus distance.\r\n   */\r\n  public constructor(props?: CameraProps) {\r\n    if (props !== undefined) {\r\n      this.lens = Angle.fromJSON(props.lens);\r\n      this.focusDist = JsonUtils.asDouble(props.focusDist);\r\n      this.eye = Point3d.fromJSON(props.eye);\r\n      return;\r\n    }\r\n    this.lens = Angle.createRadians(Math.PI / 2.0);\r\n    this.focusDist = 1;\r\n    this.eye = new Point3d();\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"Camera.js","sourceRoot":"","sources":["../../src/Camera.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,KAAK,EAAc,OAAO,EAAoB,MAAM,sBAAsB,CAAC;AAYpF;;;GAGG;AACH,MAAM,OAAO,MAAM;IAKV,MAAM,CAAC,gBAAgB,CAAC,GAAU;QACvC,OAAO,GAAG,CAAC,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,CAAC,IAAI,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC;IAChE,CAAC;IAEM,MAAM,CAAC,iBAAiB,CAAC,GAAU;QACxC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC;YAC7B,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC;IAClC,CAAC;IAEM,eAAe,KAAK,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,CAAC;IAClD,IAAW,YAAY,KAAK,OAAO,IAAI,CAAC,SAAS,GAAG,GAAG,IAAI,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC;IAC9E,gBAAgB,KAAK,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IAC7C,gBAAgB,CAAC,IAAY,IAAI,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC;IAChE,IAAW,WAAW,KAAK,OAAO,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChE,YAAY,KAAK,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACvD,YAAY,KAAK,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACpC,YAAY,CAAC,KAAY,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACxD,WAAW,KAAK,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAClC,WAAW,CAAC,EAAU,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACxD,IAAW,OAAO,KAAK,OAAO,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;IAC/D,MAAM,CAAC,KAAa;QACzB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,GAAG;YAC3D,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;YAC/C,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;IACM,KAAK,KAAK,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpC,OAAO,CAAC,GAAW;QACxB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC;QAC/B,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,YAAmB,KAAmB;QACpC,IAAI,KAAK,KAAK,SAAS,EAAE;YACvB,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACvC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YACrD,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACvC,OAAO;SACR;QACD,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC;QAC/C,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC,GAAG,GAAG,IAAI,OAAO,EAAE,CAAC;IAC3B,CAAC;CACF","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Views\r\n */\r\n\r\nimport { JsonUtils } from \"@itwin/core-bentley\";\r\nimport { Angle, AngleProps, Point3d, XYAndZ, XYZProps } from \"@itwin/core-geometry\";\r\n\r\n/** JSON representation of a [[Camera]].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface CameraProps {\r\n  lens: AngleProps;\r\n  focusDist: number; // NOTE: this is abbreviated, do not change!\r\n  eye: XYZProps;\r\n}\r\n\r\n/** The current position (eyepoint), lens angle, and focus distance of a camera.\r\n * @see [Views]($docs/learning/frontend/Views.md)\r\n * @public\r\n */\r\nexport class Camera implements CameraProps {\r\n  public readonly lens: Angle;\r\n  public focusDist: number;\r\n  public readonly eye: Point3d;\r\n\r\n  public static isValidLensAngle(val: Angle) {\r\n    return val.radians > (Math.PI / 8.0) && val.radians < Math.PI;\r\n  }\r\n\r\n  public static validateLensAngle(val: Angle) {\r\n    if (!this.isValidLensAngle(val))\r\n      val.setRadians(Math.PI / 2.0);\r\n  }\r\n\r\n  public invalidateFocus() { this.focusDist = 0.0; }\r\n  public get isFocusValid() { return this.focusDist > 0.0 && this.focusDist < 1.0e14; }\r\n  public getFocusDistance() { return this.focusDist; }\r\n  public setFocusDistance(dist: number) { this.focusDist = dist; }\r\n  public get isLensValid() { return Camera.isValidLensAngle(this.lens); }\r\n  public validateLens() { Camera.validateLensAngle(this.lens); }\r\n  public getLensAngle() { return this.lens; }\r\n  public setLensAngle(angle: Angle) { this.lens.setFrom(angle); }\r\n  public getEyePoint() { return this.eye; }\r\n  public setEyePoint(pt: XYAndZ) { this.eye.setFrom(pt); }\r\n  public get isValid() { return this.isLensValid && this.isFocusValid; }\r\n  public equals(other: Camera) {\r\n    return Math.abs(this.lens.radians - other.lens.radians) < .01 &&\r\n      Math.abs(this.focusDist - other.focusDist) < .1 &&\r\n      this.eye.isAlmostEqual(other.eye);\r\n  }\r\n  public clone() { return new Camera(this); }\r\n  public setFrom(rhs: Camera) {\r\n    this.lens.setFrom(rhs.lens);\r\n    this.focusDist = rhs.focusDist;\r\n    this.eye.setFrom(rhs.eye);\r\n  }\r\n\r\n  /** Construct a Camera\r\n   * @param props The properties of the new camera. If undefined, create a camera with eye at {0,0,0}, 90 degree lens, 1 meter focus distance.\r\n   */\r\n  public constructor(props?: CameraProps) {\r\n    if (props !== undefined) {\r\n      this.lens = Angle.fromJSON(props.lens);\r\n      this.focusDist = JsonUtils.asDouble(props.focusDist);\r\n      this.eye = Point3d.fromJSON(props.eye);\r\n      return;\r\n    }\r\n    this.lens = Angle.createRadians(Math.PI / 2.0);\r\n    this.focusDist = 1;\r\n    this.eye = new Point3d();\r\n  }\r\n}\r\n"]}

package/lib/esm/ChangedElements.d.ts

@@ -1,86 +1,86 @@
-/**
- * @packageDocumentation
- * @module Entities
- */
-import { DbOpcode, Id64String } from "@itwin/core-bentley";
-import { AxisAlignedBox3dProps } from "./geometry/Placement";
-/** Bitflags describing which aspects of an [Element]($backend) changed as part of a [[ChangedElements]].
- * @public
- * @extensions
- */
-export declare enum TypeOfChange {
-    /** A property in the element changed */
-    Property = 1,
-    /** The geometry stream of a [GeometricElement]($backend) changed */
-    Geometry = 2,
-    /** The [[Placement]] of a [GeometricElement]($backend) changed */
-    Placement = 4,
-    /** Indirect change occurred to this element by a related instance */
-    Indirect = 8,
-    /** Hidden properties of the element changed */
-    Hidden = 16,
-    /** The top-most parent of the element has changed */
-    Parent = 32
-}
-/** Changed elements found in a changeset or between a range of changesets.
- * All arrays in this object will have the same number of items.
- * Each index for those arrays refer to the same element, e.g. to get the class Id of
- * the element given by element Id changedElements.elements[index], you can use changedElements.classIds[index].
- * @public
- * @extensions
- */
-export interface ChangedElements {
-    /** Ids of elements that changed */
-    elements: Id64String[];
-    /** ECClass Ids of elements that changed */
-    classIds: Id64String[];
-    /** Operation that occurred on the element. Whether the element was inserted, updated or deleted.
-     * See [DbOpcode]($core-bentley)
-     */
-    opcodes: DbOpcode[];
-    /** Type of change bitflags, see [[TypeOfChange]] */
-    type: TypeOfChange[];
-    /** Model Ids of the changed elements
-     * This may be undefined if the agent that did the processing job did not export model Ids
-     */
-    modelIds?: Id64String[];
-    /** Property accessor strings of properties that changed, if any, for each changed element
-     * This may be undefined if the agent that did the processing job did not export properties
-    */
-    properties?: string[][];
-    /** Before state checksums of the property value
-     * Useful to determine if property values have changed
-     * between the versions being inspected
-     * This may be undefined if the agent that did the processing job did not export checksums
-     */
-    oldChecksums?: number[][];
-    /** After state checksums of the property value
-     * Useful to determine if property values have changed
-     * between the versions being inspected
-     * This may be undefined if the agent that did the processing job did not export checksums
-     */
-    newChecksums?: number[][];
-    /**
-     * Parent ids of the changed elements
-     * Will be "0" if the element has no parent
-     * This may be undefined if the agent that did the processing job did not export parent information
-     */
-    parentIds?: Id64String[];
-    /**
-     * Parent ECClass Ids of the changed elements
-     * Will be "0" if the element has no parent
-     * This may be undefined if the agent that did the processing job did not export parent information
-     */
-    parentClassIds?: Id64String[];
-}
-/** @internal */
-export interface ChangedModels {
-    modelIds: Id64String[];
-    bboxes: AxisAlignedBox3dProps[];
-}
-/** @internal */
-export interface ChangeData {
-    changedElements: ChangedElements;
-    changedModels: ChangedModels;
-}
+/**
+ * @packageDocumentation
+ * @module Entities
+ */
+import { DbOpcode, Id64String } from "@itwin/core-bentley";
+import { AxisAlignedBox3dProps } from "./geometry/Placement";
+/** Bitflags describing which aspects of an [Element]($backend) changed as part of a [[ChangedElements]].
+ * @public
+ * @extensions
+ */
+export declare enum TypeOfChange {
+    /** A property in the element changed */
+    Property = 1,
+    /** The geometry stream of a [GeometricElement]($backend) changed */
+    Geometry = 2,
+    /** The [[Placement]] of a [GeometricElement]($backend) changed */
+    Placement = 4,
+    /** Indirect change occurred to this element by a related instance */
+    Indirect = 8,
+    /** Hidden properties of the element changed */
+    Hidden = 16,
+    /** The top-most parent of the element has changed */
+    Parent = 32
+}
+/** Changed elements found in a changeset or between a range of changesets.
+ * All arrays in this object will have the same number of items.
+ * Each index for those arrays refer to the same element, e.g. to get the class Id of
+ * the element given by element Id changedElements.elements[index], you can use changedElements.classIds[index].
+ * @public
+ * @extensions
+ */
+export interface ChangedElements {
+    /** Ids of elements that changed */
+    elements: Id64String[];
+    /** ECClass Ids of elements that changed */
+    classIds: Id64String[];
+    /** Operation that occurred on the element. Whether the element was inserted, updated or deleted.
+     * See [DbOpcode]($core-bentley)
+     */
+    opcodes: DbOpcode[];
+    /** Type of change bitflags, see [[TypeOfChange]] */
+    type: TypeOfChange[];
+    /** Model Ids of the changed elements
+     * This may be undefined if the agent that did the processing job did not export model Ids
+     */
+    modelIds?: Id64String[];
+    /** Property accessor strings of properties that changed, if any, for each changed element
+     * This may be undefined if the agent that did the processing job did not export properties
+    */
+    properties?: string[][];
+    /** Before state checksums of the property value
+     * Useful to determine if property values have changed
+     * between the versions being inspected
+     * This may be undefined if the agent that did the processing job did not export checksums
+     */
+    oldChecksums?: number[][];
+    /** After state checksums of the property value
+     * Useful to determine if property values have changed
+     * between the versions being inspected
+     * This may be undefined if the agent that did the processing job did not export checksums
+     */
+    newChecksums?: number[][];
+    /**
+     * Parent ids of the changed elements
+     * Will be "0" if the element has no parent
+     * This may be undefined if the agent that did the processing job did not export parent information
+     */
+    parentIds?: Id64String[];
+    /**
+     * Parent ECClass Ids of the changed elements
+     * Will be "0" if the element has no parent
+     * This may be undefined if the agent that did the processing job did not export parent information
+     */
+    parentClassIds?: Id64String[];
+}
+/** @internal */
+export interface ChangedModels {
+    modelIds: Id64String[];
+    bboxes: AxisAlignedBox3dProps[];
+}
+/** @internal */
+export interface ChangeData {
+    changedElements: ChangedElements;
+    changedModels: ChangedModels;
+}
 //# sourceMappingURL=ChangedElements.d.ts.map

package/lib/esm/ChangedElements.js

@@ -1,21 +1,21 @@
-// cspell:ignore bboxes
-/** Bitflags describing which aspects of an [Element]($backend) changed as part of a [[ChangedElements]].
- * @public
- * @extensions
- */
-export var TypeOfChange;
-(function (TypeOfChange) {
-    /** A property in the element changed */
-    TypeOfChange[TypeOfChange["Property"] = 1] = "Property";
-    /** The geometry stream of a [GeometricElement]($backend) changed */
-    TypeOfChange[TypeOfChange["Geometry"] = 2] = "Geometry";
-    /** The [[Placement]] of a [GeometricElement]($backend) changed */
-    TypeOfChange[TypeOfChange["Placement"] = 4] = "Placement";
-    /** Indirect change occurred to this element by a related instance */
-    TypeOfChange[TypeOfChange["Indirect"] = 8] = "Indirect";
-    /** Hidden properties of the element changed */
-    TypeOfChange[TypeOfChange["Hidden"] = 16] = "Hidden";
-    /** The top-most parent of the element has changed */
-    TypeOfChange[TypeOfChange["Parent"] = 32] = "Parent";
-})(TypeOfChange || (TypeOfChange = {}));
+// cspell:ignore bboxes
+/** Bitflags describing which aspects of an [Element]($backend) changed as part of a [[ChangedElements]].
+ * @public
+ * @extensions
+ */
+export var TypeOfChange;
+(function (TypeOfChange) {
+    /** A property in the element changed */
+    TypeOfChange[TypeOfChange["Property"] = 1] = "Property";
+    /** The geometry stream of a [GeometricElement]($backend) changed */
+    TypeOfChange[TypeOfChange["Geometry"] = 2] = "Geometry";
+    /** The [[Placement]] of a [GeometricElement]($backend) changed */
+    TypeOfChange[TypeOfChange["Placement"] = 4] = "Placement";
+    /** Indirect change occurred to this element by a related instance */
+    TypeOfChange[TypeOfChange["Indirect"] = 8] = "Indirect";
+    /** Hidden properties of the element changed */
+    TypeOfChange[TypeOfChange["Hidden"] = 16] = "Hidden";
+    /** The top-most parent of the element has changed */
+    TypeOfChange[TypeOfChange["Parent"] = 32] = "Parent";
+})(TypeOfChange || (TypeOfChange = {}));
 //# sourceMappingURL=ChangedElements.js.map

package/lib/esm/ChangedEntities.d.ts

@@ -1,46 +1,46 @@
-/** @packageDocumentation
- * @module NativeApp
- */
-import { CompressedId64Set, Id64String } from "@itwin/core-bentley";
-/** Describes an [Entity]($backend) and its [ECClass]($docs/bis/guide/references/glossary/#ecclass) by Id.
- * @public
- * @extensions
- */
-export interface EntityIdAndClassId {
-    /** The entity's Id. */
-    id: Id64String;
-    /** The Id of the entity's ECClass. */
-    classId: Id64String;
-}
-/** JSON representation of the set of [Element]($backend)s or [Model]($backend)s that were changed by a [Txn]($docs/learning/InteractiveEditing.md).
- * @see [TxnManager.onElementsChanged]($backend) and [TxnManager.onModelsChanged]($backend).
- * @see [BriefcaseTxns.onElementsChanged]($frontend) and [BriefcaseTxns.onModelsChanged]($frontend).
- * @public
- * @extensions
- */
-export interface ChangedEntities {
-    /** The ids of entities that were inserted during the Txn. */
-    inserted?: CompressedId64Set;
-    /** The ids of entities that were deleted during the Txn. */
-    deleted?: CompressedId64Set;
-    /** The ids of entities that were modified during the Txn, including any [Element]($backend)s for which one of their [ElementAspect]($backend)s was changed. */
-    updated?: CompressedId64Set;
-}
-/** A collection of [[EntityIdAndClassId]]s, as used by [TxnChangedEntities]($backend).
- * For efficiency, the iterator supplied by this iterable returns **the same `EntityIdAndClassId` object** on each iteration. Therefore the objects must be copied if you
- * intend to store references to them. For example, to populate an array from the iterable:
- * ```ts
- *  function arrayFromIterable(entities: EntityIdAndClassIdIterable): EntityIdAndClassId[] {
- *    // NO! return Array.from(entities);
- *    const array = [];
- *    for (const entity of entities)
- *      array.push({...entity});
- *
- *    return array;
- *  }
- * ```
- * @public
- * @extensions
- */
-export declare type EntityIdAndClassIdIterable = Iterable<Readonly<EntityIdAndClassId>>;
+/** @packageDocumentation
+ * @module NativeApp
+ */
+import { CompressedId64Set, Id64String } from "@itwin/core-bentley";
+/** Describes an [Entity]($backend) and its [ECClass]($docs/bis/guide/references/glossary/#ecclass) by Id.
+ * @public
+ * @extensions
+ */
+export interface EntityIdAndClassId {
+    /** The entity's Id. */
+    id: Id64String;
+    /** The Id of the entity's ECClass. */
+    classId: Id64String;
+}
+/** JSON representation of the set of [Element]($backend)s or [Model]($backend)s that were changed by a [Txn]($docs/learning/InteractiveEditing.md).
+ * @see [TxnManager.onElementsChanged]($backend) and [TxnManager.onModelsChanged]($backend).
+ * @see [BriefcaseTxns.onElementsChanged]($frontend) and [BriefcaseTxns.onModelsChanged]($frontend).
+ * @public
+ * @extensions
+ */
+export interface ChangedEntities {
+    /** The ids of entities that were inserted during the Txn. */
+    inserted?: CompressedId64Set;
+    /** The ids of entities that were deleted during the Txn. */
+    deleted?: CompressedId64Set;
+    /** The ids of entities that were modified during the Txn, including any [Element]($backend)s for which one of their [ElementAspect]($backend)s was changed. */
+    updated?: CompressedId64Set;
+}
+/** A collection of [[EntityIdAndClassId]]s, as used by [TxnChangedEntities]($backend).
+ * For efficiency, the iterator supplied by this iterable returns **the same `EntityIdAndClassId` object** on each iteration. Therefore the objects must be copied if you
+ * intend to store references to them. For example, to populate an array from the iterable:
+ * ```ts
+ *  function arrayFromIterable(entities: EntityIdAndClassIdIterable): EntityIdAndClassId[] {
+ *    // NO! return Array.from(entities);
+ *    const array = [];
+ *    for (const entity of entities)
+ *      array.push({...entity});
+ *
+ *    return array;
+ *  }
+ * ```
+ * @public
+ * @extensions
+ */
+export type EntityIdAndClassIdIterable = Iterable<Readonly<EntityIdAndClassId>>;
 //# sourceMappingURL=ChangedEntities.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ChangedEntities.d.ts","sourceRoot":"","sources":["../../src/ChangedEntities.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEpE;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,uBAAuB;IACvB,EAAE,EAAE,UAAU,CAAC;IACf,sCAAsC;IACtC,OAAO,EAAE,UAAU,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,4DAA4D;IAC5D,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,+JAA+J;IAC/J,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;GAeG;AACH,oBAAY,0BAA0B,GAAG,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"ChangedEntities.d.ts","sourceRoot":"","sources":["../../src/ChangedEntities.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEpE;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,uBAAuB;IACvB,EAAE,EAAE,UAAU,CAAC;IACf,sCAAsC;IACtC,OAAO,EAAE,UAAU,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,4DAA4D;IAC5D,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,+JAA+J;IAC/J,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,0BAA0B,GAAG,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC"}

package/lib/esm/ChangedEntities.js

@@ -1,9 +1,9 @@
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module NativeApp
- */
-export {};
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module NativeApp
+ */
+export {};
 //# sourceMappingURL=ChangedEntities.js.map