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

package/lib/cjs/workspace/Workspace.js.map

@@ -1 +1 @@
-{"version":3,"file":"Workspace.js","sourceRoot":"","sources":["../../../src/workspace/Workspace.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Workspace\r\n */\r\n\r\nimport { createHash } from \"crypto\";\r\nimport * as fs from \"fs-extra\";\r\nimport { dirname, extname, join } from \"path\";\r\nimport { CloudSqlite, IModelJsNative, NativeLibrary } from \"@bentley/imodeljs-native\";\r\nimport { BeEvent, DbResult, OpenMode, Optional } from \"@itwin/core-bentley\";\r\nimport { IModelError, LocalDirName, LocalFileName } from \"@itwin/core-common\";\r\nimport { IModelJsFs } from \"../IModelJsFs\";\r\nimport { SQLiteDb } from \"../SQLiteDb\";\r\nimport { SqliteStatement } from \"../SqliteStatement\";\r\nimport { Settings, SettingsPriority } from \"./Settings\";\r\n\r\n// cspell:ignore rowid\r\n\r\n/** The names of Settings used by Workspace\r\n * @beta\r\n */\r\nenum WorkspaceSetting {\r\n  ContainerAlias = \"workspace/container/alias\",\r\n}\r\n\r\nconst workspaceDbFileExt = \"itwin-workspace\";\r\n\r\n/**\r\n * The name of a WorkspaceContainer. This is the user-supplied name of a WorkspaceContainer, used to specify its *purpose* within a workspace.\r\n * WorkspaceContainerName can be \"aliased\" by `WorkspaceSetting.containerAlias` settings so that \"resolved\" [[WorkspaceContainerId]] that supplies\r\n * the actual WorkspaceContainer for a WorkspaceContainerName may vary. Also note that more than one WorkspaceContainerName may resolve to the same\r\n * WorkspaceContainerId, if multiple purposes are served by the same WorkspaceContainer.\r\n * @note there are no constraints on the contents or length of `WorkspaceContainerName`s, although short descriptive names are recommended.\r\n * However, when no alias exists in WorkspaceSetting.containerAlias for a WorkspaceContainerName, then the WorkspaceContainerName becomes\r\n * the WorkspaceContainerId, and the constraints on WorkspaceContainerId apply.\r\n * @beta\r\n */\r\nexport type WorkspaceContainerName = string;\r\n\r\n/**\r\n * The unique identifier of a WorkspaceContainer. This becomes the base name for the local directory holding the WorkspaceDbs from a WorkspaceContainer.\r\n * `WorkspaceContainerName`s are resolved to WorkspaceContainerId through `WorkspaceSetting.containerAlias` settings,\r\n * so users may not recognize the actual WorkspaceContainerId supplying resources for a WorkspaceDbName.\r\n *\r\n * `WorkspaceContainerId`s :\r\n *  - may only contain lower case letters, numbers or dashes\r\n *  - may not start or end with with a dash\r\n *  - be shorter than 3 or longer than 63 characters\r\n * @beta\r\n */\r\nexport type WorkspaceContainerId = string;\r\n\r\n/** The name of a WorkspaceDb within a WorkspaceContainer.\r\n * @beta\r\n */\r\nexport type WorkspaceDbName = string;\r\n\r\n/**\r\n * The version name for a WorkspaceDb. More than one version of a WorkspaceDb may be stored in the same WorkspaceContainer. This\r\n * string identifies a specific version.\r\n * @beta\r\n */\r\nexport type WorkspaceDbVersion = string;\r\n\r\n/**\r\n * The name for identifying WorkspaceResources in a [[WorkspaceDb]].\r\n * * `WorkspaceResourceName`s may not:\r\n *  - be blank or start or end with a space\r\n *  - be longer than 1024 characters\r\n * @note a single WorkspaceDb may hold WorkspaceResources of type 'blob', 'string' and 'file', all with the same WorkspaceResourceName.\r\n * @beta\r\n */\r\nexport type WorkspaceResourceName = string;\r\n\r\n/** supply either container name of id, not both\r\n * @beta\r\n */\r\nexport type ContainerNameOrId = { containerName: WorkspaceContainerName, containerId?: never } | { containerId: WorkspaceContainerId, containerName?: never };\r\n\r\n/**\r\n * Properties that specify a WorkspaceContainer.\r\n * This can either be a WorkspaceContainerName or a WorkspaceContainerId. If id is supplied,\r\n * it is used directly. Otherwise name must be resolved via [[Workspace.resolveContainerId]].\r\n * @beta\r\n */\r\nexport type WorkspaceContainerProps = ContainerNameOrId & {\r\n  cloudProps?: CloudSqlite.TransferProps;\r\n};\r\n\r\n/** Properties of a WorkspaceDb\r\n * @beta\r\n */\r\nexport type WorkspaceDbProps = WorkspaceContainerProps & {\r\n  /** the name of the WorkspaceDb */\r\n  dbName: WorkspaceDbName;\r\n};\r\n\r\n/** Properties that specify a WorkspaceResource within a WorkspaceDb.\r\n * @beta\r\n */\r\nexport type WorkspaceResourceProps = WorkspaceDbProps & {\r\n  /** the name of the resource within [[db]] */\r\n  rscName: WorkspaceResourceName;\r\n};\r\n\r\n/**\r\n * A WorkspaceDb holds workspace resources. `WorkspaceDb`s may just be local files, or they may be  stored and\r\n * synchronized in WorkspaceContainers. Each `WorkspaceResource` in a WorkspaceDb is  identified by a [[WorkspaceResourceName]].\r\n * Resources of type `string` and `blob` may be loaded directly from the `WorkspaceDb`. Resources of type `file` are\r\n * copied from the WorkspaceDb into a temporary local file so they can be accessed directly.\r\n * @beta\r\n */\r\nexport interface WorkspaceDb {\r\n  readonly container: WorkspaceContainer;\r\n  /** The WorkspaceDbName of this WorkspaceDb. */\r\n  readonly dbName: WorkspaceDbName;\r\n  /** event raised when this WorkspaceDb is closed. */\r\n  readonly onClosed: BeEvent<() => void>;\r\n  /** The name of the local file for holding this WorkspaceDb. */\r\n  readonly localFile: LocalDirName;\r\n  /** Get a string resource from this WorkspaceDb, if present. */\r\n  getString(rscName: WorkspaceResourceName): string | undefined;\r\n\r\n  /** Get a blob resource from this WorkspaceDb, if present. */\r\n  getBlob(rscName: WorkspaceResourceName): Uint8Array | undefined;\r\n  /** @internal */\r\n  getBlobReader(rscName: WorkspaceResourceName): IModelJsNative.BlobIO;\r\n\r\n  /** Extract a local copy of a file resource from this WorkspaceDb, if present.\r\n   * @param rscName The name of the file resource in the WorkspaceDb\r\n   * @param targetFileName optional name for extracted file. Some applications require files in specific locations or filenames. If\r\n   * 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\r\n   * keep the extracted files in the  container filesDir.\r\n   * @returns the full path to a file on the local filesystem.\r\n   * @note The file is copied from the file into the local filesystem so it may be accessed directly. This happens only\r\n   * as necessary, if the local file doesn't exist, or if it is out-of-date because it was updated in the file.\r\n   * For this reason, you should not save the local file name, and instead call this method every time you access it, so its\r\n   * content is always holds the correct version.\r\n   * @note The filename will be a hash value, not the resource name.\r\n   * @note Workspace resource files are set readonly as they are copied from the file.\r\n   * To edit them, you must first copy them to another location.\r\n   */\r\n  getFile(rscName: WorkspaceResourceName, targetFileName?: LocalFileName): LocalFileName | undefined;\r\n}\r\n\r\n/**\r\n * Options for constructing a [[Workspace]].\r\n * @beta\r\n */\r\nexport interface WorkspaceOpts {\r\n  /** The local directory for the WorkspaceDb files. The [[Workspace]] will (only) look in this directory\r\n   * for files named `${this.containerId}/${this.dbId}.itwin-workspace`.\r\n   * @note if not supplied, defaults to `iTwin/Workspace` in the user-local folder.\r\n   */\r\n  containerDir?: LocalDirName;\r\n}\r\n\r\n/**\r\n * Settings and resources that customize an application for the current session.\r\n * See [Workspaces]($docs/learning/backend/Workspace)\r\n * @beta\r\n */\r\nexport interface Workspace {\r\n  /** The local directory for the WorkspaceDb files with the name `${containerId}.itwin-workspace`. */\r\n  readonly containerDir: LocalDirName;\r\n  /** The [[Settings]] for this Workspace */\r\n  readonly settings: Settings;\r\n\r\n  getContainer(props: WorkspaceContainerProps): WorkspaceContainer;\r\n\r\n  /**\r\n   * Resolve a WorkspaceContainerProps to a WorkspaceContainerId. If props is an object with an `id` member, that value is returned unchanged.\r\n   * If it is a string, then the highest priority [[WorkspaceSetting.containerAlias]] setting with an entry for the WorkspaceContainerName\r\n   * is used. If no WorkspaceSetting.containerAlias entry for the WorkspaceContainerName can be found, the name is returned as the id.\r\n   */\r\n  resolveContainerId(props: WorkspaceContainerProps): WorkspaceContainerId;\r\n  /**\r\n   * Get an open [[WorkspaceDb]]. If the WorkspaceDb is present but not open, it is opened first.\r\n   * If `cloudProps` are supplied, and if container is not  present or not up-to-date, it is downloaded first.\r\n   * @returns a Promise that is resolved when the container is local, opened, and available for access.\r\n   */\r\n  getWorkspaceDb(props: WorkspaceDbProps): Promise<WorkspaceDb>;\r\n  /** Load a WorkspaceResource of type string, parse it, and add it to the current Settings for this Workspace.\r\n   * @note settingsRsc must specify a resource holding a stringified JSON representation of a [[SettingDictionary]]\r\n   * @returns a Promise that is resolved when the settings resource has been loaded.\r\n   */\r\n  loadSettingsDictionary(settingRsc: WorkspaceResourceProps, priority: SettingsPriority): Promise<void>;\r\n  /** Close this Workspace. All WorkspaceContainers are dropped. */\r\n  close(): void;\r\n}\r\n\r\n/** A WorkspaceContainer holds WorkspaceDbs.\r\n * @beta\r\n */\r\nexport interface WorkspaceContainer {\r\n  readonly dirName: LocalDirName;\r\n  /** the local directory where this WorkspaceContainer will store temporary files extracted for file-resources. */\r\n  readonly filesDir: LocalDirName;\r\n  readonly id: WorkspaceContainerId;\r\n  readonly workspace: Workspace;\r\n  /** @internal */\r\n  addWorkspaceDb(toAdd: ITwinWorkspaceDb): void;\r\n\r\n  getWorkspaceDb(props: Optional<WorkspaceDbProps, \"containerName\">): Promise<WorkspaceDb>;\r\n  /** Close and remove a currently opened [[WorkspaceDb]] from this Workspace. */\r\n  dropWorkspaceDb(container: WorkspaceDb): void;\r\n  /** Close this WorkspaceContainer. All currently opened WorkspaceDbs are dropped. */\r\n  close(): void;\r\n}\r\n\r\n/** @internal */\r\nexport class ITwinWorkspace implements Workspace {\r\n  private _containers = new Map<WorkspaceContainerId, ITwinWorkspaceContainer>();\r\n  public readonly containerDir: LocalDirName;\r\n  public readonly settings: Settings;\r\n\r\n  public constructor(settings: Settings, opts?: WorkspaceOpts) {\r\n    this.settings = settings;\r\n    this.containerDir = opts?.containerDir ?? join(NativeLibrary.defaultLocalDir, \"iTwin\", \"Workspace\");\r\n  }\r\n\r\n  public addContainer(toAdd: ITwinWorkspaceContainer) {\r\n    if (undefined !== this._containers.get(toAdd.id))\r\n      throw new Error(\"container already exists in workspace\");\r\n    this._containers.set(toAdd.id, toAdd);\r\n  }\r\n  public getContainer(props: WorkspaceContainerProps): WorkspaceContainer {\r\n    const id = this.resolveContainerId(props);\r\n    if (undefined === id)\r\n      throw new Error(`can't resolve workspace container name [${props.containerName}]`);\r\n\r\n    return this._containers.get(id) ?? new ITwinWorkspaceContainer(this, id);\r\n  }\r\n\r\n  public async getWorkspaceDb(props: WorkspaceDbProps): Promise<WorkspaceDb> {\r\n    return this.getContainer(props).getWorkspaceDb(props);\r\n  }\r\n\r\n  public async loadSettingsDictionary(settingRsc: WorkspaceResourceProps, priority: SettingsPriority) {\r\n    const db = await this.getWorkspaceDb(settingRsc);\r\n    const setting = db.getString(settingRsc.rscName);\r\n    if (undefined === setting)\r\n      throw new Error(`could not load setting resource ${settingRsc.rscName}`);\r\n\r\n    this.settings.addJson(`${db.container.id}/${db.dbName}/${settingRsc.rscName}`, priority, setting);\r\n  }\r\n\r\n  public close() {\r\n    this.settings.close();\r\n    for (const [_id, container] of this._containers)\r\n      container.close();\r\n    this._containers.clear();\r\n  }\r\n\r\n  public resolveContainerId(props: WorkspaceContainerProps): WorkspaceContainerId {\r\n    if (props.containerId)\r\n      return props.containerId; // if the container id is supplied, just use it\r\n\r\n    const id = this.settings.resolveSetting(WorkspaceSetting.ContainerAlias, (val) => {\r\n      if (Array.isArray(val)) {\r\n        for (const entry of val) {\r\n          if (typeof entry === \"object\" && entry.name === props.containerName && typeof entry.id === \"string\")\r\n            return entry.id;\r\n        }\r\n      }\r\n      return undefined; // keep going through all settings dictionaries\r\n    }, props.containerName);\r\n    if (undefined === id)\r\n      throw new Error(\"Unable to resolve container id.\");\r\n    return id;\r\n  }\r\n}\r\n\r\n/** @internal */\r\nexport class ITwinWorkspaceContainer implements WorkspaceContainer {\r\n  public readonly workspace: ITwinWorkspace;\r\n  public readonly filesDir: LocalDirName;\r\n  public readonly id: WorkspaceContainerId;\r\n  private _wsDbs = new Map<WorkspaceDbName, ITwinWorkspaceDb>();\r\n  public get dirName() { return join(this.workspace.containerDir, this.id); }\r\n\r\n  /** rules for ContainerIds (from Azure, see https://docs.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata)\r\n   *  - may only contain lower case letters, numbers or dashes\r\n   *  - may not start or end with with a dash nor have more than one dash in a row\r\n   *  - may not be shorter than 3 or longer than 63 characters\r\n   */\r\n  private static validateContainerId(id: WorkspaceContainerId) {\r\n    if (!/^(?=.{3,63}$)[a-z0-9]+(-[a-z0-9]+)*$/g.test(id))\r\n      throw new Error(`invalid containerId: [${id}]`);\r\n  }\r\n\r\n  public constructor(workspace: ITwinWorkspace, id: WorkspaceContainerId) {\r\n    ITwinWorkspaceContainer.validateContainerId(id);\r\n    this.workspace = workspace;\r\n    this.id = id;\r\n    workspace.addContainer(this);\r\n    this.filesDir = join(this.dirName, \"Files\");\r\n  }\r\n\r\n  public addWorkspaceDb(toAdd: ITwinWorkspaceDb) {\r\n    if (undefined !== this._wsDbs.get(toAdd.dbName))\r\n      throw new Error(\"dbName already exists in workspace\");\r\n    this._wsDbs.set(toAdd.dbName, toAdd);\r\n  }\r\n\r\n  public async getWorkspaceDb(props: Optional<WorkspaceDbProps, \"containerName\">): Promise<WorkspaceDb> {\r\n    const db = this._wsDbs.get(props.dbName) ?? new ITwinWorkspaceDb(props.dbName, this);\r\n    if (!db.isOpen) {\r\n      if (props.cloudProps)\r\n        await CloudSqlite.downloadDb({ ...db, ...props.cloudProps, containerId: this.id });\r\n      db.open();\r\n    }\r\n    return db;\r\n  }\r\n\r\n  public dropWorkspaceDb(toDrop: WorkspaceDb): void {\r\n    const name = toDrop.dbName;\r\n    const wsDb = this._wsDbs.get(name);\r\n    if (wsDb === toDrop) {\r\n      wsDb.close();\r\n      this._wsDbs.delete(name);\r\n    }\r\n  }\r\n\r\n  public close() {\r\n    for (const [_name, db] of this._wsDbs)\r\n      db.close();\r\n    this._wsDbs.clear();\r\n  }\r\n\r\n  public purgeContainerFiles() {\r\n    IModelJsFs.purgeDirSync(this.filesDir);\r\n  }\r\n}\r\n\r\n/**\r\n * A local file holding a WorkspaceDb.\r\n * @beta\r\n */\r\nexport class ITwinWorkspaceDb implements WorkspaceDb {\r\n  public readonly sqliteDb = new SQLiteDb(); // eslint-disable-line @typescript-eslint/naming-convention\r\n  public readonly dbName: WorkspaceDbName;\r\n  public readonly container: WorkspaceContainer;\r\n  public localFile: LocalFileName;\r\n  public readonly onClosed = new BeEvent<() => void>();\r\n\r\n  protected static noLeadingOrTrailingSpaces(name: string, msg: string) {\r\n    if (name.trim() !== name)\r\n      throw new Error(`${msg} [${name}] may not have leading or tailing spaces`);\r\n  }\r\n\r\n  private static validateDbName(dbName: WorkspaceDbName) {\r\n    if (dbName === \"\" || dbName.length > 255 || /[#\\.<>:\"/\\\\\"`'|?*\\u0000-\\u001F]/g.test(dbName) || /^(con|prn|aux|nul|com\\d|lpt\\d)$/i.test(dbName))\r\n      throw new Error(`invalid dbName: [${dbName}]`);\r\n    this.noLeadingOrTrailingSpaces(dbName, \"dbName\");\r\n  }\r\n\r\n  public get isOpen() { return this.sqliteDb.isOpen; }\r\n  public queryFileResource(rscName: WorkspaceResourceName) {\r\n    const info = this.sqliteDb.nativeDb.queryEmbeddedFile(rscName);\r\n    if (undefined === info)\r\n      return undefined;\r\n\r\n    // since resource names can contain illegal characters, path separators, etc., we make the local file name from its hash, in hex.\r\n    let localFileName = join(this.container.filesDir, createHash(\"sha1\").update(rscName).digest(\"hex\"));\r\n    if (info.fileExt !== \"\") // since some applications may expect to see the extension, append it here if it was supplied.\r\n      localFileName = `${localFileName}.${info.fileExt}`;\r\n    return { localFileName, info };\r\n  }\r\n\r\n  public constructor(dbName: WorkspaceDbName, container: WorkspaceContainer) {\r\n    ITwinWorkspaceDb.validateDbName(dbName);\r\n    this.dbName = dbName;\r\n    this.container = container;\r\n    this.localFile = join(container.dirName, `${dbName}.${workspaceDbFileExt}`);\r\n    container.addWorkspaceDb(this);\r\n  }\r\n\r\n  public open(): void {\r\n    this.sqliteDb.openDb(this.localFile, OpenMode.Readonly);\r\n  }\r\n\r\n  public close(): void {\r\n    if (this.isOpen) {\r\n      this.onClosed.raiseEvent();\r\n      this.sqliteDb.closeDb();\r\n      this.container.dropWorkspaceDb(this);\r\n    }\r\n  }\r\n\r\n  public getString(rscName: WorkspaceResourceName): string | undefined {\r\n    return this.sqliteDb.withSqliteStatement(\"SELECT value from strings WHERE id=?\", (stmt) => {\r\n      stmt.bindString(1, rscName);\r\n      return DbResult.BE_SQLITE_ROW === stmt.step() ? stmt.getValueString(0) : undefined;\r\n    });\r\n  }\r\n\r\n  /** Get a BlobIO reader for a blob WorkspaceResource.\r\n   * @note when finished, caller must call `close` on the BlobIO.\r\n   */\r\n  public getBlobReader(rscName: WorkspaceResourceName): IModelJsNative.BlobIO {\r\n    return this.sqliteDb.withSqliteStatement(\"SELECT rowid from blobs WHERE id=?\", (stmt) => {\r\n      stmt.bindString(1, rscName);\r\n      const blobReader = new IModelJsNative.BlobIO();\r\n      blobReader.open(this.sqliteDb.nativeDb, { tableName: \"blobs\", columnName: \"value\", row: stmt.getValueInteger(0) });\r\n      return blobReader;\r\n    });\r\n  }\r\n\r\n  public getBlob(rscName: WorkspaceResourceName): Uint8Array | undefined {\r\n    return this.sqliteDb.withSqliteStatement(\"SELECT value from blobs WHERE id=?\", (stmt) => {\r\n      stmt.bindString(1, rscName);\r\n      return DbResult.BE_SQLITE_ROW === stmt.step() ? stmt.getValueBlob(0) : undefined;\r\n    });\r\n  }\r\n\r\n  public getFile(rscName: WorkspaceResourceName, targetFileName?: LocalFileName): LocalFileName | undefined {\r\n    const file = this.queryFileResource(rscName);\r\n    if (!file)\r\n      return undefined;\r\n\r\n    const info = file.info;\r\n    const localFileName = targetFileName ?? file.localFileName;\r\n\r\n    // check whether the file is already up to date.\r\n    const stat = fs.existsSync(localFileName) && fs.statSync(localFileName);\r\n    if (stat && Math.round(stat.mtimeMs) === info.date && stat.size === info.size)\r\n      return localFileName; // yes, we're done\r\n\r\n    // extractEmbeddedFile fails if the file exists or if the directory does not exist\r\n    if (stat)\r\n      fs.removeSync(localFileName);\r\n    else\r\n      IModelJsFs.recursiveMkDirSync(dirname(localFileName));\r\n\r\n    this.sqliteDb.nativeDb.extractEmbeddedFile({ name: rscName, localFileName });\r\n    const date = new Date(info.date);\r\n    fs.utimesSync(localFileName, date, date); // set the last-modified date of the file to match date in container\r\n    fs.chmodSync(localFileName, \"0444\"); // set file readonly\r\n    return localFileName;\r\n  }\r\n}\r\n\r\n/**\r\n * An editable [[WorkspaceDb]]. This is used by administrators for creating and modifying `WorkspaceDb`s.\r\n * For cloud-backed containers, the write token must be obtained before this class may be used. Only one user at at time\r\n * may be editing.\r\n * @beta\r\n */\r\nexport class EditableWorkspaceDb extends ITwinWorkspaceDb {\r\n  private _isCloudOpen = false;\r\n  private static validateResourceName(name: WorkspaceResourceName) {\r\n    ITwinWorkspaceDb.noLeadingOrTrailingSpaces(name, \"resource name\");\r\n    if (name.length > 1024)\r\n      throw new Error(\"resource name too long\");\r\n  }\r\n\r\n  private validateResourceSize(val: Uint8Array | string) {\r\n    const len = typeof val === \"string\" ? val.length : val.byteLength;\r\n    if (len > (1024 * 1024 * 1024)) // one gigabyte\r\n      throw new Error(\"value is too large\");\r\n  }\r\n\r\n  public override open() {\r\n    this.sqliteDb.openDb(this.localFile, OpenMode.ReadWrite);\r\n  }\r\n\r\n  public override close() {\r\n    if (this._isCloudOpen) {\r\n      //  this.db.nativeDb.flushCloudUpload(); TODO: add back when available\r\n      this._isCloudOpen = false;\r\n    }\r\n    super.close();\r\n  }\r\n\r\n  private getFileModifiedTime(localFileName: LocalFileName): number {\r\n    return Math.round(fs.statSync(localFileName).mtimeMs);\r\n  }\r\n\r\n  private performWriteSql(rscName: WorkspaceResourceName, sql: string, bind?: (stmt: SqliteStatement) => void) {\r\n    this.sqliteDb.withSqliteStatement(sql, (stmt) => {\r\n      stmt.bindString(1, rscName);\r\n      bind?.(stmt);\r\n      const rc = stmt.step();\r\n      if (DbResult.BE_SQLITE_DONE !== rc)\r\n        throw new IModelError(rc, \"workspace write error\");\r\n    });\r\n    this.sqliteDb.saveChanges();\r\n  }\r\n\r\n  /** Create a new, empty, EditableWorkspaceDb for importing Workspace resources. */\r\n  public create() {\r\n    IModelJsFs.recursiveMkDirSync(dirname(this.localFile));\r\n    this.sqliteDb.createDb(this.localFile);\r\n    this.sqliteDb.executeSQL(\"CREATE TABLE strings(id TEXT PRIMARY KEY NOT NULL,value TEXT)\");\r\n    this.sqliteDb.executeSQL(\"CREATE TABLE blobs(id TEXT PRIMARY KEY NOT NULL,value BLOB)\");\r\n    this.sqliteDb.saveChanges();\r\n  }\r\n\r\n  public static async cloneVersion(oldVersion: WorkspaceDbVersion, newVersion: WorkspaceDbVersion, cloudProps: CloudSqlite.ContainerAccessProps) {\r\n    return CloudSqlite.copyDb(oldVersion, newVersion, cloudProps);\r\n  }\r\n\r\n  public async upload(cloudProps: CloudSqlite.TransferProps) {\r\n    return CloudSqlite.uploadDb({ ...cloudProps, ...this });\r\n  }\r\n\r\n  /** Add a new string resource to this WorkspaceDb.\r\n   * @param rscName The name of the string resource.\r\n   * @param val The string to save.\r\n   */\r\n  public addString(rscName: WorkspaceResourceName, val: string): void {\r\n    EditableWorkspaceDb.validateResourceName(rscName);\r\n    this.validateResourceSize(val);\r\n    this.performWriteSql(rscName, \"INSERT INTO strings(id,value) VALUES(?,?)\", (stmt) => stmt.bindString(2, val));\r\n  }\r\n\r\n  /** Update an existing string resource with a new value.\r\n   * @param rscName The name of the string resource.\r\n   * @param val The new value.\r\n   * @throws if rscName does not exist\r\n   */\r\n  public updateString(rscName: WorkspaceResourceName, val: string): void {\r\n    this.validateResourceSize(val);\r\n    this.performWriteSql(rscName, \"UPDATE strings SET value=?2 WHERE id=?1\", (stmt) => stmt.bindString(2, val));\r\n  }\r\n\r\n  /** Remove a string resource. */\r\n  public removeString(rscName: WorkspaceResourceName): void {\r\n    this.performWriteSql(rscName, \"DELETE FROM strings WHERE id=?\");\r\n  }\r\n\r\n  /** Add a new blob resource to this WorkspaceDb.\r\n   * @param rscName The name of the blob resource.\r\n   * @param val The blob to save.\r\n   */\r\n  public addBlob(rscName: WorkspaceResourceName, val: Uint8Array): void {\r\n    EditableWorkspaceDb.validateResourceName(rscName);\r\n    this.validateResourceSize(val);\r\n    this.performWriteSql(rscName, \"INSERT INTO blobs(id,value) VALUES(?,?)\", (stmt) => stmt.bindBlob(2, val));\r\n  }\r\n\r\n  /** Update an existing blob resource with a new value.\r\n   * @param rscName The name of the blob resource.\r\n   * @param val The new value.\r\n   * @throws if rscName does not exist\r\n   */\r\n  public updateBlob(rscName: WorkspaceResourceName, val: Uint8Array): void {\r\n    this.validateResourceSize(val);\r\n    this.performWriteSql(rscName, \"UPDATE blobs SET value=?2 WHERE id=?1\", (stmt) => stmt.bindBlob(2, val));\r\n  }\r\n\r\n  /** Get a BlobIO writer for a previously-added blob WorkspaceResource.\r\n   * @note after writing is complete, caller must call `close` on the BlobIO and must call `saveChanges` on the `db`.\r\n   */\r\n  public getBlobWriter(rscName: WorkspaceResourceName): IModelJsNative.BlobIO {\r\n    return this.sqliteDb.withSqliteStatement(\"SELECT rowid from blobs WHERE id=?\", (stmt) => {\r\n      stmt.bindString(1, rscName);\r\n      const blobWriter = new IModelJsNative.BlobIO();\r\n      blobWriter.open(this.sqliteDb.nativeDb, { tableName: \"blobs\", columnName: \"value\", row: stmt.getValueInteger(0), writeable: true });\r\n      return blobWriter;\r\n    });\r\n  }\r\n\r\n  /** Remove a blob resource. */\r\n  public removeBlob(rscName: WorkspaceResourceName): void {\r\n    this.performWriteSql(rscName, \"DELETE FROM blobs WHERE id=?\");\r\n  }\r\n\r\n  /** Copy the contents of an existing local file into this WorkspaceDb as a file resource.\r\n   * @param rscName The name of the file resource.\r\n   * @param localFileName The name of a local file to be read.\r\n   * @param fileExt The extension (do not include the leading \".\") to be appended to the generated fileName\r\n   * when this WorkspaceDb is extracted from the WorkspaceDb. By default the characters after the last \".\" in `localFileName`\r\n   * are used. Pass this argument to override that.\r\n   */\r\n  public addFile(rscName: WorkspaceResourceName, localFileName: LocalFileName, fileExt?: string): void {\r\n    EditableWorkspaceDb.validateResourceName(rscName);\r\n    fileExt = fileExt ?? extname(localFileName);\r\n    if (fileExt?.[0] === \".\")\r\n      fileExt = fileExt.slice(1);\r\n    this.sqliteDb.nativeDb.embedFile({ name: rscName, localFileName, date: this.getFileModifiedTime(localFileName), fileExt });\r\n  }\r\n\r\n  /** Replace an existing file resource with the contents of a local file.\r\n   * @param rscName The name of the file resource.\r\n   * @param localFileName The name of a local file to be read.\r\n   * @throws if rscName does not exist\r\n   */\r\n  public updateFile(rscName: WorkspaceResourceName, localFileName: LocalFileName): void {\r\n    this.queryFileResource(rscName); // throws if not present\r\n    this.sqliteDb.nativeDb.replaceEmbeddedFile({ name: rscName, localFileName, date: this.getFileModifiedTime(localFileName) });\r\n  }\r\n\r\n  /** Remove a file resource. */\r\n  public removeFile(rscName: WorkspaceResourceName): void {\r\n    const file = this.queryFileResource(rscName);\r\n    if (undefined === file)\r\n      throw new Error(`file resource \"${rscName}\" does not exist`);\r\n    if (file && fs.existsSync(file.localFileName))\r\n      fs.unlinkSync(file.localFileName);\r\n    this.sqliteDb.nativeDb.removeEmbeddedFile(rscName);\r\n  }\r\n}\r\n\r\n"]}
+{"version":3,"file":"Workspace.js","sourceRoot":"","sources":["../../../src/workspace/Workspace.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Workspace\r\n */\r\n\r\nimport { createHash } from \"crypto\";\r\nimport * as fs from \"fs-extra\";\r\nimport { dirname, extname, join } from \"path\";\r\nimport * as semver from \"semver\";\r\nimport { CloudSqlite } from \"@bentley/imodeljs-native\";\r\nimport { BeEvent, DbResult, OpenMode, Optional } from \"@itwin/core-bentley\";\r\nimport { IModelError, LocalDirName, LocalFileName } from \"@itwin/core-common\";\r\nimport { IModelHost, KnownLocations } from \"../IModelHost\";\r\nimport { IModelJsFs } from \"../IModelJsFs\";\r\nimport { SQLiteDb } from \"../SQLiteDb\";\r\nimport { SqliteStatement } from \"../SqliteStatement\";\r\nimport { Settings, SettingsPriority } from \"./Settings\";\r\nimport { SettingsSchemas } from \"./SettingsSchemas\";\r\n\r\n/* eslint-disable @typescript-eslint/naming-convention */\r\n// cspell:ignore rowid primarykey\r\n\r\n/** The Settings used by Workspace api\r\n * @beta\r\n */\r\nexport const WorkspaceSetting = {\r\n  Accounts: \"cloud/accounts\",\r\n  Containers: \"cloud/containers\",\r\n  Databases: \"workspace/databases\",\r\n};\r\n\r\n/** Types used to identify cloud accounts for Workspaces.\r\n *  @beta\r\n */\r\nexport namespace WorkspaceAccount {\r\n  /** The name of a WorkspaceAccount in a \"cloud/accounts\" setting. */\r\n  export type Name = string;\r\n\r\n  /** A member named `accountName` that specifies by an entry in a \"cloud/accounts\" setting */\r\n  export interface Alias { accountName: string }\r\n\r\n  /** The properties of a cloud account required to open containers with CloudSqlite. Usually supplied via a \"cloud/accounts\" setting. */\r\n  export type Props = CloudSqlite.AccountAccessProps;\r\n}\r\n\r\n/** @beta */\r\nexport namespace WorkspaceContainer {\r\n  /** The name of a WorkspaceContainer in a \"cloud/containers\" setting. */\r\n  export type Name = string;\r\n\r\n  /** The unique identifier of a WorkspaceContainer. This becomes the base name for the local directory holding the WorkspaceDbs from a WorkspaceContainer.\r\n   * Usually supplied via the `containerId` member of a \"cloud/containers\" setting.\r\n   * `WorkspaceContainer.Id`s may:\r\n   *  - only contain lower case letters, numbers or dashes\r\n   *  - not start or end with a dash\r\n   *  - not be shorter than 3 or longer than 63 characters\r\n   */\r\n  export type Id = string;\r\n\r\n  /** A member named `containerName` that specifies by an entry in a \"cloud/containers\" setting */\r\n  export interface Alias { containerName: string }\r\n\r\n  /** Properties that specify a WorkspaceContainer. */\r\n  export interface Props extends Optional<CloudSqlite.ContainerProps, \"accessToken\"> {\r\n    /** true if the container is public (doesn't require authentication) */\r\n    isPublic?: boolean;\r\n    /** attempt to synchronize (i.e. call `checkForChanges`) this cloud container whenever it is connected to a cloud cache. */\r\n    syncOnConnect?: boolean;\r\n  }\r\n}\r\n\r\n/** @beta */\r\nexport namespace WorkspaceDb {\r\n  /** The name of a WorkspaceDb in a \"workspace/databases\" setting. */\r\n  export type Name = string;\r\n\r\n  /** The base name of a WorkspaceDb within a WorkspaceContainer (without any version identifier) */\r\n  export type DbName = string;\r\n\r\n  /** The  name of a WorkspaceDb within a WorkspaceContainer, including the version identifier */\r\n  export type DbFullName = string;\r\n\r\n  /** The semver-format version identifier for a WorkspaceDb. */\r\n  export type Version = string;\r\n\r\n  /** The [semver range format](https://github.com/npm/node-semver) identifier for a range of acceptable versions. */\r\n  export type VersionRange = string;\r\n\r\n  /** Properties that specify how to load a WorkspaceDb within a [[WorkspaceContainer]]. */\r\n  export interface Props extends CloudSqlite.DbNameProp {\r\n    /** a semver version range specifier that determines the acceptable range of versions to load. If not present, use the newest version. */\r\n    version?: VersionRange;\r\n    /** if true, allow semver *prerelease* versions. By default only released version are allowed. */\r\n    includePrerelease?: boolean;\r\n  }\r\n\r\n  /** Scope to increment for a version number.\r\n   * @see semver.ReleaseType\r\n   */\r\n  export type VersionIncrement = \"major\" | \"minor\" | \"patch\";\r\n}\r\n\r\n/** Types used to identify Workspace resources\r\n *  @beta\r\n */\r\nexport namespace WorkspaceResource {\r\n  /**\r\n   * The name for identifying WorkspaceResources in a [[WorkspaceDb]].\r\n   * * `WorkspaceResource.Name`s may not:\r\n   *  - be blank or start or end with a space\r\n   *  - be longer than 1024 characters\r\n   * @note a single WorkspaceDb may hold WorkspaceResources of type 'blob', 'string' and 'file', all with the same WorkspaceResource.Name.\r\n   */\r\n  export type Name = string;\r\n\r\n  /** Properties that specify an individual WorkspaceResource within a [[WorkspaceDb]]. */\r\n  export interface Props {\r\n    /** the name of the resource within the WorkspaceDb */\r\n    rscName: Name;\r\n  }\r\n}\r\n\r\n/**\r\n * A WorkspaceDb holds workspace resources. `WorkspaceDb`s may just be local files, or they may be stored\r\n * in cloud WorkspaceContainers. Each `WorkspaceResource` in a WorkspaceDb is identified by a [[WorkspaceResource.Name]].\r\n * Resources of type `string` and `blob` may be loaded directly from the `WorkspaceDb`. Resources of type `file` are\r\n * copied from the WorkspaceDb into a temporary local file so they can be accessed by programs directly from disk.\r\n * @beta\r\n */\r\nexport interface WorkspaceDb {\r\n  /** The WorkspaceContainer holding this WorkspaceDb. */\r\n  readonly container: WorkspaceContainer;\r\n  /** The base name of this WorkspaceDb, without version */\r\n  readonly dbName: WorkspaceDb.DbName;\r\n  /** event raised before this WorkspaceDb is closed. */\r\n  readonly onClose: BeEvent<() => void>;\r\n  /** 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 */\r\n  readonly dbFileName: string;\r\n  /** Get a string resource from this WorkspaceDb, if present. */\r\n  getString(rscName: WorkspaceResource.Name): string | undefined;\r\n  /** Get a blob resource from this WorkspaceDb, if present. */\r\n  getBlob(rscName: WorkspaceResource.Name): Uint8Array | undefined;\r\n  /** @internal */\r\n  getBlobReader(rscName: WorkspaceResource.Name): SQLiteDb.BlobIO;\r\n\r\n  /**\r\n   * Extract a local copy of a file resource from this WorkspaceDb, if present.\r\n   * @param rscName The name of the file resource in the WorkspaceDb\r\n   * @param targetFileName optional name for extracted file. Some applications require files in specific locations or filenames. If\r\n   * 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\r\n   * keep the extracted files in the  filesDir.\r\n   * @returns the full path to a file on the local filesystem.\r\n   * @note The file is copied from the file into the local filesystem so it may be accessed directly. This happens only\r\n   * as necessary, if the local file doesn't exist, or if it is out-of-date because it was updated in the file.\r\n   * For this reason, you should not save the local file name, and instead call this method every time you access it, so its\r\n   * content is always holds the correct version.\r\n   * @note The filename will be a hash value, not the resource name.\r\n   * @note Workspace resource files are set readonly as they are copied from the file.\r\n   * To edit them, you must first copy them to another location.\r\n   */\r\n  getFile(rscName: WorkspaceResource.Name, targetFileName?: LocalFileName): LocalFileName | undefined;\r\n\r\n  /**\r\n   * Ensure that the contents of a `WorkspaceDb` are downloaded into the local cache so that it may be accessed offline.\r\n   * Until the promise is resolved, the `WorkspaceDb` is not fully downloaded, but it *may* be safely accessed during the download.\r\n   * To determine the progress of the download, use the `localBlocks` and `totalBlocks` values returned by `CloudContainer.queryDatabase`.\r\n   */\r\n  prefetch(): void;\r\n}\r\n\r\n/** The properties of the CloudCache used for Workspaces.\r\n * @beta\r\n */\r\nexport interface WorkspaceCloudCacheProps extends Optional<CloudSqlite.CacheProps, \"name\" | \"rootDir\"> {\r\n  /** if true, empty the cache before using it. */\r\n  clearContents?: boolean;\r\n}\r\n\r\n/**\r\n * Options for constructing a [[Workspace]].\r\n * @beta\r\n */\r\nexport interface WorkspaceOpts {\r\n  /** The local directory for non-cloud-based WorkspaceDb files. The workspace api will look in this directory\r\n   * for files named `${containerId}/${dbId}.itwin-workspace`.\r\n   * @note if not supplied, defaults to `iTwin/Workspace` in the user-local folder.\r\n   */\r\n  containerDir?: LocalDirName;\r\n\r\n  /** Properties for the cloud cache for the `WorkspaceContainers` of the Workspace. */\r\n  cloudCacheProps?: WorkspaceCloudCacheProps;\r\n\r\n  /** the local fileName(s) of one or more settings files to load after the Workspace is first created. */\r\n  settingsFiles?: LocalFileName | [LocalFileName];\r\n}\r\n\r\n/**\r\n * Settings and resources that customize an application for the current session.\r\n * See [Workspaces]($docs/learning/backend/Workspace)\r\n * @beta\r\n */\r\nexport interface Workspace {\r\n  /** The directory for local WorkspaceDb files with the name `${containerId}/${dbId}.itwin-workspace`. */\r\n  readonly containerDir: LocalDirName;\r\n  /** The [[Settings]] for this Workspace */\r\n  readonly settings: Settings;\r\n  /** The CloudCache for cloud-based WorkspaceContainers */\r\n  readonly cloudCache?: SQLiteDb.CloudCache;\r\n\r\n  /** search for a previously opened container.\r\n   * @param containerId the id of the container\r\n   * @returns the [[WorkspaceContainer]] for `containerId` if it was not previously opened with [[getContainer]]\r\n   */\r\n  findContainer(containerId: WorkspaceContainer.Id): WorkspaceContainer | undefined;\r\n\r\n  /** get a [[WorkspaceContainer]] by [[WorkspaceContainer.Props]]\r\n   * @param props the properties of the `WorkspaceContainer`. If `props.containerId` was already opened, its WorkspaceContainer is returned.\r\n   * Otherwise it is created.\r\n   * @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.\r\n  */\r\n  getContainer(props: WorkspaceContainer.Props, account?: WorkspaceAccount.Props): WorkspaceContainer;\r\n\r\n  /** get the properties for the supplied account name by searching for an entry with that name in a `cloud/accounts` setting. */\r\n  resolveAccount(accountName: WorkspaceAccount.Name): WorkspaceAccount.Props;\r\n\r\n  /** get the properties for the supplied container name by searching for an entry with that name in a `cloud/containers` setting. */\r\n  resolveContainer(containerName: WorkspaceContainer.Name): WorkspaceContainer.Props & WorkspaceAccount.Alias;\r\n\r\n  /** get the properties for the supplied workspace database name by searching for an entry with that name in a `workspace/databases` setting. */\r\n  resolveDatabase(databaseAlias: WorkspaceDb.Name): WorkspaceDb.Props & WorkspaceContainer.Alias;\r\n\r\n  /**\r\n   * Get an opened [[WorkspaceDb]]. If the WorkspaceDb is present but not open, it is opened first.\r\n   * If `cloudProps` are supplied, a CloudContainer will be used to open the WorkspaceDb.\r\n   */\r\n  getWorkspaceDbFromProps(dbProps: WorkspaceDb.Props, containerProps: WorkspaceContainer.Props, account?: WorkspaceAccount.Props): WorkspaceDb;\r\n\r\n  /** Get an opened [[WorkspaceDb]] from a WorkspaceDb name.\r\n   * @param databaseName the database name, resolved via [[resolveDatabase]].\r\n   * @see [[getWorkspaceDbFromProps]]\r\n   */\r\n  getWorkspaceDb(databaseName: WorkspaceDb.Name,): WorkspaceDb;\r\n\r\n  /** Load a WorkspaceResource of type string, parse it, and add it to the current Settings for this Workspace.\r\n   * @note settingsRsc must specify a resource holding a stringified JSON representation of a [[SettingDictionary]]\r\n   */\r\n  loadSettingsDictionary(settingRsc: WorkspaceResource.Name, db: WorkspaceDb, priority: SettingsPriority): void;\r\n\r\n  /** Close this Workspace. All WorkspaceContainers are dropped. */\r\n  close(): void;\r\n}\r\n\r\n/**\r\n * A WorkspaceContainer holds WorkspaceDbs.\r\n * Access rights are administered per WorkspaceContainer. That is, if a user has rights to access a WorkspaceContainer, that right\r\n * applies to all WorkspaceDbs in the WorkspaceContainer.\r\n * @beta\r\n */\r\nexport interface WorkspaceContainer {\r\n  /** the local directory where this WorkspaceContainer will store temporary files extracted for file-resources. */\r\n  readonly filesDir: LocalDirName;\r\n  /** The unique identifier for a WorkspaceContainer a cloud storage account. */\r\n  readonly id: WorkspaceContainer.Id;\r\n  /** Workspace holding this WorkspaceContainer. */\r\n  readonly workspace: Workspace;\r\n  /** CloudContainer for this WorkspaceContainer (`undefined` if this is a local WorkspaceContainer.)\r\n   * @internal\r\n  */\r\n  readonly cloudContainer?: SQLiteDb.CloudContainer;\r\n\r\n  /** @internal */\r\n  addWorkspaceDb(toAdd: ITwinWorkspaceDb): void;\r\n  /** @internal */\r\n  resolveDbFileName(props: WorkspaceDb.Props): string;\r\n\r\n  /** find or open a WorkspaceDb from this WorkspaceContainer. */\r\n  getWorkspaceDb(props: WorkspaceDb.Props): WorkspaceDb;\r\n  /** Close and remove a currently opened [[WorkspaceDb]] from this Workspace. */\r\n  dropWorkspaceDb(container: WorkspaceDb): void;\r\n  /** Close this WorkspaceContainer. All currently opened WorkspaceDbs are dropped. */\r\n  close(): void;\r\n}\r\n\r\n/** @internal */\r\nexport class ITwinWorkspace implements Workspace {\r\n  private _containers = new Map<WorkspaceContainer.Id, ITwinWorkspaceContainer>();\r\n  public readonly containerDir: LocalDirName;\r\n  public readonly settings: Settings;\r\n\r\n  private _cloudCacheProps?: WorkspaceCloudCacheProps;\r\n  private _cloudCache?: SQLiteDb.CloudCache;\r\n  public get cloudCache(): SQLiteDb.CloudCache {\r\n    if (undefined === this._cloudCache) {\r\n      const cacheProps = {\r\n        ...this._cloudCacheProps,\r\n        rootDir: this._cloudCacheProps?.rootDir ?? join(this.containerDir, \"cloud\"),\r\n        cacheSize: this._cloudCacheProps?.cacheSize ?? \"20G\",\r\n        name: this._cloudCacheProps?.name ?? \"workspace\",\r\n      };\r\n      IModelJsFs.recursiveMkDirSync(cacheProps.rootDir);\r\n      if (cacheProps.clearContents)\r\n        fs.emptyDirSync(cacheProps.rootDir);\r\n      this._cloudCache = SQLiteDb.createCloudCache(cacheProps);\r\n    }\r\n    return this._cloudCache;\r\n  }\r\n\r\n  public constructor(settings: Settings, opts?: WorkspaceOpts) {\r\n    this.settings = settings;\r\n    this.containerDir = opts?.containerDir ?? join(IModelHost.cacheDir, \"Workspace\");\r\n    this._cloudCacheProps = opts?.cloudCacheProps;\r\n    let settingsFiles = opts?.settingsFiles;\r\n    if (settingsFiles) {\r\n      if (typeof settingsFiles === \"string\")\r\n        settingsFiles = [settingsFiles];\r\n      settingsFiles.forEach((file) => settings.addFile(file, SettingsPriority.application));\r\n    }\r\n  }\r\n\r\n  public addContainer(toAdd: ITwinWorkspaceContainer) {\r\n    if (undefined !== this._containers.get(toAdd.id))\r\n      throw new Error(\"container already exists in workspace\");\r\n    this._containers.set(toAdd.id, toAdd);\r\n  }\r\n\r\n  public findContainer(containerId: WorkspaceContainer.Id) {\r\n    return this._containers.get(containerId);\r\n  }\r\n\r\n  public getContainer(props: WorkspaceContainer.Props, account?: WorkspaceAccount.Props): WorkspaceContainer {\r\n    return this.findContainer(props.containerId) ?? new ITwinWorkspaceContainer(this, props, account);\r\n  }\r\n\r\n  public getWorkspaceDbFromProps(dbProps: WorkspaceDb.Props, containerProps: WorkspaceContainer.Props, account?: WorkspaceAccount.Props): WorkspaceDb {\r\n    return this.getContainer(containerProps, account).getWorkspaceDb(dbProps);\r\n  }\r\n\r\n  public getWorkspaceDb(dbAlias: string,) {\r\n    const dbProps = this.resolveDatabase(dbAlias);\r\n    const containerProps = this.resolveContainer(dbProps.containerName);\r\n    const account = containerProps.accountName !== \"\" ? this.resolveAccount(containerProps.accountName) : undefined;\r\n    let container: WorkspaceContainer | undefined = this.findContainer(containerProps.containerId);\r\n    if (undefined === container) {\r\n      container = this.getContainer(containerProps, account);\r\n    }\r\n    return container?.getWorkspaceDb(dbProps);\r\n  }\r\n\r\n  public loadSettingsDictionary(settingRsc: WorkspaceResource.Name, db: WorkspaceDb, priority: SettingsPriority) {\r\n    const setting = db.getString(settingRsc);\r\n    if (undefined === setting)\r\n      throw new Error(`could not load setting resource ${settingRsc}`);\r\n\r\n    this.settings.addJson(`${db.container.id}/${db.dbName}/${settingRsc}`, priority, setting);\r\n  }\r\n\r\n  public close() {\r\n    this.settings.close();\r\n    for (const [_id, container] of this._containers)\r\n      container.close();\r\n    this._containers.clear();\r\n    if (this._cloudCache) {\r\n      this._cloudCache.destroy();\r\n      this._cloudCache = undefined;\r\n    }\r\n  }\r\n\r\n  public resolveAccount(accountName: string): WorkspaceAccount.Props {\r\n    const resolved = this.settings.resolveSetting<WorkspaceAccount.Props>(WorkspaceSetting.Accounts, (val) => {\r\n      if (Array.isArray(val)) {\r\n        for (const entry of val) {\r\n          if (typeof entry === \"object\" && entry.name === accountName)\r\n            return SettingsSchemas.validateArrayObject(entry, WorkspaceSetting.Accounts, accountName);\r\n        }\r\n      }\r\n      return undefined; // keep going through all settings dictionaries\r\n    });\r\n    if (resolved === undefined)\r\n      throw new Error(`no setting \"${WorkspaceSetting.Accounts}\" entry for \"${accountName}\"`);\r\n\r\n    return resolved;\r\n  }\r\n\r\n  public resolveContainer(containerName: string): WorkspaceContainer.Props & WorkspaceAccount.Alias {\r\n    const resolved = this.settings.resolveSetting<WorkspaceContainer.Props & WorkspaceAccount.Alias>(WorkspaceSetting.Containers, (val) => {\r\n      if (Array.isArray(val)) {\r\n        for (const entry of val) {\r\n          if (typeof entry === \"object\" && entry.name === containerName)\r\n            return SettingsSchemas.validateArrayObject(entry, WorkspaceSetting.Containers, containerName);\r\n        }\r\n      }\r\n      return undefined; // keep going through all settings dictionaries\r\n    });\r\n    if (resolved === undefined)\r\n      throw new Error(`no setting \"${WorkspaceSetting.Containers}\" entry for \"${containerName}\"`);\r\n\r\n    return resolved;\r\n  }\r\n\r\n  public resolveDatabase(databaseName: string): WorkspaceDb.Props & WorkspaceContainer.Alias {\r\n    const resolved = this.settings.resolveSetting<WorkspaceDb.Props & WorkspaceContainer.Alias>(WorkspaceSetting.Databases, (val) => {\r\n      if (Array.isArray(val)) {\r\n        for (const entry of val) {\r\n          if (typeof entry === \"object\" && entry.name === databaseName)\r\n            return SettingsSchemas.validateArrayObject(entry, WorkspaceSetting.Databases, databaseName);\r\n        }\r\n      }\r\n      return undefined; // keep going through all settings dictionaries\r\n    });\r\n\r\n    if (resolved === undefined)\r\n      throw new Error(`no setting \"${WorkspaceSetting.Databases}\" entry for \"${databaseName}\"`);\r\n\r\n    return resolved;\r\n  }\r\n}\r\n\r\n/** @internal */\r\nexport class ITwinWorkspaceContainer implements WorkspaceContainer {\r\n  public readonly workspace: ITwinWorkspace;\r\n  public readonly filesDir: LocalDirName;\r\n  public readonly id: WorkspaceContainer.Id;\r\n\r\n  public readonly cloudContainer?: SQLiteDb.CloudContainer | undefined;\r\n  private _wsDbs = new Map<WorkspaceDb.DbName, ITwinWorkspaceDb>();\r\n  public get dirName() { return join(this.workspace.containerDir, this.id); }\r\n\r\n  public static noLeadingOrTrailingSpaces(name: string, msg: string) {\r\n    if (name.trim() !== name)\r\n      throw new Error(`${msg} [${name}] may not have leading or tailing spaces`);\r\n  }\r\n\r\n  /** rules for ContainerIds (from Azure, see https://docs.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata)\r\n   *  - may only contain lower case letters, numbers or dashes\r\n   *  - may not start or end with with a dash nor have more than one dash in a row\r\n   *  - may not be shorter than 3 or longer than 63 characters\r\n   */\r\n  private static validateContainerId(id: WorkspaceContainer.Id) {\r\n    if (!/^(?=.{3,63}$)[a-z0-9]+(-[a-z0-9]+)*$/g.test(id))\r\n      throw new Error(`invalid containerId: [${id}]`);\r\n  }\r\n\r\n  public static validateDbName(dbName: WorkspaceDb.DbName) {\r\n    if (dbName === \"\" || dbName.length > 255 || /[#\\.<>:\"/\\\\\"`'|?*\\u0000-\\u001F]/g.test(dbName) || /^(con|prn|aux|nul|com\\d|lpt\\d)$/i.test(dbName))\r\n      throw new Error(`invalid dbName: [${dbName}]`);\r\n    this.noLeadingOrTrailingSpaces(dbName, \"dbName\");\r\n  }\r\n\r\n  public constructor(workspace: ITwinWorkspace, props: WorkspaceContainer.Props, account?: WorkspaceAccount.Props) {\r\n    ITwinWorkspaceContainer.validateContainerId(props.containerId);\r\n    this.workspace = workspace;\r\n    this.id = props.containerId;\r\n\r\n    if (account?.accessName && account.storageType)\r\n      this.cloudContainer = SQLiteDb.createCloudContainer({ accessToken: \"\", ...props, ...account });\r\n\r\n    workspace.addContainer(this);\r\n    this.filesDir = join(this.dirName, \"Files\");\r\n\r\n    const cloudContainer = this.cloudContainer;\r\n    if (undefined === cloudContainer)\r\n      return;\r\n\r\n    cloudContainer.connect(this.workspace.cloudCache);\r\n    if (props.syncOnConnect) {\r\n      try {\r\n        cloudContainer.checkForChanges();\r\n      } catch (e: unknown) {\r\n        // must be offline\r\n      }\r\n    }\r\n  }\r\n\r\n  public static validateVersion(version?: WorkspaceDb.Version) {\r\n    version = version ?? \"1.0.0\";\r\n    if (version) {\r\n      const opts = { loose: true, includePrerelease: true };\r\n      // clean allows prerelease, so try it first. If that fails attempt to coerce it (coerce strips prerelease even if you say not to.)\r\n      const semVersion = semver.clean(version, opts) ?? semver.coerce(version, opts)?.version;\r\n      if (!semVersion)\r\n        throw new Error(\"invalid version specification\");\r\n      version = semVersion;\r\n    }\r\n    return version;\r\n  }\r\n\r\n  public static parseDbFileName(dbFileName: WorkspaceDb.DbFullName): { dbName: WorkspaceDb.DbName, version: WorkspaceDb.Version } {\r\n    const parts = dbFileName.split(\":\");\r\n    return { dbName: parts[0], version: parts[1] };\r\n  }\r\n\r\n  public static makeDbFileName(dbName: WorkspaceDb.DbName, version?: WorkspaceDb.Version): WorkspaceDb.DbName {\r\n    return `${dbName}:${this.validateVersion(version)}`;\r\n  }\r\n\r\n  public static resolveCloudFileName(cloudContainer: SQLiteDb.CloudContainer, props: WorkspaceDb.Props): WorkspaceDb.DbFullName {\r\n    const dbName = props.dbName;\r\n    const dbs = cloudContainer.queryDatabases(`${dbName}*`); // get all databases that start with dbName\r\n\r\n    const versions = [];\r\n    for (const db of dbs) {\r\n      const thisDb = ITwinWorkspaceContainer.parseDbFileName(db);\r\n      if (thisDb.dbName === dbName && \"string\" === typeof thisDb.version && thisDb.version.length > 0)\r\n        versions.push(thisDb.version);\r\n    }\r\n\r\n    if (versions.length === 0)\r\n      versions[0] = \"1.0.0\";\r\n\r\n    const range = props.version ?? \"*\";\r\n    try {\r\n      const version = semver.maxSatisfying(versions, range, { loose: true, includePrerelease: props.includePrerelease });\r\n      if (version)\r\n        return `${dbName}:${version}`;\r\n    } catch (e: unknown) {\r\n    }\r\n    throw new Error(`No version of [${dbName}] available for \"${range}\"`);\r\n  }\r\n\r\n  /**\r\n   * Create a copy of an existing [[WorkspaceDb]] in a cloud container with a new version number.\r\n   * @param cloudContainer The attached cloud container holding the existing WorkspaceDb\r\n   * @param fromProps Properties that describe the source WorkspaceDb for the new version\r\n   * @param versionType The type of version increment to apply to the existing version.\r\n   * @note This requires that the cloudContainer is attached and the write lock on the container be held. The copy should be modified with\r\n   * new content before the write lock is released, and thereafter should never be modified again.\r\n   */\r\n  public static async makeNewVersion(cloudContainer: SQLiteDb.CloudContainer, fromProps: WorkspaceDb.Props, versionType: WorkspaceDb.VersionIncrement) {\r\n    const oldName = this.resolveCloudFileName(cloudContainer, fromProps);\r\n    const oldDb = this.parseDbFileName(oldName);\r\n    const newVersion = semver.inc(oldDb.version, versionType);\r\n    if (!newVersion)\r\n      throw new Error(\"invalid version\");\r\n\r\n    const newName = this.makeDbFileName(oldDb.dbName, newVersion);\r\n    await cloudContainer.copyDatabase(oldName, newName);\r\n    return { oldName, newName };\r\n  }\r\n\r\n  /**\r\n   * Convert a WorkspaceDb.Props specification into a DbFileName. For cloud-based containers, this resolves to the dbName, incorporating the appropriate\r\n   * version. For file-based containers, this returns a local filename of a WorkspaceDb file with the extension \".itwin-workspace\"\r\n   */\r\n  public resolveDbFileName(props: WorkspaceDb.Props): WorkspaceDb.DbFullName {\r\n    const cloudContainer = this.cloudContainer;\r\n    if (undefined === cloudContainer)\r\n      return join(this.dirName, `${props.dbName}.${ITwinWorkspaceDb.fileExt}`); // local file, versions not allowed\r\n\r\n    return ITwinWorkspaceContainer.resolveCloudFileName(cloudContainer, props);\r\n  }\r\n\r\n  public addWorkspaceDb(toAdd: ITwinWorkspaceDb) {\r\n    if (undefined !== this._wsDbs.get(toAdd.dbName))\r\n      throw new Error(`workspaceDb ${toAdd.dbName} already exists in workspace`);\r\n    this._wsDbs.set(toAdd.dbName, toAdd);\r\n  }\r\n\r\n  public getWorkspaceDb(props: WorkspaceDb.Props): WorkspaceDb {\r\n    const db = this._wsDbs.get(props.dbName) ?? new ITwinWorkspaceDb(props, this);\r\n    if (!db.isOpen)\r\n      db.open();\r\n    return db;\r\n  }\r\n\r\n  public dropWorkspaceDb(toDrop: WorkspaceDb) {\r\n    const name = toDrop.dbName;\r\n    const wsDb = this._wsDbs.get(name);\r\n    if (wsDb === toDrop) {\r\n      this._wsDbs.delete(name);\r\n      wsDb.close();\r\n    }\r\n  }\r\n\r\n  public close() {\r\n    for (const [_name, db] of this._wsDbs)\r\n      db.close();\r\n    this._wsDbs.clear();\r\n    this.cloudContainer?.disconnect();\r\n  }\r\n\r\n  /** Delete all local files extracted by [[WorkspaceDb.getFile]] for this container. */\r\n  public purgeContainerFiles() {\r\n    IModelJsFs.purgeDirSync(this.filesDir);\r\n  }\r\n}\r\n\r\n/**\r\n * Implementation of WorkspaceDb\r\n * @internal\r\n */\r\nexport class ITwinWorkspaceDb implements WorkspaceDb {\r\n  /** file extension for local WorkspaceDbs */\r\n  public static readonly fileExt = \"itwin-workspace\";\r\n  /** the SQLiteDb for this WorkspaceDb*/\r\n  public readonly sqliteDb = new SQLiteDb();\r\n  /** the base WorkspaceDb name, without directory, extension, or version information. */\r\n  public readonly dbName: WorkspaceDb.DbName;\r\n  /** The WorkspaceContainer holding this WorkspaceDb */\r\n  public readonly container: WorkspaceContainer;\r\n  /** called before db is closed */\r\n  public readonly onClose = new BeEvent<() => void>();\r\n  /** either a local file name or the name of the file in a cloud container, including version identifier */\r\n  public dbFileName: string;\r\n\r\n  /** true if this WorkspaceDb is currently open */\r\n  public get isOpen() { return this.sqliteDb.isOpen; }\r\n  public queryFileResource(rscName: WorkspaceResource.Name) {\r\n    const info = this.sqliteDb.nativeDb.queryEmbeddedFile(rscName);\r\n    if (undefined === info)\r\n      return undefined;\r\n\r\n    // since resource names can contain illegal characters, path separators, etc., we make the local file name from its hash, in hex.\r\n    let localFileName = join(this.container.filesDir, createHash(\"sha1\").update(this.dbFileName).update(rscName).digest(\"hex\"));\r\n    if (info.fileExt !== \"\") // since some applications may expect to see the extension, append it here if it was supplied.\r\n      localFileName = `${localFileName}.${info.fileExt}`;\r\n    return { localFileName, info };\r\n  }\r\n\r\n  public constructor(props: WorkspaceDb.Props, container: WorkspaceContainer) {\r\n    ITwinWorkspaceContainer.validateDbName(props.dbName);\r\n    this.dbName = props.dbName;\r\n    this.container = container;\r\n    this.dbFileName = container.resolveDbFileName(props);\r\n    container.addWorkspaceDb(this);\r\n  }\r\n\r\n  public open() {\r\n    this.sqliteDb.openDb(this.dbFileName, OpenMode.Readonly, this.container.cloudContainer);\r\n  }\r\n\r\n  public close() {\r\n    if (this.isOpen) {\r\n      this.onClose.raiseEvent();\r\n      this.sqliteDb.closeDb();\r\n      this.container.dropWorkspaceDb(this);\r\n    }\r\n  }\r\n\r\n  public getString(rscName: WorkspaceResource.Name): string | undefined {\r\n    return this.sqliteDb.withSqliteStatement(\"SELECT value from strings WHERE id=?\", (stmt) => {\r\n      stmt.bindString(1, rscName);\r\n      return DbResult.BE_SQLITE_ROW === stmt.step() ? stmt.getValueString(0) : undefined;\r\n    });\r\n  }\r\n\r\n  /** Get a BlobIO reader for a blob WorkspaceResource.\r\n   * @note when finished, caller *must* call `close` on the BlobIO.\r\n   */\r\n  public getBlobReader(rscName: WorkspaceResource.Name): SQLiteDb.BlobIO {\r\n    return this.sqliteDb.withSqliteStatement(\"SELECT rowid from blobs WHERE id=?\", (stmt) => {\r\n      stmt.bindString(1, rscName);\r\n      const blobReader = SQLiteDb.createBlobIO();\r\n      blobReader.open(this.sqliteDb.nativeDb, { tableName: \"blobs\", columnName: \"value\", row: stmt.getValueInteger(0) });\r\n      return blobReader;\r\n    });\r\n  }\r\n\r\n  public getBlob(rscName: WorkspaceResource.Name): Uint8Array | undefined {\r\n    return this.sqliteDb.withSqliteStatement(\"SELECT value from blobs WHERE id=?\", (stmt) => {\r\n      stmt.bindString(1, rscName);\r\n      return DbResult.BE_SQLITE_ROW === stmt.step() ? stmt.getValueBlob(0) : undefined;\r\n    });\r\n  }\r\n\r\n  public getFile(rscName: WorkspaceResource.Name, targetFileName?: LocalFileName): LocalFileName | undefined {\r\n    const file = this.queryFileResource(rscName);\r\n    if (!file)\r\n      return undefined;\r\n\r\n    const info = file.info;\r\n    const localFileName = targetFileName ?? file.localFileName;\r\n\r\n    // check whether the file is already up to date.\r\n    const stat = fs.existsSync(localFileName) && fs.statSync(localFileName);\r\n    if (stat && Math.round(stat.mtimeMs) === info.date && stat.size === info.size)\r\n      return localFileName; // yes, we're done\r\n\r\n    // extractEmbeddedFile fails if the file exists or if the directory does not exist\r\n    if (stat)\r\n      fs.removeSync(localFileName);\r\n    else\r\n      IModelJsFs.recursiveMkDirSync(dirname(localFileName));\r\n\r\n    this.sqliteDb.nativeDb.extractEmbeddedFile({ name: rscName, localFileName });\r\n    const date = new Date(info.date);\r\n    fs.utimesSync(localFileName, date, date); // set the last-modified date of the file to match date in container\r\n    fs.chmodSync(localFileName, \"0444\"); // set file readonly\r\n    return localFileName;\r\n  }\r\n\r\n  public prefetch(opts?: CloudSqlite.PrefetchProps): SQLiteDb.CloudPrefetch | undefined {\r\n    const cloudContainer = this.container.cloudContainer;\r\n    return (cloudContainer !== undefined) ? SQLiteDb.startCloudPrefetch(cloudContainer, this.dbFileName, opts) : undefined;\r\n  }\r\n}\r\n\r\n/**\r\n * An editable [[WorkspaceDb]]. This is used by administrators for creating and modifying `WorkspaceDb`s.\r\n * For cloud-backed containers, the write token must be obtained before this class may be used. Only one user at at time\r\n * may be editing.\r\n * @internal\r\n */\r\nexport class EditableWorkspaceDb extends ITwinWorkspaceDb {\r\n  private static validateResourceName(name: WorkspaceResource.Name) {\r\n    ITwinWorkspaceContainer.noLeadingOrTrailingSpaces(name, \"resource name\");\r\n    if (name.length > 1024)\r\n      throw new Error(\"resource name too long\");\r\n  }\r\n\r\n  private validateResourceSize(val: Uint8Array | string) {\r\n    const len = typeof val === \"string\" ? val.length : val.byteLength;\r\n    if (len > (1024 * 1024 * 1024)) // one gigabyte\r\n      throw new Error(\"value is too large\");\r\n  }\r\n\r\n  public override open() {\r\n    this.sqliteDb.openDb(this.dbFileName, OpenMode.ReadWrite, this.container.cloudContainer);\r\n  }\r\n\r\n  private getFileModifiedTime(localFileName: LocalFileName): number {\r\n    return Math.round(fs.statSync(localFileName).mtimeMs);\r\n  }\r\n\r\n  private performWriteSql(rscName: WorkspaceResource.Name, sql: string, bind?: (stmt: SqliteStatement) => void) {\r\n    this.sqliteDb.withSqliteStatement(sql, (stmt) => {\r\n      stmt.bindString(1, rscName);\r\n      bind?.(stmt);\r\n      const rc = stmt.step();\r\n      if (DbResult.BE_SQLITE_DONE !== rc) {\r\n        if (DbResult.BE_SQLITE_CONSTRAINT_PRIMARYKEY === rc)\r\n          throw new IModelError(rc, `resource \"${rscName}\" already exists`);\r\n\r\n        throw new IModelError(rc, `workspace [${sql}]`);\r\n      }\r\n    });\r\n    this.sqliteDb.saveChanges();\r\n  }\r\n\r\n  public async createDb(version?: string) {\r\n    if (!this.container.cloudContainer) {\r\n      EditableWorkspaceDb.createEmpty(this.dbFileName);\r\n    } else {\r\n      // currently the only way to create a workspaceDb in a cloud container is to create a temporary workspaceDb and upload it.\r\n      const tempDbFile = join(KnownLocations.tmpdir, `empty.${ITwinWorkspaceDb.fileExt}`);\r\n      if (fs.existsSync(tempDbFile))\r\n        fs.rmSync(tempDbFile);\r\n      EditableWorkspaceDb.createEmpty(tempDbFile);\r\n      this.dbFileName = ITwinWorkspaceContainer.makeDbFileName(this.dbName, version);\r\n      await CloudSqlite.uploadDb(this.container.cloudContainer, { localFileName: tempDbFile, dbName: this.dbFileName });\r\n      fs.rmSync(tempDbFile);\r\n    }\r\n    this.open();\r\n  }\r\n\r\n  /** Create a new, empty, EditableWorkspaceDb for importing Workspace resources. */\r\n  public static createEmpty(fileName: LocalFileName) {\r\n    const db = new SQLiteDb();\r\n    IModelJsFs.recursiveMkDirSync(dirname(fileName));\r\n    db.createDb(fileName);\r\n    db.executeSQL(\"CREATE TABLE strings(id TEXT PRIMARY KEY NOT NULL,value TEXT)\");\r\n    db.executeSQL(\"CREATE TABLE blobs(id TEXT PRIMARY KEY NOT NULL,value BLOB)\");\r\n    db.closeDb(true);\r\n  }\r\n\r\n  /** Add a new string resource to this WorkspaceDb.\r\n   * @param rscName The name of the string resource.\r\n   * @param val The string to save.\r\n   */\r\n  public addString(rscName: WorkspaceResource.Name, val: string): void {\r\n    EditableWorkspaceDb.validateResourceName(rscName);\r\n    this.validateResourceSize(val);\r\n    this.performWriteSql(rscName, \"INSERT INTO strings(id,value) VALUES(?,?)\", (stmt) => stmt.bindString(2, val));\r\n  }\r\n\r\n  /** Update an existing string resource with a new value.\r\n   * @param rscName The name of the string resource.\r\n   * @param val The new value.\r\n   * @throws if rscName does not exist\r\n   */\r\n  public updateString(rscName: WorkspaceResource.Name, val: string): void {\r\n    this.validateResourceSize(val);\r\n    this.performWriteSql(rscName, \"UPDATE strings SET value=?2 WHERE id=?1\", (stmt) => stmt.bindString(2, val));\r\n  }\r\n\r\n  /** Remove a string resource. */\r\n  public removeString(rscName: WorkspaceResource.Name): void {\r\n    this.performWriteSql(rscName, \"DELETE FROM strings WHERE id=?\");\r\n  }\r\n\r\n  /** Add a new blob resource to this WorkspaceDb.\r\n   * @param rscName The name of the blob resource.\r\n   * @param val The blob to save.\r\n   */\r\n  public addBlob(rscName: WorkspaceResource.Name, val: Uint8Array): void {\r\n    EditableWorkspaceDb.validateResourceName(rscName);\r\n    this.validateResourceSize(val);\r\n    this.performWriteSql(rscName, \"INSERT INTO blobs(id,value) VALUES(?,?)\", (stmt) => stmt.bindBlob(2, val));\r\n  }\r\n\r\n  /** Update an existing blob resource with a new value.\r\n   * @param rscName The name of the blob resource.\r\n   * @param val The new value.\r\n   * @throws if rscName does not exist\r\n   */\r\n  public updateBlob(rscName: WorkspaceResource.Name, val: Uint8Array): void {\r\n    this.validateResourceSize(val);\r\n    this.performWriteSql(rscName, \"UPDATE blobs SET value=?2 WHERE id=?1\", (stmt) => stmt.bindBlob(2, val));\r\n  }\r\n\r\n  /** Get a BlobIO writer for a previously-added blob WorkspaceResource.\r\n   * @note after writing is complete, caller must call `close` on the BlobIO and must call `saveChanges` on the `db`.\r\n   */\r\n  public getBlobWriter(rscName: WorkspaceResource.Name): SQLiteDb.BlobIO {\r\n    return this.sqliteDb.withSqliteStatement(\"SELECT rowid from blobs WHERE id=?\", (stmt) => {\r\n      stmt.bindString(1, rscName);\r\n      const blobWriter = SQLiteDb.createBlobIO();\r\n      blobWriter.open(this.sqliteDb.nativeDb, { tableName: \"blobs\", columnName: \"value\", row: stmt.getValueInteger(0), writeable: true });\r\n      return blobWriter;\r\n    });\r\n  }\r\n\r\n  /** Remove a blob resource. */\r\n  public removeBlob(rscName: WorkspaceResource.Name): void {\r\n    this.performWriteSql(rscName, \"DELETE FROM blobs WHERE id=?\");\r\n  }\r\n\r\n  /** Copy the contents of an existing local file into this WorkspaceDb as a file resource.\r\n   * @param rscName The name of the file resource.\r\n   * @param localFileName The name of a local file to be read.\r\n   * @param fileExt The extension (do not include the leading \".\") to be appended to the generated fileName\r\n   * when this WorkspaceDb is extracted from the WorkspaceDb. By default the characters after the last \".\" in `localFileName`\r\n   * are used. Pass this argument to override that.\r\n   */\r\n  public addFile(rscName: WorkspaceResource.Name, localFileName: LocalFileName, fileExt?: string): void {\r\n    EditableWorkspaceDb.validateResourceName(rscName);\r\n    fileExt = fileExt ?? extname(localFileName);\r\n    if (fileExt?.[0] === \".\")\r\n      fileExt = fileExt.slice(1);\r\n    this.sqliteDb.nativeDb.embedFile({ name: rscName, localFileName, date: this.getFileModifiedTime(localFileName), fileExt });\r\n  }\r\n\r\n  /** Replace an existing file resource with the contents of another local file.\r\n   * @param rscName The name of the file resource.\r\n   * @param localFileName The name of a local file to be read.\r\n   * @throws if rscName does not exist\r\n   */\r\n  public updateFile(rscName: WorkspaceResource.Name, localFileName: LocalFileName): void {\r\n    this.queryFileResource(rscName); // throws if not present\r\n    this.sqliteDb.nativeDb.replaceEmbeddedFile({ name: rscName, localFileName, date: this.getFileModifiedTime(localFileName) });\r\n  }\r\n\r\n  /** Remove a file resource. */\r\n  public removeFile(rscName: WorkspaceResource.Name): void {\r\n    const file = this.queryFileResource(rscName);\r\n    if (undefined === file)\r\n      throw new Error(`file resource \"${rscName}\" does not exist`);\r\n    if (file && fs.existsSync(file.localFileName))\r\n      fs.unlinkSync(file.localFileName);\r\n    this.sqliteDb.nativeDb.removeEmbeddedFile(rscName);\r\n  }\r\n}\r\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itwin/core-backend",
-  "version": "3.3.0-dev.9",
+  "version": "3.4.0-dev.10",
   "description": "iTwin.js backend components",
   "main": "lib/cjs/core-backend.js",
   "typings": "lib/cjs/core-backend",
@@ -24,14 +24,18 @@
     "url": "http://www.bentley.com"
   },
   "peerDependencies": {
-    "@itwin/core-bentley": "^3.3.0-dev.9",
-    "@itwin/core-common": "^3.3.0-dev.9",
-    "@itwin/core-geometry": "^3.3.0-dev.9",
-    "@itwin/ecschema-metadata": "^3.3.0-dev.9"
+    "@itwin/core-bentley": "^3.4.0-dev.10",
+    "@itwin/core-common": "^3.4.0-dev.10",
+    "@itwin/core-geometry": "^3.4.0-dev.10",
+    "@itwin/ecschema-metadata": "^3.4.0-dev.10",
+    "@opentelemetry/api": "^1.0.4"
   },
   "peerDependenciesMeta": {
     "@itwin/ecschema-metadata": {
       "optional": true
+    },
+    "@opentelemetry/api": {
+      "optional": true
     }
   },
   "//devDependencies": [
@@ -39,20 +43,21 @@
     "NOTE: All tools used by scripts in this package must be listed as devDependencies"
   ],
   "devDependencies": {
-    "@itwin/build-tools": "3.3.0-dev.9",
-    "@itwin/core-bentley": "3.3.0-dev.9",
-    "@itwin/core-common": "3.3.0-dev.9",
-    "@itwin/core-geometry": "3.3.0-dev.9",
-    "@itwin/core-webpack-tools": "3.3.0-dev.9",
-    "@itwin/ecschema-metadata": "3.3.0-dev.9",
-    "@itwin/eslint-plugin": "3.3.0-dev.9",
-    "@types/chai": "^4.1.4",
+    "@itwin/build-tools": "3.4.0-dev.10",
+    "@itwin/core-bentley": "3.4.0-dev.10",
+    "@itwin/core-common": "3.4.0-dev.10",
+    "@itwin/core-geometry": "3.4.0-dev.10",
+    "@itwin/core-webpack-tools": "3.4.0-dev.10",
+    "@itwin/ecschema-metadata": "3.4.0-dev.10",
+    "@itwin/eslint-plugin": "3.4.0-dev.10",
+    "@opentelemetry/api": "^1.0.4",
+    "@types/chai": "4.3.1",
     "@types/chai-as-promised": "^7",
     "@types/fs-extra": "^4.0.7",
     "@types/mocha": "^8.2.2",
     "@types/multiparty": "^0.0.31",
     "@types/node": "16.11.7",
-    "@types/semver": "^5.5.0",
+    "@types/semver": "7.3.10",
     "@types/sinon": "^9.0.0",
     "@types/ws": "^7.0.0",
     "chai": "^4.1.2",
@@ -63,25 +68,25 @@
     "eslint": "^7.11.0",
     "fs-extra": "^8.1.0",
     "internal-tools": "3.0.0-dev.69",
-    "mocha": "^8.3.2",
-    "null-loader": "^0.1.1",
+    "mocha": "^10.0.0",
+    "null-loader": "^4.0.1",
     "nyc": "^15.1.0",
     "rimraf": "^3.0.2",
     "sinon": "^9.0.2",
-    "source-map-loader": "^1.0.0",
+    "source-map-loader": "^4.0.0",
     "typescript": "~4.4.0",
-    "webpack": "4.42.0"
+    "webpack": "^5.64.4"
   },
   "dependencies": {
     "@azure/storage-blob": "^12.7.0",
-    "@bentley/imodeljs-native": "3.2.8",
-    "@itwin/core-telemetry": "3.3.0-dev.9",
+    "@bentley/imodeljs-native": "3.4.3",
+    "@itwin/core-telemetry": "3.4.0-dev.10",
     "form-data": "^2.3.2",
     "fs-extra": "^8.1.0",
     "json5": "^2.2.0",
     "js-base64": "^3.6.1",
     "multiparty": "^4.2.1",
-    "semver": "^5.5.0",
+    "semver": "^7.3.5",
     "ws": "^7.5.3"
   },
   "nyc": {

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

@@ -1 +0,0 @@
-{"version":3,"file":"ViewStateHydrater.d.ts","sourceRoot":"","sources":["../../src/ViewStateHydrater.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,4BAA4B,EAAE,6BAA6B,EAA6F,MAAM,oBAAoB,CAAC;AAE5L,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAAW;gBACP,MAAM,EAAE,QAAQ;IAItB,uBAAuB,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,6BAA6B,CAAC;YAmBrG,iBAAiB;YAUjB,8BAA8B;YAe9B,mBAAmB;YAInB,iBAAiB;YAsBjB,WAAW;YAOX,4BAA4B;CA8B3C"}

package/lib/cjs/ViewStateHydrater.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ViewStateHydrater.js","sourceRoot":"","sources":["../../src/ViewStateHydrater.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\nimport { BentleyError, CompressedId64Set, Id64String, Logger } from \"@itwin/core-bentley\";\r\nimport { HydrateViewStateRequestProps, HydrateViewStateResponseProps, ModelProps, QueryRowFormat, SubCategoryResultRow, ViewAttachmentProps, ViewStateLoadProps } from \"@itwin/core-common\";\r\nimport { BackendLoggerCategory } from \"./BackendLoggerCategory\";\r\nimport { IModelDb } from \"./IModelDb\";\r\n\r\nexport class ViewStateHydrater {\r\n  private _imodel: IModelDb;\r\n  public constructor(iModel: IModelDb) {\r\n    this._imodel = iModel;\r\n  }\r\n\r\n  public async getHydrateResponseProps(options: HydrateViewStateRequestProps): Promise<HydrateViewStateResponseProps> {\r\n    const response: HydrateViewStateResponseProps = {};\r\n    const promises = [];\r\n    if (options.acsId)\r\n      promises.push(this.handleAcsId(response, options.acsId));\r\n    if (options.sheetViewAttachmentIds)\r\n      promises.push(this.handleSheetViewAttachmentIds(response, options.sheetViewAttachmentIds, options.viewStateLoadProps));\r\n    if (options.notLoadedCategoryIds)\r\n      promises.push(this.handleCategoryIds(response, options.notLoadedCategoryIds));\r\n    if (options.spatialViewId)\r\n      promises.push(this.handleSpatialViewId(response, options.spatialViewId, options.viewStateLoadProps));\r\n    if (options.notLoadedModelSelectorStateModels)\r\n      promises.push(this.handleModelSelectorStateModels(response, options.notLoadedModelSelectorStateModels));\r\n    if (options.baseModelId)\r\n      promises.push(this.handleBaseModelId(response, options.baseModelId));\r\n    await Promise.all(promises);\r\n    return response;\r\n  }\r\n\r\n  private async handleBaseModelId(response: HydrateViewStateResponseProps, baseModelId: Id64String) {\r\n    let modelProps;\r\n    try {\r\n      modelProps = this._imodel.models.getModelJson({ id: baseModelId });\r\n    } catch (err) {\r\n      Logger.logError(BackendLoggerCategory.ViewStateHydrater, `Error getting modelProps for baseModelId: ${baseModelId}`, () => ({error: BentleyError.getErrorProps(err)}));\r\n    }\r\n    response.baseModelProps = modelProps;\r\n  }\r\n\r\n  private async handleModelSelectorStateModels(response: HydrateViewStateResponseProps, models: CompressedId64Set) {\r\n    const decompressedModelIds = CompressedId64Set.decompressSet(models);\r\n\r\n    const modelJsonArray: ModelProps[] = [];\r\n    for (const id of decompressedModelIds) {\r\n      try {\r\n        const modelProps = this._imodel.models.getModelJson({ id });\r\n        modelJsonArray.push(modelProps);\r\n      } catch (error) {\r\n      }\r\n    }\r\n\r\n    response.modelSelectorStateModels = modelJsonArray;\r\n  }\r\n\r\n  private async handleSpatialViewId(response: HydrateViewStateResponseProps, spatialViewId: Id64String, viewStateLoadProps?: ViewStateLoadProps) {\r\n    response.spatialViewProps = this._imodel.views.getViewStateData(spatialViewId, viewStateLoadProps);\r\n  }\r\n\r\n  private async handleCategoryIds(response: HydrateViewStateResponseProps, categoryIds: CompressedId64Set) {\r\n    // consider splitting up categoryIds, as queries get slow with many many categoryids in them.\r\n    const maxCategoriesPerQuery = 200;\r\n    const decompressedIds = CompressedId64Set.decompressArray(categoryIds);\r\n    const result = [];\r\n    while (decompressedIds.length !== 0) {\r\n      const end = (decompressedIds.length > maxCategoriesPerQuery) ? maxCategoriesPerQuery : decompressedIds.length;\r\n      const where = decompressedIds.splice(0, end).join(\",\");\r\n      const query = `SELECT ECInstanceId as id, Parent.Id as parentId, Properties as appearance FROM BisCore.SubCategory WHERE Parent.Id IN (${where})`;\r\n      try {\r\n        for await (const row of this._imodel.query(query, undefined, { rowFormat: QueryRowFormat.UseJsPropertyNames })) {\r\n          result.push(row as SubCategoryResultRow);\r\n        }\r\n      } catch {\r\n        // ###TODO: detect cases in which retry is warranted\r\n        // Note that currently, if we succeed in obtaining some pages of results and fail to retrieve another page, we will end up processing the\r\n        // incomplete results. Since we're not retrying, that's the best we can do.\r\n      }\r\n    }\r\n    response.categoryIdsResult = result;\r\n  }\r\n\r\n  private async handleAcsId(response: HydrateViewStateResponseProps, acsId: string) {\r\n    try {\r\n      const props = this._imodel.elements.getElementProps(acsId);\r\n      response.acsElementProps = props;\r\n    } catch { }\r\n  }\r\n\r\n  private async handleSheetViewAttachmentIds(response: HydrateViewStateResponseProps, sheetViewAttachmentIds: CompressedId64Set, viewStateLoadProps?: ViewStateLoadProps) {\r\n    const decompressedIds = CompressedId64Set.decompressSet(sheetViewAttachmentIds);\r\n    const attachmentProps: ViewAttachmentProps[] = [];\r\n    for (const id of decompressedIds) {\r\n      try {\r\n        attachmentProps.push(this._imodel.elements.getElementJson({ id }) );\r\n      } catch (error) {\r\n      }\r\n    }\r\n\r\n    const promises = [];\r\n    for (const attachment of attachmentProps) {\r\n      const loadView = async () => {\r\n        try {\r\n          const view = this._imodel.views.getViewStateData(attachment.view.id, viewStateLoadProps);\r\n          return view;\r\n        } catch {\r\n          return undefined;\r\n        }\r\n      };\r\n\r\n      promises.push(loadView());\r\n    }\r\n    const views = await Promise.all(promises);\r\n    response.sheetViewViews = views;\r\n    response.sheetViewAttachmentProps = attachmentProps;\r\n\r\n    return;\r\n  }\r\n\r\n}\r\n"]}

package/lib/cjs/assets/Settings.schema.json

@@ -1,25 +0,0 @@
-{
-  "$id": "http://itwinjs.org/json-schema/settings",
-  "$schema": "http://json-schema.org/draft-07/schema",
-  "title": "schema for iTwin settings",
-  "description": "base schema for iTwin.js settings",
-  "type": "object",
-  "properties": {
-    "groupName": {
-      "type": "string",
-      "description": "the name for a group of settings"
-    },
-    "order": {
-      "type": "integer",
-      "minimum": 0,
-      "description": "for sorting settings groups in an editor"
-    },
-    "extensionId": {
-      "type": "string",
-      "description": "the name of the extension for these settings"
-    }
-  },
-  "required": [
-    "groupName"
-  ]
-}

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

@@ -1,68 +0,0 @@
-/** @packageDocumentation
- * @module Workspace
- */
-import { BeEvent, JSONSchema, JSONSchemaTypeName } from "@itwin/core-bentley";
-/**
- * The properties of a Setting, used by the settings editor. This interface also includes the
- * default value if it is not specified in any Settings file.
- * This interface includes all members of [JSONSchema]($bentley) with the extensions added by VSCode.
- * @beta
- */
-export interface SettingSpec extends Readonly<JSONSchema> {
-    type: JSONSchemaTypeName | JSONSchemaTypeName[];
-    /** labels for items of an enum. */
-    readonly enumItemLabels?: string[];
-    /** whether the editor should show multiple lines. */
-    readonly multilineEdit?: true;
-}
-/**
- * The properties of a group of [[SettingSpec]]s for an application. Groups can be added and removed from the registry
- * and are identified by their (required) `groupName` member
- * @beta
- */
-export interface SettingsGroupSpec {
-    readonly groupName: string;
-    readonly properties: {
-        [name: string]: SettingSpec;
-    };
-    readonly order?: number;
-    readonly title?: string;
-    readonly description?: string;
-    readonly extensionId?: string;
-}
-/**
- * The registry of available [[SettingsGroupSpec]]s.
- * The registry is used for editing Settings files and for finding default values for settings.
- * @beta
- */
-export declare class SettingsSpecRegistry {
-    private constructor();
-    private static readonly _allGroups;
-    /** a map of all registered [[SettingSpec]]s */
-    static readonly allSpecs: Map<string, SettingSpec>;
-    /** event that signals that the values in [[allSpecs]] have changed in some way. */
-    static readonly onSpecsChanged: BeEvent<() => void>;
-    /** Clear the contents of the registry and remove all event listeners.
-     * @note This is really only necessary for tests of the Settings system.
-     * @internal
-     */
-    static reset(): void;
-    /**
-     * Add one or more [[SettingsGroupSpec]]s to the registry. `SettingsGroupSpec`s must include a `groupName` member that is used
-     * to identify the group. If a group with the same name is already registered, the old values are first removed and then the new group is added.
-     * @returns an array of problems found adding properties of the supplied group(s).
-     */
-    static addGroup(settingsGroup: SettingsGroupSpec | SettingsGroupSpec[]): string[];
-    /** Add a [[SettingsGroupSpec]] from stringified json5. */
-    static addJson(settingSpecJson: string): string[];
-    /** Add a [[SettingsGroupSpec]] from a json5 file. */
-    static addFile(fileName: string): string[];
-    /** Remove a previously added [[SettingsGroupSpec]] by groupName */
-    static removeGroup(groupName: string): void;
-    private static doAdd;
-    private static doRemove;
-    private static validateProperty;
-    private static validateAndAdd;
-    private static getDefaultValue;
-}
-//# sourceMappingURL=SettingsSpecRegistry.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"SettingsSpecRegistry.d.ts","sourceRoot":"","sources":["../../../src/workspace/SettingsSpecRegistry.ts"],"names":[],"mappings":"AAIA;;GAEG;AAIH,OAAO,EAAE,OAAO,EAAE,UAAU,EAAkB,kBAAkB,EAAW,MAAM,qBAAqB,CAAC;AAEvG;;;;;GAKG;AACH,MAAM,WAAW,WAAY,SAAQ,QAAQ,CAAC,UAAU,CAAC;IACvD,IAAI,EAAE,kBAAkB,GAAG,kBAAkB,EAAE,CAAC;IAChD,mCAAmC;IACnC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IACnC,qDAAqD;IACrD,QAAQ,CAAC,aAAa,CAAC,EAAE,IAAI,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE;QAAE,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAA;KAAE,CAAC;IACrD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;GAIG;AACH,qBAAa,oBAAoB;IAC/B,OAAO;IACP,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAwC;IAC1E,+CAA+C;IAC/C,gBAAuB,QAAQ,2BAAkC;IACjE,mFAAmF;IACnF,gBAAuB,cAAc,gBAAqB,IAAI,EAAI;IAElE;;;OAGG;WACW,KAAK;IAMnB;;;;OAIG;WACW,QAAQ,CAAC,aAAa,EAAE,iBAAiB,GAAG,iBAAiB,EAAE,GAAG,MAAM,EAAE;IAUxF,0DAA0D;WAC5C,OAAO,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,EAAE;IAIxD,qDAAqD;WACvC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE;IAIjD,mEAAmE;WACrD,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKlD,OAAO,CAAC,MAAM,CAAC,KAAK;IAWpB,OAAO,CAAC,MAAM,CAAC,QAAQ;IASvB,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAS/B,OAAO,CAAC,MAAM,CAAC,cAAc;IAmB7B,OAAO,CAAC,MAAM,CAAC,eAAe;CAkB/B"}

package/lib/cjs/workspace/SettingsSpecRegistry.js

@@ -1,122 +0,0 @@
-"use strict";
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module Workspace
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SettingsSpecRegistry = void 0;
-const fs = require("fs-extra");
-const json5_1 = require("json5");
-const core_bentley_1 = require("@itwin/core-bentley");
-/**
- * The registry of available [[SettingsGroupSpec]]s.
- * The registry is used for editing Settings files and for finding default values for settings.
- * @beta
- */
-class SettingsSpecRegistry {
-    constructor() { } // singleton
-    /** Clear the contents of the registry and remove all event listeners.
-     * @note This is really only necessary for tests of the Settings system.
-     * @internal
-     */
-    static reset() {
-        this._allGroups.clear();
-        this.allSpecs.clear();
-        this.onSpecsChanged.clear();
-    }
-    /**
-     * Add one or more [[SettingsGroupSpec]]s to the registry. `SettingsGroupSpec`s must include a `groupName` member that is used
-     * to identify the group. If a group with the same name is already registered, the old values are first removed and then the new group is added.
-     * @returns an array of problems found adding properties of the supplied group(s).
-     */
-    static addGroup(settingsGroup) {
-        if (!Array.isArray(settingsGroup))
-            settingsGroup = [settingsGroup];
-        const problems = [];
-        this.doAdd(settingsGroup, problems);
-        this.onSpecsChanged.raiseEvent();
-        return problems;
-    }
-    /** Add a [[SettingsGroupSpec]] from stringified json5. */
-    static addJson(settingSpecJson) {
-        return this.addGroup((0, json5_1.parse)(settingSpecJson));
-    }
-    /** Add a [[SettingsGroupSpec]] from a json5 file. */
-    static addFile(fileName) {
-        return this.addJson(fs.readFileSync(fileName, "utf-8"));
-    }
-    /** Remove a previously added [[SettingsGroupSpec]] by groupName */
-    static removeGroup(groupName) {
-        this.doRemove(groupName);
-        this.onSpecsChanged.raiseEvent();
-    }
-    static doAdd(settingsGroup, problems) {
-        settingsGroup.forEach((group) => {
-            if (undefined === group.groupName)
-                throw new Error("settings group has no name");
-            this.doRemove(group.groupName);
-            this.validateAndAdd(group, problems);
-            this._allGroups.set(group.groupName, group);
-        });
-    }
-    static doRemove(groupName) {
-        const group = this._allGroups.get(groupName);
-        if (undefined !== (group === null || group === void 0 ? void 0 : group.properties)) {
-            for (const key of Object.keys(group.properties))
-                this.allSpecs.delete(key);
-        }
-        this._allGroups.delete(groupName);
-    }
-    static validateProperty(property) {
-        if (!property.trim())
-            return "empty property name";
-        if (this.allSpecs.has(property))
-            return `property "${property}" is already defined`;
-        return undefined;
-    }
-    static validateAndAdd(group, problems) {
-        var _a;
-        const properties = group.properties;
-        if (undefined === properties)
-            return;
-        for (const key of Object.keys(properties)) {
-            const problem = this.validateProperty(key);
-            if (problem) {
-                problems === null || problems === void 0 ? void 0 : problems.push(problem);
-                delete properties[key];
-                continue;
-            }
-            const property = properties[key];
-            property.default = (_a = property.default) !== null && _a !== void 0 ? _a : this.getDefaultValue(property.type);
-            this.allSpecs.set(key, property);
-        }
-    }
-    static getDefaultValue(type) {
-        type = Array.isArray(type) ? type[0] : type;
-        switch (type) {
-            case "boolean":
-                return false;
-            case "integer":
-            case "number":
-                return 0;
-            case "string":
-                return "";
-            case "array":
-                return [];
-            case "object":
-                return {};
-            default:
-                return undefined;
-        }
-    }
-}
-exports.SettingsSpecRegistry = SettingsSpecRegistry;
-SettingsSpecRegistry._allGroups = new Map();
-/** a map of all registered [[SettingSpec]]s */
-SettingsSpecRegistry.allSpecs = new Map();
-/** event that signals that the values in [[allSpecs]] have changed in some way. */
-SettingsSpecRegistry.onSpecsChanged = new core_bentley_1.BeEvent();
-//# sourceMappingURL=SettingsSpecRegistry.js.map

package/lib/cjs/workspace/SettingsSpecRegistry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SettingsSpecRegistry.js","sourceRoot":"","sources":["../../../src/workspace/SettingsSpecRegistry.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Workspace\r\n */\r\n\r\nimport * as fs from \"fs-extra\";\r\nimport { parse } from \"json5\";\r\nimport { BeEvent, JSONSchema, JSONSchemaType, JSONSchemaTypeName, Mutable } from \"@itwin/core-bentley\";\r\n\r\n/**\r\n * The properties of a Setting, used by the settings editor. This interface also includes the\r\n * default value if it is not specified in any Settings file.\r\n * This interface includes all members of [JSONSchema]($bentley) with the extensions added by VSCode.\r\n * @beta\r\n */\r\nexport interface SettingSpec extends Readonly<JSONSchema> {\r\n  type: JSONSchemaTypeName | JSONSchemaTypeName[];\r\n  /** labels for items of an enum. */\r\n  readonly enumItemLabels?: string[];\r\n  /** whether the editor should show multiple lines. */\r\n  readonly multilineEdit?: true;\r\n}\r\n\r\n/**\r\n * The properties of a group of [[SettingSpec]]s for an application. Groups can be added and removed from the registry\r\n * and are identified by their (required) `groupName` member\r\n * @beta\r\n */\r\nexport interface SettingsGroupSpec {\r\n  readonly groupName: string;\r\n  readonly properties: { [name: string]: SettingSpec };\r\n  readonly order?: number;\r\n  readonly title?: string;\r\n  readonly description?: string;\r\n  readonly extensionId?: string;\r\n}\r\n\r\n/**\r\n * The registry of available [[SettingsGroupSpec]]s.\r\n * The registry is used for editing Settings files and for finding default values for settings.\r\n * @beta\r\n */\r\nexport class SettingsSpecRegistry {\r\n  private constructor() { } // singleton\r\n  private static readonly _allGroups = new Map<string, SettingsGroupSpec>();\r\n  /** a map of all registered [[SettingSpec]]s */\r\n  public static readonly allSpecs = new Map<string, SettingSpec>();\r\n  /** event that signals that the values in [[allSpecs]] have changed in some way. */\r\n  public static readonly onSpecsChanged = new BeEvent<() => void>();\r\n\r\n  /** Clear the contents of the registry and remove all event listeners.\r\n   * @note This is really only necessary for tests of the Settings system.\r\n   * @internal\r\n   */\r\n  public static reset() {\r\n    this._allGroups.clear();\r\n    this.allSpecs.clear();\r\n    this.onSpecsChanged.clear();\r\n  }\r\n\r\n  /**\r\n   * Add one or more [[SettingsGroupSpec]]s to the registry. `SettingsGroupSpec`s must include a `groupName` member that is used\r\n   * to identify the group. If a group with the same name is already registered, the old values are first removed and then the new group is added.\r\n   * @returns an array of problems found adding properties of the supplied group(s).\r\n   */\r\n  public static addGroup(settingsGroup: SettingsGroupSpec | SettingsGroupSpec[]): string[] {\r\n    if (!Array.isArray(settingsGroup))\r\n      settingsGroup = [settingsGroup];\r\n\r\n    const problems: string[] = [];\r\n    this.doAdd(settingsGroup, problems);\r\n    this.onSpecsChanged.raiseEvent();\r\n    return problems;\r\n  }\r\n\r\n  /** Add a [[SettingsGroupSpec]] from stringified json5. */\r\n  public static addJson(settingSpecJson: string): string[] {\r\n    return this.addGroup(parse(settingSpecJson));\r\n  }\r\n\r\n  /** Add a [[SettingsGroupSpec]] from a json5 file. */\r\n  public static addFile(fileName: string): string[] {\r\n    return this.addJson(fs.readFileSync(fileName, \"utf-8\"));\r\n  }\r\n\r\n  /** Remove a previously added [[SettingsGroupSpec]] by groupName */\r\n  public static removeGroup(groupName: string): void {\r\n    this.doRemove(groupName);\r\n    this.onSpecsChanged.raiseEvent();\r\n  }\r\n\r\n  private static doAdd(settingsGroup: SettingsGroupSpec[], problems?: string[]) {\r\n    settingsGroup.forEach((group) => {\r\n      if (undefined === group.groupName)\r\n        throw new Error(\"settings group has no name\");\r\n\r\n      this.doRemove(group.groupName);\r\n      this.validateAndAdd(group, problems);\r\n      this._allGroups.set(group.groupName, group);\r\n    });\r\n  }\r\n\r\n  private static doRemove(groupName: string) {\r\n    const group = this._allGroups.get(groupName);\r\n    if (undefined !== group?.properties) {\r\n      for (const key of Object.keys(group.properties))\r\n        this.allSpecs.delete(key);\r\n    }\r\n    this._allGroups.delete(groupName);\r\n  }\r\n\r\n  private static validateProperty(property: string): string | undefined {\r\n    if (!property.trim())\r\n      return \"empty property name\";\r\n    if (this.allSpecs.has(property))\r\n      return `property \"${property}\" is already defined`;\r\n\r\n    return undefined;\r\n  }\r\n\r\n  private static validateAndAdd(group: SettingsGroupSpec, problems?: string[]) {\r\n    const properties = group.properties;\r\n    if (undefined === properties)\r\n      return;\r\n\r\n    for (const key of Object.keys(properties)) {\r\n      const problem = this.validateProperty(key);\r\n      if (problem) {\r\n        problems?.push(problem);\r\n        delete properties[key];\r\n        continue;\r\n      }\r\n\r\n      const property: Mutable<SettingSpec> = properties[key];\r\n      property.default = property.default ?? this.getDefaultValue(property.type);\r\n      this.allSpecs.set(key, property);\r\n    }\r\n  }\r\n\r\n  private static getDefaultValue(type: JSONSchemaTypeName | JSONSchemaTypeName[]): JSONSchemaType | undefined {\r\n    type = Array.isArray(type) ? type[0] : type;\r\n    switch (type) {\r\n      case \"boolean\":\r\n        return false;\r\n      case \"integer\":\r\n      case \"number\":\r\n        return 0;\r\n      case \"string\":\r\n        return \"\";\r\n      case \"array\":\r\n        return [];\r\n      case \"object\":\r\n        return {};\r\n      default:\r\n        return undefined;\r\n    }\r\n  }\r\n}\r\n"]}