Allow for querying with operationName

README.md

@@ -163,6 +163,17 @@ client.query(query, vars).then(result => {
 });
 ```
 
+### Querying With OperationName
+
+Querying with an operationName will send the query string under an operationName param. This is useful for pre-defined queries on the server.
+
+```js
+client.queryWithOperationName(
+  'AllFilms',
+  { after: 'cursor' }
+)
+```
+
 ## Cache API
 
 Lokka has a built in cache. But it won't be used when you are invoking the core API. For that, you need to use following APIs:

index.js

@@ -115,6 +115,15 @@ var Lokka = function () {
 
       return this.send(queryWithFragments, vars);
     }
+  }, {
+    key: 'queryWithOperationName',
+    value: function queryWithOperationName(operationName, vars) {
+      if (!operationName) {
+        throw new Error('operationName is required!');
+      }
+
+      return this._transport.send(null, vars, operationName);
+    }
   }, {
     key: 'mutate',
     value: function mutate(query, vars) {
@@ -179,4 +188,4 @@ var Lokka = function () {
 }();
 
 exports.Lokka = Lokka;
-exports.default = Lokka;
+exports.default = Lokka;

lib/__tests__/index.js

@@ -296,6 +296,33 @@ describe('Lokka', () => {
     });
   });
 
+  describe('queryWithOperationName()', () => {
+    describe('called without an operationName', () => {
+      it('should throw an error', () => {
+        const lokka = new Lokka({transport: new EchoTransport()});
+        expect(() => lokka.queryWithOperationName()).to.throw(/operationName is required!/);
+      });
+    });
+
+    describe('called with an operationName', () => {
+      it('should add vars to the query', async () => {
+        const lokka = new Lokka({transport: new EchoTransport()});
+        const operationNameDef = 'AllPosts';
+        const vars = {after: 'cursor'};
+
+        lokka._transport.send = (q, v, oN) => {
+          expect(q).to.be.equal(null);
+          expect(v).to.deep.equal(vars);
+          expect(trimIt(oN)).to.be.equal(trimIt(operationNameDef));
+          return Promise.resolve(oN);
+        };
+
+        const finalQuery = await lokka.queryWithOperationName(operationNameDef, vars);
+        expect(trimIt(finalQuery)).to.be.equal(trimIt(operationNameDef));
+      });
+    });
+  });
+
   describe('mutate()', () => {
     describe('called without a query', () => {
       it('should throw an error', () => {

lib/index.js

@@ -75,6 +75,14 @@ export class Lokka {
     return this.send(queryWithFragments, vars);
   }
 
+  queryWithOperationName(operationName, vars) {
+    if (!operationName) {
+      throw new Error('operationName is required!');
+    }
+
+    return this._transport.send(null, vars, operationName);
+  }
+
   mutate(query, vars) {
     if (!query) {
       throw new Error('query is required!');