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

package/lib/cjs/rpc/web/WebAppRpcProtocol.d.ts

@@ -1,88 +1,90 @@
-/** @packageDocumentation
- * @module RpcInterface
- */
-/// <reference types="node" />
-import { BackendReadable, BackendWritable } from "../../BackendTypes";
-import { RpcConfiguration } from "../core/RpcConfiguration";
-import { RpcContentType, RpcRequestStatus } from "../core/RpcConstants";
-import { RpcOperation } from "../core/RpcOperation";
-import { RpcProtocol } from "../core/RpcProtocol";
-import { OpenAPIInfo, OpenAPIParameter, RpcOpenAPIDescription } from "./OpenAPI";
-import { WebAppRpcRequest } from "./WebAppRpcRequest";
-/** An HTTP server request object.
- * @public
- */
-export interface HttpServerRequest extends BackendReadable {
-    aborted: boolean;
-    httpVersion: string;
-    httpVersionMajor: number;
-    httpVersionMinor: number;
-    complete: boolean;
-    connection: any;
-    headers: {
-        [header: string]: string | string[] | undefined;
-    };
-    rawHeaders: string[];
-    trailers: {
-        [key: string]: string | undefined;
-    };
-    rawTrailers: string[];
-    setTimeout(msecs: number, callback: () => void): void;
-    setTimeout(msecs: number, callback: () => void): this;
-    url?: string;
-    statusCode?: number;
-    statusMessage?: string;
-    socket: any;
-    destroy(error?: Error): this;
-    body: string | Buffer;
-    path: string;
-    method: string;
-    ip?: string;
-    header: (field: string) => string | undefined;
-}
-/** An HTTP server response object.
- * @public
- */
-export interface HttpServerResponse extends BackendWritable {
-    send(body?: any): HttpServerResponse;
-    status(code: number): HttpServerResponse;
-    set(field: string, value: string): void;
-}
-/** The HTTP application protocol.
- * @internal
- */
-export declare abstract class WebAppRpcProtocol extends RpcProtocol {
-    preserveStreams: boolean;
-    /** Convenience handler for an RPC operation get request for an HTTP server. */
-    handleOperationGetRequest(req: HttpServerRequest, res: HttpServerResponse): Promise<void>;
-    /** Convenience handler for an RPC operation post request for an HTTP server. */
-    handleOperationPostRequest(req: HttpServerRequest, res: HttpServerResponse): Promise<void>;
-    /** Convenience handler for an OpenAPI description request for an HTTP server. */
-    handleOpenApiDescriptionRequest(_req: HttpServerRequest, res: HttpServerResponse): void;
-    /** Converts an HTTP content type value to an RPC content type value. */
-    static computeContentType(httpType: string | null | undefined): RpcContentType;
-    /** The OpenAPI-compatible info object for this protocol. */
-    abstract info: OpenAPIInfo;
-    /** An optional prefix for RPC operation URI paths. */
-    pathPrefix: string;
-    /** The RPC request class for this protocol. */
-    readonly requestType: typeof WebAppRpcRequest;
-    /** Supplies the status corresponding to a protocol-specific code value. */
-    getStatus(code: number): RpcRequestStatus;
-    /** Supplies the protocol-specific code corresponding to a status value. */
-    getCode(status: RpcRequestStatus): number;
-    supportsStatusCategory: boolean;
-    /** Whether an HTTP status code indicates a request timeout. */
-    isTimeout(code: number): boolean;
-    /** An OpenAPI-compatible description of this protocol.
-     * @internal
-     */
-    get openAPIDescription(): RpcOpenAPIDescription;
-    /** Returns the OpenAPI-compatible URI path parameters for an RPC operation.
-     * @internal
-     */
-    abstract supplyPathParametersForOperation(_operation: RpcOperation): OpenAPIParameter[];
-    /** Constructs an HTTP protocol. */
-    constructor(configuration: RpcConfiguration);
-}
+/** @packageDocumentation
+ * @module RpcInterface
+ */
+/// <reference types="node" />
+import { BackendReadable, BackendWritable } from "../../BackendTypes";
+import { RpcConfiguration } from "../core/RpcConfiguration";
+import { RpcContentType, RpcRequestStatus } from "../core/RpcConstants";
+import { RpcOperation } from "../core/RpcOperation";
+import { RpcProtocol } from "../core/RpcProtocol";
+import { OpenAPIInfo, OpenAPIParameter, RpcOpenAPIDescription } from "./OpenAPI";
+import { WebAppRpcRequest } from "./WebAppRpcRequest";
+/** An HTTP server request object.
+ * @public
+ * @deprecated in 3.6. The RPC system will be significantly refactored (or replaced) in version 5.0.
+ */
+export interface HttpServerRequest extends BackendReadable {
+    aborted: boolean;
+    httpVersion: string;
+    httpVersionMajor: number;
+    httpVersionMinor: number;
+    complete: boolean;
+    connection: any;
+    headers: {
+        [header: string]: string | string[] | undefined;
+    };
+    rawHeaders: string[];
+    trailers: {
+        [key: string]: string | undefined;
+    };
+    rawTrailers: string[];
+    setTimeout(msecs: number, callback: () => void): void;
+    setTimeout(msecs: number, callback: () => void): this;
+    url?: string;
+    statusCode?: number;
+    statusMessage?: string;
+    socket: any;
+    destroy(error?: Error): this;
+    body: string | Buffer;
+    path: string;
+    method: string;
+    ip?: string;
+    header: (field: string) => string | undefined;
+}
+/** An HTTP server response object.
+ * @public
+ * @deprecated in 3.6. The RPC system will be significantly refactored (or replaced) in version 5.0.
+ */
+export interface HttpServerResponse extends BackendWritable {
+    send(body?: any): HttpServerResponse;
+    status(code: number): HttpServerResponse;
+    set(field: string, value: string): void;
+}
+/** The HTTP application protocol.
+ * @internal
+ */
+export declare abstract class WebAppRpcProtocol extends RpcProtocol {
+    preserveStreams: boolean;
+    /** Convenience handler for an RPC operation get request for an HTTP server. */
+    handleOperationGetRequest(req: HttpServerRequest, res: HttpServerResponse): Promise<void>;
+    /** Convenience handler for an RPC operation post request for an HTTP server. */
+    handleOperationPostRequest(req: HttpServerRequest, res: HttpServerResponse): Promise<void>;
+    /** Convenience handler for an OpenAPI description request for an HTTP server. */
+    handleOpenApiDescriptionRequest(_req: HttpServerRequest, res: HttpServerResponse): void;
+    /** Converts an HTTP content type value to an RPC content type value. */
+    static computeContentType(httpType: string | null | undefined): RpcContentType;
+    /** The OpenAPI-compatible info object for this protocol. */
+    abstract info: OpenAPIInfo;
+    /** An optional prefix for RPC operation URI paths. */
+    pathPrefix: string;
+    /** The RPC request class for this protocol. */
+    readonly requestType: typeof WebAppRpcRequest;
+    /** Supplies the status corresponding to a protocol-specific code value. */
+    getStatus(code: number): RpcRequestStatus;
+    /** Supplies the protocol-specific code corresponding to a status value. */
+    getCode(status: RpcRequestStatus): number;
+    supportsStatusCategory: boolean;
+    /** Whether an HTTP status code indicates a request timeout. */
+    isTimeout(code: number): boolean;
+    /** An OpenAPI-compatible description of this protocol.
+     * @internal
+     */
+    get openAPIDescription(): RpcOpenAPIDescription;
+    /** Returns the OpenAPI-compatible URI path parameters for an RPC operation.
+     * @internal
+     */
+    abstract supplyPathParametersForOperation(_operation: RpcOperation): OpenAPIParameter[];
+    /** Constructs an HTTP protocol. */
+    constructor(configuration: RpcConfiguration);
+}
 //# sourceMappingURL=WebAppRpcProtocol.d.ts.map

