@boo-labs/server 0.0.0-stage → 1.0.0

package/source/application/configurations/Http2CleartextServerConfiguration/index.mjs

@@ -0,0 +1,168 @@
+// @ts-check
+/**
+ * @file Defines the HTTP/2 cleartext server configuration.
+ *
+ * @description Provides the configuration used to create and operate a
+ * Node.js HTTP/2 server over a cleartext (h2c) connection.
+ *
+ * Http2CleartextServerConfiguration defines the server-level configuration
+ * for listening, request handling, response handling, static file serving,
+ * cross-origin resource sharing, security headers, rate limiting, cookies,
+ * CSRF protection, response compression, and the underlying HTTP/2 connection.
+ *
+ * @module Http2CleartextServerConfiguration
+ */
+
+// ━━ IMPORT MODULES ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+// » IMPORT NATIVE NODEJS MODULES
+
+// » IMPORT THIRD PARTY MODULES
+
+// » IMPORT LOCAL MODULES
+import ServerConfiguration from '../ServerConfiguration/index.mjs';
+
+// ━━ TYPE DEFINITIONS ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+/**
+ * HTTP/2 cleartext server connection options.
+ *
+ * @typedef {import('node:http2').ServerOptions} Http2ConnectionOptions
+ */
+
+/**
+ * Identity of a cleartext HTTP/2 server.
+ *
+ * @typedef  {object}                 Http2CleartextServerConfigurationIdentity
+ * @property {'http'}                 protocol                                  - Application-level protocol.
+ * @property {'h2c'}                  transport                                 - Transport identifier for HTTP/2 cleartext.
+ * @property {Http2ConnectionOptions} [connection]                              - HTTP/2 cleartext connection options.
+ */
+
+/**
+ * Represents the listen options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/ListenOptions').ListenOptionsInput} ListenOptionsInput
+ */
+
+/**
+ * Represents the request options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/RequestOptions').RequestOptionsInput} RequestOptionsInput
+ */
+
+/**
+ * Represents the response options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/ResponseOptions').ResponseOptionsInput} ResponseOptionsInput
+ */
+
+/**
+ * Represents the static file serving options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/StaticOptions').StaticOptionsInput} StaticOptionsInput
+ */
+
+/**
+ * Represents the CORS options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/CORSOptions').CORSOptionsInput} CORSOptionsInput
+ */
+
+/**
+ * Represents the security headers options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/SecurityHeadersOptions').SecurityHeadersOptionsInput} SecurityHeadersOptionsInput
+ */
+
+/**
+ * Represents the rate limit options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/RateLimitOptions').RateLimitOptionsInput} RateLimitOptionsInput
+ */
+
+/**
+ * Represents the cookie parser options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/CookieParserOptions').CookieParserOptionsInput} CookieParserOptionsInput
+ */
+
+/**
+ * Represents the cookie session options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/CookieSessionOptions').CookieSessionOptionsInput} CookieSessionOptionsInput
+ */
+
+/**
+ * Represents the CSRF options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/CSRFOptions').CSRFOptionsInput} CSRFOptionsInput
+ */
+
+/**
+ * Represents the compression options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/CompressOptions').CompressOptionsInput} CompressOptionsInput
+ */
+
+/**
+ * Represents the cookie options accepted by the server configuration.
+ *
+ * @typedef  {object}                    CookieOptionsInput
+ * @property {CookieParserOptionsInput}  [parser]           - Cookie parser configuration.
+ * @property {CookieSessionOptionsInput} [session]          - Cookie session configuration.
+ */
+
+/**
+ * Options accepted by {@link Http2CleartextServerConfiguration}.
+ *
+ * @typedef  {object}                      Http2CleartextServerConfigurationOptions
+ * @property {Http2ConnectionOptions}      [connection]                             - HTTP/2 cleartext server connection options.
+ * @property {ListenOptionsInput}          [listen]                                 - Server listening configuration.
+ * @property {RequestOptionsInput}         [request]                                - Request handling configuration.
+ * @property {ResponseOptionsInput}        [response]                               - Response handling configuration.
+ * @property {StaticOptionsInput}          [static]                                 - Static file serving configuration.
+ * @property {CORSOptionsInput}            [cors]                                   - CORS configuration.
+ * @property {SecurityHeadersOptionsInput} [securityHeaders]                        - Security headers configuration.
+ * @property {RateLimitOptionsInput}       [rateLimit]                              - Rate limit configuration.
+ * @property {CookieOptionsInput}          [cookie]                                 - Cookie configuration.
+ * @property {CSRFOptionsInput}            [csrf]                                   - CSRF configuration.
+ * @property {CompressOptionsInput}        [compress]                               - Compression configuration.
+ */
+
+// ━━ MODULE ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+/**
+ * Configuration for a Node.js HTTP/2 server operating over cleartext (h2c).
+ *
+ * @classdesc Http2CleartextServerConfiguration provides the server configuration
+ * required to create and operate an HTTP/2 cleartext server, including connection,
+ * listening, request, response, static file serving, CORS, security headers,
+ * rate limiting, cookie, CSRF, and compression options.
+ *
+ * @augments ServerConfiguration<Http2CleartextServerConfigurationIdentity>
+ */
+class Http2CleartextServerConfiguration extends ServerConfiguration {
+  /**
+   * Creates a new {@link Http2CleartextServerConfiguration}.
+   *
+   * @param {Http2CleartextServerConfigurationOptions} options - Server configuration options.
+   *
+   * @example
+   * ```js
+   * const configuration = new Http2CleartextServerConfiguration({
+   *   listen: {
+   *     host: 'localhost',
+   *     port: 3000,
+   *   },
+   * });
+   * ```
+   */
+  constructor(options) {
+    super({
+      ...options,
+      transport: 'h2c',
+      protocol: 'http',
+    });
+  }
+}
+
+// ━━ EXPORT MODULE ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+export default Http2CleartextServerConfiguration;

