@koine/browser 2.0.0-beta.71 → 2.0.0-beta.73

package/browser/createStorage.js

@@ -0,0 +1 @@
+import{decode as e,encode as t,isBrowser as o,isNullOrUndefined as r,noop as s}from"@koine/utils";import{on as l}from"@koine/dom";import{storage as i}from"./storage";export let createStorage=(n,a)=>{let c=a?i.s:i.l,m=Object.keys(n).reduce((e,o)=>({...e,[o]:t(o)}),{});return{get:(t,o)=>c.get(m[t],e,o),getAll(e){if(!o)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];r(s)?l&&(t[o]=l):t[o]=s}return t},set(e,o){c.set(m[e],o,t)},setMany(e){if("development"!==process.env.NODE_ENV||o||console.log("[@koine/utils:createStorage] attempt to use 'setMany' outside of browser."),o)for(let t in e){let o=e[t];r(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||o||console.log("[@koine/utils:createStorage] attempt to use 'clear' outside of browser."),o)for(let e in m)c.remove(m[e])},watch:(e,t,r)=>o?l(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."),s)}};

package/browser/getZonedDate.js

@@ -0,0 +1 @@
+import{isBrowser as e}from"@koine/utils";let t=(e,t)=>e;export let getZonedDate=(o="",n)=>{if(o.endsWith("Z")||(o+="Z"),!n&&e)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),n):new Date(o)};

package/browser/gtag.js

@@ -0,0 +1 @@
+import{isUndefined as o,noop as t}from"@koine/utils";export let gtag=(...g)=>{o(window)||o(window.gtag)?t():window.gtag(...g)};

package/browser/gtagPageview.js

@@ -0,0 +1 @@
+import{gtag as e}from"./gtag";export let gtagPageview=(...t)=>e("event","page_view",{page_path:t[0]||location.pathname,page_title:t[1]||document.title,page_location:t[2]||location.href});

package/browser/index.js

@@ -0,0 +1 @@
+export{createStorage}from"./createStorage";export{getZonedDate}from"./getZonedDate";export{gtag}from"./gtag";export{gtagPageview}from"./gtagPageview";export{isIE}from"./isIE";export{isMobile}from"./isMobile";export{listenUrlSearch}from"./listenUrlSearch";export{listenUrlSearchParams}from"./listenUrlSearchParams";export{navigateToHash}from"./navigateToHash";export{navigateToHashParams}from"./navigateToHashParams";export{navigateToMergedHashParams}from"./navigateToMergedHashParams";export{navigateToMergedParams}from"./navigateToMergedParams";export{navigateToParams}from"./navigateToParams";export{navigateToUrl}from"./navigateToUrl";export{navigateWithoutUrlParam}from"./navigateWithoutUrlParam";export{redirectTo}from"./redirectTo";export{storage}from"./storage";export{storageClient}from"./storageClient";

package/browser/isIE.js

@@ -0,0 +1 @@
+import{isServer as e}from"@koine/utils";export let isIE=(i=!0)=>{if(e)return i;let r=window.navigator.userAgent;return!!(r.indexOf("MSIE ")>0||r.indexOf("Trident/")>0)};

package/browser/isMobile.js

@@ -0,0 +1 @@
+import{isServer as i}from"@koine/utils";export let isMobile=(e=!0)=>i?e:/Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(window.navigator.userAgent);

package/browser/listenUrlSearch.js

@@ -0,0 +1 @@
+import{isBrowser as t}from"@koine/utils";import{on as e}from"@koine/dom";let o=(t,e,o)=>function(...r){if(o)return e(),t.apply(this,r);let i=t.apply(this,r);return e(),i},r=t?location.search:"",i=()=>{let t=location.search;if(t!==r)for(let e of history.__.h.values())e(r,t);r=t};export let listenUrlSearch=t=>(history.__||(history.pushState=o(history.pushState,i),history.replaceState=o(history.replaceState,i),e(window,"popstate",i),history.__={h:new Set}),history.__.h.has(t)||history.__.h.add(t),()=>{history.__.h.delete(t)});

package/browser/listenUrlSearchParams.js

@@ -0,0 +1 @@
+import{listenUrlSearch as e}from"./listenUrlSearch";export let listenUrlSearchParams=(r,a)=>e((e,t)=>{let l=new URLSearchParams(e),m=new URLSearchParams(t).get(r);l.get(r)!==m&&a(m)});

package/browser/navigateToHash.js