package/lib/cjs/rpc/web/WebAppRpcProtocol.d.ts.map

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

package/lib/cjs/rpc/web/WebAppRpcProtocol.js

@@ -1,117 +1,117 @@
-"use strict";
-/*---------------------------------------------------------------------------------------------
-* 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
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WebAppRpcProtocol = void 0;
-const core_bentley_1 = require("@itwin/core-bentley");
-const CommonLoggerCategory_1 = require("../../CommonLoggerCategory");
-const RpcConstants_1 = require("../core/RpcConstants");
-const RpcProtocol_1 = require("../core/RpcProtocol");
-const OpenAPI_1 = require("./OpenAPI");
-const WebAppRpcLogging_1 = require("./WebAppRpcLogging");
-const WebAppRpcRequest_1 = require("./WebAppRpcRequest");
-/** The HTTP application protocol.
- * @internal
- */
-class WebAppRpcProtocol extends RpcProtocol_1.RpcProtocol {
-    /** Constructs an HTTP protocol. */
-    constructor(configuration) {
-        super(configuration);
-        this.preserveStreams = true;
-        /** An optional prefix for RPC operation URI paths. */
-        this.pathPrefix = "";
-        /** The RPC request class for this protocol. */
-        this.requestType = WebAppRpcRequest_1.WebAppRpcRequest;
-        this.supportsStatusCategory = true;
-        this.events.addListener(WebAppRpcLogging_1.WebAppRpcLogging.logProtocolEvent);
-    }
-    /** Convenience handler for an RPC operation get request for an HTTP server. */
-    async handleOperationGetRequest(req, res) {
-        return this.handleOperationPostRequest(req, res);
-    }
-    /** Convenience handler for an RPC operation post request for an HTTP server. */
-    async handleOperationPostRequest(req, res) {
-        let request;
-        try {
-            request = await WebAppRpcRequest_1.WebAppRpcRequest.parseRequest(this, req);
-        }
-        catch (error) {
-            const message = core_bentley_1.BentleyError.getErrorMessage(error);
-            core_bentley_1.Logger.logError(CommonLoggerCategory_1.CommonLoggerCategory.RpcInterfaceBackend, `Failed to parse request: ${message}`, core_bentley_1.BentleyError.getErrorMetadata(error));
-            res.status(400);
-            res.send(JSON.stringify({ message, isError: true }));
-            return;
-        }
-        const fulfillment = await this.fulfill(request);
-        await WebAppRpcRequest_1.WebAppRpcRequest.sendResponse(this, request, fulfillment, req, res);
-    }
-    /** Convenience handler for an OpenAPI description request for an HTTP server. */
-    handleOpenApiDescriptionRequest(_req, res) {
-        const description = JSON.stringify(this.openAPIDescription);
-        res.send(description);
-    }
-    /** Converts an HTTP content type value to an RPC content type value. */
-    static computeContentType(httpType) {
-        if (!httpType)
-            return RpcConstants_1.RpcContentType.Unknown;
-        if (httpType.indexOf(RpcConstants_1.WEB_RPC_CONSTANTS.ANY_TEXT) === 0) {
-            return RpcConstants_1.RpcContentType.Text;
-        }
-        else if (httpType.indexOf(RpcConstants_1.WEB_RPC_CONSTANTS.BINARY) === 0) {
-            return RpcConstants_1.RpcContentType.Binary;
-        }
-        else if (httpType.indexOf(RpcConstants_1.WEB_RPC_CONSTANTS.MULTIPART) === 0) {
-            return RpcConstants_1.RpcContentType.Multipart;
-        }
-        else {
-            return RpcConstants_1.RpcContentType.Unknown;
-        }
-    }
-    /** Supplies the status corresponding to a protocol-specific code value. */
-    getStatus(code) {
-        switch (code) {
-            case 404: return RpcConstants_1.RpcRequestStatus.NotFound;
-            case 202: return RpcConstants_1.RpcRequestStatus.Pending;
-            case 200: return RpcConstants_1.RpcRequestStatus.Resolved;
-            case 500: return RpcConstants_1.RpcRequestStatus.Rejected;
-            case 204: return RpcConstants_1.RpcRequestStatus.NoContent;
-            case 502: return RpcConstants_1.RpcRequestStatus.BadGateway;
-            case 503: return RpcConstants_1.RpcRequestStatus.ServiceUnavailable;
-            case 504: return RpcConstants_1.RpcRequestStatus.GatewayTimeout;
-            case 408: return RpcConstants_1.RpcRequestStatus.RequestTimeout;
-            case 429: return RpcConstants_1.RpcRequestStatus.TooManyRequests;
-            default: return RpcConstants_1.RpcRequestStatus.Unknown;
-        }
-    }
-    /** Supplies the protocol-specific code corresponding to a status value. */
-    getCode(status) {
-        switch (status) {
-            case RpcConstants_1.RpcRequestStatus.NotFound: return 404;
-            case RpcConstants_1.RpcRequestStatus.Pending: return 202;
-            case RpcConstants_1.RpcRequestStatus.Resolved: return 200;
-            case RpcConstants_1.RpcRequestStatus.Rejected: return 500;
-            case RpcConstants_1.RpcRequestStatus.NoContent: return 204;
-            case RpcConstants_1.RpcRequestStatus.BadGateway: return 502;
-            case RpcConstants_1.RpcRequestStatus.ServiceUnavailable: return 503;
-            case RpcConstants_1.RpcRequestStatus.GatewayTimeout: return 504;
-            case RpcConstants_1.RpcRequestStatus.RequestTimeout: return 408;
-            case RpcConstants_1.RpcRequestStatus.TooManyRequests: return 429;
-            default: return 501;
-        }
-    }
-    /** Whether an HTTP status code indicates a request timeout. */
-    isTimeout(code) {
-        return code === 504;
-    }
-    /** An OpenAPI-compatible description of this protocol.
-     * @internal
-     */
-    get openAPIDescription() { return new OpenAPI_1.RpcOpenAPIDescription(this); }
-}
-exports.WebAppRpcProtocol = WebAppRpcProtocol;
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebAppRpcProtocol = void 0;
+const core_bentley_1 = require("@itwin/core-bentley");
+const CommonLoggerCategory_1 = require("../../CommonLoggerCategory");
+const RpcConstants_1 = require("../core/RpcConstants");
+const RpcProtocol_1 = require("../core/RpcProtocol");
+const OpenAPI_1 = require("./OpenAPI");
+const WebAppRpcLogging_1 = require("./WebAppRpcLogging");
+const WebAppRpcRequest_1 = require("./WebAppRpcRequest");
+/** The HTTP application protocol.
+ * @internal
+ */
+class WebAppRpcProtocol extends RpcProtocol_1.RpcProtocol {
+    /** Constructs an HTTP protocol. */
+    constructor(configuration) {
+        super(configuration);
+        this.preserveStreams = true;
+        /** An optional prefix for RPC operation URI paths. */
+        this.pathPrefix = "";
+        /** The RPC request class for this protocol. */
+        this.requestType = WebAppRpcRequest_1.WebAppRpcRequest;
+        this.supportsStatusCategory = true;
+        this.events.addListener(WebAppRpcLogging_1.WebAppRpcLogging.logProtocolEvent);
+    }
+    /** Convenience handler for an RPC operation get request for an HTTP server. */
+    async handleOperationGetRequest(req, res) {
+        return this.handleOperationPostRequest(req, res);
+    }
+    /** Convenience handler for an RPC operation post request for an HTTP server. */
+    async handleOperationPostRequest(req, res) {
+        let request;
+        try {
+            request = await WebAppRpcRequest_1.WebAppRpcRequest.parseRequest(this, req);
+        }
+        catch (error) {
+            const message = core_bentley_1.BentleyError.getErrorMessage(error);
+            core_bentley_1.Logger.logError(CommonLoggerCategory_1.CommonLoggerCategory.RpcInterfaceBackend, `Failed to parse request: ${message}`, core_bentley_1.BentleyError.getErrorMetadata(error));
+            res.status(400);
+            res.send(JSON.stringify({ message, isError: true }));
+            return;
+        }
+        const fulfillment = await this.fulfill(request);
+        await WebAppRpcRequest_1.WebAppRpcRequest.sendResponse(this, request, fulfillment, req, res);
+    }
+    /** Convenience handler for an OpenAPI description request for an HTTP server. */
+    handleOpenApiDescriptionRequest(_req, res) {
+        const description = JSON.stringify(this.openAPIDescription);
+        res.send(description);
+    }
+    /** Converts an HTTP content type value to an RPC content type value. */
+    static computeContentType(httpType) {
+        if (!httpType)
+            return RpcConstants_1.RpcContentType.Unknown;
+        if (httpType.indexOf(RpcConstants_1.WEB_RPC_CONSTANTS.ANY_TEXT) === 0) {
+            return RpcConstants_1.RpcContentType.Text;
+        }
+        else if (httpType.indexOf(RpcConstants_1.WEB_RPC_CONSTANTS.BINARY) === 0) {
+            return RpcConstants_1.RpcContentType.Binary;
+        }
+        else if (httpType.indexOf(RpcConstants_1.WEB_RPC_CONSTANTS.MULTIPART) === 0) {
+            return RpcConstants_1.RpcContentType.Multipart;
+        }
+        else {
+            return RpcConstants_1.RpcContentType.Unknown;
+        }
+    }
+    /** Supplies the status corresponding to a protocol-specific code value. */
+    getStatus(code) {
+        switch (code) {
+            case 404: return RpcConstants_1.RpcRequestStatus.NotFound;
+            case 202: return RpcConstants_1.RpcRequestStatus.Pending;
+            case 200: return RpcConstants_1.RpcRequestStatus.Resolved;
+            case 500: return RpcConstants_1.RpcRequestStatus.Rejected;
+            case 204: return RpcConstants_1.RpcRequestStatus.NoContent;
+            case 502: return RpcConstants_1.RpcRequestStatus.BadGateway;
+            case 503: return RpcConstants_1.RpcRequestStatus.ServiceUnavailable;
+            case 504: return RpcConstants_1.RpcRequestStatus.GatewayTimeout;
+            case 408: return RpcConstants_1.RpcRequestStatus.RequestTimeout;
+            case 429: return RpcConstants_1.RpcRequestStatus.TooManyRequests;
+            default: return RpcConstants_1.RpcRequestStatus.Unknown;
+        }
+    }
+    /** Supplies the protocol-specific code corresponding to a status value. */
+    getCode(status) {
+        switch (status) {
+            case RpcConstants_1.RpcRequestStatus.NotFound: return 404;
+            case RpcConstants_1.RpcRequestStatus.Pending: return 202;
+            case RpcConstants_1.RpcRequestStatus.Resolved: return 200;
+            case RpcConstants_1.RpcRequestStatus.Rejected: return 500;
+            case RpcConstants_1.RpcRequestStatus.NoContent: return 204;
+            case RpcConstants_1.RpcRequestStatus.BadGateway: return 502;
+            case RpcConstants_1.RpcRequestStatus.ServiceUnavailable: return 503;
+            case RpcConstants_1.RpcRequestStatus.GatewayTimeout: return 504;
+            case RpcConstants_1.RpcRequestStatus.RequestTimeout: return 408;
+            case RpcConstants_1.RpcRequestStatus.TooManyRequests: return 429;
+            default: return 501;
+        }
+    }
+    /** Whether an HTTP status code indicates a request timeout. */
+    isTimeout(code) {
+        return code === 504;
+    }
+    /** An OpenAPI-compatible description of this protocol.
+     * @internal
+     */
+    get openAPIDescription() { return new OpenAPI_1.RpcOpenAPIDescription(this); }
+}
+exports.WebAppRpcProtocol = WebAppRpcProtocol;
 //# sourceMappingURL=WebAppRpcProtocol.js.map

