@koine/browser 2.0.0-beta.80 → 2.0.0-beta.83

package/createStorage.cjs.js

@@ -7,95 +7,45 @@ var dom = require('@koine/dom');
 var storage = require('./storage.cjs.js');
 require('./storageClient.cjs.js');
 
-let createStorage = (config, useSessionStorage) => {
-    const client = useSessionStorage ? storage.storage.s : storage.storage.l;
-    const keys = Object.keys(config).reduce((map, key) => ({ ...map, [key]: utils.encode(key) }), {});
-    return {
-        get(key, defaultValue) {
-            return client.get(keys[key], utils.decode, defaultValue);
-        },
-        getAll(defaultValues) {
-            if (!utils.isBrowser) {
-                if (process.env["NODE_ENV"] === "development") {
-                    console.log(`[@koine/utils:createStorage] attempt to use 'getAll' outside of browser.`);
-                }
-                return {};
-            }
-            const all = {};
-            for (const key in keys) {
-                const value = this.get(key);
-                const defaultValue = defaultValues?.[key];
-                if (!utils.isNullOrUndefined(value)) {
-                    all[key] = value;
-                }
-                else if (defaultValue) {
-                    all[key] = defaultValue;
-                }
-            }
-            return all;
-        },
-        set(key, value) {
-            client.set(keys[key], value, utils.encode);
-        },
-        setMany(newValues) {
-            if (process.env["NODE_ENV"] === "development") {
-                if (!utils.isBrowser) {
-                    console.log(`[@koine/utils:createStorage] attempt to use 'setMany' outside of browser.`);
-                }
-            }
-            if (utils.isBrowser) {
-                for (const key in newValues) {
-                    const value = newValues[key];
-                    if (!utils.isNullOrUndefined(value)) {
-                        this.set(key, value);
-                    }
-                    else {
-                        this.remove(key);
-                    }
-                }
-            }
-        },
-        has(key) {
-            return client.has(keys[key]);
-        },
-        remove(key) {
-            client.remove(keys[key]);
-        },
-        clear() {
-            if (process.env["NODE_ENV"] === "development") {
-                if (!utils.isBrowser) {
-                    console.log(`[@koine/utils:createStorage] attempt to use 'clear' outside of browser.`);
-                }
-            }
-            if (utils.isBrowser) {
-                for (const key in keys) {
-                    client.remove(keys[key]);
-                }
-            }
-        },
-        watch: (keyToWatch, onRemoved, onAdded) => {
-            if (!utils.isBrowser) {
-                if (process.env["NODE_ENV"] === "development") {
-                    console.log(`[@koine/utils:createStorage] attempt to use 'watch' outside of browser.`);
-                }
-                return utils.noop;
-            }
-            const handler = (event) => {
-                const { key, oldValue, newValue } = event;
-                if (key === keys[keyToWatch]) {
-                    if (oldValue && !newValue) {
-                        onRemoved?.();
-                    }
-                    else if (!oldValue && newValue) {
-                        onAdded?.();
-                    }
-                }
-            };
-            const listener = dom.on(window, "storage", handler);
-            return listener;
-        },
-    };
-};
+/**
+ * @category storage
+ *//**
+ * Utility to create a storage instance to interact with `localStorage` using
+ * encrypted (encoded) key/values.
+ *
+ * @category storage
+ */let createStorage=(a,n)=>{let c=n?storage.storage.s:storage.storage.l,m=Object.keys(a).reduce((e,o)=>({...e,[o]:utils.encode(o)}),{});return {/**
+     * Get all storage value (it uses `localStorage.get()`).
+     *
+     * Unparseable values with `JSON.parse()` return their value as it is.
+     * On ssr or if the given `key` argument is not found `defaultValue` is
+     * returned, otherwise `null`.
+     */get:(t,o)=>c.get(m[t],utils.decode,o),/**
+     * Get all storage values (it uses `localStorage.get()`).
+     *
+     * `undefined` and `null` values are not returned.
+     */getAll(e){if(!utils.isBrowser)return "development"===process.env.NODE_ENV&&console.log("[@koine/utils:createStorage] attempt to use 'getAll' outside of browser."),{};let t={};for(let o in m){let s=this.get(o),l=e?.[o];utils.isNullOrUndefined(s)?l&&// NOTE: without the assertion typedoc does not compile
+(t[o]=l):t[o]=s;}return t},/**
+     * Set a storage value (it uses `localStorage.set()`).
+     *
+     * Non-string values are stringified with `JSON.stringify()`
+     */set(e,o){c.set(m[e],o,utils.encode);},/**
+     * Set all given storage values (it uses `localStorage.set()`).
+     *
+     * Non-string values are stringified with `JSON.stringify()`, `undefined`
+     * and `null` values are removed from the storage
+     */setMany(e){if("development"!==process.env.NODE_ENV||utils.isBrowser||console.log("[@koine/utils:createStorage] attempt to use 'setMany' outside of browser."),utils.isBrowser)for(let t in e){let o=e[t];utils.isNullOrUndefined(o)?this.remove(t):this.set(t,o);}},/**
+     * Check if a storage value is _truthy_ (it uses `localStorage.get()`).
+     */has:e=>c.has(m[e]),/**
+     * Remove a storage value (it uses `localStorage.remove()`).
+     */remove(e){c.remove(m[e]);},/**
+     * Clear all storage values (it uses `localStorage.remove()`).
+     */clear(){if("development"!==process.env.NODE_ENV||utils.isBrowser||console.log("[@koine/utils:createStorage] attempt to use 'clear' outside of browser."),utils.isBrowser)for(let e in m)c.remove(m[e]);},/**
+     * Watch a storage value changes, this needs to be executed only in browser
+     * context (it uses `window.addEventListener("storage")`).
+     *
+     * Inspiration from [Multi Tab Logout in React — Redux](https://medium.com/front-end-weekly/multi-tab-logout-in-react-redux-4715f071c7fa)
+     */watch:(e,t,r)=>utils.isBrowser?dom.on(window,"storage",o=>{let{key:s,oldValue:l,newValue:i}=o;s===m[e]&&(l&&!i?t?.():!l&&i&&r?.());}):("development"===process.env.NODE_ENV&&console.log("[@koine/utils:createStorage] attempt to use 'watch' outside of browser."),utils.noop)}};
 
 exports.createStorage = createStorage;
 exports["default"] = createStorage;

