@within-7/jetr 0.1.0 → 0.1.1

package/README.md

@@ -0,0 +1,139 @@
+# @within-7/jetr
+
+Internal static site hosting CLI. Deploy static files to Cloudflare R2 and get a `{name}.jetr.within-7.com` subdomain.
+
+## Install
+
+```bash
+npm i -g @within-7/jetr
+```
+
+Or use directly:
+
+```bash
+npx @within-7/jetr deploy my-site ./dist
+```
+
+## Quick Start
+
+```bash
+# 1. Login with your JWT token (from auth-gateway)
+jetr login <token>
+
+# 2. Create a site
+jetr create my-blog
+
+# 3. Deploy
+jetr deploy my-blog ./dist
+# ✔ Deployed!
+#   URL:       https://my-blog.jetr.within-7.com
+#   Uploaded:  12 files
+#   Size:      1.2 MB
+```
+
+## Commands
+
+### `jetr login <token>`
+
+Save JWT token for authentication. Token is stored in `~/.jetr/config.json`.
+
+```bash
+jetr login eyJhbGciOiJIUzI1NiJ9...
+jetr login <token> --api-url https://custom-api.example.com
+```
+
+### `jetr create <name>`
+
+Create a new site. Name becomes the subdomain: `{name}.jetr.within-7.com`.
+
+```bash
+jetr create my-blog
+jetr create preview-site --password secret123
+jetr create temp-demo --expires 86400    # expires in 24h
+```
+
+### `jetr deploy <name> [directory]`
+
+Deploy a directory to a site. Uses incremental upload — only changed files are uploaded.
+
+```bash
+jetr deploy my-blog ./dist
+jetr deploy my-blog .          # deploy current directory
+jetr deploy my-blog            # defaults to current directory
+```
+
+### `jetr list`
+
+List your sites.
+
+```bash
+jetr list
+jetr ls
+```
+
+### `jetr info <name>`
+
+Show site details including files and share tokens.
+
+```bash
+jetr info my-blog
+```
+
+### `jetr delete <name>`
+
+Delete a site and all its files.
+
+```bash
+jetr delete my-blog
+jetr rm my-blog
+```
+
+### `jetr password <name> [password]`
+
+Set or remove site password.
+
+```bash
+jetr password my-blog secret123    # set password
+jetr password my-blog              # remove password
+```
+
+### `jetr token create <site>`
+
+Create a share token for password-protected sites.
+
+```bash
+jetr token create my-blog --note "For QA team"
+jetr token create my-blog --expires 3600    # 1 hour
+```
+
+### `jetr token revoke <site> <id>`
+
+Revoke a share token.
+
+```bash
+jetr token revoke my-blog KTEaMnomEOPHlZizIvDNL
+```
+
+### `jetr whoami`
+
+Show current config (API URL and token).
+
+## How It Works
+
+1. **`jetr deploy`** scans the directory and computes SHA-256 hashes for each file
+2. Sends the file manifest to the API, which diffs against the current state
+3. Only uploads files that changed (incremental deploy)
+4. Finalizes the deploy — old files are cleaned up, new files go live
+
+This means re-deploying a large site with one changed file only uploads that one file.
+
+## Config
+
+Config is stored at `~/.jetr/config.json`:
+
+```json
+{
+  "apiUrl": "https://jetr-api.lixilei.workers.dev",
+  "token": "eyJhbG..."
+}
+```

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@within-7/jetr",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "CLI for Jetr static site hosting",
   "type": "module",
   "bin": {
     "jetr": "./dist/cli.js"
   },
-  "files": ["dist"],
+  "files": ["dist", "README.md"],
   "scripts": {
     "build": "tsup src/cli.ts --format esm --target node20 --clean",
     "dev": "tsx src/cli.ts",