@itwin/core-backend 3.3.0-dev.9 → 3.4.0-dev.10

package/lib/cjs/workspace/Workspace.d.ts

@@ -1,112 +1,126 @@
 /** @packageDocumentation
  * @module Workspace
  */
-import { CloudSqlite, IModelJsNative } from "@bentley/imodeljs-native";
+import { CloudSqlite } from "@bentley/imodeljs-native";
 import { BeEvent, Optional } from "@itwin/core-bentley";
 import { LocalDirName, LocalFileName } from "@itwin/core-common";
 import { SQLiteDb } from "../SQLiteDb";
 import { Settings, SettingsPriority } from "./Settings";
-/**
- * The name of a WorkspaceContainer. This is the user-supplied name of a WorkspaceContainer, used to specify its *purpose* within a workspace.
- * WorkspaceContainerName can be "aliased" by `WorkspaceSetting.containerAlias` settings so that "resolved" [[WorkspaceContainerId]] that supplies
- * the actual WorkspaceContainer for a WorkspaceContainerName may vary. Also note that more than one WorkspaceContainerName may resolve to the same
- * WorkspaceContainerId, if multiple purposes are served by the same WorkspaceContainer.
- * @note there are no constraints on the contents or length of `WorkspaceContainerName`s, although short descriptive names are recommended.
- * However, when no alias exists in WorkspaceSetting.containerAlias for a WorkspaceContainerName, then the WorkspaceContainerName becomes
- * the WorkspaceContainerId, and the constraints on WorkspaceContainerId apply.
- * @beta
- */
-export declare type WorkspaceContainerName = string;
-/**
- * The unique identifier of a WorkspaceContainer. This becomes the base name for the local directory holding the WorkspaceDbs from a WorkspaceContainer.
- * `WorkspaceContainerName`s are resolved to WorkspaceContainerId through `WorkspaceSetting.containerAlias` settings,
- * so users may not recognize the actual WorkspaceContainerId supplying resources for a WorkspaceDbName.
- *
- * `WorkspaceContainerId`s :
- *  - may only contain lower case letters, numbers or dashes
- *  - may not start or end with with a dash
- *  - be shorter than 3 or longer than 63 characters
- * @beta
- */
-export declare type WorkspaceContainerId = string;
-/** The name of a WorkspaceDb within a WorkspaceContainer.
- * @beta
- */
-export declare type WorkspaceDbName = string;
-/**
- * The version name for a WorkspaceDb. More than one version of a WorkspaceDb may be stored in the same WorkspaceContainer. This
- * string identifies a specific version.
- * @beta
- */
-export declare type WorkspaceDbVersion = string;
-/**
- * The name for identifying WorkspaceResources in a [[WorkspaceDb]].
- * * `WorkspaceResourceName`s may not:
- *  - be blank or start or end with a space
- *  - be longer than 1024 characters
- * @note a single WorkspaceDb may hold WorkspaceResources of type 'blob', 'string' and 'file', all with the same WorkspaceResourceName.
+/** The Settings used by Workspace api
  * @beta
  */
