@memberjunction/codegen-lib 6.1.0-edge.5 → 6.1.0-edge.7

package/dist/Database/field-metadata-lock.js

@@ -0,0 +1,159 @@
+/**
+ * Pure decision function for field metadata updates (Category, GeneratedFormSection,
+ * DisplayName, ExtendedType, CodeType).
+ *
+ * Implements the normative per-column lock table from plan §3.2.
+ * All decisions are pure functions of current field state, proposed values, and lock context.
+ */
+export function computeFieldMetadataUpdate(field, proposal, ctx, validateExtendedType, sanitizeCodeType) {
+    const update = {
+        skipped: [],
+    };
+    // ──────────────────────────────────────────────────────────────────────────
+    // 1. Category & GeneratedFormSection
+    // ──────────────────────────────────────────────────────────────────────────
+    // Override category for system metadata audit fields (__mj_*)
+    const rawProposedCategory = field.Name.startsWith('__mj_')
+        ? 'System Metadata'
+        : proposal.category;
+    if (!field.AutoUpdateCategory) {
+        update.skipped.push({ column: 'Category', reason: 'flag' });
+    }
+    else {
+        const isCurrentCategoryBlank = !field.Category || field.Category.trim() === '';
+        const isAllowedToCategorize = isCurrentCategoryBlank || ctx.isNewEntity;
+        if (!isAllowedToCategorize) {
+            // Existing non-blank category on an existing entity: locked, never moves even between existing categories
+            update.skipped.push({ column: 'Category', reason: 'locked' });
+        }
+        else {
+            if (!rawProposedCategory || rawProposedCategory.trim() === '') {
+                update.skipped.push({ column: 'Category', reason: 'blank-proposal' });
+            }
+            else {
+                const trimmedProposed = rawProposedCategory.trim();
+                if (trimmedProposed === (field.Category ?? '').trim()) {
+                    update.skipped.push({ column: 'Category', reason: 'unchanged' });
+                }
+                else {
+                    update.Category = trimmedProposed;
+                    // GeneratedFormSection is only emitted when Category is emitted
+                    if (field.GeneratedFormSection !== 'Category') {
+                        update.GeneratedFormSection = 'Category';
+                    }
+                }
+            }
+        }
+    }
+    // ──────────────────────────────────────────────────────────────────────────
+    // 2. DisplayName
+    // ──────────────────────────────────────────────────────────────────────────
+    if (!field.AutoUpdateDisplayName) {
+        update.skipped.push({ column: 'DisplayName', reason: 'flag' });
+    }
+    else {
+        const isAllowedDisplayName = ctx.isNewEntity || ctx.isNewField || ctx.descriptionReopened;
+        if (!isAllowedDisplayName) {
+            update.skipped.push({ column: 'DisplayName', reason: 'locked' });
+        }
+        else {
+            if (!proposal.displayName || proposal.displayName.trim() === '') {
+                update.skipped.push({ column: 'DisplayName', reason: 'blank-proposal' });
+            }
+            else {
+                const trimmedProposal = proposal.displayName.trim();
+                if (trimmedProposal === (field.DisplayName ?? '').trim()) {
+                    update.skipped.push({ column: 'DisplayName', reason: 'unchanged' });
+                }
+                else {
+                    update.DisplayName = trimmedProposal;
+                }
+            }
+        }
+    }
+    // ──────────────────────────────────────────────────────────────────────────
+    // 3. ExtendedType
+    // ──────────────────────────────────────────────────────────────────────────
+    if (!field.AutoUpdateExtendedType) {
+        update.skipped.push({ column: 'ExtendedType', reason: 'flag' });
+    }
+    else {
+        const isAllowedExtendedType = ctx.isNewEntity || ctx.isNewField || ctx.typeReopened;
+        if (!isAllowedExtendedType) {
+            update.skipped.push({ column: 'ExtendedType', reason: 'locked' });
+        }
+        else {
+            if (proposal.extendedType === undefined) {
+                update.skipped.push({ column: 'ExtendedType', reason: 'blank-proposal' });
+            }
+            else if (proposal.extendedType === null ||
+                proposal.extendedType.trim() === '' ||
+                proposal.extendedType.trim().toLowerCase() === 'null') {
+                if (field.ExtendedType === null) {
+                    update.skipped.push({ column: 'ExtendedType', reason: 'unchanged' });
+                }
+                else {
+                    update.ExtendedType = null;
+                }
+            }
+            else {
+                const valid = validateExtendedType(proposal.extendedType.trim());
+                const normalizedValueListType = (field.ValueListType || '').trim().toLowerCase();
+                const isValueList = normalizedValueListType !== '' && normalizedValueListType !== 'none';
+                if (!valid || (valid === 'Code' && isValueList)) {
+                    update.skipped.push({ column: 'ExtendedType', reason: 'invalid' });
+                }
+                else {
+                    if (valid === field.ExtendedType) {
+                        update.skipped.push({ column: 'ExtendedType', reason: 'unchanged' });
+                    }
+                    else {
+                        update.ExtendedType = valid;
+                    }
+                }
+            }
+        }
+    }
+    // ──────────────────────────────────────────────────────────────────────────
+    // 4. CodeType (governed by AutoUpdateExtendedType; D6)
+    // ──────────────────────────────────────────────────────────────────────────
+    if (!field.AutoUpdateExtendedType) {
+        update.skipped.push({ column: 'CodeType', reason: 'flag' });
+    }
+    else {
+        const isAllowedCodeType = ctx.isNewEntity || ctx.isNewField || ctx.typeReopened;
+        if (!isAllowedCodeType) {
+            update.skipped.push({ column: 'CodeType', reason: 'locked' });
+        }
+        else {
+            // Determine effective extended type after step 3
+            const effectiveExtendedType = 'ExtendedType' in update ? update.ExtendedType : field.ExtendedType;
+            if (effectiveExtendedType !== 'Code') {
+                // CodeType MUST be null when ExtendedType is not Code
+                if (field.CodeType === null) {
+                    update.skipped.push({ column: 'CodeType', reason: 'unchanged' });
+                }
+                else {
+                    update.CodeType = null;
+                }
+            }
+            else {
+                if (proposal.codeType === undefined) {
+                    update.skipped.push({ column: 'CodeType', reason: 'blank-proposal' });
+                }
+                else {
+                    const sanitized = sanitizeCodeType(proposal.codeType, field.Name);
+                    const resolvedCodeType = sanitized ?? null;
+                    if (resolvedCodeType === field.CodeType) {
+                        update.skipped.push({ column: 'CodeType', reason: 'unchanged' });
+                    }
+                    else {
+                        update.CodeType = resolvedCodeType;
+                    }
+                }
+            }
+        }
+    }
+    return update;
+}
+//# sourceMappingURL=field-metadata-lock.js.map

