@memberjunction/global 2.62.0 → 2.63.1

package/dist/DeepDiff.js

@@ -0,0 +1,342 @@
+"use strict";
+/**
+ * @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"
+ * ```
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeepDiffer = exports.DiffChangeType = void 0;
+const _ = __importStar(require("lodash"));
+/**
+ * Types of changes that can occur in a deep diff operation
+ */
+var DiffChangeType;
+(function (DiffChangeType) {
+    /** A new property or value was added */
+    DiffChangeType["Added"] = "added";
+    /** An existing property or value was removed */
+    DiffChangeType["Removed"] = "removed";
+    /** An existing value was changed to a different value */
+    DiffChangeType["Modified"] = "modified";
+    /** No change detected (only included when includeUnchanged is true) */
+    DiffChangeType["Unchanged"] = "unchanged";
+})(DiffChangeType || (exports.DiffChangeType = DiffChangeType = {}));
+/**
+ * Deep difference generator for comparing JavaScript objects, arrays, and primitives.
+ *
+ * This class provides comprehensive comparison capabilities with configurable
+ * output formatting and depth control.
+ */
+class DeepDiffer {
+    /**
+     * Creates a new DeepDiffer instance
+     * @param config - Optional configuration overrides
+     */
+    constructor(config) {
+        this.config = {
+            includeUnchanged: false,
+            maxDepth: 10,
+            maxStringLength: 100,
+            includeArrayIndices: true,
+            ...config
+        };
+    }
+    /**
+     * 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(oldValue, newValue) {
+        const changes = [];
+        // Generate the diff recursively
+        this.generateDiff(oldValue, newValue, [], changes, 0);
+        // Sort changes by path for consistency
+        changes.sort((a, b) => a.path.localeCompare(b.path));
+        // Generate summary
+        const summary = {
+            added: changes.filter(c => c.type === DiffChangeType.Added).length,
+            removed: changes.filter(c => c.type === DiffChangeType.Removed).length,
+            modified: changes.filter(c => c.type === DiffChangeType.Modified).length,
+            unchanged: changes.filter(c => c.type === DiffChangeType.Unchanged).length,
+            totalPaths: changes.length
+        };
+        // Generate formatted output
+        const formatted = this.formatDiff(changes, summary);
+        return {
+            changes,
+            summary,
+            formatted
+        };
+    }
+    /**
+     * Update configuration options
+     * @param config - Partial configuration to merge with existing config
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+    /**
+     * Recursively generate diff between two values
+     * @private
+     */
+    generateDiff(oldValue, newValue, path, changes, depth) {
+        // Check depth limit
+        if (depth > this.config.maxDepth) {
+            return;
+        }
+        const pathStr = path.join('.');
+        // Handle different cases
+        if (oldValue === newValue) {
+            if (this.config.includeUnchanged) {
+                changes.push({
+                    path: pathStr || 'root',
+                    type: DiffChangeType.Unchanged,
+                    oldValue,
+                    newValue,
+                    description: 'No change'
+                });
+            }
+        }
+        else if (oldValue === undefined && newValue !== undefined) {
+            changes.push({
+                path: pathStr || 'root',
+                type: DiffChangeType.Added,
+                newValue,
+                description: this.describeValue(newValue, 'Added')
+            });
+        }
+        else if (oldValue !== undefined && newValue === undefined) {
+            changes.push({
+                path: pathStr || 'root',
+                type: DiffChangeType.Removed,
+                oldValue,
+                description: this.describeValue(oldValue, 'Removed')
+            });
+        }
+        else if (Array.isArray(oldValue) && Array.isArray(newValue)) {
+            this.diffArrays(oldValue, newValue, path, changes, depth);
+        }
+        else if (_.isObject(oldValue) && _.isObject(newValue)) {
+            this.diffObjects(oldValue, newValue, path, changes, depth);
+        }
+        else {
+            // Values are different types or primitives
+            changes.push({
+                path: pathStr || 'root',
+                type: DiffChangeType.Modified,
+                oldValue,
+                newValue,
+                description: `Changed from ${this.describeValue(oldValue)} to ${this.describeValue(newValue)}`
+            });
+        }
+    }
+    /**
+     * Compare two arrays and generate diff
+     * @private
+     */
+    diffArrays(oldArray, newArray, path, changes, depth) {
+        const pathStr = path.join('.');
+        // Check if array lengths are different
+        if (oldArray.length !== newArray.length) {
+            changes.push({
+                path: pathStr || 'root',
+                type: DiffChangeType.Modified,
+                oldValue: `Array[${oldArray.length}]`,
+                newValue: `Array[${newArray.length}]`,
+                description: `Array length changed from ${oldArray.length} to ${newArray.length}`
+            });
+        }
+        // Compare array elements
+        const maxLength = Math.max(oldArray.length, newArray.length);
+        for (let i = 0; i < maxLength; i++) {
+            const elementPath = this.config.includeArrayIndices
+                ? [...path, `[${i}]`]
+                : [...path, `[]`];
+            if (i < oldArray.length && i < newArray.length) {
+                // Element exists in both arrays
+                this.generateDiff(oldArray[i], newArray[i], elementPath, changes, depth + 1);
+            }
+            else if (i < oldArray.length) {
+                // Element was removed
+                changes.push({
+                    path: elementPath.join('.'),
+                    type: DiffChangeType.Removed,
+                    oldValue: oldArray[i],
+                    description: this.describeValue(oldArray[i], 'Removed')
+                });
+            }
+            else {
+                // Element was added
+                changes.push({
+                    path: elementPath.join('.'),
+                    type: DiffChangeType.Added,
+                    newValue: newArray[i],
+                    description: this.describeValue(newArray[i], 'Added')
+                });
+            }
+        }
+    }
+    /**
+     * Compare two objects and generate diff
+     * @private
+     */
+    diffObjects(oldObj, newObj, path, changes, depth) {
+        // Get all unique keys from both objects
+        const allKeys = new Set([
+            ...Object.keys(oldObj),
+            ...Object.keys(newObj)
+        ]);
+        // Compare each key
+        for (const key of allKeys) {
+            const keyPath = [...path, key];
+            this.generateDiff(oldObj[key], newObj[key], keyPath, changes, depth + 1);
+        }
+    }
+    /**
+     * Create a human-readable description of a value
+     * @private
+     */
+    describeValue(value, prefix) {
+        if (this.config.valueFormatter) {
+            const type = Array.isArray(value) ? 'array' : typeof value;
+            return this.config.valueFormatter(value, type);
+        }
+        const description = this.getValueDescription(value);
+        return prefix ? `${prefix} ${description}` : description;
+    }
+    /**
+     * Get a description of a value for display
+     * @private
+     */
+    getValueDescription(value) {
+        if (value === null)
+            return 'null';
+        if (value === undefined)
+            return 'undefined';
+        const type = typeof value;
+        if (type === 'string') {
+            const str = value.length > this.config.maxStringLength
+                ? `"${value.substring(0, this.config.maxStringLength)}..."`
+                : `"${value}"`;
+            return str;
+        }
+        if (type === 'number' || type === 'boolean') {
+            return String(value);
+        }
+        if (Array.isArray(value)) {
+            return `Array[${value.length}]`;
+        }
+        if (_.isObject(value)) {
+            const keys = Object.keys(value);
+            return `Object{${keys.length} ${keys.length === 1 ? 'key' : 'keys'}}`;
+        }
+        return String(value);
+    }
+    /**
+     * Format the diff results as a human-readable string
+     * @private
+     */
+    formatDiff(changes, summary) {
+        const lines = [];
+        // Add summary header
+        lines.push('=== Deep Diff Summary ===');
+        lines.push(`Total changes: ${summary.added + summary.removed + summary.modified}`);
+        if (summary.added > 0)
+            lines.push(`  Added: ${summary.added}`);
+        if (summary.removed > 0)
+            lines.push(`  Removed: ${summary.removed}`);
+        if (summary.modified > 0)
+            lines.push(`  Modified: ${summary.modified}`);
+        if (this.config.includeUnchanged && summary.unchanged > 0) {
+            lines.push(`  Unchanged: ${summary.unchanged}`);
+        }
+        lines.push('');
+        // Add changes
+        if (changes.length > 0) {
+            lines.push('=== Changes ===');
+            // Group changes by type for better readability
+            const changesByType = _.groupBy(changes, 'type');
+            for (const type of [DiffChangeType.Added, DiffChangeType.Removed, DiffChangeType.Modified]) {
+                const typeChanges = changesByType[type];
+                if (typeChanges && typeChanges.length > 0) {
+                    lines.push(`\n${type.charAt(0).toUpperCase() + type.slice(1)}:`);
+                    for (const change of typeChanges) {
+                        lines.push(`  ${change.path}: ${change.description}`);
+                    }
+                }
+            }
+            if (this.config.includeUnchanged && changesByType[DiffChangeType.Unchanged]) {
+                lines.push(`\nUnchanged (${changesByType[DiffChangeType.Unchanged].length} items)`);
+            }
+        }
+        return lines.join('\n');
+    }
+}
+exports.DeepDiffer = DeepDiffer;
+//# sourceMappingURL=DeepDiff.js.map