package/lib/cjs/rpc/web/WebAppRpcProtocol.js.map

@@ -1 +1 @@
-{"version":3,"file":"WebAppRpcProtocol.js","sourceRoot":"","sources":["../../../../src/rpc/web/WebAppRpcProtocol.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 { BentleyError, Logger } from \"@itwin/core-bentley\";\r\nimport { CommonLoggerCategory } from \"../../CommonLoggerCategory\";\r\nimport { BackendReadable, BackendWritable } from \"../../BackendTypes\";\r\nimport { RpcConfiguration } from \"../core/RpcConfiguration\";\r\nimport { RpcContentType, RpcRequestStatus, WEB_RPC_CONSTANTS } from \"../core/RpcConstants\";\r\nimport { RpcOperation } from \"../core/RpcOperation\";\r\nimport { RpcProtocol, SerializedRpcRequest } from \"../core/RpcProtocol\";\r\nimport { OpenAPIInfo, OpenAPIParameter, RpcOpenAPIDescription } from \"./OpenAPI\";\r\nimport { WebAppRpcLogging } from \"./WebAppRpcLogging\";\r\nimport { WebAppRpcRequest } from \"./WebAppRpcRequest\";\r\n\r\n/* eslint-disable deprecation/deprecation */\r\n\r\n/** An HTTP server request object.\r\n * @public\r\n */\r\nexport interface HttpServerRequest extends BackendReadable {\r\n  aborted: boolean;\r\n  httpVersion: string;\r\n  httpVersionMajor: number;\r\n  httpVersionMinor: number;\r\n  complete: boolean;\r\n  connection: any;\r\n  headers: { [header: string]: string | string[] | undefined };\r\n  rawHeaders: string[];\r\n  trailers: { [key: string]: string | undefined };\r\n  rawTrailers: string[];\r\n  setTimeout(msecs: number, callback: () => void): void;\r\n  setTimeout(msecs: number, callback: () => void): this;\r\n  url?: string;\r\n  statusCode?: number;\r\n  statusMessage?: string;\r\n  socket: any;\r\n  destroy(error?: Error): this;\r\n  body: string | Buffer;\r\n  path: string;\r\n  method: string;\r\n  ip?: string;\r\n  header: (field: string) => string | undefined;\r\n}\r\n\r\n/** An HTTP server response object.\r\n * @public\r\n */\r\nexport interface HttpServerResponse extends BackendWritable {\r\n  send(body?: any): HttpServerResponse;\r\n  status(code: number): HttpServerResponse;\r\n  set(field: string, value: string): void;\r\n}\r\n\r\n/** The HTTP application protocol.\r\n * @internal\r\n */\r\nexport abstract class WebAppRpcProtocol extends RpcProtocol {\r\n  public override preserveStreams = true;\r\n\r\n  /** Convenience handler for an RPC operation get request for an HTTP server. */\r\n  public async handleOperationGetRequest(req: HttpServerRequest, res: HttpServerResponse) {\r\n    return this.handleOperationPostRequest(req, res);\r\n  }\r\n\r\n  /** Convenience handler for an RPC operation post request for an HTTP server. */\r\n  public async handleOperationPostRequest(req: HttpServerRequest, res: HttpServerResponse) {\r\n    let request: SerializedRpcRequest;\r\n    try {\r\n      request = await WebAppRpcRequest.parseRequest(this, req);\r\n    } catch (error) {\r\n      const message = BentleyError.getErrorMessage(error);\r\n      Logger.logError(CommonLoggerCategory.RpcInterfaceBackend, `Failed to parse request: ${message}`, BentleyError.getErrorMetadata(error));\r\n      res.status(400);\r\n      res.send(JSON.stringify({ message, isError: true }));\r\n      return;\r\n    }\r\n    const fulfillment = await this.fulfill(request);\r\n    await WebAppRpcRequest.sendResponse(this, request, fulfillment, req, res);\r\n  }\r\n\r\n  /** Convenience handler for an OpenAPI description request for an HTTP server. */\r\n  public handleOpenApiDescriptionRequest(_req: HttpServerRequest, res: HttpServerResponse) {\r\n    const description = JSON.stringify(this.openAPIDescription);\r\n    res.send(description);\r\n  }\r\n\r\n  /** Converts an HTTP content type value to an RPC content type value. */\r\n  public static computeContentType(httpType: string | null | undefined): RpcContentType {\r\n    if (!httpType)\r\n      return RpcContentType.Unknown;\r\n\r\n    if (httpType.indexOf(WEB_RPC_CONSTANTS.ANY_TEXT) === 0) {\r\n      return RpcContentType.Text;\r\n    } else if (httpType.indexOf(WEB_RPC_CONSTANTS.BINARY) === 0) {\r\n      return RpcContentType.Binary;\r\n    } else if (httpType.indexOf(WEB_RPC_CONSTANTS.MULTIPART) === 0) {\r\n      return RpcContentType.Multipart;\r\n    } else {\r\n      return RpcContentType.Unknown;\r\n    }\r\n  }\r\n\r\n  /** The OpenAPI-compatible info object for this protocol. */\r\n  public abstract info: OpenAPIInfo;\r\n\r\n  /** An optional prefix for RPC operation URI paths. */\r\n  public pathPrefix: string = \"\";\r\n\r\n  /** The RPC request class for this protocol. */\r\n  public readonly requestType = WebAppRpcRequest;\r\n\r\n  /** Supplies the status corresponding to a protocol-specific code value. */\r\n  public override getStatus(code: number): RpcRequestStatus {\r\n    switch (code) {\r\n      case 404: return RpcRequestStatus.NotFound;\r\n      case 202: return RpcRequestStatus.Pending;\r\n      case 200: return RpcRequestStatus.Resolved;\r\n      case 500: return RpcRequestStatus.Rejected;\r\n      case 204: return RpcRequestStatus.NoContent;\r\n      case 502: return RpcRequestStatus.BadGateway;\r\n      case 503: return RpcRequestStatus.ServiceUnavailable;\r\n      case 504: return RpcRequestStatus.GatewayTimeout;\r\n      case 408: return RpcRequestStatus.RequestTimeout;\r\n      case 429: return RpcRequestStatus.TooManyRequests;\r\n      default: return RpcRequestStatus.Unknown;\r\n    }\r\n  }\r\n\r\n  /** Supplies the protocol-specific code corresponding to a status value. */\r\n  public override getCode(status: RpcRequestStatus): number {\r\n    switch (status) {\r\n      case RpcRequestStatus.NotFound: return 404;\r\n      case RpcRequestStatus.Pending: return 202;\r\n      case RpcRequestStatus.Resolved: return 200;\r\n      case RpcRequestStatus.Rejected: return 500;\r\n      case RpcRequestStatus.NoContent: return 204;\r\n      case RpcRequestStatus.BadGateway: return 502;\r\n      case RpcRequestStatus.ServiceUnavailable: return 503;\r\n      case RpcRequestStatus.GatewayTimeout: return 504;\r\n      case RpcRequestStatus.RequestTimeout: return 408;\r\n      case RpcRequestStatus.TooManyRequests: return 429;\r\n      default: return 501;\r\n    }\r\n  }\r\n\r\n  public override supportsStatusCategory = true;\r\n\r\n  /** Whether an HTTP status code indicates a request timeout. */\r\n  public isTimeout(code: number): boolean {\r\n    return code === 504;\r\n  }\r\n\r\n  /** An OpenAPI-compatible description of this protocol.\r\n   * @internal\r\n   */\r\n  public get openAPIDescription() { return new RpcOpenAPIDescription(this); }\r\n\r\n  /** Returns the OpenAPI-compatible URI path parameters for an RPC operation.\r\n   * @internal\r\n   */\r\n  public abstract supplyPathParametersForOperation(_operation: RpcOperation): OpenAPIParameter[];\r\n\r\n  /** Constructs an HTTP protocol. */\r\n  public constructor(configuration: RpcConfiguration) {\r\n    super(configuration);\r\n    this.events.addListener(WebAppRpcLogging.logProtocolEvent);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"WebAppRpcProtocol.js","sourceRoot":"","sources":["../../../../src/rpc/web/WebAppRpcProtocol.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module RpcInterface\n */\n\nimport { BentleyError, Logger } from \"@itwin/core-bentley\";\nimport { CommonLoggerCategory } from \"../../CommonLoggerCategory\";\nimport { BackendReadable, BackendWritable } from \"../../BackendTypes\";\nimport { RpcConfiguration } from \"../core/RpcConfiguration\";\nimport { RpcContentType, RpcRequestStatus, WEB_RPC_CONSTANTS } from \"../core/RpcConstants\";\nimport { RpcOperation } from \"../core/RpcOperation\";\nimport { RpcProtocol, SerializedRpcRequest } from \"../core/RpcProtocol\";\nimport { OpenAPIInfo, OpenAPIParameter, RpcOpenAPIDescription } from \"./OpenAPI\";\nimport { WebAppRpcLogging } from \"./WebAppRpcLogging\";\nimport { WebAppRpcRequest } from \"./WebAppRpcRequest\";\n\n/* eslint-disable deprecation/deprecation */\n\n/** An HTTP server request object.\n * @public\n * @deprecated in 3.6. The RPC system will be significantly refactored (or replaced) in version 5.0.\n */\nexport interface HttpServerRequest extends BackendReadable {\n  aborted: boolean;\n  httpVersion: string;\n  httpVersionMajor: number;\n  httpVersionMinor: number;\n  complete: boolean;\n  connection: any;\n  headers: { [header: string]: string | string[] | undefined };\n  rawHeaders: string[];\n  trailers: { [key: string]: string | undefined };\n  rawTrailers: string[];\n  setTimeout(msecs: number, callback: () => void): void;\n  setTimeout(msecs: number, callback: () => void): this;\n  url?: string;\n  statusCode?: number;\n  statusMessage?: string;\n  socket: any;\n  destroy(error?: Error): this;\n  body: string | Buffer;\n  path: string;\n  method: string;\n  ip?: string;\n  header: (field: string) => string | undefined;\n}\n\n/** An HTTP server response object.\n * @public\n * @deprecated in 3.6. The RPC system will be significantly refactored (or replaced) in version 5.0.\n */\nexport interface HttpServerResponse extends BackendWritable {\n  send(body?: any): HttpServerResponse;\n  status(code: number): HttpServerResponse;\n  set(field: string, value: string): void;\n}\n\n/** The HTTP application protocol.\n * @internal\n */\nexport abstract class WebAppRpcProtocol extends RpcProtocol {\n  public override preserveStreams = true;\n\n  /** Convenience handler for an RPC operation get request for an HTTP server. */\n  public async handleOperationGetRequest(req: HttpServerRequest, res: HttpServerResponse) {\n    return this.handleOperationPostRequest(req, res);\n  }\n\n  /** Convenience handler for an RPC operation post request for an HTTP server. */\n  public async handleOperationPostRequest(req: HttpServerRequest, res: HttpServerResponse) {\n    let request: SerializedRpcRequest;\n    try {\n      request = await WebAppRpcRequest.parseRequest(this, req);\n    } catch (error) {\n      const message = BentleyError.getErrorMessage(error);\n      Logger.logError(CommonLoggerCategory.RpcInterfaceBackend, `Failed to parse request: ${message}`, BentleyError.getErrorMetadata(error));\n      res.status(400);\n      res.send(JSON.stringify({ message, isError: true }));\n      return;\n    }\n    const fulfillment = await this.fulfill(request);\n    await WebAppRpcRequest.sendResponse(this, request, fulfillment, req, res);\n  }\n\n  /** Convenience handler for an OpenAPI description request for an HTTP server. */\n  public handleOpenApiDescriptionRequest(_req: HttpServerRequest, res: HttpServerResponse) {\n    const description = JSON.stringify(this.openAPIDescription);\n    res.send(description);\n  }\n\n  /** Converts an HTTP content type value to an RPC content type value. */\n  public static computeContentType(httpType: string | null | undefined): RpcContentType {\n    if (!httpType)\n      return RpcContentType.Unknown;\n\n    if (httpType.indexOf(WEB_RPC_CONSTANTS.ANY_TEXT) === 0) {\n      return RpcContentType.Text;\n    } else if (httpType.indexOf(WEB_RPC_CONSTANTS.BINARY) === 0) {\n      return RpcContentType.Binary;\n    } else if (httpType.indexOf(WEB_RPC_CONSTANTS.MULTIPART) === 0) {\n      return RpcContentType.Multipart;\n    } else {\n      return RpcContentType.Unknown;\n    }\n  }\n\n  /** The OpenAPI-compatible info object for this protocol. */\n  public abstract info: OpenAPIInfo;\n\n  /** An optional prefix for RPC operation URI paths. */\n  public pathPrefix: string = \"\";\n\n  /** The RPC request class for this protocol. */\n  public readonly requestType = WebAppRpcRequest;\n\n  /** Supplies the status corresponding to a protocol-specific code value. */\n  public override getStatus(code: number): RpcRequestStatus {\n    switch (code) {\n      case 404: return RpcRequestStatus.NotFound;\n      case 202: return RpcRequestStatus.Pending;\n      case 200: return RpcRequestStatus.Resolved;\n      case 500: return RpcRequestStatus.Rejected;\n      case 204: return RpcRequestStatus.NoContent;\n      case 502: return RpcRequestStatus.BadGateway;\n      case 503: return RpcRequestStatus.ServiceUnavailable;\n      case 504: return RpcRequestStatus.GatewayTimeout;\n      case 408: return RpcRequestStatus.RequestTimeout;\n      case 429: return RpcRequestStatus.TooManyRequests;\n      default: return RpcRequestStatus.Unknown;\n    }\n  }\n\n  /** Supplies the protocol-specific code corresponding to a status value. */\n  public override getCode(status: RpcRequestStatus): number {\n    switch (status) {\n      case RpcRequestStatus.NotFound: return 404;\n      case RpcRequestStatus.Pending: return 202;\n      case RpcRequestStatus.Resolved: return 200;\n      case RpcRequestStatus.Rejected: return 500;\n      case RpcRequestStatus.NoContent: return 204;\n      case RpcRequestStatus.BadGateway: return 502;\n      case RpcRequestStatus.ServiceUnavailable: return 503;\n      case RpcRequestStatus.GatewayTimeout: return 504;\n      case RpcRequestStatus.RequestTimeout: return 408;\n      case RpcRequestStatus.TooManyRequests: return 429;\n      default: return 501;\n    }\n  }\n\n  public override supportsStatusCategory = true;\n\n  /** Whether an HTTP status code indicates a request timeout. */\n  public isTimeout(code: number): boolean {\n    return code === 504;\n  }\n\n  /** An OpenAPI-compatible description of this protocol.\n   * @internal\n   */\n  public get openAPIDescription() { return new RpcOpenAPIDescription(this); }\n\n  /** Returns the OpenAPI-compatible URI path parameters for an RPC operation.\n   * @internal\n   */\n  public abstract supplyPathParametersForOperation(_operation: RpcOperation): OpenAPIParameter[];\n\n  /** Constructs an HTTP protocol. */\n  public constructor(configuration: RpcConfiguration) {\n    super(configuration);\n    this.events.addListener(WebAppRpcLogging.logProtocolEvent);\n  }\n}\n"]}

