@memberjunction/global 2.115.0 → 2.117.0

package/dist/index.d.ts

@@ -9,6 +9,7 @@ export * from './util/PatternUtils';
 export * from './ValidationTypes';
 export * from './JSONValidator';
 export * from './SafeExpressionEvaluator';
+export * from './warningManager';
 export * from './Global';
 export * from './RegisterClass';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAChE,cAAc,aAAa,CAAA;AAC3B,cAAc,QAAQ,CAAA;AACtB,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,2BAA2B,CAAA;AAGzC,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAChE,cAAc,aAAa,CAAA;AAC3B,cAAc,QAAQ,CAAA;AACtB,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,2BAA2B,CAAA;AACzC,cAAc,kBAAkB,CAAA;AAGhC,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA"}

package/dist/index.js

@@ -29,6 +29,7 @@ __exportStar(require("./util/PatternUtils"), exports);
 __exportStar(require("./ValidationTypes"), exports);
 __exportStar(require("./JSONValidator"), exports);
 __exportStar(require("./SafeExpressionEvaluator"), exports);
+__exportStar(require("./warningManager"), exports);
 // Export the main classes
 __exportStar(require("./Global"), exports);
 __exportStar(require("./RegisterClass"), exports);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,iCAAiC;AACjC,+CAAgE;AAAvD,4GAAA,YAAY,OAAA;AAAE,iHAAA,iBAAiB,OAAA;AACxC,8CAA2B;AAC3B,yCAAsB;AACtB,gDAA6B;AAC7B,kDAA+B;AAC/B,6CAA0B;AAC1B,+CAA4B;AAC5B,sDAAoC;AACpC,oDAAiC;AACjC,kDAA+B;AAC/B,4DAAyC;AAEzC,0BAA0B;AAC1B,2CAAwB;AACxB,kDAA+B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,iCAAiC;AACjC,+CAAgE;AAAvD,4GAAA,YAAY,OAAA;AAAE,iHAAA,iBAAiB,OAAA;AACxC,8CAA2B;AAC3B,yCAAsB;AACtB,gDAA6B;AAC7B,kDAA+B;AAC/B,6CAA0B;AAC1B,+CAA4B;AAC5B,sDAAoC;AACpC,oDAAiC;AACjC,kDAA+B;AAC/B,4DAAyC;AACzC,mDAAgC;AAEhC,0BAA0B;AAC1B,2CAAwB;AACxB,kDAA+B"}

