@memberjunction/react-runtime 5.25.0 → 5.27.0

package/dist/runtime.umd.js

@@ -19975,6 +19975,20 @@ var BaseInfo = /*#__PURE__*/function () {
       this.copyInitData(initData);
     }
   }
+  /**
+   * Default JSON serialization for BaseInfo subclasses.
+   *
+   * Emits all non-underscored direct field declarations. For `_`-prefixed private backing fields
+   * (the MJ pattern for collection storage — e.g. `_Fields`, `_RelatedEntities`, `_OrganicKeys`),
+   * emits the value of the corresponding same-named public getter instead. Purely computed getters
+   * without a backing field (display-name formatters, derived flags) are intentionally skipped —
+   * they can throw when source fields are null and don't belong on the wire anyway.
+   *
+   * Nested BaseInfo instances and arrays of them unwrap automatically via JSON.stringify's
+   * native toJSON() protocol.
+   *
+   * Subclasses may override to emit a filtered subset or custom shape (see EntityFieldValueInfo).
+   */
   return _createClass(BaseInfo, [{
     key: "copyInitData",
     value:
@@ -20003,6 +20017,32 @@ var BaseInfo = /*#__PURE__*/function () {
         }
       }
     }
+  }, {
+    key: "toJSON",
+    value: function toJSON() {
+      var result = {};
+      var self = this;
+      for (var _i = 0, _Object$keys = Object.keys(this); _i < _Object$keys.length; _i++) {
+        var key = _Object$keys[_i];
+        if (!key.startsWith('_')) {
+          result[key] = self[key];
+          continue;
+        }
+        // Private backing field — expose via its public getter if one exists with the same name minus the underscore
+        var publicKey = key.slice(1);
+        if (!publicKey) continue;
+        var proto = Object.getPrototypeOf(this);
+        while (proto && proto !== Object.prototype) {
+          var desc = Object.getOwnPropertyDescriptor(proto, publicKey);
+          if (desc && typeof desc.get === 'function') {
+            result[publicKey] = self[publicKey];
+            break;
+          }
+          proto = Object.getPrototypeOf(proto);
+        }
+      }
+      return result;
+    }
   }]);
 }();
 ;// ../../MJCore/dist/generic/platformVariants.js