package/source/application/configurations/Http2SecureServerConfiguration/index.mjs

@@ -0,0 +1,172 @@
+// @ts-check
+/**
+ * @file Defines the HTTP/2 secure server configuration.
+ *
+ * @description Provides the configuration used to create and operate a
+ * Node.js HTTP/2 server over a TLS connection.
+ *
+ * Http2SecureServerConfiguration defines the server-level configuration for
+ * listening, request handling, response handling, static file serving,
+ * cross-origin resource sharing, security headers, rate limiting, cookies,
+ * CSRF protection, response compression, and the underlying HTTP/2 connection.
+ *
+ * @module Http2SecureServerConfiguration
+ */
+
+// ━━ IMPORT MODULES ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+// » IMPORT NATIVE NODEJS MODULES
+
+// » IMPORT THIRD PARTY MODULES
+
+// » IMPORT LOCAL MODULES
+import ServerConfiguration from '../ServerConfiguration/index.mjs';
+
+// ━━ TYPE DEFINITIONS ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+/**
+ * HTTP/2 secure server connection options.
+ *
+ * @typedef {import('node:http2').SecureServerOptions} Http2SecureConnectionOptions
+ */
+
+/**
+ * Identity of a secure HTTP/2 server.
+ *
+ * @typedef  {object}                       Http2SecureServerConfigurationIdentity
+ * @property {'https'}                      protocol                               - Application-level protocol.
+ * @property {'h2'}                         transport                              - Transport identifier for HTTP/2 over TLS.
+ * @property {Http2SecureConnectionOptions} [connection]                           - HTTP/2 secure connection options.
+ */
+
+/**
+ * Represents the listen options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/ListenOptions').ListenOptionsInput} ListenOptionsInput
+ */
+
+/**
+ * Represents the request options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/RequestOptions').RequestOptionsInput} RequestOptionsInput
+ */
+
+/**
+ * Represents the response options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/ResponseOptions').ResponseOptionsInput} ResponseOptionsInput
+ */
+
+/**
+ * Represents the static file serving options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/StaticOptions').StaticOptionsInput} StaticOptionsInput
+ */
+
+/**
+ * Represents the CORS options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/CORSOptions').CORSOptionsInput} CORSOptionsInput
+ */
+
+/**
+ * Represents the security headers options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/SecurityHeadersOptions').SecurityHeadersOptionsInput} SecurityHeadersOptionsInput
+ */
+
+/**
+ * Represents the rate limit options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/RateLimitOptions').RateLimitOptionsInput} RateLimitOptionsInput
+ */
+
+/**
+ * Represents the cookie parser options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/CookieParserOptions').CookieParserOptionsInput} CookieParserOptionsInput
+ */
+
+/**
+ * Represents the cookie session options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/CookieSessionOptions').CookieSessionOptionsInput} CookieSessionOptionsInput
+ */
+
+/**
+ * Represents the CSRF options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/CSRFOptions').CSRFOptionsInput} CSRFOptionsInput
+ */
+
+/**
+ * Represents the compression options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/CompressOptions').CompressOptionsInput} CompressOptionsInput
+ */
+
+/**
+ * Represents the cookie options accepted by the server configuration.
+ *
+ * @typedef  {object}                    CookieOptionsInput
+ * @property {CookieParserOptionsInput}  [parser]           - Cookie parser configuration.
+ * @property {CookieSessionOptionsInput} [session]          - Cookie session configuration.
+ */
+
+/**
+ * Options accepted by {@link Http2SecureServerConfiguration}.
+ *
+ * @typedef  {object}                       Http2SecureServerConfigurationOptions
+ * @property {Http2SecureConnectionOptions} [connection]                          - HTTP/2 secure server connection options.
+ * @property {ListenOptionsInput}           [listen]                              - Server listening configuration.
+ * @property {RequestOptionsInput}          [request]                             - Request handling configuration.
+ * @property {ResponseOptionsInput}         [response]                            - Response handling configuration.
+ * @property {StaticOptionsInput}           [static]                              - Static file serving configuration.
+ * @property {CORSOptionsInput}             [cors]                                - CORS configuration.
+ * @property {SecurityHeadersOptionsInput}  [securityHeaders]                     - Security headers configuration.
+ * @property {RateLimitOptionsInput}        [rateLimit]                           - Rate limit configuration.
+ * @property {CookieOptionsInput}           [cookie]                              - Cookie configuration.
+ * @property {CSRFOptionsInput}             [csrf]                                - CSRF configuration.
+ * @property {CompressOptionsInput}         [compress]                            - Compression configuration.
+ */
+
+// ━━ MODULE ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+/**
+ * Configuration for a Node.js HTTP/2 server operating over TLS.
+ *
+ * @classdesc Http2SecureServerConfiguration provides the server configuration
+ * required to create and operate an HTTP/2 server over TLS, including
+ * connection, listening, request, response, static file serving, CORS,
+ * security headers, rate limiting, cookie, CSRF, and compression options.
+ *
+ * @augments ServerConfiguration<Http2SecureServerConfigurationIdentity>
+ */
+class Http2SecureServerConfiguration extends ServerConfiguration {
+  /**
+   * Creates a new {@link Http2SecureServerConfiguration}.
+   *
+   * @param {Http2SecureServerConfigurationOptions} options - Server configuration options.
+   *
+   * @example
+   * ```js
+   * const configuration = new Http2SecureServerConfiguration({
+   *   listen: {
+   *     host: 'localhost',
+   *     port: 3443,
+   *   },
+   *   connection: {
+   *     cert: './cert.pem',
+   *     key: './key.pem',
+   *   },
+   * });
+   * ```
+   */
+  constructor(options) {
+    super({
+      ...options,
+      transport: 'h2',
+      protocol: 'https',
+    });
+  }
+}
+
+// ━━ EXPORT MODULE ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+export default Http2SecureServerConfiguration;

