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

package/createStorage.cjs.js

@@ -7,7 +7,45 @@ var dom = require('@koine/dom');
 var storage = require('./storage.cjs.js');
 require('./storageClient.cjs.js');
 
-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:(t,o)=>c.get(m[t],utils.decode,o),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&&(t[o]=l):t[o]=s;}return t},set(e,o){c.set(m[e],o,utils.encode);},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);}},has:e=>c.has(m[e]),remove(e){c.remove(m[e]);},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:(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)}};
+/**
+ * @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.esm.js

@@ -3,6 +3,44 @@ import { on } from '@koine/dom';
 import { storage } from './storage.esm.js';
 import './storageClient.esm.js';
 
-let createStorage=(a,n)=>{let c=n?storage.s:storage.l,m=Object.keys(a).reduce((e,o)=>({...e,[o]:encode(o)}),{});return {get:(t,o)=>c.get(m[t],decode,o),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&&(t[o]=l):t[o]=s;}return t},set(e,o){c.set(m[e],o,encode);},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);}},has:e=>c.has(m[e]),remove(e){c.remove(m[e]);},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:(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)}};
+/**
+ * @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,7 +4,24 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var utils = require('@koine/utils');
 
-let t=(e,t)=>e;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);}return n?t(new Date(o)):new Date(o)};
+// 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,5 +1,22 @@
 import { isBrowser } from '@koine/utils';
 
-let t=(e,t)=>e;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);}return n?t(new Date(o)):new Date(o)};
+// 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,7 +4,19 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var utils = require('@koine/utils');
 
-let gtag=(...o)=>{utils.isUndefined(window)||utils.isUndefined(window.gtag)?utils.noop():window.gtag(...o);};
+/**
+ * @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,5 +1,17 @@
 import { isUndefined, noop } from '@koine/utils';
 
-let gtag=(...o)=>{isUndefined(window)||isUndefined(window.gtag)?noop():window.gtag(...o);};
+/**
+ * @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,7 +5,9 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var gtag = require('./gtag.cjs.js');
 require('@koine/utils');
 
-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});
+/**
+ * @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,6 +1,8 @@
 import { gtag } from './gtag.esm.js';
 import '@koine/utils';
 
-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});
+/**
+ * @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,7 +4,11 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var utils = require('@koine/utils');
 
-let isIE=(t=!0)=>{if(utils.isServer)return t;let i=window.navigator.userAgent;return !!(i.indexOf("MSIE ")>0||i.indexOf("Trident/")>0)};
+/**
+ * @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,5 +1,9 @@
 import { isServer } from '@koine/utils';
 
-let isIE=(t=!0)=>{if(isServer)return t;let i=window.navigator.userAgent;return !!(i.indexOf("MSIE ")>0||i.indexOf("Trident/")>0)};
+/**
+ * @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,7 +4,13 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var utils = require('@koine/utils');
 
-let isMobile=(e=!0)=>utils.isServer?e:/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,5 +1,11 @@
 import { isServer } from '@koine/utils';
 
-let isMobile=(e=!0)=>isServer?e:/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,7 +5,28 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var utils = require('@koine/utils');
 var dom = require('@koine/dom');
 
-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;if(t!==o)for(let e of history.__.h.values())e(o,t);o=t;};let listenUrlSearch=t=>(history.__||(history.pushState=r(history.pushState,i),history.replaceState=r(history.replaceState,i),dom.on(window,"popstate",i),history.__={h:new Set}),history.__.h.has(t)||history.__.h.add(t),()=>{history.__.h.delete(t);});
+/**
+   * 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;

package/listenUrlSearch.esm.js

@@ -1,6 +1,27 @@
 import { isBrowser } from '@koine/utils';
 import { on } from '@koine/dom';
 
-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=isBrowser?location.search:"",i=()=>{let t=location.search;if(t!==o)for(let e of history.__.h.values())e(o,t);o=t;};let listenUrlSearch=t=>(history.__||(history.pushState=r(history.pushState,i),history.replaceState=r(history.replaceState,i),on(window,"popstate",i),history.__={h:new Set}),history.__.h.has(t)||history.__.h.add(t),()=>{history.__.h.delete(t);});
+/**
+   * 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=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
+    on(window,"popstate",i),// extend history object
+    history.__={h:new Set}),history.__.h.has(t)||history.__.h.add(t),()=>{history.__.h.delete(t);});
 
 export { listenUrlSearch as default, listenUrlSearch };

package/listenUrlSearchParams.cjs.js

@@ -6,7 +6,11 @@ var listenUrlSearch = require('./listenUrlSearch.cjs.js');
 require('@koine/utils');
 require('@koine/dom');
 
-let listenUrlSearchParams=(r,a)=>listenUrlSearch.listenUrlSearch((e,t)=>{let l=new URLSearchParams(e),s=new URLSearchParams(t).get(r);l.get(r)!==s&&a(s);});
+/**
+ * @category events
+ * @category navigation
+ * @category events
+ */let listenUrlSearchParams=(r,a)=>listenUrlSearch.listenUrlSearch((e,t)=>{let l=new URLSearchParams(e),s=new URLSearchParams(t).get(r);l.get(r)!==s&&a(s);});
 
 exports["default"] = listenUrlSearchParams;
 exports.listenUrlSearchParams = listenUrlSearchParams;

