feature/add-callbacks-to-operation (#38)

Author: @vyuldashev 

* MediaType application/x-www-form-urlencoded

* add docblock

* #15 Extensions support

* #15 BaseObject getter for extension

* #15 BaseObject getter for all extensions

* #15 Extensions object, add readme for extensions

* resolve conflicts

* fix code style

* add callbacks to Operation

src/Objects/Operation.php

@@ -98,6 +98,11 @@ class Operation extends BaseObject
      */
     protected $servers;
 
+    /**
+     * @var \GoldSpecDigital\ObjectOrientedOAS\Objects\PathItem[]|null
+     */
+    protected $callbacks;
+
     /**
      * @param string|null $objectId
      * @return \GoldSpecDigital\ObjectOrientedOAS\Objects\Operation
@@ -352,6 +357,19 @@ public function servers(Server ...$servers): self
         return $instance;
     }
 
+    /**
+     * @param \GoldSpecDigital\ObjectOrientedOAS\Objects\PathItem[] $callbacks
+     * @return $this
+     */
+    public function callbacks(PathItem ...$callbacks): self
+    {
+        $instance = clone $this;
+
+        $instance->callbacks = $callbacks ?: null;
+
+        return $instance;
+    }
+
     /**
      * @return array
      */
@@ -362,6 +380,11 @@ protected function generate(): array
             $responses[$response->statusCode ?? 'default'] = $response;
         }
 
+        $callbacks = [];
+        foreach ($this->callbacks ?? [] as $callback) {
+            $callbacks[$callback->objectId] = $callback;
+        }
+
         return Arr::filter([
             'tags' => $this->tags,
             'summary' => $this->summary,
@@ -374,6 +397,7 @@ protected function generate(): array
             'deprecated' => $this->deprecated,
             'security' => $this->noSecurity ? [] : $this->security,
             'servers' => $this->servers,
+            'callbacks' => $callbacks ?: null,
         ]);
     }
 }

tests/Objects/OperationTest.php

@@ -24,6 +24,15 @@ public function create_with_all_parameters_works()
         $securityScheme = SecurityScheme::create('OAuth2')
             ->type(SecurityScheme::TYPE_OAUTH2);
 
+        $callback = PathItem::create('MyEvent')
+            ->route('{$request.query.callbackUrl}')
+            ->operations(
+                Operation::post()->requestBody(
+                    RequestBody::create()
+                        ->description('something happened')
+                )
+            );
+
         $operation = Operation::create()
             ->action(Operation::ACTION_GET)
             ->tags(Tag::create()->name('Users'))
@@ -36,7 +45,8 @@ public function create_with_all_parameters_works()
             ->responses(Response::create())
             ->deprecated()
             ->security(SecurityRequirement::create()->securityScheme($securityScheme))
-            ->servers(Server::create());
+            ->servers(Server::create())
+            ->callbacks($callback);
 
         $pathItem = PathItem::create()
             ->operations($operation);
@@ -64,6 +74,15 @@ public function create_with_all_parameters_works()
                 'servers' => [
                     [],
                 ],
+                'callbacks' => [
+                    'MyEvent' => [
+                        'post' => [
+                            'requestBody' => [
+                                'description' => 'something happened',
+                            ],
+                        ],
+                    ],
+                ],
             ],
         ], $pathItem->toArray());
     }