@itwin/core-common 4.0.0-dev.1 → 4.0.0-dev.100

package/lib/esm/RpcInterface.js

@@ -1,134 +1,155 @@
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module RpcInterface
- */
-import * as semver from "semver";
-import { RpcConfiguration } from "./rpc/core/RpcConfiguration";
-import { CURRENT_REQUEST } from "./rpc/core/RpcRegistry";
-import { aggregateLoad, RpcRequest } from "./rpc/core/RpcRequest";
-import { RpcRoutingToken } from "./rpc/core/RpcRoutingToken";
-import { IpcSession } from "./ipc/IpcSession";
-import { BentleyStatus, IModelError, NoContentError } from "./IModelError";
-import { RpcRequestEvent, RpcRequestStatus } from "./rpc/core/RpcConstants";
-import { BeDuration } from "@itwin/core-bentley";
-/** An RPC interface is a set of operations exposed by a service that a client can call, using configurable protocols,
- * in a platform-independent way. TheRpcInterface class is the base class for RPC interface definitions and implementations.
- * @public
- */
-export class RpcInterface {
-    /** @internal */
-    constructor(routing = RpcRoutingToken.default) {
-        this.routing = routing;
-        this.configuration = RpcConfiguration.supply(this);
-    }
-    /** Determines whether the backend version of an RPC interface is compatible (according to semantic versioning) with the frontend version of the interface. */
-    static isVersionCompatible(backend, frontend) {
-        const difference = semver.diff(backend, frontend);
-        if (semver.prerelease(backend) || semver.prerelease(frontend)) {
-            return difference === null;
-        }
-        else if (semver.major(backend) === 0 || semver.major(frontend) === 0) {
-            return difference === null || (difference === "patch" && semver.patch(frontend) < semver.patch(backend));
-        }
-        else {
-            return difference === null || difference === "patch" || (difference === "minor" && semver.minor(frontend) < semver.minor(backend));
-        }
-    }
-    /** Obtains the implementation result for an RPC operation. */
-    async forward(parameters) {
-        const parametersCompat = (arguments.length === 1 && typeof (parameters) === "object") ? parameters : arguments;
-        const parametersArray = Array.isArray(parametersCompat) ? parametersCompat : Array.prototype.slice.call(parametersCompat);
-        const operationName = parametersArray.pop();
-        const session = IpcSession.active;
-        if (session) {
-            return intercept(session, this, operationName, parametersArray);
-        }
-        else {
-            const request = new this.configuration.protocol.requestType(this, operationName, parametersArray);
-            request.submit(); // eslint-disable-line @typescript-eslint/no-floating-promises
-            this[CURRENT_REQUEST] = request;
-            return request.response;
-        }
-    }
-}
-RpcInterface.prototype.configurationSupplier = undefined;
-class InterceptedRequest extends RpcRequest {
-    async load() { throw new Error(); }
-    async send() { throw new Error(); }
-    setHeader(_name, _value) { throw new Error(); }
-}
-async function intercept(session, client, operation, parameters) {
-    const request = new InterceptedRequest(client, operation, []);
-    client[CURRENT_REQUEST] = request;
-    const context = await client.configuration.protocol.serialize(request);
-    request.parameters = parameters;
-    const info = {
-        definition: {
-            interfaceName: context.operation.interfaceDefinition,
-            interfaceVersion: context.operation.interfaceVersion,
-        },
-        operation,
-        parameters,
-        context: {
-            applicationId: context.applicationId,
-            applicationVersion: context.applicationVersion,
-            id: context.id,
-            sessionId: context.sessionId,
-            protocolVersion: (context.protocolVersion || 0).toString(),
-        },
-    };
-    const dispatch = async () => {
-        aggregateLoad.lastRequest = new Date().getTime();
-        const response = await session.handleRpc(info);
-        aggregateLoad.lastResponse = new Date().getTime();
-        if (typeof (response) === "object" && response.hasOwnProperty("iTwinRpcCoreResponse") && response.hasOwnProperty("managedStatus")) {
-            const status = response;
-            if (status.managedStatus === "pending") {
-                return handlePending(request, status, dispatch);
-            }
-            else if (status.managedStatus === "notFound") {
-                return handleNotFound(request, status, dispatch);
-            }
-            else if (status.managedStatus === "noContent") {
-                return handleNoContent();
-            }
-        }
-        else {
-            return response;
-        }
-    };
-    return dispatch();
-}
-async function handlePending(request, status, dispatch) {
-    request._status = RpcRequestStatus.Pending;
-    request._extendedStatus = status.responseValue.message;
-    RpcRequest.events.raiseEvent(RpcRequestEvent.PendingUpdateReceived, request);
-    const delay = request.operation.policy.retryInterval(request.client.configuration);
-    await BeDuration.wait(delay);
-    return dispatch();
-}
-async function handleNotFound(request, status, dispatch) {
-    return new Promise((resolve, reject) => {
-        let resubmitted = false;
-        RpcRequest.notFoundHandlers.raiseEvent(request, status.responseValue, async () => {
-            if (resubmitted) {
-                throw new IModelError(BentleyStatus.ERROR, `Already resubmitted using this handler.`);
-            }
-            resubmitted = true;
-            try {
-                const response = await dispatch();
-                resolve(response);
-            }
-            catch (err) {
-                reject(err);
-            }
-        }, reject);
-    });
-}
-async function handleNoContent() {
-    throw new NoContentError();
-}
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module RpcInterface
+ */
+import { RpcConfiguration } from "./rpc/core/RpcConfiguration";
+import { CURRENT_REQUEST } from "./rpc/core/RpcRegistry";
+import { aggregateLoad, RpcRequest } from "./rpc/core/RpcRequest";
+import { RpcRoutingToken } from "./rpc/core/RpcRoutingToken";
+import { IpcSession } from "./ipc/IpcSession";
+import { BentleyStatus, IModelError, NoContentError } from "./IModelError";
+import { RpcRequestEvent, RpcRequestStatus } from "./rpc/core/RpcConstants";
+import { BeDuration } from "@itwin/core-bentley";
+/** An RPC interface is a set of operations exposed by a service that a client can call, using configurable protocols,
+ * in a platform-independent way. TheRpcInterface class is the base class for RPC interface definitions and implementations.
+ * @public
+ */
+export class RpcInterface {
+    static findDiff(backend, frontend) {
+        return backend.major !== frontend.major ? "major" : backend.minor !== frontend.minor ? "minor" : backend.patch !== frontend.patch ? "patch" : backend.prerelease !== frontend.prerelease ? "prerelease" : "same";
+    }
+    static parseVer(version) {
+        // Split the version string into major.minor.path and prerelease tag
+        const split = version.split(/[:-]/);
+        // Split the major.minor.path into seperate components
+        const prefix = split[0].split(".");
+        if (split.length === 1) {
+            return { major: Number(prefix[0]), minor: Number(prefix[1]), patch: Number(prefix[2]) };
+        }
+        else {
+            return { major: Number(prefix[0]), minor: Number(prefix[1]), patch: Number(prefix[2]), prerelease: split[1] };
+        }
+    }
+    /** Determines whether the backend version of an RPC interface is compatible (according to semantic versioning) with the frontend version of the interface. */
+    static isVersionCompatible(backend, frontend) {
+        const backendSemver = this.parseVer(backend);
+        const frontendSemver = this.parseVer(frontend);
+        const difference = this.findDiff(backendSemver, frontendSemver);
+        // If the major versions are different, the versions are not compatible
+        // In the case of prerelease tags, they are compatible if the whole version string matches, otherwise it fails
+        if ((backendSemver.prerelease !== undefined || frontendSemver.prerelease !== undefined) || difference === "major") {
+            return difference === "same";
+        }
+        else if (backendSemver.major === 0 || frontendSemver.major === 0) {
+            // If the major and minor versions match and major versions are 0, compatible as long as backend patch version is greater
+            return difference === "same" || (difference === "patch" && frontendSemver.patch < backendSemver.patch);
+        }
+        else {
+            // If the strings match exactly, major and minor match but patch differs, versions are compatible
+            // If minor versions differ, compatible as long as backend patch versionn is greater
+            return difference === "same" || difference === "patch" || (difference === "minor" && frontendSemver.minor < backendSemver.minor);
+        }
+    }
+    /** @internal */
+    constructor(routing = RpcRoutingToken.default) {
+        this.routing = routing;
+        this.configuration = RpcConfiguration.supply(this);
+    }
+    /** Obtains the implementation result for an RPC operation. */
+    async forward(parameters) {
+        const parametersCompat = (arguments.length === 1 && typeof (parameters) === "object") ? parameters : arguments;
+        const parametersArray = Array.isArray(parametersCompat) ? parametersCompat : Array.prototype.slice.call(parametersCompat);
+        const operationName = parametersArray.pop();
+        const session = IpcSession.active;
+        if (session) {
+            return intercept(session, this, operationName, parametersArray);
+        }
+        else {
+            const request = new this.configuration.protocol.requestType(this, operationName, parametersArray);
+            request.submit(); // eslint-disable-line @typescript-eslint/no-floating-promises
+            this[CURRENT_REQUEST] = request;
+            return request.response;
+        }
+    }
+}
+RpcInterface.prototype.configurationSupplier = undefined;
+class InterceptedRequest extends RpcRequest {
+    async load() { throw new Error(); }
+    async send() { throw new Error(); }
+    setHeader(_name, _value) { throw new Error(); }
+}
+async function intercept(session, client, operation, parameters) {
+    const request = new InterceptedRequest(client, operation, []);
+    client[CURRENT_REQUEST] = request;
+    const context = await client.configuration.protocol.serialize(request);
+    request.parameters = parameters;
+    const info = {
+        definition: {
+            interfaceName: context.operation.interfaceDefinition,
+            interfaceVersion: context.operation.interfaceVersion,
+        },
+        operation,
+        parameters,
+        context: {
+            applicationId: context.applicationId,
+            applicationVersion: context.applicationVersion,
+            id: context.id,
+            sessionId: context.sessionId,
+            protocolVersion: (context.protocolVersion || 0).toString(),
+        },
+    };
+    const dispatch = async () => {
+        aggregateLoad.lastRequest = new Date().getTime();
+        const response = await session.handleRpc(info);
+        aggregateLoad.lastResponse = new Date().getTime();
+        if (typeof (response) === "object" && response.hasOwnProperty("iTwinRpcCoreResponse") && response.hasOwnProperty("managedStatus")) {
+            const status = response;
+            if (status.managedStatus === "pending") {
+                return handlePending(request, status, dispatch);
+            }
+            else if (status.managedStatus === "notFound") {
+                return handleNotFound(request, status, dispatch);
+            }
+            else if (status.managedStatus === "noContent") {
+                return handleNoContent();
+            }
+        }
+        else {
+            return response;
+        }
+    };
+    return dispatch();
+}
+async function handlePending(request, status, dispatch) {
+    request._status = RpcRequestStatus.Pending;
+    request._extendedStatus = status.responseValue.message;
+    RpcRequest.events.raiseEvent(RpcRequestEvent.PendingUpdateReceived, request);
+    const delay = request.operation.policy.retryInterval(request.client.configuration);
+    await BeDuration.wait(delay);
+    return dispatch();
+}
+async function handleNotFound(request, status, dispatch) {
+    return new Promise((resolve, reject) => {
+        let resubmitted = false;
+        RpcRequest.notFoundHandlers.raiseEvent(request, status.responseValue, async () => {
+            if (resubmitted) {
+                throw new IModelError(BentleyStatus.ERROR, `Already resubmitted using this handler.`);
+            }
+            resubmitted = true;
+            try {
+                const response = await dispatch();
+                resolve(response);
+            }
+            catch (err) {
+                reject(err);
+            }
+        }, reject);
+    });
+}
+async function handleNoContent() {
+    throw new NoContentError();
+}
 //# sourceMappingURL=RpcInterface.js.map