package/listenUrlSearchParams.esm.js

@@ -2,6 +2,10 @@ import { listenUrlSearch } from './listenUrlSearch.esm.js';
 import '@koine/utils';
 import '@koine/dom';
 
-let listenUrlSearchParams=(r,a)=>listenUrlSearch((e,t)=>{let l=new URLSearchParams(e),s=new URLSearchParams(t).get(r);l.get(r)!==s&&a(s);});
+/**
+ * @category events
+ * @category navigation
+ * @category events
+ */let listenUrlSearchParams=(r,a)=>listenUrlSearch((e,t)=>{let l=new URLSearchParams(e),s=new URLSearchParams(t).get(r);l.get(r)!==s&&a(s);});
 
 export { listenUrlSearchParams as default, listenUrlSearchParams };

package/navigateToHash.cjs.js

@@ -4,7 +4,12 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var navigateToUrl = require('./navigateToUrl.cjs.js');
 
-let navigateToHash=(t="")=>{let{pathname:o,search:e}=location;navigateToUrl.navigateToUrl(o+(e?"?"+e:"")+(t?"#"+t:""),!0);};
+/**
+ * It updates the browser's location hash by replacing the history state.
+ * The non-silent standard way would simply be `location.hash = "#new-hash"`
+ *
+ * @category location
+ */let navigateToHash=(t="")=>{let{pathname:o,search:e}=location;navigateToUrl.navigateToUrl(o+(e?"?"+e:"")+(t?"#"+t:""),!0);};
 
 exports["default"] = navigateToHash;
 exports.navigateToHash = navigateToHash;

package/navigateToHash.esm.js

@@ -1,5 +1,10 @@
 import { navigateToUrl } from './navigateToUrl.esm.js';
 
-let navigateToHash=(t="")=>{let{pathname:o,search:e}=location;navigateToUrl(o+(e?"?"+e:"")+(t?"#"+t:""),!0);};
+/**
+ * It updates the browser's location hash by replacing the history state.
+ * The non-silent standard way would simply be `location.hash = "#new-hash"`
+ *
+ * @category location
+ */let navigateToHash=(t="")=>{let{pathname:o,search:e}=location;navigateToUrl(o+(e?"?"+e:"")+(t?"#"+t:""),!0);};
 
 export { navigateToHash as default, navigateToHash };

package/navigateToHashParams.cjs.js

@@ -4,7 +4,12 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var utils = require('@koine/utils');
 
-let navigateToHashParams=(o={},e="")=>{let r=!e,i="#/"+utils.getUrlHashPathname(e=e||location.hash)+("string"==typeof o?o:utils.buildUrlQueryString(o));return r&&(location.hash=i),i};
+/**
+ * It updates the `location.hash` with the given query params, it uses `location.hash`
+ * if a second argument `hash` is not provded
+ *
+ * @category location
+ */let navigateToHashParams=(o={},e="")=>{let r=!e,i="#/"+utils.getUrlHashPathname(e=e||location.hash)+("string"==typeof o?o:utils.buildUrlQueryString(o));return r&&(location.hash=i),i};
 
 exports["default"] = navigateToHashParams;
 exports.navigateToHashParams = navigateToHashParams;

