libmodulor 0.10.0 → 0.11.0

package/CHANGELOG.md

@@ -1,15 +1,39 @@
 # CHANGELOG
 
+## v0.11.0 (2025-04-03)
+
+**BREAKING**
+
+- Remove `ContainerPrinter` : It was using internals of inversify v6. These internals are not present anymore in v7 and the maintainers were not convinced about adding something to list the bindings of a container. In prevision of the upgrade to v7, unfortunately, we remove it to keep things simple
+- Upgrade to express 5 : Unless you extended `NodeExpressServerManager` and did some special stuff, this should be transparent to you. Except bumping the version to `5.1.0`, there should be nothing to do. Otherwise, check the excellent [migration guide](https://expressjs.com/en/guide/migrating-5.html)
+
+**Fixed**
+
+- Return early when parent data type validation is not ok
+- Adjust the `npx libmodulor CreateProject` command
+
+**Misc**
+
+- Analyze the web bundle of `examples/supertrader` (`(cd examples/supertrader && yarn build:analyze:web)`)
+- Include data-types tables in `llms.txt`
+- Update UC input field when forcing the value in `rInput` (e.g. boolean set to false or array set to empty)
+
 ## v0.10.0 (2025-03-28)
 
+**Added**
+
+- Introduce `UCOutputFieldValueFragment` in `target/react` and `UCOutputFieldValue` in `target/react-(native|web)-pure` to display uc values using the `fmt()` method of each data type. `TBoolean.fmt()` has been adapted to display `✔️` when `true`, instead of `true|false` which are not very user friendly in a UI
+- Introduce `Year` data type
+
+**Fixed**
+
+- Adjust `fmt` of `THostPort` and `TTimestamp` (they shouldn't be formatted as numbers) and `tName` of `TEmbeddedObject`
+
 **Misc**
 
 - Update `examples/supertrader` to showcase type semantics and displaying UC output fields according to the definition
 - In `target/react`, make `useUCOR` return a `Part0` always set : you can remove all the now obsolete patterns like `if (listItemsPart0)`, `listItemsPart0 &&`, `listItemsPart0?.`, `listItemsPart0!.` in your React components relying on `useUCOR`. Also expose the function signatures used by `useUC` and `useUCOR` to make them easily passable as children props
-- Introduce `UCOutputFieldValueFragment` in `target/react` and `UCOutputFieldValue` in `target/react-(native|web)-pure` to display uc values using the `fmt()` method of each data type. `TBoolean.fmt()` has been adapted to display `✔️` when `true`, instead of `true|false` which are not very user friendly in a UI
 - List base and final data types directly in the documentation => https://libmodulor.c100k.eu/docs/references/data-types
-- Introduce `Year` data type
-- Adjust `fmt` of `THostPort` and `TTimestamp` (they shouldn't be formatted as numbers) and `tName` of `TEmbeddedObject`
 
 ## v0.9.0 (2025-03-20)
 

package/README.md

@@ -3,7 +3,7 @@
 [![npm version](https://img.shields.io/npm/v/libmodulor.svg?style=for-the-badge&color=blue)](https://www.npmjs.com/package/libmodulor)
 [![license](https://img.shields.io/badge/license-LGPL-green.svg?style=for-the-badge)](https://github.com/c100k/libmodulor/blob/master/LICENSE)
 
-An opinionated TypeScript library to create business oriented applications.
+A TypeScript library to create business oriented applications.
 
 > [!WARNING]
 > The project is still in active development. Although already used in pilot projects, it's not suitable for all production scenarios yet.
@@ -23,4 +23,4 @@ If you think you can help in any way, feel free to contact me (cf. `author` in `
 
 ## ⚖️ License
 
-[LGPL-3.0](https://github.com/c100k/libmodulor/blob/v0.10.0/LICENSE)
+[LGPL-3.0](https://github.com/c100k/libmodulor/blob/v0.11.0/LICENSE)

package/dist/esm/apps/Helper/src/lib/project.js

@@ -42,17 +42,17 @@ export const PACKAGE_JSON = (name) => `{
     },
     "devDependencies": {
         "@biomejs/biome": "^1.9.4",
-        "@types/node": "^22.13.11",
+        "@types/node": "^22.13.14",
         "@vitest/coverage-v8": "^3.0.9",
         "buffer": "^6.0.3",
         "cookie-parser": "^1.4.7",
-        "express": "^4.21.2",
+        "express": "^5.1.0",
         "express-fileupload": "^1.5.1",
-        "fast-check": "^4.0.0",
+        "fast-check": "^4.0.1",
         "helmet": "^8.1.0",
         "jose": "^6.0.10",
         "typescript": "^5.8.2",
-        "vite": "^6.2.2",
+        "vite": "^6.2.3",
         "vitest": "^3.0.9"
     }
 }

package/dist/esm/dt/base/TBoolean.js

@@ -35,6 +35,9 @@ export class TBoolean extends TBase {
     }
     validate() {
         const validation = super.validate();
+        if (!validation.isOK()) {
+            return validation;
+        }
         if (typeof this.raw !== 'boolean') {
             validation.add({
                 constraint: 'type',

package/dist/esm/dt/base/TInt.js

@@ -45,6 +45,9 @@ export class TInt extends TNumber {
     }
     validate() {
         const validation = super.validate();
+        if (!validation.isOK()) {
+            return validation;
+        }
         if (typeof this.raw === 'number' && this.raw.toString().includes('.')) {
             validation.add({
                 constraint: 'type',

package/dist/esm/dt/base/TNumber.js

@@ -60,6 +60,9 @@ export class TNumber extends TBase {
     }
     validate() {
         const validation = super.validate();
+        if (!validation.isOK()) {
+            return validation;
+        }
         if (typeof this.raw !== 'number' || Number.isNaN(this.raw)) {
             validation.add({
                 constraint: 'type',

package/dist/esm/dt/base/TObject.js

@@ -39,6 +39,9 @@ export class TObject extends TBase {
     }
     validate() {
         const validation = super.validate();
+        if (!validation.isOK()) {
+            return validation;
+        }
         // typeof this.raw is 'object', hence the check for nullity
         if (this.raw === null || typeof this.raw !== 'object') {
             validation.add({

package/dist/esm/dt/base/TString.js

@@ -27,6 +27,9 @@ export class TString extends TBase {
     }
     validate() {
         const validation = super.validate();
+        if (!validation.isOK()) {
+            return validation;
+        }
         if (typeof this.raw !== 'string') {
             validation.add({
                 constraint: 'type',

package/dist/esm/dt/final/TDateISO8601.js

@@ -17,6 +17,9 @@ export class TDateISO8601 extends TString {
     }
     validate() {
         const validation = super.validate();
+        if (!validation.isOK()) {
+            return validation;
+        }
         const parsed = Date.parse(this.raw);
         if (Number.isNaN(parsed)) {
             validation.add({

package/dist/esm/dt/final/TJSONString.js

@@ -11,6 +11,9 @@ export class TJSONString extends TString {
     }
     validate() {
         const validation = super.validate();
+        if (!validation.isOK()) {
+            return validation;
+        }
         try {
             JSON.parse(this.raw);
         }

package/dist/esm/dt/final/TJWT.js

@@ -14,6 +14,9 @@ export class TJWT extends TString {
     }
     validate() {
         const validation = super.validate();
+        if (!validation.isOK()) {
+            return validation;
+        }
         try {
             const parts = this.raw.split('.');
             if (parts.length !== 3) {

package/dist/esm/target/node-express-server/middlewares/AuthenticationCheckerMiddlewareBuilder.js

@@ -39,21 +39,15 @@ let AuthenticationCheckerMiddlewareBuilder = class AuthenticationCheckerMiddlewa
                 auth: null,
                 def: ucd,
             });
-            try {
-                const { auth } = await this.authenticationChecker.exec({
-                    authCookie,
-                    authorizationHeader,
-                    uc,
-                });
-                if (auth) {
-                    req.auth = auth;
-                }
-                nextFn();
-            }
-            catch (err) {
-                // Always catch otherwise it breaks the middleware chain and hangs forever
-                nextFn(err);
+            const { auth } = await this.authenticationChecker.exec({
+                authCookie,
+                authorizationHeader,
+                uc,
+            });
+            if (auth) {
+                req.auth = auth;
             }
+            nextFn();
         };
     }
 };

package/dist/esm/target/node-express-server/middlewares/PublicApiKeyCheckerMiddlewareBuilder.js

@@ -26,18 +26,12 @@ let PublicApiKeyCheckerMiddlewareBuilder = class PublicApiKeyCheckerMiddlewareBu
     }
     exec({ checkType }) {
         return async (req, _res, nextFn) => {
-            try {
-                const value = req.header(this.s().server_public_api_key_header_name);
-                await this.publicApiKeyChecker.exec({
-                    checkType,
-                    value,
-                });
-                nextFn();
-            }
-            catch (err) {
-                // Always catch otherwise it breaks the middleware chain and hangs forever
-                nextFn(err);
-            }
+            const value = req.header(this.s().server_public_api_key_header_name);
+            await this.publicApiKeyChecker.exec({
+                checkType,
+                value,
+            });
+            nextFn();
         };
     }
 };

package/dist/esm/target/node-express-server/middlewares/RequestCheckerMiddlewareBuilder.js

@@ -19,18 +19,12 @@ let RequestCheckerMiddlewareBuilder = class RequestCheckerMiddlewareBuilder {
     }
     exec(_input) {
         return (req, _res, nextFn) => {
-            try {
-                this.requestChecker.exec({
-                    secure: req.secure,
-                    url: req.url,
-                    xForwardedProtoHeader: req.get('X-Forwarded-Proto'),
-                });
-                nextFn();
-            }
-            catch (err) {
-                // Always catch otherwise it breaks the middleware chain and hangs forever
-                nextFn(err);
-            }
+            this.requestChecker.exec({
+                secure: req.secure,
+                url: req.url,
+                xForwardedProtoHeader: req.get('X-Forwarded-Proto'),
+            });
+            nextFn();
         };
     }
 };

package/dist/esm/target/node-express-server/middlewares/RequestHandlerMiddlewareBuilder.js

@@ -29,56 +29,50 @@ let RequestHandlerMiddlewareBuilder = class RequestHandlerMiddlewareBuilder {
         };
     }
     exec({ appManifest, envelope, ucd, ucManager, }) {
-        return async (req, res, nextFn) => {
-            try {
-                const uc = this.ucBuilder.exec({
-                    appManifest,
-                    auth: null,
-                    def: ucd,
-                });
-                if (isReqAuthenticated(req)) {
-                    uc.auth = req.auth;
+        return async (req, res) => {
+            const uc = this.ucBuilder.exec({
+                appManifest,
+                auth: null,
+                def: ucd,
+            });
+            if (isReqAuthenticated(req)) {
+                uc.auth = req.auth;
+            }
+            this.fillUCFromReq(req, envelope, uc);
+            const output = await ucManager.execServer(uc);
+            const { ext, io } = ucd;
+            const sideEffects = io.o?.sideEffects;
+            if (sideEffects) {
+                const ucor = new UCOutputReader(uc.def, output ?? undefined);
+                let item;
+                if (ucor.canItem00()) {
+                    item = ucor.item00().item;
                 }
-                this.fillUCFromReq(req, envelope, uc);
-                const output = await ucManager.execServer(uc);
-                const { ext, io } = ucd;
-                const sideEffects = io.o?.sideEffects;
-                if (sideEffects) {
-                    const ucor = new UCOutputReader(uc.def, output ?? undefined);
-                    let item;
-                    if (ucor.canItem00()) {
-                        item = ucor.item00().item;
-                    }
-                    // Be careful with this, as some are incompatible.
-                    // For instance, if there is a REDIRECT and then a CLEAR_AUTH, the latter won't be executed as we return after the redirect.
-                    for (const se of sideEffects) {
-                        const { type } = se;
-                        switch (type) {
-                            case UCOutputSideEffectType.CLEAR_AUTH:
-                                await this.handleClearAuth(res);
-                                break;
-                            case UCOutputSideEffectType.REDIRECT:
-                                await this.handleRedirect(res, item);
-                                return;
-                            case UCOutputSideEffectType.SET_AUTH:
-                                await this.handleSetAuth(res, item);
-                                break;
-                            default:
-                                ((_) => { })(type);
-                        }
+                // Be careful with this, as some are incompatible.
+                // For instance, if there is a REDIRECT and then a CLEAR_AUTH, the latter won't be executed as we return after the redirect.
+                for (const se of sideEffects) {
+                    const { type } = se;
+                    switch (type) {
+                        case UCOutputSideEffectType.CLEAR_AUTH:
+                            await this.handleClearAuth(res);
+                            break;
+                        case UCOutputSideEffectType.REDIRECT:
+                            await this.handleRedirect(res, item);
+                            return;
+                        case UCOutputSideEffectType.SET_AUTH:
+                            await this.handleSetAuth(res, item);
+                            break;
+                        default:
+                            ((_) => { })(type);
                     }
                 }
-                if (!output) {
-                    res.status(204).send();
-                    return;
-                }
-                const transform = ext?.http?.transform;
-                res.send(output && transform ? transform(output) : output);
             }
-            catch (err) {
-                // Always catch otherwise it breaks the middleware chain and hangs forever
-                nextFn(err);
+            if (!output) {
+                res.status(204).send();
+                return;
             }
+            const transform = ext?.http?.transform;
+            res.send(output && transform ? transform(output) : output);
         };
     }
     fillUCFromReq(req, envelope, uc) {

package/dist/esm/testing/impl/VitestAppTestSuiteRunner.d.ts

@@ -1,9 +1,11 @@
 import type { FilePath } from '../../dt/index.js';
-import type { FSManager } from '../../std/index.js';
+import type { FSManager, Logger, ShellCommandExecutor } from '../../std/index.js';
 import type { AppTestSuiteRunner, Input } from '../workers/AppTestSuiteRunner.js';
 export declare class VitestAppTestSuiteRunner implements AppTestSuiteRunner {
     private fsManager;
-    constructor(fsManager: FSManager);
+    private logger;
+    private shellCommandExecutor;
+    constructor(fsManager: FSManager, logger: Logger, shellCommandExecutor: ShellCommandExecutor);
     exec({ appPath, skipCoverage, updateSnapshots, }: Input): Promise<void>;
     coverageReportEntrypointPath(appPath: FilePath): Promise<FilePath>;
     private coverageReportPath;

package/dist/esm/testing/impl/VitestAppTestSuiteRunner.js

@@ -11,29 +11,36 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
 import { inject, injectable } from 'inversify';
-import { createVitest } from 'vitest/node';
 import { APP_TEST_DIR_NAME, APP_TEST_REPORTS_DIR_NAME, } from '../../convention.js';
 let VitestAppTestSuiteRunner = class VitestAppTestSuiteRunner {
     fsManager;
-    constructor(fsManager) {
+    logger;
+    shellCommandExecutor;
+    constructor(fsManager, logger, shellCommandExecutor) {
         this.fsManager = fsManager;
+        this.logger = logger;
+        this.shellCommandExecutor = shellCommandExecutor;
     }
     async exec({ appPath, skipCoverage, updateSnapshots, }) {
         const testPath = this.fsManager.path(appPath, APP_TEST_DIR_NAME);
-        const excludePath = this.fsManager.path(testPath);
-        const runner = await createVitest('test', {
-            coverage: {
-                enabled: !skipCoverage,
-                exclude: [excludePath],
-                include: [appPath],
-                reportsDirectory: this.coverageReportPath(appPath),
-                reportOnFailure: false,
+        const args = [
+            'run',
+            '--dir',
+            './examples/apps/Spotify',
+        ];
+        if (!skipCoverage) {
+            args.push('--coverage.enabled', '--coverage.exclude', testPath, '--coverage.include', appPath, '--coverage.reportsDirectory', this.coverageReportPath(appPath));
+        }
+        if (updateSnapshots) {
+            args.push('--update');
+        }
+        const output = await this.shellCommandExecutor.exec({
+            bin: './node_modules/.bin/vitest',
+            opts: {
+                args,
             },
-            dir: appPath,
-            update: updateSnapshots,
-            watch: false,
         });
-        await runner.start();
+        this.logger.info(output);
     }
     async coverageReportEntrypointPath(appPath) {
         return this.fsManager.path(this.coverageReportPath(appPath), 'index.html');
@@ -46,6 +53,8 @@ let VitestAppTestSuiteRunner = class VitestAppTestSuiteRunner {
 VitestAppTestSuiteRunner = __decorate([
     injectable(),
     __param(0, inject('FSManager')),
-    __metadata("design:paramtypes", [Object])
+    __param(1, inject('Logger')),
+    __param(2, inject('ShellCommandExecutor')),
+    __metadata("design:paramtypes", [Object, Object, Object])
 ], VitestAppTestSuiteRunner);
 export { VitestAppTestSuiteRunner };

package/dist/esm/uc/utils/rInput.js

@@ -1,5 +1,5 @@
 import { TBoolean } from '../../dt/index.js';
-import { ucifIsMandatory, ucifRepeatability } from '../input-field.js';
+import { UCInputFieldChangeOperator, ucifIsMandatory, ucifRepeatability, } from '../input-field.js';
 const DEFAULT_OPTS = {
     forceArrayAsEmpty: false,
     forceBooleanAsFalse: true,
@@ -24,12 +24,14 @@ export function rInput(uc, opts) {
             ucifIsMandatory(f.def) &&
             (value === null || value === undefined)) {
             value = false;
+            f.setValue(UCInputFieldChangeOperator.SET, value);
         }
         const [isRepeatable] = ucifRepeatability(f.def);
         if (forceArrayAsEmpty &&
             isRepeatable &&
             (value === null || value === undefined)) {
             value = [];
+            f.setValue(UCInputFieldChangeOperator.SET, value);
         }
         if (!ignoreUndefined || (ignoreUndefined && value !== undefined)) {
             // Useful when we get the input before persisting for example.

package/dist/esm/utils/index.d.ts

@@ -6,7 +6,6 @@ export { HTTPRequestBuilder } from './http/HTTPRequestBuilder.js';
 export type { HTTPDataEnvelope, HTTPReqData } from './http/types.js';
 export { bindProvider } from './ioc/bindProvider.js';
 export { CONTAINER_OPTS } from './ioc/container.js';
-export { ContainerPrinter } from './ioc/ContainerPrinter.js';
 export type { Class } from './ioc/types.js';
 export { fmt as fmtNumber } from './numbers/fmt.js';
 export { type CoreUnit, type SquareUnit, type SquareableUnit, type Unit, baseFromSquareUnit, isSquareUnit, } from './numbers/units.js';

package/dist/esm/utils/index.js

@@ -2,7 +2,6 @@ export { sleep } from './async/sleep.js';
 export { HTTPRequestBuilder } from './http/HTTPRequestBuilder.js';
 export { bindProvider } from './ioc/bindProvider.js';
 export { CONTAINER_OPTS } from './ioc/container.js';
-export { ContainerPrinter } from './ioc/ContainerPrinter.js';
 export { fmt as fmtNumber } from './numbers/fmt.js';
 export { baseFromSquareUnit, isSquareUnit, } from './numbers/units.js';
 export { capitalize, isCapitalized } from './strings/capitalize.js';

package/dist/esm/utils/ioc/ContainerPrinter.d.ts

@@ -3,10 +3,13 @@ import type { Logger, Worker } from '../../std/index.js';
 interface Input {
     container: Container;
 }
-export declare class ContainerPrinter implements Worker<Input, Promise<void>> {
+interface Output {
+    bindingLines: string[];
+}
+export declare class ContainerPrinter implements Worker<Input, Promise<Output>> {
     private logger;
     constructor(logger: Logger);
-    exec({ container }: Input): Promise<void>;
+    exec({ container }: Input): Promise<Output>;
     private symToString;
 }
 export {};

package/dist/esm/utils/ioc/ContainerPrinter.js

@@ -42,6 +42,9 @@ let ContainerPrinter = class ContainerPrinter {
         for (const e of sorted) {
             this.logger.debug(e);
         }
+        return {
+            bindingLines: sorted,
+        };
     }
     symToString(sym) {
         return typeof sym === 'string' ? sym : (sym.name ?? 'UnnamedClass');

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "libmodulor",
-    "description": "An opinionated TypeScript library to create business oriented applications",
-    "version": "0.10.0",
+    "description": "A TypeScript library to create business oriented applications",
+    "version": "0.11.0",
     "license": "LGPL-3.0",
     "author": "Chafik H'nini <chafik.hnini@gmail.com>",
     "homepage": "https://github.com/c100k/libmodulor#readme",
@@ -76,26 +76,26 @@
     },
     "peerDependencies": {
         "@hono/node-server": "^1.14.0",
-        "@modelcontextprotocol/sdk": "^1.7.0",
-        "@stricli/core": "^1.1.1",
+        "@modelcontextprotocol/sdk": "^1.8.0",
+        "@stricli/core": "^1.1.2",
         "buffer": "^6.0.3",
         "cookie-parser": "^1.4.7",
-        "express": "^4.21.2",
+        "express": "^5.1.0",
         "express-fileupload": "^1.5.1",
-        "fast-check": "^4.0.0",
+        "fast-check": "^4.0.1",
         "helmet": "^8.1.0",
         "hono": "^4.7.5",
         "inversify": "^6.2.2",
         "jose": "^6.0.10",
         "knex": "^3.1.0",
         "pg": "^8.14.1",
-        "react": "^19.0.0",
-        "react-dom": "^19.0.0",
+        "react": "^19.1.0",
+        "react-dom": "^19.1.0",
         "react-native": "^0.78.1",
         "reflect-metadata": "^0.2.2",
         "sqlite3": "^5.1.7",
         "typescript": "^5.8.2",
-        "vite": "^6.2.2",
+        "vite": "^6.2.3",
         "vitest": "^3.0.9"
     },
     "peerDependenciesMeta": {