Merge pull request #18 from CloudCannon/feat/editing-subcommands

Add site editing subcommands

Author: rphillips-cc

README.md

@@ -430,6 +430,7 @@ Upload a file to a site.
 
 ```sh
 cloudcannon sites files upload --site my-site ./local-file.html /uploaded-file.html
+cloudcannon sites files upload --site my-site ./local-file.html /uploaded-file.html --allow-overwrite
 ```
 
 **Flags**
@@ -438,7 +439,132 @@ cloudcannon sites files upload --site my-site ./local-file.html /uploaded-file.h
 |---|---|---|
 | `--site <name\|id\|uuid\|domain>` | The site name, ID, UUID, or domain (required) |
 | `--type <mime>` | MIME type of the file | |
-| `--overwrite` | Overwrite if the file already exists | `false` |
+| `--allow-overwrite` | Overwrite the destination if it already exists | `false` |
+
+---
+
+### `sites files move --site <name|id|uuid|domain> [src] [dest]`
+
+Move a file within a site editing session.
+
+```sh
+cloudcannon sites files move --site my-site content/old.md content/new.md
+cloudcannon sites files move --site my-site content/old.md content/new.md --allow-overwrite
+```
+
+**Flags**
+
+| Flag | Description | Default |
+|---|---|---|
+| `--site <name\|id\|uuid\|domain>` | The site name, ID, UUID, or domain (required) | |
+| `--allow-overwrite` | Overwrite the destination if it already exists | `false` |
+
+---
+
+### `sites files clone --site <name|id|uuid|domain> [src] [dest]`
+
+Clone a file to a new path within a site editing session. The source file is left unchanged.
+
+```sh
+cloudcannon sites files clone --site my-site content/post.md content/post-copy.md
+cloudcannon sites files clone --site my-site content/post.md content/post-copy.md --allow-overwrite
+```
+
+**Flags**
+
+| Flag | Description | Default |
+|---|---|---|
+| `--site <name\|id\|uuid\|domain>` | The site name, ID, UUID, or domain (required) | |
+| `--allow-overwrite` | Overwrite the destination if it already exists | `false` |
+
+---
+
+### `sites files delete --site <name|id|uuid|domain> [target]...`
+
+Delete one or more files within a site editing session. The files are removed from the repository on commit.
+
+```sh
+cloudcannon sites files delete --site my-site content/old.md
+cloudcannon sites files delete --site my-site content/a.md content/b.md --discard-unsaved
+```
+
+**Flags**
+
+| Flag | Description | Default |
+|---|---|---|
+| `--site <name\|id\|uuid\|domain>` | The site name, ID, UUID, or domain (required) | |
+| `--discard-unsaved` | Discard any unsaved edits to the files | `false` |
+
+---
+
+### `sites files restore --site <name|id|uuid|domain> [target]...`
+
+Restore one or more deleted files within a site editing session, removing the pending delete entries.
+
+```sh
+cloudcannon sites files restore --site my-site content/old.md
+cloudcannon sites files restore --site my-site content/a.md content/b.md
+```
+
+**Flags**
+
+| Flag | Description | Default |
+|---|---|---|
+| `--site <name\|id\|uuid\|domain>` | The site name, ID, UUID, or domain (required) | |
+
+---
+
+### `sites files discard --site <name|id|uuid|domain> [target]...`
+
+Discard one or more session files from a site editing session, permanently deleting their pending edits.
+
+```sh
+cloudcannon sites files discard --site my-site content/old.md
+cloudcannon sites files discard --site my-site content/a.md content/b.md
+```
+
+**Flags**
+
+| Flag | Description | Default |
+|---|---|---|
+| `--site <name\|id\|uuid\|domain>` | The site name, ID, UUID, or domain (required) | |
+
+---
+
+### `sites files list-edits --site <name|id|uuid|domain>`
+
+List pending edits on the site's current editing session.
+
+```sh
+cloudcannon sites files list-edits --site my-site
+cloudcannon sites files list-edits --site my-site --verbose
+```
+
+**Flags**
+
+| Flag | Description | Default |
+|---|---|---|
+| `--site <name\|id\|uuid\|domain>` | The site name, ID, UUID, or domain (required) | |
+| `--verbose` | Print the full objects returned by the API | `false` |
+
+---
+
+### `sites files commit --site <name|id|uuid|domain> [path]...`
+
+Commit a site editing session, pushing changes to the connected repository.
+
+```sh
+cloudcannon sites files commit --site my-site --all
+cloudcannon sites files commit --site my-site content/a.md content/b.md --message "Publish posts"
+```
+
+**Flags**
+
+| Flag | Description | Default |
+|---|---|---|
+| `--site <name\|id\|uuid\|domain>` | The site name, ID, UUID, or domain (required) | |
+| `--all` | Commit all files in the editing session | `false` |
+| `--message <msg>` | Commit message | |
 
 ---
 

package-lock.json

@@ -63,7 +63,7 @@
 		"@cloudcannon/configuration-loader": "0.0.10",
 		"@cloudcannon/configuration-types": "0.0.58",
 		"@cloudcannon/gadget": "0.0.33",
-		"@cloudcannon/sdk": "0.0.7",
+		"@cloudcannon/sdk": "0.0.8",
 		"ajv": "8.20.0",
 		"citty": "0.2.2",
 		"fastest-levenshtein": "1.0.16",