@memberjunction/global 2.62.0 → 2.63.1

package/dist/ClassFactory.d.ts

@@ -11,6 +11,7 @@
 export declare class ClassRegistration {
     BaseClass: any;
     SubClass: any;
+    RootClass: any;
     Key: string;
     Priority: number;
 }
@@ -27,10 +28,12 @@ export declare class ClassFactory {
      * @param key A key can be used to differentiate registrations for the same base class/sub-class combination. For example, in the case of BaseEntity and Entity object subclasses we'll have a LOT of entries and we want to get the highest priority registered sub-class for a specific key. In that case, the key is the entity name, but the key can be any value you want to use to differentiate registrations.
      * @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.
+     * @param autoRegisterWithRootClass If true (default), will automatically register the subclass with the root class of the baseClass hierarchy. This ensures proper priority ordering when multiple subclasses are registered in a hierarchy.
      */
-    Register(baseClass: any, subClass: any, key?: string, priority?: number, skipNullKeyWarning?: boolean): void;
+    Register(baseClass: any, subClass: any, key?: string, priority?: number, skipNullKeyWarning?: boolean, autoRegisterWithRootClass?: boolean): void;
     /**
-     * Creates an instance of the class registered for the given base class and key. If no registration is found, will return an instance of the base class.
+     * Creates an instance of the class registered for the given base class and key.
+     * If no registration is found, will return an instance of the base class.
      */
     CreateInstance<T>(baseClass: any, key?: string, ...params: any[]): T | null;
     /**
@@ -44,5 +47,13 @@ export declare class ClassFactory {
      * Returns the registration with the highest priority for a given base class and key. If key is not provided, will return the registration with the highest priority for the base class.
      */
     GetRegistration(baseClass: any, key?: string): ClassRegistration;
+    /**
+     * Returns all registrations that have the specified root class, regardless of what base class was used in the registration.
+     * This is useful for finding all registrations in a class hierarchy.
+     * @param rootClass The root class to search for
+     * @param key Optional key to filter results
+     * @returns Array of matching registrations
+     */
+    GetRegistrationsByRootClass(rootClass: any, key?: string): ClassRegistration[];
 }
 //# sourceMappingURL=ClassFactory.d.ts.map

package/dist/ClassFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ClassFactory.d.ts","sourceRoot":"","sources":["../src/ClassFactory.ts"],"names":[],"mappings":"AAAA;;;;;;wGAMwG;AAExG;;GAEG;AACH,qBAAa,iBAAiB;IAC1B,SAAS,EAAE,GAAG,CAAA;IACd,QAAQ,EAAE,GAAG,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IAEX,QAAQ,EAAE,MAAM,CAAA;CACnB;AAGD;;;GAGG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,cAAc,CAA2B;IAEjD;;;;;;;OAOG;IACI,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,GAAE,MAAa,EAAE,QAAQ,GAAE,MAAU,EAAE,kBAAkB,GAAE,OAAe,GAAG,IAAI;IAuCnI;;OAEG;IACI,cAAc,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,GAAE,MAAa,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI;IAqBxF;;;;;OAKG;IACI,mBAAmB,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,GAAE,MAAkB,GAAG,iBAAiB,EAAE;IAWxF;;OAEG;IACI,eAAe,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,GAAE,MAAkB,GAAG,iBAAiB;CAmBrF"}
+{"version":3,"file":"ClassFactory.d.ts","sourceRoot":"","sources":["../src/ClassFactory.ts"],"names":[],"mappings":"AAAA;;;;;;wGAMwG;AAIxG;;GAEG;AACH,qBAAa,iBAAiB;IAC1B,SAAS,EAAE,GAAG,CAAA;IACd,QAAQ,EAAE,GAAG,CAAA;IACb,SAAS,EAAE,GAAG,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IAEX,QAAQ,EAAE,MAAM,CAAA;CACnB;AAGD;;;GAGG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,cAAc,CAA2B;IAEjD;;;;;;;;OAQG;IACI,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,GAAE,MAAa,EAAE,QAAQ,GAAE,MAAU,EAAE,kBAAkB,GAAE,OAAe,EAAE,yBAAyB,GAAE,OAAc,GAAG,IAAI;IAmD9K;;;OAGG;IACI,cAAc,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,GAAE,MAAa,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI;IAqBxF;;;;;OAKG;IACI,mBAAmB,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,GAAE,MAAkB,GAAG,iBAAiB,EAAE;IAWxF;;OAEG;IACI,eAAe,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,GAAE,MAAkB,GAAG,iBAAiB;IAoBlF;;;;;;OAMG;IACI,2BAA2B,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,GAAE,MAAkB,GAAG,iBAAiB,EAAE;CASnG"}

