@itwin/core-backend 5.8.0-dev.10 → 5.8.0-dev.12

package/lib/cjs/internal/workspace/SettingsImpl.js

@@ -7,18 +7,19 @@
  * @module Workspace
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SettingsImpl = void 0;
+exports.SettingsImpl = exports.dictionaryMatches = void 0;
 const fs = require("fs-extra");
 const json5_1 = require("json5");
 const path_1 = require("path");
 const core_bentley_1 = require("@itwin/core-bentley");
 const IModelJsFs_1 = require("../../IModelJsFs");
-const Settings_1 = require("../../workspace/Settings");
 const IModelHost_1 = require("../../IModelHost");
+const Settings_1 = require("../../workspace/Settings");
 const Symbols_1 = require("../Symbols");
 const dictionaryMatches = (d1, d2) => {
     return (d1.workspaceDb === d2.workspaceDb) && (d1.name === d2.name);
 };
+exports.dictionaryMatches = dictionaryMatches;
 class SettingsDictionaryImpl {
     [Symbols_1._implementationProhibited] = undefined;
     props;
@@ -31,6 +32,9 @@ class SettingsDictionaryImpl {
         const value = this.settings[settingName];
         return undefined !== value ? Settings_1.Setting.clone(value) : undefined;
     }
+    toJSON() {
+        return Settings_1.Setting.clone(this.settings);
+    }
 }
 /**
  * Internal implementation of Settings interface.
@@ -73,14 +77,14 @@ class SettingsImpl {
     }
     getDictionary(source) {
         for (const dictionary of this.dictionaries) {
-            if (dictionaryMatches(dictionary.props, source))
+            if ((0, exports.dictionaryMatches)(dictionary.props, source))
                 return dictionary;
         }
         return undefined;
     }
     dropDictionary(source, raiseEvent = true) {
         for (let i = 0; i < this.dictionaries.length; ++i) {
-            if (dictionaryMatches(this.dictionaries[i].props, source)) {
+            if ((0, exports.dictionaryMatches)(this.dictionaries[i].props, source)) {
                 this.dictionaries.splice(i, 1);
                 if (raiseEvent)
                     this.onSettingsChanged.raiseEvent();

package/lib/cjs/internal/workspace/SettingsImpl.js.map

@@ -1 +1 @@
-{"version":3,"file":"SettingsImpl.js","sourceRoot":"","sources":["../../../../src/internal/workspace/SettingsImpl.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 } from \"@itwin/core-bentley\";\r\nimport { LocalDirName, LocalFileName } from \"@itwin/core-common\";\r\nimport { IModelJsFs } from \"../../IModelJsFs\";\r\nimport { Setting, SettingName, Settings, SettingsContainer, SettingsDictionary, SettingsDictionaryProps, SettingsDictionarySource, SettingsPriority } from \"../../workspace/Settings\";\r\nimport { IModelHost } from \"../../IModelHost\";\r\nimport { _implementationProhibited } from \"../Symbols\";\r\n\r\nconst dictionaryMatches = (d1: SettingsDictionarySource, d2: SettingsDictionarySource): boolean => {\r\n  return (d1.workspaceDb === d2.workspaceDb) && (d1.name === d2.name);\r\n};\r\n\r\nclass SettingsDictionaryImpl implements SettingsDictionary {\r\n  public readonly [_implementationProhibited] = undefined;\r\n  public readonly props: SettingsDictionaryProps;\r\n  public readonly settings: SettingsContainer;\r\n\r\n  public constructor(props: SettingsDictionaryProps, settings: SettingsContainer) {\r\n    this.props = { ...props }; // make a copy so it can't be changed by caller\r\n    this.settings = settings;\r\n  }\r\n\r\n  public getSetting<T extends Setting>(settingName: string): T | undefined {\r\n    const value = this.settings[settingName] as T | undefined;\r\n    return undefined !== value ? Setting.clone(value) : undefined;\r\n  }\r\n}\r\n\r\n/**\r\n * Internal implementation of Settings interface.\r\n * @internal\r\n */\r\nexport class SettingsImpl implements Settings {\r\n  public readonly [_implementationProhibited] = undefined;\r\n  public 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({ name: fileName, priority }, fs.readFileSync(fileName, \"utf-8\"));\r\n  }\r\n\r\n  public addDirectory(dirName: LocalDirName, priority: SettingsPriority) {\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), priority);\r\n    }\r\n  }\r\n\r\n  public addJson(props: SettingsDictionaryProps, settingsJson: string) {\r\n    this.addDictionary(props, parse(settingsJson));\r\n  }\r\n\r\n  public addDictionary(props: SettingsDictionaryProps, settings: SettingsContainer) {\r\n    this.verifyPriority(props.priority);\r\n    this.dropDictionary(props, false); // make sure we don't have the same dictionary twice\r\n    const dict = new SettingsDictionaryImpl(props, settings);\r\n    const doAdd = () => {\r\n      for (let i = 0; i < this.dictionaries.length; ++i) {\r\n        if (this.dictionaries[i].props.priority <= dict.props.priority) {\r\n          this.dictionaries.splice(i, 0, dict);\r\n          return;\r\n        }\r\n      }\r\n      this.dictionaries.push(dict);\r\n    };\r\n    doAdd();\r\n    this.onSettingsChanged.raiseEvent();\r\n  }\r\n\r\n  public getDictionary(source: SettingsDictionarySource): SettingsDictionary | undefined {\r\n    for (const dictionary of this.dictionaries) {\r\n      if (dictionaryMatches(dictionary.props, source))\r\n        return dictionary;\r\n    }\r\n    return undefined;\r\n  }\r\n\r\n  public dropDictionary(source: SettingsDictionarySource, raiseEvent = true) {\r\n    for (let i = 0; i < this.dictionaries.length; ++i) {\r\n      if (dictionaryMatches(this.dictionaries[i].props, source)) {\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 * getSettingEntries<T extends Setting>(settingName: SettingName): Iterable<{ value: T, dictionary: SettingsDictionary}> {\r\n    for (const dictionary of this.dictionaries) {\r\n      const value = dictionary.getSetting<T>(settingName);\r\n      if (undefined !== value) {\r\n        yield { value, dictionary };\r\n      }\r\n    }\r\n  }\r\n\r\n  public * getSettingValues<T extends Setting>(settingName: SettingName): Iterable<T> {\r\n    for (const entry of this.getSettingEntries<T>(settingName)) {\r\n      yield entry.value;\r\n    }\r\n  }\r\n\r\n  public getSetting<T extends Setting>(settingName: SettingName, defaultValue?: T): T | undefined {\r\n    for (const value of this.getSettingValues<T>(settingName)) {\r\n      return value;\r\n    }\r\n\r\n    return defaultValue;\r\n  }\r\n\r\n  // get the setting and verify the result is either undefined or the correct type. If so, return it. Otherwise throw an exception.\r\n  private getResult<T extends Setting>(name: SettingName, expectedType: string) {\r\n    const out = this.getSetting<T>(name);\r\n    if (out === undefined || typeof out === expectedType)\r\n      return out;\r\n    throw new Error(`setting \"${name}\" is not a ${expectedType}: ${typeof out}`);\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    return this.getResult<string>(name, \"string\") ?? 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    return this.getResult<boolean>(name, \"boolean\") ?? 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    return this.getResult<number>(name, \"number\") ?? 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.getResult<T>(name, \"object\");\r\n    return out ? IModelHost.settingsSchemas.validateSetting(out, name) : defaultValue;\r\n  }\r\n  public getArray<T extends Setting>(name: SettingName, defaultValue: T[]): T[];\r\n  public getArray<T extends Setting>(name: SettingName): T[] | undefined;\r\n  public getArray<T extends Setting>(name: SettingName, defaultValue?: T[]): T[] | undefined {\r\n    if (IModelHost.settingsSchemas.settingDefs.get(name)?.combineArray) {\r\n      return this.getCombinedArray<T>(name, defaultValue);\r\n    }\r\n\r\n    const out = this.getSetting<T[]>(name);\r\n    if (out === undefined)\r\n      return defaultValue;\r\n    if (!Array.isArray(out))\r\n      throw new Error(`setting ${name} is not an array: ${String(out)}`);\r\n    return IModelHost.settingsSchemas.validateSetting(out, name);\r\n  }\r\n\r\n  private getCombinedArray<T extends Setting>(name: SettingName, defaultValue?: T[]): T[] | undefined {\r\n    let foundSetting = false;\r\n    const out: T[] = [];\r\n    for (const array of this.getSettingValues<T[]>(name)) {\r\n      foundSetting = true;\r\n\r\n      IModelHost.settingsSchemas.validateSetting(array, name);\r\n      for (const value of array) {\r\n        if (undefined === out.find((x) => Setting.areEqual(x, value))) {\r\n          out.push(value);\r\n        }\r\n      }\r\n    }\r\n\r\n    return foundSetting ? out : defaultValue;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"SettingsImpl.js","sourceRoot":"","sources":["../../../../src/internal/workspace/SettingsImpl.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,+BAA+B;AAC/B,iCAA8B;AAC9B,+BAAqC;AACrC,sDAA8C;AAE9C,iDAA8C;AAC9C,iDAA8C;AAC9C,uDAAsL;AACtL,wCAAuD;AAEhD,MAAM,iBAAiB,GAAG,CAAC,EAA4B,EAAE,EAA4B,EAAW,EAAE;IACvG,OAAO,CAAC,EAAE,CAAC,WAAW,KAAK,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC;AACtE,CAAC,CAAC;AAFW,QAAA,iBAAiB,qBAE5B;AAEF,MAAM,sBAAsB;IACV,CAAC,mCAAyB,CAAC,GAAG,SAAS,CAAC;IACxC,KAAK,CAA0B;IAC/B,QAAQ,CAAoB;IAE5C,YAAmB,KAA8B,EAAE,QAA2B;QAC5E,IAAI,CAAC,KAAK,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,+CAA+C;QAC1E,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAEM,UAAU,CAAoB,WAAmB;QACtD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAkB,CAAC;QAC1D,OAAO,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,kBAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAChE,CAAC;IAEM,MAAM;QACX,OAAO,kBAAO,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;CACF;AAED;;;GAGG;AACH,MAAa,YAAY;IACP,CAAC,mCAAyB,CAAC,GAAG,SAAS,CAAC;IACjD,YAAY,GAAyB,EAAE,CAAC;IACrC,cAAc,CAAC,SAA2B,IAAI,CAAC;IAClD,KAAK,KAAK,CAAC;IACF,iBAAiB,GAAG,IAAI,sBAAO,EAAc,CAAC;IAEvD,OAAO,CAAC,QAAuB,EAAE,QAA0B;QAChE,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IACjF,CAAC;IAEM,YAAY,CAAC,OAAqB,EAAE,QAA0B;QACnE,KAAK,MAAM,QAAQ,IAAI,uBAAU,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;YACvD,MAAM,GAAG,GAAG,IAAA,cAAO,EAAC,QAAQ,CAAC,CAAC;YAC9B,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,OAAO;gBACrC,IAAI,CAAC,OAAO,CAAC,IAAA,WAAI,EAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAEM,OAAO,CAAC,KAA8B,EAAE,YAAoB;QACjE,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,IAAA,aAAK,EAAC,YAAY,CAAC,CAAC,CAAC;IACjD,CAAC;IAEM,aAAa,CAAC,KAA8B,EAAE,QAA2B;QAC9E,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACpC,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,oDAAoD;QACvF,MAAM,IAAI,GAAG,IAAI,sBAAsB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACzD,MAAM,KAAK,GAAG,GAAG,EAAE;YACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;gBAClD,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;oBAC/D,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;oBACrC,OAAO;gBACT,CAAC;YACH,CAAC;YACD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC,CAAC;QACF,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,iBAAiB,CAAC,UAAU,EAAE,CAAC;IACtC,CAAC;IAEM,aAAa,CAAC,MAAgC;QACnD,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YAC3C,IAAI,IAAA,yBAAiB,EAAC,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC;gBAC7C,OAAO,UAAU,CAAC;QACtB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAEM,cAAc,CAAC,MAAgC,EAAE,UAAU,GAAG,IAAI;QACvE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;YAClD,IAAI,IAAA,yBAAiB,EAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;gBAC1D,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC/B,IAAI,UAAU;oBACZ,IAAI,CAAC,iBAAiB,CAAC,UAAU,EAAE,CAAC;gBACtC,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAEM,CAAE,iBAAiB,CAAoB,WAAwB;QACpE,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YAC3C,MAAM,KAAK,GAAG,UAAU,CAAC,UAAU,CAAI,WAAW,CAAC,CAAC;YACpD,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;gBACxB,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;YAC9B,CAAC;QACH,CAAC;IACH,CAAC;IAEM,CAAE,gBAAgB,CAAoB,WAAwB;QACnE,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,iBAAiB,CAAI,WAAW,CAAC,EAAE,CAAC;YAC3D,MAAM,KAAK,CAAC,KAAK,CAAC;QACpB,CAAC;IACH,CAAC;IAEM,UAAU,CAAoB,WAAwB,EAAE,YAAgB;QAC7E,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,gBAAgB,CAAI,WAAW,CAAC,EAAE,CAAC;YAC1D,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,iIAAiI;IACzH,SAAS,CAAoB,IAAiB,EAAE,YAAoB;QAC1E,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAI,IAAI,CAAC,CAAC;QACrC,IAAI,GAAG,KAAK,SAAS,IAAI,OAAO,GAAG,KAAK,YAAY;YAClD,OAAO,GAAG,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,cAAc,YAAY,KAAK,OAAO,GAAG,EAAE,CAAC,CAAC;IAC/E,CAAC;IAGM,SAAS,CAAC,IAAiB,EAAE,YAAqB;QACvD,OAAO,IAAI,CAAC,SAAS,CAAS,IAAI,EAAE,QAAQ,CAAC,IAAI,YAAY,CAAC;IAChE,CAAC;IAGM,UAAU,CAAC,IAAiB,EAAE,YAAsB;QACzD,OAAO,IAAI,CAAC,SAAS,CAAU,IAAI,EAAE,SAAS,CAAC,IAAI,YAAY,CAAC;IAClE,CAAC;IAGM,SAAS,CAAC,IAAiB,EAAE,YAAqB;QACvD,OAAO,IAAI,CAAC,SAAS,CAAS,IAAI,EAAE,QAAQ,CAAC,IAAI,YAAY,CAAC;IAChE,CAAC;IAGM,SAAS,CAAmB,IAAiB,EAAE,YAAgB;QACpE,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAI,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC9C,OAAO,GAAG,CAAC,CAAC,CAAC,uBAAU,CAAC,eAAe,CAAC,eAAe,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;IACpF,CAAC;IAGM,QAAQ,CAAoB,IAAiB,EAAE,YAAkB;QACtE,IAAI,uBAAU,CAAC,eAAe,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,CAAC;YACnE,OAAO,IAAI,CAAC,gBAAgB,CAAI,IAAI,EAAE,YAAY,CAAC,CAAC;QACtD,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAM,IAAI,CAAC,CAAC;QACvC,IAAI,GAAG,KAAK,SAAS;YACnB,OAAO,YAAY,CAAC;QACtB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,qBAAqB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrE,OAAO,uBAAU,CAAC,eAAe,CAAC,eAAe,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC/D,CAAC;IAEO,gBAAgB,CAAoB,IAAiB,EAAE,YAAkB;QAC/E,IAAI,YAAY,GAAG,KAAK,CAAC;QACzB,MAAM,GAAG,GAAQ,EAAE,CAAC;QACpB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,gBAAgB,CAAM,IAAI,CAAC,EAAE,CAAC;YACrD,YAAY,GAAG,IAAI,CAAC;YAEpB,uBAAU,CAAC,eAAe,CAAC,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YACxD,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;gBAC1B,IAAI,SAAS,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,kBAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;oBAC9D,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAClB,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC;IAC3C,CAAC;CACF;AA9ID,oCA8IC","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 } from \"@itwin/core-bentley\";\r\nimport { LocalDirName, LocalFileName } from \"@itwin/core-common\";\r\nimport { IModelJsFs } from \"../../IModelJsFs\";\r\nimport { IModelHost } from \"../../IModelHost\";\r\nimport { Setting, SettingName, Settings, SettingsContainer, SettingsDictionary, SettingsDictionaryProps, SettingsDictionarySource, SettingsPriority } from \"../../workspace/Settings\";\r\nimport { _implementationProhibited } from \"../Symbols\";\r\n\r\nexport const dictionaryMatches = (d1: SettingsDictionarySource, d2: SettingsDictionarySource): boolean => {\r\n  return (d1.workspaceDb === d2.workspaceDb) && (d1.name === d2.name);\r\n};\r\n\r\nclass SettingsDictionaryImpl implements SettingsDictionary {\r\n  public readonly [_implementationProhibited] = undefined;\r\n  public readonly props: SettingsDictionaryProps;\r\n  public readonly settings: SettingsContainer;\r\n\r\n  public constructor(props: SettingsDictionaryProps, settings: SettingsContainer) {\r\n    this.props = { ...props }; // make a copy so it can't be changed by caller\r\n    this.settings = settings;\r\n  }\r\n\r\n  public getSetting<T extends Setting>(settingName: string): T | undefined {\r\n    const value = this.settings[settingName] as T | undefined;\r\n    return undefined !== value ? Setting.clone(value) : undefined;\r\n  }\r\n\r\n  public toJSON(): SettingsContainer {\r\n    return Setting.clone(this.settings);\r\n  }\r\n}\r\n\r\n/**\r\n * Internal implementation of Settings interface.\r\n * @internal\r\n */\r\nexport class SettingsImpl implements Settings {\r\n  public readonly [_implementationProhibited] = undefined;\r\n  public 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({ name: fileName, priority }, fs.readFileSync(fileName, \"utf-8\"));\r\n  }\r\n\r\n  public addDirectory(dirName: LocalDirName, priority: SettingsPriority) {\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), priority);\r\n    }\r\n  }\r\n\r\n  public addJson(props: SettingsDictionaryProps, settingsJson: string) {\r\n    this.addDictionary(props, parse(settingsJson));\r\n  }\r\n\r\n  public addDictionary(props: SettingsDictionaryProps, settings: SettingsContainer) {\r\n    this.verifyPriority(props.priority);\r\n    this.dropDictionary(props, false); // make sure we don't have the same dictionary twice\r\n    const dict = new SettingsDictionaryImpl(props, settings);\r\n    const doAdd = () => {\r\n      for (let i = 0; i < this.dictionaries.length; ++i) {\r\n        if (this.dictionaries[i].props.priority <= dict.props.priority) {\r\n          this.dictionaries.splice(i, 0, dict);\r\n          return;\r\n        }\r\n      }\r\n      this.dictionaries.push(dict);\r\n    };\r\n    doAdd();\r\n    this.onSettingsChanged.raiseEvent();\r\n  }\r\n\r\n  public getDictionary(source: SettingsDictionarySource): SettingsDictionary | undefined {\r\n    for (const dictionary of this.dictionaries) {\r\n      if (dictionaryMatches(dictionary.props, source))\r\n        return dictionary;\r\n    }\r\n    return undefined;\r\n  }\r\n\r\n  public dropDictionary(source: SettingsDictionarySource, raiseEvent = true) {\r\n    for (let i = 0; i < this.dictionaries.length; ++i) {\r\n      if (dictionaryMatches(this.dictionaries[i].props, source)) {\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 * getSettingEntries<T extends Setting>(settingName: SettingName): Iterable<{ value: T, dictionary: SettingsDictionary}> {\r\n    for (const dictionary of this.dictionaries) {\r\n      const value = dictionary.getSetting<T>(settingName);\r\n      if (undefined !== value) {\r\n        yield { value, dictionary };\r\n      }\r\n    }\r\n  }\r\n\r\n  public * getSettingValues<T extends Setting>(settingName: SettingName): Iterable<T> {\r\n    for (const entry of this.getSettingEntries<T>(settingName)) {\r\n      yield entry.value;\r\n    }\r\n  }\r\n\r\n  public getSetting<T extends Setting>(settingName: SettingName, defaultValue?: T): T | undefined {\r\n    for (const value of this.getSettingValues<T>(settingName)) {\r\n      return value;\r\n    }\r\n\r\n    return defaultValue;\r\n  }\r\n\r\n  // get the setting and verify the result is either undefined or the correct type. If so, return it. Otherwise throw an exception.\r\n  private getResult<T extends Setting>(name: SettingName, expectedType: string) {\r\n    const out = this.getSetting<T>(name);\r\n    if (out === undefined || typeof out === expectedType)\r\n      return out;\r\n    throw new Error(`setting \"${name}\" is not a ${expectedType}: ${typeof out}`);\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    return this.getResult<string>(name, \"string\") ?? 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    return this.getResult<boolean>(name, \"boolean\") ?? 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    return this.getResult<number>(name, \"number\") ?? 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.getResult<T>(name, \"object\");\r\n    return out ? IModelHost.settingsSchemas.validateSetting(out, name) : defaultValue;\r\n  }\r\n  public getArray<T extends Setting>(name: SettingName, defaultValue: T[]): T[];\r\n  public getArray<T extends Setting>(name: SettingName): T[] | undefined;\r\n  public getArray<T extends Setting>(name: SettingName, defaultValue?: T[]): T[] | undefined {\r\n    if (IModelHost.settingsSchemas.settingDefs.get(name)?.combineArray) {\r\n      return this.getCombinedArray<T>(name, defaultValue);\r\n    }\r\n\r\n    const out = this.getSetting<T[]>(name);\r\n    if (out === undefined)\r\n      return defaultValue;\r\n    if (!Array.isArray(out))\r\n      throw new Error(`setting ${name} is not an array: ${String(out)}`);\r\n    return IModelHost.settingsSchemas.validateSetting(out, name);\r\n  }\r\n\r\n  private getCombinedArray<T extends Setting>(name: SettingName, defaultValue?: T[]): T[] | undefined {\r\n    let foundSetting = false;\r\n    const out: T[] = [];\r\n    for (const array of this.getSettingValues<T[]>(name)) {\r\n      foundSetting = true;\r\n\r\n      IModelHost.settingsSchemas.validateSetting(array, name);\r\n      for (const value of array) {\r\n        if (undefined === out.find((x) => Setting.areEqual(x, value))) {\r\n          out.push(value);\r\n        }\r\n      }\r\n    }\r\n\r\n    return foundSetting ? out : defaultValue;\r\n  }\r\n}\r\n"]}

