@urbanos/react-discovery-ui 2.1.43

package/lib/utils/http-clients.js

@@ -0,0 +1,218 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.AuthenticatedHTTPClient = void 0;
+var _axios = _interopRequireDefault(require("axios"));
+var _auth0ClientProvider = _interopRequireDefault(require("../auth/auth0-client-provider"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _regeneratorRuntime() { "use strict"; var r = _regenerator(), e = r.m(_regeneratorRuntime), t = (Object.getPrototypeOf ? Object.getPrototypeOf(e) : e.__proto__).constructor; function n(r) { var e = "function" == typeof r && r.constructor; return !!e && (e === t || "GeneratorFunction" === (e.displayName || e.name)); } var o = { throw: 1, return: 2, break: 3, continue: 3 }; function a(r) { var e, t; return function (n) { e || (e = { stop: function stop() { return t(n.a, 2); }, catch: function _catch() { return n.v; }, abrupt: function abrupt(r, e) { return t(n.a, o[r], e); }, delegateYield: function delegateYield(r, o, a) { return e.resultName = o, t(n.d, _regeneratorValues(r), a); }, finish: function finish(r) { return t(n.f, r); } }, t = function t(r, _t, o) { n.p = e.prev, n.n = e.next; try { return r(_t, o); } finally { e.next = n.n; } }), e.resultName && (e[e.resultName] = n.v, e.resultName = void 0), e.sent = n.v, e.next = n.n; try { return r.call(this, e); } finally { n.p = e.prev, n.n = e.next; } }; } return (_regeneratorRuntime = function _regeneratorRuntime() { return { wrap: function wrap(e, t, n, o) { return r.w(a(e), t, n, o && o.reverse()); }, isGeneratorFunction: n, mark: r.m, awrap: function awrap(r, e) { return new _OverloadYield(r, e); }, AsyncIterator: _regeneratorAsyncIterator, async: function async(r, e, t, o, u) { return (n(e) ? _regeneratorAsyncGen : _regeneratorAsync)(a(r), e, t, o, u); }, keys: _regeneratorKeys, values: _regeneratorValues }; })(); }
+function _regeneratorValues(e) { if (null != e) { var t = e["function" == typeof Symbol && Symbol.iterator || "@@iterator"], r = 0; if (t) return t.call(e); if ("function" == typeof e.next) return e; if (!isNaN(e.length)) return { next: function next() { return e && r >= e.length && (e = void 0), { value: e && e[r++], done: !e }; } }; } throw new TypeError(_typeof(e) + " is not iterable"); }
+function _regeneratorKeys(e) { var n = Object(e), r = []; for (var t in n) r.unshift(t); return function e() { for (; r.length;) if ((t = r.pop()) in n) return e.value = t, e.done = !1, e; return e.done = !0, e; }; }
+function _regeneratorAsync(n, e, r, t, o) { var a = _regeneratorAsyncGen(n, e, r, t, o); return a.next().then(function (n) { return n.done ? n.value : a.next(); }); }
+function _regeneratorAsyncGen(r, e, t, o, n) { return new _regeneratorAsyncIterator(_regenerator().w(r, e, t, o), n || Promise); }
+function _regeneratorAsyncIterator(t, e) { function n(r, o, i, f) { try { var c = t[r](o), u = c.value; return u instanceof _OverloadYield ? e.resolve(u.v).then(function (t) { n("next", t, i, f); }, function (t) { n("throw", t, i, f); }) : e.resolve(u).then(function (t) { c.value = t, i(c); }, function (t) { return n("throw", t, i, f); }); } catch (t) { f(t); } } var r; this.next || (_regeneratorDefine2(_regeneratorAsyncIterator.prototype), _regeneratorDefine2(_regeneratorAsyncIterator.prototype, "function" == typeof Symbol && Symbol.asyncIterator || "@asyncIterator", function () { return this; })), _regeneratorDefine2(this, "_invoke", function (t, o, i) { function f() { return new e(function (e, r) { n(t, i, e, r); }); } return r = r ? r.then(f, f) : f(); }, !0); }
+function _regenerator() { /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/babel/babel/blob/main/packages/babel-helpers/LICENSE */ var e, t, r = "function" == typeof Symbol ? Symbol : {}, n = r.iterator || "@@iterator", o = r.toStringTag || "@@toStringTag"; function i(r, n, o, i) { var c = n && n.prototype instanceof Generator ? n : Generator, u = Object.create(c.prototype); return _regeneratorDefine2(u, "_invoke", function (r, n, o) { var i, c, u, f = 0, p = o || [], y = !1, G = { p: 0, n: 0, v: e, a: d, f: d.bind(e, 4), d: function d(t, r) { return i = t, c = 0, u = e, G.n = r, a; } }; function d(r, n) { for (c = r, u = n, t = 0; !y && f && !o && t < p.length; t++) { var o, i = p[t], d = G.p, l = i[2]; r > 3 ? (o = l === n) && (u = i[(c = i[4]) ? 5 : (c = 3, 3)], i[4] = i[5] = e) : i[0] <= d && ((o = r < 2 && d < i[1]) ? (c = 0, G.v = n, G.n = i[1]) : d < l && (o = r < 3 || i[0] > n || n > l) && (i[4] = r, i[5] = n, G.n = l, c = 0)); } if (o || r > 1) return a; throw y = !0, n; } return function (o, p, l) { if (f > 1) throw TypeError("Generator is already running"); for (y && 1 === p && d(p, l), c = p, u = l; (t = c < 2 ? e : u) || !y;) { i || (c ? c < 3 ? (c > 1 && (G.n = -1), d(c, u)) : G.n = u : G.v = u); try { if (f = 2, i) { if (c || (o = "next"), t = i[o]) { if (!(t = t.call(i, u))) throw TypeError("iterator result is not an object"); if (!t.done) return t; u = t.value, c < 2 && (c = 0); } else 1 === c && (t = i.return) && t.call(i), c < 2 && (u = TypeError("The iterator does not provide a '" + o + "' method"), c = 1); i = e; } else if ((t = (y = G.n < 0) ? u : r.call(n, G)) !== a) break; } catch (t) { i = e, c = 1, u = t; } finally { f = 1; } } return { value: t, done: y }; }; }(r, o, i), !0), u; } var a = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} t = Object.getPrototypeOf; var c = [][n] ? t(t([][n]())) : (_regeneratorDefine2(t = {}, n, function () { return this; }), t), u = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(c); function f(e) { return Object.setPrototypeOf ? Object.setPrototypeOf(e, GeneratorFunctionPrototype) : (e.__proto__ = GeneratorFunctionPrototype, _regeneratorDefine2(e, o, "GeneratorFunction")), e.prototype = Object.create(u), e; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, _regeneratorDefine2(u, "constructor", GeneratorFunctionPrototype), _regeneratorDefine2(GeneratorFunctionPrototype, "constructor", GeneratorFunction), GeneratorFunction.displayName = "GeneratorFunction", _regeneratorDefine2(GeneratorFunctionPrototype, o, "GeneratorFunction"), _regeneratorDefine2(u), _regeneratorDefine2(u, o, "Generator"), _regeneratorDefine2(u, n, function () { return this; }), _regeneratorDefine2(u, "toString", function () { return "[object Generator]"; }), (_regenerator = function _regenerator() { return { w: i, m: f }; })(); }
+function _regeneratorDefine2(e, r, n, t) { var i = Object.defineProperty; try { i({}, "", {}); } catch (e) { i = 0; } _regeneratorDefine2 = function _regeneratorDefine(e, r, n, t) { function o(r, n) { _regeneratorDefine2(e, r, function (e) { return this._invoke(r, n, e); }); } r ? i ? i(e, r, { value: n, enumerable: !t, configurable: !t, writable: !t }) : e[r] = n : (o("next", 0), o("throw", 1), o("return", 2)); }, _regeneratorDefine2(e, r, n, t); }
+function _OverloadYield(e, d) { this.v = e, this.k = d; }
+function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
+function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; }
+function _classCallCheck(a, n) { if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function"); }
+function _defineProperties(e, r) { for (var t = 0; t < r.length; t++) { var o = r[t]; o.enumerable = o.enumerable || !1, o.configurable = !0, "value" in o && (o.writable = !0), Object.defineProperty(e, _toPropertyKey(o.key), o); } }
+function _createClass(e, r, t) { return r && _defineProperties(e.prototype, r), t && _defineProperties(e, t), Object.defineProperty(e, "prototype", { writable: !1 }), e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+var AuthenticatedHTTPClient = exports.AuthenticatedHTTPClient = /*#__PURE__*/function () {
+  function AuthenticatedHTTPClient() {
+    _classCallCheck(this, AuthenticatedHTTPClient);
+  }
+  return _createClass(AuthenticatedHTTPClient, null, [{
+    key: "cancelTokenSource",
+    value: function cancelTokenSource() {
+      return _axios.default.CancelToken.source();
+    }
+  }, {
+    key: "initializeClient",
+    value: function () {
+      var _initializeClient = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee() {
+        var config, authClient, isAuthenticated, token;
+        return _regeneratorRuntime().wrap(function _callee$(_context) {
+          while (1) switch (_context.prev = _context.next) {
+            case 0:
+              config = {
+                baseURL: window.DISC_API_URL,
+                headers: {},
+                validateStatus: false
+              };
+              _context.next = 3;
+              return _auth0ClientProvider.default.get();
+            case 3:
+              authClient = _context.sent;
+              _context.next = 6;
+              return authClient.isAuthenticated();
+            case 6:
+              isAuthenticated = _context.sent;
+              if (!isAuthenticated) {
+                _context.next = 13;
+                break;
+              }
+              _context.next = 10;
+              return authClient.getTokenSilently();
+            case 10:
+              token = _context.sent;
+              config.headers = Object.assign({}, config.headers, {
+                Authorization: "Bearer ".concat(token)
+              });
+              config.withCredentials = true;
+            case 13:
+              return _context.abrupt("return", _axios.default.create(config));
+            case 14:
+            case "end":
+              return _context.stop();
+          }
+        }, _callee);
+      }));
+      function initializeClient() {
+        return _initializeClient.apply(this, arguments);
+      }
+      return initializeClient;
+    }()
+  }, {
+    key: "get",
+    value: function () {
+      var _get = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee2(url) {
+        var config,
+          axiosClient,
+          _args2 = arguments;
+        return _regeneratorRuntime().wrap(function _callee2$(_context2) {
+          while (1) switch (_context2.prev = _context2.next) {
+            case 0:
+              config = _args2.length > 1 && _args2[1] !== undefined ? _args2[1] : {};
+              _context2.next = 3;
+              return AuthenticatedHTTPClient.initializeClient();
+            case 3:
+              axiosClient = _context2.sent;
+              return _context2.abrupt("return", axiosClient.get(url, config));
+            case 5:
+            case "end":
+              return _context2.stop();
+          }
+        }, _callee2);
+      }));
+      function get(_x) {
+        return _get.apply(this, arguments);
+      }
+      return get;
+    }()
+  }, {
+    key: "post",
+    value: function () {
+      var _post = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee3(url, body) {
+        var config,
+          axiosClient,
+          _args3 = arguments;
+        return _regeneratorRuntime().wrap(function _callee3$(_context3) {
+          while (1) switch (_context3.prev = _context3.next) {
+            case 0:
+              config = _args3.length > 2 && _args3[2] !== undefined ? _args3[2] : {};
+              _context3.next = 3;
+              return AuthenticatedHTTPClient.initializeClient();
+            case 3:
+              axiosClient = _context3.sent;
+              return _context3.abrupt("return", axiosClient.post(url, body, config));
+            case 5:
+            case "end":
+              return _context3.stop();
+          }
+        }, _callee3);
+      }));
+      function post(_x2, _x3) {
+        return _post.apply(this, arguments);
+      }
+      return post;
+    }()
+  }, {
+    key: "put",
+    value: function () {
+      var _put = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee4(url, body) {
+        var config,
+          axiosClient,
+          _args4 = arguments;
+        return _regeneratorRuntime().wrap(function _callee4$(_context4) {
+          while (1) switch (_context4.prev = _context4.next) {
+            case 0:
+              config = _args4.length > 2 && _args4[2] !== undefined ? _args4[2] : {};
+              _context4.next = 3;
+              return AuthenticatedHTTPClient.initializeClient();
+            case 3:
+              axiosClient = _context4.sent;
+              return _context4.abrupt("return", axiosClient.put(url, body, config));
+            case 5:
+            case "end":
+              return _context4.stop();
+          }
+        }, _callee4);
+      }));
+      function put(_x4, _x5) {
+        return _put.apply(this, arguments);
+      }
+      return put;
+    }()
+  }, {
+    key: "patch",
+    value: function () {
+      var _patch = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee5(url, body) {
+        var config,
+          axiosClient,
+          _args5 = arguments;
+        return _regeneratorRuntime().wrap(function _callee5$(_context5) {
+          while (1) switch (_context5.prev = _context5.next) {
+            case 0:
+              config = _args5.length > 2 && _args5[2] !== undefined ? _args5[2] : {};
+              _context5.next = 3;
+              return AuthenticatedHTTPClient.initializeClient();
+            case 3:
+              axiosClient = _context5.sent;
+              return _context5.abrupt("return", axiosClient.patch(url, body, config));
+            case 5:
+            case "end":
+              return _context5.stop();
+          }
+        }, _callee5);
+      }));
+      function patch(_x6, _x7) {
+        return _patch.apply(this, arguments);
+      }
+      return patch;
+    }()
+  }, {
+    key: "delete",
+    value: function () {
+      var _delete2 = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee6(url, body) {
+        var config,
+          axiosClient,
+          _args6 = arguments;
+        return _regeneratorRuntime().wrap(function _callee6$(_context6) {
+          while (1) switch (_context6.prev = _context6.next) {
+            case 0:
+              config = _args6.length > 2 && _args6[2] !== undefined ? _args6[2] : {};
+              _context6.next = 3;
+              return AuthenticatedHTTPClient.initializeClient();
+            case 3:
+              axiosClient = _context6.sent;
+              return _context6.abrupt("return", axiosClient.delete(url, body, config));
+            case 5:
+            case "end":
+              return _context6.stop();
+          }
+        }, _callee6);
+      }));
+      function _delete(_x8, _x9) {
+        return _delete2.apply(this, arguments);
+      }
+      return _delete;
+    }()
+  }]);
+}();

