@itwin/core-backend 5.8.0-dev.2 → 5.8.0-dev.20

package/lib/cjs/workspace/SettingsDb.js

@@ -0,0 +1,19 @@
+"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.settingsResourceName = void 0;
+const Symbols_1 = require("../internal/Symbols");
+/** The default resource name used to store settings in a [[SettingsDb]].
+ * This is the key under which all settings are stored in the SQLite `strings` table.
+ * When loading settings at runtime via [[Workspace.loadSettingsDictionary]], the `resourceName` defaults
+ * to this value, ensuring the read and write paths always agree on which key to use.
+ * @internal
+ */
+exports.settingsResourceName = "settings";
+//# sourceMappingURL=SettingsDb.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SettingsDb.js","sourceRoot":"","sources":["../../../src/workspace/SettingsDb.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAIH,iDAAgE;AAyGhE;;;;;GAKG;AACU,QAAA,oBAAoB,GAAG,UAAU,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Workspace\n */\n\nimport { Setting, SettingName, SettingsContainer, SettingsPriority } from \"./Settings\";\nimport { CloudSqliteContainer, WorkspaceContainerId, WorkspaceDbName } from \"./Workspace\";\nimport { _implementationProhibited } from \"../internal/Symbols\";\n\n/** Metadata stored inside a [[SettingsDb]] describing the database's contents, to help users understand\n * the purpose of the [[SettingsDb]] and who to contact with questions about it.\n * @note Only the `settingsName` field is required, and users may add additional fields for their own purposes.\n * @note Since the information is stored inside the [[SettingsDb]], it is versioned along with the rest of the contents.\n * @beta\n */\nexport interface SettingsDbManifest {\n  /** The name of the [[SettingsDb]] to be shown in user interfaces. Organizations should attempt to make this name\n   * informative enough so that users may refer to it in conversations.\n   */\n  readonly settingsName: string;\n  /** A description of the contents of this [[SettingsDb]] to help users understand its purpose and appropriate usage. */\n  readonly description?: string;\n  /** The name of the person to contact with questions about this [[SettingsDb]]. */\n  readonly contactName?: string;\n  /** The name of the person who last modified this [[SettingsDb]]. */\n  readonly lastEditedBy?: string;\n}\n\n/** Properties that specify how to load a [[SettingsDb]] within a [[CloudSqliteContainer]].\n * @beta\n */\nexport interface SettingsDbProps {\n  /** The base name of the [[SettingsDb]], without any version information. Default: `\"settings-db\"`. */\n  readonly dbName?: WorkspaceDbName;\n  /** The [semver](https://github.com/npm/node-semver) version string or range for the desired [[SettingsDb]].\n   * If not specified, the latest available version is used.\n   */\n  readonly version?: string;\n}\n\n/** Arguments for obtaining a [[SettingsDb]] from a previously-loaded container.\n * @beta\n */\nexport interface GetSettingsDbArgs {\n  /** The [[WorkspaceContainerId]] of the cloud container that holds the [[SettingsDb]].\n   * This is an opaque GUID assigned by the BlobContainer service when the container is created — it is\n   * **not** the same as an iTwinId or iModelId.\n   */\n  readonly containerId: WorkspaceContainerId;\n  /** The priority to assign to dictionaries loaded from this [[SettingsDb]]. */\n  readonly priority: SettingsPriority;\n  /** The name of the [[SettingsDb]] to retrieve. Default: `\"settings-db\"`. */\n  readonly dbName?: WorkspaceDbName;\n  /** The semantic version string or range for the desired [[SettingsDb]].\n   * If not specified, the latest available version is used.\n   */\n  readonly version?: string;\n}\n\n/** A CloudSQLite database dedicated to storing settings as key-value pairs. Unlike a general-purpose [[WorkspaceDb]],\n * a `SettingsDb` restricts its API surface to settings-only operations, providing a focused interface\n * for reading settings by name.\n *\n * Internally, all settings are stored in a single JSON blob. Each setting is a named entry in a [[SettingsContainer]].\n *\n * A `SettingsDb` resides in a [[CloudSqliteContainer]] and can be published to the cloud. Once published,\n * the `SettingsDb` becomes immutable; however, multiple versions may be created to allow settings to evolve over time.\n * @beta\n */\nexport interface SettingsDb {\n  /** @internal */\n  [_implementationProhibited]: unknown;\n  /** The [[CloudSqliteContainer]] in which this database resides. */\n  readonly container: CloudSqliteContainer;\n  /** The base name of this SettingsDb, without version. */\n  readonly dbName: string;\n  /** The resolved [semver](https://github.com/npm/node-semver) version of this SettingsDb.\n   * @note For local (non-cloud) containers, this property returns `\"0.0.0\"`.\n   */\n  readonly version: string;\n  /** The priority assigned to dictionaries loaded from this SettingsDb. */\n  readonly priority: SettingsPriority;\n  /** Whether the underlying database is currently open. */\n  readonly isOpen: boolean;\n  /** The manifest describing the contents of this SettingsDb. */\n  readonly manifest: SettingsDbManifest;\n\n  /** Open the underlying database for querying. When performing significant activity against a SettingsDb,\n   * open it before the operations and [[close]] it afterwards.\n   * @note Explicit open/close is a performance optimization for batches of operations. Individual methods like\n   * [[getSetting]] and [[getSettings]] will auto-open and auto-close the database if it is not already open.\n   */\n  open(): void;\n\n  /** Close the underlying database. You should call this after [[open]]ing the database and completing your queries.\n   * @note For [[EditableSettingsDb]] instances, if the container's write lock is currently held, closing persists\n   * any pending changes and updates the manifest's `lastEditedBy` field with the current write lock holder.\n   */\n  close(): void;\n\n  /** Return a copy of the value of the setting named `settingName`, or `undefined` if not found.\n   * The returned value is always cloned using [[Setting.clone]].\n   * @param settingName The name of the setting to retrieve.\n   */\n  getSetting<T extends Setting>(settingName: SettingName): T | undefined;\n\n  /** Return a deep copy of all settings stored in this SettingsDb as a [[SettingsContainer]].\n   * @note The returned object is a fresh copy — mutating it will not affect the stored settings.\n   */\n  getSettings(): SettingsContainer;\n}\n\n/** The default resource name used to store settings in a [[SettingsDb]].\n * This is the key under which all settings are stored in the SQLite `strings` table.\n * When loading settings at runtime via [[Workspace.loadSettingsDictionary]], the `resourceName` defaults\n * to this value, ensuring the read and write paths always agree on which key to use.\n * @internal\n */\nexport const settingsResourceName = \"settings\";\n"]}

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