package/lib/cjs/internal/workspace/SettingsSqliteDb.d.ts

@@ -0,0 +1,14 @@
+/** @packageDocumentation
+ * @module Workspace
+ */
+import { SQLiteDb, VersionedSqliteDb } from "../../SQLiteDb";
+/** A [[VersionedSqliteDb]] that stores settings dictionaries. Unlike [[WorkspaceSqliteDb]], the
+ * manifest is stored using [[settingsManifestProperty]] so that settings and workspace databases
+ * can coexist in the same container without ambiguity.
+ */
+export declare class SettingsSqliteDb extends VersionedSqliteDb {
+    myVersion: string;
+    getRequiredVersions(): SQLiteDb.RequiredVersionRanges;
+    protected createDDL(args: any): void;
+}
+//# sourceMappingURL=SettingsSqliteDb.d.ts.map

package/lib/cjs/internal/workspace/SettingsSqliteDb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SettingsSqliteDb.d.ts","sourceRoot":"","sources":["../../../../src/internal/workspace/SettingsSqliteDb.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAK7D;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,iBAAiB;IACrC,SAAS,SAAW;IACpB,mBAAmB,IAAI,QAAQ,CAAC,qBAAqB;cAUlD,SAAS,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI;CAO9C"}

package/lib/cjs/internal/workspace/SettingsSqliteDb.js

