telegram-bot-php / core

src/Entities/Response.php

Spacing +1 added lines, -1 removed lines

@@ -42,7 +42,7 @@
         $data['raw_data'] = $data;
         $this->response = $data;
 
-        $is_ok = (bool)($data['ok'] ?? false);
+        $is_ok = (bool) ($data['ok'] ?? false);
         $result = $data['result'] ?? null;
 
         if ($is_ok) {

src/Entities/UserProfilePhotos.php

Spacing +1 added lines, -1 removed lines

@@ -37,7 +37,7 @@
 
         if ($these_photos = $this->getProperty('photos')) {
             foreach ($these_photos as $photos) {
-                $all_photos[] = array_map(function ($photo) {
+                $all_photos[] = array_map(function($photo) {
                     return new PhotoSize($photo);
                 }, $photos);
             }

src/Traits/EnvironmentsTrait.php

Braces +3 added lines, -1 removed lines

@@ -50,7 +50,9 @@
      */
     protected function getEnvToken(string $file): string|null
     {
-        if (!file_exists($file)) return null;
+        if (!file_exists($file)) {
+            return null;
+        }
         return $_ENV['TELEGRAM_BOT_TOKEN'] ?? null;
     }
 

Indentation +4 added lines, -4 removed lines

@@ -27,7 +27,7 @@ 
      *
      * @return string|null
      */
-  protected static function guessEnvPath(): string|null
+    protected static function guessEnvPath(): string|null
     {
         $defaultEnvPaths = [
             getcwd() . '/.env',
@@ -45,10 +45,10 @@ 
     }
 
     protected static function tryAutoloadEnv(): void {
-      $envPath = static::guessEnvPath();
-      if ($envPath !== null) {
+        $envPath = static::guessEnvPath();
+        if ($envPath !== null) {
         (new Dotenv())->load($envPath);
-      }
+        }
     }
 
     /**

src/Telegram.php

Braces +6 added lines, -2 removed lines

@@ -107,7 +107,9 @@ 
     public function fetchWith(UpdateHandler $update_handler, Update|null $update = null): void
     {
         if (is_subclass_of($update_handler, UpdateHandler::class)) {
-            if ($update === null) $update = self::getUpdate();
+            if ($update === null) {
+                $update = self::getUpdate();
+            }
             $update_handler->resolve($update);
         }
     }
@@ -120,7 +122,9 @@ 
     public static function getUpdate(): Update|null
     {
         $input = self::getInput();
-        if (empty($input)) return null;
+        if (empty($input)) {
+            return null;
+        }
         return Telegram::processUpdate($input, self::getApiToken());
     }
 

src/TelegramLog.php

Spacing +1 added lines, -1 removed lines

@@ -115,7 +115,7 @@
     {
         // Get the correct logger instance.
         $logger = null;
-        if (in_array($name, ['emergency', 'alert', 'critical', 'error', 'warning', 'notice', 'info', 'debug',], true)) {
+        if (in_array($name, ['emergency', 'alert', 'critical', 'error', 'warning', 'notice', 'info', 'debug', ], true)) {
             $logger = self::$logger;
         } elseif ($name === 'update') {
             $logger = self::$update_logger;

src/UpdateHandler.php

Indentation +217 added lines, -217 removed lines

@@ -17,237 +17,237 @@
  */
 class UpdateHandler extends Telegram implements HandlerInterface {
 
-   use HandlerTrait;
-
-   /**
-    * @var ?Update
-    */
-   protected ?Update $update;
-
-   /**
-    * @var Plugin[]
-    */
-   private array $plugins = [];
-
-   /**
-    * @var bool
-    */
-   private bool $active_spreader = false;
-
-   /**
-    * The default configuration of the webhook.
-    *
-    * @var array
-    */
-   private array $config = [
-      'autoload_env_file' => false,
-      'env_file_path' => null,
-   ];
-
-   /**
-    * Filter incoming updates.
-    *
-    * @var array
-    */
-   private array $filterIncomingUpdates = [];
-
-   /**
-    * Webhook constructor.
-    *
-    * @param string $api_token The API key of the bot. Leave it blank for autoload from .env file.
-    */
-   public function __construct(string $api_token = '') {
-      parent::__construct($api_token);
-
-      if (!Telegram::validateToken(self::getApiToken())) {
-         throw new InvalidBotTokenException();
-      }
-   }
-
-   /**
-    * Resolve the request on single plugin.
-    *
-    * @param Plugin $plugin The plugin to work with
-    * @param ?Update $update The custom to work with
-    * @param array $config The configuration of the receiver
-    * @return void
-    */
-   public static function resolveOn(Plugin $plugin, Update $update = null, array $config = []): void {
-      // TODO: Implement resolveOn() method.
-   }
-
-   /**
-    * Add plugins to the receiver
-    *
-    * @param Plugin[]|array $plugins
-    * @retrun void
-    */
-   public function addPlugins(Plugin|array $plugins): UpdateHandler {
-      if (is_object($plugins)) {
-         $plugins = [$plugins];
-      }
-
-      foreach ($plugins as $plugin) {
-         if (!is_subclass_of($plugin, Plugin::class)) {
+    use HandlerTrait;
+
+    /**
+     * @var ?Update
+     */
+    protected ?Update $update;
+
+    /**
+     * @var Plugin[]
+     */
+    private array $plugins = [];
+
+    /**
+     * @var bool
+     */
+    private bool $active_spreader = false;
+
+    /**
+     * The default configuration of the webhook.
+     *
+     * @var array
+     */
+    private array $config = [
+        'autoload_env_file' => false,
+        'env_file_path' => null,
+    ];
+
+    /**
+     * Filter incoming updates.
+     *
+     * @var array
+     */
+    private array $filterIncomingUpdates = [];
+
+    /**
+     * Webhook constructor.
+     *
+     * @param string $api_token The API key of the bot. Leave it blank for autoload from .env file.
+     */
+    public function __construct(string $api_token = '') {
+        parent::__construct($api_token);
+
+        if (!Telegram::validateToken(self::getApiToken())) {
+            throw new InvalidBotTokenException();
+        }
+    }
+
+    /**
+     * Resolve the request on single plugin.
+     *
+     * @param Plugin $plugin The plugin to work with
+     * @param ?Update $update The custom to work with
+     * @param array $config The configuration of the receiver
+     * @return void
+     */
+    public static function resolveOn(Plugin $plugin, Update $update = null, array $config = []): void {
+        // TODO: Implement resolveOn() method.
+    }
+
+    /**
+     * Add plugins to the receiver
+     *
+     * @param Plugin[]|array $plugins
+     * @retrun void
+     */
+    public function addPlugins(Plugin|array $plugins): UpdateHandler {
+        if (is_object($plugins)) {
+            $plugins = [$plugins];
+        }
+
+        foreach ($plugins as $plugin) {
+            if (!is_subclass_of($plugin, Plugin::class)) {
             throw new \RuntimeException(
-               sprintf('The plugin %s must be an instance of %s', get_class($plugin), Plugin::class)
+                sprintf('The plugin %s must be an instance of %s', get_class($plugin), Plugin::class)
             );
-         }
+            }
 
-         $reflection = Toolkit::reflectionClass($plugin);
-         $this->plugins[] = [
+            $reflection = Toolkit::reflectionClass($plugin);
+            $this->plugins[] = [
             'class' => $plugin,
             'initialized' => is_object($plugin),
-         ];
-      }
-
-      return $this;
-   }
-
-   /**
-    * Updates the filter for incoming updates.
-    *
-    * @param array $filter
-    * @return void
-    */
-   public function filterIncomingUpdates(array $filter): void {
-      $this->filterIncomingUpdates = $filter;
-   }
-
-   /**
-    * Do not process updates that match the filter.
-    *
-    * @param Update $update
-    * @return bool
-    */
-   private function isFiltered(Update $update): bool {
-      if (empty($this->filterIncomingUpdates)) {
-         return false;
-      }
-
-      foreach ($this->filterIncomingUpdates as $type => $value) {
-         if (is_int($type)) {
+            ];
+        }
+
+        return $this;
+    }
+
+    /**
+     * Updates the filter for incoming updates.
+     *
+     * @param array $filter
+     * @return void
+     */
+    public function filterIncomingUpdates(array $filter): void {
+        $this->filterIncomingUpdates = $filter;
+    }
+
+    /**
+     * Do not process updates that match the filter.
+     *
+     * @param Update $update
+     * @return bool
+     */
+    private function isFiltered(Update $update): bool {
+        if (empty($this->filterIncomingUpdates)) {
+            return false;
+        }
+
+        foreach ($this->filterIncomingUpdates as $type => $value) {
+            if (is_int($type)) {
             if ($update->getUpdateType() === $value) {
-               return true;
+                return true;
             }
-         } elseif (is_string($type)) {
+            } elseif (is_string($type)) {
             if ($update->getUpdateType() === $type) {
-               if (is_callable($value)) {
-                  return $value($update);
-               } elseif (is_bool($value)) {
-                  return $value;
-               }
-               throw new \InvalidArgumentException('The value of the filter must be a callable or a boolean');
+                if (is_callable($value)) {
+                    return $value($update);
+                } elseif (is_bool($value)) {
+                    return $value;
+                }
+                throw new \InvalidArgumentException('The value of the filter must be a callable or a boolean');
+            }
             }
-         }
-         throw new \InvalidArgumentException('Invalid filter');
-      }
-
-      return false;
-   }
-
-   /**
-    * Resolve the request.
-    *
-    * @param ?Update $update The custom to work with
-    * @param array $config The configuration of the receiver
-    *
-    * @retrun void
-    */
-   public function resolve(Update|null $update = null, array $config = []): void {
-      $this->update = $update ?? Telegram::getUpdate();
-
-      if (empty($this->update)) {
-         TelegramLog::error('The update is empty, the request is not processed');
-         return;
-      }
-
-      if ($this->isFiltered($this->update)) {
-         TelegramLog::notice('The update is filtered, the request is not processed');
-         return;
-      }
-
-      if (!method_exists($this, '__process')) {
-         throw new \RuntimeException('The method __process does not exist');
-      }
-
-      if (is_array($config)) {
-         $this->updateConfiguration($config);
-      }
-
-      putenv('TG_CURRENT_UPDATE=' . $this->update->getRawData(false));
-
-      $this->__process($this->update);
-      $this->loadPlugins($this->plugins);
-   }
-
-   /**
-    * Update the configuration
-    *
-    * @param array $configuration
-    * @return void
-    */
-   public function updateConfiguration(array $configuration): void {
-      $this->config = array_merge($this->config, $configuration);
-   }
-
-   /**
-    * Match the update with the given plugins
-    *
-    * @param Plugin[]|array $plugins
-    * @return void
-    */
-   private function loadPlugins(array $plugins): void {
-      $update = $update ?? ($this->update ?? Telegram::getUpdate());
-
-      foreach ($plugins as $plugin) {
-         if (!is_subclass_of($plugin['class'], Plugin::class)) {
+            throw new \InvalidArgumentException('Invalid filter');
+        }
+
+        return false;
+    }
+
+    /**
+     * Resolve the request.
+     *
+     * @param ?Update $update The custom to work with
+     * @param array $config The configuration of the receiver
+     *
+     * @retrun void
+     */
+    public function resolve(Update|null $update = null, array $config = []): void {
+        $this->update = $update ?? Telegram::getUpdate();
+
+        if (empty($this->update)) {
+            TelegramLog::error('The update is empty, the request is not processed');
+            return;
+        }
+
+        if ($this->isFiltered($this->update)) {
+            TelegramLog::notice('The update is filtered, the request is not processed');
+            return;
+        }
+
+        if (!method_exists($this, '__process')) {
+            throw new \RuntimeException('The method __process does not exist');
+        }
+
+        if (is_array($config)) {
+            $this->updateConfiguration($config);
+        }
+
+        putenv('TG_CURRENT_UPDATE=' . $this->update->getRawData(false));
+
+        $this->__process($this->update);
+        $this->loadPlugins($this->plugins);
+    }
+
+    /**
+     * Update the configuration
+     *
+     * @param array $configuration
+     * @return void
+     */
+    public function updateConfiguration(array $configuration): void {
+        $this->config = array_merge($this->config, $configuration);
+    }
+
+    /**
+     * Match the update with the given plugins
+     *
+     * @param Plugin[]|array $plugins
+     * @return void
+     */
+    private function loadPlugins(array $plugins): void {
+        $update = $update ?? ($this->update ?? Telegram::getUpdate());
+
+        foreach ($plugins as $plugin) {
+            if (!is_subclass_of($plugin['class'], Plugin::class)) {
             throw new \InvalidArgumentException(sprintf(
-               'The plugin %s must be an instance of %s',
-               get_class($plugin['class']), Plugin::class
+                'The plugin %s must be an instance of %s',
+                get_class($plugin['class']), Plugin::class
             ));
-         }
-      }
+            }
+        }
 
-      if (!$update instanceof Update) {
-         throw new \InvalidArgumentException(sprintf(
+        if (!$update instanceof Update) {
+            throw new \InvalidArgumentException(sprintf(
             'The update must be an instance of %s. %s given',
             Update::class, gettype($update)
-         ));
-      }
-
-      $this->spreadUpdateWith($update, $plugins);
-   }
-
-   /**
-    * This function will get update and spread it to the plugins
-    *
-    * @param Update $update
-    * @param array<Plugin> $plugins
-    * @return void
-    */
-   private function spreadUpdateWith(Update $update, array $plugins): void {
-      $this->active_spreader = true;
-
-      foreach ($plugins as $plugin) {
-         if ($plugin['initialized'] === false) {
+            ));
+        }
+
+        $this->spreadUpdateWith($update, $plugins);
+    }
+
+    /**
+     * This function will get update and spread it to the plugins
+     *
+     * @param Update $update
+     * @param array<Plugin> $plugins
+     * @return void
+     */
+    private function spreadUpdateWith(Update $update, array $plugins): void {
+        $this->active_spreader = true;
+
+        foreach ($plugins as $plugin) {
+            if ($plugin['initialized'] === false) {
             $plugin['class'] = new $plugin['class']();
-         }
-
-         $plugin['class']->__execute($this, $update);
-         if ($this->active_spreader === false) break;
-      }
-
-      $this->active_spreader = false;
-   }
-
-   /**
-    * Stop the spreader process
-    *
-    * @return void
-    */
-   public function stop(): void {
-      $this->active_spreader = false;
-   }
+            }
+
+            $plugin['class']->__execute($this, $update);
+            if ($this->active_spreader === false) break;
+        }
+
+        $this->active_spreader = false;
+    }
+
+    /**
+     * Stop the spreader process
+     *
+     * @return void
+     */
+    public function stop(): void {
+        $this->active_spreader = false;
+    }
 
 }
\ No newline at end of file

Braces +3 added lines, -1 removed lines

@@ -235,7 +235,9 @@
          }
 
          $plugin['class']->__execute($this, $update);
-         if ($this->active_spreader === false) break;
+         if ($this->active_spreader === false) {
+             break;
+         }
       }
 
       $this->active_spreader = false;

src/Traits/PluginTrait.php

Indentation +91 added lines, -91 removed lines

@@ -16,98 +16,98 @@
  */
 trait PluginTrait {
 
-   /**
-    * @var UpdateHandler
-    */
-   protected UpdateHandler $hook;
-
-   /**
-    * This property is used to kill the plugin when you yield a Response object.
-    *
-    * @var bool
-    */
-   protected bool $KILL_ON_YIELD = true;
-
-   /**
-    * @var \Generator
-    */
-   private \Generator $returns;
-
-   /**
-    * Execute the plugin.
-    *
-    * @param UpdateHandler $receiver
-    * @param Update $update
-    * @return void
-    */
-   public function __execute(UpdateHandler $receiver, Update $update): void {
-      $this->hook = $receiver;
-
-      if (method_exists($this, '__process')) {
-         $this->__process($update);
-      }
-
-      if (method_exists($this, 'onReceivedUpdate')) {
-         $return = $this->onUpdate($update);
-         $this->__checkExit($return);
-      }
-
-      $type = $this->__identify($update);
-      if (method_exists($this, ($method = 'on' . $type)) && $type !== null) {
-         $this->__checkExit($this->__callEvent($method, $update));
-      }
-   }
-
-   /**
-    * Check for the exit of the plugin.
-    *
-    * @param \Generator $return
-    * @return void
-    */
-   private function __checkExit(\Generator $return): void {
-      if ($return->valid()) {
-         if ($return->current() !== null && $this->KILL_ON_YIELD === true) {
+    /**
+     * @var UpdateHandler
+     */
+    protected UpdateHandler $hook;
+
+    /**
+     * This property is used to kill the plugin when you yield a Response object.
+     *
+     * @var bool
+     */
+    protected bool $KILL_ON_YIELD = true;
+
+    /**
+     * @var \Generator
+     */
+    private \Generator $returns;
+
+    /**
+     * Execute the plugin.
+     *
+     * @param UpdateHandler $receiver
+     * @param Update $update
+     * @return void
+     */
+    public function __execute(UpdateHandler $receiver, Update $update): void {
+        $this->hook = $receiver;
+
+        if (method_exists($this, '__process')) {
+            $this->__process($update);
+        }
+
+        if (method_exists($this, 'onReceivedUpdate')) {
+            $return = $this->onUpdate($update);
+            $this->__checkExit($return);
+        }
+
+        $type = $this->__identify($update);
+        if (method_exists($this, ($method = 'on' . $type)) && $type !== null) {
+            $this->__checkExit($this->__callEvent($method, $update));
+        }
+    }
+
+    /**
+     * Check for the exit of the plugin.
+     *
+     * @param \Generator $return
+     * @return void
+     */
+    private function __checkExit(\Generator $return): void {
+        if ($return->valid()) {
+            if ($return->current() !== null && $this->KILL_ON_YIELD === true) {
             if ($return->current() instanceof Response) {
-               $this->stop();
+                $this->stop();
             }
-         }
-      }
-
-      if ($return->valid()) {
-         $return->next();
-         $this->__checkExit($return);
-      }
-   }
-
-   /**
-    * Identify the update type. e.g. Message, EditedMessage, etc.
-    *
-    * @param Update $update
-    * @return string|null
-    */
-   private function __identify(Update $update): ?string {
-      $type = $update->getUpdateType();
-
-      if ($type === null) {
-         return null;
-      }
-
-      return str_replace('_', '', ucwords($type, '_'));
-   }
-
-   /**
-    * Pass data to the method.
-    *
-    * @param string $method The method name.
-    * @param Update $update The update object.
-    * @return \Generator
-    */
-   private function __callEvent(string $method, Update $update): \Generator {
-      $upperName = 'get' . ucfirst(substr($method, 2));
-      return match ($method) {
-         'onWebAppData' => $this->onWebAppData($update->getWebAppData()),
-         default => $this->$method($update->getUpdateId(), $update->$upperName()),
-      };
-   }
+            }
+        }
+
+        if ($return->valid()) {
+            $return->next();
+            $this->__checkExit($return);
+        }
+    }
+
+    /**
+     * Identify the update type. e.g. Message, EditedMessage, etc.
+     *
+     * @param Update $update
+     * @return string|null
+     */
+    private function __identify(Update $update): ?string {
+        $type = $update->getUpdateType();
+
+        if ($type === null) {
+            return null;
+        }
+
+        return str_replace('_', '', ucwords($type, '_'));
+    }
+
+    /**
+     * Pass data to the method.
+     *
+     * @param string $method The method name.
+     * @param Update $update The update object.
+     * @return \Generator
+     */
+    private function __callEvent(string $method, Update $update): \Generator {
+        $upperName = 'get' . ucfirst(substr($method, 2));
+        return match ($method) {
+            'onWebAppData' => $this->onWebAppData($update->getWebAppData()),
+            default => $this->$method($update->getUpdateId(), $update->$upperName()),
+        };
+    }
 
 }
\ No newline at end of file

src/Entity.php

Spacing +2 added lines, -2 removed lines

@@ -60,8 +60,8 @@
     */
    public static function escapeMarkdown(string $string): string {
       return str_replace(
-         ['[', '`', '*', '_',],
-         ['\[', '\`', '\*', '\_',],
+         ['[', '`', '*', '_', ],
+         ['\[', '\`', '\*', '\_', ],
          $string
       );
    }

Indentation +157 added lines, -157 removed lines

@@ -12,164 +12,164 @@
  */
 abstract class Entity {
 
-   /**
-    * @var array The raw data passed to this entity
-    */
-   protected array $raw_data = [];
-
-   /**
-    * Entity constructor.
-    *
-    * @param ?array $data The raw data passed to this entity
-    */
-   public function __construct(?array $data) {
-      if (!empty($data)) {
-         $this->assignMemberVariables(($this->raw_data = $data));
-         $this->validate();
-      }
-   }
-
-   /**
-    * Helper to set member variables
-    *
-    * @param array $data
-    * @return void
-    */
-   protected function assignMemberVariables(array $data): void {
-      foreach ($data as $key => $value) {
-         $this->$key = $value;
-      }
-   }
-
-   /**
-    * Perform any special entity validation
-    *
-    * @return void
-    */
-   protected function validate(): void {
-      // Do nothing by default
-   }
-
-   /**
-    * Escape markdown (v1) special characters
-    *
-    * @see https://core.telegram.org/bots/api#markdown-style
-    *
-    * @param string $string
-    *
-    * @return string
-    */
-   public static function escapeMarkdown(string $string): string {
-      return str_replace(
-         ['[', '`', '*', '_',],
-         ['\[', '\`', '\*', '\_',],
-         $string
-      );
-   }
-
-   /**
-    * Escape markdown (v2) special characters
-    *
-    * @see https://core.telegram.org/bots/api#markdownv2-style
-    *
-    * @param string $string
-    *
-    * @return string
-    */
-   public static function escapeMarkdownV2(string $string): string {
-      return str_replace(
-         ['_', '*', '[', ']', '(', ')', '~', '`', '>', '#', '+', '-', '=', '|', '{', '}', '.', '!'],
-         ['\_', '\*', '\[', '\]', '\(', '\)', '\~', '\`', '\>', '\#', '\+', '\-', '\=', '\|', '\{', '\}', '\.', '\!'],
-         $string
-      );
-   }
-
-   /**
-    * Get the raw data passed to this entity
-    *
-    * @param bool $associated
-    * @return array|string
-    */
-   public function getRawData(bool $associated = true): array|string {
-      return $associated ? $this->raw_data : json_encode($this->raw_data);
-   }
-
-   /**
-    * Get a property from the current Entity
-    *
-    * @param string $property
-    * @param mixed $default
-    *
-    * @return mixed
-    */
-   public function getProperty(string $property, mixed $default = null): mixed {
-      return $this->raw_data[$property] ?? $default;
-   }
-
-   /**
-    * Get the list of the properties that are themselves Entities
-    *
-    * @return array
-    */
-   protected function subEntities(): array {
-      return [];
-   }
-
-   /**
-    * Get the key value from the raw data passed to this entity
-    *
-    * @param string $key
-    * @return mixed The value can be {Entity, array, string, int, float, bool, null}
-    */
-   public function get(string $key): mixed {
-      $property = $this->getProperty($key);
-      $sub_entities = $this->subEntities() ?? [];
-
-      if (isset($sub_entities[$key])) {
-         $class_name = $sub_entities[$key];
-         return Factory::resolveEntityClass($class_name, $property);
-      }
-
-      return $property ?? null;
-   }
-
-   /**
-    * Rewrite the entity values with the new data
-    *
-    * @param string $key
-    * @param mixed $value
-    * @return void
-    */
-   public function set(string $key, mixed $value): void {
-      $this->raw_data[$key] = $value;
-
-      if (property_exists($this, $key)) {
-         $this->{$key} = $value;
-      }
-   }
-
-   /**
-    * @param string $name The name of the property
-    * @param array $arguments The arguments passed to the method
-    * @return mixed
-    */
-   public function __call(string $name, array $arguments): mixed {
-      if (method_exists($this, $name)) {
-         return $this->{$name}(...$arguments);
-      }
-
-      if (str_starts_with($name, 'get')) {
-         $property_name = strtolower(ltrim(preg_replace('/[A-Z]/', '_$0', substr($name, 3)), '_'));
-         return $this->get($property_name);
-      }
-
-      if (str_starts_with($name, 'set')) {
-         $property_name = strtolower(ltrim(preg_replace('/[A-Z]/', '_$0', substr($name, 3)), '_'));
-         $this->set($property_name, $arguments[0]);
-         return $this;
-      }
+    /**
+     * @var array The raw data passed to this entity
+     */
+    protected array $raw_data = [];
+
+    /**
+     * Entity constructor.
+     *
+     * @param ?array $data The raw data passed to this entity
+     */
+    public function __construct(?array $data) {
+        if (!empty($data)) {
+            $this->assignMemberVariables(($this->raw_data = $data));
+            $this->validate();
+        }
+    }
+
+    /**
+     * Helper to set member variables
+     *
+     * @param array $data
+     * @return void
+     */
+    protected function assignMemberVariables(array $data): void {
+        foreach ($data as $key => $value) {
+            $this->$key = $value;
+        }
+    }
+
+    /**
+     * Perform any special entity validation
+     *
+     * @return void
+     */
+    protected function validate(): void {
+        // Do nothing by default
+    }
+
+    /**
+     * Escape markdown (v1) special characters
+     *
+     * @see https://core.telegram.org/bots/api#markdown-style
+     *
+     * @param string $string
+     *
+     * @return string
+     */
+    public static function escapeMarkdown(string $string): string {
+        return str_replace(
+            ['[', '`', '*', '_',],
+            ['\[', '\`', '\*', '\_',],
+            $string
+        );
+    }
+
+    /**
+     * Escape markdown (v2) special characters
+     *
+     * @see https://core.telegram.org/bots/api#markdownv2-style
+     *
+     * @param string $string
+     *
+     * @return string
+     */
+    public static function escapeMarkdownV2(string $string): string {
+        return str_replace(
+            ['_', '*', '[', ']', '(', ')', '~', '`', '>', '#', '+', '-', '=', '|', '{', '}', '.', '!'],
+            ['\_', '\*', '\[', '\]', '\(', '\)', '\~', '\`', '\>', '\#', '\+', '\-', '\=', '\|', '\{', '\}', '\.', '\!'],
+            $string
+        );
+    }
+
+    /**
+     * Get the raw data passed to this entity
+     *
+     * @param bool $associated
+     * @return array|string
+     */
+    public function getRawData(bool $associated = true): array|string {
+        return $associated ? $this->raw_data : json_encode($this->raw_data);
+    }
+
+    /**
+     * Get a property from the current Entity
+     *
+     * @param string $property
+     * @param mixed $default
+     *
+     * @return mixed
+     */
+    public function getProperty(string $property, mixed $default = null): mixed {
+        return $this->raw_data[$property] ?? $default;
+    }
+
+    /**
+     * Get the list of the properties that are themselves Entities
+     *
+     * @return array
+     */
+    protected function subEntities(): array {
+        return [];
+    }
+
+    /**
+     * Get the key value from the raw data passed to this entity
+     *
+     * @param string $key
+     * @return mixed The value can be {Entity, array, string, int, float, bool, null}
+     */
+    public function get(string $key): mixed {
+        $property = $this->getProperty($key);
+        $sub_entities = $this->subEntities() ?? [];
+
+        if (isset($sub_entities[$key])) {
+            $class_name = $sub_entities[$key];
+            return Factory::resolveEntityClass($class_name, $property);
+        }
+
+        return $property ?? null;
+    }
+
+    /**
+     * Rewrite the entity values with the new data
+     *
+     * @param string $key
+     * @param mixed $value
+     * @return void
+     */
+    public function set(string $key, mixed $value): void {
+        $this->raw_data[$key] = $value;
+
+        if (property_exists($this, $key)) {
+            $this->{$key} = $value;
+        }
+    }
+
+    /**
+     * @param string $name The name of the property
+     * @param array $arguments The arguments passed to the method
+     * @return mixed
+     */
+    public function __call(string $name, array $arguments): mixed {
+        if (method_exists($this, $name)) {
+            return $this->{$name}(...$arguments);
+        }
+
+        if (str_starts_with($name, 'get')) {
+            $property_name = strtolower(ltrim(preg_replace('/[A-Z]/', '_$0', substr($name, 3)), '_'));
+            return $this->get($property_name);
+        }
+
+        if (str_starts_with($name, 'set')) {
+            $property_name = strtolower(ltrim(preg_replace('/[A-Z]/', '_$0', substr($name, 3)), '_'));
+            $this->set($property_name, $arguments[0]);
+            return $this;
+        }
 
     throw new \BadMethodCallException(`Method {$name} does not exist`);
-  }
+    }
 
 }

src/CrashPad.php

Indentation +1 added lines, -1 removed lines

@@ -79,7 +79,7 @@
         }
 
         if (!Telegram::validateToken($_ENV['TELEGRAM_BOT_TOKEN'] ?? '')) {
-          Telegram::tryAutoloadEnv();
+            Telegram::tryAutoloadEnv();
         }
 
         if (($token = self::loadToken()) === null) {

Spacing +1 added lines, -1 removed lines

@@ -23,7 +23,7 @@
      */
     public static function enableCrashHandler(): void
     {
-        $handler = function (Throwable $throwable) {
+        $handler = function(Throwable $throwable) {
             if (Telegram::getAdminId() !== -1) {
                 $input = Telegram::getInput();
                 CrashPad::sendCrash(Telegram::getAdminId(), $throwable, $input);