Add support for usage record summary

.travis.yml

@@ -13,7 +13,7 @@ php:
 
 env:
   global:
-    - STRIPE_MOCK_VERSION=0.25.0
+    - STRIPE_MOCK_VERSION=0.26.0
   matrix:
     - AUTOLOAD=1
     - AUTOLOAD=0

init.php

@@ -110,6 +110,7 @@
 require(dirname(__FILE__) . '/lib/Transfer.php');
 require(dirname(__FILE__) . '/lib/TransferReversal.php');
 require(dirname(__FILE__) . '/lib/UsageRecord.php');
+require(dirname(__FILE__) . '/lib/UsageRecordSummary.php');
 
 // OAuth
 require(dirname(__FILE__) . '/lib/OAuth.php');

lib/SubscriptionItem.php

@@ -25,4 +25,19 @@ class SubscriptionItem extends ApiResource
     use ApiOperations\Delete;
     use ApiOperations\Retrieve;
     use ApiOperations\Update;
+
+    /**
+     * @param array|null $params
+     * @param array|string|null $options
+     *
+     * @return Collection The list of source transactions.
+     */
+    public function usageRecordSummaries($params = null, $options = null)
+    {
+        $url = $this->instanceUrl() . '/usage_record_summaries';
+        list($response, $opts) = $this->_request('get', $url, $params, $options);
+        $obj = Util\Util::convertToStripeObject($response, $opts);
+        $obj->setLastResponse($response);
+        return $obj;
+    }
 }

lib/UsageRecordSummary.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace Stripe;
+
+/**
+ * Class UsageRecord
+ *
+ * @package Stripe
+ *
+ * @property string $id
+ * @property string $object
+ * @property string $invoice
+ * @property bool $livemode
+ * @property mixed $period
+ * @property string $subscription_item
+ * @property int $total_usage
+ */
+class UsageRecordSummary extends ApiResource
+{
+
+    const OBJECT_NAME = "usage_record_summary";
+}

lib/Util/Util.php

@@ -125,6 +125,7 @@ public static function convertToStripeObject($resp, $opts)
             \Stripe\Transfer::OBJECT_NAME => 'Stripe\\Transfer',
             \Stripe\TransferReversal::OBJECT_NAME => 'Stripe\\TransferReversal',
             \Stripe\UsageRecord::OBJECT_NAME => 'Stripe\\UsageRecord',
+            \Stripe\UsageRecordSummary::OBJECT_NAME => 'Stripe\\UsageRecordSummary',
         ];
         if (self::isList($resp)) {
             $mapped = [];

tests/Stripe/SubscriptionItemTest.php

@@ -74,4 +74,16 @@ public function testIsDeletable()
         $resource->delete();
         $this->assertInstanceOf("Stripe\\SubscriptionItem", $resource);
     }
+
+    public function testCanListUsageRecordSummaries()
+    {
+        $resource = SubscriptionItem::retrieve(self::TEST_RESOURCE_ID);
+        $this->expectsRequest(
+            'get',
+            '/v1/subscription_items/' . $resource->id . "/usage_record_summaries"
+        );
+        $resources = $resource->usageRecordSummaries();
+        $this->assertTrue(is_array($resources->data));
+        $this->assertInstanceOf("Stripe\\UsageRecordSummary", $resources->data[0]);
+    }
 }

tests/bootstrap.php

@@ -1,6 +1,6 @@
 <?php
 
-define("MOCK_MINIMUM_VERSION", "0.25.0");
+define("MOCK_MINIMUM_VERSION", "0.26.0");
 define("MOCK_PORT", getenv("STRIPE_MOCK_PORT") ?: 12111);
 
 // Send a request to stripe-mock