package/dist/Database/field-metadata-lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-metadata-lock.js","sourceRoot":"","sources":["../../src/Database/field-metadata-lock.ts"],"names":[],"mappings":"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"}

package/dist/Database/manage-metadata.d.ts

@@ -6,6 +6,8 @@ import './providers/sqlserver/SQLServerCodeGenProvider.js';
 import { EntityFieldExtendedType, EntityFieldInfo, EntityInfo, ExternalDataSourceReadRouter, ExternalSchemaObject, FieldCategoryInfo, Metadata, UserInfo } from "@memberjunction/core";
 import { SQLUtilityBase } from "./sql.js";
 import { AdvancedGeneration, SmartFieldIdentificationResult, FormLayoutResult, VirtualEntityDecorationResult } from "../Misc/advanced_generation.js";
+import { FieldChangeReason, EntityFieldSnapshotRow } from './entity-field-change-tracking.js';
+export { TRACKED_FIELD_COLUMNS, FieldChangeReason, DISPLAYNAME_REOPEN_REASONS, TYPE_REOPEN_REASONS, EntityFieldSnapshotRow, EntityFieldChange, diffEntityFieldSnapshots, } from './entity-field-change-tracking.js';
 export declare class ValidatorResult {
     entityName: string;
     fieldName?: string;
@@ -249,6 +251,17 @@ export declare class ManageMetadataBase {
      * SQL Server: 1/0, PostgreSQL: true/false
      */
     protected boolLit(value: boolean): string;
+    /**
+     * Returns an explicitly-typed UUID literal for the platform.
+     * SQL Server: CAST('...' AS uniqueidentifier), PostgreSQL: CAST('...' AS uuid)
+     *
+     * Needed wherever a UUID literal appears in the SELECT list of an `INSERT ... SELECT`. A bare
+     * quoted literal is fine in `INSERT ... VALUES`, where both platforms coerce it to the target
+     * column's type — but in the projection of a SELECT, PostgreSQL can resolve an untyped literal
+     * to `text` and then refuse to assign it to a `uuid` column. `CAST(x AS y)` is ANSI and settles
+     * it on both, with the type name coming from the dialect rather than a platform branch here.
+     */
+    protected uuidLit(value: string): string;
     /**
      * Quotes mixed-case identifiers in a SQL string for the current platform.
      * Delegates to the database provider's quoteSQLForExecution method.
@@ -263,19 +276,17 @@ export declare class ManageMetadataBase {
      */
     protected runQueryWithParams(pool: CodeGenConnection, sql: string, params: Record<string, unknown>): Promise<CodeGenQueryResult>;
     /**
-     * Returns a sequence value safe to use for an EntityField INSERT under the given
-     * EntityID, defaulting to `candidate` when it doesn't collide. Otherwise returns
-     * `MAX(Sequence) + 1` for that entity.
+     * The `Sequence` expression for every EntityField INSERT CodeGen emits:
+     * `(SELECT COALESCE(MAX(Sequence), 0) + 1 FROM EntityField WHERE EntityID = '<id>')`.
      *
-     * Why this exists: several insert paths (virtual-entity field sync, IS-A parent
-     * field sync, schema-derived field creation) compute a deterministic sequence
-     * up-front, but a partial prior run can leave rows at that exact ordinal under
-     * the target EntityID. SS hides the collision because retried runs typically
-     * succeed before failing; PG raises UQ_EntityField_EntityID_Sequence (~4 errors
-     * per advanced-generation run). The values are temporary anyway —
-     * spUpdateExistingEntityFieldsFromSchema renumbers them on the next pass.
+     * Evaluated at APPLY time, never a literal. The value is disposable — the run's own
+     * spUpdateExistingEntityFieldsFromSchema pass and R__RefreshMetadata renumber every field from
+     * the schema — but it must be unique on ANY database in ANY order, because the INSERT is
+     * appended verbatim to a migration and Flyway runs every versioned migration before the
+     * repeatable renumber. Each INSERT re-evaluates MAX after the one before it, so a batch that
+     * executes sequentially in emission order rises in that order (#3670, #4202).
      */
-    protected nextAvailableEntityFieldSequence(pool: CodeGenConnection, entityId: string, candidate: number): Promise<number>;
+    protected applyTimeEntityFieldSequenceSQL(entityID: string): string;
     /**
      * Wraps a SELECT query with a row limit.
      * SQL Server: SELECT TOP N ... , PostgreSQL: SELECT ... LIMIT N
@@ -324,11 +335,39 @@ export declare class ManageMetadataBase {
      * Globally scoped list of entities that have been created during the metadata management process.
      */
     static get newEntityList(): string[];
+    static set newEntityList(value: string[]);
     private static _modifiedEntityList;
     /**
      * Globally scoped list of entities that have been modified during the metadata management process.
      */
     static get modifiedEntityList(): string[];
+    static set modifiedEntityList(value: string[]);
+    private static _newFieldSet;
+    private static _changedFields;
+    private static _changedFieldReport;
+    private static fieldKey;
+    static registerNewField(entityID: string, name: string): void;
+    static registerFieldChange(entityID: string, name: string, reasons: Iterable<FieldChangeReason>): void;
+    static isFieldNew(entityID: string, name: string): boolean;
+    static fieldChangeReasons(entityID: string, name: string): ReadonlySet<FieldChangeReason>;
+    static isDisplayNameReopened(entityID: string, name: string): boolean;
+    static isTypeReopened(entityID: string, name: string): boolean;
+    static get newFieldCount(): number;
+    static get changedFieldCount(): number;
+    static get changedFieldReport(): ReadonlyArray<{
+        entityName: string;
+        fieldName: string;
+        reasons: FieldChangeReason[];
+    }>;
+    static clearFieldTracking(): void;
+    /**
+     * Takes a snapshot of EntityField rows from vwEntityFields for diffing.
+     * Only queries columns in TRACKED_FIELD_COLUMNS (Sequence is excluded).
+     */
+    protected snapshotEntityFields(pool: CodeGenConnection, entityIDs?: string[]): Promise<Map<string, EntityFieldSnapshotRow>>;
+    protected findFieldByName<T extends {
+        Name: string;
+    }>(fields: T[], name: string | null | undefined): T | undefined;
     private static _deletedEntitySchemaList;
     /**
      * Schemas that lost an entity during this run.
@@ -376,7 +415,7 @@ export declare class ManageMetadataBase {
      * Cached per process to avoid repeated I/O within a CodeGen run; the in-process (RSU) path calls
      * {@link invalidateSoftPKFKConfigCache} at the start of each run so a rewritten file is picked up.
      */
-    private static getSoftPKFKConfig;
+    static getSoftPKFKConfig(): Record<string, unknown> | null;
     /**
      * Extracts a flat array of table configs from the config file, handling both formats:
      *   1. Schema-as-key (template format): { "dbo": [{ "TableName": "Orders", ... }] }
@@ -649,8 +688,8 @@ export declare class ManageMetadataBase {
      * INTEGRITY CHECK — in a well-formed entity every base (non-virtual) field sequences BEFORE the
      * virtual/related fields, so the EntityField order matches the base view's `SELECT [base].*, <joins>`
      * column output. The positional save-capture in the data providers (e.g. SQLServerDataProvider's
-     * @ResultTable) relies on that alignment. CodeGen assigns newly-discovered columns a temporary
-     * `maxSequence + 100000` offset that updateExistingEntityFieldsFromSchema is supposed to renumber; if
+     * @ResultTable) relies on that alignment. CodeGen inserts newly-discovered columns at an apply-time
+     * `MAX(Sequence) + ordinal` placeholder that updateExistingEntityFieldsFromSchema is supposed to renumber; if
      * a base column is left sequenced AFTER a virtual field, the save-capture would mis-route values by
      * position. The providers now compensate (saves stay correct), but the metadata is still wrong — so we
      * scan for it after every metadata pass and log a prominent warning to drive the root cause out over time.
@@ -838,7 +877,7 @@ export declare class ManageMetadataBase {
      */
     protected applyLLMFieldDescriptions(pool: CodeGenConnection, entity: EntityInfo, fieldDescriptions: VirtualEntityDecorationResult['fieldDescriptions'], schema: string): Promise<boolean>;
     /**
-     * Valid values for EntityField.ExtendedType, plus common LLM aliases mapped to valid values.
+     * Valid values for EntityField.ExtendedType. Domain lives on {@link EntityFieldInfo.ExtendedTypes}.
      */
     private static readonly VALID_EXTENDED_TYPES;
     private static readonly EXTENDED_TYPE_ALIASES;
@@ -1061,7 +1100,7 @@ export declare class ManageMetadataBase {
      *
      * @returns {string} - The SQL statement to retrieve pending entity fields.
      */
-    protected getPendingEntityFieldsSELECTSQL(entityIDs?: string[]): string;
+    protected getPendingEntityFieldsSELECTSQL(entityIDs?: string[], excludeSchemas?: string[]): string;
     /**
      * This method builds a SQL Statement that will insert a row into the EntityField table with information about a new field.
      * @param n - the new field
@@ -1077,25 +1116,8 @@ export declare class ManageMetadataBase {
      * @param sqlDefaultValue
      * @returns
      */
-    /**
-     * Park existing EntityField.Sequence values out of the 1..N catalog range so a
-     * following INSERT can use the real BaseView column_id without colliding on
-     * UQ_EntityField_EntityID_Sequence. The +100000 band is unique-safe; the
-     * subsequent spUpdateExistingEntityFieldsFromSchema rewrite brings every row
-     * (parked and new) back to live catalog order.
-     *
-     * Parks ONLY when nothing on the entity is parked yet, which is what makes a second
-     * emission for the same entity in the same run a no-op. `Sequence < 100000` alone does
-     * not achieve that: after the first park the rows below the band are precisely the ones
-     * the first pass just INSERTED at their catalog ordinals, so a second park lifts THOSE
-     * into the band — onto the row the first park moved from the same ordinal, and the
-     * migration dies on UQ_EntityField_EntityID_Sequence with a duplicate at 100000+ordinal.
-     * Reachable whenever an entity gains fields in both CodeGen passes: pass 1 for the real
-     * columns, pass 2 for the denormalized name column a new foreign key introduces.
-     */
-    protected parkEntityFieldSequencesSQL(entityID: string): string;
     protected parseDefaultValue(sqlDefaultValue: string): string;
-    protected createNewEntityFieldsFromSchema(pool: CodeGenConnection, entityIDs?: string[]): Promise<boolean>;
+    protected createNewEntityFieldsFromSchema(pool: CodeGenConnection, entityIDs?: string[], excludeSchemas?: string[]): Promise<boolean>;
     /**
      * This method handles updating entity field related name field maps which is basically the process of finding the related entity field that is the "name" field for the related entity.
      * @param ds
@@ -1249,6 +1271,24 @@ export declare class ManageMetadataBase {
      * Shared by both table-backed entity creation and virtual entity creation.
      */
     protected addEntityToApplicationForSchema(pool: CodeGenConnection, entityId: string, entityName: string, schemaName: string, currentUser: UserInfo): Promise<void>;
+    /**
+     * INSERT for one `EntityPermission` row, skipped when a row already exists for that
+     * (EntityID, RoleID, Type).
+     *
+     * The guard is not defensive tidiness — `EntityPermission` carries a UNIQUE constraint on those
+     * three columns (`UQ_EntityPermission_EntityID_RoleID_Type`), so an unguarded INSERT is a failed
+     * CodeGen run rather than a duplicate row. All three call sites are "grant the configured default
+     * permissions", which is naturally re-entrant: an entity re-detected as new, or a second CodeGen
+     * pass over the same entity, reaches them again. Before the constraint existed this silently
+     * accumulated duplicates — a live database showed one (entity, role) pair with rows created three
+     * years apart, and pairs whose verb flags disagreed.
+     *
+     * `Type` is written explicitly rather than left to the column default so the row being inserted
+     * and the row being tested for are keyed identically; a default that changed later would
+     * otherwise put them out of step. Expressed as INSERT ... SELECT ... WHERE NOT EXISTS, which is
+     * valid on both SQL Server and PostgreSQL, so no provider branch is needed.
+     */
+    protected buildEntityPermissionInsertSQL(entityId: string, roleId: string, canRead: boolean, canCreate: boolean, canUpdate: boolean, canDelete: boolean): string;
     /**
      * Adds default permissions for a newly created entity based on config settings.
      * Shared by both table-backed entity creation and virtual entity creation.
@@ -1316,7 +1356,10 @@ export declare class ManageMetadataBase {
      */
     protected entityHasRowLevelSecurity(entity: EntityInfo): boolean;
     /** Pure form of the role-RLS layer (see {@link entityHasRowLevelSecurity}). IO-free so it can be reused
-     *  verbatim by the runtime refresher's equivalent gate. */
+     *  verbatim by the runtime refresher's equivalent gate. Deliberately WIDER than the runtime's own reader
+     *  (`EntityInfo.GetUserRowLevelSecurityInfo` collects a filter only from an Allow row whose `CanRead` is
+     *  set, since #4358): a leftover filter beside a cleared flag still counts as "protected" here, which errs
+     *  conservative for a leak gate. */
     static EntityHasRoleReadRLS(entity: EntityInfo): boolean;
     /**
      * Per-run cache of the entity NAMES (trimmed + lowercased) that an API-KEY row filter
@@ -1475,7 +1518,11 @@ export declare class ManageMetadataBase {
         AutoUpdateAllowUserSearchAPI?: boolean;
         FullTextSearchEnabled?: boolean;
         AutoUpdateFullTextSearch?: boolean;
-    }, fields: Array<Record<string, unknown>>, result: SmartFieldIdentificationResult): Promise<void>;
+    }, fields: Array<Record<string, unknown>>, result: SmartFieldIdentificationResult, ctx?: {
+        isNewEntity: boolean;
+        newFieldNames: ReadonlySet<string>;
+        typeReopenedNames: ReadonlySet<string>;
+    }): Promise<void>;
     /**
      * Apply the code-level search guardrails to the LLM result, mutating
      * `result` in place so every downstream applier reads the normalized
@@ -1530,7 +1577,9 @@ export declare class ManageMetadataBase {
      * `AutoUpdateIsNameField=0` are never touched in either direction — the user owns
      * them, and `EntityInfo.NameField`'s literal-`Name` preference arbitrates at runtime.
      */
-    protected applyNameFieldUpdates(sqlStatements: string[], fields: Array<Record<string, unknown>>, result: SmartFieldIdentificationResult): void;
+    protected applyNameFieldUpdates(sqlStatements: string[], fields: Array<Record<string, unknown>>, result: SmartFieldIdentificationResult, entity?: {
+        Name?: string;
+    }): void;
     /**
      * Picks the single IsNameField winner for an entity per the rules documented on
      * {@link applyNameFieldUpdates}: stable current winner → deterministic repair
@@ -1602,7 +1651,17 @@ export declare class ManageMetadataBase {
     /**
      * Generate SQL UPDATEs for DefaultInView on the identified default view fields
      */
-    protected applyDefaultInViewUpdates(sqlStatements: string[], fields: Array<Record<string, unknown>>, result: SmartFieldIdentificationResult): void;
+    protected applyDefaultInViewUpdates(sqlStatements: string[], fields: Array<Record<string, unknown>>, result: SmartFieldIdentificationResult, entityOrCtx?: {
+        Name?: string;
+    } | {
+        isNewEntity: boolean;
+        newFieldNames: ReadonlySet<string>;
+        typeReopenedNames: ReadonlySet<string>;
+    }, maybeCtx?: {
+        isNewEntity: boolean;
+        newFieldNames: ReadonlySet<string>;
+        typeReopenedNames: ReadonlySet<string>;
+    }): void;
     /**
      * Generate SQL UPDATEs for IncludeInUserSearchAPI on the identified searchable fields.
      *
@@ -1615,7 +1674,12 @@ export declare class ManageMetadataBase {
      * every search.
      */
     protected applySearchableFieldUpdates(sqlStatements: string[], fields: Array<Record<string, unknown>>, result: SmartFieldIdentificationResult, entity?: {
+        Name?: string;
         FullTextSearchEnabled?: boolean;
+    }, ctx?: {
+        isNewEntity: boolean;
+        newFieldNames: ReadonlySet<string>;
+        typeReopenedNames: ReadonlySet<string>;
     }): void;
     /**
      * Returns true if the field is a sensible target for LIKE-based user search.
@@ -1626,7 +1690,17 @@ export declare class ManageMetadataBase {
     /**
      * Generate SQL UPDATEs for UserSearchPredicateAPI on each searchable field
      */
-    protected applySearchPredicateUpdates(sqlStatements: string[], fields: Array<Record<string, unknown>>, result: SmartFieldIdentificationResult): void;
+    protected applySearchPredicateUpdates(sqlStatements: string[], fields: Array<Record<string, unknown>>, result: SmartFieldIdentificationResult, entityOrCtx?: {
+        Name?: string;
+    } | {
+        isNewEntity: boolean;
+        newFieldNames: ReadonlySet<string>;
+        typeReopenedNames: ReadonlySet<string>;
+    }, maybeCtx?: {
+        isNewEntity: boolean;
+        newFieldNames: ReadonlySet<string>;
+        typeReopenedNames: ReadonlySet<string>;
+    }): void;
     /**
      * Generate SQL UPDATEs for entity-level AllowUserSearchAPI.
      *
@@ -1655,9 +1729,14 @@ export declare class ManageMetadataBase {
      */
     protected applyFullTextSearchUpdates(sqlStatements: string[], entity: {
         ID: string;
+        Name?: string;
         FullTextSearchEnabled?: boolean;
         AutoUpdateFullTextSearch?: boolean;
-    }, fields: Array<Record<string, unknown>>, result: SmartFieldIdentificationResult): void;
+    }, fields: Array<Record<string, unknown>>, result: SmartFieldIdentificationResult, ctx?: {
+        isNewEntity: boolean;
+        newFieldNames: ReadonlySet<string>;
+        typeReopenedNames: ReadonlySet<string>;
+    }): void;
     /**
      * Apply form layout generation results to set category on entity fields.
      * Delegates to shared methods for category assignment, icon, and category info persistence.
@@ -1673,20 +1752,19 @@ export declare class ManageMetadataBase {
         Category: string | null;
         AutoUpdateCategory: boolean;
         AutoUpdateDisplayName: boolean;
+        AutoUpdateExtendedType: boolean;
         GeneratedFormSection: string;
         DisplayName: string;
         ExtendedType: string;
         CodeType: string;
+        ValueListType?: string | null;
     }>, result: FormLayoutResult, isNewEntity?: boolean): Promise<void>;
     /**
-     * Detect if an entity has geo-capable fields based on LLM-assigned ExtendedType values.
+     * Detect if an entity has geo-capable fields based on persisted ExtendedType values in the database.
      * If any field has a Geo* ExtendedType, set Entity.SupportsGeoCoding = 1.
      * Respects the AutoUpdateSupportsGeoCoding flag — if 0, the value is locked.
      */
-    protected detectAndSetGeoCodingSupport(pool: CodeGenConnection, entity: EntityInfo, fieldCategories: Array<{
-        fieldName: string;
-        extendedType: EntityFieldExtendedType | null;
-    }>): Promise<void>;
+    protected detectAndSetGeoCodingSupport(pool: CodeGenConnection, entity: EntityInfo): Promise<void>;
     /**
      * Builds a set of existing category names from entity fields.
      * Used to enforce category stability (prevent renaming).
@@ -1714,10 +1792,12 @@ export declare class ManageMetadataBase {
         Category: string | null;
         AutoUpdateCategory: boolean;
         AutoUpdateDisplayName: boolean;
+        AutoUpdateExtendedType: boolean;
         GeneratedFormSection: string;
         DisplayName: string;
-        ExtendedType: string;
-        CodeType: string;
+        ExtendedType: string | null;
+        CodeType: string | null;
+        ValueListType?: string | null;
     }>, fieldCategories: Array<{
         fieldName: string;
         category: string;
@@ -1725,15 +1805,17 @@ export declare class ManageMetadataBase {
         extendedType?: string | null;
         codeType?: string | null;
         reason?: string;
-    }>, existingCategories: Set<string>): Promise<void>;
+    }>, existingCategories: Set<string>, ctx: {
+        isNewEntity: boolean;
+    }): Promise<void>;
     /**
      * Sets the entity icon if the entity doesn't already have one.
      */
-    protected applyEntityIcon(pool: CodeGenConnection, entityId: string, entityIcon: string): Promise<void>;
+    protected applyEntityIcon(pool: CodeGenConnection, entityId: string, entityIcon: string, entityName?: string): Promise<void>;
     /**
      * Upserts FieldCategoryInfo (new format) and FieldCategoryIcons (legacy format) in EntitySetting.
      */
-    protected applyCategoryInfoSettings(pool: CodeGenConnection, entityId: string, categoryInfo: Record<string, FieldCategoryInfo>): Promise<void>;
+    protected applyCategoryInfoSettings(pool: CodeGenConnection, entityId: string, categoryInfo: Record<string, FieldCategoryInfo>, _entityName?: string): Promise<void>;
     /**
      * Applies entity importance analysis to MJApplicationEntity records.
      * Only called for NEW entities to set DefaultForNewUser.
@@ -1743,7 +1825,7 @@ export declare class ManageMetadataBase {
         entityCategory: string;
         confidence: string;
         reasoning: string;
-    }): Promise<void>;
+    }, entityName?: string): Promise<void>;
     /**
      * Executes the given SQL query using the given ConnectionPool object.
      * If the appendToLogFile parameter is true, the query will also be appended to the log file.