libmodulor 0.6.1 → 0.8.0

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # CHANGELOG
 
+## v0.8.0 (2025-03-13)
+
+**BREAKING**
+
+- Move `NodeExpressServerManager` to a dedicated export (`libmodulor/node` => `libmodulor/node-express`). The following dependencies (`cookie-parser`, `express`, `express-fileupload` and `helmet`) are now optional. You can remove them if you're using `libmodulor/node` elements in non server targets like `cli`
+- Do not enforce `dt` and `policies` folders in app src : place everything that **is not** `*UCD` and `*ServerMain` into `lib` the way you prefer
+- Check app src folder contents : it must contain only the elements allowed by the spec (Re-generate your tests `yarn libmodulor GenerateAppsTests` to enforce the new rule)
+
+**Misc**
+
+- Introduce new "Basic" example showing all the primitives in action in one single `.ts` file
+- Move `examples/libmodulor-tuto` to `examples/supertrader`
+- Add `llms.txt` to docs at https://libmodulor.c100k.eu/llms.txt
+
+## v0.7.0 (2025-03-07)
+
+**Added**
+
+- Make `npx libmodulor CreateProject` more generic : you can now customize the `initialCommit` (default is `chore: initial commit`), the `pkgManagerBin` (default is `yarn`, works with `npm`, `pnpm`, `bun`, etc.), the `scmBin` (default is `git`)
+
+**Fixed**
+
+- Derandomize UC input before snapshotting in tests : after the upgrade to TS 5.8, snapshotting a UC including a File as input would break as a new `state` property has appeared with a dynamic `lastModified` property
+
+**Misc**
+
+- Move the documentation with concepts, examples, guides and references to https://libmodulor.c100k.eu
+
 ## v0.6.1 (2025-02-28)
 
 **Fixed**

package/README.md

@@ -5,39 +5,17 @@
 
 An opinionated TypeScript library to create business oriented applications.
 
-Applications created with `libmodulor` have **6 main properties** :
-
-- Strictly typed with explicit business data types
-- Fully typed e2e without code generation
-- Auto documented
-- Auto tested
-- Multi platforms/runtimes
-- Runnable anywhere
-
 > [!WARNING]
 > The project is still in active development. Although already used in pilot projects, it's not suitable for all production scenarios yet.
 > Being developed by only one person, it may keep going for years or stop at any time.
 > In the meantime, it's still a "research project" that needs improvement. Thus, it will be subject to BREAKING CHANGES as long as the version is not `1.0.0`.
-> All that said, the end goal is really to have a **production-grade library** to help everyone build **quality projects faster**. If you want to help in any way or have questions, feel free to contact me (cf. `author` in `package.json`).
-
-> [!NOTE]
-> At the beginning, the whole documentation will be on GitHub, starting from this file, to make it easier to have the big picture, maintain and <kbd>cmd</kbd> + <kbd>F</kbd>. At some point, I'll consider having a beautiful documentation website like all the cool kids.
-
----
+> All that said, the end goal is really to have a **production-grade library** to help everyone build **quality projects faster**.
 
 ## 🚀 Getting Started
 
