data-primals-engine 1.0.10 → 1.1.0

package/client/src/tutorials.js

@@ -0,0 +1,112 @@
+// Fichier : src/tutorials.js
+
+export const tutorialsConfig = [
+    {
+        id: 'contact-management-basics',
+        name: 'Gestion des contacts : Les bases',
+        description: 'Apprenez les opérations fondamentales : créer et supprimer un contact.',
+        icon: 'FaUserPlus',
+        stages: [
+            {
+                stage: 1,
+                tourName: 'tour-create-contact', // Nom du tour guidé à lancer
+                name: 'Créez votre premier contact',
+                description: 'Ajoutez un nouveau contact avec le prénom "Richard".',
+                completionCondition: { model: 'contact', limit: 1, filter: { "firstName": "Richard" } }
+            },
+            {
+                stage: 2,
+                tourName: 'tour-delete-contact',
+                name: 'Effacez vos traces',
+                description: 'Maintenant, supprimez le contact "Richard" que vous venez de créer.',
+                // La condition pour valider une suppression est de vérifier que le nombre d'éléments correspondants est 0.
+                completionCondition: { model: 'contact', limit: 0, filter: { "firstName": "Richard" } }
+            }
+        ],
+        rewards: {
+            xpBonus: 150,
+            achievement: 'CONTACT_MANAGER_NOVICE',
+            notification: { title: 'Gestionnaire de contacts', message: 'Vous maîtrisez les bases de la gestion de contacts !' }
+        }
+    },
+    {
+        id: 'advanced-permissions',
+        name: 'Permissions & rôles',
+        description: 'Maîtrisez la gestion des droits du bout des doigts !',
+        icon: 'FaUserShield',
+        stages: [
+            {
+                stage: 1,
+                tourName: 'tour-set-permissions',
+                name: 'Gestion des droits utilisateurs',
+                description: 'Trouvez l\'utilisateur "userTuto" et donnez-lui le droit "visitor".',
+                completionCondition: {model: 'user', limit: 1, filter: {"username": "userTuto", "roles": { "$find": {"$eq":["$$this.name","visitor"]}}}}
+            },
+            {
+                stage: 2,
+                tourName: 'tour-create-role',
+                name: 'Créer un nouveau rôle',
+                description: 'Créez un rôle personnalisé nommé "Modérateur".',
+                // Condition : un document dans le modèle 'role' avec le nom 'Modérateur' doit exister.
+                // (On suppose ici l'existence d'un modèle 'role' pour gérer les rôles).
+                completionCondition: { model: 'role', limit: 1, filter: { "name": "moderator" } }
+            },
+            {
+                stage: 3,
+                tourName: 'tour-assign-permission-to-role',
+                name: 'Ajouter une permission au rôle',
+                description: 'Modifiez le rôle "moderator" pour lui ajouter la permission "API_EDIT_DATA_content".',
+                // Condition : le rôle 'Modérateur' doit avoir une permission nommée 'delete_contact'.
+                // (On suppose que le modèle 'role' a un champ 'permissions' qui est un tableau de relations).
+                completionCondition: { model: 'role', limit: 1, filter: { "name": "moderator", "permissions": { "$find": { "$eq": ["$$this.name", "API_EDIT_DATA_content"] } } } }
+            },
+            {
+                stage: 4,
+                tourName: 'tour-assign-role-to-user',
+                name: 'Promouvoir un utilisateur',
+                description: 'Maintenant, assignez votre rôle "moderator" à l\'utilisateur "userTuto".',
+                // Condition : l'utilisateur 'userTuto' doit maintenant aussi avoir le rôle 'Modérateur'.
+                completionCondition: { model: 'user', limit: 1, filter: { "username": "userTuto", "roles": { "$find": { "$eq": ["$$this.name", "moderator"] } } } }
+            }
+        ],
+        rewards: {
+            xpBonus: 500,
+            achievement: 'PERMISSION_ARCHITECT',
+            notification: { title: 'Architecte des Permissions', message: 'Vous savez maintenant comment finement gérer les accès !' }
+        }
+    },
+    {
+        id: 'requests',
+        name: 'Suivi d\'Activité',
+        description: 'Découvrez les succès liés à l\'activité.',
+        icon: 'FaUserShield',
+        stages: [
+            {
+                stage: 1,
+                tourName: null, // Pas de tour guidé, l'action peut se faire n'importe où
+                name: 'Première requête',
+                description: 'Effectuez des actions pour générer 50 requêtes système pour débloquer votre premier succès d\'activité.',
+                completionCondition: {model: 'request', limit: 50, filter: {}}
+            },
+            {
+                stage: 2,
+                tourName: null,
+                name: 'Activité soutenue',
+                description: 'Continuez votre activité et atteignez 250 requêtes pour le prochain palier.',
+                completionCondition: {model: 'request', limit: 250, filter: {}}
+            },
+            {
+                stage: 3,
+                tourName: null,
+                name: 'Expert en requêtes',
+                description: 'Impressionnant ! Atteignez 1000 requêtes pour prouver votre maîtrise.',
+                completionCondition: {model: 'request', limit: 1000, filter: {}}
+            }
+        ],
+        rewards: {
+            xpBonus: 1000,
+            achievement: 'REQUEST_MASTER',
+            notification: { title: 'Maître des Requêtes', message: 'Votre activité sur le réseau est remarquable !' }
+        }
+    }
+];