@@ -0,0 +1 @@
+import{navigateToUrl as o}from"./navigateToUrl";export let navigateToHash=(t="")=>{let{pathname:a,search:e}=location;o(a+(e?"?"+e:"")+(t?"#"+t:""),!0)};

package/browser/navigateToHashParams.js

@@ -0,0 +1 @@
+import{buildUrlQueryString as t,getUrlHashPathname as o}from"@koine/utils";export let navigateToHashParams=(a={},e="")=>{let i=!e,r="#/"+o(e=e||location.hash)+("string"==typeof a?a:t(a));return i&&(location.hash=r),r};

package/browser/navigateToMergedHashParams.js

@@ -0,0 +1 @@
+import{getUrlHashParams as a,mergeUrlQueryParams as o}from"@koine/utils";import{navigateToHashParams as r}from"./navigateToHashParams";export let navigateToMergedHashParams=(e={},t="")=>r(o(a(t),e),t);

package/browser/navigateToMergedParams.js

@@ -0,0 +1 @@
+import{getUrlQueryParams as a,mergeUrlQueryParams as o}from"@koine/utils";import{navigateToParams as r}from"./navigateToParams";export let navigateToMergedParams=(e={},t)=>r(o(a(),e),t);

package/browser/navigateToParams.js

@@ -0,0 +1 @@
+import{buildUrlQueryString as t,isBrowser as o}from"@koine/utils";import{navigateToUrl as r}from"./navigateToUrl";export let navigateToParams=(a={},e)=>{let i="string"==typeof a?a:t(a);return o&&r(location.pathname+i,e),i};

package/browser/navigateToUrl.js

@@ -0,0 +1 @@
+export let navigateToUrl=(t="",e)=>{t&&history[e?"replaceState":"pushState"](history.state,"",t)};

package/browser/navigateWithoutUrlParam.js

@@ -0,0 +1 @@
+import{getUrlQueryParams as t}from"@koine/utils";import{navigateToParams as r}from"./navigateToParams";export let navigateWithoutUrlParam=(o,a)=>{let e={},i=t();for(let t in i)t!==o&&(e[t]=i[t]);return r(e,a)};

package/browser/redirectTo.js

@@ -0,0 +1 @@
+import{buildUrlQueryString as e,isBrowser as o}from"@koine/utils";export let redirectTo=(r,t)=>{if(o){let o=e(t);location.href=r.replace(/\?+$/g,"")+o}};

package/browser/storage.js

@@ -0,0 +1 @@
+import{storageClient as t}from"./storageClient";export let storage={l:t(),s:t(!0)};

package/browser/storageClient.js

@@ -0,0 +1 @@
+import{isBrowser as e,isString as o}from"@koine/utils";let t={g:"getItem",s:"setItem",r:"removeItem"};export let storageClient=s=>{let r=(o,r,l)=>e?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||e||console.log(`[@koine/utils:storage] called 'get' outside of browser with default value '${JSON.stringify(s)}'.`),e){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||e||console.log("[@koine/utils:storage] called 'set' outside of browser does not work."),e)try{let e=l(o(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||e||console.log("[@koine/utils:storage] called 'remove' outside of browser does not work."),e)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||e||console.log(`[@koine/utils:storage] called 'has' outside of browser with default value '${JSON.stringify(t)}'.`),e&&(s=r("g",o)??!1),s}}};

package/createStorage.js

@@ -0,0 +1,92 @@
+import { decode, encode, isBrowser, isNullOrUndefined, noop, } from "@koine/utils";
+import { on } from "@koine/dom";
+import { storage } from "./storage";
+export 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;
+        },
+    };
+};

package/getZonedDate.js

@@ -0,0 +1,21 @@
+import { isBrowser } from "@koine/utils";
+const utcToZonedTime = (date, _tz) => {
+    return date;
+};
+export 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), timeZone)
+        : new Date(dateString);
+};

package/gtag.js

@@ -0,0 +1,7 @@
+import { isUndefined, noop } from "@koine/utils";
+export let gtag = (...args) => {
+    !isUndefined(window) && !isUndefined(window.gtag)
+        ?
+            window.gtag(...args)
+        : noop();
+};

package/gtagPageview.js

@@ -0,0 +1,6 @@
+import { gtag } from "./gtag";
+export 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,
+});

package/index.js

