@memberjunction/global 2.63.0 → 2.63.1

package/dist/__tests__/ClassUtils.test.js

@@ -0,0 +1,173 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const ClassUtils_1 = require("../ClassUtils");
+// Test class hierarchy
+class Animal {
+    constructor() {
+        this.name = '';
+    }
+}
+class Mammal extends Animal {
+    constructor() {
+        super(...arguments);
+        this.furColor = '';
+    }
+}
+class Dog extends Mammal {
+    constructor() {
+        super(...arguments);
+        this.breed = '';
+    }
+}
+class GoldenRetriever extends Dog {
+    constructor() {
+        super(...arguments);
+        this.temperament = 'friendly';
+    }
+}
+// Test cases
+describe('ClassUtils', () => {
+    describe('GetSuperclass', () => {
+        it('should return immediate superclass', () => {
+            expect((0, ClassUtils_1.GetSuperclass)(GoldenRetriever)).toBe(Dog);
+            expect((0, ClassUtils_1.GetSuperclass)(Dog)).toBe(Mammal);
+            expect((0, ClassUtils_1.GetSuperclass)(Mammal)).toBe(Animal);
+            expect((0, ClassUtils_1.GetSuperclass)(Animal)).toBe(null);
+        });
+        it('should handle invalid inputs', () => {
+            expect((0, ClassUtils_1.GetSuperclass)(null)).toBe(null);
+            expect((0, ClassUtils_1.GetSuperclass)(undefined)).toBe(null);
+            expect((0, ClassUtils_1.GetSuperclass)({})).toBe(null);
+            expect((0, ClassUtils_1.GetSuperclass)('not a class')).toBe(null);
+        });
+    });
+    describe('GetRootClass', () => {
+        it('should return the root class', () => {
+            expect((0, ClassUtils_1.GetRootClass)(GoldenRetriever)).toBe(Animal);
+            expect((0, ClassUtils_1.GetRootClass)(Dog)).toBe(Animal);
+            expect((0, ClassUtils_1.GetRootClass)(Animal)).toBe(Animal);
+        });
+        it('should handle classes without inheritance', () => {
+            class Standalone {
+            }
+            expect((0, ClassUtils_1.GetRootClass)(Standalone)).toBe(Standalone);
+        });
+    });
+    describe('IsSubclassOf', () => {
+        it('should correctly identify subclass relationships', () => {
+            expect((0, ClassUtils_1.IsSubclassOf)(GoldenRetriever, Dog)).toBe(true);
+            expect((0, ClassUtils_1.IsSubclassOf)(GoldenRetriever, Mammal)).toBe(true);
+            expect((0, ClassUtils_1.IsSubclassOf)(GoldenRetriever, Animal)).toBe(true);
+            expect((0, ClassUtils_1.IsSubclassOf)(Dog, Animal)).toBe(true);
+        });
+        it('should return false for non-subclass relationships', () => {
+            expect((0, ClassUtils_1.IsSubclassOf)(Animal, Dog)).toBe(false);
+            expect((0, ClassUtils_1.IsSubclassOf)(Dog, GoldenRetriever)).toBe(false);
+            expect((0, ClassUtils_1.IsSubclassOf)(Dog, Dog)).toBe(false); // Not a subclass of itself
+        });
+        it('should handle invalid inputs', () => {
+            expect((0, ClassUtils_1.IsSubclassOf)(null, Animal)).toBe(false);
+            expect((0, ClassUtils_1.IsSubclassOf)(Dog, null)).toBe(false);
+            expect((0, ClassUtils_1.IsSubclassOf)('not a class', Animal)).toBe(false);
+        });
+    });
+    describe('IsRootClass', () => {
+        it('should identify root classes', () => {
+            expect((0, ClassUtils_1.IsRootClass)(Animal)).toBe(true);
+            class StandaloneClass {
+            }
+            expect((0, ClassUtils_1.IsRootClass)(StandaloneClass)).toBe(true);
+        });
+        it('should return false for classes with superclasses', () => {
+            expect((0, ClassUtils_1.IsRootClass)(GoldenRetriever)).toBe(false);
+            expect((0, ClassUtils_1.IsRootClass)(Dog)).toBe(false);
+            expect((0, ClassUtils_1.IsRootClass)(Mammal)).toBe(false);
+        });
+        it('should handle invalid inputs', () => {
+            expect((0, ClassUtils_1.IsRootClass)(null)).toBe(false);
+            expect((0, ClassUtils_1.IsRootClass)(undefined)).toBe(false);
+            expect((0, ClassUtils_1.IsRootClass)(42)).toBe(false);
+            expect((0, ClassUtils_1.IsRootClass)('string')).toBe(false);
+            expect((0, ClassUtils_1.IsRootClass)({})).toBe(false);
+        });
+    });
+    describe('IsDescendantClassOf', () => {
+        it('should work identically to IsSubclassOf', () => {
+            // Test direct parent
+            expect((0, ClassUtils_1.IsDescendantClassOf)(GoldenRetriever, Dog)).toBe(true);
+            expect((0, ClassUtils_1.IsDescendantClassOf)(Dog, Mammal)).toBe(true);
+            // Test grandparent and beyond
+            expect((0, ClassUtils_1.IsDescendantClassOf)(GoldenRetriever, Mammal)).toBe(true);
+            expect((0, ClassUtils_1.IsDescendantClassOf)(GoldenRetriever, Animal)).toBe(true);
+            // Test non-relationships
+            expect((0, ClassUtils_1.IsDescendantClassOf)(Animal, GoldenRetriever)).toBe(false);
+            expect((0, ClassUtils_1.IsDescendantClassOf)(Dog, Dog)).toBe(false);
+        });
+    });
+    describe('GetClassInheritance', () => {
+        it('should return inheritance chain', () => {
+            const chain = (0, ClassUtils_1.GetClassInheritance)(GoldenRetriever);
+            expect(chain.length).toBe(3);
+            expect(chain[0].name).toBe('Dog');
+            expect(chain[0].reference).toBe(Dog);
+            expect(chain[1].name).toBe('Mammal');
+            expect(chain[1].reference).toBe(Mammal);
+            expect(chain[2].name).toBe('Animal');
+            expect(chain[2].reference).toBe(Animal);
+        });
+        it('should return empty array for base classes', () => {
+            const chain = (0, ClassUtils_1.GetClassInheritance)(Animal);
+            expect(chain.length).toBe(0);
+        });
+    });
+    describe('GetFullClassHierarchy', () => {
+        it('should include the class itself', () => {
+            const hierarchy = (0, ClassUtils_1.GetFullClassHierarchy)(GoldenRetriever);
+            expect(hierarchy.length).toBe(4);
+            expect(hierarchy[0].name).toBe('GoldenRetriever');
+            expect(hierarchy[0].reference).toBe(GoldenRetriever);
+            expect(hierarchy[1].name).toBe('Dog');
+            expect(hierarchy[2].name).toBe('Mammal');
+            expect(hierarchy[3].name).toBe('Animal');
+        });
+    });
+    describe('IsClassConstructor', () => {
+        it('should identify class constructors', () => {
+            expect((0, ClassUtils_1.IsClassConstructor)(Animal)).toBe(true);
+            expect((0, ClassUtils_1.IsClassConstructor)(GoldenRetriever)).toBe(true);
+        });
+        it('should reject non-constructors', () => {
+            expect((0, ClassUtils_1.IsClassConstructor)(() => { })).toBe(false);
+            expect((0, ClassUtils_1.IsClassConstructor)(function regularFunction() { })).toBe(false);
+            expect((0, ClassUtils_1.IsClassConstructor)(42)).toBe(false);
+            expect((0, ClassUtils_1.IsClassConstructor)('string')).toBe(false);
+            expect((0, ClassUtils_1.IsClassConstructor)({})).toBe(false);
+        });
+        it('should handle constructor functions', () => {
+            function OldStyleClass() {
+                this.property = 'value';
+            }
+            OldStyleClass.prototype.method = function () { };
+            expect((0, ClassUtils_1.IsClassConstructor)(OldStyleClass)).toBe(true);
+        });
+    });
+    describe('GetClassName', () => {
+        it('should get class names', () => {
+            expect((0, ClassUtils_1.GetClassName)(Animal)).toBe('Animal');
+            expect((0, ClassUtils_1.GetClassName)(GoldenRetriever)).toBe('GoldenRetriever');
+        });
+        it('should handle anonymous classes', () => {
+            const AnonClass = class {
+            };
+            // Note: This might return 'AnonClass' or 'Anonymous' depending on environment
+            const name = (0, ClassUtils_1.GetClassName)(AnonClass);
+            expect(['AnonClass', 'Anonymous'].includes(name)).toBe(true);
+        });
+        it('should handle invalid inputs', () => {
+            expect((0, ClassUtils_1.GetClassName)(null)).toBe('Unknown');
+            expect((0, ClassUtils_1.GetClassName)(undefined)).toBe('Unknown');
+            expect((0, ClassUtils_1.GetClassName)(42)).toBe('Unknown');
+        });
+    });
+});
+//# sourceMappingURL=ClassUtils.test.js.map

