mycloudctl 1.0.1__tar.gz → 1.0.2__tar.gz

mycloudctl-1.0.2/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.4
+Name: mycloudctl
+Version: 1.0.2
+Summary: Official CLI for myCloud — your personal cloud storage
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: typer[all]>=0.12
+Requires-Dist: rich>=13.7
+Requires-Dist: httpx>=0.27
+
+# myCloud CLI
+
+myCloud is a full-stack personal cloud platform that supports file storage, folder management, sharing, file previews, stash/recovery workflows, monitoring dashboards, and optional storage-node workflows. 
+
+The `mycloud` CLI allows you to interact with your personal cloud directly from your terminal, offering a seamless and efficient way to manage your files and account without needing to open a web browser.
+
+## Installation
+
+You can install the myCloud CLI via pip:
+
+```bash
+pip install mycloudctl
+```
+
+After installation, the `mycloud` command will be available in your terminal. Alternatively, you can use the standalone executable (`mycloud-cli.exe`).
+
+## Command Reference
+
+The CLI commands are grouped by their functionality to help you easily find what you need.
+
+### 🔐 Authentication
+Manage your myCloud session and account.
+- `mycloud login`: Sign in to your myCloud account.
+- `mycloud logout`: Sign out and clear your current session.
+- `mycloud whoami`: Display the currently logged-in user and session details.
+- `mycloud register`: Register a new myCloud account directly from the terminal.
+
+### 📄 File Operations
+Core file management capabilities.
+- `mycloud ls [folder_id]`: List files and folders in the root directory, or a specified folder.
+- `mycloud upload <file>`: Upload a local file to myCloud. (Use `--stash` to upload it directly to your stash).
+- `mycloud download <id>`: Download a specific file by its ID.
+- `mycloud download-all [folder_id]`: Download all files in a folder.
+- `mycloud rm <id>`: Delete a file.
+- `mycloud rm-all [folder_id]`: Delete all files in a folder.
+- `mycloud rename <id> <new_name>`: Rename an existing file.
+- `mycloud mv <id> <folder_id>`: Move a file into a different folder.
+- `mycloud info <id>`: Show detailed metadata for a file (size, creation date, type, etc.).
+- `mycloud cat <id>`: Print the contents of a text file directly to the terminal.
+- `mycloud favorite <id>` (or `mycloud fav <id>`): Toggle the favorite status of a file.
+
+### 📁 Folder Operations
+Organize your files using folders.
+- `mycloud mkdir <name>`: Create a new folder.
+- `mycloud rmdir <id>`: Delete a folder.
+- `mycloud folders ls`: List all your folders.
+- `mycloud folders rename <id> <new_name>`: Rename a folder.
+
+### 🔍 Search
+- `mycloud find <query>`: Search your entire cloud for files and folders matching the name.
+
+### 🗑️ Stash (Recycle Bin)
+Manage temporarily deleted files.
+- `mycloud stash ls`: List all items currently in your stash.
+- `mycloud stash restore <id>`: Restore a stashed item back to its original location.
+- `mycloud stash empty`: Empty the stash permanently, deleting files forever.
+
+### 🔗 Sharing
+Share files with other users or create public links.
+- `mycloud share create <file_id>`: Create a shareable link for a file.
+- `mycloud share ls`: List all your currently active shared items.
+- `mycloud share rm <share_id>`: Revoke and remove a share link.
+- `mycloud share direct <file_id> <username>`: Directly share a file with another registered myCloud user.
+
+### 📦 Batch Operations
+Group multiple files and folders into a single shareable link.
+- `mycloud batch create`: Create a new batch share link.
+- `mycloud batch add <batch_id> <file_id>`: Add a file or folder to an existing batch share.
+
+### 🖥️ Servers / Nodes
+Manage your private storage nodes.
+- `mycloud servers ls`: List all your registered private storage nodes and their statuses.
+
+### 📊 Storage & Stats
+Monitor your storage usage.
+- `mycloud stats` (or `mycloud storage stats`): Show current storage usage, total capacity, and limits.
+- `mycloud storage breakdown`: View a detailed breakdown of your storage consumption by file type.
+
+### 🔔 Notifications
+Stay updated with account activities.
+- `mycloud notify ls`: List your recent account notifications.
+- `mycloud notify read <id>`: Mark a specific notification as read.
+- `mycloud notify read-all`: Mark all pending notifications as read.
+
+### 👤 Profile & Preferences
+Customize your account settings.
+- `mycloud profile view`: View your profile information.
+- `mycloud profile update-avatar <image_path>`: Set or update your profile picture.
+- `mycloud prefs ls`: Show your current user preferences.
+- `mycloud prefs set <key> <value>`: Update a specific preference.
+
+---
+*Built for power users who want their personal cloud accessible right from the command line.*

