@dropthis/cli 0.9.3 → 0.11.0

package/README.md

@@ -88,18 +88,19 @@ dropthis ./dist --url
 dropthis publish ./dist \
   --title "Launch page" \
   --visibility unlisted \
-  --password s3cret \
   --entry index.html \
   --expires-at 2026-12-31T00:00:00Z
 ```
 
+`publish` always creates a NEW drop with a new URL. To change a drop you already published, use `update-content` or `update-settings` with its `drop_…` id — never publish again.
+
 All publish flags:
 
 | Flag | Description |
 |------|-------------|
 | `--title <title>` | Drop title |
 | `--visibility <public\|unlisted>` | Drop visibility |
-| `--password <password>` | Set password protection |
+| `--password <password>` | Set password protection (ships with Pro; not enabled on any tier yet) |
 | `--noindex` | Prevent search indexing |
 | `--entry <path>` | Entry file for directories |
 | `--content-type <mime>` | MIME type (required for stdin) |
@@ -141,6 +142,33 @@ dropthis update-content drop_abc123 ./dist-v2 --if-revision 1
 
 `update-content` replaces the files at the URL; `update-settings` changes title, visibility, password, noindex, expiry, or metadata. Creating a new drop is always `publish` — neither update command makes a new URL.
 
+With `--if-revision`, a concurrent edit fails with a 409 instead of clobbering. The error shows the drop's `current_revision` and how to retry:
+
+```text
+✗ Revision mismatch
+  The drop changed since it was last read. Re-read it with GET /v1/drops/{drop_id} and retry with if_revision: 2 (sent as the If-Revision header).
+  Current revision: 2 — retry with --if-revision 2
+```
+
+In JSON mode the same error carries `current_revision` and a `next_action` field.
+
+## Pull (read back)
+
+Download what a drop is serving — by `drop_…` id, drop URL, or slug. URLs and slugs are resolved to your own drops; the local copy is also the rollback path (pull an old state, then `update-content` it back):
+
+```bash
+# By id, into ./drop_abc123/
+dropthis pull drop_abc123
+
+# By URL — resolves the slug to your drop, writes into ./abc123/
+dropthis pull https://abc123.dropthis.app
+
+# Choose the output directory
+dropthis pull drop_abc123 -o ./site
+```
+
+Pull fetches the current deployment's file manifest and writes every file into the output directory. It is owner-side read-back via the API — it works regardless of any viewer password. Custom-domain URLs are not resolvable yet; use the `drop_…` id instead.
+
 ## Commands
 
 ```bash
@@ -149,6 +177,7 @@ dropthis publish [input...]                  # Same as above, explicit form
 
 dropthis update-content <drop-id> [input]    # Replace a drop's content (same URL)
 dropthis update-settings <drop-id>           # Change title/visibility/password/expiry/metadata
+dropthis pull <id|url> [-o <dir>]            # Download a drop's files to a local directory
 dropthis get <drop-id>                       # Show drop details
 dropthis list                                # List your drops
 dropthis delete <drop-id>                    # Delete a drop (--yes to confirm)
@@ -233,6 +262,14 @@ Reports CLI version, auth source (`env`, `flag`, `storage`, or `missing`), and c
 {"ok":true,"version":"0.4.1","auth":{"source":"env"},"storage":{"backend":"secure"}}
 ```
 
+## Pricing tiers
+
+- **Free ($0)** — drops expire after 7 days, 5 MB per drop, dropthis badge.
+- **Personal ($5/mo)** — drops stay live while subscribed (no expiry), no badge, 100 MB per drop, 2 GB account storage.
+- **Pro ($19/mo)** — everything in Personal plus password protection, custom domains, and analytics.
+
+`dropthis account` shows your active tier and its limits. Note: password protection ships with Pro and is not enabled on any tier yet — the API rejects the `--password` option until then.
+
 ## Agent skills
 
 For AI coding agents (Cursor, Claude Code, Windsurf, etc.), install the [dropthis-skills](https://github.com/dropthis-dev/dropthis-skills) package: