@flancer32/teq-web 0.5.0 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## [0.7.0] - 2026-03-16 - Runtime composition and agent interface alignment
+
+### Changed
+- Refined runtime configuration composition for server and TLS branches and preserved immutable runtime state semantics.
+- Updated and verified the `ai/` consumer interface documentation against the current package behavior and usage rules.
+- Updated package version metadata to `0.7.0`.
+
+## [0.6.0] - 2026-03-16 - Runtime configuration hardening
+
+### Added
+- Added JSDoc coverage for request-context DTO usage and runtime configuration components.
+
+### Changed
+- Refined runtime configuration composition for server and TLS settings.
+- Hardened runtime configuration objects to remain immutable after initialization.
+- Updated package version metadata to `0.6.0`.
+
 ## [0.5.0] - 2026-03-13
 
 ### Added

package/ai/abstractions.md

@@ -16,13 +16,13 @@ Main methods:
 
 `Fl32_Web_Back_Server$` is the built-in transport adapter around Node.js `http` and `http2`. On `start(cfg)` it locks the pipeline, creates the server instance, binds request events to the Pipeline Engine, and starts listening.
 
-Config is created with `Fl32_Web_Back_Server_Config$`. Supported transport modes come from `Fl32_Web_Back_Enum_Server_Type$`:
+Default transport settings come from `Fl32_Web_Back_Config_Runtime$` under the `server` branch. TLS values for `server.tls` are provided by the dedicated runtime configuration component `Fl32_Web_Back_Config_Runtime_Tls$`. Supported transport modes come from `Fl32_Web_Back_Enum_Server_Type$`:
 
 - `http`
 - `http2`
 - `https`
 
-`https` requires TLS config.
+`https` requires `server.tls`.
 
 ## Handler Contract
 

package/ai/examples/minimal-server.md

@@ -74,5 +74,6 @@ Consumer notes:
 - The composition root configures namespace roots once and resolves one application entry service.
 - Application modules do not construct collaborators directly and do not call `new` for DI-managed handlers or infrastructure services.
 - `server.start()` locks handler registration for the runtime lifetime of that server instance.
+- Built-in server defaults may also be supplied through `Fl32_Web_Back_Config_Runtime__Factory$` as `{server: {port, type, tls}}`, where `tls` is owned by the runtime component `Fl32_Web_Back_Config_Runtime_Tls$`.
 - If your application already has its own transport layer, inject `Fl32_Web_Back_PipelineEngine$` and call `pipeline.onEventRequest(req, res)` from that adapter instead of using `Fl32_Web_Back_Server$`.
 - A correct PROCESS handler ends the response and then marks the context completed.

package/ai/overview.md

@@ -6,6 +6,8 @@ This package is not a general-purpose web framework. It does not define routing,
 
 The package assumes `@teqfw/di` and exposes its runtime surface through DI-managed modules under the `Fl32_Web_` namespace rooted at the published `src/` tree. In normal usage, application modules receive these dependencies through constructor injection and orchestrate them from DI-managed services rather than creating containers or wiring collaborators manually inside feature code.
 
+Runtime startup configuration is exposed through `Fl32_Web_Back_Config_Runtime$`. Its built-in transport branch is `config.server`, which contains `port`, `type`, and a `tls` branch backed by `Fl32_Web_Back_Config_Runtime_Tls$`.
+
 Use this package when external code needs one of these roles:
 
 - accept HTTP, HTTPS, or HTTP/2 requests with the built-in server;

package/ai/rules.md

@@ -38,4 +38,7 @@
 
 - The package is designed for `@teqfw/di`.
 - Consumer code should resolve package modules through the `Fl32_Web_` namespace mapped to the package `src/` path.
+- Startup configuration for the built-in server should be supplied through `Fl32_Web_Back_Config_Runtime__Factory$` using the hierarchical configuration shape `{server: {...}}`.
+- TLS startup configuration belongs to the dedicated runtime component `Fl32_Web_Back_Config_Runtime_Tls$`, even though consumers read it through `config.server.tls`.
+- Configure runtime values during startup only; once the runtime configuration is frozen for use, consumers must treat `Fl32_Web_Back_Config_Runtime$` and `Fl32_Web_Back_Config_Runtime_Tls$` as immutable read-only state.
 - Treat helper internals under deep implementation paths as non-essential unless the task specifically requires them. Preferred consumer entry points are the Pipeline Engine, Server, handler API, DTO factories, enums, and built-in handlers.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flancer32/teq-web",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "Server-side web request coordination infrastructure for TeqFW modular monolith applications.",
   "type": "module",
   "license": "Apache-2.0",