package/dist/warningManager.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Manages various types of warnings across the MemberJunction system.
+ *
+ * Features:
+ * - Session-level tracking: Each warning shown once per session
+ * - Debounced output: Groups warnings and displays after a quiet period
+ * - Formatted output: Tree-structured, grouped by entity and warning type
+ * - Configurable: Control debounce timing and behavior via options
+ * - Multiple warning types: Deprecation, field-not-found, and extensible for more
+ *
+ * @example
+ * ```typescript
+ * const wm = WarningManager.Instance;
+ * wm.RecordEntityDeprecationWarning('User Preferences', 'BaseEntity::constructor');
+ * wm.RecordFieldDeprecationWarning('AI Prompts', 'OldField', 'AIPromptEntity::validate');
+ * wm.RecordFieldNotFoundWarning('Users', 'DeletedColumn', 'BaseEntity::SetMany');
+ * // Warnings will be flushed automatically after debounce period
+ * ```
+ */
+/**
+ * Configuration options for the warning system
+ */
+export interface WarningConfig {
+    /**
+     * Time in milliseconds to wait after last warning before flushing output.
+     * Default: 10000 (10 seconds)
+     */
+    DebounceMs: number;
+    /**
+     * If true, shows every occurrence of warnings (ignores session tracking).
+     * Default: false
+     */
+    ShowAll: boolean;
+    /**
+     * If true, disables all warnings.
+     * Default: false
+     */
+    DisableWarnings: boolean;
+    /**
+     * If true, groups warnings and displays them in formatted tree structure.
+     * If false, displays warnings immediately as they occur.
+     * Default: true
+     */
+    GroupWarnings: boolean;
+}
+/**
+ * Singleton class that manages warnings across the entire application session.
+ * Tracks which warnings have been shown and batches them for clean, grouped output.
+ */
+export declare class WarningManager {
+    private static instance;
+    private warnedDeprecatedEntities;
+    private warnedDeprecatedFields;
+    private warnedFieldNotFound;
+    private pendingEntityDeprecationWarnings;
+    private pendingFieldDeprecationWarnings;
+    private pendingFieldNotFoundWarnings;
+    private debounceTimer;
+    private config;
+    private constructor();
+    /**
+     * Gets the singleton instance of the WarningManager
+     */
+    static get Instance(): WarningManager;
+    /**
+     * Updates the configuration for the warning system.
+     * This allows runtime customization of behavior.
+     */
+    UpdateConfig(config: Partial<WarningConfig>): void;
+    /**
+     * Gets the current configuration
+     */
+    GetConfig(): Readonly<WarningConfig>;
+    /**
+     * Records a deprecation warning for an entity.
+     *
+     * @param entityName - The name of the deprecated entity
+     * @param callerName - The name of the caller (e.g., 'BaseEntity::constructor')
+     * @returns true if this warning should be emitted immediately (when ShowAll is true)
+     */
+    RecordEntityDeprecationWarning(entityName: string, callerName: string): boolean;
+    /**
+     * Records a deprecation warning for an entity field.
+     *
+     * @param entityName - The name of the entity containing the deprecated field
+     * @param fieldName - The name of the deprecated field
+     * @param callerName - The name of the caller (e.g., 'AIPromptEntity::validate')
+     * @returns true if this warning should be emitted immediately (when ShowAll is true)
+     */
+    RecordFieldDeprecationWarning(entityName: string, fieldName: string, callerName: string): boolean;
+    /**
+     * Records a warning when a field is not found in an entity definition.
+     * This typically occurs during data loading when source data contains fields
+     * that don't exist in the entity schema.
+     *
+     * @param entityName - The name of the entity where the field was not found
+     * @param fieldName - The name of the field that was not found
+     * @param context - Context description (e.g., 'BaseEntity::SetMany during data load')
+     * @returns true if this warning should be emitted immediately (when ShowAll is true)
+     */
+    RecordFieldNotFoundWarning(entityName: string, fieldName: string, context: string): boolean;
+    /**
+     * Schedules a flush of pending warnings after the debounce period.
+     * Resets the timer if new warnings arrive.
+     */
+    private scheduleFlush;
+    /**
+     * Immediately flushes all pending warnings to the console.
+     * Can be called manually to force output before the debounce period.
+     */
+    FlushWarnings(): void;
+    /**
+     * Internal method that formats and outputs all pending warnings.
+     */
+    private flushWarnings;
+    /**
+     * Resets all tracking state. Useful for testing or starting fresh.
+     * Does NOT clear pending warnings - call FlushWarnings first if needed.
+     */
+    Reset(): void;
+}
+/**
+ * @deprecated Use WarningManager instead. This alias is provided for backward compatibility.
+ */
+export declare const DeprecationWarningManager: typeof WarningManager;
+//# sourceMappingURL=warningManager.d.ts.map

package/dist/warningManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warningManager.d.ts","sourceRoot":"","sources":["../src/warningManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,eAAe,EAAE,OAAO,CAAC;IAEzB;;;;OAIG;IACH,aAAa,EAAE,OAAO,CAAC;CAC1B;AA4BD;;;GAGG;AACH,qBAAa,cAAc;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiB;IAGxC,OAAO,CAAC,wBAAwB,CAA0B;IAC1D,OAAO,CAAC,sBAAsB,CAAuC;IAGrE,OAAO,CAAC,mBAAmB,CAAuC;IAGlE,OAAO,CAAC,gCAAgC,CAA2D;IACnG,OAAO,CAAC,+BAA+B,CAA4D;IACnG,OAAO,CAAC,4BAA4B,CAAyD;IAE7F,OAAO,CAAC,aAAa,CAA+B;IAEpD,OAAO,CAAC,MAAM,CAAgB;IAE9B,OAAO;IAUP;;OAEG;IACH,WAAkB,QAAQ,IAAI,cAAc,CAK3C;IAED;;;OAGG;IACI,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI;IAIzD;;OAEG;IACI,SAAS,IAAI,QAAQ,CAAC,aAAa,CAAC;IAI3C;;;;;;OAMG;IACI,8BAA8B,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IA2CtF;;;;;;;OAOG;IACI,6BAA6B,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IA8DxG;;;;;;;;;OASG;IACI,0BAA0B,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IA8DlG;;;OAGG;IACH,OAAO,CAAC,aAAa;IAYrB;;;OAGG;IACI,aAAa,IAAI,IAAI;IAQ5B;;OAEG;IACH,OAAO,CAAC,aAAa;IAuHrB;;;OAGG;IACI,KAAK,IAAI,IAAI;CAavB;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB,uBAAiB,CAAC"}

