@itwin/core-common 4.0.0-dev.6 → 4.0.0-dev.61

package/lib/cjs/Base64EncodedString.js.map

@@ -1 +1 @@
-{"version":3,"file":"Base64EncodedString.js","sourceRoot":"","sources":["../../src/Base64EncodedString.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,yCAAmC;AASnC;;GAEG;AACH,IAAiB,mBAAmB,CAsDnC;AAtDD,WAAiB,mBAAmB;IAClC,4EAA4E;IAC/D,0BAAM,GAAG,kBAAkB,CAAC;IAEzC,2DAA2D;IAC3D,SAAgB,cAAc,CAAC,KAAiB;QAC9C,OAAO,GAAG,oBAAA,MAAM,GAAG,kBAAM,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;IACpD,CAAC;IAFe,kCAAc,iBAE7B,CAAA;IAED,2DAA2D;IAC3D,SAAgB,YAAY,CAAC,MAA2B;QACtD,OAAO,kBAAM,CAAC,YAAY,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;IAClD,CAAC;IAFe,gCAAY,eAE3B,CAAA;IAED,+HAA+H;IAC/H,SAAgB,SAAS,CAAC,GAAW;QACnC,OAAO,GAAG,CAAC,UAAU,CAAC,oBAAA,MAAM,CAAC,CAAC;IAChC,CAAC;IAFe,6BAAS,YAExB,CAAA;IAED,6FAA6F;IAC7F,SAAgB,YAAY,CAAC,MAAc;QACzC,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,oBAAA,MAAM,GAAG,MAAM,EAAE,CAAC;IAC3D,CAAC;IAFe,gCAAY,eAE3B,CAAA;IAED,4EAA4E;IAC5E,SAAgB,WAAW,CAAC,MAA2B;QACrD,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,oBAAA,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACnE,CAAC;IAFe,+BAAW,cAE1B,CAAA;IAED,uGAAuG;IAC1F,2BAAO,GAAG,CAAC,KAAa,EAAE,KAAU,EAAO,EAAE;QACxD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,CAAC,KAAK,CAAC;YAC/C,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QAE9B,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,4GAA4G;IAC/F,4BAAQ,GAAG,CAAC,KAAa,EAAE,KAAU,EAAO,EAAE;QACzD,IAAI,KAAK,IAAI,KAAK,CAAC,WAAW,KAAK,UAAU;YAC3C,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QAEhC,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,iDAAiD;IACjD,SAAgB,MAAM,CAAC,GAAW,EAAE,OAAiB;QACnD,OAAO,kBAAM,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;IAFe,0BAAM,SAErB,CAAA;IAED,iDAAiD;IACjD,SAAgB,MAAM,CAAC,GAAW;QAChC,OAAO,kBAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAFe,0BAAM,SAErB,CAAA;AACH,CAAC,EAtDgB,mBAAmB,GAAnB,2BAAmB,KAAnB,2BAAmB,QAsDnC","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 Entities\r\n */\r\n\r\nimport { Base64 } from \"js-base64\";\r\n\r\n/** Represents an array of bytes encoded in base-64 with a prefix indicating the encoding, as required when converting EC properties of `binary` type to and from JSON.\r\n * @see [[TextureProps.data]] and [[BRepEntity.DataProps.data]] for examples of properties of this type.\r\n * @public\r\n * @extensions\r\n */\r\nexport type Base64EncodedString = string;\r\n\r\n/** Represents an array of bytes encoded in base-64 with a prefix indicating the encoding, as persisted in an [ECDb]($backend) for properties of `binary` type.\r\n * @public\r\n */\r\nexport namespace Base64EncodedString { // eslint-disable-line @typescript-eslint/no-redeclare\r\n  /** The prefix prepended to the string identifying it as base-64-encoded. */\r\n  export const prefix = \"encoding=base64;\";\r\n\r\n  /** Encode an array of bytes into a Base64EncodedString. */\r\n  export function fromUint8Array(bytes: Uint8Array): Base64EncodedString {\r\n    return `${prefix}${Base64.fromUint8Array(bytes)}`;\r\n  }\r\n\r\n  /** Decode a Base64EncodedString into an array of bytes. */\r\n  export function toUint8Array(base64: Base64EncodedString): Uint8Array {\r\n    return Base64.toUint8Array(stripPrefix(base64));\r\n  }\r\n\r\n  /** Returns true if the input starts with [[Base64EncodedString.prefix]] indicating it is a well-formed Base64EncodedString. */\r\n  export function hasPrefix(str: string): boolean {\r\n    return str.startsWith(prefix);\r\n  }\r\n\r\n  /** Ensure that the base-64-encoded string starts with the [[Base64EncodedString.prefix]]. */\r\n  export function ensurePrefix(base64: string): Base64EncodedString {\r\n    return hasPrefix(base64) ? base64 : `${prefix}${base64}`;\r\n  }\r\n\r\n  /** Remove the [[Base64EncodedString.prefix]] from the string if present. */\r\n  export function stripPrefix(base64: Base64EncodedString): string {\r\n    return hasPrefix(base64) ? base64.substr(prefix.length) : base64;\r\n  }\r\n\r\n  /** A function suitable for use with `JSON.parse` to revive a Base64EncodedString into a Uint8Array. */\r\n  export const reviver = (_name: string, value: any): any => {\r\n    if (typeof value === \"string\" && hasPrefix(value))\r\n      value = toUint8Array(value);\r\n\r\n    return value;\r\n  };\r\n\r\n  /** A function suitable for use with `JSON.stringify` to serialize a Uint8Array as a Base64EncodedString. */\r\n  export const replacer = (_name: string, value: any): any => {\r\n    if (value && value.constructor === Uint8Array)\r\n      value = fromUint8Array(value);\r\n\r\n    return value;\r\n  };\r\n\r\n  /* Encode a string into a Base64EncodedString. */\r\n  export function encode(src: string, urlSafe?: boolean): Base64EncodedString {\r\n    return Base64.encode(src, urlSafe);\r\n  }\r\n\r\n  /* Decode a Base64EncodedString into a string. */\r\n  export function decode(src: string): Base64EncodedString {\r\n    return Base64.decode(src);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"Base64EncodedString.js","sourceRoot":"","sources":["../../src/Base64EncodedString.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,yCAAmC;AASnC;;GAEG;AACH,IAAiB,mBAAmB,CAsDnC;AAtDD,WAAiB,mBAAmB;IAClC,4EAA4E;IAC/D,0BAAM,GAAG,kBAAkB,CAAC;IAEzC,2DAA2D;IAC3D,SAAgB,cAAc,CAAC,KAAiB;QAC9C,OAAO,GAAG,oBAAA,MAAM,GAAG,kBAAM,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;IACpD,CAAC;IAFe,kCAAc,iBAE7B,CAAA;IAED,2DAA2D;IAC3D,SAAgB,YAAY,CAAC,MAA2B;QACtD,OAAO,kBAAM,CAAC,YAAY,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;IAClD,CAAC;IAFe,gCAAY,eAE3B,CAAA;IAED,+HAA+H;IAC/H,SAAgB,SAAS,CAAC,GAAW;QACnC,OAAO,GAAG,CAAC,UAAU,CAAC,oBAAA,MAAM,CAAC,CAAC;IAChC,CAAC;IAFe,6BAAS,YAExB,CAAA;IAED,6FAA6F;IAC7F,SAAgB,YAAY,CAAC,MAAc;QACzC,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,oBAAA,MAAM,GAAG,MAAM,EAAE,CAAC;IAC3D,CAAC;IAFe,gCAAY,eAE3B,CAAA;IAED,4EAA4E;IAC5E,SAAgB,WAAW,CAAC,MAA2B;QACrD,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,oBAAA,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACtE,CAAC;IAFe,+BAAW,cAE1B,CAAA;IAED,uGAAuG;IAC1F,2BAAO,GAAG,CAAC,KAAa,EAAE,KAAU,EAAO,EAAE;QACxD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,CAAC,KAAK,CAAC;YAC/C,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QAE9B,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,4GAA4G;IAC/F,4BAAQ,GAAG,CAAC,KAAa,EAAE,KAAU,EAAO,EAAE;QACzD,IAAI,KAAK,IAAI,KAAK,CAAC,WAAW,KAAK,UAAU;YAC3C,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QAEhC,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,iDAAiD;IACjD,SAAgB,MAAM,CAAC,GAAW,EAAE,OAAiB;QACnD,OAAO,kBAAM,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;IAFe,0BAAM,SAErB,CAAA;IAED,iDAAiD;IACjD,SAAgB,MAAM,CAAC,GAAW;QAChC,OAAO,kBAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAFe,0BAAM,SAErB,CAAA;AACH,CAAC,EAtDgB,mBAAmB,GAAnB,2BAAmB,KAAnB,2BAAmB,QAsDnC","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 Entities\r\n */\r\n\r\nimport { Base64 } from \"js-base64\";\r\n\r\n/** Represents an array of bytes encoded in base-64 with a prefix indicating the encoding, as required when converting EC properties of `binary` type to and from JSON.\r\n * @see [[TextureProps.data]] and [[BRepEntity.DataProps.data]] for examples of properties of this type.\r\n * @public\r\n * @extensions\r\n */\r\nexport type Base64EncodedString = string;\r\n\r\n/** Represents an array of bytes encoded in base-64 with a prefix indicating the encoding, as persisted in an [ECDb]($backend) for properties of `binary` type.\r\n * @public\r\n */\r\nexport namespace Base64EncodedString { // eslint-disable-line @typescript-eslint/no-redeclare\r\n  /** The prefix prepended to the string identifying it as base-64-encoded. */\r\n  export const prefix = \"encoding=base64;\";\r\n\r\n  /** Encode an array of bytes into a Base64EncodedString. */\r\n  export function fromUint8Array(bytes: Uint8Array): Base64EncodedString {\r\n    return `${prefix}${Base64.fromUint8Array(bytes)}`;\r\n  }\r\n\r\n  /** Decode a Base64EncodedString into an array of bytes. */\r\n  export function toUint8Array(base64: Base64EncodedString): Uint8Array {\r\n    return Base64.toUint8Array(stripPrefix(base64));\r\n  }\r\n\r\n  /** Returns true if the input starts with [[Base64EncodedString.prefix]] indicating it is a well-formed Base64EncodedString. */\r\n  export function hasPrefix(str: string): boolean {\r\n    return str.startsWith(prefix);\r\n  }\r\n\r\n  /** Ensure that the base-64-encoded string starts with the [[Base64EncodedString.prefix]]. */\r\n  export function ensurePrefix(base64: string): Base64EncodedString {\r\n    return hasPrefix(base64) ? base64 : `${prefix}${base64}`;\r\n  }\r\n\r\n  /** Remove the [[Base64EncodedString.prefix]] from the string if present. */\r\n  export function stripPrefix(base64: Base64EncodedString): string {\r\n    return hasPrefix(base64) ? base64.substring(prefix.length) : base64;\r\n  }\r\n\r\n  /** A function suitable for use with `JSON.parse` to revive a Base64EncodedString into a Uint8Array. */\r\n  export const reviver = (_name: string, value: any): any => {\r\n    if (typeof value === \"string\" && hasPrefix(value))\r\n      value = toUint8Array(value);\r\n\r\n    return value;\r\n  };\r\n\r\n  /** A function suitable for use with `JSON.stringify` to serialize a Uint8Array as a Base64EncodedString. */\r\n  export const replacer = (_name: string, value: any): any => {\r\n    if (value && value.constructor === Uint8Array)\r\n      value = fromUint8Array(value);\r\n\r\n    return value;\r\n  };\r\n\r\n  /* Encode a string into a Base64EncodedString. */\r\n  export function encode(src: string, urlSafe?: boolean): Base64EncodedString {\r\n    return Base64.encode(src, urlSafe);\r\n  }\r\n\r\n  /* Decode a Base64EncodedString into a string. */\r\n  export function decode(src: string): Base64EncodedString {\r\n    return Base64.decode(src);\r\n  }\r\n}\r\n"]}

