@itwin/core-common 3.7.0-dev.6 → 3.7.0-dev.8

package/lib/cjs/RpcInterface.d.ts

@@ -1,34 +1,41 @@
-/** @packageDocumentation
- * @module RpcInterface
- */
-import { RpcConfiguration, RpcConfigurationSupplier } from "./rpc/core/RpcConfiguration";
-import { RpcRoutingToken } from "./rpc/core/RpcRoutingToken";
-/** @internal */
-export interface RpcInterfaceDefinition<T extends RpcInterface = RpcInterface> {
-    prototype: T;
-    interfaceName: string;
-    interfaceVersion: string;
-}
-/** @internal */
-export declare type RpcInterfaceImplementation<T extends RpcInterface = RpcInterface> = new () => T;
-/** 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 declare abstract class RpcInterface {
-    /** 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: string, frontend: string): boolean;
-    /** The configuration for the RPC interface.
-     * @internal
-     */
-    readonly configuration: RpcConfiguration;
-    /** @internal */
-    readonly routing: RpcRoutingToken;
-    /** @internal */
-    constructor(routing?: RpcRoutingToken);
-    /** Obtains the implementation result for an RPC operation. */
-    forward<T = any>(parameters: IArguments): Promise<T>;
-    /** @internal */
-    configurationSupplier: RpcConfigurationSupplier | undefined;
-}
+/** @packageDocumentation
+ * @module RpcInterface
+ */
+import { RpcConfiguration, RpcConfigurationSupplier } from "./rpc/core/RpcConfiguration";
+import { RpcRoutingToken } from "./rpc/core/RpcRoutingToken";
+/**
+ * Specifies the required static properties of an RpcInterface class.
+ * These properties are used to identify RPC requests and responses.
+ * @beta
+ */
+export interface RpcInterfaceDefinition<T extends RpcInterface = RpcInterface> {
+    prototype: T;
+    interfaceName: string;
+    interfaceVersion: string;
+}
+/**
+ * A class that implements the operations of an RPC interface.
+ * @beta
+ */
+export declare type RpcInterfaceImplementation<T extends RpcInterface = RpcInterface> = new () => T;
+/** 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 declare abstract class RpcInterface {
+    /** 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: string, frontend: string): boolean;
+    /** The configuration for the RPC interface.
+     * @internal
+     */
+    readonly configuration: RpcConfiguration;
+    /** @internal */
+    readonly routing: RpcRoutingToken;
+    /** @internal */
+    constructor(routing?: RpcRoutingToken);
+    /** Obtains the implementation result for an RPC operation. */
+    forward<T = any>(parameters: IArguments): Promise<T>;
+    /** @internal */
+    configurationSupplier: RpcConfigurationSupplier | undefined;
+}
 //# sourceMappingURL=RpcInterface.d.ts.map

package/lib/cjs/RpcInterface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RpcInterface.d.ts","sourceRoot":"","sources":["../../src/RpcInterface.ts"],"names":[],"mappings":"AAIA;;GAEG;AAGH,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAGzF,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAW7D,gBAAgB;AAChB,MAAM,WAAW,sBAAsB,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY;IAAI,SAAS,EAAE,CAAC,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE;AAEhJ,gBAAgB;AAChB,oBAAY,0BAA0B,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,IAAI,UAAU,CAAC,CAAC;AAE5F;;;GAGG;AACH,8BAAsB,YAAY;IAChC,8JAA8J;WAChJ,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAW7E;;OAEG;IACH,SAAgB,aAAa,EAAE,gBAAgB,CAAC;IAEhD,gBAAgB;IAChB,SAAgB,OAAO,EAAE,eAAe,CAAC;IAEzC,gBAAgB;gBACG,OAAO,GAAE,eAAyC;IAKrE,8DAA8D;IACjD,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC;IAgBjE,gBAAgB;IACT,qBAAqB,EAAE,wBAAwB,GAAG,SAAS,CAAC;CACpE"}
+{"version":3,"file":"RpcInterface.d.ts","sourceRoot":"","sources":["../../src/RpcInterface.ts"],"names":[],"mappings":"AAIA;;GAEG;AAGH,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAGzF,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAW7D;;;;GAIG;AACH,MAAM,WAAW,sBAAsB,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY;IAAI,SAAS,EAAE,CAAC,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE;AAEhJ;;;GAGG;AACH,oBAAY,0BAA0B,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,IAAI,UAAU,CAAC,CAAC;AAE5F;;;GAGG;AACH,8BAAsB,YAAY;IAChC,8JAA8J;WAChJ,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAW7E;;OAEG;IACH,SAAgB,aAAa,EAAE,gBAAgB,CAAC;IAEhD,gBAAgB;IAChB,SAAgB,OAAO,EAAE,eAAe,CAAC;IAEzC,gBAAgB;gBACG,OAAO,GAAE,eAAyC;IAKrE,8DAA8D;IACjD,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC;IAgBjE,gBAAgB;IACT,qBAAqB,EAAE,wBAAwB,GAAG,SAAS,CAAC;CACpE"}

