Allow to set folder by id or name

modules/restapi/src/main/resources/docspell-openapi.yml

@@ -5073,7 +5073,8 @@ components:
         A direction can be given, `Incoming` is used if not specified.
 
         A folderId can be given, the item is placed into this folder
-        after creation.
+        after creation. It may be the exact id of the folder or its
+        name.
 
         The `fileFilter` is an optional glob for filtering files to
         import. Only applicable if archive files are uploaded. It

modules/store/src/main/scala/docspell/store/records/RFolder.scala

@@ -74,6 +74,25 @@ object RFolder {
     sql.query[RFolder].option
   }
 
+  def requireIdByIdOrName(
+      folderId: Ident,
+      name: String,
+      collective: Ident
+  ): ConnectionIO[Ident] = {
+    val sql = run(
+      select(T.id),
+      from(T),
+      T.id === folderId || (T.name === name && T.collective === collective)
+    )
+    sql.query[Ident].option.flatMap {
+      case Some(id) => id.pure[ConnectionIO]
+      case None =>
+        Sync[ConnectionIO].raiseError(
+          new Exception(s"No folder found for: id=${folderId.id} or name=${name}")
+        )
+    }
+  }
+
   def findAll(
       coll: Ident,
       nameQ: Option[String],

modules/store/src/main/scala/docspell/store/records/RItem.scala

@@ -274,10 +274,14 @@ object RItem {
   ): ConnectionIO[Int] =
     for {
       t <- currentTime
+      fid <- folderId match {
+        case Some(f) => RFolder.requireIdByIdOrName(f, f.id, coll).map(_.some)
+        case None    => None.pure[ConnectionIO]
+      }
       n <- DML.update(
         T,
         T.cid === coll && T.id === itemId,
-        DML.set(T.folder.setTo(folderId), T.updated.setTo(t))
+        DML.set(T.folder.setTo(fid), T.updated.setTo(t))
       )
     } yield n