package/client/vite.config.js

@@ -0,0 +1,30 @@
+import { defineConfig } from 'vite'
+import react from '@vitejs/plugin-react'
+
+// https://vite.dev/config/
+export default defineConfig({
+    plugins: [react()],
+    base: "/",
+    build: {
+        outDir: "dist"
+    },
+    server : {
+        proxy: {
+            '/api': {
+                target: 'http://localhost:7633',
+                secure: false,
+                changeOrigin: true,
+                // Optionnel mais utile pour le débogage :
+                // Affiche les requêtes proxy dans la console de Vite.
+                configure: (proxy, options) => {
+                    proxy.on('proxyReq', (proxyReq, req, res) => {
+                        console.log(`[Vite Proxy] Forwarding request: ${req.method} ${req.url} -> ${options.target}${proxyReq.path}`);
+                    });
+                }
+            }
+        }
+    },
+    fs: {
+        allow: ["./src"]
+    }
+})

package/eslint.config.js

@@ -0,0 +1,50 @@
+// eslint.config.js
+import globals from "globals";
+import js from "@eslint/js";
+// eslint.config.js
+import { defineConfig } from "eslint/config";
+
+export default defineConfig([
+    {
+        // Fichiers sur lesquels appliquer cette configuration
+        files: ["**/*.js"],
+
+        // Ignore les répertoires qui ne doivent pas être analysés
+        ignores: [
+            "node_modules/",
+            "dist/",
+            "coverage/",
+            "test-backups/"
+        ],
+
+        // Options liées au langage JavaScript
+        languageOptions: {
+            ecmaVersion: "latest", // Utilise la dernière version de JavaScript
+            sourceType: "module", // Votre projet utilise des modules ES
+            globals: {
+                ...globals.node,    // Globaux pour l'environnement Node.js
+                ...globals.es2021,  // Globaux pour ES2021
+                ...globals.vitest  // Globaux pour Vitest (describe, it, expect, etc.)
+            }
+        },
+
+        // Utilise les règles recommandées par ESLint
+        ...js.configs.recommended,
+
+        // Vos règles personnalisées (à ajuster selon vos préférences)
+        rules: {
+            // Erreurs potentielles
+            "no-console": "off", // Avertit sur l'utilisation de console.log, mais ne bloque pas
+            "no-unused-vars": ["warn", { "args": "none" }], // Avertit sur les variables non utilisées
+
+            // Meilleures pratiques
+            "eqeqeq": ["error", "always"], // Impose l'utilisation de === et !==
+
+            // Style du code
+            "indent": ["error", 4], // Impose une indentation de 4 espaces
+            "quotes": ["off"], // Impose l'utilisation de guillemets simples
+            "semi": ["off"], // Impose l'utilisation de points-virgules à la fin des instructions
+            "comma-dangle": ["error"] // Impose une virgule finale sur les objets et tableaux multilignes
+        }
+    }
+]);

package/package.json

