@mytechtoday/augment-extensions 1.7.0 → 2.2.0

package/cli/dist/core/compatibility-checker.js

@@ -0,0 +1,188 @@
+"use strict";
+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 () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompatibilityChecker = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const module_system_1 = require("../utils/module-system");
+const child_process_1 = require("child_process");
+/**
+ * CompatibilityChecker class
+ * Validates module compatibility with runtime environment
+ */
+class CompatibilityChecker {
+    constructor() {
+        this.nodeVersion = process.version.replace('v', '');
+        this.typescriptVersion = this.detectTypeScriptVersion();
+    }
+    /**
+     * Check compatibility of a module
+     * @param modulePath Path to the module directory
+     * @returns Compatibility check result
+     */
+    checkCompatibility(modulePath) {
+        const errors = [];
+        const warnings = [];
+        const deprecations = [];
+        const details = {};
+        // Load module metadata
+        const metadata = this.loadCompatibilityMetadata(modulePath);
+        if (!metadata) {
+            warnings.push('No compatibility metadata found');
+            return {
+                compatible: true,
+                errors,
+                warnings,
+                deprecations,
+                details
+            };
+        }
+        // Check deprecation
+        if (metadata.deprecated) {
+            deprecations.push(metadata.deprecationMessage || 'This module is deprecated');
+        }
+        // Check breaking changes
+        if (metadata.breaking) {
+            warnings.push('This version contains breaking changes');
+        }
+        // Check Node.js version
+        if (metadata.nodeMinVersion) {
+            const nodeCheck = this.checkNodeVersion(metadata.nodeMinVersion);
+            details.node = nodeCheck;
+            if (!nodeCheck.compatible) {
+                errors.push(nodeCheck.message || 'Node.js version incompatible');
+            }
+        }
+        // Check TypeScript version
+        if (metadata.typescriptMinVersion) {
+            const tsCheck = this.checkTypeScriptVersion(metadata.typescriptMinVersion);
+            details.typescript = tsCheck;
+            if (!tsCheck.compatible) {
+                warnings.push(tsCheck.message || 'TypeScript version may be incompatible');
+            }
+        }
+        // Check Augment version (if available)
+        if (metadata.augmentMinVersion) {
+            // TODO: Implement Augment version detection
+            details.augment = {
+                required: metadata.augmentMinVersion,
+                current: 'unknown',
+                compatible: true,
+                message: 'Augment version check not implemented'
+            };
+        }
+        return {
+            compatible: errors.length === 0,
+            errors,
+            warnings,
+            deprecations,
+            details
+        };
+    }
+    /**
+     * Check Node.js version compatibility
+     * @param requiredVersion Minimum required Node.js version
+     * @returns Version check result
+     */
+    checkNodeVersion(requiredVersion) {
+        const compatible = (0, module_system_1.compareSemanticVersions)(this.nodeVersion, requiredVersion) >= 0;
+        return {
+            required: requiredVersion,
+            current: this.nodeVersion,
+            compatible,
+            message: compatible
+                ? undefined
+                : `Node.js ${requiredVersion} or higher required (current: ${this.nodeVersion})`
+        };
+    }
+    /**
+     * Check TypeScript version compatibility
+     * @param requiredVersion Minimum required TypeScript version
+     * @returns Version check result
+     */
+    checkTypeScriptVersion(requiredVersion) {
+        if (!this.typescriptVersion) {
+            return {
+                required: requiredVersion,
+                current: 'not installed',
+                compatible: false,
+                message: `TypeScript ${requiredVersion} or higher required (not installed)`
+            };
+        }
+        const compatible = (0, module_system_1.compareSemanticVersions)(this.typescriptVersion, requiredVersion) >= 0;
+        return {
+            required: requiredVersion,
+            current: this.typescriptVersion,
+            compatible,
+            message: compatible
+                ? undefined
+                : `TypeScript ${requiredVersion} or higher required (current: ${this.typescriptVersion})`
+        };
+    }
+    /**
+     * Load compatibility metadata from module
+     * @param modulePath Path to the module directory
+     * @returns Compatibility metadata or null
+     */
+    loadCompatibilityMetadata(modulePath) {
+        const metadataFile = path.join(modulePath, 'metadata.json');
+        if (!fs.existsSync(metadataFile)) {
+            return null;
+        }
+        try {
+            const content = JSON.parse(fs.readFileSync(metadataFile, 'utf-8'));
+            return content.compatibility || null;
+        }
+        catch (error) {
+            return null;
+        }
+    }
+    /**
+     * Detect installed TypeScript version
+     * @returns TypeScript version string or null if not installed
+     */
+    detectTypeScriptVersion() {
+        try {
+            const output = (0, child_process_1.execSync)('tsc --version', { encoding: 'utf-8', stdio: 'pipe' });
+            const match = output.match(/Version (\d+\.\d+\.\d+)/);
+            return match ? match[1] : null;
+        }
+        catch (error) {
+            return null;
+        }
+    }
+}
+exports.CompatibilityChecker = CompatibilityChecker;
+//# sourceMappingURL=compatibility-checker.js.map