@@ -0,0 +1,40 @@
+"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.SettingsSqliteDb = void 0;
+const SQLiteDb_1 = require("../../SQLiteDb");
+const core_common_1 = require("@itwin/core-common");
+const Symbols_1 = require("../Symbols");
+const SettingsDbImpl_1 = require("./SettingsDbImpl");
+/** A [[VersionedSqliteDb]] that stores settings dictionaries. Unlike [[WorkspaceSqliteDb]], the
+ * manifest is stored using [[settingsManifestProperty]] so that settings and workspace databases
+ * can coexist in the same container without ambiguity.
+ */
+class SettingsSqliteDb extends SQLiteDb_1.VersionedSqliteDb {
+    myVersion = "1.0.0";
+    getRequiredVersions() {
+        try {
+            return super.getRequiredVersions();
+        }
+        catch (e) {
+            if (core_common_1.SqliteError.isError(e, "invalid-versions-property"))
+                return { readVersion: "^1", writeVersion: "^1" };
+            throw e;
+        }
+    }
+    createDDL(args) {
+        const timeStampCol = "lastMod TIMESTAMP NOT NULL DEFAULT(julianday('now'))";
+        this.executeSQL(`CREATE TABLE strings(id TEXT PRIMARY KEY NOT NULL,value TEXT,${timeStampCol})`);
+        this.executeSQL(`CREATE TRIGGER strings_timeStamp AFTER UPDATE ON strings WHEN old.lastMod=new.lastMod AND old.lastMod != julianday('now') BEGIN UPDATE strings SET lastMod=julianday('now') WHERE id=new.id; END`);
+        if (args?.manifest)
+            this[Symbols_1._nativeDb].saveFileProperty(SettingsDbImpl_1.settingsManifestProperty, JSON.stringify(args.manifest));
+    }
+}
+exports.SettingsSqliteDb = SettingsSqliteDb;
+//# sourceMappingURL=SettingsSqliteDb.js.map

