@bobschlowinskii/clicraft 0.4.0

package/docs/contributing.md

@@ -0,0 +1,114 @@
+---
+layout: default
+title: Contributing
+nav_order: 10
+description: "How to contribute to CLIcraft"
+permalink: /contributing
+---
+
+# Contributing to CLIcraft
+
+Thank you for your interest in contributing to CLIcraft! We welcome contributions from the community and appreciate your help in making this tool better.
+
+## 🚀 Quick Links
+
+- **Full Contributing Guide**: [CONTRIBUTING.md](https://github.com/theinfamousben/clicraft/blob/main/CONTRIBUTING.md)
+- **Issue Tracker**: [GitHub Issues](https://github.com/theinfamousben/clicraft/issues)
+- **Pull Requests**: [GitHub PRs](https://github.com/theinfamousben/clicraft/pulls)
+- **Repository**: [theinfamousben/clicraft](https://github.com/theinfamousben/clicraft)
+
+## 📋 Ways to Contribute
+
+There are many ways you can contribute to CLIcraft:
+
+### 🐛 Report Bugs
+
+Found a bug? Please [open an issue](https://github.com/theinfamousben/clicraft/issues/new) with:
+- A clear description of the problem
+- Steps to reproduce the issue
+- Your environment (OS, Node.js version, etc.)
+- Expected vs actual behavior
+
+### ✨ Suggest Features
+
+Have an idea for a new feature? We'd love to hear it! [Open an issue](https://github.com/theinfamousben/clicraft/issues/new) and describe:
+- What problem the feature would solve
+- How you envision it working
+- Any examples or mockups (if applicable)
+
+### 📝 Improve Documentation
+
+Documentation improvements are always welcome:
+- Fix typos or clarify existing docs
+- Add examples or use cases
+- Write tutorials or guides
+- Improve code comments
+
+### 💻 Submit Code
+
+Ready to write some code? Here's how to get started:
+
+1. **Fork the repository** and clone it locally
+2. **Set up your development environment** (see below)
+3. **Create a branch** for your changes
+4. **Make your changes** following our coding guidelines
+5. **Test your changes** thoroughly
+6. **Submit a pull request** with a clear description
+
+## 🛠️ Development Setup
+
+### Prerequisites
+
+- Node.js 18 or higher
+- Java 21 or higher (for testing Minecraft functionality)
+- Git
+
+### Quick Setup
+
+```bash
+# Clone your fork
+git clone https://github.com/YOUR-USERNAME/clicraft.git
+cd clicraft
+
+# Install dependencies
+npm install
+
+# Link globally for testing
+npm link
+
+# Verify installation
+clicraft --version
+```
+
+## 📖 Detailed Guide
+
+For a comprehensive guide on contributing, including:
+- Code style guidelines
+- Pull request process
+- Testing procedures
+- Best practices
+
+Please read our full [Contributing Guide](https://github.com/theinfamousben/clicraft/blob/main/CONTRIBUTING.md).
+
+## 🤝 Code of Conduct
+
+We are committed to providing a welcoming and inclusive environment. Please:
+- Be respectful and constructive
+- Welcome and help newcomers
+- Provide helpful feedback
+- Be patient and understanding
+
+## 💬 Getting Help
+
+Need help getting started?
+- Check the [Installation Guide](installation.md)
+- Review the [Commands Documentation](commands.md)
+- Ask questions in [GitHub Issues](https://github.com/theinfamousben/clicraft/issues)
+
+## 📜 License
+
+By contributing to CLIcraft, you agree that your contributions will be licensed under the ISC License.
+
+---
+
+**Ready to contribute?** Check out our [full Contributing Guide](https://github.com/theinfamousben/clicraft/blob/main/CONTRIBUTING.md) to get started!

package/docs/index.md

@@ -0,0 +1,82 @@
+---
+layout: default
+title: Home
+nav_order: 1
+description: "CLIcraft - A simple Minecraft Mod Package Manager"
+permalink: /
+---
+
+# CLIcraft Documentation
+
+Welcome to **CLIcraft** - A simple, powerful Minecraft Mod Package Manager written in Node.js.
+
+## 🎮 What is CLIcraft?
+
+CLIcraft is a command-line tool that simplifies managing Minecraft instances and mods. Create instances with Fabric or Forge, search and install mods from Modrinth, and launch the game directly from your terminal.
+
+## ✨ Key Features
+
+- **🎮 Create Instances** - Set up new Minecraft client or server instances with Fabric or Forge
+- **🔍 Search Mods** - Find mods on Modrinth with filters for version, loader, and more
+- **📦 Install Mods** - Download and install mods directly to your instance
+- **🔄 Upgrade** - Update mods, mod loader, or Minecraft version
+- **ℹ️ Instance Info** - View detailed information about your instances
+- **🔐 Microsoft Login** - Authenticate with your Microsoft account to play online
+- **🚀 Launch Game** - Start Minecraft directly from the terminal
+
+## 🚀 Quick Start
+
+```bash
+# Create a new instance
+clicraft create
+
+# Search for mods
+clicraft search sodium
+
+# Install a mod
+cd my-instance
+clicraft install sodium
+
+# Launch the game
+clicraft launch
+```
+
+## 📖 Documentation
+
+### Getting Started
+- [Installation](installation.md) - Install CLIcraft on your system
+- [Commands Overview](commands.md) - List of all available commands
+
+### Commands
+- [`create`](commands/create.md) - Create a new Minecraft instance
+- [`search`](commands/search.md) - Search for mods on Modrinth
+- [`install`](commands/install.md) - Install mods to your instance
+- [`login`](commands/login.md) - Authenticate with Microsoft account
+- [`launch`](commands/launch.md) - Launch your Minecraft instance
+- [`info`](commands/info.md) - View instance information
+- [`upgrade`](commands/upgrade.md) - Upgrade mods and loaders
+
+### Configuration
+- [Configuration Guide](configuration.md) - Instance and authentication configuration
+
+### Contributing
+- [Contributing Guide](contributing.md) - How to contribute to CLIcraft
+
+## 🎯 Requirements
+
+- **Node.js** 18 or higher
+- **Java** 21 or higher (for running Minecraft)
+
+## 🌐 Supported Platforms
+
+- ✅ Linux
+- ✅ macOS
+- ✅ Windows
+
+## 🤝 Contributing
+
+Contributions are welcome! Please read our [Contributing Guide](https://github.com/theinfamousben/clicraft/blob/main/CONTRIBUTING.md) to learn about our development process, how to propose bugfixes and improvements, and how to build and test your changes. You can also visit our [GitHub repository](https://github.com/theinfamousben/clicraft) to open issues or submit pull requests.
+
+## 📄 License
+
+ISC - See the [LICENSE](https://github.com/theinfamousben/clicraft/blob/main/LICENSE) file for details.

package/docs/installation.md

@@ -0,0 +1,162 @@
+---
+layout: default
+title: Installation
+nav_order: 2
+description: "Install CLIcraft on your system"
+permalink: /installation
+---
+
+# Installation
+
+This guide will help you install CLIcraft on your system.
+
+## 📋 Prerequisites
+
+Before installing CLIcraft, ensure you have the following installed:
+
+- **Node.js** 18 or higher - [Download Node.js](https://nodejs.org/)
+- **Java** 21 or higher - Required for running Minecraft - [Download Java](https://adoptium.net/)
+
+You can verify your installations by running:
+
+```bash
+node --version
+java --version
+```
+
+## 📦 Installation Methods
+
+### Method 1: NPM Package (Coming Soon!)
+
+**Coming Soon!** The npm package will be available soon. Once released, you'll be able to install globally with:
+
+```bash
+npm install -g clicraft
+```
+
+### Method 2: Clone from Source
+
+This is currently the recommended way to install CLIcraft:
+
+```bash
+# Clone the repository
+git clone https://github.com/theinfamousben/clicraft.git
+cd clicraft
+
+# Install dependencies
+npm install
+
+# Link globally (allows you to use 'clicraft' command anywhere)
+npm link
+```
+
+After linking, you can use the `clicraft` command from any directory:
+
+```bash
+clicraft --version
+```
+
+## 🔧 Verifying Installation
+
+To verify that CLIcraft is installed correctly, run:
+
+```bash
+clicraft --version
+```
+
+This should display the current version of CLIcraft.
+
+## 📁 Configuration Files
+
+CLIcraft stores configuration files in the following locations:
+
+- **Authentication tokens**: `~/.mcpkg/auth.json`
+- **Instance configuration**: `mcconfig.json` (in each instance directory)
+
+These files are created automatically when you use CLIcraft for the first time.
+
+## ⬆️ Updating CLIcraft
+
+### If installed from source:
+
+```bash
+cd clicraft
+git pull origin main
+npm install
+```
+
+### If installed via npm (when available):
+
+```bash
+npm update -g clicraft
+```
+
+## 🗑️ Uninstalling
+
+### If installed from source:
+
+```bash
+npm unlink clicraft
+```
+
+Then delete the cloned repository folder.
+
+### If installed via npm (when available):
+
+```bash
+npm uninstall -g clicraft
+```
+
+To also remove configuration files:
+
+```bash
+rm -rf ~/.mcpkg
+```
+
+## 🐛 Troubleshooting
+
+### "command not found: clicraft"
+
+If you see this error after installation:
+
+1. Make sure you ran `npm link` in the clicraft directory
+2. Check that your npm global bin directory is in your PATH
+3. Try running `npm config get prefix` to see where global packages are installed
+
+### Permission errors on Linux/macOS
+
+If you encounter permission errors during `npm link`, you may need to use:
+
+```bash
+sudo npm link
+```
+
+### Node.js version issues
+
+Make sure you're using Node.js 18 or higher. You can use [nvm](https://github.com/nvm-sh/nvm) to manage multiple Node.js versions:
+
+```bash
+nvm install 18
+nvm use 18
+```
+
+## 🆘 Getting Help
+
+If you encounter any issues during installation:
+
+1. Check the [GitHub Issues](https://github.com/theinfamousben/clicraft/issues) page
+2. Open a new issue with details about your problem
+3. Include your operating system, Node.js version, and any error messages
+
+## ⏭️ Next Steps
+
+Once CLIcraft is installed, you're ready to:
+
+1. [Create your first instance](commands/create.md)
+2. [Search for mods](commands/search.md)
+3. [Install mods](commands/install.md)
+4. [Launch the game](commands/launch.md)
+
+---
+
+[← Back to Home](index.md) | [View All Commands →](commands.md)

package/helpers/auth/index.js

@@ -0,0 +1,20 @@
+// Re-export everything from auth modules
+export {
+    loadAccounts,
+    saveAccounts,
+    getCurrentAccount,
+    getAccount,
+    addAccount,
+    removeAccount,
+    switchAccount,
+    getAllAccounts,
+    getAccountCount,
+    accountExists,
+    updateAccount,
+    migrateFromLegacy
+} from './storage.js';
+
+export {
+    performAuthentication,
+    refreshAccountAuth
+} from './microsoft.js';

package/helpers/auth/microsoft.js

@@ -0,0 +1,329 @@
+import readline from 'readline';
+
+// Using the legacy live.com OAuth with the special desktop redirect URI
+// This is the official approach for native/desktop applications
+const CLIENT_ID = '00000000402b5328'; // Official Minecraft launcher client ID
+const REDIRECT_URI = 'https://login.live.com/oauth20_desktop.srf';
+
+/**
+ * Prompt user for input
+ */
+export function prompt(question) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout
+    });
+
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+
+/**
+ * Extract authorization code from redirect URL
+ */
+export function extractCodeFromUrl(url) {
+    try {
+        if (url.startsWith('http')) {
+            const parsed = new URL(url);
+            return parsed.searchParams.get('code');
+        }
+        return url;
+    } catch {
+        return url;
+    }
+}
+
+/**
+ * Open URL in browser
+ */
+export async function openBrowser(url) {
+    const { exec } = await import('child_process');
+    const { promisify } = await import('util');
+    const execAsync = promisify(exec);
+
+    const platform = process.platform;
+    let command;
+
+    if (platform === 'darwin') {
+        command = `open "${url}"`;
+    } else if (platform === 'win32') {
+        command = `start "" "${url}"`;
+    } else {
+        command = `xdg-open "${url}" || sensible-browser "${url}" || x-www-browser "${url}" || gnome-open "${url}"`;
+    }
+
+    try {
+        await execAsync(command);
+        return true;
+    } catch {
+        return false;
+    }
+}
+
+/**
+ * Get OAuth URL for Microsoft login
+ */
+export function getOAuthUrl() {
+    return `https://login.live.com/oauth20_authorize.srf?` +
+        `client_id=${CLIENT_ID}` +
+        `&response_type=code` +
+        `&redirect_uri=${encodeURIComponent(REDIRECT_URI)}` +
+        `&scope=${encodeURIComponent('service::user.auth.xboxlive.com::MBI_SSL')}`;
+}
+
+/**
+ * Exchange code for Microsoft token
+ */
+export async function getMicrosoftToken(code) {
+    const response = await fetch('https://login.live.com/oauth20_token.srf', {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/x-www-form-urlencoded'
+        },
+        body: new URLSearchParams({
+            client_id: CLIENT_ID,
+            code: code,
+            grant_type: 'authorization_code',
+            redirect_uri: REDIRECT_URI,
+            scope: 'service::user.auth.xboxlive.com::MBI_SSL'
+        })
+    });
+
+    if (!response.ok) {
+        const text = await response.text();
+        throw new Error(`Failed to get Microsoft token: ${text}`);
+    }
+
+    return await response.json();
+}
+
+/**
+ * Refresh Microsoft token
+ */
+export async function refreshMicrosoftToken(refreshToken) {
+    const response = await fetch('https://login.live.com/oauth20_token.srf', {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/x-www-form-urlencoded'
+        },
+        body: new URLSearchParams({
+            client_id: CLIENT_ID,
+            refresh_token: refreshToken,
+            grant_type: 'refresh_token',
+            scope: 'service::user.auth.xboxlive.com::MBI_SSL'
+        })
+    });
+
+    if (!response.ok) {
+        return null;
+    }
+
+    return await response.json();
+}
+
+/**
+ * Get Xbox Live token
+ */
+export async function getXboxLiveToken(msAccessToken) {
+    const response = await fetch('https://user.auth.xboxlive.com/user/authenticate', {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'Accept': 'application/json'
+        },
+        body: JSON.stringify({
+            Properties: {
+                AuthMethod: 'RPS',
+                SiteName: 'user.auth.xboxlive.com',
+                RpsTicket: msAccessToken
+            },
+            RelyingParty: 'http://auth.xboxlive.com',
+            TokenType: 'JWT'
+        })
+    });
+
+    if (!response.ok) {
+        const text = await response.text();
+        throw new Error(`Failed to get Xbox Live token: ${text}`);
+    }
+
+    return await response.json();
+}
+
+/**
+ * Get XSTS token
+ */
+export async function getXSTSToken(xblToken) {
+    const response = await fetch('https://xsts.auth.xboxlive.com/xsts/authorize', {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'Accept': 'application/json'
+        },
+        body: JSON.stringify({
+            Properties: {
+                SandboxId: 'RETAIL',
+                UserTokens: [xblToken]
+            },
+            RelyingParty: 'rp://api.minecraftservices.com/',
+            TokenType: 'JWT'
+        })
+    });
+
+    if (!response.ok) {
+        const error = await response.json().catch(() => ({}));
+        if (error.XErr === 2148916233) {
+            throw new Error('This Microsoft account does not have an Xbox account. Please create one at xbox.com');
+        } else if (error.XErr === 2148916238) {
+            throw new Error('This account belongs to someone under 18 and needs to be added to a family');
+        }
+        throw new Error(`Failed to get XSTS token: ${JSON.stringify(error)}`);
+    }
+
+    return await response.json();
+}
+
+/**
+ * Get Minecraft token
+ */
+export async function getMinecraftToken(xstsToken, userHash) {
+    const response = await fetch('https://api.minecraftservices.com/authentication/login_with_xbox', {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json'
+        },
+        body: JSON.stringify({
+            identityToken: `XBL3.0 x=${userHash};${xstsToken}`
+        })
+    });
+
+    if (!response.ok) {
+        const text = await response.text();
+        throw new Error(`Failed to get Minecraft token: ${text}`);
+    }
+
+    return await response.json();
+}
+
+/**
+ * Get Minecraft profile
+ */
+export async function getMinecraftProfile(mcAccessToken) {
+    const response = await fetch('https://api.minecraftservices.com/minecraft/profile', {
+        headers: {
+            'Authorization': `Bearer ${mcAccessToken}`
+        }
+    });
+
+    if (!response.ok) {
+        if (response.status === 404) {
+            throw new Error('You do not own Minecraft Java Edition. Please purchase it at minecraft.net');
+        }
+        throw new Error('Failed to get Minecraft profile');
+    }
+
+    return await response.json();
+}
+
+/**
+ * Full authentication flow - returns account data
+ */
+export async function performAuthentication(onStatus) {
+    const log = onStatus || (() => {});
+    
+    const authUrl = getOAuthUrl();
+    
+    log('open_url', authUrl);
+    
+    const opened = await openBrowser(authUrl);
+    log('browser_opened', opened);
+    
+    const redirectUrl = await prompt('\nPaste the redirect URL here: ');
+    
+    if (!redirectUrl) {
+        throw new Error('No URL provided');
+    }
+
+    const code = extractCodeFromUrl(redirectUrl);
+    if (!code) {
+        throw new Error('Could not extract authorization code from URL');
+    }
+
+    log('status', 'Getting Microsoft token...');
+    const msToken = await getMicrosoftToken(code);
+
+    log('status', 'Getting Xbox Live token...');
+    const xblResponse = await getXboxLiveToken(msToken.access_token);
+    const xblToken = xblResponse.Token;
+    const userHash = xblResponse.DisplayClaims.xui[0].uhs;
+
+    log('status', 'Getting XSTS token...');
+    const xstsResponse = await getXSTSToken(xblToken);
+    const xstsToken = xstsResponse.Token;
+
+    log('status', 'Getting Minecraft token...');
+    const mcToken = await getMinecraftToken(xstsToken, userHash);
+
+    log('status', 'Getting Minecraft profile...');
+    const profile = await getMinecraftProfile(mcToken.access_token);
+
+    return {
+        accessToken: mcToken.access_token,
+        refreshToken: msToken.refresh_token,
+        expiresAt: Date.now() + (mcToken.expires_in * 1000),
+        uuid: profile.id,
+        username: profile.name,
+        authenticatedAt: new Date().toISOString()
+    };
+}
+
+/**
+ * Refresh authentication for an account
+ */
+export async function refreshAccountAuth(accountData) {
+    if (!accountData.refreshToken) {
+        return null;
+    }
+
+    const msToken = await refreshMicrosoftToken(accountData.refreshToken);
+    if (!msToken) {
+        return null;
+    }
+
+    const xblResponse = await getXboxLiveToken(msToken.access_token);
+    const xstsResponse = await getXSTSToken(xblResponse.Token);
+    const mcToken = await getMinecraftToken(
+        xstsResponse.Token,
+        xblResponse.DisplayClaims.xui[0].uhs
+    );
+    const profile = await getMinecraftProfile(mcToken.access_token);
+
+    return {
+        accessToken: mcToken.access_token,
+        refreshToken: msToken.refresh_token,
+        expiresAt: Date.now() + (mcToken.expires_in * 1000),
+        uuid: profile.id,
+        username: profile.name,
+        authenticatedAt: accountData.authenticatedAt,
+        refreshedAt: new Date().toISOString()
+    };
+}
+
+export default {
+    prompt,
+    extractCodeFromUrl,
+    openBrowser,
+    getOAuthUrl,
+    getMicrosoftToken,
+    refreshMicrosoftToken,
+    getXboxLiveToken,
+    getXSTSToken,
+    getMinecraftToken,
+    getMinecraftProfile,
+    performAuthentication,
+    refreshAccountAuth
+};