@itwin/core-backend 4.7.0-dev.8 → 4.8.0-dev.0

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

@@ -1 +1 @@
-{"version":3,"file":"SettingsSchemas.js","sourceRoot":"","sources":["../../../src/workspace/SettingsSchemas.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Workspace\n */\n\nimport * as fs from \"fs-extra\";\nimport { parse } from \"json5\";\nimport { extname, join } from \"path\";\nimport { BeEvent, JSONSchema, JSONSchemaType, JSONSchemaTypeName, Mutable } from \"@itwin/core-bentley\";\nimport { LocalDirName, LocalFileName } from \"@itwin/core-common\";\nimport { IModelJsFs } from \"../IModelJsFs\";\n\n/**\n * The properties of a single Setting, used by the settings editor. This interface also includes the\n * default value if it is not specified in any Settings file.\n * This interface includes all members of [JSONSchema]($bentley) with the extensions added by VSCode.\n * @note the `type` member is marked optional in JSONSchema but is required for Settings.\n * @beta\n */\nexport interface SettingSchema extends Readonly<JSONSchema> {\n  readonly items?: SettingSchema; // must be single object, not array\n  readonly type: JSONSchemaTypeName; // type is required for settings\n  readonly properties?: { [name: string]: SettingSchema };\n\n  /** whether the setting replaces lower priority entries with the same name or combines with them. */\n  readonly cumulative?: true;\n}\n\n/**\n * The properties of a group of [[SettingSchema]]s for an application. Groups can be added and removed from [[SettingsSchemas]]\n * and are identified by their (required) `groupName` member\n * @beta\n */\nexport interface SettingSchemaGroup {\n  readonly groupName: string;\n  readonly properties: { [name: string]: SettingSchema };\n  readonly order?: number;\n  readonly title?: string;\n  readonly description?: string;\n  readonly extensionId?: string;\n}\n\n/**\n * The registry of available [[SettingSchemaGroup]]s.\n * The registry is used for editing Settings files and for finding default values for settings.\n * @beta\n */\nexport class SettingsSchemas {\n  private constructor() { } // singleton\n  private static readonly _allGroups = new Map<string, SettingSchemaGroup>();\n  /** a map of all registered [[SettingSchema]]s */\n  public static readonly allSchemas = new Map<string, SettingSchema>();\n  /** event that signals that the values in [[allSchemas]] have changed in some way. */\n  public static readonly onSchemaChanged = new BeEvent<() => void>();\n\n  /** @internal */\n  public static validateArrayObject<T>(val: T, schemaName: string, msg: string): T {\n    const schema = this.allSchemas.get(schemaName);\n    const items = schema?.items;\n    if (undefined === items)\n      return val;\n    const required = items.required;\n    const properties = items.properties;\n    if (undefined === required || undefined === properties)\n      return val;\n\n    for (const entry of required) {\n      const entryType = properties[entry].type;\n      const value = (val as any)[entry];\n      if (entryType === \"array\" && Array.isArray(value))\n        continue;\n      if (typeof value !== entryType)\n        throw new Error(`invalid \"${schemaName}\" setting entry for \"${msg}\": ${entry} is ${value}`);\n    }\n    return val;\n  }\n\n  /**\n   * Add one or more [[SettingSchemaGroup]]s. `SettingSchemaGroup`s must include a `groupName` member that is used\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.\n   */\n  public static addGroup(settingsGroup: SettingSchemaGroup | SettingSchemaGroup[]): void {\n    if (!Array.isArray(settingsGroup))\n      settingsGroup = [settingsGroup];\n\n    this.doAdd(settingsGroup);\n    this.onSchemaChanged.raiseEvent();\n  }\n\n  /** Add a [[SettingSchemaGroup]] from stringified json5. */\n  public static addJson(settingSchema: string): void {\n    this.addGroup(parse(settingSchema));\n  }\n\n  /** Add a [[SettingSchemaGroup]] from a json5 file. */\n  public static addFile(fileName: LocalFileName): void {\n    try {\n      this.addJson(fs.readFileSync(fileName, \"utf-8\"));\n    } catch (e: any) {\n      throw new Error(`parsing SettingSchema file \"${fileName}\": ${e.message}\"`);\n    }\n  }\n\n  /** Add all files with a either \".json\" or \".json5\" extension from a supplied directory. */\n  public static addDirectory(dirName: LocalDirName) {\n    for (const fileName of IModelJsFs.readdirSync(dirName)) {\n      const ext = extname(fileName);\n      if (ext === \".json5\" || ext === \".json\")\n        this.addFile(join(dirName, fileName));\n    }\n  }\n\n  /** Remove a previously added [[SettingSchemaGroup]] by groupName */\n  public static removeGroup(groupName: string): void {\n    this.doRemove(groupName);\n    this.onSchemaChanged.raiseEvent();\n  }\n\n  private static doAdd(settingsGroup: SettingSchemaGroup[]) {\n    settingsGroup.forEach((group) => {\n      if (undefined === group.groupName)\n        throw new Error(`settings group has no \"groupName\" member`);\n\n      this.doRemove(group.groupName);\n      this.validateAndAdd(group);\n      this._allGroups.set(group.groupName, group);\n    });\n  }\n\n  private static doRemove(groupName: string) {\n    const group = this._allGroups.get(groupName);\n    if (undefined !== group?.properties) {\n      for (const key of Object.keys(group.properties))\n        this.allSchemas.delete(key);\n    }\n    this._allGroups.delete(groupName);\n  }\n\n  private static validateName(name: string) {\n    if (!name.trim())\n      throw new Error(`empty property name`);\n    if (this.allSchemas.has(name))\n      throw new Error(`property \"${name}\" is already defined`);\n  }\n\n  private static validateProperty(name: string, property: SettingSchema | undefined) {\n    if (!property)\n      throw new Error(`missing required property ${name}`);\n\n    if (!property.type)\n      throw new Error(`property ${name} has no type`);\n\n    switch (property.type) {\n      case \"boolean\":\n      case \"integer\":\n      case \"null\":\n      case \"number\":\n      case \"string\":\n        return;\n\n      case \"object\":\n        const required = property.required;\n        const props = property.properties;\n        if (required && props) {\n          for (const entry of required)\n            this.validateProperty(entry, props[entry]);\n        }\n        if (props) {\n          for (const key of Object.keys(props))\n            try {\n              this.validateProperty(key, props[key]);\n            } catch (e: any) {\n              throw new Error(`property ${key} of ${name}: ${e.message}`);\n            }\n        }\n        return;\n\n      case \"array\":\n        if (typeof property.items !== \"object\")\n          throw new Error(`array property ${name} has no items member`);\n        try {\n          this.validateProperty(\"items\", property.items);\n        } catch (e: any) {\n          throw new Error(`array property ${name}: ${e.message}`);\n        }\n        return;\n\n      default:\n        throw new Error(`property ${name} has illegal type \"${property.type}\"`);\n    }\n  }\n\n  private static validateAndAdd(group: SettingSchemaGroup) {\n    const properties = group.properties;\n    if (undefined === properties)\n      throw new Error(`group ${group.groupName} has no properties`);\n\n    for (const key of Object.keys(properties)) {\n      this.validateName(key);\n      this.validateProperty(key, properties[key]);\n      const property: Mutable<SettingSchema> = properties[key];\n      property.default = property.default ?? this.getDefaultValue(property.type);\n      this.allSchemas.set(key, property);\n    }\n  }\n\n  private static getDefaultValue(type: JSONSchemaTypeName | JSONSchemaTypeName[]): JSONSchemaType | undefined {\n    type = Array.isArray(type) ? type[0] : type;\n    switch (type) {\n      case \"boolean\":\n        return false;\n      case \"integer\":\n      case \"number\":\n        return 0;\n      case \"string\":\n        return \"\";\n      case \"array\":\n        return [];\n      case \"object\":\n        return {};\n      default:\n        return undefined;\n    }\n  }\n}\n"]}
+{"version":3,"file":"SettingsSchemas.js","sourceRoot":"","sources":["../../../src/workspace/SettingsSchemas.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 { extname, join } from \"path\";\r\nimport { BeEvent, JSONSchema, JSONSchemaType, JSONSchemaTypeName, Mutable } from \"@itwin/core-bentley\";\r\nimport { LocalDirName, LocalFileName } from \"@itwin/core-common\";\r\nimport { IModelJsFs } from \"../IModelJsFs\";\r\n\r\n/**\r\n * The properties of a single 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 * @note the `type` member is marked optional in JSONSchema but is required for Settings.\r\n * @beta\r\n */\r\nexport interface SettingSchema extends Readonly<JSONSchema> {\r\n  readonly items?: SettingSchema; // must be single object, not array\r\n  readonly type: JSONSchemaTypeName; // type is required for settings\r\n  readonly properties?: { [name: string]: SettingSchema };\r\n\r\n  /** whether the setting replaces lower priority entries with the same name or combines with them. */\r\n  readonly cumulative?: true;\r\n}\r\n\r\n/**\r\n * The properties of a group of [[SettingSchema]]s for an application. Groups can be added and removed from [[SettingsSchemas]]\r\n * and are identified by their (required) `groupName` member\r\n * @beta\r\n */\r\nexport interface SettingSchemaGroup {\r\n  readonly groupName: string;\r\n  readonly properties: { [name: string]: SettingSchema };\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 [[SettingSchemaGroup]]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 SettingsSchemas {\r\n  private constructor() { } // singleton\r\n  private static readonly _allGroups = new Map<string, SettingSchemaGroup>();\r\n  /** a map of all registered [[SettingSchema]]s */\r\n  public static readonly allSchemas = new Map<string, SettingSchema>();\r\n  /** event that signals that the values in [[allSchemas]] have changed in some way. */\r\n  public static readonly onSchemaChanged = new BeEvent<() => void>();\r\n\r\n  /** @internal */\r\n  public static validateArrayObject<T>(val: T, schemaName: string, msg: string): T {\r\n    const schema = this.allSchemas.get(schemaName);\r\n    const items = schema?.items;\r\n    if (undefined === items)\r\n      return val;\r\n    const required = items.required;\r\n    const properties = items.properties;\r\n    if (undefined === required || undefined === properties)\r\n      return val;\r\n\r\n    for (const entry of required) {\r\n      const entryType = properties[entry].type;\r\n      const value = (val as any)[entry];\r\n      if (entryType === \"array\" && Array.isArray(value))\r\n        continue;\r\n      if (typeof value !== entryType)\r\n        throw new Error(`invalid \"${schemaName}\" setting entry for \"${msg}\": ${entry} is ${value}`);\r\n    }\r\n    return val;\r\n  }\r\n\r\n  /**\r\n   * Add one or more [[SettingSchemaGroup]]s. `SettingSchemaGroup`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   */\r\n  public static addGroup(settingsGroup: SettingSchemaGroup | SettingSchemaGroup[]): void {\r\n    if (!Array.isArray(settingsGroup))\r\n      settingsGroup = [settingsGroup];\r\n\r\n    this.doAdd(settingsGroup);\r\n    this.onSchemaChanged.raiseEvent();\r\n  }\r\n\r\n  /** Add a [[SettingSchemaGroup]] from stringified json5. */\r\n  public static addJson(settingSchema: string): void {\r\n    this.addGroup(parse(settingSchema));\r\n  }\r\n\r\n  /** Add a [[SettingSchemaGroup]] from a json5 file. */\r\n  public static addFile(fileName: LocalFileName): void {\r\n    try {\r\n      this.addJson(fs.readFileSync(fileName, \"utf-8\"));\r\n    } catch (e: any) {\r\n      throw new Error(`parsing SettingSchema file \"${fileName}\": ${e.message}\"`);\r\n    }\r\n  }\r\n\r\n  /** Add all files with a either \".json\" or \".json5\" extension from a supplied directory. */\r\n  public static addDirectory(dirName: LocalDirName) {\r\n    for (const fileName of IModelJsFs.readdirSync(dirName)) {\r\n      const ext = extname(fileName);\r\n      if (ext === \".json5\" || ext === \".json\")\r\n        this.addFile(join(dirName, fileName));\r\n    }\r\n  }\r\n\r\n  /** Remove a previously added [[SettingSchemaGroup]] by groupName */\r\n  public static removeGroup(groupName: string): void {\r\n    this.doRemove(groupName);\r\n    this.onSchemaChanged.raiseEvent();\r\n  }\r\n\r\n  private static doAdd(settingsGroup: SettingSchemaGroup[]) {\r\n    settingsGroup.forEach((group) => {\r\n      if (undefined === group.groupName)\r\n        throw new Error(`settings group has no \"groupName\" member`);\r\n\r\n      this.doRemove(group.groupName);\r\n      this.validateAndAdd(group);\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.allSchemas.delete(key);\r\n    }\r\n    this._allGroups.delete(groupName);\r\n  }\r\n\r\n  private static validateName(name: string) {\r\n    if (!name.trim())\r\n      throw new Error(`empty property name`);\r\n    if (this.allSchemas.has(name))\r\n      throw new Error(`property \"${name}\" is already defined`);\r\n  }\r\n\r\n  private static validateProperty(name: string, property: SettingSchema | undefined) {\r\n    if (!property)\r\n      throw new Error(`missing required property ${name}`);\r\n\r\n    if (!property.type)\r\n      throw new Error(`property ${name} has no type`);\r\n\r\n    switch (property.type) {\r\n      case \"boolean\":\r\n      case \"integer\":\r\n      case \"null\":\r\n      case \"number\":\r\n      case \"string\":\r\n        return;\r\n\r\n      case \"object\":\r\n        const required = property.required;\r\n        const props = property.properties;\r\n        if (required && props) {\r\n          for (const entry of required)\r\n            this.validateProperty(entry, props[entry]);\r\n        }\r\n        if (props) {\r\n          for (const key of Object.keys(props))\r\n            try {\r\n              this.validateProperty(key, props[key]);\r\n            } catch (e: any) {\r\n              throw new Error(`property ${key} of ${name}: ${e.message}`);\r\n            }\r\n        }\r\n        return;\r\n\r\n      case \"array\":\r\n        if (typeof property.items !== \"object\")\r\n          throw new Error(`array property ${name} has no items member`);\r\n        try {\r\n          this.validateProperty(\"items\", property.items);\r\n        } catch (e: any) {\r\n          throw new Error(`array property ${name}: ${e.message}`);\r\n        }\r\n        return;\r\n\r\n      default:\r\n        throw new Error(`property ${name} has illegal type \"${property.type}\"`);\r\n    }\r\n  }\r\n\r\n  private static validateAndAdd(group: SettingSchemaGroup) {\r\n    const properties = group.properties;\r\n    if (undefined === properties)\r\n      throw new Error(`group ${group.groupName} has no properties`);\r\n\r\n    for (const key of Object.keys(properties)) {\r\n      this.validateName(key);\r\n      this.validateProperty(key, properties[key]);\r\n      const property: Mutable<SettingSchema> = properties[key];\r\n      property.default = property.default ?? this.getDefaultValue(property.type);\r\n      this.allSchemas.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"]}

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":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Workspace\n */\n\nimport { createHash } from \"crypto\";\nimport * as fs from \"fs-extra\";\nimport { dirname, extname, join } from \"path\";\nimport * as semver from \"semver\";\nimport { AccessToken, BeEvent, DbResult, OpenMode, Optional } from \"@itwin/core-bentley\";\nimport { IModelError, LocalDirName, LocalFileName } from \"@itwin/core-common\";\nimport { CloudSqlite } from \"../CloudSqlite\";\nimport { IModelHost, KnownLocations } from \"../IModelHost\";\nimport { IModelJsFs } from \"../IModelJsFs\";\nimport { SQLiteDb } from \"../SQLiteDb\";\nimport { SqliteStatement } from \"../SqliteStatement\";\nimport { Settings, SettingsPriority } from \"./Settings\";\nimport { SettingsSchemas } from \"./SettingsSchemas\";\nimport type { IModelJsNative } from \"@bentley/imodeljs-native\";\n\n/* eslint-disable @typescript-eslint/naming-convention */\n// cspell:ignore rowid primarykey julianday\n\nfunction noLeadingOrTrailingSpaces(name: string, msg: string) {\n  if (name.trim() !== name)\n    throw new Error(`${msg} [${name}] may not have leading or tailing spaces`);\n}\n\n/** The Settings used by Workspace api\n * @beta\n */\nexport const WorkspaceSetting = {\n  Containers: \"cloud/containers\",\n  Databases: \"workspace/databases\",\n};\n\n/** @beta */\nexport namespace WorkspaceContainer {\n  /** The name of a WorkspaceContainer in a \"cloud/containers\" setting. */\n  export type Name = string;\n\n  /** The unique identifier of a WorkspaceContainer. This becomes the base name for the local directory holding the WorkspaceDbs from a WorkspaceContainer.\n   * Usually supplied via the `containerId` member of a \"cloud/containers\" setting.\n   * `WorkspaceContainer.Id`s may:\n   *  - only contain lower case letters, numbers or dashes\n   *  - not start or end with a dash\n   *  - not be shorter than 3 or longer than 63 characters\n   */\n  export type Id = string;\n\n  /** A member named `containerName` that specifies by an entry in a \"cloud/containers\" setting */\n  export interface Alias { containerName: string }\n\n  /** Properties that specify a WorkspaceContainer. */\n  export interface Props extends Optional<CloudSqlite.ContainerAccessProps, \"accessToken\"> {\n    /** attempt to synchronize (i.e. call `checkForChanges`) this cloud container whenever it is connected to a cloud cache. Default=true */\n    syncOnConnect?: boolean;\n  }\n\n  /** A function to supply an [AccessToken]($bentley) for a `WorkspaceContainer`.\n   * @param props The properties of the WorkspaceContainer necessary to obtain the access token\n   * @returns a Promise that resolves to the AccessToken for the container.\n   */\n  export type TokenFunc = (props: Props) => Promise<AccessToken>;\n\n  export function validateDbName(dbName: WorkspaceDb.DbName) {\n    if (dbName === \"\" || dbName.length > 255 || /[#\\.<>:\"/\\\\\"`'|?*\\u0000-\\u001F]/g.test(dbName) || /^(con|prn|aux|nul|com\\d|lpt\\d)$/i.test(dbName))\n      throw new Error(`invalid dbName: [${dbName}]`);\n    noLeadingOrTrailingSpaces(dbName, \"dbName\");\n  }\n\n  /**\n   * Validate that a WorkspaceContainer.Id is valid.\n   * The rules for ContainerIds (from Azure, see https://docs.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata):\n   *  - may only contain lower case letters, numbers or dashes\n   *  - may not start or end with with a dash nor have more than one dash in a row\n   *  - may not be shorter than 3 or longer than 63 characters\n   */\n  export function validateContainerId(id: WorkspaceContainer.Id) {\n    if (!/^(?=.{3,63}$)[a-z0-9]+(-[a-z0-9]+)*$/g.test(id))\n      throw new Error(`invalid containerId: [${id}]`);\n  }\n\n  /** @internal */\n  export function validateVersion(version?: WorkspaceDb.Version) {\n    version = version ?? \"1.0.0\";\n    if (version) {\n      const opts = { loose: true, includePrerelease: true };\n      // clean allows prerelease, so try it first. If that fails attempt to coerce it (coerce strips prerelease even if you say not to.)\n      const semVersion = semver.clean(version, opts) ?? semver.coerce(version, opts)?.version;\n      if (!semVersion)\n        throw new Error(\"invalid version specification\");\n      version = semVersion;\n    }\n    return version;\n  }\n\n  /**\n   * Parse the name stored in a WorkspaceContainer into the dbName and version number. A single WorkspaceContainer may hold\n   * many versions of the same WorkspaceDb. The name of the Db in the WorkspaceContainer is in the format \"name:version\". This\n   * function splits them into separate strings.\n   */\n  export function parseDbFileName(dbFileName: WorkspaceDb.DbFullName): { dbName: WorkspaceDb.DbName, version: WorkspaceDb.Version } {\n    const parts = dbFileName.split(\":\");\n    return { dbName: parts[0], version: parts[1] };\n  }\n\n  /** Create a dbName for a WorkspaceDb from its base name and version. This will be in the format \"name:version\" */\n  export function makeDbFileName(dbName: WorkspaceDb.DbName, version?: WorkspaceDb.Version): WorkspaceDb.DbName {\n    return `${dbName}:${WorkspaceContainer.validateVersion(version)}`;\n  }\n}\n\n/** @beta */\nexport namespace WorkspaceDb {\n  /** The name of a WorkspaceDb in a \"workspace/databases\" setting. */\n  export type Name = string;\n\n  /** The base name of a WorkspaceDb within a WorkspaceContainer (without any version identifier) */\n  export type DbName = string;\n\n  /** The  name of a WorkspaceDb within a WorkspaceContainer, including the version identifier */\n  export type DbFullName = string;\n\n  /** The semver-format version identifier for a WorkspaceDb. */\n  export type Version = string;\n\n  /** The [semver range format](https://github.com/npm/node-semver) identifier for a range of acceptable versions. */\n  export type VersionRange = string;\n\n  /** Properties that specify how to load a WorkspaceDb within a [[WorkspaceContainer]]. */\n  export interface Props extends CloudSqlite.DbNameProp {\n    /** a semver version range specifier that determines the acceptable range of versions to load. If not present, use the newest version. */\n    version?: VersionRange;\n    /** if true, allow semver *prerelease* versions. By default only released version are allowed. */\n    includePrerelease?: boolean;\n  }\n\n  /** Scope to increment for a version number.\n   * @see semver.ReleaseType\n   */\n  export type VersionIncrement = \"major\" | \"minor\" | \"patch\";\n\n  /** file extension for local WorkspaceDbs\n   * @internal\n   */\n  export const fileExt = \"itwin-workspace\";\n\n  /** construct a new instance of a WorkspaceDb */\n  export function construct(props: WorkspaceDb.Props, container: WorkspaceContainer): WorkspaceDb {\n    return new WorkspaceDbImpl(props, container);\n  }\n}\n\n/** Types used to identify Workspace resources\n *  @beta\n */\nexport namespace WorkspaceResource {\n  /**\n   * The name for identifying WorkspaceResources in a [[WorkspaceDb]].\n   * * `WorkspaceResource.Name`s may not:\n   *  - be blank or start or end with a space\n   *  - be longer than 1024 characters\n   * @note a single WorkspaceDb may hold WorkspaceResources of type 'blob', 'string' and 'file', all with the same WorkspaceResource.Name.\n   */\n  export type Name = string;\n\n  /** Properties that specify an individual WorkspaceResource within a [[WorkspaceDb]]. */\n  export interface Props {\n    /** the name of the resource within the WorkspaceDb */\n    rscName: Name;\n  }\n}\n\n/**\n * A WorkspaceDb holds workspace resources. `WorkspaceDb`s may just be local files, or they may be stored\n * in cloud WorkspaceContainers. Each `WorkspaceResource` in a WorkspaceDb is identified by a [[WorkspaceResource.Name]].\n * Resources of type `string` and `blob` may be loaded directly from the `WorkspaceDb`. Resources of type `file` are\n * copied from the WorkspaceDb into a temporary local file so they can be accessed by programs directly from disk.\n * @beta\n */\nexport interface WorkspaceDb {\n  /** The WorkspaceContainer holding this WorkspaceDb. */\n  readonly container: WorkspaceContainer;\n  /** The base name of this WorkspaceDb, without version */\n  readonly dbName: WorkspaceDb.DbName;\n  /** event raised before this WorkspaceDb is closed. */\n  readonly onClose: BeEvent<() => void>;\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 */\n  readonly dbFileName: string;\n  /** the SQLiteDb for this WorkspaceDb*/\n  readonly sqliteDb: SQLiteDb;\n\n  open(): void;\n  close(): void;\n\n  /** Get a string resource from this WorkspaceDb, if present. */\n  getString(rscName: WorkspaceResource.Name): string | undefined;\n  /** Get a blob resource from this WorkspaceDb, if present. */\n  getBlob(rscName: WorkspaceResource.Name): Uint8Array | undefined;\n  /** Get a BlobIO reader for a blob WorkspaceResource.\n   * @note when finished, caller *must* call `close` on the BlobIO.\n   * @internal\n   */\n  getBlobReader(rscName: WorkspaceResource.Name): SQLiteDb.BlobIO;\n\n  /**\n   * Extract a local copy of a file resource from this WorkspaceDb, if present.\n   * @param rscName The name of the file resource in the WorkspaceDb\n   * @param targetFileName optional name for extracted file. Some applications require files in specific locations or filenames. If\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\n   * keep the extracted files in the  filesDir.\n   * @returns the full path to a file on the local filesystem.\n   * @note The file is copied from the file into the local filesystem so it may be accessed directly. This happens only\n   * as necessary, if the local file doesn't exist, or if it is out-of-date because it was updated in the file.\n   * For this reason, you should not save the local file name, and instead call this method every time you access it, so its\n   * content is always holds the correct version.\n   * @note The filename will be a hash value, not the resource name.\n   * @note Workspace resource files are set readonly as they are copied from the file.\n   * To edit them, you must first copy them to another location.\n   */\n  getFile(rscName: WorkspaceResource.Name, targetFileName?: LocalFileName): LocalFileName | undefined;\n\n  /**\n   * Ensure that the contents of a `WorkspaceDb` are downloaded into the local cache so that it may be accessed offline.\n   * Until the promise is resolved, the `WorkspaceDb` is not fully downloaded, but it *may* be safely accessed during the download.\n   * To determine the progress of the download, use the `localBlocks` and `totalBlocks` values returned by `CloudContainer.queryDatabase`.\n   * @returns a `CloudSqlite.CloudPrefetch` object that can be used to await and/or cancel the prefetch.\n   * @throws if this WorkspaceDb is not from a `CloudContainer`.\n   */\n  prefetch(opts?: CloudSqlite.PrefetchProps): CloudSqlite.CloudPrefetch;\n\n  /** @internal */\n  queryFileResource(rscName: WorkspaceResource.Name): { localFileName: LocalFileName, info: IModelJsNative.EmbedFileQuery } | undefined;\n}\n\n/** The properties of the CloudCache used for Workspaces.\n * @beta\n */\nexport interface WorkspaceCloudCacheProps extends Optional<CloudSqlite.CacheProps, \"name\" | \"rootDir\"> {\n  /** if true, empty the cache before using it. */\n  clearContents?: boolean;\n}\n\n/**\n * Options for constructing a [[Workspace]].\n * @beta\n */\nexport interface WorkspaceOpts {\n  /** The local directory for non-cloud-based WorkspaceDb files. The workspace api will look in this directory\n   * for files named `${containerId}/${dbId}.itwin-workspace`.\n   * @note if not supplied, defaults to `iTwin/Workspace` in the user-local folder.\n   */\n  containerDir?: LocalDirName;\n\n  /** the local fileName(s) of one or more settings files to load after the Workspace is first created. */\n  settingsFiles?: LocalFileName | [LocalFileName];\n\n  /**\n   * only for tests\n   * @internal */\n  testCloudCache?: CloudSqlite.CloudCache;\n}\n\n/**\n * Settings and resources that customize an application for the current session.\n * See [Workspaces]($docs/learning/backend/Workspace)\n * @beta\n */\nexport interface Workspace {\n  /** The directory for local WorkspaceDb files with the name `${containerId}/${dbId}.itwin-workspace`. */\n  readonly containerDir: LocalDirName;\n  /** The [[Settings]] for this Workspace */\n  readonly settings: Settings;\n\n  /** Get The CloudCache for cloud-based WorkspaceContainers */\n  getCloudCache(): CloudSqlite.CloudCache;\n\n  /** search for a previously opened container.\n   * @param containerId the id of the container\n   * @returns the [[WorkspaceContainer]] for `containerId` if it was not previously opened with [[getContainer]]\n   */\n  findContainer(containerId: WorkspaceContainer.Id): WorkspaceContainer | undefined;\n\n  /** get a [[WorkspaceContainer]] by [[WorkspaceContainer.Props]]\n   * @param props the properties of the `WorkspaceContainer`. If `props.containerId` was already opened, its WorkspaceContainer is returned.\n   * Otherwise it is created.\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.\n  */\n  getContainer(props: WorkspaceContainer.Props): WorkspaceContainer;\n\n  /** get the properties for the supplied container name by searching for an entry with that name in a `cloud/containers` setting. */\n  resolveContainer(containerName: WorkspaceContainer.Name): WorkspaceContainer.Props;\n\n  /** get the properties for the supplied workspace database name by searching for an entry with that name in a `workspace/databases` setting. */\n  resolveDatabase(databaseAlias: WorkspaceDb.Name): WorkspaceDb.Props & WorkspaceContainer.Alias;\n\n  /**\n   * Get an opened [[WorkspaceDb]]. If the WorkspaceDb is present but not open, it is opened first.\n   * If `cloudProps` are supplied, a CloudContainer will be used to open the WorkspaceDb.\n   */\n  getWorkspaceDbFromProps(dbProps: WorkspaceDb.Props, containerProps: WorkspaceContainer.Props): WorkspaceDb;\n\n  /** Get an opened [[WorkspaceDb]] from a WorkspaceDb alias.\n   * @param dbAlias the database alias, resolved via [[resolveDatabase]].\n   */\n  getWorkspaceDb(dbAlias: WorkspaceDb.Name): Promise<WorkspaceDb>;\n\n  /** Load a WorkspaceResource of type string, parse it, and add it to the current Settings for this Workspace.\n   * @note settingsRsc must specify a resource holding a stringified JSON representation of a [[SettingDictionary]]\n   */\n  loadSettingsDictionary(settingRsc: WorkspaceResource.Name, db: WorkspaceDb, priority: SettingsPriority): void;\n\n  /** Close this Workspace. All WorkspaceContainers are dropped. */\n  close(): void;\n}\n\n/** @beta */\nexport namespace Workspace {\n  /** @internal */\n  export function construct(settings: Settings, opts?: WorkspaceOpts): Workspace {\n    return new WorkspaceImpl(settings, opts);\n  }\n}\n\n/**\n * A WorkspaceContainer is a type of `CloudSqlite.CloudContainer` that holds WorkspaceDbs. Normally a WorkspaceContainer will hold (many versions of) a single WorkspaceDb.\n * Each version of a WorkspaceDb is treated as immutable after it is created and is stored in the WorkspaceContainer indefinitely. That means that\n * older versions of the WorkspaceDb may continue to be used, for example by archived projects. For programmers familiar with [NPM](https://www.npmjs.com/), this is conceptually\n * similar and versioning follows the same rules as NPM using [Semantic Versioning](https://semver.org/).\n * @note It is possible to store more than one WorkspaceDb in the same WorkspaceContainer, but access rights are administered per WorkspaceContainer.\n * That is, if a user has rights to access a WorkspaceContainer, that right applies to all WorkspaceDbs in the WorkspaceContainer.\n * @beta\n */\nexport interface WorkspaceContainer {\n  /** the local directory where this WorkspaceContainer will store temporary files extracted for file-resources. */\n  readonly filesDir: LocalDirName;\n  /** The unique identifier for a WorkspaceContainer a cloud storage account. */\n  readonly id: WorkspaceContainer.Id;\n  /** Workspace holding this WorkspaceContainer. */\n  readonly workspace: Workspace;\n  /** CloudContainer for this WorkspaceContainer (`undefined` if this is a local WorkspaceContainer.) */\n  readonly cloudContainer?: CloudSqlite.CloudContainer;\n\n  /** @internal */\n  addWorkspaceDb(toAdd: WorkspaceDbImpl): void;\n\n  /**\n   * Find the appropriate version of a WorkspaceDb in this WorkspaceContainer based on the SemVer rule\n   * in the `WorkspaceDb.Props`.\n   * If no version satisfying the WorkspaceDb.Props rules exists, throws an exception.\n   */\n  resolveDbFileName(props: WorkspaceDb.Props): WorkspaceDb.DbFullName;\n\n  /**\n   * Create a copy of an existing [[WorkspaceDb]] in this WorkspaceContainer with a new version number. This function is used\n   * by administrator tools that modify Workspaces. This requires that the write lock on the container be held. The copy should be modified with\n   * new content before the write lock is released, and thereafter should never be modified again.\n   * @param fromProps Properties that describe the source WorkspaceDb for the new version\n   * @param versionType The type of version increment to apply to the existing version.\n   * @note The copy actually shares all of the data with the original, but with copy-on-write if/when data in the new WorkspaceDb is modified.\n   */\n  makeNewVersion(fromProps: WorkspaceDb.Props, versionType: WorkspaceDb.VersionIncrement): Promise<{ oldName: WorkspaceDb.DbName, newName: WorkspaceDb.DbName }>;\n\n  /** find or open a WorkspaceDb from this WorkspaceContainer. */\n  getWorkspaceDb(props: WorkspaceDb.Props): WorkspaceDb;\n\n  /** Close and remove a currently opened [[WorkspaceDb]] from this Workspace. */\n  closeWorkspaceDb(container: WorkspaceDb): void;\n\n  /** Close this WorkspaceContainer. All currently opened WorkspaceDbs are dropped. */\n  close(): void;\n}\n\n/**\n * An editable [[WorkspaceDb]]. This is used only by tools to allow administrators to create and modify `WorkspaceDb`s.\n * For CloudSqlite Workspaces, the write token must be obtained before the methods in this interface may be used. Normally\n * only admins will have write access to Workspaces. Only one admin at at time may be editing a Workspace.\n * @beta\n */\nexport interface EditableWorkspaceDb extends WorkspaceDb {\n  createDb(version?: string): Promise<void>;\n\n  /** Add a new string resource to this WorkspaceDb.\n   * @param rscName The name of the string resource.\n   * @param val The string to save.\n   */\n  addString(rscName: WorkspaceResource.Name, val: string): void;\n\n  /** Update an existing string resource with a new value, or add it if it does not exist.\n   * @param rscName The name of the string resource.\n   * @param val The new value.\n   */\n  updateString(rscName: WorkspaceResource.Name, val: string): void;\n\n  /** Remove a string resource. */\n  removeString(rscName: WorkspaceResource.Name): void;\n\n  /** Add a new blob resource to this WorkspaceDb.\n   * @param rscName The name of the blob resource.\n   * @param val The blob to save.\n   */\n  addBlob(rscName: WorkspaceResource.Name, val: Uint8Array): void;\n\n  /** Update an existing blob resource with a new value, or add it if it does not exist.\n   * @param rscName The name of the blob resource.\n   * @param val The new value.\n   */\n  updateBlob(rscName: WorkspaceResource.Name, val: Uint8Array): void;\n\n  /** Get a BlobIO writer for a previously-added blob WorkspaceResource.\n   * @note after writing is complete, caller must call `close` on the BlobIO and must call `saveChanges` on the `db`.\n   */\n  getBlobWriter(rscName: WorkspaceResource.Name): SQLiteDb.BlobIO;\n\n  /** Remove a blob resource. */\n  removeBlob(rscName: WorkspaceResource.Name): void;\n\n  /** Copy the contents of an existing local file into this WorkspaceDb as a file resource.\n   * @param rscName The name of the file resource.\n   * @param localFileName The name of a local file to be read.\n   * @param fileExt The extension (do not include the leading \".\") to be appended to the generated fileName\n   * when this WorkspaceDb is extracted from the WorkspaceDb. By default the characters after the last \".\" in `localFileName`\n   * are used. Pass this argument to override that.\n   */\n  addFile(rscName: WorkspaceResource.Name, localFileName: LocalFileName, fileExt?: string): void;\n\n  /** Replace an existing file resource with the contents of another local file.\n   * @param rscName The name of the file resource.\n   * @param localFileName The name of a local file to be read.\n   * @throws if rscName does not exist\n   */\n  updateFile(rscName: WorkspaceResource.Name, localFileName: LocalFileName): void;\n\n  /** Remove a file resource. */\n  removeFile(rscName: WorkspaceResource.Name): void;\n}\n\n/** @beta */\nexport namespace EditableWorkspaceDb {\n  /** construct a new instance of an EditableWorkspaceDb */\n  export function construct(props: WorkspaceDb.Props, container: WorkspaceContainer): EditableWorkspaceDb {\n    return new EditableWorkspaceDbImpl(props, container);\n  }\n  /** Create a new, empty, EditableWorkspaceDb file on the local filesystem for importing Workspace resources. */\n  export function createEmpty(fileName: LocalFileName) {\n    const db = new SQLiteDb();\n    IModelJsFs.recursiveMkDirSync(dirname(fileName));\n    db.createDb(fileName);\n    const timeStampCol = \"lastMod TIMESTAMP NOT NULL DEFAULT(julianday('now'))\";\n    db.executeSQL(`CREATE TABLE strings(id TEXT PRIMARY KEY NOT NULL,value TEXT,${timeStampCol})`);\n    db.executeSQL(`CREATE TABLE blobs(id TEXT PRIMARY KEY NOT NULL,value BLOB,${timeStampCol})`);\n    const createTrigger = (tableName: string) => {\n      db.executeSQL(`CREATE TRIGGER ${tableName}_timeStamp AFTER UPDATE ON ${tableName} WHEN old.lastMod=new.lastMod AND old.lastMod != julianday('now') BEGIN UPDATE ${tableName} SET lastMod=julianday('now') WHERE id=new.id; END`);\n    };\n    createTrigger(\"strings\");\n    createTrigger(\"blobs\");\n    db.closeDb(true);\n  }\n}\n\nclass WorkspaceImpl implements Workspace {\n  private _containers = new Map<WorkspaceContainer.Id, WorkspaceContainerImpl>();\n  public readonly containerDir: LocalDirName;\n  public readonly settings: Settings;\n  private _cloudCache?: CloudSqlite.CloudCache;\n  public getCloudCache(): CloudSqlite.CloudCache {\n    return this._cloudCache ??= CloudSqlite.CloudCaches.getCache({ cacheName: \"Workspace\", cacheSize: \"20G\" });\n  }\n\n  public constructor(settings: Settings, opts?: WorkspaceOpts) {\n    this.settings = settings;\n    this.containerDir = opts?.containerDir ?? join(IModelHost.cacheDir, \"Workspace\");\n    this._cloudCache = opts?.testCloudCache;\n    let settingsFiles = opts?.settingsFiles;\n    if (settingsFiles) {\n      if (typeof settingsFiles === \"string\")\n        settingsFiles = [settingsFiles];\n      settingsFiles.forEach((file) => settings.addFile(file, SettingsPriority.application));\n    }\n  }\n\n  public addContainer(toAdd: WorkspaceContainerImpl) {\n    if (undefined !== this._containers.get(toAdd.id))\n      throw new Error(\"container already exists in workspace\");\n    this._containers.set(toAdd.id, toAdd);\n  }\n\n  public findContainer(containerId: WorkspaceContainer.Id) {\n    return this._containers.get(containerId);\n  }\n\n  public getContainer(props: WorkspaceContainer.Props): WorkspaceContainer {\n    return this.findContainer(props.containerId) ?? new WorkspaceContainerImpl(this, props);\n  }\n\n  public getWorkspaceDbFromProps(dbProps: WorkspaceDb.Props, containerProps: WorkspaceContainer.Props): WorkspaceDb {\n    return this.getContainer(containerProps).getWorkspaceDb(dbProps);\n  }\n\n  public async getWorkspaceDb(dbAlias: string) {\n    const dbProps = this.resolveDatabase(dbAlias);\n    const props = this.resolveContainer(dbProps.containerName);\n    let container: WorkspaceContainer | undefined = this.findContainer(props.containerId);\n    if (undefined === container) {\n      props.accessToken = await CloudSqlite.requestToken(props);\n      container = this.getContainer(props);\n    }\n    return container?.getWorkspaceDb(dbProps);\n  }\n\n  public loadSettingsDictionary(settingRsc: WorkspaceResource.Name, db: WorkspaceDb, priority: SettingsPriority) {\n    const setting = db.getString(settingRsc);\n    if (undefined === setting)\n      throw new Error(`could not load setting resource ${settingRsc}`);\n\n    this.settings.addJson(`${db.container.id}/${db.dbName}/${settingRsc}`, priority, setting);\n  }\n\n  public close() {\n    this.settings.close();\n    for (const [_id, container] of this._containers)\n      container.close();\n    this._containers.clear();\n  }\n\n  public resolveContainer(containerName: string): WorkspaceContainer.Props {\n    const resolved = this.settings.resolveSetting<WorkspaceContainer.Props>(WorkspaceSetting.Containers, (val) => {\n      if (Array.isArray(val)) {\n        for (const entry of val) {\n          if (typeof entry === \"object\" && entry.name === containerName)\n            return SettingsSchemas.validateArrayObject(entry, WorkspaceSetting.Containers, containerName);\n        }\n      }\n      return undefined; // keep going through all settings dictionaries\n    });\n    if (resolved === undefined)\n      throw new Error(`no setting \"${WorkspaceSetting.Containers}\" entry for \"${containerName}\"`);\n\n    return resolved;\n  }\n\n  public resolveDatabase(databaseName: string): WorkspaceDb.Props & WorkspaceContainer.Alias {\n    const resolved = this.settings.resolveSetting<WorkspaceDb.Props & WorkspaceContainer.Alias>(WorkspaceSetting.Databases, (val) => {\n      if (Array.isArray(val)) {\n        for (const entry of val) {\n          if (typeof entry === \"object\" && entry.name === databaseName)\n            return SettingsSchemas.validateArrayObject(entry, WorkspaceSetting.Databases, databaseName);\n        }\n      }\n      return undefined; // keep going through all settings dictionaries\n    });\n\n    if (resolved === undefined)\n      throw new Error(`no setting \"${WorkspaceSetting.Databases}\" entry for \"${databaseName}\"`);\n\n    return resolved;\n  }\n}\n\nclass WorkspaceContainerImpl implements WorkspaceContainer {\n  public readonly workspace: WorkspaceImpl;\n  public readonly filesDir: LocalDirName;\n  public readonly id: WorkspaceContainer.Id;\n\n  public readonly cloudContainer?: CloudSqlite.CloudContainer | undefined;\n  private _wsDbs = new Map<WorkspaceDb.DbName, WorkspaceDbImpl>();\n  public get dirName() { return join(this.workspace.containerDir, this.id); }\n\n  public constructor(workspace: WorkspaceImpl, props: WorkspaceContainer.Props) {\n    WorkspaceContainer.validateContainerId(props.containerId);\n    this.workspace = workspace;\n    this.id = props.containerId;\n\n    if (props.baseUri !== \"\")\n      this.cloudContainer = CloudSqlite.createCloudContainer({ accessToken: \"\", ...props });\n\n    workspace.addContainer(this);\n    this.filesDir = join(this.dirName, \"Files\");\n\n    const cloudContainer = this.cloudContainer;\n    if (undefined === cloudContainer)\n      return;\n\n    cloudContainer.connect(this.workspace.getCloudCache());\n    if (false !== props.syncOnConnect) {\n      try {\n        cloudContainer.checkForChanges();\n      } catch (e: unknown) {\n        // must be offline\n      }\n    }\n  }\n\n  public resolveDbFileName(props: WorkspaceDb.Props): WorkspaceDb.DbFullName {\n    const cloudContainer = this.cloudContainer;\n    if (undefined === cloudContainer)\n      return join(this.dirName, `${props.dbName}.${WorkspaceDb.fileExt}`); // local file, versions not allowed\n\n    const dbName = props.dbName;\n    const dbs = cloudContainer.queryDatabases(`${dbName}*`); // get all databases that start with dbName\n\n    const versions = [];\n    for (const db of dbs) {\n      const thisDb = WorkspaceContainer.parseDbFileName(db);\n      if (thisDb.dbName === dbName && \"string\" === typeof thisDb.version && thisDb.version.length > 0)\n        versions.push(thisDb.version);\n    }\n\n    if (versions.length === 0)\n      versions[0] = \"1.0.0\";\n\n    const range = props.version ?? \"*\";\n    try {\n      const version = semver.maxSatisfying(versions, range, { loose: true, includePrerelease: props.includePrerelease });\n      if (version)\n        return `${dbName}:${version}`;\n    } catch (e: unknown) {\n    }\n    throw new Error(`No version of [${dbName}] available for \"${range}\"`);\n  }\n\n  public async makeNewVersion(fromProps: WorkspaceDb.Props, versionType: WorkspaceDb.VersionIncrement) {\n    const cloudContainer = this.cloudContainer;\n    if (undefined === cloudContainer)\n      throw new Error(\"versions require cloud containers\");\n\n    const oldName = this.resolveDbFileName(fromProps);\n    const oldDb = WorkspaceContainer.parseDbFileName(oldName);\n    const newVersion = semver.inc(oldDb.version, versionType);\n    if (!newVersion)\n      throw new Error(\"invalid version\");\n\n    const newName = WorkspaceContainer.makeDbFileName(oldDb.dbName, newVersion);\n    await cloudContainer.copyDatabase(oldName, newName);\n    return { oldName, newName };\n  }\n\n  public addWorkspaceDb(toAdd: WorkspaceDbImpl) {\n    if (undefined !== this._wsDbs.get(toAdd.dbName))\n      throw new Error(`workspaceDb ${toAdd.dbName} already exists in workspace`);\n    this._wsDbs.set(toAdd.dbName, toAdd);\n  }\n\n  public getWorkspaceDb(props: WorkspaceDb.Props): WorkspaceDb {\n    const db = this._wsDbs.get(props.dbName) ?? new WorkspaceDbImpl(props, this);\n    if (!db.isOpen)\n      db.open();\n    return db;\n  }\n\n  public closeWorkspaceDb(toDrop: WorkspaceDb) {\n    const name = toDrop.dbName;\n    const wsDb = this._wsDbs.get(name);\n    if (wsDb === toDrop) {\n      this._wsDbs.delete(name);\n      wsDb.close();\n    }\n  }\n\n  public close() {\n    for (const [_name, db] of this._wsDbs)\n      db.close();\n    this._wsDbs.clear();\n    this.cloudContainer?.disconnect();\n  }\n}\n\n/** Implementation of WorkspaceDb */\nclass WorkspaceDbImpl implements WorkspaceDb {\n  public readonly sqliteDb = new SQLiteDb();\n  public readonly dbName: WorkspaceDb.DbName;\n  public readonly container: WorkspaceContainer;\n  public readonly onClose = new BeEvent<() => void>();\n  public dbFileName: string;\n\n  /** true if this WorkspaceDb is currently open */\n  public get isOpen() { return this.sqliteDb.isOpen; }\n  public queryFileResource(rscName: WorkspaceResource.Name): { localFileName: LocalFileName, info: IModelJsNative.EmbedFileQuery } | undefined {\n    const info = this.sqliteDb.nativeDb.queryEmbeddedFile(rscName);\n    if (undefined === info)\n      return undefined;\n\n    // since resource names can contain illegal characters, path separators, etc., we make the local file name from its hash, in hex.\n    let localFileName = join(this.container.filesDir, createHash(\"sha1\").update(this.dbFileName).update(rscName).digest(\"hex\"));\n    if (info.fileExt !== \"\") // since some applications may expect to see the extension, append it here if it was supplied.\n      localFileName = `${localFileName}.${info.fileExt}`;\n    return { localFileName, info };\n  }\n\n  public constructor(props: WorkspaceDb.Props, container: WorkspaceContainer) {\n    WorkspaceContainer.validateDbName(props.dbName);\n    this.dbName = props.dbName;\n    this.container = container;\n    this.dbFileName = container.resolveDbFileName(props);\n    container.addWorkspaceDb(this);\n  }\n\n  public open() {\n    this.sqliteDb.openDb(this.dbFileName, OpenMode.Readonly, this.container.cloudContainer);\n  }\n\n  public close() {\n    if (this.isOpen) {\n      this.onClose.raiseEvent();\n      this.sqliteDb.closeDb();\n      this.container.closeWorkspaceDb(this);\n    }\n  }\n\n  public getString(rscName: WorkspaceResource.Name): string | undefined {\n    return this.sqliteDb.withSqliteStatement(\"SELECT value from strings WHERE id=?\", (stmt) => {\n      stmt.bindString(1, rscName);\n      return DbResult.BE_SQLITE_ROW === stmt.step() ? stmt.getValueString(0) : undefined;\n    });\n  }\n\n  public getBlobReader(rscName: WorkspaceResource.Name): SQLiteDb.BlobIO {\n    return this.sqliteDb.withSqliteStatement(\"SELECT rowid from blobs WHERE id=?\", (stmt) => {\n      stmt.bindString(1, rscName);\n      const blobReader = SQLiteDb.createBlobIO();\n      blobReader.open(this.sqliteDb.nativeDb, { tableName: \"blobs\", columnName: \"value\", row: stmt.getValueInteger(0) });\n      return blobReader;\n    });\n  }\n\n  public getBlob(rscName: WorkspaceResource.Name): Uint8Array | undefined {\n    return this.sqliteDb.withSqliteStatement(\"SELECT value from blobs WHERE id=?\", (stmt) => {\n      stmt.bindString(1, rscName);\n      return DbResult.BE_SQLITE_ROW === stmt.step() ? stmt.getValueBlob(0) : undefined;\n    });\n  }\n\n  public getFile(rscName: WorkspaceResource.Name, targetFileName?: LocalFileName): LocalFileName | undefined {\n    const file = this.queryFileResource(rscName);\n    if (!file)\n      return undefined;\n\n    const info = file.info;\n    const localFileName = targetFileName ?? file.localFileName;\n\n    // check whether the file is already up to date.\n    const stat = fs.existsSync(localFileName) && fs.statSync(localFileName);\n    if (stat && Math.round(stat.mtimeMs) === info.date && stat.size === info.size)\n      return localFileName; // yes, we're done\n\n    // extractEmbeddedFile fails if the file exists or if the directory does not exist\n    if (stat)\n      fs.removeSync(localFileName);\n    else\n      IModelJsFs.recursiveMkDirSync(dirname(localFileName));\n\n    this.sqliteDb.nativeDb.extractEmbeddedFile({ name: rscName, localFileName });\n    const date = new Date(info.date);\n    fs.utimesSync(localFileName, date, date); // set the last-modified date of the file to match date in container\n    fs.chmodSync(localFileName, \"0444\"); // set file readonly\n    return localFileName;\n  }\n\n  public prefetch(opts?: CloudSqlite.PrefetchProps): CloudSqlite.CloudPrefetch {\n    const cloudContainer = this.container.cloudContainer;\n    if (cloudContainer === undefined)\n      throw new Error(\"no cloud container to prefetch\");\n    return CloudSqlite.startCloudPrefetch(cloudContainer, this.dbFileName, opts);\n  }\n}\n\nclass EditableWorkspaceDbImpl extends WorkspaceDbImpl implements EditableWorkspaceDb {\n  private static validateResourceName(name: WorkspaceResource.Name) {\n    noLeadingOrTrailingSpaces(name, \"resource name\");\n    if (name.length > 1024)\n      throw new Error(\"resource name too long\");\n  }\n\n  private validateResourceSize(val: Uint8Array | string) {\n    const len = typeof val === \"string\" ? val.length : val.byteLength;\n    if (len > (1024 * 1024 * 1024)) // one gigabyte\n      throw new Error(\"value is too large\");\n  }\n\n  public override open() {\n    this.sqliteDb.openDb(this.dbFileName, OpenMode.ReadWrite, this.container.cloudContainer);\n  }\n\n  private getFileModifiedTime(localFileName: LocalFileName): number {\n    return Math.round(fs.statSync(localFileName).mtimeMs);\n  }\n\n  private performWriteSql(rscName: WorkspaceResource.Name, sql: string, bind?: (stmt: SqliteStatement) => void) {\n    this.sqliteDb.withSqliteStatement(sql, (stmt) => {\n      stmt.bindString(1, rscName);\n      bind?.(stmt);\n      const rc = stmt.step();\n      if (DbResult.BE_SQLITE_DONE !== rc) {\n        if (DbResult.BE_SQLITE_CONSTRAINT_PRIMARYKEY === rc)\n          throw new IModelError(rc, `resource \"${rscName}\" already exists`);\n\n        throw new IModelError(rc, `workspace [${sql}]`);\n      }\n    });\n    this.sqliteDb.saveChanges();\n  }\n\n  public async createDb(version?: string) {\n    if (!this.container.cloudContainer) {\n      EditableWorkspaceDb.createEmpty(this.dbFileName);\n    } else {\n      // currently the only way to create a workspaceDb in a cloud container is to create a temporary workspaceDb and upload it.\n      const tempDbFile = join(KnownLocations.tmpdir, `empty.${WorkspaceDb.fileExt}`);\n      if (fs.existsSync(tempDbFile))\n        IModelJsFs.removeSync(tempDbFile);\n      EditableWorkspaceDb.createEmpty(tempDbFile);\n      this.dbFileName = WorkspaceContainer.makeDbFileName(this.dbName, version);\n      await CloudSqlite.uploadDb(this.container.cloudContainer, { localFileName: tempDbFile, dbName: this.dbFileName });\n      IModelJsFs.removeSync(tempDbFile);\n    }\n    this.open();\n  }\n\n  public addString(rscName: WorkspaceResource.Name, val: string): void {\n    EditableWorkspaceDbImpl.validateResourceName(rscName);\n    this.validateResourceSize(val);\n    this.performWriteSql(rscName, \"INSERT INTO strings(id,value) VALUES(?,?)\", (stmt) => stmt.bindString(2, val));\n  }\n  public updateString(rscName: WorkspaceResource.Name, val: string): void {\n    this.validateResourceSize(val);\n    this.performWriteSql(rscName, \"INSERT INTO strings(id,value) VALUES(?,?) ON CONFLICT(id) DO UPDATE SET value=excluded.value WHERE value!=excluded.value\", (stmt) => stmt.bindString(2, val));\n  }\n  public removeString(rscName: WorkspaceResource.Name): void {\n    this.performWriteSql(rscName, \"DELETE FROM strings WHERE id=?\");\n  }\n  public addBlob(rscName: WorkspaceResource.Name, val: Uint8Array): void {\n    EditableWorkspaceDbImpl.validateResourceName(rscName);\n    this.validateResourceSize(val);\n    this.performWriteSql(rscName, \"INSERT INTO blobs(id,value) VALUES(?,?)\", (stmt) => stmt.bindBlob(2, val));\n  }\n  public updateBlob(rscName: WorkspaceResource.Name, val: Uint8Array): void {\n    this.validateResourceSize(val);\n    this.performWriteSql(rscName, \"INSERT INTO blobs(id,value) VALUES(?,?) ON CONFLICT(id) DO UPDATE SET value=excluded.value WHERE value!=excluded.value\", (stmt) => stmt.bindBlob(2, val));\n  }\n  public getBlobWriter(rscName: WorkspaceResource.Name): SQLiteDb.BlobIO {\n    return this.sqliteDb.withSqliteStatement(\"SELECT rowid from blobs WHERE id=?\", (stmt) => {\n      stmt.bindString(1, rscName);\n      const blobWriter = SQLiteDb.createBlobIO();\n      blobWriter.open(this.sqliteDb.nativeDb, { tableName: \"blobs\", columnName: \"value\", row: stmt.getValueInteger(0), writeable: true });\n      return blobWriter;\n    });\n  }\n  public removeBlob(rscName: WorkspaceResource.Name): void {\n    this.performWriteSql(rscName, \"DELETE FROM blobs WHERE id=?\");\n  }\n  public addFile(rscName: WorkspaceResource.Name, localFileName: LocalFileName, fileExt?: string): void {\n    EditableWorkspaceDbImpl.validateResourceName(rscName);\n    fileExt = fileExt ?? extname(localFileName);\n    if (fileExt?.[0] === \".\")\n      fileExt = fileExt.slice(1);\n    this.sqliteDb.nativeDb.embedFile({ name: rscName, localFileName, date: this.getFileModifiedTime(localFileName), fileExt });\n  }\n  public updateFile(rscName: WorkspaceResource.Name, localFileName: LocalFileName): void {\n    this.queryFileResource(rscName); // throws if not present\n    this.sqliteDb.nativeDb.replaceEmbeddedFile({ name: rscName, localFileName, date: this.getFileModifiedTime(localFileName) });\n  }\n  public removeFile(rscName: WorkspaceResource.Name): void {\n    const file = this.queryFileResource(rscName);\n    if (undefined === file)\n      throw new Error(`file resource \"${rscName}\" does not exist`);\n    if (file && fs.existsSync(file.localFileName))\n      fs.unlinkSync(file.localFileName);\n    this.sqliteDb.nativeDb.removeEmbeddedFile(rscName);\n  }\n}\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 { AccessToken, BeEvent, DbResult, OpenMode, Optional } from \"@itwin/core-bentley\";\r\nimport { IModelError, LocalDirName, LocalFileName } from \"@itwin/core-common\";\r\nimport { CloudSqlite } from \"../CloudSqlite\";\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\nimport type { IModelJsNative } from \"@bentley/imodeljs-native\";\r\n\r\n/* eslint-disable @typescript-eslint/naming-convention */\r\n// cspell:ignore rowid primarykey julianday\r\n\r\nfunction 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/** The Settings used by Workspace api\r\n * @beta\r\n */\r\nexport const WorkspaceSetting = {\r\n  Containers: \"cloud/containers\",\r\n  Databases: \"workspace/databases\",\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.ContainerAccessProps, \"accessToken\"> {\r\n    /** attempt to synchronize (i.e. call `checkForChanges`) this cloud container whenever it is connected to a cloud cache. Default=true */\r\n    syncOnConnect?: boolean;\r\n  }\r\n\r\n  /** A function to supply an [AccessToken]($bentley) for a `WorkspaceContainer`.\r\n   * @param props The properties of the WorkspaceContainer necessary to obtain the access token\r\n   * @returns a Promise that resolves to the AccessToken for the container.\r\n   */\r\n  export type TokenFunc = (props: Props) => Promise<AccessToken>;\r\n\r\n  export function 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    noLeadingOrTrailingSpaces(dbName, \"dbName\");\r\n  }\r\n\r\n  /**\r\n   * Validate that a WorkspaceContainer.Id is valid.\r\n   * The 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  export function 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  /** @internal */\r\n  export function 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  /**\r\n   * Parse the name stored in a WorkspaceContainer into the dbName and version number. A single WorkspaceContainer may hold\r\n   * many versions of the same WorkspaceDb. The name of the Db in the WorkspaceContainer is in the format \"name:version\". This\r\n   * function splits them into separate strings.\r\n   */\r\n  export function 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  /** Create a dbName for a WorkspaceDb from its base name and version. This will be in the format \"name:version\" */\r\n  export function makeDbFileName(dbName: WorkspaceDb.DbName, version?: WorkspaceDb.Version): WorkspaceDb.DbName {\r\n    return `${dbName}:${WorkspaceContainer.validateVersion(version)}`;\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  /** file extension for local WorkspaceDbs\r\n   * @internal\r\n   */\r\n  export const fileExt = \"itwin-workspace\";\r\n\r\n  /** construct a new instance of a WorkspaceDb */\r\n  export function construct(props: WorkspaceDb.Props, container: WorkspaceContainer): WorkspaceDb {\r\n    return new WorkspaceDbImpl(props, container);\r\n  }\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  /** the SQLiteDb for this WorkspaceDb*/\r\n  readonly sqliteDb: SQLiteDb;\r\n\r\n  open(): void;\r\n  close(): void;\r\n\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  /** Get a BlobIO reader for a blob WorkspaceResource.\r\n   * @note when finished, caller *must* call `close` on the BlobIO.\r\n   * @internal\r\n   */\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   * @returns a `CloudSqlite.CloudPrefetch` object that can be used to await and/or cancel the prefetch.\r\n   * @throws if this WorkspaceDb is not from a `CloudContainer`.\r\n   */\r\n  prefetch(opts?: CloudSqlite.PrefetchProps): CloudSqlite.CloudPrefetch;\r\n\r\n  /** @internal */\r\n  queryFileResource(rscName: WorkspaceResource.Name): { localFileName: LocalFileName, info: IModelJsNative.EmbedFileQuery } | undefined;\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  /** 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   * only for tests\r\n   * @internal */\r\n  testCloudCache?: CloudSqlite.CloudCache;\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\r\n  /** Get The CloudCache for cloud-based WorkspaceContainers */\r\n  getCloudCache(): CloudSqlite.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): WorkspaceContainer;\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;\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): WorkspaceDb;\r\n\r\n  /** Get an opened [[WorkspaceDb]] from a WorkspaceDb alias.\r\n   * @param dbAlias the database alias, resolved via [[resolveDatabase]].\r\n   */\r\n  getWorkspaceDb(dbAlias: WorkspaceDb.Name): Promise<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/** @beta */\r\nexport namespace Workspace {\r\n  /** @internal */\r\n  export function construct(settings: Settings, opts?: WorkspaceOpts): Workspace {\r\n    return new WorkspaceImpl(settings, opts);\r\n  }\r\n}\r\n\r\n/**\r\n * A WorkspaceContainer is a type of `CloudSqlite.CloudContainer` that holds WorkspaceDbs. Normally a WorkspaceContainer will hold (many versions of) a single WorkspaceDb.\r\n * Each version of a WorkspaceDb is treated as immutable after it is created and is stored in the WorkspaceContainer indefinitely. That means that\r\n * older versions of the WorkspaceDb may continue to be used, for example by archived projects. For programmers familiar with [NPM](https://www.npmjs.com/), this is conceptually\r\n * similar and versioning follows the same rules as NPM using [Semantic Versioning](https://semver.org/).\r\n * @note It is possible to store more than one WorkspaceDb in the same WorkspaceContainer, but access rights are administered per WorkspaceContainer.\r\n * That is, if a user has rights to access a WorkspaceContainer, that right 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  readonly cloudContainer?: CloudSqlite.CloudContainer;\r\n\r\n  /** @internal */\r\n  addWorkspaceDb(toAdd: WorkspaceDbImpl): void;\r\n\r\n  /**\r\n   * Find the appropriate version of a WorkspaceDb in this WorkspaceContainer based on the SemVer rule\r\n   * in the `WorkspaceDb.Props`.\r\n   * If no version satisfying the WorkspaceDb.Props rules exists, throws an exception.\r\n   */\r\n  resolveDbFileName(props: WorkspaceDb.Props): WorkspaceDb.DbFullName;\r\n\r\n  /**\r\n   * Create a copy of an existing [[WorkspaceDb]] in this WorkspaceContainer with a new version number. This function is used\r\n   * by administrator tools that modify Workspaces. This requires that 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   * @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 The copy actually shares all of the data with the original, but with copy-on-write if/when data in the new WorkspaceDb is modified.\r\n   */\r\n  makeNewVersion(fromProps: WorkspaceDb.Props, versionType: WorkspaceDb.VersionIncrement): Promise<{ oldName: WorkspaceDb.DbName, newName: WorkspaceDb.DbName }>;\r\n\r\n  /** find or open a WorkspaceDb from this WorkspaceContainer. */\r\n  getWorkspaceDb(props: WorkspaceDb.Props): WorkspaceDb;\r\n\r\n  /** Close and remove a currently opened [[WorkspaceDb]] from this Workspace. */\r\n  closeWorkspaceDb(container: WorkspaceDb): void;\r\n\r\n  /** Close this WorkspaceContainer. All currently opened WorkspaceDbs are dropped. */\r\n  close(): void;\r\n}\r\n\r\n/**\r\n * An editable [[WorkspaceDb]]. This is used only by tools to allow administrators to create and modify `WorkspaceDb`s.\r\n * For CloudSqlite Workspaces, the write token must be obtained before the methods in this interface may be used. Normally\r\n * only admins will have write access to Workspaces. Only one admin at at time may be editing a Workspace.\r\n * @beta\r\n */\r\nexport interface EditableWorkspaceDb extends WorkspaceDb {\r\n  createDb(version?: string): Promise<void>;\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  addString(rscName: WorkspaceResource.Name, val: string): void;\r\n\r\n  /** Update an existing string resource with a new value, or add it if it does not exist.\r\n   * @param rscName The name of the string resource.\r\n   * @param val The new value.\r\n   */\r\n  updateString(rscName: WorkspaceResource.Name, val: string): void;\r\n\r\n  /** Remove a string resource. */\r\n  removeString(rscName: WorkspaceResource.Name): void;\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  addBlob(rscName: WorkspaceResource.Name, val: Uint8Array): void;\r\n\r\n  /** Update an existing blob resource with a new value, or add it if it does not exist.\r\n   * @param rscName The name of the blob resource.\r\n   * @param val The new value.\r\n   */\r\n  updateBlob(rscName: WorkspaceResource.Name, val: Uint8Array): void;\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  getBlobWriter(rscName: WorkspaceResource.Name): SQLiteDb.BlobIO;\r\n\r\n  /** Remove a blob resource. */\r\n  removeBlob(rscName: WorkspaceResource.Name): void;\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  addFile(rscName: WorkspaceResource.Name, localFileName: LocalFileName, fileExt?: string): void;\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  updateFile(rscName: WorkspaceResource.Name, localFileName: LocalFileName): void;\r\n\r\n  /** Remove a file resource. */\r\n  removeFile(rscName: WorkspaceResource.Name): void;\r\n}\r\n\r\n/** @beta */\r\nexport namespace EditableWorkspaceDb {\r\n  /** construct a new instance of an EditableWorkspaceDb */\r\n  export function construct(props: WorkspaceDb.Props, container: WorkspaceContainer): EditableWorkspaceDb {\r\n    return new EditableWorkspaceDbImpl(props, container);\r\n  }\r\n  /** Create a new, empty, EditableWorkspaceDb file on the local filesystem for importing Workspace resources. */\r\n  export function createEmpty(fileName: LocalFileName) {\r\n    const db = new SQLiteDb();\r\n    IModelJsFs.recursiveMkDirSync(dirname(fileName));\r\n    db.createDb(fileName);\r\n    const timeStampCol = \"lastMod TIMESTAMP NOT NULL DEFAULT(julianday('now'))\";\r\n    db.executeSQL(`CREATE TABLE strings(id TEXT PRIMARY KEY NOT NULL,value TEXT,${timeStampCol})`);\r\n    db.executeSQL(`CREATE TABLE blobs(id TEXT PRIMARY KEY NOT NULL,value BLOB,${timeStampCol})`);\r\n    const createTrigger = (tableName: string) => {\r\n      db.executeSQL(`CREATE TRIGGER ${tableName}_timeStamp AFTER UPDATE ON ${tableName} WHEN old.lastMod=new.lastMod AND old.lastMod != julianday('now') BEGIN UPDATE ${tableName} SET lastMod=julianday('now') WHERE id=new.id; END`);\r\n    };\r\n    createTrigger(\"strings\");\r\n    createTrigger(\"blobs\");\r\n    db.closeDb(true);\r\n  }\r\n}\r\n\r\nclass WorkspaceImpl implements Workspace {\r\n  private _containers = new Map<WorkspaceContainer.Id, WorkspaceContainerImpl>();\r\n  public readonly containerDir: LocalDirName;\r\n  public readonly settings: Settings;\r\n  private _cloudCache?: CloudSqlite.CloudCache;\r\n  public getCloudCache(): CloudSqlite.CloudCache {\r\n    return this._cloudCache ??= CloudSqlite.CloudCaches.getCache({ cacheName: \"Workspace\", cacheSize: \"20G\" });\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._cloudCache = opts?.testCloudCache;\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: WorkspaceContainerImpl) {\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): WorkspaceContainer {\r\n    return this.findContainer(props.containerId) ?? new WorkspaceContainerImpl(this, props);\r\n  }\r\n\r\n  public getWorkspaceDbFromProps(dbProps: WorkspaceDb.Props, containerProps: WorkspaceContainer.Props): WorkspaceDb {\r\n    return this.getContainer(containerProps).getWorkspaceDb(dbProps);\r\n  }\r\n\r\n  public async getWorkspaceDb(dbAlias: string) {\r\n    const dbProps = this.resolveDatabase(dbAlias);\r\n    const props = this.resolveContainer(dbProps.containerName);\r\n    let container: WorkspaceContainer | undefined = this.findContainer(props.containerId);\r\n    if (undefined === container) {\r\n      props.accessToken = await CloudSqlite.requestToken(props);\r\n      container = this.getContainer(props);\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  }\r\n\r\n  public resolveContainer(containerName: string): WorkspaceContainer.Props {\r\n    const resolved = this.settings.resolveSetting<WorkspaceContainer.Props>(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\nclass WorkspaceContainerImpl implements WorkspaceContainer {\r\n  public readonly workspace: WorkspaceImpl;\r\n  public readonly filesDir: LocalDirName;\r\n  public readonly id: WorkspaceContainer.Id;\r\n\r\n  public readonly cloudContainer?: CloudSqlite.CloudContainer | undefined;\r\n  private _wsDbs = new Map<WorkspaceDb.DbName, WorkspaceDbImpl>();\r\n  public get dirName() { return join(this.workspace.containerDir, this.id); }\r\n\r\n  public constructor(workspace: WorkspaceImpl, props: WorkspaceContainer.Props) {\r\n    WorkspaceContainer.validateContainerId(props.containerId);\r\n    this.workspace = workspace;\r\n    this.id = props.containerId;\r\n\r\n    if (props.baseUri !== \"\")\r\n      this.cloudContainer = CloudSqlite.createCloudContainer({ accessToken: \"\", ...props });\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.getCloudCache());\r\n    if (false !== 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 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}.${WorkspaceDb.fileExt}`); // local file, versions not allowed\r\n\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 = WorkspaceContainer.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  public async makeNewVersion(fromProps: WorkspaceDb.Props, versionType: WorkspaceDb.VersionIncrement) {\r\n    const cloudContainer = this.cloudContainer;\r\n    if (undefined === cloudContainer)\r\n      throw new Error(\"versions require cloud containers\");\r\n\r\n    const oldName = this.resolveDbFileName(fromProps);\r\n    const oldDb = WorkspaceContainer.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 = WorkspaceContainer.makeDbFileName(oldDb.dbName, newVersion);\r\n    await cloudContainer.copyDatabase(oldName, newName);\r\n    return { oldName, newName };\r\n  }\r\n\r\n  public addWorkspaceDb(toAdd: WorkspaceDbImpl) {\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 WorkspaceDbImpl(props, this);\r\n    if (!db.isOpen)\r\n      db.open();\r\n    return db;\r\n  }\r\n\r\n  public closeWorkspaceDb(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\r\n/** Implementation of WorkspaceDb */\r\nclass WorkspaceDbImpl implements WorkspaceDb {\r\n  public readonly sqliteDb = new SQLiteDb();\r\n  public readonly dbName: WorkspaceDb.DbName;\r\n  public readonly container: WorkspaceContainer;\r\n  public readonly onClose = new BeEvent<() => void>();\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): { localFileName: LocalFileName, info: IModelJsNative.EmbedFileQuery } | undefined {\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    WorkspaceContainer.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.closeWorkspaceDb(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  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): CloudSqlite.CloudPrefetch {\r\n    const cloudContainer = this.container.cloudContainer;\r\n    if (cloudContainer === undefined)\r\n      throw new Error(\"no cloud container to prefetch\");\r\n    return CloudSqlite.startCloudPrefetch(cloudContainer, this.dbFileName, opts);\r\n  }\r\n}\r\n\r\nclass EditableWorkspaceDbImpl extends WorkspaceDbImpl implements EditableWorkspaceDb {\r\n  private static validateResourceName(name: WorkspaceResource.Name) {\r\n    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.${WorkspaceDb.fileExt}`);\r\n      if (fs.existsSync(tempDbFile))\r\n        IModelJsFs.removeSync(tempDbFile);\r\n      EditableWorkspaceDb.createEmpty(tempDbFile);\r\n      this.dbFileName = WorkspaceContainer.makeDbFileName(this.dbName, version);\r\n      await CloudSqlite.uploadDb(this.container.cloudContainer, { localFileName: tempDbFile, dbName: this.dbFileName });\r\n      IModelJsFs.removeSync(tempDbFile);\r\n    }\r\n    this.open();\r\n  }\r\n\r\n  public addString(rscName: WorkspaceResource.Name, val: string): void {\r\n    EditableWorkspaceDbImpl.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  public updateString(rscName: WorkspaceResource.Name, val: string): void {\r\n    this.validateResourceSize(val);\r\n    this.performWriteSql(rscName, \"INSERT INTO strings(id,value) VALUES(?,?) ON CONFLICT(id) DO UPDATE SET value=excluded.value WHERE value!=excluded.value\", (stmt) => stmt.bindString(2, val));\r\n  }\r\n  public removeString(rscName: WorkspaceResource.Name): void {\r\n    this.performWriteSql(rscName, \"DELETE FROM strings WHERE id=?\");\r\n  }\r\n  public addBlob(rscName: WorkspaceResource.Name, val: Uint8Array): void {\r\n    EditableWorkspaceDbImpl.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  public updateBlob(rscName: WorkspaceResource.Name, val: Uint8Array): void {\r\n    this.validateResourceSize(val);\r\n    this.performWriteSql(rscName, \"INSERT INTO blobs(id,value) VALUES(?,?) ON CONFLICT(id) DO UPDATE SET value=excluded.value WHERE value!=excluded.value\", (stmt) => stmt.bindBlob(2, val));\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  public removeBlob(rscName: WorkspaceResource.Name): void {\r\n    this.performWriteSql(rscName, \"DELETE FROM blobs WHERE id=?\");\r\n  }\r\n  public addFile(rscName: WorkspaceResource.Name, localFileName: LocalFileName, fileExt?: string): void {\r\n    EditableWorkspaceDbImpl.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  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  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": "4.7.0-dev.8",
+  "version": "4.8.0-dev.0",
   "description": "iTwin.js backend components",
   "main": "lib/cjs/core-backend.js",
   "typings": "lib/cjs/core-backend",
