libmodulor 0.29.0 → 0.31.0

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "libmodulor",
     "description": "A TypeScript library to create platform-agnostic applications",
-    "version": "0.29.0",
+    "version": "0.31.0",
     "license": "LGPL-3.0",
     "author": "Chafik H'nini <chafik.hnini@gmail.com>",
     "homepage": "https://libmodulor.c100k.eu",
@@ -29,6 +29,9 @@
         "./cloudflare-worker-hono": {
             "import": "./dist/esm/index.cloudflare-worker-hono.js"
         },
+        "./instrumentation-otl": {
+            "import": "./dist/esm/index.instrumentation-otl.js"
+        },
         "./locales/de": {
             "import": "./dist/esm/i18n/locales/de.js"
         },
@@ -53,6 +56,12 @@
         "./node-mcp": {
             "import": "./dist/esm/index.node-mcp.js"
         },
+        "./node-mcp-express": {
+            "import": "./dist/esm/index.node-mcp-express.js"
+        },
+        "./node-mcp-hono": {
+            "import": "./dist/esm/index.node-mcp-hono.js"
+        },
         "./node-stricli-cli": {
             "import": "./dist/esm/index.node-stricli-cli.js"
         },
@@ -97,44 +106,59 @@
         "test": "tsc && vitest run"
     },
     "devDependencies": {
-        "@biomejs/biome": "^2.4.14",
+        "@babel/core": "^7.29.7",
+        "@biomejs/biome": "^2.5.2",
+        "@opentelemetry/auto-instrumentations-node": "^0.77.0",
+        "@opentelemetry/exporter-trace-otlp-http": "^0.220.0",
+        "@opentelemetry/resources": "^2.9.0",
+        "@opentelemetry/sdk-node": "^0.220.0",
+        "@opentelemetry/semantic-conventions": "^1.41.1",
         "@react-native-community/slider": "^4.5.7",
-        "@types/react": "^19.2.14",
+        "@types/react": "^19.2.17",
         "@types/react-dom": "^19.2.3",
-        "babel-plugin-parameter-decorator": "^1.0.16",
         "babel-plugin-transform-typescript-metadata": "^0.3.2",
-        "expo": "55.0.11",
-        "expo-document-picker": "~14.0.8",
+        "expo": "^57.0.2",
+        "expo-document-picker": "^14.0.8",
         "expo-image-picker": "^17.0.11",
-        "react-native-safe-area-context": "^5.7.0",
-        "wrangler": "^4.90.0"
+        "react-native-safe-area-context": "^5.8.0",
+        "wrangler": "^4.107.0",
+        "zod": "^4.4.3"
     },
     "peerDependencies": {
         "@hono/node-server": "^1.19.14",
         "@modelcontextprotocol/sdk": "^1.29.0",
-        "@stricli/core": "^1.2.6",
+        "@opentelemetry/api": "^1.9.1",
+        "@opentelemetry/instrumentation": "^0.220.0",
+        "@stricli/core": "^1.2.9",
         "buffer": "^6.0.3",
         "cookie-parser": "^1.4.7",
         "express": "^5.2.1",
         "express-fileupload": "^1.5.2",
-        "fast-check": "^4.7.0",
-        "helmet": "^8.1.0",
-        "hono": "^4.12.18",
+        "fast-check": "^4.8.0",
+        "helmet": "^8.2.0",
+        "hono": "^4.12.28",
         "inversify": "^7.11.0",
         "jose": "^6.2.3",
-        "knex": "^3.2.10",
-        "next": "^15.5.18",
-        "pg": "^8.20.0",
-        "react": "19.2.3",
-        "react-dom": "19.2.3",
-        "react-native": "^0.84.1",
+        "knex": "^3.3.0",
+        "next": "^15.5.20",
+        "pg": "^8.22.0",
+        "react": "^19.2.7",
+        "react-dom": "^19.2.7",
+        "react-native": "^0.86.0",
         "reflect-metadata": "^0.2.2",
         "sqlite3": "^5.1.7",
         "typescript": "^6.0.3",
-        "vite": "^6.4.2",
-        "vitest": "^3.2.4"
+        "vite": "^8.1.3",
+        "vitest": "^4.1.10",
+        "zod": "^4.4.3"
     },
     "peerDependenciesMeta": {
+        "@opentelemetry/api": {
+            "optional": true
+        },
+        "@opentelemetry/instrumentation": {
+            "optional": true
+        },
         "@hono/node-server": {
             "optional": true
         },
@@ -194,6 +218,9 @@
         },
         "vitest": {
             "optional": true
+        },
+        "zod": {
+            "optional": true
         }
     },
     "sideEffects": false