mycloudctl-1.0.2/README_CLI.md

@@ -0,0 +1,93 @@
+# myCloud CLI
+
+myCloud is a full-stack personal cloud platform that supports file storage, folder management, sharing, file previews, stash/recovery workflows, monitoring dashboards, and optional storage-node workflows. 
+
+The `mycloud` CLI allows you to interact with your personal cloud directly from your terminal, offering a seamless and efficient way to manage your files and account without needing to open a web browser.
+
+## Installation
+
+You can install the myCloud CLI via pip:
+
+```bash
+pip install mycloudctl
+```
+
+After installation, the `mycloud` command will be available in your terminal. Alternatively, you can use the standalone executable (`mycloud-cli.exe`).
+
+## Command Reference
+
+The CLI commands are grouped by their functionality to help you easily find what you need.
+
+### 🔐 Authentication
+Manage your myCloud session and account.
+- `mycloud login`: Sign in to your myCloud account.
+- `mycloud logout`: Sign out and clear your current session.
+- `mycloud whoami`: Display the currently logged-in user and session details.
+- `mycloud register`: Register a new myCloud account directly from the terminal.
+
+### 📄 File Operations
+Core file management capabilities.
+- `mycloud ls [folder_id]`: List files and folders in the root directory, or a specified folder.
+- `mycloud upload <file>`: Upload a local file to myCloud. (Use `--stash` to upload it directly to your stash).
+- `mycloud download <id>`: Download a specific file by its ID.
+- `mycloud download-all [folder_id]`: Download all files in a folder.
+- `mycloud rm <id>`: Delete a file.
+- `mycloud rm-all [folder_id]`: Delete all files in a folder.
+- `mycloud rename <id> <new_name>`: Rename an existing file.
+- `mycloud mv <id> <folder_id>`: Move a file into a different folder.
+- `mycloud info <id>`: Show detailed metadata for a file (size, creation date, type, etc.).
+- `mycloud cat <id>`: Print the contents of a text file directly to the terminal.
+- `mycloud favorite <id>` (or `mycloud fav <id>`): Toggle the favorite status of a file.
+
+### 📁 Folder Operations
+Organize your files using folders.
+- `mycloud mkdir <name>`: Create a new folder.
+- `mycloud rmdir <id>`: Delete a folder.
+- `mycloud folders ls`: List all your folders.
+- `mycloud folders rename <id> <new_name>`: Rename a folder.
+
+### 🔍 Search
+- `mycloud find <query>`: Search your entire cloud for files and folders matching the name.
+
+### 🗑️ Stash (Recycle Bin)
+Manage temporarily deleted files.
+- `mycloud stash ls`: List all items currently in your stash.
+- `mycloud stash restore <id>`: Restore a stashed item back to its original location.
+- `mycloud stash empty`: Empty the stash permanently, deleting files forever.
+
+### 🔗 Sharing
+Share files with other users or create public links.
+- `mycloud share create <file_id>`: Create a shareable link for a file.
+- `mycloud share ls`: List all your currently active shared items.
+- `mycloud share rm <share_id>`: Revoke and remove a share link.
+- `mycloud share direct <file_id> <username>`: Directly share a file with another registered myCloud user.
+
+### 📦 Batch Operations
+Group multiple files and folders into a single shareable link.
+- `mycloud batch create`: Create a new batch share link.
+- `mycloud batch add <batch_id> <file_id>`: Add a file or folder to an existing batch share.
+
+### 🖥️ Servers / Nodes
+Manage your private storage nodes.
+- `mycloud servers ls`: List all your registered private storage nodes and their statuses.
+
+### 📊 Storage & Stats
+Monitor your storage usage.
+- `mycloud stats` (or `mycloud storage stats`): Show current storage usage, total capacity, and limits.
+- `mycloud storage breakdown`: View a detailed breakdown of your storage consumption by file type.
+
+### 🔔 Notifications
+Stay updated with account activities.
+- `mycloud notify ls`: List your recent account notifications.
+- `mycloud notify read <id>`: Mark a specific notification as read.
+- `mycloud notify read-all`: Mark all pending notifications as read.
+
+### 👤 Profile & Preferences
+Customize your account settings.
+- `mycloud profile view`: View your profile information.
+- `mycloud profile update-avatar <image_path>`: Set or update your profile picture.
+- `mycloud prefs ls`: Show your current user preferences.
+- `mycloud prefs set <key> <value>`: Update a specific preference.
+
+---
+*Built for power users who want their personal cloud accessible right from the command line.*

mycloudctl-1.0.2/cli/__init__.py

@@ -0,0 +1,2 @@
+# cli/__init__.py
+__version__ = "1.0.2"