package/navigateToHashParams.esm.js

@@ -1,5 +1,10 @@
 import { getUrlHashPathname, buildUrlQueryString } from '@koine/utils';
 
-let navigateToHashParams=(o={},e="")=>{let r=!e,i="#/"+getUrlHashPathname(e=e||location.hash)+("string"==typeof o?o:buildUrlQueryString(o));return r&&(location.hash=i),i};
+/**
+ * It updates the `location.hash` with the given query params, it uses `location.hash`
+ * if a second argument `hash` is not provded
+ *
+ * @category location
+ */let navigateToHashParams=(o={},e="")=>{let r=!e,i="#/"+getUrlHashPathname(e=e||location.hash)+("string"==typeof o?o:buildUrlQueryString(o));return r&&(location.hash=i),i};
 
 export { navigateToHashParams as default, navigateToHashParams };

package/navigateToMergedHashParams.cjs.js

@@ -5,7 +5,11 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var utils = require('@koine/utils');
 var navigateToHashParams = require('./navigateToHashParams.cjs.js');
 
-let navigateToMergedHashParams=(o={},t="")=>navigateToHashParams.navigateToHashParams(utils.mergeUrlQueryParams(utils.getUrlHashParams(t),o),t);
+/**
+ * It updates the "query params" within the `location.hash`, it uses `location`
+ *
+ * @category location
+ */let navigateToMergedHashParams=(o={},t="")=>navigateToHashParams.navigateToHashParams(utils.mergeUrlQueryParams(utils.getUrlHashParams(t),o),t);
 
 exports["default"] = navigateToMergedHashParams;
 exports.navigateToMergedHashParams = navigateToMergedHashParams;

package/navigateToMergedHashParams.esm.js

@@ -1,6 +1,10 @@
 import { mergeUrlQueryParams, getUrlHashParams } from '@koine/utils';
 import { navigateToHashParams } from './navigateToHashParams.esm.js';
 
-let navigateToMergedHashParams=(o={},t="")=>navigateToHashParams(mergeUrlQueryParams(getUrlHashParams(t),o),t);
+/**
+ * It updates the "query params" within the `location.hash`, it uses `location`
+ *
+ * @category location
+ */let navigateToMergedHashParams=(o={},t="")=>navigateToHashParams(mergeUrlQueryParams(getUrlHashParams(t),o),t);
 
 export { navigateToMergedHashParams as default, navigateToMergedHashParams };

package/navigateToMergedParams.cjs.js

@@ -6,7 +6,12 @@ var utils = require('@koine/utils');
 var navigateToParams = require('./navigateToParams.cjs.js');
 require('./navigateToUrl.cjs.js');
 
-let navigateToMergedParams=(o={},t)=>navigateToParams.navigateToParams(utils.mergeUrlQueryParams(utils.getUrlQueryParams(),o),t);
+/**
+ * Merge current URL query parameters with the given ones, it uses `history`.
+ *
+ * @category location
+ * @param replace Replace URL instead of pushing it in the history stack. By default it pushes it.
+ */let navigateToMergedParams=(o={},t)=>navigateToParams.navigateToParams(utils.mergeUrlQueryParams(utils.getUrlQueryParams(),o),t);
 
 exports["default"] = navigateToMergedParams;
 exports.navigateToMergedParams = navigateToMergedParams;

package/navigateToMergedParams.esm.js

@@ -2,6 +2,11 @@ import { mergeUrlQueryParams, getUrlQueryParams } from '@koine/utils';
 import { navigateToParams } from './navigateToParams.esm.js';
 import './navigateToUrl.esm.js';
 
