epress-cli 1.0.0

package/README.md

@@ -0,0 +1,97 @@
+# epress - Fast File Sharing CLI
+
+A super fast CLI tool to upload and download compressed files across machines.
+
+## Quick Start
+
+### 1. Setup Backend (Next.js)
+
+```bash
+cd backend
+npm install
+npm run dev
+```
+
+The backend will run on `http://localhost:3000`
+
+### 2. Setup Vercel Blob Storage
+
+1. Go to [Vercel Dashboard](https://vercel.com) → Your Team → Settings → Storage
+2. Create a new Blob Store (or use existing)
+3. Copy the `BLOB_READ_WRITE_TOKEN`
+4. Add it as an environment variable in Vercel:
+   - Go to your project → Settings → Environment Variables
+   - Add: `BLOB_READ_WRITE_TOKEN` = your token
+
+### 3. Deploy Backend (Vercel - Recommended)
+
+```bash
+cd backend
+npm install
+vercel
+```
+
+After deployment, set the API URL:
+```bash
+export EPRESS_API_URL=https://your-app.vercel.app/api
+```
+
+### 4. Use CLI Tool
+
+#### Upload a file or folder:
+```bash
+npx epress post ./my-folder
+npx epress post ./file.txt
+npx epress post ./my-folder --name "my-project"
+```
+
+#### Download by ID:
+```bash
+npx epress pull <id>
+npx epress pull <id> --output ./downloads
+```
+
+## Development
+
+### Local Development
+
+1. Start backend:
+```bash
+cd backend
+npm run dev
+```
+
+2. Test CLI locally:
+```bash
+node cli.js post ./test-folder
+node cli.js pull <id>
+```
+
+### Publishing CLI to npm
+
+1. Update package.json with your npm username
+2. Login to npm: `npm login`
+3. Publish: `npm publish`
+
+## Environment Variables
+
+### CLI
+- `EPRESS_API_URL` - Backend API URL (default: http://localhost:3000/api)
+
+### Backend (Vercel)
+- `BLOB_READ_WRITE_TOKEN` - Vercel Blob storage token (required for production)
+
+## Features
+
+- ✅ Upload files/folders as compressed zip
+- ✅ Download and extract files by ID
+- ✅ Works cross-platform (Windows, Mac, Linux)
+- ✅ Fast deployment on Vercel
+- ✅ Persistent storage with Vercel Blob
+- ✅ No database needed
+
+## Notes
+
+- Files are stored in Vercel Blob storage (persistent and fast)
+- Add authentication if needed
+- Set up file expiration/cleanup for old uploads

package/cli.js

@@ -0,0 +1,146 @@
+#!/usr/bin/env node
+
+const { program } = require('commander');
+const fs = require('fs');
+const path = require('path');
+const FormData = require('form-data');
+const axios = require('axios');
+const archiver = require('archiver');
+const extract = require('extract-zip');
+const chalk = require('chalk');
+
+// Get API URL from environment or use default
+const API_URL = process.env.EPRESS_API_URL || 'https://espress-two.vercel.app/api';
+
+program
+  .name('epress')
+  .description('CLI tool to upload and download compressed files')
+  .version('1.0.0');
+
+program
+  .command('post <path>')
+  .description('Upload a file or folder as compressed zip')
+  .option('-n, --name <name>', 'Custom ID for the upload (e.g., hd1234)')
+  .action(async (filePath, options) => {
+    try {
+      console.log(chalk.blue('📦 Compressing...'));
+      
+      const fullPath = path.resolve(filePath);
+      if (!fs.existsSync(fullPath)) {
+        console.error(chalk.red('❌ File or folder not found:', filePath));
+        process.exit(1);
+      }
+
+      const stats = fs.statSync(fullPath);
+      const isDirectory = stats.isDirectory();
+      
+      // Create zip file
+      const zipPath = path.join(__dirname, 'temp-upload.zip');
+      const output = fs.createWriteStream(zipPath);
+      const archive = archiver('zip', { zlib: { level: 9 } });
+
+      return new Promise((resolve, reject) => {
+        output.on('close', async () => {
+          try {
+            console.log(chalk.blue('📤 Uploading...'));
+            
+            const form = new FormData();
+            form.append('file', fs.createReadStream(zipPath));
+            if (options.name) {
+              form.append('name', options.name);
+            }
+
+            const response = await axios.post(`${API_URL}/upload`, form, {
+              headers: form.getHeaders(),
+              maxContentLength: Infinity,
+              maxBodyLength: Infinity,
+            });
+
+            // Clean up temp file
+            fs.unlinkSync(zipPath);
+
+            console.log(chalk.green('✅ Upload successful!'));
+            console.log(chalk.cyan('📋 ID:'), response.data.id);
+            console.log(chalk.cyan('🔗 URL:'), `${API_URL.replace('/api', '')}/api/download/${response.data.id}`);
+            console.log(chalk.yellow('\n💡 Use this command to download:'));
+            console.log(chalk.white(`   npx epress pull ${response.data.id}`));
+            
+            resolve();
+          } catch (error) {
+            fs.unlinkSync(zipPath);
+            console.error(chalk.red('❌ Upload failed:'), error.response?.data?.error || error.message);
+            reject(error);
+          }
+        });
+
+        archive.on('error', (err) => {
+          console.error(chalk.red('❌ Compression failed:'), err);
+          reject(err);
+        });
+
+        archive.pipe(output);
+
+        if (isDirectory) {
+          archive.directory(fullPath, false);
+        } else {
+          archive.file(fullPath, { name: path.basename(fullPath) });
+        }
+
+        archive.finalize();
+      });
+    } catch (error) {
+      console.error(chalk.red('❌ Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('pull <id>')
+  .description('Download and extract a file by ID')
+  .option('-o, --output <dir>', 'Output directory (default: current directory)')
+  .action(async (id, options) => {
+    try {
+      const outputDir = options.output ? path.resolve(options.output) : process.cwd();
+      
+      if (!fs.existsSync(outputDir)) {
+        fs.mkdirSync(outputDir, { recursive: true });
+      }
+
+      console.log(chalk.blue('📥 Downloading...'));
+      
+      const response = await axios.get(`${API_URL}/download/${id}`, {
+        responseType: 'stream',
+      });
+
+      const zipPath = path.join(__dirname, `temp-${id}.zip`);
+      const writer = fs.createWriteStream(zipPath);
+
+      response.data.pipe(writer);
+
+      await new Promise((resolve, reject) => {
+        writer.on('finish', async () => {
+          try {
+            console.log(chalk.blue('📦 Extracting...'));
+            await extract(zipPath, { dir: outputDir });
+            fs.unlinkSync(zipPath);
+            console.log(chalk.green(`✅ Extracted to: ${outputDir}`));
+            resolve();
+          } catch (error) {
+            fs.unlinkSync(zipPath);
+            console.error(chalk.red('❌ Extraction failed:'), error.message);
+            reject(error);
+          }
+        });
+        writer.on('error', reject);
+      });
+    } catch (error) {
+      if (error.response?.status === 404) {
+        console.error(chalk.red('❌ File not found. Invalid ID.'));
+      } else {
+        console.error(chalk.red('❌ Download failed:'), error.response?.data?.error || error.message);
+      }
+      process.exit(1);
+    }
+  });
+
+program.parse();

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "epress-cli",
+  "version": "1.0.0",
+  "description": "CLI tool to upload and download compressed files across machines",
+  "main": "cli.js",
+  "bin": {
+    "epress": "./cli.js"
+  },
+  "files": [
+    "cli.js",
+    "README.md"
+  ],
+  "scripts": {
+    "dev": "cd backend && npm run dev",
+    "build": "cd backend && npm run build",
+    "start": "cd backend && npm start"
+  },
+  "keywords": [
+    "cli",
+    "file-sharing",
+    "upload",
+    "download",
+    "file-transfer",
+    "zip",
+    "compress"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yourusername/epress.git"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "dependencies": {
+    "commander": "^11.1.0",
+    "form-data": "^4.0.0",
+    "axios": "^1.6.2",
+    "archiver": "^6.0.1",
+    "extract-zip": "^2.0.1",
+    "chalk": "^4.1.2"
+  }
+}