From 762efabe83e6d3b3f41302e082069e59c347f8d5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Matej=20Ba=C4=8Do?= <matejbaco2000@gmail.com>
Date: Mon, 4 May 2026 14:08:06 +0200
Subject: [PATCH 1/5] Support param aliases

---
 composer.json                           |  4 +-
 composer.lock                           | 96 +++++++++++++++----------
 src/Platform/Action.php                 |  4 +-
 src/Platform/Platform.php               |  6 +-
 tests/Platform/TestActionWithParams.php |  3 +-
 tests/e2e/HTTPServicesTest.php          |  9 +++
 6 files changed, 76 insertions(+), 46 deletions(-)

diff --git a/composer.json b/composer.json
index b5d4972..a5f9636 100644
--- a/composer.json
+++ b/composer.json
@@ -19,9 +19,9 @@
         "ext-json": "*",
         "ext-redis": "*",
         "utopia-php/cli": "0.23.*",
-        "utopia-php/http": "0.34.*",
+        "utopia-php/http": "dev-feat-param-aliases as 0.34.99",
         "utopia-php/queue": "0.18.*",
-        "utopia-php/servers": "0.3.*"
+        "utopia-php/servers": "dev-feat-param-aliases as 0.3.99"
     },
     "require-dev": {
         "phpunit/phpunit": "^9.3",
diff --git a/composer.lock b/composer.lock
index bd55a25..94232af 100644
--- a/composer.lock
+++ b/composer.lock
@@ -4,7 +4,7 @@
         "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
         "This file is @generated automatically"
     ],