@@ -1,20 +1,32 @@
 {
   "name": "data-primals-engine",
-  "version": "1.0.10",
+  "version": "1.1.0",
   "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.",
   "main": "src/engine.js",
   "type": "module",
   "scripts": {
-    "test": "cross-env MONGO_DB_URL=\"mongodb://localhost:27017\" PORT=7635 vitest --no-file-parallelism",
     "preinstall": "npx force-resolutions",
-    "devserver": "cross-env NODE_ENV=development node server.js",
+    "dev": "concurrently \"npm:client\" \"npm:devserver\"",
+    "prod": "npm run build-server && npm run server",
+    "client": "cd client && npm run dev",
+    "build-server": "vite build client --config client/vite.config.js --outDir dist",
+    "build-client": "cd client && npm run build",
     "server": "cross-env NODE_ENV=production node server.js",
+    "devserver": "npm run build-server && cross-env NODE_ENV=development PORT=7633 node server.js",
+    "lint": "eslint .",
+    "format": "prettier --write .",
+    "clean": "rm -rf node_modules package-lock.json",
+    "test": "cross-env MONGO_DB_URL=\"mongodb://localhost:27017\" PORT=7635 vitest --no-file-parallelism",
+    "audit": "npm audit --audit-level=high",
     "migrate:create": "node src/migrate.js create",
     "migrate:up": "node src/migrate.js up",
     "migrate:down": "node src/migrate.js down",
     "migrate:revert": "node src/migrate.js revert",
     "migrate:status": "node src/migrate.js status"
   },
+  "optionalDependencies": {
+    "@rollup/rollup-linux-x64-gnu": "4.6.1"
+  },
   "resolutions": {
     "tar-fs": "3.0.9",
     "on-headers": "1.1.0",
@@ -27,41 +39,49 @@
   "exports": {
     ".": "./src/index.js",
     "./modules/*": "./src/modules/*.js",
+    "./client": "./client/index.js",
     "./*": "./src/*.js"
   },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-query": ">=3.0.0"
+  },
   "dependencies": {
-    "@langchain/core": "^0.3.62",
-    "@langchain/google-genai": "^0.2.14",
-    "@langchain/openai": "^0.5.18",
+    "@langchain/core": "^0.3.66",
+    "@langchain/google-genai": "^0.2.16",
+    "@langchain/openai": "^0.6.3",
     "archiver": "^7.0.1",
     "aws-sdk": "^2.1692.0",
-    "bcrypt": "^5.1.1",
-    "body-parser": "^1.20.3",
+    "bcrypt": "^6.0.0",
+    "body-parser": "^2.2.0",
     "chalk": "^5.4.1",
     "check-disk-space": "^3.4.0",
-    "compression": "^1.8.0",
+    "compression": "^1.8.1",
     "cookie-parser": "^1.4.7",
-    "cronstrue": "^3.1.0",
-    "csv-parse": "^5.6.0",
+    "cronstrue": "^3.2.0",
+    "csv-parse": "^6.1.0",
+    "data-primals-engine": "^1.0.11",
     "date-fns": "^4.1.0",
-    "express": "^4.21.2",
-    "express-csrf-double-submit-cookie": "^1.2.1",
+    "express": "^5.1.0",
+    "express-csrf-double-submit-cookie": "^2.0.0",
     "express-formidable": "^1.2.0",
     "express-mongo-sanitize": "^2.2.0",
     "express-rate-limit": "^8.0.1",
-    "express-session": "^1.18.1",
-    "i18next": "^24.2.2",
-    "i18next-browser-languagedetector": "^8.0.4",
+    "express-session": "^1.18.2",
+    "i18next": "^25.3.2",
+    "i18next-browser-languagedetector": "^8.2.0",
     "juice": "^11.0.1",
-    "mathjs": "^14.4.0",
-    "mongodb": "^6.12.0",
+    "mathjs": "^14.6.0",
+    "mongodb": "^6.18.0",
     "node-cache": "^5.1.2",
     "node-schedule": "^2.1.1",
-    "nodemailer": "^6.10.0",
-    "openai": "^5.8.2",
+    "nodemailer": "^7.0.5",
+    "prop-types": "^15.8.1",
+    "openai": "^5.10.2",
+    "process": "^0.11.10",
     "randomcolor": "^0.6.2",
     "react-helmet": "^6.1.0",
-    "react-i18next": "^15.4.1",
+    "react-i18next": "^15.6.1",
     "react-markdown": "^10.1.0",
     "request-ip": "^3.3.0",
     "sanitize-html": "^2.17.0",
@@ -69,16 +89,17 @@
     "swagger-ui-express": "^5.0.1",
     "tar": "^7.4.3",
     "uniqid": "^5.4.0",
-    "vitest": "^3.2.3",
+    "vitest": "^3.2.4",
     "yaml": "^2.8.0"
   },
   "devDependencies": {
-    "@eslint/js": "^9.17.0",
-    "cross-env": "^7.0.3",
-    "eslint": "^9.17.0",
-    "globals": "^15.14.0",
-    "process": "^0.11.10"
+    "@eslint/js": "^9.32.0",
+    "concurrently": "^9.2.0",
+    "cross-env": "^10.0.0",
+    "eslint": "^9.32.0",
+    "globals": "^16.3.0"
   },
+  "subPackages": ["client"],
   "keywords": [
     "mongodb",
     "data",

package/server.js

@@ -5,6 +5,7 @@
 //set ES modules to be loaded by the script
 import process from "node:process";
 import {Config, Engine, BenchmarkTool, GameObject, Logger} from "./src/index.js";
+import sirv from "sirv";
 
 Config.Set("modules", ["mongodb", "data", "file", "bucket", "workflow","user", "assistant", "swagger"])
 Config.Set("middlewares", []);
@@ -29,4 +30,12 @@ engine.start(port, async (r) => {
     const logger = engine.getComponent(Logger);
     console.log("Server started on port" + port);
     timer.stop();
+
+    // 2. Use sirv to serve static files from 'client/dist'
+    // The 'single: true' option is key for SPAs. It will serve 'index.html'
+    // for any route that doesn't match a file, enabling client-side routing.
+    engine.use(sirv('client/dist', {
+        single: true,
+        dev: process.env.NODE_ENV === 'development'
+    }));
 });

package/src/constants.js

@@ -14,12 +14,13 @@ export const availableLangs = [
     "el",
     "ru",
     "cs",
-    "sv",
+    "sv"
 ];
 
+
 export const awsDefaultConfig = {
     bucketName : 'bucket-primals',
-    region: 'eu-north-1',
+    region: 'eu-north-1'
 }
 
 export const emailDefaultConfig = {
@@ -70,21 +71,8 @@ export const maxExecutionsByStep = 5;
 export const maxWorkflowSteps = 15;
 
 export const maxPrivateFileSize = 20 * megabytes; // Taille max par fichier privé (20 Mo)
-export const maxTotalPrivateFilesSizeFree = 125 * megabytes; // Stockage total pour les comptes gratuits (250 Mo)
-export const maxTotalPrivateFilesSizeStandard = 250 * megabytes; // Stockage total pour les comptes standard (250 Mo)
-export const maxTotalPrivateFilesSizePremium = 20000 * kilobytes * kilobytes; //
-
-export const plans = {
-    free:{
-        maxModelsPerUser,
-        maxTotalDataPerUser,
-        maxDataPerModelPerUser,
-        requestLimitPerHour: 7200,
-    },
-    premium: {
-        requestLimitPerHour: 250000,
-    }
-}
+export const maxTotalPrivateFilesSize = 250 * megabytes;
+
 //
 export const optionsSanitizer = {
     allowedTags: [
@@ -103,9 +91,9 @@ export const optionsSanitizer = {
         code: ['class'],
         img: [ 'src', "alt","width","height","style" ]
     },
-// Lots of these won't come up by default because we don't allow them
+    // Lots of these won't come up by default because we don't allow them
     selfClosing: [ 'img', 'br', 'hr', 'area', 'base', 'basefont', 'input', 'link', 'meta' ],
-// URL schemes we permit
+    // URL schemes we permit
     allowedSchemes: [ 'http', 'https', 'ftp', 'mailto', 'tel' ],
     allowedSchemesByTag: {},
     allowedSchemesAppliedToAttributes: [ 'href', 'src', 'cite' ],
@@ -123,14 +111,15 @@ metaModels['i18n'] = { load: ['translation','lang']};
 metaModels['website'] = { load: ['webpage', 'content', 'taxonomy', 'contact', 'event', 'resource'], 'require': ['i18n'] };
 metaModels['messaging'] = { load: ['alert','ticket', 'message', 'channel'], 'require': ['i18n'] };
 metaModels['eshopping'] = { load: [
-        'order', 'currency', 'product', 'productVariant', 'discount', 'cart', 'cartItem',
-        'brand', 'return', 'review', 'stock', 'returnItem', 'userSubscription',
-        'warehouse', 'shipment', 'campaign', 'stockAlert', 'invoice'],
-    'require': ['i18n', 'users', 'messaging'] };
+    'order', 'currency', 'product', 'productVariant', 'discount', 'cart', 'cartItem',
+    'brand', 'return', 'review', 'stock', 'returnItem', 'userSubscription',
+    'warehouse', 'shipment', 'campaign', 'stockAlert', 'invoice'],
+'require': ['i18n', 'users', 'messaging'] };
 metaModels['workflow'] = { load: ['env', 'workflow', 'workflowRun', 'workflowAction', 'workflowStep', 'workflowTrigger']};
 metaModels['erp'] = { load: [ 'accountingExercise', 'accountingLineItem', 'accountingEntry', 'employee', 'dashboard', 'kpi'] };
 
 
+
 export const allowedFields = ['locked', 'hiddenable', 'anonymized', 'condition', 'color', 'index', 'type', 'required', 'hint', 'default', 'validate', 'unique', 'name', 'placeholder', 'asMain'];
 
 

package/src/core.js

@@ -136,7 +136,7 @@ export function shuffle(array) {
     let currentIndex = array.length;
 
     // While there remain elements to shuffle...
-    while (currentIndex != 0) {
+    while (currentIndex !== 0) {
 
         // Pick a remaining element...
         let randomIndex = Math.floor(Math.random() * currentIndex);
@@ -164,15 +164,16 @@ export const setSeed = (s)=>{
     seed = s;
 }
 function splitmix32(a) {
-        a |= 0;
-        a = a + 0x9e3779b9 | 0;
-        let t = a ^ a >>> 16;
-        t = Math.imul(t, 0x21f0aaad);
-        t = t ^ t >>> 15;
-        t = Math.imul(t, 0x735a2d97);
-        return ((t = t ^ t >>> 15) >>> 0) / 4294967296;
+    a |= 0;
+    a = a + 0x9e3779b9 | 0;
+    let t = a ^ a >>> 16;
+    t = Math.imul(t, 0x21f0aaad);
+    t = t ^ t >>> 15;
+    t = Math.imul(t, 0x735a2d97);
+    return ((t = t ^ t >>> 15) >>> 0) / 4294967296;
 }
 
+
 export const getRand = () =>splitmix32(seed);
 
 export const getRandom = (minInclusive,maxInclusive) => {

package/src/data.js

@@ -183,39 +183,40 @@ export function getDefaultForType(field) {
     if(field.default)
         return typeof(field.default) === 'function' ? field.default() : field.default;
     switch (field.type) {
-        case 'string':
-        case 'string_t':
-        case 'richtext':
-        case 'password':
-        case 'email':
-        case 'phone':
-        case 'url':
-            return '';
-        case 'model':
-            return '';
-        case 'modelField':
-            return { model: '', field: '' };
-        case 'color':
-            return null;
-        case 'number':
-            return 0;
-        case 'date':
-        case 'datetime':
-            return null;
-        case 'boolean':
-            return false;
-        case 'file':
-            return null;
-        case 'array':
-            return [];
-        case 'enum':
-            return field.required && field.items && field.items.length > 0 ? field.items[0] : null;
-        case 'object':
-            return {};
-        case 'relation':
-            return field.multiple ? [] : null;
-        default:
-            return undefined;
+    case 'string':
+    case 'string_t':
+    case 'richtext':
+    case 'password':
+    case 'email':
+    case 'phone':
+    case 'url':
+        return '';
+    case 'model':
+        return '';
+    case 'modelField':
+        return { model: '', field: '' };
+    case 'color':
+        return null;
+    case 'number':
+        return 0;
+    case 'date':
+    case 'datetime':
+        return null;
+    case 'boolean':
+        return false;
+    case 'file':
+        return null;
+    case 'array':
+        return [];
+    case 'enum':
+        return field.required && field.items && field.items.length > 0 ? field.items[0] : null;
+    case 'object':
+        return {};
+    case 'relation':
+        return field.multiple ? [] : null;
+    default:
+            
+        return undefined;
     }
 }
 
@@ -319,54 +320,54 @@ function buildApiConditionPayloadRecursive(conditionNode) {
 
         // --- Build the specific $expr based on the operator ---
         switch (exprOperator) {
-            case '$nin':
-                const ninValueArray = Array.isArray(value) ? value : String(value).split(',').map(s => s.trim()).filter(Boolean);
-                // Note: $nin at the top level is often better handled *outside* $expr
-                // but for consistency with $find, we keep it inside $expr here.
-                // If segmentsForNesting.length === 0, a standard query { field: { $nin: [...] } } might be more efficient.
-                exprPayload = { '$not': { '$in': [fieldPathForExpr, ninValueArray] } };
-                break;
-            case '$in':
-                const inValueArray = Array.isArray(value) ? value : String(value).split(',').map(s => s.trim()).filter(Boolean);
-                // Similar note as $nin regarding top-level efficiency.
-                exprPayload = { '$in': [fieldPathForExpr, inValueArray] };
-                break;
-            case '$regexMatch':
-                exprPayload = {
-                    '$regexMatch': {
-                        input: fieldPathForExpr,
-                        regex: String(value),
-                        options: 'i'
-                    }
-                };
-                break;
-            case '$exists':
-                const shouldExist = typeof value === 'boolean' ? value : String(value).toLowerCase() === 'true';
-                // Using $ne/$eq with $type is a common way to check existence in $expr
-                exprPayload = {
-                    [shouldExist ? '$ne' : '$eq']: [ { $type: fieldPathForExpr }, "undefined" ]
-                };
-                // Note: For top-level, { field: { $exists: true/false } } is standard.
-                break;
-            default:
-                // Standard binary operators ($eq, $ne, $gt, $gte, $lt, $lte)
-                let processedValue = value;
-                // Basic type guessing for common string values
-                if (operator === '$eq' || operator === '$ne') {
-                    if (value === 'true') processedValue = true;
-                    else if (value === 'false') processedValue = false;
-                    else if (value === 'null') processedValue = null;
-                    // Avoid automatic number conversion for eq/ne unless explicitly needed
-                } else if (['$gt', '$gte', '$lt', '$lte'].includes(operator)) {
-                    // Attempt number conversion for comparison operators
-                    const num = Number(value);
-                    if (!isNaN(num) && String(value).trim() !== '') {
-                        processedValue = num;
-                    }
-                    // TODO: Consider adding date conversion if field type is known
+        case '$nin':
+            const ninValueArray = Array.isArray(value) ? value : String(value).split(',').map(s => s.trim()).filter(Boolean);
+            // Note: $nin at the top level is often better handled *outside* $expr
+            // but for consistency with $find, we keep it inside $expr here.
+            // If segmentsForNesting.length === 0, a standard query { field: { $nin: [...] } } might be more efficient.
+            exprPayload = { '$not': { '$in': [fieldPathForExpr, ninValueArray] } };
+            break;
+        case '$in':
+            const inValueArray = Array.isArray(value) ? value : String(value).split(',').map(s => s.trim()).filter(Boolean);
+            // Similar note as $nin regarding top-level efficiency.
+            exprPayload = { '$in': [fieldPathForExpr, inValueArray] };
+            break;
+        case '$regexMatch':
+            exprPayload = {
+                '$regexMatch': {
+                    input: fieldPathForExpr,
+                    regex: String(value),
+                    options: 'i'
                 }
-                exprPayload = { [exprOperator]: [fieldPathForExpr, processedValue] };
-                break;
+            };
+            break;
+        case '$exists':
+            const shouldExist = typeof value === 'boolean' ? value : String(value).toLowerCase() === 'true';
+            // Using $ne/$eq with $type is a common way to check existence in $expr
+            exprPayload = {
+                [shouldExist ? '$ne' : '$eq']: [ { $type: fieldPathForExpr }, "undefined" ]
+            };
+            // Note: For top-level, { field: { $exists: true/false } } is standard.
+            break;
+        default:
+            // Standard binary operators ($eq, $ne, $gt, $gte, $lt, $lte)
+            let processedValue = value;
+            // Basic type guessing for common string values
+            if (operator === '$eq' || operator === '$ne') {
+                if (value === 'true') processedValue = true;
+                else if (value === 'false') processedValue = false;
+                else if (value === 'null') processedValue = null;
+                // Avoid automatic number conversion for eq/ne unless explicitly needed
+            } else if (['$gt', '$gte', '$lt', '$lte'].includes(operator)) {
+                // Attempt number conversion for comparison operators
+                const num = Number(value);
+                if (!isNaN(num) && String(value).trim() !== '') {
+                    processedValue = num;
+                }
+                // TODO: Consider adding date conversion if field type is known
+            }
+            exprPayload = { [exprOperator]: [fieldPathForExpr, processedValue] };
+            break;
         }
 
         // The final payload for the innermost level is the $expr object