Refactor SDK for enhanced modularity, consistency, and functionality

- Removed `EndpointBuilder` class and replaced with `ApiPathEnum` for unified API path management.
- Standardized method signatures with improved naming conventions (e.g., `listener` -> `listenerName`, `name` -> `applicationName`).
- Introduced `Telemetry` class and `TelemetryProtocolEnum` for telemetry handling.
- Added support for managing modules in `Statistics` class and integrated `ModuleStatistics` implementation.
- Refactored `CanUpload` trait, added missing exceptions, and enhanced upload/remove methods with fallbacks for missing configs.
- Refined tests for proper mocking, coverage, and PHP 8.x compatibility.
- Updated default values and constructors for enhanced flexibility across configuration classes.

Author: Pavlusha311245

.github/SECURITY.md

@@ -8,6 +8,7 @@ We use [SemVer](https://semver.org/) for versioning. For the versions available,
 
 | Version | Nginx Unit Capability | Supported          |
 |---------|:----------------------|--------------------|
+| 0.9.x   | >=1.33.0              | :white_check_mark: |
 | 0.8.x   | 1.32.1                | :white_check_mark: |
 | < 0.7.x | -                     | :x:                |
 

.github/workflows/deploy_codecov.yaml

@@ -16,7 +16,7 @@ jobs:
       - name: Setup PHP
         uses: shivammathur/setup-php@v2
         with:
-          php-version: '8.3'
+          php-version: '8.4'
           extensions: curl
           tools: composer:v2
           coverage: xdebug

CHANGELOG.md

@@ -1,5 +1,12 @@
 # CHANGELOG
 
+## v0.9.0 - [2025/09/20]
+
+- Added new class `Telemetry` and `TelemetryProtocolEnum` for telemetry support
+- Added `ModuleStatisticsInterface` and class `ModuleStatistics` for module statistics
+- Added enum ApiPathEnum for managing API paths
+- Added methods `getRouteBlock` and `removeRouteBlock` in `Route` class
+
 ## v0.8.0 - [2024/09/10]
 
 - Updated application classes

README.md

@@ -8,11 +8,11 @@
 
 <p align="center">
 <a href="https://packagist.org/packages/pavlusha311245/unit-php-sdk"><img src="https://img.shields.io/packagist/v/Pavlusha311245/unit-php-sdk?labelColor=%231e293b&color=%23702963&link=https%3A%2F%2Fpackagist.org%2Fpackages%2Fpavlusha311245%2Funit-php-sdk" alt="packagist link"></a>
-<a href="https://unit-sdk.pavlusha.me/"><img src="https://img.shields.io/website?url=https%3A%2F%2Funit-sdk.pavlusha.me%2F&label=documentation&link=https%3A%2F%2Funit-sdk.pavlusha.me%2F" alt="documentation link"></a>
 <img src="https://github.com/Pavlusha311245/nginx-unit-php-sdk/actions/workflows/deploy_codecov.yaml/badge.svg" alt="documentation link">
 <a href="https://codecov.io/gh/Pavlusha311245/nginx-unit-php-sdk" > 
  <img src="https://codecov.io/gh/Pavlusha311245/nginx-unit-php-sdk/graph/badge.svg?token=FGTTDSJ7BX" alt="Codecov dabge"/> 
  </a>
+<a href="https://deepwiki.com/Pavlusha311245/nginx-unit-php-sdk"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
 </p>
 
 ## About
@@ -30,7 +30,8 @@ server management into your projects
 
 | Version | Nginx Unit Capability | Supported          |
 |---------|:----------------------|--------------------|
-| 0.8.x   | <= 1.32.1             | :white_check_mark: |
+| 0.9.x   | >= 1.33.0             | :white_check_mark: |
+| 0.8.x   | <= 1.32.1             | :x:                |
 | < 0.7.x | -                     | :x:                |
 
 ### Quick start

composer.json

@@ -1,6 +1,6 @@
 {
   "name": "pavlusha/unit-php-sdk",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "type": "sdk",
   "description": "This project allows developers to interact with the Nginx Unit web server through PHP classes",
   "license": "Apache-2.0",
@@ -19,27 +19,28 @@
   ],
   "scripts": {
     "test": [
-      "composer test:unit",
-      "composer test:phpstan"
+      "@test:phpstan",
+      "@test:unit"
     ],
     "test:unit": "./vendor/bin/pest",
-    "test:coverage": "./vendor/bin/pest --coverage --coverage-clover coverage.xml",
-    "test:phpstan": "./vendor/bin/phpstan analyse -c phpstan.neon",
-    "lint": "./vendor/bin/php-cs-fixer fix --rules=@PSR12 ."
+    "test:coverage": "XDEBUG_MODE=cover ./vendor/bin/pest --coverage --coverage-clover coverage.xml",
+    "test:phpstan": "./vendor/bin/phpstan analyse -c phpstan.neon --memory-limit=256M",
+    "lint": "PHP_CS_FIXER_IGNORE_ENV=1 ./vendor/bin/php-cs-fixer fix --rules=@PSR12 ."
   },
   "require": {
-    "php": "^8.3",
-    "friendsofphp/php-cs-fixer": "^3.54",
-    "guzzlehttp/guzzle": "^7.8.1",
-    "nesbot/carbon": "^2.72",
+    "php": "^8.4",
+    "friendsofphp/php-cs-fixer": "^3.68",
+    "guzzlehttp/guzzle": "^7.9",
+    "nesbot/carbon": "^3.8",
     "doctrine/inflector": "^2.0",
     "ext-curl": "*"
   },
   "require-dev": {
-    "pestphp/pest": "^2.34",
-    "phpstan/phpstan": "^1.10",
+    "roave/security-advisories": "dev-latest",
+    "pestphp/pest": "^2.36",
+    "phpstan/phpstan": "^1.12",
     "mockery/mockery": "^1.6",
-    "fakerphp/faker": "^1.23"
+    "fakerphp/faker": "^1.24"
   },
   "autoload": {
     "psr-4": {

src/Abstract/AbstractApplication.php

@@ -7,6 +7,7 @@
     ProcessManagement\RequestLimit
 };
 use UnitPhpSdk\Builders\EndpointBuilder;
+use UnitPhpSdk\Enums\ApiPathEnum;
 use UnitPhpSdk\Exceptions\UnitException;
 use UnitPhpSdk\Contracts\{ApplicationInterface, Arrayable, Uploadable};
 use UnitPhpSdk\Traits\CanUpload;
@@ -99,7 +100,7 @@ public function __construct(string $name, ?array $data = [])
             $this->parseFromArray($data);
         }
 
-        $this->setApiEndpoint(EndpointBuilder::create("config/applications/")->get() . $this->getName());
+        $this->setApiEndpoint(ApiPathEnum::APPLICATION->getPath($this->getName()));
     }
 
     /**

src/Builders/ApplicationBuilder.php

@@ -17,9 +17,10 @@
 class ApplicationBuilder
 {
     /**
-     * @throws UnitException
-     *
-     * TODO: add ApplicationTypeEnum as possible type
+     * @param $appName
+     * @param $appData
+     * @param string $type
+     * @return GoExternalApplication|JavaApplication|NodeJsExternalApplication|PerlApplication|PhpApplication|PythonApplication|RubyApplication|WebAssemblyApplication|WebAssemblyComponentApplication
      */
     public static function create($appName, $appData, string $type = '')
     {

src/Builders/EndpointBuilder.php

@@ -13,7 +13,7 @@
  *
  * @implements CertificateInterface
  */
-readonly class Certificate implements CertificateInterface, Arrayable
+class Certificate implements CertificateInterface, Arrayable
 {
     /**
      * @var array $chain