Merge pull request #41 from utopia-php/add-example

feat: add example parameter to Action::param method

Author: abnegate

src/Platform/Action.php

@@ -168,9 +168,10 @@ public function getParams(): array
      * @param  array  $injections
      * @param  bool  $skipValidation
      * @param  bool  $deprecated
+     * @param  string  $example
      * @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): 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
     {
         $param = [
             'default' => $default,
@@ -180,6 +181,7 @@ public function param(string $key, mixed $default, Validator|callable $validator
             'injections' => $injections,
             'skipValidation' => $skipValidation,
             'deprecated' => $deprecated, // TODO: @Meldiron implement tests
+            'example' => $example,
         ];
         $this->options['param:'.$key] = array_merge($param, ['type' => 'param']);
         $this->params[$key] = $param;