Rename MessageEvent to plural, update docblocks.

4 files changed, 15 insertions, 6 deletions

diff --git a/CHANGELOG.md b/CHANGELOG.md
index c44abf9..395c8e5 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,7 +3,8 @@ All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 
 ## [Unreleased][unreleased]
-- All content has been released to date.
+- Message Events API added.
+- Transmission API now accepts a DateTime object for startDate
 
 ## [1.0.3] - 2016-03-25
 ### Added
diff --git a/lib/SparkPost/MessageEvent.php b/lib/SparkPost/MessageEvents.php
index d2fe11c..788b752 100644
--- a/lib/SparkPost/MessageEvent.php
+++ b/lib/SparkPost/MessageEvents.php
@@ -6,8 +6,11 @@ namespace SparkPost;
  *
  * @see https://developers.sparkpost.com/api/#/reference/message-events
  */
-class MessageEvent extends APIResource
+class MessageEvents extends APIResource
 {
+  /**
+   * @var string
+   */
   public $endpoint = 'message-events';
 
   /**
@@ -45,8 +48,13 @@ class MessageEvent extends APIResource
 
   /**
    * List examples of the event data that will be included in a response from the MessageEvent::search() method.
+   *
+   * @param array $events (optional) Event types for which to get a sample payload.  If not provided, samples
+   * for all events will be returned.
+   *
+   * @return array Sample events.
    */
-  public function samples(Array $events) {
+  public function samples(Array $events = []) {
     return $this->get("events/samples", ["events"=>$events]);
   }
 }
\ No newline at end of file
diff --git a/lib/SparkPost/SparkPost.php b/lib/SparkPost/SparkPost.php
index 0e576fe..48d6a9c 100644
--- a/lib/SparkPost/SparkPost.php
+++ b/lib/SparkPost/SparkPost.php
@@ -6,7 +6,7 @@ use Ivory\HttpAdapter\HttpAdapterInterface;
 class SparkPost {
 
   public $transmission;
-  public $messageEvent;
+  public $messageEvents;
 
   /**
    * Connection config for making requests.
@@ -46,7 +46,7 @@ class SparkPost {
     $this->setHttpAdapter($httpAdapter);
 
     $this->transmission = new Transmission($this);
-    $this->messageEvent = new MessageEvent($this);
+    $this->messageEvents = new MessageEvents($this);
   }
 
   /**
diff --git a/test/unit/MessageEventTest.php b/test/unit/MessageEventTest.php
index 935939d..48657e6 100644
--- a/test/unit/MessageEventTest.php
+++ b/test/unit/MessageEventTest.php
@@ -21,7 +21,7 @@ class MessageEventTest extends \PHPUnit_Framework_TestCase
       $mock->shouldReceive('getHttpHeaders')->andReturn([]);
     });
     $this->sparkPostMock->httpAdapter = Mockery::mock();
-    $this->sut = new MessageEvent($this->sparkPostMock);
+    $this->sut = new MessageEvents($this->sparkPostMock);
   }
 
   public function testDateTimeConversion()