-export declare type WorkspaceResourceName = string;
-/** supply either container name of id, not both
- * @beta
- */
-export declare type ContainerNameOrId = {
-    containerName: WorkspaceContainerName;
-    containerId?: never;
-} | {
-    containerId: WorkspaceContainerId;
-    containerName?: never;
-};
-/**
- * Properties that specify a WorkspaceContainer.
- * This can either be a WorkspaceContainerName or a WorkspaceContainerId. If id is supplied,
- * it is used directly. Otherwise name must be resolved via [[Workspace.resolveContainerId]].
- * @beta
- */
-export declare type WorkspaceContainerProps = ContainerNameOrId & {
-    cloudProps?: CloudSqlite.TransferProps;
+export declare const WorkspaceSetting: {
+    Accounts: string;
+    Containers: string;
+    Databases: string;
 };
-/** Properties of a WorkspaceDb
- * @beta
+/** Types used to identify cloud accounts for Workspaces.
+ *  @beta
  */
-export declare type WorkspaceDbProps = WorkspaceContainerProps & {
-    /** the name of the WorkspaceDb */
-    dbName: WorkspaceDbName;
-};
-/** Properties that specify a WorkspaceResource within a WorkspaceDb.
- * @beta
+export declare namespace WorkspaceAccount {
+    /** The name of a WorkspaceAccount in a "cloud/accounts" setting. */
+    type Name = string;
+    /** A member named `accountName` that specifies by an entry in a "cloud/accounts" setting */
+    interface Alias {
+        accountName: string;
+    }
+    /** The properties of a cloud account required to open containers with CloudSqlite. Usually supplied via a "cloud/accounts" setting. */
+    type Props = CloudSqlite.AccountAccessProps;
+}
+/** @beta */
+export declare namespace WorkspaceContainer {
+    /** The name of a WorkspaceContainer in a "cloud/containers" setting. */
+    type Name = string;
+    /** The unique identifier of a WorkspaceContainer. This becomes the base name for the local directory holding the WorkspaceDbs from a WorkspaceContainer.
+     * Usually supplied via the `containerId` member of a "cloud/containers" setting.
+     * `WorkspaceContainer.Id`s may:
+     *  - only contain lower case letters, numbers or dashes
+     *  - not start or end with a dash
+     *  - not be shorter than 3 or longer than 63 characters
+     */
+    type Id = string;
+    /** A member named `containerName` that specifies by an entry in a "cloud/containers" setting */
+    interface Alias {
+        containerName: string;
+    }
+    /** Properties that specify a WorkspaceContainer. */
+    interface Props extends Optional<CloudSqlite.ContainerProps, "accessToken"> {
+        /** true if the container is public (doesn't require authentication) */
+        isPublic?: boolean;
+        /** attempt to synchronize (i.e. call `checkForChanges`) this cloud container whenever it is connected to a cloud cache. */
+        syncOnConnect?: boolean;
+    }
+}
+/** @beta */
+export declare namespace WorkspaceDb {
+    /** The name of a WorkspaceDb in a "workspace/databases" setting. */
+    type Name = string;
+    /** The base name of a WorkspaceDb within a WorkspaceContainer (without any version identifier) */
+    type DbName = string;
+    /** The  name of a WorkspaceDb within a WorkspaceContainer, including the version identifier */
+    type DbFullName = string;
+    /** The semver-format version identifier for a WorkspaceDb. */
+    type Version = string;
+    /** The [semver range format](https://github.com/npm/node-semver) identifier for a range of acceptable versions. */
+    type VersionRange = string;
+    /** Properties that specify how to load a WorkspaceDb within a [[WorkspaceContainer]]. */
+    interface Props extends CloudSqlite.DbNameProp {
+        /** a semver version range specifier that determines the acceptable range of versions to load. If not present, use the newest version. */
+        version?: VersionRange;
+        /** if true, allow semver *prerelease* versions. By default only released version are allowed. */
+        includePrerelease?: boolean;
+    }
+    /** Scope to increment for a version number.
+     * @see semver.ReleaseType
+     */
+    type VersionIncrement = "major" | "minor" | "patch";
+}
+/** Types used to identify Workspace resources
+ *  @beta
  */
