libmodulor 0.22.0 → 0.23.0

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # CHANGELOG
 
+## v0.23.0 (2025-11-11)
+
+See all the changes here : https://github.com/c100k/libmodulor/compare/v0.22.0...master
+
 ## v0.22.0 (2025-10-25)
 
 **Added**

package/README.md

@@ -17,4 +17,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.22.0/LICENSE)
+[LGPL-3.0](https://github.com/c100k/libmodulor/blob/v0.23.0/LICENSE)

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

@@ -81,13 +81,13 @@ export const PACKAGE_JSON = (name) => `{
         "test": "tsc && vitest run --passWithNoTests"
     },
     "dependencies": {
-        "inversify": "^7.10.3",
+        "inversify": "^7.10.4",
         "libmodulor": "latest",
         "reflect-metadata": "^0.2.2"
     },
     "devDependencies": {
-        "@biomejs/biome": "^2.2.7",
-        "@types/node": "^24.9.1",
+        "@biomejs/biome": "^2.3.4",
+        "@types/node": "^24.10.0",
         "@vitest/coverage-v8": "^3.2.4",
         "buffer": "^6.0.3",
         "cookie-parser": "^1.4.7",

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

@@ -6,7 +6,7 @@ export type { RenderUCEntrypointTouchable, RenderUCExecTouchable, UCEntrypointTo
 export { UCContainer } from './target/lib/react/UCContainer.js';
 export { UCEntrypoint } from './target/lib/react/UCEntrypoint.js';
 export { type Props as UCOutputFieldValueFragmentProps, UCOutputFieldValueFragment, } from './target/lib/react/UCOutputFieldValueFragment.js';
-export { UCPanel } from './target/lib/react/UCPanel.js';
+export { type Props as UCPanelProps, UCPanel, } from './target/lib/react/UCPanel.js';
 export { type UseActionOpts, useAction, } from './target/lib/react/useAction.js';
 export { type CloneFunc, type DivertFunc, type RefillFunc, useUC, } from './target/lib/react/useUC.js';
 export { type AppendFunc, type RemoveFunc, type UpdateFunc, useUCOR, } from './target/lib/react/useUCOR.js';

package/dist/esm/index.react.js

@@ -3,7 +3,7 @@ export { StyleContext, StyleContextProvider, styleDef, useStyleContext, } from '
 export { UCContainer } from './target/lib/react/UCContainer.js';
 export { UCEntrypoint } from './target/lib/react/UCEntrypoint.js';
 export { UCOutputFieldValueFragment, } from './target/lib/react/UCOutputFieldValueFragment.js';
-export { UCPanel } from './target/lib/react/UCPanel.js';
+export { UCPanel, } from './target/lib/react/UCPanel.js';
 export { useAction, } from './target/lib/react/useAction.js';
 export { useUC, } from './target/lib/react/useUC.js';
 export { useUCOR, } from './target/lib/react/useUCOR.js';

package/dist/esm/std/JWTManager.d.ts

@@ -41,6 +41,19 @@ export interface JWTManager {
      * @param opts
      */
     decode<T extends JWTManagerPayload>(value: JWT, opts?: JWTManagerDecodeOpts): Promise<T>;
+    /**
+     * Decode the token without checking the signature
+     *
+     * IMPORTANT : IT DOES NOT CHECK THE SIGNATURE
+     *
+     * The main purpose of this method is to be used client side to decode the JWT in order to update some state including :
+     *   - displaying the firstname in the UI
+     *   - set the payload in some state
+     *   - etc.
+     *
+     * @param value
+     */
+    decodeUnsafe<T extends JWTManagerPayload>(value: JWT): Promise<T>;
     /**
      * Encode the payload
      *
@@ -53,7 +66,9 @@ export interface JWTManager {
     /**
      * Check whether the token is usable or not
      *
-     * Note that the signature is not checked. Indeed, the main purpose of this method is to be used client side to save some requests (e.g. when the token is expired).
+     * IMPORTANT : IT DOES NOT CHECK THE SIGNATURE
+     *
+     * The main purpose of this method is to be used client side to save some requests (e.g. when the token is expired).
      * In this case, no need to send a request that will trigger an error. Better to renew the token at the client's initiative.
      */
     isUsable(value: JWT): Promise<boolean>;

package/dist/esm/std/impl/JoseJWTManager.d.ts

@@ -1,6 +1,6 @@
 import type { JWT } from '../../dt/index.js';
 import type { ClockManager } from '../ClockManager.js';
-import type { JWTManager, JWTManagerDecodeOpts, JWTManagerEncodeOpts, JWTManagerSettings } from '../JWTManager.js';
+import type { JWTManager, JWTManagerDecodeOpts, JWTManagerEncodeOpts, JWTManagerPayload, JWTManagerSettings } from '../JWTManager.js';
 import type { SettingsManager } from '../SettingsManager.js';
 export type S = Omit<JWTManagerSettings, 'jwt_manager_invalidate_issued_before'>;
 export declare class JoseJWTManager implements JWTManager {
@@ -8,7 +8,8 @@ export declare class JoseJWTManager implements JWTManager {
     private settingsManager;
     constructor(clockManager: ClockManager, settingsManager: SettingsManager<S>);
     s(): S;
-    decode<T extends object>(value: JWT, opts?: JWTManagerDecodeOpts): Promise<T>;
+    decode<T extends JWTManagerPayload>(value: JWT, opts?: JWTManagerDecodeOpts): Promise<T>;
+    decodeUnsafe<T extends JWTManagerPayload>(value: JWT): Promise<T>;
     encode<T extends object>(payload: T, opts?: JWTManagerEncodeOpts): Promise<JWT>;
     isUsable(value: JWT): Promise<boolean>;
 }

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

@@ -54,6 +54,10 @@ let JoseJWTManager = class JoseJWTManager {
         }
         throw new Error(`Unsupported alg ${alg}`);
     }
+    async decodeUnsafe(value) {
+        const decoded = decodeJwt(value);
+        return decoded;
+    }
     async encode(payload, opts) {
         const alg = opts?.alg ?? this.s().jwt_manager_algorithm;
         const aud = opts?.aud ?? this.s().jwt_manager_audience;

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

@@ -90,7 +90,7 @@ let SimpleHTTPAPICaller = class SimpleHTTPAPICaller {
         });
         const { ok, redirected } = response;
         if (ok || redirected) {
-            return this.processResGood({ opts, outputBuilder, stream }, isFormURLEncoded, isJSON, isNDJSON, isSSE, isXML, response);
+            return this.processResGood({ opts, outputBuilder, stream }, abortController, isFormURLEncoded, isJSON, isNDJSON, isSSE, isXML, response);
         }
         const message = await this.processResBad({ errBuilder, opts }, isJSON, isXML, response);
         this.throwError(message ?? unknownErrorMessage, status);
@@ -173,13 +173,14 @@ let SimpleHTTPAPICaller = class SimpleHTTPAPICaller {
             return JSON.stringify(error);
         }
     }
-    async processResGood({ opts, outputBuilder, stream, }, isFormURLEncoded, isJSON, isNDJSON, isSSE, isXML, response) {
+    async processResGood({ opts, outputBuilder, stream, }, abortController, isFormURLEncoded, isJSON, isNDJSON, isSSE, isXML, response) {
         let payload;
         if (isNDJSON && stream) {
             if (!response.body) {
                 throw new Error(ERR_STREAM_UNAVAILABLE);
             }
             await this.ndJSONStreamManager.exec({
+                abortController,
                 onData: async (data) => {
                     if (outputBuilder) {
                         stream.onData(await outputBuilder(data));
@@ -196,6 +197,7 @@ let SimpleHTTPAPICaller = class SimpleHTTPAPICaller {
                 throw new Error(ERR_STREAM_UNAVAILABLE);
             }
             await this.sseStreamManager.exec({
+                abortController,
                 onData: async (data) => {
                     if (outputBuilder) {
                         stream.onData(await outputBuilder(data));

package/dist/esm/target/lib/client/consts.js

@@ -2,6 +2,7 @@
  * @see TARGET_DEFAULT_SERVER_MANAGER_SETTINGS
  */
 export const TARGET_DEFAULT_SERVER_CLIENT_MANAGER_SETTINGS = {
+    server_cookies_name_auth: 'auth',
     server_public_api_key: 'PublicApiKeyToBeChangedWhenDeploying',
     server_public_api_key_header_name: 'X-API-Key',
     server_public_url: 'http://localhost:7443',

package/dist/esm/target/lib/react/UCPanel.d.ts

@@ -6,17 +6,16 @@ import type { RenderUCForm } from './form.js';
 import type { RenderUCAutoExecLoader } from './loader.js';
 import type { UCPanelCtx, UCPanelOnDone, UCPanelOnError, UCPanelOnInit, UCPanelOnStartSubmitting } from './panel.js';
 import type { RenderUCExecTouchable } from './touchable.js';
-type Props<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined> = Pick<UCPanelCtx<I, OPI0, OPI1>, 'clearAfterExec' | 'uc'> & {
-    autoExec?: boolean;
-    onDone?: UCPanelOnDone<I, OPI0, OPI1>;
-    onInit?: UCPanelOnInit<I, OPI0, OPI1>;
-    onError?: UCPanelOnError;
-    onStartSubmitting?: UCPanelOnStartSubmitting;
+export type Props<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined> = Pick<UCPanelCtx<I, OPI0, OPI1>, 'clearAfterExec' | 'uc'> & {
+    autoExec?: boolean | undefined;
+    onDone?: UCPanelOnDone<I, OPI0, OPI1> | undefined;
+    onInit?: UCPanelOnInit<I, OPI0, OPI1> | undefined;
+    onError?: UCPanelOnError | undefined;
+    onStartSubmitting?: UCPanelOnStartSubmitting | undefined;
     renderAutoExecLoader: RenderUCAutoExecLoader;
     renderExecTouchable: RenderUCExecTouchable<I, OPI0, OPI1>;
     renderForm: RenderUCForm<I, OPI0, OPI1>;
-    sleepInMs?: UIntDuration;
+    sleepInMs?: UIntDuration | undefined;
     stream?: StreamConfig<UCOutputReader<I, OPI0, OPI1>> | undefined;
 };
 export declare function UCPanel<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined>({ autoExec, clearAfterExec, onDone, onError, onInit, onStartSubmitting, renderAutoExecLoader, renderForm, renderExecTouchable, sleepInMs, stream, uc, }: Props<I, OPI0, OPI1>): ReactElement;
-export {};

package/dist/esm/target/lib/react/useUC.js

@@ -1,4 +1,4 @@
-import { useState } from 'react';
+import { useEffect, useState } from 'react';
 import { UC, } from '../../../uc/index.js';
 /**
  * This hook provides utilities to init a use case and perform actions on it in a React way
@@ -21,6 +21,16 @@ export function useUC(appManifest, def, auth, opts) {
         }
         return v;
     });
+    // biome-ignore lint/correctness/useExhaustiveDependencies(appManifest): avoid infinite re-rendering
+    // biome-ignore lint/correctness/useExhaustiveDependencies(def): avoid infinite re-rendering
+    // biome-ignore lint/correctness/useExhaustiveDependencies(opts?.fillWith): avoid infinite re-rendering
+    useEffect(() => {
+        const v = new UC(appManifest, def, auth);
+        if (opts?.fillWith) {
+            v.fill(opts?.fillWith);
+        }
+        setUC(v);
+    }, [auth]);
     /**
      * Get a new `UC` based on the initial one
      * @param i

package/dist/esm/target/lib/server/ServerManager.d.ts

@@ -27,6 +27,7 @@ export interface ServerManagerSettings extends ServerManagerAuthSettings, Settin
     server_ssl_fullchain_path: FilePath | null;
     server_ssl_key_path: FilePath | null;
     server_static_dir_path: DirPath | null;
+    server_stop_mode: 'aggressive' | 'patient';
     server_tmp_path: FilePath;
 }
 export interface ServerManager extends Initializable {

package/dist/esm/target/lib/server/consts.js

@@ -19,5 +19,6 @@ export const TARGET_DEFAULT_SERVER_MANAGER_SETTINGS = {
     server_ssl_fullchain_path: null,
     server_ssl_key_path: null,
     server_static_dir_path: null,
+    server_stop_mode: 'patient',
     server_tmp_path: 'tmp',
 };

package/dist/esm/target/lib/server-express/funcs.js

@@ -14,7 +14,9 @@ export function buildHandler(appManifest, ucd, contract, serverRequestHandler, u
             case 'stream': {
                 execOpts = {
                     stream: {
-                        onClose: async () => { },
+                        onClose: async () => {
+                            throw new Error('execOpts.stream.onClose needs to be set in the UC ServerMain');
+                        },
                         onData: async (output) => {
                             if (!output) {
                                 return;
@@ -31,7 +33,6 @@ export function buildHandler(appManifest, ucd, contract, serverRequestHandler, u
                 }
                 res.flushHeaders();
                 res.on('close', async () => {
-                    res.end();
                     await execOpts?.stream?.onClose();
                 });
                 break;

package/dist/esm/target/lib/server-node/funcs.d.ts

@@ -1,5 +1,5 @@
 import type { Logger, SettingsManager } from '../../../std/index.js';
 import type { EntrypointsBuilder } from '../server/EntrypointsBuilder.js';
-import type { ListenSettings, Server } from './types.js';
+import type { ListenSettings, Server, StopSettings } from './types.js';
 export declare function listen(server: Server, entrypointsBuilder: EntrypointsBuilder, logger: Logger, settingsManager: SettingsManager<ListenSettings>): void;
-export declare function stop(server: Server): Promise<void>;
+export declare function stop(server: Server, settingsManager: SettingsManager<StopSettings>): Promise<void>;

package/dist/esm/target/lib/server-node/funcs.js

@@ -5,16 +5,26 @@ export function listen(server, entrypointsBuilder, logger, settingsManager) {
         logger.info(`Listening on ${entrypointsBuilder.exec().http}`);
     });
 }
-export async function stop(server) {
+export async function stop(server, settingsManager) {
     if (!server?.listening) {
         return;
     }
+    const mode = settingsManager.get()('server_stop_mode');
     // As stated in the docs of `close`, only awaiting `.close` is not enough to make sure all the connections are closed.
     // Hence the wrapping in a promise, where the callback is called when the 'close' event is emitted.
     return new Promise((resolve, reject) => {
         if (!server) {
             return resolve();
         }
+        switch (mode) {
+            case 'aggressive':
+                server.closeAllConnections();
+                break;
+            case 'patient':
+                break;
+            default:
+                ((_) => { })(mode);
+        }
         server.close((err) => {
             if (err) {
                 return reject(err);

package/dist/esm/target/lib/server-node/types.d.ts

@@ -3,3 +3,4 @@ import type https from 'node:https';
 import type { ServerManagerSettings } from '../server/ServerManager.js';
 export type Server = http.Server | https.Server;
 export type ListenSettings = Pick<ServerManagerSettings, 'server_binding_host' | 'server_binding_port'>;
+export type StopSettings = Pick<ServerManagerSettings, 'server_stop_mode'>;

package/dist/esm/target/node-express-server/NodeExpressServerManager.d.ts

@@ -8,8 +8,8 @@ import type { ServerManager, ServerManagerSettings } from '../lib/server/ServerM
 import { ServerRequestHandler } from '../lib/server/ServerRequestHandler.js';
 import { ServerSSLCertLoader } from '../lib/server/ServerSSLCertLoader.js';
 import { HelmetMiddlewareBuilder } from '../lib/server-express/HelmetMiddlewareBuilder.js';
-import type { ListenSettings } from '../lib/server-node/types.js';
-type S = ListenSettings & Pick<LoggerSettings, 'logger_level'> & Pick<ServerManagerSettings, 'server_tmp_path'>;
+import type { ListenSettings, StopSettings } from '../lib/server-node/types.js';
+type S = ListenSettings & Pick<LoggerSettings, 'logger_level'> & Pick<ServerManagerSettings, 'server_tmp_path'> & StopSettings;
 export declare class NodeExpressServerManager implements Configurable<S>, ServerManager {
     private entrypointsBuilder;
     protected environmentManager: EnvironmentManager;

package/dist/esm/target/node-express-server/NodeExpressServerManager.js

@@ -47,6 +47,7 @@ let NodeExpressServerManager = class NodeExpressServerManager {
             logger_level: this.settingsManager.get()('logger_level'),
             server_binding_host: this.settingsManager.get()('server_binding_host'),
             server_binding_port: this.settingsManager.get()('server_binding_port'),
+            server_stop_mode: this.settingsManager.get()('server_stop_mode'),
             server_tmp_path: this.settingsManager.get()('server_tmp_path'),
         };
     }
@@ -79,7 +80,7 @@ let NodeExpressServerManager = class NodeExpressServerManager {
         listen(this.server, this.entrypointsBuilder, this.logger, this.settingsManager);
     }
     async stop() {
-        await stop(this.server);
+        await stop(this.server, this.settingsManager);
     }
     async warmUp() {
         // Nothing to do

package/dist/esm/target/node-hono-server/NodeHonoServerManager.d.ts

@@ -7,8 +7,8 @@ import { EntrypointsBuilder } from '../lib/server/EntrypointsBuilder.js';
 import type { ServerManager } from '../lib/server/ServerManager.js';
 import { ServerRequestHandler } from '../lib/server/ServerRequestHandler.js';
 import { ServerSSLCertLoader } from '../lib/server/ServerSSLCertLoader.js';
-import type { ListenSettings } from '../lib/server-node/types.js';
-type S = ListenSettings;
+import type { ListenSettings, StopSettings } from '../lib/server-node/types.js';
+type S = ListenSettings & StopSettings;
 export declare class NodeHonoServerManager implements Configurable<S>, ServerManager {
     private entrypointsBuilder;
     protected environmentManager: EnvironmentManager;

package/dist/esm/target/node-hono-server/NodeHonoServerManager.js

@@ -44,6 +44,7 @@ let NodeHonoServerManager = class NodeHonoServerManager {
         return {
             server_binding_host: this.settingsManager.get()('server_binding_host'),
             server_binding_port: this.settingsManager.get()('server_binding_port'),
+            server_stop_mode: this.settingsManager.get()('server_stop_mode'),
         };
     }
     getRuntime() {
@@ -75,7 +76,7 @@ let NodeHonoServerManager = class NodeHonoServerManager {
         listen(this.server, this.entrypointsBuilder, this.logger, this.settingsManager);
     }
     async stop() {
-        await stop(this.server);
+        await stop(this.server, this.settingsManager);
     }
     async warmUp() {
         // Nothing to do

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

@@ -18,8 +18,8 @@ export async function newNodeAppTester(serverPortRangeStart, idx, args) {
     const settings = {
         ...STD_DEFAULT_JWT_MANAGER_SETTINGS,
         ...TARGET_DEFAULT_SERVER_MANAGER_SETTINGS,
-        jwt_manager_audience: 'fik',
-        jwt_manager_issuer: 'fik',
+        jwt_manager_audience: 'libmodulor-test',
+        jwt_manager_issuer: 'libmodulor-test',
         jwt_manager_secret: new TPassword().example(),
         logger_level,
         server_basic_auth_entries: {
@@ -28,6 +28,7 @@ export async function newNodeAppTester(serverPortRangeStart, idx, args) {
         server_binding_port: serverPortRangeStart + idx,
         server_private_api_key_entries: [new TApiKey().example()],
         server_public_api_key_entries: [new TApiKey().example()],
+        server_stop_mode: 'aggressive',
     };
     const container = new Container(CONTAINER_OPTS);
     bindCommon(container, () => settings);

package/dist/esm/utils/http/NDJSONStreamManager.d.ts

@@ -1,12 +1,13 @@
 import type { HTTPAPICallExecutorResBody, Worker } from '../../std/index.js';
 type Encoding = 'utf-8';
 interface I<D extends object = object> {
+    abortController: AbortController;
     encoding?: Encoding | undefined;
     onData: (data: D) => Promise<void>;
     reader: ReturnType<HTTPAPICallExecutorResBody['getReader']>;
 }
 export declare class NDJSONStreamManager implements Worker<I, Promise<void>> {
     private static DEFAULT_ENCODING;
-    exec({ encoding, onData, reader, }: I): Promise<void>;
+    exec({ abortController, encoding, onData, reader, }: I): Promise<void>;
 }
 export {};

package/dist/esm/utils/http/NDJSONStreamManager.js

@@ -10,10 +10,13 @@ import { NDJSON_DATA_SEP } from './nd-json.js';
 let NDJSONStreamManager = class NDJSONStreamManager {
     static { NDJSONStreamManager_1 = this; }
     static DEFAULT_ENCODING = 'utf-8';
-    async exec({ encoding = NDJSONStreamManager_1.DEFAULT_ENCODING, onData, reader, }) {
+    async exec({ abortController, encoding = NDJSONStreamManager_1.DEFAULT_ENCODING, onData, reader, }) {
         const decoder = new TextDecoder(encoding);
         let buffer = '';
         while (true) {
+            if (abortController.signal.aborted) {
+                return;
+            }
             const { done, value } = await reader.read();
             if (done) {
                 return;

package/dist/esm/utils/http/SSEStreamManager.d.ts

@@ -1,12 +1,13 @@
 import type { HTTPAPICallExecutorResBody, Worker } from '../../std/index.js';
 type Encoding = 'utf-8';
 interface I<D extends object = object> {
+    abortController: AbortController;
     encoding?: Encoding | undefined;
     onData: (data: D) => Promise<void>;
     reader: ReturnType<HTTPAPICallExecutorResBody['getReader']>;
 }
 export declare class SSEStreamManager implements Worker<I, Promise<void>> {
     private static DEFAULT_ENCODING;
-    exec({ encoding, onData, reader, }: I): Promise<void>;
+    exec({ abortController, encoding, onData, reader, }: I): Promise<void>;
 }
 export {};

package/dist/esm/utils/http/SSEStreamManager.js

@@ -11,10 +11,13 @@ import { isSSEError, parseDataLine, SSE_DATA_SEP, SSE_MSG_SEP } from './sse.js';
 let SSEStreamManager = class SSEStreamManager {
     static { SSEStreamManager_1 = this; }
     static DEFAULT_ENCODING = 'utf-8';
-    async exec({ encoding = SSEStreamManager_1.DEFAULT_ENCODING, onData, reader, }) {
+    async exec({ abortController, encoding = SSEStreamManager_1.DEFAULT_ENCODING, onData, reader, }) {
         const decoder = new TextDecoder(encoding);
         let buffer = '';
         while (true) {
+            if (abortController.signal.aborted) {
+                return;
+            }
             const { done, value } = await reader.read();
             if (done) {
                 return;

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "libmodulor",
     "description": "A TypeScript library to create platform-agnostic applications",
-    "version": "0.22.0",
+    "version": "0.23.0",
     "license": "LGPL-3.0",
     "author": "Chafik H'nini <chafik.hnini@gmail.com>",
     "homepage": "https://libmodulor.c100k.eu",
@@ -81,11 +81,11 @@
         "lint:ci": "biome check"
     },
     "devDependencies": {
-        "@biomejs/biome": "^2.2.7"
+        "@biomejs/biome": "^2.3.4"
     },
     "peerDependencies": {
-        "@hono/node-server": "^1.19.5",
-        "@modelcontextprotocol/sdk": "^1.20.1",
+        "@hono/node-server": "^1.19.6",
+        "@modelcontextprotocol/sdk": "^1.21.0",
         "@stricli/core": "^1.2.4",
         "buffer": "^6.0.3",
         "cookie-parser": "^1.4.7",
@@ -93,8 +93,8 @@
         "express-fileupload": "^1.5.2",
         "fast-check": "^4.3.0",
         "helmet": "^8.1.0",
-        "hono": "^4.10.2",
-        "inversify": "^7.10.3",
+        "hono": "^4.10.4",
+        "inversify": "^7.10.4",
         "jose": "^6.1.0",
         "knex": "^3.1.0",
         "next": "^15.5.6",