@memberjunction/global 4.4.0 → 5.1.0

package/dist/DynamicPackageLoader.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Dynamic Package Loading
+ *
+ * Provides runtime dynamic import capabilities for MJ Open App packages.
+ * Used by MJAPI startup to load server-side app bootstrap packages that
+ * register their classes with the ClassFactory via @RegisterClass decorators.
+ */
+/**
+ * Describes a package to be dynamically imported at runtime.
+ * Typically read from the `dynamicPackages.server` section of mj.config.cjs.
+ */
+export interface DynamicPackageLoad {
+    /** npm package name to dynamically import */
+    PackageName: string;
+    /** Named export to call after import (e.g., 'LoadAcmeCRMServer') */
+    StartupExport: string;
+    /** Open App name this package belongs to (for tracking) */
+    AppName: string;
+    /** Whether this package should be loaded. Allows disabling without removing. */
+    Enabled: boolean;
+}
+/**
+ * Result of attempting to dynamically load a single package.
+ */
+export interface DynamicLoadResult {
+    /** The package that was loaded (or failed to load) */
+    PackageName: string;
+    /** Whether the package was loaded and its startup export called successfully */
+    Success: boolean;
+    /** Error message if the load failed */
+    Error?: string;
+}
+/**
+ * Utility class for dynamically loading npm packages at runtime.
+ *
+ * Used during MJAPI startup to load Open App server-side bootstrap packages.
+ * Each package is loaded in isolation — a failure in one package does not
+ * prevent others from loading.
+ */
+export declare class DynamicPackageLoader {
+    /**
+     * Loads all enabled dynamic packages in parallel for better performance.
+     * For each package:
+     * 1. Skips if `Enabled` is false
+     * 2. Dynamically imports the package via `await import()`
+     * 3. Calls the named `StartupExport` function if it exists
+     * 4. Records success or failure
+     *
+     * Errors are isolated per-package — a broken package does not crash the server.
+     * All enabled packages are loaded concurrently using Promise.all().
+     *
+     * @param packages - Array of packages to load
+     * @returns Array of results indicating success/failure for each package
+     */
+    static LoadPackages(packages: DynamicPackageLoad[]): Promise<DynamicLoadResult[]>;
+    /**
+     * Attempts to dynamically import a single package and call its startup export.
+     */
+    private static LoadSinglePackage;
+}
+//# sourceMappingURL=DynamicPackageLoader.d.ts.map

package/dist/DynamicPackageLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DynamicPackageLoader.d.ts","sourceRoot":"","sources":["../src/DynamicPackageLoader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAC/B,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IAEpB,oEAAoE;IACpE,aAAa,EAAE,MAAM,CAAC;IAEtB,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;IAEhB,gFAAgF;IAChF,OAAO,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IAEpB,gFAAgF;IAChF,OAAO,EAAE,OAAO,CAAC;IAEjB,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,qBAAa,oBAAoB;IAC7B;;;;;;;;;;;;;OAaG;WACU,YAAY,CAAC,QAAQ,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAKvF;;OAEG;mBACkB,iBAAiB;CAqBzC"}

package/dist/DynamicPackageLoader.js

@@ -0,0 +1,56 @@
+/**
+ * Dynamic Package Loading
+ *
+ * Provides runtime dynamic import capabilities for MJ Open App packages.
+ * Used by MJAPI startup to load server-side app bootstrap packages that
+ * register their classes with the ClassFactory via @RegisterClass decorators.
+ */
+/**
+ * Utility class for dynamically loading npm packages at runtime.
+ *
+ * Used during MJAPI startup to load Open App server-side bootstrap packages.
+ * Each package is loaded in isolation — a failure in one package does not
+ * prevent others from loading.
+ */
+export class DynamicPackageLoader {
+    /**
+     * Loads all enabled dynamic packages in parallel for better performance.
+     * For each package:
+     * 1. Skips if `Enabled` is false
+     * 2. Dynamically imports the package via `await import()`
+     * 3. Calls the named `StartupExport` function if it exists
+     * 4. Records success or failure
+     *
+     * Errors are isolated per-package — a broken package does not crash the server.
+     * All enabled packages are loaded concurrently using Promise.all().
+     *
+     * @param packages - Array of packages to load
+     * @returns Array of results indicating success/failure for each package
+     */
+    static async LoadPackages(packages) {
+        const enabledPackages = packages.filter(p => p.Enabled);
+        return Promise.all(enabledPackages.map(pkg => DynamicPackageLoader.LoadSinglePackage(pkg)));
+    }
+    /**
+     * Attempts to dynamically import a single package and call its startup export.
+     */
+    static async LoadSinglePackage(pkg) {
+        try {
+            const module = await import(pkg.PackageName);
+            if (pkg.StartupExport && typeof module[pkg.StartupExport] === 'function') {
+                module[pkg.StartupExport]();
+            }
+            return { PackageName: pkg.PackageName, Success: true };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.error(`Failed to load dynamic package ${pkg.PackageName}: ${errorMessage}`);
+            return {
+                PackageName: pkg.PackageName,
+                Success: false,
+                Error: errorMessage
+            };
+        }
+    }
+}
+//# sourceMappingURL=DynamicPackageLoader.js.map

