fix offsetSet

.gitignore

@@ -1 +1,3 @@
-/vendor
+!.gitignore
+composer.phar
+vendor

README.md

@@ -1,5 +1,5 @@
-# Колпачный фреймворк для ВКонтакте
+# PHP-фреймворк ВКонтакте
-Развивается как многопоточный фреймворк с поддержкой всех возможностей API ВКонтакте, а так же не добавленных, но необходимых функций, работу с большим количеством роботов под разными сессиями, поддерживающий PSR-спецификацию и полностью покрытый тестами
+Многопоточный фреймворк с поддержкой всех возможностей API ВКонтакте
 
 ### Установка:
 ```sh

composer.json

@@ -1,32 +1,33 @@
 {
     "name": "mirzaev/vk",
     "type": "framework",
-    "description": "Фреймворк VK API",
+    "description": "Framework for vk.com API",
+    "readme": "README.md",
     "keywords": [
         "vk",
         "api"
     ],
-    "homepage": "https://git.hood.su/mirzaev/vk",
+    "homepage": "https://git.mirzaev.sexy/mirzaev/vk",
     "license": "WTFPL",
     "authors": [
         {
             "name": "Arsen Mirzaev Tatyano-Muradovich",
-            "email": "red@hood.su",
+            "email": "arsen@mirzaev.sexy",
-            "homepage": "https://hood.su/mirzaev",
+            "homepage": "https://mirzaev.sexy/mirzaev",
             "role": "Programmer"
         }
     ],
     "support": {
-        "docs": "https://git.hood.su/mirzaev/vk/manual",
+        "docs": "https://git.mirzaev.sexy/mirzaev/vk/wiki",
-        "issues": "https://git.hood.su/mirzaev/vk/issues"
+        "issues": "https://git.mirzaev.sexy/mirzaev/vk/issues"
     },
     "require": {
-        "php": "~8.0",
+        "php": "~8.1",
         "psr/log": "~1.0",
-        "mirzaev/accounts": "~0.1.x-dev",
+        "mirzaev/accounts": "~1.2.0",
         "monolog/monolog": "~1.6",
         "jasny/error-handler": "~0.2",
-        "guzzlehttp/guzzle": "~7.2"
+        "guzzlehttp/guzzle": "~7.5"
     },
     "require-dev": {
         "phpunit/phpunit": "~9.5"

mirzaev/vk/system/api/callback.php

@@ -2,7 +2,7 @@
 
 // declare(strict_types=1);
 
-// namespace Hood\VK\API;
+// namespace mirzaev\vk\API;
 
 // class CallBack extends CallBackAbstract
 // {

mirzaev/vk/system/api/longpoll.php

@@ -7,7 +7,8 @@ namespace mirzaev\vk\api;
 use Exception;
 
 use mirzaev\vk\core,
-    mirzaev\vk\robots\robot;
+    mirzaev\vk\robots\robot,
+    mirzaev\vk\robots\group;
 
 /**
  * LongPoll
@@ -25,7 +26,7 @@ use mirzaev\vk\core,
  * @see https://vk.com/dev/groups.setLongPollSettings
  *
  * @package mirzaev\vk\api
- * @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
+ * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
  *
  * @todo Добавить обработку ошибок ($request['errors];)
  */
@@ -36,14 +37,14 @@ final class longpoll
      *
      * @see $this->get()
      */
-    private string $key;
+    private readonly string $key;
 
     /**
      * Сервер (URL)
      *
      * @see $this->get()
      */
-    private string $server;
+    private readonly string $server;
 
     /**
      * Идентификатор последнего события
@@ -59,7 +60,7 @@ final class longpoll
      *
      * $robot Робот
      */
-    public function __construct(private robot $robot)
+    public function __construct(private robot&group $robot)
     {
         // Инициализация
         if (empty($robot->id)) throw new Exception('Необходимо указать идентификатор ВКонтакте');

mirzaev/vk/system/api/methods/messages.php

@@ -11,6 +11,18 @@ use mirzaev\vk\robots\robot;
 use mirzaev\vk\api\data;
 use mirzaev\vk\robots\group;
 
+/**
+ * Режимы отправки сообщений
+ */
+enum mode
+{
+    /** Быстро - случайный идентификатор (умножение на rand()) */
+    case random;
+
+    /** Надёжно - проверка отправки (поиск сообщения через messages.getById) */
+    case search;
+}
+
 /**
  * Сообщение
  *
@@ -20,16 +32,16 @@ use mirzaev\vk\robots\group;
  * @see https://vk.com/dev/messages.getById
  *
  * @package mirzaev\vk\api
- * @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
+ * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
  *
  * @todo Доработать строгий режим отправки: проверку сообщения в беседе (не имеет ID сообщений)
  */
 final class messages extends method
 {
     /**
-     * @var int $mode Режим отправки
+     * @var mode $mode Режим отправки сообщений
      */
-    protected int $mode = 1;
+    protected mode $mode = mode::random;
 
     /**
      * @var array[int] Сообщения для пересылки
@@ -119,8 +131,9 @@ final class messages extends method
         // Идентификатор
         $random_id = time();
 
-        if ($this->mode = 1) {
+        if ($this->mode === mode::random) {
-            // Перемножение (по умолчанию)
+            // Быстрая отправка сообщения
+
             $random_id *= rand();
         }
 
@@ -130,7 +143,7 @@ final class messages extends method
         // Цель отправки
         $this->robot->api->destination($destination);
 
-        // Инициализация идентификатора (защита от повторных отправок) в настройках API
+        // Инициализация идентификатора сообщения (защита от повторных отправок) в настройках API
         $this->robot->api['random_id'] = $random_id;
 
         // Инициализация текста в настройках API
@@ -165,8 +178,8 @@ final class messages extends method
             throw new Exception('Вконтакте: ' . $request->error->error_msg, $request->error->error_code);
         }
 
-        if ($this->mode >= 2) {
+        if ($this->mode === mode::search) {
-            // Если установлен режим 2 (усиленная проверка отправленного сообщения)
+            // Надёжная доставка сообщения
 
             if (!empty($request["response"])) {
                 // Ответ получен
@@ -177,7 +190,6 @@ final class messages extends method
                 // Запрашиваемые сообщения
                 $this->robot->api['message_ids'] = $request["response"];
 
-                // Запрос
                 if ($this->robot->browser->request('POST', 'messages.getById', ['form_params' => $this->robot->api->settings])['response']['count'] === 0) {
                     // Сообщения не существует
                     //!!!!!!!!!!!!!!!!!!!!!!!!!!!

mirzaev/vk/system/api/methods/method.php

@@ -15,7 +15,7 @@ use mirzaev\vk\robots\robot;
  * @method protected static delete(string $url, ...$params) Удалить
  *
  * @package mirzaev\vk\api\methods
- * @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
+ * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
  */
 abstract class method
 {

mirzaev/vk/system/api/methods/photos.php

@@ -20,7 +20,7 @@ use mirzaev\accounts\vk as account;
  * @see https://vk.com/dev/messages.getById
  *
  * @package mirzaev\vk\api\methods
- * @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
+ * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
  *
  * @todo Добавить обработку ошибок ($request['errors];)
  */

mirzaev/vk/system/api/settings.php

@@ -21,7 +21,7 @@ use mirzaev\vk\robots\robot;
  * 1. Создать __isset(), __unset()
  *
  * @package mirzaev\vk\api
- * @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
+ * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
  */
 class settings implements ArrayAccess
 {
@@ -219,7 +219,7 @@ class settings implements ArrayAccess
     /**
      * Записать по смещению
      */
-    public function offsetSet(mixed $offset, mixed $value): mixed
+    public function offsetSet(mixed $offset, mixed $value): void
     {
         if (isset($this->settings)) {
             if (strcasecmp($offset, 'settings') === 0) {
@@ -236,21 +236,27 @@ class settings implements ArrayAccess
                 if (is_array($value)) {
                     // Жесткая запись
 
-                    return $this->settings['attachments'] = $value;
+                    $this->settings['attachments'] = $value;
+
+                    return;
                 }
 
                 if (empty($this->settings['attachments']) || count($this->settings['attachments']) < 10) {
                     // Записано менее чем 10 вложений (от 0 до 9)
 
                     // Запись (конкатенация)
-                    return $this->settings['attachments'][] = $value;
+                    $this->settings['attachments'][] = $value;
+
+                    return;
                 }
 
                 throw new Exception('Превышено ограничение на 10 вложений', 500);
             } else {
                 // Запись по ключу или смещению
 
-                return $this->settings[$offset] = $value;
+                $this->settings[$offset] = $value;
+
+                return;
             }
         }
 

mirzaev/vk/system/core.php

@@ -24,7 +24,7 @@ use exception;
  * @method public function get($id = null) Чтение из реестра
  *
  * @package mirzaev\vk
- * @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
+ * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
  */
 final class core
 {
@@ -45,22 +45,22 @@ final class core
      *
      * Используется в логировании
      */
-    private string $timezone;
+    private readonly string $timezone;
 
     /**
      * Путь до корня проекта
      */
-    private string $path_root;
+    private readonly string $path_root;
 
     /**
      * Путь до папки журналов
      */
-    private string $path_logs;
+    private readonly string $path_logs;
 
     /**
      * Путь до временной папки
      */
-    private string $path_temp;
+    private readonly string $path_temp;
 
     /**
      * Запись в журнал

mirzaev/vk/system/loggers/jasmo.php

@@ -21,7 +21,7 @@ use mirzaev\vk\core,
  * @see Jasny\ErrorHandler
  *
  * @package mirzaev\vk\loggers
- * @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
+ * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
  */
 final class jasmo extends logger
 {

mirzaev/vk/system/loggers/logger.php

@@ -8,7 +8,7 @@ namespace mirzaev\vk\loggers;
  * Абстрактный класс журналиста
  *
  * @package mirzaev\vk\loggers
- * @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
+ * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
  */
 abstract class logger
 {

mirzaev/vk/system/robots/group.php

@@ -22,7 +22,7 @@ use mirzaev\vk\robots\robot,
  * @method public function __isset($name) Проверка на инициализированность свойства
  *
  * @package mirzaev\vk\robots
- * @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
+ * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
  */
 final class group extends robot
 {
@@ -38,8 +38,8 @@ final class group extends robot
      * @param string|null $key Ключ
      */
     public function __construct(
-        protected int|null $id = null,
+        protected ?int $id = null,
-        protected string|null $key = null
+        protected ?string $key = null
     ) {
         parent::__construct($id, $key);
 

mirzaev/vk/system/robots/robot.php

@@ -39,39 +39,39 @@ use GuzzleHttp\Client as browser;
  * @method public function __toString() Конвертация в строку
  *
  * @package mirzaev\vk\robots
- * @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
+ * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
  */
 abstract class robot
 {
     /**
-     * Сессия
+     * @var int $session Сессия
      */
-    protected int $session;
+    protected readonly int $session;
 
     /**
-     * Аккаунт
+     * @var account $account Аккаунт ВКонтакте
      */
-    private account $account;
+    private readonly account $account;
 
     /**
-     * $messages_mode Режим отправки сообщений
+     * @var api $api API ВКонтакте
      */
-    protected int $messages_mode = 1;
+    protected readonly api $api;
 
     /**
-     * @var api API ВКонтакте
+     * @var browser $browser Браузер
      */
-    protected api $api;
+    protected readonly browser $browser;
 
     /**
      * Конструктор
      *
-     * @param int|null $id Идентификатор
+     * @param int|null $id Идентификатор робота
-     * @param string|null $key Ключ
+     * @param string|null $key Ключ API ВКонтакте
      */
     public function __construct(
-        protected int|null $id = null,
+        protected ?int $id = null,
-        protected string|null $key = null
+        protected ?string $key = null
     ) {
         // Инициализация ядра
         $core = core::init();
@@ -183,14 +183,13 @@ abstract class robot
     public function __set(string $name, mixed $value): void
     {
         match ($name) {
-            'id' => isset($this->id) ? throw new Exception('Запрещено перезаписывать идентификатор', 500) : $this->id = (int) $value,
+            'id' => empty($this->id) ?: $this->id = $value,
-            'session' => isset($this->session) ? throw new Exception('Запрещено перезаписывать сессию', 500) : $this->session = (int) $value,
+            'session' => empty($this->session) ?: $this->session = $value,
             'key' => $this->key((string) $value),
             'account' => $this->account($value),
             'api' => $this->api(),
-            'browser' => isset($this->browser) ? throw new Exception('Запрещено перезаписывать браузер', 500) : $this->browser = $value,
+            'browser' => empty($this->browser) ?: $this->browser = $value,
-            'messages_new' => $this->messages_new = (int) $value,
+            'messages_new' => $this->messages_new = (int) $value
-            default => throw new Exception("Свойство $name не найдено", 404)
         };
     }
 
@@ -219,23 +218,16 @@ abstract class robot
     }
 
     /**
-     * Проверить свойство на инициализированность
+     * Проверить на инициализированность
      *
-     * @param string $name Название
+     * @param mixed $name Название
-     *
-     * @return mixed
      */
     public function __isset(string $name): bool
     {
         return match ($name) {
             'id' => isset($this->id),
-            'session' => isset($this->session),
             'key' => isset($this->key),
-            'account' => isset($this->account),
+            default => false
-            'api' => isset($this->api),
-            'browser' => isset($this->browser),
-            'messages_new' => isset($this->messages_new),
-            default => throw new Exception("Свойство $name не найдено", 404)
         };
     }
 

mirzaev/vk/system/robots/user.php

@@ -12,7 +12,7 @@ use mirzaev\accounts\vk as account;
  * Робот-пользователь
  *
  * @package mirzaev\vk\robots
- * @author Arsen Mirzaev Tatyano-Muradovich <red@hood.su>
+ * @author Arsen Mirzaev Tatyano-Muradovich <arsen@mirzaev.sexy>
  */
 final class user extends robot
 {
@@ -23,8 +23,8 @@ final class user extends robot
      * @param string|null $key Ключ
      */
     public function __construct(
-        protected int|null $id = null,
+        protected readonly int|null $id = null,
-        protected string|null $key = null
+        protected readonly string|null $key = null
     ) {
         parent::__construct($id, $key);