@itwin/core-common 4.0.0-dev.7 → 4.0.0-dev.72

package/lib/esm/rpc/TestRpcManager.js

@@ -1,37 +1,37 @@
-/*---------------------------------------------------------------------------------------------
-* 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 { RpcConfiguration, RpcDefaultConfiguration } from "./core/RpcConfiguration";
-/* eslint-disable deprecation/deprecation */
-/** An RpcManager that uses RpcDefaultConfiguration/RpcDirectProtocol to make client stubs invoke
- * registered server impls as direct method calls within the same JavaScript context. In other words,
- * TestRpcManager sets up a protocol that uses our remoting mechanism but cuts out the communication
- * part of it. (No IPC or XHR is used or required.)
- * Nevertheless, all of the rest of the call marshalling and operation monitoring mechanism is used.
- * That makes TestRpcManager a way to write simple, single-process integration tests for frontends
- * and backends that actually use RpcInterfaces. Note that to write such a single-process integration
- * test, you must make *both* client and server use TestRpcManager to configure their RpcInterfaces.
- * It will not work if one side uses TestRpcManager and the other uses some other protocol (say, cloud).
- * That means that you must actually program the backend to know when it is running in direct test
- * mode and to employ TestRpcManager in that case.
- * @internal
- */
-export class TestRpcManager {
-    static initialize(interfaces) {
-        const config = class extends RpcDefaultConfiguration {
-            constructor() {
-                super(...arguments);
-                this.interfaces = () => interfaces;
-            }
-        };
-        for (const def of interfaces)
-            RpcConfiguration.assign(def, () => RpcDefaultConfiguration);
-        const instance = RpcConfiguration.obtain(config);
-        RpcConfiguration.initializeInterfaces(instance);
-    }
-}
+/*---------------------------------------------------------------------------------------------
+* 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 { RpcConfiguration, RpcDefaultConfiguration } from "./core/RpcConfiguration";
+/* eslint-disable deprecation/deprecation */
+/** An RpcManager that uses RpcDefaultConfiguration/RpcDirectProtocol to make client stubs invoke
+ * registered server impls as direct method calls within the same JavaScript context. In other words,
+ * TestRpcManager sets up a protocol that uses our remoting mechanism but cuts out the communication
+ * part of it. (No IPC or XHR is used or required.)
+ * Nevertheless, all of the rest of the call marshalling and operation monitoring mechanism is used.
+ * That makes TestRpcManager a way to write simple, single-process integration tests for frontends
+ * and backends that actually use RpcInterfaces. Note that to write such a single-process integration
+ * test, you must make *both* client and server use TestRpcManager to configure their RpcInterfaces.
+ * It will not work if one side uses TestRpcManager and the other uses some other protocol (say, cloud).
+ * That means that you must actually program the backend to know when it is running in direct test
+ * mode and to employ TestRpcManager in that case.
+ * @internal
+ */
+export class TestRpcManager {
+    static initialize(interfaces) {
+        const config = class extends RpcDefaultConfiguration {
+            constructor() {
+                super(...arguments);
+                this.interfaces = () => interfaces;
+            }
+        };
+        for (const def of interfaces)
+            RpcConfiguration.assign(def, () => RpcDefaultConfiguration);
+        const instance = RpcConfiguration.obtain(config);
+        RpcConfiguration.initializeInterfaces(instance);
+    }
+}
 //# sourceMappingURL=TestRpcManager.js.map

package/lib/esm/rpc/WipRpcInterface.d.ts

