Initial support for attachments

Author: robgridley

src/Client.php

@@ -63,6 +63,16 @@ public function __get($name)
         return $this->model(Type::modelify($name));
     }
 
+    /**
+     * Get an instance of the attachment service.
+     *
+     * @return \Pace\Services\AttachmentService
+     */
+    public function attachment()
+    {
+        return $this->service('AttachmentService');
+    }
+
     /**
      * Clone an object.
      *

src/Model.php

@@ -5,11 +5,14 @@
 use ArrayAccess;
 use JsonSerializable;
 use Pace\XPath\Builder;
+use Pace\Model\Attachments;
 use InvalidArgumentException;
 use UnexpectedValueException;
 
 class Model implements ArrayAccess, JsonSerializable
 {
+    use Attachments;
+
     /**
      * The model type.
      *

src/Model/Attachments.php

@@ -0,0 +1,47 @@
+<?php
+
+namespace Pace\Model;
+
+use BadMethodCallException;
+
+trait Attachments
+{
+    /**
+     * Attach a file to the model.
+     *
+     * @param string $name
+     * @param string $content
+     * @param int|string|null $primaryKey
+     * @return \Pace\Model
+     */
+    public function attach($name, $content, $primaryKey = null)
+    {
+        $key = $this->client->attachment()->add($this->type, $this->key($primaryKey), null, $name, $content);
+
+        return $this->client->model('FileAttachment')->read($key);
+    }
+
+    /**
+     * Get the model's attachments.
+     *
+     * @return \Pace\KeyCollection
+     */
+    public function attachments()
+    {
+        return $this->morphMany('FileAttachment')->get();
+    }
+
+    /**
+     * Get the file attachment content.
+     *
+     * @return string
+     */
+    public function getContent()
+    {
+        if ($this->type !== 'FileAttachment') {
+            throw new BadMethodCallException('Call to method which only exists on FileAttachment');
+        }
+
+        return $this->client->attachment()->getByKey($this->attachment)['content'];
+    }
+}

src/Services/AttachmentService.php

@@ -0,0 +1,84 @@
+<?php
+
+namespace Pace\Services;
+
+use Finfo;
+use Pace\Service;
+
+class AttachmentService extends Service
+{
+    /**
+     * Add a new attachment to the vault.
+     *
+     * @param string $object
+     * @param mixed $key
+     * @param string|null $attribute
+     * @param string $name
+     * @param string $content
+     * @return string
+     */
+    public function add($object, $key, $attribute, $name, $content)
+    {
+        $attachment = [
+            'name' => $name,
+            'content' => base64_encode($content),
+            'mimeType' => $this->guessMimeType($name, $content),
+            'fileExtension' => pathinfo($name, PATHINFO_EXTENSION),
+        ];
+
+        $request = [
+            'in0' => $object,
+            'in1' => $key,
+            'in2' => $attribute,
+            'in3' => $attachment,
+        ];
+
+        $response = $this->soap->addAttachment($request);
+
+        return $response->out;
+    }
+
+    /**
+     * Get an attachment from the vault by the specified key.
+     *
+     * @param string $key
+     * @return array
+     */
+    public function getByKey($key)
+    {
+        $request = ['in0' => $key];
+
+        $response = $this->soap->getAttachmentFromKey($request);
+
+        $attachment = (array)$response->out;
+        $attachment['content'] = base64_decode($attachment['content']);
+
+        return $attachment;
+    }
+
+    /**
+     * Remove an attachment from the vault by the specified key.
+     *
+     * @param string $key
+     */
+    public function removeByKey($key)
+    {
+        $request = ['in0' => $key];
+
+        $this->soap->removeAttachmentFromKey($request);
+    }
+
+    /**
+     * Guess the MIME type for the specified file.
+     *
+     * @param string $name
+     * @param string $content
+     * @return string
+     */
+    protected function guessMimeType($name, $content)
+    {
+        $finfo = new Finfo(FILEINFO_MIME_TYPE);
+
+        return $finfo->buffer($content) ?: 'application/octet-stream';
+    }
+}