@flancer32/teq-web 0.10.0 → 0.12.0

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## [0.12.0] - 2026-07-04 - Pipeline locking and transport contract alignment
+
+### Added
+- Added unit and integration coverage for direct request execution with an unlocked pipeline.
+- Added unit coverage for the request-context DTO contract.
+
+### Changed
+- Stopped pipeline processing when the response is no longer writable.
+- Required explicit handler locking before direct `PipelineEngine` request execution.
+- Clarified the transport model as plain HTTP plus secure web transport and aligned AI-facing documentation with the current server behavior.
+- Clarified that runtime-isolation guarantees apply to separate Node.js processes, not to multiple containers within one process.
+- Updated package version metadata to `0.12.0`.
+
+## [0.11.0] - 2026-04-01 - TeqFW spec alignment and runtime contract updates
+
+### Added
+- Added TeqFW specification documents for DI usage, ES module conventions, and package metadata expectations.
+
+### Changed
+- Reworked runtime configuration docs and examples to follow the current spec-level contract.
+- Tightened runtime configuration implementation and unit tests to match the updated contract.
+- Replaced legacy TeqFW convention documents with the current spec-oriented documentation layout.
+- Updated package version metadata to `0.11.0`.
+
 ## [0.10.0] - 2026-03-31 - Validator conformance and release preparation
 
 ### Changed

package/README.md

@@ -4,7 +4,7 @@ Infrastructure web server and deterministic request pipeline for TeqFW packages.
 
 `@flancer32/teq-web` is an infrastructural component of the **Tequila Framework (TeqFW)** platform.
 
-The package provides a deterministic **request lifecycle pipeline** and a built-in **Node.js web server** that other TeqFW packages can use as the runtime environment for processing HTTP requests.
+The package provides a deterministic **request lifecycle pipeline** and a built-in **Node.js web server** that other TeqFW packages can use as the runtime environment for processing web requests.
 
 Within the TeqFW ecosystem, this package plays a role similar to how **Express** or **Fastify** are used in typical Node.js applications: it acts as the **web runtime layer** used by higher-level packages.
 
@@ -96,6 +96,12 @@ Supported server types:
 - `http2`
 - `https`
 
+Mode meaning:
+
+- `http` is plain HTTP
+- `http2` is cleartext HTTP/2
+- `https` is secure web transport using the Node.js secure HTTP/2 server with HTTP/1.1 fallback when negotiated by the client
+
 The server locks the handler pipeline before entering the execution phase.
 
 ### Handlers
@@ -113,14 +119,14 @@ Handlers do not coordinate with each other directly. Execution order is derived
 ## Example (TeqFW Style)
 
 ```javascript
-// App/Web/Handler/Hello.mjs
+// src/Handler/Hello.mjs
 
-export const __deps__ = {
-  dtoInfoFactory: "Fl32_Web_Back_Dto_Info__Factory$",
-  STAGE: "Fl32_Web_Back_Enum_Stage$",
-};
+/**
+ * @namespace App_Web_Handler_Hello
+ * @description Example PROCESS handler
+ */
 
-export default class App_Web_Handler_Hello {
+export default class Hello {
   constructor({ dtoInfoFactory, STAGE }) {
     const info = dtoInfoFactory.create({
       name: "App_Web_Handler_Hello",
@@ -139,18 +145,22 @@ export default class App_Web_Handler_Hello {
     };
   }
 }
+
+export const __deps__ = Object.freeze({
+  dtoInfoFactory: "Fl32_Web_Back_Dto_Info__Factory$",
+  STAGE: "Fl32_Web_Back_Enum_Stage$",
+});
 ```
 
 ```javascript
-// App/Web/Server/Start.mjs
+// src/Server/Start.mjs
 
-export const __deps__ = {
-  pipeline: "Fl32_Web_Back_PipelineEngine$",
-  server: "Fl32_Web_Back_Server$",
-  helloHandler: "App_Web_Handler_Hello$",
-};
+/**
+ * @namespace App_Web_Server_Start
+ * @description Example application entry service
+ */
 
-export default class App_Web_Server_Start {
+export default class Start {
   constructor({ pipeline, server, helloHandler }) {
     this.execute = async function () {
       pipeline.addHandler(helloHandler);
@@ -162,6 +172,12 @@ export default class App_Web_Server_Start {
     };
   }
 }
+
+export const __deps__ = Object.freeze({
+  pipeline: "Fl32_Web_Back_PipelineEngine$",
+  server: "Fl32_Web_Back_Server$",
+  helloHandler: "App_Web_Handler_Hello$",
+});
 ```
 
 Application entry point:

