Merge remote-tracking branch 'origin/master'

CHANGELOG.md

@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## Unreleased
 
+### Added
+
+- Support fragments
+
+### Fixed
+
+- Merge fields between diverging subtrees within inline fragments
+
 ## v0.19.0
 
 ### Added

examples/polymorphic/expected/Operations/NodeWithFragments.php

@@ -0,0 +1,71 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Spawnia\Sailor\Polymorphic\Operations;
+
+/**
+ * @extends \Spawnia\Sailor\Operation<\Spawnia\Sailor\Polymorphic\Operations\NodeWithFragments\NodeWithFragmentsResult>
+ */
+class NodeWithFragments extends \Spawnia\Sailor\Operation
+{
+    /**
+     * @param string $id
+     */
+    public static function execute($id): NodeWithFragments\NodeWithFragmentsResult
+    {
+        return self::executeOperation(
+            $id,
+        );
+    }
+
+    protected static function converters(): array
+    {
+        static $converters;
+
+        return $converters ??= [
+            ['id', new \Spawnia\Sailor\Convert\NonNullConverter(new \Spawnia\Sailor\Convert\IDConverter)],
+        ];
+    }
+
+    public static function document(): string
+    {
+        return /* @lang GraphQL */ 'query NodeWithFragments($id: ID!) {
+          __typename
+          node(id: $id) {
+            __typename
+            node {
+              __typename
+              node {
+                __typename
+                id
+                ... on User {
+                  id
+                }
+              }
+            }
+            ... on Task {
+              done
+              node {
+                __typename
+                node {
+                  __typename
+                  ... on User {
+                    name
+                  }
+                }
+              }
+            }
+            ... on Post {
+              id
+              title
+            }
+          }
+        }';
+    }
+
+    public static function endpoint(): string
+    {
+        return 'polymorphic';
+    }
+}

examples/polymorphic/expected/Operations/NodeWithFragments/Node/Node/Node/Post.php

@@ -0,0 +1,42 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Spawnia\Sailor\Polymorphic\Operations\NodeWithFragments\Node\Node\Node;
+
+/**
+ * @property string $id
+ * @property string $__typename
+ */
+class Post extends \Spawnia\Sailor\ObjectLike
+{
+    /**
+     * @param string $id
+     */
+    public static function make($id): self
+    {
+        $instance = new self;
+
+        if ($id !== self::UNDEFINED) {
+            $instance->id = $id;
+        }
+        $instance->__typename = 'Node';
+
+        return $instance;
+    }
+
+    protected function converters(): array
+    {
+        static $converters;
+
+        return $converters ??= [
+            'id' => new \Spawnia\Sailor\Convert\NonNullConverter(new \Spawnia\Sailor\Convert\IDConverter),
+            '__typename' => new \Spawnia\Sailor\Convert\NonNullConverter(new \Spawnia\Sailor\Convert\StringConverter),
+        ];
+    }
+
+    public static function endpoint(): string
+    {
+        return 'polymorphic';
+    }
+}

examples/polymorphic/expected/Operations/NodeWithFragments/Node/Node/Node/Task.php

@@ -0,0 +1,42 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Spawnia\Sailor\Polymorphic\Operations\NodeWithFragments\Node\Node\Node;
+
+/**
+ * @property string $id
+ * @property string $__typename
+ */
+class Task extends \Spawnia\Sailor\ObjectLike
+{
+    /**
+     * @param string $id
+     */
+    public static function make($id): self
+    {
+        $instance = new self;
+
+        if ($id !== self::UNDEFINED) {
+            $instance->id = $id;
+        }
+        $instance->__typename = 'Node';
+
+        return $instance;
+    }
+
+    protected function converters(): array
+    {
+        static $converters;
+
+        return $converters ??= [
+            'id' => new \Spawnia\Sailor\Convert\NonNullConverter(new \Spawnia\Sailor\Convert\IDConverter),
+            '__typename' => new \Spawnia\Sailor\Convert\NonNullConverter(new \Spawnia\Sailor\Convert\StringConverter),
+        ];
+    }
+
+    public static function endpoint(): string
+    {
+        return 'polymorphic';
+    }
+}

examples/polymorphic/expected/Operations/NodeWithFragments/Node/Node/Node/User.php

