/**
* Adds an artifact to the collection.
*
* @param \Gedcomx\Rs\Client\Util\DataSource $artifact
* @param \Gedcomx\Source\SourceDescription $description
* @param \Gedcomx\Rs\Client\GedcomxApplicationState $state
* @param \Gedcomx\Rs\Client\Options\StateTransitionOption $option,...
*
* @throws \Gedcomx\Rs\Client\Exception\GedcomxApplicationException
* @return \Gedcomx\Rs\Client\SourceDescriptionState
*/
public function addArtifact(DataSource $artifact, SourceDescription $description = null, GedcomxApplicationState $state = null, StateTransitionOption $option = null)
{
if ($state == null) {
$state = $this;
}
$link = $state->getLink(Rel::ARTIFACTS);
if ($link == null || $link->getHref() == null) {
throw new GedcomxApplicationException(sprintf("Resource at %s doesn't support adding artifacts.", state . getUri()));
}
$postData = [];
if ($artifact->isFile()) {
$postData[] = ['name' => 'artifact', 'contents' => fopen($artifact->getFile(), 'r')];
if ($artifact->getTitle()) {
$postData[] = ['name' => 'title', 'contents' => $artifact->getTitle()];
}
} else {
foreach ($artifact->getParameters() as $key => $value) {
$postData[] = ['name' => $key, 'contents' => $value];
}
}
if ($description != null) {
if ($description->getTitles() != null) {
foreach ($description->getTitles() as $value) {
$postData[] = ['name' => 'title', 'contents' => $value->getValue()];
}
}
if ($description->getDescriptions() != null) {
foreach ($description->getDescriptions() as $value) {
$postData[] = ['name' => 'description', 'contents' => $value->getValue()];
}
}
if ($description->getCitations() != null) {
foreach ($description->getCitations() as $citation) {
$postData[] = ['name' => 'citation', 'contents' => $value->getValue()];
}
}
}
$body = new \GuzzleHttp\Psr7\MultipartStream($postData);
$headers = ['Content-Type' => 'multipart/form-data; boundary=' . $body->getBoundary()];
$request = $state->createAuthenticatedGedcomxRequest('POST', $link->getHref(), $headers, null, $body);
return $state->stateFactory->createState('SourceDescriptionState', $this->client, $request, $state->passOptionsTo('invoke', array($request), func_get_args()), $state->accessToken);
}
