@posthog/core 1.8.0 → 1.8.1

package/dist/utils/index.d.ts

@@ -6,6 +6,7 @@ export * from './string-utils';
 export * from './type-utils';
 export * from './promise-queue';
 export * from './logger';
+export * from './user-agent-utils';
 export declare const STRING_FORMAT = "utf8";
 export declare function assert(truthyValue: any, message: string): void;
 export declare function removeTrailingSlash(url: string): string;

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAEpC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,yBAAyB,CAAA;AACvC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,UAAU,CAAA;AAExB,eAAO,MAAM,aAAa,SAAS,CAAA;AAEnC,wBAAgB,MAAM,CAAC,WAAW,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAI9D;AASD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAA;CACtC;AAED,wBAAsB,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,CAAC,CAAC,CAqB5F;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,GAAG,CAOnE;AAGD,eAAO,MAAM,SAAS,GAAI,KAAK,GAAG,KAAG,GAAG,IAAI,OAAO,CAAC,GAAG,CAEtD,CAAA;AAED,eAAO,MAAM,OAAO,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,KAEzC,CAAA;AAED,wBAAgB,QAAQ,IAAI,SAAS,GAAG,SAAS,CAEhD;AAED,wBAAgB,UAAU,CAAC,CAAC,EAC1B,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,GAC1C,OAAO,CAAC,CAAC;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,GAAG,CAAA;CAAE,CAAC,EAAE,CAAC,CAStF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAEpC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,yBAAyB,CAAA;AACvC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,UAAU,CAAA;AACxB,cAAc,oBAAoB,CAAA;AAElC,eAAO,MAAM,aAAa,SAAS,CAAA;AAEnC,wBAAgB,MAAM,CAAC,WAAW,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAI9D;AASD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAA;CACtC;AAED,wBAAsB,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,CAAC,CAAC,CAqB5F;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,GAAG,CAOnE;AAGD,eAAO,MAAM,SAAS,GAAI,KAAK,GAAG,KAAG,GAAG,IAAI,OAAO,CAAC,GAAG,CAEtD,CAAA;AAED,eAAO,MAAM,OAAO,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,KAEzC,CAAA;AAED,wBAAgB,QAAQ,IAAI,SAAS,GAAG,SAAS,CAEhD;AAED,wBAAgB,UAAU,CAAC,CAAC,EAC1B,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,GAC1C,OAAO,CAAC,CAAC;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,GAAG,CAAA;CAAE,CAAC,EAAE,CAAC,CAStF"}

package/dist/utils/index.js

@@ -20,6 +20,9 @@ var __webpack_modules__ = {
     },
     "./type-utils": function(module) {
         module.exports = require("./type-utils.js");
+    },
+    "./user-agent-utils": function(module) {
+        module.exports = require("./user-agent-utils.js");
     }
 };
 var __webpack_module_cache__ = {};
@@ -211,6 +214,25 @@ var __webpack_exports__ = {};
         return _logger__WEBPACK_IMPORTED_MODULE_6__[key];
     }).bind(0, __WEBPACK_IMPORT_KEY__);
     __webpack_require__.d(__webpack_exports__, __WEBPACK_REEXPORT_OBJECT__);
