From ff1e349b31a3dda6c3120d364fdb88304aa69fcd Mon Sep 17 00:00:00 2001
From: MaksimKutishchev <max@amopro.ru>
Date: Mon, 2 Sep 2024 22:44:54 +0400
Subject: [PATCH] Feature: add event types

---
 src/AmoCRM/Client/AmoCRMApiClient.php         |  14 +++
 .../Collections/EventTypesCollections.php     |  28 +++++
 src/AmoCRM/EntitiesServices/EventTypes.php    | 107 ++++++++++++++++++
 src/AmoCRM/Helpers/EntityTypesInterface.php   |   1 +
 src/AmoCRM/Models/EventTypeModel.php          |  83 ++++++++++++++
 5 files changed, 233 insertions(+)
 create mode 100644 src/AmoCRM/Collections/EventTypesCollections.php
 create mode 100644 src/AmoCRM/EntitiesServices/EventTypes.php
 create mode 100644 src/AmoCRM/Models/EventTypeModel.php

diff --git a/src/AmoCRM/Client/AmoCRMApiClient.php b/src/AmoCRM/Client/AmoCRMApiClient.php
index dfe9e91..0b03d96 100644
--- a/src/AmoCRM/Client/AmoCRMApiClient.php
+++ b/src/AmoCRM/Client/AmoCRMApiClient.php
@@ -18,6 +18,7 @@
 use AmoCRM\EntitiesServices\CustomFields;
 use AmoCRM\EntitiesServices\EntityFiles;
 use AmoCRM\EntitiesServices\EntityNotes;
+use AmoCRM\EntitiesServices\EventTypes;
 use AmoCRM\EntitiesServices\Files;
 use AmoCRM\EntitiesServices\Sources;
 use AmoCRM\EntitiesServices\EntitySubscriptions;
@@ -565,6 +566,19 @@ public function events(): Events
         return new Events($request);
     }
 
+    /**
+     * Метод вернет объект событий
+     *
+     * @return EventTypes
+     * @throws AmoCRMMissedTokenException
+     */
+    public function eventTypes(): EventTypes
+    {
+        $request = $this->buildRequest();
+
+        return new EventTypes($request);
+    }
+
     /**
      * Метод вернет объект хуков
      *
diff --git a/src/AmoCRM/Collections/EventTypesCollections.php b/src/AmoCRM/Collections/EventTypesCollections.php
new file mode 100644
index 0000000..1db8513
--- /dev/null
+++ b/src/AmoCRM/Collections/EventTypesCollections.php
@@ -0,0 +1,28 @@
+<?php
+
+namespace AmoCRM\Collections;
+
+use AmoCRM\Collections\Interfaces\HasPagesInterface;
+use AmoCRM\Collections\Traits\PagesTrait;
+use AmoCRM\Models\EventTypeModel;
+
+/**
+ * Class EventTypesCollections
+ *
+ * @package AmoCRM\Collections
+ *
+ * @method null|EventTypeModel current()
+ * @method null|EventTypeModel last()
+ * @method null|EventTypeModel first()
+ * @method null|EventTypeModel offsetGet($offset)
+ * @method void offsetSet($offset, EventTypeModel $value)
+ * @method EventsCollections prepend(EventTypeModel $value)
+ * @method EventsCollections add(EventTypeModel $value)
+ * @method null|EventTypeModel getBy($key, $value)
+ */
+class EventTypesCollections extends BaseApiCollection implements HasPagesInterface
+{
+    use PagesTrait;
+
+    public const ITEM_CLASS = EventTypeModel::class;
+}
diff --git a/src/AmoCRM/EntitiesServices/EventTypes.php b/src/AmoCRM/EntitiesServices/EventTypes.php
new file mode 100644
index 0000000..d2beb23
--- /dev/null
+++ b/src/AmoCRM/EntitiesServices/EventTypes.php
@@ -0,0 +1,107 @@
+<?php
+
+namespace AmoCRM\EntitiesServices;
+
+use AmoCRM\Client\AmoCRMApiClient;
+use AmoCRM\Client\AmoCRMApiRequest;
+use AmoCRM\Collections\BaseApiCollection;
+use AmoCRM\Collections\EventsCollections;
+use AmoCRM\Collections\EventTypesCollections;
+use AmoCRM\Exceptions\NotAvailableForActionException;
+use AmoCRM\Filters\BaseEntityFilter;
+use AmoCRM\Helpers\EntityTypesInterface;
+use AmoCRM\Models\BaseApiModel;
+use AmoCRM\Models\EventTypeModel;
+
+/**
+ * Class EventTypes
+ *
+ * @package AmoCRM\EntitiesServices
+ *
+ * @method null|EventsCollections get(BaseEntityFilter $filter = null, array $with = [])
+ */
+class EventTypes extends BaseEntity
+{
+    /**
+     * @var string
+     */
+    protected $method = 'api/v' . AmoCRMApiClient::API_VERSION . '/' . EntityTypesInterface::EVENTS . '/types';
+
+    /**
+     * @var string
+     */
+    protected $collectionClass = EventTypesCollections::class;
+
+    /**
+     * @var string
+     */
+    public const ITEM_CLASS = EventTypeModel::class;
+
+    /**
+     * @param array $response
+     *
+     * @return array
+     */
+    protected function getEntitiesFromResponse(array $response): array
+    {
+        $entities = $response[AmoCRMApiRequest::EMBEDDED][EntityTypesInterface::EVENTS_TYPES] ?? [];
+        
+        return $entities;
+    }
+
+    /**
+     * @param BaseApiModel $model
+     *
+     * @return BaseApiModel
+     * @throws NotAvailableForActionException
+     */
+    public function addOne(BaseApiModel $model): BaseApiModel
+    {
+        throw new NotAvailableForActionException('Method not available for this entity');
+    }
+
+    /**
+     * @param BaseApiCollection $collection
+     *
+     * @return BaseApiCollection
+     * @throws NotAvailableForActionException
+     */
+    public function add(BaseApiCollection $collection): BaseApiCollection
+    {
+        throw new NotAvailableForActionException('Method not available for this entity');
+    }
+
+    /**
+     * @param BaseApiCollection $collection
+     *
+     * @return BaseApiCollection
+     * @throws NotAvailableForActionException
+     */
+    public function update(BaseApiCollection $collection): BaseApiCollection
+    {
+        throw new NotAvailableForActionException('Method not available for this entity');
+    }
+
+    /**
+     * @param BaseApiModel $apiModel
+     *
+     * @return BaseApiModel
+     * @throws NotAvailableForActionException
+     */
+    public function updateOne(BaseApiModel $apiModel): BaseApiModel
+    {
+        throw new NotAvailableForActionException('Method not available for this entity');
+    }
+
+    /**
+     * @param BaseApiModel $apiModel
+     * @param array $with
+     *
+     * @return BaseApiModel
+     * @throws NotAvailableForActionException
+     */
+    public function syncOne(BaseApiModel $apiModel, $with = []): BaseApiModel
+    {
+        throw new NotAvailableForActionException('Method not available for this entity');
+    }
+}
diff --git a/src/AmoCRM/Helpers/EntityTypesInterface.php b/src/AmoCRM/Helpers/EntityTypesInterface.php
index 2a09c24..a33bd8e 100644
--- a/src/AmoCRM/Helpers/EntityTypesInterface.php
+++ b/src/AmoCRM/Helpers/EntityTypesInterface.php
@@ -20,6 +20,7 @@ interface EntityTypesInterface
     public const CUSTOMERS = 'customers';
     public const CUSTOMERS_TRANSACTIONS = 'transactions';
     public const EVENTS = 'events';
