@memberjunction/react-runtime 2.92.0 → 2.94.0

package/dist/utilities/library-dependency-resolver.js

@@ -0,0 +1,410 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LibraryDependencyResolver = void 0;
+class LibraryDependencyResolver {
+    constructor(options) {
+        this.debug = false;
+        this.debug = options?.debug || false;
+    }
+    parseDependencies(json) {
+        const dependencies = new Map();
+        if (!json || json.trim() === '') {
+            return dependencies;
+        }
+        try {
+            const parsed = JSON.parse(json);
+            if (typeof parsed === 'object' && parsed !== null) {
+                for (const [name, version] of Object.entries(parsed)) {
+                    if (typeof version === 'string') {
+                        dependencies.set(name, version);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            console.error('Failed to parse dependencies JSON:', error);
+        }
+        return dependencies;
+    }
+    buildDependencyGraph(libraries) {
+        const nodes = new Map();
+        const roots = new Set();
+        for (const library of libraries) {
+            const dependencies = this.parseDependencies(library.Dependencies);
+            nodes.set(library.Name, {
+                library,
+                dependencies,
+                dependents: new Set()
+            });
+            roots.add(library.Name);
+        }
+        for (const [name, node] of nodes) {
+            for (const [depName, depVersion] of node.dependencies) {
+                const depNode = nodes.get(depName);
+                if (depNode) {
+                    roots.delete(depName);
+                    depNode.dependents.add(name);
+                }
+                else if (this.debug) {
+                    console.warn(`Dependency '${depName}' not found for library '${name}'`);
+                }
+            }
+        }
+        return { nodes, roots };
+    }
+    detectCycles(graph) {
+        const cycles = [];
+        const visited = new Set();
+        const recursionStack = new Set();
+        const path = [];
+        const detectCyclesUtil = (nodeName) => {
+            visited.add(nodeName);
+            recursionStack.add(nodeName);
+            path.push(nodeName);
+            const node = graph.nodes.get(nodeName);
+            if (node) {
+                for (const [depName] of node.dependencies) {
+                    if (!visited.has(depName)) {
+                        detectCyclesUtil(depName);
+                    }
+                    else if (recursionStack.has(depName)) {
+                        const cycleStartIndex = path.indexOf(depName);
+                        const cycle = [...path.slice(cycleStartIndex), depName];
+                        cycles.push(cycle);
+                    }
+                }
+            }
+            path.pop();
+            recursionStack.delete(nodeName);
+        };
+        for (const nodeName of graph.nodes.keys()) {
+            if (!visited.has(nodeName)) {
+                detectCyclesUtil(nodeName);
+            }
+        }
+        return cycles;
+    }
+    topologicalSort(graph) {
+        const result = [];
+        const visited = new Set();
+        const tempMarked = new Set();
+        const visit = (nodeName) => {
+            if (tempMarked.has(nodeName)) {
+                return false;
+            }
+            if (visited.has(nodeName)) {
+                return true;
+            }
+            tempMarked.add(nodeName);
+            const node = graph.nodes.get(nodeName);
+            if (node) {
+                for (const [depName] of node.dependencies) {
+                    if (graph.nodes.has(depName)) {
+                        if (!visit(depName)) {
+                            return false;
+                        }
+                    }
+                }
+                result.push(node.library);
+            }
+            tempMarked.delete(nodeName);
+            visited.add(nodeName);
+            return true;
+        };
+        for (const nodeName of graph.nodes.keys()) {
+            if (!visited.has(nodeName)) {
+                if (!visit(nodeName)) {
+                    console.error(`Cycle detected involving library: ${nodeName}`);
+                }
+            }
+        }
+        return result;
+    }
+    parseVersion(version) {
+        const match = version.match(/^(\d+)\.(\d+)\.(\d+)(?:-([^+]+))?(?:\+(.+))?$/);
+        if (!match) {
+            return null;
+        }
+        return {
+            major: parseInt(match[1], 10),
+            minor: parseInt(match[2], 10),
+            patch: parseInt(match[3], 10),
+            prerelease: match[4],
+            build: match[5]
+        };
+    }
+    parseVersionRange(spec) {
+        if (spec === '*' || spec === '' || spec === 'latest') {
+            return { type: 'any', raw: spec };
+        }
+        if (spec.startsWith('~')) {
+            const version = this.parseVersion(spec.substring(1));
+            return {
+                type: 'tilde',
+                version: version || undefined,
+                raw: spec
+            };
+        }
+        if (spec.startsWith('^')) {
+            const version = this.parseVersion(spec.substring(1));
+            return {
+                type: 'caret',
+                version: version || undefined,
+                raw: spec
+            };
+        }
+        const version = this.parseVersion(spec);
+        if (version) {
+            return {
+                type: 'exact',
+                version,
+                raw: spec
+            };
+        }
+        return { type: 'any', raw: spec };
+    }
+    versionSatisfiesRange(version, range) {
+        if (range.type === 'any') {
+            return true;
+        }
+        if (!range.version) {
+            return false;
+        }
+        const rangeVer = range.version;
+        switch (range.type) {
+            case 'exact':
+                return version.major === rangeVer.major &&
+                    version.minor === rangeVer.minor &&
+                    version.patch === rangeVer.patch;
+            case 'tilde':
+                if (version.major !== rangeVer.major)
+                    return false;
+                if (version.minor !== rangeVer.minor)
+                    return false;
+                return version.patch >= rangeVer.patch;
+            case 'caret':
+                if (rangeVer.major === 0) {
+                    if (version.major !== 0)
+                        return false;
+                    if (rangeVer.minor === 0) {
+                        return version.minor === 0 && version.patch === rangeVer.patch;
+                    }
+                    if (version.minor !== rangeVer.minor)
+                        return false;
+                    return version.patch >= rangeVer.patch;
+                }
+                if (version.major !== rangeVer.major)
+                    return false;
+                if (version.minor < rangeVer.minor)
+                    return false;
+                if (version.minor === rangeVer.minor) {
+                    return version.patch >= rangeVer.patch;
+                }
+                return true;
+            default:
+                return false;
+        }
+    }
+    compareVersions(a, b) {
+        if (a.major !== b.major)
+            return a.major - b.major;
+        if (a.minor !== b.minor)
+            return a.minor - b.minor;
+        if (a.patch !== b.patch)
+            return a.patch - b.patch;
+        if (!a.prerelease && b.prerelease)
+            return 1;
+        if (a.prerelease && !b.prerelease)
+            return -1;
+        if (a.prerelease && b.prerelease) {
+            return a.prerelease.localeCompare(b.prerelease);
+        }
+        return 0;
+    }
+    resolveVersionConflicts(requirements, availableLibraries) {
+        if (requirements.length === 0) {
+            throw new Error('No version requirements provided');
+        }
+        const libraryName = requirements[0].library;
+        const warnings = [];
+        const availableVersions = availableLibraries
+            .filter(lib => lib.Name === libraryName && lib.Version)
+            .map(lib => ({
+            library: lib,
+            version: this.parseVersion(lib.Version)
+        }))
+            .filter(item => item.version !== null)
+            .sort((a, b) => this.compareVersions(b.version, a.version));
+        if (availableVersions.length === 0) {
+            throw new Error(`No versions available for library '${libraryName}'`);
+        }
+        const ranges = requirements.map(req => ({
+            ...req,
+            range: this.parseVersionRange(req.versionSpec)
+        }));
+        for (const { library, version } of availableVersions) {
+            let satisfiesAll = true;
+            const satisfiedRequirements = [];
+            for (const req of ranges) {
+                if (this.versionSatisfiesRange(version, req.range)) {
+                    satisfiedRequirements.push(req);
+                }
+                else {
+                    satisfiesAll = false;
+                    warnings.push(`Version ${library.Version} does not satisfy '${req.versionSpec}' required by ${req.requestedBy}`);
+                    break;
+                }
+            }
+            if (satisfiesAll) {
+                return {
+                    library: libraryName,
+                    version: library.Version,
+                    satisfies: requirements,
+                    warnings: warnings.length > 0 ? warnings : undefined
+                };
+            }
+        }
+        const latest = availableVersions[0];
+        warnings.push(`Could not find a version that satisfies all requirements. Using ${latest.library.Version}`);
+        return {
+            library: libraryName,
+            version: latest.library.Version,
+            satisfies: [],
+            warnings
+        };
+    }
+    getLoadOrder(requestedLibs, allLibs, options) {
+        const errors = [];
+        const warnings = [];
+        if (this.debug || options?.debug) {
+            console.log('🔍 Getting load order for:', requestedLibs);
+        }
+        const libMap = new Map();
+        for (const lib of allLibs) {
+            if (!libMap.has(lib.Name)) {
+                libMap.set(lib.Name, []);
+            }
+            libMap.get(lib.Name).push(lib);
+        }
+        const needed = new Set();
+        const toProcess = [...requestedLibs];
+        const processed = new Set();
+        const versionRequirements = new Map();
+        let depth = 0;
+        const maxDepth = options?.maxDepth || 10;
+        while (toProcess.length > 0 && depth < maxDepth) {
+            const current = toProcess.shift();
+            if (processed.has(current))
+                continue;
+            processed.add(current);
+            needed.add(current);
+            const libVersions = libMap.get(current);
+            if (!libVersions || libVersions.length === 0) {
+                errors.push(`Library '${current}' not found`);
+                continue;
+            }
+            const lib = libVersions[0];
+            const deps = this.parseDependencies(lib.Dependencies);
+            for (const [depName, depVersion] of deps) {
+                needed.add(depName);
+                if (!versionRequirements.has(depName)) {
+                    versionRequirements.set(depName, []);
+                }
+                versionRequirements.get(depName).push({
+                    library: depName,
+                    versionSpec: depVersion,
+                    requestedBy: current
+                });
+                if (!processed.has(depName)) {
+                    toProcess.push(depName);
+                }
+            }
+            depth++;
+        }
+        if (depth >= maxDepth) {
+            warnings.push(`Maximum dependency depth (${maxDepth}) reached`);
+        }
+        const resolvedLibraries = [];
+        for (const libName of needed) {
+            const requirements = versionRequirements.get(libName) || [];
+            const versions = libMap.get(libName) || [];
+            if (versions.length === 0) {
+                errors.push(`Library '${libName}' not found`);
+                continue;
+            }
+            if (requirements.length > 0) {
+                try {
+                    const resolved = this.resolveVersionConflicts(requirements, versions);
+                    const selectedLib = versions.find(lib => lib.Version === resolved.version);
+                    if (selectedLib) {
+                        resolvedLibraries.push(selectedLib);
+                        if (resolved.warnings) {
+                            warnings.push(...resolved.warnings);
+                        }
+                    }
+                }
+                catch (error) {
+                    errors.push(error.message);
+                    resolvedLibraries.push(versions[0]);
+                }
+            }
+            else {
+                resolvedLibraries.push(versions[0]);
+            }
+        }
+        const graph = this.buildDependencyGraph(resolvedLibraries);
+        const cycles = this.detectCycles(graph);
+        if (cycles.length > 0) {
+            errors.push(`Circular dependencies detected: ${cycles.map(c => c.join(' -> ')).join(', ')}`);
+            return {
+                success: false,
+                cycles,
+                errors,
+                warnings: warnings.length > 0 ? warnings : undefined
+            };
+        }
+        const sorted = this.topologicalSort(graph);
+        if (this.debug || options?.debug) {
+            console.log('✅ Load order determined:', sorted.map(lib => `${lib.Name}@${lib.Version}`));
+        }
+        return {
+            success: errors.length === 0,
+            order: sorted,
+            errors: errors.length > 0 ? errors : undefined,
+            warnings: warnings.length > 0 ? warnings : undefined
+        };
+    }
+    getDirectDependencies(library) {
+        return this.parseDependencies(library.Dependencies);
+    }
+    getTransitiveDependencies(libraryName, allLibs, maxDepth = 10) {
+        const dependencies = new Set();
+        const toProcess = [libraryName];
+        const processed = new Set();
+        let depth = 0;
+        const libMap = new Map();
+        for (const lib of allLibs) {
+            libMap.set(lib.Name, lib);
+        }
+        while (toProcess.length > 0 && depth < maxDepth) {
+            const current = toProcess.shift();
+            if (processed.has(current))
+                continue;
+            processed.add(current);
+            const lib = libMap.get(current);
+            if (!lib)
+                continue;
+            const deps = this.parseDependencies(lib.Dependencies);
+            for (const [depName] of deps) {
+                dependencies.add(depName);
+                if (!processed.has(depName)) {
+                    toProcess.push(depName);
+                }
+            }
+            depth++;
+        }
+        return dependencies;
+    }
+}
+exports.LibraryDependencyResolver = LibraryDependencyResolver;
+//# sourceMappingURL=library-dependency-resolver.js.map

package/dist/utilities/library-dependency-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"library-dependency-resolver.js","sourceRoot":"","sources":["../../src/utilities/library-dependency-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @fileoverview Library dependency resolution utilities\n * Provides dependency graph construction, cycle detection, topological sorting, and version resolution\n * @module @memberjunction/react-runtime/utilities\n */\n\nimport { ComponentLibraryEntity } from '@memberjunction/core-entities';\nimport {\n  DependencyGraph,\n  DependencyNode,\n  LoadOrderResult,\n  ParsedDependency,\n  ParsedVersion,\n  ResolvedVersion,\n  VersionRange,\n  VersionRangeType,\n  VersionRequirement,\n  DependencyResolutionOptions\n} from '../types/dependency-types';\n\n/**\n * Resolves library dependencies and determines load order\n */\nexport class LibraryDependencyResolver {\n  private debug: boolean = false;\n\n  constructor(options?: DependencyResolutionOptions) {\n    this.debug = options?.debug || false;\n  }\n\n  /**\n   * Parse dependencies from JSON string\n   * @param json - JSON string containing dependencies\n   * @returns Map of library name to version specification\n   */\n  parseDependencies(json: string | null): Map<string, string> {\n    const dependencies = new Map<string, string>();\n    \n    if (!json || json.trim() === '') {\n      return dependencies;\n    }\n\n    try {\n      const parsed = JSON.parse(json);\n      if (typeof parsed === 'object' && parsed !== null) {\n        for (const [name, version] of Object.entries(parsed)) {\n          if (typeof version === 'string') {\n            dependencies.set(name, version);\n          }\n        }\n      }\n    } catch (error) {\n      console.error('Failed to parse dependencies JSON:', error);\n    }\n\n    return dependencies;\n  }\n\n  /**\n   * Build a dependency graph from a collection of libraries\n   * @param libraries - All available libraries\n   * @returns Dependency graph structure\n   */\n  buildDependencyGraph(libraries: ComponentLibraryEntity[]): DependencyGraph {\n    const nodes = new Map<string, DependencyNode>();\n    const roots = new Set<string>();\n\n    // First pass: create nodes for all libraries\n    for (const library of libraries) {\n      const dependencies = this.parseDependencies(library.Dependencies);\n      nodes.set(library.Name, {\n        library,\n        dependencies,\n        dependents: new Set()\n      });\n      // Initially assume all are roots\n      roots.add(library.Name);\n    }\n\n    // Second pass: establish dependency relationships\n    for (const [name, node] of nodes) {\n      for (const [depName, depVersion] of node.dependencies) {\n        const depNode = nodes.get(depName);\n        if (depNode) {\n          // This library depends on depName, so depName is not a root\n          roots.delete(depName);\n          // Add this library as a dependent of depName\n          depNode.dependents.add(name);\n        } else if (this.debug) {\n          console.warn(`Dependency '${depName}' not found for library '${name}'`);\n        }\n      }\n    }\n\n    return { nodes, roots };\n  }\n\n  /**\n   * Detect circular dependencies in the graph\n   * @param graph - Dependency graph\n   * @returns Array of cycles found\n   */\n  detectCycles(graph: DependencyGraph): string[][] {\n    const cycles: string[][] = [];\n    const visited = new Set<string>();\n    const recursionStack = new Set<string>();\n    const path: string[] = [];\n\n    const detectCyclesUtil = (nodeName: string): void => {\n      visited.add(nodeName);\n      recursionStack.add(nodeName);\n      path.push(nodeName);\n\n      const node = graph.nodes.get(nodeName);\n      if (node) {\n        for (const [depName] of node.dependencies) {\n          if (!visited.has(depName)) {\n            detectCyclesUtil(depName);\n          } else if (recursionStack.has(depName)) {\n            // Found a cycle\n            const cycleStartIndex = path.indexOf(depName);\n            const cycle = [...path.slice(cycleStartIndex), depName];\n            cycles.push(cycle);\n          }\n        }\n      }\n\n      path.pop();\n      recursionStack.delete(nodeName);\n    };\n\n    // Check all nodes\n    for (const nodeName of graph.nodes.keys()) {\n      if (!visited.has(nodeName)) {\n        detectCyclesUtil(nodeName);\n      }\n    }\n\n    return cycles;\n  }\n\n  /**\n   * Perform topological sort to determine load order\n   * @param graph - Dependency graph\n   * @returns Sorted array of libraries to load in order\n   */\n  topologicalSort(graph: DependencyGraph): ComponentLibraryEntity[] {\n    const result: ComponentLibraryEntity[] = [];\n    const visited = new Set<string>();\n    const tempMarked = new Set<string>();\n\n    const visit = (nodeName: string): boolean => {\n      if (tempMarked.has(nodeName)) {\n        // Cycle detected\n        return false;\n      }\n      if (visited.has(nodeName)) {\n        return true;\n      }\n\n      tempMarked.add(nodeName);\n      const node = graph.nodes.get(nodeName);\n      \n      if (node) {\n        // Visit dependencies first\n        for (const [depName] of node.dependencies) {\n          if (graph.nodes.has(depName)) {\n            if (!visit(depName)) {\n              return false;\n            }\n          }\n        }\n        result.push(node.library);\n      }\n\n      tempMarked.delete(nodeName);\n      visited.add(nodeName);\n      return true;\n    };\n\n    // Start with all nodes\n    for (const nodeName of graph.nodes.keys()) {\n      if (!visited.has(nodeName)) {\n        if (!visit(nodeName)) {\n          console.error(`Cycle detected involving library: ${nodeName}`);\n        }\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Parse a semver version string\n   * @param version - Version string (e.g., \"1.2.3\")\n   * @returns Parsed version object\n   */\n  private parseVersion(version: string): ParsedVersion | null {\n    const match = version.match(/^(\\d+)\\.(\\d+)\\.(\\d+)(?:-([^+]+))?(?:\\+(.+))?$/);\n    if (!match) {\n      return null;\n    }\n\n    return {\n      major: parseInt(match[1], 10),\n      minor: parseInt(match[2], 10),\n      patch: parseInt(match[3], 10),\n      prerelease: match[4],\n      build: match[5]\n    };\n  }\n\n  /**\n   * Parse a version specification into a range\n   * @param spec - Version specification (e.g., \"^1.2.3\", \"~1.2.0\", \"1.2.3\")\n   * @returns Parsed version range\n   */\n  private parseVersionRange(spec: string): VersionRange {\n    if (spec === '*' || spec === '' || spec === 'latest') {\n      return { type: 'any', raw: spec };\n    }\n\n    // Tilde range (~1.2.3)\n    if (spec.startsWith('~')) {\n      const version = this.parseVersion(spec.substring(1));\n      return {\n        type: 'tilde',\n        version: version || undefined,\n        raw: spec\n      };\n    }\n\n    // Caret range (^1.2.3)\n    if (spec.startsWith('^')) {\n      const version = this.parseVersion(spec.substring(1));\n      return {\n        type: 'caret',\n        version: version || undefined,\n        raw: spec\n      };\n    }\n\n    // Exact version\n    const version = this.parseVersion(spec);\n    if (version) {\n      return {\n        type: 'exact',\n        version,\n        raw: spec\n      };\n    }\n\n    // Default to any if we can't parse\n    return { type: 'any', raw: spec };\n  }\n\n  /**\n   * Check if a version satisfies a version range\n   * @param version - Version to check\n   * @param range - Version range specification\n   * @returns True if version satisfies range\n   */\n  private versionSatisfiesRange(version: ParsedVersion, range: VersionRange): boolean {\n    if (range.type === 'any') {\n      return true;\n    }\n\n    if (!range.version) {\n      return false;\n    }\n\n    const rangeVer = range.version;\n\n    switch (range.type) {\n      case 'exact':\n        return version.major === rangeVer.major &&\n               version.minor === rangeVer.minor &&\n               version.patch === rangeVer.patch;\n\n      case 'tilde': // ~1.2.3 means >=1.2.3 <1.3.0\n        if (version.major !== rangeVer.major) return false;\n        if (version.minor !== rangeVer.minor) return false;\n        return version.patch >= rangeVer.patch;\n\n      case 'caret': // ^1.2.3 means >=1.2.3 <2.0.0 (for 1.x.x)\n        if (rangeVer.major === 0) {\n          // ^0.x.y behaves like ~0.x.y\n          if (version.major !== 0) return false;\n          if (rangeVer.minor === 0) {\n            // ^0.0.x means exactly 0.0.x\n            return version.minor === 0 && version.patch === rangeVer.patch;\n          }\n          // ^0.x.y means >=0.x.y <0.(x+1).0\n          if (version.minor !== rangeVer.minor) return false;\n          return version.patch >= rangeVer.patch;\n        }\n        // Normal caret for major > 0\n        if (version.major !== rangeVer.major) return false;\n        if (version.minor < rangeVer.minor) return false;\n        if (version.minor === rangeVer.minor) {\n          return version.patch >= rangeVer.patch;\n        }\n        return true;\n\n      default:\n        return false;\n    }\n  }\n\n  /**\n   * Compare two versions for sorting\n   * @returns -1 if a < b, 0 if a === b, 1 if a > b\n   */\n  private compareVersions(a: ParsedVersion, b: ParsedVersion): number {\n    if (a.major !== b.major) return a.major - b.major;\n    if (a.minor !== b.minor) return a.minor - b.minor;\n    if (a.patch !== b.patch) return a.patch - b.patch;\n    \n    // Handle prerelease versions\n    if (!a.prerelease && b.prerelease) return 1; // a is newer\n    if (a.prerelease && !b.prerelease) return -1; // b is newer\n    if (a.prerelease && b.prerelease) {\n      return a.prerelease.localeCompare(b.prerelease);\n    }\n    \n    return 0;\n  }\n\n  /**\n   * Resolve version conflicts using NPM-style resolution\n   * @param requirements - Array of version requirements\n   * @param availableLibraries - All available libraries to choose from\n   * @returns Resolved version information\n   */\n  resolveVersionConflicts(\n    requirements: VersionRequirement[],\n    availableLibraries: ComponentLibraryEntity[]\n  ): ResolvedVersion {\n    if (requirements.length === 0) {\n      throw new Error('No version requirements provided');\n    }\n\n    const libraryName = requirements[0].library;\n    const warnings: string[] = [];\n\n    // Find all available versions for this library\n    const availableVersions = availableLibraries\n      .filter(lib => lib.Name === libraryName && lib.Version)\n      .map(lib => ({\n        library: lib,\n        version: this.parseVersion(lib.Version!)\n      }))\n      .filter(item => item.version !== null)\n      .sort((a, b) => this.compareVersions(b.version!, a.version!)); // Sort descending\n\n    if (availableVersions.length === 0) {\n      throw new Error(`No versions available for library '${libraryName}'`);\n    }\n\n    // Parse all requirements\n    const ranges = requirements.map(req => ({\n      ...req,\n      range: this.parseVersionRange(req.versionSpec)\n    }));\n\n    // Find the highest version that satisfies all requirements\n    for (const { library, version } of availableVersions) {\n      let satisfiesAll = true;\n      const satisfiedRequirements: VersionRequirement[] = [];\n\n      for (const req of ranges) {\n        if (this.versionSatisfiesRange(version!, req.range)) {\n          satisfiedRequirements.push(req);\n        } else {\n          satisfiesAll = false;\n          warnings.push(\n            `Version ${library.Version} does not satisfy '${req.versionSpec}' required by ${req.requestedBy}`\n          );\n          break;\n        }\n      }\n\n      if (satisfiesAll) {\n        return {\n          library: libraryName,\n          version: library.Version!,\n          satisfies: requirements,\n          warnings: warnings.length > 0 ? warnings : undefined\n        };\n      }\n    }\n\n    // No version satisfies all requirements\n    // Return the latest version with warnings\n    const latest = availableVersions[0];\n    warnings.push(\n      `Could not find a version that satisfies all requirements. Using ${latest.library.Version}`\n    );\n\n    return {\n      library: libraryName,\n      version: latest.library.Version!,\n      satisfies: [],\n      warnings\n    };\n  }\n\n  /**\n   * Get the load order for a set of requested libraries\n   * @param requestedLibs - Library names requested\n   * @param allLibs - All available libraries\n   * @param options - Resolution options\n   * @returns Load order result\n   */\n  getLoadOrder(\n    requestedLibs: string[],\n    allLibs: ComponentLibraryEntity[],\n    options?: DependencyResolutionOptions\n  ): LoadOrderResult {\n    const errors: string[] = [];\n    const warnings: string[] = [];\n\n    if (this.debug || options?.debug) {\n      console.log('🔍 Getting load order for:', requestedLibs);\n    }\n\n    // Build a map for quick lookup\n    const libMap = new Map<string, ComponentLibraryEntity[]>();\n    for (const lib of allLibs) {\n      if (!libMap.has(lib.Name)) {\n        libMap.set(lib.Name, []);\n      }\n      libMap.get(lib.Name)!.push(lib);\n    }\n\n    // Collect all libraries needed (requested + their dependencies)\n    const needed = new Set<string>();\n    const toProcess = [...requestedLibs];\n    const processed = new Set<string>();\n    const versionRequirements = new Map<string, VersionRequirement[]>();\n    let depth = 0;\n    const maxDepth = options?.maxDepth || 10;\n\n    while (toProcess.length > 0 && depth < maxDepth) {\n      const current = toProcess.shift()!;\n      if (processed.has(current)) continue;\n\n      processed.add(current);\n      needed.add(current);\n\n      // Find the library\n      const libVersions = libMap.get(current);\n      if (!libVersions || libVersions.length === 0) {\n        errors.push(`Library '${current}' not found`);\n        continue;\n      }\n\n      // For now, use the first version found (should be resolved properly)\n      const lib = libVersions[0];\n      const deps = this.parseDependencies(lib.Dependencies);\n\n      // Process dependencies\n      for (const [depName, depVersion] of deps) {\n        needed.add(depName);\n        \n        // Track version requirements\n        if (!versionRequirements.has(depName)) {\n          versionRequirements.set(depName, []);\n        }\n        versionRequirements.get(depName)!.push({\n          library: depName,\n          versionSpec: depVersion,\n          requestedBy: current\n        });\n\n        if (!processed.has(depName)) {\n          toProcess.push(depName);\n        }\n      }\n\n      depth++;\n    }\n\n    if (depth >= maxDepth) {\n      warnings.push(`Maximum dependency depth (${maxDepth}) reached`);\n    }\n\n    // Resolve version conflicts for each library\n    const resolvedLibraries: ComponentLibraryEntity[] = [];\n    for (const libName of needed) {\n      const requirements = versionRequirements.get(libName) || [];\n      const versions = libMap.get(libName) || [];\n      \n      if (versions.length === 0) {\n        errors.push(`Library '${libName}' not found`);\n        continue;\n      }\n\n      if (requirements.length > 0) {\n        try {\n          const resolved = this.resolveVersionConflicts(requirements, versions);\n          const selectedLib = versions.find(lib => lib.Version === resolved.version);\n          if (selectedLib) {\n            resolvedLibraries.push(selectedLib);\n            if (resolved.warnings) {\n              warnings.push(...resolved.warnings);\n            }\n          }\n        } catch (error: any) {\n          errors.push(error.message);\n          // Use first available version as fallback\n          resolvedLibraries.push(versions[0]);\n        }\n      } else {\n        // No specific requirements, use the first (default) version\n        resolvedLibraries.push(versions[0]);\n      }\n    }\n\n    // Build dependency graph with resolved libraries\n    const graph = this.buildDependencyGraph(resolvedLibraries);\n\n    // Check for cycles\n    const cycles = this.detectCycles(graph);\n    if (cycles.length > 0) {\n      errors.push(`Circular dependencies detected: ${cycles.map(c => c.join(' -> ')).join(', ')}`);\n      return {\n        success: false,\n        cycles,\n        errors,\n        warnings: warnings.length > 0 ? warnings : undefined\n      };\n    }\n\n    // Perform topological sort\n    const sorted = this.topologicalSort(graph);\n\n    if (this.debug || options?.debug) {\n      console.log('✅ Load order determined:', sorted.map(lib => `${lib.Name}@${lib.Version}`));\n    }\n\n    return {\n      success: errors.length === 0,\n      order: sorted,\n      errors: errors.length > 0 ? errors : undefined,\n      warnings: warnings.length > 0 ? warnings : undefined\n    };\n  }\n\n  /**\n   * Get direct dependencies of a library\n   * @param library - Library to get dependencies for\n   * @returns Map of dependency names to version specs\n   */\n  getDirectDependencies(library: ComponentLibraryEntity): Map<string, string> {\n    return this.parseDependencies(library.Dependencies);\n  }\n\n  /**\n   * Get all transitive dependencies of a library\n   * @param libraryName - Library name to analyze\n   * @param allLibs - All available libraries\n   * @param maxDepth - Maximum depth to traverse\n   * @returns Set of all dependency names (including transitive)\n   */\n  getTransitiveDependencies(\n    libraryName: string,\n    allLibs: ComponentLibraryEntity[],\n    maxDepth: number = 10\n  ): Set<string> {\n    const dependencies = new Set<string>();\n    const toProcess = [libraryName];\n    const processed = new Set<string>();\n    let depth = 0;\n\n    // Build lookup map\n    const libMap = new Map<string, ComponentLibraryEntity>();\n    for (const lib of allLibs) {\n      libMap.set(lib.Name, lib);\n    }\n\n    while (toProcess.length > 0 && depth < maxDepth) {\n      const current = toProcess.shift()!;\n      if (processed.has(current)) continue;\n\n      processed.add(current);\n      const lib = libMap.get(current);\n      if (!lib) continue;\n\n      const deps = this.parseDependencies(lib.Dependencies);\n      for (const [depName] of deps) {\n        dependencies.add(depName);\n        if (!processed.has(depName)) {\n          toProcess.push(depName);\n        }\n      }\n\n      depth++;\n    }\n\n    return dependencies;\n  }\n}"]}

package/dist/utilities/library-loader.d.ts

@@ -1,5 +1,7 @@
 import { StandardLibraries } from './standard-libraries';
 import { LibraryConfiguration, ExternalLibraryConfig, LibraryLoadOptions as ConfigLoadOptions } from '../types/library-config';
+import { ComponentLibraryEntity } from '@memberjunction/core-entities';
+import { LoadedLibraryState, DependencyResolutionOptions } from '../types/dependency-types';
 interface LoadedResource {
     element: HTMLScriptElement | HTMLLinkElement;
     promise: Promise<any>;
@@ -21,6 +23,8 @@ export interface LibraryLoadResult {
 }
 export declare class LibraryLoader {
     private static loadedResources;
+    private static loadedLibraryStates;
+    private static dependencyResolver;
     static loadAllLibraries(config?: LibraryConfiguration, additionalLibraries?: ExternalLibraryConfig[]): Promise<LibraryLoadResult>;
     static loadLibrariesFromConfig(options?: ConfigLoadOptions): Promise<LibraryLoadResult>;
     static loadLibraries(options: LibraryLoadOptions): Promise<LibraryLoadResult>;
@@ -29,6 +33,11 @@ export declare class LibraryLoader {
     private static waitForScriptLoad;
     static getLoadedResources(): Map<string, LoadedResource>;
     static clearCache(): void;
+    static loadLibraryWithDependencies(libraryName: string, allLibraries: ComponentLibraryEntity[], requestedBy?: string, options?: DependencyResolutionOptions): Promise<any>;
+    static loadLibrariesWithDependencies(libraryNames: string[], allLibraries: ComponentLibraryEntity[], requestedBy?: string, options?: DependencyResolutionOptions): Promise<Map<string, any>>;
+    static getLoadedLibraryStates(): Map<string, LoadedLibraryState>;
+    static isLibraryLoaded(libraryName: string): boolean;
+    static getLoadedLibraryVersion(libraryName: string): string | undefined;
 }
 export {};
 //# sourceMappingURL=library-loader.d.ts.map

package/dist/utilities/library-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"library-loader.d.ts","sourceRoot":"","sources":["../../src/utilities/library-loader.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,iBAAiB,EAElB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,kBAAkB,IAAI,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAU/H,UAAU,cAAc;IACtB,OAAO,EAAE,iBAAiB,GAAG,eAAe,CAAC;IAC7C,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;CACvB;AAMD,MAAM,WAAW,kBAAkB;IAEjC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,eAAe,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACzD;AAKD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,GAAG,CAAC;IACX,QAAQ,EAAE,GAAG,CAAC;IACd,KAAK,EAAE,GAAG,CAAC;IACX,SAAS,EAAE,iBAAiB,CAAC;CAC9B;AAKD,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,eAAe,CAAqC;WAQtD,gBAAgB,CAC3B,MAAM,CAAC,EAAE,oBAAoB,EAC7B,mBAAmB,CAAC,EAAE,qBAAqB,EAAE,GAC5C,OAAO,CAAC,iBAAiB,CAAC;WAwBhB,uBAAuB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;WAkFhF,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;mBAuC9D,UAAU;IAiF/B,OAAO,CAAC,MAAM,CAAC,OAAO;IA2BtB,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAmDhC,MAAM,CAAC,kBAAkB,IAAI,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC;IAOxD,MAAM,CAAC,UAAU,IAAI,IAAI;CAa1B"}
+{"version":3,"file":"library-loader.d.ts","sourceRoot":"","sources":["../../src/utilities/library-loader.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,iBAAiB,EAElB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,kBAAkB,IAAI,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG/H,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,OAAO,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAS5F,UAAU,cAAc;IACtB,OAAO,EAAE,iBAAiB,GAAG,eAAe,CAAC;IAC7C,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;CACvB;AAMD,MAAM,WAAW,kBAAkB;IAEjC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,eAAe,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACzD;AAKD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,GAAG,CAAC;IACX,QAAQ,EAAE,GAAG,CAAC;IACd,KAAK,EAAE,GAAG,CAAC;IACX,SAAS,EAAE,iBAAiB,CAAC;CAC9B;AAKD,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,eAAe,CAAqC;IACnE,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAyC;IAC3E,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAmD;WAQvE,gBAAgB,CAC3B,MAAM,CAAC,EAAE,oBAAoB,EAC7B,mBAAmB,CAAC,EAAE,qBAAqB,EAAE,GAC5C,OAAO,CAAC,iBAAiB,CAAC;WAwBhB,uBAAuB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;WAkFhF,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;mBAuC9D,UAAU;IAiF/B,OAAO,CAAC,MAAM,CAAC,OAAO;IA2BtB,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAmDhC,MAAM,CAAC,kBAAkB,IAAI,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC;IAOxD,MAAM,CAAC,UAAU,IAAI,IAAI;WAuBZ,2BAA2B,CACtC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,sBAAsB,EAAE,EACtC,WAAW,GAAE,MAAe,EAC5B,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,GAAG,CAAC;WA6GF,6BAA6B,CACxC,YAAY,EAAE,MAAM,EAAE,EACtB,YAAY,EAAE,sBAAsB,EAAE,EACtC,WAAW,GAAE,MAAe,EAC5B,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAgG5B,MAAM,CAAC,sBAAsB,IAAI,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC;IAShE,MAAM,CAAC,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IASpD,MAAM,CAAC,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAGxE"}