-export declare type WorkspaceResourceProps = WorkspaceDbProps & {
-    /** the name of the resource within [[db]] */
-    rscName: WorkspaceResourceName;
-};
+export declare namespace WorkspaceResource {
+    /**
+     * The name for identifying WorkspaceResources in a [[WorkspaceDb]].
+     * * `WorkspaceResource.Name`s may not:
+     *  - be blank or start or end with a space
+     *  - be longer than 1024 characters
+     * @note a single WorkspaceDb may hold WorkspaceResources of type 'blob', 'string' and 'file', all with the same WorkspaceResource.Name.
+     */
+    type Name = string;
+    /** Properties that specify an individual WorkspaceResource within a [[WorkspaceDb]]. */
+    interface Props {
+        /** the name of the resource within the WorkspaceDb */
+        rscName: Name;
+    }
+}
 /**
- * A WorkspaceDb holds workspace resources. `WorkspaceDb`s may just be local files, or they may be  stored and
- * synchronized in WorkspaceContainers. Each `WorkspaceResource` in a WorkspaceDb is  identified by a [[WorkspaceResourceName]].
+ * A WorkspaceDb holds workspace resources. `WorkspaceDb`s may just be local files, or they may be stored
+ * in cloud WorkspaceContainers. Each `WorkspaceResource` in a WorkspaceDb is identified by a [[WorkspaceResource.Name]].
  * Resources of type `string` and `blob` may be loaded directly from the `WorkspaceDb`. Resources of type `file` are
- * copied from the WorkspaceDb into a temporary local file so they can be accessed directly.
+ * copied from the WorkspaceDb into a temporary local file so they can be accessed by programs directly from disk.
  * @beta
  */
 export interface WorkspaceDb {
+    /** The WorkspaceContainer holding this WorkspaceDb. */
     readonly container: WorkspaceContainer;
-    /** The WorkspaceDbName of this WorkspaceDb. */
-    readonly dbName: WorkspaceDbName;
-    /** event raised when this WorkspaceDb is closed. */
-    readonly onClosed: BeEvent<() => void>;
-    /** The name of the local file for holding this WorkspaceDb. */
-    readonly localFile: LocalDirName;
+    /** The base name of this WorkspaceDb, without version */
+    readonly dbName: WorkspaceDb.DbName;
+    /** event raised before this WorkspaceDb is closed. */
+    readonly onClose: BeEvent<() => void>;
+    /** Name by which a WorkspaceDb may be opened. This will be either a local file name or the name of a database in a cloud container */
+    readonly dbFileName: string;
     /** Get a string resource from this WorkspaceDb, if present. */
-    getString(rscName: WorkspaceResourceName): string | undefined;
+    getString(rscName: WorkspaceResource.Name): string | undefined;
     /** Get a blob resource from this WorkspaceDb, if present. */
-    getBlob(rscName: WorkspaceResourceName): Uint8Array | undefined;
+    getBlob(rscName: WorkspaceResource.Name): Uint8Array | undefined;
     /** @internal */
-    getBlobReader(rscName: WorkspaceResourceName): IModelJsNative.BlobIO;
-    /** Extract a local copy of a file resource from this WorkspaceDb, if present.
+    getBlobReader(rscName: WorkspaceResource.Name): SQLiteDb.BlobIO;
+    /**
+     * Extract a local copy of a file resource from this WorkspaceDb, if present.
      * @param rscName The name of the file resource in the WorkspaceDb
      * @param targetFileName optional name for extracted file. Some applications require files in specific locations or filenames. If
      * you know the full path to use for the extracted file, you can supply it. Generally, it is best to *not* supply the filename and
-     * keep the extracted files in the  container filesDir.
+     * keep the extracted files in the  filesDir.
      * @returns the full path to a file on the local filesystem.
      * @note The file is copied from the file into the local filesystem so it may be accessed directly. This happens only
      * as necessary, if the local file doesn't exist, or if it is out-of-date because it was updated in the file.
@@ -116,18 +130,35 @@ export interface WorkspaceDb {
      * @note Workspace resource files are set readonly as they are copied from the file.
      * To edit them, you must first copy them to another location.
      */
-    getFile(rscName: WorkspaceResourceName, targetFileName?: LocalFileName): LocalFileName | undefined;
+    getFile(rscName: WorkspaceResource.Name, targetFileName?: LocalFileName): LocalFileName | undefined;
+    /**
+     * Ensure that the contents of a `WorkspaceDb` are downloaded into the local cache so that it may be accessed offline.
+     * Until the promise is resolved, the `WorkspaceDb` is not fully downloaded, but it *may* be safely accessed during the download.
+     * To determine the progress of the download, use the `localBlocks` and `totalBlocks` values returned by `CloudContainer.queryDatabase`.
+     */
+    prefetch(): void;
+}
+/** The properties of the CloudCache used for Workspaces.
+ * @beta
+ */
+export interface WorkspaceCloudCacheProps extends Optional<CloudSqlite.CacheProps, "name" | "rootDir"> {
+    /** if true, empty the cache before using it. */
+    clearContents?: boolean;
 }
 /**
  * Options for constructing a [[Workspace]].
  * @beta
  */
 export interface WorkspaceOpts {
-    /** The local directory for the WorkspaceDb files. The [[Workspace]] will (only) look in this directory
-     * for files named `${this.containerId}/${this.dbId}.itwin-workspace`.
+    /** The local directory for non-cloud-based WorkspaceDb files. The workspace api will look in this directory
+     * for files named `${containerId}/${dbId}.itwin-workspace`.
      * @note if not supplied, defaults to `iTwin/Workspace` in the user-local folder.
      */
     containerDir?: LocalDirName;
+    /** Properties for the cloud cache for the `WorkspaceContainers` of the Workspace. */
+    cloudCacheProps?: WorkspaceCloudCacheProps;
+    /** the local fileName(s) of one or more settings files to load after the Workspace is first created. */
+    settingsFiles?: LocalFileName | [LocalFileName];
 }
 /**
  * Settings and resources that customize an application for the current session.
@@ -135,43 +166,69 @@ export interface WorkspaceOpts {
  * @beta
  */
 export interface Workspace {
-    /** The local directory for the WorkspaceDb files with the name `${containerId}.itwin-workspace`. */
+    /** The directory for local WorkspaceDb files with the name `${containerId}/${dbId}.itwin-workspace`. */
     readonly containerDir: LocalDirName;
     /** The [[Settings]] for this Workspace */
     readonly settings: Settings;
-    getContainer(props: WorkspaceContainerProps): WorkspaceContainer;
-    /**
-     * Resolve a WorkspaceContainerProps to a WorkspaceContainerId. If props is an object with an `id` member, that value is returned unchanged.
-     * If it is a string, then the highest priority [[WorkspaceSetting.containerAlias]] setting with an entry for the WorkspaceContainerName
-     * is used. If no WorkspaceSetting.containerAlias entry for the WorkspaceContainerName can be found, the name is returned as the id.
+    /** The CloudCache for cloud-based WorkspaceContainers */
+    readonly cloudCache?: SQLiteDb.CloudCache;
+    /** search for a previously opened container.
+     * @param containerId the id of the container
+     * @returns the [[WorkspaceContainer]] for `containerId` if it was not previously opened with [[getContainer]]
      */
-    resolveContainerId(props: WorkspaceContainerProps): WorkspaceContainerId;
+    findContainer(containerId: WorkspaceContainer.Id): WorkspaceContainer | undefined;
+    /** get a [[WorkspaceContainer]] by [[WorkspaceContainer.Props]]
+     * @param props the properties of the `WorkspaceContainer`. If `props.containerId` was already opened, its WorkspaceContainer is returned.
+     * Otherwise it is created.
+     * @param account If present, the properties for this container if it is to be opened from the cloud. If not present, the container is just a local directory.
+    */
+    getContainer(props: WorkspaceContainer.Props, account?: WorkspaceAccount.Props): WorkspaceContainer;
+    /** get the properties for the supplied account name by searching for an entry with that name in a `cloud/accounts` setting. */
+    resolveAccount(accountName: WorkspaceAccount.Name): WorkspaceAccount.Props;
+    /** get the properties for the supplied container name by searching for an entry with that name in a `cloud/containers` setting. */
+    resolveContainer(containerName: WorkspaceContainer.Name): WorkspaceContainer.Props & WorkspaceAccount.Alias;
+    /** get the properties for the supplied workspace database name by searching for an entry with that name in a `workspace/databases` setting. */
+    resolveDatabase(databaseAlias: WorkspaceDb.Name): WorkspaceDb.Props & WorkspaceContainer.Alias;
     /**
-     * Get an open [[WorkspaceDb]]. If the WorkspaceDb is present but not open, it is opened first.
-     * If `cloudProps` are supplied, and if container is not  present or not up-to-date, it is downloaded first.
-     * @returns a Promise that is resolved when the container is local, opened, and available for access.
+     * Get an opened [[WorkspaceDb]]. If the WorkspaceDb is present but not open, it is opened first.
+     * If `cloudProps` are supplied, a CloudContainer will be used to open the WorkspaceDb.
+     */
+    getWorkspaceDbFromProps(dbProps: WorkspaceDb.Props, containerProps: WorkspaceContainer.Props, account?: WorkspaceAccount.Props): WorkspaceDb;
+    /** Get an opened [[WorkspaceDb]] from a WorkspaceDb name.
+     * @param databaseName the database name, resolved via [[resolveDatabase]].
+     * @see [[getWorkspaceDbFromProps]]
      */
-    getWorkspaceDb(props: WorkspaceDbProps): Promise<WorkspaceDb>;
+    getWorkspaceDb(databaseName: WorkspaceDb.Name): WorkspaceDb;
     /** Load a WorkspaceResource of type string, parse it, and add it to the current Settings for this Workspace.
      * @note settingsRsc must specify a resource holding a stringified JSON representation of a [[SettingDictionary]]
-     * @returns a Promise that is resolved when the settings resource has been loaded.
      */
-    loadSettingsDictionary(settingRsc: WorkspaceResourceProps, priority: SettingsPriority): Promise<void>;
+    loadSettingsDictionary(settingRsc: WorkspaceResource.Name, db: WorkspaceDb, priority: SettingsPriority): void;
     /** Close this Workspace. All WorkspaceContainers are dropped. */
     close(): void;
 }