@@ -0,0 +1,50 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Spawnia\Sailor\Polymorphic\Operations\NodeWithFragments\Node\Node\Node;
+
+/**
+ * @property string $id
+ * @property string $__typename
+ * @property string|null $name
+ */
+class User extends \Spawnia\Sailor\ObjectLike
+{
+    /**
+     * @param string $id
+     * @param string|null $name
+     */
+    public static function make(
+        $id,
+        $name = 'Special default value that allows Sailor to differentiate between explicitly passing null and not passing a value at all.'
+    ): self {
+        $instance = new self;
+
+        if ($id !== self::UNDEFINED) {
+            $instance->id = $id;
+        }
+        $instance->__typename = 'Node';
+        if ($name !== self::UNDEFINED) {
+            $instance->name = $name;
+        }
+
+        return $instance;
+    }
+
+    protected function converters(): array
+    {
+        static $converters;
+
+        return $converters ??= [
+            'id' => new \Spawnia\Sailor\Convert\NonNullConverter(new \Spawnia\Sailor\Convert\IDConverter),
+            '__typename' => new \Spawnia\Sailor\Convert\NonNullConverter(new \Spawnia\Sailor\Convert\StringConverter),
+            'name' => new \Spawnia\Sailor\Convert\NullConverter(new \Spawnia\Sailor\Convert\StringConverter),
+        ];
+    }
+
+    public static function endpoint(): string
+    {
+        return 'polymorphic';
+    }
+}

examples/polymorphic/expected/Operations/NodeWithFragments/Node/Node/Post.php

@@ -0,0 +1,46 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Spawnia\Sailor\Polymorphic\Operations\NodeWithFragments\Node\Node;
+
+/**
+ * @property string $__typename
+ * @property \Spawnia\Sailor\Polymorphic\Operations\NodeWithFragments\Node\Node\Node\User|\Spawnia\Sailor\Polymorphic\Operations\NodeWithFragments\Node\Node\Node\Task|\Spawnia\Sailor\Polymorphic\Operations\NodeWithFragments\Node\Node\Node\Post|null $node
+ */
+class Post extends \Spawnia\Sailor\ObjectLike
+{
+    /**
+     * @param \Spawnia\Sailor\Polymorphic\Operations\NodeWithFragments\Node\Node\Node\User|\Spawnia\Sailor\Polymorphic\Operations\NodeWithFragments\Node\Node\Node\Task|\Spawnia\Sailor\Polymorphic\Operations\NodeWithFragments\Node\Node\Node\Post|null $node
+     */
+    public static function make($node = 'Special default value that allows Sailor to differentiate between explicitly passing null and not passing a value at all.'): self
+    {
+        $instance = new self;
+
+        $instance->__typename = 'Node';
+        if ($node !== self::UNDEFINED) {
+            $instance->node = $node;
+        }
+
+        return $instance;
+    }
+
+    protected function converters(): array
+    {
+        static $converters;
+
+        return $converters ??= [
+            '__typename' => new \Spawnia\Sailor\Convert\NonNullConverter(new \Spawnia\Sailor\Convert\StringConverter),
+            'node' => new \Spawnia\Sailor\Convert\NullConverter(new \Spawnia\Sailor\Convert\PolymorphicConverter([
+            'User' => '\\Spawnia\\Sailor\\Polymorphic\\Operations\\NodeWithFragments\\Node\\Node\\Node\\User',
+            'Task' => '\\Spawnia\\Sailor\\Polymorphic\\Operations\\NodeWithFragments\\Node\\Node\\Node\\Task',
+            'Post' => '\\Spawnia\\Sailor\\Polymorphic\\Operations\\NodeWithFragments\\Node\\Node\\Node\\Post',
+        ])),
+        ];
+    }
+
+    public static function endpoint(): string
+    {
+        return 'polymorphic';
+    }
+}

examples/polymorphic/expected/Operations/NodeWithFragments/Node/Node/Task.php