package/dist/esm/target/lib/openapi/consts.d.ts

@@ -1,2 +0,0 @@
-import type { OpenAPIDescription } from './types.js';
-export declare const SUCCESS_DESCRIPTION: OpenAPIDescription;

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

@@ -1 +0,0 @@
-export const SUCCESS_DESCRIPTION = '🕺🏽';

package/dist/esm/target/lib/openapi/input.d.ts

@@ -1,16 +0,0 @@
-import type { DataType } from '../../../dt/index.js';
-import { type UCInputField } from '../../../uc/index.js';
-import type { OpenAPIProperty } from './types.js';
-export interface OpenAPIInputDef<T extends DataType> {
-    /**
-     * Internal types that are not part of the spec
-     */
-    internal?: {
-        required?: boolean;
-    };
-    /**
-     * Fields that are part of the spec
-     */
-    spec?: OpenAPIProperty<T>;
-}
-export declare function openAPIInputDef<T extends DataType>(field: UCInputField<T>): OpenAPIInputDef<T>;

package/dist/esm/target/lib/openapi/input.js

@@ -1,33 +0,0 @@
-import { ucifExamples, ucifIsMandatory, ucifRepeatability, } from '../../../uc/index.js';
-export function openAPIInputDef(field) {
-    const def = {
-        internal: {},
-        spec: { type: 'string' },
-    };
-    if (!def.internal || !def.spec) {
-        // Just a guard to safely type the rest of the function without using !
-        return def;
-    }
-    const { def: fDef } = field;
-    const { type: fType } = fDef;
-    def.internal.required = ucifIsMandatory(fDef);
-    def.spec = fType.jsonSchemaType();
-    const examples = ucifExamples(fDef);
-    if (examples) {
-        def.spec.examples = examples;
-    }
-    const options = fType.getOptions();
-    if (options) {
-        def.spec.enum = options.map((o) => o.value);
-    }
-    const [isRepeatable] = ucifRepeatability(fDef);
-    if (isRepeatable) {
-        def.spec = {
-            items: def.spec,
-            maxItems: fDef.cardinality?.max,
-            minItems: fDef.cardinality?.min,
-            type: 'array',
-        };
-    }
-    return def;
-}

package/dist/esm/target/node-mcp-server/NodeLocalStdioMCPServerManager.js

