@itwin/core-common 4.0.0-dev.10 → 4.0.0-dev.101

package/lib/cjs/rpc/core/RpcConfiguration.js

@@ -1,192 +1,192 @@
-"use strict";
-var _a;
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RpcDirectRequest = exports.RpcDirectProtocol = exports.RpcDefaultConfiguration = exports.RpcConfiguration = exports.RpcRoutingMap = void 0;
-const RpcManager_1 = require("../../RpcManager");
-const RpcControl_1 = require("./RpcControl");
-const RpcProtocol_1 = require("./RpcProtocol");
-const RpcRegistry_1 = require("./RpcRegistry");
-const RpcRequest_1 = require("./RpcRequest");
-const RpcRoutingToken_1 = require("./RpcRoutingToken");
-/** @internal */
-var RpcRoutingMap;
-(function (RpcRoutingMap) {
-    function create() {
-        const configurations = new Map();
-        return Object.assign((routing) => configurations.get(routing.id)(), { configurations });
-    }
-    RpcRoutingMap.create = create;
-})(RpcRoutingMap = exports.RpcRoutingMap || (exports.RpcRoutingMap = {}));
-/** A RpcConfiguration specifies how calls on an RPC interface will be marshalled, plus other operating parameters.
- * RpcConfiguration is the base class for specific configurations.
- * @internal
- */
-class RpcConfiguration {
-    constructor() {
-        /** @internal */
-        this.attached = [];
-        /** @internal */
-        this.allowAttachedInterfaces = true;
-        /** The target interval (in milliseconds) between connection attempts for pending RPC operation requests. */
-        this.pendingOperationRetryInterval = 10000;
-        /** The maximum number of transient faults permitted before request failure. */
-        this.transientFaultLimit = 4;
-        /** @internal */
-        this.routing = RpcRoutingToken_1.RpcRoutingToken.default;
-        /** The control channel for the configuration.
-         * @internal
-         */
-        this.controlChannel = RpcControl_1.RpcControlChannel.obtain(this);
-    }
-    /** Sets the configuration supplier for an RPC interface class. */
-    static assign(definition, supplier) {
-        const map = definition.prototype.configurationSupplier;
-        if (!map || typeof (map.configurations) === "undefined") {
-            definition.prototype.configurationSupplier = supplier;
-        }
-        else {
-            map.configurations.set(RpcRoutingToken_1.RpcRoutingToken.default.id, supplier);
-        }
-    }
-    /** Sets the configuration supplier for an RPC interface class for a given routing. */
-    static assignWithRouting(definition, routing, configuration) {
-        if (!definition.prototype.configurationSupplier) {
-            RpcConfiguration.assign(definition, RpcRoutingMap.create());
-        }
-        let map = definition.prototype.configurationSupplier;
-        if (typeof (map.configurations) === "undefined") {
-            const existing = map;
-            map = RpcRoutingMap.create();
-            RpcConfiguration.assign(definition, map);
-            map.configurations.set(RpcRoutingToken_1.RpcRoutingToken.default.id, existing);
-        }
-        const supplier = () => configuration;
-        map.configurations.set(routing.id, supplier);
-    }
-    /** Obtains the instance of an RPC configuration class. */
-    static obtain(configurationConstructor) {
-        let instance = configurationConstructor[RpcRegistry_1.INSTANCE];
-        if (!instance)
-            instance = configurationConstructor[RpcRegistry_1.INSTANCE] = new configurationConstructor();
-        return instance;
-    }
-    /** @internal */
-    get attachedInterfaces() { return this.attached; }
-    /** @internal */
-    attach(definition) {
-        if (!this.allowAttachedInterfaces) {
-            return;
-        }
-        if (this.interfaces().indexOf(definition) !== -1 || this.attached.indexOf(definition) !== -1) {
-            return;
-        }
-        this.attached.push(definition);
-        RpcConfiguration.assign(definition, () => this.constructor);
-        RpcManager_1.RpcManager.initializeInterface(definition);
-    }
-    /** Initializes the RPC interfaces managed by the configuration. */
-    static initializeInterfaces(configuration) {
-        configuration.interfaces().forEach((definition) => RpcManager_1.RpcManager.initializeInterface(definition));
-    }
-    /** @internal */
-    static supply(definition) {
-        return RpcConfiguration.obtain(definition.configurationSupplier ? definition.configurationSupplier(definition.routing) : RpcDefaultConfiguration);
-    }
-    /** @internal */
-    onRpcClientInitialized(definition, client) {
-        this.protocol.onRpcClientInitialized(definition, client);
-    }
-    /** @internal */
-    onRpcImplInitialized(definition, impl) {
-        this.protocol.onRpcImplInitialized(definition, impl);
-    }
-    /** @internal */
-    onRpcClientTerminated(definition, client) {
-        this.protocol.onRpcClientTerminated(definition, client);
-    }
-    /** @internal */
-    onRpcImplTerminated(definition, impl) {
-        this.protocol.onRpcImplTerminated(definition, impl);
-    }
-}
-exports.RpcConfiguration = RpcConfiguration;
-_a = RpcConfiguration;
-/** Whether development mode is enabled.
- * @note This parameter determines whether developer convenience features like backend stack traces are available.
- */
-RpcConfiguration.developmentMode = false;
-/** Whether frontend checks that are relevant in a cloud-hosted routing scenario are disabled. */
-RpcConfiguration.disableRoutingValidation = false;
-/** Whether strict mode is enabled.
- * This parameter determines system behaviors relating to strict checking:
- * - Whether an error is thrown if the type marshaling system encounters an unregistered type (only in strict mode).
- */
-RpcConfiguration.strictMode = false;
-/**
- * Whether to throw an error when the IModelRpcProps in the operation parameter list differs from the token in the URL.
- * @note By default, a warning is logged and the operation is allowed to proceed.
- * @note The parameter token is always replaced by the url token (unless RpcOperationPolicy.allowTokenMismatch is set).
- */
-RpcConfiguration.throwOnTokenMismatch = false;
-/** Enables passing of application-specific context with each RPC request. */
-RpcConfiguration.requestContext = {
-    getId: (_request) => "",
-    serialize: async (request) => ({
-        id: request.id,
-        applicationId: "",
-        applicationVersion: "",
-        sessionId: "",
-        authorization: "",
-    }),
-};
-/** A default configuration that can be used for basic testing within a library.
- * @internal
- */
-class RpcDefaultConfiguration extends RpcConfiguration {
-    constructor() {
-        super(...arguments);
-        this.interfaces = () => [];
-        this.protocol = new RpcDirectProtocol(this);
-    }
-}
-exports.RpcDefaultConfiguration = RpcDefaultConfiguration;
-/** A default protocol that can be used for basic testing within a library.
- * @internal
- */
-class RpcDirectProtocol extends RpcProtocol_1.RpcProtocol {
-    constructor() {
-        super(...arguments);
-        this.requestType = RpcDirectRequest;
-    }
-}
-exports.RpcDirectProtocol = RpcDirectProtocol;
-/** A default request type that can be used for basic testing within a library.
- * @internal
- */
-class RpcDirectRequest extends RpcRequest_1.RpcRequest {
-    constructor() {
-        super(...arguments);
-        this.headers = new Map();
-        this.fulfillment = undefined;
-    }
-    async send() {
-        const request = await this.protocol.serialize(this);
-        return new Promise(async (resolve, reject) => {
-            try {
-                this.fulfillment = await this.protocol.fulfill(request);
-                resolve(this.fulfillment.status);
-            }
-            catch (err) {
-                reject(err);
-            }
-        });
-    }
-    setHeader(name, value) {
-        this.headers.set(name, value);
-    }
-    async load() {
-        return this.fulfillment.result;
-    }
-}
-exports.RpcDirectRequest = RpcDirectRequest;
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RpcDirectRequest = exports.RpcDirectProtocol = exports.RpcDefaultConfiguration = exports.RpcConfiguration = exports.RpcRoutingMap = void 0;
+const RpcManager_1 = require("../../RpcManager");
+const RpcControl_1 = require("./RpcControl");
+const RpcProtocol_1 = require("./RpcProtocol");
+const RpcRegistry_1 = require("./RpcRegistry");
+const RpcRequest_1 = require("./RpcRequest");
+const RpcRoutingToken_1 = require("./RpcRoutingToken");
+/** @internal */
+var RpcRoutingMap;
+(function (RpcRoutingMap) {
+    function create() {
+        const configurations = new Map();
+        return Object.assign((routing) => configurations.get(routing.id)(), { configurations });
+    }
+    RpcRoutingMap.create = create;
+})(RpcRoutingMap = exports.RpcRoutingMap || (exports.RpcRoutingMap = {}));
+/** A RpcConfiguration specifies how calls on an RPC interface will be marshalled, plus other operating parameters.
+ * RpcConfiguration is the base class for specific configurations.
+ * @beta
+ */
+class RpcConfiguration {
+    constructor() {
+        /** @internal */
+        this.attached = [];
+        /** @internal */
+        this.allowAttachedInterfaces = true;
+        /** The target interval (in milliseconds) between connection attempts for pending RPC operation requests. */
+        this.pendingOperationRetryInterval = 10000;
+        /** The maximum number of transient faults permitted before request failure. */
+        this.transientFaultLimit = 4;
+        /** @internal */
+        this.routing = RpcRoutingToken_1.RpcRoutingToken.default;
+        /** The control channel for the configuration.
+         * @internal
+         */
+        this.controlChannel = RpcControl_1.RpcControlChannel.obtain(this);
+    }
+    /** @internal Sets the configuration supplier for an RPC interface class. */
+    static assign(definition, supplier) {
+        const map = definition.prototype.configurationSupplier;
+        if (!map || typeof (map.configurations) === "undefined") {
+            definition.prototype.configurationSupplier = supplier;
+        }
+        else {
+            map.configurations.set(RpcRoutingToken_1.RpcRoutingToken.default.id, supplier);
+        }
+    }
+    /** Sets the configuration supplier for an RPC interface class for a given routing. */
+    static assignWithRouting(definition, routing, configuration) {
+        if (!definition.prototype.configurationSupplier) {
+            RpcConfiguration.assign(definition, RpcRoutingMap.create());
+        }
+        let map = definition.prototype.configurationSupplier;
+        if (typeof (map.configurations) === "undefined") {
+            const existing = map;
+            map = RpcRoutingMap.create();
+            RpcConfiguration.assign(definition, map);
+            map.configurations.set(RpcRoutingToken_1.RpcRoutingToken.default.id, existing);
+        }
+        const supplier = () => configuration;
+        map.configurations.set(routing.id, supplier);
+    }
+    /** Obtains the instance of an RPC configuration class. */
+    static obtain(configurationConstructor) {
+        let instance = configurationConstructor[RpcRegistry_1.INSTANCE];
+        if (!instance)
+            instance = configurationConstructor[RpcRegistry_1.INSTANCE] = new configurationConstructor();
+        return instance;
+    }
+    /** @internal */
+    get attachedInterfaces() { return this.attached; }
+    /** @internal */
+    attach(definition) {
+        if (!this.allowAttachedInterfaces) {
+            return;
+        }
+        if (this.interfaces().indexOf(definition) !== -1 || this.attached.indexOf(definition) !== -1) {
+            return;
+        }
+        this.attached.push(definition);
+        RpcConfiguration.assign(definition, () => this.constructor);
+        RpcManager_1.RpcManager.initializeInterface(definition);
+    }
+    /** Initializes the RPC interfaces managed by the configuration. */
+    static initializeInterfaces(configuration) {
+        configuration.interfaces().forEach((definition) => RpcManager_1.RpcManager.initializeInterface(definition));
+    }
+    /** @internal */
+    static supply(definition) {
+        return RpcConfiguration.obtain(definition.configurationSupplier ? definition.configurationSupplier(definition.routing) : RpcDefaultConfiguration);
+    }
+    /** @internal */
+    onRpcClientInitialized(definition, client) {
+        this.protocol.onRpcClientInitialized(definition, client);
+    }
+    /** @internal */
+    onRpcImplInitialized(definition, impl) {
+        this.protocol.onRpcImplInitialized(definition, impl);
+    }
+    /** @internal */
+    onRpcClientTerminated(definition, client) {
+        this.protocol.onRpcClientTerminated(definition, client);
+    }
+    /** @internal */
+    onRpcImplTerminated(definition, impl) {
+        this.protocol.onRpcImplTerminated(definition, impl);
+    }
+}
+_a = RpcConfiguration;
+/** Whether development mode is enabled.
+ * @note This parameter determines whether developer convenience features like backend stack traces are available.
+ */
+RpcConfiguration.developmentMode = false;
+/** Whether frontend checks that are relevant in a cloud-hosted routing scenario are disabled. */
+RpcConfiguration.disableRoutingValidation = false;
+/** Whether strict mode is enabled.
+ * This parameter determines system behaviors relating to strict checking:
+ * - Whether an error is thrown if the type marshaling system encounters an unregistered type (only in strict mode).
+ */
+RpcConfiguration.strictMode = false;
+/**
+ * Whether to throw an error when the IModelRpcProps in the operation parameter list differs from the token in the URL.
+ * @note By default, a warning is logged and the operation is allowed to proceed.
+ * @note The parameter token is always replaced by the url token (unless RpcOperationPolicy.allowTokenMismatch is set).
+ */
+RpcConfiguration.throwOnTokenMismatch = false;
+/** @internal Enables passing of application-specific context with each RPC request. */
+RpcConfiguration.requestContext = {
+    getId: (_request) => "",
+    serialize: async (request) => ({
+        id: request.id,
+        applicationId: "",
+        applicationVersion: "",
+        sessionId: "",
+        authorization: "",
+    }),
+};
+exports.RpcConfiguration = RpcConfiguration;
+/** A default configuration that can be used for basic testing within a library.
+ * @internal
+ */
+class RpcDefaultConfiguration extends RpcConfiguration {
+    constructor() {
+        super(...arguments);
+        this.interfaces = () => [];
+        this.protocol = new RpcDirectProtocol(this);
+    }
+}
+exports.RpcDefaultConfiguration = RpcDefaultConfiguration;
+/** A default protocol that can be used for basic testing within a library.
+ * @internal
+ */
+class RpcDirectProtocol extends RpcProtocol_1.RpcProtocol {
+    constructor() {
+        super(...arguments);
+        this.requestType = RpcDirectRequest;
+    }
+}
+exports.RpcDirectProtocol = RpcDirectProtocol;
+/** A default request type that can be used for basic testing within a library.
+ * @internal
+ */
+class RpcDirectRequest extends RpcRequest_1.RpcRequest {
+    constructor() {
+        super(...arguments);
+        this.headers = new Map();
+        this.fulfillment = undefined;
+    }
+    async send() {
+        const request = await this.protocol.serialize(this);
+        return new Promise(async (resolve, reject) => {
+            try {
+                this.fulfillment = await this.protocol.fulfill(request);
+                resolve(this.fulfillment.status);
+            }
+            catch (err) {
+                reject(err);
+            }
+        });
+    }
+    setHeader(name, value) {
+        this.headers.set(name, value);
+    }
+    async load() {
+        return this.fulfillment.result;
+    }
+}
+exports.RpcDirectRequest = RpcDirectRequest;
 //# sourceMappingURL=RpcConfiguration.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"RpcConfiguration.js","sourceRoot":"","sources":["../../../../src/rpc/core/RpcConfiguration.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module RpcInterface\r\n */\r\nimport { RpcInterface, RpcInterfaceDefinition } from \"../../RpcInterface\";\r\nimport { RpcManager } from \"../../RpcManager\";\r\nimport { RpcControlChannel } from \"./RpcControl\";\r\nimport { SerializedRpcActivity } from \"./RpcInvocation\";\r\nimport { RpcProtocol, RpcRequestFulfillment } from \"./RpcProtocol\";\r\nimport { INSTANCE } from \"./RpcRegistry\";\r\nimport { RpcRequest } from \"./RpcRequest\";\r\nimport { RpcRequestContext } from \"./RpcRequestContext\";\r\nimport { RpcRoutingToken } from \"./RpcRoutingToken\";\r\n\r\n/* eslint-disable deprecation/deprecation */\r\n\r\n/** @internal */\r\nexport type RpcConfigurationSupplier = (routing?: RpcRoutingToken) => { new(): RpcConfiguration }; // eslint-disable-line @typescript-eslint/prefer-function-type\r\n\r\n/** @internal */\r\nexport interface RpcRoutingMap extends RpcConfigurationSupplier { configurations: Map<number, RpcConfigurationSupplier> }\r\n\r\n/** @internal */\r\nexport namespace RpcRoutingMap {\r\n  export function create(): RpcRoutingMap {\r\n    const configurations = new Map();\r\n    return Object.assign((routing?: RpcRoutingToken) => configurations.get(routing!.id)(), { configurations });\r\n  }\r\n}\r\n\r\n/** A RpcConfiguration specifies how calls on an RPC interface will be marshalled, plus other operating parameters.\r\n * RpcConfiguration is the base class for specific configurations.\r\n * @internal\r\n */\r\nexport abstract class RpcConfiguration {\r\n  /** Whether development mode is enabled.\r\n   * @note This parameter determines whether developer convenience features like backend stack traces are available.\r\n   */\r\n  public static developmentMode: boolean = false;\r\n\r\n  /** Whether frontend checks that are relevant in a cloud-hosted routing scenario are disabled. */\r\n  public static disableRoutingValidation: boolean = false;\r\n\r\n  /** Whether strict mode is enabled.\r\n   * This parameter determines system behaviors relating to strict checking:\r\n   * - Whether an error is thrown if the type marshaling system encounters an unregistered type (only in strict mode).\r\n   */\r\n  public static strictMode: boolean = false;\r\n\r\n  /**\r\n   * Whether to throw an error when the IModelRpcProps in the operation parameter list differs from the token in the URL.\r\n   * @note By default, a warning is logged and the operation is allowed to proceed.\r\n   * @note The parameter token is always replaced by the url token (unless RpcOperationPolicy.allowTokenMismatch is set).\r\n   */\r\n  public static throwOnTokenMismatch = false;\r\n\r\n  /** Sets the configuration supplier for an RPC interface class. */\r\n  public static assign<T extends RpcInterface>(definition: RpcInterfaceDefinition<T>, supplier: RpcConfigurationSupplier): void {\r\n    const map = definition.prototype.configurationSupplier as RpcRoutingMap | undefined;\r\n    if (!map || typeof (map.configurations) === \"undefined\") {\r\n      definition.prototype.configurationSupplier = supplier;\r\n    } else {\r\n      map.configurations.set(RpcRoutingToken.default.id, supplier);\r\n    }\r\n  }\r\n\r\n  /** Sets the configuration supplier for an RPC interface class for a given routing. */\r\n  public static assignWithRouting<T extends RpcInterface>(definition: RpcInterfaceDefinition<T>, routing: RpcRoutingToken, configuration: new () => RpcConfiguration): void {\r\n    if (!definition.prototype.configurationSupplier) {\r\n      RpcConfiguration.assign(definition, RpcRoutingMap.create());\r\n    }\r\n\r\n    let map = definition.prototype.configurationSupplier as RpcRoutingMap;\r\n    if (typeof (map.configurations) === \"undefined\") {\r\n      const existing = map as RpcConfigurationSupplier;\r\n      map = RpcRoutingMap.create();\r\n      RpcConfiguration.assign(definition, map);\r\n      map.configurations.set(RpcRoutingToken.default.id, existing);\r\n    }\r\n\r\n    const supplier = () => configuration;\r\n    map.configurations.set(routing.id, supplier);\r\n  }\r\n\r\n  /** Obtains the instance of an RPC configuration class. */\r\n  public static obtain<T extends RpcConfiguration>(configurationConstructor: new () => T): T {\r\n    let instance = (configurationConstructor as any)[INSTANCE] as T;\r\n    if (!instance)\r\n      instance = (configurationConstructor as any)[INSTANCE] = new configurationConstructor();\r\n\r\n    return instance;\r\n  }\r\n\r\n  /** Enables passing of application-specific context with each RPC request. */\r\n  public static requestContext: RpcRequestContext = {\r\n    getId: (_request: RpcRequest): string => \"\",\r\n    serialize: async (request: RpcRequest): Promise<SerializedRpcActivity> => ({\r\n      id: request.id,\r\n      applicationId: \"\",\r\n      applicationVersion: \"\",\r\n      sessionId: \"\",\r\n      authorization: \"\",\r\n    }),\r\n  };\r\n\r\n  /** @internal */\r\n  public attached: RpcInterfaceDefinition[] = [];\r\n\r\n  /** The protocol of the configuration.\r\n   * @internal\r\n   */\r\n  public abstract readonly protocol: RpcProtocol;\r\n\r\n  /** The RPC interfaces managed by the configuration. */\r\n  public abstract readonly interfaces: () => RpcInterfaceDefinition[];\r\n\r\n  /** @internal */\r\n  public allowAttachedInterfaces: boolean = true;\r\n\r\n  /** @internal */\r\n  public get attachedInterfaces(): ReadonlyArray<RpcInterfaceDefinition> { return this.attached; }\r\n\r\n  /** The target interval (in milliseconds) between connection attempts for pending RPC operation requests. */\r\n  public pendingOperationRetryInterval = 10000;\r\n\r\n  /** The maximum number of transient faults permitted before request failure. */\r\n  public transientFaultLimit = 4;\r\n\r\n  /** @internal */\r\n  public readonly routing: RpcRoutingToken = RpcRoutingToken.default;\r\n\r\n  /** The control channel for the configuration.\r\n   * @internal\r\n   */\r\n  public readonly controlChannel = RpcControlChannel.obtain(this);\r\n\r\n  /** @internal */\r\n  public attach<T extends RpcInterface>(definition: RpcInterfaceDefinition<T>): void {\r\n    if (!this.allowAttachedInterfaces) {\r\n      return;\r\n    }\r\n\r\n    if (this.interfaces().indexOf(definition) !== -1 || this.attached.indexOf(definition) !== -1) {\r\n      return;\r\n    }\r\n\r\n    this.attached.push(definition);\r\n    RpcConfiguration.assign(definition, () => this.constructor as any);\r\n    RpcManager.initializeInterface(definition);\r\n  }\r\n\r\n  /** Initializes the RPC interfaces managed by the configuration. */\r\n  public static initializeInterfaces(configuration: RpcConfiguration) {\r\n    configuration.interfaces().forEach((definition) => RpcManager.initializeInterface(definition));\r\n  }\r\n\r\n  /** @internal */\r\n  public static supply(definition: RpcInterface): RpcConfiguration {\r\n    return RpcConfiguration.obtain(definition.configurationSupplier ? definition.configurationSupplier(definition.routing) : RpcDefaultConfiguration);\r\n  }\r\n\r\n  /** @internal */\r\n  public onRpcClientInitialized(definition: RpcInterfaceDefinition, client: RpcInterface): void {\r\n    this.protocol.onRpcClientInitialized(definition, client);\r\n  }\r\n\r\n  /** @internal */\r\n  public onRpcImplInitialized(definition: RpcInterfaceDefinition, impl: RpcInterface): void {\r\n    this.protocol.onRpcImplInitialized(definition, impl);\r\n  }\r\n\r\n  /** @internal */\r\n  public onRpcClientTerminated(definition: RpcInterfaceDefinition, client: RpcInterface): void {\r\n    this.protocol.onRpcClientTerminated(definition, client);\r\n  }\r\n\r\n  /** @internal */\r\n  public onRpcImplTerminated(definition: RpcInterfaceDefinition, impl: RpcInterface): void {\r\n    this.protocol.onRpcImplTerminated(definition, impl);\r\n  }\r\n}\r\n\r\n/** A default configuration that can be used for basic testing within a library.\r\n * @internal\r\n */\r\nexport class RpcDefaultConfiguration extends RpcConfiguration {\r\n  public interfaces = () => [];\r\n  public protocol: RpcProtocol = new RpcDirectProtocol(this);\r\n}\r\n\r\n/** A default protocol that can be used for basic testing within a library.\r\n * @internal\r\n */\r\nexport class RpcDirectProtocol extends RpcProtocol {\r\n  public readonly requestType = RpcDirectRequest;\r\n}\r\n\r\n/** A default request type that can be used for basic testing within a library.\r\n * @internal\r\n */\r\nexport class RpcDirectRequest extends RpcRequest {\r\n  public headers: Map<string, string> = new Map();\r\n  public fulfillment: RpcRequestFulfillment | undefined = undefined;\r\n\r\n  protected async send() {\r\n    const request = await this.protocol.serialize(this);\r\n    return new Promise<number>(async (resolve, reject) => {\r\n      try {\r\n        this.fulfillment = await this.protocol.fulfill(request);\r\n        resolve(this.fulfillment.status);\r\n      } catch (err) {\r\n        reject(err);\r\n      }\r\n    });\r\n  }\r\n\r\n  protected setHeader(name: string, value: string): void {\r\n    this.headers.set(name, value);\r\n  }\r\n\r\n  protected async load() {\r\n    return this.fulfillment!.result;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"RpcConfiguration.js","sourceRoot":"","sources":["../../../../src/rpc/core/RpcConfiguration.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 */\nimport { RpcInterface, RpcInterfaceDefinition } from \"../../RpcInterface\";\nimport { RpcManager } from \"../../RpcManager\";\nimport { RpcControlChannel } from \"./RpcControl\";\nimport { SerializedRpcActivity } from \"./RpcInvocation\";\nimport { RpcProtocol, RpcRequestFulfillment } from \"./RpcProtocol\";\nimport { INSTANCE } from \"./RpcRegistry\";\nimport { RpcRequest } from \"./RpcRequest\";\nimport { RpcRequestContext } from \"./RpcRequestContext\";\nimport { RpcRoutingToken } from \"./RpcRoutingToken\";\n\n/* eslint-disable deprecation/deprecation */\n\n/** @internal */\nexport type RpcConfigurationSupplier = (routing?: RpcRoutingToken) => { new(): RpcConfiguration }; // eslint-disable-line @typescript-eslint/prefer-function-type\n\n/** @internal */\nexport interface RpcRoutingMap extends RpcConfigurationSupplier { configurations: Map<number, RpcConfigurationSupplier> }\n\n/** @internal */\nexport namespace RpcRoutingMap {\n  export function create(): RpcRoutingMap {\n    const configurations = new Map();\n    return Object.assign((routing?: RpcRoutingToken) => configurations.get(routing!.id)(), { configurations });\n  }\n}\n\n/** A RpcConfiguration specifies how calls on an RPC interface will be marshalled, plus other operating parameters.\n * RpcConfiguration is the base class for specific configurations.\n * @beta\n */\nexport abstract class RpcConfiguration {\n  /** Whether development mode is enabled.\n   * @note This parameter determines whether developer convenience features like backend stack traces are available.\n   */\n  public static developmentMode: boolean = false;\n\n  /** Whether frontend checks that are relevant in a cloud-hosted routing scenario are disabled. */\n  public static disableRoutingValidation: boolean = false;\n\n  /** Whether strict mode is enabled.\n   * This parameter determines system behaviors relating to strict checking:\n   * - Whether an error is thrown if the type marshaling system encounters an unregistered type (only in strict mode).\n   */\n  public static strictMode: boolean = false;\n\n  /**\n   * Whether to throw an error when the IModelRpcProps in the operation parameter list differs from the token in the URL.\n   * @note By default, a warning is logged and the operation is allowed to proceed.\n   * @note The parameter token is always replaced by the url token (unless RpcOperationPolicy.allowTokenMismatch is set).\n   */\n  public static throwOnTokenMismatch = false;\n\n  /** @internal Sets the configuration supplier for an RPC interface class. */\n  public static assign<T extends RpcInterface>(definition: RpcInterfaceDefinition<T>, supplier: RpcConfigurationSupplier): void {\n    const map = definition.prototype.configurationSupplier as RpcRoutingMap | undefined;\n    if (!map || typeof (map.configurations) === \"undefined\") {\n      definition.prototype.configurationSupplier = supplier;\n    } else {\n      map.configurations.set(RpcRoutingToken.default.id, supplier);\n    }\n  }\n\n  /** Sets the configuration supplier for an RPC interface class for a given routing. */\n  public static assignWithRouting<T extends RpcInterface>(definition: RpcInterfaceDefinition<T>, routing: RpcRoutingToken, configuration: new () => RpcConfiguration): void {\n    if (!definition.prototype.configurationSupplier) {\n      RpcConfiguration.assign(definition, RpcRoutingMap.create());\n    }\n\n    let map = definition.prototype.configurationSupplier as RpcRoutingMap;\n    if (typeof (map.configurations) === \"undefined\") {\n      const existing = map as RpcConfigurationSupplier;\n      map = RpcRoutingMap.create();\n      RpcConfiguration.assign(definition, map);\n      map.configurations.set(RpcRoutingToken.default.id, existing);\n    }\n\n    const supplier = () => configuration;\n    map.configurations.set(routing.id, supplier);\n  }\n\n  /** Obtains the instance of an RPC configuration class. */\n  public static obtain<T extends RpcConfiguration>(configurationConstructor: new () => T): T {\n    let instance = (configurationConstructor as any)[INSTANCE] as T;\n    if (!instance)\n      instance = (configurationConstructor as any)[INSTANCE] = new configurationConstructor();\n\n    return instance;\n  }\n\n  /** @internal Enables passing of application-specific context with each RPC request. */\n  public static requestContext: RpcRequestContext = {\n    getId: (_request: RpcRequest): string => \"\",\n    serialize: async (request: RpcRequest): Promise<SerializedRpcActivity> => ({\n      id: request.id,\n      applicationId: \"\",\n      applicationVersion: \"\",\n      sessionId: \"\",\n      authorization: \"\",\n    }),\n  };\n\n  /** @internal */\n  public attached: RpcInterfaceDefinition[] = [];\n\n  /** The protocol of the configuration.\n   * @internal\n   */\n  public abstract readonly protocol: RpcProtocol;\n\n  /** The RPC interfaces managed by the configuration. */\n  public abstract readonly interfaces: () => RpcInterfaceDefinition[];\n\n  /** @internal */\n  public allowAttachedInterfaces: boolean = true;\n\n  /** @internal */\n  public get attachedInterfaces(): ReadonlyArray<RpcInterfaceDefinition> { return this.attached; }\n\n  /** The target interval (in milliseconds) between connection attempts for pending RPC operation requests. */\n  public pendingOperationRetryInterval = 10000;\n\n  /** The maximum number of transient faults permitted before request failure. */\n  public transientFaultLimit = 4;\n\n  /** @internal */\n  public readonly routing: RpcRoutingToken = RpcRoutingToken.default;\n\n  /** The control channel for the configuration.\n   * @internal\n   */\n  public readonly controlChannel = RpcControlChannel.obtain(this);\n\n  /** @internal */\n  public attach<T extends RpcInterface>(definition: RpcInterfaceDefinition<T>): void {\n    if (!this.allowAttachedInterfaces) {\n      return;\n    }\n\n    if (this.interfaces().indexOf(definition) !== -1 || this.attached.indexOf(definition) !== -1) {\n      return;\n    }\n\n    this.attached.push(definition);\n    RpcConfiguration.assign(definition, () => this.constructor as any);\n    RpcManager.initializeInterface(definition);\n  }\n\n  /** Initializes the RPC interfaces managed by the configuration. */\n  public static initializeInterfaces(configuration: RpcConfiguration) {\n    configuration.interfaces().forEach((definition) => RpcManager.initializeInterface(definition));\n  }\n\n  /** @internal */\n  public static supply(definition: RpcInterface): RpcConfiguration {\n    return RpcConfiguration.obtain(definition.configurationSupplier ? definition.configurationSupplier(definition.routing) : RpcDefaultConfiguration);\n  }\n\n  /** @internal */\n  public onRpcClientInitialized(definition: RpcInterfaceDefinition, client: RpcInterface): void {\n    this.protocol.onRpcClientInitialized(definition, client);\n  }\n\n  /** @internal */\n  public onRpcImplInitialized(definition: RpcInterfaceDefinition, impl: RpcInterface): void {\n    this.protocol.onRpcImplInitialized(definition, impl);\n  }\n\n  /** @internal */\n  public onRpcClientTerminated(definition: RpcInterfaceDefinition, client: RpcInterface): void {\n    this.protocol.onRpcClientTerminated(definition, client);\n  }\n\n  /** @internal */\n  public onRpcImplTerminated(definition: RpcInterfaceDefinition, impl: RpcInterface): void {\n    this.protocol.onRpcImplTerminated(definition, impl);\n  }\n}\n\n/** A default configuration that can be used for basic testing within a library.\n * @internal\n */\nexport class RpcDefaultConfiguration extends RpcConfiguration {\n  public interfaces = () => [];\n  public protocol: RpcProtocol = new RpcDirectProtocol(this);\n}\n\n/** A default protocol that can be used for basic testing within a library.\n * @internal\n */\nexport class RpcDirectProtocol extends RpcProtocol {\n  public readonly requestType = RpcDirectRequest;\n}\n\n/** A default request type that can be used for basic testing within a library.\n * @internal\n */\nexport class RpcDirectRequest extends RpcRequest {\n  public headers: Map<string, string> = new Map();\n  public fulfillment: RpcRequestFulfillment | undefined = undefined;\n\n  protected async send() {\n    const request = await this.protocol.serialize(this);\n    return new Promise<number>(async (resolve, reject) => {\n      try {\n        this.fulfillment = await this.protocol.fulfill(request);\n        resolve(this.fulfillment.status);\n      } catch (err) {\n        reject(err);\n      }\n    });\n  }\n\n  protected setHeader(name: string, value: string): void {\n    this.headers.set(name, value);\n  }\n\n  protected async load() {\n    return this.fulfillment!.result;\n  }\n}\n"]}

