ngx-git 1.0.0 → 1.0.2

package/README.txt

@@ -0,0 +1,35 @@
+
+install: npm i -g ngx-git
+
+NGX v4.0.0 — GitHub proxy CLI
+
+Auth:
+  ngx login                              GitHub OAuth (opens browser)
+  ngx logout                             Clear saved session
+  ngx whoami                             Show current user
+
+Push / Clone:
+  ngx push                               Push current folder to GitHub
+  ngx push my-repo                       Push with specific repo name
+  ngx push my-repo --public              Push as public repo
+  ngx push my-repo --path ./src          Push a subfolder
+  ngx push my-repo --message "feat: x"   Custom commit message
+  ngx clone owner/repo                   Clone repo (downloads all files)
+  ngx clone owner/repo ./local-dir       Clone into specific directory
+
+Repos:
+  ngx repos                              List your GitHub repos
+  ngx create <name> [--public]           Create a new GitHub repo
+  ngx delete <name>                      Delete a GitHub repo
+  ngx visibility <repo> public|private   Change repo visibility
+
+Logs:
+  ngx logs                               Your NGX activity log
+
+Config:
+  ngx config server <url>                Point to a different NGX server
+  ngx -v                                 Show version
+
+Auto-ignored on push:
+  .env  node_modules  .git  dist  build  *.key  *.pem  secrets
+  Add extras in .ngxignore or .gitignore

package/cli.js

@@ -545,7 +545,7 @@ const { flags, rest } = parseArgs(rawArgs || []);
 
     case "whoami":
       const u = getUsername();