package/lib/utils/http-clients.test.js

@@ -0,0 +1,88 @@
+import { AuthenticatedHTTPClient } from './http-clients'
+import Auth0Client from '../auth/auth0-client-provider'
+import mockAxios from 'axios'
+
+describe('http-clients', () => {
+  const url = '/api/v1/dog'
+
+  describe('AuthenticatedHTTPClient', () => {
+    const token = 'token'
+    const fakeAuth0Client = {
+      isAuthenticated: () => Promise.resolve(false),
+      getTokenSilently: () => Promise.resolve(token)
+    }
+    beforeEach(() => {
+      Auth0Client.get = jest.fn(() => Promise.resolve(fakeAuth0Client))
+    })
+
+    describe('.get', () => {
+      it('given a custom config, it passes it along to axios', async () => {
+        const config = { myCustomConfig: true }
+
+        await AuthenticatedHTTPClient.get(url, config)
+
+        expect(mockAxios.get).toHaveBeenCalledWith(url, config)
+      })
+      it('given no custom config, it defaults the config passed to axios', async () => {
+        await AuthenticatedHTTPClient.get(url)
+
+        expect(mockAxios.get).toHaveBeenCalledWith(url, {})
+      })
+    })
+
+    describe('.post', () => {
+      const body = { stuff: true }
+      it('given a custom config, it passes it along to axios', async () => {
+        const config = { myCustomConfig: true }
+
+        await AuthenticatedHTTPClient.post(url, body, config)
+
+        expect(mockAxios.post).toHaveBeenCalledWith(url, body, config)
+      })
+      it('given no custom config, it defaults the config passed to axios', async () => {
+        await AuthenticatedHTTPClient.post(url, body)
+
+        expect(mockAxios.post).toHaveBeenCalledWith(url, body, {})
+      })
+    })
+
+    describe('.initializeClient', () => {
+      let client
+
+      describe('isAuthenticated is true', () => {
+        beforeEach(async () => {
+          fakeAuth0Client.isAuthenticated = () => Promise.resolve(true)
+          client = await AuthenticatedHTTPClient.initializeClient()
+        })
+
+        it('defaults the base url to the value in global config', () => {
+          expect(client.defaults.baseURL).not.toBe(undefined)
+          expect(client.defaults.baseURL).toBe(window.DISC_API_URL)
+        })
+
+        it('sets the client to send cross-domain auth headers, etc.', () => {
+          expect(client.defaults.withCredentials).toBeTruthy()
+        })
+
+        it('sends an auth header', () => {
+          expect(client.defaults.headers.Authorization).toBe(`Bearer ${token}`)
+        })
+      })
+
+      describe('isAuthenticated is false', () => {
+        beforeEach(async () => {
+          fakeAuth0Client.isAuthenticated = () => Promise.resolve(false)
+          client = await AuthenticatedHTTPClient.initializeClient()
+        })
+
+        it('sets the client to send cross-domain auth headers, etc.', () => {
+          expect(client.defaults.withCredentials).toBeFalsy()
+        })
+
+        it('sends an auth header', () => {
+          expect(client.defaults.headers.Authorization).toBe(undefined)
+        })
+      })
+    })
+  })
+})

