@itwin/core-backend 3.0.0-dev.98 → 3.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"Settings.js","sourceRoot":"","sources":["../../../src/workspace/Settings.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Workspace\r\n */\r\n\r\nimport * as fs from \"fs-extra\";\r\nimport { parse } from \"json5\";\r\nimport { BeEvent, JSONSchemaType } from \"@itwin/core-bentley\";\r\nimport { LocalFileName } from \"@itwin/core-common\";\r\n\r\n/** The type of a Setting, according to its schema\r\n * @beta\r\n */\r\nexport type SettingType = JSONSchemaType;\r\n\r\n/**\r\n * The name of a Setting. SettingNames must be valid JavaScript property names, defined in a [[SettingSpec]].\r\n * @see [SettingName]($docs/learning/backend/Workspace#settingnames)\r\n * @beta\r\n */\r\nexport type SettingName = string;\r\n\r\n/** The name of a [[SettingDictionary]]. `SettingDictionary`s are stored in [[Settings]] and may be removed by DictionaryName.\r\n * DictionaryNames must be valid JavaScript property names.\r\n * @beta\r\n */\r\nexport type DictionaryName = string;\r\n\r\n/**\r\n * A function called by [[Settings.resolveSetting]] for every SettingDictionary with a Setting that matches a name. The\r\n * SettingDictionaries are sorted by priority and this function is called in priority order with the highest priority first.\r\n * When this function returns a non-undefined value, the iteration is stopped and that value is returned. In this way,\r\n * applications can \"combine\" the prioritized Setting values as appropriate. The default implementation of this function\r\n * used by [[Settings.getSetting]] merely returns a clone of the value the first time it is called, so the highest priority\r\n * value is returned.\r\n * @beta\r\n */\r\nexport type SettingResolver<T> = (val: T, dict: DictionaryName, priority: SettingsPriority) => T | undefined;\r\n\r\n/** An entry in the array returned by [[Settings.inspectSetting]]\r\n * @beta\r\n *\r\n */\r\nexport interface SettingInspector<T> { value: T, dictionary: DictionaryName, priority: number }\r\n\r\n/** An object with string-named members (as opposed to an array object).\r\n * @beta\r\n */\r\nexport interface SettingObject {\r\n  [name: string]: SettingType;\r\n}\r\n\r\n/**\r\n * An object with Settings as its members. A SettingDictionary also has a name and generally comes from a parsed JSON file, but\r\n * may also be created in memory by applications\r\n * @beta\r\n */\r\nexport type SettingDictionary = SettingObject;\r\n\r\n/**\r\n * Values for SettingsPriority determine the sort order for Settings. Higher values take precedence over lower values.\r\n * @beta\r\n*/\r\nexport enum SettingsPriority {\r\n  /** values supplied default-settings files */\r\n  defaults = 100,\r\n  /** values supplied by applications at runtime */\r\n  application = 200,\r\n  /** values that apply to all iTwins for an organization. */\r\n  organization = 300,\r\n  /** values that apply to all iModels in an iTwin. */\r\n  iTwin = 400,\r\n  /** values that apply to a single iModel. */\r\n  iModel = 500,\r\n}\r\n\r\n/** The current set of Settings for a Workspace.\r\n * @beta\r\n */\r\nexport interface Settings {\r\n  /** @internal */\r\n  close(): void;\r\n\r\n  /** Event raised whenever a SettingsDictionary is added or removed. */\r\n  readonly onSettingsChanged: BeEvent<() => void>;\r\n\r\n  /** Add a SettingDictionary from a local settings file. The file should be in [JSON5](https://json5.org/) format. It is read\r\n   * and parsed and the fileName is used as the DictionaryName.\r\n   * @param fileName the name of a local settings file of the SettingDictionary. This becomes the DictionaryName.\r\n   * @param priority the SettingsPriority for the SettingDictionary\r\n   * @note If the SettingDictionary was previously added, the new content overrides the old content.\r\n   */\r\n  addFile(fileName: LocalFileName, priority: SettingsPriority): void;\r\n\r\n  /** Add a SettingDictionary from a JSON5 stringified string. The string is parsed and the resultant object is added as a SettingDictionary.\r\n   * @param dictionaryName the name of the SettingDictionary\r\n   * @param priority the SettingsPriority for the SettingDictionary\r\n   * @param settingsJson the JSON5 stringified string to be parsed.\r\n   * @note If the SettingDictionary was previously added, the new content overrides the old content.\r\n   */\r\n  addJson(dictionaryName: DictionaryName, priority: SettingsPriority, settingsJson: string): void;\r\n\r\n  /** Add a SettingDictionary object.\r\n   * @param dictionaryName the name of the SettingDictionary\r\n   * @param priority the SettingsPriority for the SettingDictionary\r\n   * @param settings the SettingDictionary object to be added.\r\n   * @note If the SettingDictionary was previously added, the new content overrides the old content.\r\n   */\r\n  addDictionary(dictionaryName: DictionaryName, priority: SettingsPriority, settings: SettingDictionary): void;\r\n\r\n  /** Remove a SettingDictionary by name. */\r\n  dropDictionary(dictionaryName: DictionaryName): void;\r\n\r\n  /**\r\n   * Resolve a setting, by name, using a SettingResolver.\r\n   * @param settingName The name of the setting to resolve\r\n   * @param resolver function to be called for each SettingDictionary with a matching Setting. Iteration stops when it returns a non-undefined value.\r\n   * @param defaultValue value returned if settingName is not present in any SettingDictionary or resolver never returned a value.\r\n   * @returns the resolved setting value.\r\n   */\r\n  resolveSetting<T extends SettingType>(settingName: SettingName, resolver: SettingResolver<T>, defaultValue?: T): T | undefined;\r\n  resolveSetting<T extends SettingType>(settingName: SettingName, resolver: SettingResolver<T>, defaultValue: T): T;\r\n\r\n  /** Get the highest priority setting for a SettingName.\r\n   * @param settingName The name of the setting\r\n   * @param defaultValue value returned if settingName is not present in any SettingDictionary.\r\n   * @note This method is generic on SettingType, but no type checking is actually performed at run time. So, if you\r\n   * use this method to get a setting with an expected type, but its value is a different type, the return type of this method will be wrong.\r\n   * You must always type check the result. Use the non-generic \"get\" methods (e.g. [[getString]]) if you only want the value\r\n   * if its type is correct.\r\n   */\r\n  getSetting<T extends SettingType>(settingName: SettingName, defaultValue?: T): T | undefined;\r\n\r\n  /** Get a string setting by SettingName.\r\n   * @param settingName The name of the setting\r\n   * @param defaultValue value returned if settingName is not present in any SettingDictionary, or if the highest priority setting is not a string.\r\n   */\r\n  getString(settingName: SettingName, defaultValue: string): string;\r\n  getString(settingName: SettingName, defaultValue?: string): string | undefined;\r\n\r\n  /** Get a boolean setting by SettingName.\r\n  * @param settingName The name of the setting\r\n  * @param defaultValue value returned if settingName is not present in any SettingDictionary, or if the highest priority setting is not a boolean.\r\n  */\r\n  getBoolean(settingName: SettingName, defaultValue: boolean): boolean;\r\n  getBoolean(settingName: SettingName, defaultValue?: boolean): boolean | undefined;\r\n\r\n  /** Get a number setting by SettingName.\r\n  * @param settingName The name of the setting\r\n  * @param defaultValue value returned if settingName is not present in any SettingDictionary, or if the highest priority setting is not a number.\r\n  */\r\n  getNumber(settingName: SettingName, defaultValue: number): number;\r\n  getNumber(settingName: SettingName): number | undefined;\r\n\r\n  /** Get an object setting by SettingName.\r\n  * @param settingName The name of the setting\r\n  * @param defaultValue value returned if settingName is not present in any SettingDictionary, or if the highest priority setting is not an object.\r\n  */\r\n  getObject<T extends object>(settingName: SettingName, defaultValue: T): T;\r\n  getObject<T extends object>(settingName: SettingName): T | undefined;\r\n\r\n  /** Get an array setting by SettingName.\r\n  * @param settingName The name of the setting\r\n  * @param defaultValue value returned if settingName is not present in any SettingDictionary, or if the highest priority setting is not an array.\r\n  */\r\n  getArray<T extends SettingType>(settingName: SettingName, defaultValue: Array<T>): Array<T>;\r\n  getArray<T extends SettingType>(settingName: SettingName): Array<T> | undefined;\r\n\r\n  /** Get an array of [[SettingInspector] objects, sorted in priority order, for all Settings that match a SettingName.\r\n   * @note this method is mainly for debugging and diagnostics.\r\n   */\r\n  inspectSetting<T extends SettingType>(name: SettingName): SettingInspector<T>[];\r\n}\r\n\r\n/** @internal */\r\nfunction deepClone<T extends SettingType>(obj: any): T {\r\n  if (!obj || typeof obj !== \"object\")\r\n    return obj;\r\n\r\n  const result = Array.isArray(obj) ? [] : {} as any;\r\n  Object.keys(obj).forEach((key: string) => {\r\n    const val = obj[key];\r\n    if (val && typeof val === \"object\") {\r\n      result[key] = deepClone(val);\r\n    } else {\r\n      result[key] = val;\r\n    }\r\n  });\r\n  return result;\r\n}\r\n\r\nclass SettingsDictionary {\r\n  public constructor(public readonly name: string, public readonly priority: SettingsPriority, public readonly settings: SettingDictionary) { }\r\n  public getSetting<T extends SettingType>(settingName: string): SettingType | undefined {\r\n    return this.settings[settingName] as T | undefined;\r\n  }\r\n}\r\n\r\n/**\r\n * Internal implementation of Settings interface.\r\n * @internal\r\n */\r\nexport class BaseSettings implements Settings {\r\n  private _dictionaries: SettingsDictionary[] = [];\r\n  protected verifyPriority(_priority: SettingsPriority) { }\r\n  public close() { }\r\n  public readonly onSettingsChanged = new BeEvent<() => void>();\r\n\r\n  public addFile(fileName: LocalFileName, priority: SettingsPriority) {\r\n    this.addJson(fileName, priority, fs.readFileSync(fileName, \"utf-8\"));\r\n  }\r\n\r\n  public addJson(dictionaryName: string, priority: SettingsPriority, settingsJson: string) {\r\n    this.addDictionary(dictionaryName, priority, parse(settingsJson));\r\n  }\r\n\r\n  public addDictionary(dictionaryName: string, priority: SettingsPriority, settings: SettingDictionary) {\r\n    this.verifyPriority(priority);\r\n    this.dropDictionary(dictionaryName, false); // make sure we don't have the same dictionary twice\r\n    const file = new SettingsDictionary(dictionaryName, priority, settings);\r\n    const doAdd = () => {\r\n      for (let i = 0; i < this._dictionaries.length; ++i) {\r\n        if (this._dictionaries[i].priority <= file.priority) {\r\n          this._dictionaries.splice(i, 0, file);\r\n          return;\r\n        }\r\n      }\r\n      this._dictionaries.push(file);\r\n    };\r\n    doAdd();\r\n    this.onSettingsChanged.raiseEvent();\r\n  }\r\n\r\n  public dropDictionary(dictionaryName: DictionaryName, raiseEvent = true) {\r\n    for (let i = 0; i < this._dictionaries.length; ++i) {\r\n      if (this._dictionaries[i].name === dictionaryName) {\r\n        this._dictionaries.splice(i, 1);\r\n        if (raiseEvent)\r\n          this.onSettingsChanged.raiseEvent();\r\n        return true;\r\n      }\r\n    }\r\n    return false;\r\n  }\r\n\r\n  public resolveSetting<T extends SettingType>(name: SettingName, resolver: SettingResolver<T>, defaultValue?: T): T | undefined {\r\n    for (const dict of this._dictionaries) {\r\n      const val = dict.getSetting(name) as T | undefined;\r\n      const resolved = val && resolver(val, dict.name, dict.priority);\r\n      if (undefined !== resolved)\r\n        return resolved;\r\n    }\r\n    return defaultValue;\r\n  }\r\n\r\n  public getSetting<T extends SettingType>(name: SettingName, defaultValue?: T): T | undefined {\r\n    return this.resolveSetting(name, (val) => deepClone<T>(val)) ?? defaultValue;\r\n  }\r\n\r\n  /** for debugging. Returns an array of all values for a setting, sorted by priority.\r\n   * @note values are not cloned. Do not modify objects or arrays.\r\n   */\r\n  public inspectSetting<T extends SettingType>(name: SettingName): SettingInspector<T>[] {\r\n    const all: SettingInspector<T>[] = [];\r\n    this.resolveSetting<T>(name, (value, dictionary, priority) => { all.push({ value, dictionary, priority }); return undefined; });\r\n    return all;\r\n  }\r\n\r\n  public getString(name: SettingName, defaultValue: string): string;\r\n  public getString(name: SettingName): string | undefined;\r\n  public getString(name: SettingName, defaultValue?: string): string | undefined {\r\n    const out = this.getSetting<string>(name);\r\n    return typeof out === \"string\" ? out : defaultValue;\r\n  }\r\n  public getBoolean(name: SettingName, defaultValue: boolean): boolean;\r\n  public getBoolean(name: SettingName): boolean | undefined;\r\n  public getBoolean(name: SettingName, defaultValue?: boolean): boolean | undefined {\r\n    const out = this.getSetting<boolean>(name);\r\n    return typeof out === \"boolean\" ? out : defaultValue;\r\n  }\r\n  public getNumber(name: SettingName, defaultValue: number): number;\r\n  public getNumber(name: SettingName): number | undefined;\r\n  public getNumber(name: SettingName, defaultValue?: number): number | undefined {\r\n    const out = this.getSetting<number>(name);\r\n    return typeof out === \"number\" ? out : defaultValue;\r\n  }\r\n  public getObject<T extends object>(name: SettingName, defaultValue: T): T;\r\n  public getObject<T extends object>(name: SettingName): T | undefined;\r\n  public getObject<T extends object>(name: SettingName, defaultValue?: T): T | undefined {\r\n    const out = this.getSetting<SettingObject>(name);\r\n    return typeof out === \"object\" ? out as T : defaultValue;\r\n  }\r\n  public getArray<T extends SettingType>(name: SettingName, defaultValue: Array<T>): Array<T>;\r\n  public getArray<T extends SettingType>(name: SettingName): Array<T> | undefined;\r\n  public getArray<T extends SettingType>(name: SettingName, defaultValue?: Array<T>): Array<T> | undefined {\r\n    const out = this.getSetting<Array<T>>(name);\r\n    return Array.isArray(out) ? out : defaultValue;\r\n  }\r\n}\r\n"]}

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

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

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

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