package/dist/__tests__/ClassUtils.test.js.map

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

package/dist/index.d.ts

@@ -1,66 +1,10 @@
-import * as MJ from './interface';
-import { Observable } from 'rxjs';
-import { ClassFactory } from './ClassFactory';
-import { ObjectCache } from './ObjectCache';
-import { BaseSingleton } from './BaseSingleton';
 export { ClassFactory, ClassRegistration } from './ClassFactory';
 export * from './interface';
 export * from './util';
 export * from './ObjectCache';
 export * from './BaseSingleton';
 export * from './DeepDiff';
-/**
- * Global class used for coordinating events, creating class instances, and managing components across MemberJunction
- */
-export declare class MJGlobal extends BaseSingleton<MJGlobal> {
-    private _eventsSubject;
-    private _eventsReplaySubject;
-    private _events$;
-    private _eventsReplay$;
-    private _components;
-    private _classFactory;
-    private _properties;
-    /**
-     * Returns the global instance of the MJGlobal class. This is a singleton class, so there is only one instance of it in the application. Do not directly create new instances of MJGlobal, always use this method to get the instance.
-     */
-    static get Instance(): MJGlobal;
-    RegisterComponent(component: MJ.IMJComponent): void;
-    /**
-     * Resets the class to its initial state. Use very carefully and sparingly.
-     */
-    Reset(): void;
-    /**
-     * Use this method to raise an event to all component who are listening for the event.
-     * @param event
-     */
-    RaiseEvent(event: MJ.MJEvent): void;
-    /**
-     * Use this method to get an observable that will fire when an event is raised.
-     * @param withReplay
-     * @returns
-     */
-    GetEventListener(withReplay?: boolean): Observable<MJ.MJEvent>;
-    /**
-     * Returns the instance of ClassFactory you should use in your application. Access this via the MJGlobal.Instance.ClassFactory property.
-     */
-    get ClassFactory(): ClassFactory;
-    /**
-     * Global property bag
-     */
-    get Properties(): MJ.MJGlobalProperty[];
-    private _objectCache;
-    /**
-     * ObjectCache can be used to cache objects as needed by any application in memory. These objects are NOT persisted to disk or any other storage medium, so they are only good for the lifetime of the application
-     */
-    get ObjectCache(): ObjectCache;
-}
-/**
- * Decorate your class with this to register it with the MJGlobal class factory.
- * @param baseClass
- * @param key a string that is later used to retrieve a given registration - this should be unique for each baseClass/key combination, if multiple registrations exist for a given baseClass/key combination, the highest priority registration will be used to create class instances
- * @param priority Higher priority registrations will be used over lower priority registrations. If there are multiple registrations for a given base class/sub-class/key combination, the one with the highest priority will be used. If there are multiple registrations with the same priority, the last one registered will be used. Finally, if you do NOT provide this setting, the order of registrations will increment the priority automatically so dependency injection will typically care care of this. That is, in order for Class B, a subclass of Class A, to be registered properly, Class A code has to already have been loaded and therefore Class A's RegisterClass decorator was run. In that scenario, if neither Class A or B has a priority setting, Class A would be 1 and Class B would be 2 automatically. For this reason, you only need to explicitly set priority if you want to do something atypical as this mechanism normally will solve for setting the priority correctly based on the furthest descendant class that is registered.
- * @param skipNullKeyWarning If true, will not print a warning if the key is null or undefined. This is useful for cases where you know that the key is not needed and you don't want to see the warning in the console.
- * @returns an instance of the class that was registered for the combination of baseClass/key (with highest priority if more than one)
- */
-export declare function RegisterClass(baseClass: any, key?: string, priority?: number, skipNullKeyWarning?: boolean): (constructor: Function) => void;
+export * from './ClassUtils';
+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":"AAAA,OAAO,KAAK,EAAE,MAAM,aAAa,CAAA;AAEjC,OAAO,EAA0B,UAAU,EAAE,MAAM,MAAM,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAqB,MAAM,gBAAgB,CAAA;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,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;AAE1B;;GAEG;AACH,qBAAa,QAAS,SAAQ,aAAa,CAAC,QAAQ,CAAC;IAEjD,OAAO,CAAC,cAAc,CAAsC;IAC5D,OAAO,CAAC,oBAAoB,CAAkD;IAG9E,OAAO,CAAC,QAAQ,CAA8D;IAC9E,OAAO,CAAC,cAAc,CAAoE;IAE1F,OAAO,CAAC,WAAW,CAAyB;IAE5C,OAAO,CAAC,aAAa,CAAoC;IAEzD,OAAO,CAAC,WAAW,CAA6B;IAEhD;;OAEG;IACH,WAAkB,QAAQ,IAAI,QAAQ,CAErC;IAEM,iBAAiB,CAAC,SAAS,EAAE,EAAE,CAAC,YAAY;IAInD;;OAEG;IACI,KAAK;IAWZ;;;OAGG;IACI,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO;IAKnC;;;;OAIG;IACI,gBAAgB,CAAC,UAAU,GAAE,OAAe,GAAG,UAAU,CAAC,EAAE,CAAC,OAAO,CAAC;IAI5E;;OAEG;IACH,IAAW,YAAY,IAAI,YAAY,CAEtC;IAED;;OAEG;IACH,IAAW,UAAU,IAAI,EAAE,CAAC,gBAAgB,EAAE,CAE7C;IAGD,OAAO,CAAC,YAAY,CAAkC;IACtD;;OAEG;IACH,IAAW,WAAW,IAAI,WAAW,CAEpC;CACJ;AAID;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,GAAE,MAAa,EAAE,QAAQ,GAAE,MAAU,EAAE,kBAAkB,GAAE,OAAe,GAAG,CAAC,WAAW,EAAE,QAAQ,KAAK,IAAI,CAK5J"}
+{"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;AAG5B,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA"}