@@ -0,0 +1,250 @@
+/** @packageDocumentation
+ * @module Workspace
+ */
+import { LocalFileName } from "@itwin/core-common";
+import { GuidString } from "@itwin/core-bentley";
+import { Setting, SettingName, SettingsContainer } from "./Settings";
+import { BlobContainer } from "../BlobContainerService";
+import { CloudSqliteContainer, GetWorkspaceContainerArgs, Workspace, WorkspaceContainerProps, WorkspaceDbName, WorkspaceDbNameAndVersion, WorkspaceDbVersion } from "./Workspace";
+import { SettingsDb, SettingsDbManifest, SettingsDbProps } from "./SettingsDb";
+import { _implementationProhibited } from "../internal/Symbols";
+import { CloudSqlite } from "../CloudSqlite";
+/** @beta */
+export declare namespace SettingsEditor {
+    /**
+     * Create a new [[SettingsEditor]] for creating new versions of [[SettingsDb]]s.
+     * @note The caller becomes the owner of the SettingsEditor and is responsible for calling [[SettingsEditor.close]] on it when finished.
+     * @note It is illegal to have more than one SettingsEditor active in a single session.
+     */
+    function construct(): SettingsEditor;
+    /**
+     * Create a new, empty, [[SettingsDb]] file on the local filesystem for importing settings dictionaries.
+     * @note Do not pass an untrusted or unintended path in `localFileName`.
+     * This helper creates or overwrites the file at that location; callers that need fail-if-exists behavior should check first.
+     */
+    function createEmptyDb(args: {
+        localFileName: LocalFileName;
+        manifest: SettingsDbManifest;
+    }): void;
+    /** Arguments for [[SettingsEditor.queryContainers]] and [[SettingsEditor.findContainers]]. */
+    interface QuerySettingsContainersArgs {
+        /** The iTwinId whose settings containers should be queried. */
+        iTwinId: GuidString;
+        /** Optional iModelId to further scope the query to containers associated with a specific iModel. */
+        iModelId?: GuidString;
+        /** Optional label filter. */
+        label?: string;
+    }
+    /**
+     * Query the [[BlobContainer]] service for all settings containers associated with a given iTwin.
+     * This is a convenience wrapper around `BlobContainer.service.queryContainersMetadata` that
+     * automatically filters by `containerType: "settings"`.
+     * @param args - The query arguments including the iTwinId.
+     * @returns A promise that resolves to the matching container metadata entries.
+     * @note Requires [[IModelHost.authorizationClient]] to be configured.
+     */
+    function queryContainers(args: QuerySettingsContainersArgs): Promise<BlobContainer.MetadataResponse[]>;
+}
+/** Arguments supplied to [[SettingsEditor.createNewCloudContainer]] to create a new [[EditableSettingsCloudContainer]].
+ * The created container will automatically have `containerType: "settings"` in its metadata, enabling discovery
+ * via `BlobContainer.service.queryContainersMetadata({ containerType: "settings" })`.
+ * @beta
+ */
+export interface CreateNewSettingsContainerArgs {
+    /**
+     * The scope of the container. This determines the ownership of the container, how RBAC rights are assigned,
+     * and the location of the datacenter.
+     */
+    scope: BlobContainer.Scope;
+    /** The manifest to be stored in the default SettingsDb in the new container. */
+    manifest: SettingsDbManifest;
+    /** Metadata stored by the BlobContainer service. The `containerType` field is omitted here because it is
+     * automatically set to `"settings"` when the container is created (mirroring the `"workspace"` convention for WorkspaceDb containers).
+     */
+    metadata: Omit<BlobContainer.Metadata, "containerType">;
+    /** The name of the default [[SettingsDb]] created inside the new container.
+     * Default: "settings-db";
+     */
+    dbName?: WorkspaceDbName;
+}
+/** Arguments supplied to [[EditableSettingsCloudContainer.createNewSettingsDbVersion]].
+ * @beta
+ */
+export interface CreateNewSettingsDbVersionArgs {
+    /**
+     * The properties that determine the source [[SettingsDb]] to serve as the basis for the new version.
+     * This is usually the latest version, but it is possible to create patches to older versions.
+     */
+    fromProps?: SettingsDbProps;
+    /** The type of version increment to apply to the source version. */
+    versionType: CloudSqlite.SemverIncrement;
+    /** For prerelease versions, a string that becomes part of the version name. */
+    identifier?: string;
+}
+/** The result of creating a new version of a [[SettingsDb]].
+ * @beta
+ */
+export interface SettingsDbVersionResult {
+    /** The name and version of the source SettingsDb. */
+    oldDb: WorkspaceDbNameAndVersion;
+    /** The name and version of the newly-created SettingsDb. */
+    newDb: WorkspaceDbNameAndVersion;
+}
+/** Arguments supplied to [[EditableSettingsCloudContainer.createDb]] to create a new [[SettingsDb]] in a container.
+ * @beta
+ */
+export interface CreateSettingsDbArgs {
+    /** The name of the new SettingsDb. Default: `"settings-db"`. */
+    dbName?: WorkspaceDbName;
+    /** The initial version of the new SettingsDb. Default: `"0.0.0"`. */
+    version?: WorkspaceDbVersion;
+    /** The manifest for the new SettingsDb. */
+    manifest: SettingsDbManifest;
+}
+/** Arguments supplied to [[EditableSettingsDb.updateSetting]] to add or update a single [[Setting]].
+ * @beta
+ */
+export interface UpdateSettingArgs {
+    /** The [[SettingName]] of the setting to add or update. */
+    readonly settingName: SettingName;
+    /** The new value for the setting. */
+    readonly value: Setting;
+}
+/**
+ * A [[CloudSqliteContainer]] opened for editing settings by a [[SettingsEditor]].
+ * You can create new [[SettingsDb]]s or new versions of existing [[SettingsDb]]s inside it.
+ * Before actually making any changes to the container's contents, you must first obtain an exclusive write lock on it via
+ * [[acquireWriteLock]]. Only one user can hold the write lock at any given time. When you have finished making changes,
+ * you can use [[releaseWriteLock]] to publish your changes, or [[abandonChanges]] to discard them.
+ * @note Settings containers are separate from workspace containers, providing independent write locks.
+ * Editing settings does not block workspace resource editing, and vice versa.
+ * @beta
+ */
+export interface EditableSettingsCloudContainer extends CloudSqliteContainer {
+    /**
+     * Create a copy of an existing [[SettingsDb]] in this container with a new [[WorkspaceDbVersion]].
+     * The copy should be modified with new content before the write lock is released,
+     * and thereafter may never be modified again.
+     * @param args - The properties that determine the source SettingsDb and the version increment to apply.
+     * @returns A promise that resolves to an object containing the old and new SettingsDb names and versions.
+     */
+    createNewSettingsDbVersion(args: CreateNewSettingsDbVersionArgs): Promise<SettingsDbVersionResult>;
+    /**
+     * Create a new, empty [[SettingsDb]].
+     * @param args - The arguments for creating the new SettingsDb.
+     * @returns A promise that resolves to an EditableSettingsDb.
+     */
+    createDb(args: CreateSettingsDbArgs): Promise<EditableSettingsDb>;
+    /**
+     * Get the cloud properties of this container.
+     */
+    readonly cloudProps: WorkspaceContainerProps | undefined;
+    /**
+     * Get an editable [[SettingsDb]] to add, delete, or update settings *within a newly created version* of a SettingsDb.
+     * Repeated calls that resolve to the same SettingsDb return the same cached instance.
+     * @param props - The properties of the SettingsDb.
+     * @returns An EditableSettingsDb for modifying settings.
+     * @throws if the targeted SettingsDb has already been published and is immutable. Use [[createNewSettingsDbVersion]] first to create an editable version.
+     */
+    getEditableDb(props?: SettingsDbProps): EditableSettingsDb;
+    /**
+     * Acquire the write lock on the container. Use [[releaseWriteLock]] to release the lock after publishing your changes, or
+     * [[abandonChanges]] to release the lock and discard your changes.
+     * Only one user can hold the write lock at any given time. However, readers can continue to read the published contents of the container while
+     * a writer holds the write lock. Readers will only see the writer's changes after they are published by [[releaseWriteLock]].
+     * @param user - The name of the user acquiring the write lock.
+     * @throws if the write lock is already held by another user.
+     */
+    acquireWriteLock(user: string): void;
+    /**
+     * Release the write lock on the container. This should be called after all changes to the container's contents are complete. It
+     * publishes and uploads the changes made to any [[SettingsDb]]s while the lock was held, after which those dbs become immutable.
+     */
+    releaseWriteLock(): void;
+    /**
+     * Abandon any changes made to the container and release the write lock. Any newly created versions of SettingsDbs are discarded.
+     */
+    abandonChanges(): void;
+}
+/**
+ * An editable [[SettingsDb]]. This is used only by tools to allow administrators to create and modify SettingsDbs.
+ * For cloud-based SettingsDbs, the container's write token must be obtained via [[EditableSettingsCloudContainer.acquireWriteLock]] before the methods in this interface may be used.
+ * Normally, only admins will have write access.
+ * Only one admin at a time may be editing a settings container.
+ * @note Unlike [[EditableWorkspaceDb]], this interface only supports settings operations — no blob, file, or string resource methods.
+ * @beta
+ */
+export interface EditableSettingsDb extends SettingsDb {
+    /** The editable container that owns this SettingsDb. */
+    readonly container: EditableSettingsCloudContainer;
+    /**
+     * Update the contents of the manifest in this SettingsDb.
+     * @note This replaces the stored manifest entirely; omitted fields are lost.
+     * @param manifest - The updated manifest.
+     */
+    updateManifest(manifest: SettingsDbManifest): void;
+    /**
+     * Replace all settings in this SettingsDb with the given container.
+     * @param settings - The settings object to store.
+     */
+    updateSettings(settings: SettingsContainer): void;
+    /**
+     * Add or update a single [[Setting]] by name.
+     * If a setting with the given name already exists, its value is replaced.
+     * If it does not exist, it is added. Other settings are preserved.
+     * @param args - The arguments specifying the setting name and value.
+     */
+    updateSetting(args: UpdateSettingArgs): void;
+    /**
+     * Remove a single [[Setting]] by name. Other settings are preserved.
+     * @param settingName - The name of the setting to remove.
+     */
+    removeSetting(settingName: SettingName): void;
+}
+/** An object that permits administrators to modify the contents of settings containers.
+ * Use [[SettingsEditor.construct]] to obtain a SettingsEditor, and [[close]] when finished using it.
+ * Only one SettingsEditor may be in use at any given time.
+ * Use [[getContainer]] to edit an existing container, or [[createNewCloudContainer]] to create a new container.
+ * @beta
+ */
+export interface SettingsEditor {
+    /** @internal */
+    [_implementationProhibited]: unknown;
+    /**
+     * The workspace dedicated to this editor.
+     * @note This workspace is independent from [[IModelHost.appWorkspace]] and all [[IModelDb.workspace]]s.
+     */
+    readonly workspace: Workspace;
+    /**
+     * Retrieves a container for the editor with the specified properties and access token.
+     */
+    getContainer(args: GetWorkspaceContainerArgs): EditableSettingsCloudContainer;
+    /**
+     * Asynchronously retrieves a container for the editor with the specified properties.
+     */
+    getContainerAsync(props: WorkspaceContainerProps): Promise<EditableSettingsCloudContainer>;
+    /**
+     * Creates a new cloud container for holding SettingsDbs, from the [[BlobContainer]] service.
+     * The container is automatically assigned `containerType: "settings"` in its metadata and
+     * initialized with a default [[SettingsDb]].
+     * @param args - The arguments for creating the container, including scope, metadata, and manifest.
+     * @returns A promise that resolves to the new EditableSettingsCloudContainer.
+     * @note The current user must have administrator rights for the iTwin for the container.
+     * @note Requires [[IModelHost.authorizationClient]] to be configured.
+     */
+    createNewCloudContainer(args: CreateNewSettingsContainerArgs): Promise<EditableSettingsCloudContainer>;
+    /**
+     * Find and open existing settings containers by querying the [[BlobContainer]] service.
+     * This is a convenience method that queries for all settings containers matching the given iTwinId
+     * (and optionally iModelId), requests write access tokens, and opens each matching container.
+     * @param args - The query arguments including iTwinId and optionally iModelId and label.
+     * @returns A promise that resolves to an array of opened [[EditableSettingsCloudContainer]]s.
+     * @note Requires [[IModelHost.authorizationClient]] and [[BlobContainer.service]] to be configured.
+     */
+    findContainers(args: SettingsEditor.QuerySettingsContainersArgs): Promise<EditableSettingsCloudContainer[]>;
+    /**
+     * Closes this editor. All settings containers are dropped.
+     */
+    close(): void;
+}
+//# sourceMappingURL=SettingsEditor.d.ts.map

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

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