package/lib/cjs/workspace/SettingsSpecRegistry.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"SettingsSpecRegistry.js","sourceRoot":"","sources":["../../../src/workspace/SettingsSpecRegistry.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,+BAA+B;AAC/B,iCAA8B;AAC9B,sDAAuG;AA8BvG;;;;GAIG;AACH,MAAa,oBAAoB;IAC/B,gBAAwB,CAAC,CAAC,YAAY;IAOtC;;;OAGG;IACI,MAAM,CAAC,KAAK;QACjB,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,QAAQ,CAAC,aAAsD;QAC3E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC;YAC/B,aAAa,GAAG,CAAC,aAAa,CAAC,CAAC;QAElC,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;QACpC,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,CAAC;QACjC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,0DAA0D;IACnD,MAAM,CAAC,OAAO,CAAC,eAAuB;QAC3C,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAA,aAAK,EAAC,eAAe,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,qDAAqD;IAC9C,MAAM,CAAC,OAAO,CAAC,QAAgB;QACpC,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,mEAAmE;IAC5D,MAAM,CAAC,WAAW,CAAC,SAAiB;QACzC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACzB,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,CAAC;IACnC,CAAC;IAEO,MAAM,CAAC,KAAK,CAAC,aAAkC,EAAE,QAAmB;QAC1E,aAAa,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YAC9B,IAAI,SAAS,KAAK,KAAK,CAAC,SAAS;gBAC/B,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;YAEhD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YAC/B,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;YACrC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,MAAM,CAAC,QAAQ,CAAC,SAAiB;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,SAAS,MAAK,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,UAAU,CAAA,EAAE;YACnC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;gBAC7C,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;SAC7B;QACD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;IAEO,MAAM,CAAC,gBAAgB,CAAC,QAAgB;QAC9C,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE;YAClB,OAAO,qBAAqB,CAAC;QAC/B,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC;YAC7B,OAAO,aAAa,QAAQ,sBAAsB,CAAC;QAErD,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,MAAM,CAAC,cAAc,CAAC,KAAwB,EAAE,QAAmB;;QACzE,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;QACpC,IAAI,SAAS,KAAK,UAAU;YAC1B,OAAO;QAET,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE;YACzC,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;YAC3C,IAAI,OAAO,EAAE;gBACX,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,IAAI,CAAC,OAAO,CAAC,CAAC;gBACxB,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC;gBACvB,SAAS;aACV;YAED,MAAM,QAAQ,GAAyB,UAAU,CAAC,GAAG,CAAC,CAAC;YACvD,QAAQ,CAAC,OAAO,GAAG,MAAA,QAAQ,CAAC,OAAO,mCAAI,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC3E,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;SAClC;IACH,CAAC;IAEO,MAAM,CAAC,eAAe,CAAC,IAA+C;QAC5E,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC5C,QAAQ,IAAI,EAAE;YACZ,KAAK,SAAS;gBACZ,OAAO,KAAK,CAAC;YACf,KAAK,SAAS,CAAC;YACf,KAAK,QAAQ;gBACX,OAAO,CAAC,CAAC;YACX,KAAK,QAAQ;gBACX,OAAO,EAAE,CAAC;YACZ,KAAK,OAAO;gBACV,OAAO,EAAE,CAAC;YACZ,KAAK,QAAQ;gBACX,OAAO,EAAE,CAAC;YACZ;gBACE,OAAO,SAAS,CAAC;SACpB;IACH,CAAC;;AAlHH,oDAmHC;AAjHyB,+BAAU,GAAG,IAAI,GAAG,EAA6B,CAAC;AAC1E,+CAA+C;AACxB,6BAAQ,GAAG,IAAI,GAAG,EAAuB,CAAC;AACjE,mFAAmF;AAC5D,mCAAc,GAAG,IAAI,sBAAO,EAAc,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Workspace\r\n */\r\n\r\nimport * as fs from \"fs-extra\";\r\nimport { parse } from \"json5\";\r\nimport { BeEvent, JSONSchema, JSONSchemaType, JSONSchemaTypeName, Mutable } from \"@itwin/core-bentley\";\r\n\r\n/**\r\n * The properties of a Setting, used by the settings editor. This interface also includes the\r\n * default value if it is not specified in any Settings file.\r\n * This interface includes all members of [JSONSchema]($bentley) with the extensions added by VSCode.\r\n * @beta\r\n */\r\nexport interface SettingSpec extends Readonly<JSONSchema> {\r\n  type: JSONSchemaTypeName | JSONSchemaTypeName[];\r\n  /** labels for items of an enum. */\r\n  readonly enumItemLabels?: string[];\r\n  /** whether the editor should show multiple lines. */\r\n  readonly multilineEdit?: true;\r\n}\r\n\r\n/**\r\n * The properties of a group of [[SettingSpec]]s for an application. Groups can be added and removed from the registry\r\n * and are identified by their (required) `groupName` member\r\n * @beta\r\n */\r\nexport interface SettingsGroupSpec {\r\n  readonly groupName: string;\r\n  readonly properties: { [name: string]: SettingSpec };\r\n  readonly order?: number;\r\n  readonly title?: string;\r\n  readonly description?: string;\r\n  readonly extensionId?: string;\r\n}\r\n\r\n/**\r\n * The registry of available [[SettingsGroupSpec]]s.\r\n * The registry is used for editing Settings files and for finding default values for settings.\r\n * @beta\r\n */\r\nexport class SettingsSpecRegistry {\r\n  private constructor() { } // singleton\r\n  private static readonly _allGroups = new Map<string, SettingsGroupSpec>();\r\n  /** a map of all registered [[SettingSpec]]s */\r\n  public static readonly allSpecs = new Map<string, SettingSpec>();\r\n  /** event that signals that the values in [[allSpecs]] have changed in some way. */\r\n  public static readonly onSpecsChanged = new BeEvent<() => void>();\r\n\r\n  /** Clear the contents of the registry and remove all event listeners.\r\n   * @note This is really only necessary for tests of the Settings system.\r\n   * @internal\r\n   */\r\n  public static reset() {\r\n    this._allGroups.clear();\r\n    this.allSpecs.clear();\r\n    this.onSpecsChanged.clear();\r\n  }\r\n\r\n  /**\r\n   * Add one or more [[SettingsGroupSpec]]s to the registry. `SettingsGroupSpec`s must include a `groupName` member that is used\r\n   * to identify the group. If a group with the same name is already registered, the old values are first removed and then the new group is added.\r\n   * @returns an array of problems found adding properties of the supplied group(s).\r\n   */\r\n  public static addGroup(settingsGroup: SettingsGroupSpec | SettingsGroupSpec[]): string[] {\r\n    if (!Array.isArray(settingsGroup))\r\n      settingsGroup = [settingsGroup];\r\n\r\n    const problems: string[] = [];\r\n    this.doAdd(settingsGroup, problems);\r\n    this.onSpecsChanged.raiseEvent();\r\n    return problems;\r\n  }\r\n\r\n  /** Add a [[SettingsGroupSpec]] from stringified json5. */\r\n  public static addJson(settingSpecJson: string): string[] {\r\n    return this.addGroup(parse(settingSpecJson));\r\n  }\r\n\r\n  /** Add a [[SettingsGroupSpec]] from a json5 file. */\r\n  public static addFile(fileName: string): string[] {\r\n    return this.addJson(fs.readFileSync(fileName, \"utf-8\"));\r\n  }\r\n\r\n  /** Remove a previously added [[SettingsGroupSpec]] by groupName */\r\n  public static removeGroup(groupName: string): void {\r\n    this.doRemove(groupName);\r\n    this.onSpecsChanged.raiseEvent();\r\n  }\r\n\r\n  private static doAdd(settingsGroup: SettingsGroupSpec[], problems?: string[]) {\r\n    settingsGroup.forEach((group) => {\r\n      if (undefined === group.groupName)\r\n        throw new Error(\"settings group has no name\");\r\n\r\n      this.doRemove(group.groupName);\r\n      this.validateAndAdd(group, problems);\r\n      this._allGroups.set(group.groupName, group);\r\n    });\r\n  }\r\n\r\n  private static doRemove(groupName: string) {\r\n    const group = this._allGroups.get(groupName);\r\n    if (undefined !== group?.properties) {\r\n      for (const key of Object.keys(group.properties))\r\n        this.allSpecs.delete(key);\r\n    }\r\n    this._allGroups.delete(groupName);\r\n  }\r\n\r\n  private static validateProperty(property: string): string | undefined {\r\n    if (!property.trim())\r\n      return \"empty property name\";\r\n    if (this.allSpecs.has(property))\r\n      return `property \"${property}\" is already defined`;\r\n\r\n    return undefined;\r\n  }\r\n\r\n  private static validateAndAdd(group: SettingsGroupSpec, problems?: string[]) {\r\n    const properties = group.properties;\r\n    if (undefined === properties)\r\n      return;\r\n\r\n    for (const key of Object.keys(properties)) {\r\n      const problem = this.validateProperty(key);\r\n      if (problem) {\r\n        problems?.push(problem);\r\n        delete properties[key];\r\n        continue;\r\n      }\r\n\r\n      const property: Mutable<SettingSpec> = properties[key];\r\n      property.default = property.default ?? this.getDefaultValue(property.type);\r\n      this.allSpecs.set(key, property);\r\n    }\r\n  }\r\n\r\n  private static getDefaultValue(type: JSONSchemaTypeName | JSONSchemaTypeName[]): JSONSchemaType | undefined {\r\n    type = Array.isArray(type) ? type[0] : type;\r\n    switch (type) {\r\n      case \"boolean\":\r\n        return false;\r\n      case \"integer\":\r\n      case \"number\":\r\n        return 0;\r\n      case \"string\":\r\n        return \"\";\r\n      case \"array\":\r\n        return [];\r\n      case \"object\":\r\n        return {};\r\n      default:\r\n        return undefined;\r\n    }\r\n  }\r\n}\r\n"]}

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