package/lib/cjs/rpc/web/WebAppRpcRequest.d.ts

@@ -1,68 +1,68 @@
-/** @packageDocumentation
- * @module RpcInterface
- */
-import { RpcInterface } from "../../RpcInterface";
-import { RpcContentType } from "../core/RpcConstants";
-import { RpcSerializedValue } from "../core/RpcMarshaling";
-import { RpcRequestFulfillment, SerializedRpcRequest } from "../core/RpcProtocol";
-import { RpcRequest } from "../core/RpcRequest";
-import { HttpServerRequest, HttpServerResponse, WebAppRpcProtocol } from "./WebAppRpcProtocol";
-/** @internal */
-export declare type HttpMethod_T = "get" | "put" | "post" | "delete" | "options" | "head" | "patch" | "trace";
-/** A web application RPC request.
- * @internal
- */
-export declare class WebAppRpcRequest extends RpcRequest {
-    private _loading;
-    private _request;
-    private _pathSuffix;
-    private get _headers();
-    /** The maximum size permitted for an encoded component in a URL.
-     * Note that some backends limit the total cumulative request size. Our current node backends accept requests with a max size of 16 kb.
-     * In addition to the url size, an authorization header may also add considerably to the request size.
-     * @note This is used for features like encoding the payload of a cacheable request in the URL.
-     */
-    static maxUrlComponentSize: number;
-    /** The HTTP method for this request. */
-    method: HttpMethod_T;
-    /** Convenience access to the protocol of this request. */
-    readonly protocol: WebAppRpcProtocol;
-    /** Standardized access to metadata about the request (useful for purposes such as logging). */
-    metadata: {
-        status: number;
-        message: string;
-    };
-    /** Parses a request. */
-    static parseRequest(protocol: WebAppRpcProtocol, req: HttpServerRequest): Promise<SerializedRpcRequest>;
-    /** Sends the response for a web request. */
-    static sendResponse(protocol: WebAppRpcProtocol, request: SerializedRpcRequest, fulfillment: RpcRequestFulfillment, req: HttpServerRequest, res: HttpServerResponse): Promise<void>;
-    /** Determines the most efficient transport type for an RPC value. */
-    static computeTransportType(value: RpcSerializedValue, source: any): RpcContentType;
-    /** Constructs a web application request. */
-    constructor(client: RpcInterface, operation: string, parameters: any[]);
-    /** Sets request header values. */
-    protected setHeader(name: string, value: string): void;
-    /** Sends the request. */
-    protected send(): Promise<number>;
-    protected computeRetryAfter(attempts: number): number;
-    protected handleUnknownResponse(code: number): void;
-    protected load(): Promise<RpcSerializedValue>;
-    /** Override to supply an alternate fetch function. */
-    protected supplyFetch(): typeof fetch;
-    /** Override to supply an alternate Request function. */
-    protected supplyRequest(): typeof Request;
-    private performFetch;
-    private loadText;
-    private loadBinary;
-    private loadMultipart;
-    private setupTransport;
-    private setupBinaryTransport;
-    private setupMultipartTransport;
-    private setupTextTransport;
-    /** @internal */
-    static backend: {
-        sendResponse: (_protocol: WebAppRpcProtocol, _request: SerializedRpcRequest, _fulfillment: RpcRequestFulfillment, _req: HttpServerRequest, _res: HttpServerResponse) => Promise<void>;
-        parseRequest: (_protocol: WebAppRpcProtocol, _req: HttpServerRequest) => Promise<SerializedRpcRequest>;
-    };
-}
+/** @packageDocumentation
+ * @module RpcInterface
+ */
+import { RpcInterface } from "../../RpcInterface";
+import { RpcContentType } from "../core/RpcConstants";
+import { RpcSerializedValue } from "../core/RpcMarshaling";
+import { RpcRequestFulfillment, SerializedRpcRequest } from "../core/RpcProtocol";
+import { RpcRequest } from "../core/RpcRequest";
+import { HttpServerRequest, HttpServerResponse, WebAppRpcProtocol } from "./WebAppRpcProtocol";
+/** @internal */
+export declare type HttpMethod_T = "get" | "put" | "post" | "delete" | "options" | "head" | "patch" | "trace";
+/** A web application RPC request.
+ * @internal
+ */
+export declare class WebAppRpcRequest extends RpcRequest {
+    private _loading;
+    private _request;
+    private _pathSuffix;
+    private get _headers();
+    /** The maximum size permitted for an encoded component in a URL.
+     * Note that some backends limit the total cumulative request size. Our current node backends accept requests with a max size of 16 kb.
+     * In addition to the url size, an authorization header may also add considerably to the request size.
+     * @note This is used for features like encoding the payload of a cacheable request in the URL.
+     */
+    static maxUrlComponentSize: number;
+    /** The HTTP method for this request. */
+    method: HttpMethod_T;
+    /** Convenience access to the protocol of this request. */
+    readonly protocol: WebAppRpcProtocol;
+    /** Standardized access to metadata about the request (useful for purposes such as logging). */
+    metadata: {
+        status: number;
+        message: string;
+    };
+    /** Parses a request. */
+    static parseRequest(protocol: WebAppRpcProtocol, req: HttpServerRequest): Promise<SerializedRpcRequest>;
+    /** Sends the response for a web request. */
+    static sendResponse(protocol: WebAppRpcProtocol, request: SerializedRpcRequest, fulfillment: RpcRequestFulfillment, req: HttpServerRequest, res: HttpServerResponse): Promise<void>;
+    /** Determines the most efficient transport type for an RPC value. */
+    static computeTransportType(value: RpcSerializedValue, source: any): RpcContentType;
+    /** Constructs a web application request. */
+    constructor(client: RpcInterface, operation: string, parameters: any[]);
+    /** Sets request header values. */
+    protected setHeader(name: string, value: string): void;
+    /** Sends the request. */
+    protected send(): Promise<number>;
+    protected computeRetryAfter(attempts: number): number;
+    protected handleUnknownResponse(code: number): void;
+    protected load(): Promise<RpcSerializedValue>;
+    /** Override to supply an alternate fetch function. */
+    protected supplyFetch(): typeof fetch;
+    /** Override to supply an alternate Request function. */
+    protected supplyRequest(): typeof Request;
+    private performFetch;
+    private loadText;
+    private loadBinary;
+    private loadMultipart;
+    private setupTransport;
+    private setupBinaryTransport;
+    private setupMultipartTransport;
+    private setupTextTransport;
+    /** @internal */
+    static backend: {
+        sendResponse: (_protocol: WebAppRpcProtocol, _request: SerializedRpcRequest, _fulfillment: RpcRequestFulfillment, _req: HttpServerRequest, _res: HttpServerResponse) => Promise<void>;
+        parseRequest: (_protocol: WebAppRpcProtocol, _req: HttpServerRequest) => Promise<SerializedRpcRequest>;
+    };
+}
 //# sourceMappingURL=WebAppRpcRequest.d.ts.map