package/dist/index.js

@@ -14,105 +14,18 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RegisterClass = exports.MJGlobal = exports.ClassRegistration = exports.ClassFactory = void 0;
-const rxjs_1 = require("rxjs");
-const ClassFactory_1 = require("./ClassFactory");
-const ObjectCache_1 = require("./ObjectCache");
-const BaseSingleton_1 = require("./BaseSingleton");
-var ClassFactory_2 = require("./ClassFactory");
-Object.defineProperty(exports, "ClassFactory", { enumerable: true, get: function () { return ClassFactory_2.ClassFactory; } });
-Object.defineProperty(exports, "ClassRegistration", { enumerable: true, get: function () { return ClassFactory_2.ClassRegistration; } });
+exports.ClassRegistration = exports.ClassFactory = void 0;
+// Export all types and utilities
+var ClassFactory_1 = require("./ClassFactory");
+Object.defineProperty(exports, "ClassFactory", { enumerable: true, get: function () { return ClassFactory_1.ClassFactory; } });
+Object.defineProperty(exports, "ClassRegistration", { enumerable: true, get: function () { return ClassFactory_1.ClassRegistration; } });
 __exportStar(require("./interface"), exports);
 __exportStar(require("./util"), exports);
 __exportStar(require("./ObjectCache"), exports);
 __exportStar(require("./BaseSingleton"), exports);
 __exportStar(require("./DeepDiff"), exports);
