@itwin/presentation-backend 5.0.0-dev.11 → 5.0.0-dev.111

package/lib/esm/presentation-backend/PresentationRpcImpl.js

@@ -0,0 +1,409 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module RPC
+ */
+import { IModelDb, RpcTrace } from "@itwin/core-backend";
+import { BeEvent, ErrorCategory, Logger, omit, StatusCategory, SuccessCategory } from "@itwin/core-bentley";
+import { RpcPendingResponse } from "@itwin/core-common";
+import { ContentFlags, DefaultContentDisplayTypes, KeySet, PresentationError, PresentationRpcInterface, PresentationStatus, RulesetVariable, SelectClassInfo, } from "@itwin/presentation-common";
+import { buildElementProperties, createCancellableTimeoutPromise, deepReplaceNullsToUndefined } from "@itwin/presentation-common/internal";
+// @ts-expect-error TS complains about `with` in CJS builds; The path is fine at runtime, but not at compile time
+// eslint-disable-next-line @itwin/import-within-package
+import packageJson from "../../../package.json" with { type: "json" };
+import { PresentationBackendLoggerCategory } from "./BackendLoggerCategory.js";
+import { Presentation } from "./Presentation.js";
+import { DESCRIPTOR_ONLY_CONTENT_FLAG, getRulesetIdObject } from "./PresentationManagerDetail.js";
+import { TemporaryStorage } from "./TemporaryStorage.js";
+import { _presentation_manager_detail } from "./InternalSymbols.js";
+const packageJsonVersion = packageJson.version;
+/** @internal */
+export const MAX_ALLOWED_PAGE_SIZE = 1000;
+/** @internal */
+export const MAX_ALLOWED_KEYS_PAGE_SIZE = 10000;
+const DEFAULT_REQUEST_TIMEOUT = 5000;
+/**
+ * The backend implementation of PresentationRpcInterface. All it's basically
+ * responsible for is forwarding calls to [[Presentation.manager]].
+ *
+ * @internal
+ */
+export class PresentationRpcImpl extends PresentationRpcInterface {
+    _requestTimeout;
+    _pendingRequests;
+    _cancelEvents;
+    _statusHandler;
+    constructor(props) {
+        super();
+        this._requestTimeout = props?.requestTimeout ?? DEFAULT_REQUEST_TIMEOUT;
+        this._pendingRequests = new TemporaryStorage({
+            // remove the pending request after request timeout + 10 seconds - this gives
+            // frontend 10 seconds to re-send the request until it's removed from requests' cache
+            unusedValueLifetime: this._requestTimeout > 0 ? this._requestTimeout + 10 * 1000 : undefined,
+            // attempt to clean up every second
+            cleanupInterval: 1000,
+            cleanupHandler: (id, _, reason) => {
+                if (reason !== "request") {
+                    Logger.logTrace(PresentationBackendLoggerCategory.Rpc, `Cleaning up request without frontend retrieving it: ${id}.`);
+                    /* c8 ignore next */
+                    this._cancelEvents.get(id)?.raiseEvent();
+                }
+                this._cancelEvents.delete(id);
+            },
+        });
+        this._cancelEvents = new Map();
+        this._statusHandler = createStatusCategoryHandler();
+        StatusCategory.handlers.add(this._statusHandler);
+    }
+    [Symbol.dispose]() {
+        this._pendingRequests[Symbol.dispose]();
+        StatusCategory.handlers.delete(this._statusHandler);
+    }
+    get requestTimeout() {
+        return this._requestTimeout;
+    }
+    get pendingRequests() {
+        return this._pendingRequests;
+    }
+    /** Returns an ok response with result inside */
+    successResponse(result, diagnostics) {
+        return {
+            statusCode: PresentationStatus.Success,
+            result,
+            diagnostics,
+        };
+    }
+    /** Returns a bad request response with empty result and an error code */
+    errorResponse(errorCode, errorMessage, diagnostics) {
+        return {
+            statusCode: errorCode,
+            result: undefined,
+            errorMessage,
+            diagnostics,
+        };
+    }
+    /**
+     * Get the [[PresentationManager]] used by this RPC impl.
+     */
+    getManager(clientId) {
+        return Presentation.getManager(clientId);
+    }
+    async getIModel(token) {
+        const imodel = IModelDb.findByKey(token.key);
+        // call refreshContainer, just in case this is a V2 checkpoint whose sasToken is about to expire, or its default transaction is about to be restarted.
+        await imodel.refreshContainerForRpc(RpcTrace.expectCurrentActivity.accessToken);
+        return imodel;
+    }
+    async makeRequest(token, requestId, requestOptions, request) {
+        const serializedRequestOptionsForLogging = JSON.stringify({
+            ...omit(requestOptions, ["rulesetOrId"]),
+            ...(requestOptions.rulesetOrId ? { rulesetId: getRulesetIdObject(requestOptions.rulesetOrId).uniqueId } : undefined),
+        });
+        Logger.logInfo(PresentationBackendLoggerCategory.Rpc, `Received '${requestId}' request. Params: ${serializedRequestOptionsForLogging}`);
+        const imodel = await this.getIModel(token);
+        const requestKey = JSON.stringify({ iModelKey: token.key, requestId, requestOptions });
+        let resultPromise = this._pendingRequests.getValue(requestKey);
+        if (resultPromise) {
+            Logger.logTrace(PresentationBackendLoggerCategory.Rpc, `Request already pending`);
+        }
+        else {
+            Logger.logTrace(PresentationBackendLoggerCategory.Rpc, `Request not found, creating a new one`);
+            const { clientId: _, diagnostics: diagnosticsOptions, rulesetVariables, ...options } = requestOptions;
+            const managerRequestOptions = {
+                ...options,
+                imodel,
+                cancelEvent: new BeEvent(),
+            };
+            // set up ruleset variables
+            if (rulesetVariables) {
+                managerRequestOptions.rulesetVariables = rulesetVariables.map(RulesetVariable.fromJSON);
+            }
+            // set up diagnostics listener
+            let diagnostics;
+            const getDiagnostics = () => {
+                if (!diagnostics) {
+                    diagnostics = {};
+                }
+                return diagnostics;
+            };
+            if (diagnosticsOptions) {
+                if (diagnosticsOptions.backendVersion) {
+                    getDiagnostics().backendVersion = packageJsonVersion;
+                }
+                managerRequestOptions.diagnostics = {
+                    ...diagnosticsOptions,
+                    handler: (d) => {
+                        if (d.logs) {
+                            const target = getDiagnostics();
+                            if (target.logs) {
+                                target.logs.push(...d.logs);
+                            }
+                            else {
+                                target.logs = [...d.logs];
+                            }
+                        }
+                    },
+                };
+            }
+            // initiate request
+            resultPromise = request(managerRequestOptions).then((result) => this.successResponse(result, diagnostics));
+            // store the request promise
+            this._pendingRequests.addValue(requestKey, resultPromise);
+            this._cancelEvents.set(requestKey, managerRequestOptions.cancelEvent);
+        }
+        if (this._requestTimeout === 0) {
+            Logger.logTrace(PresentationBackendLoggerCategory.Rpc, `Request timeout not configured, returning promise without a timeout.`);
+            void resultPromise.finally(() => {
+                this._pendingRequests.deleteValue(requestKey);
+            });
+            return resultPromise;
+        }
+        Logger.logTrace(PresentationBackendLoggerCategory.Rpc, `Returning a promise with a timeout of ${this._requestTimeout}.`);
+        const timeout = createCancellableTimeoutPromise(this._requestTimeout);
+        return Promise.race([
+            resultPromise,
+            timeout.promise.then(() => {
+                // eslint-disable-next-line @typescript-eslint/only-throw-error
+                throw new RpcPendingResponse("Timeout");
+            }),
+        ])
+            .then((response) => {
+            Logger.logTrace(PresentationBackendLoggerCategory.Rpc, `Request completed, returning result.`);
+            this._pendingRequests.deleteValue(requestKey);
+            return response;
+        })
+            .finally(() => {
+            timeout.cancel();
+        });
+    }
+    async getNodesCount(token, requestOptions) {
+        return this.makeRequest(token, "getNodesCount", requestOptions, async (options) => {
+            return this.getManager(requestOptions.clientId).getNodesCount(options);
+        });
+    }
+    async getPagedNodes(token, requestOptions) {
+        return this.makeRequest(token, "getPagedNodes", requestOptions, async (options) => {
+            options = enforceValidPageSize(options);
+            const [serializedHierarchyLevel, count] = await Promise.all([
+                this.getManager(requestOptions.clientId)[_presentation_manager_detail].getNodes(options),
+                this.getManager(requestOptions.clientId).getNodesCount(options),
+            ]);
+            const hierarchyLevel = deepReplaceNullsToUndefined(JSON.parse(serializedHierarchyLevel));
+            return {
+                total: count,
+                items: hierarchyLevel.nodes,
+            };
+        });
+    }
+    async getNodesDescriptor(token, requestOptions) {
+        return this.makeRequest(token, "getNodesDescriptor", requestOptions, async (options) => {
+            return this.getManager(requestOptions.clientId)[_presentation_manager_detail].getNodesDescriptor(options);
+        });
+    }
+    async getNodePaths(token, requestOptions) {
+        return this.makeRequest(token, "getNodePaths", requestOptions, async (options) => {
+            return this.getManager(requestOptions.clientId)[_presentation_manager_detail].getNodePaths(options);
+        });
+    }
+    async getFilteredNodePaths(token, requestOptions) {
+        return this.makeRequest(token, "getFilteredNodePaths", requestOptions, async (options) => {
+            return this.getManager(requestOptions.clientId)[_presentation_manager_detail].getFilteredNodePaths(options);
+        });
+    }
+    async getContentSources(token, requestOptions) {
+        return this.makeRequest(token, "getContentSources", requestOptions, async (options) => {
+            const result = await this.getManager(requestOptions.clientId).getContentSources(options);
+            const classesMap = {};
+            const selectClasses = result.map((sci) => SelectClassInfo.toCompressedJSON(sci, classesMap));
+            return { sources: selectClasses, classesMap };
+        });
+    }
+    async getContentDescriptor(token, requestOptions) {
+        return this.makeRequest(token, "getContentDescriptor", requestOptions, async (options) => {
+            options = {
+                ...options,
+                contentFlags: (options.contentFlags ?? 0) | DESCRIPTOR_ONLY_CONTENT_FLAG, // always append the "descriptor only" flag when handling request from the frontend
+                keys: KeySet.fromJSON(options.keys),
+            };
+            // Here we send a plain JSON string but we will parse it to DescriptorJSON on the frontend. This way we are
+            // bypassing unnecessary deserialization and serialization.
+            return Presentation.getManager(requestOptions.clientId)[_presentation_manager_detail].getContentDescriptor(options);
+        });
+    }
+    async getContentSetSize(token, requestOptions) {
+        return this.makeRequest(token, "getContentSetSize", requestOptions, async (options) => {
+            options = {
+                ...options,
+                keys: KeySet.fromJSON(options.keys),
+            };
+            return this.getManager(requestOptions.clientId).getContentSetSize(options);
+        });
+    }
+    async getPagedContent(token, requestOptions) {
+        return this.makeRequest(token, "getPagedContent", requestOptions, async (options) => {
+            options = enforceValidPageSize({
+                ...options,
+                keys: KeySet.fromJSON(options.keys),
+            });
+            const [size, content] = await Promise.all([
+                this.getManager(requestOptions.clientId).getContentSetSize(options),
+                this.getManager(requestOptions.clientId)[_presentation_manager_detail].getContent(options),
+            ]);
+            if (!content) {
+                return undefined;
+            }
+            return {
+                descriptor: content.descriptor.toJSON(),
+                contentSet: {
+                    total: size,
+                    items: content.contentSet.map((i) => i.toJSON()),
+                },
+            };
+        });
+    }
+    async getPagedContentSet(token, requestOptions) {
+        // eslint-disable-next-line @typescript-eslint/no-deprecated
+        const response = await this.getPagedContent(token, requestOptions);
+        if (response.statusCode !== PresentationStatus.Success) {
+            return this.errorResponse(response.statusCode, response.errorMessage, response.diagnostics);
+        }
+        if (!response.result) {
+            return this.errorResponse(PresentationStatus.Error, `Failed to get content set (received a success response with empty result)`, response.diagnostics);
+        }
+        return {
+            ...response,
+            result: response.result.contentSet,
+        };
+    }
+    async getElementProperties(token, requestOptions) {
+        return this.makeRequest(token, "getElementProperties", { ...requestOptions }, async (options) => {
+            const manager = this.getManager(requestOptions.clientId);
+            const { elementId, ...optionsNoElementId } = options;
+            const content = await manager[_presentation_manager_detail].getContent({
+                ...optionsNoElementId,
+                descriptor: {
+                    displayType: DefaultContentDisplayTypes.PropertyPane,
+                    contentFlags: ContentFlags.ShowLabels,
+                },
+                rulesetOrId: "ElementProperties",
+                keys: new KeySet([{ className: "BisCore:Element", id: elementId }]),
+            });
+            if (!content || content.contentSet.length === 0) {
+                return undefined;
+            }
+            return buildElementProperties(content.descriptor, content.contentSet[0]);
+        });
+    }
+    async getPagedDistinctValues(token, requestOptions) {
+        return this.makeRequest(token, "getPagedDistinctValues", requestOptions, async (options) => {
+            options = enforceValidPageSize({
+                ...options,
+                keys: KeySet.fromJSON(options.keys),
+            });
+            return this.getManager(requestOptions.clientId)[_presentation_manager_detail].getPagedDistinctValues(options);
+        });
+    }
+    async getContentInstanceKeys(token, requestOptions) {
+        return this.makeRequest(token, "getContentInstanceKeys", requestOptions, async (options) => {
+            const { displayType, ...optionsNoDisplayType } = options;
+            options = enforceValidPageSize({
+                ...optionsNoDisplayType,
+                keys: KeySet.fromJSON(optionsNoDisplayType.keys),
+                descriptor: {
+                    displayType,
+                    contentFlags: ContentFlags.KeysOnly,
+                },
+            }, MAX_ALLOWED_KEYS_PAGE_SIZE);
+            const [size, content] = await Promise.all([
+                this.getManager(requestOptions.clientId).getContentSetSize(options),
+                this.getManager(requestOptions.clientId)[_presentation_manager_detail].getContent(options),
+            ]);
+            if (size === 0 || !content) {
+                return { total: 0, items: new KeySet().toJSON() };
+            }
+            return {
+                total: size,
+                items: content.contentSet.reduce((keys, item) => keys.add(item.primaryKeys), new KeySet()).toJSON(),
+            };
+        });
+    }
+    async getDisplayLabelDefinition(token, requestOptions) {
+        return this.makeRequest(token, "getDisplayLabelDefinition", requestOptions, async (options) => {
+            const label = await this.getManager(requestOptions.clientId)[_presentation_manager_detail].getDisplayLabelDefinition(options);
+            return label;
+        });
+    }
+    async getPagedDisplayLabelDefinitions(token, requestOptions) {
+        const pageOpts = enforceValidPageSize({ paging: { start: 0, size: requestOptions.keys.length } });
+        if (pageOpts.paging.size < requestOptions.keys.length) {
+            requestOptions.keys.splice(pageOpts.paging.size);
+        }
+        return this.makeRequest(token, "getPagedDisplayLabelDefinitions", requestOptions, async (options) => {
+            const labels = await this.getManager(requestOptions.clientId)[_presentation_manager_detail].getDisplayLabelDefinitions({
+                ...options,
+                keys: options.keys,
+            });
+            return {
+                total: options.keys.length,
+                items: labels,
+            };
+        });
+    }
+    /* eslint-disable @typescript-eslint/no-deprecated */
+    async getSelectionScopes(token, requestOptions) {
+        return this.makeRequest(token, "getSelectionScopes", requestOptions, async (options) => this.getManager(requestOptions.clientId).getSelectionScopes(options));
+    }
+    async computeSelection(token, requestOptions) {
+        return this.makeRequest(token, "computeSelection", requestOptions, async (options) => {
+            const keys = await this.getManager(requestOptions.clientId).computeSelection(options);
+            return keys.toJSON();
+        });
+    }
+}
+const enforceValidPageSize = (requestOptions, maxPageSize = MAX_ALLOWED_PAGE_SIZE) => {
+    const validPageSize = getValidPageSize(requestOptions.paging?.size, maxPageSize);
+    if (!requestOptions.paging || requestOptions.paging.size !== validPageSize) {
+        return { ...requestOptions, paging: { ...requestOptions.paging, size: validPageSize } };
+    }
+    return requestOptions;
+};
+const getValidPageSize = (size, maxPageSize) => {
+    const requestedSize = size ?? 0;
+    return requestedSize === 0 || requestedSize > maxPageSize ? maxPageSize : requestedSize;
+};
+// not testing temporary solution
+/* c8 ignore start */
+function createStatusCategoryHandler() {
+    return (e) => {
+        if (e instanceof PresentationError) {
+            switch (e.errorNumber) {
+                case PresentationStatus.NotInitialized:
+                    return new (class extends ErrorCategory {
+                        name = "Internal server error";
+                        code = 500;
+                    })();
+                case PresentationStatus.Canceled:
+                    return new (class extends SuccessCategory {
+                        name = "Cancelled";
+                        code = 204;
+                    })();
+                case PresentationStatus.ResultSetTooLarge:
+                    return new (class extends ErrorCategory {
+                        name = "Result set is too large";
+                        code = 413;
+                    })();
+                case PresentationStatus.Error:
+                case PresentationStatus.InvalidArgument:
+                    return new (class extends ErrorCategory {
+                        name = "Invalid request props";
+                        code = 422;
+                    })();
+            }
+        }
+        return undefined;
+    };
+}
+/* c8 ignore end */
+//# sourceMappingURL=PresentationRpcImpl.js.map