package/lib/cjs/workspace/SettingsEditor.js

@@ -0,0 +1,53 @@
+"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.SettingsEditor = void 0;
+const BlobContainerService_1 = require("../BlobContainerService");
+const SettingsSqliteDb_1 = require("../internal/workspace/SettingsSqliteDb");
+const SettingsEditorImpl_1 = require("../internal/workspace/SettingsEditorImpl");
+const Symbols_1 = require("../internal/Symbols");
+const IModelHost_1 = require("../IModelHost");
+/** @beta */
+var SettingsEditor;
+(function (SettingsEditor) {
+    /**
+     * Create a new [[SettingsEditor]] for creating new versions of [[SettingsDb]]s.
+     * @note The caller becomes the owner of the SettingsEditor and is responsible for calling [[SettingsEditor.close]] on it when finished.
+     * @note It is illegal to have more than one SettingsEditor active in a single session.
+     */
+    function construct() {
+        return (0, SettingsEditorImpl_1.constructSettingsEditor)();
+    }
+    SettingsEditor.construct = construct;
+    /**
+     * Create a new, empty, [[SettingsDb]] file on the local filesystem for importing settings dictionaries.
+     * @note Do not pass an untrusted or unintended path in `localFileName`.
+     * This helper creates or overwrites the file at that location; callers that need fail-if-exists behavior should check first.
+     */
+    function createEmptyDb(args) {
+        SettingsSqliteDb_1.SettingsSqliteDb.createNewDb(args.localFileName, args);
+    }
+    SettingsEditor.createEmptyDb = createEmptyDb;
+    /**
+     * Query the [[BlobContainer]] service for all settings containers associated with a given iTwin.
+     * This is a convenience wrapper around `BlobContainer.service.queryContainersMetadata` that
+     * automatically filters by `containerType: "settings"`.
+     * @param args - The query arguments including the iTwinId.
+     * @returns A promise that resolves to the matching container metadata entries.
+     * @note Requires [[IModelHost.authorizationClient]] to be configured.
+     */
+    async function queryContainers(args) {
+        if (undefined === BlobContainerService_1.BlobContainer.service)
+            throw new Error("BlobContainer.service is not available. Ensure IModelHost is initialized with a valid configuration.");
+        const userToken = await IModelHost_1.IModelHost.getAccessToken();
+        return BlobContainerService_1.BlobContainer.service.queryContainersMetadata(userToken, { ...args, containerType: "settings" });
+    }
+    SettingsEditor.queryContainers = queryContainers;
+})(SettingsEditor || (exports.SettingsEditor = SettingsEditor = {}));
+//# sourceMappingURL=SettingsEditor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SettingsEditor.js","sourceRoot":"","sources":["../../../src/workspace/SettingsEditor.ts"],"names":[],"mappings":";AAAA;;;gGAGgG;AAChG;;GAEG;;;AAKH,kEAAwD;AAGxD,6EAA0E;AAC1E,iFAAmF;AACnF,iDAAgE;AAEhE,8CAA2C;AAE3C,YAAY;AACZ,IAAiB,cAAc,CA0C9B;AA1CD,WAAiB,cAAc;IAC7B;;;;OAIG;IACH,SAAgB,SAAS;QACvB,OAAO,IAAA,4CAAuB,GAAE,CAAC;IACnC,CAAC;IAFe,wBAAS,YAExB,CAAA;IAED;;;;OAIG;IACH,SAAgB,aAAa,CAAC,IAAoE;QAChG,mCAAgB,CAAC,WAAW,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;IACzD,CAAC;IAFe,4BAAa,gBAE5B,CAAA;IAYD;;;;;;;OAOG;IACI,KAAK,UAAU,eAAe,CAAC,IAAiC;QACrE,IAAI,SAAS,KAAK,oCAAa,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,sGAAsG,CAAC,CAAC;QACjK,MAAM,SAAS,GAAG,MAAM,uBAAU,CAAC,cAAc,EAAE,CAAC;QACpD,OAAO,oCAAa,CAAC,OAAO,CAAC,uBAAuB,CAAC,SAAS,EAAE,EAAE,GAAG,IAAI,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC,CAAC;IAC1G,CAAC;IAJqB,8BAAe,kBAIpC,CAAA;AACH,CAAC,EA1CgB,cAAc,8BAAd,cAAc,QA0C9B","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Workspace\n */\n\nimport { LocalFileName } from \"@itwin/core-common\";\nimport { GuidString } from \"@itwin/core-bentley\";\nimport { Setting, SettingName, SettingsContainer } from \"./Settings\";\nimport { BlobContainer } from \"../BlobContainerService\";\nimport { CloudSqliteContainer, GetWorkspaceContainerArgs, Workspace, WorkspaceContainerProps, WorkspaceDbName, WorkspaceDbNameAndVersion, WorkspaceDbVersion } from \"./Workspace\";\nimport { SettingsDb, SettingsDbManifest, SettingsDbProps } from \"./SettingsDb\";\nimport { SettingsSqliteDb } from \"../internal/workspace/SettingsSqliteDb\";\nimport { constructSettingsEditor } from \"../internal/workspace/SettingsEditorImpl\";\nimport { _implementationProhibited } from \"../internal/Symbols\";\nimport { CloudSqlite } from \"../CloudSqlite\";\nimport { IModelHost } from \"../IModelHost\";\n\n/** @beta */\nexport namespace SettingsEditor {\n  /**\n   * Create a new [[SettingsEditor]] for creating new versions of [[SettingsDb]]s.\n   * @note The caller becomes the owner of the SettingsEditor and is responsible for calling [[SettingsEditor.close]] on it when finished.\n   * @note It is illegal to have more than one SettingsEditor active in a single session.\n   */\n  export function construct(): SettingsEditor {\n    return constructSettingsEditor();\n  }\n\n  /**\n   * Create a new, empty, [[SettingsDb]] file on the local filesystem for importing settings dictionaries.\n   * @note Do not pass an untrusted or unintended path in `localFileName`.\n   * This helper creates or overwrites the file at that location; callers that need fail-if-exists behavior should check first.\n   */\n  export function createEmptyDb(args: { localFileName: LocalFileName; manifest: SettingsDbManifest }): void {\n    SettingsSqliteDb.createNewDb(args.localFileName, args);\n  }\n\n  /** Arguments for [[SettingsEditor.queryContainers]] and [[SettingsEditor.findContainers]]. */\n  export interface QuerySettingsContainersArgs {\n    /** The iTwinId whose settings containers should be queried. */\n    iTwinId: GuidString;\n    /** Optional iModelId to further scope the query to containers associated with a specific iModel. */\n    iModelId?: GuidString;\n    /** Optional label filter. */\n    label?: string;\n  }\n\n  /**\n   * Query the [[BlobContainer]] service for all settings containers associated with a given iTwin.\n   * This is a convenience wrapper around `BlobContainer.service.queryContainersMetadata` that\n   * automatically filters by `containerType: \"settings\"`.\n   * @param args - The query arguments including the iTwinId.\n   * @returns A promise that resolves to the matching container metadata entries.\n   * @note Requires [[IModelHost.authorizationClient]] to be configured.\n   */\n  export async function queryContainers(args: QuerySettingsContainersArgs): Promise<BlobContainer.MetadataResponse[]> {\n    if (undefined === BlobContainer.service) throw new Error(\"BlobContainer.service is not available. Ensure IModelHost is initialized with a valid configuration.\");\n    const userToken = await IModelHost.getAccessToken();\n    return BlobContainer.service.queryContainersMetadata(userToken, { ...args, containerType: \"settings\" });\n  }\n}\n\n/** Arguments supplied to [[SettingsEditor.createNewCloudContainer]] to create a new [[EditableSettingsCloudContainer]].\n * The created container will automatically have `containerType: \"settings\"` in its metadata, enabling discovery\n * via `BlobContainer.service.queryContainersMetadata({ containerType: \"settings\" })`.\n * @beta\n */\nexport interface CreateNewSettingsContainerArgs {\n  /**\n   * The scope of the container. This determines the ownership of the container, how RBAC rights are assigned,\n   * and the location of the datacenter.\n   */\n  scope: BlobContainer.Scope;\n  /** The manifest to be stored in the default SettingsDb in the new container. */\n  manifest: SettingsDbManifest;\n  /** Metadata stored by the BlobContainer service. The `containerType` field is omitted here because it is\n   * automatically set to `\"settings\"` when the container is created (mirroring the `\"workspace\"` convention for WorkspaceDb containers).\n   */\n  metadata: Omit<BlobContainer.Metadata, \"containerType\">;\n  /** The name of the default [[SettingsDb]] created inside the new container.\n   * Default: \"settings-db\";\n   */\n  dbName?: WorkspaceDbName;\n}\n\n/** Arguments supplied to [[EditableSettingsCloudContainer.createNewSettingsDbVersion]].\n * @beta\n */\nexport interface CreateNewSettingsDbVersionArgs {\n  /**\n   * The properties that determine the source [[SettingsDb]] to serve as the basis for the new version.\n   * This is usually the latest version, but it is possible to create patches to older versions.\n   */\n  fromProps?: SettingsDbProps;\n  /** The type of version increment to apply to the source version. */\n  versionType: CloudSqlite.SemverIncrement;\n  /** For prerelease versions, a string that becomes part of the version name. */\n  identifier?: string;\n}\n\n/** The result of creating a new version of a [[SettingsDb]].\n * @beta\n */\nexport interface SettingsDbVersionResult {\n  /** The name and version of the source SettingsDb. */\n  oldDb: WorkspaceDbNameAndVersion;\n  /** The name and version of the newly-created SettingsDb. */\n  newDb: WorkspaceDbNameAndVersion;\n}\n\n/** Arguments supplied to [[EditableSettingsCloudContainer.createDb]] to create a new [[SettingsDb]] in a container.\n * @beta\n */\nexport interface CreateSettingsDbArgs {\n  /** The name of the new SettingsDb. Default: `\"settings-db\"`. */\n  dbName?: WorkspaceDbName;\n  /** The initial version of the new SettingsDb. Default: `\"0.0.0\"`. */\n  version?: WorkspaceDbVersion;\n  /** The manifest for the new SettingsDb. */\n  manifest: SettingsDbManifest;\n}\n\n/** Arguments supplied to [[EditableSettingsDb.updateSetting]] to add or update a single [[Setting]].\n * @beta\n */\nexport interface UpdateSettingArgs {\n  /** The [[SettingName]] of the setting to add or update. */\n  readonly settingName: SettingName;\n  /** The new value for the setting. */\n  readonly value: Setting;\n}\n\n/**\n * A [[CloudSqliteContainer]] opened for editing settings by a [[SettingsEditor]].\n * You can create new [[SettingsDb]]s or new versions of existing [[SettingsDb]]s inside it.\n * Before actually making any changes to the container's contents, you must first obtain an exclusive write lock on it via\n * [[acquireWriteLock]]. Only one user can hold the write lock at any given time. When you have finished making changes,\n * you can use [[releaseWriteLock]] to publish your changes, or [[abandonChanges]] to discard them.\n * @note Settings containers are separate from workspace containers, providing independent write locks.\n * Editing settings does not block workspace resource editing, and vice versa.\n * @beta\n */\nexport interface EditableSettingsCloudContainer extends CloudSqliteContainer {\n  /**\n   * Create a copy of an existing [[SettingsDb]] in this container with a new [[WorkspaceDbVersion]].\n   * The copy should be modified with new content before the write lock is released,\n   * and thereafter may never be modified again.\n   * @param args - The properties that determine the source SettingsDb and the version increment to apply.\n   * @returns A promise that resolves to an object containing the old and new SettingsDb names and versions.\n   */\n  createNewSettingsDbVersion(args: CreateNewSettingsDbVersionArgs): Promise<SettingsDbVersionResult>;\n\n  /**\n   * Create a new, empty [[SettingsDb]].\n   * @param args - The arguments for creating the new SettingsDb.\n   * @returns A promise that resolves to an EditableSettingsDb.\n   */\n  createDb(args: CreateSettingsDbArgs): Promise<EditableSettingsDb>;\n\n  /**\n   * Get the cloud properties of this container.\n   */\n  readonly cloudProps: WorkspaceContainerProps | undefined;\n\n  /**\n   * Get an editable [[SettingsDb]] to add, delete, or update settings *within a newly created version* of a SettingsDb.\n   * Repeated calls that resolve to the same SettingsDb return the same cached instance.\n   * @param props - The properties of the SettingsDb.\n   * @returns An EditableSettingsDb for modifying settings.\n   * @throws if the targeted SettingsDb has already been published and is immutable. Use [[createNewSettingsDbVersion]] first to create an editable version.\n   */\n  getEditableDb(props?: SettingsDbProps): EditableSettingsDb;\n\n  /**\n   * Acquire the write lock on the container. Use [[releaseWriteLock]] to release the lock after publishing your changes, or\n   * [[abandonChanges]] to release the lock and discard your changes.\n   * Only one user can hold the write lock at any given time. However, readers can continue to read the published contents of the container while\n   * a writer holds the write lock. Readers will only see the writer's changes after they are published by [[releaseWriteLock]].\n   * @param user - The name of the user acquiring the write lock.\n   * @throws if the write lock is already held by another user.\n   */\n  acquireWriteLock(user: string): void;\n\n  /**\n   * Release the write lock on the container. This should be called after all changes to the container's contents are complete. It\n   * publishes and uploads the changes made to any [[SettingsDb]]s while the lock was held, after which those dbs become immutable.\n   */\n  releaseWriteLock(): void;\n\n  /**\n   * Abandon any changes made to the container and release the write lock. Any newly created versions of SettingsDbs are discarded.\n   */\n  abandonChanges(): void;\n}\n\n/**\n * An editable [[SettingsDb]]. This is used only by tools to allow administrators to create and modify SettingsDbs.\n * For cloud-based SettingsDbs, the container's write token must be obtained via [[EditableSettingsCloudContainer.acquireWriteLock]] before the methods in this interface may be used.\n * Normally, only admins will have write access.\n * Only one admin at a time may be editing a settings container.\n * @note Unlike [[EditableWorkspaceDb]], this interface only supports settings operations — no blob, file, or string resource methods.\n * @beta\n */\nexport interface EditableSettingsDb extends SettingsDb {\n  /** The editable container that owns this SettingsDb. */\n  readonly container: EditableSettingsCloudContainer;\n\n  /**\n   * Update the contents of the manifest in this SettingsDb.\n   * @note This replaces the stored manifest entirely; omitted fields are lost.\n   * @param manifest - The updated manifest.\n   */\n  updateManifest(manifest: SettingsDbManifest): void;\n\n  /**\n   * Replace all settings in this SettingsDb with the given container.\n   * @param settings - The settings object to store.\n   */\n  updateSettings(settings: SettingsContainer): void;\n\n  /**\n   * Add or update a single [[Setting]] by name.\n   * If a setting with the given name already exists, its value is replaced.\n   * If it does not exist, it is added. Other settings are preserved.\n   * @param args - The arguments specifying the setting name and value.\n   */\n  updateSetting(args: UpdateSettingArgs): void;\n\n  /**\n   * Remove a single [[Setting]] by name. Other settings are preserved.\n   * @param settingName - The name of the setting to remove.\n   */\n  removeSetting(settingName: SettingName): void;\n}\n\n/** An object that permits administrators to modify the contents of settings containers.\n * Use [[SettingsEditor.construct]] to obtain a SettingsEditor, and [[close]] when finished using it.\n * Only one SettingsEditor may be in use at any given time.\n * Use [[getContainer]] to edit an existing container, or [[createNewCloudContainer]] to create a new container.\n * @beta\n */\nexport interface SettingsEditor {\n  /** @internal */\n  [_implementationProhibited]: unknown;\n\n  /**\n   * The workspace dedicated to this editor.\n   * @note This workspace is independent from [[IModelHost.appWorkspace]] and all [[IModelDb.workspace]]s.\n   */\n  readonly workspace: Workspace;\n\n  /**\n   * Retrieves a container for the editor with the specified properties and access token.\n   */\n  getContainer(args: GetWorkspaceContainerArgs): EditableSettingsCloudContainer;\n\n  /**\n   * Asynchronously retrieves a container for the editor with the specified properties.\n   */\n  getContainerAsync(props: WorkspaceContainerProps): Promise<EditableSettingsCloudContainer>;\n\n  /**\n   * Creates a new cloud container for holding SettingsDbs, from the [[BlobContainer]] service.\n   * The container is automatically assigned `containerType: \"settings\"` in its metadata and\n   * initialized with a default [[SettingsDb]].\n   * @param args - The arguments for creating the container, including scope, metadata, and manifest.\n   * @returns A promise that resolves to the new EditableSettingsCloudContainer.\n   * @note The current user must have administrator rights for the iTwin for the container.\n   * @note Requires [[IModelHost.authorizationClient]] to be configured.\n   */\n  createNewCloudContainer(args: CreateNewSettingsContainerArgs): Promise<EditableSettingsCloudContainer>;\n\n  /**\n   * Find and open existing settings containers by querying the [[BlobContainer]] service.\n   * This is a convenience method that queries for all settings containers matching the given iTwinId\n   * (and optionally iModelId), requests write access tokens, and opens each matching container.\n   * @param args - The query arguments including iTwinId and optionally iModelId and label.\n   * @returns A promise that resolves to an array of opened [[EditableSettingsCloudContainer]]s.\n   * @note Requires [[IModelHost.authorizationClient]] and [[BlobContainer.service]] to be configured.\n   */\n  findContainers(args: SettingsEditor.QuerySettingsContainersArgs): Promise<EditableSettingsCloudContainer[]>;\n\n  /**\n   * Closes this editor. All settings containers are dropped.\n   */\n  close(): void;\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"SettingsSchemas.js","sourceRoot":"","sources":["../../../src/workspace/SettingsSchemas.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;AAIH,iDAAgE","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 { BeEvent, JSONSchema, JSONSchemaTypeName } from \"@itwin/core-bentley\";\r\nimport { LocalDirName, LocalFileName } from \"@itwin/core-common\";\r\nimport { _implementationProhibited } from \"../internal/Symbols\";\r\nimport { SettingName } from \"./Settings\";\r\n\r\n/** Metadata describing a single [[Setting]] as part of a [[SettingGroupSchema]].\r\n  * Every setting has a [[type]], which can be one of the following:\r\n  * - A primitive type like `string` or `number`;\r\n  * - An object containing any number of named properties, each with their own types; or\r\n  * - An array of elements, all of the same type.\r\n  * This metadata is used to validate setting values against the schema, and to enable user interfaces by which\r\n  * users can view and modify their settings.\r\n  * @beta\r\n  */\r\nexport interface SettingSchema extends Readonly<JSONSchema> {\r\n  /** For arrays only, the metadata describing every element in the array. */\r\n  readonly items?: SettingSchema;\r\n  /** The name of the [[Setting]]'s data type. */\r\n  readonly type: JSONSchemaTypeName;\r\n  /** For objects and arrays only, the name of a [[SettingSchema]] that provides a base definition for this type.\r\n   * The name is expected to refer to a type definition registered with [[SettingsSchema.typeDefs]].\r\n   * Therefore, it must be the full name, including the [[SettingGroupSchema.schemaPrefix]].\r\n   */\r\n  readonly extends?: string;\r\n  /** For objects only, the name and metadata of each of the object's properties. */\r\n  readonly properties?: { [name: SettingName]: SettingSchema };\r\n  /** For arrays only, specifies how [[SettingsDictionary.getArray]] resolves the value of the setting.\r\n   * By default, like other types of settings, the setting uses the value of the setting from the highest-priority dictionary.\r\n   * If `combineArray` is `true`, then the value of the setting is computed by combining the elements of every array from every dictionary,\r\n   * ordered by priority and eliminating duplicate elements.\r\n   * Two elements are considered duplicates of one another if [[Setting.areEqual]] returns `true`.\r\n   */\r\n  readonly combineArray?: boolean;\r\n}\r\n\r\n/** Metadata describing a group of related [[SettingSchema]]s. You can register setting schema groups via [[SettingsSchemas.addGroup]] and\r\n  * remove them via [[SettingsSchemas.removeGroup]].\r\n  *\r\n  * All of the settings share the same [[schemaPrefix]], which must be unique amongst all other groups.\r\n  * The prefix is combined with the name of each [[SettingSchema]] in the group to form the fully-qualified name used to refer\r\n  * to the setting outside of the group, e.g., when accessing [[SettingsSchemas.settingDefs]] or in [[SettingSchema.extends]].\r\n  * In the following example, the fully-qualified name of the setting named \"metric\" is \"format/units/metric\".\r\n  *\r\n  * ```json\r\n  *  {\r\n  *    \"schemaPrefix\": \"format/units\",\r\n  *    \"settingDefs\": {\r\n  *      \"metric\": { \"type\": \"boolean\" }\r\n  *    }\r\n  *  }\r\n  * ```\r\n  *\r\n  * A group can also define [[SettingSchema]]s that, rather than describing actual [[Setting]]s, instead describe types that can be extended by [[Setting]]s via\r\n  * [[SettingSchema.extends]]. A [[SettingSchema]] can refer to type definitions defined in its own group or any other group.\r\n  * @beta\r\n  */\r\nexport interface SettingGroupSchema {\r\n  /** Uniquely identifies this group amongst all other groups.\r\n   * The prefix can use forward-slashes to define logical subgroups - for example, two related groups with the prefixes \"units/metric\" and \"units/imperial\".\r\n   * The user interface may parse these prefixes to display both groups under a \"units\" tab or expandable tree view node.\r\n   *\r\n   * @note Schema prefixes beginning with \"itwin\" are reserved for use by iTwin.js.\r\n   */\r\n  readonly schemaPrefix: string;\r\n  /** Metadata for each [[Setting]] in this group. */\r\n  readonly settingDefs?: { [name: string]: SettingSchema | undefined };\r\n  /** Metadata for types that can be extended by other [[Setting]]s via [[SettingSchema.extends]]. */\r\n  readonly typeDefs?: { [name: string]: SettingSchema | undefined };\r\n  /** An integer used when displaying a list of schemas in a user interface, to sort schemas with a lower `order` before those with a `higher` order. */\r\n  readonly order?: number;\r\n  /** A description of this group suitable for displaying to a user. */\r\n  readonly description: string;\r\n}\r\n\r\n/**\r\n * The registry of available [[SettingGroupSchema]]s.\r\n * The registry is used for editing Settings files and for finding default values for settings.\r\n * @beta\r\n */\r\n\r\n/** The registry of metadata describing groups of [[SettingSchema]]s available to the current session.\r\n  * The schemas are used to look up the default values of [[Setting]]s, validate that their values are of the type dictated by the schema, and\r\n  * query metadata like [[SettingsSchema.combineArray]] that modify their behavior.\r\n  * They can also be used to drive a user interface that enables end users to edit [[Settings]].\r\n  *\r\n  * When [[IModelHost.startup]] is invoked at the beginning of a session, schemas delivered with the application - like those describing\r\n  * [[Workspace]]s - are automatically loaded.\r\n  * The application can manually register additional schemas using methods like [[addGroup]], [[addFile]], [[addDirectory]], and [[addJson]].\r\n  * When [[IModelHost.shutdown]] is invoked at the end of a session, all registered schemas are unregistered.\r\n  *\r\n  * See the [learning article]($docs/learning/backend/Workspace) for a detailed overiew and examples.\r\n  *\r\n  * @see [[IModelHost.settingsSchemas]] to access the registry for the current session.\r\n  * @beta\r\n  */\r\nexport interface SettingsSchemas {\r\n  /** @internal */\r\n  readonly [_implementationProhibited]: unknown;\r\n\r\n  /** The map of each individual registered [[SettingSchema]] defining a [[Setting]], accessed by its fully-qualified name (including its [[SettingGroupSchema.schemaPrefix]]). */\r\n  readonly settingDefs: ReadonlyMap<SettingName, SettingSchema>;\r\n\r\n  /** The map of each individual registered [[SettingSchema]] defining a type that can be extended by other [[SettingSchema]]s via [[SettingSchema.extends]],\r\n   * accessed by its fully-qualified name (including its [[SettingGroupSchema.schemaPrefix]]).\r\n   */\r\n  readonly typeDefs: ReadonlyMap<SettingName, SettingSchema>;\r\n\r\n  /** An event raised whenever schemas are added or removed. */\r\n  readonly onSchemaChanged: BeEvent<() => void>;\r\n\r\n  /**\r\n   * Ensure that the setting value supplied is valid according to its [[SettingSchema]].\r\n   * If no schema has been registered for the setting, no validation is performed.\r\n   * @param value The value of the setting to validate against the schema.\r\n   * @param settingName The fully-qualified setting name.\r\n   * @returns `value` if `value` matches the schema corresponding to `settingName`, or if no such schema has been registered.\r\n   * @throws Error if `value` is invalid according to the schema.\r\n   */\r\n  validateSetting<T>(value: T, settingName: SettingName): T;\r\n\r\n  /** Register one or more [[SettingGroupSchema]]s.\r\n   * If a group with the same [[SettingGroupSchema.prefix]] was previously registered, it will be replaced.\r\n   * Each [[SettingSchema]] in the group will be added to [[settingDefs]] or [[typeDefs]].\r\n   */\r\n  addGroup(settingsGroup: SettingGroupSchema | SettingGroupSchema[]): void;\r\n\r\n  /** Invokes [[addGroup]] for a [[SettingGroupSchema]] supplied as stringified json5. */\r\n  addJson(settingSchema: string): void;\r\n\r\n  /** Invokes [[addGroup]] for a json5 file containiner a [[SettingGroupSchema]]. */\r\n  addFile(fileName: LocalFileName): void;\r\n\r\n  /** Invokes [[addFile]] for every json and json5 file in the specified directory. */\r\n  addDirectory(dirName: LocalDirName): void;\r\n\r\n  /** Unregisters all [[settingDefs]] and [[typeDefs]] with the specified [[SettingGroupSchema.schemaPrefix]]. */\r\n  removeGroup(schemaPrefix: string): void;\r\n}\r\n"]}
+{"version":3,"file":"SettingsSchemas.js","sourceRoot":"","sources":["../../../src/workspace/SettingsSchemas.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;AAIH,iDAAgE","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Workspace\n */\n\nimport { BeEvent, JSONSchema, JSONSchemaTypeName } from \"@itwin/core-bentley\";\nimport { LocalDirName, LocalFileName } from \"@itwin/core-common\";\nimport { _implementationProhibited } from \"../internal/Symbols\";\nimport { SettingName } from \"./Settings\";\n\n/** Metadata describing a single [[Setting]] as part of a [[SettingGroupSchema]].\n  * Every setting has a [[type]], which can be one of the following:\n  * - A primitive type like `string` or `number`;\n  * - An object containing any number of named properties, each with their own types; or\n  * - An array of elements, all of the same type.\n  * This metadata is used to validate setting values against the schema, and to enable user interfaces by which\n  * users can view and modify their settings.\n  * @beta\n  */\nexport interface SettingSchema extends Readonly<JSONSchema> {\n  /** For arrays only, the metadata describing every element in the array. */\n  readonly items?: SettingSchema;\n  /** The name of the [[Setting]]'s data type. */\n  readonly type: JSONSchemaTypeName;\n  /** For objects and arrays only, the name of a [[SettingSchema]] that provides a base definition for this type.\n   * The name is expected to refer to a type definition registered with [[SettingsSchema.typeDefs]].\n   * Therefore, it must be the full name, including the [[SettingGroupSchema.schemaPrefix]].\n   */\n  readonly extends?: string;\n  /** For objects only, the name and metadata of each of the object's properties. */\n  readonly properties?: { [name: SettingName]: SettingSchema };\n  /** For arrays only, specifies how [[SettingsDictionary.getArray]] resolves the value of the setting.\n   * By default, like other types of settings, the setting uses the value of the setting from the highest-priority dictionary.\n   * If `combineArray` is `true`, then the value of the setting is computed by combining the elements of every array from every dictionary,\n   * ordered by priority and eliminating duplicate elements.\n   * Two elements are considered duplicates of one another if [[Setting.areEqual]] returns `true`.\n   */\n  readonly combineArray?: boolean;\n}\n\n/** Metadata describing a group of related [[SettingSchema]]s. You can register setting schema groups via [[SettingsSchemas.addGroup]] and\n  * remove them via [[SettingsSchemas.removeGroup]].\n  *\n  * All of the settings share the same [[schemaPrefix]], which must be unique amongst all other groups.\n  * The prefix is combined with the name of each [[SettingSchema]] in the group to form the fully-qualified name used to refer\n  * to the setting outside of the group, e.g., when accessing [[SettingsSchemas.settingDefs]] or in [[SettingSchema.extends]].\n  * In the following example, the fully-qualified name of the setting named \"metric\" is \"format/units/metric\".\n  *\n  * ```json\n  *  {\n  *    \"schemaPrefix\": \"format/units\",\n  *    \"settingDefs\": {\n  *      \"metric\": { \"type\": \"boolean\" }\n  *    }\n  *  }\n  * ```\n  *\n  * A group can also define [[SettingSchema]]s that, rather than describing actual [[Setting]]s, instead describe types that can be extended by [[Setting]]s via\n  * [[SettingSchema.extends]]. A [[SettingSchema]] can refer to type definitions defined in its own group or any other group.\n  * @beta\n  */\nexport interface SettingGroupSchema {\n  /** Uniquely identifies this group amongst all other groups.\n   * The prefix can use forward-slashes to define logical subgroups - for example, two related groups with the prefixes \"units/metric\" and \"units/imperial\".\n   * The user interface may parse these prefixes to display both groups under a \"units\" tab or expandable tree view node.\n   *\n   * @note Schema prefixes beginning with \"itwin\" are reserved for use by iTwin.js.\n   */\n  readonly schemaPrefix: string;\n  /** Metadata for each [[Setting]] in this group. */\n  readonly settingDefs?: { [name: string]: SettingSchema | undefined };\n  /** Metadata for types that can be extended by other [[Setting]]s via [[SettingSchema.extends]]. */\n  readonly typeDefs?: { [name: string]: SettingSchema | undefined };\n  /** An integer used when displaying a list of schemas in a user interface, to sort schemas with a lower `order` before those with a `higher` order. */\n  readonly order?: number;\n  /** A description of this group suitable for displaying to a user. */\n  readonly description: string;\n}\n\n/**\n * The registry of available [[SettingGroupSchema]]s.\n * The registry is used for editing Settings files and for finding default values for settings.\n * @beta\n */\n\n/** The registry of metadata describing groups of [[SettingSchema]]s available to the current session.\n  * The schemas are used to look up the default values of [[Setting]]s, validate that their values are of the type dictated by the schema, and\n  * query metadata like [[SettingsSchema.combineArray]] that modify their behavior.\n  * They can also be used to drive a user interface that enables end users to edit [[Settings]].\n  *\n  * When [[IModelHost.startup]] is invoked at the beginning of a session, schemas delivered with the application - like those describing\n  * [[Workspace]]s - are automatically loaded.\n  * The application can manually register additional schemas using methods like [[addGroup]], [[addFile]], [[addDirectory]], and [[addJson]].\n  * When [[IModelHost.shutdown]] is invoked at the end of a session, all registered schemas are unregistered.\n  *\n  * See the [learning article]($docs/learning/backend/Workspace) for a detailed overiew and examples.\n  *\n  * @see [[IModelHost.settingsSchemas]] to access the registry for the current session.\n  * @beta\n  */\nexport interface SettingsSchemas {\n  /** @internal */\n  readonly [_implementationProhibited]: unknown;\n\n  /** The map of each individual registered [[SettingSchema]] defining a [[Setting]], accessed by its fully-qualified name (including its [[SettingGroupSchema.schemaPrefix]]). */\n  readonly settingDefs: ReadonlyMap<SettingName, SettingSchema>;\n\n  /** The map of each individual registered [[SettingSchema]] defining a type that can be extended by other [[SettingSchema]]s via [[SettingSchema.extends]],\n   * accessed by its fully-qualified name (including its [[SettingGroupSchema.schemaPrefix]]).\n   */\n  readonly typeDefs: ReadonlyMap<SettingName, SettingSchema>;\n\n  /** An event raised whenever schemas are added or removed. */\n  readonly onSchemaChanged: BeEvent<() => void>;\n\n  /**\n   * Ensure that the setting value supplied is valid according to its [[SettingSchema]].\n   * If no schema has been registered for the setting, no validation is performed.\n   * @param value The value of the setting to validate against the schema.\n   * @param settingName The fully-qualified setting name.\n   * @returns `value` if `value` matches the schema corresponding to `settingName`, or if no such schema has been registered.\n   * @throws Error if `value` is invalid according to the schema.\n   */\n  validateSetting<T>(value: T, settingName: SettingName): T;\n\n  /** Register one or more [[SettingGroupSchema]]s.\n   * If a group with the same [[SettingGroupSchema.prefix]] was previously registered, it will be replaced.\n   * Each [[SettingSchema]] in the group will be added to [[settingDefs]] or [[typeDefs]].\n   */\n  addGroup(settingsGroup: SettingGroupSchema | SettingGroupSchema[]): void;\n\n  /** Invokes [[addGroup]] for a [[SettingGroupSchema]] supplied as stringified json5. */\n  addJson(settingSchema: string): void;\n\n  /** Invokes [[addGroup]] for a json5 file containiner a [[SettingGroupSchema]]. */\n  addFile(fileName: LocalFileName): void;\n\n  /** Invokes [[addFile]] for every json and json5 file in the specified directory. */\n  addDirectory(dirName: LocalDirName): void;\n\n  /** Unregisters all [[settingDefs]] and [[typeDefs]] with the specified [[SettingGroupSchema.schemaPrefix]]. */\n  removeGroup(schemaPrefix: string): void;\n}\n"]}

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