-/**
- * Global class used for coordinating events, creating class instances, and managing components across MemberJunction
- */
-class MJGlobal extends BaseSingleton_1.BaseSingleton {
-    constructor() {
-        super(...arguments);
-        // subjects for observables to handle eventing
-        this._eventsSubject = new rxjs_1.Subject();
-        this._eventsReplaySubject = new rxjs_1.ReplaySubject();
-        // Convert the Subjects to Observables for public use.
-        this._events$ = this._eventsSubject.asObservable();
-        this._eventsReplay$ = this._eventsReplaySubject.asObservable();
-        this._components = [];
-        this._classFactory = new ClassFactory_1.ClassFactory();
-        this._properties = [];
-        this._objectCache = new ObjectCache_1.ObjectCache();
-    }
-    /**
-     * Returns the global instance of the MJGlobal class. This is a singleton class, so there is only one instance of it in the application. Do not directly create new instances of MJGlobal, always use this method to get the instance.
-     */
-    static get Instance() {
-        return super.getInstance();
-    }
-    RegisterComponent(component) {
-        this._components.push(component);
-    }
-    /**
-     * Resets the class to its initial state. Use very carefully and sparingly.
-     */
-    Reset() {
-        this._components = [];
-        this._eventsSubject = new rxjs_1.Subject();
-        this._eventsReplaySubject = new rxjs_1.ReplaySubject();
-        // Convert the Subjects to Observables for public use.
-        this._events$ = this._eventsSubject.asObservable();
-        this._eventsReplay$ = this._eventsReplaySubject.asObservable();
-    }
-    /**
-     * Use this method to raise an event to all component who are listening for the event.
-     * @param event
-     */
-    RaiseEvent(event) {
-        this._eventsSubject.next(event);
-        this._eventsReplaySubject.next(event);
-    }
-    /**
-     * Use this method to get an observable that will fire when an event is raised.
-     * @param withReplay
-     * @returns
-     */
-    GetEventListener(withReplay = false) {
-        return withReplay ? this._eventsReplay$ : this._events$;
-    }
-    /**
-     * Returns the instance of ClassFactory you should use in your application. Access this via the MJGlobal.Instance.ClassFactory property.
-     */
-    get ClassFactory() {
-        return this._classFactory;
-    }
-    /**
-     * Global property bag
-     */
-    get Properties() {
-        return this._properties;
-    }
-    /**
-     * ObjectCache can be used to cache objects as needed by any application in memory. These objects are NOT persisted to disk or any other storage medium, so they are only good for the lifetime of the application
-     */
-    get ObjectCache() {
-        return this._objectCache;
-    }
-}
-exports.MJGlobal = MJGlobal;
-/**
- * Decorate your class with this to register it with the MJGlobal class factory.
- * @param baseClass
- * @param key a string that is later used to retrieve a given registration - this should be unique for each baseClass/key combination, if multiple registrations exist for a given baseClass/key combination, the highest priority registration will be used to create class instances
- * @param priority Higher priority registrations will be used over lower priority registrations. If there are multiple registrations for a given base class/sub-class/key combination, the one with the highest priority will be used. If there are multiple registrations with the same priority, the last one registered will be used. Finally, if you do NOT provide this setting, the order of registrations will increment the priority automatically so dependency injection will typically care care of this. That is, in order for Class B, a subclass of Class A, to be registered properly, Class A code has to already have been loaded and therefore Class A's RegisterClass decorator was run. In that scenario, if neither Class A or B has a priority setting, Class A would be 1 and Class B would be 2 automatically. For this reason, you only need to explicitly set priority if you want to do something atypical as this mechanism normally will solve for setting the priority correctly based on the furthest descendant class that is registered.
- * @param skipNullKeyWarning If true, will not print a warning if the key is null or undefined. This is useful for cases where you know that the key is not needed and you don't want to see the warning in the console.
- * @returns an instance of the class that was registered for the combination of baseClass/key (with highest priority if more than one)
- */
-function RegisterClass(baseClass, key = null, priority = 0, skipNullKeyWarning = false) {
-    return function (constructor) {
-        // Invoke the registration method
-        MJGlobal.Instance.ClassFactory.Register(baseClass, constructor, key, priority, skipNullKeyWarning);
-    };
-}
-exports.RegisterClass = RegisterClass;
+__exportStar(require("./ClassUtils"), exports);
+// Export the main classes
+__exportStar(require("./Global"), exports);
+__exportStar(require("./RegisterClass"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAEA,+BAA0D;AAC1D,iDAAgE;AAChE,+CAA4C;AAC5C,mDAAgD;AAEhD,+CAAgE;AAAvD,4GAAA,YAAY,OAAA;AAAE,iHAAA,iBAAiB,OAAA;AACxC,8CAA2B;AAC3B,yCAAsB;AACtB,gDAA6B;AAC7B,kDAA+B;AAC/B,6CAA0B;AAE1B;;GAEG;AACH,MAAa,QAAS,SAAQ,6BAAuB;IAArD;;QACI,8CAA8C;QACtC,mBAAc,GAAwB,IAAI,cAAO,EAAE,CAAC;QACpD,yBAAoB,GAA8B,IAAI,oBAAa,EAAE,CAAC;QAE9E,sDAAsD;QAC9C,aAAQ,GAA2B,IAAI,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC;QACtE,mBAAc,GAA2B,IAAI,CAAC,oBAAoB,CAAC,YAAY,EAAE,CAAC;QAElF,gBAAW,GAAsB,EAAE,CAAC;QAEpC,kBAAa,GAAiB,IAAI,2BAAY,EAAE,CAAC;QAEjD,gBAAW,GAA0B,EAAE,CAAC;QA4DxC,iBAAY,GAAgB,IAAI,yBAAW,EAAE,CAAC;IAO1D,CAAC;IAjEG;;OAEG;IACI,MAAM,KAAK,QAAQ;QACtB,OAAO,KAAK,CAAC,WAAW,EAAY,CAAC;IACzC,CAAC;IAEM,iBAAiB,CAAC,SAA0B;QAC/C,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACI,KAAK;QACR,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;QAEtB,IAAI,CAAC,cAAc,GAAI,IAAI,cAAO,EAAE,CAAC;QACrC,IAAI,CAAC,oBAAoB,GAAG,IAAI,oBAAa,EAAE,CAAC;QAEhD,sDAAsD;QACtD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC;QACnD,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,oBAAoB,CAAC,YAAY,EAAE,CAAC;IACnE,CAAC;IAED;;;OAGG;IACI,UAAU,CAAC,KAAiB;QAC/B,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACI,gBAAgB,CAAC,aAAsB,KAAK;QAC/C,OAAO,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,IAAW,YAAY;QACnB,OAAO,IAAI,CAAC,aAAa,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,IAAW,UAAU;QACjB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC5B,CAAC;IAID;;OAEG;IACH,IAAW,WAAW;QAClB,OAAO,IAAI,CAAC,YAAY,CAAC;IAC7B,CAAC;CACJ;AAhFD,4BAgFC;AAID;;;;;;;GAOG;AACH,SAAgB,aAAa,CAAC,SAAc,EAAE,MAAc,IAAI,EAAE,WAAmB,CAAC,EAAE,qBAA8B,KAAK;IACvH,OAAO,UAAU,WAAqB;QAClC,iCAAiC;QACjC,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,EAAE,QAAQ,EAAE,kBAAkB,CAAC,CAAC;IACvG,CAAC,CAAA;AACL,CAAC;AALD,sCAKC"}
+{"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;AAE5B,0BAA0B;AAC1B,2CAAwB;AACxB,kDAA+B"}

package/package.json

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

package/readme.md

@@ -13,9 +13,11 @@ npm install @memberjunction/global
 The `@memberjunction/global` library serves as the foundation for cross-component communication and coordination in MemberJunction applications. It provides:
 
 - **Global Singleton Management** - Ensures true singleton instances across module boundaries
-- **Class Factory System** - Dynamic class registration and instantiation with inheritance support
+- **Class Factory System** - Dynamic class registration and instantiation with automatic root class detection
 - **Event System** - RxJS-based event bus for component communication
 - **Object Caching** - In-memory object cache for application lifetime
+- **Class Reflection Utilities** - Runtime class hierarchy inspection and analysis
+- **Deep Diff Engine** - Comprehensive object comparison and change tracking
 - **Utility Functions** - Common string manipulation, JSON parsing (including recursive nested JSON parsing), and formatting utilities
 
 ## Core Components
@@ -54,21 +56,27 @@ const replaySubscription = mjGlobal.GetEventListener(true).subscribe(event => {
 
 ### Class Factory System
 
-Register and instantiate classes dynamically with support for inheritance and key-based selection.
+Register and instantiate classes dynamically with automatic root class detection and inheritance chain support.
 
 ```typescript
 import { RegisterClass, MJGlobal } from '@memberjunction/global';
 
-// Define a base class
+// Define a base class hierarchy
 class BaseProcessor {
   process(data: any): void {
     console.log('Base processing');
   }
 }
 
-// Register a subclass using the decorator
-@RegisterClass(BaseProcessor, 'custom', 100)
-class CustomProcessor extends BaseProcessor {
+class SpecialProcessor extends BaseProcessor {
+  process(data: any): void {
+    console.log('Special processing');
+  }
+}
+
+// Register a subclass - automatically registers with root class (BaseProcessor)
+@RegisterClass(SpecialProcessor, 'custom')
+class CustomProcessor extends SpecialProcessor {
   process(data: any): void {
     console.log('Custom processing');
   }
@@ -78,6 +86,15 @@ class CustomProcessor extends BaseProcessor {
 const factory = MJGlobal.Instance.ClassFactory;
 const processor = factory.CreateInstance<BaseProcessor>(BaseProcessor, 'custom');
 processor.process(data); // Uses CustomProcessor
+
+// Key Features:
+// 1. Auto-registers with root class by default (BaseProcessor in this case)
+// 2. Ensures proper priority ordering in inheritance chains
+// 3. Can opt-out with autoRegisterWithRootClass: false
+@RegisterClass(SpecialProcessor, 'special', 0, false, false) // Last param disables auto-root registration
+class DirectRegistration extends SpecialProcessor {
+  // This registers directly to SpecialProcessor, not BaseProcessor
+}
 ```
 
 ### Object Cache
@@ -127,6 +144,117 @@ const service = MyService.Instance;
 service.addData('example');
 ```
 
+### Class Reflection Utilities
+
+Runtime utilities for inspecting and analyzing class hierarchies.
+
+```typescript
+import { 
+  GetSuperclass, 
+  GetRootClass, 
+  IsSubclassOf,
+  IsRootClass,
+  IsDescendantClassOf,
+  GetClassInheritance,
+  GetFullClassHierarchy,
+  IsClassConstructor,
+  GetClassName
+} from '@memberjunction/global';
+
+// Example class hierarchy
+class Animal {}
+class Mammal extends Animal {}
+class Dog extends Mammal {}
+class GoldenRetriever extends Dog {}
+
+// Get immediate superclass
+const parent = GetSuperclass(GoldenRetriever); // Returns: Dog
+
+// Get root class of hierarchy
+const root = GetRootClass(GoldenRetriever); // Returns: Animal
+
+// Check inheritance relationships
+IsSubclassOf(GoldenRetriever, Animal); // true (checks entire chain)
+IsDescendantClassOf(GoldenRetriever, Animal); // true (alias for IsSubclassOf)
+IsRootClass(Animal); // true
+IsRootClass(Dog); // false
+
+// Get inheritance chain
+const chain = GetClassInheritance(GoldenRetriever);
+// Returns: [
+//   { name: 'Dog', reference: Dog },
+//   { name: 'Mammal', reference: Mammal },
+//   { name: 'Animal', reference: Animal }
+// ]
+
+// Get full hierarchy including the class itself
+const fullChain = GetFullClassHierarchy(GoldenRetriever);
+// Returns: [
+//   { name: 'GoldenRetriever', reference: GoldenRetriever },
+//   { name: 'Dog', reference: Dog },
+//   { name: 'Mammal', reference: Mammal },
+//   { name: 'Animal', reference: Animal }
+// ]
+
+// Utility functions
+IsClassConstructor(Dog); // true
+IsClassConstructor(() => {}); // false
+GetClassName(GoldenRetriever); // "GoldenRetriever"
+```
+
+### Deep Diff Engine
+
+Comprehensive object comparison and change tracking with hierarchical diff visualization.
+
+```typescript
+import { DeepDiffer, DiffChangeType } from '@memberjunction/global';
+
+// Create a differ instance
+const differ = new DeepDiffer({
+  includeUnchanged: false,  // Don't track unchanged values
+  maxDepth: 10,             // Maximum recursion depth
+  maxStringLength: 100      // Truncate long strings
+});
+
+// Compare two objects
+const oldData = {
+  user: { name: 'John', age: 30, role: 'admin' },
+  settings: { theme: 'dark', notifications: true },
+  tags: ['important', 'active']
+};
+
+const newData = {
+  user: { name: 'John', age: 31, role: 'superadmin' },
+  settings: { theme: 'light', notifications: true, language: 'en' },
+  tags: ['important', 'active', 'premium']
+};
+
+// Get the diff
+const result = differ.diff(oldData, newData);
+
+// Access summary
+console.log(result.summary);
+// { added: 2, removed: 0, modified: 3, unchanged: 3, total: 8 }
+
+// Iterate through changes
+result.changes.forEach(change => {
+  console.log(`${change.path}: ${change.type} - ${change.description}`);
+});
+// Output:
+// user.age: Modified - Changed from 30 to 31
+// user.role: Modified - Changed from "admin" to "superadmin"
+// settings.theme: Modified - Changed from "dark" to "light"
+// settings.language: Added - Value: "en"
+// tags[2]: Added - Value: "premium"
+
+// Filter changes by type
+const additions = result.changes.filter(c => c.type === DiffChangeType.Added);
+const modifications = result.changes.filter(c => c.type === DiffChangeType.Modified);
+
+// Update configuration on the fly
+differ.updateConfig({ includeUnchanged: true });
+```
+
 ## Event Types
 
 The library provides predefined event types for common scenarios:
@@ -255,6 +383,45 @@ InvokeManualResize(50, myComponent);
 
 ## Advanced Usage
 
+### Class Factory with Root Class Detection
+
+The Class Factory automatically detects and uses root classes for registration, ensuring proper priority ordering in inheritance hierarchies:
+
+```typescript
+class BaseEntity {} // Root class
+
+class UserEntity extends BaseEntity {}
+
+// This automatically registers with BaseEntity (the root)
+@RegisterClass(UserEntity, 'Admin')
+class AdminUserEntity extends UserEntity {}
+
+// Also registers with BaseEntity, gets higher priority
+@RegisterClass(AdminUserEntity, 'SuperAdmin')  
+class SuperAdminEntity extends AdminUserEntity {}
+
+// All of these create SuperAdminEntity (highest priority)
+factory.CreateInstance(BaseEntity, 'SuperAdmin');      // ✓ Works
+factory.CreateInstance(UserEntity, 'SuperAdmin');      // ✓ Works  
+factory.CreateInstance(AdminUserEntity, 'SuperAdmin'); // ✓ Works
+```
+
+### Disabling Auto-Root Registration
+
+Sometimes you want to register at a specific level in the hierarchy:
+
+```typescript
+// Register directly to UserEntity, not BaseEntity
+@RegisterClass(UserEntity, 'Special', 0, false, false) // Last param = false
+class SpecialUserEntity extends UserEntity {
+  // This only matches when creating from UserEntity, not BaseEntity
+}
+
+// Direct registration queries
+factory.CreateInstance(UserEntity, 'Special');   // ✓ Returns SpecialUserEntity
+factory.CreateInstance(BaseEntity, 'Special');   // ✗ Returns BaseEntity instance
+```
+
 ### Class Factory with Parameters
 
 ```typescript
@@ -289,6 +456,23 @@ class AdvancedDataHandler extends BaseHandler {}
 const handler = factory.CreateInstance<BaseHandler>(BaseHandler, 'data');
 ```
 
+### Inspecting Registrations
+
+```typescript
+// Get all registrations for a base class
+const registrations = factory.GetAllRegistrations(BaseEntity, 'Users');
+
+// Get registrations by root class
+const rootRegistrations = factory.GetRegistrationsByRootClass(BaseEntity);
+
+// Each registration contains:
+// - BaseClass: The class it's registered to (usually root)
+// - SubClass: The actual implementation class
+// - RootClass: The detected root of the hierarchy
+// - Key: The registration key
+// - Priority: The priority number
+```
+
 ### Global Properties
 
 Store and retrieve global properties: