@dropthis/cli 0.31.0 → 0.33.1

package/README.md

@@ -157,6 +157,10 @@ All publish flags:
 | `--visibility <public\|unlisted>` | Drop visibility |
 | `--password <password>` | Require a password to view the drop (Pro plan) |
 | `--noindex` | Prevent search indexing |
+| `--slug <vanity-slug>` | Vanity slug for a path-mode custom domain (only with `--domain`; Pro) |
+| `--domain <hostname>` | Serve the drop under one of your connected custom domains (Pro) |
+| `--shared` | Publish to the shared dropthis pool, bypassing your default custom domain |
+| `--workspace <slugOrId>` | Target a specific workspace for this publish (delegated keys) |
 | `--entry <path>` | Entry file for directories |
 | `--content-type <mime>` | MIME type (required for stdin) |
 | `--path <path>` | Filename (required for stdin) |
@@ -199,7 +203,7 @@ dropthis update-settings drop_abc123 --title "New title"
 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.
+`update-content` updates the files at the URL — **patch by default**: files you don't include are carried forward, so you can ship a single changed file. Use `--mode replace` (or `--replace`) for a full content swap, and `--delete-path <path>` (repeatable) to remove a file. `update-settings` changes title, visibility, password, noindex, expiry, or metadata — including `--no-password` to clear a password and `--index` to re-allow indexing. 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:
 
@@ -234,15 +238,27 @@ Pull fetches the current deployment's file manifest and writes every file into t
 dropthis [input...]                          # Publish content (default command)
 dropthis publish [input...]                  # Same as above, explicit form
 
-dropthis update-content <drop-id> [input]    # Replace a drop's content (same URL)
+dropthis update-content <drop-id> [input]    # Update a drop's content (patch by default; same URL)
 dropthis update-settings <drop-id>           # Change title/visibility/password/expiry/metadata
 dropthis pull <id|url|slug> [-o <dir>]       # Download a drop's files to a local directory
 dropthis get <id|url|slug>                   # Show drop details
+dropthis resolve <id|url|slug>               # Resolve a drop URL/slug back to its drop_… id
 dropthis list                                # List your drops
 dropthis list --domain reports.example.com   # Only drops on a custom domain
 dropthis delete <id|url|slug>                # Delete a drop (--yes to confirm)
 
-dropthis deployments                         # View deployment history
+dropthis deployments list <drop-id>          # List a drop's deployment history
+dropthis deployments get <drop-id> <dep-id>  # Show one deployment
+
+dropthis domains connect <host> --mode <path|dedicated>   # Connect a custom domain (Pro)
+dropthis domains list                        # List custom domains
+dropthis domains status <host>               # Show domain + DNS status
+dropthis domains verify <host> [--wait]      # Verify DNS (exit 6 pending, 7 timeout)
+dropthis domains update <host> [--default|--drop <id>]    # Repoint or set the default domain
+dropthis domains remove <host> --yes         # Disconnect a domain
+
+dropthis workspace list                      # List workspaces you belong to
+dropthis workspace use <slug|id>             # Switch active workspace (delegated keys)
 
 dropthis login                               # Authenticate with email OTP
 dropthis login request --email <email>       # Request OTP (non-interactive)
@@ -250,12 +266,13 @@ dropthis login verify --email <email> --otp <code>   # Verify OTP
 dropthis logout                              # Remove stored credentials
 dropthis whoami                              # Show current auth status
 
-dropthis account                             # Show account details
+dropthis account                             # Show account details, active tier + limits
 dropthis account update --display-name <name>  # Update your display name
+dropthis account delete --yes                # Delete your account
 
-dropthis api-keys create                     # Create an API key
+dropthis api-keys create [--service --workspace <ws>]  # Mint a delegated key, or a pinned CI service key
 dropthis api-keys list                       # List API keys
-dropthis api-keys delete <key-id>            # Delete an API key (--yes to confirm)
+dropthis api-keys delete <key-id> --yes      # Delete an API key
 
 dropthis upgrade                             # Update the CLI to the latest version
 dropthis doctor                              # CLI diagnostics
@@ -300,10 +317,12 @@ dropthis publish ./dist --url
 | 6 | Domain verification pending (`domains verify` one-shot, not live yet) |
 | 7 | Domain verification timeout (`domains verify --wait` exceeded `--timeout`) |
 
+This table — plus the global flags (`--api-key`, `--api-url`, `--json`, `--quiet`, `--no-interactive`) — is machine-readable from `dropthis commands --json` (the `exit_codes` and `global_options` fields), so an agent can discover the whole surface without scraping docs.
+
 **JSON output shape:**
 
 ```json
-{"ok":true,"drop":{"url":"https://dropthis.app/abc123","id":"drop_abc123"}}
+{"ok":true,"drop":{"url":"https://abc123.dropthis.app/","id":"drop_abc123"}}
 ```
 
 **Error shape (stderr):**
@@ -323,13 +342,20 @@ dropthis doctor
 Reports CLI version, auth source (`env`, `flag`, `storage`, or `missing`), and credential storage backend (`secure`, `insecure`, or `none`).
 
 ```json
-{"ok":true,"version":"0.4.1","auth":{"source":"env"},"storage":{"backend":"secure"}}
+{"ok":true,"version":"0.32.0","auth":{"source":"env"},"storage":{"backend":"secure"}}
+```
+
+Add `--online` for a network preflight an agent can run **before** a publish to tell apart the common failures — re-auth vs network vs an unresolved workspace:
+
+```bash
+dropthis doctor --online --json
 ```
 
+It hits `GET /v1/account` (token valid? which workspace resolves? which plan?) and lists custom-domain verification status as a `checks` array. It exits **3** on an auth failure and **5** on a network failure, so a script can branch on the exit code.
+
 ## Pricing tiers
 
-- **Free** — drops expire after 7 days, 5 MB per drop, 500 MB active storage, dropthis badge.
-- **Pro** — drops never expire, 100 MB per drop, 10 GB storage, no badge, 1 custom domain, password-protected drops. Pro is currently invite-only. Learn more at https://dropthis.app/pricing.
+dropthis has four tiers — **Free**, **Keep**, **Pro**, and **Business**. Free drops carry the dropthis badge and expire after 30 days; paid tiers add permanence, larger limits, custom domains, passwords, and analytics. Run `dropthis account` to see your active tier and its exact caps, or visit https://dropthis.app/pricing for the current plans.
 
 Connecting a custom domain (`dropthis domains connect`) requires the Pro plan (1 hostname). Domains already connected keep working regardless of plan.