package/lib/cjs/BlobReader.d.ts

@@ -1,32 +1,32 @@
-/** @packageDocumentation
- * @module iModels
- */
-import { Id64String } from "@itwin/core-bentley";
-import { BlobOptions, BlobRange, DbBlobRequest, DbBlobResponse, DbRequestExecutor } from "./ConcurrentQuery";
-/** @beta */
-export declare class Uint8Chunks implements Iterable<Uint8Array> {
-    private _chunks;
-    append(chunk: Uint8Array): void;
-    at(idx: number): Uint8Array;
-    get length(): number;
-    [Symbol.iterator](): Iterator<Uint8Array, any, undefined>;
-    combine(): Uint8Array;
-}
-/** @beta */
-export declare class BlobReader {
-    private _executor;
-    readonly className: string;
-    readonly accessString: string;
-    readonly instanceId: Id64String;
-    private _chunks;
-    private _lengthToRead;
-    private _options;
-    constructor(_executor: DbRequestExecutor<DbBlobRequest, DbBlobResponse>, className: string, accessString: string, instanceId: Id64String, options?: BlobOptions);
-    reset(options?: BlobOptions): void;
-    get range(): BlobRange;
-    step(): Promise<boolean>;
-    readToEnd(): Promise<Uint8Array>;
-    get current(): Uint8Array;
-    get chunks(): Uint8Chunks;
-}
+/** @packageDocumentation
+ * @module iModels
+ */
+import { Id64String } from "@itwin/core-bentley";
+import { BlobOptions, BlobRange, DbBlobRequest, DbBlobResponse, DbRequestExecutor } from "./ConcurrentQuery";
+/** @beta */
+export declare class Uint8Chunks implements Iterable<Uint8Array> {
+    private _chunks;
+    append(chunk: Uint8Array): void;
+    at(idx: number): Uint8Array;
+    get length(): number;
+    [Symbol.iterator](): Iterator<Uint8Array, any, undefined>;
+    combine(): Uint8Array;
+}
+/** @beta */
+export declare class BlobReader {
+    private _executor;
+    readonly className: string;
+    readonly accessString: string;
+    readonly instanceId: Id64String;
+    private _chunks;
+    private _lengthToRead;
+    private _options;
+    constructor(_executor: DbRequestExecutor<DbBlobRequest, DbBlobResponse>, className: string, accessString: string, instanceId: Id64String, options?: BlobOptions);
+    reset(options?: BlobOptions): void;
+    get range(): BlobRange;
+    step(): Promise<boolean>;
+    readToEnd(): Promise<Uint8Array>;
+    get current(): Uint8Array;
+    get chunks(): Uint8Chunks;
+}
 //# sourceMappingURL=BlobReader.d.ts.map