package/dist/DynamicPackageLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DynamicPackageLoader.js","sourceRoot":"","sources":["../src/DynamicPackageLoader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAkCH;;;;;;GAMG;AACH,MAAM,OAAO,oBAAoB;IAC7B;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,QAA8B;QACpD,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACxD,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAChG,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,GAAuB;QAC1D,IAAI,CAAC;YACD,MAAM,MAAM,GAA4B,MAAM,MAAM,CAAC,GAAG,CAAC,WAAW,CAA4B,CAAC;YAEjG,IAAI,GAAG,CAAC,aAAa,IAAI,OAAO,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,KAAK,UAAU,EAAE,CAAC;gBACtE,MAAM,CAAC,GAAG,CAAC,aAAa,CAAgB,EAAE,CAAC;YAChD,CAAC;YAED,OAAO,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC3D,CAAC;QACD,OAAO,KAAc,EAAE,CAAC;YACpB,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5E,OAAO,CAAC,KAAK,CAAC,kCAAkC,GAAG,CAAC,WAAW,KAAK,YAAY,EAAE,CAAC,CAAC;YAEpF,OAAO;gBACH,WAAW,EAAE,GAAG,CAAC,WAAW;gBAC5B,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,YAAY;aACtB,CAAC;QACN,CAAC;IACL,CAAC;CACJ"}

package/dist/index.d.ts

@@ -14,4 +14,5 @@ export * from './warningManager.js';
 export * from './EncryptionUtils.js';
 export * from './Global.js';
 export * from './RegisterClass.js';
+export * from './DynamicPackageLoader.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -18,6 +18,7 @@ export * from './EncryptionUtils.js';
 // Export the main classes
 export * from './Global.js';
 export * from './RegisterClass.js';
+export * from './DynamicPackageLoader.js';
 // NOTE: RegisterForStartup has moved to @memberjunction/core
 // Import from there instead of here
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAChE,cAAc,aAAa,CAAA;AAC3B,cAAc,QAAQ,CAAA;AACtB,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,2BAA2B,CAAA;AACzC,cAAc,0BAA0B,CAAA;AACxC,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AAEjC,2DAA2D;AAC3D,oCAAoC;AAEpC,0BAA0B;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA;AAE/B,6DAA6D;AAC7D,oCAAoC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAChE,cAAc,aAAa,CAAA;AAC3B,cAAc,QAAQ,CAAA;AACtB,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,2BAA2B,CAAA;AACzC,cAAc,0BAA0B,CAAA;AACxC,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AAEjC,2DAA2D;AAC3D,oCAAoC;AAEpC,0BAA0B;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,wBAAwB,CAAA;AAEtC,6DAA6D;AAC7D,oCAAoC"}

package/dist/warningManager.d.ts

@@ -12,7 +12,7 @@
  * ```typescript
  * const wm = WarningManager.Instance;
  * wm.RecordEntityDeprecationWarning('User Preferences', 'BaseEntity::constructor');
- * wm.RecordFieldDeprecationWarning('AI Prompts', 'OldField', 'AIPromptEntity::validate');
+ * wm.RecordFieldDeprecationWarning('MJ: AI Prompts', 'OldField', 'MJAIPromptEntity::validate');
  * wm.RecordFieldNotFoundWarning('Users', 'DeletedColumn', 'BaseEntity::SetMany');
  * // Warnings will be flushed automatically after debounce period
  * ```
@@ -86,7 +86,7 @@ export declare class WarningManager {
      *
      * @param entityName - The name of the entity containing the deprecated field
      * @param fieldName - The name of the deprecated field
-     * @param callerName - The name of the caller (e.g., 'AIPromptEntity::validate')
+     * @param callerName - The name of the caller (e.g., 'MJAIPromptEntity::validate')
      * @returns true if this warning should be emitted immediately (when ShowAll is true)
      */
     RecordFieldDeprecationWarning(entityName: string, fieldName: string, callerName: string): boolean;

package/dist/warningManager.js

@@ -12,7 +12,7 @@
  * ```typescript
  * const wm = WarningManager.Instance;
  * wm.RecordEntityDeprecationWarning('User Preferences', 'BaseEntity::constructor');
- * wm.RecordFieldDeprecationWarning('AI Prompts', 'OldField', 'AIPromptEntity::validate');
+ * wm.RecordFieldDeprecationWarning('MJ: AI Prompts', 'OldField', 'MJAIPromptEntity::validate');
  * wm.RecordFieldNotFoundWarning('Users', 'DeletedColumn', 'BaseEntity::SetMany');
  * // Warnings will be flushed automatically after debounce period
  * ```
@@ -113,7 +113,7 @@ export class WarningManager {
      *
      * @param entityName - The name of the entity containing the deprecated field
      * @param fieldName - The name of the deprecated field
-     * @param callerName - The name of the caller (e.g., 'AIPromptEntity::validate')
+     * @param callerName - The name of the caller (e.g., 'MJAIPromptEntity::validate')
      * @returns true if this warning should be emitted immediately (when ShowAll is true)
      */
     RecordFieldDeprecationWarning(entityName, fieldName, callerName) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@memberjunction/global",
   "type": "module",
-  "version": "4.4.0",
+  "version": "5.1.0",
   "description": "MemberJunction: Global Object - Needed for ALL other MJ components",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",