@flancer32/teq-web 0.10.0 → 0.11.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [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/ai/abstractions.md

@@ -22,7 +22,7 @@ Default transport settings come from flat fields of `Fl32_Web_Back_Config_Runtim
 - `http2`
 - `https`
 
-`https` requires `server.tls`.
+`https` requires `config.tls` to contain both `key` and `cert`.
 
 ## Handler Contract
 
@@ -63,7 +63,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

@@ -6,17 +6,17 @@ This example shows the preferred TeqFW-style usage path: external code resolves
 // App/Web/Handler/Hello.mjs
 // @ts-check
 
-export const __deps__ = {
+export const __deps__ = Object.freeze({
+    default: Object.freeze({}),
     dtoInfoFactory: 'Fl32_Web_Back_Dto_Info__Factory$',
     STAGE: 'Fl32_Web_Back_Enum_Stage$',
-};
+});
 
 export default class App_Web_Handler_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({
@@ -40,19 +40,19 @@ export default class App_Web_Handler_Hello {
 // App/Web/Server/Start.mjs
 // @ts-check
 
-export const __deps__ = {
+export const __deps__ = Object.freeze({
+    default: Object.freeze({}),
     pipeline: 'Fl32_Web_Back_PipelineEngine$',
     server: 'Fl32_Web_Back_Server$',
     helloHandler: 'App_Web_Handler_Hello$',
-};
+});
 
 export default class App_Web_Server_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 () {

package/ai/rules.md

@@ -42,3 +42,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.11.0",
   "description": "Server-side web request coordination infrastructure for TeqFW modular monolith applications.",
   "type": "module",
   "license": "Apache-2.0",

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

@@ -86,8 +86,8 @@ export class Factory {
  * `Factory` is the DI-managed component described by `__deps__`.
  */
 export const __deps__ = Object.freeze({
-    default: {},
-    Factory: {
+    default: Object.freeze({}),
+    Factory: Object.freeze({
         cast: 'Fl32_Web_Back_Helper_Cast$',
-    },
+    }),
 });

package/src/Back/Config/Runtime.mjs

@@ -70,10 +70,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 +86,7 @@ export class Factory {
             }
             Object.freeze(cfg);
             frozen = true;
+            return proxy;
         };
     }
 }
@@ -97,10 +98,10 @@ export class Factory {
  * `Factory` is the DI-managed component described by `__deps__`.
  */
 export const __deps__ = Object.freeze({
-    default: {},
-    Factory: {
+    default: Object.freeze({}),
+    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$',
-    },
+    }),
 });