package/source/application/configurations/HttpServerConfiguration/index.mjs

@@ -0,0 +1,169 @@
+// @ts-check
+/**
+ * @file Defines the HTTP server configuration.
+ *
+ * @description Provides the configuration used to create and operate a
+ * Node.js HTTP server over an HTTP/1.1 cleartext connection.
+ *
+ * HttpServerConfiguration defines the server-level configuration for
+ * listening, request handling, response handling, static file serving,
+ * cross-origin resource sharing, security headers, rate limiting, cookies,
+ * CSRF protection, response compression, and the underlying HTTP connection.
+ *
+ * @module HttpServerConfiguration
+ */
+
+// ━━ IMPORT MODULES ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+// » IMPORT NATIVE NODEJS MODULES
+
+// » IMPORT THIRD PARTY MODULES
+
+// » IMPORT LOCAL MODULES
+import ServerConfiguration from '../ServerConfiguration/index.mjs';
+
+// ━━ TYPE DEFINITIONS ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+/**
+ * HTTP server connection options.
+ *
+ * @typedef {import('node:http').ServerOptions} HttpConnectionOptions
+ */
+
+/**
+ * Identity of an HTTP/1.1 cleartext server.
+ *
+ * @typedef  {object}                HttpServerConfigurationIdentity
+ * @property {'http'}                protocol                        - Application-level protocol.
+ * @property {'h1'}                  transport                       - Transport identifier for HTTP/1.1 cleartext.
+ * @property {HttpConnectionOptions} [connection]                    - HTTP server connection options.
+ */
+
+/**
+ * Represents the listen options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/ListenOptions').ListenOptionsInput} ListenOptionsInput
+ */
+
+/**
+ * Represents the request options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/RequestOptions').RequestOptionsInput} RequestOptionsInput
+ */
+
+/**
+ * Represents the response options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/ResponseOptions').ResponseOptionsInput} ResponseOptionsInput
+ */
+
+/**
+ * Represents the static file serving options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/StaticOptions').StaticOptionsInput} StaticOptionsInput
+ */
+
+/**
+ * Represents the CORS options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/CORSOptions').CORSOptionsInput} CORSOptionsInput
+ */
+
+/**
+ * Represents the security headers options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/SecurityHeadersOptions').SecurityHeadersOptionsInput} SecurityHeadersOptionsInput
+ */
+
+/**
+ * Represents the rate limit options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/RateLimitOptions').RateLimitOptionsInput} RateLimitOptionsInput
+ */
+
+/**
+ * Represents the cookie parser options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/CookieParserOptions').CookieParserOptionsInput} CookieParserOptionsInput
+ */
+
+/**
+ * Represents the cookie session options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/CookieSessionOptions').CookieSessionOptionsInput} CookieSessionOptionsInput
+ */
+
+/**
+ * Represents the CSRF options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/CSRFOptions').CSRFOptionsInput} CSRFOptionsInput
+ */
+
+/**
+ * Represents the compression options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/CompressOptions').CompressOptionsInput} CompressOptionsInput
+ */
+
+/**
+ * Represents the cookie options accepted by the server configuration.
+ *
+ * @typedef  {object}                    CookieOptionsInput
+ * @property {CookieParserOptionsInput}  [parser]           - Cookie parser configuration.
+ * @property {CookieSessionOptionsInput} [session]          - Cookie session configuration.
+ */
+
+/**
+ * Options accepted by {@link HttpServerConfiguration}.
+ *
+ * @typedef  {object}                      HttpServerConfigurationOptions
+ * @property {HttpConnectionOptions}       [connection]                   - HTTP server connection options.
+ * @property {ListenOptionsInput}          [listen]                       - Server listening configuration.
+ * @property {RequestOptionsInput}         [request]                      - Request handling configuration.
+ * @property {ResponseOptionsInput}        [response]                     - Response handling configuration.
+ * @property {StaticOptionsInput}          [static]                       - Static file serving configuration.
+ * @property {CORSOptionsInput}            [cors]                         - CORS configuration.
+ * @property {SecurityHeadersOptionsInput} [securityHeaders]              - Security headers configuration.
+ * @property {RateLimitOptionsInput}       [rateLimit]                    - Rate limit configuration.
+ * @property {CookieOptionsInput}          [cookie]                       - Cookie configuration.
+ * @property {CSRFOptionsInput}            [csrf]                         - CSRF configuration.
+ * @property {CompressOptionsInput}        [compress]                     - Compression configuration.
+ */
+
+// ━━ MODULE ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+/**
+ * Configuration for a Node.js HTTP server operating over HTTP/1.1
+ * cleartext.
+ *
+ * @classdesc HttpServerConfiguration provides the server configuration required
+ * to create and operate an HTTP server, including connection, listening,
+ * request, response, static file serving, CORS, security headers, rate
+ * limiting, cookie, CSRF, and compression options.
+ *
+ * @augments ServerConfiguration<HttpServerConfigurationIdentity>
+ */
+class HttpServerConfiguration extends ServerConfiguration {
+  /**
+   * Creates a new {@link HttpServerConfiguration}.
+   *
+   * @param {HttpServerConfigurationOptions} options - Server configuration options.
+   *
+   * @example
+   * ```js
+   * const configuration = new HttpServerConfiguration({
+   *   listen: {
+   *     host: 'localhost',
+   *     port: 3000,
+   *   },
+   * });
+   * ```
+   */
+  constructor(options) {
+    super({
+      ...options,
+      transport: 'h1',
+      protocol: 'http',
+    });
+  }
+}
+
+// ━━ EXPORT MODULE ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+export default HttpServerConfiguration;

