define spec for graphql union

.github/ISSUE_TEMPLATE/01-compatible-certification-request.md

@@ -0,0 +1,27 @@
+---
+[Implementation Name]: Compatible Certification Request
+about: Start a request for a compatible certification 
+title: 'MicroProfile GraphQL [Version] Compatible Certification Request'
+labels: 'Certification :trophy:'
+assignees: ''
+
+---
+
+- [ ] Organization Name ("Organization") and, if applicable, URL:<br/>
+  // Add here
+- [ ] Product Name, Version and download URL (if applicable):<br/>
+  // Add here
+- [ ] Specification Name, Version and download URL:<br/>
+   // Add here
+- [ ] (Optional) TCK Version, digital SHA-256 fingerprint and download URL:<br/>
+  // Add here
+- [ ] Public URL of TCK Results Summary:<br/>
+  // Add here
+- [ ] Any Additional Specification Certification Requirements:<br/>
+  // Add here
+- [ ] Java runtime used to run the implementation:<br/>
+  // Add here
+- [ ] Summary of the information for the certification environment, operating system, cloud, ...:<br/>
+  // Add here
+- [ ] By checking this box I acknowledge that the Organization I represent accepts the terms of the [EFTL](https://www.eclipse.org/legal/tck.php).
+- [ ] By checking this box I attest that all TCK requirements have been met, including any compatibility rules.

.github/dependabot.yml

@@ -0,0 +1,10 @@
+version: 2
+updates:
+  - package-ecosystem: "maven"
+    directory: "/"
+    schedule:
+      interval: "daily"
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "daily"

.github/workflows/build.yml

@@ -12,13 +12,14 @@ jobs:
     name: build with jdk ${{matrix.java}}
 
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v3
         name: checkout
 
-      - uses: actions/setup-java@v1.3.0
+      - uses: actions/setup-java@v2
         name: set up jdk ${{matrix.java}}
         with:
+          distribution: 'adopt'
           java-version: ${{matrix.java}}
 
       - name: build with maven
-        run: mvn -B verify --file pom.xml
+        run: mvn -B verify javadoc:javadoc --file pom.xml

.gitignore

@@ -7,3 +7,18 @@
 .idea
 .DS_Store
 **/*.iml
+/api/target/
+/client/target/
+/client/api/target/
+/client/spec/target/
+/client/tck/target/
+/full/target/
+/full/api/target/
+/full/tck/target/
+/full/spec/target/
+/server/target/
+/server/api/target/
+/server/spec/target/
+/server/tck/target/
+/spec/target/
+/tck/target/

CONTRIBUTING.adoc

@@ -25,9 +25,9 @@ Do you want to contribute to this project? Here is what you can do:
 ** Make sure you have signed the https://www.eclipse.org/legal/ECA.php[Eclipse Contributor Agreement]
 * https://github.com/eclipse/microprofile-graphql/issues[Create or fix an issue].
 * https://gitter.im/eclipse/microprofile-graphql[Join us on Gitter to discuss this project].
-* Join our https://calendar.google.com/calendar/embed?src=gbnbc373ga40n0tvbl88nkc3r4%40group.calendar.google.com[weekly meeting] on Fridays at https://www.timeanddate.com/time/map/[15h30 GMT]. 
+* Join our https://calendar.google.com/calendar/embed?src=gbnbc373ga40n0tvbl88nkc3r4%40group.calendar.google.com[weekly meeting] on Fridays at https://www.timeanddate.com/time/map/[14h30 GMT]. 
 ** https://docs.google.com/document/d/1gb3jirFGrJwDZSbrtnFPVTNjPNe3Y0dUYfm-HkU1c3U/edit#heading=h.xpx6vfxuho2d[Minutes and Agenda].
-** https://ibm.webex.com/meet/andymc[Meeting room].
+** https://bluejeans.com/27833906895[Meeting room].
 * Join the discussions on the https://groups.google.com/forum/#!forum/microprofile[MicroProfile Google Group]
 * https://microprofile.io/blog/[Contribute a blog post].
 

README.asciidoc

@@ -22,20 +22,28 @@ image:https://badges.gitter.im/eclipse/microprofile-graphql.svg[link="https://gi
 
 = Microprofile GraphQL Specification
 
-Read the https://download.eclipse.org/microprofile/microprofile-graphql-1.0/microprofile-graphql.html[MicroProfile GraphQL 1.0] Specification
+Read the https://download.eclipse.org/microprofile/microprofile-graphql-1.1.0/microprofile-graphql-spec-1.1.0.html[MicroProfile GraphQL 1.1.0] Specification
 
-== Generating the API and JavaDoc
+== Structure
 
-Just enter `mvn clean install` at the command line. Maven will generate the following artifacts.
+This project consist of 3 parts:
 
-API Jar::
-The jar containing the api interfaces and classes in `/api/target`
+* link:server/README.asciidoc[Server] - The server-side of MicroProfile GraphQL.
+* link:client/README.asciidoc[Client] - The client-side of MicroProfile GraphQL.
+* link:full/README.asciidoc[Full] - The combination of Server and Client.
 
-Specification::
-The PDF and HTML will be generated in `spec/target/generated-docs/`
+Implementations can decide to implement only the Server, or only the Client, or both.
 
-TCK::
-The TCK that can be used to test your implementation
+== Use this in your project to depend on both the server and client API:
+
+[source,xml,numbered]
+----
+<dependency>
+  <groupId>org.eclipse.microprofile.graphql</groupId>
+  <artifactId>microprofile-graphql-api</artifactId>
+  <version>1.0.3</version>
+</dependency>
+----
 
 == About
 GraphQL is an open-source data query and manipulation language for APIs, and a runtime for fulfilling queries with existing data. 
@@ -74,6 +82,18 @@ MicroProfile is the optimal place to host that standard as it is open, ideally s
 This specification will focus on making it easy for developers to create a GraphQL Service/Endpoint and publish it as an API. 
 Where the data comes from (NoSQL, Relational DB, another service, etc.) is not the concern of this Proposed Specification. 
 
+== Implementations
+
+* SmallRye GraphQL - https://github.com/smallrye/smallrye-graphql (standalone implementation)
+* Open Liberty 20.0.0.6 - https://openliberty.io/blog/2020/06/05/graphql-open-liberty-20006.html
+* Quarkus 1.5 - https://quarkus.io/blog/quarkus-1-5-final-released/
+* Wildfly - https://www.wildfly.org/news/2020/08/13/Introducing-the-WildFly-GraphQL-feature-pack/
+* Helidon 2.2.0 - https://medium.com/helidon/microprofile-graphql-support-now-available-in-helidon-mp-dbc7bc0b4af
+
+== Acknowledgements
+
+This API and specification would not be possible without the enormous assistance from the https://github.com/leangen/graphql-spqr[GraphQL SPQR project].
+
 == Contributing
 
 Do you want to contribute to this project? link:CONTRIBUTING.adoc[Find out how you can help here].

client/README.asciidoc

@@ -0,0 +1,44 @@
+//
+// Copyright (c) 2020 Contributors to the Eclipse Foundation
+//
+// See the NOTICE file(s) distributed with this work for additional
+// information regarding copyright ownership.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+= Microprofile GraphQL Client Specification
+
+== Generating the API and JavaDoc
+
+Just enter `mvn clean install` at the command line. Maven will generate the following artifacts.
+
+API Jar::
+The jar containing the api interfaces and classes in `/api/target`
+
+Specification::
+The PDF and HTML will be generated in `spec/target/generated-docs/`
+
+TCK::
+The TCK that can be used to test your implementation
+
+== Use this in your project
+
+[source,xml,numbered]
+----
+<dependency>
+  <groupId>org.eclipse.microprofile.graphql</groupId>
+  <artifactId>microprofile-graphql-client-api</artifactId>
+  <version>1.0.1</version>
+</dependency>
+----

client/api/pom.xml

@@ -0,0 +1,125 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  ~ Copyright (c) 2020 Contributors to the Eclipse Foundation
+  ~
+  ~ Licensed under the Apache License, Version 2.0 (the "License");
+  ~ you may not use this file except in compliance with the License.
+  ~ You may obtain a copy of the License at
+  ~
+  ~    http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <parent>
+        <groupId>org.eclipse.microprofile.graphql</groupId>
+        <artifactId>microprofile-graphql-client</artifactId>
+        <version>2.0-SNAPSHOT</version>
+        <relativePath>../</relativePath>
+    </parent>
+
+    <artifactId>microprofile-graphql-client-api</artifactId>
+    <name>MicroProfile GraphQL Client :: API</name>
+    <description>Client-side code-first GraphQL APIs for MicroProfile :: API</description>
+
+    <dependencies>
+        <!-- API dependencies -->
+        <dependency>
+            <groupId>jakarta.json</groupId>
+            <artifactId>jakarta.json-api</artifactId>
+            <scope>provided</scope>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <plugins>
+            <plugin>
+                <artifactId>maven-resources-plugin</artifactId>
+                <version>3.2.0</version>
+                <executions>
+                    <execution>
+                        <id>copy-resources</id>
+                        <phase>validate</phase>
+                        <goals>
+                            <goal>copy-resources</goal>
+                        </goals>
+                        <configuration>
+                            <outputDirectory>${basedir}/target/apidocs/doc-files/</outputDirectory>
+                            <overwrite>true</overwrite>
+                            <resources>
+                                <resource>
+                                    <directory>src/main/javadoc/licenses/${revremark}/</directory>
+                                    <filtering>true</filtering>
+                                </resource>
+                            </resources>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-javadoc-plugin</artifactId>
+                <configuration>
+                    <failOnError>false</failOnError>
+                    <docfilessubdirs>true</docfilessubdirs>
+                    <attach>true</attach>
+                    <doclint>none</doclint>
+                    <doctitle>${project.name}</doctitle>
+                    <windowtitle>${project.name}</windowtitle>
+                    <header><![CDATA[<br>${project.name} v${project.version}]]></header>
+                    <bottom>
+                        <![CDATA[
+        Copyright &#169; ${inceptionYear} &#x2013; {currentYear} {organizationName}. All rights reserved.
+        <br>
+        Use is subject to <a href="{@docRoot}/doc-files/license.html" target="_top">license terms</a>.
+    ]]>
+                    </bottom>
+                    <tags>
+                        <tag>
+                            <name>implSpec</name>
+                            <placement>a</placement>
+                            <head>Implementation Specification:</head>
+                        </tag>
+                    </tags>
+                </configuration>
+                <executions>
+                    <execution>
+                        <id>attach-javadocs</id>
+                        <goals>
+                            <goal>jar</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+
+            <plugin>
+                <groupId>biz.aQute.bnd</groupId>
+                <artifactId>bnd-maven-plugin</artifactId>
+                <executions>
+                    <execution>
+                        <goals>
+                            <goal>bnd-process</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-jar-plugin</artifactId>
+                <configuration>
+                    <Bundle-SymbolicName>org.eclipse.microprofile.graphql.client</Bundle-SymbolicName>
+                    <Bundle-Name>MicroProfile GraphQL Client bundle</Bundle-Name>
+                    <archive>
+                        <manifestFile>${project.build.outputDirectory}/META-INF/MANIFEST.MF</manifestFile>
+                    </archive>
+                </configuration>
+            </plugin>
+        </plugins>
+    </build>
+</project>

client/api/src/main/java/org/eclipse/microprofile/graphql/client/GraphQLError.java

@@ -0,0 +1,51 @@
+/*
+ * Copyright (c) 2020 Contributors to the Eclipse Foundation
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.eclipse.microprofile.graphql.client;
+
+import java.util.List;
+import java.util.Map;
+
+public interface GraphQLError {
+
+    /**
+     * Textual description of the error, supplied by the service.
+     */
+    String getMessage();
+
+    /**
+     * List of locations in the request that correspond to this error. Each location is a map that
+     * should contain the `line` and `column` items.
+     */
+    List<Map<String, Integer>> getLocations();
+
+    /**
+     * The path to the response field where the error arose. This is represented as an array, where each item is either
+     * a string (when it represents a field), or an integer (when it represents an index).
+     */
+    Object[] getPath();
+
+    /**
+     * Contents of the `extensions` field. This is used by GraphQL services to pass extra information about the error.
+     */
+    Map<String, Object> getExtensions();
+
+    /**
+     * Any other fields beyond message, locations, path and extensions. These are discouraged by the spec,
+     * but if a GraphQL service adds them, they will appear in this map.
+     */
+    Map<String, Object> getOtherFields();
+}