@itwin/core-common 3.6.0-dev.65 → 3.6.0-dev.66

package/lib/esm/rpc/core/RpcControl.js

@@ -1,142 +1,139 @@
-/*---------------------------------------------------------------------------------------------
-* 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 { Base64 } from "js-base64";
-import { RpcInterface } from "../../RpcInterface";
-import { RpcManager } from "../../RpcManager";
-import { RpcConfiguration } from "./RpcConfiguration";
-import { RpcOperation } from "./RpcOperation";
-import { RpcRegistry } from "./RpcRegistry";
-/* eslint-disable deprecation/deprecation */
-/** An RPC operation control response.
- * @public
- * @deprecated in 3.6. The RPC system will be significantly refactored (or replaced) in version 5.0.
- */
-export class RpcControlResponse {
-    constructor() {
-        this.message = "RpcControlResponse";
-    }
-}
-/** A pending RPC operation response.
- * @public
- * @deprecated in 3.6. The RPC system will be significantly refactored (or replaced) in version 5.0.
- */
-export class RpcPendingResponse extends RpcControlResponse {
-    /** Constructs a pending response. */
-    constructor(message = "") {
-        super();
-        this.message = message;
-    }
-}
-/** A RPC operation response.
- * @public
- * @deprecated in 3.6. The RPC system will be significantly refactored (or replaced) in version 5.0.
- */
-export class RpcNotFoundResponse extends RpcControlResponse {
-    constructor() {
-        super(...arguments);
-        this.message = "Not found";
-    }
-}
-/** Manages requests and responses for an RPC configuration.
- * @internal
- */
-export class RpcControlChannel {
-    constructor(configuration) {
-        var _a;
-        this._initialized = false;
-        this._clientActive = false;
-        this._describeEndpoints = undefined;
-        this._channelInterface = (_a = class extends RpcInterface {
-                async describeEndpoints() { return this.forward(arguments); }
-            },
-            _a.interfaceVersion = "CONTROL",
-            _a.interfaceName = "",
-            _a);
-        this._channelImpl = class extends RpcInterface {
-            async describeEndpoints() {
-                const endpoints = [];
-                this.configuration.interfaces().forEach((definition) => {
-                    if (!RpcRegistry.instance.isRpcInterfaceInitialized(definition))
-                        return;
-                    const description = { interfaceName: definition.interfaceName, interfaceVersion: definition.interfaceVersion, operationNames: [], compatible: true };
-                    RpcOperation.forEach(definition, (operation) => description.operationNames.push(operation.operationName));
-                    endpoints.push(description);
-                });
-                return endpoints;
-            }
-        };
-        this._configuration = configuration;
-        RpcControlChannel.channels.push(this);
-    }
-    /** @internal */
-    static ensureInitialized() {
-        this.channels.forEach((channel) => channel.initialize());
-    }
-    /** @internal */
-    async describeEndpoints() {
-        this.activateClient();
-        if (!this._channelInterface.interfaceName) {
-            return [];
-        }
-        return this._describeEndpoints();
-    }
-    /** @internal */
-    static obtain(configuration) {
-        if (RpcControlChannel._obtainLock)
-            return undefined;
-        ++RpcControlChannel._obtainLock;
-        const channel = new RpcControlChannel(configuration);
-        --RpcControlChannel._obtainLock;
-        return channel;
-    }
-    computeId() {
-        const interfaces = [];
-        this._configuration.interfaces().forEach((definition) => interfaces.push(`${definition.interfaceName}@${definition.interfaceVersion}`));
-        const id = interfaces.sort().join(",");
-        return Base64.encode(id);
-    }
-    activateClient() {
-        if (this._clientActive)
-            return;
-        this.initialize();
-        const token = { key: "none", iTwinId: "none", iModelId: "none", changeset: { id: "none" } };
-        RpcOperation.forEach(this._channelInterface, (operation) => operation.policy.token = (_request) => { var _a; return (_a = RpcOperation.fallbackToken) !== null && _a !== void 0 ? _a : token; });
-        const client = RpcManager.getClientForInterface(this._channelInterface);
-        this._describeEndpoints = async () => client.describeEndpoints();
-        this._clientActive = true;
-    }
-    /** @internal */
-    initialize() {
-        if (this._initialized) {
-            return;
-        }
-        const id = this.computeId();
-        Object.defineProperty(this._channelInterface, "interfaceName", { value: id });
-        Object.defineProperty(this._channelImpl, "interfaceName", { value: id });
-        RpcConfiguration.assign(this._channelInterface, () => this._configuration.constructor);
-        RpcManager.registerImpl(this._channelInterface, this._channelImpl);
-        RpcManager.initializeInterface(this._channelInterface);
-        this._initialized = true;
-    }
-    /** @internal */
-    handleUnknownOperation(invocation, _error) {
-        this.initialize();
-        const op = invocation.request.operation;
-        if (op.interfaceVersion === "CONTROL" && op.operationName === "describeEndpoints") {
-            if (this._channelInterface.interfaceName) {
-                op.interfaceDefinition = this._channelInterface.interfaceName;
-            }
-            return true;
-        }
-        return false;
-    }
-}
-/** @internal */
-RpcControlChannel.channels = [];
-RpcControlChannel._obtainLock = 0;
+/*---------------------------------------------------------------------------------------------
+* 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 { Base64 } from "js-base64";
+import { RpcInterface } from "../../RpcInterface";
+import { RpcManager } from "../../RpcManager";
+import { RpcConfiguration } from "./RpcConfiguration";
+import { RpcOperation } from "./RpcOperation";
+import { RpcRegistry } from "./RpcRegistry";
+/* eslint-disable deprecation/deprecation */
+/** An RPC operation control response.
+ * @public
+ */
+export class RpcControlResponse {
+    constructor() {
+        this.message = "RpcControlResponse";
+    }
+}
+/** A pending RPC operation response.
+ * @public
+ */
+export class RpcPendingResponse extends RpcControlResponse {
+    /** Constructs a pending response. */
+    constructor(message = "") {
+        super();
+        this.message = message;
+    }
+}
+/** A RPC operation response.
+ * @public
+ */
+export class RpcNotFoundResponse extends RpcControlResponse {
+    constructor() {
+        super(...arguments);
+        this.message = "Not found";
+    }
+}
+/** Manages requests and responses for an RPC configuration.
+ * @internal
+ */
+export class RpcControlChannel {
+    constructor(configuration) {
+        var _a;
+        this._initialized = false;
+        this._clientActive = false;
+        this._describeEndpoints = undefined;
+        this._channelInterface = (_a = class extends RpcInterface {
+                async describeEndpoints() { return this.forward(arguments); }
+            },
+            _a.interfaceVersion = "CONTROL",
+            _a.interfaceName = "",
+            _a);
+        this._channelImpl = class extends RpcInterface {
+            async describeEndpoints() {
+                const endpoints = [];
+                this.configuration.interfaces().forEach((definition) => {
+                    if (!RpcRegistry.instance.isRpcInterfaceInitialized(definition))
+                        return;
+                    const description = { interfaceName: definition.interfaceName, interfaceVersion: definition.interfaceVersion, operationNames: [], compatible: true };
+                    RpcOperation.forEach(definition, (operation) => description.operationNames.push(operation.operationName));
+                    endpoints.push(description);
+                });
+                return endpoints;
+            }
+        };
+        this._configuration = configuration;
+        RpcControlChannel.channels.push(this);
+    }
+    /** @internal */
+    static ensureInitialized() {
+        this.channels.forEach((channel) => channel.initialize());
+    }
+    /** @internal */
+    async describeEndpoints() {
+        this.activateClient();
+        if (!this._channelInterface.interfaceName) {
+            return [];
+        }
+        return this._describeEndpoints();
+    }
+    /** @internal */
+    static obtain(configuration) {
+        if (RpcControlChannel._obtainLock)
+            return undefined;
+        ++RpcControlChannel._obtainLock;
+        const channel = new RpcControlChannel(configuration);
+        --RpcControlChannel._obtainLock;
+        return channel;
+    }
+    computeId() {
+        const interfaces = [];
+        this._configuration.interfaces().forEach((definition) => interfaces.push(`${definition.interfaceName}@${definition.interfaceVersion}`));
+        const id = interfaces.sort().join(",");
+        return Base64.encode(id);
+    }
+    activateClient() {
+        if (this._clientActive)
+            return;
+        this.initialize();
+        const token = { key: "none", iTwinId: "none", iModelId: "none", changeset: { id: "none" } };
+        RpcOperation.forEach(this._channelInterface, (operation) => operation.policy.token = (_request) => { var _a; return (_a = RpcOperation.fallbackToken) !== null && _a !== void 0 ? _a : token; });
+        const client = RpcManager.getClientForInterface(this._channelInterface);
+        this._describeEndpoints = async () => client.describeEndpoints();
+        this._clientActive = true;
+    }
+    /** @internal */
+    initialize() {
+        if (this._initialized) {
+            return;
+        }
+        const id = this.computeId();
+        Object.defineProperty(this._channelInterface, "interfaceName", { value: id });
+        Object.defineProperty(this._channelImpl, "interfaceName", { value: id });
+        RpcConfiguration.assign(this._channelInterface, () => this._configuration.constructor);
+        RpcManager.registerImpl(this._channelInterface, this._channelImpl);
+        RpcManager.initializeInterface(this._channelInterface);
+        this._initialized = true;
+    }
+    /** @internal */
+    handleUnknownOperation(invocation, _error) {
+        this.initialize();
+        const op = invocation.request.operation;
+        if (op.interfaceVersion === "CONTROL" && op.operationName === "describeEndpoints") {
+            if (this._channelInterface.interfaceName) {
+                op.interfaceDefinition = this._channelInterface.interfaceName;
+            }
+            return true;
+        }
+        return false;
+    }
+}
+/** @internal */
+RpcControlChannel.channels = [];
+RpcControlChannel._obtainLock = 0;
 //# sourceMappingURL=RpcControl.js.map

