support simple pagination

README.md

@@ -1602,6 +1602,37 @@ Query `posts(limit:10,page:1){data{id},total,per_page}` might return
 Note that you need to add in the extra 'data' object when you request paginated resources as the returned data gives you
 the paginated resources in a data object at the same level as the returned pagination metadata.
 
+[Simple Pagination](https://laravel.com/docs/pagination#simple-pagination) will be used, if a query or mutation returns a `SimplePaginationType`.
+
+```php
+namespace App\GraphQL\Queries;
+
+use Closure;
+use GraphQL\Type\Definition\ResolveInfo;
+use GraphQL\Type\Definition\Type;
+use Rebing\GraphQL\Support\Facades\GraphQL;
+use Rebing\GraphQL\Support\Query;
+
+class PostsQuery extends Query
+{
+    public function type(): Type
+    {
+        return Type::nonNull(GraphQL::simplePaginate('posts'));
+    }
+
+    // ...
+
+    public function resolve($root, $args, $context, ResolveInfo $info, Closure $getSelectFields)
+    {
+        $fields = $getSelectFields();
+
+        return Post::with($fields->getRelations())
+            ->select($fields->getSelect())
+            ->simplePaginate($args['limit'], ['*'], 'page', $args['page']);
+    }
+}
+```
+
 ### Batching
 
 You can send multiple queries (or mutations) at once by grouping them together. Therefore, instead of creating two HTTP requests:

config/config.php

@@ -169,6 +169,12 @@
      */
     'pagination_type' => \Rebing\GraphQL\Support\PaginationType::class,
 
+    /*
+     * You can define your own simple pagination type.
+     * Reference \Rebing\GraphQL\Support\SimplePaginationType::class
+     */
+    'simple_pagination_type' => \Rebing\GraphQL\Support\SimplePaginationType::class,
+
     /*
      * Config for GraphiQL (see (https://github.com/graphql/graphiql).
      */

phpstan-baseline.neon

@@ -420,6 +420,11 @@ parameters:
 			count: 1
 			path: src/Support/SelectFields.php
 
+		-
+			message: "#^Anonymous function never returns null so it can be removed from the return typehint\\.$#"
+			count: 2
+			path: src/Support/SimplePaginationType.php
+
 		-
 			message: "#^Property Rebing\\\\GraphQL\\\\Support\\\\Type\\:\\:\\$attributes has no typehint specified\\.$#"
 			count: 1

src/GraphQL.php

@@ -24,6 +24,7 @@
 use Rebing\GraphQL\Support\Contracts\ConfigConvertible;
 use Rebing\GraphQL\Support\Contracts\TypeConvertible;
 use Rebing\GraphQL\Support\PaginationType;
+use Rebing\GraphQL\Support\SimplePaginationType;
 
 class GraphQL
 {
@@ -380,6 +381,18 @@ public function paginate(string $typeName, string $customName = null): Type
         return $this->typesInstances[$name];
     }
 
+    public function simplePaginate(string $typeName, string $customName = null): Type
+    {
+        $name = $customName ?: $typeName.'SimplePagination';
+
+        if (! isset($this->typesInstances[$name])) {
+            $paginationType = config('graphql.simple_pagination_type', SimplePaginationType::class);
+            $this->wrapType($typeName, $name, $paginationType);
+        }
+
+        return $this->typesInstances[$name];
+    }
+
     /**
      * To add customs result to the query or mutations.
      *

src/Support/Facades/GraphQL.php

@@ -16,6 +16,7 @@
  * @method static ExecutionResult queryAndReturnResult(string $query, ?array $params = [], array $opts = [])
  * @method static Type type(string $name, bool $fresh = false)
  * @method static Type paginate(string $typeName, string $customName = null)
+ * @method static Type simplePaginate(string $typeName, string $customName = null)
  * @method static array<string,object|string> getTypes()
  * @method static Schema schema(Schema|array|string $schema = null)
  * @method static array getSchemas()

src/Support/SelectFields.php

@@ -182,7 +182,8 @@ protected static function handleFields(
                 $queryable = static::isQueryable($fieldObject->config);
 
                 // Pagination
-                if (is_a($parentType, config('graphql.pagination_type', PaginationType::class))) {
+                if (is_a($parentType, config('graphql.pagination_type', PaginationType::class))
+                    || is_a($parentType, config('graphql.simple_pagination_type', SimplePaginationType::class))) {
                     /* @var GraphqlType $fieldType */
                     $fieldType = $fieldObject->config['type'];
                     static::handleFields(

src/Support/SimplePaginationType.php

@@ -0,0 +1,89 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Rebing\GraphQL\Support;
+
+use GraphQL\Type\Definition\ObjectType;
+use GraphQL\Type\Definition\Type as GraphQLType;
+use Illuminate\Pagination\Paginator;
+use Illuminate\Support\Collection;
+use Rebing\GraphQL\Support\Facades\GraphQL;
+
+class SimplePaginationType extends ObjectType
+{
+    public function __construct(string $typeName, string $customName = null)
+    {
+        $name = $customName ?: $typeName.'SimplePagination';
+
+        $config = [
+            'name'   => $name,
+            'fields' => $this->getPaginationFields($typeName),
+        ];
+
+        $underlyingType = GraphQL::type($typeName);
+        if (isset($underlyingType->config['model'])) {
+            $config['model'] = $underlyingType->config['model'];
+        }
+
+        parent::__construct($config);
+    }
+
+    /**
+     * @param string $typeName
+     *
+     * @return array<string, array<string,mixed>>
+     */
+    protected function getPaginationFields(string $typeName): array
+    {
+        return [
+            'data'           => [
+                'type'        => GraphQLType::listOf(GraphQL::type($typeName)),
+                'description' => 'List of items on the current page',
+                'resolve'     => function (Paginator $data): Collection {
+                    return $data->getCollection();
+                },
+            ],
+            'per_page'       => [
+                'type'        => GraphQLType::nonNull(GraphQLType::int()),
+                'description' => 'Number of items returned per page',
+                'resolve'     => function (Paginator $data): int {
+                    return $data->perPage();
+                },
+                'selectable'  => false,
+            ],
+            'current_page'   => [
+                'type'        => GraphQLType::nonNull(GraphQLType::int()),
+                'description' => 'Current page of the cursor',
+                'resolve'     => function (Paginator $data): int {
+                    return $data->currentPage();
+                },
+                'selectable'  => false,
+            ],
+            'from'           => [
+                'type'        => GraphQLType::int(),
+                'description' => 'Number of the first item returned',
+                'resolve'     => function (Paginator $data): ?int {
+                    return $data->firstItem();
+                },
+                'selectable'  => false,
+            ],
+            'to'             => [
+                'type'        => GraphQLType::int(),
+                'description' => 'Number of the last item returned',
+                'resolve'     => function (Paginator $data): ?int {
+                    return $data->lastItem();
+                },
+                'selectable'  => false,
+            ],
+            'has_more_pages' => [
+                'type'        => GraphQLType::nonNull(GraphQLType::boolean()),
+                'description' => 'Determines if cursor has more pages after the current page',
+                'resolve'     => function (Paginator $data): bool {
+                    return $data->hasMorePages();
+                },
+                'selectable'  => false,
+            ],
+        ];
+    }
+}

tests/Database/SelectFields/PrimaryKeyTests/PrimaryKeySimplePaginationQuery.php

@@ -0,0 +1,52 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Rebing\GraphQL\Tests\Database\SelectFields\PrimaryKeyTests;
+
+use Closure;
+use GraphQL\Type\Definition\ResolveInfo;
+use GraphQL\Type\Definition\Type;
+use Illuminate\Contracts\Pagination\Paginator;
+use Rebing\GraphQL\Support\Facades\GraphQL;
+use Rebing\GraphQL\Support\Query;
+use Rebing\GraphQL\Support\SelectFields;
+use Rebing\GraphQL\Tests\Support\Models\Post;
+
+class PrimaryKeySimplePaginationQuery extends Query
+{
+    /**
+     * @var array<string, string>
+     */
+    protected $attributes = [
+        'name' => 'primaryKeySimplePaginationQuery',
+    ];
+
+    /**
+     * @return Type
+     */
+    public function type(): Type
+    {
+        return GraphQL::simplePaginate('Post');
+    }
+
+    /**
+     * @param mixed       $root
+     * @param mixed       $args
+     * @param mixed       $ctx
+     * @param ResolveInfo $info
+     * @param Closure     $getSelectFields
+     *
+     * @return Paginator
+     */
+    public function resolve($root, $args, $ctx, ResolveInfo $info, Closure $getSelectFields)
+    {
+        /** @var SelectFields $selectFields */
+        $selectFields = $getSelectFields();
+
+        return Post
+            ::with($selectFields->getRelations())
+            ->select($selectFields->getSelect())
+            ->simplePaginate(1);
+    }
+}