Added missing segments API calls (v11)

src/Dto/AbstractDto.php

@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace OneSignal\Dto;
+
+interface AbstractDto
+{
+    public function toArray(): array;
+}

src/Dto/Segments/CreateSegment.php

@@ -0,0 +1,48 @@
+<?php
+
+declare(strict_types=1);
+
+namespace OneSignal\Dto\Segments;
+
+use OneSignal\Dto\AbstractDto;
+
+class CreateSegment implements AbstractDto
+{
+    protected string $name;
+
+    protected array $filters = [];
+
+    /**
+     * @param array<int, array> $filters
+     */
+    public function __construct(string $name, array $filters = [])
+    {
+        $this->name = $name;
+        $this->filters = $filters;
+    }
+
+    public function setName(string $name): self
+    {
+        $this->name = $name;
+
+        return $this;
+    }
+
+    /**
+     * @param array<int, array> $filters
+     */
+    public function setFilters(array $filters = []): self
+    {
+        $this->filters = $filters;
+
+        return $this;
+    }
+
+    public function toArray(): array
+    {
+        return [
+            'name' => $this->name,
+            'filters' => $this->filters,
+        ];
+    }
+}

src/Dto/Segments/ListSegments.php

@@ -0,0 +1,49 @@
+<?php
+
+declare(strict_types=1);
+
+namespace OneSignal\Dto\Segments;
+
+use OneSignal\Dto\AbstractDto;
+
+class ListSegments implements AbstractDto
+{
+    protected ?int $limit = null;
+
+    protected ?int $offset = null;
+
+    public function __construct(?int $limit = null, ?int $offset = null)
+    {
+        $this->limit = $limit;
+        $this->offset = $offset;
+    }
+
+    public function setLimit(?int $limit = null): self
+    {
+        $this->limit = $limit;
+
+        return $this;
+    }
+
+    public function setOffset(?int $offset = null): self
+    {
+        $this->offset = $offset;
+
+        return $this;
+    }
+
+    public function toArray(): array
+    {
+        $query = [];
+
+        if ($this->limit !== null) {
+            $query['limit'] = $this->limit;
+        }
+
+        if ($this->offset !== null) {
+            $query['offset'] = $this->offset;
+        }
+
+        return $query;
+    }
+}

src/OneSignal.php

@@ -105,6 +105,10 @@ public function api(string $name)
             case 'notifications':
                 $api = new Notifications($this, $this->resolverFactory);
 
+                break;
+            case 'segments':
+                $api = new Segments($this);
+
                 break;
             default:
                 throw new InvalidArgumentException("Undefined api instance called: '$name'.");

src/Segments.php

@@ -0,0 +1,65 @@
+<?php
+
+declare(strict_types=1);
+
+namespace OneSignal;
+
+use OneSignal\Dto\Segments\CreateSegment;
+use OneSignal\Dto\Segments\ListSegments;
+
+class Segments extends AbstractApi
+{
+    public function __construct(OneSignal $client)
+    {
+        parent::__construct($client);
+    }
+
+    /**
+     * Get information about all segments.
+     *
+     * Application authentication key and ID must be set.
+     */
+    public function list(ListSegments $listSegmentsDto): array
+    {
+        $app_id = $this->client->getConfig()->getApplicationId();
+
+        $request = $this->createRequest('GET', '/apps/'.$app_id.'/segments?'.http_build_query($listSegmentsDto->toArray()));
+        $request = $request->withHeader('Authorization', "Basic {$this->client->getConfig()->getApplicationAuthKey()}");
+
+        return $this->client->sendRequest($request);
+    }
+
+    /**
+     * Create new segment with provided data.
+     *
+     * Application authentication key and ID must be set.
+     */
+    public function create(CreateSegment $createSegmentDto): array
+    {
+        $app_id = $this->client->getConfig()->getApplicationId();
+
+        $request = $this->createRequest('POST', '/apps/'.$app_id.'/segments');
+        $request = $request->withHeader('Authorization', "Basic {$this->client->getConfig()->getApplicationAuthKey()}");
+        $request = $request->withHeader('Content-Type', 'application/json');
+        $request = $request->withBody($this->createStream($createSegmentDto->toArray()));
+
+        return $this->client->sendRequest($request);
+    }
+
+    /**
+     * Delete segment.
+     *
+     * Application authentication key and ID must be set.
+     *
+     * @param string $id Segment ID
+     */
+    public function delete(string $id): array
+    {
+        $app_id = $this->client->getConfig()->getApplicationId();
+
+        $request = $this->createRequest('DELETE', '/apps/'.$app_id.'/segments/'.$id);
+        $request = $request->withHeader('Authorization', "Basic {$this->client->getConfig()->getApplicationAuthKey()}");
+
+        return $this->client->sendRequest($request);
+    }
+}