package/lib/esm/rpc/core/RpcControl.js.map

@@ -1 +1 @@
-{"version":3,"file":"RpcControl.js","sourceRoot":"","sources":["../../../../src/rpc/core/RpcControl.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 { Base64 } from \"js-base64\";\nimport { IModelRpcProps } from \"../../IModel\";\nimport { RpcInterface } from \"../../RpcInterface\";\nimport { RpcInterfaceEndpoints, RpcManager } from \"../../RpcManager\";\nimport { RpcConfiguration } from \"./RpcConfiguration\";\nimport { RpcInvocation } from \"./RpcInvocation\";\nimport { RpcOperation } from \"./RpcOperation\";\nimport { RpcRegistry } from \"./RpcRegistry\";\n\n/* eslint-disable deprecation/deprecation */\n\n/** An RPC operation control response.\n * @public\n * @deprecated in 3.6. The RPC system will be significantly refactored (or replaced) in version 5.0.\n */\nexport abstract class RpcControlResponse {\n  public message = \"RpcControlResponse\";\n}\n\n/** A pending RPC operation response.\n * @public\n * @deprecated in 3.6. The RPC system will be significantly refactored (or replaced) in version 5.0.\n */\nexport class RpcPendingResponse extends RpcControlResponse {\n  /** Extended status regarding the pending operation. */\n  public override message: string;\n\n  /** Constructs a pending response. */\n  public constructor(message: string = \"\") {\n    super();\n    this.message = message;\n  }\n}\n\n/** A RPC operation response.\n * @public\n * @deprecated in 3.6. The RPC system will be significantly refactored (or replaced) in version 5.0.\n */\nexport class RpcNotFoundResponse extends RpcControlResponse {\n  public override message = \"Not found\";\n}\n\n/** Manages requests and responses for an RPC configuration.\n * @internal\n */\nexport class RpcControlChannel {\n  /** @internal */\n  public static channels: RpcControlChannel[] = [];\n  private static _obtainLock = 0;\n  private _configuration: RpcConfiguration;\n  private _initialized = false;\n  private _clientActive = false;\n  private _describeEndpoints: () => Promise<RpcInterfaceEndpoints[]> = undefined as any;\n\n  /** @internal */\n  public static ensureInitialized() {\n    this.channels.forEach((channel) => channel.initialize());\n  }\n\n  private constructor(configuration: RpcConfiguration) {\n    this._configuration = configuration;\n    RpcControlChannel.channels.push(this);\n  }\n\n  /** @internal */\n  public async describeEndpoints() {\n    this.activateClient();\n    if (!this._channelInterface.interfaceName) {\n      return [];\n    }\n\n    return this._describeEndpoints();\n  }\n\n  /** @internal */\n  public static obtain(configuration: RpcConfiguration): RpcControlChannel {\n    if (RpcControlChannel._obtainLock)\n      return undefined as any;\n\n    ++RpcControlChannel._obtainLock;\n    const channel = new RpcControlChannel(configuration);\n    --RpcControlChannel._obtainLock;\n\n    return channel;\n  }\n\n  private _channelInterface = class extends RpcInterface {\n    public static readonly interfaceVersion = \"CONTROL\";\n    public static readonly interfaceName = \"\";\n    public async describeEndpoints(): Promise<RpcInterfaceEndpoints[]> { return this.forward(arguments); }\n  };\n\n  private _channelImpl = class extends RpcInterface {\n    public async describeEndpoints(): Promise<RpcInterfaceEndpoints[]> {\n      const endpoints: RpcInterfaceEndpoints[] = [];\n\n      this.configuration.interfaces().forEach((definition) => {\n        if (!RpcRegistry.instance.isRpcInterfaceInitialized(definition))\n          return;\n\n        const description: RpcInterfaceEndpoints = { interfaceName: definition.interfaceName, interfaceVersion: definition.interfaceVersion, operationNames: [], compatible: true };\n        RpcOperation.forEach(definition, (operation) => description.operationNames.push(operation.operationName));\n        endpoints.push(description);\n      });\n\n      return endpoints;\n    }\n  };\n\n  private computeId(): string {\n    const interfaces: string[] = [];\n    this._configuration.interfaces().forEach((definition) => interfaces.push(`${definition.interfaceName}@${definition.interfaceVersion}`));\n    const id = interfaces.sort().join(\",\");\n\n    return Base64.encode(id);\n  }\n\n  private activateClient() {\n    if (this._clientActive)\n      return;\n\n    this.initialize();\n\n    const token: IModelRpcProps = { key: \"none\", iTwinId: \"none\", iModelId: \"none\", changeset: { id: \"none\" } };\n    RpcOperation.forEach(this._channelInterface, (operation) => operation.policy.token = (_request) => RpcOperation.fallbackToken ?? token);\n    const client = RpcManager.getClientForInterface(this._channelInterface);\n    this._describeEndpoints = async () => client.describeEndpoints();\n    this._clientActive = true;\n  }\n\n  /** @internal */\n  public initialize() {\n    if (this._initialized) {\n      return;\n    }\n\n    const id = this.computeId();\n    Object.defineProperty(this._channelInterface, \"interfaceName\", { value: id });\n    Object.defineProperty(this._channelImpl, \"interfaceName\", { value: id });\n\n    RpcConfiguration.assign(this._channelInterface, () => this._configuration.constructor as any);\n    RpcManager.registerImpl(this._channelInterface, this._channelImpl);\n    RpcManager.initializeInterface(this._channelInterface);\n\n    this._initialized = true;\n  }\n\n  /** @internal */\n  public handleUnknownOperation(invocation: RpcInvocation, _error: any): boolean {\n    this.initialize();\n\n    const op = invocation.request.operation;\n    if (op.interfaceVersion === \"CONTROL\" && op.operationName === \"describeEndpoints\") {\n      if (this._channelInterface.interfaceName) {\n        op.interfaceDefinition = this._channelInterface.interfaceName;\n      }\n\n      return true;\n    }\n\n    return false;\n  }\n}\n"]}
+{"version":3,"file":"RpcControl.js","sourceRoot":"","sources":["../../../../src/rpc/core/RpcControl.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 { Base64 } from \"js-base64\";\r\nimport { IModelRpcProps } from \"../../IModel\";\r\nimport { RpcInterface } from \"../../RpcInterface\";\r\nimport { RpcInterfaceEndpoints, RpcManager } from \"../../RpcManager\";\r\nimport { RpcConfiguration } from \"./RpcConfiguration\";\r\nimport { RpcInvocation } from \"./RpcInvocation\";\r\nimport { RpcOperation } from \"./RpcOperation\";\r\nimport { RpcRegistry } from \"./RpcRegistry\";\r\n\r\n/* eslint-disable deprecation/deprecation */\r\n\r\n/** An RPC operation control response.\r\n * @public\r\n */\r\nexport abstract class RpcControlResponse {\r\n  public message = \"RpcControlResponse\";\r\n}\r\n\r\n/** A pending RPC operation response.\r\n * @public\r\n */\r\nexport class RpcPendingResponse extends RpcControlResponse {\r\n  /** Extended status regarding the pending operation. */\r\n  public override message: string;\r\n\r\n  /** Constructs a pending response. */\r\n  public constructor(message: string = \"\") {\r\n    super();\r\n    this.message = message;\r\n  }\r\n}\r\n\r\n/** A RPC operation response.\r\n * @public\r\n */\r\nexport class RpcNotFoundResponse extends RpcControlResponse {\r\n  public override message = \"Not found\";\r\n}\r\n\r\n/** Manages requests and responses for an RPC configuration.\r\n * @internal\r\n */\r\nexport class RpcControlChannel {\r\n  /** @internal */\r\n  public static channels: RpcControlChannel[] = [];\r\n  private static _obtainLock = 0;\r\n  private _configuration: RpcConfiguration;\r\n  private _initialized = false;\r\n  private _clientActive = false;\r\n  private _describeEndpoints: () => Promise<RpcInterfaceEndpoints[]> = undefined as any;\r\n\r\n  /** @internal */\r\n  public static ensureInitialized() {\r\n    this.channels.forEach((channel) => channel.initialize());\r\n  }\r\n\r\n  private constructor(configuration: RpcConfiguration) {\r\n    this._configuration = configuration;\r\n    RpcControlChannel.channels.push(this);\r\n  }\r\n\r\n  /** @internal */\r\n  public async describeEndpoints() {\r\n    this.activateClient();\r\n    if (!this._channelInterface.interfaceName) {\r\n      return [];\r\n    }\r\n\r\n    return this._describeEndpoints();\r\n  }\r\n\r\n  /** @internal */\r\n  public static obtain(configuration: RpcConfiguration): RpcControlChannel {\r\n    if (RpcControlChannel._obtainLock)\r\n      return undefined as any;\r\n\r\n    ++RpcControlChannel._obtainLock;\r\n    const channel = new RpcControlChannel(configuration);\r\n    --RpcControlChannel._obtainLock;\r\n\r\n    return channel;\r\n  }\r\n\r\n  private _channelInterface = class extends RpcInterface {\r\n    public static readonly interfaceVersion = \"CONTROL\";\r\n    public static readonly interfaceName = \"\";\r\n    public async describeEndpoints(): Promise<RpcInterfaceEndpoints[]> { return this.forward(arguments); }\r\n  };\r\n\r\n  private _channelImpl = class extends RpcInterface {\r\n    public async describeEndpoints(): Promise<RpcInterfaceEndpoints[]> {\r\n      const endpoints: RpcInterfaceEndpoints[] = [];\r\n\r\n      this.configuration.interfaces().forEach((definition) => {\r\n        if (!RpcRegistry.instance.isRpcInterfaceInitialized(definition))\r\n          return;\r\n\r\n        const description: RpcInterfaceEndpoints = { interfaceName: definition.interfaceName, interfaceVersion: definition.interfaceVersion, operationNames: [], compatible: true };\r\n        RpcOperation.forEach(definition, (operation) => description.operationNames.push(operation.operationName));\r\n        endpoints.push(description);\r\n      });\r\n\r\n      return endpoints;\r\n    }\r\n  };\r\n\r\n  private computeId(): string {\r\n    const interfaces: string[] = [];\r\n    this._configuration.interfaces().forEach((definition) => interfaces.push(`${definition.interfaceName}@${definition.interfaceVersion}`));\r\n    const id = interfaces.sort().join(\",\");\r\n\r\n    return Base64.encode(id);\r\n  }\r\n\r\n  private activateClient() {\r\n    if (this._clientActive)\r\n      return;\r\n\r\n    this.initialize();\r\n\r\n    const token: IModelRpcProps = { key: \"none\", iTwinId: \"none\", iModelId: \"none\", changeset: { id: \"none\" } };\r\n    RpcOperation.forEach(this._channelInterface, (operation) => operation.policy.token = (_request) => RpcOperation.fallbackToken ?? token);\r\n    const client = RpcManager.getClientForInterface(this._channelInterface);\r\n    this._describeEndpoints = async () => client.describeEndpoints();\r\n    this._clientActive = true;\r\n  }\r\n\r\n  /** @internal */\r\n  public initialize() {\r\n    if (this._initialized) {\r\n      return;\r\n    }\r\n\r\n    const id = this.computeId();\r\n    Object.defineProperty(this._channelInterface, \"interfaceName\", { value: id });\r\n    Object.defineProperty(this._channelImpl, \"interfaceName\", { value: id });\r\n\r\n    RpcConfiguration.assign(this._channelInterface, () => this._configuration.constructor as any);\r\n    RpcManager.registerImpl(this._channelInterface, this._channelImpl);\r\n    RpcManager.initializeInterface(this._channelInterface);\r\n\r\n    this._initialized = true;\r\n  }\r\n\r\n  /** @internal */\r\n  public handleUnknownOperation(invocation: RpcInvocation, _error: any): boolean {\r\n    this.initialize();\r\n\r\n    const op = invocation.request.operation;\r\n    if (op.interfaceVersion === \"CONTROL\" && op.operationName === \"describeEndpoints\") {\r\n      if (this._channelInterface.interfaceName) {\r\n        op.interfaceDefinition = this._channelInterface.interfaceName;\r\n      }\r\n\r\n      return true;\r\n    }\r\n\r\n    return false;\r\n  }\r\n}\r\n"]}