@@ -0,0 +1,46 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Spawnia\Sailor\Polymorphic\Operations\NodeWithFragments\Node\Node;
+
+/**
+ * @property string $__typename
+ * @property \Spawnia\Sailor\Polymorphic\Operations\NodeWithFragments\Node\Node\Node\User|\Spawnia\Sailor\Polymorphic\Operations\NodeWithFragments\Node\Node\Node\Task|\Spawnia\Sailor\Polymorphic\Operations\NodeWithFragments\Node\Node\Node\Post|null $node
+ */
+class Task extends \Spawnia\Sailor\ObjectLike
+{
+    /**
+     * @param \Spawnia\Sailor\Polymorphic\Operations\NodeWithFragments\Node\Node\Node\User|\Spawnia\Sailor\Polymorphic\Operations\NodeWithFragments\Node\Node\Node\Task|\Spawnia\Sailor\Polymorphic\Operations\NodeWithFragments\Node\Node\Node\Post|null $node
+     */
+    public static function make($node = 'Special default value that allows Sailor to differentiate between explicitly passing null and not passing a value at all.'): self
+    {
+        $instance = new self;
+
+        $instance->__typename = 'Node';
+        if ($node !== self::UNDEFINED) {
+            $instance->node = $node;
+        }
+
+        return $instance;
+    }
+
+    protected function converters(): array
+    {
+        static $converters;
+
+        return $converters ??= [
+            '__typename' => new \Spawnia\Sailor\Convert\NonNullConverter(new \Spawnia\Sailor\Convert\StringConverter),
+            'node' => new \Spawnia\Sailor\Convert\NullConverter(new \Spawnia\Sailor\Convert\PolymorphicConverter([
+            'User' => '\\Spawnia\\Sailor\\Polymorphic\\Operations\\NodeWithFragments\\Node\\Node\\Node\\User',
+            'Task' => '\\Spawnia\\Sailor\\Polymorphic\\Operations\\NodeWithFragments\\Node\\Node\\Node\\Task',
+            'Post' => '\\Spawnia\\Sailor\\Polymorphic\\Operations\\NodeWithFragments\\Node\\Node\\Node\\Post',
+        ])),
+        ];
+    }
+
+    public static function endpoint(): string
+    {
+        return 'polymorphic';
+    }
+}

examples/polymorphic/expected/Operations/NodeWithFragments/Node/Node/User.php

@@ -0,0 +1,46 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Spawnia\Sailor\Polymorphic\Operations\NodeWithFragments\Node\Node;
+
+/**
+ * @property string $__typename
+ * @property \Spawnia\Sailor\Polymorphic\Operations\NodeWithFragments\Node\Node\Node\User|\Spawnia\Sailor\Polymorphic\Operations\NodeWithFragments\Node\Node\Node\Task|\Spawnia\Sailor\Polymorphic\Operations\NodeWithFragments\Node\Node\Node\Post|null $node
+ */
+class User extends \Spawnia\Sailor\ObjectLike
+{
+    /**
+     * @param \Spawnia\Sailor\Polymorphic\Operations\NodeWithFragments\Node\Node\Node\User|\Spawnia\Sailor\Polymorphic\Operations\NodeWithFragments\Node\Node\Node\Task|\Spawnia\Sailor\Polymorphic\Operations\NodeWithFragments\Node\Node\Node\Post|null $node
+     */
+    public static function make($node = 'Special default value that allows Sailor to differentiate between explicitly passing null and not passing a value at all.'): self
+    {
+        $instance = new self;
+
+        $instance->__typename = 'Node';
+        if ($node !== self::UNDEFINED) {
+            $instance->node = $node;
+        }
+
+        return $instance;
+    }
+
+    protected function converters(): array
+    {
+        static $converters;
+
+        return $converters ??= [
+            '__typename' => new \Spawnia\Sailor\Convert\NonNullConverter(new \Spawnia\Sailor\Convert\StringConverter),
+            'node' => new \Spawnia\Sailor\Convert\NullConverter(new \Spawnia\Sailor\Convert\PolymorphicConverter([
+            'User' => '\\Spawnia\\Sailor\\Polymorphic\\Operations\\NodeWithFragments\\Node\\Node\\Node\\User',
+            'Task' => '\\Spawnia\\Sailor\\Polymorphic\\Operations\\NodeWithFragments\\Node\\Node\\Node\\Task',
+            'Post' => '\\Spawnia\\Sailor\\Polymorphic\\Operations\\NodeWithFragments\\Node\\Node\\Node\\Post',
+        ])),
+        ];
+    }
+
+    public static function endpoint(): string
+    {
+        return 'polymorphic';
+    }
+}