package/ai/abstractions.md

@@ -10,7 +10,7 @@ Main methods:
 
 - `addHandler(handler)` or `registerHandler(handler)` registers a handler before the pipeline is locked;
 - `lockHandlers()` freezes handler order explicitly;
-- `onEventRequest(req, res)` or `handleRequest(req, res)` executes one request lifecycle.
+- `onEventRequest(req, res)` or `handleRequest(req, res)` executes one request lifecycle after the pipeline has been locked.
 
 ## Server
 
@@ -22,7 +22,13 @@ Default transport settings come from flat fields of `Fl32_Web_Back_Config_Runtim
 - `http2`
 - `https`
 
-`https` requires `server.tls`.
+Mode meaning:
+
+- `http` is plain HTTP.
+- `http2` is cleartext HTTP/2.
+- `https` is secure web transport implemented through the Node.js secure `http2` server and may negotiate `HTTP/2` or fall back to `HTTP/1.1`.
+
+`https` requires `config.tls` to contain both `key` and `cert`.
 
 ## Handler Contract
 
@@ -63,7 +69,7 @@ Only `PROCESS` handlers may mark the request as completed.
 
 ## Built-in Static Handler
 
-`Fl32_Web_Back_Handler_Static$` is a PROCESS-stage handler for static file delivery. Before use, call `init({sources})` with source DTOs created by `Fl32_Web_Back_Dto_Source$Factory`.
+`Fl32_Web_Back_Handler_Static$` is a PROCESS-stage handler for static file delivery. Before use, call `init({sources})` with source DTOs created by `Fl32_Web_Back_Dto_Source__Factory$`.
 
 Each source describes:
 

package/ai/examples/minimal-server.md

@@ -3,20 +3,19 @@
 This example shows the preferred TeqFW-style usage path: external code resolves one application service from the container, and that service receives web infrastructure through constructor injection.
 
 ```js
-// App/Web/Handler/Hello.mjs
+// src/Handler/Hello.mjs
 // @ts-check
 
-export const __deps__ = {
-    dtoInfoFactory: 'Fl32_Web_Back_Dto_Info__Factory$',
-    STAGE: 'Fl32_Web_Back_Enum_Stage$',
-};
+/**
+ * @namespace App_Web_Handler_Hello
+ * @description Example PROCESS handler
+ */
 
