Mutation support

src/Manager.php

@@ -13,15 +13,20 @@
 class Manager
 {
     /**
-     * @var array {@link Chillu\GraphQL\TypeCreator}
+     * @var array Map of named {@link Type}
      */
     protected $types = [];
 
     /**
-     * @var array Map of {@link Chillu\GraphQL\QueryCreator}
+     * @var array Map of named arrays
      */
     protected $queries = [];
 
+    /**
+     * @var array Map of named arrays
+     */
+    protected $mutations = [];
+
     /**
      * @var callable
      */
@@ -34,6 +39,8 @@ class Manager
     public static function createFromConfig($config)
     {
         $manager = Injector::inst()->create(Manager::class);
+
+        // Types
         if ($config && array_key_exists('types', $config)) {
             foreach ($config['types'] as $name => $typeCreatorClass) {
                 $typeCreator = Injector::inst()->create($typeCreatorClass, $manager);
@@ -49,6 +56,7 @@ public static function createFromConfig($config)
             }
         }
 
+        // Queries
         if ($config && array_key_exists('queries', $config)) {
             foreach ($config['queries'] as $name => $queryCreatorClass) {
                 $queryCreator = Injector::inst()->create($queryCreatorClass, $manager);
@@ -64,6 +72,22 @@ public static function createFromConfig($config)
             }
         }
 
+        // Mutations
+        if ($config && array_key_exists('mutations', $config)) {
+            foreach ($config['mutations'] as $name => $mutationCreatorClass) {
+                $mutationCreator = Injector::inst()->create($mutationCreatorClass, $manager);
+                if (!($mutationCreator instanceof MutationCreator)) {
+                    throw new InvalidArgumentException(sprintf(
+                        'The mutation named "%s" needs to be a class extending ' . MutationCreator::class,
+                        $name
+                    ));
+                }
+
+                $mutation = $mutationCreator->toArray();
+                $manager->addMutation($mutation, $name);
+            }
+        }
+
         return $manager;
     }
 
@@ -77,8 +101,14 @@ public function schema()
             'fields' => $this->queries,
         ]);
 
+        $mutationType = new ObjectType([
+            'name' => 'Mutation',
+            'fields' => $this->mutations,
+        ]);
+
         return new Schema([
             'query' => $queryType,
+            'mutation' => $mutationType,
         ]);
     }
 
@@ -163,6 +193,25 @@ public function getQuery($name)
         return $this->queries[$name];
     }
 
+    /**
+     * @param array  $mutation
+     * @param string $name Identifier for this mutation (unique in schema)
+     */
+    public function addMutation($mutation, $name)
+    {
+        $this->mutations[$name] = $mutation;
+    }
+
+    /**
+     * @param string $name
+     *
+     * @return array
+     */
+    public function getMutation($name)
+    {
+        return $this->mutations[$name];
+    }
+
     /**
      * More verbose error display defaults.
      *

src/MutationCreator.php

@@ -0,0 +1,13 @@
+<?php
+
+namespace Chillu\GraphQL;
+
+/**
+ * Represents a GraphQL mutation.
+ *
+ * @todo Validation support
+ */
+class MutationCreator extends FieldCreator
+{
+
+}

tests/Fake/MutationCreatorFake.php

@@ -0,0 +1,15 @@
+<?php
+
+namespace Chillu\GraphQL\Tests\Fake;
+
+use Chillu\GraphQL\MutationCreator;
+
+class MutationCreatorFake extends MutationCreator
+{
+    public function type()
+    {
+        return function() {
+            return $this->manager->getType('mytype');
+        };
+    }
+}

tests/ManagerTest.php

@@ -5,6 +5,7 @@
 use Chillu\GraphQL\Manager;
 use Chillu\GraphQL\Tests\Fake\TypeCreatorFake;
 use Chillu\GraphQL\Tests\Fake\QueryCreatorFake;
+use Chillu\GraphQL\Tests\Fake\MutationCreatorFake;
 use GraphQL\Type\Definition\Type;
 use SilverStripe\Dev\SapphireTest;
 use GraphQL\Error;
@@ -19,22 +20,39 @@ public function testCreateFromConfig()
             'types' => [
                 'mytype' => TypeCreatorFake::class,
             ],
+            'queries' => [
+                'myquery' => QueryCreatorFake::class,
+            ],
+            'mutations' => [
+                'mymutation' => MutationCreatorFake::class,
+            ],
         ];
         $manager = Manager::createFromConfig($config);
         $this->assertInstanceOf(
             Type::class,
             $manager->getType('mytype')
         );
+        $this->assertInternalType(
+            'array',
+            $manager->getQuery('myquery')
+        );
+        $this->assertInternalType(
+            'array',
+            $manager->getMutation('mymutation')
+        );
     }
 
     public function testSchema()
     {
         $manager = new Manager();
         $manager->addType($this->getType($manager), 'mytype');
         $manager->addQuery($this->getQuery($manager), 'myquery');
+        $manager->addMutation($this->getMutation($manager), 'mymutation');
 
         $schema = $manager->schema();
         $this->assertInstanceOf(Schema::class, $schema);
+        $this->assertNotNull($schema->getType('TypeCreatorFake'));
+        $this->assertNotNull($schema->getMutationType()->getField('mymutation'));
         $this->assertNotNull($schema->getQueryType()->getField('myquery'));
     }
 
@@ -73,6 +91,19 @@ public function testAddQuery()
         );
     }
 
+    public function testAddMutation()
+    {
+        $manager = new Manager();
+        $mutation = $this->getMutation($manager);
+        $type = $this->getType($manager);
+        $manager->addMutation($mutation, 'mymutation');
+        $manager->addType($type, 'mytype');
+        $this->assertEquals(
+            $mutation,
+            $manager->getMutation('mymutation')
+        );
+    }
+
     public function testQueryWithError()
     {
         $mock = $this->getMockBuilder(Manager::class)
@@ -102,4 +133,9 @@ protected function getQuery(Manager $manager)
     {
         return (new QueryCreatorFake($manager))->toArray();
     }
+
+    protected function getMutation(Manager $manager)
+    {
+        return (new MutationCreatorFake($manager))->toArray();
+    }
 }