add api.locator endpoint and tests (#7)

src/index.js

@@ -166,6 +166,10 @@ function forteApi(credentials, scope, options) {
     search(query, params) {
       validateArgs('search_query', arguments)
       return client.post(ApiPaths.search(scope), { params, data: query })
+    },
+    locator(query) {
+      validateArgs('locator_query', arguments)
+      return client.post(ApiPaths.locator(scope), { data: query })
     }
   }
 }
@@ -319,5 +323,10 @@ const validators = {
     if(isEmptyObject(query)) {
       throw new InvalidArgumentError('query')
     }
+  },
+  locator_query(query) {
+    if(isEmptyObject(query)) {
+      throw new InvalidArgumentError('query')
+    }
   }
 }

src/util.js

@@ -59,5 +59,8 @@ export const ApiPaths = {
   },
   search: (scope) => {
     return `/forte/search/${scope.trunk}/${scope.branch}/`
+  },
+  locator: (scope) => {
+    return `/forte/locator/${scope.trunk}`
   }
 }

test/index.js

@@ -675,6 +675,41 @@ describe('forteApi', () => {
       })
     })
   })
+
+  describe('api.locator(query)', () => {
+    const invalidQueries = [null, undefined, {}, '', () => {}]
+    invalidQueries.forEach((query) => {
+      it(`should throw for query '${JSON.stringify(query)}'`, () => {
+        assert.throws(() => { api.search(query) }, InvalidArgumentError)
+      })
+    })
+
+    const validQueries = [
+      {
+        city: 'Saint Petersburg',
+        stateProvince: 'FL',
+        countToReturn: 100,
+        radius: 100
+      },
+      {
+        postalCode: '33701',
+        countToReturn: 5,
+        radius: 100
+      }
+    ]
+
+    validQueries.forEach((query) => {
+      const expected = expectedUri(ApiPaths.locator(validTrunkAndBranchScope))
+
+      it(`should POST uri: ${expected}`, () => {
+        const getLocatorMock = mockapi.post(expected, 200)
+
+        return api.locator(query).then(() => {
+          getLocatorMock.done()
+        })
+      })
+    })
+  })
 })
 
 // only used for assert output, not actual test