+    var _user_agent_utils__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__("./user-agent-utils");
+    var __WEBPACK_REEXPORT_OBJECT__ = {};
+    for(var __WEBPACK_IMPORT_KEY__ in _user_agent_utils__WEBPACK_IMPORTED_MODULE_7__)if ([
+        "removeTrailingSlash",
+        "retriable",
+        "default",
+        "currentISOTime",
+        "currentTimestamp",
+        "STRING_FORMAT",
+        "isError",
+        "safeSetTimeout",
+        "getFetch",
+        "isPromise",
+        "assert",
+        "allSettled"
+    ].indexOf(__WEBPACK_IMPORT_KEY__) < 0) __WEBPACK_REEXPORT_OBJECT__[__WEBPACK_IMPORT_KEY__] = (function(key) {
+        return _user_agent_utils__WEBPACK_IMPORTED_MODULE_7__[key];
+    }).bind(0, __WEBPACK_IMPORT_KEY__);
+    __webpack_require__.d(__webpack_exports__, __WEBPACK_REEXPORT_OBJECT__);
     const STRING_FORMAT = 'utf8';
     function assert(truthyValue, message) {
         if (!truthyValue || 'string' != typeof truthyValue || isEmpty(truthyValue)) throw new Error(message);

package/dist/utils/index.mjs

@@ -5,6 +5,7 @@ export * from "./string-utils.mjs";
 export * from "./type-utils.mjs";
 export * from "./promise-queue.mjs";
 export * from "./logger.mjs";
+export * from "./user-agent-utils.mjs";
 const STRING_FORMAT = 'utf8';
 function assert(truthyValue, message) {
     if (!truthyValue || 'string' != typeof truthyValue || isEmpty(truthyValue)) throw new Error(message);

package/dist/utils/user-agent-utils.d.ts

@@ -0,0 +1,19 @@
+/**
+ * This function detects which browser is running this script.
+ * The order of the checks are important since many user agents
+ * include keywords used in later checks.
+ */
+export declare const detectBrowser: (user_agent: string, vendor: string | undefined) => string;
+/**
+ * This function detects which browser version is running this script,
+ * parsing major and minor version (e.g., 42.1). User agent strings from:
+ * http://www.useragentstring.com/pages/useragentstring.php
+ *
+ * `navigator.vendor` is passed in and used to help with detecting certain browsers
+ * NB `navigator.vendor` is deprecated and not present in every browser
+ */
+export declare const detectBrowserVersion: (userAgent: string, vendor: string | undefined) => number | null;
+export declare const detectOS: (user_agent: string) => [string, string];
+export declare const detectDevice: (user_agent: string) => string;
+export declare const detectDeviceType: (user_agent: string) => string;
+//# sourceMappingURL=user-agent-utils.d.ts.map

package/dist/utils/user-agent-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-agent-utils.d.ts","sourceRoot":"","sources":["../../src/utils/user-agent-utils.ts"],"names":[],"mappings":"AAqFA;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAa,YAAY,MAAM,EAAE,QAAQ,MAAM,GAAG,SAAS,KAAG,MA4CvF,CAAA;AAsBD;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAAa,WAAW,MAAM,EAAE,QAAQ,MAAM,GAAG,SAAS,KAAG,MAAM,GAAG,IAetG,CAAA;AA0FD,eAAO,MAAM,QAAQ,GAAa,YAAY,MAAM,KAAG,CAAC,MAAM,EAAE,MAAM,CAUrE,CAAA;AAED,eAAO,MAAM,YAAY,GAAa,YAAY,MAAM,KAAG,MAuD1D,CAAA;AAED,eAAO,MAAM,gBAAgB,GAAa,YAAY,MAAM,KAAG,MAmB9D,CAAA"}

package/dist/utils/user-agent-utils.js

@@ -0,0 +1,384 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    detectDeviceType: ()=>detectDeviceType,
+    detectOS: ()=>detectOS,
+    detectDevice: ()=>detectDevice,
+    detectBrowser: ()=>detectBrowser,
+    detectBrowserVersion: ()=>detectBrowserVersion
+});
+const external_string_utils_js_namespaceObject = require("./string-utils.js");
+const external_type_utils_js_namespaceObject = require("./type-utils.js");
+const FACEBOOK = 'Facebook';
+const MOBILE = 'Mobile';
+const IOS = 'iOS';
+const ANDROID = 'Android';
+const TABLET = 'Tablet';
+const ANDROID_TABLET = ANDROID + ' ' + TABLET;
+const IPAD = 'iPad';
+const APPLE = 'Apple';
+const APPLE_WATCH = APPLE + ' Watch';
+const SAFARI = 'Safari';
+const BLACKBERRY = 'BlackBerry';
+const SAMSUNG = 'Samsung';
+const SAMSUNG_BROWSER = SAMSUNG + 'Browser';
+const SAMSUNG_INTERNET = SAMSUNG + ' Internet';
+const CHROME = 'Chrome';
+const CHROME_OS = CHROME + ' OS';
+const CHROME_IOS = CHROME + ' ' + IOS;
+const INTERNET_EXPLORER = 'Internet Explorer';
+const INTERNET_EXPLORER_MOBILE = INTERNET_EXPLORER + ' ' + MOBILE;
+const OPERA = 'Opera';
+const OPERA_MINI = OPERA + ' Mini';
+const EDGE = 'Edge';
+const MICROSOFT_EDGE = 'Microsoft ' + EDGE;
+const FIREFOX = 'Firefox';
+const FIREFOX_IOS = FIREFOX + ' ' + IOS;
+const NINTENDO = 'Nintendo';
+const PLAYSTATION = 'PlayStation';
+const XBOX = 'Xbox';
+const ANDROID_MOBILE = ANDROID + ' ' + MOBILE;
+const MOBILE_SAFARI = MOBILE + ' ' + SAFARI;
+const WINDOWS = 'Windows';
+const WINDOWS_PHONE = WINDOWS + ' Phone';
+const NOKIA = 'Nokia';
+const OUYA = 'Ouya';
+const GENERIC = 'Generic';
+const GENERIC_MOBILE = GENERIC + ' ' + MOBILE.toLowerCase();
+const GENERIC_TABLET = GENERIC + ' ' + TABLET.toLowerCase();
+const KONQUEROR = 'Konqueror';
+const BROWSER_VERSION_REGEX_SUFFIX = '(\\d+(\\.\\d+)?)';
+const DEFAULT_BROWSER_VERSION_REGEX = new RegExp('Version/' + BROWSER_VERSION_REGEX_SUFFIX);
+const XBOX_REGEX = new RegExp(XBOX, 'i');
+const PLAYSTATION_REGEX = new RegExp(PLAYSTATION + ' \\w+', 'i');
+const NINTENDO_REGEX = new RegExp(NINTENDO + ' \\w+', 'i');
+const BLACKBERRY_REGEX = new RegExp(BLACKBERRY + '|PlayBook|BB10', 'i');
+const windowsVersionMap = {
+    'NT3.51': 'NT 3.11',
+    'NT4.0': 'NT 4.0',
+    '5.0': '2000',
+    '5.1': 'XP',
+    '5.2': 'XP',
+    '6.0': 'Vista',
+    '6.1': '7',
+    '6.2': '8',
+    '6.3': '8.1',
+    '6.4': '10',
+    '10.0': '10'
+};
+function isSafari(userAgent) {
+    return (0, external_string_utils_js_namespaceObject.includes)(userAgent, SAFARI) && !(0, external_string_utils_js_namespaceObject.includes)(userAgent, CHROME) && !(0, external_string_utils_js_namespaceObject.includes)(userAgent, ANDROID);
+}
+const safariCheck = (ua, vendor)=>vendor && (0, external_string_utils_js_namespaceObject.includes)(vendor, APPLE) || isSafari(ua);
+const detectBrowser = function(user_agent, vendor) {
+    vendor = vendor || '';
+    if ((0, external_string_utils_js_namespaceObject.includes)(user_agent, ' OPR/') && (0, external_string_utils_js_namespaceObject.includes)(user_agent, 'Mini')) return OPERA_MINI;
+    if ((0, external_string_utils_js_namespaceObject.includes)(user_agent, ' OPR/')) return OPERA;
+    if (BLACKBERRY_REGEX.test(user_agent)) return BLACKBERRY;
+    if ((0, external_string_utils_js_namespaceObject.includes)(user_agent, 'IE' + MOBILE) || (0, external_string_utils_js_namespaceObject.includes)(user_agent, 'WPDesktop')) return INTERNET_EXPLORER_MOBILE;
+    if ((0, external_string_utils_js_namespaceObject.includes)(user_agent, SAMSUNG_BROWSER)) return SAMSUNG_INTERNET;
+    else if ((0, external_string_utils_js_namespaceObject.includes)(user_agent, EDGE) || (0, external_string_utils_js_namespaceObject.includes)(user_agent, 'Edg/')) return MICROSOFT_EDGE;
+    else if ((0, external_string_utils_js_namespaceObject.includes)(user_agent, 'FBIOS')) return FACEBOOK + ' ' + MOBILE;
+    else if ((0, external_string_utils_js_namespaceObject.includes)(user_agent, 'UCWEB') || (0, external_string_utils_js_namespaceObject.includes)(user_agent, 'UCBrowser')) return 'UC Browser';
+    else if ((0, external_string_utils_js_namespaceObject.includes)(user_agent, 'CriOS')) return CHROME_IOS;
+    else if ((0, external_string_utils_js_namespaceObject.includes)(user_agent, 'CrMo')) return CHROME;
+    else if ((0, external_string_utils_js_namespaceObject.includes)(user_agent, CHROME)) return CHROME;
+    else if ((0, external_string_utils_js_namespaceObject.includes)(user_agent, ANDROID) && (0, external_string_utils_js_namespaceObject.includes)(user_agent, SAFARI)) return ANDROID_MOBILE;
+    else if ((0, external_string_utils_js_namespaceObject.includes)(user_agent, 'FxiOS')) return FIREFOX_IOS;
+    else if ((0, external_string_utils_js_namespaceObject.includes)(user_agent.toLowerCase(), KONQUEROR.toLowerCase())) return KONQUEROR;
+    else if (safariCheck(user_agent, vendor)) return (0, external_string_utils_js_namespaceObject.includes)(user_agent, MOBILE) ? MOBILE_SAFARI : SAFARI;
+    else if ((0, external_string_utils_js_namespaceObject.includes)(user_agent, FIREFOX)) return FIREFOX;
+    else if ((0, external_string_utils_js_namespaceObject.includes)(user_agent, 'MSIE') || (0, external_string_utils_js_namespaceObject.includes)(user_agent, 'Trident/')) return INTERNET_EXPLORER;
+    else if ((0, external_string_utils_js_namespaceObject.includes)(user_agent, 'Gecko')) return FIREFOX;
+    return '';
+};
+const versionRegexes = {
+    [INTERNET_EXPLORER_MOBILE]: [
+        new RegExp('rv:' + BROWSER_VERSION_REGEX_SUFFIX)
+    ],
+    [MICROSOFT_EDGE]: [
+        new RegExp(EDGE + '?\\/' + BROWSER_VERSION_REGEX_SUFFIX)
+    ],
+    [CHROME]: [
+        new RegExp('(' + CHROME + '|CrMo)\\/' + BROWSER_VERSION_REGEX_SUFFIX)
+    ],
+    [CHROME_IOS]: [
+        new RegExp('CriOS\\/' + BROWSER_VERSION_REGEX_SUFFIX)
+    ],
+    'UC Browser': [
+        new RegExp('(UCBrowser|UCWEB)\\/' + BROWSER_VERSION_REGEX_SUFFIX)
+    ],
+    [SAFARI]: [
+        DEFAULT_BROWSER_VERSION_REGEX
+    ],
+    [MOBILE_SAFARI]: [
+        DEFAULT_BROWSER_VERSION_REGEX
+    ],
+    [OPERA]: [
+        new RegExp('(' + OPERA + '|OPR)\\/' + BROWSER_VERSION_REGEX_SUFFIX)
+    ],
+    [FIREFOX]: [
+        new RegExp(FIREFOX + '\\/' + BROWSER_VERSION_REGEX_SUFFIX)
+    ],
+    [FIREFOX_IOS]: [
+        new RegExp('FxiOS\\/' + BROWSER_VERSION_REGEX_SUFFIX)
+    ],
+    [KONQUEROR]: [
+        new RegExp('Konqueror[:/]?' + BROWSER_VERSION_REGEX_SUFFIX, 'i')
+    ],
+    [BLACKBERRY]: [
+        new RegExp(BLACKBERRY + ' ' + BROWSER_VERSION_REGEX_SUFFIX),
+        DEFAULT_BROWSER_VERSION_REGEX
+    ],
+    [ANDROID_MOBILE]: [
+        new RegExp('android\\s' + BROWSER_VERSION_REGEX_SUFFIX, 'i')
+    ],
+    [SAMSUNG_INTERNET]: [
+        new RegExp(SAMSUNG_BROWSER + '\\/' + BROWSER_VERSION_REGEX_SUFFIX)
+    ],
+    [INTERNET_EXPLORER]: [
+        new RegExp('(rv:|MSIE )' + BROWSER_VERSION_REGEX_SUFFIX)
+    ],
+    Mozilla: [
+        new RegExp('rv:' + BROWSER_VERSION_REGEX_SUFFIX)
+    ]
+};
+const detectBrowserVersion = function(userAgent, vendor) {
+    const browser = detectBrowser(userAgent, vendor);
+    const regexes = versionRegexes[browser];
+    if ((0, external_type_utils_js_namespaceObject.isUndefined)(regexes)) return null;
+    for(let i = 0; i < regexes.length; i++){
+        const regex = regexes[i];
+        const matches = userAgent.match(regex);
+        if (matches) return parseFloat(matches[matches.length - 2]);
+    }
+    return null;
+};
+const osMatchers = [
+    [
+        new RegExp(XBOX + '; ' + XBOX + ' (.*?)[);]', 'i'),
+        (match)=>[
+                XBOX,
+                match && match[1] || ''
+            ]
+    ],
+    [
+        new RegExp(NINTENDO, 'i'),
+        [
+            NINTENDO,
+            ''
+        ]
+    ],
+    [
+        new RegExp(PLAYSTATION, 'i'),
+        [
+            PLAYSTATION,
+            ''
+        ]
+    ],
+    [
+        BLACKBERRY_REGEX,
+        [
+            BLACKBERRY,
+            ''
+        ]
+    ],
+    [
+        new RegExp(WINDOWS, 'i'),
+        (_, user_agent)=>{
+            if (/Phone/.test(user_agent) || /WPDesktop/.test(user_agent)) return [
+                WINDOWS_PHONE,
+                ''
+            ];
+            if (new RegExp(MOBILE).test(user_agent) && !/IEMobile\b/.test(user_agent)) return [
+                WINDOWS + ' ' + MOBILE,
+                ''
+            ];
+            const match = /Windows NT ([0-9.]+)/i.exec(user_agent);
+            if (match && match[1]) {
+                const version = match[1];
+                let osVersion = windowsVersionMap[version] || '';
+                if (/arm/i.test(user_agent)) osVersion = 'RT';
+                return [
+                    WINDOWS,
+                    osVersion
+                ];
+            }
+            return [
+                WINDOWS,
+                ''
+            ];
+        }
+    ],
+    [
+        /((iPhone|iPad|iPod).*?OS (\d+)_(\d+)_?(\d+)?|iPhone)/,
+        (match)=>{
+            if (match && match[3]) {
+                const versionParts = [
+                    match[3],
+                    match[4],
+                    match[5] || '0'
+                ];
+                return [
+                    IOS,
+                    versionParts.join('.')
+                ];
+            }
+            return [
+                IOS,
+                ''
+            ];
+        }
+    ],
+    [
+        /(watch.*\/(\d+\.\d+\.\d+)|watch os,(\d+\.\d+),)/i,
+        (match)=>{
+            let version = '';
+            if (match && match.length >= 3) version = (0, external_type_utils_js_namespaceObject.isUndefined)(match[2]) ? match[3] : match[2];
+            return [
+                'watchOS',
+                version
+            ];
+        }
+    ],
+    [
+        new RegExp('(' + ANDROID + ' (\\d+)\\.(\\d+)\\.?(\\d+)?|' + ANDROID + ')', 'i'),
+        (match)=>{
+            if (match && match[2]) {
+                const versionParts = [
+                    match[2],
+                    match[3],
+                    match[4] || '0'
+                ];
+                return [
+                    ANDROID,
+                    versionParts.join('.')
+                ];
+            }
+            return [
+                ANDROID,
+                ''
+            ];
+        }
+    ],
+    [
+        /Mac OS X (\d+)[_.](\d+)[_.]?(\d+)?/i,
+        (match)=>{
+            const result = [
+                'Mac OS X',
+                ''
+            ];
+            if (match && match[1]) {
+                const versionParts = [
+                    match[1],
+                    match[2],
+                    match[3] || '0'
+                ];
+                result[1] = versionParts.join('.');
+            }
+            return result;
+        }
+    ],
+    [
+        /Mac/i,
+        [
+            'Mac OS X',
+            ''
+        ]
+    ],
+    [
+        /CrOS/,
+        [
+            CHROME_OS,
+            ''
+        ]
+    ],
+    [
+        /Linux|debian/i,
+        [
+            'Linux',
+            ''
+        ]
+    ]
+];
+const detectOS = function(user_agent) {
+    for(let i = 0; i < osMatchers.length; i++){
+        const [rgex, resultOrFn] = osMatchers[i];
+        const match = rgex.exec(user_agent);
+        const result = match && ((0, external_type_utils_js_namespaceObject.isFunction)(resultOrFn) ? resultOrFn(match, user_agent) : resultOrFn);
+        if (result) return result;
+    }
+    return [
+        '',
+        ''
+    ];
+};
+const detectDevice = function(user_agent) {
+    if (NINTENDO_REGEX.test(user_agent)) return NINTENDO;
+    if (PLAYSTATION_REGEX.test(user_agent)) return PLAYSTATION;
+    if (XBOX_REGEX.test(user_agent)) return XBOX;
+    if (new RegExp(OUYA, 'i').test(user_agent)) return OUYA;
+    if (new RegExp('(' + WINDOWS_PHONE + '|WPDesktop)', 'i').test(user_agent)) return WINDOWS_PHONE;
+    else if (/iPad/.test(user_agent)) return IPAD;
+    else if (/iPod/.test(user_agent)) return 'iPod Touch';
+    else if (/iPhone/.test(user_agent)) return 'iPhone';
+    else if (/(watch)(?: ?os[,/]|\d,\d\/)[\d.]+/i.test(user_agent)) return APPLE_WATCH;
+    else if (BLACKBERRY_REGEX.test(user_agent)) return BLACKBERRY;
+    else if (/(kobo)\s(ereader|touch)/i.test(user_agent)) return 'Kobo';
+    else if (new RegExp(NOKIA, 'i').test(user_agent)) return NOKIA;
+    else if (/(kf[a-z]{2}wi|aeo[c-r]{2})( bui|\))/i.test(user_agent) || /(kf[a-z]+)( bui|\)).+silk\//i.test(user_agent)) return 'Kindle Fire';
+    else if (/(Android|ZTE)/i.test(user_agent)) if (!(!new RegExp(MOBILE).test(user_agent) || /(9138B|TB782B|Nexus [97]|pixel c|HUAWEISHT|BTV|noble nook|smart ultra 6)/i.test(user_agent))) return ANDROID;
+    else {
+        if (/pixel[\daxl ]{1,6}/i.test(user_agent) && !/pixel c/i.test(user_agent) || /(huaweimed-al00|tah-|APA|SM-G92|i980|zte|U304AA)/i.test(user_agent) || /lmy47v/i.test(user_agent) && !/QTAQZ3/i.test(user_agent)) return ANDROID;
+        return ANDROID_TABLET;
+    }
+    else if (new RegExp('(pda|' + MOBILE + ')', 'i').test(user_agent)) return GENERIC_MOBILE;
+    else if (new RegExp(TABLET, 'i').test(user_agent) && !new RegExp(TABLET + ' pc', 'i').test(user_agent)) return GENERIC_TABLET;
+    else return '';
+};
+const detectDeviceType = function(user_agent) {
+    const device = detectDevice(user_agent);
+    if (device === IPAD || device === ANDROID_TABLET || 'Kobo' === device || 'Kindle Fire' === device || device === GENERIC_TABLET) return TABLET;
+    if (device === NINTENDO || device === XBOX || device === PLAYSTATION || device === OUYA) return 'Console';
+    if (device === APPLE_WATCH) return 'Wearable';
+    if (device) return MOBILE;
+    return 'Desktop';
+};
+exports.detectBrowser = __webpack_exports__.detectBrowser;
+exports.detectBrowserVersion = __webpack_exports__.detectBrowserVersion;
+exports.detectDevice = __webpack_exports__.detectDevice;
+exports.detectDeviceType = __webpack_exports__.detectDeviceType;
+exports.detectOS = __webpack_exports__.detectOS;
+for(var __webpack_i__ in __webpack_exports__)if (-1 === [
+    "detectBrowser",
+    "detectBrowserVersion",
+    "detectDevice",
+    "detectDeviceType",
+    "detectOS"
+].indexOf(__webpack_i__)) exports[__webpack_i__] = __webpack_exports__[__webpack_i__];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/utils/user-agent-utils.mjs