package/cli/dist/core/compatibility-checker.js.map

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

package/cli/dist/core/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Core module exports
+ * Provides version management, resolution, compatibility checking, and module loading
+ */
+export { VersionManager, type VersionMetadata } from './version-manager';
+export { VersionResolver, type VersionStrategy, type VersionResolutionResult } from './version-resolver';
+export { CompatibilityChecker, type CompatibilityResult, type VersionCheckResult, type CompatibilityMetadata } from './compatibility-checker';
+export { ModuleLoader, type ModuleLoadOptions, type ModuleLoadResult } from './module-loader';
+//# sourceMappingURL=index.d.ts.map

package/cli/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,KAAK,eAAe,EAAE,KAAK,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AACzG,OAAO,EACL,oBAAoB,EACpB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC3B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,YAAY,EACZ,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACtB,MAAM,iBAAiB,CAAC"}

package/cli/dist/core/index.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * Core module exports
+ * Provides version management, resolution, compatibility checking, and module loading
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModuleLoader = exports.CompatibilityChecker = exports.VersionResolver = exports.VersionManager = void 0;
+var version_manager_1 = require("./version-manager");
+Object.defineProperty(exports, "VersionManager", { enumerable: true, get: function () { return version_manager_1.VersionManager; } });
+var version_resolver_1 = require("./version-resolver");
+Object.defineProperty(exports, "VersionResolver", { enumerable: true, get: function () { return version_resolver_1.VersionResolver; } });
+var compatibility_checker_1 = require("./compatibility-checker");
+Object.defineProperty(exports, "CompatibilityChecker", { enumerable: true, get: function () { return compatibility_checker_1.CompatibilityChecker; } });
+var module_loader_1 = require("./module-loader");
+Object.defineProperty(exports, "ModuleLoader", { enumerable: true, get: function () { return module_loader_1.ModuleLoader; } });
+//# sourceMappingURL=index.js.map

package/cli/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,qDAAyE;AAAhE,iHAAA,cAAc,OAAA;AACvB,uDAAyG;AAAhG,mHAAA,eAAe,OAAA;AACxB,iEAKiC;AAJ/B,6HAAA,oBAAoB,OAAA;AAKtB,iDAIyB;AAHvB,6GAAA,YAAY,OAAA"}

package/cli/dist/core/module-loader.d.ts

