@itwin/core-common 4.0.0-dev.52 → 4.0.0-dev.55

package/lib/esm/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,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAyB,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,4CAA4C;AAE5C;;GAEG;AACH,MAAM,OAAgB,kBAAkB;IAAxC;QACS,YAAO,GAAG,oBAAoB,CAAC;IACxC,CAAC;CAAA;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,kBAAkB;IAIxD,qCAAqC;IACrC,YAAmB,UAAkB,EAAE;QACrC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,kBAAkB;IAA3D;;QACkB,YAAO,GAAG,WAAW,CAAC;IACxC,CAAC;CAAA;AAED;;GAEG;AACH,MAAM,OAAO,iBAAiB;IAc5B,YAAoB,aAA+B;;QAT3C,iBAAY,GAAG,KAAK,CAAC;QACrB,kBAAa,GAAG,KAAK,CAAC;QACtB,uBAAkB,GAA2C,SAAgB,CAAC;QAkC9E,sBAAiB,SAAG,KAAM,SAAQ,YAAY;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,YAAY;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,WAAW,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,YAAY,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;IARD,gBAAgB;IACT,MAAM,CAAC,iBAAiB;QAC7B,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAC3D,CAAC;IAOD,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,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;IAEO,cAAc;QACpB,IAAI,IAAI,CAAC,aAAa;YACpB,OAAO;QAET,IAAI,CAAC,UAAU,EAAE,CAAC;QAElB,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,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,YAAY,CAAC,aAAa,IAAI,KAAK,CAAC,CAAC;QACxI,MAAM,MAAM,GAAG,UAAU,CAAC,qBAAqB,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACxE,IAAI,CAAC,kBAAkB,GAAG,KAAK,IAAI,EAAE,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;QACjE,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;IAC5B,CAAC;IAED,gBAAgB;IACT,UAAU;QACf,IAAI,IAAI,CAAC,YAAY,EAAE;YACrB,OAAO;SACR;QAED,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,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,WAAkB,CAAC,CAAC;QAC9F,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,iBAAiB,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QACnE,UAAU,CAAC,mBAAmB,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAEvD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;IAC3B,CAAC;IAED,gBAAgB;IACT,sBAAsB,CAAC,UAAyB,EAAE,MAAW;QAClE,IAAI,CAAC,UAAU,EAAE,CAAC;QAElB,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;;AAnHD,gBAAgB;AACF,0BAAQ,GAAwB,EAAE,CAAC;AAClC,6BAAW,GAAG,CAAC,CAAC","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"]}
+{"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 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

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

@@ -1 +1 @@
-{"version":3,"file":"RpcInvocation.d.ts","sourceRoot":"","sources":["../../../../src/rpc/core/RpcInvocation.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAA+B,UAAU,EAAqE,MAAM,qBAAqB,CAAC;AAI9J,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAoB,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGpE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAoB,WAAW,EAAsB,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAK/H;;;GAGG;AACH,MAAM,WAAW,WAAY,SAAQ,YAAY;IAC/C,iFAAiF;IACjF,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAEhC,sCAAsC;IACtC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAElC,yCAAyC;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;CACzD;AAED,gBAAgB;AAChB,oBAAY,cAAc,GAAG,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;AAE7F;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAc,WAAW,EAAE,cAAc,CAAiC;IAC1E,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,QAAQ,CAAa;IAE7B,wCAAwC;IACxC,SAAgB,QAAQ,EAAE,WAAW,CAAC;IAEtC,4BAA4B;IAC5B,SAAgB,OAAO,EAAE,oBAAoB,CAAC;IAE9C,oCAAoC;IACpC,SAAgB,SAAS,EAAE,YAAY,CAAoB;IAE3D,mCAAmC;IACnC,SAAgB,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IAErC,wCAAwC;IACxC,SAAgB,WAAW,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAE5D,mCAAmC;IACnC,IAAW,MAAM,IAAI,gBAAgB,CAMpC;IAED,4CAA4C;IAC5C,IAAW,OAAO,IAAI,MAAM,CAE3B;IAED;;;OAGG;WACW,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,aAAa;IAI3D,gCAAgC;gBACb,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,oBAAoB;IA8BvE,OAAO,CAAC,sBAAsB;WAKhB,cAAc,CAAC,QAAQ,CAAC,EAAE,WAAW;;;;;;;YAQrC,OAAO;IAkCrB,OAAO,CAAC,aAAa;IAsBrB,OAAO,CAAC,MAAM,CAAC,aAAa;YAOd,MAAM;YAKN,eAAe;YAOf,eAAe;IA4B7B,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,sBAAsB;IAY9B,OAAO,CAAC,OAAO;IAsBf,OAAO,CAAC,uBAAuB;IAQ/B,OAAO,CAAC,uBAAuB;CA0BhC"}
+{"version":3,"file":"RpcInvocation.d.ts","sourceRoot":"","sources":["../../../../src/rpc/core/RpcInvocation.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAA+B,UAAU,EAAqE,MAAM,qBAAqB,CAAC;AAI9J,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAoB,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGpE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAoB,WAAW,EAAsB,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAK/H;;;GAGG;AACH,MAAM,WAAW,WAAY,SAAQ,YAAY;IAC/C,iFAAiF;IACjF,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAEhC,sCAAsC;IACtC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAElC,yCAAyC;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;CACzD;AAED,gBAAgB;AAChB,MAAM,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;AAE7F;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAc,WAAW,EAAE,cAAc,CAAiC;IAC1E,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,QAAQ,CAAa;IAE7B,wCAAwC;IACxC,SAAgB,QAAQ,EAAE,WAAW,CAAC;IAEtC,4BAA4B;IAC5B,SAAgB,OAAO,EAAE,oBAAoB,CAAC;IAE9C,oCAAoC;IACpC,SAAgB,SAAS,EAAE,YAAY,CAAoB;IAE3D,mCAAmC;IACnC,SAAgB,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IAErC,wCAAwC;IACxC,SAAgB,WAAW,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAE5D,mCAAmC;IACnC,IAAW,MAAM,IAAI,gBAAgB,CAMpC;IAED,4CAA4C;IAC5C,IAAW,OAAO,IAAI,MAAM,CAE3B;IAED;;;OAGG;WACW,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,aAAa;IAI3D,gCAAgC;gBACb,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,oBAAoB;IA8BvE,OAAO,CAAC,sBAAsB;WAKhB,cAAc,CAAC,QAAQ,CAAC,EAAE,WAAW;;;;;;;YAQrC,OAAO;IAkCrB,OAAO,CAAC,aAAa;IAsBrB,OAAO,CAAC,MAAM,CAAC,aAAa;YAOd,MAAM;YAKN,eAAe;YAOf,eAAe;IA4B7B,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,sBAAsB;IAY9B,OAAO,CAAC,OAAO;IAsBf,OAAO,CAAC,uBAAuB;IAQ/B,OAAO,CAAC,uBAAuB;CA0BhC"}