RHS1b3 New push.admin.device_registrations.save

src/AblyRest.php

@@ -115,6 +115,14 @@ public function post( $path, $headers = [], $params = [], $returnHeaders = false
         return $this->requestInternal( 'POST', $path, $headers, $params, $returnHeaders, $auth );
     }
 
+    /**
+     * Does a PUT request, automatically injecting auth headers and handling fallback on server failure
+     * @see AblyRest::request()
+     */
+    public function put( $path, $headers = [], $params = [], $returnHeaders = false, $auth = true ) {
+        return $this->requestInternal( 'PUT', $path, $headers, $params, $returnHeaders, $auth );
+    }
+
     /**
      * Does a HTTP request, automatically injecting auth headers and handling fallback on server failure.
      * This method is used internally and `request` is the preferable method to use.

src/Models/DeviceDetails.php

@@ -0,0 +1,52 @@
+<?php
+namespace Ably\Models;
+
+function get($arr, $key) {
+    foreach(explode('.', $key) as $k) {
+        if (is_null($arr) || ! isset($arr[$k])) {
+          return NULL;
+        }
+        $arr = $arr[$k];
+    }
+
+    return $arr;
+}
+
+class DeviceDetails extends BaseOptions {
+
+    /**
+     * @var string
+     */
+    public $id;
+
+    /**
+     * @var string
+     */
+    public $clientId;
+
+    /**
+     * @var string
+     */
+    public $formFactor;
+
+    /**
+     * @var array
+     */
+    public $metadata;
+
+    /**
+     * @var string
+     */
+    public $platform;
+
+    /**
+     * @var \Ably\Models\DevicePushDetails
+     */
+    public $push;
+
+    /**
+     * @var string
+     */
+    public $deviceSecret;
+
+}

src/Models/DevicePushDetails.php

@@ -0,0 +1,21 @@
+<?php
+namespace Ably\Models;
+
+class DevicePushDetails extends BaseOptions {
+
+    /**
+     * @var \Ably\Models\ErrorInfo
+     */
+    public $errorReason;
+
+    /**
+     * @var array
+     */
+    public $recipient;
+
+    /**
+     * @var string
+     */
+    public $state;
+
+}

src/PushAdmin.php

@@ -11,6 +11,7 @@ class PushAdmin {
      */
     public function __construct( AblyRest $ably ) {
         $this->ably = $ably;
+        $this->deviceRegistrations = new PushDeviceRegistrations( $ably );
     }
 
     public function publish ( array $recipient, array $data, $returnHeaders = false ) {

src/PushDeviceRegistrations.php

@@ -0,0 +1,32 @@
+<?php
+namespace Ably;
+
+use Ably\Models\DeviceDetails;
+
+class PushDeviceRegistrations {
+
+    private $ably;
+
+    /**
+     * Constructor
+     * @param AblyRest $ably Ably API instance
+     */
+    public function __construct( AblyRest $ably ) {
+        $this->ably = $ably;
+    }
+
+    /**
+     * Creates or updates the device. Returns a DeviceDetails object.
+     *
+     * @param array $device an array with the device information
+     */
+    public function save ( $device ) {
+        $deviceDetails = new DeviceDetails( $device );
+        $path = '/push/deviceRegistrations/' . $deviceDetails->id;
+        $params = $deviceDetails->toArray();
+        $body = $this->ably->put( $path, [], json_encode($params) );
+        $body = json_decode(json_encode($body), true); // Convert stdClass to array
+        return new DeviceDetails ( $body );
+    }
+
+}

tests/PushDeviceRegistrationsTest.php

@@ -0,0 +1,98 @@
+<?php
+namespace tests;
+use Ably\AblyRest;
+use Ably\Models\DeviceDetails;
+use Ably\Exceptions\AblyException;
+
+require_once __DIR__ . '/factories/TestApp.php';
+
+
+function random_string ( $n ) {
+    return bin2hex(openssl_random_pseudo_bytes($n / 2));
+}
+
+class PushDeviceRegistrationsTest extends \PHPUnit_Framework_TestCase {
+    protected static $testApp;
+    protected static $defaultOptions;
+    protected static $ably;
+
+    public static function setUpBeforeClass() {
+        self::$testApp = new TestApp();
+        self::$defaultOptions = self::$testApp->getOptions();
+        self::$ably = new AblyRest( array_merge( self::$defaultOptions, [
+            'key' => self::$testApp->getAppKeyDefault()->string,
+        ] ) );
+    }
+
+    public static function tearDownAfterClass() {
+        self::$testApp->release();
+    }
+
+    /**
+     * RSH1b3
+     */
+    public function testAdminDeviceRegistrationsSave() {
+        $data = [
+            'id' => random_string(26),
+            'clientId' => random_string(12),
+            'platform' => 'ios',
+            'formFactor' => 'phone',
+            'push' => [
+                'recipient' => [
+                    'transportType' => 'apns',
+                    'deviceToken' => '740f4707bebcf74f9b7c25d48e3358945f6aa01da5ddb387462c7eaf61bb78ad'
+                ]
+            ],
+            'deviceSecret' => random_string(12),
+        ];
+
+        // Create
+        $deviceDetails = self::$ably->push->admin->deviceRegistrations->save($data);
+        $this->assertInstanceOf(DeviceDetails::class, $deviceDetails);
+        $this->assertEquals($deviceDetails->id, $data['id']);
+
+        // Update
+        $new_data = array_merge($data, [ 'formFactor' => 'tablet' ]);
+        $deviceDetails = self::$ably->push->admin->deviceRegistrations->save($new_data);
+
+        // Fail
+        $this->expectException(AblyException::class);
+        $new_data = array_merge($data, [ 'deviceSecret' => random_string(12) ]);
+        self::$ably->push->admin->deviceRegistrations->save($new_data);
+    }
+
+    public function badValues() {
+        $data = [
+            'id' => random_string(26),
+            'clientId' => random_string(12),
+            'platform' => 'ios',
+            'formFactor' => 'phone',
+            'push' => [
+                'recipient' => [
+                    'transportType' => 'apns',
+                    'deviceToken' => '740f4707bebcf74f9b7c25d48e3358945f6aa01da5ddb387462c7eaf61bb78ad'
+                ]
+            ],
+            'deviceSecret' => random_string(12),
+        ];
+
+        return [
+            [
+                array_merge($data, [
+                    'push' => [ 'recipient' => array_merge($data['push']['recipient'], ['transportType' => 'xyz']) ]
+                ])
+            ],
+            [ array_merge($data, [ 'platform' => 'native' ]) ],
+            [ array_merge($data, [ 'formFactor' => 'fridge' ]) ],
+        ];
+    }
+
+    /**
+     * @dataProvider badValues
+     * @expectedException Ably\Exceptions\AblyRequestException
+     */
+    public function testAdminDeviceRegistrationsSaveInvalid($data) {
+        self::$ably->push->admin->deviceRegistrations->save($data);
+    }
+
+}