mycloudctl-1.0.2/mycloudctl.egg-info/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.4
+Name: mycloudctl
+Version: 1.0.2
+Summary: Official CLI for myCloud — your personal cloud storage
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: typer[all]>=0.12
+Requires-Dist: rich>=13.7
+Requires-Dist: httpx>=0.27
+
+# myCloud CLI
+
+myCloud is a full-stack personal cloud platform that supports file storage, folder management, sharing, file previews, stash/recovery workflows, monitoring dashboards, and optional storage-node workflows. 
+
+The `mycloud` CLI allows you to interact with your personal cloud directly from your terminal, offering a seamless and efficient way to manage your files and account without needing to open a web browser.
+
+## Installation
+
+You can install the myCloud CLI via pip:
+
+```bash
+pip install mycloudctl
+```
+
+After installation, the `mycloud` command will be available in your terminal. Alternatively, you can use the standalone executable (`mycloud-cli.exe`).
+
+## Command Reference
+
+The CLI commands are grouped by their functionality to help you easily find what you need.
+
+### 🔐 Authentication
+Manage your myCloud session and account.
+- `mycloud login`: Sign in to your myCloud account.
+- `mycloud logout`: Sign out and clear your current session.
+- `mycloud whoami`: Display the currently logged-in user and session details.
+- `mycloud register`: Register a new myCloud account directly from the terminal.
+
+### 📄 File Operations
+Core file management capabilities.
+- `mycloud ls [folder_id]`: List files and folders in the root directory, or a specified folder.
+- `mycloud upload <file>`: Upload a local file to myCloud. (Use `--stash` to upload it directly to your stash).
+- `mycloud download <id>`: Download a specific file by its ID.
+- `mycloud download-all [folder_id]`: Download all files in a folder.
+- `mycloud rm <id>`: Delete a file.
+- `mycloud rm-all [folder_id]`: Delete all files in a folder.
+- `mycloud rename <id> <new_name>`: Rename an existing file.
+- `mycloud mv <id> <folder_id>`: Move a file into a different folder.
+- `mycloud info <id>`: Show detailed metadata for a file (size, creation date, type, etc.).
+- `mycloud cat <id>`: Print the contents of a text file directly to the terminal.
+- `mycloud favorite <id>` (or `mycloud fav <id>`): Toggle the favorite status of a file.
+
+### 📁 Folder Operations
+Organize your files using folders.
+- `mycloud mkdir <name>`: Create a new folder.
+- `mycloud rmdir <id>`: Delete a folder.
+- `mycloud folders ls`: List all your folders.
+- `mycloud folders rename <id> <new_name>`: Rename a folder.
+
+### 🔍 Search
+- `mycloud find <query>`: Search your entire cloud for files and folders matching the name.
+
+### 🗑️ Stash (Recycle Bin)
+Manage temporarily deleted files.
+- `mycloud stash ls`: List all items currently in your stash.
+- `mycloud stash restore <id>`: Restore a stashed item back to its original location.
+- `mycloud stash empty`: Empty the stash permanently, deleting files forever.
+
+### 🔗 Sharing
+Share files with other users or create public links.
+- `mycloud share create <file_id>`: Create a shareable link for a file.
+- `mycloud share ls`: List all your currently active shared items.
+- `mycloud share rm <share_id>`: Revoke and remove a share link.
+- `mycloud share direct <file_id> <username>`: Directly share a file with another registered myCloud user.
+
+### 📦 Batch Operations
+Group multiple files and folders into a single shareable link.
+- `mycloud batch create`: Create a new batch share link.
+- `mycloud batch add <batch_id> <file_id>`: Add a file or folder to an existing batch share.
+
+### 🖥️ Servers / Nodes
+Manage your private storage nodes.
+- `mycloud servers ls`: List all your registered private storage nodes and their statuses.
+
+### 📊 Storage & Stats
+Monitor your storage usage.
+- `mycloud stats` (or `mycloud storage stats`): Show current storage usage, total capacity, and limits.
+- `mycloud storage breakdown`: View a detailed breakdown of your storage consumption by file type.
+
+### 🔔 Notifications
+Stay updated with account activities.
+- `mycloud notify ls`: List your recent account notifications.
+- `mycloud notify read <id>`: Mark a specific notification as read.
+- `mycloud notify read-all`: Mark all pending notifications as read.
+
+### 👤 Profile & Preferences
+Customize your account settings.
+- `mycloud profile view`: View your profile information.
+- `mycloud profile update-avatar <image_path>`: Set or update your profile picture.
+- `mycloud prefs ls`: Show your current user preferences.
+- `mycloud prefs set <key> <value>`: Update a specific preference.
+
+---
+*Built for power users who want their personal cloud accessible right from the command line.*

