Add a route to delete a file in the trash bin of NextCloud

docs/nextcloud.md

@@ -511,6 +511,31 @@ HTTP/1.1 204 No Content
 - 404 Not Found, when the account is not found or the file/directory is not found on the NextCloud
 - 409 Conflict, when a directory or file already exists where the file/directory should be restored on the NextCloud.
 
+## DELETE /remote/nextcloud/:account/trash/*
+
+This route can be used to delete a file in the trash.
+
+### Request
+
+```http
+DELETE /remote/nextcloud/4ab2155707bb6613a8b9463daf00381b/trash/document-v1.docx HTTP/1.1
+Host: cozy.example.net
+Authorization: Bearer eyJhbG...
+```
+
+### Response
+
+```http
+HTTP/1.1 204 No Content
+```
+
+#### Status codes
+
+- 204 No Content, when the file/directory has been put in the trash
+- 400 Bad Request, when the account is not configured for NextCloud, or the `To` parameter is missing
+- 401 Unauthorized, when authentication to the NextCloud fails
+- 404 Not Found, when the account is not found or the file/directory is not found on the NextCloud
+
 ## DELETE /remote/nextcloud/:account/trash
 
 This route can be used to empty the trash bin on NextCloud.

model/nextcloud/nextcloud.go

@@ -152,6 +152,10 @@ func (nc *NextCloud) Restore(path string) error {
  return nc.webdav.Move(path, dst)
 }
 
+func (nc *NextCloud) DeleteTrash(path string) error {
+ return nc.webdav.Delete("/trashbin/" + nc.userID + "/" + path)
+}
+
 func (nc *NextCloud) EmptyTrash() error {
  return nc.webdav.Delete("/trashbin/" + nc.userID + "/trash")
 }

web/remote/nextcloud.go

@@ -43,6 +43,25 @@ func nextcloudGetTrash(c echo.Context) error {
  return jsonapi.DataList(c, http.StatusOK, files, nil)
 }
 
+func nextcloudDeleteTrash(c echo.Context) error {
+ inst := middlewares.GetInstance(c)
+ if err := middlewares.AllowWholeType(c, permission.DELETE, consts.Files); err != nil {
+ return err
+ }
+
+ accountID := c.Param("account")
+ nc, err := nextcloud.New(inst, accountID)
+ if err != nil {
+ return wrapNextcloudErrors(err)
+ }
+
+ path := "/trash/" + c.Param("*")
+ if err := nc.DeleteTrash(path); err != nil {
+ return wrapNextcloudErrors(err)
+ }
+ return c.NoContent(http.StatusNoContent)
+}
+
 func nextcloudEmptyTrash(c echo.Context) error {
  inst := middlewares.GetInstance(c)
  if err := middlewares.AllowWholeType(c, permission.DELETE, consts.Files); err != nil {
@@ -305,6 +324,7 @@ func nextcloudRestore(c echo.Context) error {
 func nextcloudRoutes(router *echo.Group) {
  group := router.Group("/nextcloud/:account")
  group.GET("/trash/*", nextcloudGetTrash)
+ group.DELETE("/trash/*", nextcloudDeleteTrash)
  group.DELETE("/trash", nextcloudEmptyTrash)
  group.GET("/*", nextcloudGet)
  group.PUT("/*", nextcloudPut)