package/lib/esm/RpcInterface.js.map

@@ -1 +1 @@
-{"version":3,"file":"RpcInterface.js","sourceRoot":"","sources":["../../src/RpcInterface.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module RpcInterface\r\n */\r\n\r\nimport * as semver from \"semver\";\r\nimport { RpcConfiguration, RpcConfigurationSupplier } from \"./rpc/core/RpcConfiguration\";\r\nimport { CURRENT_REQUEST } from \"./rpc/core/RpcRegistry\";\r\nimport { aggregateLoad, RpcRequest } from \"./rpc/core/RpcRequest\";\r\nimport { RpcRoutingToken } from \"./rpc/core/RpcRoutingToken\";\r\nimport { InterceptedRpcRequest, IpcSession } from \"./ipc/IpcSession\";\r\nimport { RpcSerializedValue } from \"./rpc/core/RpcMarshaling\";\r\nimport { RpcManagedStatus } from \"./rpc/core/RpcProtocol\";\r\nimport { BentleyStatus, IModelError, NoContentError } from \"./IModelError\";\r\nimport { RpcRequestEvent, RpcRequestStatus } from \"./rpc/core/RpcConstants\";\r\nimport { BeDuration } from \"@itwin/core-bentley\";\r\nimport { RpcNotFoundResponse } from \"./rpc/core/RpcControl\";\r\n\r\n/* eslint-disable deprecation/deprecation */\r\n\r\n/** @internal */\r\nexport interface RpcInterfaceDefinition<T extends RpcInterface = RpcInterface> { prototype: T, interfaceName: string, interfaceVersion: string }\r\n\r\n/** @internal */\r\nexport type RpcInterfaceImplementation<T extends RpcInterface = RpcInterface> = new () => T;\r\n\r\n/** An RPC interface is a set of operations exposed by a service that a client can call, using configurable protocols,\r\n * in a platform-independent way. TheRpcInterface class is the base class for RPC interface definitions and implementations.\r\n * @public\r\n */\r\nexport abstract class RpcInterface {\r\n  /** Determines whether the backend version of an RPC interface is compatible (according to semantic versioning) with the frontend version of the interface. */\r\n  public static isVersionCompatible(backend: string, frontend: string): boolean {\r\n    const difference = semver.diff(backend, frontend);\r\n    if (semver.prerelease(backend) || semver.prerelease(frontend)) {\r\n      return difference === null;\r\n    } else if (semver.major(backend) === 0 || semver.major(frontend) === 0) {\r\n      return difference === null || (difference === \"patch\" && semver.patch(frontend) < semver.patch(backend));\r\n    } else {\r\n      return difference === null || difference === \"patch\" || (difference === \"minor\" && semver.minor(frontend) < semver.minor(backend));\r\n    }\r\n  }\r\n\r\n  /** The configuration for the RPC interface.\r\n   * @internal\r\n   */\r\n  public readonly configuration: RpcConfiguration;\r\n\r\n  /** @internal */\r\n  public readonly routing: RpcRoutingToken;\r\n\r\n  /** @internal */\r\n  public constructor(routing: RpcRoutingToken = RpcRoutingToken.default) {\r\n    this.routing = routing;\r\n    this.configuration = RpcConfiguration.supply(this);\r\n  }\r\n\r\n  /** Obtains the implementation result for an RPC operation. */\r\n  public async forward<T = any>(parameters: IArguments): Promise<T> {\r\n    const parametersCompat = (arguments.length === 1 && typeof (parameters) === \"object\") ? parameters : arguments;\r\n    const parametersArray = Array.isArray(parametersCompat) ? parametersCompat : Array.prototype.slice.call(parametersCompat);\r\n    const operationName = parametersArray.pop();\r\n\r\n    const session = IpcSession.active;\r\n    if (session) {\r\n      return intercept(session, this, operationName, parametersArray);\r\n    } else {\r\n      const request = new (this.configuration.protocol.requestType as any)(this, operationName, parametersArray) as RpcRequest;\r\n      request.submit(); // eslint-disable-line @typescript-eslint/no-floating-promises\r\n      (this as any)[CURRENT_REQUEST] = request;\r\n      return request.response;\r\n    }\r\n  }\r\n\r\n  /** @internal */\r\n  public configurationSupplier: RpcConfigurationSupplier | undefined;\r\n}\r\n\r\nRpcInterface.prototype.configurationSupplier = undefined;\r\n\r\nclass InterceptedRequest extends RpcRequest {\r\n  protected override async load(): Promise<RpcSerializedValue> { throw new Error(); }\r\n  protected override async send(): Promise<number> { throw new Error(); }\r\n  protected override setHeader(_name: string, _value: string): void { throw new Error(); }\r\n}\r\n\r\nasync function intercept(session: IpcSession, client: RpcInterface, operation: string, parameters: any[]) {\r\n  const request = new InterceptedRequest(client, operation, []);\r\n  (client as any)[CURRENT_REQUEST] = request;\r\n\r\n  const context = await client.configuration.protocol.serialize(request);\r\n  request.parameters = parameters;\r\n\r\n  const info: InterceptedRpcRequest = {\r\n    definition: {\r\n      interfaceName: context.operation.interfaceDefinition,\r\n      interfaceVersion: context.operation.interfaceVersion,\r\n    },\r\n    operation,\r\n    parameters,\r\n    context: {\r\n      applicationId: context.applicationId,\r\n      applicationVersion: context.applicationVersion,\r\n      id: context.id,\r\n      sessionId: context.sessionId,\r\n      protocolVersion: (context.protocolVersion || 0).toString(),\r\n    },\r\n  };\r\n\r\n  const dispatch = async () => {\r\n    aggregateLoad.lastRequest = new Date().getTime();\r\n\r\n    const response = await session.handleRpc(info);\r\n\r\n    aggregateLoad.lastResponse = new Date().getTime();\r\n\r\n    if (typeof (response) === \"object\" && response.hasOwnProperty(\"iTwinRpcCoreResponse\") && response.hasOwnProperty(\"managedStatus\")) {\r\n      const status: RpcManagedStatus = response;\r\n\r\n      if (status.managedStatus === \"pending\") {\r\n        return handlePending(request, status, dispatch);\r\n      } else if (status.managedStatus === \"notFound\") {\r\n        return handleNotFound(request, status, dispatch);\r\n      } else if (status.managedStatus === \"noContent\") {\r\n        return handleNoContent();\r\n      }\r\n    } else {\r\n      return response;\r\n    }\r\n  };\r\n\r\n  return dispatch();\r\n}\r\n\r\nasync function handlePending(request: InterceptedRequest, status: RpcManagedStatus, dispatch: () => Promise<any>) {\r\n  request._status = RpcRequestStatus.Pending;\r\n  request._extendedStatus = (status.responseValue as { message: string }).message;\r\n  RpcRequest.events.raiseEvent(RpcRequestEvent.PendingUpdateReceived, request);\r\n\r\n  const delay = request.operation.policy.retryInterval(request.client.configuration);\r\n\r\n  await BeDuration.wait(delay);\r\n  return dispatch();\r\n}\r\n\r\nasync function handleNotFound(request: InterceptedRequest, status: RpcManagedStatus, dispatch: () => Promise<any>) {\r\n  return new Promise((resolve, reject) => {\r\n    let resubmitted = false;\r\n\r\n    RpcRequest.notFoundHandlers.raiseEvent(request, status.responseValue as RpcNotFoundResponse, async () => {\r\n      if (resubmitted) {\r\n        throw new IModelError(BentleyStatus.ERROR, `Already resubmitted using this handler.`);\r\n      }\r\n\r\n      resubmitted = true;\r\n\r\n      try {\r\n        const response = await dispatch();\r\n        resolve(response);\r\n      } catch (err) {\r\n        reject(err);\r\n      }\r\n    }, reject);\r\n  });\r\n}\r\n\r\nasync function handleNoContent() {\r\n  throw new NoContentError();\r\n}\r\n"]}
+{"version":3,"file":"RpcInterface.js","sourceRoot":"","sources":["../../src/RpcInterface.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module RpcInterface\r\n */\r\nimport { RpcConfiguration, RpcConfigurationSupplier } from \"./rpc/core/RpcConfiguration\";\r\nimport { CURRENT_REQUEST } from \"./rpc/core/RpcRegistry\";\r\nimport { aggregateLoad, RpcRequest } from \"./rpc/core/RpcRequest\";\r\nimport { RpcRoutingToken } from \"./rpc/core/RpcRoutingToken\";\r\nimport { InterceptedRpcRequest, IpcSession } from \"./ipc/IpcSession\";\r\nimport { RpcSerializedValue } from \"./rpc/core/RpcMarshaling\";\r\nimport { RpcManagedStatus } from \"./rpc/core/RpcProtocol\";\r\nimport { BentleyStatus, IModelError, NoContentError } from \"./IModelError\";\r\nimport { RpcRequestEvent, RpcRequestStatus } from \"./rpc/core/RpcConstants\";\r\nimport { BeDuration } from \"@itwin/core-bentley\";\r\nimport { RpcNotFoundResponse } from \"./rpc/core/RpcControl\";\r\n\r\n/* eslint-disable deprecation/deprecation */\r\n\r\n/**\r\n * Specifies the required static properties of an RpcInterface class.\r\n * These properties are used to identify RPC requests and responses.\r\n * @beta\r\n */\r\nexport interface RpcInterfaceDefinition<T extends RpcInterface = RpcInterface> { prototype: T, interfaceName: string, interfaceVersion: string }\r\n\r\n/**\r\n * A class that implements the operations of an RPC interface.\r\n * @beta\r\n */\r\nexport type RpcInterfaceImplementation<T extends RpcInterface = RpcInterface> = new () => T;\r\n\r\ninterface SemverType {\r\n  major: number;\r\n  minor: number;\r\n  patch: number;\r\n  prerelease?: string;\r\n}\r\n\r\n/** An RPC interface is a set of operations exposed by a service that a client can call, using configurable protocols,\r\n * in a platform-independent way. TheRpcInterface class is the base class for RPC interface definitions and implementations.\r\n * @public\r\n */\r\nexport abstract class RpcInterface {\r\n\r\n  private static findDiff(backend: SemverType, frontend: SemverType) {\r\n    return backend.major !== frontend.major ? \"major\" : backend.minor !== frontend.minor ? \"minor\" : backend.patch !== frontend.patch ? \"patch\" : backend.prerelease !== frontend.prerelease ? \"prerelease\" : \"same\";\r\n  }\r\n\r\n  private static parseVer(version: string): SemverType {\r\n    // Split the version string into major.minor.path and prerelease tag\r\n    const split = version.split(/[:-]/);\r\n    // Split the major.minor.path into seperate components\r\n    const prefix = split[0].split(\".\");\r\n    if (split.length === 1) {\r\n      return { major: Number(prefix[0]), minor: Number(prefix[1]), patch: Number(prefix[2]) };\r\n    } else {\r\n      return { major: Number(prefix[0]), minor: Number(prefix[1]), patch: Number(prefix[2]), prerelease: split[1] };\r\n    }\r\n  }\r\n\r\n  /** Determines whether the backend version of an RPC interface is compatible (according to semantic versioning) with the frontend version of the interface. */\r\n  public static isVersionCompatible(backend: string, frontend: string): boolean {\r\n    const backendSemver = this.parseVer(backend);\r\n    const frontendSemver = this.parseVer(frontend);\r\n    const difference = this.findDiff(backendSemver, frontendSemver);\r\n\r\n    // If the major versions are different, the versions are not compatible\r\n    // In the case of prerelease tags, they are compatible if the whole version string matches, otherwise it fails\r\n    if ((backendSemver.prerelease !== undefined || frontendSemver.prerelease !== undefined) || difference === \"major\") {\r\n      return difference === \"same\";\r\n    } else if (backendSemver.major === 0 || frontendSemver.major === 0) {\r\n      // If the major and minor versions match and major versions are 0, compatible as long as backend patch version is greater\r\n      return difference === \"same\" || (difference === \"patch\" && frontendSemver.patch < backendSemver.patch);\r\n    } else {\r\n      // If the strings match exactly, major and minor match but patch differs, versions are compatible\r\n      // If minor versions differ, compatible as long as backend patch versionn is greater\r\n      return difference === \"same\" || difference === \"patch\" || (difference === \"minor\" && frontendSemver.minor < backendSemver.minor);\r\n    }\r\n  }\r\n\r\n  /** The configuration for the RPC interface.\r\n   * @internal\r\n   */\r\n  public readonly configuration: RpcConfiguration;\r\n\r\n  /** @internal */\r\n  public readonly routing: RpcRoutingToken;\r\n\r\n  /** @internal */\r\n  public constructor(routing: RpcRoutingToken = RpcRoutingToken.default) {\r\n    this.routing = routing;\r\n    this.configuration = RpcConfiguration.supply(this);\r\n  }\r\n\r\n  /** Obtains the implementation result for an RPC operation. */\r\n  public async forward<T = any>(parameters: IArguments): Promise<T> {\r\n    const parametersCompat = (arguments.length === 1 && typeof (parameters) === \"object\") ? parameters : arguments;\r\n    const parametersArray = Array.isArray(parametersCompat) ? parametersCompat : Array.prototype.slice.call(parametersCompat);\r\n    const operationName = parametersArray.pop();\r\n\r\n    const session = IpcSession.active;\r\n    if (session) {\r\n      return intercept(session, this, operationName, parametersArray);\r\n    } else {\r\n      const request = new (this.configuration.protocol.requestType as any)(this, operationName, parametersArray) as RpcRequest;\r\n      request.submit(); // eslint-disable-line @typescript-eslint/no-floating-promises\r\n      (this as any)[CURRENT_REQUEST] = request;\r\n      return request.response;\r\n    }\r\n  }\r\n\r\n  /** @internal */\r\n  public configurationSupplier: RpcConfigurationSupplier | undefined;\r\n}\r\n\r\nRpcInterface.prototype.configurationSupplier = undefined;\r\n\r\nclass InterceptedRequest extends RpcRequest {\r\n  protected override async load(): Promise<RpcSerializedValue> { throw new Error(); }\r\n  protected override async send(): Promise<number> { throw new Error(); }\r\n  protected override setHeader(_name: string, _value: string): void { throw new Error(); }\r\n}\r\n\r\nasync function intercept(session: IpcSession, client: RpcInterface, operation: string, parameters: any[]) {\r\n  const request = new InterceptedRequest(client, operation, []);\r\n  (client as any)[CURRENT_REQUEST] = request;\r\n\r\n  const context = await client.configuration.protocol.serialize(request);\r\n  request.parameters = parameters;\r\n\r\n  const info: InterceptedRpcRequest = {\r\n    definition: {\r\n      interfaceName: context.operation.interfaceDefinition,\r\n      interfaceVersion: context.operation.interfaceVersion,\r\n    },\r\n    operation,\r\n    parameters,\r\n    context: {\r\n      applicationId: context.applicationId,\r\n      applicationVersion: context.applicationVersion,\r\n      id: context.id,\r\n      sessionId: context.sessionId,\r\n      protocolVersion: (context.protocolVersion || 0).toString(),\r\n    },\r\n  };\r\n\r\n  const dispatch = async () => {\r\n    aggregateLoad.lastRequest = new Date().getTime();\r\n\r\n    const response = await session.handleRpc(info);\r\n\r\n    aggregateLoad.lastResponse = new Date().getTime();\r\n\r\n    if (typeof (response) === \"object\" && response.hasOwnProperty(\"iTwinRpcCoreResponse\") && response.hasOwnProperty(\"managedStatus\")) {\r\n      const status: RpcManagedStatus = response;\r\n\r\n      if (status.managedStatus === \"pending\") {\r\n        return handlePending(request, status, dispatch);\r\n      } else if (status.managedStatus === \"notFound\") {\r\n        return handleNotFound(request, status, dispatch);\r\n      } else if (status.managedStatus === \"noContent\") {\r\n        return handleNoContent();\r\n      }\r\n    } else {\r\n      return response;\r\n    }\r\n  };\r\n\r\n  return dispatch();\r\n}\r\n\r\nasync function handlePending(request: InterceptedRequest, status: RpcManagedStatus, dispatch: () => Promise<any>) {\r\n  request._status = RpcRequestStatus.Pending;\r\n  request._extendedStatus = (status.responseValue as { message: string }).message;\r\n  RpcRequest.events.raiseEvent(RpcRequestEvent.PendingUpdateReceived, request);\r\n\r\n  const delay = request.operation.policy.retryInterval(request.client.configuration);\r\n\r\n  await BeDuration.wait(delay);\r\n  return dispatch();\r\n}\r\n\r\nasync function handleNotFound(request: InterceptedRequest, status: RpcManagedStatus, dispatch: () => Promise<any>) {\r\n  return new Promise((resolve, reject) => {\r\n    let resubmitted = false;\r\n\r\n    RpcRequest.notFoundHandlers.raiseEvent(request, status.responseValue as RpcNotFoundResponse, async () => {\r\n      if (resubmitted) {\r\n        throw new IModelError(BentleyStatus.ERROR, `Already resubmitted using this handler.`);\r\n      }\r\n\r\n      resubmitted = true;\r\n\r\n      try {\r\n        const response = await dispatch();\r\n        resolve(response);\r\n      } catch (err) {\r\n        reject(err);\r\n      }\r\n    }, reject);\r\n  });\r\n}\r\n\r\nasync function handleNoContent() {\r\n  throw new NoContentError();\r\n}\r\n"]}

