json-object-editor 0.10.425 → 0.10.431

package/js/joe-full.js

@@ -12369,6 +12369,8 @@ Column Count
     this.Header = {}
     this.toggleHelpMenu = function(show,target){
 
+    }
+    this.listUnsavedChanges = function(){
     }
 	this.Header.Render = this.renderEditorHeader = function(specs){
         var BM = new Benchmarker();
@@ -14531,6 +14533,7 @@ this.renderHTMLContent = function(specs){
                 +fillTemplate(fieldlabel,self.current.object)
                 +(required && '*' ||'')
                 +self.renderFieldTooltip(prop)
+                +self.renderFieldReloadIcon(prop)
             +'</label>';
 
             //render comment
@@ -14623,7 +14626,15 @@ this.renderHTMLContent = function(specs){
 
 		return tooltip_html;
 	};
+    this.renderFieldReloadIcon = function(prop){
+        var reloadable = self.propAsFuncOrValue(prop.reloadable);
+        if(!reloadable){return '';}
+        //var comment = ($.type(prop.comment) == "function")?prop.comment():prop.comment;
+        var comment_html = ` <joe-icon class="joe-reload-icon fright" title="Reload Field" onclick="_joe.Fields.rerender('${prop.name}')">⟳</joe-icon>`;
 
+        return comment_html;
+    };
+    
 	this.selectAndRenderFieldType = function(prop){
 		//var joeFieldBenchmarker = new Benchmarker();
 
@@ -15856,7 +15867,8 @@ this.renderHTMLContent = function(specs){
             stripecolor:false,
             bgcolor:false,
             checkbox:false,
-            value:''
+            value:'',
+            link:false
         },specs);
         var schemaprop = specs.schemaprop && self.propAsFuncOrValue(specs.schemaprop,item);
         var schema = ((schemaprop && item[schemaprop])||schema||item.itemtype||item.type);
@@ -15867,7 +15879,7 @@ this.renderHTMLContent = function(specs){
         
         var idprop = specs.idprop || (schemaobj && schemaobj.idprop) ||'_id';
         var hasMenu = specs.itemMenu && specs.itemMenu.length;
-        var action = specs.action || ' onclick="goJoe(_joe.search(\'${'+idprop+'}\')[0],{schema:\''+schema+'\'})" ';
+        var action = self.propAsFuncOrValue(specs.action,item) || ' onclick="goJoe(_joe.search(\'${'+idprop+'}\')[0],{schema:\''+schema+'\'})" ';
         var nonclickable = self.propAsFuncOrValue(specs.nonclickable,item);
         var clickablelistitem = (!specs.gotoButton && !nonclickable/* && !hasMenu*/);
         //var clickablelistitem = !!clickable && (!specs.gotoButton && !hasMenu);
@@ -15882,6 +15894,7 @@ this.renderHTMLContent = function(specs){
             'data-value="' +encodeURI(JSON.stringify(specs.value))+ '" data-isObject=true'
             :'data-value="' + specs.value + '"';
         
+        var link = specs.link && self.propAsFuncOrValue(specs.link,item);
         var html = fillTemplate(`<joe-list-item schema="${schema}" 
             itemId="${item[idprop]}"
             idprop="${idprop}"
@@ -15904,13 +15917,13 @@ this.renderHTMLContent = function(specs){
                         
                         + self.Render.itemCheckbox(item,schemaobj)
 
-                        +((specs.link && '<a class="non-link" onclick="__cancelClick();" href="'+specs.link+'">')||'')  
+                        +((link && '<a class="non-link" onclick="__cancelClick();" href="'+link+'">')||'')  
 
                         + '<div class="joe-field-item-content '+(nonclickable && 'nonclickable' || '')+'" ' + click + ' >'
                             + self.propAsFuncOrValue(contentTemplate+__clearDiv__, item)
                         + __clearDiv__+'</div>'
 
-                        +((specs.link && '</a>')||'')   
+                        +((link && '</a>')||'')   
                         +self.Render.stripeColor(item,specs.stripecolor)
                         + self._renderExpanderButton(expanderContent, item)
                         + (specs.deleteButton && deleteButton || '')
@@ -18685,6 +18698,7 @@ Field Rendering Helpers
     var sortable_index;
     this.Autosave = {
         possibleChanges:true,
+        unsavedChanges:false,
         activate:function(){
             if(!self.specs.autosave){
                 return;
@@ -18714,7 +18728,8 @@ Field Rendering Helpers
                     var showUnsaved = (hasChanged && self.getMode() == "details");
                     document.title =( showUnsaved && '*' ||'')
                         +document.title.replace('*','');
-                        self.overlay.toggleClass('unsaved-changes',showUnsaved)
+                        self.overlay.toggleClass('unsaved-changes',showUnsaved);
+                        self.Autosave.unsavedChanges = hasChanged;
                 },intercnt)
         },
         deactivate:function(){
@@ -18946,7 +18961,7 @@ Field Rendering Helpers
             tocheck.map(field=>{
 
             })
-            return (tocheck.length > 0);
+            return (tocheck.length > 0)?tocheck:false;
         }
         if(self.overlay.hasClass('active') && !listMode && !self.current.changesConfirmed && tocheck.length){
             
@@ -18954,7 +18969,7 @@ Field Rendering Helpers
             self.current.changesConfirmed = confirmed;
             return confirmed;
         }
-        return true;
+        return tocheck;
     }
 /*-------------------------------------------------------------------->
  J | MESSAGING
@@ -19585,7 +19600,10 @@ Field Rendering Helpers
     
         for (const [field, val] of Object.entries(object)) {
             if (val === undefined || val === null) continue;
-            if (field == '_id') continue;
+            if (field == '_id'){
+                flattened[field] = val;
+                continue;
+            }
     
             if (typeof val === 'string' && $c.isCuid(val) && recursive && depth > 0) {
                 if (!visited.has(val)) {
@@ -21162,7 +21180,7 @@ logit(intent)
                     var users = _joe.Data[(user_dataset || 'user')].where({_id:{$in:ids}});
                     var html = '';
                     users.map(function(user){
-                        html += self.SERVER.User.Render.cube(user);
+                        html += self.SERVER.User.Render.cube(user,cssclass);
                     })
                     return html;
                 },
@@ -21683,6 +21701,7 @@ logit(intent)
             var e = e || window.event;
             if (e.stopPropagation) e.stopPropagation();
             if (e.preventDefault) e.preventDefault();
+            return false;
         },
         getPossibleValues:function(propertyName,schema,specs){
             //TODO:

package/js/joe.js

@@ -1,9 +1,3 @@
-/* -------------------------------------------------------- 
- * 
- *  JOE - v1.5.0 
- *  Created by: Corey Hadden 
- * 
- * -------------------------------------------------------- */
 /* -------------------------------------------------------- 
  * 
  *  JOE - v1.5.0 
@@ -1076,6 +1070,8 @@ Column Count
     this.Header = {}
     this.toggleHelpMenu = function(show,target){
 
+    }
+    this.listUnsavedChanges = function(){
     }
 	this.Header.Render = this.renderEditorHeader = function(specs){
         var BM = new Benchmarker();
@@ -3238,6 +3234,7 @@ this.renderHTMLContent = function(specs){
                 +fillTemplate(fieldlabel,self.current.object)
                 +(required && '*' ||'')
                 +self.renderFieldTooltip(prop)
+                +self.renderFieldReloadIcon(prop)
             +'</label>';
 
             //render comment
@@ -3330,7 +3327,15 @@ this.renderHTMLContent = function(specs){
 
 		return tooltip_html;
 	};
+    this.renderFieldReloadIcon = function(prop){
+        var reloadable = self.propAsFuncOrValue(prop.reloadable);
+        if(!reloadable){return '';}
+        //var comment = ($.type(prop.comment) == "function")?prop.comment():prop.comment;
+        var comment_html = ` <joe-icon class="joe-reload-icon fright" title="Reload Field" onclick="_joe.Fields.rerender('${prop.name}')">⟳</joe-icon>`;
 
+        return comment_html;
+    };
+    
 	this.selectAndRenderFieldType = function(prop){
 		//var joeFieldBenchmarker = new Benchmarker();
 
@@ -4563,7 +4568,8 @@ this.renderHTMLContent = function(specs){
             stripecolor:false,
             bgcolor:false,
             checkbox:false,
-            value:''
+            value:'',
+            link:false
         },specs);
         var schemaprop = specs.schemaprop && self.propAsFuncOrValue(specs.schemaprop,item);
         var schema = ((schemaprop && item[schemaprop])||schema||item.itemtype||item.type);
@@ -4574,7 +4580,7 @@ this.renderHTMLContent = function(specs){
         
         var idprop = specs.idprop || (schemaobj && schemaobj.idprop) ||'_id';
         var hasMenu = specs.itemMenu && specs.itemMenu.length;
-        var action = specs.action || ' onclick="goJoe(_joe.search(\'${'+idprop+'}\')[0],{schema:\''+schema+'\'})" ';
+        var action = self.propAsFuncOrValue(specs.action,item) || ' onclick="goJoe(_joe.search(\'${'+idprop+'}\')[0],{schema:\''+schema+'\'})" ';
         var nonclickable = self.propAsFuncOrValue(specs.nonclickable,item);
         var clickablelistitem = (!specs.gotoButton && !nonclickable/* && !hasMenu*/);
         //var clickablelistitem = !!clickable && (!specs.gotoButton && !hasMenu);
@@ -4589,6 +4595,7 @@ this.renderHTMLContent = function(specs){
             'data-value="' +encodeURI(JSON.stringify(specs.value))+ '" data-isObject=true'
             :'data-value="' + specs.value + '"';
         
+        var link = specs.link && self.propAsFuncOrValue(specs.link,item);
         var html = fillTemplate(`<joe-list-item schema="${schema}" 
             itemId="${item[idprop]}"
             idprop="${idprop}"
@@ -4611,13 +4618,13 @@ this.renderHTMLContent = function(specs){
                         
                         + self.Render.itemCheckbox(item,schemaobj)
 
-                        +((specs.link && '<a class="non-link" onclick="__cancelClick();" href="'+specs.link+'">')||'')  
+                        +((link && '<a class="non-link" onclick="__cancelClick();" href="'+link+'">')||'')  
 
                         + '<div class="joe-field-item-content '+(nonclickable && 'nonclickable' || '')+'" ' + click + ' >'
                             + self.propAsFuncOrValue(contentTemplate+__clearDiv__, item)
                         + __clearDiv__+'</div>'
 
-                        +((specs.link && '</a>')||'')   
+                        +((link && '</a>')||'')   
                         +self.Render.stripeColor(item,specs.stripecolor)
                         + self._renderExpanderButton(expanderContent, item)
                         + (specs.deleteButton && deleteButton || '')
@@ -7392,6 +7399,7 @@ Field Rendering Helpers
     var sortable_index;
     this.Autosave = {
         possibleChanges:true,
+        unsavedChanges:false,
         activate:function(){
             if(!self.specs.autosave){
                 return;
@@ -7421,7 +7429,8 @@ Field Rendering Helpers
                     var showUnsaved = (hasChanged && self.getMode() == "details");
                     document.title =( showUnsaved && '*' ||'')
                         +document.title.replace('*','');
-                        self.overlay.toggleClass('unsaved-changes',showUnsaved)
+                        self.overlay.toggleClass('unsaved-changes',showUnsaved);
+                        self.Autosave.unsavedChanges = hasChanged;
                 },intercnt)
         },
         deactivate:function(){
@@ -7653,7 +7662,7 @@ Field Rendering Helpers
             tocheck.map(field=>{
 
             })
-            return (tocheck.length > 0);
+            return (tocheck.length > 0)?tocheck:false;
         }
         if(self.overlay.hasClass('active') && !listMode && !self.current.changesConfirmed && tocheck.length){
             
@@ -7661,7 +7670,7 @@ Field Rendering Helpers
             self.current.changesConfirmed = confirmed;
             return confirmed;
         }
-        return true;
+        return tocheck;
     }
 /*-------------------------------------------------------------------->
  J | MESSAGING
@@ -8292,7 +8301,10 @@ Field Rendering Helpers
     
         for (const [field, val] of Object.entries(object)) {
             if (val === undefined || val === null) continue;
-            if (field == '_id') continue;
+            if (field == '_id'){
+                flattened[field] = val;
+                continue;
+            }
     
             if (typeof val === 'string' && $c.isCuid(val) && recursive && depth > 0) {
                 if (!visited.has(val)) {
@@ -9869,7 +9881,7 @@ logit(intent)
                     var users = _joe.Data[(user_dataset || 'user')].where({_id:{$in:ids}});
                     var html = '';
                     users.map(function(user){
-                        html += self.SERVER.User.Render.cube(user);
+                        html += self.SERVER.User.Render.cube(user,cssclass);
                     })
                     return html;
                 },
@@ -10390,6 +10402,7 @@ logit(intent)
             var e = e || window.event;
             if (e.stopPropagation) e.stopPropagation();
             if (e.preventDefault) e.preventDefault();
+            return false;
         },
         getPossibleValues:function(propertyName,schema,specs){
             //TODO:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "json-object-editor",
-  "version": "0.10.425",
+  "version": "0.10.431",
   "description": "JOE the Json Object Editor | Platform Edition",
   "main": "app.js",
   "scripts": {

package/pages/template.html

@@ -311,8 +311,9 @@
 	JOE.init();
 	//capp.init();
 	var capp_apps = '${USERAPPS}'.split(',') || [];
+	var caobj = ${USERAPPSOBJ};
 	var all_apps = '${APPS}'.split(',') || [];
-	capp.Menu.addFromApps(capp_apps,'<joe-subtext>${this.webconfig.name}</joe-subtext>${APPNAME}');
+	capp.Menu.addFromApps(caobj,'<joe-subtext>${this.webconfig.name}</joe-subtext>${APPNAME}');
 	//capp.Button.add('Docs',null,'window.open(\'/JsonObjectEditor/docs.html\')','capp-header');
 	
 

package/readme.md

@@ -198,11 +198,13 @@ a list of schema objects that can configure the editor fields, these can be give
 			alert(obj.name);
 		},*/
 		onblur:logit,
+		
 		hideNumbers:boolean *toggle list numbers*
 		multipleCallback:function to be called after a multi-edit. passed list of edited items.
 		onUpdate: callback for after update. passed single edited items.
 		onMultipleUpdate:callback for after multi update.passed list of edited items.
                 filters: array of objects
+		checkChanges:(bool) whether or not to check for changes via interval and on leave
 	}
 ##Table View
 	- add tableView object to a schema;

package/server/app-config.js

@@ -28,10 +28,10 @@ var apps = function(){
     var default_schemas = JOE.webconfig.default_schemas;
     return{
         joe:{
-            title:'Platform',
+            title:'JOE Platform',
             info:'This is the master Data Model Management System (DMMS) admin page. It has access to all of your schemas and datasets.',
             description:'JOE is the Json Object Editor. The Platform app has access to all your schemas and datasets.',
-            plugins:['auth.js','formBuilder.js','reportbuilder.js','callbackTester.js','memberRegistry.js','awsConnect.js','notifier.js','calendar.js','inventory.js','money.js'],
+            plugins:['auth.js','formBuilder.js','reportbuilder.js','callbackTester.js','memberRegistry.js','awsConnect.js','notifier.js','calendar.js','inventory.js','money.js','plugin-utils.js','chatgpt.js','chatgpt-assistants.js','chatgpt-tools.js'],
             collections:((default_schemas.concat(['schema','group',
                 'site','page','post','layout','block','include','event',
                 'project','board','task',

package/server/fields/core.js

@@ -68,15 +68,15 @@ var fields = {
     'coords':{type:'geo'},
     'state':{type:'select',values:usStates,idprop:'code',template:'${code}',width:'25%',minwidth:'100px',blank:true},
     'name':{type:'text',onblur:'_joe.TITLE.set()'},
-    instructions_format:{type:'select',values:['wysiwyg','code'], rerender:'instructions',display:'Instructions Format'},
+    instructions_format:{type:'select',values:['wysiwyg','code','text',], rerender:'instructions',display:'Instructions Format'},
     instructions:{
-        height:'auto',
+        height:'600px',
         display:'Instructions',
         type:function(item){
-            if(!item.instructions_format){
-                return 'wysiwyg';
+            if(!item.instructions_format || item.instructions_format == 'text'){
+                return 'rendering';
             }
-            if(["code"].indexOf(item.instructions_format) != -1){
+            else if(["code"].indexOf(item.instructions_format) != -1){
                 return 'code';
             }
             return item.instructions_format;
@@ -86,8 +86,16 @@ var fields = {
         type: "select",
         display: "Ai Model",
         values: [
-          { value: "gpt-4o", name: "GPT-4o (Current Default)" }
-        ],
+            { value: "gpt-4o", name: "GPT-4o (Fast, 128k)" },
+            { value: "gpt-4.1", name: "GPT-4.1 (Strong, 1M)" },
+            { value: "gpt-4.1-mini", name: "4.1-mini (Cheap, 1M)" },
+            { value: "gpt-4.1-nano", name: "4.1-nano (Fastest, light tasks)" }
+          ],
+          tooltip:`Ai Model Guide -
+            GPT-4o is the default for fast, responsive tasks and supports up to 128k tokens. It’s ideal for short completions, summaries, and dynamic UI tools.
+            GPT-4.1 and 4.1-mini support a massive 1 million token context, making them perfect for large inputs like full business profiles, long strategy texts, and multi-object analysis.
+            4.1-mini is significantly cheaper than full 4.1, with great balance for most structured AI workflows.
+            4.1-nano is best for lightweight classification or routing logic where speed and cost matter more than depth.`,
         default: "gpt-4o",
       },
     template:{

package/server/init.js

@@ -62,7 +62,7 @@ var app = function(config){
 
             });
         }
-        ['Apps','Schemas','Mongo','MySQL','Comments'].map(function(m){
+        ['Apps','Schemas','Mongo','MySQL','Comments','Utils'].map(function(m){
             initializeModule(m);
         });
         //initializeModule('Apps');

package/server/modules/Apps.js

@@ -495,16 +495,54 @@ function Apps(){
         return app;
     }
     this.loadPlugin = function(p){
-        logit(moduleName+'loading plugin '+p);
+        //logit(moduleName+'loading plugin '+p);
+        let _joeSrc='';
+        console.log(JOE.Utils.color('[plugin]', 'plugin'), 'loaded: '+p);
         var plugin;
         if(p.indexOf('.js') == -1){p+= '.js';}
-        try{
-            var pluginpath = internalPluginsDir + p;
-            fs.accessSync(pluginpath, fs.F_OK);
+
+        const candidateDirs = [
+            pluginsDir,
+            internalPluginsDir
+        ];
+        let pluginpath = null;
+        let override = false;
+        //for (let dir of candidateDirs) {
+
+
+            try {
+                let attempt = internalPluginsDir + p;
+                fs.accessSync(attempt, fs.F_OK);
+                pluginpath = attempt;
                 
-        }catch(e){
-            var pluginpath = pluginsDir + p;
-        }
+                
+            } catch (e) {
+                // continue
+            }
+            try {
+                let attempt = pluginsDir + p;
+                fs.accessSync(attempt, fs.F_OK);
+                if(pluginpath){
+                    override = true;
+                }
+                pluginpath = attempt;
+                
+                
+            } catch (e) {
+               
+                // continue
+            }
+       // }
+        // try{
+        //     //first try the pluginsDir, then the internalPluginsDir
+
+            
+        //     var pluginpath = internalPluginsDir + p;
+        //     fs.accessSync(pluginpath, fs.F_OK);
+                
+        // }catch(e){
+        //     var pluginpath = pluginsDir + p;
+        // }
         try{
             try{
                 delete require.cache[require.resolve(pluginpath)];
@@ -512,12 +550,15 @@ function Apps(){
                 console.log(moduleName+'[error] '+p+' not deleted');
             }
             plugin = require(pluginpath);
-            
+            _joeSrc = pluginpath;
         }catch(e){
             plugin = {error:'plugin '+p+' not found'};
             console.log(e,plugin);
         }
+        plugin._pathname = _joeSrc;
+        plugin._override = override;
         self.plugins[p.replace('.js','')] = plugin;
+        
         return plugin;
     }
 

package/server/modules/Server.js

@@ -16,6 +16,9 @@ var os = require('os');
 const $J = require('./UniversalShorthand');
 var rd = require('renderizer')({templatesDir:path.resolve(JOE.joedir,JOE.webconfig.templatesDir)});
 
+function coloredLog(message) {
+    console.log(JOE.Utils.color('[server]', 'module'), message);
+  }
 var authBool = JOE.isAuthorized = function(req,res){
     var users = (JOE.Data && JOE.Data.user) || [];
 
@@ -140,7 +143,23 @@ server.get(['/API/user/:method'],auth,function(req,res,next){
                 res.jsonp({logout:true});
                 return next();
             break;
-
+            case 'apps':
+                logit('getting apps for '+req.User.name);
+                userApps = [];
+                if (req.User.apps && req.User.apps.length) {
+                    req.User.apps.map(function (app) {
+                        if (JOE.Apps.cache[app]) {
+                            userApps.push({
+                                name: app,
+                                title: JOE.Apps.cache[app].title,
+                                description: JOE.Apps.cache[app].description
+                            });
+                        }
+                    });
+                } 
+                res.jsonp({userApps});
+                return;//return next();
+            break;
         }
     }
 
@@ -711,12 +730,17 @@ server.get(['/JOE/','/JOE/:appname'],auth,function(req,res,next){
             }
 
             //var collections = [];
-
+            let uappsObj = [];
+            USER.apps.map(a=>{
+                let aa = Apps[a]||{};
+                uappsObj.push({name:a,title:aa.title,description:aa.description});
+            });
             var payload = {
                 APPNAME:currentApp.title || appname,
                 APPINFO:JSON.stringify(stringFunctions(currentApp)),
                 APPS:apps.join(','),
                 USERAPPS:(USER.apps||apps||[]).join(','),
+                USERAPPSOBJ:JSON.stringify(uappsObj),
                 webconfig:JOE.webconfig,
                 settings:settings,
                 JOEPATH:JOE.webconfig.joepath,
@@ -761,21 +785,21 @@ server.get(['/RENDER/:contentType/:templateName'],function(req,res){
 
 JOE.webDir = webDir = JOE.appDir+'/'+JOE.webconfig.webDir+'/';
 JOE.Utils.setupFileFolder(webDir,'web');
-
+    coloredLog('listening on '+JOE.webconfig.port);
 
 
 server.use('/',express.static(JOE.webDir));
 
 http.listen(JOE.webconfig.port,function(){
     //console.log('joe listening on '+JOE.webconfig.port);
-    console.log(JOE.Utils.color('[server]','module')+' on '+JOE.webconfig.port);
+    coloredLog('using webDir: '+JOE.webDir);
 });
 JOE.httpServer = http;
 var httpsPort = JOE.webconfig.httpsPort;
 if(httpsPort){
     var httpsServer = https.Server({key: JOE.Pem.serviceKey, cert: JOE.Pem.certificate}, server);
     httpsServer.listen(httpsPort);
-    console.log(JOE.Utils.color('[server]','module')+' https on '+httpsPort);
+    coloredLog(' https on '+httpsPort);
     JOE.httpsServer = httpsServer;
     // pem.createCertificate({selfSigned:true}, function(err, keys){
     //     if(err){

package/server/modules/Storage.js

@@ -102,6 +102,9 @@ function Storage(specs){
                 
                 var save_callback = function(err,data){
                     callback(err,data);
+                    if (!specs || specs.push !== false) {
+                        JOE.io.emit('item_updated', { results: [data] });
+                    }
                     if(!err){
                         var ts = new Date().toISOString();
                         var cached = JOE.Cache.findByID(data.itemtype,data._id);

package/server/modules/UniversalShorthand.js

@@ -21,8 +21,7 @@ function UniversalShorthand(){
             if(items){
                 callback && callback(items);
                 return items;
-            }
-             
+            }  
         }
         this.schema = function(schemaname,callback){
             self._usages.schema++;

package/server/modules/Utils.js

@@ -174,6 +174,68 @@ var utils = function(){
             }
             return finalItems;
         }
+        this.flattenObject = function(id, options = {}) {
+            const { recursive = true, depth = 1, visited = new Set() } = options;
+        
+            let object = null;
+            
+            if (id) {
+                object = $J.get(id);
+            } 
+            
+            if (!object) return null;
+        
+            const flattened = {};
+            const currentId = object._id || object.id;
+            if (currentId) visited.add(currentId);
+        
+            for (const [field, val] of Object.entries(object)) {
+                if (val === undefined || val === null) continue;
+                if (field == '_id'){
+                    flattened[field] = val;
+                    continue;
+                }
+                if(field == 'password'){
+                    flattened[field] = '********';
+                    continue;
+                    
+                }
+                if(field =="status"){
+                    flattened[field]  = $J.get(val);
+                    continue
+                }
+                if (typeof val === 'string' && $c.isCuid(val) && recursive && depth > 0) {
+                    if (!visited.has(val)) {
+                        const expanded = JOE.Utils.flattenObject(val, {
+                            recursive,
+                            depth: depth - 1,
+                            visited: new Set(visited)
+                        });
+                        flattened[field] = expanded || val;
+                    } else {
+                        flattened[field] = val;
+                    }
+                }
+                else if (Array.isArray(val) && val.every(v => typeof v === 'string' && $c.isCuid(v)) && recursive && depth > 0) {
+                    flattened[field] = val.map(refId => {
+                        if (!visited.has(refId)) {
+                            const expanded = JOE.Utils.flattenObject(refId, {
+                                recursive,
+                                depth: depth - 1,
+                                visited: new Set(visited)
+                            });
+                            return expanded || refId;
+                        }
+                        return refId;
+                    });
+                }
+                else {
+                    flattened[field] = val;
+                }
+            }
+        
+            return flattened;
+        };
 
     return this;
 };