package/dist/DeepDiff.js.map

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

package/dist/Global.d.ts

@@ -0,0 +1,51 @@
+import * as MJ from './interface';
+import { Observable } from 'rxjs';
+import { ClassFactory } from './ClassFactory';
+import { ObjectCache } from './ObjectCache';
+import { BaseSingleton } from './BaseSingleton';
+/**
+ * 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;
+}
+//# sourceMappingURL=Global.d.ts.map

package/dist/Global.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Global.d.ts","sourceRoot":"","sources":["../src/Global.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,aAAa,CAAA;AACjC,OAAO,EAA0B,UAAU,EAAE,MAAM,MAAM,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;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"}

package/dist/Global.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MJGlobal = void 0;
+const rxjs_1 = require("rxjs");
+const ClassFactory_1 = require("./ClassFactory");
+const ObjectCache_1 = require("./ObjectCache");
+const BaseSingleton_1 = require("./BaseSingleton");
+/**
+ * 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;
+//# sourceMappingURL=Global.js.map

package/dist/Global.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Global.js","sourceRoot":"","sources":["../src/Global.ts"],"names":[],"mappings":";;;AACA,+BAA0D;AAC1D,iDAA6C;AAC7C,+CAA4C;AAC5C,mDAAgD;AAEhD;;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"}

package/dist/RegisterClass.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 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.
+ * @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.
+ * @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, autoRegisterWithRootClass?: boolean): (constructor: Function) => void;
+//# sourceMappingURL=RegisterClass.d.ts.map

package/dist/RegisterClass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RegisterClass.d.ts","sourceRoot":"","sources":["../src/RegisterClass.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,GAAE,MAAa,EAAE,QAAQ,GAAE,MAAU,EAAE,kBAAkB,GAAE,OAAe,EAAE,yBAAyB,GAAE,OAAc,GAAG,CAAC,WAAW,EAAE,QAAQ,KAAK,IAAI,CAKvM"}

package/dist/RegisterClass.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RegisterClass = void 0;
+const Global_1 = require("./Global");
+/**
+ * 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.
+ * @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.
+ * @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, autoRegisterWithRootClass = true) {
+    return function (constructor) {
+        // Invoke the registration method
+        Global_1.MJGlobal.Instance.ClassFactory.Register(baseClass, constructor, key, priority, skipNullKeyWarning, autoRegisterWithRootClass);
+    };
+}
+exports.RegisterClass = RegisterClass;
+//# sourceMappingURL=RegisterClass.js.map

package/dist/RegisterClass.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RegisterClass.js","sourceRoot":"","sources":["../src/RegisterClass.ts"],"names":[],"mappings":";;;AAAA,qCAAoC;AAEpC;;;;;;;;GAQG;AACH,SAAgB,aAAa,CAAC,SAAc,EAAE,MAAc,IAAI,EAAE,WAAmB,CAAC,EAAE,qBAA8B,KAAK,EAAE,4BAAqC,IAAI;IAClK,OAAO,UAAU,WAAqB;QAClC,iCAAiC;QACjC,iBAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,EAAE,QAAQ,EAAE,kBAAkB,EAAE,yBAAyB,CAAC,CAAC;IAClI,CAAC,CAAA;AACL,CAAC;AALD,sCAKC"}

package/dist/__tests__/ClassUtils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ClassUtils.test.d.ts.map

package/dist/__tests__/ClassUtils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClassUtils.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/ClassUtils.test.ts"],"names":[],"mappings":""}