libmodulor 0.28.0 → 0.30.0

package/dist/esm/uc/metadata.d.ts

@@ -1,4 +1,5 @@
 import type { AppName } from '../app/index.js';
+import { UC_INPUT_SUFFIX, UC_OPI0_SUFFIX, UC_OPI1_SUFFIX } from '../convention.js';
 import type { IconCode } from '../icon/index.js';
 /**
  * The type of action the use case performs
@@ -14,6 +15,9 @@ export type FQUCNameSeparator = '_';
  * It's made with the {@link AppName} and the {@link UCName} linked by {@link FQUCNameSeparator}.
  */
 export type FQUCName = `${AppName}${FQUCNameSeparator}${UCName}`;
+export type FQUCInputName = `${FQUCName}${typeof UC_INPUT_SUFFIX}`;
+export type FQUCOPI0Name = `${FQUCName}${typeof UC_OPI0_SUFFIX}`;
+export type FQUCOPI1Name = `${FQUCName}${typeof UC_OPI1_SUFFIX}`;
 export interface UCMetadata {
     action: UCAction;
     beta?: boolean;
@@ -24,4 +28,7 @@ export interface UCMetadata {
 }
 export declare const FQ_UC_NAME_SEPARATOR: FQUCNameSeparator;
 export declare function formatFQUCName(appName: AppName, ucName: UCName): FQUCName;
+export declare function formatFQUCInputName(fqUCName: FQUCName): FQUCInputName;
+export declare function formatFQUCOPI0Name(fqUCName: FQUCName): FQUCOPI0Name;
+export declare function formatFQUCOPI1Name(fqUCName: FQUCName): FQUCOPI1Name;
 export declare function parseFQUCName(value: string): [AppName, UCName];

package/dist/esm/uc/metadata.js

@@ -1,9 +1,19 @@
+import { UC_INPUT_SUFFIX, UC_OPI0_SUFFIX, UC_OPI1_SUFFIX, } from '../convention.js';
 import { isCapitalized } from '../utils/index.js';
 const ERR_INVALID_FQ_UC_NAME = (value) => `Invalid fully qualified use case name : ${value}`;
 export const FQ_UC_NAME_SEPARATOR = '_';
 export function formatFQUCName(appName, ucName) {
     return [appName, ucName].join(FQ_UC_NAME_SEPARATOR);
 }
+export function formatFQUCInputName(fqUCName) {
+    return `${fqUCName}${UC_INPUT_SUFFIX}`;
+}
+export function formatFQUCOPI0Name(fqUCName) {
+    return `${fqUCName}${UC_OPI0_SUFFIX}`;
+}
+export function formatFQUCOPI1Name(fqUCName) {
+    return `${fqUCName}${UC_OPI1_SUFFIX}`;
+}
 export function parseFQUCName(value) {
     const elements = value.split(FQ_UC_NAME_SEPARATOR);
     if (elements.length !== 2) {

package/dist/esm/uc/opi.d.ts

@@ -1,4 +1,5 @@
-import type { DataType, UUID } from '../dt/index.js';
+import { type DataType, type UUID } from '../dt/index.js';
+import type { UCOutputPartDefFields } from './output-part.js';
 import type { Value } from './value.js';
 /**
  * Base interface all the use case OPI interfaces must extend
@@ -6,6 +7,7 @@ import type { Value } from './value.js';
 export interface UCOPIBase {
     id: UUID;
 }
+export declare const UCOPIBaseDefFields: UCOutputPartDefFields<UCOPIBase>;
 /**
  * A value returned as part of an OPI
  *

package/dist/esm/uc/opi.js

@@ -1 +1,4 @@
-export {};
+import { TUUID } from '../dt/index.js';
+export const UCOPIBaseDefFields = {
+    id: { type: new TUUID() },
+};

package/dist/esm/uc/output-field.d.ts

@@ -1,10 +1,20 @@
-import type { DataType, TBase } from '../dt/index.js';
+import type { DataType, TBase, UIntQuantity } from '../dt/index.js';
 import type { StringKeys } from '../utils/index.js';
+import { type UCFieldDefCardinality } from './cardinality.js';
 import type { UCOPIBase } from './opi.js';
 /**
  * Definition of a use case output field
  */
 export interface UCOutputFieldDef<OPI extends UCOPIBase, T extends DataType> {
+    /**
+     * A field can have 0, 1 or n values. This field defines the rules.
+     *
+     * @defaultValue { max: 1, min: 1 } => it has a single value
+     *
+     * @example { max: 5, min: 0 } => it has at most 5 values or none
+     * @example { min: 0 } => it is nullable
+     */
+    cardinality?: UCFieldDefCardinality;
     /**
      * Indicates another field of the output this field can potentially link to (in the `<a></a>` way).
      */
@@ -15,3 +25,6 @@ export interface UCOutputFieldDef<OPI extends UCOPIBase, T extends DataType> {
     totalType?: 'sum';
     type: TBase<T>;
 }
+export declare function ucofExamples<OPI extends UCOPIBase, T extends DataType>(def: UCOutputFieldDef<OPI, T>): T[] | undefined;
+export declare function ucofIsMandatory<OPI extends UCOPIBase, T extends DataType>(def: UCOutputFieldDef<OPI, T>): boolean;
+export declare function ucofRepeatability<OPI extends UCOPIBase, T extends DataType>(def: UCOutputFieldDef<OPI, T>): [boolean, UIntQuantity];

package/dist/esm/uc/output-field.js

@@ -1 +1,11 @@
-export {};
+import { ucfIsMandatory, ucfRepeatability, } from './cardinality.js';
+import { ucfExamples } from './examples.js';
+export function ucofExamples(def) {
+    return ucfExamples(def.type);
+}
+export function ucofIsMandatory(def) {
+    return ucfIsMandatory(def.cardinality);
+}
+export function ucofRepeatability(def) {
+    return ucfRepeatability(def.cardinality);
+}

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

@@ -7,7 +7,7 @@ const ACTION_HTTP_METHOD_MAPPING = {
     Update: 'PUT',
     View: 'GET',
 };
-const METHODS_WITH_NO_BODY = ['GET', 'HEAD'];
+const METHODS_WITH_NO_BODY = ['DELETE', 'GET', 'HEAD'];
 export function ucHTTPContract(uc, pathPrefix = '/api/v1') {
     const { ext, metadata } = uc.def;
     const { action } = metadata;

package/dist/esm/utils/bundling/funcs.js

@@ -15,6 +15,6 @@ export function assertTransformedCorrectly(transformed, fileName) {
     if (match !== null) {
         // biome-ignore lint/suspicious/noConsole: we want it
         console.warn(transformed);
-        throw new Error(`[WARNING] The following file might not have been transformed correctly : ${fileName} (see transformed above)`);
+        throw new Error(`The following file might not have been transformed correctly : ${fileName} (see transformed above)`);
     }
 }

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

@@ -1,6 +1,6 @@
 export declare const Plugin: {
     name: string;
-    transform: (this: import("rollup").TransformPluginContext, code: string, id: string) => {
+    transform: (this: import("rolldown").TransformPluginContext, code: string, id: string) => {
         code: string;
     };
 };

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

@@ -1,2 +1,7 @@
+import type { URL } from '../../dt/index.js';
+export type HTTPCSPType = 'defaultSrc' | 'imgSrc' | 'scriptSrc';
+export type HTTPCSPValue = URL[];
+export type HTTPCookieSameSite = 'lax' | 'none' | 'strict';
 export type HTTPDataEnvelope = 'form-data' | 'json' | 'query-params';
 export type HTTPReqData = Record<string, unknown>;
+export type HTTPHeaderName = 'Accept' | 'Authorization' | 'Content-Type' | 'Cookie' | 'Origin' | 'X-Requested-With' | (string & {});

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

@@ -11,12 +11,13 @@ export { fromQueryParams, toQueryParams } from './http/query-params.js';
 export { SSEStreamManager } from './http/SSEStreamManager.js';
 export { fmtSingleDataMsg, fmtSSEError, isSSEError, parseDataLine, SSE_HEADERS, } from './http/sse.js';
 export { isClientError, isError, isServerError } from './http/status.js';
-export type { HTTPDataEnvelope, HTTPReqData } from './http/types.js';
+export type { HTTPCookieSameSite, HTTPCSPType, HTTPCSPValue, HTTPDataEnvelope, HTTPHeaderName, HTTPReqData, } from './http/types.js';
 export { bindFactory } from './ioc/bindFactory.js';
 export { CONTAINER_OPTS } from './ioc/container.js';
 export type { Class } from './ioc/types.js';
 export { fmt as fmtNumber } from './numbers/fmt.js';
 export { baseFromSquareUnit, type CoreUnit, isSquareUnit, type SquareableUnit, type SquareUnit, type Unit, } from './numbers/units.js';
+export { defaultStreamOnClose } from './streams/funcs.js';
 export type { StreamConfig, StreamOnClose, StreamOnData, StreamOnDone, } from './streams/types.js';
 export { capitalize, isCapitalized } from './strings/capitalize.js';
 export { humanize } from './strings/humanize.js';

package/dist/esm/utils/index.js

@@ -11,6 +11,7 @@ export { bindFactory } from './ioc/bindFactory.js';
 export { CONTAINER_OPTS } from './ioc/container.js';
 export { fmt as fmtNumber } from './numbers/fmt.js';
 export { baseFromSquareUnit, isSquareUnit, } from './numbers/units.js';
+export { defaultStreamOnClose } from './streams/funcs.js';
 export { capitalize, isCapitalized } from './strings/capitalize.js';
 export { humanize } from './strings/humanize.js';
 export { truncate } from './strings/truncate.js';

package/dist/esm/utils/streams/funcs.d.ts

@@ -0,0 +1,2 @@
+import type { StreamOnClose } from './types.js';
+export declare function defaultStreamOnClose(streamedOnce: boolean): StreamOnClose;

package/dist/esm/utils/streams/funcs.js

@@ -0,0 +1,10 @@
+const ERR_MISSING_STREAM_ON_CLOSE = 'execOpts.stream.onClose needs to be set in the ServerMain to avoid memory leaks';
+export function defaultStreamOnClose(streamedOnce) {
+    return async () => {
+        if (!streamedOnce) {
+            // No need to close or register anything if it hasn't streamed anything yet
+            return;
+        }
+        throw new Error(ERR_MISSING_STREAM_ON_CLOSE);
+    };
+}

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "libmodulor",
     "description": "A TypeScript library to create platform-agnostic applications",
-    "version": "0.28.0",
+    "version": "0.30.0",
     "license": "LGPL-3.0",
     "author": "Chafik H'nini <chafik.hnini@gmail.com>",
     "homepage": "https://libmodulor.c100k.eu",
@@ -53,6 +53,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,33 +103,34 @@
         "test": "tsc && vitest run"
     },
     "devDependencies": {
-        "@biomejs/biome": "^2.4.13",
+        "@biomejs/biome": "^2.4.15",
         "@react-native-community/slider": "^4.5.7",
         "@types/react": "^19.2.14",
         "@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-image-picker": "^17.0.10",
+        "expo": "^55.0.24",
+        "expo-document-picker": "^14.0.8",
+        "expo-image-picker": "^17.0.11",
         "react-native-safe-area-context": "^5.7.0",
-        "wrangler": "^4.84.1"
+        "wrangler": "^4.91.0",
+        "zod": "^4.4.3"
     },
     "peerDependencies": {
         "@hono/node-server": "^1.19.14",
         "@modelcontextprotocol/sdk": "^1.29.0",
-        "@stricli/core": "^1.2.6",
+        "@stricli/core": "^1.2.7",
         "buffer": "^6.0.3",
         "cookie-parser": "^1.4.7",
         "express": "^5.2.1",
         "express-fileupload": "^1.5.2",
-        "fast-check": "^4.7.0",
+        "fast-check": "^4.8.0",
         "helmet": "^8.1.0",
-        "hono": "^4.12.15",
+        "hono": "^4.12.18",
         "inversify": "^7.11.0",
-        "jose": "^6.2.2",
-        "knex": "^3.2.9",
-        "next": "^15.5.15",
+        "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",
@@ -131,8 +138,9 @@
         "reflect-metadata": "^0.2.2",
         "sqlite3": "^5.1.7",
         "typescript": "^6.0.3",
-        "vite": "^6.4.2",
-        "vitest": "^3.2.4"
+        "vite": "^8.0.13",
+        "vitest": "^4.1.6",
+        "zod": "^4.4.3"
     },
     "peerDependenciesMeta": {
         "@hono/node-server": {
@@ -194,6 +202,9 @@
         },
         "vitest": {
             "optional": true
+        },
+        "zod": {
+            "optional": true
         }
     },
     "sideEffects": false

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

@@ -1,183 +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 { 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 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.inputFields.length > 0) {
-            const properties = {};
-            for (const f of uc.inputFields) {
-                const { def, key } = f;
-                const { desc } = this.wordingManager.ucif(f);
-                properties[key] = {
-                    ...propertyType(def),
-                    description: desc,
-                    required: ucifIsMandatory(def),
-                };
-            }
-            res.properties = properties;
-        }
-        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() {
-        this.runtime = new Server({
-            name: this.productManifest.name,
-            version: '0.1.0',
-        }, {
-            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,19 +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 Property<T extends PropertyPrimitiveType = PropertyPrimitiveType> = PropertyType<T> & {
-    description: string | null;
-    required: boolean;
-};
-export type Tool = ListToolsResult['tools'][0];