@@ -1,30 +1,30 @@
-/** @packageDocumentation
- * @module RpcInterface
- */
-import { ChangedElements } from "../ChangedElements";
-import { IModelRpcProps } from "../IModel";
-import { RpcInterface } from "../RpcInterface";
-/** The purpose of this class is to house WIP RPC methods. For example:
- * - WIP methods where signatures or behavior is still changing
- * - Experimental methods that we may decide are a bad idea and never release
- * The idea is to house these WIP RPC methods away from other RpcInterfaces that have stated compatibility goals.
- * Once stable, the goal is to move methods out to their rightful home.
- * Apps/services should understand the *flux* implied by registering this RpcInterface and should be in control of both the client and server before even considering using it.
- * @internal
- */
-export declare abstract class WipRpcInterface extends RpcInterface {
-    /** Returns the IModelReadRpcInterface instance for the frontend. */
-    static getClient(): WipRpcInterface;
-    /** The immutable name of the interface. */
-    static readonly interfaceName = "WipRpcInterface";
-    /** The semantic version of the interface.
-     * @note The WipRpcInterface will never progress to 1.0 since it is never intended to be public.
-     */
-    static interfaceVersion: string;
-    placeholder(_iModelToken: IModelRpcProps): Promise<string>;
-    isChangeCacheAttached(_iModelToken: IModelRpcProps): Promise<boolean>;
-    attachChangeCache(_iModelToken: IModelRpcProps): Promise<void>;
-    getChangedElements(_iModelToken: IModelRpcProps, _startChangesetId: string, _endChangesetId: string): Promise<ChangedElements | undefined>;
-    isChangesetProcessed(_iModelToken: IModelRpcProps, _changesetId: string): Promise<boolean>;
-}
+/** @packageDocumentation
+ * @module RpcInterface
+ */
+import { ChangedElements } from "../ChangedElements";
+import { IModelRpcProps } from "../IModel";
+import { RpcInterface } from "../RpcInterface";
+/** The purpose of this class is to house WIP RPC methods. For example:
+ * - WIP methods where signatures or behavior is still changing
+ * - Experimental methods that we may decide are a bad idea and never release
+ * The idea is to house these WIP RPC methods away from other RpcInterfaces that have stated compatibility goals.
+ * Once stable, the goal is to move methods out to their rightful home.
+ * Apps/services should understand the *flux* implied by registering this RpcInterface and should be in control of both the client and server before even considering using it.
+ * @internal
+ */
+export declare abstract class WipRpcInterface extends RpcInterface {
+    /** Returns the IModelReadRpcInterface instance for the frontend. */
+    static getClient(): WipRpcInterface;
+    /** The immutable name of the interface. */
+    static readonly interfaceName = "WipRpcInterface";
+    /** The semantic version of the interface.
+     * @note The WipRpcInterface will never progress to 1.0 since it is never intended to be public.
+     */
+    static interfaceVersion: string;
+    placeholder(_iModelToken: IModelRpcProps): Promise<string>;
+    isChangeCacheAttached(_iModelToken: IModelRpcProps): Promise<boolean>;
+    attachChangeCache(_iModelToken: IModelRpcProps): Promise<void>;
+    getChangedElements(_iModelToken: IModelRpcProps, _startChangesetId: string, _endChangesetId: string): Promise<ChangedElements | undefined>;
+    isChangesetProcessed(_iModelToken: IModelRpcProps, _changesetId: string): Promise<boolean>;
+}
 //# sourceMappingURL=WipRpcInterface.d.ts.map

package/lib/esm/rpc/WipRpcInterface.js