@@ -0,0 +1,18 @@
+export { createStorage } from "./createStorage";
+export { getZonedDate } from "./getZonedDate";
+export { gtag } from "./gtag";
+export { gtagPageview } from "./gtagPageview";
+export { isIE } from "./isIE";
+export { isMobile } from "./isMobile";
+export { listenUrlSearch } from "./listenUrlSearch";
+export { listenUrlSearchParams } from "./listenUrlSearchParams";
+export { navigateToHash } from "./navigateToHash";
+export { navigateToHashParams } from "./navigateToHashParams";
+export { navigateToMergedHashParams } from "./navigateToMergedHashParams";
+export { navigateToMergedParams } from "./navigateToMergedParams";
+export { navigateToParams } from "./navigateToParams";
+export { navigateToUrl } from "./navigateToUrl";
+export { navigateWithoutUrlParam } from "./navigateWithoutUrlParam";
+export { redirectTo } from "./redirectTo";
+export { storage } from "./storage";
+export { storageClient } from "./storageClient";

package/isIE.js

@@ -0,0 +1,11 @@
+import { isServer } from "@koine/utils";
+export 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;
+};

package/isMobile.js

@@ -0,0 +1,5 @@
+import { isServer } from "@koine/utils";
+export let isMobile = (ssrValue = true) => isServer
+    ? ssrValue
+    :
+        /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(window.navigator.userAgent);

package/listenUrlSearch.js

@@ -0,0 +1,38 @@
+import { isBrowser } from "@koine/utils";
+import { on } from "@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 = 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;
+};
+export let listenUrlSearch = (handler) => {
+    if (!history.__) {
+        history.pushState = extendHistoryMethod(history.pushState, runHandlers);
+        history.replaceState = extendHistoryMethod(history.replaceState, runHandlers);
+        on(window, "popstate", runHandlers);
+        history.__ = { h: new Set() };
+    }
+    if (!history.__.h.has(handler)) {
+        history.__.h.add(handler);
+    }
+    return () => {
+        history.__.h.delete(handler);
+    };
+};

package/listenUrlSearchParams.js

@@ -0,0 +1,9 @@
+import { listenUrlSearch } from "./listenUrlSearch";
+export let listenUrlSearchParams = (paramName, handler) => listenUrlSearch((prevSearch, newSearch) => {
+    const prevParams = new URLSearchParams(prevSearch);
+    const newParams = new URLSearchParams(newSearch);
+    const newValue = newParams.get(paramName);
+    if (prevParams.get(paramName) !== newValue) {
+        handler(newValue);
+    }
+});

package/navigateToHash.js

@@ -0,0 +1,5 @@
+import { navigateToUrl } from "./navigateToUrl";
+export let navigateToHash = (hash = "") => {
+    const { pathname, search } = location;
+    navigateToUrl(pathname + (search ? "?" + search : "") + (hash ? "#" + hash : ""), true);
+};

package/navigateToHashParams.js

@@ -0,0 +1,12 @@
+import { buildUrlQueryString, getUrlHashPathname, } from "@koine/utils";
+export let navigateToHashParams = (params = {}, hash = "") => {
+    const useLocation = !hash;
+    hash = hash || location.hash;
+    const hashQueryLess = getUrlHashPathname(hash);
+    const queryString = typeof params === "string" ? params : buildUrlQueryString(params);
+    const newHash = "#/" + hashQueryLess + queryString;
+    if (useLocation) {
+        location.hash = newHash;
+    }
+    return newHash;
+};

package/navigateToMergedHashParams.js

@@ -0,0 +1,3 @@
+import { getUrlHashParams, mergeUrlQueryParams, } from "@koine/utils";
+import { navigateToHashParams } from "./navigateToHashParams";
+export let navigateToMergedHashParams = (params = {}, hash = "") => navigateToHashParams(mergeUrlQueryParams(getUrlHashParams(hash), params), hash);

package/navigateToMergedParams.js

@@ -0,0 +1,3 @@
+import { getUrlQueryParams, mergeUrlQueryParams, } from "@koine/utils";
+import { navigateToParams } from "./navigateToParams";
+export let navigateToMergedParams = (params = {}, replace) => navigateToParams(mergeUrlQueryParams(getUrlQueryParams(), params), replace);

package/navigateToParams.js

@@ -0,0 +1,9 @@
+import { buildUrlQueryString, isBrowser, } from "@koine/utils";
+import { navigateToUrl } from "./navigateToUrl";
+export let navigateToParams = (params = {}, replace) => {
+    const queryString = typeof params === "string" ? params : buildUrlQueryString(params);
+    if (isBrowser) {
+        navigateToUrl(location.pathname + queryString, replace);
+    }
+    return queryString;
+};

