data-primals-engine 1.2.1 → 1.2.2

package/README.md

@@ -18,15 +18,18 @@
 
 ## 🚀 Key Features
 
-- **Dynamic data modeling**: Define and update schemas using JSON, no migrations required.
-- **Robust REST API**: Advanced CRUD operations, filtering, and querying.
-- **Modular architecture**: Load or extend modules dynamically.
-- **Automation workflows**: Trigger actions on events or schedules.
-- **Authentication & authorization**: Role-based access control, pluggable providers.
-- **📦 Starter Packs**: CRM, e-commerce, showcase websites, etc.
-- **🧠 AI Integration**: Supports OpenAI, Google Gemini via LangChain.
-- **🌐 i18n support**: Multilingual interfaces, translated validations.
-- **📄 Auto Documentation**: Swagger available at `/api-docs`.
+- **Dynamic Data Modeling**: Define and update schemas using JSON, no migrations required.
+- **Custom API Endpoints**: Create server-side logic and new API endpoints directly from the UI in a secure, sandboxed environment.
+- **Automation Workflows**: Trigger complex actions based on data events (create, update, delete) or schedules (cron).
+- **Advanced Querying & Aggregation**: Go beyond simple filters with deep relation expansion, complex lookups, and dynamic calculated fields.
+- **Integrated Backup & Restore**: Secure, encrypted user data backups with rotation policies, supporting both local and AWS S3 storage.
+- **Event-Driven & Extensible**: A core event system allows for deep customization and the easy creation of new modules or plugins.
+- **Authentication & Authorization**: Robust role-based access control (RBAC) and pluggable user providers.
+- **Built-in File Management**: Handle file uploads seamlessly with integrated support for AWS S3 storage.
+- **🧠 AI Integration**: Natively supports OpenAI and Google Gemini models via LangChain for content generation, analysis, and more.
+- **🌐 Internationalization (i18n)**: Fully supports multilingual interfaces and user-specific translated data.
+- **📦 Starter Packs**: Quickly bootstrap applications with pre-built data packs for CRM, e-commerce, and more.
+- **📄Auto-Generated API Documentation**: Interactive API documentation available via the interface or at `/api-docs`.
 
 
 ## 🌟 Why Choose data-primals-engine?
@@ -603,11 +606,68 @@ Expected response :
   },
   "publishedPosts": 15
 }