package/source/application/configurations/HttpsServerConfiguration/index.mjs

@@ -0,0 +1,172 @@
+// @ts-check
+/**
+ * @file Defines the HTTPS server configuration.
+ *
+ * @description Provides the configuration used to create and operate a
+ * Node.js HTTPS server over an HTTP/1.1 TLS connection.
+ *
+ * HttpsServerConfiguration defines the server-level configuration for
+ * listening, request handling, response handling, static file serving,
+ * cross-origin resource sharing, security headers, rate limiting, cookies,
+ * CSRF protection, response compression, and the underlying HTTPS connection.
+ *
+ * @module HttpsServerConfiguration
+ */
+
+// ━━ IMPORT MODULES ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+// » IMPORT NATIVE NODEJS MODULES
+
+// » IMPORT THIRD PARTY MODULES
+
+// » IMPORT LOCAL MODULES
+import ServerConfiguration from '../ServerConfiguration/index.mjs';
+
+// ━━ TYPE DEFINITIONS ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+/**
+ * HTTPS server connection options.
+ *
+ * @typedef {import('node:https').ServerOptions} HttpsConnectionOptions
+ */
+
+/**
+ * Identity of an HTTP/1.1 over TLS server.
+ *
+ * @typedef  {object}                 HttpsServerConfigurationIdentity
+ * @property {'https'}                protocol                         - Application-level protocol.
+ * @property {'h1s'}                  transport                        - Transport identifier for HTTP/1.1 over TLS.
+ * @property {HttpsConnectionOptions} [connection]                     - HTTPS server connection options.
+ */
+
+/**
+ * Represents the listen options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/ListenOptions').ListenOptionsInput} ListenOptionsInput
+ */
+
+/**
+ * Represents the request options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/RequestOptions').RequestOptionsInput} RequestOptionsInput
+ */
+
+/**
+ * Represents the response options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/ResponseOptions').ResponseOptionsInput} ResponseOptionsInput
+ */
+
+/**
+ * Represents the static file serving options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/StaticOptions').StaticOptionsInput} StaticOptionsInput
+ */
+
+/**
+ * Represents the CORS options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/CORSOptions').CORSOptionsInput} CORSOptionsInput
+ */
+
+/**
+ * Represents the security headers options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/SecurityHeadersOptions').SecurityHeadersOptionsInput} SecurityHeadersOptionsInput
+ */
+
+/**
+ * Represents the rate limit options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/RateLimitOptions').RateLimitOptionsInput} RateLimitOptionsInput
+ */
+
+/**
+ * Represents the cookie parser options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/CookieParserOptions').CookieParserOptionsInput} CookieParserOptionsInput
+ */
+
+/**
+ * Represents the cookie session options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/CookieSessionOptions').CookieSessionOptionsInput} CookieSessionOptionsInput
+ */
+
+/**
+ * Represents the CSRF options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/CSRFOptions').CSRFOptionsInput} CSRFOptionsInput
+ */
+
+/**
+ * Represents the compression options accepted by the server configuration.
+ *
+ * @typedef {import('#ServerOptions/CompressOptions').CompressOptionsInput} CompressOptionsInput
+ */
+
+/**
+ * Represents the cookie options accepted by the server configuration.
+ *
+ * @typedef  {object}                    CookieOptionsInput
+ * @property {CookieParserOptionsInput}  [parser]           - Cookie parser configuration.
+ * @property {CookieSessionOptionsInput} [session]          - Cookie session configuration.
+ */
+
+/**
+ * Options accepted by {@link HttpsServerConfiguration}.
+ *
+ * @typedef  {object}                      HttpsServerConfigurationOptions
+ * @property {HttpsConnectionOptions}      [connection]                    - HTTPS server connection options.
+ * @property {ListenOptionsInput}          [listen]                        - Server listening configuration.
+ * @property {RequestOptionsInput}         [request]                       - Request handling configuration.
+ * @property {ResponseOptionsInput}        [response]                      - Response handling configuration.
+ * @property {StaticOptionsInput}          [static]                        - Static file serving configuration.
+ * @property {CORSOptionsInput}            [cors]                          - CORS configuration.
+ * @property {SecurityHeadersOptionsInput} [securityHeaders]               - Security headers configuration.
+ * @property {RateLimitOptionsInput}       [rateLimit]                     - Rate limit configuration.
+ * @property {CookieOptionsInput}          [cookie]                        - Cookie configuration.
+ * @property {CSRFOptionsInput}            [csrf]                          - CSRF configuration.
+ * @property {CompressOptionsInput}        [compress]                      - Compression configuration.
+ */
+
+// ━━ MODULE ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+/**
+ * Configuration for a Node.js HTTPS server operating over HTTP/1.1 TLS.
+ *
+ * @classdesc HttpsServerConfiguration provides the server configuration required
+ * to create and operate an HTTPS server, including connection, listening,
+ * request, response, static file serving, CORS, security headers, rate
+ * limiting, cookie, CSRF, and compression options.
+ *
+ * @augments ServerConfiguration<HttpsServerConfigurationIdentity>
+ */
+class HttpsServerConfiguration extends ServerConfiguration {
+  /**
+   * Creates a new {@link HttpsServerConfiguration}.
+   *
+   * @param {HttpsServerConfigurationOptions} options - Server configuration options.
+   *
+   * @example
+   * ```js
+   * const configuration = new HttpsServerConfiguration({
+   *   listen: {
+   *     host: 'localhost',
+   *     port: 3443,
+   *   },
+   *   connection: {
+   *     cert: './cert.pem',
+   *     key: './key.pem',
+   *   },
+   * });
+   * ```
+   */
+  constructor(options) {
+    super({
+      ...options,
+      transport: 'h1s',
+      protocol: 'https',
+    });
+  }
+}
+
+// ━━ EXPORT MODULE ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+export default HttpsServerConfiguration;