instantsearch.js 4.32.0 → 4.33.0

package/es/connectors/powered-by/connectPoweredBy.js

@@ -4,7 +4,7 @@ function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { va
 
 function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
 
-import { checkRendering, createDocumentationMessageGenerator, noop } from '../../lib/utils';
+import { safelyRunOnBrowser, checkRendering, createDocumentationMessageGenerator, noop } from '../../lib/utils';
 var withUsage = createDocumentationMessageGenerator({
   name: 'powered-by',
   connector: true
@@ -17,11 +17,20 @@ var withUsage = createDocumentationMessageGenerator({
 var connectPoweredBy = function connectPoweredBy(renderFn) {
   var unmountFn = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : noop;
   checkRendering(renderFn, withUsage());
-  var defaultUrl = 'https://www.algolia.com/?' + 'utm_source=instantsearch.js&' + 'utm_medium=website&' + "utm_content=".concat(typeof window !== 'undefined' && window.location ? window.location.hostname : '', "&") + 'utm_campaign=poweredby';
+  var defaultUrl = 'https://www.algolia.com/?' + 'utm_source=instantsearch.js&' + 'utm_medium=website&' + "utm_content=".concat(safelyRunOnBrowser(function (_ref) {
+    var _window$location;
+
+    var window = _ref.window;
+    return ((_window$location = window.location) === null || _window$location === void 0 ? void 0 : _window$location.hostname) || '';
+  }, {
+    fallback: function fallback() {
+      return '';
+    }
+  }), "&") + 'utm_campaign=poweredby';
   return function (widgetParams) {
-    var _ref = widgetParams || {},
-        _ref$url = _ref.url,
-        url = _ref$url === void 0 ? defaultUrl : _ref$url;
+    var _ref2 = widgetParams || {},
+        _ref2$url = _ref2.url,
+        url = _ref2$url === void 0 ? defaultUrl : _ref2$url;
 
     return {
       $$type: 'ais.poweredBy',

package/es/lib/InstantSearch.js

@@ -501,15 +501,17 @@ var InstantSearch = /*#__PURE__*/function (_EventEmitter) {
       var nextUiState = typeof uiState === 'function' ? uiState(this.mainIndex.getWidgetUiState({})) : uiState;
 
       var setIndexHelperState = function setIndexHelperState(indexWidget) {
+        var nextIndexUiState = nextUiState[indexWidget.getIndexId()] || {};
+
         if (process.env.NODE_ENV === 'development') {
           checkIndexUiState({
             index: indexWidget,
-            indexUiState: nextUiState[indexWidget.getIndexId()]
+            indexUiState: nextIndexUiState
           });
         }
 
         indexWidget.getHelper().setState(indexWidget.getWidgetSearchParameters(indexWidget.getHelper().state, {
-          uiState: nextUiState[indexWidget.getIndexId()]
+          uiState: nextIndexUiState
         }));
         indexWidget.getWidgets().filter(isIndexWidget).forEach(setIndexHelperState);
       };

package/es/lib/infiniteHitsCache/sessionStorage.js

@@ -2,7 +2,7 @@ function _objectWithoutProperties(source, excluded) { if (source == null) return
 
 function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
 
-import { isEqual } from '../utils';
+import { isEqual, safelyRunOnBrowser } from '../utils';
 
 function getStateWithoutPage(state) {
   var _ref = state || {},
@@ -13,28 +13,27 @@ function getStateWithoutPage(state) {
 }
 
 var KEY = 'ais.infiniteHits';
-
-function hasSessionStorage() {
-  return typeof window !== 'undefined' && typeof window.sessionStorage !== 'undefined';
-}
-
 export default function createInfiniteHitsSessionStorageCache() {
   return {
     read: function read(_ref2) {
       var state = _ref2.state;
+      var sessionStorage = safelyRunOnBrowser(function (_ref3) {
+        var window = _ref3.window;
+        return window.sessionStorage;
+      });
 
-      if (!hasSessionStorage()) {
+      if (!sessionStorage) {
         return null;
       }
 
       try {
         var cache = JSON.parse( // @ts-expect-error JSON.parse() requires a string, but it actually accepts null, too.
-        window.sessionStorage.getItem(KEY));
+        sessionStorage.getItem(KEY));
         return cache && isEqual(cache.state, getStateWithoutPage(state)) ? cache.hits : null;
       } catch (error) {
         if (error instanceof SyntaxError) {
           try {
-            window.sessionStorage.removeItem(KEY);
+            sessionStorage.removeItem(KEY);
           } catch (err) {// do nothing
           }
         }
@@ -42,16 +41,20 @@ export default function createInfiniteHitsSessionStorageCache() {
         return null;
       }
     },
-    write: function write(_ref3) {
-      var state = _ref3.state,
-          hits = _ref3.hits;
+    write: function write(_ref4) {
+      var state = _ref4.state,
+          hits = _ref4.hits;
+      var sessionStorage = safelyRunOnBrowser(function (_ref5) {
+        var window = _ref5.window;
+        return window.sessionStorage;
+      });
 
-      if (!hasSessionStorage()) {
+      if (!sessionStorage) {
         return;
       }
 
       try {
-        window.sessionStorage.setItem(KEY, JSON.stringify({
+        sessionStorage.setItem(KEY, JSON.stringify({
           state: getStateWithoutPage(state),
           hits: hits
         }));

package/es/lib/routers/history.d.ts

@@ -14,6 +14,7 @@ declare type BrowserHistoryArgs<TRouteState> = {
     writeDelay: number;
     createURL: CreateURL<TRouteState>;
     parseURL: ParseURL<TRouteState>;
+    getLocation(): Location;
 };
 declare class BrowserHistory<TRouteState> implements Router<TRouteState> {
     /**
@@ -38,13 +39,23 @@ declare class BrowserHistory<TRouteState> implements Router<TRouteState> {
      * It should be symmetrical to `createURL`.
      */
     private readonly parseURL;
+    /**
+     * Returns the location to store in the history.
+     * @default () => window.location
+     */
+    private readonly getLocation;
     private writeTimer?;
     private _onPopState;
+    /**
+     * Indicates if history.pushState should be executed.
+     * It needs to avoid pushing state to history in case of back/forward in browser
+     */
+    private shouldPushState;
     /**
      * Initializes a new storage provider that syncs the search state to the URL
      * using web APIs (`window.location.pushState` and `onpopstate` event).
      */
-    constructor({ windowTitle, writeDelay, createURL, parseURL, }: BrowserHistoryArgs<TRouteState>);
+    constructor({ windowTitle, writeDelay, createURL, parseURL, getLocation, }: BrowserHistoryArgs<TRouteState>);
     /**
      * Reads the URL and returns a syncable UI search state.
      */
@@ -71,5 +82,5 @@ declare class BrowserHistory<TRouteState> implements Router<TRouteState> {
      */
     dispose(): void;
 }
-export default function historyRouter<TRouteState = UiState>({ createURL, parseURL, writeDelay, windowTitle, }?: Partial<BrowserHistoryArgs<TRouteState>>): BrowserHistory<TRouteState>;
+export default function historyRouter<TRouteState = UiState>({ createURL, parseURL, writeDelay, windowTitle, getLocation, }?: Partial<BrowserHistoryArgs<TRouteState>>): BrowserHistory<TRouteState>;
 export {};

package/es/lib/routers/history.js

@@ -7,9 +7,12 @@ function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _d
 function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
 
 import qs from 'qs';
+import { safelyRunOnBrowser } from '../utils';
 
 var setWindowTitle = function setWindowTitle(title) {
   if (title) {
+    // This function is only executed on browsers so we can disable this check.
+    // eslint-disable-next-line no-restricted-globals
     window.document.title = title;
   }
 };
@@ -20,11 +23,14 @@ var BrowserHistory = /*#__PURE__*/function () {
    * using web APIs (`window.location.pushState` and `onpopstate` event).
    */
   function BrowserHistory(_ref) {
+    var _this = this;
+
     var windowTitle = _ref.windowTitle,
         _ref$writeDelay = _ref.writeDelay,
         writeDelay = _ref$writeDelay === void 0 ? 400 : _ref$writeDelay,
         createURL = _ref.createURL,
-        parseURL = _ref.parseURL;
+        parseURL = _ref.parseURL,
+        getLocation = _ref.getLocation;
 
     _classCallCheck(this, BrowserHistory);
 
@@ -36,15 +42,23 @@ var BrowserHistory = /*#__PURE__*/function () {
 
     _defineProperty(this, "parseURL", void 0);
 
+    _defineProperty(this, "getLocation", void 0);
+
     _defineProperty(this, "writeTimer", void 0);
 
+    _defineProperty(this, "shouldPushState", true);
+
     this.windowTitle = windowTitle;
     this.writeTimer = undefined;
     this.writeDelay = writeDelay;
     this._createURL = createURL;
     this.parseURL = parseURL;
-    var title = this.windowTitle && this.windowTitle(this.read());
-    setWindowTitle(title);
+    this.getLocation = getLocation;
+    safelyRunOnBrowser(function () {
+      var title = _this.windowTitle && _this.windowTitle(_this.read());
+
+      setWindowTitle(title);
+    });
   }
   /**
    * Reads the URL and returns a syncable UI search state.
@@ -56,7 +70,7 @@ var BrowserHistory = /*#__PURE__*/function () {
     value: function read() {
       return this.parseURL({
         qsModule: qs,
-        location: window.location
+        location: this.getLocation()
       });
     }
     /**
@@ -66,20 +80,30 @@ var BrowserHistory = /*#__PURE__*/function () {
   }, {
     key: "write",
     value: function write(routeState) {
-      var _this = this;
+      var _this2 = this;
 
-      var url = this.createURL(routeState);
-      var title = this.windowTitle && this.windowTitle(routeState);
+      safelyRunOnBrowser(function (_ref2) {
+        var window = _ref2.window;
 
-      if (this.writeTimer) {
-        window.clearTimeout(this.writeTimer);
-      }
+        var url = _this2.createURL(routeState);
+
+        var title = _this2.windowTitle && _this2.windowTitle(routeState);
+
+        if (_this2.writeTimer) {
+          clearTimeout(_this2.writeTimer);
+        }
+
+        _this2.writeTimer = setTimeout(function () {
+          setWindowTitle(title);
+
+          if (_this2.shouldPushState) {
+            window.history.pushState(routeState, title || '', url);
+          }
 
-      this.writeTimer = window.setTimeout(function () {
-        setWindowTitle(title);
-        window.history.pushState(routeState, title || '', url);
-        _this.writeTimer = undefined;
-      }, this.writeDelay);
+          _this2.shouldPushState = true;
+          _this2.writeTimer = undefined;
+        }, _this2.writeDelay);
+      });
     }
     /**
      * Sets a callback on the `onpopstate` event of the history API of the current page.
@@ -89,26 +113,30 @@ var BrowserHistory = /*#__PURE__*/function () {
   }, {
     key: "onUpdate",
     value: function onUpdate(callback) {
-      var _this2 = this;
+      var _this3 = this;
 
       this._onPopState = function (event) {
-        if (_this2.writeTimer) {
-          window.clearTimeout(_this2.writeTimer);
-          _this2.writeTimer = undefined;
+        if (_this3.writeTimer) {
+          clearTimeout(_this3.writeTimer);
+          _this3.writeTimer = undefined;
         }
 
+        _this3.shouldPushState = false;
         var routeState = event.state; // At initial load, the state is read from the URL without update.
         // Therefore the state object is not available.
         // In this case, we fallback and read the URL.
 
         if (!routeState) {
-          callback(_this2.read());
+          callback(_this3.read());
         } else {
           callback(routeState);
         }
       };
 
-      window.addEventListener('popstate', this._onPopState);
+      safelyRunOnBrowser(function (_ref3) {
+        var window = _ref3.window;
+        window.addEventListener('popstate', _this3._onPopState);
+      });
     }
     /**
      * Creates a complete URL from a given syncable UI state.
@@ -124,7 +152,7 @@ var BrowserHistory = /*#__PURE__*/function () {
       return this._createURL({
         qsModule: qs,
         routeState: routeState,
-        location: window.location
+        location: this.getLocation()
       });
     }
     /**
@@ -134,12 +162,18 @@ var BrowserHistory = /*#__PURE__*/function () {
   }, {
     key: "dispose",
     value: function dispose() {
-      if (this._onPopState) {
-        window.removeEventListener('popstate', this._onPopState);
-      }
+      var _this4 = this;
+
+      safelyRunOnBrowser(function (_ref4) {
+        var window = _ref4.window;
+
+        if (_this4._onPopState) {
+          window.removeEventListener('popstate', _this4._onPopState);
+        }
+      });
 
       if (this.writeTimer) {
-        window.clearTimeout(this.writeTimer);
+        clearTimeout(this.writeTimer);
       }
 
       this.write({});
@@ -150,12 +184,12 @@ var BrowserHistory = /*#__PURE__*/function () {
 }();
 
 export default function historyRouter() {
-  var _ref2 = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {},
-      _ref2$createURL = _ref2.createURL,
-      createURL = _ref2$createURL === void 0 ? function (_ref3) {
-    var qsModule = _ref3.qsModule,
-        routeState = _ref3.routeState,
-        location = _ref3.location;
+  var _ref5 = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {},
+      _ref5$createURL = _ref5.createURL,
+      createURL = _ref5$createURL === void 0 ? function (_ref6) {
+    var qsModule = _ref6.qsModule,
+        routeState = _ref6.routeState,
+        location = _ref6.location;
     var protocol = location.protocol,
         hostname = location.hostname,
         _location$port = location.port,
@@ -171,11 +205,11 @@ export default function historyRouter() {
     }
 
     return "".concat(protocol, "//").concat(hostname).concat(portWithPrefix).concat(pathname, "?").concat(queryString).concat(hash);
-  } : _ref2$createURL,
-      _ref2$parseURL = _ref2.parseURL,
-      parseURL = _ref2$parseURL === void 0 ? function (_ref4) {
-    var qsModule = _ref4.qsModule,
-        location = _ref4.location;
+  } : _ref5$createURL,
+      _ref5$parseURL = _ref5.parseURL,
+      parseURL = _ref5$parseURL === void 0 ? function (_ref7) {
+    var qsModule = _ref7.qsModule,
+        location = _ref7.location;
     // `qs` by default converts arrays with more than 20 items to an object.
     // We want to avoid this because the data structure manipulated can therefore vary.
     // Setting the limit to `100` seems a good number because the engine's default is 100
@@ -189,15 +223,27 @@ export default function historyRouter() {
     return qsModule.parse(location.search.slice(1), {
       arrayLimit: 99
     });
-  } : _ref2$parseURL,
-      _ref2$writeDelay = _ref2.writeDelay,
-      writeDelay = _ref2$writeDelay === void 0 ? 400 : _ref2$writeDelay,
-      windowTitle = _ref2.windowTitle;
+  } : _ref5$parseURL,
+      _ref5$writeDelay = _ref5.writeDelay,
+      writeDelay = _ref5$writeDelay === void 0 ? 400 : _ref5$writeDelay,
+      windowTitle = _ref5.windowTitle,
+      _ref5$getLocation = _ref5.getLocation,
+      getLocation = _ref5$getLocation === void 0 ? function () {
+    return safelyRunOnBrowser(function (_ref8) {
+      var window = _ref8.window;
+      return window.location;
+    }, {
+      fallback: function fallback() {
+        throw new Error('You need to provide `getLocation` to the `history` router in environments where `window` does not exist.');
+      }
+    });
+  } : _ref5$getLocation;
 
   return new BrowserHistory({
     createURL: createURL,
     parseURL: parseURL,
     writeDelay: writeDelay,
-    windowTitle: windowTitle
+    windowTitle: windowTitle,
+    getLocation: getLocation
   });
 }

package/es/lib/utils/detect-insights-client.js

@@ -1,3 +1,11 @@
+import { safelyRunOnBrowser } from './safelyRunOnBrowser';
 export default function hasDetectedInsightsClient() {
-  return typeof window !== 'undefined' && Boolean(window.AlgoliaAnalyticsObject);
+  return safelyRunOnBrowser(function (_ref) {
+    var window = _ref.window;
+    return Boolean(window.AlgoliaAnalyticsObject);
+  }, {
+    fallback: function fallback() {
+      return false;
+    }
+  });
 }

package/es/lib/utils/index.d.ts

@@ -45,3 +45,4 @@ export { createConcurrentSafePromise } from './createConcurrentSafePromise';
 export { debounce } from './debounce';
 export { serializePayload, deserializePayload } from './serializer';
 export { getWidgetAttribute } from './getWidgetAttribute';
+export { safelyRunOnBrowser } from './safelyRunOnBrowser';

package/es/lib/utils/index.js

@@ -44,4 +44,5 @@ export { convertNumericRefinementsToFilters } from './convertNumericRefinementsT
 export { createConcurrentSafePromise } from './createConcurrentSafePromise';
 export { debounce } from './debounce';
 export { serializePayload, deserializePayload } from './serializer';
-export { getWidgetAttribute } from './getWidgetAttribute';
+export { getWidgetAttribute } from './getWidgetAttribute';
+export { safelyRunOnBrowser } from './safelyRunOnBrowser';

package/es/lib/utils/safelyRunOnBrowser.d.ts

@@ -0,0 +1,14 @@
+declare type BrowserCallback<TReturn> = (params: {
+    window: typeof window;
+}) => TReturn;
+declare type SafelyRunOnBrowserOptions<TReturn> = {
+    /**
+     * Fallback to run on server environments.
+     */
+    fallback: () => TReturn;
+};
+/**
+ * Runs code on browser enviromnents safely.
+ */
+export declare function safelyRunOnBrowser<TReturn>(callback: BrowserCallback<TReturn>, { fallback }?: SafelyRunOnBrowserOptions<TReturn>): TReturn;
+export {};

package/es/lib/utils/safelyRunOnBrowser.js

@@ -0,0 +1,23 @@
+// eslint-disable-next-line no-restricted-globals
+
+/**
+ * Runs code on browser enviromnents safely.
+ */
+export function safelyRunOnBrowser(callback) {
+  var _ref = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {
+    fallback: function fallback() {
+      return undefined;
+    }
+  },
+      fallback = _ref.fallback;
+
+  // eslint-disable-next-line no-restricted-globals
+  if (typeof window === 'undefined') {
+    return fallback();
+  } // eslint-disable-next-line no-restricted-globals
+
+
+  return callback({
+    window: window
+  });
+}

package/es/lib/version.d.ts

@@ -1,2 +1,2 @@
-declare const _default: "4.32.0";
+declare const _default: "4.33.0";
 export default _default;

package/es/lib/version.js

@@ -1 +1 @@
-export default '4.32.0';
+export default '4.33.0';

package/es/lib/voiceSearchHelper/index.js

@@ -4,6 +4,11 @@ function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { va
 
 function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
 
+// `SpeechRecognition` is an API used on the browser so we can safely disable
+// the `window` check.
+
+/* eslint-disable no-restricted-globals */
+
 /* global SpeechRecognition SpeechRecognitionEvent */
 var createVoiceSearchHelper = function createVoiceSearchHelper(_ref) {
   var searchAsYouSpeak = _ref.searchAsYouSpeak,

package/es/middlewares/createMetadataMiddleware.js

@@ -1,3 +1,5 @@
+import { safelyRunOnBrowser } from '../lib/utils';
+
 function extractPayload(widgets, instantSearchInstance, payload) {
   var parent = instantSearchInstance.mainIndex;
   var initOptions = {
@@ -43,7 +45,14 @@ function extractPayload(widgets, instantSearchInstance, payload) {
 }
 
 export function isMetadataEnabled() {
-  return typeof window !== 'undefined' && window.navigator.userAgent.indexOf('Algolia Crawler') > -1;
+  return safelyRunOnBrowser(function (_ref) {
+    var window = _ref.window;
+    return window.navigator.userAgent.indexOf('Algolia Crawler') > -1;
+  }, {
+    fallback: function fallback() {
+      return false;
+    }
+  });
 }
 /**
  * Exposes the metadata of mounted widgets in a custom
@@ -54,8 +63,8 @@ export function isMetadataEnabled() {
  */
 
 export function createMetadataMiddleware() {
-  return function (_ref) {
-    var instantSearchInstance = _ref.instantSearchInstance;
+  return function (_ref2) {
+    var instantSearchInstance = _ref2.instantSearchInstance;
     var payload = {
       widgets: []
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "instantsearch.js",
-  "version": "4.32.0",
+  "version": "4.33.0",
   "description": "InstantSearch.js is a JavaScript library for building performant and instant search experiences with Algolia.",
   "homepage": "https://www.algolia.com/doc/guides/building-search-ui/what-is-instantsearch/js/",
   "types": "es/index.d.ts",
@@ -150,7 +150,7 @@
   "bundlesize": [
     {
       "path": "./dist/instantsearch.production.min.js",
-      "maxSize": "69 kB"
+      "maxSize": "69.25 kB"
     },
     {
       "path": "./dist/instantsearch.development.js",