package/lib/cjs/rpc/core/RpcConstants.d.ts

@@ -1,91 +1,91 @@
-/** @packageDocumentation
- * @module RpcInterface
- */
-/** Describes available options for RPC response caching.
- * @public
- */
-export declare enum RpcResponseCacheControl {
-    None = 0,
-    Immutable = 1
-}
-/** RPC protocol event types.
- * @public
- * @deprecated in 3.6. The RPC system will be significantly refactored (or replaced) in version 5.0.
- */
-export declare enum RpcProtocolEvent {
-    RequestCreated = 0,
-    ResponseLoaded = 1,
-    ResponseLoading = 2,
-    ConnectionErrorReceived = 3,
-    UnknownErrorReceived = 4,
-    BackendErrorReceived = 5,
-    ConnectionAborted = 6,
-    RequestReceived = 7,
-    BackendResponseCreated = 8,
-    BackendReportedPending = 9,
-    BackendReportedNotFound = 10,
-    BackendErrorOccurred = 11,
-    BackendReportedNoContent = 12
-}
-/** The status of an RPC operation request.
- * @public
- * @deprecated in 3.6. The RPC system will be significantly refactored (or replaced) in version 5.0.
- */
-export declare enum RpcRequestStatus {
-    Unknown = 0,
-    Created = 1,
-    Submitted = 2,
-    Pending = 3,
-    Resolved = 4,
-    Rejected = 5,
-    Disposed = 6,
-    NotFound = 7,
-    Cancelled = 8,
-    NoContent = 9,
-    BadGateway = 10,
-    ServiceUnavailable = 11,
-    GatewayTimeout = 12,
-    RequestTimeout = 13,
-    TooManyRequests = 14
-}
-/** @public @deprecated in 3.6. The RPC system will be significantly refactored (or replaced) in version 5.0. */
-export declare namespace RpcRequestStatus {
-    function isTransientError(status: RpcRequestStatus): boolean;
-}
-/** RPC request event types.
- * @public
- * @deprecated in 3.6. The RPC system will be significantly refactored (or replaced) in version 5.0.
- */
-export declare enum RpcRequestEvent {
-    StatusChanged = 0,
-    PendingUpdateReceived = 1,
-    TransientErrorReceived = 2
-}
-/** RPC content types.
- * @public
- * @deprecated in 3.6. The RPC system will be significantly refactored (or replaced) in version 5.0.
- */
-export declare enum RpcContentType {
-    Unknown = 0,
-    Text = 1,
-    Binary = 2,
-    Multipart = 3,
-    Stream = 4
-}
-/** Endpoints for RPC protocols.
- * @public
- * @deprecated in 3.6. The RPC system will be significantly refactored (or replaced) in version 5.0.
- */
-export declare enum RpcEndpoint {
-    Frontend = 0,
-    Backend = 1
-}
-/** @internal */
-export declare const WEB_RPC_CONSTANTS: {
-    CONTENT: string;
-    TEXT: string;
-    ANY_TEXT: string;
-    BINARY: string;
-    MULTIPART: string;
-};
+/** @packageDocumentation
+ * @module RpcInterface
+ */
+/** Describes available options for RPC response caching.
+ * @public
+ */
+export declare enum RpcResponseCacheControl {
+    None = 0,
+    Immutable = 1
+}
+/** RPC protocol event types.
+ * @public
+ * @deprecated in 3.6. The RPC system will be significantly refactored (or replaced) in version 5.0.
+ */
+export declare enum RpcProtocolEvent {
+    RequestCreated = 0,
+    ResponseLoaded = 1,
+    ResponseLoading = 2,
+    ConnectionErrorReceived = 3,
+    UnknownErrorReceived = 4,
+    BackendErrorReceived = 5,
+    ConnectionAborted = 6,
+    RequestReceived = 7,
+    BackendResponseCreated = 8,
+    BackendReportedPending = 9,
+    BackendReportedNotFound = 10,
+    BackendErrorOccurred = 11,
+    BackendReportedNoContent = 12
+}
+/** The status of an RPC operation request.
+ * @public
+ * @deprecated in 3.6. The RPC system will be significantly refactored (or replaced) in version 5.0.
+ */
+export declare enum RpcRequestStatus {
+    Unknown = 0,
+    Created = 1,
+    Submitted = 2,
+    Pending = 3,
+    Resolved = 4,
+    Rejected = 5,
+    Disposed = 6,
+    NotFound = 7,
+    Cancelled = 8,
+    NoContent = 9,
+    BadGateway = 10,
+    ServiceUnavailable = 11,
+    GatewayTimeout = 12,
+    RequestTimeout = 13,
+    TooManyRequests = 14
+}
+/** @public @deprecated in 3.6. The RPC system will be significantly refactored (or replaced) in version 5.0. */
+export declare namespace RpcRequestStatus {
+    function isTransientError(status: RpcRequestStatus): boolean;
+}
+/** RPC request event types.
+ * @public
+ * @deprecated in 3.6. The RPC system will be significantly refactored (or replaced) in version 5.0.
+ */
+export declare enum RpcRequestEvent {
+    StatusChanged = 0,
+    PendingUpdateReceived = 1,
+    TransientErrorReceived = 2
+}
+/** RPC content types.
+ * @public
+ * @deprecated in 3.6. The RPC system will be significantly refactored (or replaced) in version 5.0.
+ */
+export declare enum RpcContentType {
+    Unknown = 0,
+    Text = 1,
+    Binary = 2,
+    Multipart = 3,
+    Stream = 4
+}
+/** Endpoints for RPC protocols.
+ * @public
+ * @deprecated in 3.6. The RPC system will be significantly refactored (or replaced) in version 5.0.
+ */
+export declare enum RpcEndpoint {
+    Frontend = 0,
+    Backend = 1
+}
+/** @internal */
+export declare const WEB_RPC_CONSTANTS: {
+    CONTENT: string;
+    TEXT: string;
+    ANY_TEXT: string;
+    BINARY: string;
+    MULTIPART: string;
+};
 //# sourceMappingURL=RpcConstants.d.ts.map