Added the ability to pass the collection name to create collection docs properly

Author: joshmurrayeu

src/Endpoint/Concerns/BuildsOpenApiPaths.php

@@ -14,6 +14,7 @@
 trait BuildsOpenApiPaths
 {
     private function buildOpenApiContent(
+        string $name,
         array $resources,
         bool $multiple = false,
         bool $included = true,
@@ -27,7 +28,7 @@ private function buildOpenApiContent(
                     'type' => 'object',
                     'required' => ['data'],
                     'properties' => array_filter([
-                        'links' => $links ? $this->buildLinksObject($item) : [],
+                        'links' => $links ? $this->buildLinksObject($name) : [],
                         'data' => $multiple ? ['type' => 'array', 'items' => $item] : $item,
                         'included' => $included ? ['type' => 'array'] : [],
                     ]),
@@ -36,10 +37,10 @@ private function buildOpenApiContent(
         ];
     }
 
-    private function buildLinksObject(array $item): array
+    private function buildLinksObject(string $name): array
     {
         // @todo: maybe pull in the API or Context to return a server name?
-        $baseUri = sprintf('https://{server}/%s', $this->findResourceFromItem($item));
+        $baseUri = sprintf('https://{server}/%s', $name);
         $defaultQuery = ['page[limit]' => 10];
 
         $links = [

src/Endpoint/Create.php

@@ -118,6 +118,7 @@ public function getOpenApiPaths(Collection $collection): array
                     'requestBody' => [
                         'required' => true,
                         'content' => $this->buildOpenApiContent(
+                            $collection->name(),
                             array_map(
                                 fn($resource) => [
                                     '$ref' => "#/components/schemas/{$resource}Create",
@@ -130,6 +131,7 @@ public function getOpenApiPaths(Collection $collection): array
                         '200' => [
                             'description' => 'Resource created successfully.',
                             'content' => $this->buildOpenApiContent(
+                                $collection->name(),
                                 array_map(
                                     fn($resource) => ['$ref' => "#/components/schemas/$resource"],
                                     $collection->resources(),

src/Endpoint/Index.php

@@ -192,6 +192,7 @@ public function getOpenApiPaths(Collection $collection): array
                         '200' => [
                             'description' => 'Successful list all response.',
                             'content' => $this->buildOpenApiContent(
+                                $collection->name(),
                                 array_map(
                                     fn($resource) => ['$ref' => "#/components/schemas/$resource"],
                                     $collection->resources(),

src/Endpoint/ResourceAction.php

@@ -92,6 +92,7 @@ public function getOpenApiPaths(Collection $collection): array
                         '200' => [
                             'description' => 'Successful custom action response.',
                             'content' => $this->buildOpenApiContent(
+                                $collection->name(),
                                 array_map(
                                     fn($resource) => ['$ref' => "#/components/schemas/$resource"],
                                     $collection->resources(),

src/Endpoint/Show.php

@@ -77,6 +77,7 @@ public function getOpenApiPaths(Collection $collection): array
                         '200' => [
                             'description' => 'Successful show response.',
                             'content' => $this->buildOpenApiContent(
+                                $collection->name(),
                                 array_map(
                                     fn($resource) => ['$ref' => "#/components/schemas/$resource"],
                                     $collection->resources(),

src/Endpoint/Update.php

@@ -98,6 +98,7 @@ public function getOpenApiPaths(Collection $collection): array
                     'requestBody' => [
                         'required' => true,
                         'content' => $this->buildOpenApiContent(
+                            $collection->name(),
                             array_map(
                                 fn($resource) => [
                                     '$ref' => "#/components/schemas/{$resource}Update",
@@ -110,6 +111,7 @@ public function getOpenApiPaths(Collection $collection): array
                         '200' => [
                             'description' => 'Successful update response.',
                             'content' => $this->buildOpenApiContent(
+                                $collection->name(),
                                 array_map(
                                     fn($resource) => ['$ref' => "#/components/schemas/$resource"],
                                     $collection->resources(),