@memberjunction/core 3.4.0 → 4.1.0

package/dist/generic/entityInfo.js

@@ -1,15 +1,12 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RecordMergeResult = exports.RecordMergeDetailResult = exports.RecordMergeRequest = exports.RecordDependency = exports.EntityDependency = exports.ValidationResult = exports.ValidationErrorInfo = exports.ValidationErrorType = exports.EntityInfo = exports.EntitySettingInfo = exports.EntityDocumentTypeInfo = exports.EntityFieldInfo = exports.GeneratedFormSectionType = exports.EntityFieldValueInfo = exports.EntityFieldValueListType = exports.EntityFieldGraphQLType = exports.EntityFieldTSType = exports.EntityPermissionInfo = exports.EntityUserPermissionInfo = exports.EntityPermissionType = exports.EntityRelationshipInfo = exports.RecordChange = exports.RecordChangeStatus = void 0;
-const baseInfo_1 = require("./baseInfo");
-const metadata_1 = require("./metadata");
-const util_1 = require("./util");
-const logging_1 = require("./logging");
-const global_1 = require("@memberjunction/global");
+import { BaseInfo } from "./baseInfo.js";
+import { Metadata } from "./metadata.js";
+import { TypeScriptTypeFromSQLType, SQLFullType, SQLMaxLength, FormatValue, CodeNameFromString } from "./util.js";
+import { LogError } from "./logging.js";
+import { WarningManager, SafeJSONParse } from "@memberjunction/global";
 /**
  * The possible status values for a record change
  */