-/** A WorkspaceContainer holds WorkspaceDbs.
+/**
+ * A WorkspaceContainer holds WorkspaceDbs.
+ * Access rights are administered per WorkspaceContainer. That is, if a user has rights to access a WorkspaceContainer, that right
+ * applies to all WorkspaceDbs in the WorkspaceContainer.
  * @beta
  */
 export interface WorkspaceContainer {
-    readonly dirName: LocalDirName;
     /** the local directory where this WorkspaceContainer will store temporary files extracted for file-resources. */
     readonly filesDir: LocalDirName;
-    readonly id: WorkspaceContainerId;
+    /** The unique identifier for a WorkspaceContainer a cloud storage account. */
+    readonly id: WorkspaceContainer.Id;
+    /** Workspace holding this WorkspaceContainer. */
     readonly workspace: Workspace;
+    /** CloudContainer for this WorkspaceContainer (`undefined` if this is a local WorkspaceContainer.)
+     * @internal
+    */
+    readonly cloudContainer?: SQLiteDb.CloudContainer;
     /** @internal */
     addWorkspaceDb(toAdd: ITwinWorkspaceDb): void;
-    getWorkspaceDb(props: Optional<WorkspaceDbProps, "containerName">): Promise<WorkspaceDb>;
+    /** @internal */
+    resolveDbFileName(props: WorkspaceDb.Props): string;
+    /** find or open a WorkspaceDb from this WorkspaceContainer. */
+    getWorkspaceDb(props: WorkspaceDb.Props): WorkspaceDb;
     /** Close and remove a currently opened [[WorkspaceDb]] from this Workspace. */
     dropWorkspaceDb(container: WorkspaceDb): void;
     /** Close this WorkspaceContainer. All currently opened WorkspaceDbs are dropped. */
@@ -182,110 +239,149 @@ export declare class ITwinWorkspace implements Workspace {
     private _containers;
     readonly containerDir: LocalDirName;
     readonly settings: Settings;
+    private _cloudCacheProps?;
+    private _cloudCache?;
+    get cloudCache(): SQLiteDb.CloudCache;
     constructor(settings: Settings, opts?: WorkspaceOpts);
     addContainer(toAdd: ITwinWorkspaceContainer): void;
-    getContainer(props: WorkspaceContainerProps): WorkspaceContainer;
-    getWorkspaceDb(props: WorkspaceDbProps): Promise<WorkspaceDb>;
-    loadSettingsDictionary(settingRsc: WorkspaceResourceProps, priority: SettingsPriority): Promise<void>;
+    findContainer(containerId: WorkspaceContainer.Id): ITwinWorkspaceContainer | undefined;
+    getContainer(props: WorkspaceContainer.Props, account?: WorkspaceAccount.Props): WorkspaceContainer;
+    getWorkspaceDbFromProps(dbProps: WorkspaceDb.Props, containerProps: WorkspaceContainer.Props, account?: WorkspaceAccount.Props): WorkspaceDb;
+    getWorkspaceDb(dbAlias: string): WorkspaceDb;
+    loadSettingsDictionary(settingRsc: WorkspaceResource.Name, db: WorkspaceDb, priority: SettingsPriority): void;
     close(): void;
-    resolveContainerId(props: WorkspaceContainerProps): WorkspaceContainerId;
+    resolveAccount(accountName: string): WorkspaceAccount.Props;
+    resolveContainer(containerName: string): WorkspaceContainer.Props & WorkspaceAccount.Alias;
+    resolveDatabase(databaseName: string): WorkspaceDb.Props & WorkspaceContainer.Alias;
 }
 /** @internal */
 export declare class ITwinWorkspaceContainer implements WorkspaceContainer {
     readonly workspace: ITwinWorkspace;
     readonly filesDir: LocalDirName;
-    readonly id: WorkspaceContainerId;
+    readonly id: WorkspaceContainer.Id;
+    readonly cloudContainer?: SQLiteDb.CloudContainer | undefined;
     private _wsDbs;
     get dirName(): string;
+    static noLeadingOrTrailingSpaces(name: string, msg: string): void;
     /** rules for ContainerIds (from Azure, see https://docs.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata)
      *  - may only contain lower case letters, numbers or dashes
      *  - may not start or end with with a dash nor have more than one dash in a row
      *  - may not be shorter than 3 or longer than 63 characters
      */
     private static validateContainerId;
-    constructor(workspace: ITwinWorkspace, id: WorkspaceContainerId);
+    static validateDbName(dbName: WorkspaceDb.DbName): void;
+    constructor(workspace: ITwinWorkspace, props: WorkspaceContainer.Props, account?: WorkspaceAccount.Props);
+    static validateVersion(version?: WorkspaceDb.Version): string;
+    static parseDbFileName(dbFileName: WorkspaceDb.DbFullName): {
+        dbName: WorkspaceDb.DbName;
+        version: WorkspaceDb.Version;
+    };
+    static makeDbFileName(dbName: WorkspaceDb.DbName, version?: WorkspaceDb.Version): WorkspaceDb.DbName;
+    static resolveCloudFileName(cloudContainer: SQLiteDb.CloudContainer, props: WorkspaceDb.Props): WorkspaceDb.DbFullName;
+    /**
+     * Create a copy of an existing [[WorkspaceDb]] in a cloud container with a new version number.
+     * @param cloudContainer The attached cloud container holding the existing WorkspaceDb
+     * @param fromProps Properties that describe the source WorkspaceDb for the new version
+     * @param versionType The type of version increment to apply to the existing version.
+     * @note This requires that the cloudContainer is attached and the write lock on the container be held. The copy should be modified with
+     * new content before the write lock is released, and thereafter should never be modified again.
+     */
+    static makeNewVersion(cloudContainer: SQLiteDb.CloudContainer, fromProps: WorkspaceDb.Props, versionType: WorkspaceDb.VersionIncrement): Promise<{
+        oldName: string;
+        newName: string;
+    }>;
+    /**
+     * Convert a WorkspaceDb.Props specification into a DbFileName. For cloud-based containers, this resolves to the dbName, incorporating the appropriate
+     * version. For file-based containers, this returns a local filename of a WorkspaceDb file with the extension ".itwin-workspace"
+     */
+    resolveDbFileName(props: WorkspaceDb.Props): WorkspaceDb.DbFullName;
     addWorkspaceDb(toAdd: ITwinWorkspaceDb): void;
-    getWorkspaceDb(props: Optional<WorkspaceDbProps, "containerName">): Promise<WorkspaceDb>;
+    getWorkspaceDb(props: WorkspaceDb.Props): WorkspaceDb;
     dropWorkspaceDb(toDrop: WorkspaceDb): void;
     close(): void;
+    /** Delete all local files extracted by [[WorkspaceDb.getFile]] for this container. */
     purgeContainerFiles(): void;
 }
 /**
- * A local file holding a WorkspaceDb.
- * @beta
+ * Implementation of WorkspaceDb
+ * @internal
  */
 export declare class ITwinWorkspaceDb implements WorkspaceDb {
+    /** file extension for local WorkspaceDbs */
+    static readonly fileExt = "itwin-workspace";
+    /** the SQLiteDb for this WorkspaceDb*/
     readonly sqliteDb: SQLiteDb;
-    readonly dbName: WorkspaceDbName;
+    /** the base WorkspaceDb name, without directory, extension, or version information. */
+    readonly dbName: WorkspaceDb.DbName;
+    /** The WorkspaceContainer holding this WorkspaceDb */
     readonly container: WorkspaceContainer;
-    localFile: LocalFileName;
-    readonly onClosed: BeEvent<() => void>;
-    protected static noLeadingOrTrailingSpaces(name: string, msg: string): void;
-    private static validateDbName;
+    /** called before db is closed */
+    readonly onClose: BeEvent<() => void>;
+    /** either a local file name or the name of the file in a cloud container, including version identifier */
+    dbFileName: string;
+    /** true if this WorkspaceDb is currently open */
     get isOpen(): boolean;
-    queryFileResource(rscName: WorkspaceResourceName): {
+    queryFileResource(rscName: WorkspaceResource.Name): {
         localFileName: string;
-        info: IModelJsNative.EmbedFileQuery;
+        info: import("@bentley/imodeljs-native").IModelJsNative.EmbedFileQuery;
     } | undefined;
-    constructor(dbName: WorkspaceDbName, container: WorkspaceContainer);
+    constructor(props: WorkspaceDb.Props, container: WorkspaceContainer);
     open(): void;
     close(): void;
-    getString(rscName: WorkspaceResourceName): string | undefined;
+    getString(rscName: WorkspaceResource.Name): string | undefined;
     /** Get a BlobIO reader for a blob WorkspaceResource.
-     * @note when finished, caller must call `close` on the BlobIO.
+     * @note when finished, caller *must* call `close` on the BlobIO.
      */
-    getBlobReader(rscName: WorkspaceResourceName): IModelJsNative.BlobIO;
-    getBlob(rscName: WorkspaceResourceName): Uint8Array | undefined;
-    getFile(rscName: WorkspaceResourceName, targetFileName?: LocalFileName): LocalFileName | undefined;
+    getBlobReader(rscName: WorkspaceResource.Name): SQLiteDb.BlobIO;
+    getBlob(rscName: WorkspaceResource.Name): Uint8Array | undefined;
+    getFile(rscName: WorkspaceResource.Name, targetFileName?: LocalFileName): LocalFileName | undefined;
+    prefetch(opts?: CloudSqlite.PrefetchProps): SQLiteDb.CloudPrefetch | undefined;
 }
 /**
  * An editable [[WorkspaceDb]]. This is used by administrators for creating and modifying `WorkspaceDb`s.
  * For cloud-backed containers, the write token must be obtained before this class may be used. Only one user at at time
  * may be editing.
- * @beta
+ * @internal
  */
 export declare class EditableWorkspaceDb extends ITwinWorkspaceDb {
-    private _isCloudOpen;
     private static validateResourceName;
     private validateResourceSize;
     open(): void;
-    close(): void;
     private getFileModifiedTime;
     private performWriteSql;
+    createDb(version?: string): Promise<void>;
     /** Create a new, empty, EditableWorkspaceDb for importing Workspace resources. */
-    create(): void;
-    static cloneVersion(oldVersion: WorkspaceDbVersion, newVersion: WorkspaceDbVersion, cloudProps: CloudSqlite.ContainerAccessProps): Promise<void>;
-    upload(cloudProps: CloudSqlite.TransferProps): Promise<void>;
+    static createEmpty(fileName: LocalFileName): void;
     /** Add a new string resource to this WorkspaceDb.
      * @param rscName The name of the string resource.
      * @param val The string to save.
      */
-    addString(rscName: WorkspaceResourceName, val: string): void;
+    addString(rscName: WorkspaceResource.Name, val: string): void;
     /** Update an existing string resource with a new value.
      * @param rscName The name of the string resource.
      * @param val The new value.
      * @throws if rscName does not exist
      */
-    updateString(rscName: WorkspaceResourceName, val: string): void;
+    updateString(rscName: WorkspaceResource.Name, val: string): void;
     /** Remove a string resource. */
-    removeString(rscName: WorkspaceResourceName): void;
+    removeString(rscName: WorkspaceResource.Name): void;
     /** Add a new blob resource to this WorkspaceDb.
      * @param rscName The name of the blob resource.
      * @param val The blob to save.
      */
-    addBlob(rscName: WorkspaceResourceName, val: Uint8Array): void;
+    addBlob(rscName: WorkspaceResource.Name, val: Uint8Array): void;
     /** Update an existing blob resource with a new value.
      * @param rscName The name of the blob resource.
      * @param val The new value.
      * @throws if rscName does not exist
      */
-    updateBlob(rscName: WorkspaceResourceName, val: Uint8Array): void;
+    updateBlob(rscName: WorkspaceResource.Name, val: Uint8Array): void;
     /** Get a BlobIO writer for a previously-added blob WorkspaceResource.
      * @note after writing is complete, caller must call `close` on the BlobIO and must call `saveChanges` on the `db`.
      */
-    getBlobWriter(rscName: WorkspaceResourceName): IModelJsNative.BlobIO;
+    getBlobWriter(rscName: WorkspaceResource.Name): SQLiteDb.BlobIO;
     /** Remove a blob resource. */
-    removeBlob(rscName: WorkspaceResourceName): void;
+    removeBlob(rscName: WorkspaceResource.Name): void;
     /** Copy the contents of an existing local file into this WorkspaceDb as a file resource.
      * @param rscName The name of the file resource.
      * @param localFileName The name of a local file to be read.
@@ -293,14 +389,14 @@ export declare class EditableWorkspaceDb extends ITwinWorkspaceDb {
      * when this WorkspaceDb is extracted from the WorkspaceDb. By default the characters after the last "." in `localFileName`
      * are used. Pass this argument to override that.
      */
-    addFile(rscName: WorkspaceResourceName, localFileName: LocalFileName, fileExt?: string): void;
-    /** Replace an existing file resource with the contents of a local file.
+    addFile(rscName: WorkspaceResource.Name, localFileName: LocalFileName, fileExt?: string): void;
+    /** Replace an existing file resource with the contents of another local file.
      * @param rscName The name of the file resource.
      * @param localFileName The name of a local file to be read.
      * @throws if rscName does not exist
      */
-    updateFile(rscName: WorkspaceResourceName, localFileName: LocalFileName): void;
+    updateFile(rscName: WorkspaceResource.Name, localFileName: LocalFileName): void;
     /** Remove a file resource. */
-    removeFile(rscName: WorkspaceResourceName): void;
+    removeFile(rscName: WorkspaceResource.Name): void;
 }
 //# sourceMappingURL=Workspace.d.ts.map

package/lib/cjs/workspace/Workspace.d.ts.map

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