-    "content-hash": "8daee4941ba69caecaf2aeb476f41ef5",
+    "content-hash": "e6b09573b4d08fd17a642962beb0f3b8",
     "packages": [
         {
             "name": "brick/math",
@@ -1616,16 +1616,16 @@
         },
         {
             "name": "symfony/http-client",
-            "version": "v7.4.8",
+            "version": "v7.4.9",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/http-client.git",
-                "reference": "01933e626c3de76bea1e22641e205e78f6a34342"
+                "reference": "7e941c6abf4e3bf7dca160bf0e11ef36a9f832f6"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/http-client/zipball/01933e626c3de76bea1e22641e205e78f6a34342",
-                "reference": "01933e626c3de76bea1e22641e205e78f6a34342",
+                "url": "https://api.github.com/repos/symfony/http-client/zipball/7e941c6abf4e3bf7dca160bf0e11ef36a9f832f6",
+                "reference": "7e941c6abf4e3bf7dca160bf0e11ef36a9f832f6",
                 "shasum": ""
             },
             "require": {
@@ -1693,7 +1693,7 @@
                 "http"
             ],
             "support": {
-                "source": "https://github.com/symfony/http-client/tree/v7.4.8"
+                "source": "https://github.com/symfony/http-client/tree/v7.4.9"
             },
             "funding": [
                 {
@@ -1713,7 +1713,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2026-03-30T12:55:43+00:00"
+            "time": "2026-04-29T13:25:15+00:00"
         },
         {
             "name": "symfony/http-client-contracts",
@@ -1795,7 +1795,7 @@
         },
         {
             "name": "symfony/polyfill-mbstring",
-            "version": "v1.36.0",
+            "version": "v1.37.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-mbstring.git",
@@ -1856,7 +1856,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-mbstring/tree/v1.36.0"
+                "source": "https://github.com/symfony/polyfill-mbstring/tree/v1.37.0"
             },
             "funding": [
                 {
@@ -1880,7 +1880,7 @@
         },
         {
             "name": "symfony/polyfill-php82",
-            "version": "v1.36.0",
+            "version": "v1.37.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-php82.git",
@@ -1936,7 +1936,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-php82/tree/v1.36.0"
+                "source": "https://github.com/symfony/polyfill-php82/tree/v1.37.0"
             },
             "funding": [
                 {
@@ -1960,7 +1960,7 @@
         },
         {
             "name": "symfony/polyfill-php83",
-            "version": "v1.36.0",
+            "version": "v1.37.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-php83.git",
@@ -2016,7 +2016,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-php83/tree/v1.36.0"
+                "source": "https://github.com/symfony/polyfill-php83/tree/v1.37.0"
             },
             "funding": [
                 {
@@ -2366,35 +2366,37 @@
         },
         {
             "name": "utopia-php/http",
-            "version": "0.34.16",
+            "version": "dev-feat-param-aliases",
             "source": {
                 "type": "git",
                 "url": "https://github.com/utopia-php/http.git",
-                "reference": "2b4021ba3f9d476264ce9fd6703d6c79de9add7f"
+                "reference": "4439705c8c2e81af826f4b6d694469c9ebc84a9f"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/utopia-php/http/zipball/2b4021ba3f9d476264ce9fd6703d6c79de9add7f",
-                "reference": "2b4021ba3f9d476264ce9fd6703d6c79de9add7f",
+                "url": "https://api.github.com/repos/utopia-php/http/zipball/4439705c8c2e81af826f4b6d694469c9ebc84a9f",
+                "reference": "4439705c8c2e81af826f4b6d694469c9ebc84a9f",
                 "shasum": ""
             },
             "require": {
-                "ext-swoole": "*",
-                "php": ">=8.2",
+                "php": ">=8.3",
                 "utopia-php/compression": "0.1.*",
                 "utopia-php/di": "0.3.*",
-                "utopia-php/servers": "0.3.*",
+                "utopia-php/servers": "dev-feat-param-aliases as 0.3.x-dev",
                 "utopia-php/telemetry": "0.2.*",
                 "utopia-php/validators": "0.2.*"
             },
             "require-dev": {
                 "doctrine/instantiator": "^1.5",
                 "laravel/pint": "1.*",
-                "phpbench/phpbench": "^1.2",
-                "phpstan/phpstan": "1.*",
-                "phpunit/phpunit": "^9.5.25",
+                "phpstan/phpstan": "^2.1",
+                "phpunit/phpunit": "^12.0",
+                "rector/rector": "^2.4",
                 "swoole/ide-helper": "4.8.3"
             },
+            "suggest": {
+                "ext-swoole": "Required to use the Swoole server adapter (\\Utopia\\Http\\Adapter\\Swoole\\Server)."
+            },
             "type": "library",
             "autoload": {
                 "psr-4": {
@@ -2414,9 +2416,9 @@
             ],
             "support": {
                 "issues": "https://github.com/utopia-php/http/issues",
-                "source": "https://github.com/utopia-php/http/tree/0.34.16"
+                "source": "https://github.com/utopia-php/http/tree/feat-param-aliases"
             },
-            "time": "2026-03-20T10:39:07+00:00"
+            "time": "2026-05-04T11:52:49+00:00"
         },
         {
             "name": "utopia-php/pools",
@@ -2540,16 +2542,16 @@
         },
         {
             "name": "utopia-php/servers",
-            "version": "0.3.0",
+            "version": "dev-feat-param-aliases",
             "source": {
                 "type": "git",
                 "url": "https://github.com/utopia-php/servers.git",
-                "reference": "235be31200df9437fc96a1c270ffef4c64fafe52"
+                "reference": "24bbd8fbb6550bc72f2816d9b0c3b690e38e17fa"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/utopia-php/servers/zipball/235be31200df9437fc96a1c270ffef4c64fafe52",
-                "reference": "235be31200df9437fc96a1c270ffef4c64fafe52",
+                "url": "https://api.github.com/repos/utopia-php/servers/zipball/24bbd8fbb6550bc72f2816d9b0c3b690e38e17fa",
+                "reference": "24bbd8fbb6550bc72f2816d9b0c3b690e38e17fa",
                 "shasum": ""
             },
             "require": {
@@ -2588,9 +2590,9 @@
             ],
             "support": {
                 "issues": "https://github.com/utopia-php/servers/issues",
-                "source": "https://github.com/utopia-php/servers/tree/0.3.0"
+                "source": "https://github.com/utopia-php/servers/tree/feat-param-aliases"
             },
-            "time": "2026-03-13T11:31:42+00:00"
+            "time": "2026-05-04T11:57:44+00:00"
         },
         {
             "name": "utopia-php/telemetry",
@@ -2649,16 +2651,16 @@
         },
         {
             "name": "utopia-php/validators",
-            "version": "0.2.0",
+            "version": "0.2.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/utopia-php/validators.git",
-                "reference": "30b6030a5b100fc1dff34506e5053759594b2a20"
+                "reference": "5d7d494e64457cd4eb67fdcfd9481f2c89796aa6"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/utopia-php/validators/zipball/30b6030a5b100fc1dff34506e5053759594b2a20",
-                "reference": "30b6030a5b100fc1dff34506e5053759594b2a20",
+                "url": "https://api.github.com/repos/utopia-php/validators/zipball/5d7d494e64457cd4eb67fdcfd9481f2c89796aa6",
+                "reference": "5d7d494e64457cd4eb67fdcfd9481f2c89796aa6",
                 "shasum": ""
             },
             "require": {
@@ -2688,9 +2690,9 @@
             ],
             "support": {
                 "issues": "https://github.com/utopia-php/validators/issues",
-                "source": "https://github.com/utopia-php/validators/tree/0.2.0"
+                "source": "https://github.com/utopia-php/validators/tree/0.2.2"
             },
-            "time": "2026-01-13T09:16:51+00:00"
+            "time": "2026-04-27T16:30:24+00:00"
         }
     ],
     "packages-dev": [
@@ -4557,9 +4559,25 @@
             "time": "2025-11-17T20:03:58+00:00"
         }
     ],
-    "aliases": [],
+    "aliases": [
+        {
+            "package": "utopia-php/http",
+            "version": "dev-feat-param-aliases",
+            "alias": "0.34.99",
+            "alias_normalized": "0.34.99.0"
+        },
+        {
+            "package": "utopia-php/servers",
+            "version": "dev-feat-param-aliases",
+            "alias": "0.3.99",
+            "alias_normalized": "0.3.99.0"
+        }
+    ],
     "minimum-stability": "stable",
-    "stability-flags": {},
+    "stability-flags": {
+        "utopia-php/http": 20,
+        "utopia-php/servers": 20
+    },
     "prefer-stable": false,
     "prefer-lowest": false,
     "platform": {
diff --git a/src/Platform/Action.php b/src/Platform/Action.php
index aeac0b7..bdf6afa 100644
--- a/src/Platform/Action.php
+++ b/src/Platform/Action.php
@@ -169,9 +169,10 @@ public function getParams(): array
      * @param  bool  $skipValidation
      * @param  bool  $deprecated
      * @param  string  $example
+     * @param  array  $aliases
      * @return self
      */
-    public function param(string $key, mixed $default, Validator|callable $validator, string $description = '', bool $optional = false, array $injections = [], bool $skipValidation = false, bool $deprecated = false, string $example = ''): self
+    public function param(string $key, mixed $default, Validator|callable $validator, string $description = '', bool $optional = false, array $injections = [], bool $skipValidation = false, bool $deprecated = false, string $example = '', array $aliases = []): self
     {
         $param = [
             'default' => $default,
@@ -182,6 +183,7 @@ public function param(string $key, mixed $default, Validator|callable $validator
             'skipValidation' => $skipValidation,
             'deprecated' => $deprecated, // TODO: @Meldiron implement tests
             'example' => $example,
+            'aliases' => $aliases,
         ];
         $this->options['param:'.$key] = array_merge($param, ['type' => 'param']);
         $this->params[$key] = $param;
diff --git a/src/Platform/Platform.php b/src/Platform/Platform.php
index 2662713..ef2b3b6 100644
--- a/src/Platform/Platform.php
+++ b/src/Platform/Platform.php
@@ -115,7 +115,7 @@ protected function initHttp(array $services): void
                     switch ($option['type']) {
                         case 'param':
                             $key = substr($key, stripos($key, ':') + 1);
-                            $hook->param($key, $option['default'], $option['validator'], $option['description'], $option['optional'], $option['injections'], $option['skipValidation'], $option['deprecated'], $option['example']);
+                            $hook->param($key, $option['default'], $option['validator'], $option['description'], $option['optional'], $option['injections'], $option['skipValidation'], $option['deprecated'], $option['example'], aliases: $option['aliases'] ?? []);
                             break;
                         case 'injection':
                             $hook->inject($option['name']);
@@ -165,7 +165,7 @@ protected function initTasks(array $services): void
                     switch ($option['type']) {
                         case 'param':
                             $key = substr($key, stripos($key, ':') + 1);
-                            $hook->param($key, $option['default'], $option['validator'], $option['description'], $option['optional'], $option['injections'], $option['skipValidation'], $option['deprecated'], $option['example']);
+                            $hook->param($key, $option['default'], $option['validator'], $option['description'], $option['optional'], $option['injections'], $option['skipValidation'], $option['deprecated'], $option['example'], aliases: $option['aliases'] ?? []);
                             break;
                         case 'injection':
                             $hook->inject($option['name']);
@@ -222,7 +222,7 @@ protected function initWorker(array $services, string $workerName): void
                     switch ($option['type']) {
                         case 'param':
                             $key = substr($key, stripos($key, ':') + 1);
-                            $hook->param($key, $option['default'], $option['validator'], $option['description'], $option['optional'], $option['injections'], $option['skipValidation'], $option['deprecated'], $option['example']);
+                            $hook->param($key, $option['default'], $option['validator'], $option['description'], $option['optional'], $option['injections'], $option['skipValidation'], $option['deprecated'], $option['example'], aliases: $option['aliases'] ?? []);
                             break;
                         case 'injection':
                             $hook->inject($option['name']);
diff --git a/tests/Platform/TestActionWithParams.php b/tests/Platform/TestActionWithParams.php
index 4e2e7d1..34cea91 100644
--- a/tests/Platform/TestActionWithParams.php
+++ b/tests/Platform/TestActionWithParams.php
@@ -18,8 +18,9 @@ public function __construct()
             ->param('name', '', new Text(128), 'User name.', false, example: 'John Doe')
             ->param('age', 0, new Range(0, 150), 'User age.', true, example: '25')
             ->param('active', false, new Boolean(true), 'Is active.', true, deprecated: true, example: 'true')
+            ->param('email', '', new Text(256), 'User email.', true, aliases: ['emailAddress', 'userEmail'], example: 'user@example.com')
             ->inject('response')
-            ->callback(function ($name, $age, $active, $response) {
+            ->callback(function ($name, $age, $active, $email, $response) {
                 $response->send('OK');
             });
     }
diff --git a/tests/e2e/HTTPServicesTest.php b/tests/e2e/HTTPServicesTest.php
index 8fb26a4..26e30eb 100644
--- a/tests/e2e/HTTPServicesTest.php
+++ b/tests/e2e/HTTPServicesTest.php
@@ -158,5 +158,14 @@ public function testActionParamFieldsForwardedToRoute()
         $this->assertFalse($params['name']['deprecated']);
         $this->assertEquals('true', $params['active']['example']);
         $this->assertTrue($params['active']['deprecated']);
+
+        // Verify aliases are forwarded
+        $this->assertArrayHasKey('email', $params, 'Param email should be registered');
+        $this->assertArrayHasKey('aliases', $params['email'], 'Param email should have aliases key');
+        $this->assertEquals(['emailAddress', 'userEmail'], $params['email']['aliases']);
+        
+        // Verify params without aliases have empty array
+        $this->assertArrayHasKey('aliases', $params['name'], 'Param name should have aliases key');
+        $this->assertEquals([], $params['name']['aliases']);
     }
 }

From 4e305e9238e08610867483c5f5f1ddd7991f0c5d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Matej=20Ba=C4=8Do?= <matejbaco2000@gmail.com>
Date: Mon, 4 May 2026 14:25:08 +0200
Subject: [PATCH 2/5] PR review fixes

---
 composer.lock                  | 76 ++++++++--------------------------
 tests/e2e/HTTPServicesTest.php |  4 +-
 2 files changed, 20 insertions(+), 60 deletions(-)

diff --git a/composer.lock b/composer.lock
index 94232af..6f7cb90 100644
--- a/composer.lock
+++ b/composer.lock
@@ -1022,16 +1022,16 @@
         },
         {
             "name": "phpseclib/phpseclib",
-            "version": "3.0.51",
+            "version": "3.0.52",
             "source": {
                 "type": "git",
                 "url": "https://github.com/phpseclib/phpseclib.git",
-                "reference": "d59c94077f9c9915abb51ddb52ce85188ece1748"
+                "reference": "2adaefc83df2ec548558307690f376dd7d4f4fce"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/phpseclib/phpseclib/zipball/d59c94077f9c9915abb51ddb52ce85188ece1748",
-                "reference": "d59c94077f9c9915abb51ddb52ce85188ece1748",
+                "url": "https://api.github.com/repos/phpseclib/phpseclib/zipball/2adaefc83df2ec548558307690f376dd7d4f4fce",
+                "reference": "2adaefc83df2ec548558307690f376dd7d4f4fce",
                 "shasum": ""
             },
             "require": {
@@ -1112,7 +1112,7 @@
             ],
             "support": {
                 "issues": "https://github.com/phpseclib/phpseclib/issues",
-                "source": "https://github.com/phpseclib/phpseclib/tree/3.0.51"
+                "source": "https://github.com/phpseclib/phpseclib/tree/3.0.52"
             },
             "funding": [
                 {
@@ -1128,7 +1128,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2026-04-10T01:33:53+00:00"
+            "time": "2026-04-27T07:02:15+00:00"
         },
         {
             "name": "psr/container",
@@ -2179,16 +2179,16 @@
         },
         {
             "name": "utopia-php/cli",
-            "version": "0.23.0",
+            "version": "0.23.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/utopia-php/cli.git",
-                "reference": "4efef2662b27cdce0d6d09ea5c3a16a1cca2ba6c"
+                "reference": "145b91fef827853bcceaa3ab8ca2b1d6faaca2ab"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/utopia-php/cli/zipball/4efef2662b27cdce0d6d09ea5c3a16a1cca2ba6c",
-                "reference": "4efef2662b27cdce0d6d09ea5c3a16a1cca2ba6c",
+                "url": "https://api.github.com/repos/utopia-php/cli/zipball/145b91fef827853bcceaa3ab8ca2b1d6faaca2ab",
+                "reference": "145b91fef827853bcceaa3ab8ca2b1d6faaca2ab",
                 "shasum": ""
             },
             "require": {
@@ -2224,9 +2224,9 @@
             ],
             "support": {
                 "issues": "https://github.com/utopia-php/cli/issues",
-                "source": "https://github.com/utopia-php/cli/tree/0.23.0"
+                "source": "https://github.com/utopia-php/cli/tree/0.23.2"
             },
-            "time": "2026-03-13T12:23:18+00:00"
+            "time": "2026-04-27T09:19:04+00:00"
         },
         {
             "name": "utopia-php/compression",
@@ -2325,45 +2325,6 @@
             },
             "time": "2026-03-21T07:42:10+00:00"
         },
-        {
-            "name": "utopia-php/fetch",
-            "version": "0.5.1",
-            "source": {
-                "type": "git",
-                "url": "https://github.com/utopia-php/fetch.git",
-                "reference": "a96a010e1c273f3888765449687baf58cbc61fcd"
-            },
-            "dist": {
-                "type": "zip",
-                "url": "https://api.github.com/repos/utopia-php/fetch/zipball/a96a010e1c273f3888765449687baf58cbc61fcd",
-                "reference": "a96a010e1c273f3888765449687baf58cbc61fcd",
-                "shasum": ""
-            },
-            "require": {
-                "php": ">=8.1"
-            },
-            "require-dev": {
-                "laravel/pint": "^1.5.0",
-                "phpstan/phpstan": "^1.10",
-                "phpunit/phpunit": "^9.5"
-            },
-            "type": "library",
-            "autoload": {
-                "psr-4": {
-                    "Utopia\\Fetch\\": "src/"
-                }
-            },
-            "notification-url": "https://packagist.org/downloads/",
-            "license": [
-                "MIT"
-            ],
-            "description": "A simple library that provides an interface for making HTTP Requests.",
-            "support": {
-                "issues": "https://github.com/utopia-php/fetch/issues",
-                "source": "https://github.com/utopia-php/fetch/tree/0.5.1"
-            },
-            "time": "2025-12-18T16:25:10+00:00"
-        },
         {
             "name": "utopia-php/http",
             "version": "dev-feat-param-aliases",
@@ -2475,23 +2436,22 @@
         },
         {
             "name": "utopia-php/queue",
-            "version": "0.18.0",
+            "version": "0.18.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/utopia-php/queue.git",
-                "reference": "91de91b89cb295fa1a90f5ec1f2eeff8811bd2ad"
+                "reference": "87a561635f2bf365d8e3503051054c6525f28811"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/utopia-php/queue/zipball/91de91b89cb295fa1a90f5ec1f2eeff8811bd2ad",
-                "reference": "91de91b89cb295fa1a90f5ec1f2eeff8811bd2ad",
+                "url": "https://api.github.com/repos/utopia-php/queue/zipball/87a561635f2bf365d8e3503051054c6525f28811",
+                "reference": "87a561635f2bf365d8e3503051054c6525f28811",
                 "shasum": ""
             },
             "require": {
                 "php": ">=8.3",
                 "php-amqplib/php-amqplib": "^3.7",
                 "utopia-php/di": "0.3.*",
-                "utopia-php/fetch": "0.5.*",
                 "utopia-php/pools": "1.*",
                 "utopia-php/servers": "0.3.*",
                 "utopia-php/telemetry": "0.2.*",
@@ -2536,9 +2496,9 @@
             ],
             "support": {
                 "issues": "https://github.com/utopia-php/queue/issues",
-                "source": "https://github.com/utopia-php/queue/tree/0.18.0"
+                "source": "https://github.com/utopia-php/queue/tree/0.18.1"
             },
-            "time": "2026-04-23T11:37:11+00:00"
+            "time": "2026-04-29T03:23:59+00:00"
         },
         {
             "name": "utopia-php/servers",
diff --git a/tests/e2e/HTTPServicesTest.php b/tests/e2e/HTTPServicesTest.php
index 26e30eb..82ad833 100644
--- a/tests/e2e/HTTPServicesTest.php
+++ b/tests/e2e/HTTPServicesTest.php
@@ -146,7 +146,7 @@ public function testActionParamFieldsForwardedToRoute()
         $params = $route->getParams();
 
         // Verify all Action::param() fields are forwarded to the Route
-        $actionParamKeys = ['default', 'validator', 'description', 'optional', 'injections', 'skipValidation', 'deprecated', 'example'];
+        $actionParamKeys = ['default', 'validator', 'description', 'optional', 'injections', 'skipValidation', 'deprecated', 'example', 'aliases'];
 
         foreach ($params as $name => $param) {
             foreach ($actionParamKeys as $key) {
@@ -163,7 +163,7 @@ public function testActionParamFieldsForwardedToRoute()
         $this->assertArrayHasKey('email', $params, 'Param email should be registered');
         $this->assertArrayHasKey('aliases', $params['email'], 'Param email should have aliases key');
         $this->assertEquals(['emailAddress', 'userEmail'], $params['email']['aliases']);
-        
+
         // Verify params without aliases have empty array
         $this->assertArrayHasKey('aliases', $params['name'], 'Param name should have aliases key');
         $this->assertEquals([], $params['name']['aliases']);

From 393b7ab9b26782c933a7f35457edf49ef0cbb403 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Matej=20Ba=C4=8Do?= <matejbaco2000@gmail.com>
Date: Mon, 4 May 2026 14:57:03 +0200
Subject: [PATCH 3/5] Upgrade all libs to support param aliases

---
 composer.json |  4 ++--
 composer.lock | 44 +++++++++++++++++++++++++++++---------------
 2 files changed, 31 insertions(+), 17 deletions(-)

diff --git a/composer.json b/composer.json
index a5f9636..5bdb31d 100644
--- a/composer.json
+++ b/composer.json
@@ -18,9 +18,9 @@
         "php": ">=8.3",
         "ext-json": "*",
         "ext-redis": "*",
-        "utopia-php/cli": "0.23.*",
+        "utopia-php/cli": "dev-feat-param-alias as 0.23.99",
         "utopia-php/http": "dev-feat-param-aliases as 0.34.99",
-        "utopia-php/queue": "0.18.*",
+        "utopia-php/queue": "dev-feat-param-aliases as 0.18.99",
         "utopia-php/servers": "dev-feat-param-aliases as 0.3.99"
     },
     "require-dev": {
diff --git a/composer.lock b/composer.lock
index 6f7cb90..698b8dd 100644
--- a/composer.lock
+++ b/composer.lock
@@ -4,7 +4,7 @@
         "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
         "This file is @generated automatically"
     ],
-    "content-hash": "e6b09573b4d08fd17a642962beb0f3b8",
+    "content-hash": "8c1c6c6878c062a182a70cb78bb80f8c",
     "packages": [
         {
             "name": "brick/math",
@@ -2179,21 +2179,21 @@
         },
         {
             "name": "utopia-php/cli",
-            "version": "0.23.2",
+            "version": "dev-feat-param-alias",
             "source": {
                 "type": "git",
                 "url": "https://github.com/utopia-php/cli.git",
-                "reference": "145b91fef827853bcceaa3ab8ca2b1d6faaca2ab"
+                "reference": "c01a4af02249f20f5a9b3e23b6e8ee20f52857a2"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/utopia-php/cli/zipball/145b91fef827853bcceaa3ab8ca2b1d6faaca2ab",
-                "reference": "145b91fef827853bcceaa3ab8ca2b1d6faaca2ab",
+                "url": "https://api.github.com/repos/utopia-php/cli/zipball/c01a4af02249f20f5a9b3e23b6e8ee20f52857a2",
+                "reference": "c01a4af02249f20f5a9b3e23b6e8ee20f52857a2",
                 "shasum": ""
             },
             "require": {
                 "php": ">=7.4",
-                "utopia-php/servers": "0.3.*"
+                "utopia-php/servers": "dev-feat-param-aliases"
             },
             "require-dev": {
                 "laravel/pint": "1.2.*",
@@ -2224,9 +2224,9 @@
             ],
             "support": {
                 "issues": "https://github.com/utopia-php/cli/issues",
-                "source": "https://github.com/utopia-php/cli/tree/0.23.2"
+                "source": "https://github.com/utopia-php/cli/tree/feat-param-alias"
             },
-            "time": "2026-04-27T09:19:04+00:00"
+            "time": "2026-05-04T12:39:30+00:00"
         },
         {
             "name": "utopia-php/compression",
@@ -2436,16 +2436,16 @@
         },
         {
             "name": "utopia-php/queue",
-            "version": "0.18.1",
+            "version": "dev-feat-param-aliases",
             "source": {
                 "type": "git",
                 "url": "https://github.com/utopia-php/queue.git",
-                "reference": "87a561635f2bf365d8e3503051054c6525f28811"
+                "reference": "a340c39c88e020413fe207e36c938985792d503c"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/utopia-php/queue/zipball/87a561635f2bf365d8e3503051054c6525f28811",
-                "reference": "87a561635f2bf365d8e3503051054c6525f28811",
+                "url": "https://api.github.com/repos/utopia-php/queue/zipball/a340c39c88e020413fe207e36c938985792d503c",
+                "reference": "a340c39c88e020413fe207e36c938985792d503c",
                 "shasum": ""
             },
             "require": {
@@ -2453,7 +2453,7 @@
                 "php-amqplib/php-amqplib": "^3.7",
                 "utopia-php/di": "0.3.*",
                 "utopia-php/pools": "1.*",
-                "utopia-php/servers": "0.3.*",
+                "utopia-php/servers": "dev-feat-param-aliases as 0.3.99",
                 "utopia-php/telemetry": "0.2.*",
                 "utopia-php/validators": "0.2.*"
             },
@@ -2496,9 +2496,9 @@
             ],
             "support": {
                 "issues": "https://github.com/utopia-php/queue/issues",
-                "source": "https://github.com/utopia-php/queue/tree/0.18.1"
+                "source": "https://github.com/utopia-php/queue/tree/feat-param-aliases"
             },
-            "time": "2026-04-29T03:23:59+00:00"
+            "time": "2026-05-04T12:56:06+00:00"
         },
         {
             "name": "utopia-php/servers",
@@ -4520,12 +4520,24 @@
         }
     ],
     "aliases": [
+        {
+            "package": "utopia-php/cli",
+            "version": "dev-feat-param-alias",
+            "alias": "0.23.99",
+            "alias_normalized": "0.23.99.0"
+        },
         {
             "package": "utopia-php/http",
             "version": "dev-feat-param-aliases",
             "alias": "0.34.99",
             "alias_normalized": "0.34.99.0"
         },
+        {
+            "package": "utopia-php/queue",
+            "version": "dev-feat-param-aliases",
+            "alias": "0.18.99",
+            "alias_normalized": "0.18.99.0"
+        },
         {
             "package": "utopia-php/servers",
             "version": "dev-feat-param-aliases",
@@ -4535,7 +4547,9 @@
     ],
     "minimum-stability": "stable",
     "stability-flags": {
+        "utopia-php/cli": 20,
         "utopia-php/http": 20,
+        "utopia-php/queue": 20,
         "utopia-php/servers": 20
     },
     "prefer-stable": false,

From 7fa008758c869671014ae4c4d52bb8cd686212f9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Matej=20Ba=C4=8Do?= <matejbaco2000@gmail.com>
Date: Mon, 4 May 2026 15:12:58 +0200
Subject: [PATCH 4/5] Remove 8.1 nad 8.2 support due to failing tests with
 syntax error

---
 .github/workflows/tests.yml | 2 +-
 composer.lock               | 8 ++++----
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 69854a9..ca5560f 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -7,7 +7,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        php-versions: ['8.1', '8.2', '8.3', '8.4', 'nightly']
+        php-versions: ['8.3', '8.4', 'nightly']
 
     steps:
     - name: Checkout repository
diff --git a/composer.lock b/composer.lock
index 698b8dd..f7d1ec5 100644
--- a/composer.lock
+++ b/composer.lock
@@ -2440,12 +2440,12 @@
             "source": {
                 "type": "git",
                 "url": "https://github.com/utopia-php/queue.git",
-                "reference": "a340c39c88e020413fe207e36c938985792d503c"
+                "reference": "32b0c439a8fa4fc06b8b8793800a04be894bf03c"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/utopia-php/queue/zipball/a340c39c88e020413fe207e36c938985792d503c",
-                "reference": "a340c39c88e020413fe207e36c938985792d503c",
+                "url": "https://api.github.com/repos/utopia-php/queue/zipball/32b0c439a8fa4fc06b8b8793800a04be894bf03c",
+                "reference": "32b0c439a8fa4fc06b8b8793800a04be894bf03c",
                 "shasum": ""
             },
             "require": {
@@ -2498,7 +2498,7 @@
                 "issues": "https://github.com/utopia-php/queue/issues",
                 "source": "https://github.com/utopia-php/queue/tree/feat-param-aliases"
             },
-            "time": "2026-05-04T12:56:06+00:00"
+            "time": "2026-05-04T12:59:54+00:00"
         },
         {
             "name": "utopia-php/servers",

From bc9fac01f5fc388c9a71382216b335dcdc70bfb5 Mon Sep 17 00:00:00 2001
From: Chirag Aggarwal <chiragaggarwal5k@gmail.com>
Date: Tue, 5 May 2026 10:11:33 +0530
Subject: [PATCH 5/5] Use stable param alias releases

---
 composer.json |  8 ++---
 composer.lock | 90 +++++++++++++++++----------------------------------
 2 files changed, 34 insertions(+), 64 deletions(-)

diff --git a/composer.json b/composer.json
index 5bdb31d..f896a61 100644
--- a/composer.json
+++ b/composer.json
@@ -18,10 +18,10 @@
         "php": ">=8.3",
         "ext-json": "*",
         "ext-redis": "*",
-        "utopia-php/cli": "dev-feat-param-alias as 0.23.99",
-        "utopia-php/http": "dev-feat-param-aliases as 0.34.99",
-        "utopia-php/queue": "dev-feat-param-aliases as 0.18.99",
-        "utopia-php/servers": "dev-feat-param-aliases as 0.3.99"
+        "utopia-php/cli": "0.23.3",
+        "utopia-php/http": "0.34.25",
+        "utopia-php/queue": "0.18.2",
+        "utopia-php/servers": "0.4.0"
     },
     "require-dev": {
         "phpunit/phpunit": "^9.3",
diff --git a/composer.lock b/composer.lock
index f7d1ec5..3ccedbd 100644
--- a/composer.lock
+++ b/composer.lock
@@ -4,7 +4,7 @@
         "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
         "This file is @generated automatically"
     ],
-    "content-hash": "8c1c6c6878c062a182a70cb78bb80f8c",
+    "content-hash": "e5b594cb7190724df576883925c53acb",
     "packages": [
         {
             "name": "brick/math",
@@ -2179,21 +2179,21 @@
         },
         {
             "name": "utopia-php/cli",
-            "version": "dev-feat-param-alias",
+            "version": "0.23.3",
             "source": {
                 "type": "git",
                 "url": "https://github.com/utopia-php/cli.git",
-                "reference": "c01a4af02249f20f5a9b3e23b6e8ee20f52857a2"
+                "reference": "3c45ae5bcdcd3c7916e1909d74c60b8e771610db"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/utopia-php/cli/zipball/c01a4af02249f20f5a9b3e23b6e8ee20f52857a2",
-                "reference": "c01a4af02249f20f5a9b3e23b6e8ee20f52857a2",
+                "url": "https://api.github.com/repos/utopia-php/cli/zipball/3c45ae5bcdcd3c7916e1909d74c60b8e771610db",
+                "reference": "3c45ae5bcdcd3c7916e1909d74c60b8e771610db",
                 "shasum": ""
             },
             "require": {
                 "php": ">=7.4",
-                "utopia-php/servers": "dev-feat-param-aliases"
+                "utopia-php/servers": "0.4.0"
             },
             "require-dev": {
                 "laravel/pint": "1.2.*",
@@ -2224,9 +2224,9 @@
             ],
             "support": {
                 "issues": "https://github.com/utopia-php/cli/issues",
-                "source": "https://github.com/utopia-php/cli/tree/feat-param-alias"
+                "source": "https://github.com/utopia-php/cli/tree/0.23.3"
             },
-            "time": "2026-05-04T12:39:30+00:00"
+            "time": "2026-05-05T04:38:59+00:00"
         },
         {
             "name": "utopia-php/compression",
@@ -2327,23 +2327,23 @@
         },
         {
             "name": "utopia-php/http",
-            "version": "dev-feat-param-aliases",
+            "version": "0.34.25",
             "source": {
                 "type": "git",
                 "url": "https://github.com/utopia-php/http.git",
-                "reference": "4439705c8c2e81af826f4b6d694469c9ebc84a9f"
+                "reference": "76be330d4197bae680eb4ccc29c573456fe91904"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/utopia-php/http/zipball/4439705c8c2e81af826f4b6d694469c9ebc84a9f",
-                "reference": "4439705c8c2e81af826f4b6d694469c9ebc84a9f",
+                "url": "https://api.github.com/repos/utopia-php/http/zipball/76be330d4197bae680eb4ccc29c573456fe91904",
+                "reference": "76be330d4197bae680eb4ccc29c573456fe91904",
                 "shasum": ""
             },
             "require": {
                 "php": ">=8.3",
                 "utopia-php/compression": "0.1.*",
                 "utopia-php/di": "0.3.*",
-                "utopia-php/servers": "dev-feat-param-aliases as 0.3.x-dev",
+                "utopia-php/servers": "0.4.0",
                 "utopia-php/telemetry": "0.2.*",
                 "utopia-php/validators": "0.2.*"
             },
@@ -2377,9 +2377,9 @@
             ],
             "support": {
                 "issues": "https://github.com/utopia-php/http/issues",
-                "source": "https://github.com/utopia-php/http/tree/feat-param-aliases"
+                "source": "https://github.com/utopia-php/http/tree/0.34.25"
             },
-            "time": "2026-05-04T11:52:49+00:00"
+            "time": "2026-05-05T04:39:15+00:00"
         },
         {
             "name": "utopia-php/pools",
@@ -2436,16 +2436,16 @@
         },
         {
             "name": "utopia-php/queue",
-            "version": "dev-feat-param-aliases",
+            "version": "0.18.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/utopia-php/queue.git",
-                "reference": "32b0c439a8fa4fc06b8b8793800a04be894bf03c"
+                "reference": "f85ca003c99ff475708c05466643d067403c0c22"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/utopia-php/queue/zipball/32b0c439a8fa4fc06b8b8793800a04be894bf03c",
-                "reference": "32b0c439a8fa4fc06b8b8793800a04be894bf03c",
+                "url": "https://api.github.com/repos/utopia-php/queue/zipball/f85ca003c99ff475708c05466643d067403c0c22",
+                "reference": "f85ca003c99ff475708c05466643d067403c0c22",
                 "shasum": ""
             },
             "require": {
@@ -2453,7 +2453,7 @@
                 "php-amqplib/php-amqplib": "^3.7",
                 "utopia-php/di": "0.3.*",
                 "utopia-php/pools": "1.*",
-                "utopia-php/servers": "dev-feat-param-aliases as 0.3.99",
+                "utopia-php/servers": "0.4.0",
                 "utopia-php/telemetry": "0.2.*",
                 "utopia-php/validators": "0.2.*"
             },
@@ -2496,22 +2496,22 @@
             ],
             "support": {
                 "issues": "https://github.com/utopia-php/queue/issues",
-                "source": "https://github.com/utopia-php/queue/tree/feat-param-aliases"
+                "source": "https://github.com/utopia-php/queue/tree/0.18.2"
             },
-            "time": "2026-05-04T12:59:54+00:00"
+            "time": "2026-05-05T04:38:59+00:00"
         },
         {
             "name": "utopia-php/servers",
-            "version": "dev-feat-param-aliases",
+            "version": "0.4.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/utopia-php/servers.git",
-                "reference": "24bbd8fbb6550bc72f2816d9b0c3b690e38e17fa"
+                "reference": "7db346ef377503efe0acafe0791085270cd9ed70"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/utopia-php/servers/zipball/24bbd8fbb6550bc72f2816d9b0c3b690e38e17fa",
-                "reference": "24bbd8fbb6550bc72f2816d9b0c3b690e38e17fa",
+                "url": "https://api.github.com/repos/utopia-php/servers/zipball/7db346ef377503efe0acafe0791085270cd9ed70",
+                "reference": "7db346ef377503efe0acafe0791085270cd9ed70",
                 "shasum": ""
             },
             "require": {
@@ -2550,9 +2550,9 @@
             ],
             "support": {
                 "issues": "https://github.com/utopia-php/servers/issues",
-                "source": "https://github.com/utopia-php/servers/tree/feat-param-aliases"
+                "source": "https://github.com/utopia-php/servers/tree/0.4.0"
             },
-            "time": "2026-05-04T11:57:44+00:00"
+            "time": "2026-05-05T04:08:30+00:00"
         },
         {
             "name": "utopia-php/telemetry",
@@ -4519,39 +4519,9 @@
             "time": "2025-11-17T20:03:58+00:00"
         }
     ],
-    "aliases": [
-        {
-            "package": "utopia-php/cli",
-            "version": "dev-feat-param-alias",
-            "alias": "0.23.99",
-            "alias_normalized": "0.23.99.0"
-        },
-        {
-            "package": "utopia-php/http",
-            "version": "dev-feat-param-aliases",
-            "alias": "0.34.99",
-            "alias_normalized": "0.34.99.0"
-        },
-        {
-            "package": "utopia-php/queue",
-            "version": "dev-feat-param-aliases",
-            "alias": "0.18.99",
-            "alias_normalized": "0.18.99.0"
-        },
-        {
-            "package": "utopia-php/servers",
-            "version": "dev-feat-param-aliases",
-            "alias": "0.3.99",
-            "alias_normalized": "0.3.99.0"
-        }
-    ],
+    "aliases": [],
     "minimum-stability": "stable",
-    "stability-flags": {
-        "utopia-php/cli": 20,
-        "utopia-php/http": 20,
-        "utopia-php/queue": 20,
-        "utopia-php/servers": 20
-    },
+    "stability-flags": {},
     "prefer-stable": false,
     "prefer-lowest": false,
     "platform": {