package/lib/cjs/RpcInterface.js

@@ -1,138 +1,138 @@
-"use strict";
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module RpcInterface
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RpcInterface = void 0;
-const semver = require("semver");
-const RpcConfiguration_1 = require("./rpc/core/RpcConfiguration");
-const RpcRegistry_1 = require("./rpc/core/RpcRegistry");
-const RpcRequest_1 = require("./rpc/core/RpcRequest");
-const RpcRoutingToken_1 = require("./rpc/core/RpcRoutingToken");
-const IpcSession_1 = require("./ipc/IpcSession");
-const IModelError_1 = require("./IModelError");
-const RpcConstants_1 = require("./rpc/core/RpcConstants");
-const core_bentley_1 = require("@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
- */
-class RpcInterface {
-    /** @internal */
-    constructor(routing = RpcRoutingToken_1.RpcRoutingToken.default) {
-        this.routing = routing;
-        this.configuration = RpcConfiguration_1.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_1.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[RpcRegistry_1.CURRENT_REQUEST] = request;
-            return request.response;
-        }
-    }
-}
-exports.RpcInterface = RpcInterface;
-RpcInterface.prototype.configurationSupplier = undefined;
-class InterceptedRequest extends RpcRequest_1.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[RpcRegistry_1.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 () => {
-        RpcRequest_1.aggregateLoad.lastRequest = new Date().getTime();
-        const response = await session.handleRpc(info);
-        RpcRequest_1.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 = RpcConstants_1.RpcRequestStatus.Pending;
-    request._extendedStatus = status.responseValue.message;
-    RpcRequest_1.RpcRequest.events.raiseEvent(RpcConstants_1.RpcRequestEvent.PendingUpdateReceived, request);
-    const delay = request.operation.policy.retryInterval(request.client.configuration);
-    await core_bentley_1.BeDuration.wait(delay);
-    return dispatch();
-}
-async function handleNotFound(request, status, dispatch) {
-    return new Promise((resolve, reject) => {
-        let resubmitted = false;
-        RpcRequest_1.RpcRequest.notFoundHandlers.raiseEvent(request, status.responseValue, async () => {
-            if (resubmitted) {
-                throw new IModelError_1.IModelError(IModelError_1.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 IModelError_1.NoContentError();
-}
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module RpcInterface
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RpcInterface = void 0;
+const semver = require("semver");
+const RpcConfiguration_1 = require("./rpc/core/RpcConfiguration");
+const RpcRegistry_1 = require("./rpc/core/RpcRegistry");
+const RpcRequest_1 = require("./rpc/core/RpcRequest");
+const RpcRoutingToken_1 = require("./rpc/core/RpcRoutingToken");
+const IpcSession_1 = require("./ipc/IpcSession");
+const IModelError_1 = require("./IModelError");
+const RpcConstants_1 = require("./rpc/core/RpcConstants");
+const core_bentley_1 = require("@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
+ */
+class RpcInterface {
+    /** @internal */
+    constructor(routing = RpcRoutingToken_1.RpcRoutingToken.default) {
+        this.routing = routing;
+        this.configuration = RpcConfiguration_1.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_1.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[RpcRegistry_1.CURRENT_REQUEST] = request;
+            return request.response;
+        }
+    }
+}
+exports.RpcInterface = RpcInterface;
+RpcInterface.prototype.configurationSupplier = undefined;
+class InterceptedRequest extends RpcRequest_1.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[RpcRegistry_1.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 () => {
+        RpcRequest_1.aggregateLoad.lastRequest = new Date().getTime();
+        const response = await session.handleRpc(info);
+        RpcRequest_1.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 = RpcConstants_1.RpcRequestStatus.Pending;
+    request._extendedStatus = status.responseValue.message;
+    RpcRequest_1.RpcRequest.events.raiseEvent(RpcConstants_1.RpcRequestEvent.PendingUpdateReceived, request);
+    const delay = request.operation.policy.retryInterval(request.client.configuration);
+    await core_bentley_1.BeDuration.wait(delay);
+    return dispatch();
+}
+async function handleNotFound(request, status, dispatch) {
+    return new Promise((resolve, reject) => {
+        let resubmitted = false;
+        RpcRequest_1.RpcRequest.notFoundHandlers.raiseEvent(request, status.responseValue, async () => {
+            if (resubmitted) {
+                throw new IModelError_1.IModelError(IModelError_1.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 IModelError_1.NoContentError();
+}
 //# sourceMappingURL=RpcInterface.js.map

package/lib/cjs/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":["/*---------------------------------------------------------------------------------------------\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 RpcInterface\n */\n\nimport * as semver from \"semver\";\nimport { RpcConfiguration, RpcConfigurationSupplier } from \"./rpc/core/RpcConfiguration\";\nimport { CURRENT_REQUEST } from \"./rpc/core/RpcRegistry\";\nimport { aggregateLoad, RpcRequest } from \"./rpc/core/RpcRequest\";\nimport { RpcRoutingToken } from \"./rpc/core/RpcRoutingToken\";\nimport { InterceptedRpcRequest, IpcSession } from \"./ipc/IpcSession\";\nimport { RpcSerializedValue } from \"./rpc/core/RpcMarshaling\";\nimport { RpcManagedStatus } from \"./rpc/core/RpcProtocol\";\nimport { BentleyStatus, IModelError, NoContentError } from \"./IModelError\";\nimport { RpcRequestEvent, RpcRequestStatus } from \"./rpc/core/RpcConstants\";\nimport { BeDuration } from \"@itwin/core-bentley\";\nimport { RpcNotFoundResponse } from \"./rpc/core/RpcControl\";\n\n/* eslint-disable deprecation/deprecation */\n\n/**\n * Specifies the required static properties of an RpcInterface class.\n * These properties are used to identify RPC requests and responses.\n * @beta\n */\nexport interface RpcInterfaceDefinition<T extends RpcInterface = RpcInterface> { prototype: T, interfaceName: string, interfaceVersion: string }\n\n/**\n * A class that implements the operations of an RPC interface.\n * @beta\n */\nexport type RpcInterfaceImplementation<T extends RpcInterface = RpcInterface> = new () => T;\n\n/** An RPC interface is a set of operations exposed by a service that a client can call, using configurable protocols,\n * in a platform-independent way. TheRpcInterface class is the base class for RPC interface definitions and implementations.\n * @public\n */\nexport abstract class RpcInterface {\n  /** Determines whether the backend version of an RPC interface is compatible (according to semantic versioning) with the frontend version of the interface. */\n  public static isVersionCompatible(backend: string, frontend: string): boolean {\n    const difference = semver.diff(backend, frontend);\n    if (semver.prerelease(backend) || semver.prerelease(frontend)) {\n      return difference === null;\n    } else if (semver.major(backend) === 0 || semver.major(frontend) === 0) {\n      return difference === null || (difference === \"patch\" && semver.patch(frontend) < semver.patch(backend));\n    } else {\n      return difference === null || difference === \"patch\" || (difference === \"minor\" && semver.minor(frontend) < semver.minor(backend));\n    }\n  }\n\n  /** The configuration for the RPC interface.\n   * @internal\n   */\n  public readonly configuration: RpcConfiguration;\n\n  /** @internal */\n  public readonly routing: RpcRoutingToken;\n\n  /** @internal */\n  public constructor(routing: RpcRoutingToken = RpcRoutingToken.default) {\n    this.routing = routing;\n    this.configuration = RpcConfiguration.supply(this);\n  }\n\n  /** Obtains the implementation result for an RPC operation. */\n  public async forward<T = any>(parameters: IArguments): Promise<T> {\n    const parametersCompat = (arguments.length === 1 && typeof (parameters) === \"object\") ? parameters : arguments;\n    const parametersArray = Array.isArray(parametersCompat) ? parametersCompat : Array.prototype.slice.call(parametersCompat);\n    const operationName = parametersArray.pop();\n\n    const session = IpcSession.active;\n    if (session) {\n      return intercept(session, this, operationName, parametersArray);\n    } else {\n      const request = new (this.configuration.protocol.requestType as any)(this, operationName, parametersArray) as RpcRequest;\n      request.submit(); // eslint-disable-line @typescript-eslint/no-floating-promises\n      (this as any)[CURRENT_REQUEST] = request;\n      return request.response;\n    }\n  }\n\n  /** @internal */\n  public configurationSupplier: RpcConfigurationSupplier | undefined;\n}\n\nRpcInterface.prototype.configurationSupplier = undefined;\n\nclass InterceptedRequest extends RpcRequest {\n  protected override async load(): Promise<RpcSerializedValue> { throw new Error(); }\n  protected override async send(): Promise<number> { throw new Error(); }\n  protected override setHeader(_name: string, _value: string): void { throw new Error(); }\n}\n\nasync function intercept(session: IpcSession, client: RpcInterface, operation: string, parameters: any[]) {\n  const request = new InterceptedRequest(client, operation, []);\n  (client as any)[CURRENT_REQUEST] = request;\n\n  const context = await client.configuration.protocol.serialize(request);\n  request.parameters = parameters;\n\n  const info: InterceptedRpcRequest = {\n    definition: {\n      interfaceName: context.operation.interfaceDefinition,\n      interfaceVersion: context.operation.interfaceVersion,\n    },\n    operation,\n    parameters,\n    context: {\n      applicationId: context.applicationId,\n      applicationVersion: context.applicationVersion,\n      id: context.id,\n      sessionId: context.sessionId,\n      protocolVersion: (context.protocolVersion || 0).toString(),\n    },\n  };\n\n  const dispatch = async () => {\n    aggregateLoad.lastRequest = new Date().getTime();\n\n    const response = await session.handleRpc(info);\n\n    aggregateLoad.lastResponse = new Date().getTime();\n\n    if (typeof (response) === \"object\" && response.hasOwnProperty(\"iTwinRpcCoreResponse\") && response.hasOwnProperty(\"managedStatus\")) {\n      const status: RpcManagedStatus = response;\n\n      if (status.managedStatus === \"pending\") {\n        return handlePending(request, status, dispatch);\n      } else if (status.managedStatus === \"notFound\") {\n        return handleNotFound(request, status, dispatch);\n      } else if (status.managedStatus === \"noContent\") {\n        return handleNoContent();\n      }\n    } else {\n      return response;\n    }\n  };\n\n  return dispatch();\n}\n\nasync function handlePending(request: InterceptedRequest, status: RpcManagedStatus, dispatch: () => Promise<any>) {\n  request._status = RpcRequestStatus.Pending;\n  request._extendedStatus = (status.responseValue as { message: string }).message;\n  RpcRequest.events.raiseEvent(RpcRequestEvent.PendingUpdateReceived, request);\n\n  const delay = request.operation.policy.retryInterval(request.client.configuration);\n\n  await BeDuration.wait(delay);\n  return dispatch();\n}\n\nasync function handleNotFound(request: InterceptedRequest, status: RpcManagedStatus, dispatch: () => Promise<any>) {\n  return new Promise((resolve, reject) => {\n    let resubmitted = false;\n\n    RpcRequest.notFoundHandlers.raiseEvent(request, status.responseValue as RpcNotFoundResponse, async () => {\n      if (resubmitted) {\n        throw new IModelError(BentleyStatus.ERROR, `Already resubmitted using this handler.`);\n      }\n\n      resubmitted = true;\n\n      try {\n        const response = await dispatch();\n        resolve(response);\n      } catch (err) {\n        reject(err);\n      }\n    }, reject);\n  });\n}\n\nasync function handleNoContent() {\n  throw new NoContentError();\n}\n"]}

package/lib/cjs/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/cjs/RpcManager.js

@@ -1,56 +1,56 @@
-"use strict";
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module RpcInterface
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RpcManager = void 0;
-const RpcOperation_1 = require("./rpc/core/RpcOperation");
-const RpcRegistry_1 = require("./rpc/core/RpcRegistry");
-const RpcRoutingToken_1 = require("./rpc/core/RpcRoutingToken");
-/** RPC interface management is concerned with coordination of access and configuration for RPC interfaces.
- * @internal
- */
-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_1.RpcRegistry.instance.initializeRpcInterface(definition);
-    }
-    /** Terminates an RPC interface class. */
-    static terminateInterface(definition) {
-        RpcRegistry_1.RpcRegistry.instance.terminateRpcInterface(definition);
-    }
-    /** Returns the RPC client instance for the frontend. */
-    static getClientForInterface(definition, routing = RpcRoutingToken_1.RpcRoutingToken.default) {
-        return RpcRegistry_1.RpcRegistry.instance.getClientForInterface(definition, routing);
-    }
-    /** Register the RPC implementation class for the backend. */
-    static registerImpl(definition, implementation) {
-        RpcRegistry_1.RpcRegistry.instance.registerImpl(definition, implementation);
-    }
-    /** Supply the instance of the RPC interface implementation class for the backend (optional). */
-    static supplyImplInstance(definition, instance) {
-        RpcRegistry_1.RpcRegistry.instance.supplyImplInstance(definition, instance);
-    }
-    /** Unregister the RPC implementation class for the backend. */
-    static unregisterImpl(definition) {
-        RpcRegistry_1.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_1.RpcRegistry.instance.describeAvailableEndpoints();
-    }
-    /** Configures RPC protocols that employ iModel-based routing infrastructure. */
-    static setIModel(props) {
-        RpcOperation_1.RpcOperation.fallbackToken = props;
-    }
-}
-exports.RpcManager = RpcManager;
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module RpcInterface
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RpcManager = void 0;
+const RpcOperation_1 = require("./rpc/core/RpcOperation");
+const RpcRegistry_1 = require("./rpc/core/RpcRegistry");
+const RpcRoutingToken_1 = require("./rpc/core/RpcRoutingToken");
+/** RPC interface management is concerned with coordination of access and configuration for RPC interfaces.
+ * @beta
+ */
+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_1.RpcRegistry.instance.initializeRpcInterface(definition);
+    }
+    /** Terminates an RPC interface class. */
+    static terminateInterface(definition) {
+        RpcRegistry_1.RpcRegistry.instance.terminateRpcInterface(definition);
+    }
+    /** Returns the RPC client instance for the frontend. */
+    static getClientForInterface(definition, routing = RpcRoutingToken_1.RpcRoutingToken.default) {
+        return RpcRegistry_1.RpcRegistry.instance.getClientForInterface(definition, routing);
+    }
+    /** Register the RPC implementation class for the backend. */
+    static registerImpl(definition, implementation) {
+        RpcRegistry_1.RpcRegistry.instance.registerImpl(definition, implementation);
+    }
+    /** Supply the instance of the RPC interface implementation class for the backend (optional). */
+    static supplyImplInstance(definition, instance) {
+        RpcRegistry_1.RpcRegistry.instance.supplyImplInstance(definition, instance);
+    }
+    /** Unregister the RPC implementation class for the backend. */
+    static unregisterImpl(definition) {
+        RpcRegistry_1.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_1.RpcRegistry.instance.describeAvailableEndpoints();
+    }
+    /** Configures RPC protocols that employ iModel-based routing infrastructure. */
+    static setIModel(props) {
+        RpcOperation_1.RpcOperation.fallbackToken = props;
+    }
+}
+exports.RpcManager = RpcManager;
 //# sourceMappingURL=RpcManager.js.map