package/lib/esm/presentation-backend/PresentationRpcImpl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PresentationRpcImpl.js","sourceRoot":"","sources":["../../../src/presentation-backend/PresentationRpcImpl.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 RPC\n */\n\nimport { IModelDb, RpcTrace } from \"@itwin/core-backend\";\nimport { BeEvent, ErrorCategory, Logger, omit, StatusCategory, SuccessCategory } from \"@itwin/core-bentley\";\nimport { IModelRpcProps, RpcPendingResponse } from \"@itwin/core-common\";\nimport {\n  ClientDiagnostics,\n  ComputeSelectionRpcRequestOptions,\n  ContentDescriptorRpcRequestOptions,\n  ContentFlags,\n  ContentInstanceKeysRpcRequestOptions,\n  ContentRpcRequestOptions,\n  ContentSourcesRpcRequestOptions,\n  ContentSourcesRpcResult,\n  DefaultContentDisplayTypes,\n  DescriptorJSON,\n  Diagnostics,\n  DisplayLabelRpcRequestOptions,\n  DisplayLabelsRpcRequestOptions,\n  DisplayValueGroup,\n  DistinctValuesRpcRequestOptions,\n  ElementProperties,\n  FilterByInstancePathsHierarchyRpcRequestOptions,\n  FilterByTextHierarchyRpcRequestOptions,\n  HierarchyLevel,\n  HierarchyLevelDescriptorRpcRequestOptions,\n  HierarchyRpcRequestOptions,\n  ItemJSON,\n  KeySet,\n  KeySetJSON,\n  LabelDefinition,\n  Node,\n  NodePathElement,\n  Paged,\n  PagedResponse,\n  PageOptions,\n  PresentationError,\n  PresentationRpcInterface,\n  PresentationRpcResponse,\n  PresentationRpcResponseData,\n  PresentationStatus,\n  RpcDiagnosticsOptions,\n  Ruleset,\n  RulesetVariable,\n  RulesetVariableJSON,\n  SelectClassInfo,\n  SelectionScope,\n  SelectionScopeRpcRequestOptions,\n  SingleElementPropertiesRpcRequestOptions,\n} from \"@itwin/presentation-common\";\nimport { buildElementProperties, createCancellableTimeoutPromise, deepReplaceNullsToUndefined } from \"@itwin/presentation-common/internal\";\n// @ts-expect-error TS complains about `with` in CJS builds; The path is fine at runtime, but not at compile time\n// eslint-disable-next-line @itwin/import-within-package\nimport packageJson from \"../../../package.json\" with { type: \"json\" };\nimport { PresentationBackendLoggerCategory } from \"./BackendLoggerCategory.js\";\nimport { Presentation } from \"./Presentation.js\";\nimport { PresentationManager } from \"./PresentationManager.js\";\nimport { DESCRIPTOR_ONLY_CONTENT_FLAG, getRulesetIdObject } from \"./PresentationManagerDetail.js\";\nimport { TemporaryStorage } from \"./TemporaryStorage.js\";\nimport { _presentation_manager_detail } from \"./InternalSymbols.js\";\n\nconst packageJsonVersion = packageJson.version;\n\ntype ContentGetter<TResult = any, TOptions = any> = (requestOptions: TOptions) => TResult;\n\n/** @internal */\nexport const MAX_ALLOWED_PAGE_SIZE = 1000;\n/** @internal */\nexport const MAX_ALLOWED_KEYS_PAGE_SIZE = 10000;\n\nconst DEFAULT_REQUEST_TIMEOUT = 5000;\n\n/**\n * The backend implementation of PresentationRpcInterface. All it's basically\n * responsible for is forwarding calls to [[Presentation.manager]].\n *\n * @internal\n */\nexport class PresentationRpcImpl extends PresentationRpcInterface implements Disposable {\n  private _requestTimeout: number;\n  private _pendingRequests: TemporaryStorage<PresentationRpcResponse<any>>;\n  private _cancelEvents: Map<string, BeEvent<() => void>>;\n  private _statusHandler: (e: Error) => StatusCategory | undefined;\n\n  public constructor(props?: { requestTimeout?: number }) {\n    super();\n    this._requestTimeout = props?.requestTimeout ?? DEFAULT_REQUEST_TIMEOUT;\n    this._pendingRequests = new TemporaryStorage({\n      // remove the pending request after request timeout + 10 seconds - this gives\n      // frontend 10 seconds to re-send the request until it's removed from requests' cache\n      unusedValueLifetime: this._requestTimeout > 0 ? this._requestTimeout + 10 * 1000 : undefined,\n\n      // attempt to clean up every second\n      cleanupInterval: 1000,\n\n      cleanupHandler: (id, _, reason) => {\n        if (reason !== \"request\") {\n          Logger.logTrace(PresentationBackendLoggerCategory.Rpc, `Cleaning up request without frontend retrieving it: ${id}.`);\n          /* c8 ignore next */\n          this._cancelEvents.get(id)?.raiseEvent();\n        }\n        this._cancelEvents.delete(id);\n      },\n    });\n    this._cancelEvents = new Map<string, BeEvent<() => void>>();\n\n    this._statusHandler = createStatusCategoryHandler();\n    StatusCategory.handlers.add(this._statusHandler);\n  }\n\n  public [Symbol.dispose]() {\n    this._pendingRequests[Symbol.dispose]();\n    StatusCategory.handlers.delete(this._statusHandler);\n  }\n\n  public get requestTimeout() {\n    return this._requestTimeout;\n  }\n\n  public get pendingRequests() {\n    return this._pendingRequests;\n  }\n\n  /** Returns an ok response with result inside */\n  private successResponse<TResult>(result: TResult, diagnostics?: ClientDiagnostics) {\n    return {\n      statusCode: PresentationStatus.Success,\n      result,\n      diagnostics,\n    };\n  }\n\n  /** Returns a bad request response with empty result and an error code */\n  private errorResponse(errorCode: PresentationStatus, errorMessage?: string, diagnostics?: ClientDiagnostics) {\n    return {\n      statusCode: errorCode,\n      result: undefined,\n      errorMessage,\n      diagnostics,\n    };\n  }\n\n  /**\n   * Get the [[PresentationManager]] used by this RPC impl.\n   */\n  public getManager(clientId?: string): PresentationManager {\n    return Presentation.getManager(clientId);\n  }\n\n  private async getIModel(token: IModelRpcProps): Promise<IModelDb> {\n    const imodel = IModelDb.findByKey(token.key);\n    // call refreshContainer, just in case this is a V2 checkpoint whose sasToken is about to expire, or its default transaction is about to be restarted.\n    await imodel.refreshContainerForRpc(RpcTrace.expectCurrentActivity.accessToken);\n    return imodel;\n  }\n\n  private async makeRequest<\n    TRpcOptions extends { rulesetOrId?: Ruleset | string; clientId?: string; diagnostics?: RpcDiagnosticsOptions; rulesetVariables?: RulesetVariableJSON[] },\n    TResult,\n  >(token: IModelRpcProps, requestId: string, requestOptions: TRpcOptions, request: ContentGetter<Promise<TResult>>): PresentationRpcResponse<TResult> {\n    const serializedRequestOptionsForLogging = JSON.stringify({\n      ...omit(requestOptions, [\"rulesetOrId\"]),\n      ...(requestOptions.rulesetOrId ? { rulesetId: getRulesetIdObject(requestOptions.rulesetOrId).uniqueId } : undefined),\n    });\n    Logger.logInfo(PresentationBackendLoggerCategory.Rpc, `Received '${requestId}' request. Params: ${serializedRequestOptionsForLogging}`);\n\n    const imodel = await this.getIModel(token);\n    const requestKey = JSON.stringify({ iModelKey: token.key, requestId, requestOptions });\n    let resultPromise = this._pendingRequests.getValue(requestKey);\n    if (resultPromise) {\n      Logger.logTrace(PresentationBackendLoggerCategory.Rpc, `Request already pending`);\n    } else {\n      Logger.logTrace(PresentationBackendLoggerCategory.Rpc, `Request not found, creating a new one`);\n      const { clientId: _, diagnostics: diagnosticsOptions, rulesetVariables, ...options } = requestOptions;\n      const managerRequestOptions: any = {\n        ...options,\n        imodel,\n        cancelEvent: new BeEvent<() => void>(),\n      };\n\n      // set up ruleset variables\n      if (rulesetVariables) {\n        managerRequestOptions.rulesetVariables = rulesetVariables.map(RulesetVariable.fromJSON);\n      }\n\n      // set up diagnostics listener\n      let diagnostics: ClientDiagnostics | undefined;\n      const getDiagnostics = (): ClientDiagnostics => {\n        if (!diagnostics) {\n          diagnostics = {};\n        }\n        return diagnostics;\n      };\n      if (diagnosticsOptions) {\n        if (diagnosticsOptions.backendVersion) {\n          getDiagnostics().backendVersion = packageJsonVersion;\n        }\n        managerRequestOptions.diagnostics = {\n          ...diagnosticsOptions,\n          handler: (d: Diagnostics) => {\n            if (d.logs) {\n              const target = getDiagnostics();\n              if (target.logs) {\n                target.logs.push(...d.logs);\n              } else {\n                target.logs = [...d.logs];\n              }\n            }\n          },\n        };\n      }\n\n      // initiate request\n      resultPromise = request(managerRequestOptions).then((result) => this.successResponse(result, diagnostics));\n\n      // store the request promise\n      this._pendingRequests.addValue(requestKey, resultPromise);\n      this._cancelEvents.set(requestKey, managerRequestOptions.cancelEvent);\n    }\n\n    if (this._requestTimeout === 0) {\n      Logger.logTrace(PresentationBackendLoggerCategory.Rpc, `Request timeout not configured, returning promise without a timeout.`);\n      void resultPromise.finally(() => {\n        this._pendingRequests.deleteValue(requestKey);\n      });\n      return resultPromise;\n    }\n\n    Logger.logTrace(PresentationBackendLoggerCategory.Rpc, `Returning a promise with a timeout of ${this._requestTimeout}.`);\n    const timeout = createCancellableTimeoutPromise(this._requestTimeout);\n    return Promise.race([\n      resultPromise,\n      timeout.promise.then(() => {\n        // eslint-disable-next-line @typescript-eslint/only-throw-error\n        throw new RpcPendingResponse(\"Timeout\");\n      }),\n    ])\n      .then((response: PresentationRpcResponseData<TResult>) => {\n        Logger.logTrace(PresentationBackendLoggerCategory.Rpc, `Request completed, returning result.`);\n        this._pendingRequests.deleteValue(requestKey);\n        return response;\n      })\n      .finally(() => {\n        timeout.cancel();\n      });\n  }\n\n  public override async getNodesCount(token: IModelRpcProps, requestOptions: HierarchyRpcRequestOptions): PresentationRpcResponse<number> {\n    return this.makeRequest(token, \"getNodesCount\", requestOptions, async (options) => {\n      return this.getManager(requestOptions.clientId).getNodesCount(options);\n    });\n  }\n\n  public override async getPagedNodes(token: IModelRpcProps, requestOptions: Paged<HierarchyRpcRequestOptions>): PresentationRpcResponse<PagedResponse<Node>> {\n    return this.makeRequest(token, \"getPagedNodes\", requestOptions, async (options) => {\n      options = enforceValidPageSize(options);\n      const [serializedHierarchyLevel, count] = await Promise.all([\n        this.getManager(requestOptions.clientId)[_presentation_manager_detail].getNodes(options),\n        this.getManager(requestOptions.clientId).getNodesCount(options),\n      ]);\n      const hierarchyLevel: HierarchyLevel = deepReplaceNullsToUndefined(JSON.parse(serializedHierarchyLevel));\n      return {\n        total: count,\n        items: hierarchyLevel.nodes,\n      };\n    });\n  }\n\n  public override async getNodesDescriptor(\n    token: IModelRpcProps,\n    requestOptions: HierarchyLevelDescriptorRpcRequestOptions,\n  ): PresentationRpcResponse<string | DescriptorJSON | undefined> {\n    return this.makeRequest(token, \"getNodesDescriptor\", requestOptions, async (options) => {\n      return this.getManager(requestOptions.clientId)[_presentation_manager_detail].getNodesDescriptor(options);\n    });\n  }\n\n  public override async getNodePaths(\n    token: IModelRpcProps,\n    requestOptions: FilterByInstancePathsHierarchyRpcRequestOptions,\n  ): PresentationRpcResponse<NodePathElement[]> {\n    return this.makeRequest(token, \"getNodePaths\", requestOptions, async (options) => {\n      return this.getManager(requestOptions.clientId)[_presentation_manager_detail].getNodePaths(options);\n    });\n  }\n\n  public override async getFilteredNodePaths(\n    token: IModelRpcProps,\n    requestOptions: FilterByTextHierarchyRpcRequestOptions,\n  ): PresentationRpcResponse<NodePathElement[]> {\n    return this.makeRequest(token, \"getFilteredNodePaths\", requestOptions, async (options) => {\n      return this.getManager(requestOptions.clientId)[_presentation_manager_detail].getFilteredNodePaths(options);\n    });\n  }\n\n  public override async getContentSources(\n    token: IModelRpcProps,\n    requestOptions: ContentSourcesRpcRequestOptions,\n  ): PresentationRpcResponse<ContentSourcesRpcResult> {\n    return this.makeRequest(token, \"getContentSources\", requestOptions, async (options) => {\n      const result = await this.getManager(requestOptions.clientId).getContentSources(options);\n      const classesMap = {};\n      const selectClasses = result.map((sci) => SelectClassInfo.toCompressedJSON(sci, classesMap));\n      return { sources: selectClasses, classesMap };\n    });\n  }\n\n  public override async getContentDescriptor(\n    token: IModelRpcProps,\n    requestOptions: ContentDescriptorRpcRequestOptions,\n  ): PresentationRpcResponse<DescriptorJSON | undefined> {\n    return this.makeRequest(token, \"getContentDescriptor\", requestOptions, async (options) => {\n      options = {\n        ...options,\n        contentFlags: (options.contentFlags ?? 0) | DESCRIPTOR_ONLY_CONTENT_FLAG, // always append the \"descriptor only\" flag when handling request from the frontend\n        keys: KeySet.fromJSON(options.keys),\n      };\n      // Here we send a plain JSON string but we will parse it to DescriptorJSON on the frontend. This way we are\n      // bypassing unnecessary deserialization and serialization.\n      return Presentation.getManager(requestOptions.clientId)[_presentation_manager_detail].getContentDescriptor(options) as unknown as\n        | DescriptorJSON\n        | undefined;\n    });\n  }\n\n  public override async getContentSetSize(token: IModelRpcProps, requestOptions: ContentRpcRequestOptions): PresentationRpcResponse<number> {\n    return this.makeRequest(token, \"getContentSetSize\", requestOptions, async (options) => {\n      options = {\n        ...options,\n        keys: KeySet.fromJSON(options.keys),\n      };\n      return this.getManager(requestOptions.clientId).getContentSetSize(options);\n    });\n  }\n\n  public override async getPagedContent(\n    token: IModelRpcProps,\n    requestOptions: Paged<ContentRpcRequestOptions>,\n  ): PresentationRpcResponse<{ descriptor: DescriptorJSON; contentSet: PagedResponse<ItemJSON> } | undefined> {\n    return this.makeRequest(token, \"getPagedContent\", requestOptions, async (options) => {\n      options = enforceValidPageSize({\n        ...options,\n        keys: KeySet.fromJSON(options.keys),\n      });\n\n      const [size, content] = await Promise.all([\n        this.getManager(requestOptions.clientId).getContentSetSize(options),\n        this.getManager(requestOptions.clientId)[_presentation_manager_detail].getContent(options),\n      ]);\n\n      if (!content) {\n        return undefined;\n      }\n\n      return {\n        descriptor: content.descriptor.toJSON(),\n        contentSet: {\n          total: size,\n          items: content.contentSet.map((i) => i.toJSON()),\n        },\n      };\n    });\n  }\n\n  public override async getPagedContentSet(\n    token: IModelRpcProps,\n    requestOptions: Paged<ContentRpcRequestOptions>,\n  ): PresentationRpcResponse<PagedResponse<ItemJSON>> {\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\n    const response = await this.getPagedContent(token, requestOptions);\n    if (response.statusCode !== PresentationStatus.Success) {\n      return this.errorResponse(response.statusCode, response.errorMessage, response.diagnostics);\n    }\n    if (!response.result) {\n      return this.errorResponse(PresentationStatus.Error, `Failed to get content set (received a success response with empty result)`, response.diagnostics);\n    }\n    return {\n      ...response,\n      result: response.result.contentSet,\n    };\n  }\n\n  public override async getElementProperties(\n    token: IModelRpcProps,\n    requestOptions: SingleElementPropertiesRpcRequestOptions,\n  ): PresentationRpcResponse<ElementProperties | undefined> {\n    return this.makeRequest(token, \"getElementProperties\", { ...requestOptions }, async (options) => {\n      const manager = this.getManager(requestOptions.clientId);\n      const { elementId, ...optionsNoElementId } = options;\n      const content = await manager[_presentation_manager_detail].getContent({\n        ...optionsNoElementId,\n        descriptor: {\n          displayType: DefaultContentDisplayTypes.PropertyPane,\n          contentFlags: ContentFlags.ShowLabels,\n        },\n        rulesetOrId: \"ElementProperties\",\n        keys: new KeySet([{ className: \"BisCore:Element\", id: elementId }]),\n      });\n      if (!content || content.contentSet.length === 0) {\n        return undefined;\n      }\n      return buildElementProperties(content.descriptor, content.contentSet[0]);\n    });\n  }\n\n  public override async getPagedDistinctValues(\n    token: IModelRpcProps,\n    requestOptions: DistinctValuesRpcRequestOptions,\n  ): PresentationRpcResponse<PagedResponse<DisplayValueGroup>> {\n    return this.makeRequest(token, \"getPagedDistinctValues\", requestOptions, async (options) => {\n      options = enforceValidPageSize({\n        ...options,\n        keys: KeySet.fromJSON(options.keys),\n      });\n      return this.getManager(requestOptions.clientId)[_presentation_manager_detail].getPagedDistinctValues(options);\n    });\n  }\n\n  public override async getContentInstanceKeys(\n    token: IModelRpcProps,\n    requestOptions: ContentInstanceKeysRpcRequestOptions,\n  ): PresentationRpcResponse<{ total: number; items: KeySetJSON }> {\n    return this.makeRequest(token, \"getContentInstanceKeys\", requestOptions, async (options) => {\n      const { displayType, ...optionsNoDisplayType } = options;\n      options = enforceValidPageSize(\n        {\n          ...optionsNoDisplayType,\n          keys: KeySet.fromJSON(optionsNoDisplayType.keys),\n          descriptor: {\n            displayType,\n            contentFlags: ContentFlags.KeysOnly,\n          },\n        },\n        MAX_ALLOWED_KEYS_PAGE_SIZE,\n      );\n\n      const [size, content] = await Promise.all([\n        this.getManager(requestOptions.clientId).getContentSetSize(options),\n        this.getManager(requestOptions.clientId)[_presentation_manager_detail].getContent(options),\n      ]);\n\n      if (size === 0 || !content) {\n        return { total: 0, items: new KeySet().toJSON() };\n      }\n\n      return {\n        total: size,\n        items: content.contentSet.reduce((keys, item) => keys.add(item.primaryKeys), new KeySet()).toJSON(),\n      };\n    });\n  }\n\n  public override async getDisplayLabelDefinition(\n    token: IModelRpcProps,\n    requestOptions: DisplayLabelRpcRequestOptions,\n  ): PresentationRpcResponse<LabelDefinition> {\n    return this.makeRequest(token, \"getDisplayLabelDefinition\", requestOptions, async (options) => {\n      const label = await this.getManager(requestOptions.clientId)[_presentation_manager_detail].getDisplayLabelDefinition(options);\n      return label;\n    });\n  }\n\n  public override async getPagedDisplayLabelDefinitions(\n    token: IModelRpcProps,\n    requestOptions: DisplayLabelsRpcRequestOptions,\n  ): PresentationRpcResponse<PagedResponse<LabelDefinition>> {\n    const pageOpts = enforceValidPageSize({ paging: { start: 0, size: requestOptions.keys.length } });\n    if (pageOpts.paging.size < requestOptions.keys.length) {\n      requestOptions.keys.splice(pageOpts.paging.size);\n    }\n    return this.makeRequest(token, \"getPagedDisplayLabelDefinitions\", requestOptions, async (options) => {\n      const labels = await this.getManager(requestOptions.clientId)[_presentation_manager_detail].getDisplayLabelDefinitions({\n        ...options,\n        keys: options.keys,\n      });\n      return {\n        total: options.keys.length,\n        items: labels,\n      };\n    });\n  }\n\n  /* eslint-disable @typescript-eslint/no-deprecated */\n  public override async getSelectionScopes(token: IModelRpcProps, requestOptions: SelectionScopeRpcRequestOptions): PresentationRpcResponse<SelectionScope[]> {\n    return this.makeRequest(token, \"getSelectionScopes\", requestOptions, async (options) =>\n      this.getManager(requestOptions.clientId).getSelectionScopes(options),\n    );\n  }\n\n  public override async computeSelection(token: IModelRpcProps, requestOptions: ComputeSelectionRpcRequestOptions): PresentationRpcResponse<KeySetJSON> {\n    return this.makeRequest(token, \"computeSelection\", requestOptions, async (options) => {\n      const keys = await this.getManager(requestOptions.clientId).computeSelection(options);\n      return keys.toJSON();\n    });\n  }\n  /* eslint-enable @typescript-eslint/no-deprecated */\n}\n\nconst enforceValidPageSize = <TOptions extends Paged<object>>(\n  requestOptions: TOptions,\n  maxPageSize = MAX_ALLOWED_PAGE_SIZE,\n): TOptions & { paging: PageOptions } => {\n  const validPageSize = getValidPageSize(requestOptions.paging?.size, maxPageSize);\n  if (!requestOptions.paging || requestOptions.paging.size !== validPageSize) {\n    return { ...requestOptions, paging: { ...requestOptions.paging, size: validPageSize } };\n  }\n  return requestOptions as TOptions & { paging: PageOptions };\n};\n\nconst getValidPageSize = (size: number | undefined, maxPageSize: number) => {\n  const requestedSize = size ?? 0;\n  return requestedSize === 0 || requestedSize > maxPageSize ? maxPageSize : requestedSize;\n};\n\n// not testing temporary solution\n/* c8 ignore start */\nfunction createStatusCategoryHandler() {\n  return (e: Error) => {\n    if (e instanceof PresentationError) {\n      switch (e.errorNumber) {\n        case PresentationStatus.NotInitialized:\n          return new (class extends ErrorCategory {\n            public name = \"Internal server error\";\n            public code = 500;\n          })();\n        case PresentationStatus.Canceled:\n          return new (class extends SuccessCategory {\n            public name = \"Cancelled\";\n            public code = 204;\n          })();\n        case PresentationStatus.ResultSetTooLarge:\n          return new (class extends ErrorCategory {\n            public name = \"Result set is too large\";\n            public code = 413;\n          })();\n        case PresentationStatus.Error:\n        case PresentationStatus.InvalidArgument:\n          return new (class extends ErrorCategory {\n            public name = \"Invalid request props\";\n            public code = 422;\n          })();\n      }\n    }\n    return undefined;\n  };\n}\n/* c8 ignore end */\n"]}