@@ -1,37 +1,38 @@
-/*---------------------------------------------------------------------------------------------
-* 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 { RpcInterface } from "../RpcInterface";
-import { RpcManager } from "../RpcManager";
-/** The purpose of this class is to house WIP RPC methods. For example:
- * - WIP methods where signatures or behavior is still changing
- * - Experimental methods that we may decide are a bad idea and never release
- * The idea is to house these WIP RPC methods away from other RpcInterfaces that have stated compatibility goals.
- * Once stable, the goal is to move methods out to their rightful home.
- * Apps/services should understand the *flux* implied by registering this RpcInterface and should be in control of both the client and server before even considering using it.
- * @internal
- */
-export class WipRpcInterface extends RpcInterface {
-    /** Returns the IModelReadRpcInterface instance for the frontend. */
-    static getClient() { return RpcManager.getClientForInterface(WipRpcInterface); }
-    /*===========================================================================================
-      NOTE: Any add/remove/change to the methods below requires an update of the interface version.
-      NOTE: Please consult the README in this folder for the semantic versioning rules.
-    ==========================================================================================*/
-    async placeholder(_iModelToken) { return this.forward(arguments); } // here to test that WipRpcInterface is configured properly
-    async isChangeCacheAttached(_iModelToken) { return this.forward(arguments); }
-    async attachChangeCache(_iModelToken) { return this.forward(arguments); }
-    async getChangedElements(_iModelToken, _startChangesetId, _endChangesetId) { return this.forward(arguments); }
-    async isChangesetProcessed(_iModelToken, _changesetId) { return this.forward(arguments); }
-}
-/** The immutable name of the interface. */
-WipRpcInterface.interfaceName = "WipRpcInterface";
-/** The semantic version of the interface.
- * @note The WipRpcInterface will never progress to 1.0 since it is never intended to be public.
- */
-WipRpcInterface.interfaceVersion = "0.5.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 { RpcInterface } from "../RpcInterface";
+import { RpcManager } from "../RpcManager";
+/** The purpose of this class is to house WIP RPC methods. For example:
+ * - WIP methods where signatures or behavior is still changing
+ * - Experimental methods that we may decide are a bad idea and never release
+ * The idea is to house these WIP RPC methods away from other RpcInterfaces that have stated compatibility goals.
+ * Once stable, the goal is to move methods out to their rightful home.
+ * Apps/services should understand the *flux* implied by registering this RpcInterface and should be in control of both the client and server before even considering using it.
+ * @internal
+ */
+class WipRpcInterface extends RpcInterface {
+    /** Returns the IModelReadRpcInterface instance for the frontend. */
+    static getClient() { return RpcManager.getClientForInterface(WipRpcInterface); }
+    /*===========================================================================================
+      NOTE: Any add/remove/change to the methods below requires an update of the interface version.
+      NOTE: Please consult the README in this folder for the semantic versioning rules.
+    ==========================================================================================*/
+    async placeholder(_iModelToken) { return this.forward(arguments); } // here to test that WipRpcInterface is configured properly
+    async isChangeCacheAttached(_iModelToken) { return this.forward(arguments); }
+    async attachChangeCache(_iModelToken) { return this.forward(arguments); }
+    async getChangedElements(_iModelToken, _startChangesetId, _endChangesetId) { return this.forward(arguments); }
+    async isChangesetProcessed(_iModelToken, _changesetId) { return this.forward(arguments); }
+}
+/** The immutable name of the interface. */
+WipRpcInterface.interfaceName = "WipRpcInterface";
+/** The semantic version of the interface.
+ * @note The WipRpcInterface will never progress to 1.0 since it is never intended to be public.
+ */
+WipRpcInterface.interfaceVersion = "0.5.0";
+export { WipRpcInterface };
 //# sourceMappingURL=WipRpcInterface.js.map

package/lib/esm/rpc/WipRpcInterface.js.map