package/lib/utils/index.js

@@ -0,0 +1,34 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "GeoJsonUtils", {
+  enumerable: true,
+  get: function get() {
+    return _geojsonUtils.default;
+  }
+});
+Object.defineProperty(exports, "ModifiedDateStringBuilder", {
+  enumerable: true,
+  get: function get() {
+    return _modifiedDateStringBuilder.default;
+  }
+});
+Object.defineProperty(exports, "QueryStringBuilder", {
+  enumerable: true,
+  get: function get() {
+    return _queryStringBuilder.default;
+  }
+});
+Object.defineProperty(exports, "RecommendationUtils", {
+  enumerable: true,
+  get: function get() {
+    return _recommendationUtils.default;
+  }
+});
+var _queryStringBuilder = _interopRequireDefault(require("./query-string-builder"));
+var _geojsonUtils = _interopRequireDefault(require("./geojson-utils"));
+var _modifiedDateStringBuilder = _interopRequireDefault(require("./modified-date-string-builder"));
+var _recommendationUtils = _interopRequireDefault(require("./recommendation-utils"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }

package/lib/utils/modified-date-string-builder.js

@@ -0,0 +1,29 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _luxon = require("luxon");
+var NO_DATE_MESSAGE = 'Date not provided';
+var createDateString = function createDateString(dataset) {
+  switch (dataset.sourceType) {
+    case 'remote':
+      return 'Updates to remote datasets are not tracked';
+    case 'ingest':
+      return buildDate(dataset.modified, _luxon.DateTime.DATE_MED) + ' (Last updated by provider)';
+    case 'stream':
+      return buildDate(dataset.lastUpdatedDate, _luxon.DateTime.DATE_MED) + ' (Last Ingested)';
+    default:
+      return NO_DATE_MESSAGE;
+  }
+};
+var buildDate = function buildDate(date, format) {
+  if (!date) return NO_DATE_MESSAGE;
+  return _luxon.DateTime.fromISO(date, {
+    zone: 'utc'
+  }).endOf("day").setZone('local').toLocaleString(format);
+};
+var _default = exports.default = {
+  createDateString: createDateString
+};

package/lib/utils/modified-date-string-builder.test.js

@@ -0,0 +1,93 @@
+import { ModifiedDateStringBuilder } from './'
+
+describe('create date string', () => {
+  it('returns explanation for remote datasets', () => {
+    const dataset = {
+      sourceType: 'remote',
+      modified: '123',
+      lastUpdatedDate: '456'
+    }
+    const result = ModifiedDateStringBuilder.createDateString(dataset)
+
+    expect(result).toEqual('Updates to remote datasets are not tracked')
+  })
+
+  it('returns explanation for ingest datasets with null date value', () => {
+    const dataset = {
+      sourceType: 'ingest',
+      modified: null,
+      lastUpdatedDate: 'yesterday'
+    }
+    const result = ModifiedDateStringBuilder.createDateString(dataset)
+
+    expect(result).toEqual('Date not provided (Last updated by provider)')
+  })
+
+  it('returns explanation for ingest datasets with empty date value', () => {
+    const dataset = {
+      sourceType: 'ingest',
+      modified: '',
+      lastUpdatedDate: 'yesterday'
+    }
+    const result = ModifiedDateStringBuilder.createDateString(dataset)
+
+    expect(result).toEqual('Date not provided (Last updated by provider)')
+  })
+
+  it('returns explanation for streaming datasets with empty date value', () => {
+    const dataset = {
+      sourceType: 'stream',
+      modified: 'tomorrow',
+      lastUpdatedDate: null
+    }
+    const result = ModifiedDateStringBuilder.createDateString(dataset)
+
+    expect(result).toEqual('Date not provided (Last Ingested)')
+  })
+
+  it('returns modified date as DATE (Last ingested) for streaming datasets', () => {
+    const dataset = {
+      sourceType: 'stream',
+      modified: 'tomorrow',
+      lastUpdatedDate: '2019-09-06T20:06:59.367752Z'
+    }
+    const result = ModifiedDateStringBuilder.createDateString(dataset)
+
+    expect(result).toEqual('Sep 6, 2019 (Last Ingested)')
+  })
+
+  it('returns modified date as DATE (Last updated by provider) for ingest datasets', () => {
+    const dataset = {
+      sourceType: 'ingest',
+      modified: '2019-08-06T20:06:59.367752Z',
+      lastUpdatedDate: 'never'
+    }
+    const result = ModifiedDateStringBuilder.createDateString(dataset)
+
+    expect(result).toEqual('Aug 6, 2019 (Last updated by provider)')
+  })
+
+  it('return update not provided message for fallthrough', () => {
+    const dataset = {
+      sourceType: 'no good',
+      modified: '2019-08-06T20:06:59.367752Z',
+      lastUpdatedDate: 'never'
+    }
+
+    const result = ModifiedDateStringBuilder.createDateString(dataset)
+
+    expect(result).toEqual('Date not provided')
+  })
+
+  it('returns invalid date message when date parsing fails', () => {
+    const dataset = {
+      sourceType: 'ingest',
+      modified: '2019-08-06TImNotADateHAHA20:06:59.367752Z',
+      lastUpdatedDate: 'never'
+    }
+
+    const result = ModifiedDateStringBuilder.createDateString(dataset)
+
+    expect(result).toEqual('Invalid DateTime (Last updated by provider)')
+  })
+})

package/lib/utils/query-string-builder.js

@@ -0,0 +1,38 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _qs = _interopRequireDefault(require("qs"));
+var _lodash = _interopRequireDefault(require("lodash"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+var createTagFilterQueryString = function createTagFilterQueryString(tags) {
+  return createFilterQueryString('tags', tags);
+};
+var createOrganizationFilterQueryString = function createOrganizationFilterQueryString(organization) {
+  return createFilterQueryString('organization', organization);
+};
+var createFilterQueryString = function createFilterQueryString(attributeName, attributeValue) {
+  return createQueryString(_defineProperty({}, attributeName, _lodash.default.castArray(attributeValue)));
+};
+function createQueryString(facets, searchCriteria, sort, apiAccessible) {
+  return _qs.default.stringify({
+    q: searchCriteria,
+    sort: sort,
+    facets: facets,
+    apiAccessible: apiAccessible
+  }, {
+    arrayFormat: 'brackets'
+  });
+}
+var _default = exports.default = {
+  createTagFilterQueryString: createTagFilterQueryString,
+  createOrganizationFilterQueryString: createOrganizationFilterQueryString,
+  createFilterQueryString: createFilterQueryString,
+  createQueryString: createQueryString
+};

package/lib/utils/query-string-builder.test.js

@@ -0,0 +1,33 @@
+import { QueryStringBuilder } from './'
+
+describe('query string builder', () => {
+  describe('createQueryString', () => {
+    test.each(
+      [
+        ['sort=name_desc&facets%5Btags%5D%5B%5D=stuff&facets%5Btags%5D%5B%5D=things&apiAccessible=false',
+          { tags: ['stuff', 'things'] }, undefined, 'name_desc', false
+        ],
+        ['sort=last_mod&facets%5Borganization%5D%5B%5D=Slime%20Jime&apiAccessible=true',
+          { organization: ['Slime Jime'] }, undefined, 'last_mod', true
+        ],
+        ['q=GREG&sort=last_mod&facets%5Borganization%5D%5B%5D=Slime%20Jime&facets%5Btags%5D%5B%5D=stuff&apiAccessible=true',
+          { organization: ['Slime Jime'], tags: ['stuff'] }, 'GREG', 'last_mod', true
+        ]
+      ]
+    )('properly encodes facets=%s, search=%s, sort=%s to a URL of %s', (expected, facets, searchCriteria, sort, apiAccessible) => {
+      expect(QueryStringBuilder.createQueryString(facets, searchCriteria, sort, apiAccessible)).toBe(expected)
+    })
+  })
+
+  test('createTagFilterQueryString properly encodes a single filter value in a list', () => {
+    expect(QueryStringBuilder.createTagFilterQueryString('stuff')).toBe('facets%5Btags%5D%5B%5D=stuff')
+  })
+
+  test('createTagFilterQueryString properly encodes multiple values in a list', () => {
+    expect(QueryStringBuilder.createTagFilterQueryString(['stuff', 'things'])).toBe('facets%5Btags%5D%5B%5D=stuff&facets%5Btags%5D%5B%5D=things')
+  })
+
+  test('createOrganizationFilterQueryString properly encodes a single value as string', () => {
+    expect(QueryStringBuilder.createOrganizationFilterQueryString('Slime Jime')).toBe('facets%5Borganization%5D%5B%5D=Slime%20Jime')
+  })
+})

package/lib/utils/recommendation-utils.js

@@ -0,0 +1,12 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var getDatasetUrl = function getDatasetUrl(recommendation) {
+  return "/dataset/".concat(recommendation.orgName, "/").concat(recommendation.dataName);
+};
+var _default = exports.default = {
+  getDatasetUrl: getDatasetUrl
+};

package/lib/utils/recommendation-utils.test.js

@@ -0,0 +1,9 @@
+import { RecommendationUtils } from './'
+import { recommendations } from '../../test-helpers/recommendations'
+
+describe('recommendation utils', () => {
+  test('return url to dataset details page', () => {
+    const expectedUrl = '/dataset/hello/world'
+    expect(RecommendationUtils.getDatasetUrl(recommendations[0])).toEqual(expectedUrl)
+  })
+})