@@ -0,0 +1,68 @@
+import { VersionManager, VersionMetadata } from './version-manager';
+import { VersionResolver, VersionResolutionResult } from './version-resolver';
+import { Module } from '../utils/module-system';
+/**
+ * Module load options
+ */
+export interface ModuleLoadOptions {
+    version?: string;
+    useCache?: boolean;
+    cacheTTL?: number;
+}
+/**
+ * Module load result
+ */
+export interface ModuleLoadResult {
+    module: Module;
+    version: string;
+    metadata: VersionMetadata;
+    resolution: VersionResolutionResult;
+}
+/**
+ * ModuleLoader class
+ * Manages module loading with version support and caching
+ */
+export declare class ModuleLoader {
+    private versionManager;
+    private versionResolver;
+    private cache;
+    private cacheTTL;
+    constructor(versionManager?: VersionManager, versionResolver?: VersionResolver);
+    /**
+     * Load a module with optional version specification
+     * @param modulePath Path to the module directory
+     * @param options Load options including version specification
+     * @returns Module load result or null if not found
+     */
+    load(modulePath: string, options?: ModuleLoadOptions): ModuleLoadResult | null;
+    /**
+     * Get version metadata for a module without loading it
+     * @param modulePath Path to the module directory
+     * @returns Version metadata or null if not found
+     */
+    getVersionMetadata(modulePath: string): VersionMetadata | null;
+    /**
+     * Get all available versions for a module
+     * @param modulePath Path to the module directory
+     * @returns Array of version strings
+     */
+    getAvailableVersions(modulePath: string): string[];
+    /**
+     * Clear module cache
+     * @param modulePath Optional path to clear specific module, or all if not provided
+     */
+    clearCache(modulePath?: string): void;
+    /**
+     * Set cache TTL
+     * @param ttl Time to live in milliseconds
+     */
+    setCacheTTL(ttl: number): void;
+    /**
+     * Generate cache key for module and version
+     * @param modulePath Module path
+     * @param version Version string
+     * @returns Cache key
+     */
+    private getCacheKey;
+}
+//# sourceMappingURL=module-loader.d.ts.map

package/cli/dist/core/module-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-loader.d.ts","sourceRoot":"","sources":["../../src/core/module-loader.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAc,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAY5D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,eAAe,CAAC;IAC1B,UAAU,EAAE,uBAAuB,CAAC;CACrC;AAED;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,KAAK,CAA4C;IACzD,OAAO,CAAC,QAAQ,CAAmB;gBAEvB,cAAc,CAAC,EAAE,cAAc,EAAE,eAAe,CAAC,EAAE,eAAe;IAK9E;;;;;OAKG;IACH,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,gBAAgB,GAAG,IAAI;IAmElF;;;;OAIG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAI9D;;;;OAIG;IACH,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;IAKlD;;;OAGG;IACH,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAgBrC;;;OAGG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI9B;;;;;OAKG;IACH,OAAO,CAAC,WAAW;CAGpB"}

package/cli/dist/core/module-loader.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModuleLoader = void 0;
+const version_manager_1 = require("./version-manager");
+const version_resolver_1 = require("./version-resolver");
+const module_system_1 = require("../utils/module-system");
+/**
+ * ModuleLoader class
+ * Manages module loading with version support and caching
+ */
+class ModuleLoader {
+    constructor(versionManager, versionResolver) {
+        this.cache = new Map();
+        this.cacheTTL = 3600000; // 1 hour in milliseconds
+        this.versionManager = versionManager || new version_manager_1.VersionManager();
+        this.versionResolver = versionResolver || new version_resolver_1.VersionResolver(this.versionManager);
+    }
+    /**
+     * Load a module with optional version specification
+     * @param modulePath Path to the module directory
+     * @param options Load options including version specification
+     * @returns Module load result or null if not found
+     */
+    load(modulePath, options = {}) {
+        const { version = 'latest', useCache = true, cacheTTL } = options;
+        // Set custom cache TTL if provided
+        if (cacheTTL !== undefined) {
+            this.cacheTTL = cacheTTL;
+        }
+        // Check cache first
+        const cacheKey = this.getCacheKey(modulePath, version);
+        if (useCache) {
+            const cached = this.cache.get(cacheKey);
+            if (cached && Date.now() - cached.timestamp < this.cacheTTL) {
+                // Return cached result with resolution info
+                return {
+                    module: cached.module,
+                    version: cached.version,
+                    metadata: cached.metadata,
+                    resolution: {
+                        version: cached.version,
+                        path: modulePath,
+                        strategy: version === 'latest' ? 'latest' : 'specific',
+                        available: [cached.version]
+                    }
+                };
+            }
+        }
+        // Resolve version
+        const resolution = this.versionResolver.resolve(modulePath, version);
+        if (!resolution) {
+            return null;
+        }
+        // Load module from resolved path
+        const module = (0, module_system_1.loadModule)(resolution.path);
+        if (!module) {
+            return null;
+        }
+        // Get version metadata
+        const metadata = this.versionManager.getVersion(resolution.path);
+        if (!metadata) {
+            return null;
+        }
+        // Create result
+        const result = {
+            module,
+            version: resolution.version,
+            metadata,
+            resolution
+        };
+        // Cache the result
+        if (useCache) {
+            this.cache.set(cacheKey, {
+                module,
+                version: resolution.version,
+                metadata,
+                timestamp: Date.now()
+            });
+        }
+        return result;
+    }
+    /**
+     * Get version metadata for a module without loading it
+     * @param modulePath Path to the module directory
+     * @returns Version metadata or null if not found
+     */
+    getVersionMetadata(modulePath) {
+        return this.versionManager.getVersion(modulePath);
+    }
+    /**
+     * Get all available versions for a module
+     * @param modulePath Path to the module directory
+     * @returns Array of version strings
+     */
+    getAvailableVersions(modulePath) {
+        const resolution = this.versionResolver.resolveLatest(modulePath);
+        return resolution?.available || [];
+    }
+    /**
+     * Clear module cache
+     * @param modulePath Optional path to clear specific module, or all if not provided
+     */
+    clearCache(modulePath) {
+        if (modulePath) {
+            // Clear all cache entries for this module path
+            const keysToDelete = [];
+            for (const key of this.cache.keys()) {
+                if (key.startsWith(modulePath + ':')) {
+                    keysToDelete.push(key);
+                }
+            }
+            keysToDelete.forEach(key => this.cache.delete(key));
+        }
+        else {
+            // Clear all cache
+            this.cache.clear();
+        }
+    }
+    /**
+     * Set cache TTL
+     * @param ttl Time to live in milliseconds
+     */
+    setCacheTTL(ttl) {
+        this.cacheTTL = ttl;
+    }
+    /**
+     * Generate cache key for module and version
+     * @param modulePath Module path
+     * @param version Version string
+     * @returns Cache key
+     */
+    getCacheKey(modulePath, version) {
+        return `${modulePath}:${version}`;
+    }
+}
+exports.ModuleLoader = ModuleLoader;
+//# sourceMappingURL=module-loader.js.map

package/cli/dist/core/module-loader.js.map

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

package/cli/dist/core/version-manager.d.ts

@@ -0,0 +1,62 @@
+import { type SemanticVersion } from '../utils/module-system';
+/**
+ * Version metadata interface
+ */
+export interface VersionMetadata {
+    version: string;
+    publishedAt?: Date;
+    deprecated?: boolean;
+    deprecationMessage?: string;
+    breaking?: boolean;
+    changelog?: string;
+}
+/**
+ * VersionManager class
+ * Manages module versions including loading, caching, and comparison
+ */
+export declare class VersionManager {
+    private cache;
+    private cacheTTL;
+    /**
+     * Get version metadata for a module
+     * @param modulePath Path to the module directory
+     * @returns Version metadata or null if not found
+     */
+    getVersion(modulePath: string): VersionMetadata | null;
+    /**
+     * Set version for a module
+     * @param modulePath Path to the module directory
+     * @param version Version string (must be valid semver)
+     * @returns True if successful, false otherwise
+     */
+    setVersion(modulePath: string, version: string): boolean;
+    /**
+     * Compare two versions
+     * @param v1 First version string
+     * @param v2 Second version string
+     * @returns -1 if v1 < v2, 0 if v1 === v2, 1 if v1 > v2
+     */
+    compareVersions(v1: string, v2: string): number;
+    /**
+     * Parse version string into components
+     * @param version Version string
+     * @returns Parsed semantic version or null if invalid
+     */
+    parseVersion(version: string): SemanticVersion | null;
+    /**
+     * Check if version is deprecated
+     * @param modulePath Path to the module directory
+     * @returns True if deprecated, false otherwise
+     */
+    isDeprecated(modulePath: string): boolean;
+    /**
+     * Clear version cache
+     */
+    clearCache(): void;
+    /**
+     * Set cache TTL
+     * @param ttl Time to live in milliseconds
+     */
+    setCacheTTL(ttl: number): void;
+}
+//# sourceMappingURL=version-manager.d.ts.map

