@itwin/core-backend 5.11.0-dev.9 → 5.12.0-dev.2

package/lib/esm/workspace/SettingsEditor.js

@@ -77,8 +77,10 @@ export var SettingsContainers;
     }
     SettingsContainers.getITwinContainerId = getITwinContainerId;
     /**
-     * Look up the settings container for an iTwin and obtain a read-only access token.
-     * @returns container props needed by [[IModelHost.getITwinWorkspace]].
+     * Look up settings containers for an iTwin and its account iTwin and obtain read-only access tokens.
+     * @returns Container props needed by [[IModelHost.getITwinWorkspace]]. The requested iTwin's settings
+     * container is returned at [[SettingsPriority.iTwin]]; the account iTwin container is returned at
+     * [[SettingsPriority.organization]].
      * @note Requires [[IModelHost.authorizationClient]] to be configured.
      * @note Requires [[BlobContainer.service]] to be configured.
      */
@@ -86,25 +88,39 @@ export var SettingsContainers;
         if (undefined === BlobContainer.service)
             ITwinSettingsError.throwError("blob-service-unavailable", { message: "BlobContainer.service is not available." });
         const userToken = await IModelHost.getAccessToken();
-        const containers = await queryContainers({ iTwinId });
-        if (!containers || containers.length === 0)
+        const containers = await queryContainers({ iTwinId, includeParentITwins: { filter: "accountOnly" } });
+        if (containers.length === 0)
             return undefined;
-        if (containers.length > 1) {
-            ITwinSettingsError.throwError("multiple-itwin-settings-containers", {
-                message: `Multiple iTwin settings containers were found for '${iTwinId}', so a container cannot be automatically selected.`,
-                iTwinId,
-            });
-        }
-        const tokenProps = await BlobContainer.service.requestToken({ containerId: containers[0].containerId, accessLevel: "read", userToken });
-        return [{
+        const seenITwins = new Set();
+        const results = [];
+        for (const container of containers) {
+            const ownerITwinId = container.iTwinId;
+            if (undefined === ownerITwinId) {
+                ITwinSettingsError.throwError("missing-container-itwinid", {
+                    message: `Settings container '${container.containerId}' has no iTwinId. Please upgrade to a newer version of the BlobContainer service that populates iTwinId in query results.`,
+                    iTwinId,
+                });
+            }
+            if (seenITwins.has(ownerITwinId)) {
+                ITwinSettingsError.throwError("multiple-itwin-settings-containers", {
+                    message: `Multiple iTwin settings containers were found for '${ownerITwinId}', so a container cannot be automatically selected.`,
+                    iTwinId: ownerITwinId,
+                });
+            }
+            seenITwins.add(ownerITwinId);
+            const priority = container.accountITwinId === ownerITwinId ? SettingsPriority.organization : SettingsPriority.iTwin;
+            const tokenProps = await BlobContainer.service.requestToken({ containerId: container.containerId, accessLevel: "read", userToken });
+            results.push({
                 baseUri: tokenProps.baseUri,
-                containerId: containers[0].containerId,
+                containerId: container.containerId,
                 storageType: tokenProps.provider,
                 accessToken: tokenProps.token,
-                priority: SettingsPriority.iTwin,
+                priority,
                 dbName: settingsWorkspaceDbName,
                 includePrerelease: true,
-            }];
+            });
+        }
+        return results;
     }
     SettingsContainers.getITwinSettingsSources = getITwinSettingsSources;
 })(SettingsContainers || (SettingsContainers = {}));

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