@@ -0,0 +1,338 @@
+import { includes } from "./string-utils.mjs";
+import { isFunction, isUndefined } from "./type-utils.mjs";
+const FACEBOOK = 'Facebook';
+const MOBILE = 'Mobile';
+const IOS = 'iOS';
+const ANDROID = 'Android';
+const TABLET = 'Tablet';
+const ANDROID_TABLET = ANDROID + ' ' + TABLET;
+const IPAD = 'iPad';
+const APPLE = 'Apple';
+const APPLE_WATCH = APPLE + ' Watch';
+const SAFARI = 'Safari';
+const BLACKBERRY = 'BlackBerry';
+const SAMSUNG = 'Samsung';
+const SAMSUNG_BROWSER = SAMSUNG + 'Browser';
+const SAMSUNG_INTERNET = SAMSUNG + ' Internet';
+const CHROME = 'Chrome';
+const CHROME_OS = CHROME + ' OS';
+const CHROME_IOS = CHROME + ' ' + IOS;
+const INTERNET_EXPLORER = 'Internet Explorer';
+const INTERNET_EXPLORER_MOBILE = INTERNET_EXPLORER + ' ' + MOBILE;
+const OPERA = 'Opera';
+const OPERA_MINI = OPERA + ' Mini';
+const EDGE = 'Edge';
+const MICROSOFT_EDGE = 'Microsoft ' + EDGE;
+const FIREFOX = 'Firefox';
+const FIREFOX_IOS = FIREFOX + ' ' + IOS;
+const NINTENDO = 'Nintendo';
+const PLAYSTATION = 'PlayStation';
+const XBOX = 'Xbox';
+const ANDROID_MOBILE = ANDROID + ' ' + MOBILE;
+const MOBILE_SAFARI = MOBILE + ' ' + SAFARI;
+const WINDOWS = 'Windows';
+const WINDOWS_PHONE = WINDOWS + ' Phone';
+const NOKIA = 'Nokia';
+const OUYA = 'Ouya';
+const GENERIC = 'Generic';
+const GENERIC_MOBILE = GENERIC + ' ' + MOBILE.toLowerCase();
+const GENERIC_TABLET = GENERIC + ' ' + TABLET.toLowerCase();
+const KONQUEROR = 'Konqueror';
+const BROWSER_VERSION_REGEX_SUFFIX = '(\\d+(\\.\\d+)?)';
+const DEFAULT_BROWSER_VERSION_REGEX = new RegExp('Version/' + BROWSER_VERSION_REGEX_SUFFIX);
+const XBOX_REGEX = new RegExp(XBOX, 'i');
+const PLAYSTATION_REGEX = new RegExp(PLAYSTATION + ' \\w+', 'i');
+const NINTENDO_REGEX = new RegExp(NINTENDO + ' \\w+', 'i');
+const BLACKBERRY_REGEX = new RegExp(BLACKBERRY + '|PlayBook|BB10', 'i');
+const windowsVersionMap = {
+    'NT3.51': 'NT 3.11',
+    'NT4.0': 'NT 4.0',
+    '5.0': '2000',
+    '5.1': 'XP',
+    '5.2': 'XP',
+    '6.0': 'Vista',
+    '6.1': '7',
+    '6.2': '8',
+    '6.3': '8.1',
+    '6.4': '10',
+    '10.0': '10'
+};
+function isSafari(userAgent) {
+    return includes(userAgent, SAFARI) && !includes(userAgent, CHROME) && !includes(userAgent, ANDROID);
+}
+const safariCheck = (ua, vendor)=>vendor && includes(vendor, APPLE) || isSafari(ua);
+const detectBrowser = function(user_agent, vendor) {
+    vendor = vendor || '';
+    if (includes(user_agent, ' OPR/') && includes(user_agent, 'Mini')) return OPERA_MINI;
+    if (includes(user_agent, ' OPR/')) return OPERA;
+    if (BLACKBERRY_REGEX.test(user_agent)) return BLACKBERRY;
+    if (includes(user_agent, 'IE' + MOBILE) || includes(user_agent, 'WPDesktop')) return INTERNET_EXPLORER_MOBILE;
+    if (includes(user_agent, SAMSUNG_BROWSER)) return SAMSUNG_INTERNET;
+    else if (includes(user_agent, EDGE) || includes(user_agent, 'Edg/')) return MICROSOFT_EDGE;
+    else if (includes(user_agent, 'FBIOS')) return FACEBOOK + ' ' + MOBILE;
+    else if (includes(user_agent, 'UCWEB') || includes(user_agent, 'UCBrowser')) return 'UC Browser';
+    else if (includes(user_agent, 'CriOS')) return CHROME_IOS;
+    else if (includes(user_agent, 'CrMo')) return CHROME;
+    else if (includes(user_agent, CHROME)) return CHROME;
+    else if (includes(user_agent, ANDROID) && includes(user_agent, SAFARI)) return ANDROID_MOBILE;
+    else if (includes(user_agent, 'FxiOS')) return FIREFOX_IOS;
+    else if (includes(user_agent.toLowerCase(), KONQUEROR.toLowerCase())) return KONQUEROR;
+    else if (safariCheck(user_agent, vendor)) return includes(user_agent, MOBILE) ? MOBILE_SAFARI : SAFARI;
+    else if (includes(user_agent, FIREFOX)) return FIREFOX;
+    else if (includes(user_agent, 'MSIE') || includes(user_agent, 'Trident/')) return INTERNET_EXPLORER;
+    else if (includes(user_agent, 'Gecko')) return FIREFOX;
+    return '';
+};
+const versionRegexes = {
+    [INTERNET_EXPLORER_MOBILE]: [
+        new RegExp('rv:' + BROWSER_VERSION_REGEX_SUFFIX)
+    ],
+    [MICROSOFT_EDGE]: [
+        new RegExp(EDGE + '?\\/' + BROWSER_VERSION_REGEX_SUFFIX)
+    ],
+    [CHROME]: [
+        new RegExp('(' + CHROME + '|CrMo)\\/' + BROWSER_VERSION_REGEX_SUFFIX)
+    ],
+    [CHROME_IOS]: [
+        new RegExp('CriOS\\/' + BROWSER_VERSION_REGEX_SUFFIX)
+    ],
+    'UC Browser': [
+        new RegExp('(UCBrowser|UCWEB)\\/' + BROWSER_VERSION_REGEX_SUFFIX)
+    ],
+    [SAFARI]: [
+        DEFAULT_BROWSER_VERSION_REGEX
+    ],
+    [MOBILE_SAFARI]: [
+        DEFAULT_BROWSER_VERSION_REGEX
+    ],
+    [OPERA]: [
+        new RegExp('(' + OPERA + '|OPR)\\/' + BROWSER_VERSION_REGEX_SUFFIX)
+    ],
+    [FIREFOX]: [
+        new RegExp(FIREFOX + '\\/' + BROWSER_VERSION_REGEX_SUFFIX)
+    ],
+    [FIREFOX_IOS]: [
+        new RegExp('FxiOS\\/' + BROWSER_VERSION_REGEX_SUFFIX)
+    ],
+    [KONQUEROR]: [
+        new RegExp('Konqueror[:/]?' + BROWSER_VERSION_REGEX_SUFFIX, 'i')
+    ],
+    [BLACKBERRY]: [
+        new RegExp(BLACKBERRY + ' ' + BROWSER_VERSION_REGEX_SUFFIX),
+        DEFAULT_BROWSER_VERSION_REGEX
+    ],
+    [ANDROID_MOBILE]: [
+        new RegExp('android\\s' + BROWSER_VERSION_REGEX_SUFFIX, 'i')
+    ],
+    [SAMSUNG_INTERNET]: [
+        new RegExp(SAMSUNG_BROWSER + '\\/' + BROWSER_VERSION_REGEX_SUFFIX)
+    ],
+    [INTERNET_EXPLORER]: [
+        new RegExp('(rv:|MSIE )' + BROWSER_VERSION_REGEX_SUFFIX)
+    ],
+    Mozilla: [
+        new RegExp('rv:' + BROWSER_VERSION_REGEX_SUFFIX)
+    ]
+};
+const detectBrowserVersion = function(userAgent, vendor) {
+    const browser = detectBrowser(userAgent, vendor);
+    const regexes = versionRegexes[browser];
+    if (isUndefined(regexes)) return null;
+    for(let i = 0; i < regexes.length; i++){
+        const regex = regexes[i];
+        const matches = userAgent.match(regex);
+        if (matches) return parseFloat(matches[matches.length - 2]);
+    }
+    return null;
+};
+const osMatchers = [
+    [
+        new RegExp(XBOX + '; ' + XBOX + ' (.*?)[);]', 'i'),
+        (match)=>[
+                XBOX,
+                match && match[1] || ''
+            ]
+    ],
+    [
+        new RegExp(NINTENDO, 'i'),
+        [
+            NINTENDO,
+            ''
+        ]
+    ],
+    [
+        new RegExp(PLAYSTATION, 'i'),
+        [
+            PLAYSTATION,
+            ''
+        ]
+    ],
+    [
+        BLACKBERRY_REGEX,
+        [
+            BLACKBERRY,
+            ''
+        ]
+    ],
+    [
+        new RegExp(WINDOWS, 'i'),
+        (_, user_agent)=>{
+            if (/Phone/.test(user_agent) || /WPDesktop/.test(user_agent)) return [
+                WINDOWS_PHONE,
+                ''
+            ];
+            if (new RegExp(MOBILE).test(user_agent) && !/IEMobile\b/.test(user_agent)) return [
+                WINDOWS + ' ' + MOBILE,
+                ''
+            ];
+            const match = /Windows NT ([0-9.]+)/i.exec(user_agent);
+            if (match && match[1]) {
+                const version = match[1];
+                let osVersion = windowsVersionMap[version] || '';
+                if (/arm/i.test(user_agent)) osVersion = 'RT';
+                return [
+                    WINDOWS,
+                    osVersion
+                ];
+            }
+            return [
+                WINDOWS,
+                ''
+            ];
+        }
+    ],
+    [
+        /((iPhone|iPad|iPod).*?OS (\d+)_(\d+)_?(\d+)?|iPhone)/,
+        (match)=>{
+            if (match && match[3]) {
+                const versionParts = [
+                    match[3],
+                    match[4],
+                    match[5] || '0'
+                ];
+                return [
+                    IOS,
+                    versionParts.join('.')
+                ];
+            }
+            return [
+                IOS,
+                ''
+            ];
+        }
+    ],
+    [
+        /(watch.*\/(\d+\.\d+\.\d+)|watch os,(\d+\.\d+),)/i,
+        (match)=>{
+            let version = '';
+            if (match && match.length >= 3) version = isUndefined(match[2]) ? match[3] : match[2];
+            return [
+                'watchOS',
+                version
+            ];
+        }
+    ],
+    [
+        new RegExp('(' + ANDROID + ' (\\d+)\\.(\\d+)\\.?(\\d+)?|' + ANDROID + ')', 'i'),
+        (match)=>{
+            if (match && match[2]) {
+                const versionParts = [
+                    match[2],
+                    match[3],
+                    match[4] || '0'
+                ];
+                return [
+                    ANDROID,
+                    versionParts.join('.')
+                ];
+            }
+            return [
+                ANDROID,
+                ''
+            ];
+        }
+    ],
+    [
+        /Mac OS X (\d+)[_.](\d+)[_.]?(\d+)?/i,
+        (match)=>{
+            const result = [
+                'Mac OS X',
+                ''
+            ];
+            if (match && match[1]) {
+                const versionParts = [
+                    match[1],
+                    match[2],
+                    match[3] || '0'
+                ];
+                result[1] = versionParts.join('.');
+            }
+            return result;
+        }
+    ],
+    [
+        /Mac/i,
+        [
+            'Mac OS X',
+            ''
+        ]
+    ],
+    [
+        /CrOS/,
+        [
+            CHROME_OS,
+            ''
+        ]
+    ],
+    [
+        /Linux|debian/i,
+        [
+            'Linux',
+            ''
+        ]
+    ]
+];
+const detectOS = function(user_agent) {
+    for(let i = 0; i < osMatchers.length; i++){
+        const [rgex, resultOrFn] = osMatchers[i];
+        const match = rgex.exec(user_agent);
+        const result = match && (isFunction(resultOrFn) ? resultOrFn(match, user_agent) : resultOrFn);
+        if (result) return result;
+    }
+    return [
+        '',
+        ''
+    ];
+};
+const detectDevice = function(user_agent) {
+    if (NINTENDO_REGEX.test(user_agent)) return NINTENDO;
+    if (PLAYSTATION_REGEX.test(user_agent)) return PLAYSTATION;
+    if (XBOX_REGEX.test(user_agent)) return XBOX;
+    if (new RegExp(OUYA, 'i').test(user_agent)) return OUYA;
+    if (new RegExp('(' + WINDOWS_PHONE + '|WPDesktop)', 'i').test(user_agent)) return WINDOWS_PHONE;
+    else if (/iPad/.test(user_agent)) return IPAD;
+    else if (/iPod/.test(user_agent)) return 'iPod Touch';
+    else if (/iPhone/.test(user_agent)) return 'iPhone';
+    else if (/(watch)(?: ?os[,/]|\d,\d\/)[\d.]+/i.test(user_agent)) return APPLE_WATCH;
+    else if (BLACKBERRY_REGEX.test(user_agent)) return BLACKBERRY;
+    else if (/(kobo)\s(ereader|touch)/i.test(user_agent)) return 'Kobo';
+    else if (new RegExp(NOKIA, 'i').test(user_agent)) return NOKIA;
+    else if (/(kf[a-z]{2}wi|aeo[c-r]{2})( bui|\))/i.test(user_agent) || /(kf[a-z]+)( bui|\)).+silk\//i.test(user_agent)) return 'Kindle Fire';
+    else if (/(Android|ZTE)/i.test(user_agent)) if (!(!new RegExp(MOBILE).test(user_agent) || /(9138B|TB782B|Nexus [97]|pixel c|HUAWEISHT|BTV|noble nook|smart ultra 6)/i.test(user_agent))) return ANDROID;
+    else {
+        if (/pixel[\daxl ]{1,6}/i.test(user_agent) && !/pixel c/i.test(user_agent) || /(huaweimed-al00|tah-|APA|SM-G92|i980|zte|U304AA)/i.test(user_agent) || /lmy47v/i.test(user_agent) && !/QTAQZ3/i.test(user_agent)) return ANDROID;
+        return ANDROID_TABLET;
+    }
+    else if (new RegExp('(pda|' + MOBILE + ')', 'i').test(user_agent)) return GENERIC_MOBILE;
+    else if (new RegExp(TABLET, 'i').test(user_agent) && !new RegExp(TABLET + ' pc', 'i').test(user_agent)) return GENERIC_TABLET;
+    else return '';
+};
+const detectDeviceType = function(user_agent) {
+    const device = detectDevice(user_agent);
+    if (device === IPAD || device === ANDROID_TABLET || 'Kobo' === device || 'Kindle Fire' === device || device === GENERIC_TABLET) return TABLET;
+    if (device === NINTENDO || device === XBOX || device === PLAYSTATION || device === OUYA) return 'Console';
+    if (device === APPLE_WATCH) return 'Wearable';
+    if (device) return MOBILE;
+    return 'Desktop';
+};
+export { detectBrowser, detectBrowserVersion, detectDevice, detectDeviceType, detectOS };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@posthog/core",
-  "version": "1.8.0",
+  "version": "1.8.1",
   "license": "MIT",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/utils/index.ts