@@ -0,0 +1,306 @@
+/** @packageDocumentation
+ * @module Workspace
+ */
+import { CloudSqlite, IModelJsNative } from "@bentley/imodeljs-native";
+import { BeEvent, Optional } from "@itwin/core-bentley";
+import { LocalDirName, LocalFileName } from "@itwin/core-common";
+import { SQLiteDb } from "../SQLiteDb";
+import { Settings, SettingsPriority } from "./Settings";
+/**
+ * The name of a WorkspaceContainer. This is the user-supplied name of a WorkspaceContainer, used to specify its *purpose* within a workspace.
+ * WorkspaceContainerName can be "aliased" by `WorkspaceSetting.containerAlias` settings so that "resolved" [[WorkspaceContainerId]] that supplies
+ * the actual WorkspaceContainer for a WorkspaceContainerName may vary. Also note that more than one WorkspaceContainerName may resolve to the same
+ * WorkspaceContainerId, if multiple purposes are served by the same WorkspaceContainer.
+ * @note there are no constraints on the contents or length of `WorkspaceContainerName`s, although short descriptive names are recommended.
+ * However, when no alias exists in WorkspaceSetting.containerAlias for a WorkspaceContainerName, then the WorkspaceContainerName becomes
+ * the WorkspaceContainerId, and the constraints on WorkspaceContainerId apply.
+ * @beta
+ */
+export declare type WorkspaceContainerName = string;
+/**
+ * The unique identifier of a WorkspaceContainer. This becomes the base name for the local directory holding the WorkspaceDbs from a WorkspaceContainer.
+ * `WorkspaceContainerName`s are resolved to WorkspaceContainerId through `WorkspaceSetting.containerAlias` settings,
+ * so users may not recognize the actual WorkspaceContainerId supplying resources for a WorkspaceDbName.
+ *
+ * `WorkspaceContainerId`s :
+ *  - may only contain lower case letters, numbers or dashes
+ *  - may not start or end with with a dash
+ *  - be shorter than 3 or longer than 63 characters
+ * @beta
+ */
+export declare type WorkspaceContainerId = string;
+/** The name of a WorkspaceDb within a WorkspaceContainer.
+ * @beta
+ */
+export declare type WorkspaceDbName = string;
+/**
+ * The version name for a WorkspaceDb. More than one version of a WorkspaceDb may be stored in the same WorkspaceContainer. This
+ * string identifies a specific version.
+ * @beta
+ */
+export declare type WorkspaceDbVersion = string;
+/**
+ * The name for identifying WorkspaceResources in a [[WorkspaceDb]].
+ * * `WorkspaceResourceName`s may not:
+ *  - be blank or start or end with a space
+ *  - be longer than 1024 characters
+ * @note a single WorkspaceDb may hold WorkspaceResources of type 'blob', 'string' and 'file', all with the same WorkspaceResourceName.
+ * @beta
+ */
+export declare type WorkspaceResourceName = string;
+/** supply either container name of id, not both
+ * @beta
+ */
+export declare type ContainerNameOrId = {
+    containerName: WorkspaceContainerName;
+    containerId?: never;
+} | {
+    containerId: WorkspaceContainerId;
+    containerName?: never;
+};
+/**
+ * Properties that specify a WorkspaceContainer.
+ * This can either be a WorkspaceContainerName or a WorkspaceContainerId. If id is supplied,
+ * it is used directly. Otherwise name must be resolved via [[Workspace.resolveContainerId]].
+ * @beta
+ */
+export declare type WorkspaceContainerProps = ContainerNameOrId & {
+    cloudProps?: CloudSqlite.TransferProps;
+};
+/** Properties of a WorkspaceDb
+ * @beta
+ */
+export declare type WorkspaceDbProps = WorkspaceContainerProps & {
+    /** the name of the WorkspaceDb */
+    dbName: WorkspaceDbName;
+};
+/** Properties that specify a WorkspaceResource within a WorkspaceDb.
+ * @beta
+ */
+export declare type WorkspaceResourceProps = WorkspaceDbProps & {
+    /** the name of the resource within [[db]] */
+    rscName: WorkspaceResourceName;
+};
+/**
+ * A WorkspaceDb holds workspace resources. `WorkspaceDb`s may just be local files, or they may be  stored and
+ * synchronized in WorkspaceContainers. Each `WorkspaceResource` in a WorkspaceDb is  identified by a [[WorkspaceResourceName]].
+ * Resources of type `string` and `blob` may be loaded directly from the `WorkspaceDb`. Resources of type `file` are
+ * copied from the WorkspaceDb into a temporary local file so they can be accessed directly.
+ * @beta
+ */
+export interface WorkspaceDb {
+    readonly container: WorkspaceContainer;
+    /** The WorkspaceDbName of this WorkspaceDb. */
+    readonly dbName: WorkspaceDbName;
+    /** event raised when this WorkspaceDb is closed. */
+    readonly onClosed: BeEvent<() => void>;
+    /** The name of the local file for holding this WorkspaceDb. */
+    readonly localFile: LocalDirName;
+    /** Get a string resource from this WorkspaceDb, if present. */
+    getString(rscName: WorkspaceResourceName): string | undefined;
+    /** Get a blob resource from this WorkspaceDb, if present. */
+    getBlob(rscName: WorkspaceResourceName): Uint8Array | undefined;
+    /** @internal */
+    getBlobReader(rscName: WorkspaceResourceName): IModelJsNative.BlobIO;
+    /** Extract a local copy of a file resource from this WorkspaceDb, if present.
+     * @param rscName The name of the file resource in the WorkspaceDb
+     * @param targetFileName optional name for extracted file. Some applications require files in specific locations or filenames. If
+     * you know the full path to use for the extracted file, you can supply it. Generally, it is best to *not* supply the filename and
+     * keep the extracted files in the  container filesDir.
+     * @returns the full path to a file on the local filesystem.
+     * @note The file is copied from the file into the local filesystem so it may be accessed directly. This happens only
+     * as necessary, if the local file doesn't exist, or if it is out-of-date because it was updated in the file.
+     * For this reason, you should not save the local file name, and instead call this method every time you access it, so its
+     * content is always holds the correct version.
+     * @note The filename will be a hash value, not the resource name.
+     * @note Workspace resource files are set readonly as they are copied from the file.
+     * To edit them, you must first copy them to another location.
+     */
+    getFile(rscName: WorkspaceResourceName, targetFileName?: LocalFileName): LocalFileName | undefined;
+}
+/**
+ * Options for constructing a [[Workspace]].
+ * @beta
+ */
+export interface WorkspaceOpts {
+    /** The local directory for the WorkspaceDb files. The [[Workspace]] will (only) look in this directory
+     * for files named `${this.containerId}/${this.dbId}.itwin-workspace`.
+     * @note if not supplied, defaults to `iTwin/Workspace` in the user-local folder.
+     */
+    containerDir?: LocalDirName;
+}
+/**
+ * Settings and resources that customize an application for the current session.
+ * See [Workspaces]($docs/learning/backend/Workspace)
+ * @beta
+ */
+export interface Workspace {
+    /** The local directory for the WorkspaceDb files with the name `${containerId}.itwin-workspace`. */
+    readonly containerDir: LocalDirName;
+    /** The [[Settings]] for this Workspace */
+    readonly settings: Settings;
+    getContainer(props: WorkspaceContainerProps): WorkspaceContainer;
+    /**
+     * Resolve a WorkspaceContainerProps to a WorkspaceContainerId. If props is an object with an `id` member, that value is returned unchanged.
+     * If it is a string, then the highest priority [[WorkspaceSetting.containerAlias]] setting with an entry for the WorkspaceContainerName
+     * is used. If no WorkspaceSetting.containerAlias entry for the WorkspaceContainerName can be found, the name is returned as the id.
+     */
+    resolveContainerId(props: WorkspaceContainerProps): WorkspaceContainerId;
+    /**
+     * Get an open [[WorkspaceDb]]. If the WorkspaceDb is present but not open, it is opened first.
+     * If `cloudProps` are supplied, and if container is not  present or not up-to-date, it is downloaded first.
+     * @returns a Promise that is resolved when the container is local, opened, and available for access.
+     */
+    getWorkspaceDb(props: WorkspaceDbProps): Promise<WorkspaceDb>;
+    /** Load a WorkspaceResource of type string, parse it, and add it to the current Settings for this Workspace.
+     * @note settingsRsc must specify a resource holding a stringified JSON representation of a [[SettingDictionary]]
+     * @returns a Promise that is resolved when the settings resource has been loaded.
+     */
+    loadSettingsDictionary(settingRsc: WorkspaceResourceProps, priority: SettingsPriority): Promise<void>;
+    /** Close this Workspace. All WorkspaceContainers are dropped. */
+    close(): void;
+}
+/** A WorkspaceContainer holds WorkspaceDbs.
+ * @beta
+ */
+export interface WorkspaceContainer {
+    readonly dirName: LocalDirName;
+    /** the local directory where this WorkspaceContainer will store temporary files extracted for file-resources. */
+    readonly filesDir: LocalDirName;
+    readonly id: WorkspaceContainerId;
+    readonly workspace: Workspace;
+    /** @internal */
+    addWorkspaceDb(toAdd: ITwinWorkspaceDb): void;
+    getWorkspaceDb(props: Optional<WorkspaceDbProps, "containerName">): Promise<WorkspaceDb>;
+    /** Close and remove a currently opened [[WorkspaceDb]] from this Workspace. */
+    dropWorkspaceDb(container: WorkspaceDb): void;
+    /** Close this WorkspaceContainer. All currently opened WorkspaceDbs are dropped. */
+    close(): void;
+}
+/** @internal */
+export declare class ITwinWorkspace implements Workspace {
+    private _containers;
+    readonly containerDir: LocalDirName;
+    readonly settings: Settings;
+    constructor(settings: Settings, opts?: WorkspaceOpts);
+    addContainer(toAdd: ITwinWorkspaceContainer): void;
+    getContainer(props: WorkspaceContainerProps): WorkspaceContainer;
+    getWorkspaceDb(props: WorkspaceDbProps): Promise<WorkspaceDb>;
+    loadSettingsDictionary(settingRsc: WorkspaceResourceProps, priority: SettingsPriority): Promise<void>;
+    close(): void;
+    resolveContainerId(props: WorkspaceContainerProps): WorkspaceContainerId;
+}
+/** @internal */
+export declare class ITwinWorkspaceContainer implements WorkspaceContainer {
+    readonly workspace: ITwinWorkspace;
+    readonly filesDir: LocalDirName;
+    readonly id: WorkspaceContainerId;
+    private _wsDbs;
+    get dirName(): string;
+    /** rules for ContainerIds (from Azure, see https://docs.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata)
+     *  - may only contain lower case letters, numbers or dashes
+     *  - may not start or end with with a dash nor have more than one dash in a row
+     *  - may not be shorter than 3 or longer than 63 characters
+     */
+    private static validateContainerId;
+    constructor(workspace: ITwinWorkspace, id: WorkspaceContainerId);
+    addWorkspaceDb(toAdd: ITwinWorkspaceDb): void;
+    getWorkspaceDb(props: Optional<WorkspaceDbProps, "containerName">): Promise<WorkspaceDb>;
+    dropWorkspaceDb(toDrop: WorkspaceDb): void;
+    close(): void;
+    purgeContainerFiles(): void;
+}
+/**
+ * A local file holding a WorkspaceDb.
+ * @beta
+ */
+export declare class ITwinWorkspaceDb implements WorkspaceDb {
+    readonly sqliteDb: SQLiteDb;
+    readonly dbName: WorkspaceDbName;
+    readonly container: WorkspaceContainer;
+    localFile: LocalFileName;
+    readonly onClosed: BeEvent<() => void>;
+    protected static noLeadingOrTrailingSpaces(name: string, msg: string): void;
+    private static validateDbName;
+    get isOpen(): boolean;
+    queryFileResource(rscName: WorkspaceResourceName): {
+        localFileName: string;
+        info: IModelJsNative.EmbedFileQuery;
+    } | undefined;
+    constructor(dbName: WorkspaceDbName, container: WorkspaceContainer);
+    open(): void;
+    close(): void;
+    getString(rscName: WorkspaceResourceName): string | undefined;
+    /** Get a BlobIO reader for a blob WorkspaceResource.
+     * @note when finished, caller must call `close` on the BlobIO.
+     */
+    getBlobReader(rscName: WorkspaceResourceName): IModelJsNative.BlobIO;
+    getBlob(rscName: WorkspaceResourceName): Uint8Array | undefined;
+    getFile(rscName: WorkspaceResourceName, targetFileName?: LocalFileName): LocalFileName | undefined;
+}
+/**
+ * An editable [[WorkspaceDb]]. This is used by administrators for creating and modifying `WorkspaceDb`s.
+ * For cloud-backed containers, the write token must be obtained before this class may be used. Only one user at at time
+ * may be editing.
+ * @beta
+ */
+export declare class EditableWorkspaceDb extends ITwinWorkspaceDb {
+    private _isCloudOpen;
+    private static validateResourceName;
+    private validateResourceSize;
+    open(): void;
+    close(): void;
+    private getFileModifiedTime;
+    private performWriteSql;
+    /** Create a new, empty, EditableWorkspaceDb for importing Workspace resources. */
+    create(): void;
+    static cloneVersion(oldVersion: WorkspaceDbVersion, newVersion: WorkspaceDbVersion, cloudProps: CloudSqlite.ContainerAccessProps): Promise<void>;
+    upload(cloudProps: CloudSqlite.TransferProps): Promise<void>;
+    /** Add a new string resource to this WorkspaceDb.
+     * @param rscName The name of the string resource.
+     * @param val The string to save.
+     */
+    addString(rscName: WorkspaceResourceName, val: string): void;
+    /** Update an existing string resource with a new value.
+     * @param rscName The name of the string resource.
+     * @param val The new value.
+     * @throws if rscName does not exist
+     */
+    updateString(rscName: WorkspaceResourceName, val: string): void;
+    /** Remove a string resource. */
+    removeString(rscName: WorkspaceResourceName): void;
+    /** Add a new blob resource to this WorkspaceDb.
+     * @param rscName The name of the blob resource.
+     * @param val The blob to save.
+     */
+    addBlob(rscName: WorkspaceResourceName, val: Uint8Array): void;
+    /** Update an existing blob resource with a new value.
+     * @param rscName The name of the blob resource.
+     * @param val The new value.
+     * @throws if rscName does not exist
+     */
+    updateBlob(rscName: WorkspaceResourceName, val: Uint8Array): void;
+    /** Get a BlobIO writer for a previously-added blob WorkspaceResource.
+     * @note after writing is complete, caller must call `close` on the BlobIO and must call `saveChanges` on the `db`.
+     */
+    getBlobWriter(rscName: WorkspaceResourceName): IModelJsNative.BlobIO;
+    /** Remove a blob resource. */
+    removeBlob(rscName: WorkspaceResourceName): void;
+    /** Copy the contents of an existing local file into this WorkspaceDb as a file resource.
+     * @param rscName The name of the file resource.
+     * @param localFileName The name of a local file to be read.
+     * @param fileExt The extension (do not include the leading ".") to be appended to the generated fileName
+     * when this WorkspaceDb is extracted from the WorkspaceDb. By default the characters after the last "." in `localFileName`
+     * are used. Pass this argument to override that.
+     */
+    addFile(rscName: WorkspaceResourceName, localFileName: LocalFileName, fileExt?: string): void;
+    /** Replace an existing file resource with the contents of a local file.
+     * @param rscName The name of the file resource.
+     * @param localFileName The name of a local file to be read.
+     * @throws if rscName does not exist
+     */
+    updateFile(rscName: WorkspaceResourceName, localFileName: LocalFileName): void;
+    /** Remove a file resource. */
+    removeFile(rscName: WorkspaceResourceName): void;
+}
+//# sourceMappingURL=Workspace.d.ts.map

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

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