@@ -25,9 +25,9 @@
     "url": "http://www.bentley.com"
   },
   "peerDependencies": {
-    "@itwin/core-bentley": "^4.7.0-dev.8",
-    "@itwin/core-common": "^4.7.0-dev.8",
-    "@itwin/core-geometry": "^4.7.0-dev.8",
+    "@itwin/core-bentley": "^4.8.0-dev.0",
+    "@itwin/core-common": "^4.8.0-dev.0",
+    "@itwin/core-geometry": "^4.8.0-dev.0",
     "@opentelemetry/api": "^1.0.4"
   },
   "peerDependenciesMeta": {
@@ -69,16 +69,16 @@
     "ts-node": "^10.8.2",
     "typescript": "~5.3.3",
     "webpack": "^5.76.0",
-    "@itwin/build-tools": "4.7.0-dev.8",
-    "@itwin/core-geometry": "4.7.0-dev.8",
-    "@itwin/core-bentley": "4.7.0-dev.8",
-    "@itwin/ecsql-common": "4.7.0-dev.8",
-    "@itwin/core-common": "4.7.0-dev.8",
-    "@itwin/core-webpack-tools": "4.7.0-dev.8",
+    "@itwin/build-tools": "4.8.0-dev.0",
+    "@itwin/core-geometry": "4.8.0-dev.0",
+    "@itwin/core-bentley": "4.8.0-dev.0",
+    "@itwin/core-common": "4.8.0-dev.0",
+    "@itwin/ecsql-common": "4.8.0-dev.0",
+    "@itwin/core-webpack-tools": "4.8.0-dev.0",
     "internal-tools": "3.0.0-dev.69"
   },
   "dependencies": {
-    "@bentley/imodeljs-native": "4.7.9",
+    "@bentley/imodeljs-native": "4.7.22",
     "@itwin/cloud-agnostic-core": "^2.1.0",
     "@itwin/object-storage-azure": "^2.2.2",
     "@itwin/object-storage-core": "^2.2.2",
@@ -91,7 +91,7 @@
     "semver": "^7.3.5",
     "touch": "^3.1.0",
     "ws": "^7.5.3",
-    "@itwin/core-telemetry": "4.7.0-dev.8"
+    "@itwin/core-telemetry": "4.8.0-dev.0"
   },
   "nyc": {
     "extends": "./node_modules/@itwin/build-tools/.nycrc"