@@ -1 +1 @@
-{"version":3,"file":"WipRpcInterface.js","sourceRoot":"","sources":["../../../src/rpc/WipRpcInterface.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C;;;;;;;GAOG;AACH,MAAM,OAAgB,eAAgB,SAAQ,YAAY;IACxD,oEAAoE;IAC7D,MAAM,CAAC,SAAS,KAAsB,OAAO,UAAU,CAAC,qBAAqB,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAUxG;;;gGAG4F;IACrF,KAAK,CAAC,WAAW,CAAC,YAA4B,IAAqB,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,2DAA2D;IAChK,KAAK,CAAC,qBAAqB,CAAC,YAA4B,IAAsB,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC/G,KAAK,CAAC,iBAAiB,CAAC,YAA4B,IAAmB,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACxG,KAAK,CAAC,kBAAkB,CAAC,YAA4B,EAAE,iBAAyB,EAAE,eAAuB,IAA0C,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACpL,KAAK,CAAC,oBAAoB,CAAC,YAA4B,EAAE,YAAoB,IAAsB,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;;AAhB3I,2CAA2C;AACpB,6BAAa,GAAG,iBAAiB,CAAC;AAEzD;;GAEG;AACW,gCAAgB,GAAG,OAAO,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 { ChangedElements } from \"../ChangedElements\";\r\nimport { IModelRpcProps } from \"../IModel\";\r\nimport { RpcInterface } from \"../RpcInterface\";\r\nimport { RpcManager } from \"../RpcManager\";\r\n\r\n/** The purpose of this class is to house WIP RPC methods. For example:\r\n * - WIP methods where signatures or behavior is still changing\r\n * - Experimental methods that we may decide are a bad idea and never release\r\n * The idea is to house these WIP RPC methods away from other RpcInterfaces that have stated compatibility goals.\r\n * Once stable, the goal is to move methods out to their rightful home.\r\n * Apps/services should understand the *flux* implied by registering this RpcInterface and should be in control of both the client and server before even considering using it.\r\n * @internal\r\n */\r\nexport abstract class WipRpcInterface extends RpcInterface { // eslint-disable-line deprecation/deprecation\r\n  /** Returns the IModelReadRpcInterface instance for the frontend. */\r\n  public static getClient(): WipRpcInterface { return RpcManager.getClientForInterface(WipRpcInterface); }\r\n\r\n  /** The immutable name of the interface. */\r\n  public static readonly interfaceName = \"WipRpcInterface\";\r\n\r\n  /** The semantic version of the interface.\r\n   * @note The WipRpcInterface will never progress to 1.0 since it is never intended to be public.\r\n   */\r\n  public static interfaceVersion = \"0.5.0\";\r\n\r\n  /*===========================================================================================\r\n    NOTE: Any add/remove/change to the methods below requires an update of the interface version.\r\n    NOTE: Please consult the README in this folder for the semantic versioning rules.\r\n  ==========================================================================================*/\r\n  public async placeholder(_iModelToken: IModelRpcProps): Promise<string> { return this.forward(arguments); } // here to test that WipRpcInterface is configured properly\r\n  public async isChangeCacheAttached(_iModelToken: IModelRpcProps): Promise<boolean> { return this.forward(arguments); }\r\n  public async attachChangeCache(_iModelToken: IModelRpcProps): Promise<void> { return this.forward(arguments); }\r\n  public async getChangedElements(_iModelToken: IModelRpcProps, _startChangesetId: string, _endChangesetId: string): Promise<ChangedElements | undefined> { return this.forward(arguments); }\r\n  public async isChangesetProcessed(_iModelToken: IModelRpcProps, _changesetId: string): Promise<boolean> { return this.forward(arguments); }\r\n}\r\n"]}
+{"version":3,"file":"WipRpcInterface.js","sourceRoot":"","sources":["../../../src/rpc/WipRpcInterface.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C;;;;;;;GAOG;AACH,MAAsB,eAAgB,SAAQ,YAAY;IACxD,oEAAoE;IAC7D,MAAM,CAAC,SAAS,KAAsB,OAAO,UAAU,CAAC,qBAAqB,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAUxG;;;gGAG4F;IACrF,KAAK,CAAC,WAAW,CAAC,YAA4B,IAAqB,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,2DAA2D;IAChK,KAAK,CAAC,qBAAqB,CAAC,YAA4B,IAAsB,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC/G,KAAK,CAAC,iBAAiB,CAAC,YAA4B,IAAmB,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACxG,KAAK,CAAC,kBAAkB,CAAC,YAA4B,EAAE,iBAAyB,EAAE,eAAuB,IAA0C,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACpL,KAAK,CAAC,oBAAoB,CAAC,YAA4B,EAAE,YAAoB,IAAsB,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;;AAhB3I,2CAA2C;AACpB,6BAAa,GAAG,iBAAiB,CAAC;AAEzD;;GAEG;AACW,gCAAgB,GAAG,OAAO,CAAC;SAVrB,eAAe","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 { ChangedElements } from \"../ChangedElements\";\r\nimport { IModelRpcProps } from \"../IModel\";\r\nimport { RpcInterface } from \"../RpcInterface\";\r\nimport { RpcManager } from \"../RpcManager\";\r\n\r\n/** The purpose of this class is to house WIP RPC methods. For example:\r\n * - WIP methods where signatures or behavior is still changing\r\n * - Experimental methods that we may decide are a bad idea and never release\r\n * The idea is to house these WIP RPC methods away from other RpcInterfaces that have stated compatibility goals.\r\n * Once stable, the goal is to move methods out to their rightful home.\r\n * Apps/services should understand the *flux* implied by registering this RpcInterface and should be in control of both the client and server before even considering using it.\r\n * @internal\r\n */\r\nexport abstract class WipRpcInterface extends RpcInterface { // eslint-disable-line deprecation/deprecation\r\n  /** Returns the IModelReadRpcInterface instance for the frontend. */\r\n  public static getClient(): WipRpcInterface { return RpcManager.getClientForInterface(WipRpcInterface); }\r\n\r\n  /** The immutable name of the interface. */\r\n  public static readonly interfaceName = \"WipRpcInterface\";\r\n\r\n  /** The semantic version of the interface.\r\n   * @note The WipRpcInterface will never progress to 1.0 since it is never intended to be public.\r\n   */\r\n  public static interfaceVersion = \"0.5.0\";\r\n\r\n  /*===========================================================================================\r\n    NOTE: Any add/remove/change to the methods below requires an update of the interface version.\r\n    NOTE: Please consult the README in this folder for the semantic versioning rules.\r\n  ==========================================================================================*/\r\n  public async placeholder(_iModelToken: IModelRpcProps): Promise<string> { return this.forward(arguments); } // here to test that WipRpcInterface is configured properly\r\n  public async isChangeCacheAttached(_iModelToken: IModelRpcProps): Promise<boolean> { return this.forward(arguments); }\r\n  public async attachChangeCache(_iModelToken: IModelRpcProps): Promise<void> { return this.forward(arguments); }\r\n  public async getChangedElements(_iModelToken: IModelRpcProps, _startChangesetId: string, _endChangesetId: string): Promise<ChangedElements | undefined> { return this.forward(arguments); }\r\n  public async isChangesetProcessed(_iModelToken: IModelRpcProps, _changesetId: string): Promise<boolean> { return this.forward(arguments); }\r\n}\r\n"]}

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