+    public const EVENTS_TYPES = 'events_types';
     public const NOTES = 'notes';
     public const TAGS = 'tags';
     public const TASKS = 'tasks';
diff --git a/src/AmoCRM/Models/EventTypeModel.php b/src/AmoCRM/Models/EventTypeModel.php
new file mode 100644
index 0000000..762ae05
--- /dev/null
+++ b/src/AmoCRM/Models/EventTypeModel.php
@@ -0,0 +1,83 @@
+<?php
+
+namespace AmoCRM\Models;
+
+use InvalidArgumentException;
+
+class EventTypeModel extends BaseApiModel
+{
+    /** @var string */
+    protected $key;
+    /** @var int */
+    protected $type;
+    /** @var string */
+    protected $lang;
+    
+    public function getKey(): string
+    {
+        return $this->key;
+    }
+    
+    public function setKey(string $key): EventTypeModel
+    {
+        $this->key = $key;
+        
+        return $this;
+    }
+    
+    public function getType(): int
+    {
+        return $this->type;
+    }
+    
+    public function setType(int $type): EventTypeModel
+    {
+        $this->type = $type;
+        
+        return $this;
+    }
+    
+    public function getLang(): string
+    {
+        return $this->lang;
+    }
+    
+    public function setLang(string $lang): EventTypeModel
+    {
+        $this->lang = $lang;
+        
+        return $this;
+    }
+    
+    public static function fromArray(array $eventType): EventTypeModel
+    {
+        if (empty($eventType['key'])) {
+            throw new InvalidArgumentException('EventType key is empty in ' . \json_encode($eventType, JSON_THROW_ON_ERROR));
+        }
+        
+        $eventTypeModel = new static();
+        
+        $eventTypeModel->setKey($eventType['key'])
+            ->setType($eventType['type'])
+            ->setLang($eventType['lang']);
+        
+        return $eventTypeModel;
+    }
+    
+    /**
+     * @inheritDoc
+     */
+    public function toArray(): array
+    {
+        return [
+            'key' => $this->getKey(),
+            'type' => $this->getType(),
+            'lang' => $this->getLang(),
+        ];
+    }
+    
+    public function toApi(?string $requestId = "0"): array
+    {
+        return [];
+    }
+}