cloudsync-cli 2026.7.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 CloudSync Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,560 @@
+# 🔒 CloudSync-CLI
+
+<div align="center">
+
+![CloudSync Banner](https://img.shields.io/badge/CloudSync-CLI-blue?style=for-the-badge)
+[![npm version](https://img.shields.io/npm/v/cloudsync-cli.svg?style=for-the-badge)](https://www.npmjs.com/package/cloudsync-cli)
+[![GitHub package version](https://img.shields.io/github/package-json/v/Tech4File/cloudsync-cli?style=for-the-badge)](https://github.com/Tech4File/cloudsync-cli/packages)
+[![License](https://img.shields.io/badge/license-MIT-green?style=for-the-badge)](LICENSE)
+[![Node.js Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen?style=for-the-badge)](https://nodejs.org/)
+[![GitHub Actions](https://img.shields.io/github/actions/workflow/status/Tech4File/cloudsync-cli/release.yml?style=for-the-badge)](https://github.com/Tech4File/cloudsync-cli/actions)
+[![GitHub Downloads](https://img.shields.io/github/downloads/Tech4File/cloudsync-cli/total?style=for-the-badge)](https://github.com/Tech4File/cloudsync-cli/releases)
+
+**An open-source, Git-like version control CLI for secure cloud-to-local synchronization via encrypted SSH tunnels**
+
+*"Your configs, your cloud, your rules - no public repos required."*
+
+</div>
+
+---
+
+## 🚀 Why CloudSync-CLI?
+
+### The Problem with Traditional Git
+
+| Limitation | Git | CloudSync-CLI |
+|------------|-----|---------------|
+| **Sensitive Data** | Requires `.gitignore` hacks & external tools | Built-in encrypted channels for `.env`, keys, configs |
+| **Large Binaries** | Poor handling, bloats repos | Optimized chunking & delta compression |
+| **Binary Diffs** | Not supported | Full delta compression with zstd/lz4 |
+| **Transfer Protocols** | HTTPS only | SSH, SFTP, RSYNC, WebSocket, Direct Pipe |
+
+| **Real-time Sync** | Manual push/pull cycles | Optional watch mode with instant sync |
+| **P2P Sharing** | Requires fork/clone | Session links with optional password protection |
+| **Conflict Resolution** | Manual 3-way merge | Visual diff + automated strategies |
+| **Cloud-Native** | Indirect integration | Direct SSH, any cloud platform |
+| **Memory Safety** | Disk-based temp files | Memory-only streams for sensitive data |
+| **Speed** | Compressed HTTPS | Raw SSH piping for maximum throughput |
+
+### Our Solution
+
+CloudSync-CLI brings **Git-like version control** to sensitive configuration files and environment data, with **enterprise-grade security** and **multiple transport options** that Git simply wasn't designed for.
+
+---
+
+## ✨ Features
+
+### 🔐 Security First
+- **Pure SSH2 Protocols** - No middleman tracking, all traffic between your authorized keypairs
+- **Memory-Only Streams** - Temporary files bypass disk writes, protecting sensitive keys
+- **SHA-256 Integrity** - Every transfer verified with cryptographic checksums
+- **Password Protection** - Optional password for shareable session links
+
+### 🚄 Multiple Transport Methods
+| Protocol | Speed | Compression | Resume | Best For |
+|----------|-------|-------------|--------|----------|
+| `SSH-SCP` | ⚡⚡⚡ | External | ❌ | Simple transfers |
+| `SSH-SFTP` | ⚡⚡⚡ | Configurable | ✅ | Full features |
+| `RSYNC-DELTA` | ⚡⚡⚡⚡ | Built-in | ✅ | Large syncs |
+| `WEBSOCKET` | ⚡⚡⚡⚡ | Stream | ✅ | Real-time sync |
+| `DIRECT-PIPE` | ⚡⚡⚡⚡⚡ | None | ❌ | Maximum speed |
+| `HYBRID-ZIP` | ⚡⚡⚡ | High | ❌ | Archives |
+
+### 📦 Git-Like Version Control
+- **Staging Area** - Stage specific files before committing
+- **Commit History** - Full version history with messages
+- **Diff Comparison** - Compare any two versions
+- **Rollback** - Revert to any previous version instantly
+- **Branching Model** - Profile-based configuration management
+
+### 🔗 P2P Sharing
+- Generate shareable session links
+- Password-protected sessions
+- Real-time connection monitoring
+- Clipboard-ready URLs
+- Configurable expiration
+
+### 🖥️ SSH Tunneling
+- Local and remote port forwarding
+- Background tunnel mode
+- Multi-port configuration
+- Verbose tunnel status
+
+---
+
+## 📥 Installation
+
+### Via npm (Global)
+
+```bash
+npm install -g cloudsync-cli
+```
+
+### Via Windows Installer
+
+Download `CloudSync-Setup.exe` from our [releases page](https://github.com/Tech4File/cloudsync-cli/releases) and run the installer.
+
+### Verify Installation
+
+```bash
+cloudsync --version
+# cloudsync/1.0.0 linux-x64 node-v18.17.0
+```
+
+---
+
+## 📖 Quick Start
+
+### 1. Initialize Configuration
+
+```bash
+# Interactive setup
+cloudsync init
+
+# Or with all options
+cloudsync init \
+  --host your-server.com \
+  --user myusername \
+  --port 22 \
+  --protocol ssh \
+  --verbose
+```
+
+### 2. Stage Files
+
+```bash
+# Stage specific files
+cloudsync stage .env config.json
+
+# Stage all files
+cloudsync stage --all
+
+# Stage by pattern
+cloudsync stage --include "*.config.js,*.json"
+```
+
+### 3. Commit Changes
+
+```bash
+cloudsync commit "Add production environment config"
+```
+
+### 4. Upload to Cloud
+
+```bash
+# Full upload with compression
+cloudsync upload --compress zip --verbose
+
+# Upload with custom protocol
+cloudsync upload --protocol rsync --exclude node_modules,.git
+
+# Dry run preview
+cloudsync upload --dry-run
+```
+
+### 5. Download from Cloud
+
+```bash
+# Download latest
+cloudsync download --latest
+
+# Download specific version
+cloudsync download --version v1234-abcd
+
+# Download specific files
+cloudsync download .env --verbose
+```
+
+### 6. Bidirectional Sync
+
+```bash
+# One-time sync
+cloudsync sync
+
+# Watch mode (continuous)
+cloudsync sync --watch --interval 30
+
+# With conflict strategy
+cloudsync sync --strategy local --verbose
+```
+
+---
+
+## 🛠️ Command Reference
+
+### Core Commands
+
+| Command | Description |
+|---------|-------------|
+| `cloudsync init` | Initialize configuration profile |
+| `cloudsync upload [files]` | Upload files to remote |
+| `cloudsync download [files]` | Download files from remote |
+| `cloudsync sync` | Bidirectional synchronization |
+| `cloudsync port <local:remote>` | Create SSH tunnel |
+| `cloudsync share [path]` | Generate shareable session link |
+
+### Version Control Commands
+
+| Command | Description |
+|---------|-------------|
+| `cloudsync stage [files]` | Stage files for commit |
+| `cloudsync unstage [files]` | Remove from staging |
+| `cloudsync commit [msg]` | Commit staged changes |
+| `cloudsync history` | View commit history |
+| `cloudsync diff [versions]` | Compare versions |
+| `cloudsync rollback <version>` | Revert to version |
+| `cloudsync status` | Show repository status |
+| `cloudsync log` | View operation logs |
+
+### Utility Commands
+
+| Command | Description |
+|---------|-------------|
+| `cloudsync config [key] [value]` | Manage configuration |
+| `cloudsync doctor` | Run diagnostics |
+| `cloudsync clone <remote>` | Clone remote workspace |
+| `cloudsync help [topic]` | Show help |
+
+### Global Flags
+
+| Flag | Description |
+|------|-------------|
+| `-v, --verbose` | Enable verbose output |
+| `-q, --quiet` | Suppress messages |
+| `-c, --config <path>` | Custom config file |
+| `--no-color` | Disable colors |
+
+---
+
+## 📋 Command Options Reference
+
+### `upload` Options
+
+```bash
+cloudsync upload [files...]
+  --include <patterns>     # Files to include (comma-separated)
+  --exclude <patterns>      # Files to exclude (default: node_modules,.git,dist,build)
+  --message <msg>           # Commit message
+  --all                     # Upload all changes
+  --force                   # Force overwrite
+  --compress <method>       # zip|lz4|zstd (default: zip)
+  --chunk-size <MB>        # Chunk size (default: 10)
+  --protocol <proto>       # ssh|sftp|rsync|websocket|pipe
+  --verbose                # Detailed progress
+  --dry-run                # Preview only
+  --profile <name>         # Config profile
+```
+
+### `download` Options
+
+```bash
+cloudsync download [files...]
+  --include <patterns>     # Specific files to fetch
+  --exclude <patterns>     # Skip certain files
+  --version <id>          # Specific version
+  --latest                # Fetch latest
+  --verbose               # Detailed progress
+  --dry-run               # Preview only
+  --profile <name>        # Config profile
+  --output <path>         # Output directory
+```
+
+### `sync` Options
+
+```bash
+cloudsync sync
+  --strategy <type>       # local|remote|manual
+  --watch                 # Continuous watching
+  --interval <seconds>    # Sync interval (default: 30)
+  --verbose               # Detailed logs
+  --dry-run               # Preview
+  --profile <name>        # Config profile
+  --include <patterns>    # Files to sync
+  --exclude <patterns>    # Files to skip
+```
+
+### `share` Options
+
+```bash
+cloudsync share [path]
+  --type <type>           # file|folder|session
+  --port <number>         # Server port (default: 3000)
+  --expires <minutes>     # Expiration (default: 60)
+  --password <pwd>         # Password protection
+  --verbose               # Show details
+  --open                  # Auto-open URL
+  --profile <name>        # Config profile
+```
+
+### `port` Options
+
+```bash
+cloudsync port <local:remote>
+  --host <hostname>       # Bind host (default: 0.0.0.0)
+  --verbose               # Show tunnel details
+  --background            # Run in background
+  --profile <name>        # Config profile
+```
+
+---
+
+## 🔧 Configuration
+
+### Profile Structure
+
+```json
+{
+  "profiles": {
+    "default": {
+      "host": "your-server.com",
+      "user": "myusername",
+      "port": 22,
+      "key": "~/.ssh/id_rsa",
+      "protocol": "ssh",
+      "workspace": "/home/myuser/project",
+      "createdAt": "2024-01-15T10:30:00Z"
+    },
+    "production": {
+      "host": "prod.example.com",
+      "user": "deploy",
+      "protocol": "rsync"
+    }
+  },
+  "settings": {
+    "compression": "zip",
+    "chunkSize": 10,
+    "verbose": false,
+    "defaultProfile": "default"
+  }
+}
+```
+
+### Config Commands
+
+```bash
+# List all config
+cloudsync config --list
+
+# Get specific value
+cloudsync config profiles.default.host
+
+# Set value
+cloudsync config settings.compression zstd
+
+# Use global config
+cloudsync config --global settings.verbose true
+
+# Unset value
+cloudsync config --unset profiles.production
+```
+
+---
+
+## 🔒 Security Architecture
+
+### Transport Security
+
+```
+┌─────────────────────────────────────────────────────────┐
+│                    CloudSync Security                    │
+├─────────────────────────────────────────────────────────┤
+│                                                          │
+│  Your Local Machine                                      │
+│  ┌─────────────────┐                                    │
+│  │  Private Key 🔐  │──── Encrypted Tunnel ──────►      │
+│  │  (never leaves)  │        SSH2                         │
+│  └─────────────────┘              │                     │
+│                                    ▼                     │
+│  Memory-Only Streams ◄──────────────┤                     │
+│  (no disk writes)                   │                     │
+│                                     ▼                     │
+│  Remote Server (SSH or cloud)         │                     │
+│  ┌─────────────────┐       Authenticated & Encrypted    │
+│  │  Public Key 🔓  │◄──────────────────────────         │
+│  └─────────────────┘                                    │
+│                                                          │
+└─────────────────────────────────────────────────────────┘
+```
+
+### Key Security Features
+
+1. **Zero-Trust Architecture** - Keys never leave your machine
+2. **Memory-Only Processing** - Sensitive data never touches disk
+3. **End-to-End Encryption** - SSH2 with strong cipher suites
+4. **Integrity Verification** - SHA-256 checksums on all transfers
+5. **Session Tokens** - Unique, expirable shareable links
+6. **No Third-Party Tracking** - 100% peer-to-peer
+
+---
+
+## 🏗️ Architecture Overview
+
+```
+cloudsync-cli/
+├── bin/
+│   └── cloudsync.js          # Entry point
+├── src/
+│   ├── cli/
+│   │   ├── index.js          # Commander.js setup
+│   │   └── commands/         # Command definitions
+│   │       ├── init.js
+│   │       ├── upload.js
+│   │       ├── download.js
+│   │       ├── sync.js
+│   │       ├── port.js
+│   │       ├── share.js
+│   │       ├── stage.js
+│   │       ├── commit.js
+│   │       ├── history.js
+│   │       ├── diff.js
+│   │       ├── rollback.js
+│   │       ├── status.js
+│   │       ├── config.js
+│   │       ├── doctor.js
+│   │       ├── clone.js
+│   │       └── log.js
+│   ├── transport/            # Protocol implementations
+│   ├── vcs/                  # Version control system
+│   └── utils/                # Helper functions
+├── package.json
+└── README.md
+```
+
+---
+
+## 📊 Comparison with Git Workflows
+
+### Traditional Git Workflow (With Sensitive Files)
+
+```bash
+# Problem: Sensitive files need special handling
+git add .env                    # ❌ Danger! May commit secrets
+echo ".env" >> .gitignore      # ✓ But now it's untracked
+git add .env.example            # ✓ Manual workaround
+
+# Or use git-crypt (complex setup)
+git crypt init                  # Complex
+git crypt lock                  # Lock when done
+
+# Environment-specific repos (messy)
+git remote add prod git@github.com:myorg/prod-configs.git
+```
+
+### CloudSync Workflow (Same Project)
+
+```bash
+# Simple and secure
+cloudsync init --host your-server.com --user myuser
+cloudsync stage .env config.json
+cloudsync commit "Update environment config"
+cloudsync upload                # Encrypted, versioned, done
+
+# Files stay private, never in Git
+```
+
+---
+
+## 🌐 Use Cases
+
+### 1. Cloud Environment Sync
+
+```bash
+# Sync local .env to your cloud server
+cloudsync upload --include .env,config.json --exclude node_modules
+
+# Pull latest from your cloud server
+cloudsync download --latest
+
+# Create persistent tunnel for local dev
+cloudsync port 3000:3000 --background
+```
+
+### 2. Multi-Environment Configs
+
+```bash
+# Development profile
+cloudsync init --profile dev --host dev.server.com
+
+# Production profile
+cloudsync init --profile prod --host prod.server.com
+
+# Switch and sync
+cloudsync upload --profile prod
+```
+
+### 3. Team Sharing (Without Git Access)
+
+```bash
+# Generate secure share link
+cloudsync share --type folder . --expires 120 --password MyPass123
+
+# Share the link with team
+🔗 http://localhost:3000/share/abc123
+```
+
+### 4. CI/CD Integration
+
+```bash
+# In CI pipeline
+cloudsync download --version $COMMIT_SHA --dry-run
+cloudsync download --version $COMMIT_SHA
+```
+
+---
+
+## 🔍 Troubleshooting
+
+### Doctor Command
+
+Run diagnostics to identify issues:
+
+```bash
+cloudsync doctor --verbose
+```
+
+### Common Issues
+
+| Issue | Solution |
+|-------|----------|
+| SSH connection fails | Run `cloudsync doctor` to test credentials |
+| Permission denied | Check SSH key permissions: `chmod 600 ~/.ssh/id_rsa` |
+| No files to upload | Ensure `--include` patterns match your files |
+| Config not found | Run `cloudsync init` first |
+
+---
+
+## 🤝 Contributing
+
+Contributions are welcome! Please read our contributing guidelines before submitting PRs.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing`)
+5. Open a Pull Request
+
+---
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+---
+
+## 🙏 Acknowledgments
+
+- [Commander.js](https://www.npmjs.com/package/commander) - CLI framework
+- [ssh2](https://www.npmjs.com/package/ssh2) - SSH client
+- [Archiver](https://www.npmjs.com/package/archiver) - ZIP compression
+- [diff-match-patch](https://www.npmjs.com/package/diff-match-patch) - Text diffing
+
+---
+
+<div align="center">
+
+**Made with ❤️ for developers who value security and simplicity**
+
+[![Star on GitHub](https://img.shields.io/github/stars/Tech4File/cloudsync-cli?style=social)](https://github.com/Tech4File/cloudsync-cli)
+[![Tweet](https://img.shields.io/twitter/url?style=social&url=https%3A%2F%2Fgithub.com%2FTech4File%2Fcloudsync-cli)](https://twitter.com/intent/tweet?text=Check%20out%20CloudSync-CLI%20-%20A%20secure%2C%20Git-like%20tool%20for%20syncing%20configs%20to%20cloud%20environments&url=https%3A%2F%2Fgithub.com%2FTech4File%2Fcloudsync-cli)
+
+</div>

package/bin/cloudsync.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+
+/**
+ * CloudSync-CLI Entry Point
+ *
+ * Dynamically loads the CLI module using a resolved absolute file path
+ * from import.meta.url so that pkg can locate the bundled files at build time
+ * (pkg traces static imports; dynamic paths are resolved via import.meta.url).
+ */
+
+import { mkdirSync, existsSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+// ── Ensure .cloudsync directories exist ──────────────────
+const csyncDir = join(process.cwd(), '.cloudsync');
+[
+  csyncDir,
+  join(csyncDir, 'staging'),
+  join(csyncDir, 'history', 'commits'),
+  join(csyncDir, 'history', 'diffs'),
+  join(csyncDir, 'cache'),
+  join(csyncDir, 'logs'),
+].forEach((dir) => {
+  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+});
+
+// ── Global error handlers ────────────────────────────────
+process.on('uncaughtException', (err) => {
+  console.error('\n❌', err.message);
+  if (process.argv.includes('--verbose')) console.error(err.stack);
+  process.exit(1);
+});
+
+process.on('unhandledRejection', (reason) => {
+  console.error('\n❌ Unhandled rejection:', reason);
+  process.exit(1);
+});
+
+// ── Resolve CLI entry via import.meta.url (works with pkg) ──
+const cliUrl = new URL('../src/cli/index.js', import.meta.url).href;
+
+import(cliUrl).catch((err) => {
+  console.error('Failed to load CLI:', err.message);
+  process.exit(1);
+});