-      if (u) console.log(`Logged in as: ${C.bold(u)}  (${getServer()})`);
+      if (u) console.log(`Logged in as: ${C.bold(u)}  "nginxSoft"`);
       else console.log("Not logged in");
       break;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ngx-git",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "NGX - Minimal GitHub-like server",
   "main": "server.js",
   "bin": {

package/data/test.txt

@@ -1 +0,0 @@
-how are 

package/readmi.txt

@@ -1,189 +0,0 @@
-# NGX v2.0 — Minimal GitHub-like Code Vault
-
-A self-hosted, lightweight code repository server with JWT auth, repo tokens, public/private repos, activity logging, and a React UI.
-
----
-
-## 🚀 Quick Start
-
-### 1. Install dependencies
-```bash
-npm install
-```
-
-### 2. Configure environment
-```bash
-cp .env.example .env
-# Edit .env: set a strong JWT_SECRET
-```
-
-### 3. Start the server
-```bash
-npm start
-# Server runs at http://localhost:3000
-```
-
-### 4. Open the UI
-Open `ui.html` in your browser (or serve it via any static server).
-
-### 5. Install CLI globally
-```bash
-npm link
-# Now you can use `ngx` anywhere
-```
-
----
-
-## 📡 Server API
-
-| Method | Route | Auth | Description |
-|--------|-------|------|-------------|
-| GET | `/status` | None | Server health check |
-| POST | `/auth/register` | None | Create account |
-| POST | `/auth/login` | None | Login, get JWT |
-| GET | `/repos/:user` | Optional | List repos (private filtered) |
-| GET | `/repos/:user/:repo` | Optional | Get repo info |
-| POST | `/repos/:user/:repo` | JWT | Create repo |
-| PATCH | `/repos/:user/:repo/visibility` | JWT | Toggle public/private |
-| DELETE | `/repos/:user/:repo` | JWT | Delete repo |
-| GET | `/repos/:user/:repo/token` | JWT | Get repo token |
-| POST | `/repos/:user/:repo/token/regenerate` | JWT | Regenerate token |
-| POST | `/push/:user/:repo` | JWT or Repo Token | Push zip |
-| GET | `/clone/:user/:repo` | None (public) / JWT or Repo Token (private) | Download zip |
-| GET | `/logs/:user` | JWT | Your activity log |
-| GET | `/logs/:user/:repo` | JWT (private) / None (public) | Repo activity |
-
----
-
-## 🖥 CLI Commands
-
-### Auth
-```bash
-ngx register <username> <password>    # Register
-ngx login <username> <password>       # Login (saves JWT to ~/.ngxconfig)
-ngx logout                            # Clear session
-ngx whoami                            # Show current user
-```
-
-### Repo Management
-```bash
-ngx init <reponame> [public|private]  # Create a repo (default: private)
-ngx repos                             # List your repos
-ngx delete <reponame>                 # Delete (asks confirmation)
-ngx visibility <reponame> public      # Make public
-ngx visibility <reponame> private     # Make private
-```
-
-### Push / Clone
-```bash
-# Push (using JWT — must be logged in)
-ngx push ./my-project
-
-# Push (using repo token — no login needed)
-ngx push ./my-project --token <repo-token>
-
-# Clone public repo (no auth)
-ngx clone alice/my-project
-
-# Clone private repo (JWT must be logged in as owner)
-ngx clone alice/my-project
-
-# Clone private repo (using repo token)
-ngx clone alice/my-project --token <repo-token>
-
-# Clone into specific folder
-ngx clone alice/my-project ./local-copy
-```
-
-> **Note:** `push` and `clone` use the folder/repo name automatically.  
-> `.ngxsafe`, `node_modules`, and `.git` are excluded from push.
-
-### Tokens
-```bash
-ngx token show <reponame>    # Show current repo token
-ngx token regen <reponame>   # Regenerate (old token immediately invalid)
-```
-
-### Logs
-```bash
-ngx logs                     # Your last 100 actions
-ngx logs <reponame>          # Activity for a specific repo
-```
-
-### Server Config
-```bash
-ngx config server http://my-server.com:3000   # Point CLI to custom server
-ngx -v                                         # Show version
-```
-
----
-
-## 🔐 Auth System
-
-### JWT (for UI and CLI login sessions)
-- Expires in **7 days**
-- Stored in `~/.ngxconfig` (CLI) or `sessionStorage` (UI)
-- Required for: creating repos, deleting, changing visibility, viewing tokens
-
-### Repo Token (for CI/CD, scripts, team sharing)
-- A UUID generated when repo is created
-- Does **not** expire unless regenerated
-- Can be used with `--token` flag in CLI
-- For **private repos**: needed by anyone who isn't the owner
-- For **public repos**: not needed for clone; needed for push
-
-### Public vs Private
-| Operation | Public Repo | Private Repo |
-|-----------|-------------|--------------|
-| Clone | Anyone, no auth | Owner JWT or Repo Token |
-| Push | Owner JWT or Repo Token | Owner JWT or Repo Token |
-| View info | Anyone | Owner only |
-
----
-
-## 📁 File Structure
-
-```
-ngx-server/
-├── server.js        # Express API server
-├── cli.js           # CLI tool
-├── ui.html          # React UI (single file)
-├── package.json
-├── .env             # Your config (JWT_SECRET, PORT)
-├── .env.example
-├── data.json        # Users + repos DB (auto-created)
-├── activity.log     # Activity log (auto-created, NDJSON)
-├── repos/           # Stored zips (auto-created)
-│   └── <username>/
-│       └── <reponame>/
-│           └── latest.zip
-└── tmp/             # Upload temp dir (auto-created)
-```
-
----
-
-## 🛡 Security Notes
-
-1. **Change `JWT_SECRET`** in `.env` before deploying — use a long random string.
-2. The `data.json` contains hashed passwords (bcrypt, 10 rounds). Never expose it publicly.
-3. For production, put HTTPS in front (nginx/caddy recommended).
-4. Consider adding rate limiting (e.g., `express-rate-limit`) for public deployments.
-5. Repo tokens are UUIDs — treat them like passwords.
-
----
-
-## 🔧 Dependencies
-
-| Package | Purpose |
-|---------|---------|
-| express | HTTP server |
-| multer | File upload handling |
-| jsonwebtoken | JWT sign/verify |
-| bcryptjs | Password hashing |
-| uuid | Repo token generation |
-| cors | Cross-origin requests |
-| adm-zip | Zip/unzip for push/clone |
-| axios | HTTP client (CLI) |
-| form-data | Multipart form (CLI) |
-| cross-spawn | Process spawning |
-| dotenv | Environment config |