@koine/browser 2.0.0-beta.2 → 2.0.0-beta.21

package/getZonedDate.mjs

@@ -1,37 +0,0 @@
-import utcToZonedTime from "date-fns-tz/utcToZonedTime";
-import isBrowser from "@koine/utils/isBrowser";
-/**
- * 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.
- */
-export function getZonedDate(dateString, timeZone) {
-    if (dateString === void 0) { dateString = ""; }
-    if (!dateString.endsWith("Z"))
-        dateString += "Z";
-    if (!timeZone && isBrowser) {
-        try {
-            timeZone = Intl.DateTimeFormat().resolvedOptions().timeZone;
-        }
-        catch (e) {
-            if (process.env["NODE_ENV"] !== "production") {
-                console.warn("[@koine/utils: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 timeZone
-        ? utcToZonedTime(new Date(dateString), timeZone)
-        : new Date(dateString);
-}
-export default getZonedDate;

package/gtagPageview.mjs

@@ -1,30 +0,0 @@
-import isUndefined from "@koine/utils/isUndefined";
-/**
- * @category analytics-google
- */
-export var gtagPageview = function () {
-    var args = [];
-    for (var _i = 0; _i < arguments.length; _i++) {
-        args[_i] = arguments[_i];
-    }
-    if (!isUndefined(window) && !isUndefined(window.gtag)) {
-        window.gtag("event", "page_view", {
-            page_path: args[0] || location.pathname,
-            page_title: args[1] || document.title,
-            page_location: args[2] || location.href,
-            // send_to: '<GA_MEASUREMENT_ID>'
-        });
-    }
-};
-export default gtagPageview;
-// export type GtmEventArgs = [
-//   eventCategory?: string,
-//   eventAction?: string,
-//   eventLabel?: string,
-//   eventValue?: string
-// ];
-// export const event = (...args: GtmEventArgs) => {
-//   if (!isUndefined(window) && !isUndefined(window.gtag)) {
-//     window.gtag("send", "event", ...args);
-//   }
-// };

package/index.mjs

@@ -1,15 +0,0 @@
-export { createStorage } from "./createStorage";
-export { getZonedDate } from "./getZonedDate";
-export { gtagPageview } from "./gtagPageview";
-export { isIE } from "./isIE";
-export { isMobile } from "./isMobile";
-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.mjs

@@ -1,18 +0,0 @@
-import isServer from "@koine/utils/isServer";
-/**
- * @category detect
- * @category is
- * @see https://stackoverflow.com/a/21712356/12285349
- */
-export function isIE(ssrValue) {
-    if (ssrValue === void 0) { ssrValue = true; }
-    if (isServer) {
-        return ssrValue;
-    }
-    var ua = window.navigator.userAgent;
-    if (ua.indexOf("MSIE ") > 0 || ua.indexOf("Trident/") > 0) {
-        return true;
-    }
-    return false;
-}
-export default isIE;

package/isMobile.mjs

@@ -1,16 +0,0 @@
-import isServer from "@koine/utils/isServer";
-/**
- * @category detect
- * @category is
- * @see https://stackoverflow.com/a/3540295
- */
-export function isMobile(ssrValue) {
-    if (ssrValue === void 0) { ssrValue = true; }
-    if (isServer) {
-        return ssrValue;
-    }
-    return /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(window.navigator.userAgent);
-    // return /(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)
-}
-export default isMobile;

package/navigateToHash.mjs

@@ -1,13 +0,0 @@
-import navigateToUrl from "./navigateToUrl";
-/**
- * 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
- */
-export function navigateToHash(hash) {
-    if (hash === void 0) { hash = ""; }
-    var pathname = location.pathname, search = location.search;
-    navigateToUrl(pathname + (search ? "?" + search : "") + (hash ? "#" + hash : ""), true);
-}
-export default navigateToHash;

package/navigateToHashParams.mjs

@@ -1,22 +0,0 @@
-import buildUrlQueryString from "@koine/utils/buildUrlQueryString";
-import getUrlHashPathname from "@koine/utils/getUrlHashPathname";
-/**
- * It updates the `location.hash` with the given query params, it uses `location.hash`
- * if a second argument `hash` is not provded
- *
- * @category location
- */
-export function navigateToHashParams(params, hash) {
-    if (params === void 0) { params = {}; }
-    if (hash === void 0) { hash = ""; }
-    var useLocation = !hash;
-    hash = hash || location.hash;
-    var hashQueryLess = getUrlHashPathname(hash);
-    var queryString = typeof params === "string" ? params : buildUrlQueryString(params);
-    var newHash = "#/" + hashQueryLess + queryString;
-    if (useLocation) {
-        location.hash = newHash;
-    }
-    return newHash;
-}
-export default navigateToHashParams;

package/navigateToMergedHashParams.mjs

@@ -1,14 +0,0 @@
-import mergeUrlQueryParams from "@koine/utils/mergeUrlQueryParams";
-import getUrlHashParams from "@koine/utils/getUrlHashParams";
-import { navigateToHashParams } from "./navigateToHashParams";
-/**
- * It updates the "query params" within the `location.hash`, it uses `location`
- *
- * @category location
- */
-export function navigateToMergedHashParams(params, hash) {
-    if (params === void 0) { params = {}; }
-    if (hash === void 0) { hash = ""; }
-    return navigateToHashParams(mergeUrlQueryParams(getUrlHashParams(hash), params), hash);
-}
-export default navigateToMergedHashParams;

package/navigateToMergedParams.mjs

@@ -1,14 +0,0 @@
-import mergeUrlQueryParams from "@koine/utils/mergeUrlQueryParams";
-import getUrlQueryParams from "@koine/utils/getUrlQueryParams";
-import { navigateToParams } from "./navigateToParams";
-/**
- * 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.
- */
-export function navigateToMergedParams(params, replace) {
-    if (params === void 0) { params = {}; }
-    return navigateToParams(mergeUrlQueryParams(getUrlQueryParams(), params), replace);
-}
-export default navigateToMergedParams;

package/navigateToParams.mjs

@@ -1,19 +0,0 @@
-import isBrowser from "@koine/utils/isBrowser";
-import buildUrlQueryString from "@koine/utils/buildUrlQueryString";
-import navigateToUrl from "./navigateToUrl";
-/**
- * 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 `?`
- */
-export function navigateToParams(params, replace) {
-    if (params === void 0) { params = {}; }
-    var queryString = typeof params === "string" ? params : buildUrlQueryString(params);
-    if (isBrowser) {
-        navigateToUrl(location.pathname + queryString, replace);
-    }
-    return queryString;
-}
-export default navigateToParams;

package/navigateToUrl.mjs

@@ -1,12 +0,0 @@
-/**
- * It updates the browser's location URL with global `history` object
- *
- * @category location
- */
-export function navigateToUrl(url, replace) {
-    if (url === void 0) { url = ""; }
-    if (url) {
-        history[replace ? "replaceState" : "pushState"](history.state, "", url);
-    }
-}
-export default navigateToUrl;

package/navigateWithoutUrlParam.mjs

@@ -1,19 +0,0 @@
-import getUrlQueryParams from "@koine/utils/getUrlQueryParams";
-import navigateToParams from "./navigateToParams";
-/**
- * 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.
- */
-export function navigateWithoutUrlParam(paramName, replace) {
-    var params = {};
-    var currentParams = getUrlQueryParams();
-    for (var key in currentParams) {
-        if (key !== paramName) {
-            params[key] = currentParams[key];
-        }
-    }
-    return navigateToParams(params, replace);
-}
-export default navigateWithoutUrlParam;

package/redirectTo.mjs

@@ -1,15 +0,0 @@
-import isBrowser from "@koine/utils/isBrowser";
-import buildUrlQueryString from "@koine/utils/buildUrlQueryString";
-/**
- * Redirect to url with params {optionally}, removes eventual trailing question
- * marks from the given URL, it uses `location`
- *
- * @category location
- */
-export function redirectTo(url, params) {
-    if (isBrowser) {
-        var queryString = buildUrlQueryString(params);
-        location.href = url.replace(/\?+$/g, "") + queryString;
-    }
-}
-export default redirectTo;

package/storage.mjs

@@ -1,9 +0,0 @@
-import storageClient from "./storageClient";
-/**
- * Storage, for `localStorage` and `sessionStorage`
- */
-export var storage = {
-    l: storageClient(),
-    s: storageClient(true),
-};
-export default storage;

package/storageClient.mjs

@@ -1,103 +0,0 @@
-import isBrowser from "@koine/utils/isBrowser";
-import isString from "@koine/utils/isString";
-var methodsMap = { g: "getItem", s: "setItem", r: "removeItem" };
-/**
- * Super minifiable `local/session Storage` client creator with SSR safety
- */
-export var storageClient = function (useSessionStorage) {
-    var nativeMethod = function (method, key, value) {
-        return isBrowser
-            ? window[useSessionStorage ? "sessionStorage" : "localStorage"][methodsMap[method]](key, value)
-            : function () {
-                if (process.env["NODE_ENV"] !== "production") {
-                    console.warn("[@koine/utils:storageClient]: ".concat(useSessionStorage ? "sessionStorage" : "localStorage", " does not exists outside of browser."));
-                }
-            };
-    };
-    var get = function (key, transform, defaultValue) {
-        var value = defaultValue !== null && defaultValue !== void 0 ? defaultValue : null;
-        if (process.env["NODE_ENV"] !== "production") {
-            if (!isBrowser) {
-                console.log("[@koine/utils:storage] called 'get' outside of browser with default value '".concat(JSON.stringify(defaultValue), "'."));
-            }
-        }
-        if (isBrowser) {
-            var stored = nativeMethod("g", key);
-            if (stored) {
-                stored = transform ? transform(stored) : stored;
-                try {
-                    var parsed = JSON.parse(stored);
-                    if (parsed)
-                        value = parsed;
-                }
-                catch (_e) {
-                    value = stored;
-                    // if (process.env["NODE_ENV"] !== "production") {
-                    //   console.warn(
-                    //     `[@koine/utils:storage]: 'get' failed to parse stored value as JSON. Plain '${stored}' value is returned.`
-                    //   );
-                    // }
-                }
-            }
-        }
-        return value;
-    };
-    var set = function (key, value, transform) {
-        if (transform === void 0) { transform = function (value) { return value; }; }
-        if (process.env["NODE_ENV"] !== "production") {
-            if (!isBrowser) {
-                console.log("[@koine/utils:storage] called 'set' outside of browser does not work.");
-            }
-        }
-        if (isBrowser) {
-            try {
-                var transformedValue = isString(value)
-                    ? transform(value)
-                    : transform(JSON.stringify(value));
-                nativeMethod("s", key, transformedValue);
-            }
-            catch (_e) {
-                if (process.env["NODE_ENV"] !== "production") {
-                    console.warn("[@koine/utils:createStorage]: 'set' error.", _e);
-                }
-            }
-        }
-    };
-    var remove = function (key) {
-        if (process.env["NODE_ENV"] !== "production") {
-            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"] !== "production") {
-                    console.warn("[@koine/utils:createStorage]: 'remove' error.", _e);
-                }
-            }
-        }
-    };
-    var has = function (key, defaultValue) {
-        var value = defaultValue !== null && defaultValue !== void 0 ? defaultValue : false;
-        if (process.env["NODE_ENV"] !== "production") {
-            if (!isBrowser) {
-                console.log("[@koine/utils:storage] called 'has' outside of browser with default value '".concat(JSON.stringify(defaultValue), "'."));
-            }
-        }
-        if (isBrowser) {
-            var stored = nativeMethod("g", key);
-            value = stored !== null && stored !== void 0 ? stored : false;
-        }
-        return value;
-    };
-    return {
-        get: get,
-        set: set,
-        remove: remove,
-        has: has,
-    };
-};
-export default storageClient;