@@ -2,10 +2,11 @@
  * @module Workspace
  */
 import { AccessToken, BeEvent, ITwinError, Optional } from "@itwin/core-bentley";
-import { LocalDirName, LocalFileName } from "@itwin/core-common";
+import { DbCloudContainerInfo, LocalDirName, LocalFileName } from "@itwin/core-common";
 import { CloudSqlite } from "../CloudSqlite";
 import { SQLiteDb } from "../SQLiteDb";
 import { SettingName, Settings, SettingsDictionary, SettingsPriority } from "./Settings";
+import { GetSettingsDbArgs, SettingsDb } from "./SettingsDb";
 import type { IModelJsNative } from "@bentley/imodeljs-native";
 import { _implementationProhibited } from "../internal/Symbols";
 /** The unique identifier of a [[WorkspaceContainer]]. This becomes the base name for a local file directory holding the container's [[WorkspaceDb]]s.
@@ -71,7 +72,8 @@ export interface WorkspaceDbProps extends WorkspaceDbNameAndVersion {
 /** Properties describing a [[WorkspaceDb]] and the [[WorkspaceContainer]] containing it.
  * @beta
  */
-export type WorkspaceDbCloudProps = WorkspaceDbProps & WorkspaceContainerProps;
+export interface WorkspaceDbCloudProps extends WorkspaceDbProps, WorkspaceContainerProps, DbCloudContainerInfo {
+}
 /** A function supplied as [[WorkspaceDbQueryResourcesArgs.callback]] to be invoked to process the requested resources.
  * @beta
  */