package/lib/esm/presentation-backend/RulesetEmbedder.d.ts

@@ -0,0 +1,109 @@
+/** @packageDocumentation
+ * @module Core
+ */
+import { Entity, IModelDb } from "@itwin/core-backend";
+import { Id64String } from "@itwin/core-bentley";
+import { Ruleset } from "@itwin/presentation-common";
+/**
+ * Interface for callbacks which will be called before and after Element/Model updates
+ * @public
+ */
+interface UpdateCallbacks {
+    onBeforeUpdate: (props: Entity) => Promise<void>;
+    onAfterUpdate: (props: Entity) => Promise<void>;
+}
+/**
+ * Interface for callbacks which will be called before and after Element/Model is inserted
+ * @public
+ */
+interface InsertCallbacks {
+    onBeforeInsert: (props: Entity) => Promise<void>;
+    onAfterInsert: (props: Entity) => Promise<void>;
+}
+/**
+ * Options for [[RulesetEmbedder.insertRuleset]] operation.
+ * @public
+ */
+export interface RulesetInsertOptions {
+    /**
+     * When should insertion be skipped:
+     * - `same-id` - if iModel already contains a ruleset with the same id and **any** version
+     * - `same-id-and-version-eq` - if iModel already contains a ruleset with same id and version
+     * - `same-id-and-version-gte` - if iModel already contains a ruleset with same id and
+     * version greater or equal to version of the inserted ruleset.
+     *
+     * Defaults to `same-id-and-version-eq`.
+     */
+    skip?: "never" | "same-id" | "same-id-and-version-eq" | "same-id-and-version-gte";
+    /**
+     * Which existing versions of rulesets with same id should be replaced when we insert a new one:
+     * - `all` - replace all rulesets with same id.
+     * - `all-lower` - replace rulesets with same id and version lower than the version of inserted ruleset.
+     * - `exact` - replace only the ruleset whose id and version matches the inserted ruleset.
+     *
+     * Defaults to `exact`.
+     */
+    replaceVersions?: "all" | "all-lower" | "exact";
+    /**
+     * Callbacks that will be called before and after `Entity` updates
+     */
+    onEntityUpdate?: UpdateCallbacks;
+    /**
+     * Callbacks that will be called before and after `Entity` is inserted
+     */
+    onEntityInsert?: InsertCallbacks;
+}
+/**
+ * Properties for creating a `RulesetEmbedder` instance.
+ * @public
+ */
+export interface RulesetEmbedderProps {
+    /** iModel to embed rulesets to */
+    imodel: IModelDb;
+    /**
+     * An ID of existing subject under which presentation ruleset will be located or created.
+     * Defaults to 'IModel.rootSubjectId'.
+     */
+    parentSubjectId?: Id64String;
+}
+/**
+ * An API for embedding presentation rulesets into iModels.
+ * @public
+ */
+export declare class RulesetEmbedder {
+    private _imodel;
+    private _parentSubjectId;
+    private readonly _schemaPath;
+    private readonly _rulesetModelName;
+    private readonly _rulesetSubjectName;
+    /**
+     * Constructs RulesetEmbedder
+     */
+    constructor(props: RulesetEmbedderProps);
+    /**
+     * Inserts a ruleset into iModel.
+     * @param ruleset Ruleset to insert.
+     * @param options Options for inserting a ruleset.
+     * @returns ID of inserted ruleset element or, if insertion was skipped, ID of existing ruleset with the same ID and highest version.
+     */
+    insertRuleset(ruleset: Ruleset, options?: RulesetInsertOptions): Promise<Id64String>;
+    private updateRuleset;
+    private insertNewRuleset;
+    /**
+     * Get all rulesets embedded in the iModel.
+     */
+    getRulesets(): Promise<Ruleset[]>;
+    private getOrCreateRulesetModel;
+    private queryRulesetModel;
+    private queryDefinitionPartition;
+    private querySubject;
+    private insertDefinitionModel;
+    private insertDefinitionPartition;
+    private insertSubject;
+    private handleElementOperationPrerequisites;
+    private insertElement;
+    private insertModel;
+    private updateElement;
+}
+export {};
+//# sourceMappingURL=RulesetEmbedder.d.ts.map