@@ -1,112 +1,112 @@
-/** @packageDocumentation
- * @module RpcInterface
- */
-import { RpcInterface, RpcInterfaceDefinition } from "../../RpcInterface";
-import { RpcControlChannel } from "./RpcControl";
-import { RpcProtocol, RpcRequestFulfillment } from "./RpcProtocol";
-import { RpcRequest } from "./RpcRequest";
-import { RpcRequestContext } from "./RpcRequestContext";
-import { RpcRoutingToken } from "./RpcRoutingToken";
-/** @internal */
-export declare type RpcConfigurationSupplier = (routing?: RpcRoutingToken) => {
-    new (): RpcConfiguration;
-};
-/** @internal */
-export interface RpcRoutingMap extends RpcConfigurationSupplier {
-    configurations: Map<number, RpcConfigurationSupplier>;
-}
-/** @internal */
-export declare namespace RpcRoutingMap {
-    function create(): 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
- */
-export declare abstract class RpcConfiguration {
-    /** Whether development mode is enabled.
-     * @note This parameter determines whether developer convenience features like backend stack traces are available.
-     */
-    static developmentMode: boolean;
-    /** Whether frontend checks that are relevant in a cloud-hosted routing scenario are disabled. */
-    static disableRoutingValidation: boolean;
-    /** 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).
-     */
-    static strictMode: boolean;
-    /**
-     * 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).
-     */
-    static throwOnTokenMismatch: boolean;
-    /** Sets the configuration supplier for an RPC interface class. */
-    static assign<T extends RpcInterface>(definition: RpcInterfaceDefinition<T>, supplier: RpcConfigurationSupplier): void;
-    /** Sets the configuration supplier for an RPC interface class for a given routing. */
-    static assignWithRouting<T extends RpcInterface>(definition: RpcInterfaceDefinition<T>, routing: RpcRoutingToken, configuration: new () => RpcConfiguration): void;
-    /** Obtains the instance of an RPC configuration class. */
-    static obtain<T extends RpcConfiguration>(configurationConstructor: new () => T): T;
-    /** Enables passing of application-specific context with each RPC request. */
-    static requestContext: RpcRequestContext;
-    /** @internal */
-    attached: RpcInterfaceDefinition[];
-    /** The protocol of the configuration.
-     * @internal
-     */
-    abstract readonly protocol: RpcProtocol;
-    /** The RPC interfaces managed by the configuration. */
-    abstract readonly interfaces: () => RpcInterfaceDefinition[];
-    /** @internal */
-    allowAttachedInterfaces: boolean;
-    /** @internal */
-    get attachedInterfaces(): ReadonlyArray<RpcInterfaceDefinition>;
-    /** The target interval (in milliseconds) between connection attempts for pending RPC operation requests. */
-    pendingOperationRetryInterval: number;
-    /** The maximum number of transient faults permitted before request failure. */
-    transientFaultLimit: number;
-    /** @internal */
-    readonly routing: RpcRoutingToken;
-    /** The control channel for the configuration.
-     * @internal
-     */
-    readonly controlChannel: RpcControlChannel;
-    /** @internal */
-    attach<T extends RpcInterface>(definition: RpcInterfaceDefinition<T>): void;
-    /** Initializes the RPC interfaces managed by the configuration. */
-    static initializeInterfaces(configuration: RpcConfiguration): void;
-    /** @internal */
-    static supply(definition: RpcInterface): RpcConfiguration;
-    /** @internal */
-    onRpcClientInitialized(definition: RpcInterfaceDefinition, client: RpcInterface): void;
-    /** @internal */
-    onRpcImplInitialized(definition: RpcInterfaceDefinition, impl: RpcInterface): void;
-    /** @internal */
-    onRpcClientTerminated(definition: RpcInterfaceDefinition, client: RpcInterface): void;
-    /** @internal */
-    onRpcImplTerminated(definition: RpcInterfaceDefinition, impl: RpcInterface): void;
-}
-/** A default configuration that can be used for basic testing within a library.
- * @internal
- */
-export declare class RpcDefaultConfiguration extends RpcConfiguration {
-    interfaces: () => never[];
-    protocol: RpcProtocol;
-}
-/** A default protocol that can be used for basic testing within a library.
- * @internal
- */
-export declare class RpcDirectProtocol extends RpcProtocol {
-    readonly requestType: typeof RpcDirectRequest;
-}
-/** A default request type that can be used for basic testing within a library.
- * @internal
- */
-export declare class RpcDirectRequest extends RpcRequest {
-    headers: Map<string, string>;
-    fulfillment: RpcRequestFulfillment | undefined;
-    protected send(): Promise<number>;
-    protected setHeader(name: string, value: string): void;
-    protected load(): Promise<import("./RpcMarshaling").RpcSerializedValue>;
-}
+/** @packageDocumentation
+ * @module RpcInterface
+ */
+import { RpcInterface, RpcInterfaceDefinition } from "../../RpcInterface";
+import { RpcControlChannel } from "./RpcControl";
+import { RpcProtocol, RpcRequestFulfillment } from "./RpcProtocol";
+import { RpcRequest } from "./RpcRequest";
+import { RpcRequestContext } from "./RpcRequestContext";
+import { RpcRoutingToken } from "./RpcRoutingToken";
+/** @internal */
+export type RpcConfigurationSupplier = (routing?: RpcRoutingToken) => {
+    new (): RpcConfiguration;
+};
+/** @internal */
+export interface RpcRoutingMap extends RpcConfigurationSupplier {
+    configurations: Map<number, RpcConfigurationSupplier>;
+}
+/** @internal */
+export declare namespace RpcRoutingMap {
+    function create(): 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
+ */
+export declare abstract class RpcConfiguration {
+    /** Whether development mode is enabled.
+     * @note This parameter determines whether developer convenience features like backend stack traces are available.
+     */
+    static developmentMode: boolean;
+    /** Whether frontend checks that are relevant in a cloud-hosted routing scenario are disabled. */
+    static disableRoutingValidation: boolean;
+    /** 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).
+     */
+    static strictMode: boolean;
+    /**
+     * 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).
+     */
+    static throwOnTokenMismatch: boolean;
+    /** @internal Sets the configuration supplier for an RPC interface class. */
+    static assign<T extends RpcInterface>(definition: RpcInterfaceDefinition<T>, supplier: RpcConfigurationSupplier): void;
+    /** Sets the configuration supplier for an RPC interface class for a given routing. */
+    static assignWithRouting<T extends RpcInterface>(definition: RpcInterfaceDefinition<T>, routing: RpcRoutingToken, configuration: new () => RpcConfiguration): void;
+    /** Obtains the instance of an RPC configuration class. */
+    static obtain<T extends RpcConfiguration>(configurationConstructor: new () => T): T;
+    /** @internal Enables passing of application-specific context with each RPC request. */
+    static requestContext: RpcRequestContext;
+    /** @internal */
+    attached: RpcInterfaceDefinition[];
+    /** The protocol of the configuration.
+     * @internal
+     */
+    abstract readonly protocol: RpcProtocol;
+    /** The RPC interfaces managed by the configuration. */
+    abstract readonly interfaces: () => RpcInterfaceDefinition[];
+    /** @internal */
+    allowAttachedInterfaces: boolean;
+    /** @internal */
+    get attachedInterfaces(): ReadonlyArray<RpcInterfaceDefinition>;
+    /** The target interval (in milliseconds) between connection attempts for pending RPC operation requests. */
+    pendingOperationRetryInterval: number;
+    /** The maximum number of transient faults permitted before request failure. */
+    transientFaultLimit: number;
+    /** @internal */
+    readonly routing: RpcRoutingToken;
+    /** The control channel for the configuration.
+     * @internal
+     */
+    readonly controlChannel: RpcControlChannel;
+    /** @internal */
+    attach<T extends RpcInterface>(definition: RpcInterfaceDefinition<T>): void;
+    /** Initializes the RPC interfaces managed by the configuration. */
+    static initializeInterfaces(configuration: RpcConfiguration): void;
+    /** @internal */
+    static supply(definition: RpcInterface): RpcConfiguration;
+    /** @internal */
+    onRpcClientInitialized(definition: RpcInterfaceDefinition, client: RpcInterface): void;
+    /** @internal */
+    onRpcImplInitialized(definition: RpcInterfaceDefinition, impl: RpcInterface): void;
+    /** @internal */
+    onRpcClientTerminated(definition: RpcInterfaceDefinition, client: RpcInterface): void;
+    /** @internal */
+    onRpcImplTerminated(definition: RpcInterfaceDefinition, impl: RpcInterface): void;
+}
+/** A default configuration that can be used for basic testing within a library.
+ * @internal
+ */
+export declare class RpcDefaultConfiguration extends RpcConfiguration {
+    interfaces: () => never[];
+    protocol: RpcProtocol;
+}
+/** A default protocol that can be used for basic testing within a library.
+ * @internal
+ */
+export declare class RpcDirectProtocol extends RpcProtocol {
+    readonly requestType: typeof RpcDirectRequest;
+}
+/** A default request type that can be used for basic testing within a library.
+ * @internal
+ */
+export declare class RpcDirectRequest extends RpcRequest {
+    headers: Map<string, string>;
+    fulfillment: RpcRequestFulfillment | undefined;
+    protected send(): Promise<number>;
+    protected setHeader(name: string, value: string): void;
+    protected load(): Promise<import("./RpcMarshaling").RpcSerializedValue>;
+}
 //# sourceMappingURL=RpcConfiguration.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"RpcConfiguration.d.ts","sourceRoot":"","sources":["../../../../src/rpc/core/RpcConfiguration.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"RpcConfiguration.d.ts","sourceRoot":"","sources":["../../../../src/rpc/core/RpcConfiguration.ts"],"names":[],"mappings":"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"}