-exports.RecordChangeStatus = {
+export const RecordChangeStatus = {
     Pending: 'Pending',
     Complete: 'Complete',
     Error: 'Error',
@@ -17,9 +14,9 @@ exports.RecordChangeStatus = {
 /**
  * Record Change object has information on a change to a record in the Record Changes entity
  */
-class RecordChange extends baseInfo_1.BaseInfo {
+export class RecordChange extends BaseInfo {
     get StatusValue() {
-        return exports.RecordChangeStatus[this.Status?.trim()];
+        return RecordChangeStatus[this.Status?.trim()];
     }
     get Changes() {
         return JSON.parse(this.ChangesJSON);
@@ -40,7 +37,6 @@ class RecordChange extends baseInfo_1.BaseInfo {
         this.copyInitData(initData);
     }
 }
-exports.RecordChange = RecordChange;
 /**
  * Information about the Entity Relationship between the Entity and the Related Entity - this class
  * maps to information in the Entity Relationships metadata entity.
@@ -49,7 +45,7 @@ exports.RecordChange = RecordChange;
  * Metadata about relationships between entities including display preferences for the UI.
  * Defines foreign key relationships and how they should be represented in the user interface.
  */
-class EntityRelationshipInfo extends baseInfo_1.BaseInfo {
+export class EntityRelationshipInfo extends BaseInfo {
     constructor(initData) {
         super();
         this.ID = null;
@@ -97,54 +93,52 @@ class EntityRelationshipInfo extends baseInfo_1.BaseInfo {
         this.copyInitData(initData);
     }
 }
-exports.EntityRelationshipInfo = EntityRelationshipInfo;
-exports.EntityPermissionType = {
+export const EntityPermissionType = {
     Read: 'Read',
     Create: 'Create',
     Update: 'Update',
     Delete: 'Delete',
 };
-class EntityUserPermissionInfo {
+export class EntityUserPermissionInfo {
     constructor() {
         this.ID = null;
     }
 }
-exports.EntityUserPermissionInfo = EntityUserPermissionInfo;
 /**
  * Security settings for each entity.
  * Controls which roles can perform create, read, update, and delete operations.
  */
-class EntityPermissionInfo extends baseInfo_1.BaseInfo {
+export class EntityPermissionInfo extends BaseInfo {
     get CreateRLSFilterObject() {
-        return this.RLSFilter(exports.EntityPermissionType.Create);
+        return this.RLSFilter(EntityPermissionType.Create);
     }
     get ReadRLSFilterObject() {
-        return this.RLSFilter(exports.EntityPermissionType.Read);
+        return this.RLSFilter(EntityPermissionType.Read);
     }
     get UpdateRLSFilterObject() {
-        return this.RLSFilter(exports.EntityPermissionType.Update);
+        return this.RLSFilter(EntityPermissionType.Update);
     }
     get DeleteRLSFilterObject() {
-        return this.RLSFilter(exports.EntityPermissionType.Delete);
+        return this.RLSFilter(EntityPermissionType.Delete);
     }
     RLSFilter(type) {
         let fID = "";
         switch (type) {
-            case exports.EntityPermissionType.Read:
+            case EntityPermissionType.Read:
                 fID = this.ReadRLSFilterID;
                 break;
-            case exports.EntityPermissionType.Create:
+            case EntityPermissionType.Create:
                 fID = this.CreateRLSFilterID;
                 break;
-            case exports.EntityPermissionType.Update:
+            case EntityPermissionType.Update:
                 fID = this.UpdateRLSFilterID;
                 break;
-            case exports.EntityPermissionType.Delete:
+            case EntityPermissionType.Delete:
                 fID = this.DeleteRLSFilterID;
                 break;
         }
         if (fID && fID.length > 0)
-            return metadata_1.Metadata.Provider.RowLevelSecurityFilters.find(f => f.ID === fID);
+            return Metadata.Provider.RowLevelSecurityFilters.find(f => f.ID === fID);
     }
     constructor(initData) {
         super();
@@ -172,21 +166,20 @@ class EntityPermissionInfo extends baseInfo_1.BaseInfo {
         this.copyInitData(initData);
     }
 }
-exports.EntityPermissionInfo = EntityPermissionInfo;
-exports.EntityFieldTSType = {
+export const EntityFieldTSType = {
     String: 'string',
     Number: 'number',
     Date: 'Date',
     Boolean: 'boolean',
 };
-exports.EntityFieldGraphQLType = {
+export const EntityFieldGraphQLType = {
     Int: 'Int',
     Float: 'Float',
     String: 'String',
     Boolean: 'Boolean',
     Timestamp: 'Timestamp',
 };
-exports.EntityFieldValueListType = {
+export const EntityFieldValueListType = {
     None: 'None',
     List: 'List',
     ListOrUserEntry: 'ListOrUserEntry',
@@ -195,7 +188,7 @@ exports.EntityFieldValueListType = {
  * Defines allowed values for entity fields with value lists.
  * Supports dropdowns, validations, and data integrity constraints.
  */
-class EntityFieldValueInfo extends baseInfo_1.BaseInfo {
+export class EntityFieldValueInfo extends BaseInfo {
     constructor(initData) {
         super();
         this.ID = null;
@@ -209,8 +202,7 @@ class EntityFieldValueInfo extends baseInfo_1.BaseInfo {
         this.copyInitData(initData);
     }
 }
-exports.EntityFieldValueInfo = EntityFieldValueInfo;
-exports.GeneratedFormSectionType = {
+export const GeneratedFormSectionType = {
     Top: 'Top',
     Details: 'Details',
     Category: 'Category',
@@ -222,7 +214,7 @@ exports.GeneratedFormSectionType = {
  * List of all fields within each entity with metadata about each field.
  * Includes data types, relationships, defaults, and UI display preferences.
  */
-class EntityFieldInfo extends baseInfo_1.BaseInfo {
+export class EntityFieldInfo extends BaseInfo {
     /**
      * JSON configuration for additional fields to join from the related entity.
      * Parsed from the RelatedEntityJoinFields column. Uses lazy initialization and caching
@@ -242,7 +234,7 @@ class EntityFieldInfo extends baseInfo_1.BaseInfo {
             return this._relatedEntityJoinFieldsParsed;
         }
         // Parse and cache the configuration
-        const parsed = (0, global_1.SafeJSONParse)(this.RelatedEntityJoinFields, false);
+        const parsed = SafeJSONParse(this.RelatedEntityJoinFields, false);
         if (parsed === null) {
             // Parsing failed - mark as failed so we don't try again
             this._relatedEntityJoinFieldsFailedParsing = true;
@@ -260,34 +252,34 @@ class EntityFieldInfo extends baseInfo_1.BaseInfo {
      */
     get ValueListTypeEnum() {
         if (this.ValueListType == null)
-            return exports.EntityFieldValueListType.None;
+            return EntityFieldValueListType.None;
         else {
             // iterate through list of possibilities from enum and compare lcase
-            for (let enumMember in exports.EntityFieldValueListType) {
-                if (typeof exports.EntityFieldValueListType[enumMember] === 'string' &&
+            for (let enumMember in EntityFieldValueListType) {
+                if (typeof EntityFieldValueListType[enumMember] === 'string' &&
                     enumMember.toLowerCase().trim() === this.ValueListType.toLowerCase().trim()) {
-                    return exports.EntityFieldValueListType[enumMember];
+                    return EntityFieldValueListType[enumMember];
                 }
             }
         }
     }
     get GeneratedFormSectionType() {
-        return exports.GeneratedFormSectionType[this.GeneratedFormSection];
+        return GeneratedFormSectionType[this.GeneratedFormSection];
     }
     /**
      * Provides the TypeScript type for a given Entity Field. This is useful to map
      * a wide array of database types to a narrower set of TypeScript types.
      */
     get TSType() {
-        switch ((0, util_1.TypeScriptTypeFromSQLType)(this.Type).toLowerCase()) {
+        switch (TypeScriptTypeFromSQLType(this.Type).toLowerCase()) {
             case "number":
-                return exports.EntityFieldTSType.Number;
+                return EntityFieldTSType.Number;
             case "boolean":
-                return exports.EntityFieldTSType.Boolean;
+                return EntityFieldTSType.Boolean;
             case "date":
-                return exports.EntityFieldTSType.Date;
+                return EntityFieldTSType.Date;
             default:
-                return exports.EntityFieldTSType.String;
+                return EntityFieldTSType.String;
         }
     }
     /**
@@ -332,8 +324,8 @@ class EntityFieldInfo extends baseInfo_1.BaseInfo {
      */
     get NeedsQuotes() {
         switch (this.TSType) {
-            case exports.EntityFieldTSType.Number:
-            case exports.EntityFieldTSType.Boolean:
+            case EntityFieldTSType.Number:
+            case EntityFieldTSType.Boolean:
                 return false;
             default:
                 return true;
@@ -341,12 +333,12 @@ class EntityFieldInfo extends baseInfo_1.BaseInfo {
     }
     get CodeName() {
         if (this._codeName === null) {
-            this._codeName = (0, util_1.CodeNameFromString)(this.Name);
+            this._codeName = CodeNameFromString(this.Name);
         }
         return this._codeName;
     }
     get GraphQLType() {
-        switch ((0, util_1.TypeScriptTypeFromSQLType)(this.Type).toLowerCase()) {
+        switch (TypeScriptTypeFromSQLType(this.Type).toLowerCase()) {
             case "number":
                 // either an int or float if not an int
                 switch (this.Type.toLowerCase().trim()) {
@@ -354,30 +346,34 @@ class EntityFieldInfo extends baseInfo_1.BaseInfo {
                     case "smallint":
                     case "tinyint":
                     case "bigint":
-                        return exports.EntityFieldGraphQLType.Int;
+                        return EntityFieldGraphQLType.Int;
                     default:
-                        return exports.EntityFieldGraphQLType.Float;
+                        return EntityFieldGraphQLType.Float;
                 }
             case "boolean":
-                return exports.EntityFieldGraphQLType.Boolean;
+                return EntityFieldGraphQLType.Boolean;
             case "date":
-                return exports.EntityFieldGraphQLType.Timestamp;
+                return EntityFieldGraphQLType.Timestamp;
             default:
-                return exports.EntityFieldGraphQLType.String;
+                return EntityFieldGraphQLType.String;
         }
     }
     /**
      * Returns a string with the full SQL data type that combines, as appropriate, Type, Length, Precision and Scale where these attributes are relevant to the Type
      */
     get SQLFullType() {
-        return (0, util_1.SQLFullType)(this.Type, this.Length, this.Precision, this.Scale);
+        return SQLFullType(this.Type, this.Length, this.Precision, this.Scale);
     }
     get MaxLength() {
-        return (0, util_1.SQLMaxLength)(this.Type, this.Length);
+        return SQLMaxLength(this.Type, this.Length);
     }
     get ReadOnly() {
-        return this.IsVirtual ||
-            !this.AllowUpdateAPI ||
+        // Note: IsVirtual is intentionally NOT checked here. For IS-A (table-per-type) inheritance,
+        // parent entity fields on child entities are marked IsVirtual=1 (they don't exist in the
+        // child's base table) but ARE editable via the parent save chain. The AllowUpdateAPI flag
+        // already correctly distinguishes editable IS-A parent fields (AllowUpdateAPI=1) from
+        // truly read-only virtual fields like joined display names (AllowUpdateAPI=0).
+        return !this.AllowUpdateAPI ||
             this.IsPrimaryKey ||
             this.IsSpecialDateField;
     }
@@ -451,7 +447,7 @@ class EntityFieldInfo extends baseInfo_1.BaseInfo {
      * @returns either the original string value or a formatted version. If the format cannot be applied an an exception occurs it is captured and the error is put to the log, and the original value is returned
      */
     FormatValue(value, decimals = 2, currency = 'USD', maxLength = 0, trailingChars = "...") {
-        return (0, util_1.FormatValue)(this.Type, value, decimals, currency, maxLength, trailingChars);
+        return FormatValue(this.Type, value, decimals, currency, maxLength, trailingChars);
     }
     constructor(initData = null) {
         super();
@@ -752,15 +748,26 @@ class EntityFieldInfo extends baseInfo_1.BaseInfo {
         }
         if (entityField.Status?.trim().toLowerCase() === 'deprecated') {
             // Record deprecation warning - will be batched and displayed after debounce period
-            global_1.WarningManager.Instance.RecordFieldDeprecationWarning(entityField.Entity, entityField.Name, callerName);
+            WarningManager.Instance.RecordFieldDeprecationWarning(entityField.Entity, entityField.Name, callerName);
         }
         else if (entityField.Status?.trim().toLowerCase() === 'disabled') {
             // console.error and throw the exception
             const exceptionString = `${callerName}: Entity Field ${entityField.Entity}.${entityField.Name} is disabled and cannot be used.`;
-            (0, logging_1.LogError)(exceptionString);
+            LogError(exceptionString);
             throw new Error(exceptionString);
         }
     }
+    /**
+     * Readonly array of SQL Server date/time functions that return the current date/time
+     */
+    static { this.SQL_CURRENT_DATE_FUNCTIONS = [
+        'getdate()',
+        'getutcdate()',
+        'sysdatetimeoffset()',
+        'current_timestamp',
+        'sysdatetime()',
+        'sysutcdatetime()'
+    ]; }
     /**
      * Checks if a default value is a SQL Server function that returns the current date/time
      * @param defaultValue - The default value to check
@@ -777,18 +784,6 @@ class EntityFieldInfo extends baseInfo_1.BaseInfo {
         return EntityFieldInfo.SQL_CURRENT_DATE_FUNCTIONS.some(func => normalizedValue.includes(func));
     }
 }
-exports.EntityFieldInfo = EntityFieldInfo;
-/**
- * Readonly array of SQL Server date/time functions that return the current date/time
- */
-EntityFieldInfo.SQL_CURRENT_DATE_FUNCTIONS = [
-    'getdate()',
-    'getutcdate()',
-    'sysdatetimeoffset()',
-    'current_timestamp',
-    'sysdatetime()',
-    'sysutcdatetime()'
-];
 /**
  * Entity Document Type Info object has information about the document types that exist across all entities. When Entity Documents are created they are associated with a document type.
  */
@@ -796,7 +791,7 @@ EntityFieldInfo.SQL_CURRENT_DATE_FUNCTIONS = [
  * Defines types of documents that can be generated from entity data.
  * Supports various output formats for entity records.
  */
-class EntityDocumentTypeInfo extends baseInfo_1.BaseInfo {
+export class EntityDocumentTypeInfo extends BaseInfo {
     constructor(initData = null) {
         super();
         this.ID = null;
@@ -807,7 +802,6 @@ class EntityDocumentTypeInfo extends baseInfo_1.BaseInfo {
         this.copyInitData(initData);
     }
 }
-exports.EntityDocumentTypeInfo = EntityDocumentTypeInfo;
 /**
  * Settings allow you to store key/value pairs of information that can be used to configure the behavior of the entity.
  */
@@ -815,7 +809,7 @@ exports.EntityDocumentTypeInfo = EntityDocumentTypeInfo;
  * Stores entity-specific configuration settings.
  * Allows customization of how entities function within the system.
  */
-class EntitySettingInfo extends baseInfo_1.BaseInfo {
+export class EntitySettingInfo extends BaseInfo {
     constructor(initData = null) {
         super();
         this.ID = null;
@@ -828,12 +822,11 @@ class EntitySettingInfo extends baseInfo_1.BaseInfo {
         this.copyInitData(initData);
     }
 }
-exports.EntitySettingInfo = EntitySettingInfo;
 /**
  * Catalog of all entities across all schemas.
  * Contains comprehensive metadata about each entity including its database mappings, security settings, and UI preferences.
  */
-class EntityInfo extends baseInfo_1.BaseInfo {
+export class EntityInfo extends BaseInfo {
     /**
      * Returns the primary key field for the entity. For entities with a composite primary key, use the PrimaryKeys property which returns all.
      * In the case of a composite primary key, the PrimaryKey property will return the first field in the sequence of the primary key fields.
@@ -897,6 +890,17 @@ class EntityInfo extends baseInfo_1.BaseInfo {
     get Settings() {
         return this._Settings;
     }
+    /**
+     * Gets the parsed FieldCategoryInfo map for this entity, keyed by category name.
+     * Auto-populated from the 'FieldCategoryInfo' EntitySetting (with legacy 'FieldCategoryIcons' fallback)
+     * during EntityInfo construction. Returns null if no category info is configured.
+     */
+    get FieldCategories() {
+        return this._FieldCategories;
+    }
+    static { this.__createdAtFieldName = '__mj_CreatedAt'; }
+    static { this.__updatedAtFieldName = '__mj_UpdatedAt'; }
+    static { this.__deletedAtFieldName = '__mj_DeletedAt'; }
     /**
      * Returns the name of the special reserved field that is used to store the CreatedAt timestamp across all of MJ. This is only used when an entity has TrackRecordChanges turned on
      */
@@ -928,12 +932,12 @@ class EntityInfo extends baseInfo_1.BaseInfo {
         }
         if (entity.Status?.trim().toLowerCase() === 'deprecated') {
             // Record deprecation warning - will be batched and displayed after debounce period
-            global_1.WarningManager.Instance.RecordEntityDeprecationWarning(entity.Name, callerName);
+            WarningManager.Instance.RecordEntityDeprecationWarning(entity.Name, callerName);
         }
         else if (entity.Status?.trim().toLowerCase() === 'disabled') {
             // console.error and throw the exception
             const exceptionString = `${callerName}: Entity ${entity.Name} is disabled and cannot be used.`;
-            (0, logging_1.LogError)(exceptionString);
+            LogError(exceptionString);
             throw new Error(exceptionString);
         }
     }
@@ -960,6 +964,104 @@ class EntityInfo extends baseInfo_1.BaseInfo {
         else
             return f;
     }
+    /**************************************************************************
+     * IS-A Type Relationship Computed Properties
+     *
+     * These properties support the IS-A (parent/child type) inheritance model
+     * where child entities share their parent's primary key and inherit all
+     * parent fields. Example: Meeting IS-A Product, Webinar IS-A Meeting.
+     **************************************************************************/
+    /**
+     * Returns the parent EntityInfo for IS-A type inheritance, or null if this entity
+     * has no parent type. Uses the existing ParentID column on the Entity table.
+     * Example: For "Meetings" entity with ParentID pointing to "Products", returns the Products EntityInfo.
+     */
+    get ParentEntityInfo() {
+        if (!this.ParentID)
+            return null;
+        return Metadata.Provider?.Entities?.find(e => e.ID === this.ParentID) ?? null;
+    }
+    /**
+     * Returns all child entities that have their ParentID set to this entity's ID.
+     * These represent IS-A type specializations of this entity.
+     * Example: For "Products" entity, might return [Meetings, Publications].
+     */
+    get ChildEntities() {
+        return Metadata.Provider?.Entities?.filter(e => e.ParentID === this.ID) ?? [];
+    }
+    /**
+     * Walks the IS-A chain upward from this entity to the root, returning all parent entities.
+     * Does NOT include this entity itself.
+     * Example: For Webinars (IS-A Meetings IS-A Products), returns [Meetings, Products].
+     * Results are cached after first computation for performance.
+     */
+    get ParentChain() {
+        if (this._parentChainCache !== null)
+            return this._parentChainCache;
+        const chain = [];
+        let current = this.ParentEntityInfo;
+        const visited = new Set(); // circular reference protection
+        while (current) {
+            if (visited.has(current.ID))
+                break; // prevent infinite loop
+            visited.add(current.ID);
+            chain.push(current);
+            current = current.ParentEntityInfo;
+        }
+        this._parentChainCache = chain;
+        return chain;
+    }
+    /**
+     * Returns true if this entity is a child type in an IS-A relationship (has a parent entity).
+     */
+    get IsChildType() {
+        return this.ParentID != null;
+    }
+    /**
+     * Returns true if this entity is a parent type in an IS-A relationship (has child entities).
+     */
+    get IsParentType() {
+        return this.ChildEntities.length > 0;
+    }
+    /**
+     * Returns all fields from all parent entities in the IS-A chain, excluding primary keys,
+     * virtual fields, and timestamp fields (__mj_ prefixed). These represent the inherited
+     * fields that should be available on child entities.
+     */
+    get AllParentFields() {
+        const fields = [];
+        for (const parent of this.ParentChain) {
+            fields.push(...parent.Fields.filter(f => !f.IsPrimaryKey && !f.Name.startsWith('__mj_') && !f.IsVirtual));
+        }
+        return fields;
+    }
+    /**
+     * Returns a cached Set of field names that belong to parent entities in the IS-A chain,
+     * including the shared primary key(s). Used for efficient field routing in
+     * BaseEntity.Set/Get/SetMany/Hydrate operations.
+     * The Set enables O(1) lookup to determine if a field should be routed to the parent entity.
+     *
+     * Note: AllParentFields excludes PKs (they aren't "inherited data" fields), but the
+     * routing set must include them so that SetMany and Hydrate can forward the shared
+     * IS-A primary key to parent entities.
+     */
+    get ParentEntityFieldNames() {
+        if (this._parentEntityFieldNamesCache !== null)
+            return this._parentEntityFieldNamesCache;
+        const names = this.AllParentFields.map(f => f.Name);
+        // Add shared PK names from the immediate parent — these are excluded from
+        // AllParentFields but must be routed so parent entities receive their identity.
+        const parentEntity = this.ParentEntityInfo;
+        if (parentEntity) {
+            for (const pk of parentEntity.PrimaryKeys) {
+                if (!names.includes(pk.Name)) {
+                    names.push(pk.Name);
+                }
+            }
+        }
+        this._parentEntityFieldNamesCache = new Set(names);
+        return this._parentEntityFieldNamesCache;
+    }
     /**
      * Returns the Permissions for this entity for a given user, based on the roles the user is part of
      * @param user
@@ -1008,19 +1110,19 @@ class EntityInfo extends baseInfo_1.BaseInfo {
             const roleMatch = user.UserRoles?.find((r) => r.RoleID === ep.RoleID);
             if (roleMatch) { // user has this role 
                 switch (type) {
-                    case exports.EntityPermissionType.Create:
+                    case EntityPermissionType.Create:
                         if (!ep.CreateRLSFilterID)
                             return true;
                         break;
-                    case exports.EntityPermissionType.Read:
+                    case EntityPermissionType.Read:
                         if (!ep.ReadRLSFilterID)
                             return true;
                         break;
-                    case exports.EntityPermissionType.Update:
+                    case EntityPermissionType.Update:
                         if (!ep.UpdateRLSFilterID)
                             return true;
                         break;
-                    case exports.EntityPermissionType.Delete:
+                    case EntityPermissionType.Delete:
                         if (!ep.DeleteRLSFilterID)
                             return true;
                         break;
@@ -1043,19 +1145,19 @@ class EntityInfo extends baseInfo_1.BaseInfo {
             if (roleMatch) { // user has this role
                 let matchObject = null;
                 switch (type) {
-                    case exports.EntityPermissionType.Create:
+                    case EntityPermissionType.Create:
                         if (ep.CreateRLSFilterID)
                             matchObject = ep.CreateRLSFilterObject;
                         break;
-                    case exports.EntityPermissionType.Read:
+                    case EntityPermissionType.Read:
                         if (ep.ReadRLSFilterID)
                             matchObject = ep.ReadRLSFilterObject;
                         break;
-                    case exports.EntityPermissionType.Update:
+                    case EntityPermissionType.Update:
                         if (ep.UpdateRLSFilterID)
                             matchObject = ep.UpdateRLSFilterObject;
                         break;
-                    case exports.EntityPermissionType.Delete:
+                    case EntityPermissionType.Delete:
                         if (ep.DeleteRLSFilterID)
                             matchObject = ep.DeleteRLSFilterObject;
                         break;
@@ -1436,11 +1538,16 @@ class EntityInfo extends baseInfo_1.BaseInfo {
         this.ParentEntity = null;
         this.ParentBaseTable = null;
         this.ParentBaseView = null;
+        this._FieldCategories = null;
         this._hasIdField = false;
         this._virtualCount = 0;
         this._manyToManyCount = 0;
         this._oneToManyCount = 0;
         this._floatCount = 0;
+        // Cache for ParentChain to avoid repeated walks
+        this._parentChainCache = null;
+        // Cache for ParentEntityFieldNames
+        this._parentEntityFieldNamesCache = null;
         if (initData) {
             this.copyInitData(initData);
             // do some special handling to create class instances instead of just data objects
@@ -1466,6 +1573,8 @@ class EntityInfo extends baseInfo_1.BaseInfo {
             if (es) {
                 es.map((s) => this._Settings.push(new EntitySettingInfo(s)));
             }
+            // auto-populate FieldCategories from the FieldCategoryInfo setting
+            this._FieldCategories = this.parseFieldCategoriesFromSettings();
             // copy the Related Entities
             this._RelatedEntities = [];
             const er = initData.EntityRelationships || initData._RelatedEntities;
@@ -1525,47 +1634,65 @@ class EntityInfo extends baseInfo_1.BaseInfo {
             this._oneToManyCount = oneToManyCount;
         }
         catch (e) {
-            (0, logging_1.LogError)(e);
+            LogError(e);
+        }
+    }
+    /**
+     * Parses FieldCategoryInfo from EntitySettings, with legacy FieldCategoryIcons fallback.
+     * Called once during construction so the result is cached on _FieldCategories.
+     */
+    parseFieldCategoriesFromSettings() {
+        if (!this._Settings || this._Settings.length === 0) {
+            return null;
+        }
+        // Try new format first
+        const infoSetting = this._Settings.find(s => s.Name === 'FieldCategoryInfo');
+        if (infoSetting?.Value) {
+            const parsed = SafeJSONParse(infoSetting.Value, false);
+            if (parsed) {
+                return parsed;
+            }
+        }
+        // Fallback to legacy FieldCategoryIcons format (icon-only map)
+        const iconSetting = this._Settings.find(s => s.Name === 'FieldCategoryIcons');
+        if (iconSetting?.Value) {
+            const icons = SafeJSONParse(iconSetting.Value, false);
+            if (icons) {
+                const result = {};
+                for (const [category, icon] of Object.entries(icons)) {
+                    result[category] = { icon, description: '' };
+                }
+                return result;
+            }
         }
+        return null;
     }
 }
-exports.EntityInfo = EntityInfo;
-EntityInfo.__createdAtFieldName = '__mj_CreatedAt';
-EntityInfo.__updatedAtFieldName = '__mj_UpdatedAt';
-EntityInfo.__deletedAtFieldName = '__mj_DeletedAt';
 // Re-export validation types from @memberjunction/global for backward compatibility
-var global_2 = require("@memberjunction/global");
-Object.defineProperty(exports, "ValidationErrorType", { enumerable: true, get: function () { return global_2.ValidationErrorType; } });
-Object.defineProperty(exports, "ValidationErrorInfo", { enumerable: true, get: function () { return global_2.ValidationErrorInfo; } });
-Object.defineProperty(exports, "ValidationResult", { enumerable: true, get: function () { return global_2.ValidationResult; } });
+export { ValidationErrorType, ValidationErrorInfo, ValidationResult } from '@memberjunction/global';
 /**
  * Information about the link between two entities
  */
-class EntityDependency {
+export class EntityDependency {
 }
-exports.EntityDependency = EntityDependency;
 /**
  * Information about the link between two records
  */
-class RecordDependency {
+export class RecordDependency {
 }
-exports.RecordDependency = RecordDependency;
 /**
  * Information about a merge request including the entity, the surviving record and the records to merge into the surviving record. Additionally, there is an optional field map that can be used to override field values in the surviving record to values specified.
  */
-class RecordMergeRequest {
+export class RecordMergeRequest {
 }
-exports.RecordMergeRequest = RecordMergeRequest;
 /**
  * The result of a merge request for a single record
  */
-class RecordMergeDetailResult {
+export class RecordMergeDetailResult {
 }
-exports.RecordMergeDetailResult = RecordMergeDetailResult;
 /**
  * The result of a merge request
  */
-class RecordMergeResult {
+export class RecordMergeResult {
 }
-exports.RecordMergeResult = RecordMergeResult;
 //# sourceMappingURL=entityInfo.js.map