package/lib/esm/presentation-backend/RulesetEmbedder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RulesetEmbedder.d.ts","sourceRoot":"","sources":["../../../src/presentation-backend/RulesetEmbedder.ts"],"names":[],"mappings":"AAIA;;GAEG;AAIH,OAAO,EAAoE,MAAM,EAAE,QAAQ,EAAkC,MAAM,qBAAqB,CAAC;AACzJ,OAAO,EAAU,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAezD,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAKrD;;;GAGG;AACH,UAAU,eAAe;IACvB,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD;AAED;;;GAGG;AACH,UAAU,eAAe;IACvB,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,wBAAwB,GAAG,yBAAyB,CAAC;IAElF;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,KAAK,GAAG,WAAW,GAAG,OAAO,CAAC;IAEhD;;OAEG;IACH,cAAc,CAAC,EAAE,eAAe,CAAC;IAEjC;;OAEG;IACH,cAAc,CAAC,EAAE,eAAe,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,kCAAkC;IAClC,MAAM,EAAE,QAAQ,CAAC;IACjB;;;OAGG;IACH,eAAe,CAAC,EAAE,UAAU,CAAC;CAC9B;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAW;IAC1B,OAAO,CAAC,gBAAgB,CAAa;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgG;IAC5H,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAuB;IACzD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAuB;IAE3D;;OAEG;gBACgB,KAAK,EAAE,oBAAoB;IAM9C;;;;;OAKG;IACU,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;YA2EnF,aAAa;YAWb,gBAAgB;IAa9B;;OAEG;IACU,WAAW,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YAchC,uBAAuB;IAWrC,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,wBAAwB;IAShC,OAAO,CAAC,YAAY;YAYN,qBAAqB;YAWrB,yBAAyB;YAezB,aAAa;YAqBb,mCAAmC;YAcnC,aAAa;YAYb,WAAW;YAaX,aAAa;CAU5B"}