package/lib/esm/rpc/core/RpcInvocation.d.ts

@@ -1,90 +1,90 @@
-/** @packageDocumentation
- * @module RpcInterface
- */
-import { AccessToken, GuidString } from "@itwin/core-bentley";
-import { RpcInterface } from "../../RpcInterface";
-import { SessionProps } from "../../SessionProps";
-import { RpcRequestStatus } from "./RpcConstants";
-import { RpcOperation } from "./RpcOperation";
-import { RpcProtocol, RpcRequestFulfillment, SerializedRpcRequest } from "./RpcProtocol";
-/** The properties of an RpcActivity.
- * @public
- * @extensions
- */
-export interface RpcActivity extends SessionProps {
-    /** Used for logging to correlate an Rpc activity between frontend and backend */
-    readonly activityId: GuidString;
-    /** access token for authorization  */
-    readonly accessToken: AccessToken;
-    /** the name of the current rpc method */
-    readonly rpcMethod?: string;
-}
-/** Serialized format for sending the request across the RPC layer
- * @public
- */
-export interface SerializedRpcActivity {
-    id: string;
-    applicationId: string;
-    applicationVersion: string;
-    sessionId: string;
-    authorization: string;
-    csrfToken?: {
-        headerName: string;
-        headerValue: string;
-    };
-}
-/** @internal */
-export declare type RpcActivityRun = (activity: RpcActivity, fn: () => Promise<any>) => Promise<any>;
-/** An RPC operation invocation in response to a request.
- * @internal
- */
-export declare class RpcInvocation {
-    static runActivity: RpcActivityRun;
-    private _threw;
-    private _pending;
-    private _notFound;
-    private _noContent;
-    private _timeIn;
-    private _timeOut;
-    /** The protocol for this invocation. */
-    readonly protocol: RpcProtocol;
-    /** The received request. */
-    readonly request: SerializedRpcRequest;
-    /** The operation of the request. */
-    readonly operation: RpcOperation;
-    /** The implementation response. */
-    readonly result: Promise<any>;
-    /** The fulfillment for this request. */
-    readonly fulfillment: Promise<RpcRequestFulfillment>;
-    /** The status for this request. */
-    get status(): RpcRequestStatus;
-    /** The elapsed time for this invocation. */
-    get elapsed(): number;
-    /**
-     * The invocation for the current RPC operation.
-     * @note The return value of this function is only reliable in an RPC impl class member function where program control was received from the RpcInvocation constructor function.
-     */
-    static current(rpcImpl: RpcInterface): RpcInvocation;
-    /** Constructs an invocation. */
-    constructor(protocol: RpcProtocol, request: SerializedRpcRequest);
-    private handleUnknownOperation;
-    static sanitizeForLog(activity?: RpcActivity): {
-        ActivityId: string;
-        SessionId: string;
-        ApplicationId: string;
-        ApplicationVersion: string;
-        rpcMethod: string | undefined;
-    } | undefined;
-    private resolve;
-    private applyPolicies;
-    private static compareTokens;
-    private reject;
-    private fulfillResolved;
-    private fulfillRejected;
-    private supportsNoContent;
-    private supportsStatusCategory;
-    private fulfill;
-    private lookupOperationFunction;
-    private transformResponseStatus;
-}
+/** @packageDocumentation
+ * @module RpcInterface
+ */
+import { AccessToken, GuidString } from "@itwin/core-bentley";
+import { RpcInterface } from "../../RpcInterface";
+import { SessionProps } from "../../SessionProps";
+import { RpcRequestStatus } from "./RpcConstants";
+import { RpcOperation } from "./RpcOperation";
+import { RpcProtocol, RpcRequestFulfillment, SerializedRpcRequest } from "./RpcProtocol";
+/** The properties of an RpcActivity.
+ * @public
+ * @extensions
+ */
+export interface RpcActivity extends SessionProps {
+    /** Used for logging to correlate an Rpc activity between frontend and backend */
+    readonly activityId: GuidString;
+    /** access token for authorization  */
+    readonly accessToken: AccessToken;
+    /** the name of the current rpc method */
+    readonly rpcMethod?: string;
+}
+/** Serialized format for sending the request across the RPC layer
+ * @public
+ */
+export interface SerializedRpcActivity {
+    id: string;
+    applicationId: string;
+    applicationVersion: string;
+    sessionId: string;
+    authorization: string;
+    csrfToken?: {
+        headerName: string;
+        headerValue: string;
+    };
+}
+/** @internal */
+export declare type RpcActivityRun = (activity: RpcActivity, fn: () => Promise<any>) => Promise<any>;
+/** An RPC operation invocation in response to a request.
+ * @internal
+ */
+export declare class RpcInvocation {
+    static runActivity: RpcActivityRun;
+    private _threw;
+    private _pending;
+    private _notFound;
+    private _noContent;
+    private _timeIn;
+    private _timeOut;
+    /** The protocol for this invocation. */
+    readonly protocol: RpcProtocol;
+    /** The received request. */
+    readonly request: SerializedRpcRequest;
+    /** The operation of the request. */
+    readonly operation: RpcOperation;
+    /** The implementation response. */
+    readonly result: Promise<any>;
+    /** The fulfillment for this request. */
+    readonly fulfillment: Promise<RpcRequestFulfillment>;
+    /** The status for this request. */
+    get status(): RpcRequestStatus;
+    /** The elapsed time for this invocation. */
+    get elapsed(): number;
+    /**
+     * The invocation for the current RPC operation.
+     * @note The return value of this function is only reliable in an RPC impl class member function where program control was received from the RpcInvocation constructor function.
+     */
+    static current(rpcImpl: RpcInterface): RpcInvocation;
+    /** Constructs an invocation. */
+    constructor(protocol: RpcProtocol, request: SerializedRpcRequest);
+    private handleUnknownOperation;
+    static sanitizeForLog(activity?: RpcActivity): {
+        ActivityId: string;
+        SessionId: string;
+        ApplicationId: string;
+        ApplicationVersion: string;
+        rpcMethod: string | undefined;
+    } | undefined;
+    private resolve;
+    private applyPolicies;
+    private static compareTokens;
+    private reject;
+    private fulfillResolved;
+    private fulfillRejected;
+    private supportsNoContent;
+    private supportsStatusCategory;
+    private fulfill;
+    private lookupOperationFunction;
+    private transformResponseStatus;
+}
 //# sourceMappingURL=RpcInvocation.d.ts.map