-let navigateToMergedParams=(o={},t)=>navigateToParams(mergeUrlQueryParams(getUrlQueryParams(),o),t);
+/**
+ * Merge current URL query parameters with the given ones, it uses `history`.
+ *
+ * @category location
+ * @param replace Replace URL instead of pushing it in the history stack. By default it pushes it.
+ */let navigateToMergedParams=(o={},t)=>navigateToParams(mergeUrlQueryParams(getUrlQueryParams(),o),t);
 
 export { navigateToMergedParams as default, navigateToMergedParams };

package/navigateToParams.cjs.js

@@ -5,7 +5,13 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var utils = require('@koine/utils');
 var navigateToUrl = require('./navigateToUrl.cjs.js');
 
-let navigateToParams=(e={},r)=>{let i="string"==typeof e?e:utils.buildUrlQueryString(e);return utils.isBrowser&&navigateToUrl.navigateToUrl(location.pathname+i,r),i};
+/**
+ * Change current URL query parameters, it uses `history`.
+ *
+ * @category location
+ * @param replace Replace URL instead of pushing it in the history stack. By default it pushes it.
+ * @returns The query string with initial `?`
+ */let navigateToParams=(e={},r)=>{let i="string"==typeof e?e:utils.buildUrlQueryString(e);return utils.isBrowser&&navigateToUrl.navigateToUrl(location.pathname+i,r),i};
 
 exports["default"] = navigateToParams;
 exports.navigateToParams = navigateToParams;

package/navigateToParams.esm.js

@@ -1,6 +1,12 @@
 import { buildUrlQueryString, isBrowser } from '@koine/utils';
 import { navigateToUrl } from './navigateToUrl.esm.js';
 
-let navigateToParams=(e={},r)=>{let i="string"==typeof e?e:buildUrlQueryString(e);return isBrowser&&navigateToUrl(location.pathname+i,r),i};
+/**
+ * Change current URL query parameters, it uses `history`.
+ *
+ * @category location
+ * @param replace Replace URL instead of pushing it in the history stack. By default it pushes it.
+ * @returns The query string with initial `?`
+ */let navigateToParams=(e={},r)=>{let i="string"==typeof e?e:buildUrlQueryString(e);return isBrowser&&navigateToUrl(location.pathname+i,r),i};
 
 export { navigateToParams as default, navigateToParams };

package/navigateToUrl.cjs.js

@@ -2,7 +2,11 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-let navigateToUrl=(t="",e)=>{t&&history[e?"replaceState":"pushState"](history.state,"",t);};
+/**
+ * It updates the browser's location URL with global `history` object
+ *
+ * @category location
+ */let navigateToUrl=(t="",e)=>{t&&history[e?"replaceState":"pushState"](history.state,"",t);};
 
 exports["default"] = navigateToUrl;
 exports.navigateToUrl = navigateToUrl;

package/navigateToUrl.esm.js

@@ -1,3 +1,7 @@
-let navigateToUrl=(t="",e)=>{t&&history[e?"replaceState":"pushState"](history.state,"",t);};
+/**
+ * It updates the browser's location URL with global `history` object
+ *
+ * @category location
+ */let navigateToUrl=(t="",e)=>{t&&history[e?"replaceState":"pushState"](history.state,"",t);};
 
 export { navigateToUrl as default, navigateToUrl };

package/navigateWithoutUrlParam.cjs.js

@@ -6,7 +6,12 @@ var utils = require('@koine/utils');
 var navigateToParams = require('./navigateToParams.cjs.js');
 require('./navigateToUrl.cjs.js');
 
-let navigateWithoutUrlParam=(a,e)=>{let o={},i=utils.getUrlQueryParams();for(let t in i)t!==a&&(o[t]=i[t]);return navigateToParams.navigateToParams(o,e)};
+/**
+ * Remove URL query parameter, it uses `history`
+ *
+ * @category location
+ * @param replace Replace URL instead of pushing it in the history stack. By default it pushes it.
+ */let navigateWithoutUrlParam=(a,e)=>{let o={},i=utils.getUrlQueryParams();for(let t in i)t!==a&&(o[t]=i[t]);return navigateToParams.navigateToParams(o,e)};
 
 exports["default"] = navigateWithoutUrlParam;
 exports.navigateWithoutUrlParam = navigateWithoutUrlParam;

package/navigateWithoutUrlParam.esm.js

