spice-js 2.7.29 → 2.7.30

package/build/index.js

@@ -53,7 +53,9 @@ function _asyncToGenerator(n) { return function () { var t = this, e = arguments
 var path = require("path");
 //import IO from "koa-socket-2";
 var cors = require("kcors");
-global.spice = {};
+// Preserve an existing host/test configuration when the package is imported.
+// Production boot still starts from an empty object because spice is undefined.
+global.spice = global.spice || {};
 require("dotenv").config({
   path: path.resolve("./")
 });

package/build/models/SpiceModel.js

@@ -27,6 +27,8 @@ var SDate = require("sonover-date"),
   _serializers = Symbol(),
   _level = Symbol(),
   _mapping_dept = Symbol(),
+  _mapping_dept_scalar = Symbol(),
+  _mapping_dept_array = Symbol(),
   _mapping_dept_exempt = Symbol(),
   _current_path = Symbol();
 
@@ -48,21 +50,27 @@ class SpiceModel {
       args = {};
     }
     try {
-      var _args2, _args2$args, _args3, _args3$args, _args$args, _args4, _args4$args, _args5, _args5$args, _args6, _args6$args, _args7, _args7$args, _args8, _args8$args;
+      var _args2, _modelArgs$ctx, _modelArgs$ctx$state, _ref, _ref2, _modelArgs$mapping_de, _ref3, _ref4, _modelArgs$mapping_de2, _args$args, _args3, _args3$args, _args4, _args4$args, _args5, _args5$args, _args6, _args6$args, _args7, _args7$args;
+      var modelArgs = ((_args2 = args) == null ? void 0 : _args2.args) || {};
+      var requestProfile = (modelArgs == null ? void 0 : (_modelArgs$ctx = modelArgs.ctx) == null ? void 0 : (_modelArgs$ctx$state = _modelArgs$ctx.state) == null ? void 0 : _modelArgs$ctx$state.read_profile) || {};
+      var defaultMappingDept = process.env.MAPPING_DEPT || 3;
+      var legacyMappingDept = modelArgs.mapping_dept !== undefined && modelArgs.mapping_dept !== null ? modelArgs.mapping_dept : undefined;
       var dbtype = spice.config.database.connections[args.connection].type || "couchbase";
       var Database = require("spice-" + dbtype);
-      this[_mapping_dept] = ((_args2 = args) == null ? void 0 : (_args2$args = _args2.args) == null ? void 0 : _args2$args.mapping_dept) || process.env.MAPPING_DEPT || 3;
-      this[_mapping_dept_exempt] = ((_args3 = args) == null ? void 0 : (_args3$args = _args3.args) == null ? void 0 : _args3$args.mapping_dept_exempt) || [];
+      this[_mapping_dept] = legacyMappingDept != null ? legacyMappingDept : defaultMappingDept;
+      this[_mapping_dept_scalar] = (_ref = (_ref2 = (_modelArgs$mapping_de = modelArgs.mapping_dept_scalar) != null ? _modelArgs$mapping_de : legacyMappingDept) != null ? _ref2 : requestProfile.mapping_dept_scalar) != null ? _ref : defaultMappingDept;
+      this[_mapping_dept_array] = (_ref3 = (_ref4 = (_modelArgs$mapping_de2 = modelArgs.mapping_dept_array) != null ? _modelArgs$mapping_de2 : legacyMappingDept) != null ? _ref4 : requestProfile.mapping_dept_array) != null ? _ref3 : defaultMappingDept;
+      this[_mapping_dept_exempt] = modelArgs.mapping_dept_exempt || [];
       this.type = "";
       this.collection = args.connection;
       this[_args] = args.args;
       this[_external_modifier_loaded] = false;
       this[_disable_lifecycle_events] = ((_args$args = args.args) == null ? void 0 : _args$args.disable_lifecycle_events) || false;
-      this[_ctx] = (_args4 = args) == null ? void 0 : (_args4$args = _args4.args) == null ? void 0 : _args4$args.ctx;
-      this[_skip_cache] = ((_args5 = args) == null ? void 0 : (_args5$args = _args5.args) == null ? void 0 : _args5$args.skip_cache) || false;
-      this[_level] = ((_args6 = args) == null ? void 0 : (_args6$args = _args6.args) == null ? void 0 : _args6$args._level) || 0;
-      this[_current_path] = ((_args7 = args) == null ? void 0 : (_args7$args = _args7.args) == null ? void 0 : _args7$args._current_path) || "";
-      this[_columns] = ((_args8 = args) == null ? void 0 : (_args8$args = _args8.args) == null ? void 0 : _args8$args._columns) || "";
+      this[_ctx] = (_args3 = args) == null ? void 0 : (_args3$args = _args3.args) == null ? void 0 : _args3$args.ctx;
+      this[_skip_cache] = ((_args4 = args) == null ? void 0 : (_args4$args = _args4.args) == null ? void 0 : _args4$args.skip_cache) || false;
+      this[_level] = ((_args5 = args) == null ? void 0 : (_args5$args = _args5.args) == null ? void 0 : _args5$args._level) || 0;
+      this[_current_path] = ((_args6 = args) == null ? void 0 : (_args6$args = _args6.args) == null ? void 0 : _args6$args._current_path) || "";
+      this[_columns] = ((_args7 = args) == null ? void 0 : (_args7$args = _args7.args) == null ? void 0 : _args7$args._columns) || "";
       this[_hooks] = {
         create: {
           before: [],
@@ -209,6 +217,26 @@ class SpiceModel {
     }
     // }
   }
+  applyMappingDepthArgs(args) {
+    if (args === void 0) {
+      args = {};
+    }
+    var hasLegacyDepth = args.mapping_dept !== undefined && args.mapping_dept !== null;
+    if (hasLegacyDepth) {
+      this[_mapping_dept] = args.mapping_dept;
+      this[_mapping_dept_scalar] = args.mapping_dept;
+      this[_mapping_dept_array] = args.mapping_dept;
+    }
+    if (args.mapping_dept_scalar !== undefined && args.mapping_dept_scalar !== null) {
+      this[_mapping_dept_scalar] = args.mapping_dept_scalar;
+    }
+    if (args.mapping_dept_array !== undefined && args.mapping_dept_array !== null) {
+      this[_mapping_dept_array] = args.mapping_dept_array;
+    }
+    if (args.mapping_dept_exempt) {
+      this[_mapping_dept_exempt] = args.mapping_dept_exempt;
+    }
+  }
   get database() {
     return this[_database];
   }
@@ -250,13 +278,13 @@ class SpiceModel {
       return [];
     })();
   }
-  createValidationString(_ref) {
+  createValidationString(_ref5) {
     var {
       property_name,
       props,
       operation,
       complete
-    } = _ref;
+    } = _ref5;
     var operationExempt = {
       PUT: ["required", "unique"]
     };
@@ -487,14 +515,13 @@ class SpiceModel {
       // Profiling: use track() for proper async context forking
       var p = (_this4$_ctx = _this4[_ctx]) == null ? void 0 : _this4$_ctx.profiler;
       var doGet = /*#__PURE__*/function () {
-        var _ref2 = _asyncToGenerator(function* () {
-          if (args.mapping_dept) _this4[_mapping_dept] = args.mapping_dept;
-          if (args.mapping_dept_exempt) _this4[_mapping_dept_exempt] = args.mapping_dept_exempt;
+        var _ref6 = _asyncToGenerator(function* () {
           if (!args) {
             args = {};
           }
+          _this4.applyMappingDepthArgs(args);
           if (_.isString(args.id)) {
-            var _args9, _results, _results2, _results3, _results4, _results5, _results6;
+            var _args8, _results, _results2, _results3, _results4, _results5, _results6;
             if (args.skip_hooks !== true) {
               yield _this4.run_hook(args, "get", "before");
             }
@@ -514,7 +541,7 @@ class SpiceModel {
             var originalColumns = args.columns;
 
             // Extract nestings from columns if specified
-            var nestings = _this4.extractNestings(((_args9 = args) == null ? void 0 : _args9.columns) || "", _this4.type);
+            var nestings = _this4.extractNestings(((_args8 = args) == null ? void 0 : _args8.columns) || "", _this4.type);
 
             // Build join metadata and prepare columns
             _this4.buildJoinMetadata(nestings, args);
@@ -597,14 +624,14 @@ class SpiceModel {
           }
         });
         return function doGet() {
-          return _ref2.apply(this, arguments);
+          return _ref6.apply(this, arguments);
         };
       }();
       try {
         if (p) {
-          var _args0;
+          var _args9;
           return yield p.track(_this4.type + ".get", doGet, {
-            id: (_args0 = args) == null ? void 0 : _args0.id
+            id: (_args9 = args) == null ? void 0 : _args9.id
           });
         }
         return yield doGet();
@@ -632,14 +659,15 @@ class SpiceModel {
       // ⚡ Profiling: use track() for proper async context forking
       var p = (_this6$_ctx = _this6[_ctx]) == null ? void 0 : _this6$_ctx.profiler;
       var doGetMulti = /*#__PURE__*/function () {
-        var _ref5 = _asyncToGenerator(function* () {
+        var _ref9 = _asyncToGenerator(function* () {
           if (!args) {
             args = {};
           }
+          _this6.applyMappingDepthArgs(args);
           if (args.skip_hooks != true) {
             yield _this6.run_hook(_this6, "list", "before");
           }
-          _.remove(args.ids, o => o == undefined);
+          args.ids = _.uniq(_.filter(args.ids || [], id => _.isString(id) && id.length > 0));
           var key = "multi-get::" + _this6.type + "::" + _.join(args.ids, "|") + ":" + args.columns;
           var results = [];
           if (args.ids.length > 0) {
@@ -673,14 +701,14 @@ class SpiceModel {
           return results;
         });
         return function doGetMulti() {
-          return _ref5.apply(this, arguments);
+          return _ref9.apply(this, arguments);
         };
       }();
       try {
         if (p) {
-          var _args1, _args1$ids;
+          var _args0, _args0$ids;
           return yield p.track(_this6.type + ".getMulti", doGetMulti, {
-            ids_count: ((_args1 = args) == null ? void 0 : (_args1$ids = _args1.ids) == null ? void 0 : _args1$ids.length) || 0
+            ids_count: ((_args0 = args) == null ? void 0 : (_args0$ids = _args0.ids) == null ? void 0 : _args0$ids.length) || 0
           });
         }
         return yield doGetMulti();
@@ -729,7 +757,7 @@ class SpiceModel {
       // Profiling: use track() for proper async context forking
       var p = (_this8$_ctx = _this8[_ctx]) == null ? void 0 : _this8$_ctx.profiler;
       var doUpdate = /*#__PURE__*/function () {
-        var _ref6 = _asyncToGenerator(function* () {
+        var _ref0 = _asyncToGenerator(function* () {
           _this8.updated_at = new SDate().now();
           var results = yield _this8.database.get(args.id);
           var item_exist = yield _this8.exist(results);
@@ -773,7 +801,7 @@ class SpiceModel {
           });
         });
         return function doUpdate() {
-          return _ref6.apply(this, arguments);
+          return _ref0.apply(this, arguments);
         };
       }();
       try {
@@ -799,7 +827,7 @@ class SpiceModel {
       // Profiling: use track() for proper async context forking
       var p = (_this9$_ctx = _this9[_ctx]) == null ? void 0 : _this9$_ctx.profiler;
       var doCreate = /*#__PURE__*/function () {
-        var _ref8 = _asyncToGenerator(function* () {
+        var _ref10 = _asyncToGenerator(function* () {
           var form;
           _this9.created_at = new SDate().now();
           args = _.defaults(args, {
@@ -845,7 +873,7 @@ class SpiceModel {
           });
         });
         return function doCreate() {
-          return _ref8.apply(this, arguments);
+          return _ref10.apply(this, arguments);
         };
       }();
       try {
@@ -883,7 +911,7 @@ class SpiceModel {
       // Profiling: use track() for proper async context forking
       var p = (_this1$_ctx = _this1[_ctx]) == null ? void 0 : _this1$_ctx.profiler;
       var doDelete = /*#__PURE__*/function () {
-        var _ref0 = _asyncToGenerator(function* () {
+        var _ref12 = _asyncToGenerator(function* () {
           var item_exist = yield _this1.exist(args.id);
           if (!item_exist) {
             throw new Error(_this1.type + " does not exist.");
@@ -894,7 +922,7 @@ class SpiceModel {
           }
           var delete_response = {};
           var dbOperation = /*#__PURE__*/function () {
-            var _ref1 = _asyncToGenerator(function* () {
+            var _ref13 = _asyncToGenerator(function* () {
               if (args.hard) {
                 delete_response = yield _this1.database.delete(args.id);
                 _this1.setMonitor();
@@ -905,7 +933,7 @@ class SpiceModel {
               }
             });
             return function dbOperation() {
-              return _ref1.apply(this, arguments);
+              return _ref13.apply(this, arguments);
             };
           }();
           if (p) {
@@ -921,7 +949,7 @@ class SpiceModel {
           return {};
         });
         return function doDelete() {
-          return _ref0.apply(this, arguments);
+          return _ref12.apply(this, arguments);
         };
       }();
       try {
@@ -1111,12 +1139,12 @@ class SpiceModel {
   }
   createJoinSection(mappedNestings) {
     if (!mappedNestings || mappedNestings.length === 0) return "";
-    return mappedNestings.map(_ref10 => {
+    return mappedNestings.map(_ref14 => {
       var {
         alias,
         reference,
         is_array
-      } = _ref10;
+      } = _ref14;
       var keyspace = (0, _fix.fixCollection)(reference);
       if (is_array === true) {
         return "LEFT NEST `" + keyspace + "` AS `" + alias + "` ON KEYS `" + this.type + "`.`" + alias + "`";
@@ -1261,10 +1289,9 @@ class SpiceModel {
       // Profiling: use track() for proper async context forking
       var p = (_this10$_ctx = _this10[_ctx]) == null ? void 0 : _this10$_ctx.profiler;
       var doList = /*#__PURE__*/function () {
-        var _ref11 = _asyncToGenerator(function* () {
-          var _args10, _args11;
-          if (args.mapping_dept) _this10[_mapping_dept] = args.mapping_dept;
-          if (args.mapping_dept_exempt) _this10[_mapping_dept_exempt] = args.mapping_dept_exempt;
+        var _ref15 = _asyncToGenerator(function* () {
+          var _args1, _args10;
+          _this10.applyMappingDepthArgs(args);
 
           // Filter out id, meta().id, and any column ending with .id (e.g., dependents.id)
           if (args.columns) {
@@ -1278,9 +1305,9 @@ class SpiceModel {
           var originalColumns = args.columns;
 
           // Find alias tokens from query/columns/sort
-          var nestings = [..._this10.extractNestings(((_args10 = args) == null ? void 0 : _args10.query) || "", _this10.type),
+          var nestings = [..._this10.extractNestings(((_args1 = args) == null ? void 0 : _args1.query) || "", _this10.type),
           //...this.extractNestings(args?.columns || "", this.type),
-          ..._this10.extractNestings(((_args11 = args) == null ? void 0 : _args11.sort) || "", _this10.type)];
+          ..._this10.extractNestings(((_args10 = args) == null ? void 0 : _args10.sort) || "", _this10.type)];
 
           // Build join metadata and prepare columns
           var {
@@ -1341,15 +1368,15 @@ class SpiceModel {
           return results;
         });
         return function doList() {
-          return _ref11.apply(this, arguments);
+          return _ref15.apply(this, arguments);
         };
       }();
       try {
         if (p) {
-          var _args12, _args13;
+          var _args11, _args12;
           return yield p.track(_this10.type + ".list", doList, {
-            limit: (_args12 = args) == null ? void 0 : _args12.limit,
-            offset: (_args13 = args) == null ? void 0 : _args13.offset
+            limit: (_args11 = args) == null ? void 0 : _args11.limit,
+            offset: (_args12 = args) == null ? void 0 : _args12.offset
           });
         }
         return yield doList();
@@ -1395,8 +1422,9 @@ class SpiceModel {
       // Profiling: use track() for proper async context forking
       var p = (_this11$_ctx = _this11[_ctx]) == null ? void 0 : _this11$_ctx.profiler;
       var doFetch = /*#__PURE__*/function () {
-        var _ref12 = _asyncToGenerator(function* () {
+        var _ref16 = _asyncToGenerator(function* () {
           if (args.is_custom_query === "true" && args.ids.length > 0) {
+            console.log("Fetching results from database", _this11.type, args, query, mappedNestings);
             return yield _this11.database.query(query);
           } else if (args.is_full_text === "true") {
             return yield _this11.database.full_text_search(_this11.type, query || "", args.limit, args.offset, args._join);
@@ -1407,7 +1435,7 @@ class SpiceModel {
           }
         });
         return function doFetch() {
-          return _ref12.apply(this, arguments);
+          return _ref16.apply(this, arguments);
         };
       }();
       if (p) {
@@ -1416,12 +1444,12 @@ class SpiceModel {
       return yield doFetch();
     })();
   }
-  addHook(_ref13) {
+  addHook(_ref17) {
     var {
       operation,
       when,
       execute
-    } = _ref13;
+    } = _ref17;
     this[_hooks][operation][when].push(execute);
   }
   run_hook(data, op, when, old_data) {
@@ -1519,7 +1547,8 @@ class SpiceModel {
         data = Array.of(data);
       }
       var isExempt = _this13.isFieldExempt(source_property);
-      if (isExempt || _this13[_level] + 1 < _this13[_mapping_dept]) {
+      var activeMappingDept = type === "read" ? _this13[_mapping_dept_scalar] : _this13[_mapping_dept];
+      if (isExempt || _this13[_level] + 1 < activeMappingDept) {
         var classes = _.compact(_.isArray(Class) ? Class : [Class]);
         var ids = [];
         _.each(data, result => {
@@ -1543,12 +1572,14 @@ class SpiceModel {
 
         // ⚡ Wrap in profiler track() to ensure proper async context for child operations
         var fetchRelated = /*#__PURE__*/function () {
-          var _ref14 = _asyncToGenerator(function* () {
+          var _ref18 = _asyncToGenerator(function* () {
             return yield Promise.allSettled(_.map(classes, obj => {
               var objInstance = new obj(_extends({}, _this13[_args], {
                 skip_cache: _this13[_skip_cache],
                 _level: _this13[_level] + 1,
                 mapping_dept: _this13[_mapping_dept],
+                mapping_dept_scalar: _this13[_mapping_dept_scalar],
+                mapping_dept_array: _this13[_mapping_dept_array],
                 mapping_dept_exempt: _this13[_mapping_dept_exempt],
                 _columns: columnArray.join(","),
                 _current_path: childPath
@@ -1561,7 +1592,7 @@ class SpiceModel {
             }));
           });
           return function fetchRelated() {
-            return _ref14.apply(this, arguments);
+            return _ref18.apply(this, arguments);
           };
         }();
         var returned_all;
@@ -1628,7 +1659,8 @@ class SpiceModel {
         data = Array.of(data);
       }
       var isExempt = _this14.isFieldExempt(source_property);
-      if (isExempt || _this14[_level] + 1 < _this14[_mapping_dept]) {
+      var activeMappingDept = type === "read" ? _this14[_mapping_dept_array] : _this14[_mapping_dept];
+      if (isExempt || _this14[_level] + 1 < activeMappingDept) {
         var ids = [];
         _.each(data, result => {
           var value = result[source_property];
@@ -1661,12 +1693,14 @@ class SpiceModel {
 
         // ⚡ Wrap in profiler track() to ensure proper async context for child operations
         var fetchRelated = /*#__PURE__*/function () {
-          var _ref15 = _asyncToGenerator(function* () {
+          var _ref19 = _asyncToGenerator(function* () {
             return yield Promise.allSettled(_.map(classes, obj => {
               return new obj(_extends({}, _this14[_args], {
                 skip_cache: _this14[_skip_cache],
                 _level: _this14[_level] + 1,
                 mapping_dept: _this14[_mapping_dept],
+                mapping_dept_scalar: _this14[_mapping_dept_scalar],
+                mapping_dept_array: _this14[_mapping_dept_array],
                 mapping_dept_exempt: _this14[_mapping_dept_exempt],
                 _columns: columnArray.join(","),
                 _current_path: childPath
@@ -1678,7 +1712,7 @@ class SpiceModel {
             }));
           });
           return function fetchRelated() {
-            return _ref15.apply(this, arguments);
+            return _ref19.apply(this, arguments);
           };
         }();
         var returned_all;
@@ -1726,11 +1760,11 @@ class SpiceModel {
       return original_is_array ? data : data[0];
     })();
   }
-  addModifier(_ref16) {
+  addModifier(_ref20) {
     var {
       when,
       execute
-    } = _ref16;
+    } = _ref20;
     if (this[_serializers][when]) {
       this[_serializers][when]["modifiers"].push(execute);
     }
@@ -1800,14 +1834,14 @@ class SpiceModel {
                     _this15.addModifier({
                       when: properties[i].map.when || "read",
                       execute: function () {
-                        var _execute = _asyncToGenerator(function* (data, old_data, ctx, type, args, mapping_dept, level, columns) {
+                        var _execute = _asyncToGenerator(function* (data, old_data, ctx, type, args, mapping_dept, level, columns, serializationType) {
                           // Skip if columns are specified but this field isn't included
                           if (!_this15.isFieldInColumns(i, columns)) {
                             return data;
                           }
-                          return yield _this15.mapToObject(data, _.isString(properties[i].map.reference) ? spice.models[properties[i].map.reference] : properties[i].map.reference, i, properties[i].map.destination || i, properties[i], args, type, mapping_dept, level, columns);
+                          return yield _this15.mapToObject(data, _.isString(properties[i].map.reference) ? spice.models[properties[i].map.reference] : properties[i].map.reference, i, properties[i].map.destination || i, properties[i], args, serializationType, mapping_dept, level, columns);
                         });
-                        function execute(_x, _x2, _x3, _x4, _x5, _x6, _x7, _x8) {
+                        function execute(_x, _x2, _x3, _x4, _x5, _x6, _x7, _x8, _x9) {
                           return _execute.apply(this, arguments);
                         }
                         return execute;
@@ -1821,14 +1855,14 @@ class SpiceModel {
                     _this15.addModifier({
                       when: properties[i].map.when || "read",
                       execute: function () {
-                        var _execute2 = _asyncToGenerator(function* (data, old_data, ctx, type, args, mapping_dept, level, columns) {
+                        var _execute2 = _asyncToGenerator(function* (data, old_data, ctx, type, args, mapping_dept, level, columns, serializationType) {
                           // Skip if columns are specified but this field isn't included
                           if (!_this15.isFieldInColumns(i, columns)) {
                             return data;
                           }
-                          return yield _this15.mapToObjectArray(data, _.isString(properties[i].map.reference) ? spice.models[properties[i].map.reference] : properties[i].map.reference, i, properties[i].map.destination || i, properties[i], args, type, mapping_dept, level, columns);
+                          return yield _this15.mapToObjectArray(data, _.isString(properties[i].map.reference) ? spice.models[properties[i].map.reference] : properties[i].map.reference, i, properties[i].map.destination || i, properties[i], args, serializationType, mapping_dept, level, columns);
                         });
-                        function execute(_x9, _x0, _x1, _x10, _x11, _x12, _x13, _x14) {
+                        function execute(_x0, _x1, _x10, _x11, _x12, _x13, _x14, _x15, _x16) {
                           return _execute2.apply(this, arguments);
                         }
                         return execute;
@@ -1860,7 +1894,7 @@ class SpiceModel {
       // Profiling: use track() for proper async context forking
       var p = (_this16$_ctx = _this16[_ctx]) == null ? void 0 : _this16$_ctx.profiler;
       var doSerialize = /*#__PURE__*/function () {
-        var _ref17 = _asyncToGenerator(function* () {
+        var _ref21 = _asyncToGenerator(function* () {
           var _this16$_serializers, _this16$_serializers$;
           // Early exit if serialization should not run.
           if (!_this16.shouldSerializerRun(args, type)) {
@@ -1878,7 +1912,7 @@ class SpiceModel {
           for (var i = 0; i < modifiers.length; i++) {
             var modifier = modifiers[i];
             try {
-              var result = yield modifier(data, old_data, _this16[_ctx], _this16.type, args, _this16[_mapping_dept], _this16[_level], _this16[_columns]);
+              var result = yield modifier(data, old_data, _this16[_ctx], _this16.type, args, _this16[_mapping_dept], _this16[_level], _this16[_columns], type);
               // Guard against modifiers that return undefined
               if (result !== undefined) {
                 data = result;
@@ -1928,7 +1962,7 @@ class SpiceModel {
           return originalIsArray ? data : data[0];
         });
         return function doSerialize() {
-          return _ref17.apply(this, arguments);
+          return _ref21.apply(this, arguments);
         };
       }();
       try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spice-js",
-  "version": "2.7.29",
+  "version": "2.7.30",
   "description": "spice",
   "main": "build/index.js",
   "repository": {

package/src/index.js

@@ -2,7 +2,9 @@
 var path = require("path");
 //import IO from "koa-socket-2";
 const cors = require("kcors");
-global.spice = {};
+// Preserve an existing host/test configuration when the package is imported.
+// Production boot still starts from an empty object because spice is undefined.
+global.spice = global.spice || {};
 
 require("dotenv").config({ path: path.resolve("./") });
 

package/src/models/SpiceModel.js

@@ -22,6 +22,8 @@ var SDate = require("sonover-date"),
   _serializers = Symbol(),
   _level = Symbol(),
   _mapping_dept = Symbol(),
+  _mapping_dept_scalar = Symbol(),
+  _mapping_dept_array = Symbol(),
   _mapping_dept_exempt = Symbol(),
   _current_path = Symbol();
 
@@ -47,12 +49,29 @@ if (!Promise.allSettled) {
 export default class SpiceModel {
   constructor(args = {}) {
     try {
+      const modelArgs = args?.args || {};
+      const requestProfile = modelArgs?.ctx?.state?.read_profile || {};
+      const defaultMappingDept = process.env.MAPPING_DEPT || 3;
+      const legacyMappingDept =
+        modelArgs.mapping_dept !== undefined && modelArgs.mapping_dept !== null ?
+          modelArgs.mapping_dept
+        : undefined;
+
       var dbtype =
         spice.config.database.connections[args.connection].type || "couchbase";
       let Database = require(`spice-${dbtype}`);
-      this[_mapping_dept] =
-        args?.args?.mapping_dept || process.env.MAPPING_DEPT || 3;
-      this[_mapping_dept_exempt] = args?.args?.mapping_dept_exempt || [];
+      this[_mapping_dept] = legacyMappingDept ?? defaultMappingDept;
+      this[_mapping_dept_scalar] =
+        modelArgs.mapping_dept_scalar ??
+        legacyMappingDept ??
+        requestProfile.mapping_dept_scalar ??
+        defaultMappingDept;
+      this[_mapping_dept_array] =
+        modelArgs.mapping_dept_array ??
+        legacyMappingDept ??
+        requestProfile.mapping_dept_array ??
+        defaultMappingDept;
+      this[_mapping_dept_exempt] = modelArgs.mapping_dept_exempt || [];
       this.type = "";
       this.collection = args.connection;
       this[_args] = args.args;
@@ -237,6 +256,32 @@ export default class SpiceModel {
     // }
   }
 
+  applyMappingDepthArgs(args = {}) {
+    const hasLegacyDepth =
+      args.mapping_dept !== undefined && args.mapping_dept !== null;
+
+    if (hasLegacyDepth) {
+      this[_mapping_dept] = args.mapping_dept;
+      this[_mapping_dept_scalar] = args.mapping_dept;
+      this[_mapping_dept_array] = args.mapping_dept;
+    }
+    if (
+      args.mapping_dept_scalar !== undefined &&
+      args.mapping_dept_scalar !== null
+    ) {
+      this[_mapping_dept_scalar] = args.mapping_dept_scalar;
+    }
+    if (
+      args.mapping_dept_array !== undefined &&
+      args.mapping_dept_array !== null
+    ) {
+      this[_mapping_dept_array] = args.mapping_dept_array;
+    }
+    if (args.mapping_dept_exempt) {
+      this[_mapping_dept_exempt] = args.mapping_dept_exempt;
+    }
+  }
+
   get database() {
     return this[_database];
   }
@@ -515,13 +560,10 @@ export default class SpiceModel {
     const p = this[_ctx]?.profiler;
 
     const doGet = async () => {
-      if (args.mapping_dept) this[_mapping_dept] = args.mapping_dept;
-      if (args.mapping_dept_exempt)
-        this[_mapping_dept_exempt] = args.mapping_dept_exempt;
-
       if (!args) {
         args = {};
       }
+      this.applyMappingDepthArgs(args);
       if (_.isString(args.id)) {
         if (args.skip_hooks !== true) {
           await this.run_hook(args, "get", "before");
@@ -687,10 +729,13 @@ export default class SpiceModel {
       if (!args) {
         args = {};
       }
+      this.applyMappingDepthArgs(args);
       if (args.skip_hooks != true) {
         await this.run_hook(this, "list", "before");
       }
-      _.remove(args.ids, (o) => o == undefined);
+      args.ids = _.uniq(
+        _.filter(args.ids || [], (id) => _.isString(id) && id.length > 0),
+      );
       let key = `multi-get::${this.type}::${_.join(args.ids, "|")}:${args.columns}`;
       let results = [];
 
@@ -1384,9 +1429,7 @@ export default class SpiceModel {
     const p = this[_ctx]?.profiler;
 
     const doList = async () => {
-      if (args.mapping_dept) this[_mapping_dept] = args.mapping_dept;
-      if (args.mapping_dept_exempt)
-        this[_mapping_dept_exempt] = args.mapping_dept_exempt;
+      this.applyMappingDepthArgs(args);
 
       // Filter out id, meta().id, and any column ending with .id (e.g., dependents.id)
       if (args.columns) {
@@ -1558,6 +1601,13 @@ export default class SpiceModel {
 
     const doFetch = async () => {
       if (args.is_custom_query === "true" && args.ids.length > 0) {
+        console.log(
+          "Fetching results from database",
+          this.type,
+          args,
+          query,
+          mappedNestings,
+        );
         return await this.database.query(query);
       } else if (args.is_full_text === "true") {
         return await this.database.full_text_search(
@@ -1717,7 +1767,9 @@ export default class SpiceModel {
       data = Array.of(data);
     }
     const isExempt = this.isFieldExempt(source_property);
-    if (isExempt || this[_level] + 1 < this[_mapping_dept]) {
+    const activeMappingDept =
+      type === "read" ? this[_mapping_dept_scalar] : this[_mapping_dept];
+    if (isExempt || this[_level] + 1 < activeMappingDept) {
       let classes = _.compact(_.isArray(Class) ? Class : [Class]);
 
       let ids = [];
@@ -1761,6 +1813,8 @@ export default class SpiceModel {
               skip_cache: this[_skip_cache],
               _level: this[_level] + 1,
               mapping_dept: this[_mapping_dept],
+              mapping_dept_scalar: this[_mapping_dept_scalar],
+              mapping_dept_array: this[_mapping_dept_array],
               mapping_dept_exempt: this[_mapping_dept_exempt],
               _columns: columnArray.join(","),
               _current_path: childPath,
@@ -1881,7 +1935,9 @@ export default class SpiceModel {
       data = Array.of(data);
     }
     const isExempt = this.isFieldExempt(source_property);
-    if (isExempt || this[_level] + 1 < this[_mapping_dept]) {
+    const activeMappingDept =
+      type === "read" ? this[_mapping_dept_array] : this[_mapping_dept];
+    if (isExempt || this[_level] + 1 < activeMappingDept) {
       let ids = [];
       _.each(data, (result) => {
         let value = result[source_property];
@@ -1932,6 +1988,8 @@ export default class SpiceModel {
               skip_cache: this[_skip_cache],
               _level: this[_level] + 1,
               mapping_dept: this[_mapping_dept],
+              mapping_dept_scalar: this[_mapping_dept_scalar],
+              mapping_dept_array: this[_mapping_dept_array],
               mapping_dept_exempt: this[_mapping_dept_exempt],
               _columns: columnArray.join(","),
               _current_path: childPath,
@@ -2096,6 +2154,7 @@ export default class SpiceModel {
                     mapping_dept,
                     level,
                     columns,
+                    serializationType,
                   ) => {
                     // Skip if columns are specified but this field isn't included
                     if (!this.isFieldInColumns(i, columns)) {
@@ -2110,7 +2169,7 @@ export default class SpiceModel {
                       properties[i].map.destination || i,
                       properties[i],
                       args,
-                      type,
+                      serializationType,
                       mapping_dept,
                       level,
                       columns,
@@ -2132,6 +2191,7 @@ export default class SpiceModel {
                     mapping_dept,
                     level,
                     columns,
+                    serializationType,
                   ) => {
                     // Skip if columns are specified but this field isn't included
                     if (!this.isFieldInColumns(i, columns)) {
@@ -2147,7 +2207,7 @@ export default class SpiceModel {
                       properties[i].map.destination || i,
                       properties[i],
                       args,
-                      type,
+                      serializationType,
                       mapping_dept,
                       level,
                       columns,
@@ -2197,6 +2257,7 @@ export default class SpiceModel {
             this[_mapping_dept],
             this[_level],
             this[_columns],
+            type,
           );
           // Guard against modifiers that return undefined
           if (result !== undefined) {

package/tests/__mocks__/globalMocks.js

@@ -22,8 +22,10 @@ const spiceConfig = {
   cache: {},
   cache_providers: {},
   schemas: {},
+  models: {},
   modifiers: {},
-  schema_extenders: []
+  schema_extenders: [],
+  getModifiers: jest.fn(() => [])
 };
 
 // Set on multiple global scopes to ensure it's available

package/tests/fixtures/testData.js

@@ -29,6 +29,8 @@ const columnTestCases = {
  */
 const sampleDbResults = {
   users: [
+    { id: 'valid-1', type: 'user', name: 'Valid One', email: 'valid1@example.com' },
+    { id: 'valid-2', type: 'user', name: 'Valid Two', email: 'valid2@example.com' },
     { id: 'user-1', type: 'user', name: 'Alice', email: 'alice@example.com' },
     { id: 'user-2', type: 'user', name: 'Bob', email: 'bob@example.com' },
     { id: 'user-3', type: 'user', name: 'Charlie', email: 'charlie@example.com' }
@@ -71,7 +73,7 @@ function generateLargeDataset(size = 100) {
   for (let i = 0; i < size; i++) {
     data.push({
       id: `item-${i}`,
-      type: 'item',
+      type: 'user',
       name: `Item ${i}`,
       value: Math.random()
     });

package/tests/helpers/modelFactory.js

@@ -4,6 +4,12 @@
 
 const SpiceModel = require('../../src/models/SpiceModel').default;
 const MockDatabase = require('../__mocks__/spice-couchbase');
+const spiceConfig = require('../__mocks__/globalMocks');
+
+// Importing SpiceModel loads the package index, which initializes global.spice.
+// Restore the complete test configuration after that package initialization.
+global.spice = spiceConfig;
+globalThis.spice = spiceConfig;
 
 /**
  * Create a test model instance with mocked database
@@ -32,7 +38,7 @@ function createTestModel(config = {}) {
     connection,
     collection: type,
     props,
-    args: { ...args, skip_cache: true }
+    args: { ...args, skip_cache: true, disable_lifecycle_events: true }
   });
 
   // Inject mock database

package/tests/jest-env.js

@@ -21,8 +21,10 @@ class CustomEnvironment extends NodeEnvironment {
       cache: {},
       cache_providers: {},
       schemas: {},
+      models: {},
       modifiers: {},
-      schema_extenders: []
+      schema_extenders: [],
+      getModifiers: () => []
     };
 
     // Set on the global object for the test environment

package/tests/models/SpiceModel.mapping-depth.test.js

@@ -0,0 +1,182 @@
+const { createTestModel, seedDatabase } = require('../helpers/modelFactory');
+
+describe('SpiceModel type-specific mapping depth', () => {
+  function createRelatedModel(records, capture) {
+    return class RelatedModel {
+      constructor(args) {
+        capture.constructorArgs.push(args);
+      }
+
+      async getMulti({ ids }) {
+        capture.getMultiIds.push(ids);
+        return records.filter((record) => ids.includes(record.id));
+      }
+    };
+  }
+
+  function createMappedModel(args = {}) {
+    const scalarCapture = { constructorArgs: [], getMultiIds: [] };
+    const arrayCapture = { constructorArgs: [], getMultiIds: [] };
+    const ScalarModel = createRelatedModel(
+      [{ id: 'group-1', name: 'Administrators' }],
+      scalarCapture
+    );
+    const ArrayModel = createRelatedModel(
+      [
+        { id: 'child-1', name: 'First' },
+        { id: 'child-2', name: 'Second' }
+      ],
+      arrayCapture
+    );
+    const model = createTestModel({
+      type: 'parent',
+      args,
+      props: {
+        group: {
+          type: 'string',
+          map: { type: 'model', reference: ScalarModel }
+        },
+        children: {
+          type: 'array',
+          map: { type: 'model', reference: ArrayModel }
+        }
+      }
+    });
+    seedDatabase(model, {
+      id: 'parent-1',
+      type: 'parent',
+      group: 'group-1',
+      children: ['child-1', 'child-2']
+    });
+    return { model, scalarCapture, arrayCapture };
+  }
+
+  test('uses scalar depth 1 and array depth 3 from the request profile', async () => {
+    const ctx = {
+      state: {
+        read_profile: {
+          mapping_dept_scalar: 1,
+          mapping_dept_array: 3
+        }
+      }
+    };
+    const { model, scalarCapture, arrayCapture } = createMappedModel({ ctx });
+
+    const result = await model.get({ id: 'parent-1' });
+
+    expect(result.group).toBe('group-1');
+    expect(result.children).toEqual([
+      expect.objectContaining({ id: 'child-1', name: 'First' }),
+      expect.objectContaining({ id: 'child-2', name: 'Second' })
+    ]);
+    expect(scalarCapture.getMultiIds).toEqual([]);
+    expect(arrayCapture.getMultiIds).toEqual([['child-1', 'child-2']]);
+  });
+
+  test('keeps legacy mapping_dept behavior for both relationship types', async () => {
+    const { model, scalarCapture, arrayCapture } = createMappedModel({
+      mapping_dept: 1
+    });
+
+    const result = await model.get({ id: 'parent-1' });
+
+    expect(result.group).toBe('group-1');
+    expect(result.children).toEqual(['child-1', 'child-2']);
+    expect(scalarCapture.getMultiIds).toEqual([]);
+    expect(arrayCapture.getMultiIds).toEqual([]);
+  });
+
+  test('explicit read arguments override the request profile independently', async () => {
+    const ctx = {
+      state: {
+        read_profile: {
+          mapping_dept_scalar: 1,
+          mapping_dept_array: 1
+        }
+      }
+    };
+    const { model } = createMappedModel({ ctx });
+
+    const result = await model.get({
+      id: 'parent-1',
+      mapping_dept_scalar: 3,
+      mapping_dept_array: 3
+    });
+
+    expect(result.group).toEqual(
+      expect.objectContaining({ id: 'group-1', name: 'Administrators' })
+    );
+    expect(result.children).toHaveLength(2);
+  });
+
+  test('mapping depth exemptions continue to expand scalar paths', async () => {
+    const { model, scalarCapture } = createMappedModel({
+      mapping_dept_scalar: 1,
+      mapping_dept_array: 3,
+      mapping_dept_exempt: ['group']
+    });
+
+    const result = await model.get({ id: 'parent-1' });
+
+    expect(result.group).toEqual(
+      expect.objectContaining({ id: 'group-1', name: 'Administrators' })
+    );
+    expect(scalarCapture.getMultiIds).toEqual([['group-1']]);
+  });
+
+  test('propagates both depths to related model instances', async () => {
+    const { model, arrayCapture } = createMappedModel({
+      mapping_dept_scalar: 1,
+      mapping_dept_array: 3
+    });
+
+    await model.getMulti({ ids: ['parent-1'] });
+
+    expect(arrayCapture.constructorArgs[0]).toEqual(
+      expect.objectContaining({
+        mapping_dept_scalar: 1,
+        mapping_dept_array: 3,
+        _level: 1
+      })
+    );
+  });
+
+  test('does not apply the request read profile to write serialization', async () => {
+    const capture = { constructorArgs: [], getMultiIds: [] };
+    const RelatedModel = createRelatedModel(
+      [{ id: 'group-1', name: 'Administrators' }],
+      capture
+    );
+    const model = createTestModel({
+      type: 'parent',
+      args: {
+        ctx: {
+          state: {
+            read_profile: {
+              mapping_dept_scalar: 1,
+              mapping_dept_array: 1
+            }
+          }
+        }
+      },
+      props: {
+        group: {
+          type: 'string',
+          map: { type: 'model', reference: RelatedModel, when: 'write' }
+        }
+      }
+    });
+
+    const result = await model.do_serialize(
+      { id: 'parent-1', group: 'group-1' },
+      'write',
+      {},
+      {}
+    );
+
+    expect(result.group).toEqual(
+      expect.objectContaining({ id: 'group-1', name: 'Administrators' })
+    );
+    expect(capture.getMultiIds).toEqual([['group-1']]);
+  });
+});