@itwin/core-backend 5.0.0-dev.90 → 5.0.0-dev.92

package/lib/esm/BlobContainerService.d.ts

@@ -0,0 +1,159 @@
+/** @packageDocumentation
+ * @module BlobContainers
+ */
+import { AccessToken, GuidString, Id64String } from "@itwin/core-bentley";
+import { SettingsContainer } from "./workspace/Settings";
+/**
+ * Types and functions for creating, deleting and authorizing access to cloud-based blob containers for an iTwin.
+ * @beta
+ */
+export declare namespace BlobContainer {
+    /** Object that implements the methods to create, delete, and request access to a container. */
+    let service: BlobContainer.ContainerService | undefined;
+    /** name of cloud provider for a container. */
+    type Provider = "azure" | "google";
+    /** the name of the container within its `Scope` */
+    type ContainerId = string;
+    /** token that authenticates a user. This token is required to obtain a `ContainerToken`. */
+    type UserToken = AccessToken;
+    /** token that authenticates access to a container for either read or write. */
+    type ContainerToken = AccessToken;
+    /**
+     * The scope for a container. This determines:
+     *  - the "owner" organization, including the contract that governs its legal and commercial terms and obligations
+     *  - the administrators who may configure RBAC permissions
+     *  - the datacenter for the container. Every container resides in a datacenter as determined by the iTwinId. This
+     * determines the region for data residency requirements.
+     *  - the lifecycle constraints for the container. No container can outlive its iTwin or its iModel (if defined). That is,
+     * when the iTwin/iModel is deleted (either explicitly or due to contract expiration), the container is also deleted.
+     */
+    interface Scope {
+        /** iTwinId of the owner of this container. */
+        iTwinId: Id64String;
+        /** optionally, an iModelId within the iTwin. If present, container is deleted when the iModel is deleted. */
+        iModelId?: Id64String;
+        /** the user GUID an individual, if this container is private. */
+        ownerGuid?: GuidString;
+    }
+    /**
+     * Metadata about the use of a container so that:
+     *  - administrators can understand why a container exists for assigning RBAC permissions appropriately
+     *  - usage reports can aggregate types of containers
+     *  - applications can identify their containers
+     *  - applications can store properties about their containers
+     */
+    interface Metadata {
+        /** The machine-readable string that describes what the container is being used for (e.g. "workspace"). Always lowercase and singular. */
+        containerType: string;
+        /** Human-readable name for the container. This will be displayed in the administrator RBAC panel, and on usage reports. Not required to be unique.*/
+        label: string;
+        /** Optional human-readable explanation of the information held in the container. This will be displayed in the administrator RBAC panel, and on usage reports. */
+        description?: string;
+        /** optional properties for the container */
+        json?: SettingsContainer;
+    }
+    /**
+     * Properties returned by queryContainersMetadata
+     */
+    interface MetadataResponse extends Metadata {
+        containerId: string;
+    }
+    /** Properties returned by `Service.requestToken` */
+    interface TokenProps {
+        /**
+         * Expiring token that provides the requested access to the container. Should be used in all subsequent requests for blobs within the container,
+         * and must be refreshed before it expires
+         */
+        token: ContainerToken;
+        /** Scope of the container. */
+        scope: Scope;
+        /** Name of the blob storage provider. */
+        provider: Provider;
+        /** Time at which the token will expire. The token should be refreshed (that is, a new token should be requested) before this time. */
+        expiration: Date;
+        /** Metadata of the container. */
+        metadata: Metadata;
+        /** Base URI of the storage account that hosts the container */
+        baseUri: string;
+    }
+    /** The URI and Id of the container. */
+    interface UriAndId {
+        baseUri: string;
+        containerId: ContainerId;
+    }
+    /** Information required to access an existing container. */
+    interface AccessContainerProps extends UriAndId {
+        userToken: UserToken;
+    }
+    /** Information about a newly created container. */
+    interface CreatedContainerProps extends UriAndId {
+        /** name of the blob storage provider. */
+        provider: Provider;
+    }
+    /**
+     * Access level to request for token.
+     * - `"write"`: request a writeable AccessToken.
+     * - `"read"`:  request a read-only AccessToken.
+     * - `"admin"`:  request a admin AccessToken.
+     * - `"writeIfPossible"`: first request a writeable AccessToken. If the user is not authorized for write, request a read-only AccessToken.
+     * If the user is not authorized for the level requested, an exception is thrown.
+     */
+    type RequestAccessLevel = "write" | "read" | "admin" | "writeIfPossible";
+    /** Information required to request an access token for a container. */
+    interface RequestTokenProps extends Omit<AccessContainerProps, "baseUri"> {
+        /** the level of access requested. If not specified, defaults to `"writeIfPossible"`. */
+        accessLevel?: RequestAccessLevel;
+        /** the number of seconds before the token should expire.
+         * @note A maximum duration is determined by the service. If no value is supplied, or the value is larger than the maximum, the maximum duration is used.
+         */
+        durationSeconds?: number;
+    }
+    /** Information required to create a new container. */
+    interface CreateNewContainerProps {
+        /** the scope of the new container */
+        scope: Scope;
+        /** metadata to be stored on the new container */
+        metadata: Metadata;
+        /** The user's access token. The user must be authorized with "create container" RBAC role for the iTwin. */
+        userToken: UserToken;
+        /**
+         * the id for the container. Useful for tests.
+         * @internal
+         */
+        containerId?: ContainerId;
+    }
+    /**
+     * Query Parameters for querying containers
+     */
+    interface QueryContainerProps {
+        /** the iTwinId of the containers to query */
+        iTwinId: GuidString;
+        /** optional iModelId of the containers to query */
+        iModelId?: GuidString;
+        /** optional containerType of the containers to query */
+        containerType?: GuidString;
+        /** optional label of the containers to query */
+        label?: GuidString;
+    }
+    /** Methods to create, delete, and access blob containers. */
+    interface ContainerService {
+        /**  Create a new blob container. Throws on failure (e.g. access denied or container already exists.) */
+        create(props: CreateNewContainerProps): Promise<CreatedContainerProps>;
+        /**
+         * Delete an existing blob container.
+         * @note This method requires that the user be authorized with "delete container" RBAC role for the iTwin.
+         */
+        delete(container: AccessContainerProps): Promise<void>;
+        /** query the Scope for a container */
+        queryScope(container: AccessContainerProps): Promise<Scope>;
+        /** query the Metadata for a specific container */
+        queryMetadata(container: AccessContainerProps): Promise<Metadata>;
+        /** Returns all containers and their metadata associated with a given iTwinId. Can be further queried by label and containerType. */
+        queryContainersMetadata(userToken: UserToken, args: QueryContainerProps): Promise<MetadataResponse[]>;
+        /** update the json properties of this container */
+        updateJson(container: AccessContainerProps, json: SettingsContainer): Promise<void>;
+        /** Request a `ContainerToken` for a container. Throws on failure. */
+        requestToken(props: RequestTokenProps): Promise<TokenProps>;
+    }
+}
+//# sourceMappingURL=BlobContainerService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BlobContainerService.d.ts","sourceRoot":"","sources":["../../src/BlobContainerService.ts"],"names":[],"mappings":"AAIA;;GAEG;AAIH,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD;;;GAGG;AACH,yBAAiB,aAAa,CAAC;IAE7B,+FAA+F;IACxF,IAAI,OAAO,EAAE,aAAa,CAAC,gBAAgB,GAAG,SAAS,CAAC;IAE/D,8CAA8C;IAC9C,KAAY,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;IAE1C,mDAAmD;IACnD,KAAY,WAAW,GAAG,MAAM,CAAC;IAEjC,4FAA4F;IAC5F,KAAY,SAAS,GAAG,WAAW,CAAC;IAEpC,+EAA+E;IAC/E,KAAY,cAAc,GAAG,WAAW,CAAC;IAEzC;;;;;;;;OAQG;IACH,UAAiB,KAAK;QACpB,8CAA8C;QAC9C,OAAO,EAAE,UAAU,CAAC;QACpB,6GAA6G;QAC7G,QAAQ,CAAC,EAAE,UAAU,CAAC;QACtB,iEAAiE;QACjE,SAAS,CAAC,EAAE,UAAU,CAAC;KACxB;IAED;;;;;;OAMG;IACH,UAAiB,QAAQ;QACvB,yIAAyI;QACzI,aAAa,EAAE,MAAM,CAAC;QACtB,qJAAqJ;QACrJ,KAAK,EAAE,MAAM,CAAC;QACd,kKAAkK;QAClK,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,4CAA4C;QAC5C,IAAI,CAAC,EAAE,iBAAiB,CAAC;KAC1B;IAED;;OAEG;IACH,UAAiB,gBAAiB,SAAQ,QAAQ;QAChD,WAAW,EAAE,MAAM,CAAC;KACrB;IAED,oDAAoD;IACpD,UAAiB,UAAU;QACzB;;;WAGG;QACH,KAAK,EAAE,cAAc,CAAC;QACtB,8BAA8B;QAC9B,KAAK,EAAE,KAAK,CAAC;QACb,yCAAyC;QACzC,QAAQ,EAAE,QAAQ,CAAC;QACnB,sIAAsI;QACtI,UAAU,EAAE,IAAI,CAAC;QACjB,iCAAiC;QACjC,QAAQ,EAAE,QAAQ,CAAC;QACnB,+DAA+D;QAC/D,OAAO,EAAE,MAAM,CAAC;KACjB;IAED,uCAAuC;IACvC,UAAiB,QAAQ;QACvB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,WAAW,CAAC;KAC1B;IAED,4DAA4D;IAC5D,UAAiB,oBAAqB,SAAQ,QAAQ;QACpD,SAAS,EAAE,SAAS,CAAC;KACtB;IAED,mDAAmD;IACnD,UAAiB,qBAAsB,SAAQ,QAAQ;QACrD,yCAAyC;QACzC,QAAQ,EAAE,QAAQ,CAAC;KACpB;IAED;;;;;;;OAOG;IACH,KAAY,kBAAkB,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,iBAAiB,CAAC;IAEhF,uEAAuE;IACvE,UAAiB,iBAAkB,SAAQ,IAAI,CAAC,oBAAoB,EAAE,SAAS,CAAC;QAC9E,wFAAwF;QACxF,WAAW,CAAC,EAAE,kBAAkB,CAAC;QACjC;;WAEG;QACH,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B;IAED,sDAAsD;IACtD,UAAiB,uBAAuB;QACtC,qCAAqC;QACrC,KAAK,EAAE,KAAK,CAAC;QACb,iDAAiD;QACjD,QAAQ,EAAE,QAAQ,CAAC;QACnB,4GAA4G;QAC5G,SAAS,EAAE,SAAS,CAAC;QACrB;;;WAGG;QACH,WAAW,CAAC,EAAE,WAAW,CAAC;KAC3B;IAED;;OAEG;IACH,UAAiB,mBAAmB;QAClC,6CAA6C;QAC7C,OAAO,EAAE,UAAU,CAAC;QACpB,mDAAmD;QACnD,QAAQ,CAAC,EAAE,UAAU,CAAC;QACtB,wDAAwD;QACxD,aAAa,CAAC,EAAE,UAAU,CAAC;QAC3B,gDAAgD;QAChD,KAAK,CAAC,EAAE,UAAU,CAAC;KACpB;IAED,6DAA6D;IAC7D,UAAiB,gBAAgB;QAC/B,wGAAwG;QACxG,MAAM,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;QAEvE;;;WAGG;QACH,MAAM,CAAC,SAAS,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAEvD,sCAAsC;QACtC,UAAU,CAAC,SAAS,EAAE,oBAAoB,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QAE5D,kDAAkD;QAClD,aAAa,CAAC,SAAS,EAAE,oBAAoB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QAElE,oIAAoI;QACpI,uBAAuB,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;QAEtG,mDAAmD;QACnD,UAAU,CAAC,SAAS,EAAE,oBAAoB,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAEpF,qEAAqE;QACrE,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;KAC7D;CACF"}