@@ -2,6 +2,11 @@ import { getUrlQueryParams } from '@koine/utils';
 import { navigateToParams } from './navigateToParams.esm.js';
 import './navigateToUrl.esm.js';
 
-let navigateWithoutUrlParam=(a,e)=>{let o={},i=getUrlQueryParams();for(let t in i)t!==a&&(o[t]=i[t]);return navigateToParams(o,e)};
+/**
+ * Remove URL query parameter, it uses `history`
+ *
+ * @category location
+ * @param replace Replace URL instead of pushing it in the history stack. By default it pushes it.
+ */let navigateWithoutUrlParam=(a,e)=>{let o={},i=getUrlQueryParams();for(let t in i)t!==a&&(o[t]=i[t]);return navigateToParams(o,e)};
 
 export { navigateWithoutUrlParam as default, navigateWithoutUrlParam };

package/package.json

@@ -2,8 +2,8 @@
   "name": "@koine/browser",
   "sideEffects": false,
   "dependencies": {
-    "@koine/dom": "2.0.0-beta.82",
-    "@koine/utils": "2.0.0-beta.82"
+    "@koine/dom": "2.0.0-beta.83",
+    "@koine/utils": "2.0.0-beta.83"
   },
   "peerDependenciesMeta": {
     "date-fns-tz": {
@@ -110,5 +110,5 @@
   },
   "module": "./index.esm.js",
   "main": "./index.cjs.js",
-  "version": "2.0.0-beta.82"
+  "version": "2.0.0-beta.83"
 }

package/redirectTo.cjs.js

@@ -4,7 +4,12 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var utils = require('@koine/utils');
 
-let redirectTo=(t,o)=>{if(utils.isBrowser){let r=utils.buildUrlQueryString(o);location.href=t.replace(/\?+$/g,"")+r;}};
+/**
+ * Redirect to url with params {optionally}, removes eventual trailing question
+ * marks from the given URL, it uses `location`
+ *
+ * @category location
+ */let redirectTo=(t,o)=>{if(utils.isBrowser){let r=utils.buildUrlQueryString(o);location.href=t.replace(/\?+$/g,"")+r;}};
 
 exports["default"] = redirectTo;
 exports.redirectTo = redirectTo;

package/redirectTo.esm.js

@@ -1,5 +1,10 @@
 import { isBrowser, buildUrlQueryString } from '@koine/utils';
 
-let redirectTo=(t,o)=>{if(isBrowser){let r=buildUrlQueryString(o);location.href=t.replace(/\?+$/g,"")+r;}};
+/**
+ * Redirect to url with params {optionally}, removes eventual trailing question
+ * marks from the given URL, it uses `location`
+ *
+ * @category location
+ */let redirectTo=(t,o)=>{if(isBrowser){let r=buildUrlQueryString(o);location.href=t.replace(/\?+$/g,"")+r;}};
 
 export { redirectTo as default, redirectTo };

package/storage.cjs.js

@@ -5,7 +5,11 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var storageClient = require('./storageClient.cjs.js');
 require('@koine/utils');
 
-let storage={l:storageClient.storageClient(),s:storageClient.storageClient(!0)};
+/**
+ * Storage, for `localStorage` and `sessionStorage`
+ *
+ * @category storage
+ */let storage={l:storageClient.storageClient(),s:storageClient.storageClient(!0)};
 
 exports["default"] = storage;
 exports.storage = storage;

package/storage.esm.js

@@ -1,6 +1,10 @@
 import { storageClient } from './storageClient.esm.js';
 import '@koine/utils';
 
-let storage={l:storageClient(),s:storageClient(!0)};
+/**
+ * Storage, for `localStorage` and `sessionStorage`
+ *
+ * @category storage
+ */let storage={l:storageClient(),s:storageClient(!0)};
 
 export { storage as default, storage };

package/storageClient.cjs.js

@@ -4,7 +4,18 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var utils = require('@koine/utils');
 