package/createStorage.d.ts

@@ -1,7 +1,7 @@
 export type CreateStorageConfig = Record<string, any>;
 export declare let createStorage: <T extends CreateStorageConfig>(config: Partial<T>, useSessionStorage?: boolean) => {
-    get<TKey extends Extract<keyof T, string>>(key: TKey, defaultValue?: T[TKey] | null | undefined): T[TKey] | null;
-    getAll(defaultValues?: Partial<T> | undefined): T;
+    get<TKey extends Extract<keyof T, string>>(key: TKey, defaultValue?: null | T[TKey]): T[TKey] | null;
+    getAll(defaultValues?: Partial<T>): T;
     set<TKey_1 extends Extract<keyof T, string>>(key: TKey_1, value?: T[TKey_1] | undefined): void;
     setMany(newValues: Partial<T>): void;
     has<TKey_2 extends Extract<keyof T, string>>(key: TKey_2): any;

package/createStorage.esm.js

@@ -3,94 +3,44 @@ import { on } from '@koine/dom';
 import { storage } from './storage.esm.js';
 import './storageClient.esm.js';
 
-let createStorage = (config, useSessionStorage) => {
-    const client = useSessionStorage ? storage.s : storage.l;
-    const keys = Object.keys(config).reduce((map, key) => ({ ...map, [key]: encode(key) }), {});
-    return {
-        get(key, defaultValue) {
-            return client.get(keys[key], decode, defaultValue);
-        },
-        getAll(defaultValues) {
-            if (!isBrowser) {
-                if (process.env["NODE_ENV"] === "development") {
-                    console.log(`[@koine/utils:createStorage] attempt to use 'getAll' outside of browser.`);
-                }
-                return {};
-            }
-            const all = {};
-            for (const key in keys) {
-                const value = this.get(key);
-                const defaultValue = defaultValues?.[key];
-                if (!isNullOrUndefined(value)) {
-                    all[key] = value;
-                }
-                else if (defaultValue) {
-                    all[key] = defaultValue;
-                }
-            }
-            return all;
-        },
-        set(key, value) {
-            client.set(keys[key], value, encode);
-        },
-        setMany(newValues) {
-            if (process.env["NODE_ENV"] === "development") {
-                if (!isBrowser) {
-                    console.log(`[@koine/utils:createStorage] attempt to use 'setMany' outside of browser.`);
-                }
-            }
-            if (isBrowser) {
-                for (const key in newValues) {
-                    const value = newValues[key];
-                    if (!isNullOrUndefined(value)) {
-                        this.set(key, value);
-                    }
-                    else {
-                        this.remove(key);
-                    }
-                }
-            }
-        },
-        has(key) {
-            return client.has(keys[key]);
-        },
-        remove(key) {
-            client.remove(keys[key]);
-        },
-        clear() {
-            if (process.env["NODE_ENV"] === "development") {
-                if (!isBrowser) {
-                    console.log(`[@koine/utils:createStorage] attempt to use 'clear' outside of browser.`);
-                }
-            }
-            if (isBrowser) {
-                for (const key in keys) {
-                    client.remove(keys[key]);
-                }
-            }
-        },
-        watch: (keyToWatch, onRemoved, onAdded) => {
-            if (!isBrowser) {
-                if (process.env["NODE_ENV"] === "development") {
-                    console.log(`[@koine/utils:createStorage] attempt to use 'watch' outside of browser.`);
-                }
-                return noop;
-            }
-            const handler = (event) => {
-                const { key, oldValue, newValue } = event;
-                if (key === keys[keyToWatch]) {
-                    if (oldValue && !newValue) {
-                        onRemoved?.();
-                    }
-                    else if (!oldValue && newValue) {
-                        onAdded?.();
-                    }
-                }
-            };
-            const listener = on(window, "storage", handler);
-            return listener;
-        },
-    };
-};
+/**
+ * @category storage
+ *//**
+ * Utility to create a storage instance to interact with `localStorage` using
+ * encrypted (encoded) key/values.
+ *
+ * @category storage
+ */let createStorage=(a,n)=>{let c=n?storage.s:storage.l,m=Object.keys(a).reduce((e,o)=>({...e,[o]:encode(o)}),{});return {/**
+     * Get all storage value (it uses `localStorage.get()`).
+     *
+     * Unparseable values with `JSON.parse()` return their value as it is.
+     * On ssr or if the given `key` argument is not found `defaultValue` is
+     * returned, otherwise `null`.
+     */get:(t,o)=>c.get(m[t],decode,o),/**
+     * Get all storage values (it uses `localStorage.get()`).
+     *
+     * `undefined` and `null` values are not returned.
+     */getAll(e){if(!isBrowser)return "development"===process.env.NODE_ENV&&console.log("[@koine/utils:createStorage] attempt to use 'getAll' outside of browser."),{};let t={};for(let o in m){let s=this.get(o),l=e?.[o];isNullOrUndefined(s)?l&&// NOTE: without the assertion typedoc does not compile
+(t[o]=l):t[o]=s;}return t},/**
+     * Set a storage value (it uses `localStorage.set()`).
+     *
+     * Non-string values are stringified with `JSON.stringify()`
+     */set(e,o){c.set(m[e],o,encode);},/**
+     * Set all given storage values (it uses `localStorage.set()`).
+     *
+     * Non-string values are stringified with `JSON.stringify()`, `undefined`
+     * and `null` values are removed from the storage
+     */setMany(e){if("development"!==process.env.NODE_ENV||isBrowser||console.log("[@koine/utils:createStorage] attempt to use 'setMany' outside of browser."),isBrowser)for(let t in e){let o=e[t];isNullOrUndefined(o)?this.remove(t):this.set(t,o);}},/**
+     * Check if a storage value is _truthy_ (it uses `localStorage.get()`).
+     */has:e=>c.has(m[e]),/**
+     * Remove a storage value (it uses `localStorage.remove()`).
+     */remove(e){c.remove(m[e]);},/**
+     * Clear all storage values (it uses `localStorage.remove()`).
+     */clear(){if("development"!==process.env.NODE_ENV||isBrowser||console.log("[@koine/utils:createStorage] attempt to use 'clear' outside of browser."),isBrowser)for(let e in m)c.remove(m[e]);},/**
+     * Watch a storage value changes, this needs to be executed only in browser
+     * context (it uses `window.addEventListener("storage")`).
+     *
+     * Inspiration from [Multi Tab Logout in React — Redux](https://medium.com/front-end-weekly/multi-tab-logout-in-react-redux-4715f071c7fa)
+     */watch:(e,t,r)=>isBrowser?on(window,"storage",o=>{let{key:s,oldValue:l,newValue:i}=o;s===m[e]&&(l&&!i?t?.():!l&&i&&r?.());}):("development"===process.env.NODE_ENV&&console.log("[@koine/utils:createStorage] attempt to use 'watch' outside of browser."),noop)}};
 
 export { createStorage, createStorage as default };

package/getZonedDate.cjs.js

@@ -4,26 +4,24 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var utils = require('@koine/utils');
 
-const utcToZonedTime = (date, _tz) => {
-    return date;
-};
-let getZonedDate = (dateString = "", timeZone) => {
-    if (!dateString.endsWith("Z"))
-        dateString += "Z";
-    if (!timeZone && utils.isBrowser) {
-        try {
-            timeZone = Intl.DateTimeFormat().resolvedOptions().timeZone;
-        }
-        catch (e) {
-            if (process.env["NODE_ENV"] === "development") {
-                console.warn("[@koine/browser:getZonedDate] failed reading timeZone, error", e);
-            }
-        }
-    }
-    return timeZone
-        ? utcToZonedTime(new Date(dateString))
-        : new Date(dateString);
-};
+// import utcToZonedTime from "date-fns-tz/utcToZonedTime";
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+let t=(e,t)=>e;/**
+ * It returns a `Date` object from a date `string` adjusted on the user timeZone,
+ * if a timeZone is not provided we try getting it from the `Intl` browwser native
+ * API. It gracefully falls back returning a _non-timezone-based_ `Date`.
+ *
+ * @category date
+ *
+ * @resources
+ * - to get the timeZone client side see [this article](https://attacomsian.com/blog/javascript-current-timezone)
+ * - for converting the date based on the time zone [date-fns docs](https://date-fns.org/v2.27.0/docs/Time-Zones) and [date-fns-tz docs](https://github.com/marnusw/date-fns-tz)
+ *
+ * @param dateString A parseable date as string, `Z` is automatically suffixed if not present to correctly get time zone based time from a UTC date.
+ * @param timeZone Optionally pass a timeZone (e.g. from user preference or from the server), it falls back trying to read it from the `Intl` browwser native API.
+ */let getZonedDate=(o="",n)=>{if(o.endsWith("Z")||(o+="Z"),!n&&utils.isBrowser)try{n=Intl.DateTimeFormat().resolvedOptions().timeZone;}catch(e){"development"===process.env.NODE_ENV&&console.warn("[@koine/browser:getZonedDate] failed reading timeZone, error",e);}// no need to do anything here, it just means `Intl` failed, probably
+// because the browser does not support it
+return n?t(new Date(o)):new Date(o)};
 
 exports["default"] = getZonedDate;
 exports.getZonedDate = getZonedDate;

package/getZonedDate.esm.js

@@ -1,24 +1,22 @@
 import { isBrowser } from '@koine/utils';
 
-const utcToZonedTime = (date, _tz) => {
-    return date;
-};
-let getZonedDate = (dateString = "", timeZone) => {
-    if (!dateString.endsWith("Z"))
-        dateString += "Z";
-    if (!timeZone && isBrowser) {
-        try {
-            timeZone = Intl.DateTimeFormat().resolvedOptions().timeZone;
-        }
-        catch (e) {
-            if (process.env["NODE_ENV"] === "development") {
-                console.warn("[@koine/browser:getZonedDate] failed reading timeZone, error", e);
-            }
-        }
-    }
-    return timeZone
-        ? utcToZonedTime(new Date(dateString))
-        : new Date(dateString);
-};
+// import utcToZonedTime from "date-fns-tz/utcToZonedTime";
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+let t=(e,t)=>e;/**
+ * It returns a `Date` object from a date `string` adjusted on the user timeZone,
+ * if a timeZone is not provided we try getting it from the `Intl` browwser native
+ * API. It gracefully falls back returning a _non-timezone-based_ `Date`.
+ *
+ * @category date
+ *
+ * @resources
+ * - to get the timeZone client side see [this article](https://attacomsian.com/blog/javascript-current-timezone)
+ * - for converting the date based on the time zone [date-fns docs](https://date-fns.org/v2.27.0/docs/Time-Zones) and [date-fns-tz docs](https://github.com/marnusw/date-fns-tz)
+ *
+ * @param dateString A parseable date as string, `Z` is automatically suffixed if not present to correctly get time zone based time from a UTC date.
+ * @param timeZone Optionally pass a timeZone (e.g. from user preference or from the server), it falls back trying to read it from the `Intl` browwser native API.
+ */let getZonedDate=(o="",n)=>{if(o.endsWith("Z")||(o+="Z"),!n&&isBrowser)try{n=Intl.DateTimeFormat().resolvedOptions().timeZone;}catch(e){"development"===process.env.NODE_ENV&&console.warn("[@koine/browser:getZonedDate] failed reading timeZone, error",e);}// no need to do anything here, it just means `Intl` failed, probably
+// because the browser does not support it
+return n?t(new Date(o)):new Date(o)};
 
 export { getZonedDate as default, getZonedDate };

package/gtag.cjs.js

@@ -4,12 +4,19 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var utils = require('@koine/utils');
 
-let gtag = (...args) => {
-    !utils.isUndefined(window) && !utils.isUndefined(window.gtag)
-        ?
-            window.gtag(...args)
-        : utils.noop();
-};
+/**
+ * @category analytics-google
+ *
+ * If you like you could add to your globals `.d.ts` types:
+ *
+ * ```ts
+ * declare interface Window {
+ *   gtag: <T extends unknown[]>(...args: T) => void;
+ * }
+ * ```
+ */let gtag=(...o)=>{// @ts-expect-error nevermind
+utils.isUndefined(window)||utils.isUndefined(window.gtag)?utils.noop():// @ts-expect-error nevermind
+window.gtag(...o);};// export type GtmEventArgs = [
 
 exports["default"] = gtag;
 exports.gtag = gtag;

package/gtag.esm.js

@@ -1,10 +1,17 @@
 import { isUndefined, noop } from '@koine/utils';
 
-let gtag = (...args) => {
-    !isUndefined(window) && !isUndefined(window.gtag)
-        ?
-            window.gtag(...args)
-        : noop();
-};
+/**
+ * @category analytics-google
+ *
+ * If you like you could add to your globals `.d.ts` types:
+ *
+ * ```ts
+ * declare interface Window {
+ *   gtag: <T extends unknown[]>(...args: T) => void;
+ * }
+ * ```
+ */let gtag=(...o)=>{// @ts-expect-error nevermind
+isUndefined(window)||isUndefined(window.gtag)?noop():// @ts-expect-error nevermind
+window.gtag(...o);};// export type GtmEventArgs = [
 
 export { gtag as default, gtag };

package/gtagPageview.cjs.js

@@ -5,11 +5,9 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var gtag = require('./gtag.cjs.js');
 require('@koine/utils');
 
-let gtagPageview = (...args) => gtag.gtag("event", "page_view", {
-    page_path: args[0] || location.pathname,
-    page_title: args[1] || document.title,
-    page_location: args[2] || location.href,
-});
+/**
+ * @category analytics-google
+ */let gtagPageview=(...t)=>gtag.gtag("event","page_view",{page_path:t[0]||location.pathname,page_title:t[1]||document.title,page_location:t[2]||location.href});// send_to: '<GA_MEASUREMENT_ID>'
 
 exports["default"] = gtagPageview;
 exports.gtagPageview = gtagPageview;

package/gtagPageview.esm.js

@@ -1,10 +1,8 @@
 import { gtag } from './gtag.esm.js';
 import '@koine/utils';
 
-let gtagPageview = (...args) => gtag("event", "page_view", {
-    page_path: args[0] || location.pathname,
-    page_title: args[1] || document.title,
-    page_location: args[2] || location.href,
-});
+/**
+ * @category analytics-google
+ */let gtagPageview=(...t)=>gtag("event","page_view",{page_path:t[0]||location.pathname,page_title:t[1]||document.title,page_location:t[2]||location.href});// send_to: '<GA_MEASUREMENT_ID>'
 
 export { gtagPageview as default, gtagPageview };

package/isIE.cjs.js

@@ -4,16 +4,11 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var utils = require('@koine/utils');
 
-let isIE = (ssrValue = true) => {
-    if (utils.isServer) {
-        return ssrValue;
-    }
-    const ua = window.navigator.userAgent;
-    if (ua.indexOf("MSIE ") > 0 || ua.indexOf("Trident/") > 0) {
-        return true;
-    }
-    return false;
-};
+/**
+ * @category detect
+ * @category is
+ * @see https://stackoverflow.com/a/21712356/12285349
+ */let isIE=(t=!0)=>{if(utils.isServer)return t;let i=window.navigator.userAgent;return !!(i.indexOf("MSIE ")>0||i.indexOf("Trident/")>0)};
 
 exports["default"] = isIE;
 exports.isIE = isIE;

package/isIE.esm.js

@@ -1,14 +1,9 @@
 import { isServer } from '@koine/utils';
 
-let isIE = (ssrValue = true) => {
-    if (isServer) {
-        return ssrValue;
-    }
-    const ua = window.navigator.userAgent;
-    if (ua.indexOf("MSIE ") > 0 || ua.indexOf("Trident/") > 0) {
-        return true;
-    }
-    return false;
-};
+/**
+ * @category detect
+ * @category is
+ * @see https://stackoverflow.com/a/21712356/12285349
+ */let isIE=(t=!0)=>{if(isServer)return t;let i=window.navigator.userAgent;return !!(i.indexOf("MSIE ")>0||i.indexOf("Trident/")>0)};
 
 export { isIE as default, isIE };

package/isMobile.cjs.js

@@ -4,10 +4,13 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var utils = require('@koine/utils');
 
-let isMobile = (ssrValue = true) => utils.isServer
-    ? ssrValue
-    :
-        /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(window.navigator.userAgent);
+/**
+ * @category detect
+ * @category is
+ * @see https://stackoverflow.com/a/3540295
+ */let isMobile=(e=!0)=>utils.isServer?e:// /(android|bb\d+|meego).+mobile|avantgo|bada\/|blackberry|blazer|compal|elaine|fennec|hiptop|iemobile|ip(hone|od)|ipad|iris|kindle|Android|Silk|lge |maemo|midp|mmp|netfront|opera m(ob|in)i|palm( os)?|phone|p(ixi|re)\/|plucker|pocket|psp|series(4|6)0|symbian|treo|up\.(browser|link)|vodafone|wap|windows (ce|phone)|xda|xiino/i.test(navigator.userAgent)
+    //   || /1207|6310|6590|3gso|4thp|50[1-6]i|770s|802s|a wa|abac|ac(er|oo|s\-)|ai(ko|rn)|al(av|ca|co)|amoi|an(ex|ny|yw)|aptu|ar(ch|go)|as(te|us)|attw|au(di|\-m|r |s )|avan|be(ck|ll|nq)|bi(lb|rd)|bl(ac|az)|br(e|v)w|bumb|bw\-(n|u)|c55\/|capi|ccwa|cdm\-|cell|chtm|cldc|cmd\-|co(mp|nd)|craw|da(it|ll|ng)|dbte|dc\-s|devi|dica|dmob|do(c|p)o|ds(12|\-d)|el(49|ai)|em(l2|ul)|er(ic|k0)|esl8|ez([4-7]0|os|wa|ze)|fetc|fly(\-|_)|g1 u|g560|gene|gf\-5|g\-mo|go(\.w|od)|gr(ad|un)|haie|hcit|hd\-(m|p|t)|hei\-|hi(pt|ta)|hp( i|ip)|hs\-c|ht(c(\-| |_|a|g|p|s|t)|tp)|hu(aw|tc)|i\-(20|go|ma)|i230|iac( |\-|\/)|ibro|idea|ig01|ikom|im1k|inno|ipaq|iris|ja(t|v)a|jbro|jemu|jigs|kddi|keji|kgt( |\/)|klon|kpt |kwc\-|kyo(c|k)|le(no|xi)|lg( g|\/(k|l|u)|50|54|\-[a-w])|libw|lynx|m1\-w|m3ga|m50\/|ma(te|ui|xo)|mc(01|21|ca)|m\-cr|me(rc|ri)|mi(o8|oa|ts)|mmef|mo(01|02|bi|de|do|t(\-| |o|v)|zz)|mt(50|p1|v )|mwbp|mywa|n10[0-2]|n20[2-3]|n30(0|2)|n50(0|2|5)|n7(0(0|1)|10)|ne((c|m)\-|on|tf|wf|wg|wt)|nok(6|i)|nzph|o2im|op(ti|wv)|oran|owg1|p800|pan(a|d|t)|pdxg|pg(13|\-([1-8]|c))|phil|pire|pl(ay|uc)|pn\-2|po(ck|rt|se)|prox|psio|pt\-g|qa\-a|qc(07|12|21|32|60|\-[2-7]|i\-)|qtek|r380|r600|raks|rim9|ro(ve|zo)|s55\/|sa(ge|ma|mm|ms|ny|va)|sc(01|h\-|oo|p\-)|sdk\/|se(c(\-|0|1)|47|mc|nd|ri)|sgh\-|shar|sie(\-|m)|sk\-0|sl(45|id)|sm(al|ar|b3|it|t5)|so(ft|ny)|sp(01|h\-|v\-|v )|sy(01|mb)|t2(18|50)|t6(00|10|18)|ta(gt|lk)|tcl\-|tdg\-|tel(i|m)|tim\-|t\-mo|to(pl|sh)|ts(70|m\-|m3|m5)|tx\-9|up(\.b|g1|si)|utst|v400|v750|veri|vi(rg|te)|vk(40|5[0-3]|\-v)|vm40|voda|vulc|vx(52|53|60|61|70|80|81|83|85|98)|w3c(\-| )|webc|whit|wi(g |nc|nw)|wmlb|wonu|x700|yas\-|your|zeto|zte\-/i.test(navigator.userAgent.substr(0,4)
+    /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(window.navigator.userAgent);
 
 exports["default"] = isMobile;
 exports.isMobile = isMobile;

package/isMobile.esm.js

@@ -1,8 +1,11 @@
 import { isServer } from '@koine/utils';
 
-let isMobile = (ssrValue = true) => isServer
-    ? ssrValue
-    :
-        /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(window.navigator.userAgent);
+/**
+ * @category detect
+ * @category is
+ * @see https://stackoverflow.com/a/3540295
+ */let isMobile=(e=!0)=>isServer?e:// /(android|bb\d+|meego).+mobile|avantgo|bada\/|blackberry|blazer|compal|elaine|fennec|hiptop|iemobile|ip(hone|od)|ipad|iris|kindle|Android|Silk|lge |maemo|midp|mmp|netfront|opera m(ob|in)i|palm( os)?|phone|p(ixi|re)\/|plucker|pocket|psp|series(4|6)0|symbian|treo|up\.(browser|link)|vodafone|wap|windows (ce|phone)|xda|xiino/i.test(navigator.userAgent)
+    //   || /1207|6310|6590|3gso|4thp|50[1-6]i|770s|802s|a wa|abac|ac(er|oo|s\-)|ai(ko|rn)|al(av|ca|co)|amoi|an(ex|ny|yw)|aptu|ar(ch|go)|as(te|us)|attw|au(di|\-m|r |s )|avan|be(ck|ll|nq)|bi(lb|rd)|bl(ac|az)|br(e|v)w|bumb|bw\-(n|u)|c55\/|capi|ccwa|cdm\-|cell|chtm|cldc|cmd\-|co(mp|nd)|craw|da(it|ll|ng)|dbte|dc\-s|devi|dica|dmob|do(c|p)o|ds(12|\-d)|el(49|ai)|em(l2|ul)|er(ic|k0)|esl8|ez([4-7]0|os|wa|ze)|fetc|fly(\-|_)|g1 u|g560|gene|gf\-5|g\-mo|go(\.w|od)|gr(ad|un)|haie|hcit|hd\-(m|p|t)|hei\-|hi(pt|ta)|hp( i|ip)|hs\-c|ht(c(\-| |_|a|g|p|s|t)|tp)|hu(aw|tc)|i\-(20|go|ma)|i230|iac( |\-|\/)|ibro|idea|ig01|ikom|im1k|inno|ipaq|iris|ja(t|v)a|jbro|jemu|jigs|kddi|keji|kgt( |\/)|klon|kpt |kwc\-|kyo(c|k)|le(no|xi)|lg( g|\/(k|l|u)|50|54|\-[a-w])|libw|lynx|m1\-w|m3ga|m50\/|ma(te|ui|xo)|mc(01|21|ca)|m\-cr|me(rc|ri)|mi(o8|oa|ts)|mmef|mo(01|02|bi|de|do|t(\-| |o|v)|zz)|mt(50|p1|v )|mwbp|mywa|n10[0-2]|n20[2-3]|n30(0|2)|n50(0|2|5)|n7(0(0|1)|10)|ne((c|m)\-|on|tf|wf|wg|wt)|nok(6|i)|nzph|o2im|op(ti|wv)|oran|owg1|p800|pan(a|d|t)|pdxg|pg(13|\-([1-8]|c))|phil|pire|pl(ay|uc)|pn\-2|po(ck|rt|se)|prox|psio|pt\-g|qa\-a|qc(07|12|21|32|60|\-[2-7]|i\-)|qtek|r380|r600|raks|rim9|ro(ve|zo)|s55\/|sa(ge|ma|mm|ms|ny|va)|sc(01|h\-|oo|p\-)|sdk\/|se(c(\-|0|1)|47|mc|nd|ri)|sgh\-|shar|sie(\-|m)|sk\-0|sl(45|id)|sm(al|ar|b3|it|t5)|so(ft|ny)|sp(01|h\-|v\-|v )|sy(01|mb)|t2(18|50)|t6(00|10|18)|ta(gt|lk)|tcl\-|tdg\-|tel(i|m)|tim\-|t\-mo|to(pl|sh)|ts(70|m\-|m3|m5)|tx\-9|up(\.b|g1|si)|utst|v400|v750|veri|vi(rg|te)|vk(40|5[0-3]|\-v)|vm40|voda|vulc|vx(52|53|60|61|70|80|81|83|85|98)|w3c(\-| )|webc|whit|wi(g |nc|nw)|wmlb|wonu|x700|yas\-|your|zeto|zte\-/i.test(navigator.userAgent.substr(0,4)
+    /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(window.navigator.userAgent);
 
 export { isMobile as default, isMobile };

package/listenUrlSearch.cjs.js

@@ -5,42 +5,28 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var utils = require('@koine/utils');
 var dom = require('@koine/dom');
 
-let extendHistoryMethod = (fn, runHandlers, before) => {
-    return function interceptor(...args) {
-        if (before) {
-            runHandlers();
-            return fn.apply(this, args);
-        }
-        const result = fn.apply(this, args);
-        runHandlers();
-        return result;
-    };
-};
-let prevSearch = utils.isBrowser ? location.search : "";
-let runHandlers = () => {
-    const newSearch = location.search;
-    if (newSearch !== prevSearch) {
-        const listeners = history.__.h.values();
-        for (const listener of listeners) {
-            listener(prevSearch, newSearch);
-        }
-    }
-    prevSearch = newSearch;
-};
-let listenUrlSearch = (handler) => {
-    if (!history.__) {
-        history.pushState = extendHistoryMethod(history.pushState, runHandlers);
-        history.replaceState = extendHistoryMethod(history.replaceState, runHandlers);
-        dom.on(window, "popstate", runHandlers);
-        history.__ = { h: new Set() };
-    }
-    if (!history.__.h.has(handler)) {
-        history.__.h.add(handler);
-    }
-    return () => {
-        history.__.h.delete(handler);
-    };
-};
+/**
+   * Flag that tells if `history` methods have been replaced
+   *//**
+ * @param prevLocationSearch The previous URL search query e.g. `?myparam=mvalue`
+ * @param newLocationSearch The previous URL search query e.g. `?myparam=mvalue`
+ */let r=(t,e,r)=>function(...o){if(r)return e(),t.apply(this,o);let i=t.apply(this,o);return e(),i},o=utils.isBrowser?location.search:"",i=()=>{let t=location.search;// console.log(`listenUrlSearch: "${prevSearch}" vs "${newSearch}`);
+if(t!==o)for(let e of history.__.h.values())e(o,t);o=t;};/**
+ * Here we extend and mutate the native `window.history` object so that multiple
+ * scripts can add url change handlers without interfering each other and using
+ * the same single listener.
+ *
+ * @borrows [SO answer](https://stackoverflow.com/a/42727249/1938970)
+ *
+ * @category location
+ * @category navigation
+ * @category events
+ *
+ * @returns A de-register function to remove the handler
+ */let listenUrlSearch=t=>(history.__||(// replace browser's history global methods
+    history.pushState=r(history.pushState,i),history.replaceState=r(history.replaceState,i),// listen native history events
+    dom.on(window,"popstate",i),// extend history object
+    history.__={h:new Set}),history.__.h.has(t)||history.__.h.add(t),()=>{history.__.h.delete(t);});
 
 exports["default"] = listenUrlSearch;
 exports.listenUrlSearch = listenUrlSearch;