fix: Reuse already defined schema and add Paginated Schema

Author: matiasperrone-exo

app/Http/Controllers/Apis/CountriesApiController.php

@@ -45,20 +45,7 @@ final class CountriesApiController extends JsonController
             new OA\Response(
                 response: 200,
                 description: 'Success - Returns paginated list of countries',
-                content: new OA\JsonContent(
-                    properties: [
-                        'total' => new OA\Property(property: 'total', type: 'integer', example: 195),
-                        'per_page' => new OA\Property(property: 'per_page', type: 'integer', example: 195),
-                        'current_page' => new OA\Property(property: 'current_page', type: 'integer', example: 1),
-                        'last_page' => new OA\Property(property: 'last_page', type: 'integer', example: 1),
-                        'data' => new OA\Property(
-                            property: 'data',
-                            type: 'array',
-                            items: new OA\Items(ref: "#/components/schemas/ISOElementSchema")
-                        )
-                    ],
-                    type: 'object'
-                )
+                content: new OA\JsonContent(ref: '#/components/schemas/PaginatedISOElementResponseSchema'),
             ),
             new OA\Response(response: Response::HTTP_PRECONDITION_FAILED, description: "Validation Error"),
             new OA\Response(response: Response::HTTP_NOT_FOUND, description: "Not Found"),

app/Swagger/schemas.php

@@ -385,3 +385,22 @@ class RSVPAdminAddRequestSchema {}
     ]
 )]
 class ISOElementSchema {};
+
+#[OA\Schema(
+    schema: 'PaginatedISOElementResponseSchema',
+    type: 'object',
+    allOf: [
+        new OA\Schema(ref: '#/components/schemas/PaginateDataSchemaResponse'),
+        new OA\Schema(
+            type: 'object',
+            properties: [
+                new OA\Property(
+                    property: 'data',
+                    type: 'array',
+                    items: new OA\Items(ref: "#/components/schemas/ISOElementSchema")
+                )
+            ]
+        )
+    ]
+)]
+class PaginatedISOElementResponseSchema {};