-let t={g:"getItem",s:"setItem",r:"removeItem"};let storageClient=s=>{let r=(o,r,l)=>utils.isBrowser?window[s?"sessionStorage":"localStorage"][t[o]](r,l):()=>{"development"===process.env.NODE_ENV&&console.warn(`[@koine/utils:storageClient]: ${s?"sessionStorage":"localStorage"} does not exists outside of browser.`);};return {get:(o,t,s)=>{let l=s??null;if("development"!==process.env.NODE_ENV||utils.isBrowser||console.log(`[@koine/utils:storage] called 'get' outside of browser with default value '${JSON.stringify(s)}'.`),utils.isBrowser){let e=r("g",o);if(e){e=t?t(e):e;try{let o=JSON.parse(e);o&&(l=o);}catch(o){l=e;}}}return l},set:(t,s,l=e=>e)=>{if("development"!==process.env.NODE_ENV||utils.isBrowser||console.log("[@koine/utils:storage] called 'set' outside of browser does not work."),utils.isBrowser)try{let e=l(utils.isString(s)?s:JSON.stringify(s));r("s",t,e);}catch(e){"development"===process.env.NODE_ENV&&console.warn("[@koine/utils:createStorage]: 'set' error.",e);}},remove:o=>{if("development"!==process.env.NODE_ENV||utils.isBrowser||console.log("[@koine/utils:storage] called 'remove' outside of browser does not work."),utils.isBrowser)try{r("r",o);}catch(e){"development"===process.env.NODE_ENV&&console.warn("[@koine/utils:createStorage]: 'remove' error.",e);}},has:(o,t)=>{let s=t??!1;return "development"!==process.env.NODE_ENV||utils.isBrowser||console.log(`[@koine/utils:storage] called 'has' outside of browser with default value '${JSON.stringify(t)}'.`),utils.isBrowser&&(s=r("g",o)??!1),s}}};
+/**
+ * @category storage
+ */let t={g:"getItem",s:"setItem",r:"removeItem"};/**
+ * Super minifiable `local/session Storage` client creator with SSR safety
+ *
+ * @category storage
+ */let storageClient=s=>{let r=(o,r,l)=>utils.isBrowser?window[s?"sessionStorage":"localStorage"][t[o]](r,l):()=>{"development"===process.env.NODE_ENV&&console.warn(`[@koine/utils:storageClient]: ${s?"sessionStorage":"localStorage"} does not exists outside of browser.`);};return {get:(o,t,s)=>{let l=s??null;if("development"!==process.env.NODE_ENV||utils.isBrowser||console.log(`[@koine/utils:storage] called 'get' outside of browser with default value '${JSON.stringify(s)}'.`),utils.isBrowser){let e=r("g",o);if(e){e=t?t(e):e;try{let o=JSON.parse(e);o&&(l=o);}catch(o){l=e;}}}// if (process.env["NODE_ENV"] === "development") {
+//   console.warn(
+//     `[@koine/utils:storage]: 'get' failed to parse stored value as JSON. Plain '${stored}' value is returned.`
+//   );
+// }
+return l},set:(t,s,l=e=>e)=>{if("development"!==process.env.NODE_ENV||utils.isBrowser||console.log("[@koine/utils:storage] called 'set' outside of browser does not work."),utils.isBrowser)try{let e=l(utils.isString(s)?s:JSON.stringify(s));r("s",t,e);}catch(e){"development"===process.env.NODE_ENV&&console.warn("[@koine/utils:createStorage]: 'set' error.",e);}},remove:o=>{if("development"!==process.env.NODE_ENV||utils.isBrowser||console.log("[@koine/utils:storage] called 'remove' outside of browser does not work."),utils.isBrowser)try{r("r",o);}catch(e){"development"===process.env.NODE_ENV&&console.warn("[@koine/utils:createStorage]: 'remove' error.",e);}},has:(o,t)=>{let s=t??!1;return "development"!==process.env.NODE_ENV||utils.isBrowser||console.log(`[@koine/utils:storage] called 'has' outside of browser with default value '${JSON.stringify(t)}'.`),utils.isBrowser&&(s=r("g",o)??!1),s}}};
 
 exports["default"] = storageClient;
 exports.storageClient = storageClient;

package/storageClient.esm.js