package/lib/esm/RpcManager.d.ts

@@ -1,41 +1,41 @@
-/** @packageDocumentation
- * @module RpcInterface
- */
-import { IModelRpcProps } from "./IModel";
-import { RpcInterface, RpcInterfaceDefinition, RpcInterfaceImplementation } from "./RpcInterface";
-import { RpcRoutingToken } from "./rpc/core/RpcRoutingToken";
-/** Describes the endpoints of an RPC interface.
- * @internal
- */
-export interface RpcInterfaceEndpoints {
-    interfaceName: string;
-    interfaceVersion: string;
-    operationNames: string[];
-    compatible: boolean;
-}
-/** RPC interface management is concerned with coordination of access and configuration for RPC interfaces.
- * @internal
- */
-export declare class RpcManager {
-    /** Initializes an RPC interface class.
-     * @note This function must be called on the frontend and on the backend for each RPC interface class used by an application.
-     */
-    static initializeInterface<T extends RpcInterface>(definition: RpcInterfaceDefinition<T>): void;
-    /** Terminates an RPC interface class. */
-    static terminateInterface<T extends RpcInterface>(definition: RpcInterfaceDefinition<T>): void;
-    /** Returns the RPC client instance for the frontend. */
-    static getClientForInterface<T extends RpcInterface>(definition: RpcInterfaceDefinition<T>, routing?: RpcRoutingToken): T;
-    /** Register the RPC implementation class for the backend. */
-    static registerImpl<TDefinition extends RpcInterface, TImplementation extends TDefinition>(definition: RpcInterfaceDefinition<TDefinition>, implementation: RpcInterfaceImplementation<TImplementation>): void;
-    /** Supply the instance of the RPC interface implementation class for the backend (optional). */
-    static supplyImplInstance<TDefinition extends RpcInterface, TImplementation extends TDefinition>(definition: RpcInterfaceDefinition<TDefinition>, instance: TImplementation): void;
-    /** Unregister the RPC implementation class for the backend. */
-    static unregisterImpl<TDefinition extends RpcInterface>(definition: RpcInterfaceDefinition<TDefinition>): void;
-    /** Describes the RPC interfaces and endpoints that are currently available from the backend.
-     * @note Some endpoints may be marked incompatible if the frontend expected a different interface declaration than the backend supplied. RPC operations against an incompatible interface will fail.
-     */
-    static describeAvailableEndpoints(): Promise<RpcInterfaceEndpoints[]>;
-    /** Configures RPC protocols that employ iModel-based routing infrastructure. */
-    static setIModel(props: IModelRpcProps): void;
-}
+/** @packageDocumentation
+ * @module RpcInterface
+ */
+import { IModelRpcProps } from "./IModel";
+import { RpcInterface, RpcInterfaceDefinition, RpcInterfaceImplementation } from "./RpcInterface";
+import { RpcRoutingToken } from "./rpc/core/RpcRoutingToken";
+/** Describes the endpoints of an RPC interface.
+ * @beta
+ */
+export interface RpcInterfaceEndpoints {
+    interfaceName: string;
+    interfaceVersion: string;
+    operationNames: string[];
+    compatible: boolean;
+}
+/** RPC interface management is concerned with coordination of access and configuration for RPC interfaces.
+ * @beta
+ */
+export declare class RpcManager {
+    /** Initializes an RPC interface class.
+     * @note This function must be called on the frontend and on the backend for each RPC interface class used by an application.
+     */
+    static initializeInterface<T extends RpcInterface>(definition: RpcInterfaceDefinition<T>): void;
+    /** Terminates an RPC interface class. */
+    static terminateInterface<T extends RpcInterface>(definition: RpcInterfaceDefinition<T>): void;
+    /** Returns the RPC client instance for the frontend. */
+    static getClientForInterface<T extends RpcInterface>(definition: RpcInterfaceDefinition<T>, routing?: RpcRoutingToken): T;
+    /** Register the RPC implementation class for the backend. */
+    static registerImpl<TDefinition extends RpcInterface, TImplementation extends TDefinition>(definition: RpcInterfaceDefinition<TDefinition>, implementation: RpcInterfaceImplementation<TImplementation>): void;
+    /** Supply the instance of the RPC interface implementation class for the backend (optional). */
+    static supplyImplInstance<TDefinition extends RpcInterface, TImplementation extends TDefinition>(definition: RpcInterfaceDefinition<TDefinition>, instance: TImplementation): void;
+    /** Unregister the RPC implementation class for the backend. */
+    static unregisterImpl<TDefinition extends RpcInterface>(definition: RpcInterfaceDefinition<TDefinition>): void;
+    /** Describes the RPC interfaces and endpoints that are currently available from the backend.
+     * @note Some endpoints may be marked incompatible if the frontend expected a different interface declaration than the backend supplied. RPC operations against an incompatible interface will fail.
+     */
+    static describeAvailableEndpoints(): Promise<RpcInterfaceEndpoints[]>;
+    /** Configures RPC protocols that employ iModel-based routing infrastructure. */
+    static setIModel(props: IModelRpcProps): void;
+}
 //# sourceMappingURL=RpcManager.d.ts.map