package/lib/esm/BlobContainerService.js

@@ -0,0 +1,15 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module BlobContainers
+ */
+/**
+ * Types and functions for creating, deleting and authorizing access to cloud-based blob containers for an iTwin.
+ * @beta
+ */
+export var BlobContainer;
+(function (BlobContainer) {
+})(BlobContainer || (BlobContainer = {}));
+//# sourceMappingURL=BlobContainerService.js.map

package/lib/esm/BlobContainerService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlobContainerService.js","sourceRoot":"","sources":["../../src/BlobContainerService.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAOH;;;GAGG;AACH,MAAM,KAAW,aAAa,CA2K7B;AA3KD,WAAiB,aAAa;AA2K9B,CAAC,EA3KgB,aAAa,KAAb,aAAa,QA2K7B","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 BlobContainers\n */\n\n// spell:ignore datacenter\n\nimport { AccessToken, GuidString, Id64String } from \"@itwin/core-bentley\";\nimport { SettingsContainer } from \"./workspace/Settings\";\n\n/**\n * Types and functions for creating, deleting and authorizing access to cloud-based blob containers for an iTwin.\n * @beta\n */\nexport namespace BlobContainer {\n\n  /** Object that implements the methods to create, delete, and request access to a container. */\n  export let service: BlobContainer.ContainerService | undefined;\n\n  /** name of cloud provider for a container. */\n  export type Provider = \"azure\" | \"google\";\n\n  /** the name of the container within its `Scope` */\n  export type ContainerId = string;\n\n  /** token that authenticates a user. This token is required to obtain a `ContainerToken`. */\n  export type UserToken = AccessToken;\n\n  /** token that authenticates access to a container for either read or write. */\n  export type ContainerToken = AccessToken;\n\n  /**\n   * The scope for a container. This determines:\n   *  - the \"owner\" organization, including the contract that governs its legal and commercial terms and obligations\n   *  - the administrators who may configure RBAC permissions\n   *  - the datacenter for the container. Every container resides in a datacenter as determined by the iTwinId. This\n   * determines the region for data residency requirements.\n   *  - the lifecycle constraints for the container. No container can outlive its iTwin or its iModel (if defined). That is,\n   * when the iTwin/iModel is deleted (either explicitly or due to contract expiration), the container is also deleted.\n   */\n  export interface Scope {\n    /** iTwinId of the owner of this container. */\n    iTwinId: Id64String;\n    /** optionally, an iModelId within the iTwin. If present, container is deleted when the iModel is deleted. */\n    iModelId?: Id64String;\n    /** the user GUID an individual, if this container is private. */\n    ownerGuid?: GuidString;\n  }\n\n  /**\n   * Metadata about the use of a container so that:\n   *  - administrators can understand why a container exists for assigning RBAC permissions appropriately\n   *  - usage reports can aggregate types of containers\n   *  - applications can identify their containers\n   *  - applications can store properties about their containers\n   */\n  export interface Metadata {\n    /** The machine-readable string that describes what the container is being used for (e.g. \"workspace\"). Always lowercase and singular. */\n    containerType: string;\n    /** Human-readable name for the container. This will be displayed in the administrator RBAC panel, and on usage reports. Not required to be unique.*/\n    label: string;\n    /** Optional human-readable explanation of the information held in the container. This will be displayed in the administrator RBAC panel, and on usage reports. */\n    description?: string;\n    /** optional properties for the container */\n    json?: SettingsContainer;\n  }\n\n  /**\n   * Properties returned by queryContainersMetadata\n   */\n  export interface MetadataResponse extends Metadata {\n    containerId: string;\n  }\n\n  /** Properties returned by `Service.requestToken` */\n  export interface TokenProps {\n    /**\n     * Expiring token that provides the requested access to the container. Should be used in all subsequent requests for blobs within the container,\n     * and must be refreshed before it expires\n     */\n    token: ContainerToken;\n    /** Scope of the container. */\n    scope: Scope;\n    /** Name of the blob storage provider. */\n    provider: Provider;\n    /** Time at which the token will expire. The token should be refreshed (that is, a new token should be requested) before this time. */\n    expiration: Date;\n    /** Metadata of the container. */\n    metadata: Metadata;\n    /** Base URI of the storage account that hosts the container */\n    baseUri: string;\n  }\n\n  /** The URI and Id of the container. */\n  export interface UriAndId {\n    baseUri: string;\n    containerId: ContainerId;\n  }\n\n  /** Information required to access an existing container. */\n  export interface AccessContainerProps extends UriAndId {\n    userToken: UserToken;\n  }\n\n  /** Information about a newly created container. */\n  export interface CreatedContainerProps extends UriAndId {\n    /** name of the blob storage provider. */\n    provider: Provider;\n  }\n\n  /**\n   * Access level to request for token.\n   * - `\"write\"`: request a writeable AccessToken.\n   * - `\"read\"`:  request a read-only AccessToken.\n   * - `\"admin\"`:  request a admin AccessToken.\n   * - `\"writeIfPossible\"`: first request a writeable AccessToken. If the user is not authorized for write, request a read-only AccessToken.\n   * If the user is not authorized for the level requested, an exception is thrown.\n   */\n  export type RequestAccessLevel = \"write\" | \"read\" | \"admin\" | \"writeIfPossible\";\n\n  /** Information required to request an access token for a container. */\n  export interface RequestTokenProps extends Omit<AccessContainerProps, \"baseUri\"> {\n    /** the level of access requested. If not specified, defaults to `\"writeIfPossible\"`. */\n    accessLevel?: RequestAccessLevel;\n    /** the number of seconds before the token should expire.\n     * @note A maximum duration is determined by the service. If no value is supplied, or the value is larger than the maximum, the maximum duration is used.\n     */\n    durationSeconds?: number;\n  }\n\n  /** Information required to create a new container. */\n  export interface CreateNewContainerProps {\n    /** the scope of the new container */\n    scope: Scope;\n    /** metadata to be stored on the new container */\n    metadata: Metadata;\n    /** The user's access token. The user must be authorized with \"create container\" RBAC role for the iTwin. */\n    userToken: UserToken;\n    /**\n     * the id for the container. Useful for tests.\n     * @internal\n     */\n    containerId?: ContainerId;\n  }\n\n  /**\n   * Query Parameters for querying containers\n   */\n  export interface QueryContainerProps {\n    /** the iTwinId of the containers to query */\n    iTwinId: GuidString;\n    /** optional iModelId of the containers to query */\n    iModelId?: GuidString;\n    /** optional containerType of the containers to query */\n    containerType?: GuidString;\n    /** optional label of the containers to query */\n    label?: GuidString;\n  }\n\n  /** Methods to create, delete, and access blob containers. */\n  export interface ContainerService {\n    /**  Create a new blob container. Throws on failure (e.g. access denied or container already exists.) */\n    create(props: CreateNewContainerProps): Promise<CreatedContainerProps>;\n\n    /**\n     * Delete an existing blob container.\n     * @note This method requires that the user be authorized with \"delete container\" RBAC role for the iTwin.\n     */\n    delete(container: AccessContainerProps): Promise<void>;\n\n    /** query the Scope for a container */\n    queryScope(container: AccessContainerProps): Promise<Scope>;\n\n    /** query the Metadata for a specific container */\n    queryMetadata(container: AccessContainerProps): Promise<Metadata>;\n\n    /** Returns all containers and their metadata associated with a given iTwinId. Can be further queried by label and containerType. */\n    queryContainersMetadata(userToken: UserToken, args: QueryContainerProps): Promise<MetadataResponse[]>;\n\n    /** update the json properties of this container */\n    updateJson(container: AccessContainerProps, json: SettingsContainer): Promise<void>;\n\n    /** Request a `ContainerToken` for a container. Throws on failure. */\n    requestToken(props: RequestTokenProps): Promise<TokenProps>;\n  }\n}\n"]}