package/lib/cjs/BlobReader.js

@@ -1,85 +1,85 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BlobReader = exports.Uint8Chunks = void 0;
-const ConcurrentQuery_1 = require("./ConcurrentQuery");
-/** @beta */
-class Uint8Chunks {
-    constructor() {
-        this._chunks = [];
-    }
-    append(chunk) {
-        this._chunks.push(chunk);
-    }
-    at(idx) { return this._chunks[idx]; }
-    get length() { return this._chunks.length; }
-    [Symbol.iterator]() {
-        return this._chunks[Symbol.iterator];
-    }
-    combine() {
-        const totalChunkLength = this._chunks.reduce((acc, v) => acc + v.length, 0);
-        const combineChunk = new Uint8Array(totalChunkLength);
-        let offset = 0;
-        for (const array of this._chunks) {
-            combineChunk.set(array, offset);
-            offset += array.length;
-        }
-        return combineChunk;
-    }
-}
-exports.Uint8Chunks = Uint8Chunks;
-/** @beta */
-class BlobReader {
-    constructor(_executor, className, accessString, instanceId, options) {
-        this._executor = _executor;
-        this.className = className;
-        this.accessString = accessString;
-        this.instanceId = instanceId;
-        this._chunks = new Uint8Chunks();
-        this._lengthToRead = -1;
-        this._options = new ConcurrentQuery_1.BlobOptionsBuilder().getOptions();
-        this.reset(options);
-    }
-    reset(options) {
-        if (options) {
-            this._options = options;
-        }
-        this._chunks = new Uint8Chunks();
-        this._lengthToRead = this.range.count;
-    }
-    get range() { return this._options.range; }
-    async step() {
-        if (this._lengthToRead === this._chunks.length) {
-            return false;
-        }
-        const request = {
-            kind: ConcurrentQuery_1.DbRequestKind.BlobIO,
-            className: this.className,
-            accessString: this.accessString,
-            instanceId: this.instanceId,
-            ...this._options,
-        };
-        request.range = { offset: this._chunks.length, count: this.range ? this._lengthToRead - this._chunks.length : 0 };
-        const resp = await this._executor.execute(request);
-        ConcurrentQuery_1.DbQueryError.throwIfError(resp, request);
-        if (this._lengthToRead === -1) {
-            this._lengthToRead = resp.rawBlobSize;
-        }
-        if (resp.data && resp.data.length > 0) {
-            this._chunks.append(resp.data);
-        }
-        return true;
-    }
-    async readToEnd() {
-        while (await this.step()) { }
-        return this._chunks.combine();
-    }
-    get current() {
-        if (this._chunks.length === 0) {
-            throw new Error("there is no current buffer");
-        }
-        return this._chunks.at(this._chunks.length);
-    }
-    get chunks() { return this._chunks; }
-}
-exports.BlobReader = BlobReader;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BlobReader = exports.Uint8Chunks = void 0;
+const ConcurrentQuery_1 = require("./ConcurrentQuery");
+/** @beta */
+class Uint8Chunks {
+    constructor() {
+        this._chunks = [];
+    }
+    append(chunk) {
+        this._chunks.push(chunk);
+    }
+    at(idx) { return this._chunks[idx]; }
+    get length() { return this._chunks.length; }
+    [Symbol.iterator]() {
+        return this._chunks[Symbol.iterator];
+    }
+    combine() {
+        const totalChunkLength = this._chunks.reduce((acc, v) => acc + v.length, 0);
+        const combineChunk = new Uint8Array(totalChunkLength);
+        let offset = 0;
+        for (const array of this._chunks) {
+            combineChunk.set(array, offset);
+            offset += array.length;
+        }
+        return combineChunk;
+    }
+}
+exports.Uint8Chunks = Uint8Chunks;
+/** @beta */
+class BlobReader {
+    constructor(_executor, className, accessString, instanceId, options) {
+        this._executor = _executor;
+        this.className = className;
+        this.accessString = accessString;
+        this.instanceId = instanceId;
+        this._chunks = new Uint8Chunks();
+        this._lengthToRead = -1;
+        this._options = new ConcurrentQuery_1.BlobOptionsBuilder().getOptions();
+        this.reset(options);
+    }
+    reset(options) {
+        if (options) {
+            this._options = options;
+        }
+        this._chunks = new Uint8Chunks();
+        this._lengthToRead = this.range.count;
+    }
+    get range() { return this._options.range; }
+    async step() {
+        if (this._lengthToRead === this._chunks.length) {
+            return false;
+        }
+        const request = {
+            kind: ConcurrentQuery_1.DbRequestKind.BlobIO,
+            className: this.className,
+            accessString: this.accessString,
+            instanceId: this.instanceId,
+            ...this._options,
+        };
+        request.range = { offset: this._chunks.length, count: this.range ? this._lengthToRead - this._chunks.length : 0 };
+        const resp = await this._executor.execute(request);
+        ConcurrentQuery_1.DbQueryError.throwIfError(resp, request);
+        if (this._lengthToRead === -1) {
+            this._lengthToRead = resp.rawBlobSize;
+        }
+        if (resp.data && resp.data.length > 0) {
+            this._chunks.append(resp.data);
+        }
+        return true;
+    }
+    async readToEnd() {
+        while (await this.step()) { }
+        return this._chunks.combine();
+    }
+    get current() {
+        if (this._chunks.length === 0) {
+            throw new Error("there is no current buffer");
+        }
+        return this._chunks.at(this._chunks.length);
+    }
+    get chunks() { return this._chunks; }
+}
+exports.BlobReader = BlobReader;
 //# sourceMappingURL=BlobReader.js.map