package/lib/cjs/internal/workspace/SettingsSqliteDb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SettingsSqliteDb.js","sourceRoot":"","sources":["../../../../src/internal/workspace/SettingsSqliteDb.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,6CAA6D;AAC7D,oDAAiD;AACjD,wCAAuC;AACvC,qDAA4D;AAE5D;;;GAGG;AACH,MAAa,gBAAiB,SAAQ,4BAAiB;IACrC,SAAS,GAAG,OAAO,CAAC;IACpB,mBAAmB;QACjC,IAAI,CAAC;YACH,OAAO,KAAK,CAAC,mBAAmB,EAAE,CAAC;QACrC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,yBAAW,CAAC,OAAO,CAAC,CAAC,EAAE,2BAA2B,CAAC;gBACrD,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;YACnD,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC;IAEkB,SAAS,CAAC,IAAS;QACpC,MAAM,YAAY,GAAG,sDAAsD,CAAC;QAC5E,IAAI,CAAC,UAAU,CAAC,gEAAgE,YAAY,GAAG,CAAC,CAAC;QACjG,IAAI,CAAC,UAAU,CAAC,kMAAkM,CAAC,CAAC;QACpN,IAAI,IAAI,EAAE,QAAQ;YAChB,IAAI,CAAC,mBAAS,CAAC,CAAC,gBAAgB,CAAC,yCAAwB,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC9F,CAAC;CACF;AAnBD,4CAmBC","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 { SQLiteDb, VersionedSqliteDb } from \"../../SQLiteDb\";\r\nimport { SqliteError } from \"@itwin/core-common\";\r\nimport { _nativeDb } from \"../Symbols\";\r\nimport { settingsManifestProperty } from \"./SettingsDbImpl\";\r\n\r\n/** A [[VersionedSqliteDb]] that stores settings dictionaries. Unlike [[WorkspaceSqliteDb]], the\r\n * manifest is stored using [[settingsManifestProperty]] so that settings and workspace databases\r\n * can coexist in the same container without ambiguity.\r\n */\r\nexport class SettingsSqliteDb extends VersionedSqliteDb {\r\n  public override myVersion = \"1.0.0\";\r\n  public override getRequiredVersions(): SQLiteDb.RequiredVersionRanges {\r\n    try {\r\n      return super.getRequiredVersions();\r\n    } catch (e) {\r\n      if (SqliteError.isError(e, \"invalid-versions-property\"))\r\n        return { readVersion: \"^1\", writeVersion: \"^1\" };\r\n      throw e;\r\n    }\r\n  }\r\n\r\n  protected override createDDL(args: any): void {\r\n    const timeStampCol = \"lastMod TIMESTAMP NOT NULL DEFAULT(julianday('now'))\";\r\n    this.executeSQL(`CREATE TABLE strings(id TEXT PRIMARY KEY NOT NULL,value TEXT,${timeStampCol})`);\r\n    this.executeSQL(`CREATE TRIGGER strings_timeStamp AFTER UPDATE ON strings WHEN old.lastMod=new.lastMod AND old.lastMod != julianday('now') BEGIN UPDATE strings SET lastMod=julianday('now') WHERE id=new.id; END`);\r\n    if (args?.manifest)\r\n      this[_nativeDb].saveFileProperty(settingsManifestProperty, JSON.stringify(args.manifest));\r\n  }\r\n}\r\n"]}