{mycloudctl-1.0.1 → mycloudctl-1.0.2}/mycloudctl.egg-info/SOURCES.txt

@@ -1,4 +1,5 @@
 README.md
+README_CLI.md
 pyproject.toml
 cli/__init__.py
 cli/__main__.py

{mycloudctl-1.0.1 → mycloudctl-1.0.2}/pyproject.toml

@@ -4,10 +4,10 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "mycloudctl"
-version = "1.0.1"
+version = "1.0.2"
 description = "Official CLI for myCloud — your personal cloud storage"
 requires-python = ">=3.10"
-readme = "README.md"
+readme = "README_CLI.md"
 
 dependencies = [
     "typer[all]>=0.12",

mycloudctl-1.0.1/PKG-INFO

@@ -1,377 +0,0 @@
-Metadata-Version: 2.4
-Name: mycloudctl
-Version: 1.0.1
-Summary: Official CLI for myCloud — your personal cloud storage
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-Requires-Dist: typer[all]>=0.12
-Requires-Dist: rich>=13.7
-Requires-Dist: httpx>=0.27
-
-# myCloud
-
-A full-stack personal cloud platform built with Flask + MySQL that supports file storage, folder management, sharing (direct invite + token links + batch sharing), previews, stash/recovery workflows, monitoring dashboards, and optional storage-node workflows.
-
-## Table of Contents
-
-- Overview
-- Core Features
-- Project Structure
-- Architecture
-- Infrastructure and Runtime Topology
-- Data and Schema Evolution
-- Environment Configuration
-- Local Development Setup
-- Production Deployment (Linux VPS)
-- Operations and Monitoring
-- Security Notes
-- Troubleshooting
-- Release/Push Checklist
-
-## Overview
-
-myCloud is a web application for managing personal cloud files with:
-
-- User auth (username/password and social auth)
-- Upload/download and folder operations
-- Advanced sharing:
-  - direct user invites
-  - token-based share links
-  - batch share links for mixed files/folders
-- Shared library actions (preview, copy to MyCloud, leave share, favorites)
-- Stash workflow for temporary removal/recovery
-- Node-aware storage metadata and optional node-side GUI tooling
-- Monitoring endpoints for system, services, app activity, and product analytics
-
-## Core Features
-
-### Account and Auth
-
-- Registration, login, logout, password reset, email verification
-- Two-factor code flow endpoints
-- OAuth providers:
-  - Google
-  - GitHub
-
-### File and Folder Management
-
-- Upload files, create folders
-- Rename, move, delete, stash, unstash
-- Bulk operations: move/delete/download/share/stash/unstash/remove-share/add-to-mycloud
-- Preview support for images/video/audio/PDF/code/docx (web UI behavior)
-
-### Sharing
-
-- Direct item sharing with permission updates
-- Share links for file/folder
-- Batch share link generation and acceptance
-- Unified share removal APIs
-- Invite response APIs (accept/decline + optional mute sender)
-- Muted user management for invite control
-
-### UX and Settings
-
-- Preferences APIs and sync endpoints
-- Theme/view mode handling in frontend assets
-- Profile picture upload/remove
-- Notifications API + mark-read/hide
-
-### Monitoring and Analytics
-
-- System metrics API (CPU/RAM/disk/network/load)
-- Service status/log APIs (nginx/gunicorn/ssh where available)
-- Application activity monitor (recent events/endpoints)
-- Product analytics overview/trends
-
-## Project Structure
-
-```text
-.
-|- app.py                        # Main Flask + Socket.IO server
-|- services.py                   # Linux service/log monitoring helpers
-|- monitor.py                    # System monitor abstraction + local implementation
-|- app_monitor.py                # App-level activity monitoring
-|- data_monitor.py               # Data/storage monitoring
-|- product_analytics.py          # Product usage analytics
-|- db_update_nodes.py            # DB schema updates for storage node support
-|- migrate_shares_table.py       # Migration to unified shares table
-|- setup_batch_sharing_db.py     # Batch share schema bootstrap
-|- mycloud_node_gui.py           # Optional node desktop GUI client
-|- deploy_changed_files.ps1      # Incremental deployment helper (scp/ssh)
-|- templates/                    # Flask templates
-|- static/                       # Frontend JS/CSS/assets
-|- uploads/                      # Runtime user uploads (ignored from git)
-|- requirements.txt              # Python dependencies
-|- .env.example                  # Environment variable template
-```
-
-## Architecture
-
-### Application Layer
-
-- Framework: Flask
-- Real-time channel: Flask-SocketIO
-- Reverse-proxy awareness: Werkzeug ProxyFix
-- Session + auth logic + routing in a single main server file (`app.py`)
-
-### Real-time / Socket Layer
-
-Socket handlers are registered in `app.py` for:
-
-- node registration
-- node disconnect
-- chunked download transfer
-
-### Persistence Layer
-
-- Primary DB: MySQL (`mysql-connector-python`)
-- Schema support scripts:
-  - `migrate_shares_table.py` creates/migrates a unified `shares` model
-  - `setup_batch_sharing_db.py` provisions `batch_share_links` and `batch_share_items`
-  - `db_update_nodes.py` provisions `storage_nodes` and extends `files` with node metadata
-
-### Frontend Layer
-
-- Server-rendered Jinja templates in `templates/`
-- Static JS/CSS in `static/`
-- Rich shared-files interactions include:
-  - list/grid sort/filter/view
-  - direct invite modal and muted-users modal
-  - multi-select action toolbar
-
-## Infrastructure and Runtime Topology
-
-Typical production topology:
-
-- Browser clients -> Nginx reverse proxy -> Gunicorn/Eventlet Flask-SocketIO app
-- App server -> MySQL database
-- Optional storage nodes -> connect/register via Socket.IO events
-
-`services.py` is designed for Linux hosts with optional `systemctl` / `journalctl` access and can inspect:
-
-- nginx
-- gunicorn (unit configurable via `MONITOR_GUNICORN_SERVICE`)
-- ssh/sshd
-
-## Data and Schema Evolution
-
-### Node/Storage schema updates
-
-Run once when enabling node-aware storage metadata:
-
-```bash
-python db_update_nodes.py
-```
-
-What it does:
-
-- Creates `storage_nodes`
-- Adds `files.storage_mode` (default `central`) if missing
-- Adds `files.node_id` FK to `storage_nodes(id)` if missing
-
-### Shares migration
-
-Run once to unify old sharing models:
-
-```bash
-python migrate_shares_table.py
-```
-
-What it does:
-
-- Creates unified `shares` table if missing
-- Migrates data from older share tables/links when present
-
-### Batch share schema bootstrap
-
-Run once to enable batch share links:
-
-```bash
-python setup_batch_sharing_db.py
-```
-
-What it does:
-
-- Creates `batch_share_links`
-- Creates `batch_share_items` with FK cascade
-
-## Environment Configuration
-
-Copy the template and fill values:
-
-```bash
-cp .env.example .env
-```
-
-On Windows PowerShell:
-
-```powershell
-Copy-Item .env.example .env
-```
-
-### Key variables
-
-- Flask/runtime:
-  - `FLASK_SECRET_KEY`
-  - `FLASK_HOST`
-  - `FLASK_PORT`
-  - `FLASK_DEBUG`
-  - `APP_BASE_URL`
-- Session hardening:
-  - `SESSION_COOKIE_SECURE`
-  - `SESSION_COOKIE_SAMESITE`
-  - `SESSION_LIFETIME_HOURS`
-- Database:
-  - `DB_HOST`
-  - `DB_USER`
-  - `DB_PASSWORD`
-  - `DB_NAME`
-- OAuth/API:
-  - `GOOGLE_CLIENT_ID`
-  - `GOOGLE_CLIENT_SECRET`
-  - `GOOGLE_API_KEY`
-  - `GITHUB_CLIENT_ID`
-  - `GITHUB_CLIENT_SECRET`
-  - `MONITOR_API_KEY`
-- SMTP:
-  - `SMTP_SENDER_EMAIL`
-  - `SMTP_SENDER_PASSWORD`
-- Storage and sockets:
-  - `UPLOAD_FOLDER`
-  - `ACCOUNT_STORAGE_LIMIT_GB`
-  - `SOCKETIO_CORS_ORIGINS`
-- Monitoring/services:
-  - `MONITOR_GUNICORN_SERVICE`
-
-## Local Development Setup
-
-## 1) Create virtual environment
-
-```bash
-python -m venv .venv
-```
-
-Windows PowerShell:
-
-```powershell
-.\.venv\Scripts\Activate.ps1
-```
-
-## 2) Install dependencies
-
-```bash
-pip install -r requirements.txt
-```
-
-## 3) Configure `.env`
-
-Set a strong `FLASK_SECRET_KEY` and valid DB credentials.
-
-## 4) Optional DB setup/migrations
-
-```bash
-python db_update_nodes.py
-python migrate_shares_table.py
-python setup_batch_sharing_db.py
-```
-
-## 5) Run app
-
-```bash
-python app.py
-```
-
-Server binds to:
-
-- host: `FLASK_HOST` (default `0.0.0.0`)
-- port: `FLASK_PORT` (default `5000`)
-
-## Production Deployment (Linux VPS)
-
-### Recommended stack
-
-- Nginx (reverse proxy)
-- Gunicorn + eventlet worker class for Socket.IO compatibility
-- systemd service for app process
-- MySQL reachable from app host
-
-Example command:
-
-```bash
-gunicorn -k eventlet -w 1 -b 0.0.0.0:5000 app:app
-```
-
-Note: For Flask-SocketIO apps, eventlet/gevent-compatible deployment is recommended.
-
-### Incremental deploy helper
-
-`deploy_changed_files.ps1` can:
-
-- detect changed deployable files from git status
-- fallback to `changed_files.txt` when needed
-- upload files via `scp` and pre-create remote directories via `ssh`
-- optionally restart systemd service
-
-Example:
-
-```powershell
-.\deploy_changed_files.ps1 -RestartService -ServiceName mycloud
-```
-
-Before using in another environment, adjust script parameters:
-
-- `KeyPath`
-- `User`
-- `ServerHost`
-- `RemoteRoot`
-- `ServiceName`
-
-## Operations and Monitoring
-
-Monitoring routes are exposed in the app for:
-
-- system metrics
-- service status/logs
-- app-level statistics and recent endpoint activity
-- product analytics summaries/trends
-
-For protected monitoring APIs, provide configured `MONITOR_API_KEY` where required by your runtime policy.
-
-## Security Notes
-
-- Never commit `.env`, private keys, or runtime upload content.
-- Rotate any credentials that were ever hardcoded/shared.
-- Keep `FLASK_SECRET_KEY` long and random.
-- Enforce HTTPS in production and keep `SESSION_COOKIE_SECURE=true`.
-- Restrict CORS origins via `SOCKETIO_CORS_ORIGINS`.
-
-## Troubleshooting
-
-### App fails at startup with secret key error
-
-- Ensure `FLASK_SECRET_KEY` is set in `.env`.
-
-### DB connection/migration errors
-
-- Verify `DB_HOST`, `DB_USER`, `DB_PASSWORD`, `DB_NAME`
-- Ensure MySQL user has schema alter/create permissions
-
-### Socket issues behind proxy
-
-- Ensure proxy supports websocket upgrade
-- Use an eventlet-compatible Gunicorn setup
-
-### Monitoring service status unavailable
-
-- Confirm Linux host has `systemctl`/`journalctl`
-- Verify service names (`MONITOR_GUNICORN_SERVICE`)
-
-## Release/Push Checklist
-
-- `.env` excluded from git
-- `uploads/`, `build/`, `dist/`, `__pycache__/`, `.venv/` excluded from git
-- `requirements.txt` up to date
-- `.env.example` present and current
-- Run schema scripts on target environment before first production run
-
----

mycloudctl-1.0.1/cli/__init__.py

@@ -1,2 +0,0 @@
-# cli/__init__.py
-__version__ = "1.0.1"

mycloudctl-1.0.1/mycloudctl.egg-info/PKG-INFO

@@ -1,377 +0,0 @@
-Metadata-Version: 2.4
-Name: mycloudctl
-Version: 1.0.1
-Summary: Official CLI for myCloud — your personal cloud storage
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-Requires-Dist: typer[all]>=0.12
-Requires-Dist: rich>=13.7
-Requires-Dist: httpx>=0.27
-
-# myCloud
-
-A full-stack personal cloud platform built with Flask + MySQL that supports file storage, folder management, sharing (direct invite + token links + batch sharing), previews, stash/recovery workflows, monitoring dashboards, and optional storage-node workflows.
-
-## Table of Contents
-
-- Overview
-- Core Features
-- Project Structure
-- Architecture
-- Infrastructure and Runtime Topology
-- Data and Schema Evolution
-- Environment Configuration
-- Local Development Setup
-- Production Deployment (Linux VPS)
-- Operations and Monitoring
-- Security Notes
-- Troubleshooting
-- Release/Push Checklist
-
-## Overview
-
-myCloud is a web application for managing personal cloud files with:
-
-- User auth (username/password and social auth)
-- Upload/download and folder operations
-- Advanced sharing:
-  - direct user invites
-  - token-based share links
-  - batch share links for mixed files/folders
-- Shared library actions (preview, copy to MyCloud, leave share, favorites)
-- Stash workflow for temporary removal/recovery
-- Node-aware storage metadata and optional node-side GUI tooling
-- Monitoring endpoints for system, services, app activity, and product analytics
-
-## Core Features
-
-### Account and Auth
-
-- Registration, login, logout, password reset, email verification
-- Two-factor code flow endpoints
-- OAuth providers:
-  - Google
-  - GitHub
-
-### File and Folder Management
-
-- Upload files, create folders
-- Rename, move, delete, stash, unstash
-- Bulk operations: move/delete/download/share/stash/unstash/remove-share/add-to-mycloud
-- Preview support for images/video/audio/PDF/code/docx (web UI behavior)
-
-### Sharing
-
-- Direct item sharing with permission updates
-- Share links for file/folder
-- Batch share link generation and acceptance
-- Unified share removal APIs
-- Invite response APIs (accept/decline + optional mute sender)
-- Muted user management for invite control
-
-### UX and Settings
-
-- Preferences APIs and sync endpoints
-- Theme/view mode handling in frontend assets
-- Profile picture upload/remove
-- Notifications API + mark-read/hide
-
-### Monitoring and Analytics
-
-- System metrics API (CPU/RAM/disk/network/load)
-- Service status/log APIs (nginx/gunicorn/ssh where available)
-- Application activity monitor (recent events/endpoints)
-- Product analytics overview/trends
-
-## Project Structure
-
-```text
-.
-|- app.py                        # Main Flask + Socket.IO server
-|- services.py                   # Linux service/log monitoring helpers
-|- monitor.py                    # System monitor abstraction + local implementation
-|- app_monitor.py                # App-level activity monitoring
-|- data_monitor.py               # Data/storage monitoring
-|- product_analytics.py          # Product usage analytics
-|- db_update_nodes.py            # DB schema updates for storage node support
-|- migrate_shares_table.py       # Migration to unified shares table
-|- setup_batch_sharing_db.py     # Batch share schema bootstrap
-|- mycloud_node_gui.py           # Optional node desktop GUI client
-|- deploy_changed_files.ps1      # Incremental deployment helper (scp/ssh)
-|- templates/                    # Flask templates
-|- static/                       # Frontend JS/CSS/assets
-|- uploads/                      # Runtime user uploads (ignored from git)
-|- requirements.txt              # Python dependencies
-|- .env.example                  # Environment variable template
-```
-
-## Architecture
-
-### Application Layer
-
-- Framework: Flask
-- Real-time channel: Flask-SocketIO
-- Reverse-proxy awareness: Werkzeug ProxyFix
-- Session + auth logic + routing in a single main server file (`app.py`)
-
-### Real-time / Socket Layer
-
-Socket handlers are registered in `app.py` for:
-
-- node registration
-- node disconnect
-- chunked download transfer
-
-### Persistence Layer
-
-- Primary DB: MySQL (`mysql-connector-python`)
-- Schema support scripts:
-  - `migrate_shares_table.py` creates/migrates a unified `shares` model
-  - `setup_batch_sharing_db.py` provisions `batch_share_links` and `batch_share_items`
-  - `db_update_nodes.py` provisions `storage_nodes` and extends `files` with node metadata
-
-### Frontend Layer
-
-- Server-rendered Jinja templates in `templates/`
-- Static JS/CSS in `static/`
-- Rich shared-files interactions include:
-  - list/grid sort/filter/view
-  - direct invite modal and muted-users modal
-  - multi-select action toolbar
-
-## Infrastructure and Runtime Topology
-
-Typical production topology:
-
-- Browser clients -> Nginx reverse proxy -> Gunicorn/Eventlet Flask-SocketIO app
-- App server -> MySQL database
-- Optional storage nodes -> connect/register via Socket.IO events
-
-`services.py` is designed for Linux hosts with optional `systemctl` / `journalctl` access and can inspect:
-
-- nginx
-- gunicorn (unit configurable via `MONITOR_GUNICORN_SERVICE`)
-- ssh/sshd
-
-## Data and Schema Evolution
-
-### Node/Storage schema updates
-
-Run once when enabling node-aware storage metadata:
-
-```bash
-python db_update_nodes.py
-```
-
-What it does:
-
-- Creates `storage_nodes`
-- Adds `files.storage_mode` (default `central`) if missing
-- Adds `files.node_id` FK to `storage_nodes(id)` if missing
-
-### Shares migration
-
-Run once to unify old sharing models:
-
-```bash
-python migrate_shares_table.py
-```
-
-What it does:
-
-- Creates unified `shares` table if missing
-- Migrates data from older share tables/links when present
-
-### Batch share schema bootstrap
-
-Run once to enable batch share links:
-
-```bash
-python setup_batch_sharing_db.py
-```
-
-What it does:
-
-- Creates `batch_share_links`
-- Creates `batch_share_items` with FK cascade
-
-## Environment Configuration
-
-Copy the template and fill values:
-
-```bash
-cp .env.example .env
-```
-
-On Windows PowerShell:
-
-```powershell
-Copy-Item .env.example .env
-```
-
-### Key variables
-
-- Flask/runtime:
-  - `FLASK_SECRET_KEY`
-  - `FLASK_HOST`
-  - `FLASK_PORT`
-  - `FLASK_DEBUG`
-  - `APP_BASE_URL`
-- Session hardening:
-  - `SESSION_COOKIE_SECURE`
-  - `SESSION_COOKIE_SAMESITE`
-  - `SESSION_LIFETIME_HOURS`
-- Database:
-  - `DB_HOST`
-  - `DB_USER`
-  - `DB_PASSWORD`
-  - `DB_NAME`
-- OAuth/API:
-  - `GOOGLE_CLIENT_ID`
-  - `GOOGLE_CLIENT_SECRET`
-  - `GOOGLE_API_KEY`
-  - `GITHUB_CLIENT_ID`
-  - `GITHUB_CLIENT_SECRET`
-  - `MONITOR_API_KEY`
-- SMTP:
-  - `SMTP_SENDER_EMAIL`
-  - `SMTP_SENDER_PASSWORD`
-- Storage and sockets:
-  - `UPLOAD_FOLDER`
-  - `ACCOUNT_STORAGE_LIMIT_GB`
-  - `SOCKETIO_CORS_ORIGINS`
-- Monitoring/services:
-  - `MONITOR_GUNICORN_SERVICE`
-
-## Local Development Setup
-
-## 1) Create virtual environment
-
-```bash
-python -m venv .venv
-```
-
-Windows PowerShell:
-
-```powershell
-.\.venv\Scripts\Activate.ps1
-```
-
-## 2) Install dependencies
-
-```bash
-pip install -r requirements.txt
-```
-
-## 3) Configure `.env`
-
-Set a strong `FLASK_SECRET_KEY` and valid DB credentials.
-
-## 4) Optional DB setup/migrations
-
-```bash
-python db_update_nodes.py
-python migrate_shares_table.py
-python setup_batch_sharing_db.py
-```
-
-## 5) Run app
-
-```bash
-python app.py
-```
-
-Server binds to:
-
-- host: `FLASK_HOST` (default `0.0.0.0`)
-- port: `FLASK_PORT` (default `5000`)
-
-## Production Deployment (Linux VPS)
-
-### Recommended stack
-
-- Nginx (reverse proxy)
-- Gunicorn + eventlet worker class for Socket.IO compatibility
-- systemd service for app process
-- MySQL reachable from app host
-
-Example command:
-
-```bash
-gunicorn -k eventlet -w 1 -b 0.0.0.0:5000 app:app
-```
-
-Note: For Flask-SocketIO apps, eventlet/gevent-compatible deployment is recommended.
-
-### Incremental deploy helper
-
-`deploy_changed_files.ps1` can:
-
-- detect changed deployable files from git status
-- fallback to `changed_files.txt` when needed
-- upload files via `scp` and pre-create remote directories via `ssh`
-- optionally restart systemd service
-
-Example:
-
-```powershell
-.\deploy_changed_files.ps1 -RestartService -ServiceName mycloud
-```
-
-Before using in another environment, adjust script parameters:
-
-- `KeyPath`
-- `User`
-- `ServerHost`
-- `RemoteRoot`
-- `ServiceName`
-
-## Operations and Monitoring
-
-Monitoring routes are exposed in the app for:
-
-- system metrics
-- service status/logs
-- app-level statistics and recent endpoint activity
-- product analytics summaries/trends
-
-For protected monitoring APIs, provide configured `MONITOR_API_KEY` where required by your runtime policy.
-
-## Security Notes
-
-- Never commit `.env`, private keys, or runtime upload content.
-- Rotate any credentials that were ever hardcoded/shared.
-- Keep `FLASK_SECRET_KEY` long and random.
-- Enforce HTTPS in production and keep `SESSION_COOKIE_SECURE=true`.
-- Restrict CORS origins via `SOCKETIO_CORS_ORIGINS`.
-
-## Troubleshooting
-
-### App fails at startup with secret key error
-
-- Ensure `FLASK_SECRET_KEY` is set in `.env`.
-
-### DB connection/migration errors
-
-- Verify `DB_HOST`, `DB_USER`, `DB_PASSWORD`, `DB_NAME`
-- Ensure MySQL user has schema alter/create permissions
-
-### Socket issues behind proxy
-
-- Ensure proxy supports websocket upgrade
-- Use an eventlet-compatible Gunicorn setup
-
-### Monitoring service status unavailable
-
-- Confirm Linux host has `systemctl`/`journalctl`
-- Verify service names (`MONITOR_GUNICORN_SERVICE`)
-
-## Release/Push Checklist
-
-- `.env` excluded from git
-- `uploads/`, `build/`, `dist/`, `__pycache__/`, `.venv/` excluded from git
-- `requirements.txt` up to date
-- `.env.example` present and current
-- Run schema scripts on target environment before first production run
-
----