@@ -22629,7 +22669,7 @@ var EntityOrganicKeyInfo = /*#__PURE__*/function (_BaseInfo3) {
     if (initData) {
       _this3.copyInitData(initData);
       _this3._RelatedEntities = [];
-      var re = initData.EntityOrganicKeyRelatedEntities || initData._RelatedEntities;
+      var re = initData.EntityOrganicKeyRelatedEntities || initData._RelatedEntities || initData.RelatedEntities;
       if (re && Array.isArray(re)) {
         // sort by sequence
         var sorted = entityInfo_toConsumableArray(re);
@@ -22883,8 +22923,20 @@ var EntityFieldValueInfo = /*#__PURE__*/function (_BaseInfo6) {
     _this6.copyInitData(initData);
     return _this6;
   }
+  /**
+   * Returns a plain object suitable for JSON serialization.
+   * Called automatically by JSON.stringify().
+   */
   entityInfo_inherits(EntityFieldValueInfo, _BaseInfo6);
-  return entityInfo_createClass(EntityFieldValueInfo);
+  return entityInfo_createClass(EntityFieldValueInfo, [{
+    key: "toJSON",
+    value: function toJSON() {
+      return {
+        Value: this.Value,
+        Code: this.Code
+      };
+    }
+  }]);
 }(BaseInfo);
 var GeneratedFormSectionType = {
   Top: 'Top',
@@ -23693,6 +23745,14 @@ var EntityInfo = /*#__PURE__*/function (_BaseInfo0) {
      * since those inserts bypass BaseEntity and never trigger cache invalidation.
      */
     _this0.TrustServerCacheCompletely = true;
+    /**
+     * Controls whether this entity participates in server-side and client-side
+     * caching at all. When false (default for non-__mj entities), the entire
+     * cache code path is short-circuited: no PreRunView cache check, no
+     * auto-cache storage, no HandleBaseEntityEvent fingerprint scan, no
+     * client-side IndexedDB cache. Zero overhead on hot save/query paths.
+     */
+    _this0.AllowCaching = false;
     /**
      * Whether this entity is available through the GraphQL API
      */
@@ -23937,9 +23997,9 @@ var EntityInfo = /*#__PURE__*/function (_BaseInfo0) {
     if (initData) {
       _this0.copyInitData(initData);
       // do some special handling to create class instances instead of just data objects
-      // copy the Entity Fields
+      // copy the Entity Fields (accept EntityFields, _Fields, or Fields as input names)
       _this0._Fields = [];
-      var ef = initData.EntityFields || initData._Fields;
+      var ef = initData.EntityFields || initData._Fields || initData.Fields;
       if (ef) {
         for (var j = 0; j < ef.length; j++) {
           _this0._Fields.push(new EntityFieldInfo(ef[j]));
@@ -23963,9 +24023,9 @@ var EntityInfo = /*#__PURE__*/function (_BaseInfo0) {
       }
       // auto-populate FieldCategories from the FieldCategoryInfo setting
       _this0._FieldCategories = _this0.parseFieldCategoriesFromSettings();
-      // copy the Related Entities
+      // copy the Related Entities (accept EntityRelationships, _RelatedEntities, or RelatedEntities as input names)
       _this0._RelatedEntities = [];
-      var er = initData.EntityRelationships || initData._RelatedEntities;
+      var er = initData.EntityRelationships || initData._RelatedEntities || initData.RelatedEntities;
       if (er) {
         // check to see if ANY of the records in the er array have a non-null or non-zero sequence value. The reason is 
         // if we have any sequence values populated we want to sort by that sequence, and we want to consider null to be a high number
@@ -24001,7 +24061,7 @@ var EntityInfo = /*#__PURE__*/function (_BaseInfo0) {
       }
       // copy the Organic Keys (sorted by sequence inside EntityOrganicKeyInfo constructor)
       _this0._OrganicKeys = [];
-      var ok = initData.EntityOrganicKeys || initData._OrganicKeys;
+      var ok = initData.EntityOrganicKeys || initData._OrganicKeys || initData.OrganicKeys;
       if (ok && Array.isArray(ok)) {
         var _iterator3 = entityInfo_createForOfIteratorHelper(ok),
           _step3;
@@ -32301,10 +32361,13 @@ var DEFAULT_CONFIG = {
   enabled: true,
   maxSizeBytes: 150 * 1024 * 1024,
   // 150MB
-  maxEntries: 5000,
-  defaultTTLMs: 5 * 60 * 1000,
+  defaultTTLMs: 0,
+  // No TTL — event-based invalidation is the primary mechanism
+  evictionPolicy: 'lru',
+  maxPercentOfCachePerEntity: 50,
+  evictionSweepIntervalMs: 300000,
   // 5 minutes
-  evictionPolicy: 'lru'
+  verboseLogging: false
 };
 // ============================================================================
 // STORAGE CATEGORIES
@@ -32390,6 +32453,10 @@ var LocalCacheManager = /*#__PURE__*/function (_BaseSingleton) {
      */
     _this._changeCallbacks = new Map();
     _this._persistTimeout = null;
+    /**
+     * Handle for the periodic eviction sweep timer.
+     */
+    _this._sweepTimer = null;
     return _this;
   }
   // ========================================================================
@@ -32441,6 +32508,8 @@ var LocalCacheManager = /*#__PURE__*/function (_BaseSingleton) {
               return this.loadRegistry();
             case 1:
               this._initialized = true;
+              // Start periodic eviction sweep for TTL-expired entries
+              this.startEvictionSweep();
               // Subscribe to BaseEntity events for universal cache invalidation.
               // When any entity is saved/deleted, update all cached RunView results for that entity.
               this.subscribeToBaseEntityEvents();
@@ -32479,6 +32548,18 @@ var LocalCacheManager = /*#__PURE__*/function (_BaseSingleton) {
     value: function UpdateConfig(config) {
       this._config = localCacheManager_objectSpread(localCacheManager_objectSpread({}, this._config), config);
     }
+    /**
+     * Checks whether caching is enabled for a given entity. Returns the entity's
+     * AllowCaching metadata flag. This is the single source of truth for cache
+     * eligibility — schema-level opt-in is applied at CodeGen time via the
+     * `newEntityDefaults.AllowCachingBySchema` config, which flips this flag when
+     * the entity is first inserted into the metadata.
+     */
+  }, {
+    key: "IsCachingEnabledForEntity",
+    value: function IsCachingEnabledForEntity(entityInfo) {
+      return entityInfo.AllowCaching === true;
+    }
     /**
      * Replaces the storage provider after initialization. This is needed when
      * the initial provider (e.g., in-memory) needs to be swapped for a
@@ -32694,72 +32775,78 @@ var LocalCacheManager = /*#__PURE__*/function (_BaseSingleton) {
               }
               return _context3.a(2);
             case 1:
-              entityName = baseEntity.EntityInfo.Name;
-              fingerprints = this._entityFingerprintIndex.get(entityName);
-              if (!(!fingerprints || fingerprints.size === 0)) {
+              entityName = baseEntity.EntityInfo.Name; // Short-circuit: if caching is disabled for this entity, skip the fingerprint scan
+              if (this.IsCachingEnabledForEntity(baseEntity.EntityInfo)) {
                 _context3.n = 2;
                 break;
               }
               return _context3.a(2);
             case 2:
-              primaryKeys = baseEntity.EntityInfo.PrimaryKeys;
-              if (!(!primaryKeys || primaryKeys.length === 0)) {
+              fingerprints = this._entityFingerprintIndex.get(entityName);
+              if (!(!fingerprints || fingerprints.size === 0)) {
                 _context3.n = 3;
                 break;
               }
               return _context3.a(2);
             case 3:
+              primaryKeys = baseEntity.EntityInfo.PrimaryKeys;
+              if (!(!primaryKeys || primaryKeys.length === 0)) {
+                _context3.n = 4;
+                break;
+              }
+              return _context3.a(2);
+            case 4:
               // Build a CompositeKey from the entity's primary key fields
               key = new CompositeKey();
               key.LoadFromEntityInfoAndRecord(baseEntity.EntityInfo, baseEntity.GetAll());
               if (!(key.KeyValuePairs.length === 0 || key.KeyValuePairs.some(function (kv) {
                 return kv.Value == null;
               }))) {
-                _context3.n = 4;
+                _context3.n = 5;
                 break;
               }
               return _context3.a(2);
-            case 4:
+            case 5:
               LogStatusVerbose("LocalCacheManager: BaseEntity ".concat(entityEvent.type, " event for \"").concat(entityName, "\" PK=").concat(key.ToConcatenatedString(), ", updating ").concat(fingerprints.size, " cached fingerprint(s)"));
               fingerprintSnapshot = localCacheManager_toConsumableArray(fingerprints);
               nowISO = new Date().toISOString();
               _iterator2 = localCacheManager_createForOfIteratorHelper(fingerprintSnapshot);
-              _context3.p = 5;
+              _context3.p = 6;
               _iterator2.s();
-            case 6:
+            case 7:
               if ((_step2 = _iterator2.n()).done) {
-                _context3.n = 11;
+                _context3.n = 12;
                 break;
               }
               fingerprint = _step2.value;
-              _context3.p = 7;
-              _context3.n = 8;
+              _context3.p = 8;
+              _context3.n = 9;
               return this.processEntityEventForFingerprint(entityEvent.type, fingerprint, baseEntity, key, nowISO);
-            case 8:
-              _context3.n = 10;
-              break;
             case 9:
-              _context3.p = 9;
+              _context3.n = 11;
+              break;
+            case 10:
+              _context3.p = 10;
               _t3 = _context3.v;
               LogError("HandleBaseEntityEvent: failed to update fingerprint \"".concat(fingerprint, "\": ").concat(_t3.message));
-            case 10:
-              _context3.n = 6;
-              break;
             case 11:
-              _context3.n = 13;
+              _context3.n = 7;
               break;
             case 12:
-              _context3.p = 12;
-              _t4 = _context3.v;
-              _iterator2.e(_t4);
+              _context3.n = 14;
+              break;
             case 13:
               _context3.p = 13;
-              _iterator2.f();
-              return _context3.f(13);
+              _t4 = _context3.v;
+              _iterator2.e(_t4);
             case 14:
+              _context3.p = 14;
+              _iterator2.f();
+              return _context3.f(14);
+            case 15:
               return _context3.a(2);
           }
-        }, _callee3, this, [[7, 9], [5, 12, 13, 14]]);
+        }, _callee3, this, [[8, 10], [6, 13, 14, 15]]);
       }));
       function HandleBaseEntityEvent(_x4) {
         return _HandleBaseEntityEvent.apply(this, arguments);
@@ -32777,7 +32864,7 @@ var LocalCacheManager = /*#__PURE__*/function (_BaseSingleton) {
     key: "HandleRemoteInvalidateEvent",
     value: (function () {
       var _HandleRemoteInvalidateEvent = localCacheManager_asyncToGenerator(/*#__PURE__*/localCacheManager_regenerator().m(function _callee4(entityEvent) {
-        var payload, entityName, fingerprints, action, md, entityInfo, _i, _arr, fp, primaryKeys, _i2, _arr2, _fp, nowISO, fingerprintSnapshot, key, _iterator3, _step3, _fp2, _iterator4, _step4, fingerprint, recordData, _key, _iterator5, _step5, _fingerprint, _iterator6, _step6, _fp3, _iterator7, _step7, _fp4, _t5, _t6, _t7, _t8, _t9, _t0, _t1, _t10;
+        var payload, entityName, md, entityInfo, fingerprints, action, _i, _arr, fp, primaryKeys, _i2, _arr2, _fp, nowISO, fingerprintSnapshot, key, _iterator3, _step3, _fp2, _iterator4, _step4, fingerprint, recordData, _key, _iterator5, _step5, _fingerprint, _iterator6, _step6, _fp3, _iterator7, _step7, _fp4, _t5, _t6, _t7, _t8, _t9, _t0, _t1, _t10;
         return localCacheManager_regenerator().w(function (_context4) {
           while (1) switch (_context4.p = _context4.n) {
             case 0:
@@ -32789,141 +32876,148 @@ var LocalCacheManager = /*#__PURE__*/function (_BaseSingleton) {
               }
               return _context4.a(2);
             case 1:
-              fingerprints = this._entityFingerprintIndex.get(entityName);
-              if (!(!fingerprints || fingerprints.size === 0)) {
+              // Short-circuit: if caching is disabled for this entity, skip processing
+              md = new Metadata();
+              entityInfo = md.EntityByName(entityName);
+              if (!(entityInfo && !this.IsCachingEnabledForEntity(entityInfo))) {
                 _context4.n = 2;
                 break;
               }
               return _context4.a(2);
             case 2:
-              action = payload === null || payload === void 0 ? void 0 : payload.action; // Look up entity metadata for PK field names
-              md = new Metadata();
-              entityInfo = md.EntityByName(entityName);
+              fingerprints = this._entityFingerprintIndex.get(entityName);
+              if (!(!fingerprints || fingerprints.size === 0)) {
+                _context4.n = 3;
+                break;
+              }
+              return _context4.a(2);
+            case 3:
+              action = payload === null || payload === void 0 ? void 0 : payload.action; // entityInfo was looked up above for the AllowCaching check
               if (entityInfo) {
-                _context4.n = 6;
+                _context4.n = 7;
                 break;
               }
               LogStatusVerbose("LocalCacheManager: remote-invalidate \u2014 entity \"".concat(entityName, "\" not found in metadata, invalidating caches"));
               _i = 0, _arr = localCacheManager_toConsumableArray(fingerprints);
-            case 3:
+            case 4:
               if (!(_i < _arr.length)) {
-                _context4.n = 5;
+                _context4.n = 6;
                 break;
               }
               fp = _arr[_i];
-              _context4.n = 4;
+              _context4.n = 5;
               return this.InvalidateRunViewResult(fp);
-            case 4:
+            case 5:
               _i++;
-              _context4.n = 3;
+              _context4.n = 4;
               break;
-            case 5:
-              return _context4.a(2);
             case 6:
+              return _context4.a(2);
+            case 7:
               primaryKeys = entityInfo.PrimaryKeys;
               if (!(!primaryKeys || primaryKeys.length === 0)) {
-                _context4.n = 10;
+                _context4.n = 11;
                 break;
               }
               LogStatusVerbose("LocalCacheManager: remote-invalidate \u2014 no PKs for \"".concat(entityName, "\", invalidating ").concat(fingerprints.size, " cached fingerprint(s)"));
               _i2 = 0, _arr2 = localCacheManager_toConsumableArray(fingerprints);
-            case 7:
+            case 8:
               if (!(_i2 < _arr2.length)) {
-                _context4.n = 9;
+                _context4.n = 10;
                 break;
               }
               _fp = _arr2[_i2];
-              _context4.n = 8;
+              _context4.n = 9;
               return this.InvalidateRunViewResult(_fp);
-            case 8:
+            case 9:
               _i2++;
-              _context4.n = 7;
+              _context4.n = 8;
               break;
-            case 9:
-              return _context4.a(2);
             case 10:
+              return _context4.a(2);
+            case 11:
               nowISO = new Date().toISOString();
               fingerprintSnapshot = localCacheManager_toConsumableArray(fingerprints); // Handle delete: remove the record from all cached results
               if (!(action === 'delete')) {
-                _context4.n = 29;
+                _context4.n = 30;
                 break;
               }
               key = this.parseCompositeKeyFromJSON(payload === null || payload === void 0 ? void 0 : payload.primaryKeyValues);
               if (key) {
-                _context4.n = 18;
+                _context4.n = 19;
                 break;
               }
               LogStatusVerbose("LocalCacheManager: remote-invalidate (delete) \u2014 no PK values for \"".concat(entityName, "\", invalidating caches"));
               _iterator3 = localCacheManager_createForOfIteratorHelper(fingerprintSnapshot);
-              _context4.p = 11;
+              _context4.p = 12;
               _iterator3.s();
-            case 12:
+            case 13:
               if ((_step3 = _iterator3.n()).done) {
-                _context4.n = 14;
+                _context4.n = 15;
                 break;
               }
               _fp2 = _step3.value;
-              _context4.n = 13;
+              _context4.n = 14;
               return this.InvalidateRunViewResult(_fp2);
-            case 13:
-              _context4.n = 12;
-              break;
             case 14:
-              _context4.n = 16;
+              _context4.n = 13;
               break;
             case 15:
-              _context4.p = 15;
-              _t5 = _context4.v;
-              _iterator3.e(_t5);
+              _context4.n = 17;
+              break;
             case 16:
               _context4.p = 16;
-              _iterator3.f();
-              return _context4.f(16);
+              _t5 = _context4.v;
+              _iterator3.e(_t5);
             case 17:
-              return _context4.a(2);
+              _context4.p = 17;
+              _iterator3.f();
+              return _context4.f(17);
             case 18:
+              return _context4.a(2);
+            case 19:
               LogStatusVerbose("LocalCacheManager: remote-invalidate (delete) for \"".concat(entityName, "\" PK=").concat(key.ToConcatenatedString(), ", removing from ").concat(fingerprints.size, " cached fingerprint(s)"));
               _iterator4 = localCacheManager_createForOfIteratorHelper(fingerprintSnapshot);
-              _context4.p = 19;
+              _context4.p = 20;
               _iterator4.s();
-            case 20:
+            case 21:
               if ((_step4 = _iterator4.n()).done) {
-                _context4.n = 25;
+                _context4.n = 26;
                 break;
               }
               fingerprint = _step4.value;
-              _context4.p = 21;
-              _context4.n = 22;
+              _context4.p = 22;
+              _context4.n = 23;
               return this.RemoveSingleEntity(fingerprint, key, nowISO);
-            case 22:
-              _context4.n = 24;
-              break;
             case 23:
-              _context4.p = 23;
+              _context4.n = 25;
+              break;
+            case 24:
+              _context4.p = 24;
               _t6 = _context4.v;
               LogError("HandleRemoteInvalidateEvent: failed to remove from \"".concat(fingerprint, "\": ").concat(_t6.message));
-            case 24:
-              _context4.n = 20;
-              break;
             case 25:
-              _context4.n = 27;
+              _context4.n = 21;
               break;
             case 26:
-              _context4.p = 26;
-              _t7 = _context4.v;
-              _iterator4.e(_t7);
+              _context4.n = 28;
+              break;
             case 27:
               _context4.p = 27;
-              _iterator4.f();
-              return _context4.f(27);
+              _t7 = _context4.v;
+              _iterator4.e(_t7);
             case 28:
-              return _context4.a(2);
+              _context4.p = 28;
+              _iterator4.f();
+              return _context4.f(28);
             case 29:
+              return _context4.a(2);
+            case 30:
               if (!(action === 'save' && payload !== null && payload !== void 0 && payload.recordData)) {
-                _context4.n = 52;
+                _context4.n = 53;
                 break;
               }
-              _context4.p = 30;
+              _context4.p = 31;
               recordData = JSON.parse(payload.recordData); // Build CompositeKey from record data using entity PK fields
               _key = this.buildCompositeKeyFromRow(recordData, primaryKeys.map(function (pk) {
                 return pk.Name;
@@ -32931,121 +33025,121 @@ var LocalCacheManager = /*#__PURE__*/function (_BaseSingleton) {
               if (!_key.KeyValuePairs.some(function (kv) {
                 return kv.Value == null;
               })) {
-                _context4.n = 31;
+                _context4.n = 32;
                 break;
               }
               return _context4.a(2);
-            case 31:
+            case 32:
               LogStatusVerbose("LocalCacheManager: remote-invalidate (save) for \"".concat(entityName, "\" PK=").concat(_key.ToConcatenatedString(), ", updating ").concat(fingerprints.size, " cached fingerprint(s)"));
               _iterator5 = localCacheManager_createForOfIteratorHelper(fingerprintSnapshot);
-              _context4.p = 32;
+              _context4.p = 33;
               _iterator5.s();
-            case 33:
+            case 34:
               if ((_step5 = _iterator5.n()).done) {
-                _context4.n = 40;
+                _context4.n = 41;
                 break;
               }
               _fingerprint = _step5.value;
-              _context4.p = 34;
+              _context4.p = 35;
               if (this.isFilteredFingerprint(_fingerprint)) {
-                _context4.n = 36;
+                _context4.n = 37;
                 break;
               }
-              _context4.n = 35;
+              _context4.n = 36;
               return this.UpsertSingleEntity(_fingerprint, recordData, _key, nowISO);
-            case 35:
-              _context4.n = 37;
-              break;
             case 36:
-              _context4.n = 37;
-              return this.InvalidateRunViewResult(_fingerprint);
-            case 37:
-              _context4.n = 39;
+              _context4.n = 38;
               break;
+            case 37:
+              _context4.n = 38;
+              return this.InvalidateRunViewResult(_fingerprint);
             case 38:
-              _context4.p = 38;
+              _context4.n = 40;
+              break;
+            case 39:
+              _context4.p = 39;
               _t8 = _context4.v;
               LogError("HandleRemoteInvalidateEvent: failed to update \"".concat(_fingerprint, "\": ").concat(_t8.message));
-            case 39:
-              _context4.n = 33;
-              break;
             case 40:
-              _context4.n = 42;
+              _context4.n = 34;
               break;
             case 41:
-              _context4.p = 41;
-              _t9 = _context4.v;
-              _iterator5.e(_t9);
+              _context4.n = 43;
+              break;
             case 42:
               _context4.p = 42;
-              _iterator5.f();
-              return _context4.f(42);
+              _t9 = _context4.v;
+              _iterator5.e(_t9);
             case 43:
-              _context4.n = 51;
-              break;
+              _context4.p = 43;
+              _iterator5.f();
+              return _context4.f(43);
             case 44:
-              _context4.p = 44;
+              _context4.n = 52;
+              break;
+            case 45:
+              _context4.p = 45;
               _t0 = _context4.v;
               LogError("HandleRemoteInvalidateEvent: failed to parse recordData for \"".concat(entityName, "\": ").concat(_t0.message));
               _iterator6 = localCacheManager_createForOfIteratorHelper(fingerprintSnapshot);
-              _context4.p = 45;
+              _context4.p = 46;
               _iterator6.s();
-            case 46:
+            case 47:
               if ((_step6 = _iterator6.n()).done) {
-                _context4.n = 48;
+                _context4.n = 49;
                 break;
               }
               _fp3 = _step6.value;
-              _context4.n = 47;
+              _context4.n = 48;
               return this.InvalidateRunViewResult(_fp3);
-            case 47:
-              _context4.n = 46;
-              break;
             case 48:
-              _context4.n = 50;
+              _context4.n = 47;
               break;
             case 49:
-              _context4.p = 49;
-              _t1 = _context4.v;
-              _iterator6.e(_t1);
+              _context4.n = 51;
+              break;
             case 50:
               _context4.p = 50;
-              _iterator6.f();
-              return _context4.f(50);
+              _t1 = _context4.v;
+              _iterator6.e(_t1);
             case 51:
-              return _context4.a(2);
+              _context4.p = 51;
+              _iterator6.f();
+              return _context4.f(51);
             case 52:
+              return _context4.a(2);
+            case 53:
               // Fallback: no record data or unrecognized action — invalidate
               LogStatusVerbose("LocalCacheManager: remote-invalidate (".concat(action || 'unknown', ") for \"").concat(entityName, "\", invalidating ").concat(fingerprints.size, " cached fingerprint(s)"));
               _iterator7 = localCacheManager_createForOfIteratorHelper(fingerprintSnapshot);
-              _context4.p = 53;
+              _context4.p = 54;
               _iterator7.s();
-            case 54:
+            case 55:
               if ((_step7 = _iterator7.n()).done) {
-                _context4.n = 56;
+                _context4.n = 57;
                 break;
               }
               _fp4 = _step7.value;
-              _context4.n = 55;
+              _context4.n = 56;
               return this.InvalidateRunViewResult(_fp4);
-            case 55:
-              _context4.n = 54;
-              break;
             case 56:
-              _context4.n = 58;
+              _context4.n = 55;
               break;
             case 57:
-              _context4.p = 57;
-              _t10 = _context4.v;
-              _iterator7.e(_t10);
+              _context4.n = 59;
+              break;
             case 58:
               _context4.p = 58;
-              _iterator7.f();
-              return _context4.f(58);
+              _t10 = _context4.v;
+              _iterator7.e(_t10);
             case 59:
+              _context4.p = 59;
+              _iterator7.f();
+              return _context4.f(59);
+            case 60:
               return _context4.a(2);
           }
-        }, _callee4, this, [[53, 57, 58, 59], [45, 49, 50, 51], [34, 38], [32, 41, 42, 43], [30, 44], [21, 23], [19, 26, 27, 28], [11, 15, 16, 17]]);
+        }, _callee4, this, [[54, 58, 59, 60], [46, 50, 51, 52], [35, 39], [33, 42, 43, 44], [31, 45], [22, 24], [20, 27, 28, 29], [12, 16, 17, 18]]);
       }));
       function HandleRemoteInvalidateEvent(_x5) {
         return _HandleRemoteInvalidateEvent.apply(this, arguments);
@@ -33624,7 +33718,7 @@ var LocalCacheManager = /*#__PURE__*/function (_BaseSingleton) {
     key: "SetRunViewResult",
     value: (function () {
       var _SetRunViewResult = localCacheManager_asyncToGenerator(/*#__PURE__*/localCacheManager_regenerator().m(function _callee1(fingerprint, params, results, maxUpdatedAt, aggregateResults, totalRowCount) {
-        var data, value, sizeBytes, _params$Aggregates$le, _params$Aggregates, _t16;
+        var data, value, sizeBytes, entityName, _params$Aggregates$le, _params$Aggregates, _t16;
         return localCacheManager_regenerator().w(function (_context1) {
           while (1) switch (_context1.p = _context1.n) {
             case 0:
@@ -33646,14 +33740,18 @@ var LocalCacheManager = /*#__PURE__*/function (_BaseSingleton) {
                 data.totalRowCount = totalRowCount;
               }
               value = JSON.stringify(data);
-              sizeBytes = this.estimateSize(value); // Check if we need to evict entries
+              sizeBytes = this.estimateSize(value); // Per-entity memory limit: evict oldest entries for this entity if over budget
+              entityName = params.EntityName || 'Unknown';
               _context1.n = 2;
-              return this.evictIfNeeded(sizeBytes);
+              return this.enforcePerEntityMemoryLimit(entityName, sizeBytes);
             case 2:
-              _context1.p = 2;
               _context1.n = 3;
-              return this._storageProvider.SetItem(fingerprint, value, CacheCategory.RunViewCache);
+              return this.evictIfNeeded(sizeBytes);
             case 3:
+              _context1.p = 3;
+              _context1.n = 4;
+              return this._storageProvider.SetItem(fingerprint, value, CacheCategory.RunViewCache);
+            case 4:
               this.registerEntry({
                 key: fingerprint,
                 type: 'runview',
@@ -33677,16 +33775,16 @@ var LocalCacheManager = /*#__PURE__*/function (_BaseSingleton) {
               // Maintain entity→fingerprint reverse index for universal cache invalidation
               this.addToEntityIndex(fingerprint);
               LogStatusVerbose("LocalCacheManager.SetRunViewResult: Cached ".concat(results.length, " rows for \"").concat(fingerprint.substring(0, 60), "\" (").concat(sizeBytes, " bytes)"));
-              _context1.n = 5;
+              _context1.n = 6;
               break;
-            case 4:
-              _context1.p = 4;
+            case 5:
+              _context1.p = 5;
               _t16 = _context1.v;
               LogError("LocalCacheManager.SetRunViewResult failed: ".concat(_t16));
-            case 5:
+            case 6:
               return _context1.a(2);
           }
-        }, _callee1, this, [[2, 4]]);
+        }, _callee1, this, [[3, 5]]);
       }));
       function SetRunViewResult(_x25, _x26, _x27, _x28, _x29, _x30) {
         return _SetRunViewResult.apply(this, arguments);
@@ -35027,7 +35125,7 @@ var LocalCacheManager = /*#__PURE__*/function (_BaseSingleton) {
     key: "evictIfNeeded",
     value: (function () {
       var _evictIfNeeded = localCacheManager_asyncToGenerator(/*#__PURE__*/localCacheManager_regenerator().m(function _callee29(neededBytes) {
-        var stats, wouldExceedSize, wouldExceedCount, targetFreeBytes, targetFreeCount;
+        var stats, wouldExceedSize, targetFreeBytes;
         return localCacheManager_regenerator().w(function (_context29) {
           while (1) switch (_context29.n) {
             case 0:
@@ -35039,18 +35137,17 @@ var LocalCacheManager = /*#__PURE__*/function (_BaseSingleton) {
             case 1:
               stats = this.GetStats();
               wouldExceedSize = stats.totalSizeBytes + neededBytes > this._config.maxSizeBytes;
-              wouldExceedCount = stats.totalEntries >= this._config.maxEntries;
-              if (!(!wouldExceedSize && !wouldExceedCount)) {
+              if (wouldExceedSize) {
                 _context29.n = 2;
                 break;
               }
               return _context29.a(2);
             case 2:
-              // Calculate how much to free
-              targetFreeBytes = Math.max(neededBytes, this._config.maxSizeBytes * 0.1); // At least 10% of max
-              targetFreeCount = Math.max(1, Math.floor(this._config.maxEntries * 0.1)); // At least 10% of max
+              // Calculate how much to free — at least the incoming entry's size, but
+              // free 10% of total budget to avoid thrashing on every store.
+              targetFreeBytes = Math.max(neededBytes, this._config.maxSizeBytes * 0.1);
               _context29.n = 3;
-              return this.evict(targetFreeBytes, targetFreeCount);
+              return this.evict(targetFreeBytes);
             case 3:
               return _context29.a(2);
           }
@@ -35068,8 +35165,8 @@ var LocalCacheManager = /*#__PURE__*/function (_BaseSingleton) {
   }, {
     key: "evict",
     value: (function () {
-      var _evict = localCacheManager_asyncToGenerator(/*#__PURE__*/localCacheManager_regenerator().m(function _callee30(targetBytes, targetCount) {
-        var entries, freedBytes, freedCount, toDelete, _iterator20, _step20, _entry, _i5, _toDelete, key, entry, category, _t33, _t34, _t35;
+      var _evict = localCacheManager_asyncToGenerator(/*#__PURE__*/localCacheManager_regenerator().m(function _callee30(targetBytes) {
+        var entries, freedBytes, toDelete, _iterator20, _step20, _entry, _i5, _toDelete, key, entry, category, _t33, _t34, _t35;
         return localCacheManager_regenerator().w(function (_context30) {
           while (1) switch (_context30.p = _context30.n) {
             case 0:
@@ -35100,7 +35197,6 @@ var LocalCacheManager = /*#__PURE__*/function (_BaseSingleton) {
               return _context30.a(3, 5);
             case 5:
               freedBytes = 0;
-              freedCount = 0;
               toDelete = [];
               _iterator20 = localCacheManager_createForOfIteratorHelper(entries);
               _context30.p = 6;
@@ -35111,7 +35207,7 @@ var LocalCacheManager = /*#__PURE__*/function (_BaseSingleton) {
                 break;
               }
               _entry = _step20.value;
-              if (!(freedBytes >= targetBytes && freedCount >= targetCount)) {
+              if (!(freedBytes >= targetBytes)) {
                 _context30.n = 8;
                 break;
               }
@@ -35119,7 +35215,6 @@ var LocalCacheManager = /*#__PURE__*/function (_BaseSingleton) {
             case 8:
               toDelete.push(_entry.key);
               freedBytes += _entry.sizeBytes;
-              freedCount++;
             case 9:
               _context30.n = 7;
               break;
@@ -35185,10 +35280,282 @@ var LocalCacheManager = /*#__PURE__*/function (_BaseSingleton) {
           }
         }, _callee30, this, [[15, 18], [6, 11, 12, 13]]);
       }));
-      function evict(_x67, _x68) {
+      function evict(_x67) {
         return _evict.apply(this, arguments);
       }
       return evict;
+    }()
+    /**
+     * Returns the memory limit in bytes for a given entity based on
+     * maxPercentOfCachePerEntity. Returns 0 if no limit applies.
+     */
+    )
+  }, {
+    key: "getEntityMemoryLimitBytes",
+    value: function getEntityMemoryLimitBytes() {
+      var pct = this._config.maxPercentOfCachePerEntity;
+      if (pct <= 0) return 0;
+      return Math.floor(this._config.maxSizeBytes * pct / 100);
+    }
+    /**
+     * Enforces per-entity memory limits. When an entity's total cached bytes
+     * (including the incoming entry) would exceed its limit, evicts the
+     * least-recently-accessed entries for that entity until under the limit.
+     * @param incomingSizeBytes - estimated size of the entry about to be stored
+     */
+  }, {
+    key: "enforcePerEntityMemoryLimit",
+    value: (function () {
+      var _enforcePerEntityMemoryLimit = localCacheManager_asyncToGenerator(/*#__PURE__*/localCacheManager_regenerator().m(function _callee31(entityName, incomingSizeBytes) {
+        var _this7 = this;
+        var limitBytes, fingerprints, entries, totalBytes, bytesToFree, _iterator21, _step21, entry, category, _t36, _t37;
+        return localCacheManager_regenerator().w(function (_context31) {
+          while (1) switch (_context31.p = _context31.n) {
+            case 0:
+              limitBytes = this.getEntityMemoryLimitBytes();
+              if (!(limitBytes <= 0 || !this._storageProvider)) {
+                _context31.n = 1;
+                break;
+              }
+              return _context31.a(2);
+            case 1:
+              fingerprints = this._entityFingerprintIndex.get(entityName);
+              if (!(!fingerprints || fingerprints.size === 0)) {
+                _context31.n = 2;
+                break;
+              }
+              return _context31.a(2);
+            case 2:
+              // Sum up total bytes for this entity, including the incoming entry
+              entries = localCacheManager_toConsumableArray(fingerprints).map(function (fp) {
+                return _this7._registry.get(fp);
+              }).filter(function (e) {
+                return !!e;
+              });
+              totalBytes = entries.reduce(function (sum, e) {
+                return sum + e.sizeBytes;
+              }, 0) + incomingSizeBytes;
+              if (!(totalBytes <= limitBytes)) {
+                _context31.n = 3;
+                break;
+              }
+              return _context31.a(2);
+            case 3:
+              // Sort by lastAccessedAt ascending (LRU first)
+              entries.sort(function (a, b) {
+                return a.lastAccessedAt - b.lastAccessedAt;
+              });
+              bytesToFree = totalBytes - limitBytes;
+              if (this._config.verboseLogging) {
+                LogStatusEx({
+                  message: "    \uD83D\uDDD1\uFE0F [Cache PER-ENTITY EVICT] Entity \"".concat(entityName, "\" using ").concat((totalBytes / 1024 / 1024).toFixed(1), "MB (limit: ").concat((limitBytes / 1024 / 1024).toFixed(1), "MB), evicting LRU entries"),
+                  verboseOnly: true
+                });
+              }
+              _iterator21 = localCacheManager_createForOfIteratorHelper(entries);
+              _context31.p = 4;
+              _iterator21.s();
+            case 5:
+              if ((_step21 = _iterator21.n()).done) {
+                _context31.n = 10;
+                break;
+              }
+              entry = _step21.value;
+              if (!(bytesToFree <= 0)) {
+                _context31.n = 6;
+                break;
+              }
+              return _context31.a(3, 10);
+            case 6:
+              _context31.p = 6;
+              category = this.getCategoryForType(entry.type);
+              _context31.n = 7;
+              return this._storageProvider.Remove(entry.key, category);
+            case 7:
+              this.removeFromEntityIndex(entry.key);
+              bytesToFree -= entry.sizeBytes;
+              this._registry.delete(entry.key);
+              _context31.n = 9;
+              break;
+            case 8:
+              _context31.p = 8;
+              _t36 = _context31.v;
+            case 9:
+              _context31.n = 5;
+              break;
+            case 10:
+              _context31.n = 12;
+              break;
+            case 11:
+              _context31.p = 11;
+              _t37 = _context31.v;
+              _iterator21.e(_t37);
+            case 12:
+              _context31.p = 12;
+              _iterator21.f();
+              return _context31.f(12);
+            case 13:
+              this.debouncedPersistRegistry();
+            case 14:
+              return _context31.a(2);
+          }
+        }, _callee31, this, [[6, 8], [4, 11, 12, 13]]);
+      }));
+      function enforcePerEntityMemoryLimit(_x68, _x69) {
+        return _enforcePerEntityMemoryLimit.apply(this, arguments);
+      }
+      return enforcePerEntityMemoryLimit;
+    }()
+    /**
+     * Starts the periodic eviction sweep timer. Called during initialization.
+     * The sweep catches entries that should have been evicted (TTL expired)
+     * but weren't because no new stores triggered eviction.
+     */
+    )
+  }, {
+    key: "startEvictionSweep",
+    value: function startEvictionSweep() {
+      var _this8 = this;
+      this.stopEvictionSweep(); // Clear any existing timer
+      var intervalMs = this._config.evictionSweepIntervalMs;
+      if (intervalMs <= 0) return; // Disabled
+      this._sweepTimer = setInterval(function () {
+        _this8.runEvictionSweep().catch(function (err) {
+          LogError("LocalCacheManager: eviction sweep failed: ".concat(err.message));
+        });
+      }, intervalMs);
+      // Don't prevent Node.js process from exiting
+      if (localCacheManager_typeof(this._sweepTimer) === 'object' && 'unref' in this._sweepTimer) {
+        this._sweepTimer.unref();
+      }
+    }
+    /**
+     * Stops the periodic eviction sweep timer.
+     */
+  }, {
+    key: "stopEvictionSweep",
+    value: function stopEvictionSweep() {
+      if (this._sweepTimer) {
+        clearInterval(this._sweepTimer);
+        this._sweepTimer = null;
+      }
+    }
+    /**
+     * Runs a single eviction sweep: evicts entries that have exceeded their TTL
+     * or entries for entities that are over their per-entity cap.
+     */
+  }, {
+    key: "runEvictionSweep",
+    value: (function () {
+      var _runEvictionSweep = localCacheManager_asyncToGenerator(/*#__PURE__*/localCacheManager_regenerator().m(function _callee32() {
+        var now, ttlMs, toDelete, _iterator22, _step22, _step22$value, _key4, _entry2, _iterator23, _step23, key, entry, category, _t38, _t39, _t40;
+        return localCacheManager_regenerator().w(function (_context32) {
+          while (1) switch (_context32.p = _context32.n) {
+            case 0:
+              if (!(!this._storageProvider || !this._config.enabled)) {
+                _context32.n = 1;
+                break;
+              }
+              return _context32.a(2);
+            case 1:
+              now = Date.now();
+              ttlMs = this._config.defaultTTLMs;
+              toDelete = [];
+              _iterator22 = localCacheManager_createForOfIteratorHelper(this._registry);
+              _context32.p = 2;
+              _iterator22.s();
+            case 3:
+              if ((_step22 = _iterator22.n()).done) {
+                _context32.n = 6;
+                break;
+              }
+              _step22$value = localCacheManager_slicedToArray(_step22.value, 2), _key4 = _step22$value[0], _entry2 = _step22$value[1];
+              if (!(ttlMs > 0 && _entry2.cachedAt + ttlMs < now)) {
+                _context32.n = 4;
+                break;
+              }
+              toDelete.push(_key4);
+              return _context32.a(3, 5);
+            case 4:
+              // expiresAt check (if set individually)
+              if (_entry2.expiresAt && _entry2.expiresAt < now) {
+                toDelete.push(_key4);
+              }
+            case 5:
+              _context32.n = 3;
+              break;
+            case 6:
+              _context32.n = 8;
+              break;
+            case 7:
+              _context32.p = 7;
+              _t38 = _context32.v;
+              _iterator22.e(_t38);
+            case 8:
+              _context32.p = 8;
+              _iterator22.f();
+              return _context32.f(8);
+            case 9:
+              if (!(toDelete.length > 0)) {
+                _context32.n = 20;
+                break;
+              }
+              if (this._config.verboseLogging) {
+                LogStatusEx({
+                  message: "    \uD83D\uDDD1\uFE0F [Cache SWEEP] Evicting ".concat(toDelete.length, " TTL-expired entries"),
+                  verboseOnly: true
+                });
+              }
+              _iterator23 = localCacheManager_createForOfIteratorHelper(toDelete);
+              _context32.p = 10;
+              _iterator23.s();
+            case 11:
+              if ((_step23 = _iterator23.n()).done) {
+                _context32.n = 16;
+                break;
+              }
+              key = _step23.value;
+              _context32.p = 12;
+              entry = this._registry.get(key);
+              category = this.getCategoryForType(entry === null || entry === void 0 ? void 0 : entry.type);
+              _context32.n = 13;
+              return this._storageProvider.Remove(key, category);
+            case 13:
+              if (entry !== null && entry !== void 0 && entry.fingerprint) {
+                this.removeFromEntityIndex(entry.fingerprint);
+              }
+              this._registry.delete(key);
+              _context32.n = 15;
+              break;
+            case 14:
+              _context32.p = 14;
+              _t39 = _context32.v;
+            case 15:
+              _context32.n = 11;
+              break;
+            case 16:
+              _context32.n = 18;
+              break;
+            case 17:
+              _context32.p = 17;
+              _t40 = _context32.v;
+              _iterator23.e(_t40);
+            case 18:
+              _context32.p = 18;
+              _iterator23.f();
+              return _context32.f(18);
+            case 19:
+              _context32.n = 20;
+              return this.persistRegistry();
+            case 20:
+              return _context32.a(2);
+          }
+        }, _callee32, this, [[12, 14], [10, 17, 18, 19], [2, 7, 8, 9]]);
+      }));
+      function runEvictionSweep() {
+        return _runEvictionSweep.apply(this, arguments);
+      }
+      return runEvictionSweep;
     }())
   }], [{
     key: "Instance",
@@ -39408,6 +39775,9 @@ var ProviderBase = /*#__PURE__*/function () {
       if (!params.EntityName) return true; // View-based queries without entity name — allow caching
       var entity = this.EntityByName(params.EntityName);
       if (!entity) return true; // Entity not found — allow caching (will fail later anyway)
+      // If caching is disabled for this entity (neither the per-entity flag nor the
+      // schema-level config enables it), skip all cache operations.
+      if (!LocalCacheManager.Instance.IsCachingEnabledForEntity(entity)) return false;
       // Always exempt Record Changes — rows are created via spCreateRecordChange_Internal
       // inside save SQL batches, never through BaseEntity.Save(), so the cache is never
       // invalidated by entity events. Even if TrustServerCacheCompletely is accidentally
@@ -54123,7 +54493,7 @@ function _regenerator(){/*! regenerator-runtime -- Copyright (c) 2014-present, F
  * zod schema definition for the entity MJ: Encryption Keys
  */var MJEncryptionKeySchema=z.object({ID:z.string().describe("\n        * * Field Name: ID\n        * * Display Name: ID\n        * * SQL Data Type: uniqueidentifier\n        * * Default Value: newsequentialid()\n        * * Description: Unique identifier for the encryption key configuration."),Name:z.string().describe("\n        * * Field Name: Name\n        * * Display Name: Name\n        * * SQL Data Type: nvarchar(100)\n        * * Description: Unique name for this key (e.g., PII Master Key, API Secrets Key)."),Description:z.string().nullable().describe("\n        * * Field Name: Description\n        * * Display Name: Description\n        * * SQL Data Type: nvarchar(MAX)\n        * * Description: Description of this key purpose and scope."),EncryptionKeySourceID:z.string().describe("\n        * * Field Name: EncryptionKeySourceID\n        * * Display Name: Encryption Key Source ID\n        * * SQL Data Type: uniqueidentifier\n        * * Related Entity/Foreign Key: MJ: Encryption Key Sources (vwEncryptionKeySources.ID)\n        * * Description: References the key source that provides the key material."),EncryptionAlgorithmID:z.string().describe("\n        * * Field Name: EncryptionAlgorithmID\n        * * Display Name: Encryption Algorithm ID\n        * * SQL Data Type: uniqueidentifier\n        * * Related Entity/Foreign Key: MJ: Encryption Algorithms (vwEncryptionAlgorithms.ID)\n        * * Description: References the algorithm to use for encryption/decryption."),KeyLookupValue:z.string().describe("\n        * * Field Name: KeyLookupValue\n        * * Display Name: Key Lookup Value\n        * * SQL Data Type: nvarchar(500)\n        * * Description: Source-specific lookup value (e.g., environment variable name, vault path)."),KeyVersion:z.string().describe("\n        * * Field Name: KeyVersion\n        * * Display Name: Key Version\n        * * SQL Data Type: nvarchar(20)\n        * * Default Value: 1\n        * * Description: Version string for key rotation tracking. Incremented during rotation."),Marker:z.string().describe("\n        * * Field Name: Marker\n        * * Display Name: Marker\n        * * SQL Data Type: nvarchar(20)\n        * * Default Value: $ENC$\n        * * Description: Prefix marker for encrypted values (default: $ENC$)."),IsActive:z.boolean().describe("\n        * * Field Name: IsActive\n        * * Display Name: Is Active\n        * * SQL Data Type: bit\n        * * Default Value: 1\n        * * Description: Whether this key can be used for new encryption operations."),Status:z.union([z.literal('Active'),z.literal('Expired'),z.literal('Inactive'),z.literal('Rotating')]).describe("\n        * * Field Name: Status\n        * * Display Name: Status\n        * * SQL Data Type: nvarchar(20)\n        * * Default Value: Active\n    * * Value List Type: List\n    * * Possible Values \n    *   * Active\n    *   * Expired\n    *   * Inactive\n    *   * Rotating\n        * * Description: Current status: Active, Inactive, Rotating, or Expired."),ActivatedAt:z.date().nullable().describe("\n        * * Field Name: ActivatedAt\n        * * Display Name: Activated At\n        * * SQL Data Type: datetimeoffset\n        * * Description: When the current key version was activated."),ExpiresAt:z.date().nullable().describe("\n        * * Field Name: ExpiresAt\n        * * Display Name: Expires At\n        * * SQL Data Type: datetimeoffset\n        * * Description: Optional expiration date. Keys past this date cannot be used for new encryption."),__mj_CreatedAt:z.date().describe("\n        * * Field Name: __mj_CreatedAt\n        * * Display Name: Created At\n        * * SQL Data Type: datetimeoffset\n        * * Default Value: getutcdate()"),__mj_UpdatedAt:z.date().describe("\n        * * Field Name: __mj_UpdatedAt\n        * * Display Name: Updated At\n        * * SQL Data Type: datetimeoffset\n        * * Default Value: getutcdate()"),EncryptionKeySource:z.string().describe("\n        * * Field Name: EncryptionKeySource\n        * * Display Name: Encryption Key Source\n        * * SQL Data Type: nvarchar(100)"),EncryptionAlgorithm:z.string().describe("\n        * * Field Name: EncryptionAlgorithm\n        * * Display Name: Encryption Algorithm\n        * * SQL Data Type: nvarchar(50)")});/**
  * zod schema definition for the entity MJ: Entities
- */var MJEntitySchema=z.object({ID:z.string().describe("\n        * * Field Name: ID\n        * * Display Name: ID\n        * * SQL Data Type: uniqueidentifier\n        * * Default Value: newsequentialid()"),ParentID:z.string().nullable().describe("\n        * * Field Name: ParentID\n        * * Display Name: Parent\n        * * SQL Data Type: uniqueidentifier\n        * * Related Entity/Foreign Key: MJ: Entities (vwEntities.ID)"),Name:z.string().describe("\n        * * Field Name: Name\n        * * Display Name: Name\n        * * SQL Data Type: nvarchar(255)\n        * * Description: The canonical, unique name for this entity. For entities in schemas with an EntityNamePrefix configured (e.g., \"MJ: \" for the core schema), the Name includes the prefix: \"MJ: AI Models\", \"MJ: Users\", etc. This is the value used in GetEntityObject(), RunView({ EntityName }), and @RegisterClass decorators. The DisplayName column provides the shorter, UI-friendly alternative without the prefix."),NameSuffix:z.string().nullable().describe("\n        * * Field Name: NameSuffix\n        * * Display Name: Name Suffix\n        * * SQL Data Type: nvarchar(255)\n        * * Description: Optional suffix appended to entity names for display purposes."),Description:z.string().nullable().describe("\n        * * Field Name: Description\n        * * Display Name: Description\n        * * SQL Data Type: nvarchar(MAX)"),AutoUpdateDescription:z.boolean().describe("\n        * * Field Name: AutoUpdateDescription\n        * * Display Name: Auto Update Description\n        * * SQL Data Type: bit\n        * * Default Value: 1\n        * * Description: When set to 1 (default), whenever a description is modified in the underlying view (first choice) or table (second choice), the Description column in the entity definition will be automatically updated. If you never set metadata in the database directly, you can leave this alone. However, if you have metadata set in the database level for description, and you want to provide a DIFFERENT description in this entity definition, turn this bit off and then set the Description field and future CodeGen runs will NOT override the Description field here."),BaseTable:z.string().describe("\n        * * Field Name: BaseTable\n        * * Display Name: Base Table\n        * * SQL Data Type: nvarchar(255)\n        * * Description: The underlying database table name for this entity."),BaseView:z.string().describe("\n        * * Field Name: BaseView\n        * * Display Name: Base View\n        * * SQL Data Type: nvarchar(255)\n        * * Description: The \"wrapper\" database view used for querying this entity with joins and computed fields."),BaseViewGenerated:z.boolean().describe("\n        * * Field Name: BaseViewGenerated\n        * * Display Name: Base View Generated\n        * * SQL Data Type: bit\n        * * Default Value: 1\n        * * Description: When set to 0, CodeGen no longer generates a base view for the entity."),SchemaName:z.string().describe("\n        * * Field Name: SchemaName\n        * * Display Name: Schema Name\n        * * SQL Data Type: nvarchar(255)\n        * * Default Value: dbo\n        * * Description: Database schema containing this entity's table and view."),VirtualEntity:z.boolean().describe("\n        * * Field Name: VirtualEntity\n        * * Display Name: Virtual Entity\n        * * SQL Data Type: bit\n        * * Default Value: 0\n        * * Description: Indicates if this is a virtual entity without a physical database table."),TrackRecordChanges:z.boolean().describe("\n        * * Field Name: TrackRecordChanges\n        * * Display Name: Track Record Changes\n        * * SQL Data Type: bit\n        * * Default Value: 1\n        * * Description: When set to 1, changes made via the MemberJunction architecture will result in tracking records being created in the RecordChange table. In addition, when turned on CodeGen will ensure that your table has two fields: __mj_CreatedAt and __mj_UpdatedAt which are special fields used in conjunction with the RecordChange table to track changes to rows in your entity."),AuditRecordAccess:z.boolean().describe("\n        * * Field Name: AuditRecordAccess\n        * * Display Name: Audit Record Access\n        * * SQL Data Type: bit\n        * * Default Value: 1\n        * * Description: When set to 1, accessing a record by an end-user will result in an Audit Log record being created"),AuditViewRuns:z.boolean().describe("\n        * * Field Name: AuditViewRuns\n        * * Display Name: Audit View Runs\n        * * SQL Data Type: bit\n        * * Default Value: 1\n        * * Description: When set to 1, users running a view against this entity will result in an Audit Log record being created."),IncludeInAPI:z.boolean().describe("\n        * * Field Name: IncludeInAPI\n        * * Display Name: Include In API\n        * * SQL Data Type: bit\n        * * Default Value: 0\n        * * Description: If set to 0, the entity will not be available at all in the GraphQL API or the object model."),AllowAllRowsAPI:z.boolean().describe("\n        * * Field Name: AllowAllRowsAPI\n        * * Display Name: Allow All Rows API\n        * * SQL Data Type: bit\n        * * Default Value: 0\n        * * Description: If set to 1, a GraphQL query will be enabled that allows access to all rows in the entity."),AllowUpdateAPI:z.boolean().describe("\n        * * Field Name: AllowUpdateAPI\n        * * Display Name: Allow Update API\n        * * SQL Data Type: bit\n        * * Default Value: 0\n        * * Description: Global flag controlling if updates are allowed for any user, or not. If set to 1, a GraqhQL mutation and stored procedure are created. Permissions are still required to perform the action but if this flag is set to 0, no user will be able to perform the action."),AllowCreateAPI:z.boolean().describe("\n        * * Field Name: AllowCreateAPI\n        * * Display Name: Allow Create API\n        * * SQL Data Type: bit\n        * * Default Value: 0\n        * * Description: Global flag controlling if creates are allowed for any user, or not. If set to 1, a GraqhQL mutation and stored procedure are created. Permissions are still required to perform the action but if this flag is set to 0, no user will be able to perform the action."),AllowDeleteAPI:z.boolean().describe("\n        * * Field Name: AllowDeleteAPI\n        * * Display Name: Allow Delete API\n        * * SQL Data Type: bit\n        * * Default Value: 0\n        * * Description: Global flag controlling if deletes are allowed for any user, or not. If set to 1, a GraqhQL mutation and stored procedure are created. Permissions are still required to perform the action but if this flag is set to 0, no user will be able to perform the action."),CustomResolverAPI:z.boolean().describe("\n        * * Field Name: CustomResolverAPI\n        * * Display Name: Custom Resolver API\n        * * SQL Data Type: bit\n        * * Default Value: 0\n        * * Description: Set to 1 if a custom resolver has been created for the entity."),AllowUserSearchAPI:z.boolean().describe("\n        * * Field Name: AllowUserSearchAPI\n        * * Display Name: Allow User Search\n        * * SQL Data Type: bit\n        * * Default Value: 0\n        * * Description: Enabling this bit will result in search being possible at the API and UI layers"),FullTextSearchEnabled:z.boolean().describe("\n        * * Field Name: FullTextSearchEnabled\n        * * Display Name: Full-Text Search Enabled\n        * * SQL Data Type: bit\n        * * Default Value: 0\n        * * Description: Whether full-text search indexing is enabled for this entity."),FullTextCatalog:z.string().nullable().describe("\n        * * Field Name: FullTextCatalog\n        * * Display Name: Full-Text Catalog\n        * * SQL Data Type: nvarchar(255)\n        * * Description: Name of the SQL Server full-text catalog if search is enabled."),FullTextCatalogGenerated:z.boolean().describe("\n        * * Field Name: FullTextCatalogGenerated\n        * * Display Name: Full-Text Catalog Generated\n        * * SQL Data Type: bit\n        * * Default Value: 1\n        * * Description: Indicates if the full-text catalog was auto-generated by CodeGen."),FullTextIndex:z.string().nullable().describe("\n        * * Field Name: FullTextIndex\n        * * Display Name: Full-Text Index\n        * * SQL Data Type: nvarchar(255)\n        * * Description: Name of the full-text index on this entity's table."),FullTextIndexGenerated:z.boolean().describe("\n        * * Field Name: FullTextIndexGenerated\n        * * Display Name: Full-Text Index Generated\n        * * SQL Data Type: bit\n        * * Default Value: 1\n        * * Description: Indicates if the full-text index was auto-generated by CodeGen."),FullTextSearchFunction:z.string().nullable().describe("\n        * * Field Name: FullTextSearchFunction\n        * * Display Name: Search Function\n        * * SQL Data Type: nvarchar(255)\n        * * Description: Name of the function used for full-text searching this entity."),FullTextSearchFunctionGenerated:z.boolean().describe("\n        * * Field Name: FullTextSearchFunctionGenerated\n        * * Display Name: Search Function Generated\n        * * SQL Data Type: bit\n        * * Default Value: 1\n        * * Description: Indicates if the search function was auto-generated by CodeGen."),UserViewMaxRows:z.number().nullable().describe("\n        * * Field Name: UserViewMaxRows\n        * * Display Name: User View Max Rows\n        * * SQL Data Type: int\n        * * Default Value: 1000\n        * * Description: Maximum number of rows to return in user-created views for this entity."),spCreate:z.string().nullable().describe("\n        * * Field Name: spCreate\n        * * Display Name: Create Procedure\n        * * SQL Data Type: nvarchar(255)\n        * * Description: Name of the stored procedure for creating records in this entity."),spUpdate:z.string().nullable().describe("\n        * * Field Name: spUpdate\n        * * Display Name: Update Procedure\n        * * SQL Data Type: nvarchar(255)\n        * * Description: Name of the stored procedure for updating records in this entity."),spDelete:z.string().nullable().describe("\n        * * Field Name: spDelete\n        * * Display Name: Delete Procedure\n        * * SQL Data Type: nvarchar(255)\n        * * Description: Name of the stored procedure for deleting records in this entity."),spCreateGenerated:z.boolean().describe("\n        * * Field Name: spCreateGenerated\n        * * Display Name: Create SP Generated\n        * * SQL Data Type: bit\n        * * Default Value: 1\n        * * Description: Indicates if the create procedure was auto-generated by CodeGen."),spUpdateGenerated:z.boolean().describe("\n        * * Field Name: spUpdateGenerated\n        * * Display Name: Update SP Generated\n        * * SQL Data Type: bit\n        * * Default Value: 1\n        * * Description: Indicates if the update procedure was auto-generated by CodeGen."),spDeleteGenerated:z.boolean().describe("\n        * * Field Name: spDeleteGenerated\n        * * Display Name: Delete SP Generated\n        * * SQL Data Type: bit\n        * * Default Value: 1\n        * * Description: Indicates if the delete procedure was auto-generated by CodeGen."),CascadeDeletes:z.boolean().describe("\n        * * Field Name: CascadeDeletes\n        * * Display Name: Cascade Deletes\n        * * SQL Data Type: bit\n        * * Default Value: 0\n        * * Description: When set to 1, the deleted spDelete will pre-process deletion to related entities that have 1:M cardinality with this entity. This does not have effect if spDeleteGenerated = 0"),DeleteType:z.union([z.literal('Hard'),z.literal('Soft')]).describe("\n        * * Field Name: DeleteType\n        * * Display Name: Delete Type\n        * * SQL Data Type: nvarchar(10)\n        * * Default Value: Hard\n    * * Value List Type: List\n    * * Possible Values \n    *   * Hard\n    *   * Soft\n        * * Description: Hard deletes physically remove rows from the underlying BaseTable. Soft deletes do not remove rows but instead mark the row as deleted by using the special field __mj_DeletedAt which will automatically be added to the entity's basetable by the CodeGen tool."),AllowRecordMerge:z.boolean().describe("\n        * * Field Name: AllowRecordMerge\n        * * Display Name: Allow Record Merge\n        * * SQL Data Type: bit\n        * * Default Value: 0\n        * * Description: This field must be turned on in order to enable merging of records for the entity. For AllowRecordMerge to be turned on, AllowDeleteAPI must be set to 1, and DeleteType must be set to Soft"),spMatch:z.string().nullable().describe("\n        * * Field Name: spMatch\n        * * Display Name: Match Procedure\n        * * SQL Data Type: nvarchar(255)\n        * * Description: When specified, this stored procedure is used to find matching records in this particular entity. The convention is to pass in the primary key(s) columns for the given entity to the procedure and the return will be zero to many rows where there is a column for each primary key field(s) and a ProbabilityScore (numeric(1,12)) column that has a 0 to 1 value of the probability of a match."),RelationshipDefaultDisplayType:z.union([z.literal('Dropdown'),z.literal('Search')]).describe("\n        * * Field Name: RelationshipDefaultDisplayType\n        * * Display Name: Default Relationship Display Type\n        * * SQL Data Type: nvarchar(20)\n        * * Default Value: Search\n    * * Value List Type: List\n    * * Possible Values \n    *   * Dropdown\n    *   * Search\n        * * Description: When another entity links to this entity with a foreign key, this is the default component type that will be used in the UI. CodeGen will populate the RelatedEntityDisplayType column in the Entity Fields entity with whatever is provided here whenever a new foreign key is detected by CodeGen. The selection can be overridden on a per-foreign-key basis in each row of the Entity Fields entity."),UserFormGenerated:z.boolean().describe("\n        * * Field Name: UserFormGenerated\n        * * Display Name: User Form Generated\n        * * SQL Data Type: bit\n        * * Default Value: 1\n        * * Description: Indicates if the default user form was auto-generated for this entity."),EntityObjectSubclassName:z.string().nullable().describe("\n        * * Field Name: EntityObjectSubclassName\n        * * Display Name: Subclass Name\n        * * SQL Data Type: nvarchar(255)\n        * * Description: TypeScript class name for the entity subclass in the codebase."),EntityObjectSubclassImport:z.string().nullable().describe("\n        * * Field Name: EntityObjectSubclassImport\n        * * Display Name: Subclass Import Path\n        * * SQL Data Type: nvarchar(255)\n        * * Description: Import path for the entity subclass in the TypeScript codebase."),PreferredCommunicationField:z.string().nullable().describe("\n        * * Field Name: PreferredCommunicationField\n        * * Display Name: Preferred Communication Field\n        * * SQL Data Type: nvarchar(255)\n        * * Description: Used to specify a field within the entity that in turn contains the field name that will be used for record-level communication preferences. For example in a hypothetical entity called Contacts, say there is a field called PreferredComm and that field had possible values of Email1, SMS, and Phone, and those value in turn corresponded to field names in the entity. Each record in the Contacts entity could have a specific preference for which field would be used for communication. The MJ Communication Framework will use this information when available, as a priority ahead of the data in the Entity Communication Fields entity which is entity-level and not record-level."),Icon:z.string().nullable().describe("\n        * * Field Name: Icon\n        * * Display Name: Icon\n        * * SQL Data Type: nvarchar(500)\n        * * Description: Optional, specify an icon (CSS Class) for each entity for display in the UI"),__mj_CreatedAt:z.date().describe("\n        * * Field Name: __mj_CreatedAt\n        * * Display Name: Created At\n        * * SQL Data Type: datetimeoffset\n        * * Default Value: getutcdate()"),__mj_UpdatedAt:z.date().describe("\n        * * Field Name: __mj_UpdatedAt\n        * * Display Name: Updated At\n        * * SQL Data Type: datetimeoffset\n        * * Default Value: getutcdate()"),ScopeDefault:z.string().nullable().describe("\n        * * Field Name: ScopeDefault\n        * * Display Name: Default Scope\n        * * SQL Data Type: nvarchar(100)\n        * * Description: Optional, comma-delimited string indicating the default scope for entity visibility. Options include Users, Admins, AI, and All. Defaults to All when NULL. This is used for simple defaults for filtering entity visibility, not security enforcement."),RowsToPackWithSchema:z.union([z.literal('All'),z.literal('None'),z.literal('Sample')]).describe("\n        * * Field Name: RowsToPackWithSchema\n        * * Display Name: Rows To Pack\n        * * SQL Data Type: nvarchar(20)\n        * * Default Value: None\n    * * Value List Type: List\n    * * Possible Values \n    *   * All\n    *   * None\n    *   * Sample\n        * * Description: Determines how entity rows should be packaged for external use. Options include None, Sample, and All. Defaults to None."),RowsToPackSampleMethod:z.union([z.literal('bottom n'),z.literal('random'),z.literal('top n')]).describe("\n        * * Field Name: RowsToPackSampleMethod\n        * * Display Name: Packing Sample Method\n        * * SQL Data Type: nvarchar(20)\n        * * Default Value: random\n    * * Value List Type: List\n    * * Possible Values \n    *   * bottom n\n    *   * random\n    *   * top n\n        * * Description: Defines the sampling method for row packing when RowsToPackWithSchema is set to Sample. Options include random, top n, and bottom n. Defaults to random."),RowsToPackSampleCount:z.number().describe("\n        * * Field Name: RowsToPackSampleCount\n        * * Display Name: Packing Sample Count\n        * * SQL Data Type: int\n        * * Default Value: 0\n        * * Description: The number of rows to pack when RowsToPackWithSchema is set to Sample, based on the designated sampling method. Defaults to 0."),RowsToPackSampleOrder:z.string().nullable().describe("\n        * * Field Name: RowsToPackSampleOrder\n        * * Display Name: Packing Sample Order\n        * * SQL Data Type: nvarchar(MAX)\n        * * Description: An optional ORDER BY clause for row packing when RowsToPackWithSchema is set to Sample. Allows custom ordering for selected entity data when using top n and bottom n."),AutoRowCountFrequency:z.number().nullable().describe("\n        * * Field Name: AutoRowCountFrequency\n        * * Display Name: Refresh Frequency (Hours)\n        * * SQL Data Type: int\n        * * Description: Frequency in hours for automatically performing row counts on this entity. If NULL, automatic row counting is disabled. If greater than 0, schedules recurring SELECT COUNT(*) queries at the specified interval."),RowCount:z.number().nullable().describe("\n        * * Field Name: RowCount\n        * * Display Name: Row Count\n        * * SQL Data Type: bigint\n        * * Description: Cached row count for this entity, populated by automatic row count processes when AutoRowCountFrequency is configured."),RowCountRunAt:z.date().nullable().describe("\n        * * Field Name: RowCountRunAt\n        * * Display Name: Last Counted At\n        * * SQL Data Type: datetimeoffset\n        * * Description: Timestamp indicating when the last automatic row count was performed for this entity."),Status:z.union([z.literal('Active'),z.literal('Deprecated'),z.literal('Disabled')]).describe("\n        * * Field Name: Status\n        * * Display Name: Status\n        * * SQL Data Type: nvarchar(25)\n        * * Default Value: Active\n    * * Value List Type: List\n    * * Possible Values \n    *   * Active\n    *   * Deprecated\n    *   * Disabled\n        * * Description: Status of the entity. Active: fully functional; Deprecated: functional but generates console warnings when used; Disabled: not available for use even though metadata and physical table remain."),DisplayName:z.string().nullable().describe("\n        * * Field Name: DisplayName\n        * * Display Name: Display Name\n        * * SQL Data Type: nvarchar(255)\n        * * Description: User-friendly display name shown in the Explorer UI and other interfaces. When set, this is used instead of the entity Name for display purposes. Typically contains the entity name without the schema prefix \u2014 e.g., \"AI Models\" when Name is \"MJ: AI Models\". If NULL, the UI falls back to using the full Name."),AllowMultipleSubtypes:z.boolean().describe("\n        * * Field Name: AllowMultipleSubtypes\n        * * Display Name: Allow Multiple Subtypes\n        * * SQL Data Type: bit\n        * * Default Value: 0\n        * * Description: When false (default), child types are disjoint - a record can only be one child type at a time. When true, a record can simultaneously exist as multiple child types (e.g., a Person can be both a Member and a Volunteer)."),AutoUpdateFullTextSearch:z.boolean().describe("\n        * * Field Name: AutoUpdateFullTextSearch\n        * * Display Name: Auto Update Search Settings\n        * * SQL Data Type: bit\n        * * Default Value: 1\n        * * Description: When true, CodeGen LLM can auto-configure full-text search settings (FullTextSearchEnabled, catalog, index, function) during code generation runs."),AutoUpdateAllowUserSearchAPI:z.boolean().describe("\n        * * Field Name: AutoUpdateAllowUserSearchAPI\n        * * Display Name: Auto Update Search API\n        * * SQL Data Type: bit\n        * * Default Value: 1\n        * * Description: When true, CodeGen LLM can auto-set AllowUserSearchAPI during code generation runs."),TrustServerCacheCompletely:z.boolean().describe("\n        * * Field Name: TrustServerCacheCompletely\n        * * Display Name: Trust Server Cache\n        * * SQL Data Type: bit\n        * * Default Value: 1\n        * * Description: When true (default), the server-side RunView cache will store and return cached results for this entity, trusting that all mutations flow through BaseEntity.Save() which fires cache invalidation events. Set to false for entities whose rows are created as side-effects of other operations via raw SQL (e.g., Record Changes created by spCreateRecordChange_Internal), since those inserts bypass BaseEntity and never trigger cache invalidation."),SupportsGeoCoding:z.boolean().describe("\n        * * Field Name: SupportsGeoCoding\n        * * Display Name: Supports Geo-Coding\n        * * SQL Data Type: bit\n        * * Default Value: 0\n        * * Description: When true, CodeGen generates geo-aware subclass code, adds __mj_Latitude/__mj_Longitude virtual fields to the base view, and the UI shows a map view toggle. Auto-set by CodeGen when LLM detects geo-capable fields (address, lat/lng, etc.)."),AutoUpdateSupportsGeoCoding:z.boolean().describe("\n        * * Field Name: AutoUpdateSupportsGeoCoding\n        * * Display Name: Auto Update Geo-Coding\n        * * SQL Data Type: bit\n        * * Default Value: 1\n        * * Description: When true (default), CodeGen can automatically set SupportsGeoCoding based on LLM analysis of entity fields. Set to 0 to lock the value and prevent CodeGen from changing it."),CodeName:z.string().nullable().describe("\n        * * Field Name: CodeName\n        * * Display Name: Code Name\n        * * SQL Data Type: nvarchar(MAX)\n        * * Description: Schema-based programmatic code name derived from the entity Name. Uses GetClassNameSchemaPrefix(SchemaName) as the prefix, then strips EntityNamePrefix from the Name and removes spaces. For \"__mj\" schema with entity \"MJ: AI Models\", this produces \"MJAIModels\". For entities in other schemas, the sanitized schema name is prepended. Used in GraphQL type generation and internal code references."),ClassName:z.string().nullable().describe("\n        * * Field Name: ClassName\n        * * Display Name: Class Name\n        * * SQL Data Type: nvarchar(MAX)\n        * * Description: Schema-based programmatic class name used for TypeScript entity classes, Zod schemas, and Angular form components. Computed as GetProgrammaticName(GetClassNameSchemaPrefix(SchemaName) + BaseTable + NameSuffix). The prefix is derived from SchemaName (guaranteed unique by SQL Server), not from EntityNamePrefix. For the core __mj schema, the prefix is \"MJ\"; for all other schemas it is the alphanumeric-sanitized schema name. This prevents cross-schema collisions and aligns with GraphQL type naming in getGraphQLTypeNameBase()."),BaseTableCodeName:z.string().nullable().describe("\n        * * Field Name: BaseTableCodeName\n        * * Display Name: Base Table Code Name\n        * * SQL Data Type: nvarchar(MAX)"),ParentEntity:z.string().nullable().describe("\n        * * Field Name: ParentEntity\n        * * Display Name: Parent Entity\n        * * SQL Data Type: nvarchar(255)"),ParentBaseTable:z.string().nullable().describe("\n        * * Field Name: ParentBaseTable\n        * * Display Name: Parent Base Table\n        * * SQL Data Type: nvarchar(255)"),ParentBaseView:z.string().nullable().describe("\n        * * Field Name: ParentBaseView\n        * * Display Name: Parent Base View\n        * * SQL Data Type: nvarchar(255)")});/**
+ */var MJEntitySchema=z.object({ID:z.string().describe("\n        * * Field Name: ID\n        * * Display Name: ID\n        * * SQL Data Type: uniqueidentifier\n        * * Default Value: newsequentialid()"),ParentID:z.string().nullable().describe("\n        * * Field Name: ParentID\n        * * Display Name: Parent\n        * * SQL Data Type: uniqueidentifier\n        * * Related Entity/Foreign Key: MJ: Entities (vwEntities.ID)"),Name:z.string().describe("\n        * * Field Name: Name\n        * * Display Name: Name\n        * * SQL Data Type: nvarchar(255)\n        * * Description: The canonical, unique name for this entity. For entities in schemas with an EntityNamePrefix configured (e.g., \"MJ: \" for the core schema), the Name includes the prefix: \"MJ: AI Models\", \"MJ: Users\", etc. This is the value used in GetEntityObject(), RunView({ EntityName }), and @RegisterClass decorators. The DisplayName column provides the shorter, UI-friendly alternative without the prefix."),NameSuffix:z.string().nullable().describe("\n        * * Field Name: NameSuffix\n        * * Display Name: Name Suffix\n        * * SQL Data Type: nvarchar(255)\n        * * Description: Optional suffix appended to entity names for display purposes."),Description:z.string().nullable().describe("\n        * * Field Name: Description\n        * * Display Name: Description\n        * * SQL Data Type: nvarchar(MAX)"),AutoUpdateDescription:z.boolean().describe("\n        * * Field Name: AutoUpdateDescription\n        * * Display Name: Auto Update Description\n        * * SQL Data Type: bit\n        * * Default Value: 1\n        * * Description: When set to 1 (default), whenever a description is modified in the underlying view (first choice) or table (second choice), the Description column in the entity definition will be automatically updated. If you never set metadata in the database directly, you can leave this alone. However, if you have metadata set in the database level for description, and you want to provide a DIFFERENT description in this entity definition, turn this bit off and then set the Description field and future CodeGen runs will NOT override the Description field here."),BaseTable:z.string().describe("\n        * * Field Name: BaseTable\n        * * Display Name: Base Table\n        * * SQL Data Type: nvarchar(255)\n        * * Description: The underlying database table name for this entity."),BaseView:z.string().describe("\n        * * Field Name: BaseView\n        * * Display Name: Base View\n        * * SQL Data Type: nvarchar(255)\n        * * Description: The \"wrapper\" database view used for querying this entity with joins and computed fields."),BaseViewGenerated:z.boolean().describe("\n        * * Field Name: BaseViewGenerated\n        * * Display Name: Base View Generated\n        * * SQL Data Type: bit\n        * * Default Value: 1\n        * * Description: When set to 0, CodeGen no longer generates a base view for the entity."),SchemaName:z.string().describe("\n        * * Field Name: SchemaName\n        * * Display Name: Schema Name\n        * * SQL Data Type: nvarchar(255)\n        * * Default Value: dbo\n        * * Description: Database schema containing this entity's table and view."),VirtualEntity:z.boolean().describe("\n        * * Field Name: VirtualEntity\n        * * Display Name: Virtual Entity\n        * * SQL Data Type: bit\n        * * Default Value: 0\n        * * Description: Indicates if this is a virtual entity without a physical database table."),TrackRecordChanges:z.boolean().describe("\n        * * Field Name: TrackRecordChanges\n        * * Display Name: Track Record Changes\n        * * SQL Data Type: bit\n        * * Default Value: 1\n        * * Description: When set to 1, changes made via the MemberJunction architecture will result in tracking records being created in the RecordChange table. In addition, when turned on CodeGen will ensure that your table has two fields: __mj_CreatedAt and __mj_UpdatedAt which are special fields used in conjunction with the RecordChange table to track changes to rows in your entity."),AuditRecordAccess:z.boolean().describe("\n        * * Field Name: AuditRecordAccess\n        * * Display Name: Audit Record Access\n        * * SQL Data Type: bit\n        * * Default Value: 1\n        * * Description: When set to 1, accessing a record by an end-user will result in an Audit Log record being created"),AuditViewRuns:z.boolean().describe("\n        * * Field Name: AuditViewRuns\n        * * Display Name: Audit View Runs\n        * * SQL Data Type: bit\n        * * Default Value: 1\n        * * Description: When set to 1, users running a view against this entity will result in an Audit Log record being created."),IncludeInAPI:z.boolean().describe("\n        * * Field Name: IncludeInAPI\n        * * Display Name: Include In API\n        * * SQL Data Type: bit\n        * * Default Value: 0\n        * * Description: If set to 0, the entity will not be available at all in the GraphQL API or the object model."),AllowAllRowsAPI:z.boolean().describe("\n        * * Field Name: AllowAllRowsAPI\n        * * Display Name: Allow All Rows API\n        * * SQL Data Type: bit\n        * * Default Value: 0\n        * * Description: If set to 1, a GraphQL query will be enabled that allows access to all rows in the entity."),AllowUpdateAPI:z.boolean().describe("\n        * * Field Name: AllowUpdateAPI\n        * * Display Name: Allow Update API\n        * * SQL Data Type: bit\n        * * Default Value: 0\n        * * Description: Global flag controlling if updates are allowed for any user, or not. If set to 1, a GraqhQL mutation and stored procedure are created. Permissions are still required to perform the action but if this flag is set to 0, no user will be able to perform the action."),AllowCreateAPI:z.boolean().describe("\n        * * Field Name: AllowCreateAPI\n        * * Display Name: Allow Create API\n        * * SQL Data Type: bit\n        * * Default Value: 0\n        * * Description: Global flag controlling if creates are allowed for any user, or not. If set to 1, a GraqhQL mutation and stored procedure are created. Permissions are still required to perform the action but if this flag is set to 0, no user will be able to perform the action."),AllowDeleteAPI:z.boolean().describe("\n        * * Field Name: AllowDeleteAPI\n        * * Display Name: Allow Delete API\n        * * SQL Data Type: bit\n        * * Default Value: 0\n        * * Description: Global flag controlling if deletes are allowed for any user, or not. If set to 1, a GraqhQL mutation and stored procedure are created. Permissions are still required to perform the action but if this flag is set to 0, no user will be able to perform the action."),CustomResolverAPI:z.boolean().describe("\n        * * Field Name: CustomResolverAPI\n        * * Display Name: Custom Resolver API\n        * * SQL Data Type: bit\n        * * Default Value: 0\n        * * Description: Set to 1 if a custom resolver has been created for the entity."),AllowUserSearchAPI:z.boolean().describe("\n        * * Field Name: AllowUserSearchAPI\n        * * Display Name: Allow User Search\n        * * SQL Data Type: bit\n        * * Default Value: 0\n        * * Description: Enabling this bit will result in search being possible at the API and UI layers"),FullTextSearchEnabled:z.boolean().describe("\n        * * Field Name: FullTextSearchEnabled\n        * * Display Name: Full-Text Search Enabled\n        * * SQL Data Type: bit\n        * * Default Value: 0\n        * * Description: Whether full-text search indexing is enabled for this entity."),FullTextCatalog:z.string().nullable().describe("\n        * * Field Name: FullTextCatalog\n        * * Display Name: Full-Text Catalog\n        * * SQL Data Type: nvarchar(255)\n        * * Description: Name of the SQL Server full-text catalog if search is enabled."),FullTextCatalogGenerated:z.boolean().describe("\n        * * Field Name: FullTextCatalogGenerated\n        * * Display Name: Full-Text Catalog Generated\n        * * SQL Data Type: bit\n        * * Default Value: 1\n        * * Description: Indicates if the full-text catalog was auto-generated by CodeGen."),FullTextIndex:z.string().nullable().describe("\n        * * Field Name: FullTextIndex\n        * * Display Name: Full-Text Index\n        * * SQL Data Type: nvarchar(255)\n        * * Description: Name of the full-text index on this entity's table."),FullTextIndexGenerated:z.boolean().describe("\n        * * Field Name: FullTextIndexGenerated\n        * * Display Name: Full-Text Index Generated\n        * * SQL Data Type: bit\n        * * Default Value: 1\n        * * Description: Indicates if the full-text index was auto-generated by CodeGen."),FullTextSearchFunction:z.string().nullable().describe("\n        * * Field Name: FullTextSearchFunction\n        * * Display Name: Search Function\n        * * SQL Data Type: nvarchar(255)\n        * * Description: Name of the function used for full-text searching this entity."),FullTextSearchFunctionGenerated:z.boolean().describe("\n        * * Field Name: FullTextSearchFunctionGenerated\n        * * Display Name: Search Function Generated\n        * * SQL Data Type: bit\n        * * Default Value: 1\n        * * Description: Indicates if the search function was auto-generated by CodeGen."),UserViewMaxRows:z.number().nullable().describe("\n        * * Field Name: UserViewMaxRows\n        * * Display Name: User View Max Rows\n        * * SQL Data Type: int\n        * * Default Value: 1000\n        * * Description: Maximum number of rows to return in user-created views for this entity."),spCreate:z.string().nullable().describe("\n        * * Field Name: spCreate\n        * * Display Name: Create Procedure\n        * * SQL Data Type: nvarchar(255)\n        * * Description: Name of the stored procedure for creating records in this entity."),spUpdate:z.string().nullable().describe("\n        * * Field Name: spUpdate\n        * * Display Name: Update Procedure\n        * * SQL Data Type: nvarchar(255)\n        * * Description: Name of the stored procedure for updating records in this entity."),spDelete:z.string().nullable().describe("\n        * * Field Name: spDelete\n        * * Display Name: Delete Procedure\n        * * SQL Data Type: nvarchar(255)\n        * * Description: Name of the stored procedure for deleting records in this entity."),spCreateGenerated:z.boolean().describe("\n        * * Field Name: spCreateGenerated\n        * * Display Name: Create SP Generated\n        * * SQL Data Type: bit\n        * * Default Value: 1\n        * * Description: Indicates if the create procedure was auto-generated by CodeGen."),spUpdateGenerated:z.boolean().describe("\n        * * Field Name: spUpdateGenerated\n        * * Display Name: Update SP Generated\n        * * SQL Data Type: bit\n        * * Default Value: 1\n        * * Description: Indicates if the update procedure was auto-generated by CodeGen."),spDeleteGenerated:z.boolean().describe("\n        * * Field Name: spDeleteGenerated\n        * * Display Name: Delete SP Generated\n        * * SQL Data Type: bit\n        * * Default Value: 1\n        * * Description: Indicates if the delete procedure was auto-generated by CodeGen."),CascadeDeletes:z.boolean().describe("\n        * * Field Name: CascadeDeletes\n        * * Display Name: Cascade Deletes\n        * * SQL Data Type: bit\n        * * Default Value: 0\n        * * Description: When set to 1, the deleted spDelete will pre-process deletion to related entities that have 1:M cardinality with this entity. This does not have effect if spDeleteGenerated = 0"),DeleteType:z.union([z.literal('Hard'),z.literal('Soft')]).describe("\n        * * Field Name: DeleteType\n        * * Display Name: Delete Type\n        * * SQL Data Type: nvarchar(10)\n        * * Default Value: Hard\n    * * Value List Type: List\n    * * Possible Values \n    *   * Hard\n    *   * Soft\n        * * Description: Hard deletes physically remove rows from the underlying BaseTable. Soft deletes do not remove rows but instead mark the row as deleted by using the special field __mj_DeletedAt which will automatically be added to the entity's basetable by the CodeGen tool."),AllowRecordMerge:z.boolean().describe("\n        * * Field Name: AllowRecordMerge\n        * * Display Name: Allow Record Merge\n        * * SQL Data Type: bit\n        * * Default Value: 0\n        * * Description: This field must be turned on in order to enable merging of records for the entity. For AllowRecordMerge to be turned on, AllowDeleteAPI must be set to 1, and DeleteType must be set to Soft"),spMatch:z.string().nullable().describe("\n        * * Field Name: spMatch\n        * * Display Name: Match Procedure\n        * * SQL Data Type: nvarchar(255)\n        * * Description: When specified, this stored procedure is used to find matching records in this particular entity. The convention is to pass in the primary key(s) columns for the given entity to the procedure and the return will be zero to many rows where there is a column for each primary key field(s) and a ProbabilityScore (numeric(1,12)) column that has a 0 to 1 value of the probability of a match."),RelationshipDefaultDisplayType:z.union([z.literal('Dropdown'),z.literal('Search')]).describe("\n        * * Field Name: RelationshipDefaultDisplayType\n        * * Display Name: Default Relationship Display Type\n        * * SQL Data Type: nvarchar(20)\n        * * Default Value: Search\n    * * Value List Type: List\n    * * Possible Values \n    *   * Dropdown\n    *   * Search\n        * * Description: When another entity links to this entity with a foreign key, this is the default component type that will be used in the UI. CodeGen will populate the RelatedEntityDisplayType column in the Entity Fields entity with whatever is provided here whenever a new foreign key is detected by CodeGen. The selection can be overridden on a per-foreign-key basis in each row of the Entity Fields entity."),UserFormGenerated:z.boolean().describe("\n        * * Field Name: UserFormGenerated\n        * * Display Name: User Form Generated\n        * * SQL Data Type: bit\n        * * Default Value: 1\n        * * Description: Indicates if the default user form was auto-generated for this entity."),EntityObjectSubclassName:z.string().nullable().describe("\n        * * Field Name: EntityObjectSubclassName\n        * * Display Name: Subclass Name\n        * * SQL Data Type: nvarchar(255)\n        * * Description: TypeScript class name for the entity subclass in the codebase."),EntityObjectSubclassImport:z.string().nullable().describe("\n        * * Field Name: EntityObjectSubclassImport\n        * * Display Name: Subclass Import Path\n        * * SQL Data Type: nvarchar(255)\n        * * Description: Import path for the entity subclass in the TypeScript codebase."),PreferredCommunicationField:z.string().nullable().describe("\n        * * Field Name: PreferredCommunicationField\n        * * Display Name: Preferred Communication Field\n        * * SQL Data Type: nvarchar(255)\n        * * Description: Used to specify a field within the entity that in turn contains the field name that will be used for record-level communication preferences. For example in a hypothetical entity called Contacts, say there is a field called PreferredComm and that field had possible values of Email1, SMS, and Phone, and those value in turn corresponded to field names in the entity. Each record in the Contacts entity could have a specific preference for which field would be used for communication. The MJ Communication Framework will use this information when available, as a priority ahead of the data in the Entity Communication Fields entity which is entity-level and not record-level."),Icon:z.string().nullable().describe("\n        * * Field Name: Icon\n        * * Display Name: Icon\n        * * SQL Data Type: nvarchar(500)\n        * * Description: Optional, specify an icon (CSS Class) for each entity for display in the UI"),__mj_CreatedAt:z.date().describe("\n        * * Field Name: __mj_CreatedAt\n        * * Display Name: Created At\n        * * SQL Data Type: datetimeoffset\n        * * Default Value: getutcdate()"),__mj_UpdatedAt:z.date().describe("\n        * * Field Name: __mj_UpdatedAt\n        * * Display Name: Updated At\n        * * SQL Data Type: datetimeoffset\n        * * Default Value: getutcdate()"),ScopeDefault:z.string().nullable().describe("\n        * * Field Name: ScopeDefault\n        * * Display Name: Default Scope\n        * * SQL Data Type: nvarchar(100)\n        * * Description: Optional, comma-delimited string indicating the default scope for entity visibility. Options include Users, Admins, AI, and All. Defaults to All when NULL. This is used for simple defaults for filtering entity visibility, not security enforcement."),RowsToPackWithSchema:z.union([z.literal('All'),z.literal('None'),z.literal('Sample')]).describe("\n        * * Field Name: RowsToPackWithSchema\n        * * Display Name: Rows To Pack\n        * * SQL Data Type: nvarchar(20)\n        * * Default Value: None\n    * * Value List Type: List\n    * * Possible Values \n    *   * All\n    *   * None\n    *   * Sample\n        * * Description: Determines how entity rows should be packaged for external use. Options include None, Sample, and All. Defaults to None."),RowsToPackSampleMethod:z.union([z.literal('bottom n'),z.literal('random'),z.literal('top n')]).describe("\n        * * Field Name: RowsToPackSampleMethod\n        * * Display Name: Packing Sample Method\n        * * SQL Data Type: nvarchar(20)\n        * * Default Value: random\n    * * Value List Type: List\n    * * Possible Values \n    *   * bottom n\n    *   * random\n    *   * top n\n        * * Description: Defines the sampling method for row packing when RowsToPackWithSchema is set to Sample. Options include random, top n, and bottom n. Defaults to random."),RowsToPackSampleCount:z.number().describe("\n        * * Field Name: RowsToPackSampleCount\n        * * Display Name: Packing Sample Count\n        * * SQL Data Type: int\n        * * Default Value: 0\n        * * Description: The number of rows to pack when RowsToPackWithSchema is set to Sample, based on the designated sampling method. Defaults to 0."),RowsToPackSampleOrder:z.string().nullable().describe("\n        * * Field Name: RowsToPackSampleOrder\n        * * Display Name: Packing Sample Order\n        * * SQL Data Type: nvarchar(MAX)\n        * * Description: An optional ORDER BY clause for row packing when RowsToPackWithSchema is set to Sample. Allows custom ordering for selected entity data when using top n and bottom n."),AutoRowCountFrequency:z.number().nullable().describe("\n        * * Field Name: AutoRowCountFrequency\n        * * Display Name: Refresh Frequency (Hours)\n        * * SQL Data Type: int\n        * * Description: Frequency in hours for automatically performing row counts on this entity. If NULL, automatic row counting is disabled. If greater than 0, schedules recurring SELECT COUNT(*) queries at the specified interval."),RowCount:z.number().nullable().describe("\n        * * Field Name: RowCount\n        * * Display Name: Row Count\n        * * SQL Data Type: bigint\n        * * Description: Cached row count for this entity, populated by automatic row count processes when AutoRowCountFrequency is configured."),RowCountRunAt:z.date().nullable().describe("\n        * * Field Name: RowCountRunAt\n        * * Display Name: Last Counted At\n        * * SQL Data Type: datetimeoffset\n        * * Description: Timestamp indicating when the last automatic row count was performed for this entity."),Status:z.union([z.literal('Active'),z.literal('Deprecated'),z.literal('Disabled')]).describe("\n        * * Field Name: Status\n        * * Display Name: Status\n        * * SQL Data Type: nvarchar(25)\n        * * Default Value: Active\n    * * Value List Type: List\n    * * Possible Values \n    *   * Active\n    *   * Deprecated\n    *   * Disabled\n        * * Description: Status of the entity. Active: fully functional; Deprecated: functional but generates console warnings when used; Disabled: not available for use even though metadata and physical table remain."),DisplayName:z.string().nullable().describe("\n        * * Field Name: DisplayName\n        * * Display Name: Display Name\n        * * SQL Data Type: nvarchar(255)\n        * * Description: User-friendly display name shown in the Explorer UI and other interfaces. When set, this is used instead of the entity Name for display purposes. Typically contains the entity name without the schema prefix \u2014 e.g., \"AI Models\" when Name is \"MJ: AI Models\". If NULL, the UI falls back to using the full Name."),AllowMultipleSubtypes:z.boolean().describe("\n        * * Field Name: AllowMultipleSubtypes\n        * * Display Name: Allow Multiple Subtypes\n        * * SQL Data Type: bit\n        * * Default Value: 0\n        * * Description: When false (default), child types are disjoint - a record can only be one child type at a time. When true, a record can simultaneously exist as multiple child types (e.g., a Person can be both a Member and a Volunteer)."),AutoUpdateFullTextSearch:z.boolean().describe("\n        * * Field Name: AutoUpdateFullTextSearch\n        * * Display Name: Auto Update Search Settings\n        * * SQL Data Type: bit\n        * * Default Value: 1\n        * * Description: When true, CodeGen LLM can auto-configure full-text search settings (FullTextSearchEnabled, catalog, index, function) during code generation runs."),AutoUpdateAllowUserSearchAPI:z.boolean().describe("\n        * * Field Name: AutoUpdateAllowUserSearchAPI\n        * * Display Name: Auto Update Search API\n        * * SQL Data Type: bit\n        * * Default Value: 1\n        * * Description: When true, CodeGen LLM can auto-set AllowUserSearchAPI during code generation runs."),TrustServerCacheCompletely:z.boolean().describe("\n        * * Field Name: TrustServerCacheCompletely\n        * * Display Name: Trust Server Cache\n        * * SQL Data Type: bit\n        * * Default Value: 1\n        * * Description: When true (default), the server-side RunView cache will store and return cached results for this entity, trusting that all mutations flow through BaseEntity.Save() which fires cache invalidation events. Set to false for entities whose rows are created as side-effects of other operations via raw SQL (e.g., Record Changes created by spCreateRecordChange_Internal), since those inserts bypass BaseEntity and never trigger cache invalidation."),SupportsGeoCoding:z.boolean().describe("\n        * * Field Name: SupportsGeoCoding\n        * * Display Name: Supports Geo-Coding\n        * * SQL Data Type: bit\n        * * Default Value: 0\n        * * Description: When true, CodeGen generates geo-aware subclass code, adds __mj_Latitude/__mj_Longitude virtual fields to the base view, and the UI shows a map view toggle. Auto-set by CodeGen when LLM detects geo-capable fields (address, lat/lng, etc.)."),AutoUpdateSupportsGeoCoding:z.boolean().describe("\n        * * Field Name: AutoUpdateSupportsGeoCoding\n        * * Display Name: Auto Update Geo-Coding\n        * * SQL Data Type: bit\n        * * Default Value: 1\n        * * Description: When true (default), CodeGen can automatically set SupportsGeoCoding based on LLM analysis of entity fields. Set to 0 to lock the value and prevent CodeGen from changing it."),AllowCaching:z.boolean().describe("\n        * * Field Name: AllowCaching\n        * * Display Name: Allow Caching\n        * * SQL Data Type: bit\n        * * Default Value: 0\n        * * Description: Controls whether this entity participates in server-side and client-side caching. When false, all cache operations (PreRunView checks, auto-cache storage, BaseEntity event fingerprint scans, client-side IndexedDB cache) are skipped entirely. This column is the single source of truth at runtime; schema-level defaults are applied at CodeGen time via newEntityDefaults.AllowCachingBySchema."),DetectExternalChanges:z.boolean().describe("\n        * * Field Name: DetectExternalChanges\n        * * Display Name: Detect External Changes\n        * * SQL Data Type: bit\n        * * Default Value: 0\n        * * Description: When set to 1 AND TrackRecordChanges is also 1, the external change detection system will scan this entity for changes made outside the MJ framework (direct SQL, third-party tools, etc.) and replay them through Save() to create proper RecordChange audit entries. Default is 0 (opt-out) because most entities, especially __mj schema metadata tables, are managed by migrations/CodeGen and should not be scanned."),CodeName:z.string().nullable().describe("\n        * * Field Name: CodeName\n        * * Display Name: Code Name\n        * * SQL Data Type: nvarchar(MAX)\n        * * Description: Schema-based programmatic code name derived from the entity Name. Uses GetClassNameSchemaPrefix(SchemaName) as the prefix, then strips EntityNamePrefix from the Name and removes spaces. For \"__mj\" schema with entity \"MJ: AI Models\", this produces \"MJAIModels\". For entities in other schemas, the sanitized schema name is prepended. Used in GraphQL type generation and internal code references."),ClassName:z.string().nullable().describe("\n        * * Field Name: ClassName\n        * * Display Name: Class Name\n        * * SQL Data Type: nvarchar(MAX)\n        * * Description: Schema-based programmatic class name used for TypeScript entity classes, Zod schemas, and Angular form components. Computed as GetProgrammaticName(GetClassNameSchemaPrefix(SchemaName) + BaseTable + NameSuffix). The prefix is derived from SchemaName (guaranteed unique by SQL Server), not from EntityNamePrefix. For the core __mj schema, the prefix is \"MJ\"; for all other schemas it is the alphanumeric-sanitized schema name. This prevents cross-schema collisions and aligns with GraphQL type naming in getGraphQLTypeNameBase()."),BaseTableCodeName:z.string().nullable().describe("\n        * * Field Name: BaseTableCodeName\n        * * Display Name: Base Table Code Name\n        * * SQL Data Type: nvarchar(MAX)"),ParentEntity:z.string().nullable().describe("\n        * * Field Name: ParentEntity\n        * * Display Name: Parent Entity\n        * * SQL Data Type: nvarchar(255)"),ParentBaseTable:z.string().nullable().describe("\n        * * Field Name: ParentBaseTable\n        * * Display Name: Parent Base Table\n        * * SQL Data Type: nvarchar(255)"),ParentBaseView:z.string().nullable().describe("\n        * * Field Name: ParentBaseView\n        * * Display Name: Parent Base View\n        * * SQL Data Type: nvarchar(255)")});/**
  * zod schema definition for the entity MJ: Entity Action Filters
  */var MJEntityActionFilterSchema=z.object({ID:z.string().describe("\n        * * Field Name: ID\n        * * Display Name: ID\n        * * SQL Data Type: uniqueidentifier\n        * * Default Value: newsequentialid()"),EntityActionID:z.string().describe("\n        * * Field Name: EntityActionID\n        * * Display Name: Entity Action\n        * * SQL Data Type: uniqueidentifier\n        * * Related Entity/Foreign Key: MJ: Entity Actions (vwEntityActions.ID)"),ActionFilterID:z.string().describe("\n        * * Field Name: ActionFilterID\n        * * Display Name: Action Filter\n        * * SQL Data Type: uniqueidentifier\n        * * Related Entity/Foreign Key: MJ: Action Filters (vwActionFilters.ID)"),Sequence:z.number().describe("\n        * * Field Name: Sequence\n        * * Display Name: Sequence\n        * * SQL Data Type: int\n        * * Description: Order of filter execution."),Status:z.union([z.literal('Active'),z.literal('Disabled'),z.literal('Pending')]).describe("\n        * * Field Name: Status\n        * * Display Name: Status\n        * * SQL Data Type: nvarchar(20)\n        * * Default Value: Pending\n    * * Value List Type: List\n    * * Possible Values \n    *   * Active\n    *   * Disabled\n    *   * Pending\n        * * Description: Status of the entity action filter (Pending, Active, Disabled)."),__mj_CreatedAt:z.date().describe("\n        * * Field Name: __mj_CreatedAt\n        * * Display Name: Created At\n        * * SQL Data Type: datetimeoffset\n        * * Default Value: getutcdate()"),__mj_UpdatedAt:z.date().describe("\n        * * Field Name: __mj_UpdatedAt\n        * * Display Name: Updated At\n        * * SQL Data Type: datetimeoffset\n        * * Default Value: getutcdate()"),EntityAction:z.string().describe("\n        * * Field Name: EntityAction\n        * * Display Name: Entity Action Name\n        * * SQL Data Type: nvarchar(425)"),ActionFilter:z.string().describe("\n        * * Field Name: ActionFilter\n        * * Display Name: Action Filter Name\n        * * SQL Data Type: nvarchar(MAX)")});/**
  * zod schema definition for the entity MJ: Entity Action Invocation Types
@@ -70530,6 +70900,18 @@ provider=dist/* Metadata */.OS.Provider;_context136.p=1;_context136.n=2;return p
     * * Default Value: 1
     * * Description: When true (default), CodeGen can automatically set SupportsGeoCoding based on LLM analysis of entity fields. Set to 0 to lock the value and prevent CodeGen from changing it.
     */},{key:"AutoUpdateSupportsGeoCoding",get:function get(){return this.Get('AutoUpdateSupportsGeoCoding');},set:function set(value){this.Set('AutoUpdateSupportsGeoCoding',value);}/**
+    * * Field Name: AllowCaching
+    * * Display Name: Allow Caching
+    * * SQL Data Type: bit
+    * * Default Value: 0
+    * * Description: Controls whether this entity participates in server-side and client-side caching. When false, all cache operations (PreRunView checks, auto-cache storage, BaseEntity event fingerprint scans, client-side IndexedDB cache) are skipped entirely. This column is the single source of truth at runtime; schema-level defaults are applied at CodeGen time via newEntityDefaults.AllowCachingBySchema.
+    */},{key:"AllowCaching",get:function get(){return this.Get('AllowCaching');},set:function set(value){this.Set('AllowCaching',value);}/**
+    * * Field Name: DetectExternalChanges
+    * * Display Name: Detect External Changes
+    * * SQL Data Type: bit
+    * * Default Value: 0
+    * * Description: When set to 1 AND TrackRecordChanges is also 1, the external change detection system will scan this entity for changes made outside the MJ framework (direct SQL, third-party tools, etc.) and replay them through Save() to create proper RecordChange audit entries. Default is 0 (opt-out) because most entities, especially __mj schema metadata tables, are managed by migrations/CodeGen and should not be scanned.
+    */},{key:"DetectExternalChanges",get:function get(){return this.Get('DetectExternalChanges');},set:function set(value){this.Set('DetectExternalChanges',value);}/**
     * * Field Name: CodeName
     * * Display Name: Code Name
     * * SQL Data Type: nvarchar(MAX)
@@ -93677,12 +94059,19 @@ function util_GetGlobalObjectStore() {
 }
 /**
  * This utility function will copy all scalar and array properties from an object to a new object and return the new object.
- * This function will NOT copy functions or non-plain objects (unless resolveCircularReferences is true).
+ * This function will NOT copy non-plain object instances (unless they implement `toJSON()` or `resolveCircularReferences` is true).
+ *
+ * The function respects the standard JavaScript `toJSON()` protocol: if a value exposes a `toJSON()` method
+ * (as `Date`, `BaseInfo` subclasses, and user-defined classes can), the method is invoked and its return value
+ * is processed in place of the original. This mirrors how `JSON.stringify()` handles serialization.
+ *
+ * Arrays are recursively processed — each item is copied/toJSON'd individually — so nested objects with
+ * `toJSON()` are unwrapped to their serializable form.
  *
  * @param input - The object to copy
  * @param resolveCircularReferences - If true, handles circular references and complex objects for safe JSON serialization.
  *                                     When enabled, circular references are replaced with '[Circular Reference]',
- *                                     complex objects (Sockets, Streams, etc.) are replaced with their type names,
+ *                                     complex objects without `toJSON()` are replaced with their type names,
  *                                     Error objects are specially handled to extract name/message/stack,
  *                                     and Dates are converted to ISO strings. Default: false
  * @param maxDepth - Maximum recursion depth when resolveCircularReferences is true (default: 10)
@@ -93723,11 +94112,8 @@ function CopyScalarsAndArrays(input) {
           return _copy(item, depth + 1);
         });
       }
-      // Handle Date objects
-      if (_.isDate(value)) {
-        return value.toISOString();
-      }
       // Handle Error objects specially to get their properties
+      // (checked before toJSON so we always get name/message/stack, even if Error subclasses define toJSON)
       if (value instanceof Error) {
         return _objectSpread({
           name: value.name,
@@ -93735,6 +94121,10 @@ function CopyScalarsAndArrays(input) {
           stack: value.stack
         }, _copy(_.omit(value, ['name', 'message', 'stack']), depth + 1));
       }
+      // Respect the toJSON() protocol (covers Date, BaseInfo subclasses, and any class that implements it)
+      if (typeof value.toJSON === 'function') {
+        return _copy(value.toJSON(), depth + 1);
+      }
       // Handle plain objects (POJOs)
       if (_.isPlainObject(value)) {
         var result = {};
@@ -93745,7 +94135,7 @@ function CopyScalarsAndArrays(input) {
         }
         return result;
       }
-      // For complex objects (Socket, Stream, Buffer, etc.), just use the type name
+      // For complex objects without toJSON (Socket, Stream, Buffer, etc.), just use the type name
       var typeName = ((_value$constructor = value.constructor) === null || _value$constructor === void 0 ? void 0 : _value$constructor.name) || 'Object';
       if (typeName !== 'Object') {
         return "[".concat(typeName, "]");
@@ -93754,21 +94144,41 @@ function CopyScalarsAndArrays(input) {
     };
     return _copy(input, 0);
   } else {
-    // Original implementation for backward compatibility
+    // Simple mode: preserves existing behavior (primitives/functions pass through, class instances
+    // without toJSON get their keys dropped) while honoring the toJSON() protocol and recursing
+    // into array items so nested objects with toJSON are unwrapped.
     var result = {};
     Object.keys(input).forEach(function (key) {
       var value = input[key];
-      // Check for null or scalar types directly
+      // Primitives, null, functions — pass through
       if (value === null || util_typeof(value) !== 'object') {
         result[key] = value;
-      } else if (Array.isArray(value)) {
-        // Handle arrays by creating a new array with the same elements
-        result[key] = _toConsumableArray(value);
-      } else if (util_typeof(value) === 'object' && value.constructor === Object) {
-        // Recursively copy plain objects
+        return;
+      }
+      // toJSON protocol — use the method's output
+      var valueToJSON = value.toJSON;
+      if (typeof valueToJSON === 'function') {
+        result[key] = valueToJSON.call(value);
+        return;
+      }
+      // Arrays — process each item; items with toJSON are unwrapped, class instances without it are replaced with null to preserve array length
+      if (Array.isArray(value)) {
+        result[key] = value.map(function (item) {
+          if (item === null || util_typeof(item) !== 'object') return item;
+          var itemToJSON = item.toJSON;
+          if (typeof itemToJSON === 'function') return itemToJSON.call(item);
+          if (item.constructor === Object) return CopyScalarsAndArrays(item);
+          // Non-plain, non-toJSON class instances inside an array — can't drop without changing
+          // array length, so fall back to null (sanitized placeholder)
+          return null;
+        });
+        return;
+      }
+      // Plain objects — recurse (key omitted for class instances without toJSON)
+      if (value.constructor === Object) {
         result[key] = CopyScalarsAndArrays(value);
       }
-      // Functions and non-plain objects are intentionally ignored
+      // else: non-plain class instance without toJSON → key is dropped entirely (matches legacy)
     });
     return result;
   }