package/lib/cjs/internal/workspace/WorkspaceImpl.d.ts

@@ -10,6 +10,7 @@ export declare const workspaceDbFileExt = "itwin-workspace";
 export declare function constructWorkspaceDb(props: WorkspaceDbProps, container: WorkspaceContainer): WorkspaceDb;
 export declare function constructWorkspace(settings: Settings, opts?: WorkspaceOpts): OwnedWorkspace;
 export declare function constructWorkspaceEditor(): WorkspaceEditor;
+export declare function constructSettingsEditorWorkspace(settings: Settings, opts?: WorkspaceOpts): OwnedWorkspace;
 /**
  * Validate that a WorkspaceContainer.Id is valid.
  * The rules for ContainerIds (from Azure, see https://docs.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata):

package/lib/cjs/internal/workspace/WorkspaceImpl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WorkspaceImpl.d.ts","sourceRoot":"","sources":["../../../../src/internal/workspace/WorkspaceImpl.ts"],"names":[],"mappings":"AAIA;;GAEG;AAMH,OAAO,EAAoB,iBAAiB,EAA+C,MAAM,oBAAoB,CAAC;AAMtH,OAAO,EAAe,QAAQ,EAAgE,MAAM,0BAA0B,CAAC;AAE/H,OAAO,EACsB,SAAS,EAAE,kBAAkB,EAAE,oBAAoB,EAA2B,WAAW,EAC/F,oBAAoB,EAA0F,gBAAgB,EAC1F,aAAa,EACvE,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAqH,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAUrL,4CAA4C;AAC5C,eAAO,MAAM,kBAAkB,oBAAoB,CAAC;AAqrBpD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,kBAAkB,GAAG,WAAW,CAExG;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,cAAc,CAE3F;AAED,wBAAgB,wBAAwB,IAAI,eAAe,CAE1D;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,oBAAoB,QAGpE;AAED,eAAO,MAAM,yBAAyB,EAAE,iBAAgE,CAAC;AAOzG,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,oBAAoB,EAAE,GAAG,KAAK,CAEvG;AAED,MAAM,WAAW,cAAe,SAAQ,SAAS;IAC/C,kDAAkD;IAClD,KAAK,IAAI,IAAI,CAAC;CACf"}
+{"version":3,"file":"WorkspaceImpl.d.ts","sourceRoot":"","sources":["../../../../src/internal/workspace/WorkspaceImpl.ts"],"names":[],"mappings":"AAIA;;GAEG;AAMH,OAAO,EAAoB,iBAAiB,EAA+C,MAAM,oBAAoB,CAAC;AAMtH,OAAO,EAAe,QAAQ,EAAgE,MAAM,0BAA0B,CAAC;AAG/H,OAAO,EACsB,SAAS,EAAE,kBAAkB,EAAE,oBAAoB,EAA2B,WAAW,EAC/F,oBAAoB,EAA0F,gBAAgB,EACtE,aAAa,EAC3F,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAqH,eAAe,EAAwC,MAAM,iCAAiC,CAAC;AAY3N,4CAA4C;AAC5C,eAAO,MAAM,kBAAkB,oBAAoB,CAAC;AA+tBpD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,kBAAkB,GAAG,WAAW,CAExG;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,cAAc,CAE3F;AAED,wBAAgB,wBAAwB,IAAI,eAAe,CAE1D;AAED,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,cAAc,CAEzG;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,oBAAoB,QAGpE;AAED,eAAO,MAAM,yBAAyB,EAAE,iBAAgE,CAAC;AAOzG,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,oBAAoB,EAAE,GAAG,KAAK,CAEvG;AAED,MAAM,WAAW,cAAe,SAAQ,SAAS;IAC/C,kDAAkD;IAClD,KAAK,IAAI,IAAI,CAAC;CACf"}

package/lib/cjs/internal/workspace/WorkspaceImpl.js

@@ -11,6 +11,7 @@ exports.workspaceManifestProperty = exports.workspaceDbFileExt = void 0;
 exports.constructWorkspaceDb = constructWorkspaceDb;
 exports.constructWorkspace = constructWorkspace;
 exports.constructWorkspaceEditor = constructWorkspaceEditor;
+exports.constructSettingsEditorWorkspace = constructSettingsEditorWorkspace;
 exports.validateWorkspaceContainerId = validateWorkspaceContainerId;
 exports.throwWorkspaceDbLoadErrors = throwWorkspaceDbLoadErrors;
 const crypto_1 = require("crypto");
@@ -23,12 +24,15 @@ const IModelHost_1 = require("../../IModelHost");
 const IModelJsFs_1 = require("../../IModelJsFs");
 const SQLiteDb_1 = require("../../SQLiteDb");
 const Settings_1 = require("../../workspace/Settings");
+const SettingsDb_1 = require("../../workspace/SettingsDb");
 const Workspace_1 = require("../../workspace/Workspace");
 const WorkspaceEditor_1 = require("../../workspace/WorkspaceEditor");
 const WorkspaceSqliteDb_1 = require("./WorkspaceSqliteDb");
+const SettingsDbImpl_1 = require("./SettingsDbImpl");
 const SettingsImpl_1 = require("./SettingsImpl");
 const Symbols_1 = require("../Symbols");
 const OnlineStatus_1 = require("../OnlineStatus");
+const BlobContainerService_1 = require("../../BlobContainerService");
 function workspaceDbNameWithDefault(dbName) {
     return dbName ?? "workspace-db";
 }
@@ -113,24 +117,25 @@ class WorkspaceContainerImpl {
         }
     }
     resolveDbFileName(props) {
+        const dbName = workspaceDbNameWithDefault(props.dbName);
         const container = this.cloudContainer;
         if (undefined === container)
-            return (0, path_1.join)(this.dirName, `${props.dbName}.${exports.workspaceDbFileExt}`); // local file, versions not allowed
-        return CloudSqlite_1.CloudSqlite.querySemverMatch({ ...props, container, dbName: workspaceDbNameWithDefault(props.dbName) });
+            return (0, path_1.join)(this.dirName, `${dbName}.${exports.workspaceDbFileExt}`); // local file, versions not allowed
+        return CloudSqlite_1.CloudSqlite.querySemverMatch({ ...props, container, dbName });
     }
     addWorkspaceDb(toAdd) {
-        if (undefined !== this._wsDbs.get(toAdd.dbName))
+        if (undefined !== this._wsDbs.get(toAdd.dbFileName))
             core_common_1.WorkspaceError.throwError("already-exists", { message: `workspaceDb '${toAdd.dbName}' already exists in workspace` });
-        this._wsDbs.set(toAdd.dbName, toAdd);
+        this._wsDbs.set(toAdd.dbFileName, toAdd);
     }
     getWorkspaceDb(props) {
-        return this._wsDbs.get(workspaceDbNameWithDefault(props?.dbName)) ?? new WorkspaceDbImpl(props ?? {}, this);
+        const dbFileName = this.resolveDbFileName(props ?? {});
+        return this._wsDbs.get(dbFileName) ?? new WorkspaceDbImpl(props ?? {}, this);
     }
     closeWorkspaceDb(toDrop) {
-        const name = toDrop.dbName;
-        const wsDb = this._wsDbs.get(name);
+        const wsDb = this._wsDbs.get(toDrop.dbFileName);
         if (wsDb === toDrop) {
-            this._wsDbs.delete(name);
+            this._wsDbs.delete(toDrop.dbFileName);
             wsDb.close();
         }
     }
@@ -321,6 +326,15 @@ class WorkspaceImpl {
         }
         return container.getWorkspaceDb(props);
     }
+    getSettingsDb(args) {
+        const container = this.findContainer(args.containerId);
+        if (undefined === container)
+            core_common_1.WorkspaceError.throwError("does-not-exist", { message: `No settings container found for containerId "${args.containerId}"` });
+        const settingsDb = new SettingsDbImpl_1.SettingsDbImpl({ dbName: args.dbName ?? "settings-db", version: args.version }, container, args.priority);
+        if (!settingsDb.hasSettingsManifestProperty)
+            core_common_1.WorkspaceError.throwError("does-not-exist", { message: `Container "${args.containerId}" does not contain a SettingsDb — missing settings manifest` });
+        return settingsDb;
+    }
     async loadSettingsDictionary(props, problems) {
         if (!Array.isArray(props))
             props = [props];
@@ -329,12 +343,13 @@ class WorkspaceImpl {
             db.open();
             try {
                 const manifest = db.manifest;
-                const dictProps = { name: prop.resourceName, workspaceDb: db, priority: prop.priority };
+                const resourceName = prop.resourceName ?? SettingsDb_1.settingsResourceName;
+                const dictProps = { name: resourceName, workspaceDb: db, priority: prop.priority };
                 // don't load if we already have this dictionary. Happens if the same WorkspaceDb is in more than one list
                 if (undefined === this.settings.getDictionary(dictProps)) {
-                    const settingsJson = db.getString(prop.resourceName);
+                    const settingsJson = db.getString(resourceName);
                     if (undefined === settingsJson)
-                        throwWorkspaceDbLoadError(`could not load setting dictionary resource '${prop.resourceName}' from: '${manifest.workspaceName}'`, prop, db);
+                        throwWorkspaceDbLoadError(`could not load setting dictionary resource '${resourceName}' from: '${manifest.workspaceName}'`, prop, db);
                     db.close(); // don't leave this db open in case we're going to find another dictionary in it recursively.
                     this.settings.addJson(dictProps, settingsJson);
                     const dict = this.settings.getDictionary(dictProps);
@@ -409,6 +424,12 @@ class EditorWorkspaceImpl extends WorkspaceImpl {
         return this._cloudCache ??= makeWorkspaceCloudCache({ cacheName: workspaceEditorName, cacheSize: "20G" });
     }
 }
+const settingsEditorCacheName = "SettingsEditor";
+class SettingsEditorWorkspaceImpl extends WorkspaceImpl {
+    getCloudCache() {
+        return this._cloudCache ??= makeWorkspaceCloudCache({ cacheName: settingsEditorCacheName, cacheSize: "2G" });
+    }
+}
 class EditorImpl {
     [Symbols_1._implementationProhibited] = undefined;
     workspace = new EditorWorkspaceImpl(new SettingsImpl_1.SettingsImpl(), { containerDir: (0, path_1.join)(IModelHost_1.IModelHost.cacheDir, workspaceEditorName) });
@@ -441,6 +462,24 @@ class EditorImpl {
             : await CloudSqlite_1.CloudSqlite.requestToken({ ...props, accessLevel: "write" });
         return this.getContainer({ ...props, accessToken });
     }
+    async findContainers(args) {
+        const containers = await WorkspaceEditor_1.WorkspaceEditor.queryContainers(args);
+        const userToken = await IModelHost_1.IModelHost.getAccessToken();
+        const results = [];
+        for (const containerMeta of containers) {
+            // queryContainers already validates that BlobContainer.service is defined, so the non-null assertion is safe here.
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            const tokenProps = await BlobContainerService_1.BlobContainer.service.requestToken({ containerId: containerMeta.containerId, userToken, accessLevel: "write" });
+            results.push(this.getContainer({
+                containerId: containerMeta.containerId,
+                baseUri: tokenProps.baseUri,
+                storageType: tokenProps.provider,
+                accessToken: tokenProps.token,
+                writeable: true,
+            }));
+        }
+        return results;
+    }
     close() {
         this.workspace.close();
     }
@@ -471,9 +510,10 @@ class EditorContainerImpl extends WorkspaceContainerImpl {
         return this.getEditableDb(props);
     }
     getEditableDb(props) {
-        const db = this._wsDbs.get(workspaceDbNameWithDefault(props.dbName)) ?? new EditableDbImpl(props, this);
+        const dbFileName = this.resolveDbFileName(props);
+        const db = this._wsDbs.get(dbFileName) ?? new EditableDbImpl(props, this);
         if (this.cloudContainer && !CloudSqlite_1.CloudSqlite.isSemverEditable(db.dbFileName, this.cloudContainer)) {
-            this._wsDbs.delete(workspaceDbNameWithDefault(props.dbName));
+            this._wsDbs.delete(dbFileName);
             core_common_1.CloudSqliteError.throwError("already-published", { message: `${db.dbFileName} has been published and is not editable. Make a new version first.` });
         }
         return db;
@@ -506,7 +546,7 @@ class EditorContainerImpl extends WorkspaceContainerImpl {
             if (fs.existsSync(tempDbFile))
                 IModelJsFs_1.IModelJsFs.removeSync(tempDbFile);
             WorkspaceEditor_1.WorkspaceEditor.createEmptyDb({ localFileName: tempDbFile, manifest: args.manifest });
-            await CloudSqlite_1.CloudSqlite.uploadDb(this.cloudContainer, { localFileName: tempDbFile, dbName: CloudSqlite_1.CloudSqlite.makeSemverName(workspaceDbNameWithDefault(args.dbName)) });
+            await CloudSqlite_1.CloudSqlite.uploadDb(this.cloudContainer, { localFileName: tempDbFile, dbName: CloudSqlite_1.CloudSqlite.makeSemverName(workspaceDbNameWithDefault(args.dbName), args.version) });
             IModelJsFs_1.IModelJsFs.removeSync(tempDbFile);
         }
         return this.getWorkspaceDb(args);
@@ -634,6 +674,9 @@ function constructWorkspace(settings, opts) {
 function constructWorkspaceEditor() {
     return new EditorImpl();
 }
+function constructSettingsEditorWorkspace(settings, opts) {
+    return new SettingsEditorWorkspaceImpl(settings, opts);
+}
 /**
  * Validate that a WorkspaceContainer.Id is valid.
  * The rules for ContainerIds (from Azure, see https://docs.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata):