@bobschlowinskii/clicraft 0.4.0

package/commands/upgrade.js

@@ -0,0 +1,343 @@
+import chalk from 'chalk';
+import fs from 'fs';
+import path from 'path';
+import inquirer from 'inquirer';
+import version from '../helpers/getv.js';
+import * as v from '../helpers/versions.js';
+import { 
+    fetchJson, 
+    downloadFile, 
+    loadConfig, 
+    saveConfig, 
+    getInstancePath, 
+    requireConfig, 
+    paginatedSelect,
+    mavenToPath
+} from '../helpers/utils.js';
+import { getProjectVersions } from '../helpers/modrinth.js';
+import { MOJANG_VERSION_MANIFEST, FABRIC_META, FABRIC_MAVEN } from '../helpers/constants.js';
+
+const CONFIG_VERSION = version;
+
+// Update a single mod
+async function updateMod(instancePath, config, mod, options) {
+    console.log(chalk.gray(`\nChecking ${mod.name}...`));
+
+    try {
+        const versions = await getProjectVersions(mod.slug, config.minecraftVersion, config.modLoader);
+        
+        if (versions.length === 0) {
+            console.log(chalk.yellow(`  ⚠️  No compatible version found for ${config.minecraftVersion}`));
+            return false;
+        }
+
+        const latestVersion = versions[0];
+        
+        if (latestVersion.id === mod.versionId && !options.force) {
+            console.log(chalk.gray(`  ✓ Already up to date (${mod.versionNumber})`));
+            return false;
+        }
+
+        const file = latestVersion.files.find(f => f.primary) || latestVersion.files[0];
+        if (!file) {
+            console.log(chalk.red(`  ✗ No downloadable file found`));
+            return false;
+        }
+
+        // Remove old file
+        const modsPath = path.join(instancePath, 'mods');
+        const oldFilePath = path.join(modsPath, mod.fileName);
+        if (fs.existsSync(oldFilePath)) {
+            fs.unlinkSync(oldFilePath);
+        }
+
+        // Download new file
+        const destPath = path.join(modsPath, file.filename);
+        console.log(chalk.gray(`  Downloading ${file.filename}...`));
+        await downloadFile(file.url, destPath, null, false);
+
+        // Update mod entry
+        mod.versionId = latestVersion.id;
+        mod.versionNumber = latestVersion.version_number;
+        mod.fileName = file.filename;
+        mod.updatedAt = new Date().toISOString();
+
+        console.log(chalk.green(`  ✓ Updated to ${latestVersion.version_number}`));
+        return true;
+    } catch (error) {
+        console.log(chalk.red(`  ✗ Error: ${error.message}`));
+        return false;
+    }
+}
+
+// Upgrade all mods
+async function upgradeMods(instancePath, config, options) {
+    if (config.mods.length === 0) {
+        console.log(chalk.yellow('No mods installed.'));
+        return;
+    }
+
+    console.log(chalk.cyan(`\n📦 Checking ${config.mods.length} mods for updates...\n`));
+
+    let updated = 0;
+    for (const mod of config.mods) {
+        if (await updateMod(instancePath, config, mod, options)) {
+            updated++;
+        }
+    }
+
+    saveConfig(instancePath, config);
+
+    console.log();
+    if (updated > 0) {
+        console.log(chalk.green(`✅ Updated ${updated} mod(s)`));
+    } else {
+        console.log(chalk.gray('All mods are up to date.'));
+    }
+}
+
+// Upgrade a single mod by name
+async function upgradeSingleMod(instancePath, config, modName, options) {
+    const mod = config.mods.find(m => 
+        m.slug.toLowerCase() === modName.toLowerCase() ||
+        m.name.toLowerCase() === modName.toLowerCase()
+    );
+
+    if (!mod) {
+        console.log(chalk.red(`Error: Mod "${modName}" is not installed.`));
+        console.log(chalk.gray('Installed mods:'));
+        for (const m of config.mods) {
+            console.log(chalk.gray(`  - ${m.name} (${m.slug})`));
+        }
+        return;
+    }
+
+    console.log(chalk.cyan(`\n📦 Upgrading ${mod.name}...`));
+
+    if (await updateMod(instancePath, config, mod, { ...options, force: true })) {
+        saveConfig(instancePath, config);
+        console.log(chalk.green(`\n✅ Successfully upgraded ${mod.name}`));
+    } else {
+        console.log(chalk.yellow(`\n⚠️  Could not upgrade ${mod.name}`));
+    }
+}
+
+// Upgrade Minecraft version
+async function upgradeMinecraft(instancePath, config, options) {
+    console.log(chalk.cyan('\n🎮 Upgrade Minecraft Version\n'));
+    console.log(chalk.gray(`Current version: ${config.minecraftVersion}`));
+
+    console.log(chalk.gray('Fetching available versions...'));
+    const manifest = await fetchJson(MOJANG_VERSION_MANIFEST);
+    
+    const releaseVersions = manifest.versions
+        .filter(v => v.type === 'release')
+        .map(v => v.id);
+
+    const currentIndex = releaseVersions.indexOf(config.minecraftVersion);
+    const newerVersions = currentIndex > 0 ? releaseVersions.slice(0, currentIndex) : [];
+    
+    if (newerVersions.length === 0) {
+        console.log(chalk.green('\n✓ You are already on the latest Minecraft version!'));
+        return;
+    }
+
+    console.log(chalk.yellow(`\n${newerVersions.length} newer version(s) available`));
+
+    const newVersion = await paginatedSelect('Select new Minecraft version:', newerVersions);
+
+    const { confirm } = await inquirer.prompt([{
+        type: 'confirm',
+        name: 'confirm',
+        message: `Upgrade from ${config.minecraftVersion} to ${newVersion}?`,
+        default: false
+    }]);
+
+    if (!confirm) {
+        console.log(chalk.yellow('Upgrade cancelled.'));
+        return;
+    }
+
+    console.log(chalk.yellow('\n⚠️  Warning: Changing Minecraft version requires:'));
+    console.log(chalk.gray('   1. Re-downloading game files (libraries, assets)'));
+    console.log(chalk.gray('   2. Updating mod loader'));
+    console.log(chalk.gray('   3. Checking mod compatibility'));
+    console.log();
+    console.log(chalk.red('This feature is not yet fully implemented.'));
+    console.log(chalk.gray('For now, create a new instance with the desired version.'));
+}
+
+// Upgrade mod loader version
+async function upgradeLoader(instancePath, config, options) {
+    console.log(chalk.cyan('\n🔧 Upgrade Mod Loader\n'));
+    console.log(chalk.gray(`Current: ${config.modLoader} ${config.loaderVersion}`));
+
+    if (config.modLoader === 'fabric') {
+        console.log(chalk.gray('Fetching Fabric loader versions...'));
+        const loaderVersions = await fetchJson(`${FABRIC_META}/versions/loader`);
+        const stableVersions = loaderVersions.filter(v => v.stable).map(v => v.version);
+
+        const currentIndex = stableVersions.indexOf(config.loaderVersion);
+        const newerVersions = currentIndex > 0 ? stableVersions.slice(0, currentIndex) : 
+                              currentIndex === -1 ? stableVersions.slice(0, 5) : [];
+
+        if (newerVersions.length === 0) {
+            console.log(chalk.green('\n✓ You are already on the latest Fabric loader version!'));
+            return;
+        }
+
+        console.log(chalk.yellow(`\n${newerVersions.length} newer version(s) available`));
+
+        const newVersion = await paginatedSelect('Select Fabric loader version:', stableVersions);
+
+        if (newVersion === config.loaderVersion) {
+            console.log(chalk.gray('No change selected.'));
+            return;
+        }
+
+        const oldVersionId = config.versionId;
+        config.loaderVersion = newVersion;
+        config.versionId = `fabric-loader-${newVersion}-${config.minecraftVersion}`;
+
+        console.log(chalk.gray('\nFetching new Fabric profile...'));
+        const fabricProfile = await fetchJson(
+            `${FABRIC_META}/versions/loader/${config.minecraftVersion}/${newVersion}/profile/json`
+        );
+
+        const versionsPath = path.join(instancePath, 'versions');
+        const newVersionPath = path.join(versionsPath, config.versionId);
+        fs.mkdirSync(newVersionPath, { recursive: true });
+        fs.writeFileSync(
+            path.join(newVersionPath, `${config.versionId}.json`),
+            JSON.stringify(fabricProfile, null, 2)
+        );
+
+        console.log(chalk.gray('Checking for new libraries...'));
+        const librariesPath = path.join(instancePath, 'libraries');
+        
+        for (const lib of fabricProfile.libraries) {
+            const relativePath = mavenToPath(lib.name);
+            if (!relativePath) continue;
+            
+            const libPath = path.join(librariesPath, relativePath);
+
+            if (!fs.existsSync(libPath)) {
+                const url = (lib.url || FABRIC_MAVEN + '/') + relativePath;
+                console.log(chalk.gray(`  Downloading ${lib.name.split(':')[1]}...`));
+                fs.mkdirSync(path.dirname(libPath), { recursive: true });
+                try {
+                    await downloadFile(url, libPath, null, false);
+                } catch (err) {
+                    console.log(chalk.yellow(`  Warning: Failed to download`));
+                }
+            }
+        }
+
+        if (oldVersionId !== config.versionId) {
+            const oldVersionPath = path.join(versionsPath, oldVersionId);
+            if (fs.existsSync(oldVersionPath)) {
+                fs.rmSync(oldVersionPath, { recursive: true });
+            }
+        }
+
+        saveConfig(instancePath, config);
+        console.log(chalk.green(`\n✅ Upgraded Fabric loader to ${newVersion}`));
+
+    } else if (config.modLoader === 'forge') {
+        console.log(chalk.yellow('\n⚠️  Forge loader upgrade is not yet implemented.'));
+        console.log(chalk.gray('For now, create a new instance with the desired Forge version.'));
+    } else {
+        console.log(chalk.red(`Unknown mod loader: ${config.modLoader}`));
+    }
+}
+
+// Upgrade config version
+async function upgradeConfig(instancePath, config, options) {
+    const configVersionInt = v.enumerate(config.configVersion) ?? -1;
+    const currentVersionInt = v.enumerate(CONFIG_VERSION);
+
+    if (configVersionInt === currentVersionInt) {
+        console.log(chalk.green('✓ Config is already up to date.'));
+        return;
+    }
+
+    if (configVersionInt > currentVersionInt) {
+        console.log(chalk.yellow('Config version is newer than CLIcraft. Please update CLIcraft.'));
+        return;
+    }
+
+    console.log(chalk.cyan('\n🔄 Upgrading config format...\n'));
+
+    if (configVersionInt === -1) {
+        config.configVersion = CONFIG_VERSION;
+        console.log(chalk.gray('  + Added configVersion field'));
+    }
+
+    if (configVersionInt === -2) {
+        config.configVersion = CONFIG_VERSION;
+        console.log(chalk.gray('  + Set configVersion to current version'));
+    }
+
+    saveConfig(instancePath, config);
+    console.log(chalk.green(`\n✅ Config upgraded to v${CONFIG_VERSION}`));
+}
+
+// Main upgrade command
+export async function upgrade(modName, options) {
+    const instancePath = getInstancePath(options);
+    
+    const config = requireConfig(instancePath);
+    if (!config) return;
+
+    try {
+        if (modName) {
+            await upgradeSingleMod(instancePath, config, modName, options);
+            return;
+        }
+
+        console.log(chalk.cyan(`\n🔄 Upgrade ${config.name}\n`));
+
+        const { upgradeType } = await inquirer.prompt([{
+            type: 'rawlist',
+            name: 'upgradeType',
+            message: 'What would you like to upgrade?',
+            choices: [
+                { name: '📦 All mods', value: 'mods' },
+                { name: '🎮 Minecraft version', value: 'minecraft' },
+                { name: '🔧 Mod loader version', value: 'loader' },
+                { name: '⚙️  Config format', value: 'config' },
+                { name: '❌ Cancel', value: 'cancel' }
+            ]
+        }]);
+
+        switch (upgradeType) {
+            case 'mods':
+                await upgradeMods(instancePath, config, options);
+                break;
+            case 'minecraft':
+                await upgradeMinecraft(instancePath, config, options);
+                break;
+            case 'loader':
+                await upgradeLoader(instancePath, config, options);
+                break;
+            case 'config':
+                await upgradeConfig(instancePath, config, options);
+                break;
+            case 'cancel':
+                console.log(chalk.gray('Upgrade cancelled.'));
+                break;
+        }
+
+    } catch (error) {
+        if (error.name === 'ExitPromptError') {
+            console.log(chalk.yellow('\nUpgrade cancelled.'));
+            return;
+        }
+        console.error(chalk.red('Error during upgrade:'), error.message);
+        if (options.verbose) {
+            console.error(error);
+        }
+    }
+}
+
+export default { upgrade };

package/commands/version.js

@@ -0,0 +1,21 @@
+import chalk from 'chalk';
+import version from '../helpers/getv.js';
+
+const art = "\n" +
+    "   _____ _      _____                __ _   \n" +
+    "  / ____| |    |_   _|              / _| |  \n" +
+    " | |    | |      | |  ___ _ __ __ _| |_| |_ \n" +
+    " | |    | |      | | / __| '__/ _` |  _| __|\n" +
+    " | |____| |____ _| || (__| | | (_| | | | |_ \n" +
+    "  \\_____|______|_____\\___|_|  \\__,_|_|  \\__|\n" +
+    "                                            "
+;
+
+const output = (`
+    ${chalk.white(art)}\n
+    ${chalk.white('Version:')} ${chalk.gray(version)}
+`);
+
+export function showVersion() {
+    console.log(output);
+}

package/docs/README.md

@@ -0,0 +1,119 @@
+# CLIcraft Documentation
+
+This directory contains the complete documentation for CLIcraft - A Minecraft Mod Package Manager.
+
+## 📚 Documentation Structure
+
+### Getting Started
+- **[index.md](index.md)** - Homepage with project overview and quick start guide
+- **[installation.md](installation.md)** - Installation instructions for all platforms
+
+### Commands
+- **[commands.md](commands.md)** - Overview of all available commands
+
+#### Detailed Command Documentation
+- **[commands/create.md](commands/create.md)** - Create new Minecraft instances
+- **[commands/search.md](commands/search.md)** - Search for mods on Modrinth
+- **[commands/install.md](commands/install.md)** - Install mods to instances
+- **[commands/login.md](commands/login.md)** - Authentication commands (login, logout, status)
+- **[commands/launch.md](commands/launch.md)** - Launch Minecraft instances
+- **[commands/info.md](commands/info.md)** - View instance information
+- **[commands/upgrade.md](commands/upgrade.md)** - Update mods and versions
+
+### Configuration
+- **[configuration.md](configuration.md)** - Configuration guide including mcconfig.json, JVM arguments, and templates
+
+## 🎯 Documentation Features
+
+Each documentation page includes:
+- ✨ **Clear syntax and examples** - Easy to understand command usage
+- 🎮 **Real-world examples** - Practical usage scenarios
+- 💡 **Pro tips** - Best practices and optimization advice
+- ⚠️ **Troubleshooting** - Common issues and solutions
+- 🔗 **Navigation links** - Easy navigation between related topics
+- 📋 **Detailed explanations** - Comprehensive coverage of features
+- 🎨 **Emoji indicators** - Visual organization and readability
+
+## 📖 Reading the Documentation
+
+### For New Users
+1. Start with [index.md](index.md) for an overview
+2. Follow [installation.md](installation.md) to install CLIcraft
+3. Read [commands/create.md](commands/create.md) to create your first instance
+4. Explore other command documentation as needed
+
+### For Existing Users
+- Use [commands.md](commands.md) as a quick reference
+- Check specific command pages for detailed options
+- Review [configuration.md](configuration.md) for optimization tips
+
+### For Troubleshooting
+- Each command page has a "Common Issues" section
+- Check "Troubleshooting" sections for solutions
+- Review [configuration.md](configuration.md) for performance tuning
+
+## 🌐 Viewing the Documentation
+
+### On GitHub
+The documentation is written in Markdown and can be viewed directly on GitHub:
+https://github.com/theinfamousben/clicraft/tree/main/docs
+
+### Locally
+View the documentation files with any Markdown viewer or text editor:
+```bash
+cd docs
+cat index.md
+```
+
+### Future: GitHub Pages
+In the future, this documentation may be hosted on GitHub Pages for a better reading experience.
+
+## 📝 Documentation Style Guide
+
+The documentation follows these conventions:
+- **Commands** - Shown in code blocks with `clicraft command`
+- **Options** - Listed in tables with descriptions
+- **Examples** - Practical, real-world usage scenarios
+- **File paths** - Shown with proper directory structure
+- **Code snippets** - Syntax-highlighted JSON and bash examples
+
+## 🤝 Contributing to Documentation
+
+To improve the documentation:
+1. Fork the repository
+2. Edit the relevant `.md` files
+3. Submit a pull request
+4. Include a clear description of changes
+
+### Documentation Guidelines
+- Keep examples practical and tested
+- Use clear, concise language
+- Include troubleshooting for common issues
+- Add links to related documentation
+- Maintain consistent formatting
+
+## 📊 Documentation Statistics
+
+Total documentation: **~3,500 lines**
+- Homepage: ~70 lines
+- Installation: ~150 lines
+- Commands overview: ~190 lines
+- Command pages: ~2,500 lines (7 commands)
+- Configuration: ~500 lines
+
+## 🔗 External Resources
+
+- [GitHub Repository](https://github.com/theinfamousben/clicraft)
+- [Modrinth](https://modrinth.com) - Mod hosting platform
+- [Minecraft](https://www.minecraft.net) - Official Minecraft website
+
+## 🆘 Need Help?
+
+If you can't find what you're looking for in the documentation:
+1. Check the [GitHub Issues](https://github.com/theinfamousben/clicraft/issues)
+2. Open a new issue with your question
+3. Visit the [Discussions](https://github.com/theinfamousben/clicraft/discussions)
+
+## 📄 License
+
+This documentation is part of the CLIcraft project and is licensed under the ISC license.

package/docs/_config.yml

@@ -0,0 +1,63 @@
+title: CLIcraft Documentation
+description: A simple Minecraft Mod Package Manager written in Node.js
+remote_theme: just-the-docs/just-the-docs
+color_scheme: dark
+
+# GitHub repository
+repository: theinfamousben/clicraft
+url: https://theinfamousben.github.io/clicraft
+
+# Enable search
+search_enabled: true
+search:
+  heading_level: 2
+  previews: 3
+  preview_words_before: 5
+  preview_words_after: 10
+  tokenizer_separator: /[\s/]+/
+  rel_url: true
+  button: false
+
+# Callouts (for notes, warnings, etc.)
+callouts_level: quiet
+callouts:
+  note:
+    title: Note
+    color: blue
+  warning:
+    title: Warning
+    color: red
+  tip:
+    title: Pro Tip
+    color: green
+
+# Navigation structure
+nav_sort: case_insensitive
+
+# Aux links
+aux_links:
+  "GitHub Repository":
+    - "https://github.com/theinfamousben/clicraft"
+
+# Footer content
+footer_content: "Copyright © 2024 theinfamousben. Distributed under the ISC license."
+
+# Back to top link
+back_to_top: true
+back_to_top_text: "Back to top"
+
+# Markdown settings
+markdown: kramdown
+kramdown:
+  input: GFM
+  syntax_highlighter: rouge
+  syntax_highlighter_opts:
+    block:
+      line_numbers: false
+
+# Exclude from processing
+exclude:
+  - README.md
+  - node_modules
+  - package.json
+  - package-lock.json