@itwin/core-common 3.5.0-dev.18 → 3.5.0-dev.20

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

@@ -1 +1 @@
-{"version":3,"file":"RpcControl.js","sourceRoot":"","sources":["../../../../src/rpc/core/RpcControl.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,sDAAoD;AACpD,mCAAgC;AAEhC,mDAAgD;AAChD,qDAAkD;AAClD,iDAAqE;AACrE,yDAAsD;AAEtD,iDAA8C;AAC9C,+CAA4C;AAE5C;;GAEG;AACH,MAAsB,kBAAkB;IAAxC;QACS,YAAO,GAAG,oBAAoB,CAAC;IACxC,CAAC;CAAA;AAFD,gDAEC;AAED;;GAEG;AACH,MAAa,kBAAmB,SAAQ,kBAAkB;IAIxD,qCAAqC;IACrC,YAAmB,UAAkB,EAAE;QACrC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AATD,gDASC;AAED;;GAEG;AACH,MAAa,mBAAoB,SAAQ,kBAAkB;IAA3D;;QACkB,YAAO,GAAG,WAAW,CAAC;IACxC,CAAC;CAAA;AAFD,kDAEC;AAED;;GAEG;AACH,MAAa,iBAAiB;IAS5B,YAAoB,aAA+B;;QAJ3C,iBAAY,GAAG,KAAK,CAAC;QACrB,kBAAa,GAAG,KAAK,CAAC;QACtB,uBAAkB,GAA2C,SAAgB,CAAC;QA6B9E,sBAAiB,SAAG,KAAM,SAAQ,2BAAY;gBAG7C,KAAK,CAAC,iBAAiB,KAAuC,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;aACvG;YAHwB,mBAAgB,GAAG,SAAU;YAC7B,gBAAa,GAAG,EAAG;gBAE1C;QAEM,iBAAY,GAAG,KAAM,SAAQ,2BAAY;YACxC,KAAK,CAAC,iBAAiB;gBAC5B,MAAM,SAAS,GAA4B,EAAE,CAAC;gBAE9C,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE;oBACrD,IAAI,CAAC,yBAAW,CAAC,QAAQ,CAAC,yBAAyB,CAAC,UAAU,CAAC;wBAC7D,OAAO;oBAET,MAAM,WAAW,GAA0B,EAAE,aAAa,EAAE,UAAU,CAAC,aAAa,EAAE,gBAAgB,EAAE,UAAU,CAAC,gBAAgB,EAAE,cAAc,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;oBAC5K,2BAAY,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,WAAW,CAAC,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC;oBAC1G,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;gBAC9B,CAAC,CAAC,CAAC;gBAEH,OAAO,SAAS,CAAC;YACnB,CAAC;SACF,CAAC;QA/CA,IAAI,CAAC,cAAc,GAAG,aAAa,CAAC;QACpC,iBAAiB,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IAED,gBAAgB;IACT,KAAK,CAAC,iBAAiB;QAC5B,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,aAAa,EAAE;YACzC,OAAO,EAAE,CAAC;SACX;QAED,OAAO,IAAI,CAAC,kBAAkB,EAAE,CAAC;IACnC,CAAC;IAED,gBAAgB;IACT,MAAM,CAAC,MAAM,CAAC,aAA+B;QAClD,IAAI,iBAAiB,CAAC,WAAW;YAC/B,OAAO,SAAgB,CAAC;QAE1B,EAAE,iBAAiB,CAAC,WAAW,CAAC;QAChC,MAAM,OAAO,GAAG,IAAI,iBAAiB,CAAC,aAAa,CAAC,CAAC;QACrD,EAAE,iBAAiB,CAAC,WAAW,CAAC;QAEhC,OAAO,OAAO,CAAC;IACjB,CAAC;IAyBO,SAAS;QACf,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,aAAa,IAAI,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC;QACxI,MAAM,EAAE,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEvC,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,WAAW,EAAE,8CAA8C;YAC/E,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,8CAA8C;aAC5D,IAAI,OAAO,CAAC,eAAM,CAAC,KAAK,WAAW;YACtC,OAAO,eAAM,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;;YAEpD,OAAO,EAAE,CAAC;IACd,CAAC;IAEO,cAAc;QACpB,IAAI,IAAI,CAAC,aAAa;YACpB,OAAO;QAET,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE;YACtB,IAAI,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,CAAC,MAAM;gBACzC,MAAM,IAAI,yBAAW,CAAC,4BAAa,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;YAE/D,IAAI,CAAC,UAAU,EAAE,CAAC;SACnB;QAED,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC1B,MAAM,KAAK,GAAmB,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC;QAC5G,2BAAY,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,QAAQ,EAAE,EAAE,WAAC,OAAA,MAAA,2BAAY,CAAC,aAAa,mCAAI,KAAK,CAAA,EAAA,CAAC,CAAC;QACxI,MAAM,MAAM,GAAG,uBAAU,CAAC,qBAAqB,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACxE,IAAI,CAAC,kBAAkB,GAAG,KAAK,IAAI,EAAE,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;IACnE,CAAC;IAED,gBAAgB;IACT,UAAU;QACf,IAAI,IAAI,CAAC,YAAY;YACnB,MAAM,IAAI,yBAAW,CAAC,4BAAa,CAAC,KAAK,EAAE,sBAAsB,CAAC,CAAC;QAErE,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAEzB,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5B,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,iBAAiB,EAAE,eAAe,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QAC9E,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,YAAY,EAAE,eAAe,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QAEzE,mCAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,WAAkB,CAAC,CAAC;QAC9F,uBAAU,CAAC,YAAY,CAAC,IAAI,CAAC,iBAAiB,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QACnE,uBAAU,CAAC,mBAAmB,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACzD,CAAC;IAED,gBAAgB;IACT,sBAAsB,CAAC,UAAyB,EAAE,MAAW;QAClE,MAAM,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC;QACxC,IAAI,EAAE,CAAC,gBAAgB,KAAK,SAAS,IAAI,EAAE,CAAC,aAAa,KAAK,mBAAmB,EAAE;YACjF,IAAI,IAAI,CAAC,iBAAiB,CAAC,aAAa,EAAE;gBACxC,EAAE,CAAC,mBAAmB,GAAG,IAAI,CAAC,iBAAiB,CAAC,aAAa,CAAC;aAC/D;YAED,OAAO,IAAI,CAAC;SACb;QAED,OAAO,KAAK,CAAC;IACf,CAAC;;AAtHH,8CAuHC;AAtHC,gBAAgB;AACF,0BAAQ,GAAwB,EAAE,CAAC;AAClC,6BAAW,GAAG,CAAC,CAAC","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 { BentleyStatus } from \"@itwin/core-bentley\";\nimport { Buffer } from \"buffer\";\nimport { IModelRpcProps } from \"../../IModel\";\nimport { IModelError } from \"../../IModelError\";\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/** An RPC operation control response.\n * @public\n */\nexport abstract class RpcControlResponse {\n  public message = \"RpcControlResponse\";\n}\n\n/** A pending RPC operation response.\n * @public\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 */\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  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    if (typeof (btoa) !== \"undefined\") // eslint-disable-line deprecation/deprecation\n      return btoa(id); // eslint-disable-line deprecation/deprecation\n    else if (typeof (Buffer) !== \"undefined\")\n      return Buffer.from(id, \"binary\").toString(\"base64\");\n    else\n      return id;\n  }\n\n  private activateClient() {\n    if (this._clientActive)\n      return;\n\n    if (!this._initialized) {\n      if (this._configuration.interfaces().length)\n        throw new IModelError(BentleyStatus.ERROR, `Invalid state.`);\n\n      this.initialize();\n    }\n\n    this._clientActive = true;\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  }\n\n  /** @internal */\n  public initialize() {\n    if (this._initialized)\n      throw new IModelError(BentleyStatus.ERROR, `Already initialized.`);\n\n    this._initialized = true;\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\n  /** @internal */\n  public handleUnknownOperation(invocation: RpcInvocation, _error: any): boolean {\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 { BentleyStatus } from \"@itwin/core-bentley\";\r\nimport { Buffer } from \"buffer\";\r\nimport { IModelRpcProps } from \"../../IModel\";\r\nimport { IModelError } from \"../../IModelError\";\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/** 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  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    if (typeof (btoa) !== \"undefined\") // eslint-disable-line deprecation/deprecation\r\n      return btoa(id); // eslint-disable-line deprecation/deprecation\r\n    else if (typeof (Buffer) !== \"undefined\")\r\n      return Buffer.from(id, \"binary\").toString(\"base64\");\r\n    else\r\n      return id;\r\n  }\r\n\r\n  private activateClient() {\r\n    if (this._clientActive)\r\n      return;\r\n\r\n    if (!this._initialized) {\r\n      if (this._configuration.interfaces().length)\r\n        throw new IModelError(BentleyStatus.ERROR, `Invalid state.`);\r\n\r\n      this.initialize();\r\n    }\r\n\r\n    this._clientActive = true;\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  }\r\n\r\n  /** @internal */\r\n  public initialize() {\r\n    if (this._initialized)\r\n      throw new IModelError(BentleyStatus.ERROR, `Already initialized.`);\r\n\r\n    this._initialized = true;\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\r\n  /** @internal */\r\n  public handleUnknownOperation(invocation: RpcInvocation, _error: any): boolean {\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/cjs/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