@@ -1,188 +0,0 @@
-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 { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
-import { inject, injectable } from 'inversify';
-import { NotAvailableError } from '../../error/index.js';
-import { WordingManager } from '../../i18n/index.js';
-import { UCBuilder, ucifIsMandatory, ucMountingPoint, } from '../../uc/index.js';
-import { DEFAULT_VERSION } from '../lib/shared.js';
-import { propertyType, resError, resObj } from './funcs.js';
-/**
- * A simple MCP Server implementation
- *
- * Although it implements {@link ServerManager}, this implementation is not necessarily a "server".
- * Indeed, it uses a local `Transport` so it must be considered the same as a {@link NodeCoreCLIManager}.
- * Therefore, it calls `execClient` and not `execServer`.
- * This way, Claude AI, or any other client is just a wrapper on top of it.
- *
- * @alpha This implementation still has lots of TODOs and has not been tested in real conditions. It needs to be stabilized before usage.
- */
-let NodeLocalStdioMCPServerManager = class NodeLocalStdioMCPServerManager {
-    productManifest;
-    settingsManager;
-    ucBuilder;
-    ucManager;
-    wordingManager;
-    runtime;
-    transport;
-    appManifests;
-    tools;
-    constructor(productManifest, settingsManager, ucBuilder, ucManager, wordingManager) {
-        this.productManifest = productManifest;
-        this.settingsManager = settingsManager;
-        this.ucBuilder = ucBuilder;
-        this.ucManager = ucManager;
-        this.wordingManager = wordingManager;
-        this.appManifests = new Map();
-        this.tools = new Map();
-    }
-    s() {
-        return {
-            logger_level: this.settingsManager.get()('logger_level'),
-        };
-    }
-    overrideUCManager(ucManager) {
-        this.ucManager = ucManager;
-    }
-    async init() {
-        this.initCommon();
-    }
-    initSync() {
-        this.initCommon();
-    }
-    async mount(appManifest, ucd, contract) {
-        this.mountCommon(appManifest, ucd, contract);
-    }
-    mountSync(appManifest, ucd, contract) {
-        this.mountCommon(appManifest, ucd, contract);
-    }
-    async mountOpenAPISpec(_spec, _at) {
-        // Nothing to do
-    }
-    async mountStaticDir(_dirPath) {
-        throw new NotAvailableError('mountStaticDir');
-    }
-    async start() {
-        this.transport = new StdioServerTransport();
-        await this.runtime.connect(this.transport);
-    }
-    async stop() {
-        await this.runtime.close();
-        await this.transport.close();
-    }
-    async warmUp() {
-        this.runtime.setRequestHandler(ListToolsRequestSchema, async () => {
-            return {
-                tools: [...this.tools.values().map((v) => v.tool)],
-            };
-        });
-        this.runtime.setRequestHandler(CallToolRequestSchema, async (request) => this.execRequest(request));
-    }
-    buildInputSchema(uc) {
-        const res = {
-            type: 'object',
-        };
-        if (!uc.hasInput()) {
-            return res;
-        }
-        res.properties = {};
-        for (const f of uc.inputFields) {
-            const { def, key } = f;
-            const { desc } = this.wordingManager.ucif(f);
-            res.properties[key] = {
-                ...propertyType(def),
-                description: desc,
-                required: ucifIsMandatory(def),
-            };
-        }
-        return res;
-    }
-    async execRequest(request) {
-        const { name, arguments: args } = request.params;
-        // TODO : Check authentication in some way (see if MCP handles it)
-        const auth = null;
-        try {
-            const route = this.tools.get(name);
-            if (!route) {
-                throw new Error(`Unrecognized use case : ${name}`);
-            }
-            const { appName, ucd } = route;
-            const appManifest = this.appManifests.get(appName);
-            if (!appManifest) {
-                throw new Error(`Unrecognized app : ${appName}`);
-            }
-            const uc = this.ucBuilder.exec({
-                appManifest,
-                auth,
-                def: ucd,
-            });
-            if (args) {
-                // biome-ignore lint/suspicious/noExplicitAny: can be anything
-                uc.fill(args);
-            }
-            const confirmed = await this.ucManager.confirmClient(uc);
-            if (!confirmed) {
-                throw new Error('Ask for the user to confirm');
-            }
-            const ucor = await this.ucManager.execClient(uc);
-            return resObj(ucor);
-        }
-        catch (err) {
-            return resError(err);
-        }
-    }
-    initCommon() {
-        const { name, version } = this.productManifest;
-        this.runtime = new Server({
-            name: name,
-            version: version ?? DEFAULT_VERSION,
-        }, {
-            capabilities: {
-                tools: {},
-            },
-        });
-        if (this.s().logger_level !== 'error') {
-            const message = 'Set the logging_level to "error" as MCP does not want the server to log to stdout (see https://modelcontextprotocol.io/docs/tools/debugging#implementing-logging)';
-            // Depending on the `Logger` implementation, this.logger.error() might not write to stderr (e.g. can write to a file).
-            // That's why we explicitly write to stdout by calling console.error().
-            // biome-ignore lint/suspicious/noConsole: we want it
-            console.error(new Error(message));
-        }
-    }
-    mountCommon(appManifest, ucd, _contract) {
-        const uc = this.ucBuilder.exec({
-            appManifest,
-            auth: null,
-            def: ucd,
-        });
-        if (!this.appManifests.has(appManifest.name)) {
-            this.appManifests.set(appManifest.name, appManifest);
-        }
-        const inputSchema = this.buildInputSchema(uc);
-        const mountingPoint = uc.def.ext?.cmd?.mountAt ?? ucMountingPoint(uc);
-        const tool = { inputSchema, name: mountingPoint };
-        this.tools.set(mountingPoint, { appName: appManifest.name, tool, ucd });
-    }
-};
-NodeLocalStdioMCPServerManager = __decorate([
-    injectable(),
-    __param(0, inject('ProductManifest')),
-    __param(1, inject('SettingsManager')),
-    __param(2, inject(UCBuilder)),
-    __param(3, inject('UCManager')),
-    __param(4, inject(WordingManager)),
-    __metadata("design:paramtypes", [Object, Object, UCBuilder, Object, WordingManager])
-], NodeLocalStdioMCPServerManager);
-export { NodeLocalStdioMCPServerManager };

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

@@ -1,7 +0,0 @@
-import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-import { type DataType } from '../../dt/index.js';
-import { type UCInputFieldDef } from '../../uc/index.js';
-import type { PropertyType } from './types.js';
-export declare function propertyType<T extends DataType>(def: UCInputFieldDef<T>): PropertyType;
-export declare function resError(err: Error): CallToolResult;
-export declare function resObj<T>(obj: T): CallToolResult;

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

@@ -1,45 +0,0 @@
-import { TBoolean, TEmbeddedObject, TInt, TNumber, } from '../../dt/index.js';
-import { ucifRepeatability } from '../../uc/index.js';
-export function propertyType(def) {
-    const { cardinality, type } = def;
-    let primitive = 'string';
-    if (type instanceof TBoolean) {
-        primitive = 'boolean';
-    }
-    else if (type instanceof TInt) {
-        primitive = 'integer';
-    }
-    else if (type instanceof TNumber) {
-        primitive = 'number';
-    }
-    else if (type instanceof TEmbeddedObject) {
-        primitive = 'object';
-    }
-    const [isRepeatable] = ucifRepeatability(def);
-    const maxItems = cardinality?.max;
-    const minItems = cardinality?.min;
-    return isRepeatable
-        ? { items: { type: primitive }, maxItems, minItems, type: 'array' }
-        : { type: primitive };
-}
-export function resError(err) {
-    return {
-        content: [
-            {
-                text: err.message,
-                type: 'text',
-            },
-        ],
-        isError: true,
-    };
-}
-export function resObj(obj) {
-    return {
-        content: [
-            {
-                text: JSON.stringify(obj),
-                type: 'text',
-            },
-        ],
-    };
-}

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

@@ -1,15 +0,0 @@
-import type { ListToolsResult } from '@modelcontextprotocol/sdk/types.js';
-import type { UIntQuantity } from '../../dt/index.js';
-export type PropertyPrimitiveType = 'boolean' | 'integer' | 'number' | 'object' | 'string';
-export type PropertyArrayType<T extends PropertyPrimitiveType> = {
-    items: {
-        type: T;
-    };
-    maxItems?: UIntQuantity | undefined;
-    minItems?: UIntQuantity | undefined;
-    type: 'array';
-};
-export type PropertyType<T extends PropertyPrimitiveType = PropertyPrimitiveType> = {
-    type: T;
-} | PropertyArrayType<T>;
-export type Tool = ListToolsResult['tools'][0];