package/dist/ClassFactory.js

@@ -8,6 +8,7 @@
  ******************************************************************************************************/
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ClassFactory = exports.ClassRegistration = void 0;
+const ClassUtils_1 = require("./ClassUtils");
 /**
  * Data structure to track the class registrations
  */
@@ -29,19 +30,28 @@ class ClassFactory {
      * @param key A key can be used to differentiate registrations for the same base class/sub-class combination. For example, in the case of BaseEntity and Entity object subclasses we'll have a LOT of entries and we want to get the highest priority registered sub-class for a specific key. In that case, the key is the entity name, but the key can be any value you want to use to differentiate registrations.
      * @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.
+     * @param autoRegisterWithRootClass If true (default), will automatically register the subclass with the root class of the baseClass hierarchy. This ensures proper priority ordering when multiple subclasses are registered in a hierarchy.
      */
-    Register(baseClass, subClass, key = null, priority = 0, skipNullKeyWarning = false) {
+    Register(baseClass, subClass, key = null, priority = 0, skipNullKeyWarning = false, autoRegisterWithRootClass = true) {
         if (baseClass && subClass) {
             if (key === undefined || key === null && !skipNullKeyWarning) {
                 console.warn(`ClassFactory.GetAllRegistrations: Registration for base class ${baseClass.name} has no key set. This is not recommended and may lead to unintended behavior when trying to match registrations. Please set a key for this registration.`);
             }
-            // get all of hte existing registrations for this baseClass and key
-            const registrations = this.GetAllRegistrations(baseClass, key);
+            // Get the root class for this registration
+            const rootClass = (0, ClassUtils_1.GetRootClass)(baseClass);
+            // Determine which class to actually register against
+            const effectiveBaseClass = autoRegisterWithRootClass ? rootClass : baseClass;
+            // Log if we're auto-registering with root class
+            if (autoRegisterWithRootClass && effectiveBaseClass !== baseClass) {
+                console.info(`ClassFactory.Register: Auto-registering ${subClass.name} with root class ${rootClass.name} instead of ${baseClass.name}`);
+            }
+            // get all of the existing registrations for the effective base class and key
+            const registrations = this.GetAllRegistrations(effectiveBaseClass, key);
             if (priority > 0) {
-                // validate to make sure that the comabination of base class and key for the provided priority # is not already registered, if it is, then print a warning
+                // validate to make sure that the combination of base class and key for the provided priority # is not already registered, if it is, then print a warning
                 const existing = registrations.filter(r => r.Priority === priority);
                 if (existing && existing.length > 0) {
-                    console.warn(`*** ClassFactory.Register: Registering class ${subClass.name} for base class ${baseClass.name} and key/priority ${key}/${priority}. ${existing.length} registrations already exist for that combination. While this is allowed it is not desired and when matching class requests occur, we will simply use the LAST registration we happen to have which can lead to unintended behavior. ***`);
+                    console.warn(`*** ClassFactory.Register: Registering class ${subClass.name} for base class ${effectiveBaseClass.name} and key/priority ${key}/${priority}. ${existing.length} registrations already exist for that combination. While this is allowed it is not desired and when matching class requests occur, we will simply use the LAST registration we happen to have which can lead to unintended behavior. ***`);
                 }
             }
             else if (priority === 0 || priority === null || priority === undefined) {
@@ -57,15 +67,17 @@ class ClassFactory {
             }
             // this combination of baseclass/key/priority is NOT already registered.
             let reg = new ClassRegistration();
-            reg.BaseClass = baseClass;
+            reg.BaseClass = effectiveBaseClass;
             reg.SubClass = subClass;
+            reg.RootClass = rootClass;
             reg.Key = key;
             reg.Priority = priority;
             this._registrations.push(reg);
         }
     }
     /**
-     * Creates an instance of the class registered for the given base class and key. If no registration is found, will return an instance of the base class.
+     * Creates an instance of the class registered for the given base class and key.
+     * If no registration is found, will return an instance of the base class.
      */
     CreateInstance(baseClass, key = null, ...params) {
         if (baseClass) {
@@ -120,6 +132,22 @@ class ClassFactory {
         }
         return null;
     }
+    /**
+     * Returns all registrations that have the specified root class, regardless of what base class was used in the registration.
+     * This is useful for finding all registrations in a class hierarchy.
+     * @param rootClass The root class to search for
+     * @param key Optional key to filter results
+     * @returns Array of matching registrations
+     */
+    GetRegistrationsByRootClass(rootClass, key = undefined) {
+        if (rootClass) {
+            return this._registrations.filter(r => {
+                return r.RootClass?.name === rootClass.name &&
+                    (key === undefined || key === null ? true : r.Key?.trim().toLowerCase() === key.trim().toLowerCase());
+            });
+        }
+        return [];
+    }
 }
 exports.ClassFactory = ClassFactory;
 //# sourceMappingURL=ClassFactory.js.map

package/dist/ClassFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"ClassFactory.js","sourceRoot":"","sources":["../src/ClassFactory.ts"],"names":[],"mappings":";AAAA;;;;;;wGAMwG;;;AAExG;;GAEG;AACH,MAAa,iBAAiB;CAM7B;AAND,8CAMC;AAGD;;;GAGG;AACH,MAAa,YAAY;IAAzB;QACY,mBAAc,GAAwB,EAAE,CAAC;IAgHrD,CAAC;IA9GG;;;;;;;OAOG;IACI,QAAQ,CAAC,SAAc,EAAE,QAAa,EAAE,MAAc,IAAI,EAAE,WAAmB,CAAC,EAAE,qBAA8B,KAAK;QACxH,IAAI,SAAS,IAAI,QAAQ,EAAE,CAAC;YACxB,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;gBAC3D,OAAO,CAAC,IAAI,CAAC,iEAAiE,SAAS,CAAC,IAAI,0JAA0J,CAAC,CAAA;YAC3P,CAAC;YAED,mEAAmE;YACnE,MAAM,aAAa,GAAG,IAAI,CAAC,mBAAmB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;YAE/D,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;gBACf,0JAA0J;gBAC1J,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;gBACpE,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAClC,OAAO,CAAC,IAAI,CAAC,gDAAgD,QAAQ,CAAC,IAAI,mBAAmB,SAAS,CAAC,IAAI,qBAAqB,GAAG,IAAI,QAAQ,KAAK,QAAQ,CAAC,MAAM,0OAA0O,CAAC,CAAC;gBACnZ,CAAC;YACL,CAAC;iBACI,IAAI,QAAQ,KAAK,CAAC,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBACrE,mJAAmJ;gBACnJ,oHAAoH;gBACpH,IAAI,eAAe,GAAG,CAAC,CAAC;gBACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBAC5C,IAAI,aAAa,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,eAAe;wBAC3C,eAAe,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;gBACpD,CAAC;gBACD,wEAAwE;gBACxE,QAAQ,GAAG,eAAe,GAAG,CAAC,CAAC;YACnC,CAAC;YAED,wEAAwE;YACxE,IAAI,GAAG,GAAG,IAAI,iBAAiB,EAAE,CAAC;YAClC,GAAG,CAAC,SAAS,GAAG,SAAS,CAAC;YAC1B,GAAG,CAAC,QAAQ,GAAG,QAAQ,CAAC;YACxB,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC;YACd,GAAG,CAAC,QAAQ,GAAG,QAAQ,CAAC;YAExB,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClC,CAAC;IACL,CAAC;IAED;;OAEG;IACI,cAAc,CAAI,SAAc,EAAE,MAAc,IAAI,EAAE,GAAG,MAAa;QACzE,IAAI,SAAS,EAAE,CAAC;YACZ,IAAI,GAAG,GAAG,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;YAC/C,IAAI,GAAG,EAAE,CAAC;gBACN,IAAI,QAAQ,GAAa,IAAI,CAAC;gBAC9B,IAAI,MAAM,KAAK,SAAS;oBACpB,QAAQ,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,CAAC;;oBAEvC,QAAQ,GAAG,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,yLAAyL;gBAE5N,OAAO,QAAQ,CAAC;YACpB,CAAC;iBACI,CAAC;gBACF,mFAAmF;gBACnF,OAAO,IAAI,SAAS,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,gFAAgF;YACrH,CAAC;QACL,CAAC;QAED,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACI,mBAAmB,CAAC,SAAc,EAAE,MAAc,SAAS;QAC9D,IAAI,SAAS,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;gBAClC,OAAQ,CAAC,CAAC,SAAS,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI,IAAI,wOAAwO;oBAC/Q,CAAE,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAA;YAClH,CAAC,CAAE,CAAC;QACR,CAAC;;YAEG,OAAO,IAAI,CAAC;IACpB,CAAC;IAED;;OAEG;IACI,eAAe,CAAC,SAAc,EAAE,MAAc,SAAS;QAC1D,IAAI,OAAO,GAAG,IAAI,CAAC,mBAAmB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAA;QACtD,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,qEAAqE;YACrE,IAAI,eAAe,GAAG,CAAC,CAAC;YACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,eAAe;oBACrC,eAAe,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC9C,CAAC;YAED,sEAAsE;YACtE,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,eAAe,CAAC,CAAC;YAEpE,4JAA4J;YAC5J,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACvC,CAAC;QAED,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ;AAjHD,oCAiHC"}
+{"version":3,"file":"ClassFactory.js","sourceRoot":"","sources":["../src/ClassFactory.ts"],"names":[],"mappings":"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"}

package/dist/ClassUtils.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Utility functions for working with class hierarchies and reflection
+ */
+export interface ClassInfo {
+    /**
+     * The name of the class
+     */
+    name: string;
+    /**
+     * Reference to the class constructor
+     */
+    reference: any;
+}
+/**
+ * Gets the immediate superclass of the given class
+ * @param ClassRef The class constructor reference
+ * @returns The superclass constructor or null if no superclass
+ */
+export declare function GetSuperclass(ClassRef: any): any | null;
+/**
+ * Gets the root class in the inheritance chain (the topmost user-defined class)
+ * @param ClassRef The class constructor reference
+ * @returns The root class constructor
+ */
+export declare function GetRootClass(ClassRef: any): any;
+/**
+ * Checks if a class is a subclass of another class (at any level in the inheritance hierarchy)
+ * Note: This checks the entire inheritance chain, not just the immediate parent
+ * @param PotentialSubclass The potential subclass constructor
+ * @param PotentialAncestor The potential ancestor class constructor
+ * @returns True if PotentialSubclass inherits from PotentialAncestor at any level
+ */
+export declare function IsSubclassOf(PotentialSubclass: any, PotentialAncestor: any): boolean;
+/**
+ * Checks if a class is a root class (has no user-defined superclass)
+ * @param ClassRef The class constructor reference
+ * @returns True if the class has no superclass
+ */
+export declare function IsRootClass(ClassRef: any): boolean;
+/**
+ * Checks if a class is a descendant of another class (at any level in the hierarchy)
+ * This is an alias for IsSubclassOf with a more descriptive name
+ * @param PotentialDescendant The potential descendant class constructor
+ * @param PotentialAncestor The potential ancestor class constructor
+ * @returns True if PotentialDescendant inherits from PotentialAncestor at any level
+ */
+export declare function IsDescendantClassOf(PotentialDescendant: any, PotentialAncestor: any): boolean;
+/**
+ * Gets the complete inheritance chain for a class
+ * @param ClassRef The class constructor reference
+ * @returns Array of ClassInfo objects, ordered from immediate superclass to root
+ */
+export declare function GetClassInheritance(ClassRef: any): ClassInfo[];
+/**
+ * Gets the complete class hierarchy including the class itself
+ * @param ClassRef The class constructor reference
+ * @returns Array of ClassInfo objects, ordered from the class itself up to root
+ */
+export declare function GetFullClassHierarchy(ClassRef: any): ClassInfo[];
+/**
+ * Checks if a value is a class constructor (not an instance)
+ * @param value The value to check
+ * @returns True if the value is a class constructor
+ */
+export declare function IsClassConstructor(value: any): boolean;
+/**
+ * Gets the class name safely, handling minification and anonymous classes
+ * @param ClassRef The class constructor reference
+ * @returns The class name or a fallback string
+ */
+export declare function GetClassName(ClassRef: any): string;
+//# sourceMappingURL=ClassUtils.d.ts.map

package/dist/ClassUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClassUtils.d.ts","sourceRoot":"","sources":["../src/ClassUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,SAAS;IACtB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,SAAS,EAAE,GAAG,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,GAAG,GAAG,GAAG,GAAG,IAAI,CAavD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,GAAG,GAAG,GAAG,CAqB/C;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,iBAAiB,EAAE,GAAG,EAAE,iBAAiB,EAAE,GAAG,GAAG,OAAO,CA6BpF;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,GAAG,GAAG,OAAO,CAWlD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,mBAAmB,EAAE,GAAG,EAAE,iBAAiB,EAAE,GAAG,GAAG,OAAO,CAE7F;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,GAAG,GAAG,SAAS,EAAE,CAwB9D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,GAAG,GAAG,SAAS,EAAE,CAwBhE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAqBtD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,GAAG,GAAG,MAAM,CAkBlD"}

package/dist/ClassUtils.js

@@ -0,0 +1,202 @@
+"use strict";
+/**
+ * Utility functions for working with class hierarchies and reflection
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetClassName = exports.IsClassConstructor = exports.GetFullClassHierarchy = exports.GetClassInheritance = exports.IsDescendantClassOf = exports.IsRootClass = exports.IsSubclassOf = exports.GetRootClass = exports.GetSuperclass = void 0;
+/**
+ * Gets the immediate superclass of the given class
+ * @param ClassRef The class constructor reference
+ * @returns The superclass constructor or null if no superclass
+ */
+function GetSuperclass(ClassRef) {
+    if (!ClassRef || typeof ClassRef !== 'function') {
+        return null;
+    }
+    const superclass = Object.getPrototypeOf(ClassRef);
+    // Check if we've reached the top of the chain
+    if (!superclass || superclass === Function.prototype || superclass.constructor === Function) {
+        return null;
+    }
+    return superclass;
+}
+exports.GetSuperclass = GetSuperclass;
+/**
+ * Gets the root class in the inheritance chain (the topmost user-defined class)
+ * @param ClassRef The class constructor reference
+ * @returns The root class constructor
+ */
+function GetRootClass(ClassRef) {
+    if (!ClassRef || typeof ClassRef !== 'function') {
+        return ClassRef;
+    }
+    let current = ClassRef;
+    let previous = ClassRef;
+    while (current) {
+        const superclass = Object.getPrototypeOf(current);
+        // Stop when we reach built-in prototypes
+        if (!superclass || superclass === Function.prototype || superclass.constructor === Function) {
+            break;
+        }
+        previous = current;
+        current = superclass;
+    }
+    return previous;
+}
+exports.GetRootClass = GetRootClass;
+/**
+ * Checks if a class is a subclass of another class (at any level in the inheritance hierarchy)
+ * Note: This checks the entire inheritance chain, not just the immediate parent
+ * @param PotentialSubclass The potential subclass constructor
+ * @param PotentialAncestor The potential ancestor class constructor
+ * @returns True if PotentialSubclass inherits from PotentialAncestor at any level
+ */
+function IsSubclassOf(PotentialSubclass, PotentialAncestor) {
+    if (!PotentialSubclass || !PotentialAncestor ||
+        typeof PotentialSubclass !== 'function' ||
+        typeof PotentialAncestor !== 'function') {
+        return false;
+    }
+    // Check if they're the same class
+    if (PotentialSubclass === PotentialAncestor) {
+        return false; // A class is not a subclass of itself
+    }
+    // Walk up the prototype chain
+    let current = PotentialSubclass;
+    while (current) {
+        current = Object.getPrototypeOf(current);
+        if (current === PotentialAncestor) {
+            return true;
+        }
+        // Stop when we reach built-in prototypes
+        if (!current || current === Function.prototype || current.constructor === Function) {
+            break;
+        }
+    }
+    return false;
+}
+exports.IsSubclassOf = IsSubclassOf;
+/**
+ * Checks if a class is a root class (has no user-defined superclass)
+ * @param ClassRef The class constructor reference
+ * @returns True if the class has no superclass
+ */
+function IsRootClass(ClassRef) {
+    if (!ClassRef || typeof ClassRef !== 'function') {
+        return false;
+    }
+    const superclass = Object.getPrototypeOf(ClassRef);
+    // It's a root class if it has no superclass or only inherits from built-in prototypes
+    return !superclass ||
+        superclass === Function.prototype ||
+        superclass.constructor === Function;
+}
+exports.IsRootClass = IsRootClass;
+/**
+ * Checks if a class is a descendant of another class (at any level in the hierarchy)
+ * This is an alias for IsSubclassOf with a more descriptive name
+ * @param PotentialDescendant The potential descendant class constructor
+ * @param PotentialAncestor The potential ancestor class constructor
+ * @returns True if PotentialDescendant inherits from PotentialAncestor at any level
+ */
+function IsDescendantClassOf(PotentialDescendant, PotentialAncestor) {
+    return IsSubclassOf(PotentialDescendant, PotentialAncestor);
+}
+exports.IsDescendantClassOf = IsDescendantClassOf;
+/**
+ * Gets the complete inheritance chain for a class
+ * @param ClassRef The class constructor reference
+ * @returns Array of ClassInfo objects, ordered from immediate superclass to root
+ */
+function GetClassInheritance(ClassRef) {
+    const chain = [];
+    if (!ClassRef || typeof ClassRef !== 'function') {
+        return chain;
+    }
+    let current = Object.getPrototypeOf(ClassRef);
+    while (current) {
+        // Stop when we reach built-in prototypes
+        if (current === Function.prototype || current.constructor === Function) {
+            break;
+        }
+        chain.push({
+            name: current.name || 'Anonymous',
+            reference: current
+        });
+        current = Object.getPrototypeOf(current);
+    }
+    return chain;
+}
+exports.GetClassInheritance = GetClassInheritance;
+/**
+ * Gets the complete class hierarchy including the class itself
+ * @param ClassRef The class constructor reference
+ * @returns Array of ClassInfo objects, ordered from the class itself up to root
+ */
+function GetFullClassHierarchy(ClassRef) {
+    const chain = [];
+    if (!ClassRef || typeof ClassRef !== 'function') {
+        return chain;
+    }
+    let current = ClassRef;
+    while (current) {
+        // Stop when we reach built-in prototypes
+        if (current === Function.prototype || current.constructor === Function) {
+            break;
+        }
+        chain.push({
+            name: current.name || 'Anonymous',
+            reference: current
+        });
+        current = Object.getPrototypeOf(current);
+    }
+    return chain;
+}
+exports.GetFullClassHierarchy = GetFullClassHierarchy;
+/**
+ * Checks if a value is a class constructor (not an instance)
+ * @param value The value to check
+ * @returns True if the value is a class constructor
+ */
+function IsClassConstructor(value) {
+    if (typeof value !== 'function') {
+        return false;
+    }
+    // Check if it's a class by looking at its string representation
+    const fnString = value.toString();
+    // ES6 classes start with "class"
+    if (fnString.startsWith('class ')) {
+        return true;
+    }
+    // Check for constructor functions that might be transpiled classes
+    // They typically have a prototype with a constructor property
+    if (value.prototype && value.prototype.constructor === value) {
+        // Additional check: does it look like it's meant to be instantiated?
+        return fnString.includes('this.') || Object.getOwnPropertyNames(value.prototype).length > 1;
+    }
+    return false;
+}
+exports.IsClassConstructor = IsClassConstructor;
+/**
+ * Gets the class name safely, handling minification and anonymous classes
+ * @param ClassRef The class constructor reference
+ * @returns The class name or a fallback string
+ */
+function GetClassName(ClassRef) {
+    if (!ClassRef || typeof ClassRef !== 'function') {
+        return 'Unknown';
+    }
+    // Try to get the name property
+    if (ClassRef.name) {
+        return ClassRef.name;
+    }
+    // Try to extract from toString() as fallback
+    const fnString = ClassRef.toString();
+    const match = fnString.match(/^class\s+(\w+)/);
+    if (match && match[1]) {
+        return match[1];
+    }
+    return 'Anonymous';
+}
+exports.GetClassName = GetClassName;
+//# sourceMappingURL=ClassUtils.js.map

package/dist/ClassUtils.js.map

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

package/dist/DeepDiff.d.ts

@@ -0,0 +1,191 @@
+/**
+ * @fileoverview Deep difference comparison utility for JavaScript objects
+ *
+ * This module provides comprehensive utilities to generate detailed diffs between
+ * any two JavaScript objects, arrays, or primitive values. It recursively traverses
+ * nested structures and produces both machine-readable change objects and human-readable
+ * formatted output.
+ *
+ * Key features:
+ * - Deep recursive comparison of objects and arrays
+ * - Configurable depth limits and output formatting
+ * - Path tracking for nested changes
+ * - Summary statistics for change types
+ * - Human-readable formatted output
+ * - Type-safe change tracking
+ *
+ * @module @memberjunction/global
+ * @author MemberJunction.com
+ * @since 2.63.0
+ *
+ * @example
+ * ```typescript
+ * const differ = new DeepDiffer();
+ * const diff = differ.diff(
+ *   { name: 'John', age: 30, hobbies: ['reading'] },
+ *   { name: 'John', age: 31, hobbies: ['reading', 'gaming'] }
+ * );
+ * console.log(diff.formatted);
+ * // Output:
+ * // Modified: age
+ * //   Changed from 30 to 31
+ * // Modified: hobbies
+ * //   Array length changed from 1 to 2
+ * // Added: hobbies[1]
+ * //   Added "gaming"
+ * ```
+ */
+/**
+ * Types of changes that can occur in a deep diff operation
+ */
+export declare enum DiffChangeType {
+    /** A new property or value was added */
+    Added = "added",
+    /** An existing property or value was removed */
+    Removed = "removed",
+    /** An existing value was changed to a different value */
+    Modified = "modified",
+    /** No change detected (only included when includeUnchanged is true) */
+    Unchanged = "unchanged"
+}
+/**
+ * Represents a single change detected during diff operation
+ */
+export interface DiffChange {
+    /** The path to the changed value (e.g., "user.profile.name" or "items[2].id") */
+    path: string;
+    /** The type of change that occurred */
+    type: DiffChangeType;
+    /** The original value (undefined for Added changes) */
+    oldValue?: any;
+    /** The new value (undefined for Removed changes) */
+    newValue?: any;
+    /** Human-readable description of the change */
+    description: string;
+}
+/**
+ * Complete result of a deep diff operation
+ */
+export interface DeepDiffResult {
+    /** Array of all detected changes */
+    changes: DiffChange[];
+    /** Summary statistics about the diff */
+    summary: {
+        /** Number of properties/values that were added */
+        added: number;
+        /** Number of properties/values that were removed */
+        removed: number;
+        /** Number of properties/values that were modified */
+        modified: number;
+        /** Number of properties/values that remained unchanged (if tracked) */
+        unchanged: number;
+        /** Total number of paths examined */
+        totalPaths: number;
+    };
+    /** Human-readable formatted diff output suitable for display or logging */
+    formatted: string;
+}
+/**
+ * Configuration options for deep diff generation
+ */
+export interface DeepDiffConfig {
+    /**
+     * Whether to include unchanged paths in the diff results.
+     * Useful for seeing the complete structure comparison.
+     * @default false
+     */
+    includeUnchanged: boolean;
+    /**
+     * Maximum depth to traverse in nested objects.
+     * Prevents infinite recursion and controls performance.
+     * @default 10
+     */
+    maxDepth: number;
+    /**
+     * Maximum string length before truncation in formatted output.
+     * Helps keep the output readable for large text values.
+     * @default 100
+     */
+    maxStringLength: number;
+    /**
+     * Whether to include array indices in paths (e.g., "items[0]" vs "items").
+     * Provides more precise change tracking for arrays.
+     * @default true
+     */
+    includeArrayIndices: boolean;
+    /**
+     * Custom value formatter for the formatted output.
+     * Allows customization of how values are displayed.
+     * @param value - The value to format
+     * @param type - The type of the value
+     * @returns Formatted string representation
+     */
+    valueFormatter?: (value: any, type: string) => string;
+}
+/**
+ * Deep difference generator for comparing JavaScript objects, arrays, and primitives.
+ *
+ * This class provides comprehensive comparison capabilities with configurable
+ * output formatting and depth control.
+ */
+export declare class DeepDiffer {
+    private config;
+    /**
+     * Creates a new DeepDiffer instance
+     * @param config - Optional configuration overrides
+     */
+    constructor(config?: Partial<DeepDiffConfig>);
+    /**
+     * Generate a deep diff between two values
+     *
+     * @param oldValue - The original value
+     * @param newValue - The new value to compare against
+     * @returns Complete diff results including changes, summary, and formatted output
+     *
+     * @example
+     * ```typescript
+     * const differ = new DeepDiffer({ includeUnchanged: true });
+     * const result = differ.diff(
+     *   { users: [{ id: 1, name: 'Alice' }] },
+     *   { users: [{ id: 1, name: 'Alice Cooper' }] }
+     * );
+     * ```
+     */
+    diff<T = any>(oldValue: T, newValue: T): DeepDiffResult;
+    /**
+     * Update configuration options
+     * @param config - Partial configuration to merge with existing config
+     */
+    updateConfig(config: Partial<DeepDiffConfig>): void;
+    /**
+     * Recursively generate diff between two values
+     * @private
+     */
+    private generateDiff;
+    /**
+     * Compare two arrays and generate diff
+     * @private
+     */
+    private diffArrays;
+    /**
+     * Compare two objects and generate diff
+     * @private
+     */
+    private diffObjects;
+    /**
+     * Create a human-readable description of a value
+     * @private
+     */
+    private describeValue;
+    /**
+     * Get a description of a value for display
+     * @private
+     */
+    private getValueDescription;
+    /**
+     * Format the diff results as a human-readable string
+     * @private
+     */
+    private formatDiff;
+}
+//# sourceMappingURL=DeepDiff.d.ts.map

package/dist/DeepDiff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeepDiff.d.ts","sourceRoot":"","sources":["../src/DeepDiff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAIH;;GAEG;AACH,oBAAY,cAAc;IACtB,wCAAwC;IACxC,KAAK,UAAU;IACf,gDAAgD;IAChD,OAAO,YAAY;IACnB,yDAAyD;IACzD,QAAQ,aAAa;IACrB,uEAAuE;IACvE,SAAS,cAAc;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,IAAI,EAAE,cAAc,CAAC;IACrB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,oDAAoD;IACpD,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,oCAAoC;IACpC,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,wCAAwC;IACxC,OAAO,EAAE;QACL,kDAAkD;QAClD,KAAK,EAAE,MAAM,CAAC;QACd,oDAAoD;QACpD,OAAO,EAAE,MAAM,CAAC;QAChB,qDAAqD;QACrD,QAAQ,EAAE,MAAM,CAAC;QACjB,uEAAuE;QACvE,SAAS,EAAE,MAAM,CAAC;QAClB,qCAAqC;QACrC,UAAU,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B;;;;OAIG;IACH,gBAAgB,EAAE,OAAO,CAAC;IAE1B;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACH,mBAAmB,EAAE,OAAO,CAAC;IAE7B;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACzD;AAED;;;;;GAKG;AACH,qBAAa,UAAU;IACnB,OAAO,CAAC,MAAM,CAAiB;IAE/B;;;OAGG;gBACS,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IAU5C;;;;;;;;;;;;;;;OAeG;IACI,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,cAAc;IAkC9D;;;OAGG;IACI,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI;IAI1D;;;OAGG;IACH,OAAO,CAAC,YAAY;IAuDpB;;;OAGG;IACH,OAAO,CAAC,UAAU;IAkDlB;;;OAGG;IACH,OAAO,CAAC,WAAW;IA0BnB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAUrB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IA6B3B;;;OAGG;IACH,OAAO,CAAC,UAAU;CAsCrB"}