@jayfong/x-server 1.18.0 → 1.20.1

package/CHANGELOG.md

@@ -2,6 +2,27 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [1.20.1](https://github.com/jfWorks/x-server/compare/v1.20.0...v1.20.1) (2022-04-27)
+
+
+### Bug Fixes
+
+* res == null ? ({} as any) : res ([ea0c531](https://github.com/jfWorks/x-server/commit/ea0c531524636cf9a92e43646fb37bd57b6148d7))
+
+## [1.20.0](https://github.com/jfWorks/x-server/compare/v1.19.0...v1.20.0) (2022-04-27)
+
+
+### Features
+
+* add responseContentType ([dcd9841](https://github.com/jfWorks/x-server/commit/dcd9841e7940d0bc4dfd55faa69deedd1463aee0))
+
+## [1.19.0](https://github.com/jfWorks/x-server/compare/v1.18.0...v1.19.0) (2022-04-27)
+
+
+### Features
+
+* http_header ([b4cc67b](https://github.com/jfWorks/x-server/commit/b4cc67b88f523e9bb0535e9edd2ce6e27d5ff209))
+
 ## [1.18.0](https://github.com/jfWorks/x-server/compare/v1.17.0...v1.18.0) (2022-04-27)
 
 

package/lib/_cjs/core/handler.js

@@ -43,13 +43,18 @@ class Handler {
         }
       }
 
-      let res = await this.options.handle(data, ctx); // 打包返回数据
+      let res = await this.options.handle(data, ctx); // 设置响应的 Content-Type 头
+
+      if (this.options.responseContentType) {
+        ctx.setHeader('Content-Type', this.options.responseContentType);
+      } // 打包返回数据
+
 
       if (this.options.responseDataPack) {
         res = _vtils.DataPacker.packAsRawType(res);
       }
 
-      return res;
+      return res == null ? {} : res;
     };
 
     this.handleWs = async (data, ctx) => {

package/lib/_cjs/core/http_header.js

@@ -0,0 +1,148 @@
+"use strict";
+
+exports.__esModule = true;
+exports.HttpResponseHeader = exports.HttpRequestHeader = void 0;
+// https://en.wikipedia.org/wiki/List_of_HTTP_header_fields
+
+/**
+[...$0.querySelectorAll('tr')].map(v => v.querySelector('td:nth-child(1)').innerText.trim().split(',').map(name => name.replace(/\[.*?\]/g, '').trim()).map((name) => ({
+  name: name,
+  description: v.querySelector('td:nth-child(2)').innerText.replace(/\[.*?\]/g, '').trim(),
+  example:  v.querySelector('td:nth-child(3)').innerText.trim(),
+  pascalName: name.replace(/\-/g, '_').toUpperCase()
+}))).flat().map(item => `
+${'/'}**
+ * ${item.description}
+ *
+ * @example
+ * ${item.example}
+ *${'/'}
+${item.pascalName} = '${item.name}',
+`).join('\n\n')
+*/
+let HttpRequestHeader;
+exports.HttpRequestHeader = HttpRequestHeader;
+
+(function (HttpRequestHeader) {
+  HttpRequestHeader["A_IM"] = "A-IM";
+  HttpRequestHeader["ACCEPT"] = "Accept";
+  HttpRequestHeader["ACCEPT_CHARSET"] = "Accept-Charset";
+  HttpRequestHeader["ACCEPT_DATETIME"] = "Accept-Datetime";
+  HttpRequestHeader["ACCEPT_ENCODING"] = "Accept-Encoding";
+  HttpRequestHeader["ACCEPT_LANGUAGE"] = "Accept-Language";
+  HttpRequestHeader["ACCESS_CONTROL_REQUEST_METHOD"] = "Access-Control-Request-Method";
+  HttpRequestHeader["ACCESS_CONTROL_REQUEST_HEADERS"] = "Access-Control-Request-Headers";
+  HttpRequestHeader["AUTHORIZATION"] = "Authorization";
+  HttpRequestHeader["CACHE_CONTROL"] = "Cache-Control";
+  HttpRequestHeader["CONNECTION"] = "Connection";
+  HttpRequestHeader["CONTENT_ENCODING"] = "Content-Encoding";
+  HttpRequestHeader["CONTENT_LENGTH"] = "Content-Length";
+  HttpRequestHeader["CONTENT_MD5"] = "Content-MD5";
+  HttpRequestHeader["CONTENT_TYPE"] = "Content-Type";
+  HttpRequestHeader["COOKIE"] = "Cookie";
+  HttpRequestHeader["DATE"] = "Date";
+  HttpRequestHeader["EXPECT"] = "Expect";
+  HttpRequestHeader["FORWARDED"] = "Forwarded";
+  HttpRequestHeader["FROM"] = "From";
+  HttpRequestHeader["HOST"] = "Host";
+  HttpRequestHeader["HTTP2_SETTINGS"] = "HTTP2-Settings";
+  HttpRequestHeader["IF_MATCH"] = "If-Match";
+  HttpRequestHeader["IF_MODIFIED_SINCE"] = "If-Modified-Since";
+  HttpRequestHeader["IF_NONE_MATCH"] = "If-None-Match";
+  HttpRequestHeader["IF_RANGE"] = "If-Range";
+  HttpRequestHeader["IF_UNMODIFIED_SINCE"] = "If-Unmodified-Since";
+  HttpRequestHeader["MAX_FORWARDS"] = "Max-Forwards";
+  HttpRequestHeader["ORIGIN"] = "Origin";
+  HttpRequestHeader["PRAGMA"] = "Pragma";
+  HttpRequestHeader["PROXY_AUTHORIZATION"] = "Proxy-Authorization";
+  HttpRequestHeader["RANGE"] = "Range";
+  HttpRequestHeader["REFERER"] = "Referer";
+  HttpRequestHeader["TE"] = "TE";
+  HttpRequestHeader["TRAILER"] = "Trailer";
+  HttpRequestHeader["TRANSFER_ENCODING"] = "Transfer-Encoding";
+  HttpRequestHeader["USER_AGENT"] = "User-Agent";
+  HttpRequestHeader["UPGRADE"] = "Upgrade";
+  HttpRequestHeader["VIA"] = "Via";
+  HttpRequestHeader["WARNING"] = "Warning";
+  HttpRequestHeader["UPGRADE_INSECURE_REQUESTS"] = "Upgrade-Insecure-Requests";
+  HttpRequestHeader["X_REQUESTED_WITH"] = "X-Requested-With";
+  HttpRequestHeader["DNT"] = "DNT";
+  HttpRequestHeader["X_FORWARDED_FOR"] = "X-Forwarded-For";
+  HttpRequestHeader["X_FORWARDED_HOST"] = "X-Forwarded-Host";
+  HttpRequestHeader["X_FORWARDED_PROTO"] = "X-Forwarded-Proto";
+  HttpRequestHeader["FRONT_END_HTTPS"] = "Front-End-Https";
+  HttpRequestHeader["X_HTTP_METHOD_OVERRIDE"] = "X-Http-Method-Override";
+  HttpRequestHeader["X_ATT_DEVICEID"] = "X-ATT-DeviceId";
+  HttpRequestHeader["X_WAP_PROFILE"] = "X-Wap-Profile";
+  HttpRequestHeader["PROXY_CONNECTION"] = "Proxy-Connection";
+  HttpRequestHeader["X_UIDH"] = "X-UIDH";
+  HttpRequestHeader["X_CSRF_TOKEN"] = "X-Csrf-Token";
+  HttpRequestHeader["X_REQUEST_ID"] = "X-Request-ID";
+  HttpRequestHeader["X_CORRELATION_ID"] = "X-Correlation-ID";
+  HttpRequestHeader["SAVE_DATA"] = "Save-Data";
+})(HttpRequestHeader || (exports.HttpRequestHeader = HttpRequestHeader = {}));
+
+let HttpResponseHeader;
+exports.HttpResponseHeader = HttpResponseHeader;
+
+(function (HttpResponseHeader) {
+  HttpResponseHeader["ACCESS_CONTROL_ALLOW_ORIGIN"] = "Access-Control-Allow-Origin";
+  HttpResponseHeader["ACCESS_CONTROL_ALLOW_CREDENTIALS"] = "Access-Control-Allow-Credentials";
+  HttpResponseHeader["ACCESS_CONTROL_EXPOSE_HEADERS"] = "Access-Control-Expose-Headers";
+  HttpResponseHeader["ACCESS_CONTROL_MAX_AGE"] = "Access-Control-Max-Age";
+  HttpResponseHeader["ACCESS_CONTROL_ALLOW_METHODS"] = "Access-Control-Allow-Methods";
+  HttpResponseHeader["ACCESS_CONTROL_ALLOW_HEADERS"] = "Access-Control-Allow-Headers";
+  HttpResponseHeader["ACCEPT_PATCH"] = "Accept-Patch";
+  HttpResponseHeader["ACCEPT_RANGES"] = "Accept-Ranges";
+  HttpResponseHeader["AGE"] = "Age";
+  HttpResponseHeader["ALLOW"] = "Allow";
+  HttpResponseHeader["ALT_SVC"] = "Alt-Svc";
+  HttpResponseHeader["CACHE_CONTROL"] = "Cache-Control";
+  HttpResponseHeader["CONNECTION"] = "Connection";
+  HttpResponseHeader["CONTENT_DISPOSITION"] = "Content-Disposition";
+  HttpResponseHeader["CONTENT_ENCODING"] = "Content-Encoding";
+  HttpResponseHeader["CONTENT_LANGUAGE"] = "Content-Language";
+  HttpResponseHeader["CONTENT_LENGTH"] = "Content-Length";
+  HttpResponseHeader["CONTENT_LOCATION"] = "Content-Location";
+  HttpResponseHeader["CONTENT_MD5"] = "Content-MD5";
+  HttpResponseHeader["CONTENT_RANGE"] = "Content-Range";
+  HttpResponseHeader["CONTENT_TYPE"] = "Content-Type";
+  HttpResponseHeader["DATE"] = "Date";
+  HttpResponseHeader["DELTA_BASE"] = "Delta-Base";
+  HttpResponseHeader["ETAG"] = "ETag";
+  HttpResponseHeader["EXPIRES"] = "Expires";
+  HttpResponseHeader["IM"] = "IM";
+  HttpResponseHeader["LAST_MODIFIED"] = "Last-Modified";
+  HttpResponseHeader["LINK"] = "Link";
+  HttpResponseHeader["LOCATION"] = "Location";
+  HttpResponseHeader["P3P"] = "P3P";
+  HttpResponseHeader["PRAGMA"] = "Pragma";
+  HttpResponseHeader["PROXY_AUTHENTICATE"] = "Proxy-Authenticate";
+  HttpResponseHeader["PUBLIC_KEY_PINS"] = "Public-Key-Pins";
+  HttpResponseHeader["RETRY_AFTER"] = "Retry-After";
+  HttpResponseHeader["SERVER"] = "Server";
+  HttpResponseHeader["SET_COOKIE"] = "Set-Cookie";
+  HttpResponseHeader["STRICT_TRANSPORT_SECURITY"] = "Strict-Transport-Security";
+  HttpResponseHeader["TRAILER"] = "Trailer";
+  HttpResponseHeader["TRANSFER_ENCODING"] = "Transfer-Encoding";
+  HttpResponseHeader["TK"] = "Tk";
+  HttpResponseHeader["UPGRADE"] = "Upgrade";
+  HttpResponseHeader["VARY"] = "Vary";
+  HttpResponseHeader["VIA"] = "Via";
+  HttpResponseHeader["WARNING"] = "Warning";
+  HttpResponseHeader["WWW_AUTHENTICATE"] = "WWW-Authenticate";
+  HttpResponseHeader["X_FRAME_OPTIONS"] = "X-Frame-Options";
+  HttpResponseHeader["CONTENT_SECURITY_POLICY"] = "Content-Security-Policy";
+  HttpResponseHeader["X_CONTENT_SECURITY_POLICY"] = "X-Content-Security-Policy";
+  HttpResponseHeader["X_WEBKIT_CSP"] = "X-WebKit-CSP";
+  HttpResponseHeader["REFRESH"] = "Refresh";
+  HttpResponseHeader["STATUS"] = "Status";
+  HttpResponseHeader["TIMING_ALLOW_ORIGIN"] = "Timing-Allow-Origin";
+  HttpResponseHeader["X_CONTENT_DURATION"] = "X-Content-Duration";
+  HttpResponseHeader["X_CONTENT_TYPE_OPTIONS"] = "X-Content-Type-Options";
+  HttpResponseHeader["X_POWERED_BY"] = "X-Powered-By";
+  HttpResponseHeader["X_REQUEST_ID"] = "X-Request-ID";
+  HttpResponseHeader["X_CORRELATION_ID"] = "X-Correlation-ID";
+  HttpResponseHeader["X_UA_COMPATIBLE"] = "X-UA-Compatible";
+  HttpResponseHeader["X_XSS_PROTECTION"] = "X-XSS-Protection";
+})(HttpResponseHeader || (exports.HttpResponseHeader = HttpResponseHeader = {}));

package/lib/_cjs/core/server.js

@@ -102,7 +102,7 @@ class Server {
             await item.handler.handle(undefined, {
               url: url,
               headers: req.headers,
-              setHeader: res.header,
+              setHeader: (k, v) => res.header(k, v),
               redirect: undefined,
               ws: req
             });
@@ -130,7 +130,7 @@ class Server {
           }, {
             url: url,
             headers: req.headers,
-            setHeader: res.header,
+            setHeader: (k, v) => res.header(k, v),
             redirect: url => res.redirect(url),
             ws: undefined
           });

package/lib/_cjs/index.js

@@ -58,6 +58,14 @@ Object.keys(_http_error).forEach(function (key) {
   exports[key] = _http_error[key];
 });
 
+var _http_header = require("./core/http_header");
+
+Object.keys(_http_header).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _http_header[key]) return;
+  exports[key] = _http_header[key];
+});
+
 var _http_method = require("./core/http_method");
 
 Object.keys(_http_method).forEach(function (key) {

package/lib/core/handler.js

@@ -34,13 +34,18 @@ export class Handler {
         }
       }
 
-      let res = await this.options.handle(data, ctx); // 打包返回数据
+      let res = await this.options.handle(data, ctx); // 设置响应的 Content-Type 头
+
+      if (this.options.responseContentType) {
+        ctx.setHeader('Content-Type', this.options.responseContentType);
+      } // 打包返回数据
+
 
       if (this.options.responseDataPack) {
         res = DataPacker.packAsRawType(res);
       }
 
-      return res;
+      return res == null ? {} : res;
     };
 
     this.handleWs = async (data, ctx) => {

package/lib/core/http_header.d.ts

@@ -0,0 +1,856 @@
+/**
+[...$0.querySelectorAll('tr')].map(v => v.querySelector('td:nth-child(1)').innerText.trim().split(',').map(name => name.replace(/\[.*?\]/g, '').trim()).map((name) => ({
+  name: name,
+  description: v.querySelector('td:nth-child(2)').innerText.replace(/\[.*?\]/g, '').trim(),
+  example:  v.querySelector('td:nth-child(3)').innerText.trim(),
+  pascalName: name.replace(/\-/g, '_').toUpperCase()
+}))).flat().map(item => `
+${'/'}**
+ * ${item.description}
+ *
+ * @example
+ * ${item.example}
+ *${'/'}
+${item.pascalName} = '${item.name}',
+`).join('\n\n')
+*/
+export declare enum HttpRequestHeader {
+    /**
+     * Acceptable instance-manipulations for the request.
+     *
+     * @example
+     * A-IM: feed
+     */
+    A_IM = "A-IM",
+    /**
+     * Media type(s) that is/are acceptable for the response. See Content negotiation.
+     *
+     * @example
+     * Accept: text/html
+     */
+    ACCEPT = "Accept",
+    /**
+     * Character sets that are acceptable.
+     *
+     * @example
+     * Accept-Charset: utf-8
+     */
+    ACCEPT_CHARSET = "Accept-Charset",
+    /**
+     * Acceptable version in time.
+     *
+     * @example
+     * Accept-Datetime: Thu, 31 May 2007 20:35:00 GMT
+     */
+    ACCEPT_DATETIME = "Accept-Datetime",
+    /**
+     * List of acceptable encodings. See HTTP compression.
+     *
+     * @example
+     * Accept-Encoding: gzip, deflate
+     */
+    ACCEPT_ENCODING = "Accept-Encoding",
+    /**
+     * List of acceptable human languages for response. See Content negotiation.
+     *
+     * @example
+     * Accept-Language: en-US
+     */
+    ACCEPT_LANGUAGE = "Accept-Language",
+    /**
+     * Initiates a request for cross-origin resource sharing with Origin (below).
+     *
+     * @example
+     * Access-Control-Request-Method: GET
+     */
+    ACCESS_CONTROL_REQUEST_METHOD = "Access-Control-Request-Method",
+    /**
+     * Initiates a request for cross-origin resource sharing with Origin (below).
+     *
+     * @example
+     * Access-Control-Request-Method: GET
+     */
+    ACCESS_CONTROL_REQUEST_HEADERS = "Access-Control-Request-Headers",
+    /**
+     * Authentication credentials for HTTP authentication.
+     *
+     * @example
+     * Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
+     */
+    AUTHORIZATION = "Authorization",
+    /**
+     * Used to specify directives that must be obeyed by all caching mechanisms along the request-response chain.
+     *
+     * @example
+     * Cache-Control: no-cache
+     */
+    CACHE_CONTROL = "Cache-Control",
+    /**
+   * Control options for the current connection and list of hop-by-hop request fields.
+  Must not be used with HTTP/2.
+   *
+   * @example
+   * Connection: keep-alive
+  Connection: Upgrade
+   */
+    CONNECTION = "Connection",
+    /**
+     * The type of encoding used on the data. See HTTP compression.
+     *
+     * @example
+     * Content-Encoding: gzip
+     */
+    CONTENT_ENCODING = "Content-Encoding",
+    /**
+     * The length of the request body in octets (8-bit bytes).
+     *
+     * @example
+     * Content-Length: 348
+     */
+    CONTENT_LENGTH = "Content-Length",
+    /**
+     * A Base64-encoded binary MD5 sum of the content of the request body.
+     *
+     * @example
+     * Content-MD5: Q2hlY2sgSW50ZWdyaXR5IQ==
+     */
+    CONTENT_MD5 = "Content-MD5",
+    /**
+     * The Media type of the body of the request (used with POST and PUT requests).
+     *
+     * @example
+     * Content-Type: application/x-www-form-urlencoded
+     */
+    CONTENT_TYPE = "Content-Type",
+    /**
+     * An HTTP cookie previously sent by the server with Set-Cookie (below).
+     *
+     * @example
+     * Cookie: $Version=1; Skin=new;
+     */
+    COOKIE = "Cookie",
+    /**
+     * The date and time at which the message was originated (in "HTTP-date" format as defined by RFC 7231 Date/Time Formats).
+     *
+     * @example
+     * Date: Tue, 15 Nov 1994 08:12:31 GMT
+     */
+    DATE = "Date",
+    /**
+     * Indicates that particular server behaviors are required by the client.
+     *
+     * @example
+     * Expect: 100-continue
+     */
+    EXPECT = "Expect",
+    /**
+     * Disclose original information of a client connecting to a web server through an HTTP proxy.
+     *
+     * @example
+     * Forwarded: for=192.0.2.60;proto=http;by=203.0.113.43 Forwarded: for=192.0.2.43, for=198.51.100.17
+     */
+    FORWARDED = "Forwarded",
+    /**
+     * The email address of the user making the request.
+     *
+     * @example
+     * From: user@example.com
+     */
+    FROM = "From",
+    /**
+   * The domain name of the server (for virtual hosting), and the TCP port number on which the server is listening. The port number may be omitted if the port is the standard port for the service requested.
+  Mandatory since HTTP/1.1. If the request is generated directly in HTTP/2, it should not be used.
+   *
+   * @example
+   * Host: en.wikipedia.org:8080
+  Host: en.wikipedia.org
+   */
+    HOST = "Host",
+    /**
+     * A request that upgrades from HTTP/1.1 to HTTP/2 MUST include exactly one HTTP2-Setting header field. The HTTP2-Settings header field is a connection-specific header field that includes parameters that govern the HTTP/2 connection, provided in anticipation of the server accepting the request to upgrade.
+     *
+     * @example
+     * HTTP2-Settings: token64
+     */
+    HTTP2_SETTINGS = "HTTP2-Settings",
+    /**
+     * Only perform the action if the client supplied entity matches the same entity on the server. This is mainly for methods like PUT to only update a resource if it has not been modified since the user last updated it.
+     *
+     * @example
+     * If-Match: "737060cd8c284d8af7ad3082f209582d"
+     */
+    IF_MATCH = "If-Match",
+    /**
+     * Allows a 304 Not Modified to be returned if content is unchanged.
+     *
+     * @example
+     * If-Modified-Since: Sat, 29 Oct 1994 19:43:31 GMT
+     */
+    IF_MODIFIED_SINCE = "If-Modified-Since",
+    /**
+     * Allows a 304 Not Modified to be returned if content is unchanged, see HTTP ETag.
+     *
+     * @example
+     * If-None-Match: "737060cd8c284d8af7ad3082f209582d"
+     */
+    IF_NONE_MATCH = "If-None-Match",
+    /**
+     * If the entity is unchanged, send me the part(s) that I am missing; otherwise, send me the entire new entity.
+     *
+     * @example
+     * If-Range: "737060cd8c284d8af7ad3082f209582d"
+     */
+    IF_RANGE = "If-Range",
+    /**
+     * Only send the response if the entity has not been modified since a specific time.
+     *
+     * @example
+     * If-Unmodified-Since: Sat, 29 Oct 1994 19:43:31 GMT
+     */
+    IF_UNMODIFIED_SINCE = "If-Unmodified-Since",
+    /**
+     * Limit the number of times the message can be forwarded through proxies or gateways.
+     *
+     * @example
+     * Max-Forwards: 10
+     */
+    MAX_FORWARDS = "Max-Forwards",
+    /**
+     * Initiates a request for cross-origin resource sharing (asks server for Access-Control-* response fields).
+     *
+     * @example
+     * Origin: http://www.example-social-network.com
+     */
+    ORIGIN = "Origin",
+    /**
+     * Implementation-specific fields that may have various effects anywhere along the request-response chain.
+     *
+     * @example
+     * Pragma: no-cache
+     */
+    PRAGMA = "Pragma",
+    /**
+     * Authorization credentials for connecting to a proxy.
+     *
+     * @example
+     * Proxy-Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
+     */
+    PROXY_AUTHORIZATION = "Proxy-Authorization",
+    /**
+     * Request only part of an entity. Bytes are numbered from 0. See Byte serving.
+     *
+     * @example
+     * Range: bytes=500-999
+     */
+    RANGE = "Range",
+    /**
+     * This is the address of the previous web page from which a link to the currently requested page was followed. (The word "referrer" has been misspelled in the RFC as well as in most implementations to the point that it has become standard usage and is considered correct terminology)
+     *
+     * @example
+     * Referer: http://en.wikipedia.org/wiki/Main_Page
+     */
+    REFERER = "Referer",
+    /**
+   * The transfer encodings the user agent is willing to accept: the same values as for the response header field Transfer-Encoding can be used, plus the "trailers" value (related to the "chunked" transfer method) to notify the server it expects to receive additional fields in the trailer after the last, zero-sized, chunk.
+  Only trailers is supported in HTTP/2.
+   *
+   * @example
+   * TE: trailers, deflate
+   */
+    TE = "TE",
+    /**
+     * The Trailer general field value indicates that the given set of header fields is present in the trailer of a message encoded with chunked transfer coding.
+     *
+     * @example
+     * Trailer: Max-Forwards
+     */
+    TRAILER = "Trailer",
+    /**
+   * The form of encoding used to safely transfer the entity to the user. Currently defined methods are: chunked, compress, deflate, gzip, identity.
+  Must not be used with HTTP/2.
+   *
+   * @example
+   * Transfer-Encoding: chunked
+   */
+    TRANSFER_ENCODING = "Transfer-Encoding",
+    /**
+     * The user agent string of the user agent.
+     *
+     * @example
+     * User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:12.0) Gecko/20100101 Firefox/12.0
+     */
+    USER_AGENT = "User-Agent",
+    /**
+   * Ask the server to upgrade to another protocol.
+  Must not be used in HTTP/2.
+   *
+   * @example
+   * Upgrade: h2c, HTTPS/1.3, IRC/6.9, RTA/x11, websocket
+   */
+    UPGRADE = "Upgrade",
+    /**
+     * Informs the server of proxies through which the request was sent.
+     *
+     * @example
+     * Via: 1.0 fred, 1.1 example.com (Apache/1.1)
+     */
+    VIA = "Via",
+    /**
+     * A general warning about possible problems with the entity body.
+     *
+     * @example
+     * Warning: 199 Miscellaneous warning
+     */
+    WARNING = "Warning",
+    /**
+   * Tells a server which (presumably in the middle of a HTTP -> HTTPS migration) hosts mixed content that the client would prefer redirection to HTTPS and can handle Content-Security-Policy: upgrade-insecure-requests
+  Must not be used with HTTP/2
+   *
+   * @example
+   * Upgrade-Insecure-Requests: 1
+   */
+    UPGRADE_INSECURE_REQUESTS = "Upgrade-Insecure-Requests",
+    /**
+     * Mainly used to identify Ajax requests (most JavaScript frameworks send this field with value of XMLHttpRequest); also identifies Android apps using WebView
+     *
+     * @example
+     * X-Requested-With: XMLHttpRequest
+     */
+    X_REQUESTED_WITH = "X-Requested-With",
+    /**
+   * Requests a web application to disable their tracking of a user. This is Mozilla's version of the X-Do-Not-Track header field (since Firefox 4.0 Beta 11). Safari and IE9 also have support for this field. On March 7, 2011, a draft proposal was submitted to IETF. The W3C Tracking Protection Working Group is producing a specification.
+   *
+   * @example
+   * DNT: 1 (Do Not Track Enabled)
+  DNT: 0 (Do Not Track Disabled)
+   */
+    DNT = "DNT",
+    /**
+   * A de facto standard for identifying the originating IP address of a client connecting to a web server through an HTTP proxy or load balancer. Superseded by Forwarded header.
+   *
+   * @example
+   * X-Forwarded-For: client1, proxy1, proxy2
+  X-Forwarded-For: 129.78.138.66, 129.78.64.103
+   */
+    X_FORWARDED_FOR = "X-Forwarded-For",
+    /**
+   * A de facto standard for identifying the original host requested by the client in the Host HTTP request header, since the host name and/or port of the reverse proxy (load balancer) may differ from the origin server handling the request. Superseded by Forwarded header.
+   *
+   * @example
+   * X-Forwarded-Host: en.wikipedia.org:8080
+  X-Forwarded-Host: en.wikipedia.org
+   */
+    X_FORWARDED_HOST = "X-Forwarded-Host",
+    /**
+     * A de facto standard for identifying the originating protocol of an HTTP request, since a reverse proxy (or a load balancer) may communicate with a web server using HTTP even if the request to the reverse proxy is HTTPS. An alternative form of the header (X-ProxyUser-Ip) is used by Google clients talking to Google servers. Superseded by Forwarded header.
+     *
+     * @example
+     * X-Forwarded-Proto: https
+     */
+    X_FORWARDED_PROTO = "X-Forwarded-Proto",
+    /**
+     * Non-standard header field used by Microsoft applications and load-balancers
+     *
+     * @example
+     * Front-End-Https: on
+     */
+    FRONT_END_HTTPS = "Front-End-Https",
+    /**
+     * Requests a web application to override the method specified in the request (typically POST) with the method given in the header field (typically PUT or DELETE). This can be used when a user agent or firewall prevents PUT or DELETE methods from being sent directly (note that this is either a bug in the software component, which ought to be fixed, or an intentional configuration, in which case bypassing it may be the wrong thing to do).
+     *
+     * @example
+     * X-HTTP-Method-Override: DELETE
+     */
+    X_HTTP_METHOD_OVERRIDE = "X-Http-Method-Override",
+    /**
+     * Allows easier parsing of the MakeModel/Firmware that is usually found in the User-Agent String of AT&T Devices
+     *
+     * @example
+     * X-Att-Deviceid: GT-P7320/P7320XXLPG
+     */
+    X_ATT_DEVICEID = "X-ATT-DeviceId",
+    /**
+     * Links to an XML file on the Internet with a full description and details about the device currently connecting. In the example to the right is an XML file for an AT&T Samsung Galaxy S2.
+     *
+     * @example
+     * x-wap-profile: http://wap.samsungmobile.com/uaprof/SGH-I777.xml
+     */
+    X_WAP_PROFILE = "X-Wap-Profile",
+    /**
+   * Implemented as a misunderstanding of the HTTP specifications. Common because of mistakes in implementations of early HTTP versions. Has exactly the same functionality as standard Connection field.
+  Must not be used with HTTP/2.
+   *
+   * @example
+   * Proxy-Connection: keep-alive
+   */
+    PROXY_CONNECTION = "Proxy-Connection",
+    /**
+     * Server-side deep packet insertion of a unique ID identifying customers of Verizon Wireless; also known as "perma-cookie" or "supercookie"
+     *
+     * @example
+     * X-UIDH: ...
+     */
+    X_UIDH = "X-UIDH",
+    /**
+     * Used to prevent cross-site request forgery. Alternative header names are: X-CSRFToken and X-XSRF-TOKEN
+     *
+     * @example
+     * X-Csrf-Token: i8XNjC4b8KVok4uw5RftR38Wgp2BFwql
+     */
+    X_CSRF_TOKEN = "X-Csrf-Token",
+    /**
+     * Correlates HTTP requests between a client and server.
+     *
+     * @example
+     * X-Request-ID: f058ebd6-02f7-4d3f-942e-904344e8cde5
+     */
+    X_REQUEST_ID = "X-Request-ID",
+    /**
+     * Correlates HTTP requests between a client and server.
+     *
+     * @example
+     * X-Request-ID: f058ebd6-02f7-4d3f-942e-904344e8cde5
+     */
+    X_CORRELATION_ID = "X-Correlation-ID",
+    /**
+     * The Save-Data client hint request header available in Chrome, Opera, and Yandex browsers lets developers deliver lighter, faster applications to users who opt-in to data saving mode in their browser.
+     *
+     * @example
+     * Save-Data: on
+     */
+    SAVE_DATA = "Save-Data"
+}
+export declare enum HttpResponseHeader {
+    /**
+     * Specifying which web sites can participate in cross-origin resource sharing
+     *
+     * @example
+     * Access-Control-Allow-Origin: *
+     */
+    ACCESS_CONTROL_ALLOW_ORIGIN = "Access-Control-Allow-Origin",
+    /**
+     * Specifying which web sites can participate in cross-origin resource sharing
+     *
+     * @example
+     * Access-Control-Allow-Origin: *
+     */
+    ACCESS_CONTROL_ALLOW_CREDENTIALS = "Access-Control-Allow-Credentials",
+    /**
+     * Specifying which web sites can participate in cross-origin resource sharing
+     *
+     * @example
+     * Access-Control-Allow-Origin: *
+     */
+    ACCESS_CONTROL_EXPOSE_HEADERS = "Access-Control-Expose-Headers",
+    /**
+     * Specifying which web sites can participate in cross-origin resource sharing
+     *
+     * @example
+     * Access-Control-Allow-Origin: *
+     */
+    ACCESS_CONTROL_MAX_AGE = "Access-Control-Max-Age",
+    /**
+     * Specifying which web sites can participate in cross-origin resource sharing
+     *
+     * @example
+     * Access-Control-Allow-Origin: *
+     */
+    ACCESS_CONTROL_ALLOW_METHODS = "Access-Control-Allow-Methods",
+    /**
+     * Specifying which web sites can participate in cross-origin resource sharing
+     *
+     * @example
+     * Access-Control-Allow-Origin: *
+     */
+    ACCESS_CONTROL_ALLOW_HEADERS = "Access-Control-Allow-Headers",
+    /**
+     * Specifies which patch document formats this server supports
+     *
+     * @example
+     * Accept-Patch: text/example;charset=utf-8
+     */
+    ACCEPT_PATCH = "Accept-Patch",
+    /**
+     * What partial content range types this server supports via byte serving
+     *
+     * @example
+     * Accept-Ranges: bytes
+     */
+    ACCEPT_RANGES = "Accept-Ranges",
+    /**
+     * The age the object has been in a proxy cache in seconds
+     *
+     * @example
+     * Age: 12
+     */
+    AGE = "Age",
+    /**
+     * Valid methods for a specified resource. To be used for a 405 Method not allowed
+     *
+     * @example
+     * Allow: GET, HEAD
+     */
+    ALLOW = "Allow",
+    /**
+   * A server uses "Alt-Svc" header (meaning Alternative Services) to indicate that its resources can also be accessed at a different network location (host or port) or using a different protocol
+  When using HTTP/2, servers should instead send an ALTSVC frame.
+   *
+   * @example
+   * Alt-Svc: http/1.1="http2.example.com:8001"; ma=7200
+   */
+    ALT_SVC = "Alt-Svc",
+    /**
+     * Tells all caching mechanisms from server to client whether they may cache this object. It is measured in seconds
+     *
+     * @example
+     * Cache-Control: max-age=3600
+     */
+    CACHE_CONTROL = "Cache-Control",
+    /**
+   * Control options for the current connection and list of hop-by-hop response fields.
+  Must not be used with HTTP/2.
+   *
+   * @example
+   * Connection: close
+   */
+    CONNECTION = "Connection",
+    /**
+     * An opportunity to raise a "File Download" dialogue box for a known MIME type with binary format or suggest a filename for dynamic content. Quotes are necessary with special characters.
+     *
+     * @example
+     * Content-Disposition: attachment; filename="fname.ext"
+     */
+    CONTENT_DISPOSITION = "Content-Disposition",
+    /**
+     * The type of encoding used on the data. See HTTP compression.
+     *
+     * @example
+     * Content-Encoding: gzip
+     */
+    CONTENT_ENCODING = "Content-Encoding",
+    /**
+     * The natural language or languages of the intended audience for the enclosed content
+     *
+     * @example
+     * Content-Language: da
+     */
+    CONTENT_LANGUAGE = "Content-Language",
+    /**
+     * The length of the response body in octets (8-bit bytes)
+     *
+     * @example
+     * Content-Length: 348
+     */
+    CONTENT_LENGTH = "Content-Length",
+    /**
+     * An alternate location for the returned data
+     *
+     * @example
+     * Content-Location: /index.htm
+     */
+    CONTENT_LOCATION = "Content-Location",
+    /**
+     * A Base64-encoded binary MD5 sum of the content of the response
+     *
+     * @example
+     * Content-MD5: Q2hlY2sgSW50ZWdyaXR5IQ==
+     */
+    CONTENT_MD5 = "Content-MD5",
+    /**
+     * Where in a full body message this partial message belongs
+     *
+     * @example
+     * Content-Range: bytes 21010-47021/47022
+     */
+    CONTENT_RANGE = "Content-Range",
+    /**
+     * The MIME type of this content
+     *
+     * @example
+     * Content-Type: text/html; charset=utf-8
+     */
+    CONTENT_TYPE = "Content-Type",
+    /**
+     * The date and time that the message was sent (in "HTTP-date" format as defined by RFC 7231)
+     *
+     * @example
+     * Date: Tue, 15 Nov 1994 08:12:31 GMT
+     */
+    DATE = "Date",
+    /**
+     * Specifies the delta-encoding entity tag of the response.
+     *
+     * @example
+     * Delta-Base: "abc"
+     */
+    DELTA_BASE = "Delta-Base",
+    /**
+     * An identifier for a specific version of a resource, often a message digest
+     *
+     * @example
+     * ETag: "737060cd8c284d8af7ad3082f209582d"
+     */
+    ETAG = "ETag",
+    /**
+     * Gives the date/time after which the response is considered stale (in "HTTP-date" format as defined by RFC 7231)
+     *
+     * @example
+     * Expires: Thu, 01 Dec 1994 16:00:00 GMT
+     */
+    EXPIRES = "Expires",
+    /**
+     * Instance-manipulations applied to the response.
+     *
+     * @example
+     * IM: feed
+     */
+    IM = "IM",
+    /**
+     * The last modified date for the requested object (in "HTTP-date" format as defined by RFC 7231)
+     *
+     * @example
+     * Last-Modified: Tue, 15 Nov 1994 12:45:26 GMT
+     */
+    LAST_MODIFIED = "Last-Modified",
+    /**
+     * Used to express a typed relationship with another resource, where the relation type is defined by RFC 5988
+     *
+     * @example
+     * Link: </feed>; rel="alternate"[50]
+     */
+    LINK = "Link",
+    /**
+   * Used in redirection, or when a new resource has been created.
+   *
+   * @example
+   * Example 1: Location: http://www.w3.org/pub/WWW/People.html
+  Example 2: Location: /pub/WWW/People.html
+   */
+    LOCATION = "Location",
+    /**
+     * This field is supposed to set P3P policy, in the form of P3P:CP="your_compact_policy". However, P3P did not take off, most browsers have never fully implemented it, a lot of websites set this field with fake policy text, that was enough to fool browsers the existence of P3P policy and grant permissions for third party cookies.
+     *
+     * @example
+     * P3P: CP="This is not a P3P policy! See https://en.wikipedia.org/wiki/Special:CentralAutoLogin/P3P for more info."
+     */
+    P3P = "P3P",
+    /**
+     * Implementation-specific fields that may have various effects anywhere along the request-response chain.
+     *
+     * @example
+     * Pragma: no-cache
+     */
+    PRAGMA = "Pragma",
+    /**
+     * Request authentication to access the proxy.
+     *
+     * @example
+     * Proxy-Authenticate: Basic
+     */
+    PROXY_AUTHENTICATE = "Proxy-Authenticate",
+    /**
+     * HTTP Public Key Pinning, announces hash of website's authentic TLS certificate
+     *
+     * @example
+     * Public-Key-Pins: max-age=2592000; pin-sha256="E9CZ9INDbd+2eRQozYqqbQ2yXLVKB9+xcprMF+44U1g=";
+     */
+    PUBLIC_KEY_PINS = "Public-Key-Pins",
+    /**
+   * If an entity is temporarily unavailable, this instructs the client to try again later. Value could be a specified period of time (in seconds) or a HTTP-date.
+   *
+   * @example
+   * Example 1: Retry-After: 120
+  Example 2: Retry-After: Fri, 07 Nov 2014 23:59:59 GMT
+   */
+    RETRY_AFTER = "Retry-After",
+    /**
+     * A name for the server
+     *
+     * @example
+     * Server: Apache/2.4.1 (Unix)
+     */
+    SERVER = "Server",
+    /**
+     * An HTTP cookie
+     *
+     * @example
+     * Set-Cookie: UserID=JohnDoe; Max-Age=3600; Version=1
+     */
+    SET_COOKIE = "Set-Cookie",
+    /**
+     * A HSTS Policy informing the HTTP client how long to cache the HTTPS only policy and whether this applies to subdomains.
+     *
+     * @example
+     * Strict-Transport-Security: max-age=16070400; includeSubDomains
+     */
+    STRICT_TRANSPORT_SECURITY = "Strict-Transport-Security",
+    /**
+     * The Trailer general field value indicates that the given set of header fields is present in the trailer of a message encoded with chunked transfer coding.
+     *
+     * @example
+     * Trailer: Max-Forwards
+     */
+    TRAILER = "Trailer",
+    /**
+   * The form of encoding used to safely transfer the entity to the user. Currently defined methods are: chunked, compress, deflate, gzip, identity.
+  Must not be used with HTTP/2.
+   *
+   * @example
+   * Transfer-Encoding: chunked
+   */
+    TRANSFER_ENCODING = "Transfer-Encoding",
+    /**
+   * Tracking Status header, value suggested to be sent in response to a DNT(do-not-track), possible values:
+  "!" — under construction
+  "?" — dynamic
+  "G" — gateway to multiple parties
+  "N" — not tracking
+  "T" — tracking
+  "C" — tracking with consent
+  "P" — tracking only if consented
+  "D" — disregarding DNT
+  "U" — updated
+   *
+   * @example
+   * Tk: ?
+   */
+    TK = "Tk",
+    /**
+   * Ask the client to upgrade to another protocol.
+  Must not be used in HTTP/2
+   *
+   * @example
+   * Upgrade: h2c, HTTPS/1.3, IRC/6.9, RTA/x11, websocket
+   */
+    UPGRADE = "Upgrade",
+    /**
+   * Tells downstream proxies how to match future request headers to decide whether the cached response can be used rather than requesting a fresh one from the origin server.
+   *
+   * @example
+   * Example 1: Vary: *
+  Example 2: Vary: Accept-Language
+   */
+    VARY = "Vary",
+    /**
+     * Informs the client of proxies through which the response was sent.
+     *
+     * @example
+     * Via: 1.0 fred, 1.1 example.com (Apache/1.1)
+     */
+    VIA = "Via",
+    /**
+     * A general warning about possible problems with the entity body.
+     *
+     * @example
+     * Warning: 199 Miscellaneous warning
+     */
+    WARNING = "Warning",
+    /**
+     * Indicates the authentication scheme that should be used to access the requested entity.
+     *
+     * @example
+     * WWW-Authenticate: Basic
+     */
+    WWW_AUTHENTICATE = "WWW-Authenticate",
+    /**
+     * Clickjacking protection: deny - no rendering within a frame, sameorigin - no rendering if origin mismatch, allow-from - allow from specified location, allowall - non-standard, allow from any location
+     *
+     * @example
+     * X-Frame-Options: deny
+     */
+    X_FRAME_OPTIONS = "X-Frame-Options",
+    /**
+     * Content Security Policy definition.
+     *
+     * @example
+     * X-WebKit-CSP: default-src 'self'
+     */
+    CONTENT_SECURITY_POLICY = "Content-Security-Policy",
+    /**
+     * Content Security Policy definition.
+     *
+     * @example
+     * X-WebKit-CSP: default-src 'self'
+     */
+    X_CONTENT_SECURITY_POLICY = "X-Content-Security-Policy",
+    /**
+     * Content Security Policy definition.
+     *
+     * @example
+     * X-WebKit-CSP: default-src 'self'
+     */
+    X_WEBKIT_CSP = "X-WebKit-CSP",
+    /**
+     * Used in redirection, or when a new resource has been created. This refresh redirects after 5 seconds. Header extension introduced by Netscape and supported by most web browsers.
+     *
+     * @example
+     * Refresh: 5; url=http://www.w3.org/pub/WWW/People.html
+     */
+    REFRESH = "Refresh",
+    /**
+     * CGI header field specifying the status of the HTTP response. Normal HTTP responses use a separate "Status-Line" instead, defined by RFC 7230.
+     *
+     * @example
+     * Status: 200 OK
+     */
+    STATUS = "Status",
+    /**
+   * The Timing-Allow-Origin response header specifies origins that are allowed to see values of attributes retrieved via features of the Resource Timing API, which would otherwise be reported as zero due to cross-origin restrictions.
+   *
+   * @example
+   * Timing-Allow-Origin: *
+  Timing-Allow-Origin: <origin>[, <origin>]*
+   */
+    TIMING_ALLOW_ORIGIN = "Timing-Allow-Origin",
+    /**
+     * Provide the duration of the audio or video in seconds; only supported by Gecko browsers
+     *
+     * @example
+     * X-Content-Duration: 42.666
+     */
+    X_CONTENT_DURATION = "X-Content-Duration",
+    /**
+     * The only defined value, "nosniff", prevents Internet Explorer from MIME-sniffing a response away from the declared content-type. This also applies to Google Chrome, when downloading extensions.
+     *
+     * @example
+     * X-Content-Type-Options: nosniff[62]
+     */
+    X_CONTENT_TYPE_OPTIONS = "X-Content-Type-Options",
+    /**
+     * Specifies the technology (e.g. ASP.NET, PHP, JBoss) supporting the web application (version details are often in X-Runtime, X-Version, or X-AspNet-Version)
+     *
+     * @example
+     * X-Powered-By: PHP/5.4.0
+     */
+    X_POWERED_BY = "X-Powered-By",
+    /**
+     * Correlates HTTP requests between a client and server.
+     *
+     * @example
+     * X-Request-ID: f058ebd6-02f7-4d3f-942e-904344e8cde5
+     */
+    X_REQUEST_ID = "X-Request-ID",
+    /**
+     * Correlates HTTP requests between a client and server.
+     *
+     * @example
+     * X-Request-ID: f058ebd6-02f7-4d3f-942e-904344e8cde5
+     */
+    X_CORRELATION_ID = "X-Correlation-ID",
+    /**
+   * Recommends the preferred rendering engine (often a backward-compatibility mode) to use to display the content. Also used to activate Chrome Frame in Internet Explorer.
+   *
+   * @example
+   * X-UA-Compatible: IE=EmulateIE7
+  X-UA-Compatible: IE=edge
+  X-UA-Compatible: Chrome=1
+   */
+    X_UA_COMPATIBLE = "X-UA-Compatible",
+    /**
+     * Cross-site scripting (XSS) filter
+     *
+     * @example
+     * X-XSS-Protection: 1; mode=block
+     */
+    X_XSS_PROTECTION = "X-XSS-Protection"
+}

package/lib/core/http_header.js

@@ -0,0 +1,142 @@
+// https://en.wikipedia.org/wiki/List_of_HTTP_header_fields
+
+/**
+[...$0.querySelectorAll('tr')].map(v => v.querySelector('td:nth-child(1)').innerText.trim().split(',').map(name => name.replace(/\[.*?\]/g, '').trim()).map((name) => ({
+  name: name,
+  description: v.querySelector('td:nth-child(2)').innerText.replace(/\[.*?\]/g, '').trim(),
+  example:  v.querySelector('td:nth-child(3)').innerText.trim(),
+  pascalName: name.replace(/\-/g, '_').toUpperCase()
+}))).flat().map(item => `
+${'/'}**
+ * ${item.description}
+ *
+ * @example
+ * ${item.example}
+ *${'/'}
+${item.pascalName} = '${item.name}',
+`).join('\n\n')
+*/
+export let HttpRequestHeader;
+
+(function (HttpRequestHeader) {
+  HttpRequestHeader["A_IM"] = "A-IM";
+  HttpRequestHeader["ACCEPT"] = "Accept";
+  HttpRequestHeader["ACCEPT_CHARSET"] = "Accept-Charset";
+  HttpRequestHeader["ACCEPT_DATETIME"] = "Accept-Datetime";
+  HttpRequestHeader["ACCEPT_ENCODING"] = "Accept-Encoding";
+  HttpRequestHeader["ACCEPT_LANGUAGE"] = "Accept-Language";
+  HttpRequestHeader["ACCESS_CONTROL_REQUEST_METHOD"] = "Access-Control-Request-Method";
+  HttpRequestHeader["ACCESS_CONTROL_REQUEST_HEADERS"] = "Access-Control-Request-Headers";
+  HttpRequestHeader["AUTHORIZATION"] = "Authorization";
+  HttpRequestHeader["CACHE_CONTROL"] = "Cache-Control";
+  HttpRequestHeader["CONNECTION"] = "Connection";
+  HttpRequestHeader["CONTENT_ENCODING"] = "Content-Encoding";
+  HttpRequestHeader["CONTENT_LENGTH"] = "Content-Length";
+  HttpRequestHeader["CONTENT_MD5"] = "Content-MD5";
+  HttpRequestHeader["CONTENT_TYPE"] = "Content-Type";
+  HttpRequestHeader["COOKIE"] = "Cookie";
+  HttpRequestHeader["DATE"] = "Date";
+  HttpRequestHeader["EXPECT"] = "Expect";
+  HttpRequestHeader["FORWARDED"] = "Forwarded";
+  HttpRequestHeader["FROM"] = "From";
+  HttpRequestHeader["HOST"] = "Host";
+  HttpRequestHeader["HTTP2_SETTINGS"] = "HTTP2-Settings";
+  HttpRequestHeader["IF_MATCH"] = "If-Match";
+  HttpRequestHeader["IF_MODIFIED_SINCE"] = "If-Modified-Since";
+  HttpRequestHeader["IF_NONE_MATCH"] = "If-None-Match";
+  HttpRequestHeader["IF_RANGE"] = "If-Range";
+  HttpRequestHeader["IF_UNMODIFIED_SINCE"] = "If-Unmodified-Since";
+  HttpRequestHeader["MAX_FORWARDS"] = "Max-Forwards";
+  HttpRequestHeader["ORIGIN"] = "Origin";
+  HttpRequestHeader["PRAGMA"] = "Pragma";
+  HttpRequestHeader["PROXY_AUTHORIZATION"] = "Proxy-Authorization";
+  HttpRequestHeader["RANGE"] = "Range";
+  HttpRequestHeader["REFERER"] = "Referer";
+  HttpRequestHeader["TE"] = "TE";
+  HttpRequestHeader["TRAILER"] = "Trailer";
+  HttpRequestHeader["TRANSFER_ENCODING"] = "Transfer-Encoding";
+  HttpRequestHeader["USER_AGENT"] = "User-Agent";
+  HttpRequestHeader["UPGRADE"] = "Upgrade";
+  HttpRequestHeader["VIA"] = "Via";
+  HttpRequestHeader["WARNING"] = "Warning";
+  HttpRequestHeader["UPGRADE_INSECURE_REQUESTS"] = "Upgrade-Insecure-Requests";
+  HttpRequestHeader["X_REQUESTED_WITH"] = "X-Requested-With";
+  HttpRequestHeader["DNT"] = "DNT";
+  HttpRequestHeader["X_FORWARDED_FOR"] = "X-Forwarded-For";
+  HttpRequestHeader["X_FORWARDED_HOST"] = "X-Forwarded-Host";
+  HttpRequestHeader["X_FORWARDED_PROTO"] = "X-Forwarded-Proto";
+  HttpRequestHeader["FRONT_END_HTTPS"] = "Front-End-Https";
+  HttpRequestHeader["X_HTTP_METHOD_OVERRIDE"] = "X-Http-Method-Override";
+  HttpRequestHeader["X_ATT_DEVICEID"] = "X-ATT-DeviceId";
+  HttpRequestHeader["X_WAP_PROFILE"] = "X-Wap-Profile";
+  HttpRequestHeader["PROXY_CONNECTION"] = "Proxy-Connection";
+  HttpRequestHeader["X_UIDH"] = "X-UIDH";
+  HttpRequestHeader["X_CSRF_TOKEN"] = "X-Csrf-Token";
+  HttpRequestHeader["X_REQUEST_ID"] = "X-Request-ID";
+  HttpRequestHeader["X_CORRELATION_ID"] = "X-Correlation-ID";
+  HttpRequestHeader["SAVE_DATA"] = "Save-Data";
+})(HttpRequestHeader || (HttpRequestHeader = {}));
+
+export let HttpResponseHeader;
+
+(function (HttpResponseHeader) {
+  HttpResponseHeader["ACCESS_CONTROL_ALLOW_ORIGIN"] = "Access-Control-Allow-Origin";
+  HttpResponseHeader["ACCESS_CONTROL_ALLOW_CREDENTIALS"] = "Access-Control-Allow-Credentials";
+  HttpResponseHeader["ACCESS_CONTROL_EXPOSE_HEADERS"] = "Access-Control-Expose-Headers";
+  HttpResponseHeader["ACCESS_CONTROL_MAX_AGE"] = "Access-Control-Max-Age";
+  HttpResponseHeader["ACCESS_CONTROL_ALLOW_METHODS"] = "Access-Control-Allow-Methods";
+  HttpResponseHeader["ACCESS_CONTROL_ALLOW_HEADERS"] = "Access-Control-Allow-Headers";
+  HttpResponseHeader["ACCEPT_PATCH"] = "Accept-Patch";
+  HttpResponseHeader["ACCEPT_RANGES"] = "Accept-Ranges";
+  HttpResponseHeader["AGE"] = "Age";
+  HttpResponseHeader["ALLOW"] = "Allow";
+  HttpResponseHeader["ALT_SVC"] = "Alt-Svc";
+  HttpResponseHeader["CACHE_CONTROL"] = "Cache-Control";
+  HttpResponseHeader["CONNECTION"] = "Connection";
+  HttpResponseHeader["CONTENT_DISPOSITION"] = "Content-Disposition";
+  HttpResponseHeader["CONTENT_ENCODING"] = "Content-Encoding";
+  HttpResponseHeader["CONTENT_LANGUAGE"] = "Content-Language";
+  HttpResponseHeader["CONTENT_LENGTH"] = "Content-Length";
+  HttpResponseHeader["CONTENT_LOCATION"] = "Content-Location";
+  HttpResponseHeader["CONTENT_MD5"] = "Content-MD5";
+  HttpResponseHeader["CONTENT_RANGE"] = "Content-Range";
+  HttpResponseHeader["CONTENT_TYPE"] = "Content-Type";
+  HttpResponseHeader["DATE"] = "Date";
+  HttpResponseHeader["DELTA_BASE"] = "Delta-Base";
+  HttpResponseHeader["ETAG"] = "ETag";
+  HttpResponseHeader["EXPIRES"] = "Expires";
+  HttpResponseHeader["IM"] = "IM";
+  HttpResponseHeader["LAST_MODIFIED"] = "Last-Modified";
+  HttpResponseHeader["LINK"] = "Link";
+  HttpResponseHeader["LOCATION"] = "Location";
+  HttpResponseHeader["P3P"] = "P3P";
+  HttpResponseHeader["PRAGMA"] = "Pragma";
+  HttpResponseHeader["PROXY_AUTHENTICATE"] = "Proxy-Authenticate";
+  HttpResponseHeader["PUBLIC_KEY_PINS"] = "Public-Key-Pins";
+  HttpResponseHeader["RETRY_AFTER"] = "Retry-After";
+  HttpResponseHeader["SERVER"] = "Server";
+  HttpResponseHeader["SET_COOKIE"] = "Set-Cookie";
+  HttpResponseHeader["STRICT_TRANSPORT_SECURITY"] = "Strict-Transport-Security";
+  HttpResponseHeader["TRAILER"] = "Trailer";
+  HttpResponseHeader["TRANSFER_ENCODING"] = "Transfer-Encoding";
+  HttpResponseHeader["TK"] = "Tk";
+  HttpResponseHeader["UPGRADE"] = "Upgrade";
+  HttpResponseHeader["VARY"] = "Vary";
+  HttpResponseHeader["VIA"] = "Via";
+  HttpResponseHeader["WARNING"] = "Warning";
+  HttpResponseHeader["WWW_AUTHENTICATE"] = "WWW-Authenticate";
+  HttpResponseHeader["X_FRAME_OPTIONS"] = "X-Frame-Options";
+  HttpResponseHeader["CONTENT_SECURITY_POLICY"] = "Content-Security-Policy";
+  HttpResponseHeader["X_CONTENT_SECURITY_POLICY"] = "X-Content-Security-Policy";
+  HttpResponseHeader["X_WEBKIT_CSP"] = "X-WebKit-CSP";
+  HttpResponseHeader["REFRESH"] = "Refresh";
+  HttpResponseHeader["STATUS"] = "Status";
+  HttpResponseHeader["TIMING_ALLOW_ORIGIN"] = "Timing-Allow-Origin";
+  HttpResponseHeader["X_CONTENT_DURATION"] = "X-Content-Duration";
+  HttpResponseHeader["X_CONTENT_TYPE_OPTIONS"] = "X-Content-Type-Options";
+  HttpResponseHeader["X_POWERED_BY"] = "X-Powered-By";
+  HttpResponseHeader["X_REQUEST_ID"] = "X-Request-ID";
+  HttpResponseHeader["X_CORRELATION_ID"] = "X-Correlation-ID";
+  HttpResponseHeader["X_UA_COMPATIBLE"] = "X-UA-Compatible";
+  HttpResponseHeader["X_XSS_PROTECTION"] = "X-XSS-Protection";
+})(HttpResponseHeader || (HttpResponseHeader = {}));

package/lib/core/server.js

@@ -87,7 +87,7 @@ export class Server {
             await item.handler.handle(undefined, {
               url: url,
               headers: req.headers,
-              setHeader: res.header,
+              setHeader: (k, v) => res.header(k, v),
               redirect: undefined,
               ws: req
             });
@@ -115,7 +115,7 @@ export class Server {
           }, {
             url: url,
             headers: req.headers,
-            setHeader: res.header,
+            setHeader: (k, v) => res.header(k, v),
             redirect: url => res.redirect(url),
             ws: undefined
           });

package/lib/core/types.d.ts

@@ -2,7 +2,7 @@
 import { BasePlugin } from '../plugins/base';
 import { BaseService } from '../services/base';
 import { yup } from 'vtils/validator';
-import type { AsyncOrSync, OneOrMore, RequiredDeep } from 'vtils/types';
+import type { AsyncOrSync, LiteralUnion, OneOrMore, RequiredDeep } from 'vtils/types';
 import type { DisposeService } from '../services/dispose';
 import type { Handler } from './handler';
 import type { IncomingHttpHeaders } from 'http';
@@ -56,7 +56,7 @@ export declare namespace XHandler {
         /**
          * 设置响应头
          */
-        setHeader: (key: keyof IncomingHttpHeaders, value: string) => void;
+        setHeader: (key: string, value: string) => void;
         /**
          * HTTP 跳转
          */
@@ -98,6 +98,10 @@ export declare namespace XHandler {
          * @default false
          */
         responseDataPack?: boolean;
+        /**
+         * 响应的 Content-Type 头
+         */
+        responseContentType?: LiteralUnion<'text/html', string>;
         /**
          * 请求数据验证结构
          */

package/lib/index.d.ts

@@ -5,6 +5,7 @@ export * from './core/define_server';
 export * from './core/define_task';
 export * from './core/handler';
 export * from './core/http_error';
+export * from './core/http_header';
 export * from './core/http_method';
 export * from './core/server';
 export * from './core/types';

package/lib/index.js

@@ -6,6 +6,7 @@ export * from "./core/define_server";
 export * from "./core/define_task";
 export * from "./core/handler";
 export * from "./core/http_error";
+export * from "./core/http_header";
 export * from "./core/http_method";
 export * from "./core/server";
 export * from "./core/types";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jayfong/x-server",
-  "version": "1.18.0",
+  "version": "1.20.1",
   "license": "ISC",
   "sideEffects": false,
   "main": "lib/_cjs/index.js",