@@ -141,8 +143,12 @@ export interface WorkspaceDbLoadErrors extends ITwinError {
   * @beta
   */
 export interface WorkspaceDbSettingsProps extends WorkspaceDbCloudProps {
-    /** The name of the resource holding the stringified JSON of the [[SettingsDictionary]]. */
-    resourceName: string;
+    /** The name of the resource holding the stringified JSON of the [[SettingsDictionary]].
+     * Defaults to `"settings"`, which matches the key used by
+     * [[EditableSettingsDb.updateSettings]] to write settings. You should generally omit this
+     * field unless you need to load settings stored under a non-standard key.
+     */
+    resourceName?: string;
     /** The priority to assign to the [[SettingsDictionary]]. */
     priority: SettingsPriority;
 }
@@ -318,6 +324,13 @@ export interface Workspace {
     problems?: WorkspaceDbLoadError[]): Promise<void>;
     /** Get a single [[WorkspaceDb]].  */
     getWorkspaceDb(props: WorkspaceDbCloudProps): Promise<WorkspaceDb>;
+    /** Get a [[SettingsDb]] from a previously-loaded settings container in this workspace.
+     * @param args The arguments identifying which SettingsDb to retrieve.
+     * @returns The SettingsDb from the matching container.
+     * @throws if no container matching [[GetSettingsDbArgs.containerId]] has been loaded into this workspace, or if the container does not hold a SettingsDb.
+     * @note The container must already be loaded via [[getContainer]] or [[getContainerAsync]] before calling this method.
+     */
+    getSettingsDb(args: GetSettingsDbArgs): SettingsDb;
     /**
      * Resolve the value of all [[Setting]]s from this workspace with the supplied `settingName` into an array of [[WorkspaceDbCloudProps]]
      * that can be used to query or load workspace resources. The settings must each be an array of type [[WorkspaceDbSettingsProps]].
@@ -347,38 +360,48 @@ export interface Workspace {
     }): Promise<WorkspaceDb[]>;
 }
 /**
- * A WorkspaceContainer is a type of [[CloudSqlite.CloudContainer]] that holds one or more [[WorkspaceDb]]s. Normally a WorkspaceContainer will hold (many versions of) a single WorkspaceDb.
- * Each version of a WorkspaceDb is treated as immutable after it is created and is stored in the WorkspaceContainer indefinitely. That means that
- * older versions of the WorkspaceDb may continue to be used, for example by archived projects. For programmers familiar with [NPM](https://www.npmjs.com/), this is conceptually
- * similar and versioning follows the same rules as NPM using [Semantic Versioning](https://semver.org/).
- * @note It is possible to store more than one WorkspaceDb in the same WorkspaceContainer, but access rights are administered per WorkspaceContainer.
- * That is, if a user has rights to access a WorkspaceContainer, that right applies to all WorkspaceDbs in the WorkspaceContainer.
- * @note Not every WorkspaceContainer is associated with a [[CloudSqlite.CloudContainer]] - WorkspaceContainers may also be loaded from the local file system.
+ * Base interface for containers backed by [[CloudSqlite]] that hold versioned databases (e.g. [[WorkspaceDb]]s or [[SettingsDb]]s).
+ * Provides the shared infrastructure for cloud access, local file caching, and semver-based database resolution.
+ * @note Not every container is associated with a [[CloudSqlite.CloudContainer]] — containers may also be loaded from the local file system.
  * In this case, [[cloudContainer]] will be `undefined`.
- * @see [[Workspace.getContainer]] and [[Workspace.getContainerAsync]] to load a container.
+ * @see [[WorkspaceContainer]] for workspace-specific containers.
  * @beta
  */
-export interface WorkspaceContainer {
+export interface CloudSqliteContainer {
     /** @internal */
     [_implementationProhibited]: unknown;
-    /** the local directory where this WorkspaceContainer will store temporary files extracted for file-resources.
+    /** the local directory where this container will store temporary files extracted for file-resources.
      * @internal
      */
     readonly filesDir: LocalDirName;
     /** The workspace into which this container was loaded. */
     readonly workspace: Workspace;
-    /** Cloud container for this WorkspaceContainer, or `undefined` if this is a local WorkspaceContainer. */
+    /** Cloud container for this container, or `undefined` if this is a local container. */
     readonly cloudContainer?: CloudSqlite.CloudContainer;
     /** Properties supplied when this container was loaded */
     readonly fromProps: WorkspaceContainerProps;
-    /** @internal */
-    addWorkspaceDb(toAdd: WorkspaceDb): void;
     /**
-     * Find the fully-qualified name of a [[WorkspaceDb]] satisfying the name and version criteria specified by `props`.
+     * Find the fully-qualified name of a database satisfying the name and version criteria specified by `props`.
      * @throws Error if no version satisfying the criteria exists.
      */
     resolveDbFileName(props: WorkspaceDbProps): WorkspaceDbFullName;
-    /** Obtain a [[WorkspaceDb]] satisfying the name and version criteria specified by `props`. */
+}
+/**
+ * A [[CloudSqliteContainer]] that holds one or more [[WorkspaceDb]]s. Normally a WorkspaceContainer will hold (many versions of) a single WorkspaceDb.
+ * Each version of a WorkspaceDb is treated as immutable after it is created and is stored in the WorkspaceContainer indefinitely. That means that
+ * older versions of the WorkspaceDb may continue to be used, for example by archived projects. For programmers familiar with [NPM](https://www.npmjs.com/), this is conceptually
+ * similar and versioning follows the same rules as NPM using [Semantic Versioning](https://semver.org/).
+ * @note It is possible to store more than one WorkspaceDb in the same WorkspaceContainer, but access rights are administered per WorkspaceContainer.
+ * That is, if a user has rights to access a WorkspaceContainer, that right applies to all WorkspaceDbs in the WorkspaceContainer.
+ * @see [[Workspace.getContainer]] and [[Workspace.getContainerAsync]] to load a container.
+ * @beta
+ */
+export interface WorkspaceContainer extends CloudSqliteContainer {
+    /** @internal */
+    addWorkspaceDb(toAdd: WorkspaceDb): void;
+    /** Obtain a [[WorkspaceDb]] satisfying the name and version criteria specified by `props`.
+     * Repeated calls that resolve to the same WorkspaceDb return the same cached instance until it is closed.
+     */
     getWorkspaceDb(props?: WorkspaceDbProps): WorkspaceDb;
     /** Close and remove a currently opened [[WorkspaceDb]] from this Workspace.
      * @internal

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

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