package/lib/esm/RpcManager.js

@@ -1,52 +1,52 @@
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module RpcInterface
- */
-import { RpcOperation } from "./rpc/core/RpcOperation";
-import { RpcRegistry } from "./rpc/core/RpcRegistry";
-import { RpcRoutingToken } from "./rpc/core/RpcRoutingToken";
-/** RPC interface management is concerned with coordination of access and configuration for RPC interfaces.
- * @internal
- */
-export class RpcManager {
-    /** Initializes an RPC interface class.
-     * @note This function must be called on the frontend and on the backend for each RPC interface class used by an application.
-     */
-    static initializeInterface(definition) {
-        RpcRegistry.instance.initializeRpcInterface(definition);
-    }
-    /** Terminates an RPC interface class. */
-    static terminateInterface(definition) {
-        RpcRegistry.instance.terminateRpcInterface(definition);
-    }
-    /** Returns the RPC client instance for the frontend. */
-    static getClientForInterface(definition, routing = RpcRoutingToken.default) {
-        return RpcRegistry.instance.getClientForInterface(definition, routing);
-    }
-    /** Register the RPC implementation class for the backend. */
-    static registerImpl(definition, implementation) {
-        RpcRegistry.instance.registerImpl(definition, implementation);
-    }
-    /** Supply the instance of the RPC interface implementation class for the backend (optional). */
-    static supplyImplInstance(definition, instance) {
-        RpcRegistry.instance.supplyImplInstance(definition, instance);
-    }
-    /** Unregister the RPC implementation class for the backend. */
-    static unregisterImpl(definition) {
-        RpcRegistry.instance.unregisterImpl(definition);
-    }
-    /** Describes the RPC interfaces and endpoints that are currently available from the backend.
-     * @note Some endpoints may be marked incompatible if the frontend expected a different interface declaration than the backend supplied. RPC operations against an incompatible interface will fail.
-     */
-    static async describeAvailableEndpoints() {
-        return RpcRegistry.instance.describeAvailableEndpoints();
-    }
-    /** Configures RPC protocols that employ iModel-based routing infrastructure. */
-    static setIModel(props) {
-        RpcOperation.fallbackToken = props;
-    }
-}
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module RpcInterface
+ */
+import { RpcOperation } from "./rpc/core/RpcOperation";
+import { RpcRegistry } from "./rpc/core/RpcRegistry";
+import { RpcRoutingToken } from "./rpc/core/RpcRoutingToken";
+/** RPC interface management is concerned with coordination of access and configuration for RPC interfaces.
+ * @beta
+ */
+export class RpcManager {
+    /** Initializes an RPC interface class.
+     * @note This function must be called on the frontend and on the backend for each RPC interface class used by an application.
+     */
+    static initializeInterface(definition) {
+        RpcRegistry.instance.initializeRpcInterface(definition);
+    }
+    /** Terminates an RPC interface class. */
+    static terminateInterface(definition) {
+        RpcRegistry.instance.terminateRpcInterface(definition);
+    }
+    /** Returns the RPC client instance for the frontend. */
+    static getClientForInterface(definition, routing = RpcRoutingToken.default) {
+        return RpcRegistry.instance.getClientForInterface(definition, routing);
+    }
+    /** Register the RPC implementation class for the backend. */
+    static registerImpl(definition, implementation) {
+        RpcRegistry.instance.registerImpl(definition, implementation);
+    }
+    /** Supply the instance of the RPC interface implementation class for the backend (optional). */
+    static supplyImplInstance(definition, instance) {
+        RpcRegistry.instance.supplyImplInstance(definition, instance);
+    }
+    /** Unregister the RPC implementation class for the backend. */
+    static unregisterImpl(definition) {
+        RpcRegistry.instance.unregisterImpl(definition);
+    }
+    /** Describes the RPC interfaces and endpoints that are currently available from the backend.
+     * @note Some endpoints may be marked incompatible if the frontend expected a different interface declaration than the backend supplied. RPC operations against an incompatible interface will fail.
+     */
+    static async describeAvailableEndpoints() {
+        return RpcRegistry.instance.describeAvailableEndpoints();
+    }
+    /** Configures RPC protocols that employ iModel-based routing infrastructure. */
+    static setIModel(props) {
+        RpcOperation.fallbackToken = props;
+    }
+}
 //# sourceMappingURL=RpcManager.js.map