-export default class App_Web_Handler_Hello {
+export default class Hello {
     /**
-     * @param {{
-     *   dtoInfoFactory: Fl32_Web_Back_Dto_Info$Factory,
-     *   STAGE: Fl32_Web_Back_Enum_Stage,
-     * }} deps
+     * @param {object} deps
+     * @param {Fl32_Web_Back_Dto_Info$Factory} deps.dtoInfoFactory
+     * @param {Fl32_Web_Back_Enum_Stage} deps.STAGE
      */
     constructor({dtoInfoFactory, STAGE}) {
         const info = dtoInfoFactory.create({
@@ -34,25 +33,28 @@ export default class App_Web_Handler_Hello {
         };
     }
 }
+
+export const __deps__ = Object.freeze({
+    dtoInfoFactory: 'Fl32_Web_Back_Dto_Info__Factory$',
+    STAGE: 'Fl32_Web_Back_Enum_Stage$',
+});
 ```
 
 ```js
-// App/Web/Server/Start.mjs
+// src/Server/Start.mjs
 // @ts-check
 
-export const __deps__ = {
-    pipeline: 'Fl32_Web_Back_PipelineEngine$',
-    server: 'Fl32_Web_Back_Server$',
-    helloHandler: 'App_Web_Handler_Hello$',
-};
+/**
+ * @namespace App_Web_Server_Start
+ * @description Example application entry service
+ */
 
-export default class App_Web_Server_Start {
+export default class Start {
     /**
-     * @param {{
-     *   pipeline: Fl32_Web_Back_PipelineEngine,
-     *   server: Fl32_Web_Back_Server,
-     *   helloHandler: App_Web_Handler_Hello,
-     * }} deps
+     * @param {object} deps
+     * @param {Fl32_Web_Back_PipelineEngine} deps.pipeline
+     * @param {Fl32_Web_Back_Server} deps.server
+     * @param {App_Web_Handler_Hello} deps.helloHandler
      */
     constructor({pipeline, server, helloHandler}) {
         this.execute = async function () {
@@ -61,6 +63,12 @@ export default class App_Web_Server_Start {
         };
     }
 }
+
+export const __deps__ = Object.freeze({
+    pipeline: 'Fl32_Web_Back_PipelineEngine$',
+    server: 'Fl32_Web_Back_Server$',
+    helloHandler: 'App_Web_Handler_Hello$',
+});
 ```
 
 ```js
@@ -75,5 +83,5 @@ Consumer notes:
 - 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 `{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$`.
+- If your application already has its own transport layer, inject `Fl32_Web_Back_PipelineEngine$`, call `pipeline.lockHandlers()` during startup, and only then call `pipeline.onEventRequest(req, res)` from that adapter.
 - A correct PROCESS handler ends the response and then marks the context completed.

package/ai/overview.md

@@ -10,7 +10,7 @@ Runtime startup configuration is exposed through `Fl32_Web_Back_Config_Runtime$`
 
 Use this package when external code needs one of these roles:
 
-- accept HTTP, HTTPS, or HTTP/2 requests with the built-in server;
+- accept plain HTTP requests or secure web requests with the built-in server;
 - run request handlers through a fixed three-stage lifecycle;
 - register multiple independent handlers with deterministic ordering;
 - serve static files through the built-in PROCESS-stage handler.

package/ai/rules.md

@@ -32,7 +32,8 @@
 - Runtime is Node.js 20 or newer.
 - The package is intended for long-running server processes.
 - Process supervision, restart, scaling, reverse proxying, and load balancing are external concerns.
-- Multiple instances may run concurrently, but they are independent and must not rely on shared in-memory state.
+- Independent deployment instances should run as separate Node.js processes and must not rely on shared in-memory state between processes.
+- The package does not guarantee isolated runtime-configuration state for multiple containers or runtime assemblies inside the same process.
 
 ## DI Usage Rules
 
@@ -42,3 +43,4 @@
 - TLS startup configuration belongs to the dedicated runtime component `Fl32_Web_Back_Config_Runtime_Tls$`, even though consumers read it through `config.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.
+- Use `Object.freeze({})` for `__deps__` declarations in examples and application code that is meant to be container-managed.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flancer32/teq-web",
-  "version": "0.10.0",
+  "version": "0.12.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.4.0"
+    "@teqfw/di": "^2.6.2"
   },
   "devDependencies": {
     "@types/node": "^25.4.0"

package/src/Back/Api/Handler.mjs

@@ -1,9 +1,10 @@
+// @ts-check
+
 /**
- * Interface for web request handlers used by the Pipeline Engine.
- *
+ * @namespace Fl32_Web_Back_Api_Handler
+ * @description Interface for web request handlers used by the Pipeline Engine.
  * @interface
  */
-// @ts-check
 export default class Fl32_Web_Back_Api_Handler {
     constructor() {
         /**

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

@@ -1,7 +1,9 @@
+// @ts-check
+
 /**
- * TLS runtime configuration wrapper and factory wiring.
+ * @namespace Fl32_Web_Back_Config_Runtime_Tls
+ * @description TLS runtime configuration wrapper and factory wiring.
  */
-// @ts-check
 
 export class Data {
     /** @type {string|undefined} */
@@ -12,6 +14,15 @@ export class Data {
     key;
 }
 
+export class Params {
+    /** @type {unknown|undefined} */
+    ca;
+    /** @type {unknown|undefined} */
+    cert;
+    /** @type {unknown|undefined} */
+    key;
+}
+
 /** @type {Fl32_Web_Back_Config_Runtime_Tls} */
 const cfg = new Data();
 let frozen = false;
@@ -52,7 +63,7 @@ export class Factory {
      */
     constructor({cast}) {
         /**
-         * @param {Fl32_Web_Back_Config_Runtime_Tls_Params} [params]
+         * @param {Fl32_Web_Back_Config_Runtime_Tls__Params} [params]
          */
         this.configure = function (params = {}) {
             if (frozen) throw new Error('Runtime configuration is frozen.');
@@ -86,8 +97,7 @@ export class Factory {
  * `Factory` is the DI-managed component described by `__deps__`.
  */
 export const __deps__ = Object.freeze({
-    default: {},
-    Factory: {
+    Factory: Object.freeze({
         cast: 'Fl32_Web_Back_Helper_Cast$',
-    },
+    }),
 });

package/src/Back/Config/Runtime.mjs

@@ -1,7 +1,9 @@
+// @ts-check
+
 /**
- * Runtime configuration wrapper and factory wiring.
+ * @namespace Fl32_Web_Back_Config_Runtime
+ * @description Runtime configuration wrapper and factory wiring.
  */
-// @ts-check
 
 export class Data {
     /** @type {number|undefined} */
@@ -50,7 +52,7 @@ export class Factory {
      * @param {object} deps
      * @param {Fl32_Web_Back_Helper_Cast} deps.cast
      * @param {Fl32_Web_Back_Enum_Server_Type} deps.SERVER_TYPE
-     * @param {Fl32_Web_Back_Config_Runtime_Tls$Factory} deps.tlsFactory
+     * @param {Fl32_Web_Back_Config_Runtime_Tls__Factory} deps.tlsFactory
      */
     constructor({cast, SERVER_TYPE, tlsFactory}) {
         /**
@@ -70,10 +72,10 @@ export class Factory {
         };
 
         /**
-         * @returns {void}
+         * @returns {Fl32_Web_Back_Config_Runtime}
          */
         this.freeze = function () {
-            if (frozen) return;
+            if (frozen) return proxy;
             if (cfg.port === undefined) cfg.port = 3000;
             if (cfg.type === undefined) cfg.type = SERVER_TYPE.HTTP;
             const tls = tlsFactory.freeze();
@@ -86,6 +88,7 @@ export class Factory {
             }
             Object.freeze(cfg);
             frozen = true;
+            return proxy;
         };
     }
 }
@@ -97,10 +100,9 @@ export class Factory {
  * `Factory` is the DI-managed component described by `__deps__`.
  */
 export const __deps__ = Object.freeze({
-    default: {},
-    Factory: {
+    Factory: Object.freeze({
         cast: 'Fl32_Web_Back_Helper_Cast$',
         SERVER_TYPE: 'Fl32_Web_Back_Enum_Server_Type$',
         tlsFactory: 'Fl32_Web_Back_Config_Runtime_Tls__Factory$',
-    },
+    }),
 });

package/src/Back/Dto/Info.mjs

@@ -1,7 +1,9 @@
+// @ts-check
+
 /**
- * DTO describing handler registration and ordering metadata.
+ * @namespace Fl32_Web_Back_Dto_Info
+ * @description DTO describing handler registration and ordering metadata.
  */
-// @ts-check
 export default class Fl32_Web_Back_Dto_Info {
     /**
      * Handlers to run before this one.
@@ -56,7 +58,6 @@ export class Factory {
  * DTO dependencies.
  */
 export const __deps__ = Object.freeze({
-    default: {},
     Factory: {
         cast: 'Fl32_Web_Back_Helper_Cast$',
         STAGE: 'Fl32_Web_Back_Enum_Stage$',

package/src/Back/Dto/RequestContext.mjs

@@ -1,7 +1,9 @@
+// @ts-check
+
 /**
- * Request context passed through the pipeline lifecycle.
+ * @namespace Fl32_Web_Back_Dto_RequestContext
+ * @description Request context passed through the pipeline lifecycle.
  */
-// @ts-check
 export default class Fl32_Web_Back_Dto_RequestContext {
     constructor() {
         /** @type {Fl32_Web_Node_Http_IncomingMessage|Fl32_Web_Node_Http2_ServerRequest} */

package/src/Back/Dto/Source.mjs

@@ -1,7 +1,9 @@
+// @ts-check
+
 /**
- * Source DTO for static handler configuration.
+ * @namespace Fl32_Web_Back_Dto_Source
+ * @description Source DTO for static handler configuration.
  */
-// @ts-check
 export default class Fl32_Web_Back_Dto_Source {
     /** @type {string} */
     root;
@@ -43,7 +45,6 @@ export class Factory {
 }
 
 export const __deps__ = Object.freeze({
-    default: {},
     Factory: {
         cast: 'Fl32_Web_Back_Helper_Cast$',
     },

package/src/Back/Enum/Server/Type.mjs

@@ -1,7 +1,9 @@
+// @ts-check
+
 /**
- * Enum-like DTO for built-in server transport modes.
+ * @namespace Fl32_Web_Back_Enum_Server_Type
+ * @description Enum-like DTO for built-in server transport modes.
  */
-// @ts-check
 export default class Fl32_Web_Back_Enum_Server_Type {
     constructor() {
         this.HTTP2 = 'http2';

package/src/Back/Enum/Stage.mjs

@@ -1,7 +1,9 @@
+// @ts-check
+
 /**
- * Enum-like DTO for web request processing stages.
+ * @namespace Fl32_Web_Back_Enum_Stage
+ * @description Enum-like DTO for web request processing stages.
  */
-// @ts-check
 export default class Fl32_Web_Back_Enum_Stage {
     constructor() {
         this.INIT = 'INIT';

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

@@ -1,14 +1,15 @@
+// @ts-check
+
 /**
- * Logs basic request information at the beginning of the request lifecycle.
- *
+ * @namespace Fl32_Web_Back_Handler_Pre_Log
+ * @description Logs basic request information at the beginning of the request lifecycle.
  * @implements Fl32_Web_Back_Api_Handler
  */
-// @ts-check
 export default class Fl32_Web_Back_Handler_Pre_Log {
     /**
      * @param {object} deps
      * @param {Fl32_Web_Back_Logger} deps.logger
-     * @param {Fl32_Web_Back_Dto_Info$Factory} deps.dtoInfoFactory
+     * @param {Fl32_Web_Back_Dto_Info__Factory} deps.dtoInfoFactory
      * @param {Fl32_Web_Back_Enum_Stage} deps.STAGE
      */
     constructor({logger, dtoInfoFactory, STAGE}) {

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

@@ -1,7 +1,9 @@
+// @ts-check
+
 /**
- * Static asset config factory.
+ * @namespace Fl32_Web_Back_Handler_Static_A_Config
+ * @description Static asset config factory.
  */
-// @ts-check
 export default class Fl32_Web_Back_Handler_Static_A_Config {
     static DEFAULT_FILES = ['index.html', 'index.htm', 'index.txt'];
     /**
@@ -14,7 +16,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 {Fl32_Web_Back_Handler_Static_A_Config_Value}
+         * @returns {Fl32_Web_Back_Handler_Static_A_Config__Value}
          * @throws {Error} When required fields are missing or invalid.
          */
         this.create = (dto) => {
@@ -56,6 +58,17 @@ export default class Fl32_Web_Back_Handler_Static_A_Config {
     }
 }
 
+export class Value {
+    /** @type {string} */
+    root;
+    /** @type {string} */
+    prefix;
+    /** @type {Record<string, string[]>|undefined} */
+    allow;
+    /** @type {string[]} */
+    defaults;
+}
+
 /**
  * Dependencies for the static config factory.
  */

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

@@ -1,7 +1,9 @@
+// @ts-check
+
 /**
- * Static asset fallback helper.
+ * @namespace Fl32_Web_Back_Handler_Static_A_Fallback
+ * @description Static asset fallback helper.
  */
-// @ts-check
 export default class Fl32_Web_Back_Handler_Static_A_Fallback {
     /**
      * @param {object} deps

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

@@ -1,7 +1,9 @@
+// @ts-check
+
 /**
- * Static file service.
+ * @namespace Fl32_Web_Back_Handler_Static_A_FileService
+ * @description Static file service.
  */
-// @ts-check
 export default class Fl32_Web_Back_Handler_Static_A_FileService {
     /**
      * @param {object} deps
@@ -19,7 +21,7 @@ export default class Fl32_Web_Back_Handler_Static_A_FileService {
         /**
          * Serve a file for given config and relative path.
          *
-         * @param {Fl32_Web_Back_Handler_Static_A_Config_Value} config
+         * @param {Fl32_Web_Back_Handler_Static_A_Config__Value} config
          * @param {string} rel
          * @param {Fl32_Web_Node_Http_IncomingMessage|Fl32_Web_Node_Http2_ServerRequest} req
          * @param {Fl32_Web_Back_Response_Target} res

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

@@ -1,7 +1,9 @@
+// @ts-check
+
 /**
- * Static configuration registry.
+ * @namespace Fl32_Web_Back_Handler_Static_A_Registry
+ * @description Static configuration registry.
  */
-// @ts-check
 export default class Fl32_Web_Back_Handler_Static_A_Registry {
     /**
      * @param {object} deps
@@ -34,7 +36,7 @@ export default class Fl32_Web_Back_Handler_Static_A_Registry {
          * Find configuration by matching URL prefix.
          *
          * @param {string} url
-         * @returns {Fl32_Web_Back_Handler_Static_A_Match|null}
+         * @returns {Fl32_Web_Back_Handler_Static_A_Registry__Match|null}
          */
         this.find = function (url) {
             for (const cfg of _configs) {
@@ -48,6 +50,13 @@ export default class Fl32_Web_Back_Handler_Static_A_Registry {
     }
 }
 
+export class Match {
+    /** @type {Fl32_Web_Back_Handler_Static_A_Config__Value} */
+    config;
+    /** @type {string} */
+    rel;
+}
+
 /**
  * Dependencies for the static registry helper.
  */

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

@@ -1,7 +1,9 @@
+// @ts-check
+
 /**
- * Static path resolver.
+ * @namespace Fl32_Web_Back_Handler_Static_A_Resolver
+ * @description Static path resolver.
  */
-// @ts-check
 export default class Fl32_Web_Back_Handler_Static_A_Resolver {
     /**
      * @param {object} deps
@@ -12,7 +14,7 @@ export default class Fl32_Web_Back_Handler_Static_A_Resolver {
          * Resolve a filesystem path for given config and relative URL part.
          * Applies allow rules and prevents path traversal.
          *
-         * @param {Fl32_Web_Back_Handler_Static_A_Config_Value} 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

@@ -1,9 +1,10 @@
+// @ts-check
+
 /**
- * Universal static-file PROCESS handler.
- *
+ * @namespace Fl32_Web_Back_Handler_Static
+ * @description Universal static-file PROCESS handler.
  * @implements Fl32_Web_Back_Api_Handler
  */
-// @ts-check
 export default class Fl32_Web_Back_Handler_Static {
     /**
      * @param {object} deps
@@ -11,7 +12,7 @@ export default class Fl32_Web_Back_Handler_Static {
      * @param {Fl32_Web_Back_Handler_Static_A_FileService} deps.fileService
      * @param {Fl32_Web_Back_Helper_Respond} deps.respond
      * @param {Fl32_Web_Back_Logger} deps.logger
-     * @param {Fl32_Web_Back_Dto_Info$Factory} deps.dtoInfoFactory
+     * @param {Fl32_Web_Back_Dto_Info__Factory} deps.dtoInfoFactory
      * @param {Fl32_Web_Back_Enum_Stage} deps.STAGE
      */
     constructor({registry, fileService, respond, logger, dtoInfoFactory, STAGE}) {

package/src/Back/Helper/Cast.mjs

@@ -1,7 +1,9 @@
+// @ts-check
+
 /**
- * Cast helper used by runtime configuration and DTO factories.
+ * @namespace Fl32_Web_Back_Helper_Cast
+ * @description Cast helper used by runtime configuration and DTO factories.
  */
-// @ts-check
 export default class Fl32_Web_Back_Helper_Cast {
     constructor() {
         /**

package/src/Back/Helper/Mime.mjs

@@ -1,8 +1,10 @@
+// @ts-check
+
 /**
- * MIME type helper with built-in mapping for common file extensions.
+ * @namespace Fl32_Web_Back_Helper_Mime
+ * @description MIME type helper with built-in mapping for common file extensions.
  * Can be replaced or extended by the application via the DI container.
  */
-// @ts-check
 export default class Fl32_Web_Back_Helper_Mime {
     constructor() {
         /**

package/src/Back/Helper/Order/Kahn.mjs

@@ -1,7 +1,9 @@
+// @ts-check
+
 /**
- * Sorts named handlers by relative `before` / `after` constraints using Kahn's algorithm.
+ * @namespace Fl32_Web_Back_Helper_Order_Kahn
+ * @description Sorts named handlers by relative `before` / `after` constraints using Kahn's algorithm.
  */
-// @ts-check
 export default class Fl32_Web_Back_Helper_Order_Kahn {
     constructor() {
         /**

package/src/Back/Helper/Respond.mjs

@@ -1,7 +1,9 @@
+// @ts-check
+
 /**
- * HTTP response helper.
+ * @namespace Fl32_Web_Back_Helper_Respond
+ * @description HTTP response helper.
  */
-// @ts-check
 export default class Fl32_Web_Back_Helper_Respond {
     /**
      * @param {object} deps

package/src/Back/Logger.mjs

@@ -1,7 +1,9 @@
+// @ts-check
+
 /**
- * Simple logger implementation that delegates to the native console.
+ * @namespace Fl32_Web_Back_Logger
+ * @description Simple logger implementation that delegates to the native console.
  */
-// @ts-check
 export default class Fl32_Web_Back_Logger {
     constructor() {
         /**

package/src/Back/PipelineEngine.mjs

@@ -1,9 +1,10 @@
+// @ts-check
+
 /**
- * Pipeline Engine is the single request-lifecycle coordination component.
- * It executes handlers in three deterministic stages:
- * `INIT -> PROCESS -> FINALIZE`.
+ * @namespace Fl32_Web_Back_PipelineEngine
+ * @description Pipeline Engine is the single request-lifecycle coordination component.
+ * It executes handlers in three deterministic stages: `INIT -> PROCESS -> FINALIZE`.
  */
-// @ts-check
 
 const KEY_STAGE = Symbol('stage');
 
@@ -11,7 +12,7 @@ export default class Fl32_Web_Back_PipelineEngine {
     /* eslint-disable jsdoc/require-param-description,jsdoc/check-param-names */
     /**
      * @param {object} params
-     * @param {Fl32_Web_Back_Dto_RequestContext$Factory} params.dtoRequestContextFactory
+     * @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
@@ -144,7 +145,7 @@ export default class Fl32_Web_Back_PipelineEngine {
          */
         this.onEventRequest = async function (req, res) {
             if (!isLocked) {
-                this.orderHandlers();
+                throw new Error('Pipeline handlers must be locked before request execution');
             }
             /** @type {Fl32_Web_Back_Dto_RequestContext & {[KEY_STAGE]: string|null}} */
             const context = createRequestContext(req, res);
@@ -162,6 +163,10 @@ export default class Fl32_Web_Back_PipelineEngine {
                     if (context.isCompleted()) {
                         break;
                     }
+                    if (!respond.isWritable(res)) {
+                        context.completed = true;
+                        break;
+                    }
                     try {
                         await runHandler(handler, STAGE.PROCESS, context);
                     } catch (error) {

package/src/Back/Server.mjs

@@ -1,8 +1,10 @@
+// @ts-check
+
 /**
- * Web server implementation supporting HTTP/1 and HTTP/2 protocols.
+ * @namespace Fl32_Web_Back_Server
+ * @description Web server implementation supporting HTTP/1 and HTTP/2 protocols.
  * Handles incoming requests and delegates them to the Pipeline Engine.
  */
-// @ts-check
 export default class Fl32_Web_Back_Server {
     /**
      * @param {object} deps

package/types.d.ts

@@ -1,25 +1,25 @@
 declare global {
   type Fl32_Web_Back_Api_Handler = import("./src/Back/Api/Handler.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__Factory = import("./src/Back/Config/Runtime.mjs").Factory;
   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_Tls_Params = {ca?: unknown, cert?: unknown, key?: unknown};
+  type Fl32_Web_Back_Config_Runtime_Tls__Factory = import("./src/Back/Config/Runtime/Tls.mjs").Factory;
+  type Fl32_Web_Back_Config_Runtime_Tls__Params = import("./src/Back/Config/Runtime/Tls.mjs").Params;
   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_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_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_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;
   type Fl32_Web_Back_Enum_Stage = import("./src/Back/Enum/Stage.mjs").default;
   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_Config__Value = import("./src/Back/Handler/Static/A/Config.mjs").Value;
   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__Match = import("./src/Back/Handler/Static/A/Registry.mjs").Match;
   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;