RestProjectsService.scala

package org.knora.webapi.responders.admin
import zio.Task
import zio.URLayer
import zio.ZLayer

import org.knora.webapi.IRI
import org.knora.webapi.messages.admin.responder.projectsmessages.ProjectGetRequestADM
import org.knora.webapi.messages.admin.responder.projectsmessages.ProjectGetResponseADM
import org.knora.webapi.messages.admin.responder.projectsmessages.ProjectIdentifierADM
import org.knora.webapi.responders.ActorToZioBridge

final case class RestProjectsService(bridge: ActorToZioBridge) {

  /**
   * Finds the project by an [[IRI]] and returns the information as a [[ProjectGetResponseADM]].
   *
   * @param projectIri           an [[IRI]] identifying the project
   * @return
   *     '''success''': information about the project as a [[ProjectGetResponseADM]]
   *
   *     '''error''': [[dsp.errors.NotFoundException]] when no project for the given IRI can be found
   *                  [[dsp.errors.ValidationException]] if the given `projectIri` is invalid
   */
  def getSingleProjectADMRequest(projectIri: IRI): Task[ProjectGetResponseADM] =
    ProjectIdentifierADM.IriIdentifier
      .fromString(projectIri)
      .toZIO
      .flatMap(getSingleProjectADMRequest(_))

  /**
   * Finds the project by its [[ProjectIdentifierADM]] and returns the information as a [[ProjectGetResponseADM]].
   *
   * @param identifier           a [[ProjectIdentifierADM]] instance
   * @return
   *     '''success''': information about the project as a [[ProjectGetResponseADM]]
   *
   *     '''failure''': [[dsp.errors.NotFoundException]] when no project for the given IRI can be found
   */
  def getSingleProjectADMRequest(identifier: ProjectIdentifierADM): Task[ProjectGetResponseADM] =
    bridge.askAppActor(ProjectGetRequestADM(identifier))
}

object RestProjectsService {
  val layer: URLayer[ActorToZioBridge, RestProjectsService] = ZLayer.fromFunction(RestProjectsService.apply _)
}