@@ -7,6 +7,7 @@ export * from './string-utils'
 export * from './type-utils'
 export * from './promise-queue'
 export * from './logger'
+export * from './user-agent-utils'
 
 export const STRING_FORMAT = 'utf8'
 

package/src/utils/user-agent-utils.ts

@@ -0,0 +1,358 @@
+import { includes } from './string-utils'
+import { isFunction, isUndefined } from './type-utils'
+
+/**
+ * this device detection code is (at time of writing) about 3% of the size of the entire library
+ * this is mostly because the identifiers user in regexes and results can't be minified away since
+ * they have meaning
+ *
+ * so, there are some pre-uglifying choices in the code to help reduce the size
+ * e.g. many repeated strings are stored as variables and then old-fashioned concatenated together
+ *
+ * TL;DR here be dragons
+ */
+const FACEBOOK = 'Facebook'
+const MOBILE = 'Mobile'
+const IOS = 'iOS'
+const ANDROID = 'Android'
+const TABLET = 'Tablet'
+const ANDROID_TABLET = ANDROID + ' ' + TABLET
+const IPAD = 'iPad'
+const APPLE = 'Apple'
+const APPLE_WATCH = APPLE + ' Watch'
+const SAFARI = 'Safari'
+const BLACKBERRY = 'BlackBerry'
+const SAMSUNG = 'Samsung'
+const SAMSUNG_BROWSER = SAMSUNG + 'Browser'
+const SAMSUNG_INTERNET = SAMSUNG + ' Internet'
+const CHROME = 'Chrome'
+const CHROME_OS = CHROME + ' OS'
+const CHROME_IOS = CHROME + ' ' + IOS
+const INTERNET_EXPLORER = 'Internet Explorer'
+const INTERNET_EXPLORER_MOBILE = INTERNET_EXPLORER + ' ' + MOBILE
+const OPERA = 'Opera'
+const OPERA_MINI = OPERA + ' Mini'
+const EDGE = 'Edge'
+const MICROSOFT_EDGE = 'Microsoft ' + EDGE
+const FIREFOX = 'Firefox'
+const FIREFOX_IOS = FIREFOX + ' ' + IOS
+const NINTENDO = 'Nintendo'
+const PLAYSTATION = 'PlayStation'
+const XBOX = 'Xbox'
+const ANDROID_MOBILE = ANDROID + ' ' + MOBILE
+const MOBILE_SAFARI = MOBILE + ' ' + SAFARI
+const WINDOWS = 'Windows'
+const WINDOWS_PHONE = WINDOWS + ' Phone'
+const NOKIA = 'Nokia'
+const OUYA = 'Ouya'
+const GENERIC = 'Generic'
+const GENERIC_MOBILE = GENERIC + ' ' + MOBILE.toLowerCase()
+const GENERIC_TABLET = GENERIC + ' ' + TABLET.toLowerCase()
+const KONQUEROR = 'Konqueror'
+
+const BROWSER_VERSION_REGEX_SUFFIX = '(\\d+(\\.\\d+)?)'
+const DEFAULT_BROWSER_VERSION_REGEX = new RegExp('Version/' + BROWSER_VERSION_REGEX_SUFFIX)
+
+const XBOX_REGEX = new RegExp(XBOX, 'i')
+const PLAYSTATION_REGEX = new RegExp(PLAYSTATION + ' \\w+', 'i')
+const NINTENDO_REGEX = new RegExp(NINTENDO + ' \\w+', 'i')
+const BLACKBERRY_REGEX = new RegExp(BLACKBERRY + '|PlayBook|BB10', 'i')
+
+const windowsVersionMap: Record<string, string> = {
+  'NT3.51': 'NT 3.11',
+  'NT4.0': 'NT 4.0',
+  '5.0': '2000',
+  '5.1': 'XP',
+  '5.2': 'XP',
+  '6.0': 'Vista',
+  '6.1': '7',
+  '6.2': '8',
+  '6.3': '8.1',
+  '6.4': '10',
+  '10.0': '10',
+}
+
+/**
+ * Safari detection turns out to be complicated. For e.g. https://stackoverflow.com/a/29696509
+ * We can be slightly loose because some options have been ruled out (e.g. firefox on iOS)
+ * before this check is made
+ */
+function isSafari(userAgent: string): boolean {
+  return includes(userAgent, SAFARI) && !includes(userAgent, CHROME) && !includes(userAgent, ANDROID)
+}
+
+const safariCheck = (ua: string, vendor?: string) => (vendor && includes(vendor, APPLE)) || isSafari(ua)
+
+/**
+ * This function detects which browser is running this script.
+ * The order of the checks are important since many user agents
+ * include keywords used in later checks.
+ */
+export const detectBrowser = function (user_agent: string, vendor: string | undefined): string {
+  vendor = vendor || '' // vendor is undefined for at least IE9
+
+  if (includes(user_agent, ' OPR/') && includes(user_agent, 'Mini')) {
+    return OPERA_MINI
+  } else if (includes(user_agent, ' OPR/')) {
+    return OPERA
+  } else if (BLACKBERRY_REGEX.test(user_agent)) {
+    return BLACKBERRY
+  } else if (includes(user_agent, 'IE' + MOBILE) || includes(user_agent, 'WPDesktop')) {
+    return INTERNET_EXPLORER_MOBILE
+  }
+  // https://developer.samsung.com/internet/user-agent-string-format
+  else if (includes(user_agent, SAMSUNG_BROWSER)) {
+    return SAMSUNG_INTERNET
+  } else if (includes(user_agent, EDGE) || includes(user_agent, 'Edg/')) {
+    return MICROSOFT_EDGE
+  } else if (includes(user_agent, 'FBIOS')) {
+    return FACEBOOK + ' ' + MOBILE
+  } else if (includes(user_agent, 'UCWEB') || includes(user_agent, 'UCBrowser')) {
+    return 'UC Browser'
+  } else if (includes(user_agent, 'CriOS')) {
+    return CHROME_IOS // why not just Chrome?
+  } else if (includes(user_agent, 'CrMo')) {
+    return CHROME
+  } else if (includes(user_agent, CHROME)) {
+    return CHROME
+  } else if (includes(user_agent, ANDROID) && includes(user_agent, SAFARI)) {
+    return ANDROID_MOBILE
+  } else if (includes(user_agent, 'FxiOS')) {
+    return FIREFOX_IOS
+  } else if (includes(user_agent.toLowerCase(), KONQUEROR.toLowerCase())) {
+    return KONQUEROR
+  } else if (safariCheck(user_agent, vendor)) {
+    return includes(user_agent, MOBILE) ? MOBILE_SAFARI : SAFARI
+  } else if (includes(user_agent, FIREFOX)) {
+    return FIREFOX
+  } else if (includes(user_agent, 'MSIE') || includes(user_agent, 'Trident/')) {
+    return INTERNET_EXPLORER
+  } else if (includes(user_agent, 'Gecko')) {
+    return FIREFOX
+  }
+
+  return ''
+}
+
+const versionRegexes: Record<string, RegExp[]> = {
+  [INTERNET_EXPLORER_MOBILE]: [new RegExp('rv:' + BROWSER_VERSION_REGEX_SUFFIX)],
+  [MICROSOFT_EDGE]: [new RegExp(EDGE + '?\\/' + BROWSER_VERSION_REGEX_SUFFIX)],
+  [CHROME]: [new RegExp('(' + CHROME + '|CrMo)\\/' + BROWSER_VERSION_REGEX_SUFFIX)],
+  [CHROME_IOS]: [new RegExp('CriOS\\/' + BROWSER_VERSION_REGEX_SUFFIX)],
+  'UC Browser': [new RegExp('(UCBrowser|UCWEB)\\/' + BROWSER_VERSION_REGEX_SUFFIX)],
+  [SAFARI]: [DEFAULT_BROWSER_VERSION_REGEX],
+  [MOBILE_SAFARI]: [DEFAULT_BROWSER_VERSION_REGEX],
+  [OPERA]: [new RegExp('(' + OPERA + '|OPR)\\/' + BROWSER_VERSION_REGEX_SUFFIX)],
+  [FIREFOX]: [new RegExp(FIREFOX + '\\/' + BROWSER_VERSION_REGEX_SUFFIX)],
+  [FIREFOX_IOS]: [new RegExp('FxiOS\\/' + BROWSER_VERSION_REGEX_SUFFIX)],
+  [KONQUEROR]: [new RegExp('Konqueror[:/]?' + BROWSER_VERSION_REGEX_SUFFIX, 'i')],
+  // not every blackberry user agent has the version after the name
+  [BLACKBERRY]: [new RegExp(BLACKBERRY + ' ' + BROWSER_VERSION_REGEX_SUFFIX), DEFAULT_BROWSER_VERSION_REGEX],
+  [ANDROID_MOBILE]: [new RegExp('android\\s' + BROWSER_VERSION_REGEX_SUFFIX, 'i')],
+  [SAMSUNG_INTERNET]: [new RegExp(SAMSUNG_BROWSER + '\\/' + BROWSER_VERSION_REGEX_SUFFIX)],
+  [INTERNET_EXPLORER]: [new RegExp('(rv:|MSIE )' + BROWSER_VERSION_REGEX_SUFFIX)],
+  Mozilla: [new RegExp('rv:' + BROWSER_VERSION_REGEX_SUFFIX)],
+}
+
+/**
+ * This function detects which browser version is running this script,
+ * parsing major and minor version (e.g., 42.1). User agent strings from:
+ * http://www.useragentstring.com/pages/useragentstring.php
+ *
+ * `navigator.vendor` is passed in and used to help with detecting certain browsers
+ * NB `navigator.vendor` is deprecated and not present in every browser
+ */
+export const detectBrowserVersion = function (userAgent: string, vendor: string | undefined): number | null {
+  const browser = detectBrowser(userAgent, vendor)
+  const regexes: RegExp[] | undefined = versionRegexes[browser as keyof typeof versionRegexes]
+  if (isUndefined(regexes)) {
+    return null
+  }
+
+  for (let i = 0; i < regexes.length; i++) {
+    const regex = regexes[i]
+    const matches = userAgent.match(regex)
+    if (matches) {
+      return parseFloat(matches[matches.length - 2])
+    }
+  }
+  return null
+}
+
+// to avoid repeating regexes or calling them twice, we have an array of matches
+// the first regex that matches uses its matcher function to return the result
+const osMatchers: [
+  RegExp,
+  [string, string] | ((match: RegExpMatchArray | null, user_agent: string) => [string, string]),
+][] = [
+  [
+    new RegExp(XBOX + '; ' + XBOX + ' (.*?)[);]', 'i'),
+    (match) => {
+      return [XBOX, (match && match[1]) || '']
+    },
+  ],
+  [new RegExp(NINTENDO, 'i'), [NINTENDO, '']],
+  [new RegExp(PLAYSTATION, 'i'), [PLAYSTATION, '']],
+  [BLACKBERRY_REGEX, [BLACKBERRY, '']],
+  [
+    new RegExp(WINDOWS, 'i'),
+    (_, user_agent) => {
+      if (/Phone/.test(user_agent) || /WPDesktop/.test(user_agent)) {
+        return [WINDOWS_PHONE, '']
+      }
+      // not all JS versions support negative lookbehind, so we need two checks here
+      if (new RegExp(MOBILE).test(user_agent) && !/IEMobile\b/.test(user_agent)) {
+        return [WINDOWS + ' ' + MOBILE, '']
+      }
+      const match = /Windows NT ([0-9.]+)/i.exec(user_agent)
+      if (match && match[1]) {
+        const version = match[1]
+        let osVersion = windowsVersionMap[version] || ''
+        if (/arm/i.test(user_agent)) {
+          osVersion = 'RT'
+        }
+        return [WINDOWS, osVersion]
+      }
+      return [WINDOWS, '']
+    },
+  ],
+  [
+    /((iPhone|iPad|iPod).*?OS (\d+)_(\d+)_?(\d+)?|iPhone)/,
+    (match) => {
+      if (match && match[3]) {
+        const versionParts = [match[3], match[4], match[5] || '0']
+        return [IOS, versionParts.join('.')]
+      }
+      return [IOS, '']
+    },
+  ],
+  [
+    /(watch.*\/(\d+\.\d+\.\d+)|watch os,(\d+\.\d+),)/i,
+    (match) => {
+      // e.g. Watch4,3/5.3.8 (16U680)
+      let version = ''
+      if (match && match.length >= 3) {
+        version = isUndefined(match[2]) ? match[3] : match[2]
+      }
+      return ['watchOS', version]
+    },
+  ],
+  [
+    new RegExp('(' + ANDROID + ' (\\d+)\\.(\\d+)\\.?(\\d+)?|' + ANDROID + ')', 'i'),
+    (match) => {
+      if (match && match[2]) {
+        const versionParts = [match[2], match[3], match[4] || '0']
+        return [ANDROID, versionParts.join('.')]
+      }
+      return [ANDROID, '']
+    },
+  ],
+  [
+    /Mac OS X (\d+)[_.](\d+)[_.]?(\d+)?/i,
+    (match) => {
+      const result: [string, string] = ['Mac OS X', '']
+      if (match && match[1]) {
+        const versionParts = [match[1], match[2], match[3] || '0']
+        result[1] = versionParts.join('.')
+      }
+      return result
+    },
+  ],
+  [
+    /Mac/i,
+    // mop up a few non-standard UAs that should match mac
+    ['Mac OS X', ''],
+  ],
+  [/CrOS/, [CHROME_OS, '']],
+  [/Linux|debian/i, ['Linux', '']],
+]
+
+export const detectOS = function (user_agent: string): [string, string] {
+  for (let i = 0; i < osMatchers.length; i++) {
+    const [rgex, resultOrFn] = osMatchers[i]
+    const match = rgex.exec(user_agent)
+    const result = match && (isFunction(resultOrFn) ? resultOrFn(match, user_agent) : resultOrFn)
+    if (result) {
+      return result
+    }
+  }
+  return ['', '']
+}
+
+export const detectDevice = function (user_agent: string): string {
+  if (NINTENDO_REGEX.test(user_agent)) {
+    return NINTENDO
+  } else if (PLAYSTATION_REGEX.test(user_agent)) {
+    return PLAYSTATION
+  } else if (XBOX_REGEX.test(user_agent)) {
+    return XBOX
+  } else if (new RegExp(OUYA, 'i').test(user_agent)) {
+    return OUYA
+  } else if (new RegExp('(' + WINDOWS_PHONE + '|WPDesktop)', 'i').test(user_agent)) {
+    return WINDOWS_PHONE
+  } else if (/iPad/.test(user_agent)) {
+    return IPAD
+  } else if (/iPod/.test(user_agent)) {
+    return 'iPod Touch'
+  } else if (/iPhone/.test(user_agent)) {
+    return 'iPhone'
+  } else if (/(watch)(?: ?os[,/]|\d,\d\/)[\d.]+/i.test(user_agent)) {
+    return APPLE_WATCH
+  } else if (BLACKBERRY_REGEX.test(user_agent)) {
+    return BLACKBERRY
+  } else if (/(kobo)\s(ereader|touch)/i.test(user_agent)) {
+    return 'Kobo'
+  } else if (new RegExp(NOKIA, 'i').test(user_agent)) {
+    return NOKIA
+  } else if (
+    // Kindle Fire without Silk / Echo Show
+    /(kf[a-z]{2}wi|aeo[c-r]{2})( bui|\))/i.test(user_agent) ||
+    // Kindle Fire HD
+    /(kf[a-z]+)( bui|\)).+silk\//i.test(user_agent)
+  ) {
+    return 'Kindle Fire'
+  } else if (/(Android|ZTE)/i.test(user_agent)) {
+    if (
+      !new RegExp(MOBILE).test(user_agent) ||
+      /(9138B|TB782B|Nexus [97]|pixel c|HUAWEISHT|BTV|noble nook|smart ultra 6)/i.test(user_agent)
+    ) {
+      if (
+        (/pixel[\daxl ]{1,6}/i.test(user_agent) && !/pixel c/i.test(user_agent)) ||
+        /(huaweimed-al00|tah-|APA|SM-G92|i980|zte|U304AA)/i.test(user_agent) ||
+        (/lmy47v/i.test(user_agent) && !/QTAQZ3/i.test(user_agent))
+      ) {
+        return ANDROID
+      }
+      return ANDROID_TABLET
+    } else {
+      return ANDROID
+    }
+  } else if (new RegExp('(pda|' + MOBILE + ')', 'i').test(user_agent)) {
+    return GENERIC_MOBILE
+  } else if (new RegExp(TABLET, 'i').test(user_agent) && !new RegExp(TABLET + ' pc', 'i').test(user_agent)) {
+    return GENERIC_TABLET
+  } else {
+    return ''
+  }
+}
+
+export const detectDeviceType = function (user_agent: string): string {
+  const device = detectDevice(user_agent)
+  if (
+    device === IPAD ||
+    device === ANDROID_TABLET ||
+    device === 'Kobo' ||
+    device === 'Kindle Fire' ||
+    device === GENERIC_TABLET
+  ) {
+    return TABLET
+  } else if (device === NINTENDO || device === XBOX || device === PLAYSTATION || device === OUYA) {
+    return 'Console'
+  } else if (device === APPLE_WATCH) {
+    return 'Wearable'
+  } else if (device) {
+    return MOBILE
+  } else {
+    return 'Desktop'
+  }
+}