package/lib/esm/RpcManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"RpcManager.js","sourceRoot":"","sources":["../../src/RpcManager.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAc7D;;GAEG;AACH,MAAM,OAAO,UAAU;IACrB;;OAEG;IACI,MAAM,CAAC,mBAAmB,CAAyB,UAAqC;QAC7F,WAAW,CAAC,QAAQ,CAAC,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAC1D,CAAC;IAED,yCAAyC;IAClC,MAAM,CAAC,kBAAkB,CAAyB,UAAqC;QAC5F,WAAW,CAAC,QAAQ,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC;IACzD,CAAC;IAED,wDAAwD;IACjD,MAAM,CAAC,qBAAqB,CAAyB,UAAqC,EAAE,UAA2B,eAAe,CAAC,OAAO;QACnJ,OAAO,WAAW,CAAC,QAAQ,CAAC,qBAAqB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACzE,CAAC;IAED,6DAA6D;IACtD,MAAM,CAAC,YAAY,CAAwE,UAA+C,EAAE,cAA2D;QAC5M,WAAW,CAAC,QAAQ,CAAC,YAAY,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IAChE,CAAC;IAED,gGAAgG;IACzF,MAAM,CAAC,kBAAkB,CAAwE,UAA+C,EAAE,QAAyB;QAChL,WAAW,CAAC,QAAQ,CAAC,kBAAkB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAChE,CAAC;IAED,+DAA+D;IACxD,MAAM,CAAC,cAAc,CAAmC,UAA+C;QAC5G,WAAW,CAAC,QAAQ,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,KAAK,CAAC,0BAA0B;QAC5C,OAAO,WAAW,CAAC,QAAQ,CAAC,0BAA0B,EAAE,CAAC;IAC3D,CAAC;IAED,gFAAgF;IACzE,MAAM,CAAC,SAAS,CAAC,KAAqB;QAC3C,YAAY,CAAC,aAAa,GAAG,KAAK,CAAC;IACrC,CAAC;CACF","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 RpcInterface\r\n */\r\n\r\nimport { IModelRpcProps } from \"./IModel\";\r\nimport { RpcOperation } from \"./rpc/core/RpcOperation\";\r\nimport { RpcRegistry } from \"./rpc/core/RpcRegistry\";\r\nimport { RpcInterface, RpcInterfaceDefinition, RpcInterfaceImplementation } from \"./RpcInterface\";\r\nimport { RpcRoutingToken } from \"./rpc/core/RpcRoutingToken\";\r\n\r\n/* eslint-disable deprecation/deprecation */\r\n\r\n/** Describes the endpoints of an RPC interface.\r\n * @internal\r\n */\r\nexport interface RpcInterfaceEndpoints {\r\n  interfaceName: string;\r\n  interfaceVersion: string;\r\n  operationNames: string[];\r\n  compatible: boolean;\r\n}\r\n\r\n/** RPC interface management is concerned with coordination of access and configuration for RPC interfaces.\r\n * @internal\r\n */\r\nexport class RpcManager {\r\n  /** Initializes an RPC interface class.\r\n   * @note This function must be called on the frontend and on the backend for each RPC interface class used by an application.\r\n   */\r\n  public static initializeInterface<T extends RpcInterface>(definition: RpcInterfaceDefinition<T>): void {\r\n    RpcRegistry.instance.initializeRpcInterface(definition);\r\n  }\r\n\r\n  /** Terminates an RPC interface class. */\r\n  public static terminateInterface<T extends RpcInterface>(definition: RpcInterfaceDefinition<T>): void {\r\n    RpcRegistry.instance.terminateRpcInterface(definition);\r\n  }\r\n\r\n  /** Returns the RPC client instance for the frontend. */\r\n  public static getClientForInterface<T extends RpcInterface>(definition: RpcInterfaceDefinition<T>, routing: RpcRoutingToken = RpcRoutingToken.default): T {\r\n    return RpcRegistry.instance.getClientForInterface(definition, routing);\r\n  }\r\n\r\n  /** Register the RPC implementation class for the backend. */\r\n  public static registerImpl<TDefinition extends RpcInterface, TImplementation extends TDefinition>(definition: RpcInterfaceDefinition<TDefinition>, implementation: RpcInterfaceImplementation<TImplementation>): void {\r\n    RpcRegistry.instance.registerImpl(definition, implementation);\r\n  }\r\n\r\n  /** Supply the instance of the RPC interface implementation class for the backend (optional). */\r\n  public static supplyImplInstance<TDefinition extends RpcInterface, TImplementation extends TDefinition>(definition: RpcInterfaceDefinition<TDefinition>, instance: TImplementation): void {\r\n    RpcRegistry.instance.supplyImplInstance(definition, instance);\r\n  }\r\n\r\n  /** Unregister the RPC implementation class for the backend. */\r\n  public static unregisterImpl<TDefinition extends RpcInterface>(definition: RpcInterfaceDefinition<TDefinition>): void {\r\n    RpcRegistry.instance.unregisterImpl(definition);\r\n  }\r\n\r\n  /** Describes the RPC interfaces and endpoints that are currently available from the backend.\r\n   * @note Some endpoints may be marked incompatible if the frontend expected a different interface declaration than the backend supplied. RPC operations against an incompatible interface will fail.\r\n   */\r\n  public static async describeAvailableEndpoints(): Promise<RpcInterfaceEndpoints[]> {\r\n    return RpcRegistry.instance.describeAvailableEndpoints();\r\n  }\r\n\r\n  /** Configures RPC protocols that employ iModel-based routing infrastructure. */\r\n  public static setIModel(props: IModelRpcProps) {\r\n    RpcOperation.fallbackToken = props;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"RpcManager.js","sourceRoot":"","sources":["../../src/RpcManager.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAc7D;;GAEG;AACH,MAAM,OAAO,UAAU;IACrB;;OAEG;IACI,MAAM,CAAC,mBAAmB,CAAyB,UAAqC;QAC7F,WAAW,CAAC,QAAQ,CAAC,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAC1D,CAAC;IAED,yCAAyC;IAClC,MAAM,CAAC,kBAAkB,CAAyB,UAAqC;QAC5F,WAAW,CAAC,QAAQ,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC;IACzD,CAAC;IAED,wDAAwD;IACjD,MAAM,CAAC,qBAAqB,CAAyB,UAAqC,EAAE,UAA2B,eAAe,CAAC,OAAO;QACnJ,OAAO,WAAW,CAAC,QAAQ,CAAC,qBAAqB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACzE,CAAC;IAED,6DAA6D;IACtD,MAAM,CAAC,YAAY,CAAwE,UAA+C,EAAE,cAA2D;QAC5M,WAAW,CAAC,QAAQ,CAAC,YAAY,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IAChE,CAAC;IAED,gGAAgG;IACzF,MAAM,CAAC,kBAAkB,CAAwE,UAA+C,EAAE,QAAyB;QAChL,WAAW,CAAC,QAAQ,CAAC,kBAAkB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAChE,CAAC;IAED,+DAA+D;IACxD,MAAM,CAAC,cAAc,CAAmC,UAA+C;QAC5G,WAAW,CAAC,QAAQ,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,KAAK,CAAC,0BAA0B;QAC5C,OAAO,WAAW,CAAC,QAAQ,CAAC,0BAA0B,EAAE,CAAC;IAC3D,CAAC;IAED,gFAAgF;IACzE,MAAM,CAAC,SAAS,CAAC,KAAqB;QAC3C,YAAY,CAAC,aAAa,GAAG,KAAK,CAAC;IACrC,CAAC;CACF","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 RpcInterface\r\n */\r\n\r\nimport { IModelRpcProps } from \"./IModel\";\r\nimport { RpcOperation } from \"./rpc/core/RpcOperation\";\r\nimport { RpcRegistry } from \"./rpc/core/RpcRegistry\";\r\nimport { RpcInterface, RpcInterfaceDefinition, RpcInterfaceImplementation } from \"./RpcInterface\";\r\nimport { RpcRoutingToken } from \"./rpc/core/RpcRoutingToken\";\r\n\r\n/* eslint-disable deprecation/deprecation */\r\n\r\n/** Describes the endpoints of an RPC interface.\r\n * @beta\r\n */\r\nexport interface RpcInterfaceEndpoints {\r\n  interfaceName: string;\r\n  interfaceVersion: string;\r\n  operationNames: string[];\r\n  compatible: boolean;\r\n}\r\n\r\n/** RPC interface management is concerned with coordination of access and configuration for RPC interfaces.\r\n * @beta\r\n */\r\nexport class RpcManager {\r\n  /** Initializes an RPC interface class.\r\n   * @note This function must be called on the frontend and on the backend for each RPC interface class used by an application.\r\n   */\r\n  public static initializeInterface<T extends RpcInterface>(definition: RpcInterfaceDefinition<T>): void {\r\n    RpcRegistry.instance.initializeRpcInterface(definition);\r\n  }\r\n\r\n  /** Terminates an RPC interface class. */\r\n  public static terminateInterface<T extends RpcInterface>(definition: RpcInterfaceDefinition<T>): void {\r\n    RpcRegistry.instance.terminateRpcInterface(definition);\r\n  }\r\n\r\n  /** Returns the RPC client instance for the frontend. */\r\n  public static getClientForInterface<T extends RpcInterface>(definition: RpcInterfaceDefinition<T>, routing: RpcRoutingToken = RpcRoutingToken.default): T {\r\n    return RpcRegistry.instance.getClientForInterface(definition, routing);\r\n  }\r\n\r\n  /** Register the RPC implementation class for the backend. */\r\n  public static registerImpl<TDefinition extends RpcInterface, TImplementation extends TDefinition>(definition: RpcInterfaceDefinition<TDefinition>, implementation: RpcInterfaceImplementation<TImplementation>): void {\r\n    RpcRegistry.instance.registerImpl(definition, implementation);\r\n  }\r\n\r\n  /** Supply the instance of the RPC interface implementation class for the backend (optional). */\r\n  public static supplyImplInstance<TDefinition extends RpcInterface, TImplementation extends TDefinition>(definition: RpcInterfaceDefinition<TDefinition>, instance: TImplementation): void {\r\n    RpcRegistry.instance.supplyImplInstance(definition, instance);\r\n  }\r\n\r\n  /** Unregister the RPC implementation class for the backend. */\r\n  public static unregisterImpl<TDefinition extends RpcInterface>(definition: RpcInterfaceDefinition<TDefinition>): void {\r\n    RpcRegistry.instance.unregisterImpl(definition);\r\n  }\r\n\r\n  /** Describes the RPC interfaces and endpoints that are currently available from the backend.\r\n   * @note Some endpoints may be marked incompatible if the frontend expected a different interface declaration than the backend supplied. RPC operations against an incompatible interface will fail.\r\n   */\r\n  public static async describeAvailableEndpoints(): Promise<RpcInterfaceEndpoints[]> {\r\n    return RpcRegistry.instance.describeAvailableEndpoints();\r\n  }\r\n\r\n  /** Configures RPC protocols that employ iModel-based routing infrastructure. */\r\n  public static setIModel(props: IModelRpcProps) {\r\n    RpcOperation.fallbackToken = props;\r\n  }\r\n}\r\n"]}

package/lib/esm/SessionProps.d.ts

@@ -1,17 +1,17 @@
-/** @packageDocumentation
- * @module RpcInterface
- */
-import { GuidString } from "@itwin/core-bentley";
-/** Properties that identify a session.
- * @public
- * @extensions
- */
-export interface SessionProps {
-    /** Used for logging and usage tracking to identify the application  */
-    readonly applicationId: string;
-    /** Used for logging and usage tracking to identify the application version  */
-    readonly applicationVersion: string;
-    /** Used for logging to identify a session  */
-    readonly sessionId: GuidString;
-}
+/** @packageDocumentation
+ * @module RpcInterface
+ */
+import { GuidString } from "@itwin/core-bentley";
+/** Properties that identify a session.
+ * @public
+ * @extensions
+ */
+export interface SessionProps {
+    /** Used for logging and usage tracking to identify the application  */
+    readonly applicationId: string;
+    /** Used for logging and usage tracking to identify the application version  */
+    readonly applicationVersion: string;
+    /** Used for logging to identify a session  */
+    readonly sessionId: GuidString;
+}
 //# sourceMappingURL=SessionProps.d.ts.map