package/dist/warningManager.js

@@ -0,0 +1,373 @@
+"use strict";
+/**
+ * Manages various types of warnings across the MemberJunction system.
+ *
+ * Features:
+ * - Session-level tracking: Each warning shown once per session
+ * - Debounced output: Groups warnings and displays after a quiet period
+ * - Formatted output: Tree-structured, grouped by entity and warning type
+ * - Configurable: Control debounce timing and behavior via options
+ * - Multiple warning types: Deprecation, field-not-found, and extensible for more
+ *
+ * @example
+ * ```typescript
+ * const wm = WarningManager.Instance;
+ * wm.RecordEntityDeprecationWarning('User Preferences', 'BaseEntity::constructor');
+ * wm.RecordFieldDeprecationWarning('AI Prompts', 'OldField', 'AIPromptEntity::validate');
+ * wm.RecordFieldNotFoundWarning('Users', 'DeletedColumn', 'BaseEntity::SetMany');
+ * // Warnings will be flushed automatically after debounce period
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeprecationWarningManager = exports.WarningManager = void 0;
+/**
+ * Singleton class that manages warnings across the entire application session.
+ * Tracks which warnings have been shown and batches them for clean, grouped output.
+ */
+class WarningManager {
+    constructor() {
+        // Tracking for deprecation warnings
+        this.warnedDeprecatedEntities = new Set();
+        this.warnedDeprecatedFields = new Map(); // entityName -> Set<fieldName>
+        // Tracking for field-not-found warnings
+        this.warnedFieldNotFound = new Map(); // entityName -> Set<fieldName>
+        // Pending warnings by type
+        this.pendingEntityDeprecationWarnings = new Map();
+        this.pendingFieldDeprecationWarnings = new Map();
+        this.pendingFieldNotFoundWarnings = new Map();
+        this.debounceTimer = null;
+        // Initialize with default configuration
+        this.config = {
+            DebounceMs: 10000,
+            ShowAll: false,
+            DisableWarnings: false,
+            GroupWarnings: true
+        };
+    }
+    /**
+     * Gets the singleton instance of the WarningManager
+     */
+    static get Instance() {
+        if (!WarningManager.instance) {
+            WarningManager.instance = new WarningManager();
+        }
+        return WarningManager.instance;
+    }
+    /**
+     * Updates the configuration for the warning system.
+     * This allows runtime customization of behavior.
+     */
+    UpdateConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+    /**
+     * Gets the current configuration
+     */
+    GetConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Records a deprecation warning for an entity.
+     *
+     * @param entityName - The name of the deprecated entity
+     * @param callerName - The name of the caller (e.g., 'BaseEntity::constructor')
+     * @returns true if this warning should be emitted immediately (when ShowAll is true)
+     */
+    RecordEntityDeprecationWarning(entityName, callerName) {
+        if (this.config.DisableWarnings) {
+            return false;
+        }
+        const key = entityName;
+        const alreadyWarned = this.warnedDeprecatedEntities.has(key);
+        if (this.config.ShowAll) {
+            // Emit immediately, don't track or queue
+            console.warn(`Entity "${entityName}" is deprecated and should not be used as it could be removed in the future. (Called from: ${callerName})`);
+            return true;
+        }
+        if (!this.config.GroupWarnings) {
+            // Emit immediately if not grouping, but still track to avoid duplicates
+            if (!alreadyWarned) {
+                console.warn(`Entity "${entityName}" is deprecated and should not be used as it could be removed in the future. (Called from: ${callerName})`);
+                this.warnedDeprecatedEntities.add(key);
+            }
+            return !alreadyWarned;
+        }
+        // Group warnings - only queue if we haven't warned about this entity yet
+        if (!alreadyWarned) {
+            this.warnedDeprecatedEntities.add(key);
+            // Add to pending warnings
+            if (!this.pendingEntityDeprecationWarnings.has(key)) {
+                this.pendingEntityDeprecationWarnings.set(key, {
+                    entityName,
+                    callerNames: new Set()
+                });
+            }
+            this.pendingEntityDeprecationWarnings.get(key).callerNames.add(callerName);
+            this.scheduleFlush();
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Records a deprecation warning for an entity field.
+     *
+     * @param entityName - The name of the entity containing the deprecated field
+     * @param fieldName - The name of the deprecated field
+     * @param callerName - The name of the caller (e.g., 'AIPromptEntity::validate')
+     * @returns true if this warning should be emitted immediately (when ShowAll is true)
+     */
+    RecordFieldDeprecationWarning(entityName, fieldName, callerName) {
+        if (this.config.DisableWarnings) {
+            return false;
+        }
+        // Check if we've already warned about this specific field
+        const entityFields = this.warnedDeprecatedFields.get(entityName);
+        const alreadyWarned = entityFields?.has(fieldName) || false;
+        if (this.config.ShowAll) {
+            // Emit immediately, don't track or queue
+            console.warn(`Entity Field "${entityName}.${fieldName}" is deprecated and should not be used as it could be removed in the future. (Called from: ${callerName})`);
+            return true;
+        }
+        if (!this.config.GroupWarnings) {
+            // Emit immediately if not grouping, but still track to avoid duplicates
+            if (!alreadyWarned) {
+                console.warn(`Entity Field "${entityName}.${fieldName}" is deprecated and should not be used as it could be removed in the future. (Called from: ${callerName})`);
+                if (!this.warnedDeprecatedFields.has(entityName)) {
+                    this.warnedDeprecatedFields.set(entityName, new Set());
+                }
+                this.warnedDeprecatedFields.get(entityName).add(fieldName);
+            }
+            return !alreadyWarned;
+        }
+        // Group warnings - only queue if we haven't warned about this field yet
+        if (!alreadyWarned) {
+            // Mark as warned
+            if (!this.warnedDeprecatedFields.has(entityName)) {
+                this.warnedDeprecatedFields.set(entityName, new Set());
+            }
+            this.warnedDeprecatedFields.get(entityName).add(fieldName);
+            // Add to pending warnings
+            if (!this.pendingFieldDeprecationWarnings.has(entityName)) {
+                this.pendingFieldDeprecationWarnings.set(entityName, []);
+            }
+            const fieldWarnings = this.pendingFieldDeprecationWarnings.get(entityName);
+            let fieldWarning = fieldWarnings.find(fw => fw.fieldName === fieldName);
+            if (!fieldWarning) {
+                fieldWarning = {
+                    entityName,
+                    fieldName,
+                    callerNames: new Set()
+                };
+                fieldWarnings.push(fieldWarning);
+            }
+            fieldWarning.callerNames.add(callerName);
+            this.scheduleFlush();
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Records a warning when a field is not found in an entity definition.
+     * This typically occurs during data loading when source data contains fields
+     * that don't exist in the entity schema.
+     *
+     * @param entityName - The name of the entity where the field was not found
+     * @param fieldName - The name of the field that was not found
+     * @param context - Context description (e.g., 'BaseEntity::SetMany during data load')
+     * @returns true if this warning should be emitted immediately (when ShowAll is true)
+     */
+    RecordFieldNotFoundWarning(entityName, fieldName, context) {
+        if (this.config.DisableWarnings) {
+            return false;
+        }
+        // Check if we've already warned about this specific field
+        const entityFields = this.warnedFieldNotFound.get(entityName);
+        const alreadyWarned = entityFields?.has(fieldName) || false;
+        if (this.config.ShowAll) {
+            // Emit immediately, don't track or queue
+            console.warn(`Field "${fieldName}" does not exist on entity "${entityName}". Context: ${context}`);
+            return true;
+        }
+        if (!this.config.GroupWarnings) {
+            // Emit immediately if not grouping, but still track to avoid duplicates
+            if (!alreadyWarned) {
+                console.warn(`Field "${fieldName}" does not exist on entity "${entityName}". Context: ${context}`);
+                if (!this.warnedFieldNotFound.has(entityName)) {
+                    this.warnedFieldNotFound.set(entityName, new Set());
+                }
+                this.warnedFieldNotFound.get(entityName).add(fieldName);
+            }
+            return !alreadyWarned;
+        }
+        // Group warnings - only queue if we haven't warned about this field yet
+        if (!alreadyWarned) {
+            // Mark as warned
+            if (!this.warnedFieldNotFound.has(entityName)) {
+                this.warnedFieldNotFound.set(entityName, new Set());
+            }
+            this.warnedFieldNotFound.get(entityName).add(fieldName);
+            // Add to pending warnings
+            if (!this.pendingFieldNotFoundWarnings.has(entityName)) {
+                this.pendingFieldNotFoundWarnings.set(entityName, []);
+            }
+            const fieldWarnings = this.pendingFieldNotFoundWarnings.get(entityName);
+            let fieldWarning = fieldWarnings.find(fw => fw.fieldName === fieldName);
+            if (!fieldWarning) {
+                fieldWarning = {
+                    entityName,
+                    fieldName,
+                    contexts: new Set()
+                };
+                fieldWarnings.push(fieldWarning);
+            }
+            fieldWarning.contexts.add(context);
+            this.scheduleFlush();
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Schedules a flush of pending warnings after the debounce period.
+     * Resets the timer if new warnings arrive.
+     */
+    scheduleFlush() {
+        // Clear existing timer
+        if (this.debounceTimer) {
+            clearTimeout(this.debounceTimer);
+        }
+        // Schedule new flush
+        this.debounceTimer = setTimeout(() => {
+            this.flushWarnings();
+        }, this.config.DebounceMs);
+    }
+    /**
+     * Immediately flushes all pending warnings to the console.
+     * Can be called manually to force output before the debounce period.
+     */
+    FlushWarnings() {
+        if (this.debounceTimer) {
+            clearTimeout(this.debounceTimer);
+            this.debounceTimer = null;
+        }
+        this.flushWarnings();
+    }
+    /**
+     * Internal method that formats and outputs all pending warnings.
+     */
+    flushWarnings() {
+        const hasEntityDeprecationWarnings = this.pendingEntityDeprecationWarnings.size > 0;
+        const hasFieldDeprecationWarnings = this.pendingFieldDeprecationWarnings.size > 0;
+        const hasFieldNotFoundWarnings = this.pendingFieldNotFoundWarnings.size > 0;
+        if (!hasEntityDeprecationWarnings && !hasFieldDeprecationWarnings && !hasFieldNotFoundWarnings) {
+            return; // Nothing to flush
+        }
+        const lines = [];
+        // Output deprecation warnings if any
+        if (hasEntityDeprecationWarnings || hasFieldDeprecationWarnings) {
+            lines.push('');
+            lines.push('⚠️  DEPRECATION WARNINGS - The following entities/fields are deprecated and may be removed in future versions:');
+            lines.push('');
+            // Output entity deprecation warnings
+            if (hasEntityDeprecationWarnings) {
+                lines.push('📦 DEPRECATED ENTITIES:');
+                const sortedEntities = Array.from(this.pendingEntityDeprecationWarnings.values())
+                    .sort((a, b) => a.entityName.localeCompare(b.entityName));
+                for (const warning of sortedEntities) {
+                    const callers = Array.from(warning.callerNames).sort().join(', ');
+                    lines.push(`  • "${warning.entityName}" (called from: ${callers})`);
+                }
+                lines.push('');
+            }
+            // Output field deprecation warnings
+            if (hasFieldDeprecationWarnings) {
+                lines.push('📋 DEPRECATED ENTITY FIELDS:');
+                const sortedEntityNames = Array.from(this.pendingFieldDeprecationWarnings.keys()).sort();
+                for (let i = 0; i < sortedEntityNames.length; i++) {
+                    const entityName = sortedEntityNames[i];
+                    const fieldWarnings = this.pendingFieldDeprecationWarnings.get(entityName);
+                    const isLast = i === sortedEntityNames.length - 1;
+                    const entityPrefix = isLast ? '└─' : '├─';
+                    lines.push(`  ${entityPrefix} "${entityName}"`);
+                    // Sort field warnings by field name
+                    const sortedFields = fieldWarnings.sort((a, b) => a.fieldName.localeCompare(b.fieldName));
+                    for (let j = 0; j < sortedFields.length; j++) {
+                        const fieldWarning = sortedFields[j];
+                        const isLastField = j === sortedFields.length - 1;
+                        const fieldPrefix = isLastField ? '└─' : '├─';
+                        const continuation = isLast ? ' ' : '│';
+                        const callers = Array.from(fieldWarning.callerNames).sort().join(', ');
+                        lines.push(`  ${continuation}  ${fieldPrefix} ${fieldWarning.fieldName} (called from: ${callers})`);
+                    }
+                    if (!isLast) {
+                        lines.push(`  │`);
+                    }
+                }
+                lines.push('');
+            }
+            lines.push('💡 Set ShowAll=true in configuration to see every occurrence.');
+            lines.push('');
+        }
+        // Output field-not-found warnings if any
+        if (hasFieldNotFoundWarnings) {
+            lines.push('');
+            lines.push('⚠️  DATA INTEGRITY WARNINGS - The following fields were not found in entity definitions:');
+            lines.push('');
+            lines.push('📋 MISSING FIELDS:');
+            const sortedEntityNames = Array.from(this.pendingFieldNotFoundWarnings.keys()).sort();
+            for (let i = 0; i < sortedEntityNames.length; i++) {
+                const entityName = sortedEntityNames[i];
+                const fieldWarnings = this.pendingFieldNotFoundWarnings.get(entityName);
+                const isLast = i === sortedEntityNames.length - 1;
+                const entityPrefix = isLast ? '└─' : '├─';
+                lines.push(`  ${entityPrefix} "${entityName}"`);
+                // Sort field warnings by field name
+                const sortedFields = fieldWarnings.sort((a, b) => a.fieldName.localeCompare(b.fieldName));
+                for (let j = 0; j < sortedFields.length; j++) {
+                    const fieldWarning = sortedFields[j];
+                    const isLastField = j === sortedFields.length - 1;
+                    const fieldPrefix = isLastField ? '└─' : '├─';
+                    const continuation = isLast ? ' ' : '│';
+                    const contexts = Array.from(fieldWarning.contexts).sort().join(', ');
+                    lines.push(`  ${continuation}  ${fieldPrefix} ${fieldWarning.fieldName} (context: ${contexts})`);
+                }
+                if (!isLast) {
+                    lines.push(`  │`);
+                }
+            }
+            lines.push('');
+            lines.push('💡 These fields exist in your data but not in the entity schema. This may indicate:');
+            lines.push('   • Schema is out of sync with database');
+            lines.push('   • Data contains legacy fields that were removed');
+            lines.push('   • Field names have been changed');
+            lines.push('');
+        }
+        // Output all lines at once
+        console.warn(lines.join('\n'));
+        // Clear pending warnings
+        this.pendingEntityDeprecationWarnings.clear();
+        this.pendingFieldDeprecationWarnings.clear();
+        this.pendingFieldNotFoundWarnings.clear();
+    }
+    /**
+     * Resets all tracking state. Useful for testing or starting fresh.
+     * Does NOT clear pending warnings - call FlushWarnings first if needed.
+     */
+    Reset() {
+        this.warnedDeprecatedEntities.clear();
+        this.warnedDeprecatedFields.clear();
+        this.warnedFieldNotFound.clear();
+        this.pendingEntityDeprecationWarnings.clear();
+        this.pendingFieldDeprecationWarnings.clear();
+        this.pendingFieldNotFoundWarnings.clear();
+        if (this.debounceTimer) {
+            clearTimeout(this.debounceTimer);
+            this.debounceTimer = null;
+        }
+    }
+}
+exports.WarningManager = WarningManager;
+/**
+ * @deprecated Use WarningManager instead. This alias is provided for backward compatibility.
+ */
+exports.DeprecationWarningManager = WarningManager;
+//# sourceMappingURL=warningManager.js.map

package/dist/warningManager.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memberjunction/global",
-  "version": "2.115.0",
+  "version": "2.117.0",
   "description": "MemberJunction: Global Object - Needed for ALL other MJ components",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/readme.md

@@ -19,6 +19,7 @@ The `@memberjunction/global` library serves as the foundation for cross-componen
 - **Class Reflection Utilities** - Runtime class hierarchy inspection and analysis
 - **Deep Diff Engine** - Comprehensive object comparison and change tracking
 - **JSON Validator** - Lightweight JSON validation with flexible rules and special syntax
+- **Warning Manager** - Smart warning system with debouncing, batching, and session tracking
 - **Utility Functions** - Common string manipulation, JSON parsing (including recursive nested JSON parsing), pattern matching, and formatting utilities
 
 ## Core Components
@@ -650,6 +651,110 @@ const html = ConvertMarkdownStringToHtmlList('Unordered', '- Item 1\n- Item 2\n-
 // Returns: <ul><li>Item 1</li><li>Item 2</li><li>Item 3</li></ul>
 ```
 
+### Warning Manager
+
+The Warning Manager provides intelligent warning batching and deduplication for console messages across your application. It tracks warnings per session, groups them by type, and displays them in clean, formatted output after a configurable debounce period.
+
+#### Features
+
+- **Session-level tracking** - Each warning shown only once per session
+- **Debounced output** - Groups warnings and displays after a configurable quiet period (default 10s)
+- **Multiple warning types** - Supports deprecation warnings and data integrity warnings
+- **Beautiful formatting** - Tree-structured console output with emojis and clear grouping
+- **Configurable** - Runtime API and environment variables for customization
+- **Backward compatible** - `DeprecationWarningManager` alias provided
+
+#### Basic Usage
+
+```typescript
+import { WarningManager } from '@memberjunction/global';
+
+const wm = WarningManager.Instance;
+
+// Record deprecation warnings
+wm.RecordEntityDeprecationWarning('LegacyEntity', 'MyComponent::method');
+wm.RecordFieldDeprecationWarning('Users', 'OldField', 'DataLoader::process');
+
+// Record field-not-found warnings (data integrity issues)
+wm.RecordFieldNotFoundWarning('Users', 'DeletedColumn', 'BaseEntity::SetMany during import');
+
+// Warnings are automatically batched and displayed after debounce period
+// Or manually flush immediately:
+wm.FlushWarnings();
+```
+
+#### Example Output
+
+```
+⚠️  DEPRECATION WARNINGS - The following entities/fields are deprecated and may be removed in future versions:
+
+📦 DEPRECATED ENTITIES:
+  • "LegacyEntity" (called from: MyComponent::method)
+
+📋 DEPRECATED ENTITY FIELDS:
+  └─ "Users"
+     └─ OldField (called from: DataLoader::process)
+
+💡 Set ShowAll=true in configuration to see every occurrence.
+
+
+⚠️  DATA INTEGRITY WARNINGS - The following fields were not found in entity definitions:
+
+📋 MISSING FIELDS:
+  └─ "Users"
+     └─ DeletedColumn (context: BaseEntity::SetMany during import)
+
+💡 These fields exist in your data but not in the entity schema. This may indicate:
+   • Schema is out of sync with database
+   • Data contains legacy fields that were removed
+   • Field names have been changed
+```
+
+#### Configuration
+
+Configure via runtime API:
+
+```typescript
+wm.UpdateConfig({
+  DebounceMs: 5000,        // Wait 5 seconds after last warning
+  ShowAll: false,          // Show each warning once per session (default)
+  DisableWarnings: false,  // Enable warnings (default)
+  GroupWarnings: true      // Group warnings in tree format (default)
+});
+
+// Get current configuration
+const config = wm.GetConfig();
+```
+
+All configuration is done via the runtime API.
+
+#### Warning Types
+
+**Deprecation Warnings** indicate entities or fields that may be removed in future versions:
+- `RecordEntityDeprecationWarning(entityName, callerName)` - Deprecated entity
+- `RecordFieldDeprecationWarning(entityName, fieldName, callerName)` - Deprecated field
+
+**Data Integrity Warnings** indicate mismatches between data and schema:
+- `RecordFieldNotFoundWarning(entityName, fieldName, context)` - Field exists in data but not in schema
+
+#### Advanced Usage
+
+```typescript
+// Reset all tracking (useful for testing)
+wm.Reset();
+
+// Backward compatibility - DeprecationWarningManager is an alias
+import { DeprecationWarningManager } from '@memberjunction/global';
+const dwm = DeprecationWarningManager.Instance; // Same as WarningManager.Instance
+```
+
+#### Use Cases
+
+1. **Framework-level warnings** - Alert developers about deprecated APIs
+2. **Data migration** - Track fields that don't match current schema
+3. **Development debugging** - Identify outdated code patterns
+4. **Testing** - Verify no deprecated features are used
+
 ### Safe Expression Evaluator
 
 Secure boolean expression evaluation for conditional logic without allowing arbitrary code execution: