instatunnel 1.0.1

package/README.md

@@ -0,0 +1,69 @@
+# InstaTunnel CLI
+
+> Expose your localhost to the internet instantly - the ngrok alternative that's 40% cheaper
+
+## 🚀 Quick Start
+
+```bash
+# Install globally
+npm install -g instatunnel
+
+# Share your app instantly
+instatunnel 3000
+# or use the short alias
+it 3000
+```
+
+## ✨ Features
+
+- **🆓 Anonymous usage** - No signup required
+- **⚡ Instant setup** - Works in under 30 seconds
+- **🕐 24-hour sessions** - vs ngrok's 2-hour limit
+- **🎨 Custom subdomains** - Free vs ngrok's paid feature
+- **📱 QR codes** - Perfect for mobile testing
+- **🔒 Password protection** - Secure your tunnels
+- **🎯 Framework detection** - Auto-detect React, Next.js, Laravel
+
+## 📖 Usage Examples
+
+```bash
+# Basic tunneling
+instatunnel 3000                    # Share localhost:3000
+it 8080                             # Short alias for port 8080
+
+# Framework shortcuts
+instatunnel --react                 # Auto-detect React (port 3000)
+instatunnel --next                  # Auto-detect Next.js (port 3000)
+instatunnel --laravel               # Auto-detect Laravel (port 8000)
+
+# Security features
+instatunnel 3000 --password secret  # Password protect tunnel
+instatunnel 3000 --auth user:pass   # Basic authentication
+
+# Mobile testing
+instatunnel 3000 --qr               # Show QR code for mobile
+
+# Management
+instatunnel --list                  # List active tunnels
+instatunnel --kill myapp            # Stop specific tunnel
+instatunnel --share                 # Generate sharing templates
+```
+
+## 🆚 vs ngrok
+
+| Feature | InstaTunnel | ngrok |
+|---------|-------------|-------|
+| **Anonymous usage** | ✅ No signup | ❌ Account required |
+| **Session duration** | ✅ 24 hours | ❌ 2 hours |
+| **Custom subdomains** | ✅ Free | ❌ Paid only |
+| **Multiple tunnels** | ✅ 3 free | ❌ 1 free |
+| **Setup time** | ✅ < 30 seconds | ❌ 2-3 minutes |
+| **Pricing** | ✅ 40% cheaper | ❌ Expensive |
+
+## 🌐 Website
+
+Visit [instatunnel.my](https://instatunnel.my) for more information.
+
+## 📝 License
+
+MIT

package/install.js

@@ -0,0 +1,271 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const https = require('https');
+const os = require('os');
+const { execSync } = require('child_process');
+
+const BINARY_NAME = 'instatunnel';
+const PRIMARY_URL = 'https://instatunnel.my/releases';
+const FALLBACK_URL = 'https://github.com/instatunnel/cli/releases/latest/download';
+
+// Colors for console output
+const colors = {
+    reset: '\x1b[0m',
+    red: '\x1b[31m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    cyan: '\x1b[36m'
+};
+
+function log(message, color = 'reset') {
+    console.log(`${colors[color]}${message}${colors.reset}`);
+}
+
+function detectPlatform() {
+    const platform = os.platform();
+    const arch = os.arch();
+    
+    let platformSuffix;
+    switch (platform) {
+        case 'linux':
+            platformSuffix = 'linux';
+            break;
+        case 'darwin':
+            platformSuffix = 'darwin';
+            break;
+        case 'win32':
+            platformSuffix = 'windows';
+            break;
+        case 'freebsd':
+            platformSuffix = 'freebsd';
+            break;
+        case 'openbsd':
+            platformSuffix = 'openbsd';
+            break;
+        default:
+            throw new Error(`Unsupported platform: ${platform}`);
+    }
+    
+    let archSuffix;
+    switch (arch) {
+        case 'x64':
+            archSuffix = 'amd64';
+            break;
+        case 'arm64':
+            archSuffix = 'arm64';
+            break;
+        case 'ia32':
+            archSuffix = '386';
+            break;
+        default:
+            throw new Error(`Unsupported architecture: ${arch}`);
+    }
+    
+    const extension = platform === 'win32' ? '.exe' : '';
+    return `${BINARY_NAME}-${platformSuffix}-${archSuffix}${extension}`;
+}
+
+function downloadFile(url, outputPath) {
+    return new Promise((resolve, reject) => {
+        const file = fs.createWriteStream(outputPath);
+        
+        https.get(url, (response) => {
+            // Handle redirects
+            if (response.statusCode >= 300 && response.statusCode < 400 && response.headers.location) {
+                file.close();
+                fs.unlinkSync(outputPath);
+                return downloadFile(response.headers.location, outputPath).then(resolve).catch(reject);
+            }
+            
+            if (response.statusCode !== 200) {
+                file.close();
+                fs.unlinkSync(outputPath);
+                reject(new Error(`HTTP ${response.statusCode}: ${response.statusMessage}`));
+                return;
+            }
+            
+            response.pipe(file);
+            
+            file.on('finish', () => {
+                file.close(resolve);
+            });
+            
+            file.on('error', (err) => {
+                file.close();
+                fs.unlinkSync(outputPath);
+                reject(err);
+            });
+        }).on('error', (err) => {
+            reject(err);
+        });
+    });
+}
+
+async function downloadBinary() {
+    const binaryName = detectPlatform();
+    const binDir = path.join(__dirname, 'bin');
+    const isWindows = os.platform() === 'win32';
+    const outputPath = path.join(binDir, isWindows ? 'instatunnel.exe' : 'instatunnel');
+    
+    // Create bin directory
+    if (!fs.existsSync(binDir)) {
+        fs.mkdirSync(binDir, { recursive: true });
+    }
+    
+    log('🚀 Installing InstaTunnel CLI...', 'blue');
+    log(`📋 Platform: ${os.platform()}-${os.arch()}`, 'cyan');
+    
+    // Try primary URL first
+    const primaryUrl = `${PRIMARY_URL}/${binaryName}`;
+    const fallbackUrl = `${FALLBACK_URL}/${binaryName}`;
+    
+    try {
+        log('📥 Downloading from primary source...', 'blue');
+        await downloadFile(primaryUrl, outputPath);
+    } catch (primaryError) {
+        log(`⚠️  Primary download failed: ${primaryError.message}`, 'yellow');
+        log('📥 Trying fallback source (GitHub)...', 'blue');
+        
+        try {
+            await downloadFile(fallbackUrl, outputPath);
+        } catch (fallbackError) {
+            throw new Error(`Both downloads failed:\n  Primary: ${primaryError.message}\n  Fallback: ${fallbackError.message}`);
+        }
+    }
+    
+    // Verify binary was downloaded and is valid
+    if (!fs.existsSync(outputPath) || fs.statSync(outputPath).size === 0) {
+        throw new Error('Downloaded binary is invalid or empty');
+    }
+    
+    // Make executable on Unix systems
+    if (!isWindows) {
+        fs.chmodSync(outputPath, 0o755);
+    }
+    
+    // Create 'it' alias
+    const itPath = path.join(binDir, isWindows ? 'it.exe' : 'it');
+    fs.copyFileSync(outputPath, itPath);
+    
+    log('✅ InstaTunnel CLI installed successfully!', 'green');
+    log('', 'reset');
+    log('🚀 Quick Start:', 'cyan');
+    log('   instatunnel 3000    # Expose port 3000 instantly (no setup needed!)', 'reset');
+    log('   it 3000             # Short alias for the same command', 'reset');
+    log('', 'reset');
+    log('💡 More examples:', 'cyan');
+    log('   instatunnel         # Auto-detect common ports (3000, 8000, 8080)', 'reset');
+    log('   instatunnel 8080 --name myapp', 'reset');
+    log('   instatunnel --help  # See all options', 'reset');
+    log('', 'reset');
+    log('🌟 Key Benefits:', 'yellow');
+    log('   ✓ No signup required - works instantly', 'green');
+    log('   ✓ 24+ hour sessions (vs ngrok\'s 2 hours)', 'green');
+    log('   ✓ Custom subdomains included free', 'green');
+    log('   ✓ 40% cheaper than ngrok', 'green');
+    log('', 'reset');
+    log('📚 Documentation: https://docs.instatunnel.my', 'yellow');
+    
+    // Test installation
+    try {
+        const testCommand = isWindows ? `"${outputPath}" --version` : `${outputPath} --version`;
+        const version = execSync(testCommand, { encoding: 'utf8', timeout: 5000 }).trim();
+        log(`🔧 Installation verified! Version: ${version}`, 'green');
+    } catch (testError) {
+        log('ℹ️  Installation complete - restart terminal if command not found', 'yellow');
+    }
+}
+
+// Create uninstall script
+function createUninstallScript() {
+    const uninstallPath = path.join(__dirname, 'uninstall.js');
+    const uninstallScript = `#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+
+function cleanup() {
+    const binDir = path.join(__dirname, 'bin');
+    
+    try {
+        if (fs.existsSync(binDir)) {
+            fs.rmSync(binDir, { recursive: true, force: true });
+        }
+        console.log('✅ InstaTunnel CLI uninstalled successfully!');
+    } catch (error) {
+        console.warn('⚠️  Some cleanup may be incomplete:', error.message);
+    }
+}
+
+if (require.main === module) {
+    cleanup();
+}
+
+module.exports = { cleanup };
+`;
+
+    fs.writeFileSync(uninstallPath, uninstallScript);
+}
+
+// Create test script
+function createTestScript() {
+    const testPath = path.join(__dirname, 'test.js');
+    const testScript = `#!/usr/bin/env node
+
+const { execSync } = require('child_process');
+const path = require('path');
+const os = require('os');
+
+function test() {
+    const binDir = path.join(__dirname, 'bin');
+    const isWindows = os.platform() === 'win32';
+    const instatunnelPath = path.join(binDir, isWindows ? 'instatunnel.exe' : 'instatunnel');
+    const itPath = path.join(binDir, isWindows ? 'it.exe' : 'it');
+    
+    try {
+        // Test main command
+        const helpOutput = execSync(\`"\${instatunnelPath}" --help\`, { encoding: 'utf8', timeout: 5000 });
+        console.log('✅ instatunnel command works');
+        
+        // Test alias
+        const itHelpOutput = execSync(\`"\${itPath}" --help\`, { encoding: 'utf8', timeout: 5000 });
+        console.log('✅ it alias works');
+        
+        console.log('✅ All tests passed!');
+        return true;
+    } catch (error) {
+        console.error('❌ Test failed:', error.message);
+        return false;
+    }
+}
+
+if (require.main === module) {
+    const success = test();
+    process.exit(success ? 0 : 1);
+}
+
+module.exports = { test };
+`;
+
+    fs.writeFileSync(testPath, testScript);
+}
+
+if (require.main === module) {
+    downloadBinary()
+        .then(() => {
+            createUninstallScript();
+            createTestScript();
+        })
+        .catch((err) => {
+            log(`❌ Installation failed: ${err.message}`, 'red');
+            log('', 'reset');
+            log('🔧 Troubleshooting:', 'yellow');
+            log('   • Check your internet connection', 'reset');
+            log('   • Try running: npm install -g instatunnel --verbose', 'reset');
+            log('   • Report issues: https://github.com/instatunnel/cli/issues', 'reset');
+            process.exit(1);
+        });
+}

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "instatunnel",
+  "version": "1.0.1",
+  "description": "Expose your localhost to the internet instantly - the ngrok alternative that's 40% cheaper with superior UX",
+  "main": "install.js",
+  "bin": {
+    "instatunnel": "./bin/instatunnel",
+    "it": "./bin/it"
+  },
+  "scripts": {
+    "postinstall": "node install.js",
+    "test": "node test.js",
+    "preuninstall": "node uninstall.js"
+  },
+  "keywords": [
+    "ngrok",
+    "tunnel", 
+    "localhost",
+    "development",
+    "webhook",
+    "cli",
+    "instant",
+    "port-forwarding",
+    "demo",
+    "testing",
+    "react",
+    "nextjs",
+    "laravel",
+    "api",
+    "free",
+    "anonymous",
+    "zero-config"
+  ],
+  "author": {
+    "name": "InstaTunnel Team",
+    "email": "hello@instatunnel.my",
+    "url": "https://instatunnel.my"
+  },
+  "license": "MIT",
+  "homepage": "https://instatunnel.my",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/instatunnel/cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/instatunnel/cli/issues"
+  },
+  "funding": {
+    "type": "opencollective",
+    "url": "https://opencollective.com/instatunnel"
+  },
+  "engines": {
+    "node": ">=14.0.0",
+    "npm": ">=6.0.0"
+  },
+  "os": [
+    "linux",
+    "darwin", 
+    "win32",
+    "freebsd",
+    "openbsd"
+  ],
+  "cpu": [
+    "x64",
+    "arm64",
+    "ia32"
+  ],
+  "preferGlobal": true,
+  "files": [
+    "install.js",
+    "uninstall.js",
+    "test.js",
+    "bin/",
+    "README.md"
+  ],
+  "directories": {
+    "bin": "./bin"
+  }
+}