package/cli/dist/core/version-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-manager.d.ts","sourceRoot":"","sources":["../../src/core/version-manager.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,wBAAwB,CAAC;AAEhC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAUD;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,QAAQ,CAAmB;IAEnC;;;;OAIG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAgDtD;;;;;OAKG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAkBxD;;;;;OAKG;IACH,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM;IAI/C;;;;OAIG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAIrD;;;;OAIG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAKzC;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;;OAGG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAG/B"}

package/cli/dist/core/version-manager.js

@@ -0,0 +1,157 @@
+"use strict";
+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 () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VersionManager = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const module_system_1 = require("../utils/module-system");
+/**
+ * VersionManager class
+ * Manages module versions including loading, caching, and comparison
+ */
+class VersionManager {
+    constructor() {
+        this.cache = new Map();
+        this.cacheTTL = 3600000; // 1 hour in milliseconds
+    }
+    /**
+     * Get version metadata for a module
+     * @param modulePath Path to the module directory
+     * @returns Version metadata or null if not found
+     */
+    getVersion(modulePath) {
+        // Check cache first
+        const cached = this.cache.get(modulePath);
+        if (cached && Date.now() - cached.timestamp < this.cacheTTL) {
+            return cached.metadata;
+        }
+        // Load from VERSION file
+        const versionFile = path.join(modulePath, 'VERSION');
+        if (!fs.existsSync(versionFile)) {
+            return null;
+        }
+        try {
+            const version = fs.readFileSync(versionFile, 'utf-8').trim();
+            if (!(0, module_system_1.isValidSemanticVersion)(version)) {
+                return null;
+            }
+            // Load additional metadata if available
+            const metadataFile = path.join(modulePath, 'metadata.json');
+            let metadata = { version };
+            if (fs.existsSync(metadataFile)) {
+                const metadataContent = JSON.parse(fs.readFileSync(metadataFile, 'utf-8'));
+                metadata = {
+                    version,
+                    publishedAt: metadataContent.publishedAt ? new Date(metadataContent.publishedAt) : undefined,
+                    deprecated: metadataContent.deprecated || false,
+                    deprecationMessage: metadataContent.deprecationMessage,
+                    breaking: metadataContent.breaking || false,
+                    changelog: metadataContent.changelog
+                };
+            }
+            // Cache the result
+            this.cache.set(modulePath, {
+                metadata,
+                timestamp: Date.now()
+            });
+            return metadata;
+        }
+        catch (error) {
+            return null;
+        }
+    }
+    /**
+     * Set version for a module
+     * @param modulePath Path to the module directory
+     * @param version Version string (must be valid semver)
+     * @returns True if successful, false otherwise
+     */
+    setVersion(modulePath, version) {
+        if (!(0, module_system_1.isValidSemanticVersion)(version)) {
+            return false;
+        }
+        try {
+            const versionFile = path.join(modulePath, 'VERSION');
+            fs.writeFileSync(versionFile, version + '\n', 'utf-8');
+            // Invalidate cache
+            this.cache.delete(modulePath);
+            return true;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    /**
+     * Compare two versions
+     * @param v1 First version string
+     * @param v2 Second version string
+     * @returns -1 if v1 < v2, 0 if v1 === v2, 1 if v1 > v2
+     */
+    compareVersions(v1, v2) {
+        return (0, module_system_1.compareSemanticVersions)(v1, v2);
+    }
+    /**
+     * Parse version string into components
+     * @param version Version string
+     * @returns Parsed semantic version or null if invalid
+     */
+    parseVersion(version) {
+        return (0, module_system_1.parseSemanticVersion)(version);
+    }
+    /**
+     * Check if version is deprecated
+     * @param modulePath Path to the module directory
+     * @returns True if deprecated, false otherwise
+     */
+    isDeprecated(modulePath) {
+        const metadata = this.getVersion(modulePath);
+        return metadata?.deprecated || false;
+    }
+    /**
+     * Clear version cache
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+    /**
+     * Set cache TTL
+     * @param ttl Time to live in milliseconds
+     */
+    setCacheTTL(ttl) {
+        this.cacheTTL = ttl;
+    }
+}
+exports.VersionManager = VersionManager;
+//# sourceMappingURL=version-manager.js.map