-If you're discovering `libmodulor`, we recommend reading the [📖 Introduction](https://github.com/c100k/libmodulor/blob/v0.6.1/docs/Introduction.md) first. It will give you an overview of what `libmodulor` is and how it works.
-
-If you want to learn by doing, you can follow the [🚀 Tutorial](https://github.com/c100k/libmodulor/blob/v0.6.1/docs/Tutorial.md). It contains multiple steps showing you the basics of `libmodulor`. We'll build a small Trading app that will allow us to buy an asset from `curl`, a SPA, a CLI, Claude Desktop, an Android mobile app and an iOS mobile app !
-
-If you're felling adventurous, create a project and start building your own application, with your own apps, use cases, products, targets :
-
-```sh
-npx libmodulor CreateProject --outPath ~/Downloads --projectName libmodulor-projx
-```
+If you're discovering `libmodulor`, we recommend reading the [📖 Documentation](https://libmodulor.c100k.eu/docs) first. You'll find everything you need to get started : Concepts, Examples and Guides.
 
-Finally, for more advanced uses, check out the [📜 Guides](https://github.com/c100k/libmodulor/blob/v0.6.1/docs/Guides.md).
+When you're ready, [🚀 Create a project](https://libmodulor.c100k.eu/docs/guides/create-project) and build the awesome idea you have in mind.
 
 ## 👨‍💻 Contribute
 
@@ -45,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.6.1/LICENSE)
+[LGPL-3.0](https://github.com/c100k/libmodulor/blob/v0.8.0/LICENSE)

package/dist/esm/apps/Helper/src/i18n.js

@@ -11,10 +11,13 @@ export const I18n = {
         uc_TestApp_label: 'Test app',
         ucif_appPath_desc: 'The path of the app',
         ucif_appsPath_desc: 'The path to the directory containing all the apps',
-        ucif_projectName_desc: "Name of the project conforming to the package.json's spec (i.e. a-z, 0-9, -)",
-        ucif_outPath_desc: 'Path to a directory where to create the project. Do not include the project name in it. It is created recursively if missing.',
-        ucif_monkeyTestingTimeoutInMs_desc: 'These tests can take longer than the usual default of 5000ms because they try lots of possibilities',
         ucif_depsMapping_desc: 'The mapping of dependencies in case some of them need a specific pattern (e.g. one directory above the default)',
+        ucif_initialCommit_desc: 'The message of the initial commit',
+        ucif_monkeyTestingTimeoutInMs_desc: 'These tests can take longer than the usual default of 5000ms because they try lots of possibilities',
+        ucif_outPath_desc: 'Path to a directory where to create the project. Do not include the project name in it. It is created recursively if missing.',
+        ucif_pkgManagerBin_desc: "The package manager to use to install the deps and run the dev commands (must conform to npm's API)",
+        ucif_projectName_desc: "Name of the project conforming to the package.json's spec (i.e. a-z, 0-9, -)",
+        ucif_scmBin_desc: "The source control manager to use to init and commit (must conform to git's API)",
         ucif_serverPortRangeStart_desc: 'The port number to start with when generating the server to test (incremented by 1) for each app',
         ucif_skipCoverage_desc: 'Whether to skip coverage or not',
         ucif_updateSnapshots_desc: "Whether to update the snapshots or not. Typically, update them if the tests fail because the snapshots don't match, the reason being that you changed the implementation",

package/dist/esm/apps/Helper/src/lib/project.d.ts

@@ -1,2 +1,3 @@
 import type { FileName, Slug } from '../../../../dt/index.js';
+export declare const PACKAGE_JSON: (name: Slug) => string;
 export declare function projectFiles(name: Slug): Map<FileName, string>;

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

@@ -26,7 +26,7 @@ const BIOME_JSON = `{
     }
 }
 `;
-const PACKAGE_JSON = (name) => `{
+export const PACKAGE_JSON = (name) => `{
     "name": "${name}",
     "version": "0.1.0",
     "type": "module",
@@ -42,8 +42,8 @@ const PACKAGE_JSON = (name) => `{
     },
     "devDependencies": {
         "@biomejs/biome": "^1.9.4",
-        "@types/node": "^22.13.5",
-        "@vitest/coverage-v8": "^3.0.7",
+        "@types/node": "^22.13.10",
+        "@vitest/coverage-v8": "^3.0.8",
         "buffer": "^6.0.3",
         "cookie-parser": "^1.4.7",
         "express": "^4.21.2",
@@ -51,9 +51,9 @@ const PACKAGE_JSON = (name) => `{
         "fast-check": "^3.23.2",
         "helmet": "^8.0.0",
         "jose": "^6.0.8",
-        "typescript": "^5.7.3",
-        "vite": "^6.2.0",
-        "vitest": "^3.0.7"
+        "typescript": "^5.8.2",
+        "vite": "^6.2.1",
+        "vitest": "^3.0.8"
     }
 }
 `;

package/dist/esm/apps/Helper/src/ucds/CreateProjectUCD.d.ts

@@ -1,9 +1,12 @@
-import { type DirPath, type Slug } from '../../../../dt/index.js';
+import { type DirPath, type FileName, type FreeTextShort, type Slug } from '../../../../dt/index.js';
 import type { FSManager, Logger, ShellCommandExecutor } from '../../../../std/index.js';
 import { type UCDef, type UCInput, type UCInputFieldValue, type UCMain, type UCMainInput } from '../../../../uc/index.js';
 export interface CreateProjectInput extends UCInput {
+    initialCommit: UCInputFieldValue<FreeTextShort>;
     outPath: UCInputFieldValue<DirPath>;
+    pkgManagerBin: UCInputFieldValue<FileName>;
     projectName: UCInputFieldValue<Slug>;
+    scmBin: UCInputFieldValue<FileName>;
 }
 export declare class CreateProjectClientMain implements UCMain<CreateProjectInput> {
     private fsManager;
@@ -11,5 +14,13 @@ export declare class CreateProjectClientMain implements UCMain<CreateProjectInpu
     private shellCommandExecutor;
     constructor(fsManager: FSManager, logger: Logger, shellCommandExecutor: ShellCommandExecutor);
     exec({ uc }: UCMainInput<CreateProjectInput>): Promise<void>;
+    private assertBinPresence;
+    private commit;
+    private createConfigFiles;
+    private createDirs;
+    private createRootDir;
+    private initRepository;
+    private installDeps;
+    private runDevCmds;
 }
 export declare const CreateProjectUCD: UCDef<CreateProjectInput>;

package/dist/esm/apps/Helper/src/ucds/CreateProjectUCD.js

@@ -12,7 +12,8 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 };
 import { inject, injectable } from 'inversify';
 import { APPS_ROOT_PATH, PRODUCTS_ROOT_PATH } from '../../../../convention.js';
-import { TDirPath, TSlug, } from '../../../../dt/index.js';
+import { TDirPath, TFileName, TFreeTextShort, TSlug, } from '../../../../dt/index.js';
+import { IllegalArgumentError } from '../../../../error/index.js';
 import { EverybodyUCPolicy, } from '../../../../uc/index.js';
 import { projectFiles } from '../lib/project.js';
 import { Manifest } from '../manifest.js';
@@ -26,55 +27,95 @@ let CreateProjectClientMain = class CreateProjectClientMain {
         this.shellCommandExecutor = shellCommandExecutor;
     }
     async exec({ uc }) {
+        const initialCommit = uc.reqVal0('initialCommit');
         const outPath = uc.reqVal0('outPath');
+        const pkgManagerBin = uc.reqVal0('pkgManagerBin');
         const projectName = uc.reqVal0('projectName');
+        const scmBin = uc.reqVal0('scmBin');
+        await this.assertBinPresence(pkgManagerBin);
+        await this.assertBinPresence(scmBin);
         const cwd = this.fsManager.path(outPath, projectName);
-        this.logger.info('Creating root dir : %s', cwd);
-        await this.fsManager.mkdir(cwd, { recursive: true });
-        this.logger.info('Initializing git repository');
-        await this.shellCommandExecutor.exec({
-            bin: 'git',
-            opts: { args: ['init'], cwd },
-        });
-        this.logger.info('Creating config files');
+        // TODO : Rollback the whole thing in case of failure
+        await this.createRootDir(cwd);
+        await this.initRepository(scmBin, cwd);
+        await this.createConfigFiles(projectName, cwd);
+        await this.createDirs(cwd);
+        await this.installDeps(pkgManagerBin, cwd);
+        await this.commit(scmBin, initialCommit, cwd);
+        await this.runDevCmds(pkgManagerBin, cwd);
+        this.logger.info('Done ! Project ready ! ✅ 🚀');
+    }
+    async assertBinPresence(bin) {
+        try {
+            await this.shellCommandExecutor.exec({
+                bin: bin,
+                opts: { args: ['--version'] },
+            });
+        }
+        catch (err) {
+            throw new IllegalArgumentError(`'${bin}' seems missing. Is it installed on your machine ?`);
+        }
+    }
+    async commit(scmBin, initialCommit, cwd) {
+        this.logger.info('Committing');
+        const cmdArgs = [
+            ['branch', '-M', 'master'],
+            ['add', '.'],
+            ['commit', '-am', initialCommit],
+        ];
+        for await (const args of cmdArgs) {
+            await this.shellCommandExecutor.exec({
+                bin: scmBin,
+                opts: { args, cwd },
+            });
+        }
+    }
+    async createConfigFiles(projectName, cwd) {
         const files = projectFiles(projectName);
         for await (const [fileName, content] of files) {
             const path = this.fsManager.path(cwd, fileName);
             await this.fsManager.touch(path, content);
         }
-        const dirs = [APPS_ROOT_PATH, PRODUCTS_ROOT_PATH];
+    }
+    async createDirs(cwd) {
         this.logger.info('Creating apps and products directories');
+        const dirs = [APPS_ROOT_PATH, PRODUCTS_ROOT_PATH];
         for await (const dirPath of dirs) {
             const path = this.fsManager.path(cwd, ...dirPath);
             await this.fsManager.mkdir(path, { recursive: true });
             await this.fsManager.touch(this.fsManager.path(path, '.gitkeep'), '');
         }
-        this.logger.info('Installing dependencies');
+    }
+    async createRootDir(cwd) {
+        this.logger.info('Creating root dir : %s', cwd);
+        await this.fsManager.mkdir(cwd, { recursive: true });
+    }
+    async initRepository(scmBin, cwd) {
+        const cmd = 'init';
+        this.logger.info('Initializing repository : %s %s', scmBin, cmd);
         await this.shellCommandExecutor.exec({
-            bin: 'yarn',
-            opts: { args: ['install'], cwd },
+            bin: scmBin,
+            opts: { args: [cmd], cwd },
         });
-        this.logger.info('Committing');
-        const cmdArgs = [
-            ['branch', '-M', 'master'],
-            ['add', '.'],
-            ['commit', '-am', '"chore: initial commit"'],
-        ];
-        for await (const args of cmdArgs) {
-            await this.shellCommandExecutor.exec({
-                bin: 'git',
-                opts: { args, cwd },
-            });
-        }
-        const devCmds = ['lint', 'test'];
-        for await (const cmd of devCmds) {
-            this.logger.info('Testing dev command : yarn %s', cmd);
+    }
+    async installDeps(pkgManagerBin, cwd) {
+        const cmd = 'install';
+        this.logger.info('Installing dependencies : %s %s', pkgManagerBin, cmd);
+        await this.shellCommandExecutor.exec({
+            bin: pkgManagerBin,
+            opts: { args: [cmd], cwd },
+        });
+    }
+    async runDevCmds(pkgManagerBin, cwd) {
+        const cmd = 'run';
+        const scripts = ['lint', 'test'];
+        for await (const script of scripts) {
+            this.logger.info('Running dev command : %s %s %s', pkgManagerBin, cmd, script);
             await this.shellCommandExecutor.exec({
-                bin: 'yarn',
-                opts: { args: [cmd], cwd },
+                bin: pkgManagerBin,
+                opts: { args: [cmd, script], cwd },
             });
         }
-        this.logger.info('Done ! Project ready ! ✅ 🚀');
     }
 };
 CreateProjectClientMain = __decorate([
@@ -94,6 +135,14 @@ export const CreateProjectUCD = {
     io: {
         i: {
             fields: {
+                initialCommit: {
+                    cardinality: {
+                        min: 0,
+                    },
+                    type: new TFreeTextShort()
+                        .setDefaultValue('chore: initial commit')
+                        .setExamples(['chore: initial commit']),
+                },
                 outPath: {
                     cardinality: {
                         min: 0,
@@ -102,9 +151,25 @@ export const CreateProjectUCD = {
                         .setDefaultValue('./')
                         .setExamples([['~', 'Desktop'].join('/')]),
                 },
+                pkgManagerBin: {
+                    cardinality: {
+                        min: 0,
+                    },
+                    type: new TFileName()
+                        .setDefaultValue('yarn')
+                        .setExamples(['bun', 'npm', 'pnpm', 'yarn']),
+                },
                 projectName: {
                     type: new TSlug(),
                 },
+                scmBin: {
+                    cardinality: {
+                        min: 0,
+                    },
+                    type: new TFileName()
+                        .setDefaultValue('git')
+                        .setExamples(['git']),
+                },
             },
         },
     },

package/dist/esm/convention.d.ts

@@ -10,12 +10,15 @@ export declare const APP_I18N_FILE_NAME: string;
 export declare const APP_INDEX_NAME: string;
 export declare const APP_INDEX_FILE_NAME: string;
 export declare const APP_INDEX_FILE_NAME_FOR_IMPORT: string;
+export declare const APP_INSTALLER_FILE_NAME: string;
 export declare const APP_MANIFEST_NAME: string;
 export declare const APP_MANIFEST_FILE_EXT: string;
 export declare const APP_MANIFEST_FILE_NAME: string;
 export declare const APP_NAME_PLACEHOLDER: AppName;
 export declare const APP_ROOT_FROM_UCD: string[];
+export declare const APP_SETTINGS_FILE_NAME: string;
 export declare const APP_SRC_DIR_NAME: string;
+export declare const APP_SRC_LIB_DIR_NAME: string;
 export declare const APP_SRC_UCDS_DIR_NAME: string;
 export declare const APP_TEST_DIR_NAME: string;
 export declare const APP_TEST_MAIN_FILE_NAME: string;

package/dist/esm/convention.js

@@ -14,12 +14,15 @@ export const APP_I18N_FILE_NAME = `${APP_I18N_NAME.toLowerCase()}.ts`;
 export const APP_INDEX_NAME = 'index';
 export const APP_INDEX_FILE_NAME = `${APP_INDEX_NAME}.ts`;
 export const APP_INDEX_FILE_NAME_FOR_IMPORT = 'index.js'; // ESM
+export const APP_INSTALLER_FILE_NAME = 'installer.ts';
 export const APP_MANIFEST_NAME = 'Manifest';
 export const APP_MANIFEST_FILE_EXT = '.ts';
 export const APP_MANIFEST_FILE_NAME = `${APP_MANIFEST_NAME.toLowerCase()}${APP_MANIFEST_FILE_EXT}`;
 export const APP_NAME_PLACEHOLDER = 'AppX';
 export const APP_ROOT_FROM_UCD = ['..', '..', '..']; // $root/src/ucds/XyzUCD.ts
+export const APP_SETTINGS_FILE_NAME = 'settings.ts';
 export const APP_SRC_DIR_NAME = SRC_DIR_NAME;
+export const APP_SRC_LIB_DIR_NAME = 'lib';
 export const APP_SRC_UCDS_DIR_NAME = 'ucds';
 export const APP_TEST_DIR_NAME = 'test';
 export const APP_TEST_MAIN_FILE_NAME = 'App.test.ts';

package/dist/esm/index.node-express.d.ts

@@ -0,0 +1 @@
+export { NodeExpressServerManager } from './target/node-express-server/NodeExpressServerManager.js';

package/dist/esm/index.node-express.js

@@ -0,0 +1 @@
+export { NodeExpressServerManager } from './target/node-express-server/NodeExpressServerManager.js';

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

@@ -8,7 +8,6 @@ export { NodeHTTPAPICallExecutorAgentBuilder } from './std/impl/NodeHTTPAPICallE
 export { NodePromptManager } from './std/impl/NodePromptManager.js';
 export { NodeSpawnShellCommandExecutor } from './std/impl/NodeSpawnShellCommandExecutor.js';
 export { NodeCoreCLIManager } from './target/node-core-cli/NodeCoreCLIManager.js';
-export { NodeExpressServerManager } from './target/node-express-server/NodeExpressServerManager.js';
 export { bindNodeCLI } from './utils/ioc/bindNodeCLI.js';
 export { bindNodeCore } from './utils/ioc/bindNodeCore.js';
 export { bindServer } from './utils/ioc/bindServer.js';

package/dist/esm/index.node.js

@@ -8,7 +8,6 @@ export { NodeHTTPAPICallExecutorAgentBuilder } from './std/impl/NodeHTTPAPICallE
 export { NodePromptManager } from './std/impl/NodePromptManager.js';
 export { NodeSpawnShellCommandExecutor } from './std/impl/NodeSpawnShellCommandExecutor.js';
 export { NodeCoreCLIManager } from './target/node-core-cli/NodeCoreCLIManager.js';
-export { NodeExpressServerManager } from './target/node-express-server/NodeExpressServerManager.js';
 export { bindNodeCLI } from './utils/ioc/bindNodeCLI.js';
 export { bindNodeCore } from './utils/ioc/bindNodeCore.js';
 export { bindServer } from './utils/ioc/bindServer.js';

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

@@ -1 +1 @@
-export { StripUCDLifecycleServerPlugin } from './bundlers/vite/StripUCDLifecycleServerPlugin.js';
+export { StripUCDLifecycleServerPlugin } from './utils/bundling/vite/StripUCDLifecycleServerPlugin.js';

package/dist/esm/index.vite.js

@@ -1 +1 @@
-export { StripUCDLifecycleServerPlugin } from './bundlers/vite/StripUCDLifecycleServerPlugin.js';
+export { StripUCDLifecycleServerPlugin } from './utils/bundling/vite/StripUCDLifecycleServerPlugin.js';

package/dist/esm/std/impl/NodeSpawnShellCommandExecutor.js

@@ -21,7 +21,7 @@ let NodeSpawnShellCommandExecutor = class NodeSpawnShellCommandExecutor {
             proc.stdout.on('data', (chunk) => {
                 stdout += chunk;
             });
-            proc.stdout.on('error', (err) => {
+            proc.on('error', (err) => {
                 reject(err);
             });
             proc.on('close', (code, signal) => {

package/dist/esm/testing/AppTester.d.ts

@@ -12,6 +12,7 @@ import type { AppDocsEmitter } from './workers/AppDocsEmitter.js';
 import type { AppTestSuiteTestResult } from './workers/AppTestSuiteEmitter.js';
 import { AppTesterCtxInitializer } from './workers/AppTesterCtxInitializer.js';
 import { UCExecutor, type UCExecutorExecOutput, type Input as UCExecutorInput } from './workers/UCExecutor.js';
+import { AppFolderChecker } from './workers/checkers/AppFolderChecker.js';
 import { AppI18nChecker } from './workers/checkers/AppI18nChecker.js';
 import { AppIndexChecker } from './workers/checkers/AppIndexChecker.js';
 import { AppManifestChecker } from './workers/checkers/AppManifestChecker.js';
@@ -31,6 +32,7 @@ export interface AppTesterUCTestData<I extends UCInput | undefined = undefined,
 }
 export declare class AppTester {
     private appDocsEmitter;
+    private appFolderChecker;
     private appI18nChecker;
     private appIndexChecker;
     private appManifestChecker;
@@ -51,7 +53,8 @@ export declare class AppTester {
     private testResults;
     private testSummary;
     private ucDefSourcesCheckerOutput;
-    constructor(appDocsEmitter: AppDocsEmitter, appI18nChecker: AppI18nChecker, appIndexChecker: AppIndexChecker, appManifestChecker: AppManifestChecker, appTesterCtxInitializer: AppTesterCtxInitializer, serverManager: ServerManager, simpleHTMLAppTestReportEmitter: SimpleHTMLAppTestReportEmitter, ucBuilder: UCBuilder, ucDefChecker: UCDefChecker, ucDefSourcesChecker: UCDefSourcesChecker, ucExecutor: UCExecutor);
+    constructor(appDocsEmitter: AppDocsEmitter, appFolderChecker: AppFolderChecker, appI18nChecker: AppI18nChecker, appIndexChecker: AppIndexChecker, appManifestChecker: AppManifestChecker, appTesterCtxInitializer: AppTesterCtxInitializer, serverManager: ServerManager, simpleHTMLAppTestReportEmitter: SimpleHTMLAppTestReportEmitter, ucBuilder: UCBuilder, ucDefChecker: UCDefChecker, ucDefSourcesChecker: UCDefSourcesChecker, ucExecutor: UCExecutor);
+    checkAppFolder(): Promise<void>;
     checkAppI18n(): Promise<void>;
     checkAppIndex(): Promise<void>;
     checkAppManifest(): Promise<void>;

package/dist/esm/testing/AppTester.js

@@ -23,6 +23,7 @@ import { allWithExamples, defaultUCInputFillers, } from './uc-input.js';
 import { awaitForSrcImport } from './utils.js';
 import { AppTesterCtxInitializer } from './workers/AppTesterCtxInitializer.js';
 import { UCExecutor, } from './workers/UCExecutor.js';
+import { AppFolderChecker } from './workers/checkers/AppFolderChecker.js';
 import { AppI18nChecker } from './workers/checkers/AppI18nChecker.js';
 import { AppIndexChecker } from './workers/checkers/AppIndexChecker.js';
 import { AppManifestChecker } from './workers/checkers/AppManifestChecker.js';
@@ -30,6 +31,7 @@ import { UCDefChecker } from './workers/checkers/UCDefChecker.js';
 import { UCDefSourcesChecker, } from './workers/checkers/UCDefSourcesChecker.js';
 let AppTester = class AppTester {
     appDocsEmitter;
+    appFolderChecker;
     appI18nChecker;
     appIndexChecker;
     appManifestChecker;
@@ -51,8 +53,9 @@ let AppTester = class AppTester {
     testResults;
     testSummary;
     ucDefSourcesCheckerOutput;
-    constructor(appDocsEmitter, appI18nChecker, appIndexChecker, appManifestChecker, appTesterCtxInitializer, serverManager, simpleHTMLAppTestReportEmitter, ucBuilder, ucDefChecker, ucDefSourcesChecker, ucExecutor) {
+    constructor(appDocsEmitter, appFolderChecker, appI18nChecker, appIndexChecker, appManifestChecker, appTesterCtxInitializer, serverManager, simpleHTMLAppTestReportEmitter, ucBuilder, ucDefChecker, ucDefSourcesChecker, ucExecutor) {
         this.appDocsEmitter = appDocsEmitter;
+        this.appFolderChecker = appFolderChecker;
         this.appI18nChecker = appI18nChecker;
         this.appIndexChecker = appIndexChecker;
         this.appManifestChecker = appManifestChecker;
@@ -72,6 +75,14 @@ let AppTester = class AppTester {
             },
         };
     }
+    async checkAppFolder() {
+        const { errors } = await this.appFolderChecker.exec({
+            appPath: this.ctx.appPath,
+        });
+        if (errors.length > 0) {
+            throw new Error(errors[0]);
+        }
+    }
     async checkAppI18n() {
         const { errors } = await this.appI18nChecker.exec({
             appManifest: this.ctx.appManifest,
@@ -337,17 +348,19 @@ let AppTester = class AppTester {
 AppTester = __decorate([
     injectable(),
     __param(0, inject('AppDocsEmitter')),
-    __param(1, inject(AppI18nChecker)),
-    __param(2, inject(AppIndexChecker)),
-    __param(3, inject(AppManifestChecker)),
-    __param(4, inject(AppTesterCtxInitializer)),
-    __param(5, inject('ServerManager')),
-    __param(6, inject(SimpleHTMLAppTestReportEmitter)),
-    __param(7, inject(UCBuilder)),
-    __param(8, inject(UCDefChecker)),
-    __param(9, inject(UCDefSourcesChecker)),
-    __param(10, inject(UCExecutor)),
-    __metadata("design:paramtypes", [Object, AppI18nChecker,
+    __param(1, inject(AppFolderChecker)),
+    __param(2, inject(AppI18nChecker)),
+    __param(3, inject(AppIndexChecker)),
+    __param(4, inject(AppManifestChecker)),
+    __param(5, inject(AppTesterCtxInitializer)),
+    __param(6, inject('ServerManager')),
+    __param(7, inject(SimpleHTMLAppTestReportEmitter)),
+    __param(8, inject(UCBuilder)),
+    __param(9, inject(UCDefChecker)),
+    __param(10, inject(UCDefSourcesChecker)),
+    __param(11, inject(UCExecutor)),
+    __metadata("design:paramtypes", [Object, AppFolderChecker,
+        AppI18nChecker,
         AppIndexChecker,
         AppManifestChecker,
         AppTesterCtxInitializer, Object, SimpleHTMLAppTestReportEmitter,

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

@@ -92,6 +92,10 @@ test('Sources should be valid', async () => {
     await runner.checkUCDSources();
 });
 
+test('Folder should be valid', async () => {
+    await runner.checkAppFolder();
+});
+
 test('${APP_MANIFEST_NAME} should be valid', async () => {
     await runner.checkAppManifest();
 });

package/dist/esm/testing/workers/UCExecutor.d.ts

@@ -42,4 +42,6 @@ export declare class UCExecutor implements Worker<Input, Promise<Output>> {
     exec<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined>({ appManifest, auth, authName, inputFiller, inputFillerName, ucd, }: Input<I, OPI0, OPI1>): Promise<Output<I, OPI0, OPI1>>;
     overrideUCManager(ucManager: UCManager): void;
     private execClient;
+    private derandomizeInput;
+    private derandomizeInputFile;
 }

package/dist/esm/testing/workers/UCExecutor.js

@@ -83,6 +83,36 @@ let UCExecutor = class UCExecutor {
         catch (err) {
             out.err = err;
         }
+        finally {
+            this.derandomizeInput(out.io.i);
+        }
+    }
+    derandomizeInput(input) {
+        for (const [k, v] of Object.entries(input)) {
+            if (Array.isArray(v)) {
+                v.forEach((vv, idx) => {
+                    if (vv instanceof File) {
+                        // @ts-ignore
+                        input[k][idx] = this.derandomizeInputFile(vv);
+                    }
+                });
+            }
+            else if (v instanceof File) {
+                // @ts-ignore
+                input[k] = this.derandomizeInputFile(v);
+            }
+        }
+    }
+    derandomizeInputFile(file) {
+        // Since TypeScript 5.8, a new `lastModified` field has appeared in `File.state: FileState {}` when snapshotting.
+        // The problem is that this value is a timestamp that changes everytime we execute the tests.
+        // Creating a `specificAssertion` just for that would be cumbersome.
+        // Hence the transform of the `File` into a deterministic `Object` for easy snapshotting.
+        return {
+            name: file.name,
+            size: file.size,
+            type: file.type,
+        };
     }
 };
 UCExecutor = UCExecutor_1 = __decorate([

package/dist/esm/testing/workers/checkers/AppFolderChecker.d.ts

@@ -0,0 +1,17 @@
+import type { ErrorMessage } from '../../../dt/index.js';
+import type { FSManager, Worker } from '../../../std/index.js';
+import type { AppTesterCtx } from '../../ctx.js';
+interface Input {
+    appPath: AppTesterCtx['appPath'];
+}
+interface Output {
+    errors: ErrorMessage[];
+}
+export declare class AppFolderChecker implements Worker<Input, Promise<Output>> {
+    private fsManager;
+    private output;
+    constructor(fsManager: FSManager);
+    exec({ appPath }: Input): Promise<Output>;
+    private makeSureSrcItemsAreAllowed;
+}
+export {};

package/dist/esm/testing/workers/checkers/AppFolderChecker.js

@@ -0,0 +1,51 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { inject, injectable } from 'inversify';
+import { APP_I18N_FILE_NAME, APP_INSTALLER_FILE_NAME, APP_MANIFEST_FILE_NAME, APP_SETTINGS_FILE_NAME, APP_SRC_DIR_NAME, APP_SRC_LIB_DIR_NAME, APP_SRC_UCDS_DIR_NAME, } from '../../../convention.js';
+const ALLOWED_SRC_ITEMS = [
+    APP_SRC_LIB_DIR_NAME,
+    APP_SRC_UCDS_DIR_NAME,
+    APP_I18N_FILE_NAME,
+    APP_INSTALLER_FILE_NAME,
+    APP_MANIFEST_FILE_NAME,
+    APP_SETTINGS_FILE_NAME,
+];
+const ERR_UNALLOWED_SRC_ITEM = (item) => `The app ${APP_SRC_DIR_NAME} folder should contain only the following items : ${ALLOWED_SRC_ITEMS.join(', ')} but found ${item}. Remove it or move it to 'lib'`;
+let AppFolderChecker = class AppFolderChecker {
+    fsManager;
+    output;
+    constructor(fsManager) {
+        this.fsManager = fsManager;
+        this.output = { errors: [] };
+    }
+    async exec({ appPath }) {
+        const srcPath = this.fsManager.path(appPath, APP_SRC_DIR_NAME);
+        const contents = await this.fsManager.ls(srcPath);
+        const items = contents.map((i) => i.path);
+        this.makeSureSrcItemsAreAllowed(items);
+        return this.output;
+    }
+    makeSureSrcItemsAreAllowed(items) {
+        for (const item of items) {
+            if (!ALLOWED_SRC_ITEMS.includes(item)) {
+                this.output.errors.push(ERR_UNALLOWED_SRC_ITEM(item));
+            }
+        }
+    }
+};
+AppFolderChecker = __decorate([
+    injectable(),
+    __param(0, inject('FSManager')),
+    __metadata("design:paramtypes", [Object])
+], AppFolderChecker);
+export { AppFolderChecker };

package/dist/esm/utils/bundling/vite/StripUCDLifecycleServerPlugin.d.ts

@@ -0,0 +1,2 @@
+import type { PluginOption } from 'vite';
+export declare const StripUCDLifecycleServerPlugin: PluginOption;

package/dist/esm/utils/bundling/vite/StripUCDLifecycleServerPlugin.js

@@ -0,0 +1,18 @@
+import { UC_DEF_FILE_NAME_SUFFIX } from '../../../convention.js';
+import { stripUCDLifecycleServer } from '../../../uc/index.js';
+export const StripUCDLifecycleServerPlugin = {
+    // Why enforce ?
+    // Otherwise Rollup parses the file and strips trailing commas.
+    // We need them to strip correctly (although the implementation will be made more robust).
+    enforce: 'pre',
+    name: 'strip-ucd-lifecycle-server',
+    transform: (src, id) => {
+        if (id.match(new RegExp(`${UC_DEF_FILE_NAME_SUFFIX}$`)) === null) {
+            return;
+        }
+        const code = stripUCDLifecycleServer(src);
+        return {
+            code,
+        };
+    },
+};

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

@@ -1,6 +1,6 @@
-import { JoseJWTManager } from '../../index.std-jwt-manager-jose.js';
 import { FakeEmailManager } from '../../std/impl/FakeEmailManager.js';
 import { FakeJobManager } from '../../std/impl/FakeJobManager.js';
+import { JoseJWTManager } from '../../std/impl/JoseJWTManager.js';
 export function bindServer(container) {
     // std
     container.bind('EmailManager').to(FakeEmailManager);

package/package.json

@@ -1,12 +1,22 @@
 {
     "name": "libmodulor",
     "description": "An opinionated TypeScript library to create business oriented applications",
-    "version": "0.6.1",
+    "version": "0.8.0",
     "license": "LGPL-3.0",
     "author": "Chafik H'nini <chafik.hnini@gmail.com>",
     "homepage": "https://github.com/c100k/libmodulor#readme",
     "bugs": "https://github.com/c100k/libmodulor/issues",
-    "keywords": ["library", "typescript", "business application", "use case", "app", "product", "target", "auto-test", "auto-documentation"],
+    "keywords": [
+        "library",
+        "typescript",
+        "business application",
+        "use case",
+        "app",
+        "product",
+        "target",
+        "auto-test",
+        "auto-documentation"
+    ],
     "type": "module",
     "module": "./dist/esm/index.js",
     "exports": {
@@ -19,6 +29,9 @@
         "./locales/fr": {
             "import": "./dist/esm/i18n/locales/fr.js"
         },
+        "./node-express": {
+            "import": "./dist/esm/index.node-express.js"
+        },
         "./node-mcp": {
             "import": "./dist/esm/index.node-mcp.js"
         },
@@ -54,9 +67,16 @@
         }
     },
     "bin": "./dist/esm/products/Helper/index.js",
+    "scripts": {
+        "lint": "biome check --write .",
+        "lint:ci": "biome check"
+    },
+    "devDependencies": {
+        "@biomejs/biome": "^1.9.4"
+    },
     "peerDependencies": {
         "@hono/node-server": "^1.13.8",
-        "@modelcontextprotocol/sdk": "^1.6.0",
+        "@modelcontextprotocol/sdk": "^1.6.1",
         "@stricli/core": "^1.1.1",
         "buffer": "^6.0.3",
         "cookie-parser": "^1.4.7",
@@ -64,7 +84,7 @@
         "express-fileupload": "^1.5.1",
         "fast-check": "^3.23.2",
         "helmet": "^8.0.0",
-        "hono": "^4.7.2",
+        "hono": "^4.7.4",
         "inversify": "^6.2.2",
         "jose": "^6.0.8",
         "knex": "^3.1.0",
@@ -74,9 +94,9 @@
         "react-native": "^0.78.0",
         "reflect-metadata": "^0.2.2",
         "sqlite3": "^5.1.7",
-        "typescript": "^5.7.3",
-        "vite": "^6.2.0",
-        "vitest": "^3.0.7"
+        "typescript": "^5.8.2",
+        "vite": "^6.2.1",
+        "vitest": "^3.0.8"
     },
     "peerDependenciesMeta": {
         "@hono/node-server": {
@@ -88,6 +108,18 @@
         "@stricli/core": {
             "optional": true
         },
+        "cookie-parser": {
+            "optional": true
+        },
+        "express": {
+            "optional": true
+        },
+        "express-fileupload": {
+            "optional": true
+        },
+        "helmet": {
+            "optional": true
+        },
         "hono": {
             "optional": true
         },

package/.github/ISSUE_TEMPLATE/generic-issue.md

@@ -1,16 +0,0 @@
----
-name: Generic Issue
-about: Describe this issue template's purpose here.
-title: ''
-labels: ''
-assignees: ''
-
----
-
-## Problem
-
-<!-- State the problem clearly with as much details as you can. It can be a new feature request or a bug. Either way, there should be a clear problem -->
-
-## Potential Solution(s)
-
-<!-- If you have ideas, feel free to suggest them, we love it. We'll discuss the solutions and find the best one for everyone -->

package/.github/dependabot.yml

@@ -1,19 +0,0 @@
-# To get started with Dependabot version updates, you'll need to specify which
-# package ecosystems to update and where the package manifests are located.
-# Please see the documentation for all configuration options:
-# https://help.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
-
-version: 2
-updates:
-  - package-ecosystem: "npm"
-    directory: "/"
-    schedule:
-      interval: "weekly"
-    ignore:
-      - dependency-name: "inversify"
-        versions: ["7.x"]
-    groups:
-      dev:
-        dependency-type: "development"
-      prod:
-        dependency-type: "production"