@@ -41,7 +41,7 @@
     ]
   },
   "dependencies": {
-    "@teqfw/di": "^2.0.4"
+    "@teqfw/di": "^2.1.0"
   },
   "devDependencies": {
     "@types/node": "^25.4.0",

package/src/Back/Api/Handler.mjs

@@ -9,7 +9,7 @@ export default class Fl32_Web_Back_Api_Handler {
     /* eslint-disable no-unused-vars */
     /**
      * Handles one request context in a pipeline stage.
-     * @param {Fl32_Web_Back_PipelineEngine_RequestContext} context
+     * @param {Fl32_Web_Back_Dto_RequestContext} context
      * @returns {Promise<void>}
      */
     async handle(context) {

package/src/Back/Config/Runtime/Tls.mjs

@@ -0,0 +1,86 @@
+// @ts-check
+
+export const __deps__ = Object.freeze({
+    cast: 'Fl32_Web_Back_Helper_Cast$',
+});
+
+/**
+ * TLS runtime configuration.
+ */
+export class Data {
+    /** @type {string|undefined} */
+    ca;
+    /** @type {string|undefined} */
+    cert;
+    /** @type {string|undefined} */
+    key;
+}
+
+/** @type {Fl32_Web_Back_Config_Runtime_Tls} */
+const cfg = new Data();
+let frozen = false;
+
+const facade = {};
+
+/** @type {Fl32_Web_Back_Config_Runtime_Tls} */
+const proxy = new Proxy(facade, {
+    get(_target, prop) {
+        const isServiceProp = (prop === 'then') || (typeof prop === 'symbol');
+        if (!frozen && !isServiceProp) throw new Error('Runtime configuration is not initialized.');
+        return cfg[prop];
+    },
+    set() {
+        throw new Error('Runtime configuration is immutable.');
+    },
+    defineProperty() {
+        throw new Error('Runtime configuration is immutable.');
+    },
+    deleteProperty() {
+        throw new Error('Runtime configuration is immutable.');
+    },
+    preventExtensions() {
+        throw new Error('Runtime configuration wrapper cannot be frozen.');
+    },
+});
+
+export default class Wrapper {
+    constructor() {
+        return proxy;
+    }
+}
+
+export class Factory {
+    /**
+     * @param {object} params
+     * @param {Fl32_Web_Back_Helper_Cast} params.cast
+     */
+    constructor({cast}) {
+        /**
+         * @param {Fl32_Web_Back_Config_Runtime_Tls_Params} [params]
+         * @returns {Fl32_Web_Back_Config_Runtime_Tls}
+         */
+        this.configure = function (params = {}) {
+            if (frozen) throw new Error('Runtime configuration is frozen.');
+            if (cfg.ca === undefined && params.ca !== undefined) {
+                cfg.ca = cast.string(params.ca);
+            }
+            if (cfg.cert === undefined && params.cert !== undefined) {
+                cfg.cert = cast.string(params.cert);
+            }
+            if (cfg.key === undefined && params.key !== undefined) {
+                cfg.key = cast.string(params.key);
+            }
+            return proxy;
+        };
+
+        /**
+         * @returns {Fl32_Web_Back_Config_Runtime_Tls}
+         */
+        this.freeze = function () {
+            if (frozen) return proxy;
+            Object.freeze(cfg);
+            frozen = true;
+            return proxy;
+        };
+    }
+}

package/src/Back/Config/Runtime.mjs

@@ -0,0 +1,111 @@
+// @ts-check
+
+export const __deps__ = Object.freeze({
+    cast: 'Fl32_Web_Back_Helper_Cast$',
+    SERVER_TYPE: 'Fl32_Web_Back_Enum_Server_Type$',
+    tlsFactory: 'Fl32_Web_Back_Config_Runtime_Tls__Factory$',
+});
+
+/**
+ * Backend runtime configuration.
+ */
+export class Data {
+    /** @type {Fl32_Web_Back_Config_Runtime_Server|undefined} */
+    server;
+}
+
+/**
+ * Built-in server runtime configuration subtree.
+ */
+export class Server {
+    /** @type {number|undefined} */
+    port;
+    /** @type {string|undefined} */
+    type;
+    /** @type {Fl32_Web_Back_Config_Runtime_Tls|undefined} */
+    tls;
+}
+
+/** @type {Fl32_Web_Back_Config_Runtime} */
+const cfg = new Data();
+let frozen = false;
+
+const facade = {};
+
+/** @type {Fl32_Web_Back_Config_Runtime} */
+const proxy = new Proxy(facade, {
+    get(_target, prop) {
+        const isServiceProp = (prop === 'then') || (typeof prop === 'symbol');
+        if (!frozen && !isServiceProp) throw new Error('Runtime configuration is not initialized.');
+        return cfg[prop];
+    },
+    set() {
+        throw new Error('Runtime configuration is immutable.');
+    },
+    defineProperty() {
+        throw new Error('Runtime configuration is immutable.');
+    },
+    deleteProperty() {
+        throw new Error('Runtime configuration is immutable.');
+    },
+    preventExtensions() {
+        throw new Error('Runtime configuration wrapper cannot be frozen.');
+    },
+});
+
+export default class Wrapper {
+    constructor() {
+        return proxy;
+    }
+}
+
+export class Factory {
+    /**
+     * @param {object} params
+     * @param {Fl32_Web_Back_Helper_Cast} params.cast
+     * @param {Fl32_Web_Back_Enum_Server_Type} params.SERVER_TYPE
+     * @param {Fl32_Web_Back_Config_Runtime_Tls$Factory} params.tlsFactory
+     */
+    constructor({ cast, SERVER_TYPE, tlsFactory }) {
+        /**
+         * @param {Fl32_Web_Back_Config_Runtime_Params} [params]
+         * @returns {Fl32_Web_Back_Config_Runtime}
+         */
+        this.configure = function (params = {}) {
+            if (frozen) throw new Error('Runtime configuration is frozen.');
+            if (cfg.server === undefined) cfg.server = new Server();
+            if (cfg.server.port === undefined && params.server?.port !== undefined) {
+                cfg.server.port = cast.int(params.server.port);
+            }
+            if (cfg.server.type === undefined && params.server?.type !== undefined) {
+                cfg.server.type = cast.enum(params.server.type, SERVER_TYPE, { lower: true });
+            }
+            if (params.server?.tls !== undefined) {
+                tlsFactory.configure(params.server.tls);
+            }
+            return proxy;
+        };
+
+        /**
+         * @returns {Fl32_Web_Back_Config_Runtime}
+         */
+        this.freeze = function () {
+            if (frozen) return proxy;
+            if (cfg.server === undefined) cfg.server = new Server();
+            if (cfg.server.port === undefined) cfg.server.port = 3000;
+            if (cfg.server.type === undefined) cfg.server.type = SERVER_TYPE.HTTP;
+            const tls = tlsFactory.freeze();
+            if (cfg.server.tls === undefined) cfg.server.tls = tls;
+            if (cfg.server.type === SERVER_TYPE.HTTPS && cfg.server.tls === undefined) {
+                throw new Error('TLS configuration is required for HTTPS server type');
+            }
+            if (cfg.server.type === SERVER_TYPE.HTTPS && (!cfg.server.tls.key || !cfg.server.tls.cert)) {
+                throw new Error('TLS configuration is required for HTTPS server type');
+            }
+            Object.freeze(cfg.server);
+            Object.freeze(cfg);
+            frozen = true;
+            return proxy;
+        };
+    }
+}

package/src/Back/Dto/Info.mjs

@@ -5,12 +5,6 @@ export const __deps__ = Object.freeze({
     STAGE: 'Fl32_Web_Back_Enum_Stage$',
 });
 
-/**
- * @typedef {object} Fl32_Web_Back_Dto_InfoFactoryParams
- * @property {Fl32_Web_Back_Helper_Cast} cast
- * @property {Fl32_Web_Back_Enum_Stage} STAGE
- */
-
 export default class Fl32_Web_Back_Dto_Info {
     /**
      * Handlers to run before this one.
@@ -41,7 +35,9 @@ export default class Fl32_Web_Back_Dto_Info {
 export class Factory {
     /* eslint-disable jsdoc/require-param-description,jsdoc/check-param-names */
     /**
-     * @param {Fl32_Web_Back_Dto_InfoFactoryParams} params
+     * @param {object} params
+     * @param {Fl32_Web_Back_Helper_Cast} params.cast
+     * @param {Fl32_Web_Back_Enum_Stage} params.STAGE
      */
     constructor(
         {

package/src/Back/Dto/RequestContext.mjs

@@ -0,0 +1,33 @@
+// @ts-check
+
+/**
+ * Request context passed through the pipeline lifecycle.
+ */
+export default class Fl32_Web_Back_Dto_RequestContext {
+    /** @type {Fl32_Web_Node_Http_IncomingMessage|Fl32_Web_Node_Http2_ServerRequest} */
+    request;
+
+    /** @type {Fl32_Web_Back_Response_Target} */
+    response;
+
+    /** @type {Record<string, unknown>} */
+    data = {};
+
+    /** @type {boolean} */
+    completed = false;
+
+    /** @type {() => void} */
+    complete;
+
+    /** @type {() => boolean} */
+    isCompleted;
+}
+
+export class Factory {
+    /**
+     * @returns {Fl32_Web_Back_Dto_RequestContext}
+     */
+    create() {
+        return new Fl32_Web_Back_Dto_RequestContext();
+    }
+}

package/src/Back/Dto/Source.mjs

@@ -4,11 +4,6 @@ export const __deps__ = Object.freeze({
     cast: 'Fl32_Web_Back_Helper_Cast$',
 });
 
-/**
- * @typedef {object} Fl32_Web_Back_Dto_SourceFactoryParams
- * @property {Fl32_Web_Back_Helper_Cast} cast
- */
-
 export default class Fl32_Web_Back_Dto_Source {
     /** @type {string} */
     root;
@@ -23,7 +18,8 @@ export default class Fl32_Web_Back_Dto_Source {
 export class Factory {
     /* eslint-disable jsdoc/require-param-description */
     /**
-     * @param {Fl32_Web_Back_Dto_SourceFactoryParams} params
+     * @param {object} params
+     * @param {Fl32_Web_Back_Helper_Cast} params.cast
      */
     constructor(
         {

package/src/Back/Handler/Pre/Log.mjs

@@ -11,17 +11,13 @@ export const __deps__ = Object.freeze({
     STAGE: 'Fl32_Web_Back_Enum_Stage$',
 });
 
-/**
- * @typedef {object} Fl32_Web_Back_Handler_Pre_LogConstructorParams
- * @property {Fl32_Web_Back_Logger} logger
- * @property {Fl32_Web_Back_Dto_Info$Factory} dtoInfoFactory
- * @property {Fl32_Web_Back_Enum_Stage} STAGE
- */
-
 export default class Fl32_Web_Back_Handler_Pre_Log {
     /* eslint-disable jsdoc/require-param-description,jsdoc/check-param-names */
     /**
-     * @param {Fl32_Web_Back_Handler_Pre_LogConstructorParams} params
+     * @param {object} params
+     * @param {Fl32_Web_Back_Logger} params.logger
+     * @param {Fl32_Web_Back_Dto_Info$Factory} params.dtoInfoFactory
+     * @param {Fl32_Web_Back_Enum_Stage} params.STAGE
      */
     constructor(
         {
@@ -42,7 +38,7 @@ export default class Fl32_Web_Back_Handler_Pre_Log {
         /**
          * Log request method and URL.
          *
-         * @param {Fl32_Web_Back_PipelineEngine_RequestContext} context
+         * @param {Fl32_Web_Back_Dto_RequestContext} context
          * @returns {Promise<void>}
          */
         this.handle = async function (context) {

package/src/Back/Handler/Static/A/Config.mjs

@@ -4,16 +4,12 @@ export const __deps__ = Object.freeze({
     path: 'node_path',
 });
 
-/**
- * @typedef {object} Fl32_Web_Back_Handler_Static_A_ConfigConstructorParams
- * @property {typeof import('node:path')} path
- */
-
 export default class Fl32_Web_Back_Handler_Static_A_Config {
     static DEFAULT_FILES = ['index.html', 'index.htm', 'index.txt'];
     /* eslint-disable jsdoc/require-param-description,jsdoc/check-param-names */
     /**
-     * @param {Fl32_Web_Back_Handler_Static_A_ConfigConstructorParams} params
+     * @param {object} params
+     * @param {Fl32_Web_Node_Path} params.path
      */
     constructor(
         {
@@ -26,7 +22,7 @@ export default class Fl32_Web_Back_Handler_Static_A_Config {
          * Normalize DTO fields into configuration object.
          *
          * @param {Fl32_Web_Back_Dto_Source} dto
-         * @returns {{root:string,prefix:string,allow?:Record<string,string[]>,defaults:string[]}}
+         * @returns {Fl32_Web_Back_Handler_Static_A_Config_Value}
          * @throws {Error} When required fields are missing or invalid.
          */
         this.create = (dto) => {

package/src/Back/Handler/Static/A/Fallback.mjs

@@ -5,16 +5,12 @@ export const __deps__ = Object.freeze({
     path: 'node_path',
 });
 
-/**
- * @typedef {object} Fl32_Web_Back_Handler_Static_A_FallbackConstructorParams
- * @property {typeof import('node:fs')} fs
- * @property {typeof import('node:path')} path
- */
-
 export default class Fl32_Web_Back_Handler_Static_A_Fallback {
     /* eslint-disable jsdoc/require-param-description,jsdoc/check-param-names */
     /**
-     * @param {Fl32_Web_Back_Handler_Static_A_FallbackConstructorParams} params
+     * @param {object} params
+     * @param {Fl32_Web_Node_Fs} params.fs
+     * @param {Fl32_Web_Node_Path} params.path
      */
     constructor(
         {

package/src/Back/Handler/Static/A/FileService.mjs

@@ -10,21 +10,17 @@ export const __deps__ = Object.freeze({
     fallback: 'Fl32_Web_Back_Handler_Static_A_Fallback$',
 });
 
-/**
- * @typedef {object} Fl32_Web_Back_Handler_Static_A_FileServiceConstructorParams
- * @property {typeof import('node:fs')} fs
- * @property {typeof import('node:http2')} http2
- * @property {typeof import('node:path')} path
- * @property {Fl32_Web_Back_Logger} logger
- * @property {Fl32_Web_Back_Helper_Mime} helpMime
- * @property {Fl32_Web_Back_Handler_Static_A_Resolver} resolver
- * @property {Fl32_Web_Back_Handler_Static_A_Fallback} fallback
- */
-
 export default class Fl32_Web_Back_Handler_Static_A_FileService {
     /* eslint-disable jsdoc/require-param-description,jsdoc/check-param-names */
     /**
-     * @param {Fl32_Web_Back_Handler_Static_A_FileServiceConstructorParams} params
+     * @param {object} params
+     * @param {Fl32_Web_Node_Fs} params.fs
+     * @param {Fl32_Web_Node_Http2} params.http2
+     * @param {Fl32_Web_Node_Path} params.path
+     * @param {Fl32_Web_Back_Logger} params.logger
+     * @param {Fl32_Web_Back_Helper_Mime} params.helpMime
+     * @param {Fl32_Web_Back_Handler_Static_A_Resolver} params.resolver
+     * @param {Fl32_Web_Back_Handler_Static_A_Fallback} params.fallback
      */
     constructor(
         {
@@ -43,10 +39,10 @@ export default class Fl32_Web_Back_Handler_Static_A_FileService {
         /**
          * Serve a file for given config and relative path.
          *
-         * @param {*} config
+         * @param {Fl32_Web_Back_Handler_Static_A_Config_Value} config
          * @param {string} rel
-         * @param {*} req
-         * @param {*} res
+         * @param {Fl32_Web_Node_Http_IncomingMessage|Fl32_Web_Node_Http2_ServerRequest} req
+         * @param {Fl32_Web_Back_Response_Target} res
          * @returns {Promise<boolean>} true if served
          */
         this.serve = async (config, rel, req, res) => {

package/src/Back/Handler/Static/A/Registry.mjs

@@ -5,16 +5,12 @@ export const __deps__ = Object.freeze({
     logger: 'Fl32_Web_Back_Logger$',
 });
 
-/**
- * @typedef {object} Fl32_Web_Back_Handler_Static_A_RegistryConstructorParams
- * @property {Fl32_Web_Back_Handler_Static_A_Config} configFactory
- * @property {Fl32_Web_Back_Logger} logger
- */
-
 export default class Fl32_Web_Back_Handler_Static_A_Registry {
     /* eslint-disable jsdoc/require-param-description,jsdoc/check-param-names */
     /**
-     * @param {Fl32_Web_Back_Handler_Static_A_RegistryConstructorParams} params
+     * @param {object} params
+     * @param {Fl32_Web_Back_Handler_Static_A_Config} params.configFactory
+     * @param {Fl32_Web_Back_Logger} params.logger
      */
     constructor(
         {
@@ -49,7 +45,7 @@ export default class Fl32_Web_Back_Handler_Static_A_Registry {
          * Find configuration by matching URL prefix.
          *
          * @param {string} url
-         * @returns {{config: *, rel: string}|null}
+         * @returns {Fl32_Web_Back_Handler_Static_A_Match|null}
          */
         this.find = function (url) {
             for (const cfg of _configs) {

package/src/Back/Handler/Static/A/Resolver.mjs

@@ -8,21 +8,17 @@ export const __deps__ = Object.freeze({
     path: 'node_path',
 });
 
-/**
- * @typedef {object} Fl32_Web_Back_Handler_Static_A_ResolverConstructorParams
- * @property {typeof import('node:path')} path
- */
-
 export default class Fl32_Web_Back_Handler_Static_A_Resolver {
     /**
-     * @param {Fl32_Web_Back_Handler_Static_A_ResolverConstructorParams} params
+     * @param {object} params
+     * @param {Fl32_Web_Node_Path} params.path
      */
     constructor({path}) {
         /**
          * Resolve a filesystem path for given config and relative URL part.
          * Applies allow rules and prevents path traversal.
          *
-         * @param {{root: string, prefix: string, allow?: Record<string,string[]>}} config
+         * @param {Fl32_Web_Back_Handler_Static_A_Config_Value} config
          * @param {string} rel
          * @returns {string|null}
          * @throws {Error} On traversal or absolute rel paths.

package/src/Back/Handler/Static.mjs

@@ -14,20 +14,16 @@ export const __deps__ = Object.freeze({
     STAGE: 'Fl32_Web_Back_Enum_Stage$',
 });
 
-/**
- * @typedef {object} Fl32_Web_Back_Handler_StaticConstructorParams
- * @property {Fl32_Web_Back_Handler_Static_A_Registry} registry
- * @property {Fl32_Web_Back_Handler_Static_A_FileService} fileService
- * @property {Fl32_Web_Back_Helper_Respond} respond
- * @property {Fl32_Web_Back_Logger} logger
- * @property {Fl32_Web_Back_Dto_Info$Factory} dtoInfoFactory
- * @property {Fl32_Web_Back_Enum_Stage} STAGE
- */
-
 export default class Fl32_Web_Back_Handler_Static {
     /* eslint-disable jsdoc/require-param-description,jsdoc/check-param-names */
     /**
-     * @param {Fl32_Web_Back_Handler_StaticConstructorParams} params
+     * @param {object} params
+     * @param {Fl32_Web_Back_Handler_Static_A_Registry} params.registry
+     * @param {Fl32_Web_Back_Handler_Static_A_FileService} params.fileService
+     * @param {Fl32_Web_Back_Helper_Respond} params.respond
+     * @param {Fl32_Web_Back_Logger} params.logger
+     * @param {Fl32_Web_Back_Dto_Info$Factory} params.dtoInfoFactory
+     * @param {Fl32_Web_Back_Enum_Stage} params.STAGE
      */
     constructor(
         {
@@ -59,7 +55,7 @@ export default class Fl32_Web_Back_Handler_Static {
         /**
          * Attempt to handle incoming request.
          *
-         * @param {Fl32_Web_Back_PipelineEngine_RequestContext} context
+         * @param {Fl32_Web_Back_Dto_RequestContext} context
          * @returns {Promise<void>}
          */
         this.handle = async (context) => {

package/src/Back/Helper/Respond.mjs

@@ -5,14 +5,10 @@ export const __deps__ = Object.freeze({
     http2: 'node_http2',
 });
 
-/**
- * @typedef {object} Fl32_Web_Back_Helper_RespondConstructorParams
- * @property {typeof import('node:http2')} http2
- */
-
 export default class Fl32_Web_Back_Helper_Respond {
     /**
-     * @param {Fl32_Web_Back_Helper_RespondConstructorParams} params
+     * @param {object} params
+     * @param {Fl32_Web_Node_Http2} params.http2
      */
     constructor(
         {
@@ -47,9 +43,9 @@ export default class Fl32_Web_Back_Helper_Respond {
          * Sends an HTTP response with a given status code.
          *
          * @param {object} params
-         * @param {module:http.ServerResponse|module:http2.Http2ServerResponse} params.res - HTTP response object.
-         * @param {{[key: string]: string}} [params.headers={}] - Custom headers.
-         * @param {string|object} [params.body=''] - Response body.
+         * @param {Fl32_Web_Back_Response_Target} params.res - HTTP response object.
+         * @param {Fl32_Web_Back_Response_Headers} [params.headers={}] - Custom headers.
+         * @param {Fl32_Web_Back_Response_Body} [params.body=''] - Response body.
          * @param {number} status - HTTP status code.
          * @returns {boolean} - `true` if response was sent, `false` if headers were already sent.
          */
@@ -156,7 +152,7 @@ export default class Fl32_Web_Back_Helper_Respond {
 
         /**
          * Checks if the response is writable and not yet sent.
-         * @param {module:http.ServerResponse|module:http2.Http2ServerResponse} res
+         * @param {Fl32_Web_Back_Response_Target} res
          * @returns {boolean}
          */
         this.isWritable = function (res) {

package/src/Back/PipelineEngine.mjs

@@ -6,39 +6,28 @@
  * `INIT -> PROCESS -> FINALIZE`.
  */
 export const __deps__ = Object.freeze({
+    dtoRequestContextFactory: 'Fl32_Web_Back_Dto_RequestContext__Factory$',
     logger: 'Fl32_Web_Back_Logger$',
     respond: 'Fl32_Web_Back_Helper_Respond$',
     helpOrder: 'Fl32_Web_Back_Helper_Order_Kahn$',
     STAGE: 'Fl32_Web_Back_Enum_Stage$',
 });
 
-/**
- * @typedef {object} Fl32_Web_Back_PipelineEngineConstructorParams
- * @property {Fl32_Web_Back_Logger} logger
- * @property {Fl32_Web_Back_Helper_Respond} respond
- * @property {Fl32_Web_Back_Helper_Order_Kahn} helpOrder
- * @property {Fl32_Web_Back_Enum_Stage} STAGE
- */
-
-/**
- * @typedef {object} Fl32_Web_Back_PipelineEngine_RequestContext
- * @property {module:http.IncomingMessage|module:http2.Http2ServerRequest} request
- * @property {module:http.ServerResponse|module:http2.Http2ServerResponse} response
- * @property {Record<string, unknown>} data
- * @property {boolean} completed
- * @property {() => void} complete
- * @property {() => boolean} isCompleted
- */
-
 const KEY_STAGE = Symbol('stage');
 
 export default class Fl32_Web_Back_PipelineEngine {
     /* eslint-disable jsdoc/require-param-description,jsdoc/check-param-names */
     /**
-     * @param {Fl32_Web_Back_PipelineEngineConstructorParams} params
+     * @param {object} params
+     * @param {Fl32_Web_Back_Dto_RequestContext$Factory} params.dtoRequestContextFactory
+     * @param {Fl32_Web_Back_Logger} params.logger
+     * @param {Fl32_Web_Back_Helper_Respond} params.respond
+     * @param {Fl32_Web_Back_Helper_Order_Kahn} params.helpOrder
+     * @param {Fl32_Web_Back_Enum_Stage} params.STAGE
      */
     constructor(
         {
+            dtoRequestContextFactory,
             logger,
             respond,
             helpOrder,
@@ -57,24 +46,23 @@ export default class Fl32_Web_Back_PipelineEngine {
         let isLocked = false;
 
         /**
-         * @param {module:http.IncomingMessage|module:http2.Http2ServerRequest} request
-         * @param {module:http.ServerResponse|module:http2.Http2ServerResponse} response
-         * @returns {Fl32_Web_Back_PipelineEngine_RequestContext}
+         * @param {Fl32_Web_Node_Http_IncomingMessage|Fl32_Web_Node_Http2_ServerRequest} request
+         * @param {Fl32_Web_Back_Response_Target} response
+         * @returns {Fl32_Web_Back_Dto_RequestContext}
          */
         function createRequestContext(request, response) {
             let completed = false;
-            /** @type {Fl32_Web_Back_PipelineEngine_RequestContext & {[KEY_STAGE]: string|null}} */
-            const context = {
-                request,
-                response,
-                data: {},
-                completed: false,
-                complete: () => {
-                    context.completed = true;
-                },
-                isCompleted: () => completed,
-                [KEY_STAGE]: null,
+            /** @type {Fl32_Web_Back_Dto_RequestContext & {[KEY_STAGE]: string|null}} */
+            const context = dtoRequestContextFactory.create();
+            context.request = request;
+            context.response = response;
+            context.data = {};
+            context.completed = false;
+            context.complete = () => {
+                context.completed = true;
             };
+            context.isCompleted = () => completed;
+            context[KEY_STAGE] = null;
 
             Object.defineProperty(context, 'completed', {
                 configurable: false,
@@ -104,7 +92,7 @@ export default class Fl32_Web_Back_PipelineEngine {
         /**
          * @param {Fl32_Web_Back_Api_Handler} handler
          * @param {string} stage
-         * @param {Fl32_Web_Back_PipelineEngine_RequestContext & {[KEY_STAGE]: string|null}} context
+         * @param {Fl32_Web_Back_Dto_RequestContext & {[KEY_STAGE]: string|null}} context
          * @returns {Promise<void>}
          */
         async function runHandler(handler, stage, context) {
@@ -166,15 +154,15 @@ export default class Fl32_Web_Back_PipelineEngine {
         this.registerHandler = (handler) => this.addHandler(handler);
 
         /**
-         * @param {module:http.IncomingMessage|module:http2.Http2ServerRequest} req
-         * @param {module:http.ServerResponse|module:http2.Http2ServerResponse} res
+         * @param {Fl32_Web_Node_Http_IncomingMessage|Fl32_Web_Node_Http2_ServerRequest} req
+         * @param {Fl32_Web_Back_Response_Target} res
          * @returns {Promise<void>}
          */
         this.onEventRequest = async function (req, res) {
             if (!isLocked) {
                 this.orderHandlers();
             }
-            /** @type {Fl32_Web_Back_PipelineEngine_RequestContext & {[KEY_STAGE]: string|null}} */
+            /** @type {Fl32_Web_Back_Dto_RequestContext & {[KEY_STAGE]: string|null}} */
             const context = createRequestContext(req, res);
 
             try {
@@ -219,8 +207,8 @@ export default class Fl32_Web_Back_PipelineEngine {
         };
 
         /**
-         * @param {module:http.IncomingMessage|module:http2.Http2ServerRequest} req
-         * @param {module:http.ServerResponse|module:http2.Http2ServerResponse} res
+         * @param {Fl32_Web_Node_Http_IncomingMessage|Fl32_Web_Node_Http2_ServerRequest} req
+         * @param {Fl32_Web_Back_Response_Target} res
          * @returns {Promise<void>}
          */
         this.handleRequest = async (req, res) => this.onEventRequest(req, res);

package/src/Back/Server.mjs

@@ -7,32 +7,28 @@
 export const __deps__ = Object.freeze({
     http: 'node_http',
     http2: 'node_http2',
-    DEF: 'Fl32_Web_Back_Defaults$',
+    config: 'Fl32_Web_Back_Config_Runtime$',
     logger: 'Fl32_Web_Back_Logger$',
     pipelineEngine: 'Fl32_Web_Back_PipelineEngine$',
     SERVER_TYPE: 'Fl32_Web_Back_Enum_Server_Type$',
 });
 
-/**
- * @typedef {object} Fl32_Web_Back_ServerConstructorParams
- * @property {typeof import('node:http')} http
- * @property {typeof import('node:http2')} http2
- * @property {import('./Defaults.mjs').default} DEF
- * @property {Fl32_Web_Back_Logger} logger
- * @property {Fl32_Web_Back_PipelineEngine} pipelineEngine
- * @property {Fl32_Web_Back_Enum_Server_Type} SERVER_TYPE
- */
-
 export default class Fl32_Web_Back_Server {
     /* eslint-disable jsdoc/require-param-description,jsdoc/check-param-names */
     /**
-     * @param {Fl32_Web_Back_ServerConstructorParams} deps
+     * @param {object} deps
+     * @param {Fl32_Web_Node_Http} deps.http
+     * @param {Fl32_Web_Node_Http2} deps.http2
+     * @param {Fl32_Web_Back_Config_Runtime} deps.config
+     * @param {Fl32_Web_Back_Logger} deps.logger
+     * @param {Fl32_Web_Back_PipelineEngine} deps.pipelineEngine
+     * @param {Fl32_Web_Back_Enum_Server_Type} deps.SERVER_TYPE
      */
     constructor(
         {
             http,
             http2,
-            DEF,
+            config,
             logger,
             pipelineEngine,
             SERVER_TYPE,
@@ -42,25 +38,26 @@ export default class Fl32_Web_Back_Server {
         // VARS
         const { createServer } = http;
         const { createServer: createServerH2, createSecureServer } = http2;
-        /** @type {module:http.Server} */
+        /** @type {Fl32_Web_Node_Http_Server} */
         let _instance;
 
         // MAIN
         /**
-         * @returns {module:http.Server}
+         * @returns {Fl32_Web_Node_Http_Server}
          */
         this.getInstance = () => _instance;
 
         /**
          * Starts the server with optional configuration.
-         * @param {Fl32_Web_Back_Server_Config} [cfg]
+         * @param {Fl32_Web_Back_Config_Runtime_Server} [cfg]
          * @returns {Promise<void>}
          */
         this.start = async function (cfg) {
             pipelineEngine.lockHandlers();
             // create server
-            const port = cfg?.port ?? DEF.PORT;
-            const type = cfg?.type ?? SERVER_TYPE.HTTP;
+            const port = cfg?.port ?? config.server.port;
+            const type = cfg?.type ?? config.server.type;
+            const tls = cfg?.tls ?? config.server.tls;
 
             if (type === SERVER_TYPE.HTTP2) {
                 _instance = createServerH2();
@@ -69,11 +66,11 @@ export default class Fl32_Web_Back_Server {
                 _instance = createServer({});
                 logger.info(`Starting server in HTTP/1 mode on port ${port}...`);
             } else if (type === SERVER_TYPE.HTTPS) {
-                if (!cfg.tls?.key || !cfg.tls?.cert) {
+                if (!tls?.key || !tls?.cert) {
                     logger.error('HTTPS server requires TLS key and certificate');
                     throw new Error('TLS key and certificate are required for HTTPS server');
                 }
-                _instance = createSecureServer(cfg.tls);
+                _instance = createSecureServer(tls);
                 logger.info(`Starting server in HTTPS (HTTP/2 + TLS) mode on port ${port}...`);
             } else {
                 logger.error(`Unsupported server type: ${type}`);

package/types.d.ts

@@ -1,8 +1,16 @@
 declare global {
   type Fl32_Web_Back_Api_Handler = import("./src/Back/Api/Handler.mjs").default;
-  type Fl32_Web_Back_Defaults = import("./src/Back/Defaults.mjs").default;
+  type Fl32_Web_Back_Config_Runtime = import("./src/Back/Config/Runtime.mjs").Data;
+  type Fl32_Web_Back_Config_Runtime$Factory = import("./src/Back/Config/Runtime.mjs").Factory;
+  type Fl32_Web_Back_Config_Runtime_Server = import("./src/Back/Config/Runtime.mjs").Server;
+  type Fl32_Web_Back_Config_Runtime_Tls = import("./src/Back/Config/Runtime/Tls.mjs").Data;
+  type Fl32_Web_Back_Config_Runtime_Tls$Factory = import("./src/Back/Config/Runtime/Tls.mjs").Factory;
+  type Fl32_Web_Back_Config_Runtime_Params = {server?: {port?: unknown, type?: unknown, tls?: unknown}};
+  type Fl32_Web_Back_Config_Runtime_Tls_Params = {ca?: unknown, cert?: unknown, key?: unknown};
   type Fl32_Web_Back_Dto_Info = import("./src/Back/Dto/Info.mjs").default;
   type Fl32_Web_Back_Dto_Info$Factory = import("./src/Back/Dto/Info.mjs").Factory;
+  type Fl32_Web_Back_Dto_RequestContext = import("./src/Back/Dto/RequestContext.mjs").default;
+  type Fl32_Web_Back_Dto_RequestContext$Factory = import("./src/Back/Dto/RequestContext.mjs").Factory;
   type Fl32_Web_Back_Dto_Source = import("./src/Back/Dto/Source.mjs").default;
   type Fl32_Web_Back_Dto_Source$Factory = import("./src/Back/Dto/Source.mjs").Factory;
   type Fl32_Web_Back_Enum_Server_Type = import("./src/Back/Enum/Server/Type.mjs").default;
@@ -10,8 +18,10 @@ declare global {
   type Fl32_Web_Back_Handler_Pre_Log = import("./src/Back/Handler/Pre/Log.mjs").default;
   type Fl32_Web_Back_Handler_Static = import("./src/Back/Handler/Static.mjs").default;
   type Fl32_Web_Back_Handler_Static_A_Config = import("./src/Back/Handler/Static/A/Config.mjs").default;
+  type Fl32_Web_Back_Handler_Static_A_Config_Value = {root: string, prefix: string, allow?: Record<string, string[]>, defaults: string[]};
   type Fl32_Web_Back_Handler_Static_A_Fallback = import("./src/Back/Handler/Static/A/Fallback.mjs").default;
   type Fl32_Web_Back_Handler_Static_A_FileService = import("./src/Back/Handler/Static/A/FileService.mjs").default;
+  type Fl32_Web_Back_Handler_Static_A_Match = {config: Fl32_Web_Back_Handler_Static_A_Config_Value, rel: string};
   type Fl32_Web_Back_Handler_Static_A_Registry = import("./src/Back/Handler/Static/A/Registry.mjs").default;
   type Fl32_Web_Back_Handler_Static_A_Resolver = import("./src/Back/Handler/Static/A/Resolver.mjs").default;
   type Fl32_Web_Back_Helper_Cast = import("./src/Back/Helper/Cast.mjs").default;
@@ -20,11 +30,19 @@ declare global {
   type Fl32_Web_Back_Helper_Respond = import("./src/Back/Helper/Respond.mjs").default;
   type Fl32_Web_Back_Logger = import("./src/Back/Logger.mjs").default;
   type Fl32_Web_Back_PipelineEngine = import("./src/Back/PipelineEngine.mjs").default;
+  type Fl32_Web_Back_Response_Body = string | object;
+  type Fl32_Web_Back_Response_Headers = {[key: string]: string};
+  type Fl32_Web_Back_Response_Target = Fl32_Web_Node_Http_ServerResponse | Fl32_Web_Node_Http2_ServerResponse;
   type Fl32_Web_Back_Server = import("./src/Back/Server.mjs").default;
-  type Fl32_Web_Back_Server_Config = import("./src/Back/Server/Config.mjs").default;
-  type Fl32_Web_Back_Server_Config$Factory = import("./src/Back/Server/Config.mjs").Factory;
-  type Fl32_Web_Back_Server_Config_Tls = import("./src/Back/Server/Config/Tls.mjs").default;
-  type Fl32_Web_Back_Server_Config_Tls$Factory = import("./src/Back/Server/Config/Tls.mjs").Factory;
+  type Fl32_Web_Node_Fs = typeof import("node:fs");
+  type Fl32_Web_Node_Http = typeof import("node:http");
+  type Fl32_Web_Node_Http_Server = import("node:http").Server;
+  type Fl32_Web_Node_Http_IncomingMessage = import("node:http").IncomingMessage;
+  type Fl32_Web_Node_Http_ServerResponse = import("node:http").ServerResponse;
+  type Fl32_Web_Node_Http2 = typeof import("node:http2");
+  type Fl32_Web_Node_Http2_ServerRequest = import("node:http2").Http2ServerRequest;
+  type Fl32_Web_Node_Http2_ServerResponse = import("node:http2").Http2ServerResponse;
+  type Fl32_Web_Node_Path = typeof import("node:path");
 }
 
 export {};

package/src/Back/Defaults.mjs

@@ -1,11 +0,0 @@
-// @ts-check
-
-/**
- * Plugin constants (hardcoded configuration) for backend code.
- */
-export default class Fl32_Web_Back_Defaults {
-    constructor() {
-        this.PORT = 3000;
-        Object.freeze(this);
-    }
-}

package/src/Back/Server/Config/Tls.mjs

@@ -1,57 +0,0 @@
-// @ts-check
-
-export const __deps__ = Object.freeze({
-    cast: 'Fl32_Web_Back_Helper_Cast$',
-});
-
-/**
- * @typedef {object} Fl32_Web_Back_Server_Config_TlsFactoryParams
- * @property {Fl32_Web_Back_Helper_Cast} cast
- */
-
-export default class Fl32_Web_Back_Server_Config_Tls {
-    /**
-     * Trusted CA certificates in PEM format.
-     * @type {string|undefined}
-     */
-    ca;
-
-    /**
-     * Certificate in PEM format.
-     * @type {string}
-     */
-    cert;
-
-    /**
-     * Private key in PEM format.
-     * @type {string}
-     */
-    key;
-}
-
-export class Factory {
-    /* eslint-disable jsdoc/require-param-description,jsdoc/check-param-names */
-    /**
-     * @param {Fl32_Web_Back_Server_Config_TlsFactoryParams} params
-     */
-    constructor(
-        {
-            cast,
-        }
-    ) {
-        /* eslint-enable jsdoc/require-param-description,jsdoc/check-param-names */
-        /**
-         * @param {*} [data]
-         * @returns {Fl32_Web_Back_Server_Config_Tls}
-         */
-        this.create = function (data) {
-            const res = new Fl32_Web_Back_Server_Config_Tls();
-            if (data) {
-                res.ca = cast.string(data?.ca);
-                res.cert = cast.string(data.cert);
-                res.key = cast.string(data.key);
-            }
-            return Object.freeze(res);
-        };
-    }
-}

package/src/Back/Server/Config.mjs

@@ -1,69 +0,0 @@
-// @ts-check
-
-export const __deps__ = Object.freeze({
-    cast: 'Fl32_Web_Back_Helper_Cast$',
-    SERVER_TYPE: 'Fl32_Web_Back_Enum_Server_Type$',
-    tlsFactory: 'Fl32_Web_Back_Server_Config_Tls__Factory$',
-});
-
-/**
- * @typedef {object} Fl32_Web_Back_Server_ConfigFactoryParams
- * @property {Fl32_Web_Back_Helper_Cast} cast
- * @property {Fl32_Web_Back_Enum_Server_Type} SERVER_TYPE
- * @property {Fl32_Web_Back_Server_Config_Tls$Factory} tlsFactory
- */
-
-export default class Fl32_Web_Back_Server_Config {
-    /**
-     * Port to listening (3000).
-     *
-     * @type {number}
-     */
-    port;
-    /**
-     * @type {string}
-     * @see Fl32_Web_Back_Enum_Server_Type
-     */
-    type;
-    /**
-     * TLS configuration for HTTPS server.
-     * @type {Fl32_Web_Back_Server_Config_Tls|undefined}
-     */
-    tls;
-}
-
-export class Factory {
-    /* eslint-disable jsdoc/require-param-description,jsdoc/check-param-names */
-    /**
-     * @param {Fl32_Web_Back_Server_ConfigFactoryParams} params
-     */
-    constructor(
-        {
-            cast,
-            SERVER_TYPE,
-            tlsFactory,
-        }
-    ) {
-        /* eslint-enable jsdoc/require-param-description,jsdoc/check-param-names */
-        /**
-         * @param {Fl32_Web_Back_Server_Config|object} [data]
-         * @returns {Fl32_Web_Back_Server_Config}
-         */
-        this.create = function (data) {
-            const res = new Fl32_Web_Back_Server_Config();
-            if (data) {
-                res.port = cast.int(data.port);
-                res.type = cast.enum(data.type, SERVER_TYPE, {lower: true});
-
-                if (data.tls) {
-                    res.tls = tlsFactory.create(data.tls);
-                }
-
-                if (res.type === SERVER_TYPE.HTTPS && !res.tls) {
-                    throw new Error('TLS configuration is required for HTTPS server type');
-                }
-            }
-            return Object.freeze(res);
-        };
-    }
-}