@@ -1,5 +1,16 @@
 import { isBrowser, isString } from '@koine/utils';
 
-let t={g:"getItem",s:"setItem",r:"removeItem"};let storageClient=s=>{let r=(o,r,l)=>isBrowser?window[s?"sessionStorage":"localStorage"][t[o]](r,l):()=>{"development"===process.env.NODE_ENV&&console.warn(`[@koine/utils:storageClient]: ${s?"sessionStorage":"localStorage"} does not exists outside of browser.`);};return {get:(o,t,s)=>{let l=s??null;if("development"!==process.env.NODE_ENV||isBrowser||console.log(`[@koine/utils:storage] called 'get' outside of browser with default value '${JSON.stringify(s)}'.`),isBrowser){let e=r("g",o);if(e){e=t?t(e):e;try{let o=JSON.parse(e);o&&(l=o);}catch(o){l=e;}}}return l},set:(t,s,l=e=>e)=>{if("development"!==process.env.NODE_ENV||isBrowser||console.log("[@koine/utils:storage] called 'set' outside of browser does not work."),isBrowser)try{let e=l(isString(s)?s:JSON.stringify(s));r("s",t,e);}catch(e){"development"===process.env.NODE_ENV&&console.warn("[@koine/utils:createStorage]: 'set' error.",e);}},remove:o=>{if("development"!==process.env.NODE_ENV||isBrowser||console.log("[@koine/utils:storage] called 'remove' outside of browser does not work."),isBrowser)try{r("r",o);}catch(e){"development"===process.env.NODE_ENV&&console.warn("[@koine/utils:createStorage]: 'remove' error.",e);}},has:(o,t)=>{let s=t??!1;return "development"!==process.env.NODE_ENV||isBrowser||console.log(`[@koine/utils:storage] called 'has' outside of browser with default value '${JSON.stringify(t)}'.`),isBrowser&&(s=r("g",o)??!1),s}}};
+/**
+ * @category storage
+ */let t={g:"getItem",s:"setItem",r:"removeItem"};/**
+ * Super minifiable `local/session Storage` client creator with SSR safety
+ *
+ * @category storage
+ */let storageClient=s=>{let r=(o,r,l)=>isBrowser?window[s?"sessionStorage":"localStorage"][t[o]](r,l):()=>{"development"===process.env.NODE_ENV&&console.warn(`[@koine/utils:storageClient]: ${s?"sessionStorage":"localStorage"} does not exists outside of browser.`);};return {get:(o,t,s)=>{let l=s??null;if("development"!==process.env.NODE_ENV||isBrowser||console.log(`[@koine/utils:storage] called 'get' outside of browser with default value '${JSON.stringify(s)}'.`),isBrowser){let e=r("g",o);if(e){e=t?t(e):e;try{let o=JSON.parse(e);o&&(l=o);}catch(o){l=e;}}}// if (process.env["NODE_ENV"] === "development") {
+//   console.warn(
+//     `[@koine/utils:storage]: 'get' failed to parse stored value as JSON. Plain '${stored}' value is returned.`
+//   );
+// }
+return l},set:(t,s,l=e=>e)=>{if("development"!==process.env.NODE_ENV||isBrowser||console.log("[@koine/utils:storage] called 'set' outside of browser does not work."),isBrowser)try{let e=l(isString(s)?s:JSON.stringify(s));r("s",t,e);}catch(e){"development"===process.env.NODE_ENV&&console.warn("[@koine/utils:createStorage]: 'set' error.",e);}},remove:o=>{if("development"!==process.env.NODE_ENV||isBrowser||console.log("[@koine/utils:storage] called 'remove' outside of browser does not work."),isBrowser)try{r("r",o);}catch(e){"development"===process.env.NODE_ENV&&console.warn("[@koine/utils:createStorage]: 'remove' error.",e);}},has:(o,t)=>{let s=t??!1;return "development"!==process.env.NODE_ENV||isBrowser||console.log(`[@koine/utils:storage] called 'has' outside of browser with default value '${JSON.stringify(t)}'.`),isBrowser&&(s=r("g",o)??!1),s}}};
 
 export { storageClient as default, storageClient };