package/lib/cjs/BriefcaseTypes.d.ts

@@ -1,190 +1,192 @@
-/** @packageDocumentation
- * @module iModels
- */
-import { GuidString } from "@itwin/core-bentley";
-import { ChangesetIdWithIndex, LocalFileName } from "./ChangesetProps";
-import { IModelEncryptionProps, OpenDbKey } from "./IModel";
-import { IModelVersionProps } from "./IModelVersion";
-/** The Id assigned to a briefcase by iModelHub, or [[BriefcaseIdValue.Unassigned]] .
- * @public
- * @extensions
- */
-export declare type BriefcaseId = number;
-/** Values of [[BriefcaseId]] that have special meaning.
- * @public
- * @extensions
- */
-export declare enum BriefcaseIdValue {
-    /** Indicates an invalid/illegal BriefcaseId */
-    Illegal = 4294967295,
-    /** BriefcaseIds must be less than this value */
-    Max = 16777216,
-    /** All valid iModelHub issued BriefcaseIds will be equal or higher than this */
-    FirstValid = 2,
-    /** All valid iModelHub issued BriefcaseIds will be equal or lower than this */
-    LastValid = 16777205,
-    /**
-     * The briefcase has not been assigned a unique Id by iModelHub. Only briefcases that have been assigned a unique BriefcaseId may create changesets,
-     * because BriefcaseId is used to create unique ElementIds for new elements.
-     *
-     * The `Unassigned` briefcaseId is used for several purposes:
-     *  - **Snapshots**. Snapshot files are immutable copies of an iModel for archival or data exchange purposes. They can neither generate nor accept new changesets.
-     *  - **Checkpoints**. Checkpoints are Snapshots that represent a specific version on an iModel's timeline.
-     *  - **PullOnly**. A local briefcase file that may be used to "slide" along a timeline by applying incoming changesets.
-     * They are always opened readonly except to apply changesets.
-     *  - **Standalone**. Standalone iModels are local files that are not connected to iModelHub, and therefore cannot accept or create changesets.
-     */
-    Unassigned = 0
-}
-/** Whether a briefcase is editable or may only accept incoming changesets from iModelHub
- * @public
- * @extensions
- */
-export declare enum SyncMode {
-    /** Use a fixed version (i.e. a checkpoint). See [CheckpointManager]($backend) for preferred approach to using checkpoint files. */
-    FixedVersion = 1,
-    /** A briefcase that can be edited. A unique briefcaseId must be assigned by iModelHub. */
-    PullAndPush = 2,
-    /** use [BriefcaseIdValue.Unassigned](%backend). This makes a briefcase that can accept changesets from iModelHub but can never create changesets. */
-    PullOnly = 3
-}
-/**
- * Options to open a previously downloaded briefcase
- * @public
- */
-export interface OpenBriefcaseOptions {
-    /** open briefcase Readonly */
-    readonly openAsReadOnly?: boolean;
-}
-/**
- * Properties that specify a briefcase within the local briefcase cache.
- * @see BriefcaseManager.getFileName
- * @public
- */
-export interface BriefcaseProps {
-    /** Id of the iModel */
-    readonly iModelId: GuidString;
-    /** BriefcaseId of the briefcase */
-    readonly briefcaseId: BriefcaseId;
-}
-/** Properties for opening a local briefcase file via [BriefcaseDb.open]($backend)
- * @public
- */
-export interface OpenBriefcaseProps extends IModelEncryptionProps, OpenDbKey {
-    /** the full path to the briefcase file  */
-    readonly fileName: LocalFileName;
-    /** If true, open the briefcase readonly */
-    readonly readonly?: boolean;
-}
-/** Properties of a local briefcase file, returned by [BriefcaseManager.getCachedBriefcases]($backend) and [BriefcaseManager.downloadBriefcase]($backend)
- * @public
- * @extensions
- */
-export interface LocalBriefcaseProps {
-    /** Full path of local file. */
-    readonly fileName: LocalFileName;
-    /** The iTwin containing the iModel. */
-    readonly iTwinId: GuidString;
-    /** The iModelId. */
-    readonly iModelId: GuidString;
-    /** The briefcaseId. */
-    readonly briefcaseId: BriefcaseId;
-    /** The current changesetId.
-     * @note ChangeSet Ids are string hash values based on the ChangeSet's content and parent.
-     */
-    readonly changeset: ChangesetIdWithIndex;
-    /** Size of the briefcase file in bytes  */
-    readonly fileSize: number;
-}
-/** Properties for downloading a briefcase to a local file, from iModelHub.
- * @public
- * @extensions
- */
-export interface RequestNewBriefcaseProps {
-    /** iTwin that the iModel belongs to. */
-    readonly iTwinId: GuidString;
-    /** The iModelId for the new briefcase. */
-    readonly iModelId: GuidString;
-    /** 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.
-     * Callers can use this to open the briefcase after the download completes.
-     * @note this member is both an input and an output.
-     */
-    readonly fileName?: LocalFileName;
-    /**
-     * 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.
-     * @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]].
-     * After downloading, you can merely delete unassigned briefcase files when they are no longer needed. Assigned BriefcaseIds should be released (via [BriefcaseManager.releaseBriefcase]($backend) )
-     * when you are done with them.
-     * @note this member is both an input and an output.
-     *
-     */
-    briefcaseId?: BriefcaseId;
-    /** Id of the change set of the new briefcase. If undefined, use latest. */
-    asOf?: IModelVersionProps;
-}
-/**
- * Manages the download of a briefcase
- * @public
- */
-export interface BriefcaseDownloader {
-    /** Id of the briefcase being downloaded */
-    readonly briefcaseId: BriefcaseId;
-    /** the name of the local file for the briefcase */
-    readonly fileName: LocalFileName;
-    /** Promise that resolves when the download completes. await this to complete the download */
-    readonly downloadPromise: Promise<void>;
-    /** Request cancellation of the download */
-    readonly requestCancel: () => Promise<boolean>;
-}
-/** Option to control the validation and upgrade of domain schemas in the Db
- * @beta
- */
-export declare enum DomainOptions {
-    /** Domain schemas will be validated for any required upgrades. Any errors will be reported back, and cause the application to fail opening the Db */
-    CheckRequiredUpgrades = 0,
-    /** 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 */
-    CheckRecommendedUpgrades = 1,
-    /** 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 */
-    Upgrade = 2,
-    /** Domain schemas will neither be validated nor be upgraded. Used only internally */
-    SkipCheck = 3
-}
-/** Options that control whether a profile upgrade should be performed when opening a Db
- * @beta
- */
-export declare enum ProfileOptions {
-    /** No profile upgrade will be performed. If a profile upgrade was required, opening the file will fail */
-    None = 0,
-    /** Profile upgrade will be performed if necessary */
-    Upgrade = 1
-}
-/** Arguments to validate and update the profile and domain schemas when opening a Db
- * @beta
- */
-export interface UpgradeOptions {
-    /** Option to control the validation and upgrade of domain schemas in the Db */
-    readonly domain?: DomainOptions;
-    /** Options that control whether a profile upgrade should be performed when opening a file */
-    readonly profile?: ProfileOptions;
-}
-/**
- * The state of the schemas in the Db compared with what the current version of the software expects
- * Note: The state may vary depending on whether the Db is to be opened ReadOnly or ReadWrite.
- * @beta
- */
-export declare enum SchemaState {
-    /** 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 */
-    UpToDate = 0,
-    /** It's required that the schemas in the Db be upgraded before it can be opened with the current version of the software.
-     * This may happen in read-write scenarios where the application requires a newer version of the schemas to be in place before
-     * it can write data based on that new schema.
-     */
-    UpgradeRequired = 1,
-    /** It's recommended, but not necessary that the schemas in the Db be upgraded before opening it with the current version of the software */
-    UpgradeRecommended = 2,
-    /** 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. */
-    TooOld = 3,
-    /** The schemas in the Db are too new to be opened by the current version of the software */
-    TooNew = 4
-}
+/** @packageDocumentation
+ * @module iModels
+ */
+import { GuidString } from "@itwin/core-bentley";
+import { ChangesetIdWithIndex, LocalFileName } from "./ChangesetProps";
+import { IModelEncryptionProps, OpenDbKey } from "./IModel";
+import { IModelVersionProps } from "./IModelVersion";
+/** The Id assigned to a briefcase by iModelHub, or [[BriefcaseIdValue.Unassigned]] .
+ * @public
+ * @extensions
+ */
+export type BriefcaseId = number;
+/** Values of [[BriefcaseId]] that have special meaning.
+ * @public
+ * @extensions
+ */
+export declare enum BriefcaseIdValue {
+    /** Indicates an invalid/illegal BriefcaseId */
+    Illegal = 4294967295,
+    /** BriefcaseIds must be less than this value */
+    Max = 16777216,
+    /** All valid iModelHub issued BriefcaseIds will be equal or higher than this */
+    FirstValid = 2,
+    /** All valid iModelHub issued BriefcaseIds will be equal or lower than this */
+    LastValid = 16777205,
+    /**
+     * The briefcase has not been assigned a unique Id by iModelHub. Only briefcases that have been assigned a unique BriefcaseId may create changesets,
+     * because BriefcaseId is used to create unique ElementIds for new elements.
+     *
+     * The `Unassigned` briefcaseId is used for several purposes:
+     *  - **Snapshots**. Snapshot files are immutable copies of an iModel for archival or data exchange purposes. They can neither generate nor accept new changesets.
+     *  - **Checkpoints**. Checkpoints are Snapshots that represent a specific version on an iModel's timeline.
+     *  - **PullOnly**. A local briefcase file that may be used to "slide" along a timeline by applying incoming changesets.
+     * They are always opened readonly except to apply changesets.
+     *  - **Standalone**. Standalone iModels are local files that are not connected to iModelHub, and therefore cannot accept or create changesets.
+     */
+    Unassigned = 0
+}
+/** Whether a briefcase is editable or may only accept incoming changesets from iModelHub
+ * @public
+ * @extensions
+ */
+export declare enum SyncMode {
+    /** Use a fixed version (i.e. a checkpoint). See [CheckpointManager]($backend) for preferred approach to using checkpoint files. */
+    FixedVersion = 1,
+    /** A briefcase that can be edited. A unique briefcaseId must be assigned by iModelHub. */
+    PullAndPush = 2,
+    /** use [BriefcaseIdValue.Unassigned](%backend). This makes a briefcase that can accept changesets from iModelHub but can never create changesets. */
+    PullOnly = 3
+}
+/**
+ * Options to open a previously downloaded briefcase
+ * @public
+ */
+export interface OpenBriefcaseOptions {
+    /** open briefcase Readonly */
+    readonly openAsReadOnly?: boolean;
+}
+/**
+ * Properties that specify a briefcase within the local briefcase cache.
+ * @see BriefcaseManager.getFileName
+ * @public
+ */
+export interface BriefcaseProps {
+    /** Id of the iModel */
+    readonly iModelId: GuidString;
+    /** BriefcaseId of the briefcase */
+    readonly briefcaseId: BriefcaseId;
+}
+/** Properties for opening a local briefcase file via [BriefcaseDb.open]($backend)
+ * @public
+ */
+export interface OpenBriefcaseProps extends IModelEncryptionProps, OpenDbKey {
+    /** the full path to the briefcase file  */
+    readonly fileName: LocalFileName;
+    /** If true, open the briefcase readonly */
+    readonly readonly?: boolean;
+}
+/** Properties of a local briefcase file, returned by [BriefcaseManager.getCachedBriefcases]($backend) and [BriefcaseManager.downloadBriefcase]($backend)
+ * @public
+ * @extensions
+ */
+export interface LocalBriefcaseProps {
+    /** Full path of local file. */
+    readonly fileName: LocalFileName;
+    /** The iTwin containing the iModel. */
+    readonly iTwinId: GuidString;
+    /** The iModelId. */
+    readonly iModelId: GuidString;
+    /** The briefcaseId. */
+    readonly briefcaseId: BriefcaseId;
+    /** The current changesetId.
+     * @note ChangeSet Ids are string hash values based on the ChangeSet's content and parent.
+     */
+    readonly changeset: ChangesetIdWithIndex;
+    /** Size of the briefcase file in bytes  */
+    readonly fileSize: number;
+}
+/** Properties for downloading a briefcase to a local file, from iModelHub.
+ * @public
+ * @extensions
+ */
+export interface RequestNewBriefcaseProps {
+    /** iTwin that the iModel belongs to. */
+    readonly iTwinId: GuidString;
+    /** The iModelId for the new briefcase. */
+    readonly iModelId: GuidString;
+    /** 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.
+     * Callers can use this to open the briefcase after the download completes.
+     * @note this member is both an input and an output.
+     */
+    readonly fileName?: LocalFileName;
+    /**
+     * 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.
+     * @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]].
+     * After downloading, you can merely delete unassigned briefcase files when they are no longer needed. Assigned BriefcaseIds should be released (via [BriefcaseManager.releaseBriefcase]($backend) )
+     * when you are done with them.
+     * @note this member is both an input and an output.
+     *
+     */
+    briefcaseId?: BriefcaseId;
+    /** Id of the change set of the new briefcase. If undefined, use latest. */
+    asOf?: IModelVersionProps;
+}
+/**
+ * Manages the download of a briefcase
+ * @public
+ */
+export interface BriefcaseDownloader {
+    /** Id of the briefcase being downloaded */
+    readonly briefcaseId: BriefcaseId;
+    /** the name of the local file for the briefcase */
+    readonly fileName: LocalFileName;
+    /** Promise that resolves when the download completes. await this to complete the download */
+    readonly downloadPromise: Promise<void>;
+    /** Request cancellation of the download */
+    readonly requestCancel: () => Promise<boolean>;
+}
+/** Option to control the validation and upgrade of domain schemas in the Db
+ * @beta
+ */
+export declare enum DomainOptions {
+    /** Domain schemas will be validated for any required upgrades. Any errors will be reported back, and cause the application to fail opening the Db */
+    CheckRequiredUpgrades = 0,
+    /** 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 */
+    CheckRecommendedUpgrades = 1,
+    /** 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 */
+    Upgrade = 2,
+    /** Domain schemas will neither be validated nor be upgraded. Used only internally */
+    SkipCheck = 3
+}
+/** Options that control whether a profile upgrade should be performed when opening a Db
+ * @beta
+ */
+export declare enum ProfileOptions {
+    /** No profile upgrade will be performed. If a profile upgrade was required, opening the file will fail */
+    None = 0,
+    /** Profile upgrade will be performed if necessary */
+    Upgrade = 1
+}
+/** Arguments to validate and update the profile and domain schemas when opening a Db
+ * @beta
+ */
+export interface UpgradeOptions {
+    /** Option to control the validation and upgrade of domain schemas in the Db */
+    readonly domain?: DomainOptions;
+    /** Options that control whether a profile upgrade should be performed when opening a file */
+    readonly profile?: ProfileOptions;
+    /** Options that will allow data transform during Profile/Domain schema upgrade */
+    readonly schemaLockHeld?: boolean;
+}
+/**
+ * The state of the schemas in the Db compared with what the current version of the software expects
+ * Note: The state may vary depending on whether the Db is to be opened ReadOnly or ReadWrite.
+ * @beta
+ */
+export declare enum SchemaState {
+    /** 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 */
+    UpToDate = 0,
+    /** It's required that the schemas in the Db be upgraded before it can be opened with the current version of the software.
+     * This may happen in read-write scenarios where the application requires a newer version of the schemas to be in place before
+     * it can write data based on that new schema.
+     */
+    UpgradeRequired = 1,
+    /** It's recommended, but not necessary that the schemas in the Db be upgraded before opening it with the current version of the software */
+    UpgradeRecommended = 2,
+    /** 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. */
+    TooOld = 3,
+    /** The schemas in the Db are too new to be opened by the current version of the software */
+    TooNew = 4
+}
 //# sourceMappingURL=BriefcaseTypes.d.ts.map