package/lib/esm/BriefcaseManager.d.ts

@@ -0,0 +1,213 @@
+/** @packageDocumentation
+ * @module iModels
+ */
+import { AccessToken, BeDuration, GuidString, Optional } from "@itwin/core-bentley";
+import { BriefcaseId, BriefcaseProps, ChangesetIndex, ChangesetIndexOrId, ChangesetProps, ChangesetRange, LocalBriefcaseProps, LocalDirName, LocalFileName, RequestNewBriefcaseProps } from "@itwin/core-common";
+import { AcquireNewBriefcaseIdArg, IModelNameArg } from "./BackendHubAccess";
+import { ProgressFunction } from "./CheckpointManager";
+import { BriefcaseDb, IModelDb, TokenArg } from "./IModelDb";
+/** The argument for [[BriefcaseManager.downloadBriefcase]]
+ * @public
+*/
+export interface RequestNewBriefcaseArg extends TokenArg, RequestNewBriefcaseProps {
+    /** If present, a function called periodically during the download to indicate progress.
+     * @note return non-zero from this function to abort the download.
+     */
+    onProgress?: ProgressFunction;
+}
+/**
+ * Parameters for pushing changesets to iModelHub
+ * @public
+ */
+export interface PushChangesArgs extends TokenArg {
+    /** A description of the changes. This is visible on the iModel's timeline. */
+    description: string;
+    /** if present, the locks are retained after the operation. Otherwise, *all* locks are released after the changeset is successfully pushed. */
+    retainLocks?: true;
+    /** number of times to retry pull/merge if other users are pushing at the same time. Default is 5 */
+    mergeRetryCount?: number;
+    /** delay to wait between pull/merge retry attempts. Default is 3 seconds */
+    mergeRetryDelay?: BeDuration;
+    /** the number of time to attempt to retry to push the changeset upon failure. Default is 3 */
+    pushRetryCount?: number;
+    /** The delay to wait between retry attempts on failed pushes. Default is 3 seconds. */
+    pushRetryDelay?: BeDuration;
+    /**
+     *  For testing purpose
+     * @internal
+     */
+    noFastForward?: true;
+}
+/**
+ * Specifies a specific index for pulling changes.
+ * @public
+ */
+export interface ToChangesetArgs extends TokenArg {
+    /** The last ChangesetIndex to pull. If not present, pull *all* newer changesets. */
+    toIndex?: ChangesetIndex;
+}
+/** Arguments for [[BriefcaseManager.pullAndApplyChangesets]]
+ * @public
+ */
+export type PullChangesArgs = ToChangesetArgs & {
+    /** If present, a function called periodically during the download to indicate progress.
+     * @note return non-zero from this function to abort the download.
+     */
+    onProgress?: ProgressFunction;
+    /**
+     *  For testing purpose
+     * @internal
+     */
+    noFastForward?: true;
+};
+/** Arguments for [[BriefcaseManager.revertTimelineChanges]]
+ * @public
+ */
+export type RevertChangesArgs = Optional<PushChangesArgs, "description"> & {
+    /** If present, a function called periodically during the download to indicate progress.
+     * @note return non-zero from this function to abort the download.
+     */
+    onProgress?: ProgressFunction;
+    /** The index of the changeset to revert to */
+    toIndex: ChangesetIndex;
+    /** If present, schema changes are skipped during the revert operation. */
+    skipSchemaChanges?: true;
+};
+/** Manages downloading Briefcases and downloading and uploading changesets.
+ * @public
+ */
+export declare class BriefcaseManager {
+    /** Get the local path of the folder storing files that are associated with an imodel */
+    static getIModelPath(iModelId: GuidString): LocalDirName;
+    /** @internal */
+    static getChangeSetsPath(iModelId: GuidString): LocalDirName;
+    /** @internal */
+    static getChangeCachePathName(iModelId: GuidString): LocalFileName;
+    /** @internal */
+    static getChangedElementsPathName(iModelId: GuidString): LocalFileName;
+    private static _briefcaseSubDir;
+    /** Get the local path of the folder storing briefcases associated with the specified iModel. */
+    static getBriefcaseBasePath(iModelId: GuidString): LocalDirName;
+    /** Get the name of the local file that holds, or will hold, a local briefcase in the briefcase cache.
+     * @note The briefcase cache is a local directory established in the call to [[BriefcaseManager.initialize]].
+     * @param briefcase the iModelId and BriefcaseId for the filename
+     * @see getIModelPath
+     */
+    static getFileName(briefcase: BriefcaseProps): LocalFileName;
+    private static setupCacheDir;
+    private static _initialized?;
+    /** Initialize BriefcaseManager
+     * @param cacheRootDir The root directory for storing a cache of downloaded briefcase files on the local computer.
+     * Briefcases are stored relative to this path in sub-folders organized by IModelId.
+     * @note It is perfectly valid for applications to store briefcases in locations they manage, outside of `cacheRootDir`.
+     */
+    static initialize(cacheRootDir: LocalDirName): void;
+    private static finalize;
+    /** Get a list of the local briefcase held in the briefcase cache, optionally for a single iModelId
+     * @param iModelId if present, only briefcases for this iModelId are returned, otherwise all briefcases for all
+     * iModels in the briefcase cache are returned.
+     * @note usually there should only be one briefcase per iModel.
+     */
+    static getCachedBriefcases(iModelId?: GuidString): LocalBriefcaseProps[];
+    private static _cacheDir;
+    /** Get the root directory for the briefcase cache */
+    static get cacheDir(): LocalDirName;
+    /** Determine whether the supplied briefcaseId is in the range of assigned BriefcaseIds issued by iModelHub
+     * @note this does check whether the id was actually acquired by the caller.
+     */
+    static isValidBriefcaseId(id: BriefcaseId): boolean;
+    /** Acquire a new briefcaseId from iModelHub for the supplied iModelId
+     * @note usually there should only be one briefcase per iModel per user. If a single user acquires more than one briefcaseId,
+     * it's a good idea to supply different aliases for each of them.
+     */
+    static acquireNewBriefcaseId(arg: AcquireNewBriefcaseIdArg): Promise<BriefcaseId>;
+    /**
+     * Download a new briefcase from iModelHub for the supplied iModelId.
+     *
+     * Briefcases are local files holding a copy of an iModel.
+     * Briefcases may either be specific to an individual user (so that it can be modified to create changesets), or it can be readonly so it can accept but not create changesets.
+     * Every briefcase internally holds its [[BriefcaseId]]. Writeable briefcases have a `BriefcaseId` "assigned" to them by iModelHub. No two users will ever have the same BriefcaseId.
+     * Readonly briefcases are "unassigned" with the special value [[BriefcaseId.Unassigned]].
+     *
+     * Typically a given user will have only one briefcase on their machine for a given iModelId. Rarely, it may be necessary to use more than one
+     * briefcase to make isolated independent sets of changes, but that is exceedingly complicated and rare.
+     *
+     * Callers of this method may supply a BriefcaseId, or if none is supplied, a new one is acquired from iModelHub.
+     *
+     * @param arg The arguments that specify the briefcase file to be downloaded.
+     * @returns The properties of the local briefcase in a Promise that is resolved after the briefcase is fully downloaded and the briefcase file is ready for use via [BriefcaseDb.open]($backend).
+     * @note The location of the local file to hold the briefcase is arbitrary and may be any valid *local* path on your machine. If you don't supply
+     * a filename, the local briefcase cache is used by creating a file with the briefcaseId as its name in the `briefcases` folder below the folder named
+     * for the IModelId.
+     * @note *It is invalid to edit briefcases on a shared network drive* and that is a sure way to corrupt your briefcase (see https://www.sqlite.org/howtocorrupt.html)
+     */
+    static downloadBriefcase(arg: RequestNewBriefcaseArg): Promise<LocalBriefcaseProps>;
+    /** Deletes change sets of an iModel from local disk
+     * @internal
+     */
+    static deleteChangeSetsFromLocalDisk(iModelId: string): void;
+    /** Releases a briefcaseId from iModelHub. After this call it is illegal to generate changesets for the released briefcaseId.
+     * @note generally, this method should not be called directly. Instead use [[deleteBriefcaseFiles]].
+     * @see deleteBriefcaseFiles
+     */
+    static releaseBriefcase(accessToken: AccessToken, briefcase: BriefcaseProps): Promise<void>;
+    /**
+     * Delete and clean up a briefcase and all of its associated files. First, this method opens the supplied filename to determine its briefcaseId.
+     * Then, if a requestContext is supplied, it releases a BriefcaseId from iModelHub. Finally it deletes the local briefcase file and
+     * associated files (that is, all files in the same directory that start with the briefcase name).
+     * @param filePath the full file name of the Briefcase to delete
+     * @param accessToken for releasing the briefcaseId
+     */
+    static deleteBriefcaseFiles(filePath: LocalFileName, accessToken?: AccessToken): Promise<void>;
+    /** Deletes a file
+     *  - Does not throw any error, but logs it instead
+     *  - Returns true if the delete was successful
+     */
+    private static deleteFile;
+    /** Deletes a folder, checking if it's empty
+     *  - Does not throw any error, but logs it instead
+     *  - Returns true if the delete was successful
+     */
+    private static deleteFolderIfEmpty;
+    /** Deletes the contents of a folder, but not the folder itself
+     *  - Does not throw any errors, but logs them.
+     *  - returns true if the delete was successful.
+     */
+    private static deleteFolderContents;
+    /** Query the hub for the properties for a ChangesetIndex or ChangesetId  */
+    static queryChangeset(arg: {
+        iModelId: GuidString;
+        changeset: ChangesetIndexOrId;
+    }): Promise<ChangesetProps>;
+    /** Query the hub for an array of changeset properties given a ChangesetRange */
+    static queryChangesets(arg: {
+        iModelId: GuidString;
+        range: ChangesetRange;
+    }): Promise<ChangesetProps[]>;
+    /** Query the hub for the ChangesetProps of the most recent changeset */
+    static getLatestChangeset(arg: {
+        iModelId: GuidString;
+    }): Promise<ChangesetProps>;
+    /** Query the Id of an iModel by name.
+     * @param arg Identifies the iModel of interest
+     * @returns the Id of the corresponding iModel, or `undefined` if no such iModel exists.
+     */
+    static queryIModelByName(arg: IModelNameArg): Promise<GuidString | undefined>;
+    /** Deletes a folder and all it's contents.
+     *  - Does not throw any errors, but logs them.
+     *  - returns true if the delete was successful.
+     */
+    private static deleteFolderAndContents;
+    private static applySingleChangeset;
+    /** @internal */
+    static revertTimelineChanges(db: IModelDb, arg: RevertChangesArgs): Promise<void>;
+    /** @internal */
+    static pullAndApplyChangesets(db: IModelDb, arg: PullChangesArgs): Promise<void>;
+    /** create a changeset from the current changes, and push it to iModelHub */
+    private static pushChanges;
+    /** Pull/merge (if necessary), then push all local changes as a changeset. Called by [[BriefcaseDb.pushChanges]]
+     * @internal
+     */
+    static pullMergePush(db: BriefcaseDb, arg: PushChangesArgs): Promise<void>;
+}
+//# sourceMappingURL=BriefcaseManager.d.ts.map

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

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