@@ -1 +1 @@
-{"version":3,"file":"SettingsEditor.js","sourceRoot":"","sources":["../../../src/workspace/SettingsEditor.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Workspace\n */\n\nimport { ITwinSettingsError } from \"@itwin/core-common\";\nimport { GuidString } from \"@itwin/core-bentley\";\nimport { WorkspaceContainerId, WorkspaceDbSettingsProps } from \"./Workspace\";\nimport { BlobContainer } from \"../BlobContainerService\";\nimport { IModelHost } from \"../IModelHost\";\nimport { constructSettingsEditorForITwin, getSettingsEditorForITwin } from \"../internal/workspace/SettingsEditorImpl\";\nimport { EditableWorkspaceContainer, WorkspaceEditor } from \"./WorkspaceEditor\";\nimport { SettingsPriority } from \"./Settings\";\nimport { settingsWorkspaceDbName } from \"./SettingsDb\";\n\n/** The default resource name used to store settings in a [[WorkspaceDb]].\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 = \"settingsDictionary\";\n\n/** @internal */\nexport namespace SettingsEditor {\n  /** The type of workspace container used to store settings. */\n  export const containerType = \"settings\";\n\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 async function constructForITwin(iTwinId: GuidString): Promise<{ editor: WorkspaceEditor; container: EditableWorkspaceContainer }> {\n    return constructSettingsEditorForITwin(iTwinId);\n  }\n\n  /**\n   * Obtain a [[SettingsEditor]] for the existing settings container associated with an iTwin.\n   * @returns The editor and container, or `undefined` if no settings container exists for the iTwin.\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 async function getForITwin(iTwinId: GuidString): Promise<{ editor: WorkspaceEditor; container: EditableWorkspaceContainer } | undefined> {\n    return getSettingsEditorForITwin(iTwinId);\n  }\n}\n\n/**\n * Help locate and obtain access to known containers with type \"settings\".\n * @internal\n */\nexport namespace SettingsContainers {\n  /** Arguments for [[SettingsContainers.queryContainers]]. */\n  export interface QueryArgs {\n    /** The iTwinId whose settings containers should be queried. */\n    iTwinId: 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   * Automatically filters by `containerType: \"settings\"`.\n   * @note Requires [[IModelHost.authorizationClient]] to be configured.\n   */\n  async function queryContainers(args: QueryArgs): Promise<BlobContainer.MetadataResponse[]> {\n    if (undefined === BlobContainer.service)\n      ITwinSettingsError.throwError(\"blob-service-unavailable\", { message: \"BlobContainer.service is not available.\" });\n\n    const userToken = await IModelHost.getAccessToken();\n    return BlobContainer.service.queryContainersMetadata(userToken, { ...args, containerType: SettingsEditor.containerType });\n  }\n\n  /**\n   * Query the [[BlobContainer]] service for the single settings container associated with a given iTwin.\n   * @returns The containerId, or `undefined` if no container exists.\n   * @throws if more than one settings container is found.\n   */\n  export async function getITwinContainerId(iTwinId: GuidString): Promise<WorkspaceContainerId | undefined> {\n    const containers = await queryContainers({ iTwinId });\n    if (containers.length > 1) {\n      ITwinSettingsError.throwError(\"multiple-itwin-settings-containers\", {\n        message: `Multiple iTwin settings containers were found for '${iTwinId}', so a container cannot be automatically selected.`,\n        iTwinId,\n      });\n    }\n    return containers[0]?.containerId;\n  }\n\n  /**\n   * Look up the settings container for an iTwin and obtain a read-only access token.\n   * @returns container props needed by [[IModelHost.getITwinWorkspace]].\n   * @note Requires [[IModelHost.authorizationClient]] to be configured.\n   * @note Requires [[BlobContainer.service]] to be configured.\n   */\n  export async function getITwinSettingsSources(iTwinId: GuidString): Promise<WorkspaceDbSettingsProps[] | undefined> {\n    if (undefined === BlobContainer.service)\n      ITwinSettingsError.throwError(\"blob-service-unavailable\", { message: \"BlobContainer.service is not available.\" });\n\n    const userToken = await IModelHost.getAccessToken();\n    const containers = await queryContainers({ iTwinId });\n    if (!containers || containers.length === 0) return undefined;\n    if (containers.length > 1) {\n      ITwinSettingsError.throwError(\"multiple-itwin-settings-containers\", {\n        message: `Multiple iTwin settings containers were found for '${iTwinId}', so a container cannot be automatically selected.`,\n        iTwinId,\n      });\n    }\n\n    const tokenProps = await BlobContainer.service.requestToken({ containerId: containers[0].containerId, accessLevel: \"read\", userToken });\n    return [{\n      baseUri: tokenProps.baseUri,\n      containerId: containers[0].containerId,\n      storageType: tokenProps.provider,\n      accessToken: tokenProps.token,\n      priority: SettingsPriority.iTwin,\n      dbName: settingsWorkspaceDbName,\n      includePrerelease: true,\n    }];\n  }\n}\n"]}
+{"version":3,"file":"SettingsEditor.js","sourceRoot":"","sources":["../../../src/workspace/SettingsEditor.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Workspace\n */\n\nimport { ITwinSettingsError } from \"@itwin/core-common\";\nimport { GuidString } from \"@itwin/core-bentley\";\nimport { WorkspaceContainerId, WorkspaceDbSettingsProps } from \"./Workspace\";\nimport { BlobContainer } from \"../BlobContainerService\";\nimport { IModelHost } from \"../IModelHost\";\nimport { constructSettingsEditorForITwin, getSettingsEditorForITwin } from \"../internal/workspace/SettingsEditorImpl\";\nimport { EditableWorkspaceContainer, WorkspaceEditor } from \"./WorkspaceEditor\";\nimport { SettingsPriority } from \"./Settings\";\nimport { settingsWorkspaceDbName } from \"./SettingsDb\";\n\n/** The default resource name used to store settings in a [[WorkspaceDb]].\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 = \"settingsDictionary\";\n\n/** @internal */\nexport namespace SettingsEditor {\n  /** The type of workspace container used to store settings. */\n  export const containerType = \"settings\";\n\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 async function constructForITwin(iTwinId: GuidString): Promise<{ editor: WorkspaceEditor; container: EditableWorkspaceContainer }> {\n    return constructSettingsEditorForITwin(iTwinId);\n  }\n\n  /**\n   * Obtain a [[SettingsEditor]] for the existing settings container associated with an iTwin.\n   * @returns The editor and container, or `undefined` if no settings container exists for the iTwin.\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 async function getForITwin(iTwinId: GuidString): Promise<{ editor: WorkspaceEditor; container: EditableWorkspaceContainer } | undefined> {\n    return getSettingsEditorForITwin(iTwinId);\n  }\n}\n\n/**\n * Help locate and obtain access to known containers with type \"settings\".\n * @internal\n */\nexport namespace SettingsContainers {\n  /**\n   * Query the [[BlobContainer]] service for all settings containers associated with a given iTwin.\n   * Automatically filters by `containerType: \"settings\"`.\n   * @note Requires [[IModelHost.authorizationClient]] to be configured.\n   */\n  async function queryContainers(args: BlobContainer.QueryContainerProps): Promise<BlobContainer.MetadataResponse[]> {\n    if (undefined === BlobContainer.service)\n      ITwinSettingsError.throwError(\"blob-service-unavailable\", { message: \"BlobContainer.service is not available.\" });\n\n    const userToken = await IModelHost.getAccessToken();\n    return BlobContainer.service.queryContainersMetadata(userToken, { ...args, containerType: SettingsEditor.containerType });\n  }\n\n  /**\n   * Query the [[BlobContainer]] service for the single settings container associated with a given iTwin.\n   * @returns The containerId, or `undefined` if no container exists.\n   * @throws if more than one settings container is found.\n   */\n  export async function getITwinContainerId(iTwinId: GuidString): Promise<WorkspaceContainerId | undefined> {\n    const containers = await queryContainers({ iTwinId });\n    if (containers.length > 1) {\n      ITwinSettingsError.throwError(\"multiple-itwin-settings-containers\", {\n        message: `Multiple iTwin settings containers were found for '${iTwinId}', so a container cannot be automatically selected.`,\n        iTwinId,\n      });\n    }\n    return containers[0]?.containerId;\n  }\n\n  /**\n   * Look up settings containers for an iTwin and its account iTwin and obtain read-only access tokens.\n   * @returns Container props needed by [[IModelHost.getITwinWorkspace]]. The requested iTwin's settings\n   * container is returned at [[SettingsPriority.iTwin]]; the account iTwin container is returned at\n   * [[SettingsPriority.organization]].\n   * @note Requires [[IModelHost.authorizationClient]] to be configured.\n   * @note Requires [[BlobContainer.service]] to be configured.\n   */\n  export async function getITwinSettingsSources(iTwinId: GuidString): Promise<WorkspaceDbSettingsProps[] | undefined> {\n    if (undefined === BlobContainer.service)\n      ITwinSettingsError.throwError(\"blob-service-unavailable\", { message: \"BlobContainer.service is not available.\" });\n\n    const userToken = await IModelHost.getAccessToken();\n    const containers = await queryContainers({ iTwinId, includeParentITwins: { filter: \"accountOnly\" } });\n    if (containers.length === 0) return undefined;\n\n    const seenITwins = new Set<string>();\n    const results: WorkspaceDbSettingsProps[] = [];\n    for (const container of containers) {\n      const ownerITwinId = container.iTwinId;\n      if (undefined === ownerITwinId) {\n        ITwinSettingsError.throwError(\"missing-container-itwinid\", {\n          message: `Settings container '${container.containerId}' has no iTwinId. Please upgrade to a newer version of the BlobContainer service that populates iTwinId in query results.`,\n          iTwinId,\n        });\n      }\n      if (seenITwins.has(ownerITwinId)) {\n        ITwinSettingsError.throwError(\"multiple-itwin-settings-containers\", {\n          message: `Multiple iTwin settings containers were found for '${ownerITwinId}', so a container cannot be automatically selected.`,\n          iTwinId: ownerITwinId,\n        });\n      }\n      seenITwins.add(ownerITwinId);\n\n      const priority = container.accountITwinId === ownerITwinId ? SettingsPriority.organization : SettingsPriority.iTwin;\n      const tokenProps = await BlobContainer.service.requestToken({ containerId: container.containerId, accessLevel: \"read\", userToken });\n      results.push({\n        baseUri: tokenProps.baseUri,\n        containerId: container.containerId,\n        storageType: tokenProps.provider,\n        accessToken: tokenProps.token,\n        priority,\n        dbName: settingsWorkspaceDbName,\n        includePrerelease: true,\n      });\n    }\n\n    return results;\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itwin/core-backend",
-  "version": "5.11.0-dev.9",
+  "version": "5.12.0-dev.2",
   "description": "iTwin.js backend components",
   "main": "lib/cjs/core-backend.js",
   "module": "lib/esm/core-backend.js",
@@ -27,10 +27,10 @@
   },
   "peerDependencies": {
     "@opentelemetry/api": "^1.0.4",
-    "@itwin/core-bentley": "5.11.0-dev.9",
-    "@itwin/ecschema-metadata": "5.11.0-dev.9",
-    "@itwin/core-common": "5.11.0-dev.9",
-    "@itwin/core-geometry": "5.11.0-dev.9"
+    "@itwin/core-bentley": "5.12.0-dev.2",
+    "@itwin/core-common": "5.12.0-dev.2",
+    "@itwin/ecschema-metadata": "5.12.0-dev.2",
+    "@itwin/core-geometry": "5.12.0-dev.2"
   },
   "peerDependenciesMeta": {
     "@opentelemetry/api": {
@@ -77,27 +77,27 @@
     "marked": "^14.1.3",
     "sql-formatter": "^15.4.6",
     "webpack": "^5.97.1",
-    "@itwin/build-tools": "5.11.0-dev.9",
-    "@itwin/core-common": "5.11.0-dev.9",
-    "@itwin/ecschema-metadata": "5.11.0-dev.9",
-    "@itwin/ecschema-locaters": "5.11.0-dev.9",
-    "@itwin/core-bentley": "5.11.0-dev.9",
-    "internal-tools": "3.0.0-dev.69",
-    "@itwin/core-geometry": "5.11.0-dev.9",
-    "@itwin/ecsql-common": "5.11.0-dev.9"
+    "@itwin/core-bentley": "5.12.0-dev.2",
+    "@itwin/build-tools": "5.12.0-dev.2",
+    "@itwin/ecschema-metadata": "5.12.0-dev.2",
+    "@itwin/core-common": "5.12.0-dev.2",
+    "@itwin/ecschema-locaters": "5.12.0-dev.2",
+    "@itwin/core-geometry": "5.12.0-dev.2",
+    "@itwin/ecsql-common": "5.12.0-dev.2",
+    "internal-tools": "3.0.0-dev.69"
   },
   "dependencies": {
-    "@bentley/imodeljs-native": "5.11.4",
+    "@bentley/imodeljs-native": "5.12.0",
     "@itwin/object-storage-azure": "^3.0.4",
     "@azure/storage-blob": "^12.28.0",
-    "form-data": "^4.0.4",
+    "form-data": "^4.0.6",
     "fs-extra": "^8.1.0",
     "json5": "^2.2.3",
     "linebreak": "^1.1.0",
     "multiparty": "^4.3.0",
     "semver": "^7.5.2",
     "touch": "^3.1.0",
-    "ws": "^7.5.10"
+    "ws": "^7.5.11"
   },
   "nyc": {
     "extends": "./node_modules/@itwin/build-tools/.nycrc"

package/lib/esm/test/misc/GeoServices.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=GeoServices.test.d.ts.map

package/lib/esm/test/misc/GeoServices.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"GeoServices.test.d.ts","sourceRoot":"","sources":["../../../../src/test/misc/GeoServices.test.ts"],"names":[],"mappings":""}