package/navigateToUrl.js

@@ -0,0 +1,5 @@
+export let navigateToUrl = (url = "", replace) => {
+    if (url) {
+        history[replace ? "replaceState" : "pushState"](history.state, "", url);
+    }
+};

package/navigateWithoutUrlParam.js

@@ -0,0 +1,12 @@
+import { getUrlQueryParams } from "@koine/utils";
+import { navigateToParams } from "./navigateToParams";
+export let navigateWithoutUrlParam = (paramName, replace) => {
+    const params = {};
+    const currentParams = getUrlQueryParams();
+    for (const key in currentParams) {
+        if (key !== paramName) {
+            params[key] = currentParams[key];
+        }
+    }
+    return navigateToParams(params, replace);
+};

package/package.json

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

package/redirectTo.js

@@ -0,0 +1,7 @@
+import { buildUrlQueryString, isBrowser, } from "@koine/utils";
+export let redirectTo = (url, params) => {
+    if (isBrowser) {
+        const queryString = buildUrlQueryString(params);
+        location.href = url.replace(/\?+$/g, "") + queryString;
+    }
+};

package/storage.js

@@ -0,0 +1,5 @@
+import { storageClient } from "./storageClient";
+export let storage = {
+    l: storageClient(),
+    s: storageClient(true),
+};

package/storageClient.js

@@ -0,0 +1,90 @@
+import { isBrowser, isString } from "@koine/utils";
+const methodsMap = { g: "getItem", s: "setItem", r: "removeItem" };
+export let storageClient = (useSessionStorage) => {
+    const nativeMethod = (method, key, value) => isBrowser
+        ? window[useSessionStorage ? "sessionStorage" : "localStorage"][methodsMap[method]](key, value)
+        : () => {
+            if (process.env["NODE_ENV"] === "development") {
+                console.warn(`[@koine/utils:storageClient]: ${useSessionStorage ? "sessionStorage" : "localStorage"} does not exists outside of browser.`);
+            }
+        };
+    const get = (key, transform, defaultValue) => {
+        let value = defaultValue ?? null;
+        if (process.env["NODE_ENV"] === "development") {
+            if (!isBrowser) {
+                console.log(`[@koine/utils:storage] called 'get' outside of browser with default value '${JSON.stringify(defaultValue)}'.`);
+            }
+        }
+        if (isBrowser) {
+            let stored = nativeMethod("g", key);
+            if (stored) {
+                stored = transform ? transform(stored) : stored;
+                try {
+                    const parsed = JSON.parse(stored);
+                    if (parsed)
+                        value = parsed;
+                }
+                catch (_e) {
+                    value = stored;
+                }
+            }
+        }
+        return value;
+    };
+    const set = (key, value, transform = (value) => value) => {
+        if (process.env["NODE_ENV"] === "development") {
+            if (!isBrowser) {
+                console.log(`[@koine/utils:storage] called 'set' outside of browser does not work.`);
+            }
+        }
+        if (isBrowser) {
+            try {
+                const transformedValue = isString(value)
+                    ? transform(value)
+                    : transform(JSON.stringify(value));
+                nativeMethod("s", key, transformedValue);
+            }
+            catch (_e) {
+                if (process.env["NODE_ENV"] === "development") {
+                    console.warn(`[@koine/utils:createStorage]: 'set' error.`, _e);
+                }
+            }
+        }
+    };
+    const remove = (key) => {
+        if (process.env["NODE_ENV"] === "development") {
+            if (!isBrowser) {
+                console.log(`[@koine/utils:storage] called 'remove' outside of browser does not work.`);
+            }
+        }
+        if (isBrowser) {
+            try {
+                nativeMethod("r", key);
+            }
+            catch (_e) {
+                if (process.env["NODE_ENV"] === "development") {
+                    console.warn(`[@koine/utils:createStorage]: 'remove' error.`, _e);
+                }
+            }
+        }
+    };
+    const has = (key, defaultValue) => {
+        let value = defaultValue ?? false;
+        if (process.env["NODE_ENV"] === "development") {
+            if (!isBrowser) {
+                console.log(`[@koine/utils:storage] called 'has' outside of browser with default value '${JSON.stringify(defaultValue)}'.`);
+            }
+        }
+        if (isBrowser) {
+            const stored = nativeMethod("g", key);
+            value = stored ?? false;
+        }
+        return value;
+    };
+    return {
+        get,
+        set,
+        remove,
+        has,
+    };
+};