add graphql-tag support

Author: f

README.md

@@ -53,6 +53,10 @@ bower install graphql.js --save
 #### Using NPM
 ```bash
 npm install graphql.js --save
+
+# or
+
+yarn add graphql.js
 ```
 
 #### Using with Rails Asset Pipeline
@@ -75,6 +79,21 @@ GraphQL.js is **isomorphic**. You can use it in both **browser and Node.js**.
 var graphql = require('graphql.js')
 ```
 
+##### Using with `graphql-tag`
+
+`[graphql-tag](https://github.com/apollographql/graphql-tag)` converts GraphQL query strings to AST. You can use `graphql-tag` with GraphQL.js
+
+```js
+var gql = require('graphql-tag')
+var graphql = require('graphql.js')
+
+// setup...
+
+graph.query(gql`query { name }`)
+```
+
+> Using `graphql-tag` will not allow you to use _auto declaration_ and _nested fragments_ syntaxes since these are not valid query syntax for GraphQL but only for this library.
+
 ## Connection
 
 Create a simple connection to your GraphQL endpoint.

graphql.js

@@ -167,6 +167,15 @@
   }
 
   GraphQLClient.prototype.processQuery = function (query, fragments) {
+    if (typeof query == 'object' && query.hasOwnProperty('kind') && query.hasOwnProperty('definitions')) {
+      // This looks like a graphql AST.
+      try {
+        var graphql = require('graphql')
+        query = graphql.print(query)
+      } catch (e) {
+        throw new Error("You tried to pass a graphql syntax tree but it cannot be compiled to string.")
+      }
+    }
     var fragmentRegexp = GraphQLClient.FRAGMENT_PATTERN
     var collectedFragments = this.collectFragments(query, fragments)
     query = query.replace(fragmentRegexp, function (_, $m) {
@@ -226,7 +235,7 @@
   }
 
   GraphQLClient.prototype.buildQuery = function (query, variables) {
-    return this.autoDeclare(this.processQuery(query, this._fragments, variables), variables)
+    return this.autoDeclare(this.processQuery(query, this._fragments), variables)
   }
 
   GraphQLClient.prototype.createSenderFunction = function (url) {