+
+```
+
+---
+## Extensibility
+
+### Events (Triggers) Table
+> You can use the events below to access the engine and manipulate API responses.
+> It is useful for custom modules or middlewares for your application.
+
+Just use
+
+```javascript
+Event.Listen("OnDataAdded", (data) => {
+     my_callback()
+}, "event", "user");
+```
+
+or the system version
+```javascript
+Event.Listen("OnDataAdded", (engine, data) => {
+     my_callback()
+}, "event", "system");
+```
+
+| Event | Description                                                             | Scope | Triggered by | Arguments (Payload) | 
+| :--- |:------------------------------------------------------------------------| :--- | :--- | :--- |
+| OnServerStart | Triggered once the HTTP server is started and listening.                | System | engine.start() | engine | 
+| OnServerStop | Triggered right after the HTTP server is stopped.                       | System | engine.stop() | engine |
+| OnModelsLoaded | Triggered after the initial models are loaded and validated at startup. | System | setupInitialModels() | engine, dbModels |
+| OnModelsDeleted | Triggered after all models are deleted via the reset function.          | System | engine.resetModels() | engine | 
+| OnUserDataDumped | Triggered after a user's data has been backed up (dumped).              | System | jobDumpUserData() | engine | 
+| OnDataRestored | Triggered after a user's data has been restored from a backup.          | System | loadFromDump() | (none) |
+| OnPackInstalled | Triggered after a data pack has been successfully installed.            | System | installPack() | pack | 
+| OnModelEdited | Triggered after a model definition has been modified.                   | System & User | editModel() | System: engine, newModel (Pipeline*)<br>User: newModel (or the version modified by the system) | 
+| OnDataAdded | Triggered after new data has been inserted.                             | System & User | insertData() | System: engine, insertedIds (Pipeline*)<br>User: insertedIds (or the version modified by the system) | 
+| OnDataDeleted | Triggered just after data is actually deleted.                          | System & User | deleteData() | System: engine, {model, filter} (Pipeline*)<br>User: {model, filter} | 
+| OnDataSearched | Triggered after a data search.                                          | System & User | searchData() | System: engine, {data, count} (Pipeline*)<br>User: {data, count} (or the version modified by the system) | 
+| OnDataExported | Triggered after a data export.                                          | System & User | exportData() | System: engine, exportResults, modelsToExport (Pipeline*)<br>User: exportResults, modelsToExport (or the version modified by the system) |
+
+### Triggering events
+
+If you want to provide your own hooks, you can call :
+```javascript
+const result = Event.Trigger("OnMyCustomEvent", "event", "user", ...args);
 ```
+Results are merged together if multiple events are triggered.
+- strings are concatenated
+- numbers are added
+- booleans are ANDed
+- arrays are concatenated
+- objects are merged using spread operator
+
+---
+
 ## 🤝 Contributing
 
+Find the issues available for [contributions here](https://github.com/anonympins/data-primals-engine/issues?q=is%3Aissue%20state%3Aopen%20label%3A%22help%20wanted%22%20no%3Aassignee)
+
 1. Fork the repo
 2. Create your feature branch: `git checkout -b feature/your-feature`
+3. Launch ```npm run dev``` and make your changes with hot-reload on local port 
 3. Commit changes: `git commit -m "Add new feature"`
 4. Push to your branch: `git push origin feature/your-feature`
 5. Open a pull request

package/client/src/DataLayout.jsx

@@ -2,35 +2,19 @@ import React, {forwardRef, useCallback, useEffect, useMemo, useReducer, useRef,
 
 import "./App.scss";
 import {useMutation, useQuery, useQueryClient} from "react-query";
-import {CheckboxField, FileField, NumberField, SelectField, TextField} from "./Field.jsx";
 import ModelCreator from "./ModelCreator.jsx";
 import {useModelContext} from "./contexts/ModelContext.jsx";
-import {FaMagnifyingGlass, FaPencil} from "react-icons/fa6";
 import {Dialog, DialogProvider} from "./Dialog.jsx";
 import {Pagination} from "./Pagination.jsx";
+import {Event} from "../../src/events.js";
+
 import {
-    elementsPerPage, kilobytes,
-    mainFieldsTypes,
-    maxBytesPerSecondThrottleData,
-    maxFileSize,
-    maxRequestData, metaModels
-} from "../../src/constants.js";
-import {
-    FaArrowDown,
-    FaArrowUp, FaBell,
-    FaBook, FaCopy,
-    FaEdit,
-    FaFileExport, FaFileImport,
     FaFilter, FaInfo,
-    FaLanguage,
-    FaLock,
-    FaPlus,
-    FaTrash
 } from "react-icons/fa";
 import {getDefaultForType, getUserId} from "../../src/data.js";
 import {Trans, useTranslation} from "react-i18next";
 
-import {debounce, escapeRegExp, event_trigger, getObjectHash, isGUID} from "../../src/core.js";
+import {getObjectHash} from "../../src/core.js";
 import Button from "./Button.jsx";
 import {useAuthContext} from "./contexts/AuthContext.jsx";
 import APIInfo from "./APIInfo.jsx";
@@ -49,7 +33,6 @@ import CalendarConfigModal from "./CalendarConfigModal.jsx";
 import KanbanView from "./KanbanView.jsx";
 
 
-// --- AJOUT : Composants Placeholders pour la démonstration ---
 const CalendarView = ({ settings, model }) => (
     <div className="p-4 border rounded-md mt-4 bg-gray-50">
         <h3 className="font-bold">Vue Calendrier</h3>
@@ -349,7 +332,7 @@ function DataLayout() {
 
             console.log('Données enregistrées:', data, selectedModel);
 
-            event_trigger(recordToEdit ? 'API_ADD_DATA' : 'API_ADD_DATA', {
+            Event.Trigger(recordToEdit ? 'API_ADD_DATA' : 'API_ADD_DATA', "custom", "data", {
                 model: selectedModel.name,
             });
 

package/client/src/DataTable.jsx

@@ -6,6 +6,8 @@ import {useAuthContext} from "./contexts/AuthContext.jsx";
 import React, {useEffect, useMemo, useRef, useState} from "react";
 import {getUserId} from "../../src/data.js";
 import cronstrue from 'cronstrue/i18n';
+import {Event} from "../../src/events.js";
+
 import {
     FaBook,
     FaCopy,
@@ -238,7 +240,7 @@ export function DataTable({
                         console.log('Données non trouvées');
                     }
 
-                    event_trigger('API_DELETE_DATA', { model: item._model, id: item._id });
+                    Event.Trigger('API_DELETE_DATA', "custom", "data",{ model: item._model, id: item._id });
                     queryClient.invalidateQueries(['api/data', item._model, 'page', page, elementsPerPage, pagedFilters[item._model], pagedSort[item._model]]);
 
                 } else {

package/client/src/RestoreConfirmationModal.jsx

@@ -15,80 +15,6 @@ const RestoreConfirmationModal = ({ isOpen, onClose, onConfirm, showS3Config = f
     const { me, fetchMe } = useAuthContext(); // fetchMe pour recharger les données utilisateur après sauvegarde
     const { addNotification } = useNotificationContext();
 
-    // États pour les champs de configuration S3
-    const [s3Config, setS3Config] = useState({
-        bucketName: '',
-        accessKeyId: '',
-        secretAccessKey: '', // Ne sera pas affiché directement mais envoyé
-        region: ''
-    });
-    const [isSavingS3Config, setIsSavingS3Config] = useState(false);
-    const [showConfig, setConfigVisible] = useState(false);
-
-    // Charger la configuration S3 existante de l'utilisateur au montage si me.s3Config existe
-    useEffect(() => {
-        if (me?.s3Config && showS3Config) {
-            setS3Config({
-                bucketName: me.s3Config.bucketName || '',
-                accessKeyId: me.s3Config.accessKeyId || '',
-                secretAccessKey: '', // Ne pas pré-remplir la clé secrète pour la sécurité
-                region: me.s3Config.region || '',
-                pathPrefix: me.s3Config.pathPrefix || ''
-            });
-        } else if (showS3Config) {
-            // Réinitialiser si pas de config ou si on quitte la section S3
-            setS3Config({ bucketName: '', accessKeyId: '', secretAccessKey: '', region: '', pathPrefix: '' });
-        }
-    }, [me, showS3Config, isOpen]); // Ajouter isOpen pour recharger si la modale est rouverte
-
-
-    const handleS3ConfigChange = (e) => {
-        const { name, value } = e.target;
-        setS3Config(prev => ({ ...prev, [name]: value }));
-    };
-
-    const handleSaveS3Config = async () => {
-        setIsSavingS3Config(true);
-        // Validation basique côté client
-        if (!s3Config.bucketName || !s3Config.accessKeyId || !s3Config.region) {
-            addNotification({ type: 'error', message: t('backup.s3config.validationError', 'Le nom du bucket, l\'Access Key ID et la Région sont requis.') });
-            setIsSavingS3Config(false);
-            return;
-        }
-
-        try {
-            const payload = { ...s3Config };
-            // N'envoyer la clé secrète que si elle a été modifiée
-            if (!payload.secretAccessKey) {
-                delete payload.secretAccessKey;
-            }
-
-            const response = await fetch('/api/user/s3-config', { // Endpoint pour sauvegarder la config S3
-                method: 'POST',
-                headers: {
-                    'Content-Type': 'application/json',
-                    // Les en-têtes d'authentification (_user, Authorization) sont gérés globalement par le fetch wrapper si tu en as un, sinon ajoute-les ici
-                    // Exemple:
-                    // '_user': me?.username,
-                    // 'Authorization': `Bearer ${me?.token}`,
-                },
-                body: JSON.stringify(payload),
-            });
-            const result = await response.json();
-            if (response.ok && result.success) {
-                addNotification({ status: 'completed', title: t('backup.s3config.saveSuccess', 'Configuration S3 enregistrée avec succès.') });
-            } else {
-                addNotification({ status: 'error', title: result.error || t('backup.s3config.saveError', 'Erreur lors de l\'enregistrement de la configuration S3.') });
-            }
-        } catch (error) {
-            addNotification({ status: 'error', title: t('backup.s3config.saveError', 'Erreur lors de l\'enregistrement de la configuration S3.') });
-            console.error("Error saving S3 config:", error);
-        } finally {
-            setIsSavingS3Config(false);
-        }
-    };
-
-
     if (!isOpen) {
         return null;
     }
@@ -110,71 +36,8 @@ const RestoreConfirmationModal = ({ isOpen, onClose, onConfirm, showS3Config = f
                             <Trans i18nKey="btns.cancel">Annuler</Trans>
                         </Button>
                     </div>
-                    <div className={"flex flex-centered actions"}>
-                        {!showConfig && (<NavLink onClick={() => setConfigVisible(true)}><Trans i18nKey={"backup.s3config.title"}></Trans></NavLink>)}
-                    </div>
                 </>
 
-                {showConfig && (<>
-                    <h2>{t('backup.s3config.title', 'Configuration du stockage S3')}</h2>
-                    <p><Trans i18nKey="backup.prez"></Trans></p>
-                    <form className="s3-config-form space-y-4"> {/* Ajout de space-y pour l'espacement vertical */}
-                        <TextField
-                            name="bucketName"
-                            className={"flex flex-1"}
-                            label={t('backup.s3config.bucketName', 'Nom du Bucket S3')}
-                            value={s3Config.bucketName}
-                            onChange={handleS3ConfigChange}
-                            placeholder="my-bucket-name"
-                            required
-                        />
-                        <TextField
-                            name="accessKeyId"
-                            className={"flex flex-1"}
-                            label={t('backup.s3config.accessKeyId', 'Access Key ID AWS')}
-                            value={s3Config.accessKeyId}
-                            onChange={handleS3ConfigChange}
-                            placeholder="AKIAIOSFODNN7EXAMPLE"
-                            required
-                        />
-                        <TextField
-                            name="secretAccessKey"
-                            className={"flex flex-1"}
-                            label={t('backup.s3config.secretAccessKey', 'Secret Access Key AWS')}
-                            type="password" // Important pour masquer la clé
-                            value={s3Config.secretAccessKey}
-                            onChange={handleS3ConfigChange}
-                            placeholder={t('backup.s3config.secretPlaceholder', 'Laisser vide pour ne pas modifier')} />
-                        <TextField
-                            name="region"
-                            className={"flex flex-1"}
-                            label={t('backup.s3config.region', 'Région AWS')}
-                            value={s3Config.region}
-                            onChange={handleS3ConfigChange}
-                            placeholder="eu-west-3"
-                            required
-                        />
-                        <TextField
-                            name="pathPrefix"
-                            label={t('backup.s3config.pathPrefix', 'Préfixe de chemin (Optionnel)')}
-                            value={s3Config.pathPrefix}
-                            onChange={handleS3ConfigChange}
-                            placeholder="saves/my-app/"
-                            help={t('backup.s3config.pathPrefixHelp', 'Ex: "mon-dossier/". Laissez vide pour la racine du bucket.')}
-                        />
-                        <div
-                            className="modal-actions flex justify-end space-x-2 mt-4"> {/* Flex pour aligner les boutons */}
-                            <Button onClick={handleSaveS3Config} disabled={isSavingS3Config}
-                                    className="btn-primary"> {/* Classe btn-primary pour le bouton principal */}
-                                {isSavingS3Config ? t('btns.saving', 'Enregistrement...') : t('btns.save', 'Enregistrer la configuration S3')}
-                            </Button>
-                            <Button onClick={onClose} className="btn-secondary">
-                                <Trans i18nKey="btns.cancel">Annuler</Trans>
-                            </Button>
-                        </div>
-                    </form>
-                </>)}
-
             </div>
         </Dialog>
     );

package/client/src/hooks/useTutorials.jsx

@@ -6,7 +6,7 @@ import { tutorialsConfig } from '../tutorials.js';
 import { useTranslation } from 'react-i18next';
 import { useCallback, useEffect, useMemo, useRef } from 'react';
 import useLocalStorage from "./useLocalStorage.js";
-import { event_off, event_on } from "../../../src/core.js";
+import {Event} from "../../../src/events.js";
 
 /**
  * Hook pour gérer la logique des tutoriels multi-étapes.
@@ -205,10 +205,10 @@ export const useTutorials = () => {
 
         console.log(me.activeTutorial + new Date().getMilliseconds());
         const eventTypes = ['API_ADD_DATA', 'API_EDIT_DATA', 'API_DELETE_DATA'];
-        eventTypes.forEach(type => event_on(type, handleDataChange));
+        eventTypes.forEach(type => Event.Listen(type, handleDataChange, "custom", "data"));
 
         return () => {
-            eventTypes.forEach(type => event_off(type, handleDataChange));
+            eventTypes.forEach(type => Event.RemoveCallback(type, handleDataChange, "custom", "data"));
         };
     }, [me?.activeTutorial]);
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "data-primals-engine",
-  "version": "1.2.1",
-  "description": "data-primals-engine is the package responsible from handling large amount of data in a practical and performant way. It can handle large amount of data in a practical and performant way. It can also get workflow models working (for automation), and fully supports internationalisation.",
+  "version": "1.2.2",
+  "description": "data-primals-engine is a package responsible from handling large amount of data using MongoDB in a practical and performant way. It can also get workflow models working (for automation), and fully supports internationalisation. It also has integrated AI assistant.",
   "main": "src/engine.js",
   "type": "module",
   "scripts": {

package/src/data.js

@@ -5,21 +5,21 @@ import {mainFieldsTypes} from "./constants.js";
 
 const IV_LENGTH = 16;
 export function encryptValue(text) {
-    if (!process.env.S3_CONFIG_ENCRYPTION_KEY) throw new Error("S3_CONFIG_ENCRYPTION_KEY is not set");
+    if (!process.env.ENCRYPTION_KEY) throw new Error("ENCRYPTION_KEY is not set");
     let iv = crypto.randomBytes(IV_LENGTH);
-    let cipher = crypto.createCipheriv('aes-256-cbc', Buffer.from(process.env.S3_CONFIG_ENCRYPTION_KEY), iv);
+    let cipher = crypto.createCipheriv('aes-256-cbc', Buffer.from(process.env.ENCRYPTION_KEY), iv);
     let encrypted = cipher.update(text);
     encrypted = Buffer.concat([encrypted, cipher.final()]);
     return iv.toString('hex') + ':' + encrypted.toString('hex');
 }
 
 export function decryptValue(text) {
-    if (!process.env.S3_CONFIG_ENCRYPTION_KEY) throw new Error("S3_CONFIG_ENCRYPTION_KEY is not set");
+    if (!process.env.ENCRYPTION_KEY) throw new Error("ENCRYPTION_KEY is not set");
     if (!text || typeof text !== 'string' || !text.includes(':')) return text; // ou throw error
     let textParts = text.split(':');
     let iv = Buffer.from(textParts.shift(), 'hex');
     let encryptedText = Buffer.from(textParts.join(':'), 'hex');
-    let decipher = crypto.createDecipheriv('aes-256-cbc', Buffer.from(process.env.S3_CONFIG_ENCRYPTION_KEY), iv);
+    let decipher = crypto.createDecipheriv('aes-256-cbc', Buffer.from(process.env.ENCRYPTION_KEY), iv);
     let decrypted = decipher.update(encryptedText);
     decrypted = Buffer.concat([decrypted, decipher.final()]);
     return decrypted.toString();

package/src/email.js

@@ -1,7 +1,7 @@
 import process from "node:process";
 import nodemailer from "nodemailer";
 import juice from "juice";
-import {event_trigger} from "./core.js";
+import {Event} from "./events.js";
 import {emailDefaultConfig} from "./constants.js";
 
 // Le transporteur par défaut, utilisé si aucune config spécifique n'est fournie.
@@ -52,7 +52,7 @@ export const sendEmail = async (email = "", data, smtpConfig = null, lang, tpl =
     // Choisir le transporteur à utiliser
     const transporter = smtpConfig ? createTransporter(smtpConfig||emailDefaultConfig) : defaultTransporter;
 
-    if (tpl === null) tpl = event_trigger("sendEmail:template",data, lang);
+    if (tpl === null) tpl = Event.Trigger("sendEmail:template", "system", "calls", data, lang);
     let html = tpl;
     try {
         html = juice(tpl);

package/src/engine.js

@@ -19,6 +19,7 @@ import {DefaultUserProvider} from "./providers.js";
 import formidableMiddleware from 'express-formidable';
 import sirv from "sirv";
 import * as tls from "node:tls";
+import {Event} from "./events.js";
 
 // Constants
 const isProduction = process.env.NODE_ENV === 'production'
@@ -79,13 +80,13 @@ export const Engine = {
     Create: async (options = { app : null}) => {
         const engine = GameObject.Create("Engine");
         console.log("Creating engine", Config.Get('modules'));
-        engine.addComponent(Logger);
+        const logger = engine.addComponent(Logger);
 
         engine.userProvider = new DefaultUserProvider(engine);
 
         engine.setUserProvider = (providerInstance) => {
             engine.userProvider = providerInstance;
-            engine.getComponent(Logger).info(`Custom UserProvider '${providerInstance.constructor.name}' has been set.`);
+            logger.info(`Custom UserProvider '${providerInstance.constructor.name}' has been set.`);
         };
 
         if (!options.app) {
@@ -130,9 +131,6 @@ export const Engine = {
             return engine._modules.find(m => m.module === module);
         };
 
-
-        const logger = engine.getComponent(Logger);
-
         const importModule = async (module) => {
             const moduleA = await import(module);
             if (moduleA.onInit){
@@ -147,13 +145,13 @@ export const Engine = {
 
         await Promise.all(Config.Get('modules', []).map(async module => {
             try {
-                if( fs.existsSync(module)){
+                if( fs.existsSync(module) ){
                     return await importModule(module);
                 }else {
                     return await importModule('./modules/' + module + ".js");
                 }
             } catch (e){
-                console.log('ERROR at loading module '+ module + ' in /modules dir.', e.stack);
+                logger.info('ERROR at loading module '+ module, e.stack);
             }
         })).then(async e => {
             engine._modules = e;
@@ -202,10 +200,13 @@ export const Engine = {
                 });
                 process.exit(1);
             });
+
+            Event.Trigger("OnServerStart", "event", "system", engine);
         }
 
         engine.stop = async () => {
             await server.close();
+            Event.Trigger("OnServerStop", "event", "system", engine);
         };
 
         async function setupInitialModels() {
@@ -228,9 +229,11 @@ export const Engine = {
                     logger.info('Model loaded (' + model.name + ')');
             }
             logger.info("All models loaded.");
+            Event.Trigger("OnModelsLoaded", "event", "system", engine, dbModels);
         }
         engine.resetModels = async () => {
             await deleteModels();
+            Event.Trigger("OnModelsDeleted", "event", "system", engine);
         };
         return engine;
     }

package/src/events.js

@@ -4,7 +4,9 @@ const events = {};
 const eventLayerSystems = {
     "priority": ["high", "medium", "low"],
     "log": ["info", "debug", "warn", "error", "critical"],
-    "system": ["calls"]
+    "system": ["calls", "users"],
+    "event": ["system","user"],
+    "custom": ["data"]
 };
 
 
@@ -13,11 +15,12 @@ export const Event = {
     Trigger: (name, system = "priority", layer = "medium", ...args) => {  // Ajout des arguments system et layer
         if (!events[system] || !events[system][name] || (layer && !events[system][name][layer])) {
             //console.warn(`No trigger found for ${name} in system ${system} layer ${layer}`);
-            return;
+            return null;
         }
 
         const systemsToProcess = system ? [system] : Object.keys(events); // Si system est spécifié, on cible ce système uniquement, sinon tous les systèmes
 
+        let ret = null;
         for (const currentSystem of systemsToProcess) {
             if (events[currentSystem] && events[currentSystem][name]) {
                 const layersToProcess = layer ? [layer] : eventLayerSystems[currentSystem] || Object.keys(events[currentSystem][name]); // Si layer est spécifié, on cible cette couche, sinon toutes les couches ou celles définies dans eventLayerSystems
@@ -27,7 +30,25 @@ export const Event = {
                         if (events[currentSystem][name][currentLayer]) {
                             for (const callback of events[currentSystem][name][currentLayer]) {
                                 try {
-                                    callback(...args);
+                                    const res = callback(...args);
+                                    if (typeof res === "object" && !Array.isArray(res)) {
+                                        if (typeof ret !== "object") ret = {};
+                                        ret = {...ret, ...res};
+                                    } else if (Array.isArray(res)) {
+                                        if (!Array.isArray(ret)) ret = [];
+                                        ret = ret.concat(res);
+                                    } else if (typeof res === "string") {
+                                        if (typeof ret !== "string") ret = "";
+                                        ret += res;
+                                    } else if (typeof res === "number") {
+                                        if (typeof ret !== "number") ret = 0;
+                                        ret += res;
+                                    } else if (typeof res === "boolean") {
+                                        if (typeof ret !== "boolean") ret = true;
+                                        ret = res && ret;
+                                    } else {
+                                        ret = res || ret;
+                                    }
                                 } catch (error) {
                                     console.error(`Error in callback for event ${name} in system ${currentSystem} layer ${currentLayer}:`, error);
                                 }
@@ -37,6 +58,7 @@ export const Event = {
                 }
             }
         }
+        return ret;
     },
     Listen: (name = "", callback = () => {}, system = "priority", layer = "medium") => {
         const validSystems = Object.keys(eventLayerSystems); // Récupération des clés pour une vérification plus performante