@posthog/browser-common 0.0.0 → 0.2.0

package/dist/utils/event-utils.mjs

@@ -0,0 +1,246 @@
+import { convertToURL, getQueryParam, maskQueryParams } from "./request-utils.mjs";
+import { detectBrowser, detectBrowserVersion, detectDevice, detectDeviceType, detectOS, isNull, isUndefined, stripLeadingDollar, stripUrlHash } from "@posthog/core";
+import config from "../config.mjs";
+import { SDK_DIST_CHANNEL } from "../constants.mjs";
+import { each, extend, stripEmptyProperties } from "./general-utils.mjs";
+import { document as external_globals_mjs_document, location as external_globals_mjs_location, userAgent, window as external_globals_mjs_window } from "./globals.mjs";
+import { getCookieValue } from "./cookie-utils.mjs";
+const URL_REGEX_PREFIX = 'https?://(.*)';
+const PERSONAL_DATA_CAMPAIGN_PARAMS = [
+    'gclid',
+    'gclsrc',
+    'dclid',
+    'gbraid',
+    'wbraid',
+    'fbclid',
+    'msclkid',
+    'twclid',
+    'li_fat_id',
+    'igshid',
+    'ttclid',
+    'rdt_cid',
+    'epik',
+    'qclid',
+    'sccid',
+    'irclid',
+    '_kx'
+];
+const CAMPAIGN_PARAMS = [
+    'utm_source',
+    'utm_medium',
+    'utm_campaign',
+    'utm_content',
+    'utm_term',
+    'gad_source',
+    'mc_cid',
+    ...PERSONAL_DATA_CAMPAIGN_PARAMS
+];
+const EVENT_TO_PERSON_PROPERTIES = [
+    '$app_build',
+    '$app_name',
+    '$app_namespace',
+    '$app_version',
+    '$browser',
+    '$browser_version',
+    '$device_type',
+    '$current_url',
+    '$pathname',
+    '$os',
+    '$os_name',
+    '$os_version',
+    '$referring_domain',
+    '$referrer',
+    '$screen_height',
+    '$screen_width',
+    '$viewport_height',
+    '$viewport_width',
+    '$raw_user_agent'
+];
+const MASKED = '<masked>';
+const COOKIE_CAMPAIGN_PARAMS = [
+    'li_fat_id'
+];
+function getCampaignParams(customTrackedParams, maskPersonalDataProperties, customPersonalDataProperties) {
+    if (!external_globals_mjs_document) return {};
+    const paramsToMask = maskPersonalDataProperties ? [
+        ...PERSONAL_DATA_CAMPAIGN_PARAMS,
+        ...customPersonalDataProperties || []
+    ] : [];
+    const urlCampaignParams = _getCampaignParamsFromUrl(maskQueryParams(external_globals_mjs_document.URL, paramsToMask, MASKED), customTrackedParams);
+    const cookieCampaignParams = _getCampaignParamsFromCookie();
+    return extend(cookieCampaignParams, urlCampaignParams);
+}
+function _getCampaignParamsFromUrl(url, customParams) {
+    const campaign_keywords = CAMPAIGN_PARAMS.concat(customParams || []);
+    const params = {};
+    each(campaign_keywords, function(kwkey) {
+        const kw = getQueryParam(url, kwkey);
+        params[kwkey] = kw ? kw : null;
+    });
+    return params;
+}
+function _getCampaignParamsFromCookie() {
+    const params = {};
+    each(COOKIE_CAMPAIGN_PARAMS, function(kwkey) {
+        const kw = getCookieValue(kwkey);
+        params[kwkey] = kw ? kw : null;
+    });
+    return params;
+}
+function _getSearchEngine(referrer) {
+    if (!referrer) return null;
+    if (0 === referrer.search(URL_REGEX_PREFIX + 'google.([^/?]*)')) return 'google';
+    if (0 === referrer.search(URL_REGEX_PREFIX + 'bing.com')) return 'bing';
+    if (0 === referrer.search(URL_REGEX_PREFIX + 'yahoo.com')) return 'yahoo';
+    if (0 === referrer.search(URL_REGEX_PREFIX + 'duckduckgo.com')) return 'duckduckgo';
+    else return null;
+}
+function _getSearchInfoFromReferrer(referrer) {
+    const search = _getSearchEngine(referrer);
+    const param = 'yahoo' != search ? 'q' : 'p';
+    const ret = {};
+    if (!isNull(search)) {
+        ret['$search_engine'] = search;
+        const keyword = external_globals_mjs_document ? getQueryParam(external_globals_mjs_document.referrer, param) : '';
+        if (keyword.length) ret['ph_keyword'] = keyword;
+    }
+    return ret;
+}
+function getSearchInfo() {
+    const referrer = external_globals_mjs_document?.referrer;
+    if (!referrer) return {};
+    return _getSearchInfoFromReferrer(referrer);
+}
+function getBrowserLanguage() {
+    return navigator.language || navigator.userLanguage;
+}
+function getBrowserLanguagePrefix() {
+    const lang = getBrowserLanguage();
+    return 'string' == typeof lang ? lang.split('-')[0] : void 0;
+}
+const DIRECT = '$direct';
+function getReferrer() {
+    return external_globals_mjs_document?.referrer || DIRECT;
+}
+function getReferringDomain() {
+    if (!external_globals_mjs_document?.referrer) return DIRECT;
+    return convertToURL(external_globals_mjs_document.referrer)?.host || DIRECT;
+}
+function getReferrerInfo() {
+    return {
+        $referrer: getReferrer(),
+        $referring_domain: getReferringDomain()
+    };
+}
+function getPersonInfo(maskPersonalDataProperties, customPersonalDataProperties, disableCaptureUrlHashes = false) {
+    const paramsToMask = maskPersonalDataProperties ? [
+        ...PERSONAL_DATA_CAMPAIGN_PARAMS,
+        ...customPersonalDataProperties || []
+    ] : [];
+    const href = disableCaptureUrlHashes ? stripUrlHash(external_globals_mjs_location?.href) : external_globals_mjs_location?.href;
+    const url = href?.substring(0, 1000);
+    return {
+        r: getReferrer().substring(0, 1000),
+        u: url ? maskQueryParams(url, paramsToMask, MASKED) : void 0
+    };
+}
+function getPersonPropsFromInfo(info, disableCaptureUrlHashes = false) {
+    const { r: referrer, u } = info;
+    const url = disableCaptureUrlHashes ? stripUrlHash(u) : u;
+    const referring_domain = null == referrer ? void 0 : referrer == DIRECT ? DIRECT : convertToURL(referrer)?.host;
+    const props = {
+        $referrer: referrer,
+        $referring_domain: referring_domain
+    };
+    if (url) {
+        props['$current_url'] = url;
+        const location = convertToURL(url);
+        props['$host'] = location?.host;
+        props['$pathname'] = location?.pathname;
+        const campaignParams = _getCampaignParamsFromUrl(url);
+        extend(props, campaignParams);
+    }
+    if (referrer) {
+        const searchInfo = _getSearchInfoFromReferrer(referrer);
+        extend(props, searchInfo);
+    }
+    return props;
+}
+function getInitialPersonPropsFromInfo(info, disableCaptureUrlHashes = false) {
+    const personProps = getPersonPropsFromInfo(info, disableCaptureUrlHashes);
+    const props = {};
+    each(personProps, function(val, key) {
+        props[`$initial_${stripLeadingDollar(key)}`] = val;
+    });
+    return props;
+}
+function getTimezone() {
+    try {
+        return Intl.DateTimeFormat().resolvedOptions().timeZone;
+    } catch  {
+        return;
+    }
+}
+function getTimezoneOffset() {
+    try {
+        return new Date().getTimezoneOffset();
+    } catch  {
+        return;
+    }
+}
+function getBrowserDetectionHints() {
+    const nav = 'undefined' != typeof navigator ? navigator : void 0;
+    return nav?.brave ? {
+        brave: true
+    } : {};
+}
+function getEventProperties(maskPersonalDataProperties, customPersonalDataProperties, detectGoogleSearchApp, disableCaptureUrlHashes = false) {
+    if (!userAgent) return {};
+    const paramsToMask = maskPersonalDataProperties ? [
+        ...PERSONAL_DATA_CAMPAIGN_PARAMS,
+        ...customPersonalDataProperties || []
+    ] : [];
+    const [os_name, os_version] = detectOS(userAgent);
+    const browserHints = getBrowserDetectionHints();
+    const browserOptions = {};
+    if (!isUndefined(detectGoogleSearchApp)) browserOptions.detectGoogleSearchApp = detectGoogleSearchApp;
+    const deviceOptions = {};
+    const userAgentDataPlatform = navigator?.userAgentData?.platform;
+    const maxTouchPoints = navigator?.maxTouchPoints;
+    const screenWidth = external_globals_mjs_window?.screen?.width;
+    const screenHeight = external_globals_mjs_window?.screen?.height;
+    const devicePixelRatio = external_globals_mjs_window?.devicePixelRatio;
+    if (!isUndefined(userAgentDataPlatform)) deviceOptions.userAgentDataPlatform = userAgentDataPlatform;
+    if (!isUndefined(maxTouchPoints)) deviceOptions.maxTouchPoints = maxTouchPoints;
+    if (!isUndefined(screenWidth)) deviceOptions.screenWidth = screenWidth;
+    if (!isUndefined(screenHeight)) deviceOptions.screenHeight = screenHeight;
+    if (!isUndefined(devicePixelRatio)) deviceOptions.devicePixelRatio = devicePixelRatio;
+    const properties = extend(stripEmptyProperties({
+        $os: os_name,
+        $os_version: os_version,
+        $browser: detectBrowser(userAgent, navigator.vendor, browserHints, browserOptions),
+        $device: detectDevice(userAgent),
+        $device_type: detectDeviceType(userAgent, deviceOptions),
+        $timezone: getTimezone(),
+        $timezone_offset: getTimezoneOffset()
+    }), {
+        $current_url: maskQueryParams(disableCaptureUrlHashes ? stripUrlHash(external_globals_mjs_location?.href) : external_globals_mjs_location?.href, paramsToMask, MASKED),
+        $host: external_globals_mjs_location?.host,
+        $pathname: external_globals_mjs_location?.pathname,
+        $raw_user_agent: userAgent.length > 1000 ? userAgent.substring(0, 997) + '...' : userAgent,
+        $browser_version: detectBrowserVersion(userAgent, navigator.vendor, browserHints, browserOptions),
+        $browser_language: getBrowserLanguage(),
+        $browser_language_prefix: getBrowserLanguagePrefix(),
+        $screen_height: external_globals_mjs_window?.screen.height,
+        $screen_width: external_globals_mjs_window?.screen.width,
+        $viewport_height: external_globals_mjs_window?.innerHeight,
+        $viewport_width: external_globals_mjs_window?.innerWidth,
+        $lib: config.LIB_NAME,
+        $lib_version: config.LIB_VERSION,
+        $insert_id: Math.random().toString(36).substring(2, 10) + Math.random().toString(36).substring(2, 10),
+        $time: Date.now() / 1000
+    });
+    if (config.SDK_DIST_CHANNEL) properties[SDK_DIST_CHANNEL] = config.SDK_DIST_CHANNEL;
+    return properties;
+}
+export { CAMPAIGN_PARAMS, COOKIE_CAMPAIGN_PARAMS, EVENT_TO_PERSON_PROPERTIES, MASKED, PERSONAL_DATA_CAMPAIGN_PARAMS, getBrowserDetectionHints, getBrowserLanguage, getBrowserLanguagePrefix, getCampaignParams, getEventProperties, getInitialPersonPropsFromInfo, getPersonInfo, getPersonPropsFromInfo, getReferrer, getReferrerInfo, getReferringDomain, getSearchInfo, getTimezone, getTimezoneOffset };

package/dist/utils/general-utils.d.ts

@@ -0,0 +1,30 @@
+import type { PostHogConfig, Properties } from '@posthog/types';
+export declare function find<T>(value: T[], predicate: (value: T) => boolean): T | undefined;
+export declare function eachArray<E = any>(obj: E[] | null | undefined, iterator: (value: E, key: number) => void): void;
+export declare function each(obj: any, iterator: (value: any, key: any) => void): void;
+export declare const extend: (obj: Record<string, any>, ...args: Record<string, any>[]) => Record<string, any>;
+/**
+ * Object.entries() polyfill
+ * https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/entries
+ */
+export declare function entries<T = any>(obj: Record<string, T>): [string, T][];
+export declare const trySafe: <T>(fn: () => T) => T | undefined;
+export declare const safewrap: <F extends (...args: any[]) => any = (...args: any[]) => any>(f: F) => F;
+export declare const safewrapClass: (klass: Function, functions: string[]) => void;
+export declare const stripEmptyProperties: (p: Properties) => Properties;
+export declare function _copyAndTruncateStrings<T extends Record<string, any> = Record<string, any>>(object: T, maxStringLength: number): T;
+export declare function isCrossDomainCookie(documentLocation: Location | undefined): boolean;
+export declare function addEventListener(element: Window | Document | Element | undefined, event: string, callback: EventListener, options?: AddEventListenerOptions): void;
+/**
+ * Helper to migrate deprecated config fields to new field names with appropriate warnings
+ * @param config - The config object to check
+ * @param newField - The new field name to use
+ * @param oldField - The deprecated field name to check for
+ * @param defaultValue - The default value if neither field is set
+ * @param loggerInstance - Optional logger instance for deprecation warnings
+ * @returns The value to use (new field takes precedence over old field)
+ */
+export declare function migrateConfigField<T>(config: Record<string, any>, newField: string, oldField: string, defaultValue: T, loggerInstance?: {
+    warn: (message: string) => void;
+}): T;
+export declare function isToolbarInstance(config: Pick<PostHogConfig, 'name'>): boolean;

package/dist/utils/general-utils.js

@@ -0,0 +1,191 @@
+"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__, {
+    find: ()=>find,
+    migrateConfigField: ()=>migrateConfigField,
+    each: ()=>each,
+    entries: ()=>entries,
+    safewrap: ()=>safewrap,
+    eachArray: ()=>eachArray,
+    safewrapClass: ()=>safewrapClass,
+    isCrossDomainCookie: ()=>isCrossDomainCookie,
+    _copyAndTruncateStrings: ()=>_copyAndTruncateStrings,
+    addEventListener: ()=>addEventListener,
+    extend: ()=>extend,
+    stripEmptyProperties: ()=>stripEmptyProperties,
+    isToolbarInstance: ()=>isToolbarInstance,
+    trySafe: ()=>trySafe
+});
+const core_namespaceObject = require("@posthog/core");
+const external_logger_js_namespaceObject = require("./logger.js");
+function find(value, predicate) {
+    for(let i = 0; i < value.length; i++)if (predicate(value[i])) return value[i];
+}
+function eachArray(obj, iterator) {
+    if ((0, core_namespaceObject.isArray)(obj)) obj.forEach(iterator);
+}
+function each(obj, iterator) {
+    if ((0, core_namespaceObject.isNullish)(obj)) return;
+    if ((0, core_namespaceObject.isArray)(obj)) return void obj.forEach(iterator);
+    if ((0, core_namespaceObject.isFormData)(obj)) return void obj.forEach((val, key)=>iterator(val, key));
+    for(const key in obj)if (core_namespaceObject.hasOwnProperty.call(obj, key)) iterator(obj[key], key);
+}
+const extend = function(obj, ...args) {
+    for (const source of args)for(const prop in source)if (void 0 !== source[prop]) obj[prop] = source[prop];
+    return obj;
+};
+function entries(obj) {
+    const ownProps = Object.keys(obj);
+    let i = ownProps.length;
+    const resArray = new Array(i);
+    while(i--)resArray[i] = [
+        ownProps[i],
+        obj[ownProps[i]]
+    ];
+    return resArray;
+}
+const trySafe = function(fn) {
+    try {
+        return fn();
+    } catch  {
+        return;
+    }
+};
+const safewrap = function(f) {
+    return function(...args) {
+        try {
+            return f.apply(this, args);
+        } catch (e) {
+            external_logger_js_namespaceObject.logger.critical('Implementation error. Please turn on debug mode and open a ticket on https://app.posthog.com/home#panel=support%3Asupport%3A.');
+            external_logger_js_namespaceObject.logger.critical(e);
+        }
+    };
+};
+const safewrapClass = function(klass, functions) {
+    for(let i = 0; i < functions.length; i++)klass.prototype[functions[i]] = safewrap(klass.prototype[functions[i]]);
+};
+const stripEmptyProperties = function(p) {
+    const ret = {};
+    each(p, function(v, k) {
+        if ((0, core_namespaceObject.isString)(v) && v.length > 0 || (0, core_namespaceObject.isNumber)(v)) ret[k] = v;
+    });
+    return ret;
+};
+function deepCircularCopy(value, customizer) {
+    const COPY_IN_PROGRESS_SET = new Set();
+    function internalDeepCircularCopy(value, key) {
+        if (value !== Object(value)) return customizer ? customizer(value, key) : value;
+        if (COPY_IN_PROGRESS_SET.has(value)) return;
+        COPY_IN_PROGRESS_SET.add(value);
+        let result;
+        if ((0, core_namespaceObject.isArray)(value)) {
+            result = [];
+            eachArray(value, (it)=>{
+                result.push(internalDeepCircularCopy(it));
+            });
+        } else {
+            const copy = {};
+            each(value, (val, key)=>{
+                if (!COPY_IN_PROGRESS_SET.has(val)) copy[key] = internalDeepCircularCopy(val, key);
+            });
+            result = copy;
+        }
+        return result;
+    }
+    return internalDeepCircularCopy(value);
+}
+function _copyAndTruncateStrings(object, maxStringLength) {
+    return deepCircularCopy(object, (value)=>{
+        if ((0, core_namespaceObject.isString)(value)) return value.slice(0, maxStringLength);
+        return value;
+    });
+}
+const EXCLUDED_FROM_CROSS_SUBDOMAIN_COOKIE = [
+    'herokuapp.com',
+    'vercel.app',
+    'netlify.app'
+];
+function isCrossDomainCookie(documentLocation) {
+    const hostname = documentLocation?.hostname;
+    if (!(0, core_namespaceObject.isString)(hostname)) return false;
+    const lastTwoParts = hostname.split('.').slice(-2).join('.');
+    for (const excluded of EXCLUDED_FROM_CROSS_SUBDOMAIN_COOKIE)if (lastTwoParts === excluded) return false;
+    return true;
+}
+function addEventListener(element, event, callback, options) {
+    const { capture = false, passive = true } = options ?? {};
+    element?.addEventListener(event, callback, {
+        capture,
+        passive
+    });
+}
+function migrateConfigField(config, newField, oldField, defaultValue, loggerInstance) {
+    const hasNewField = newField in config && !(0, core_namespaceObject.isNullish)(config[newField]);
+    const hasOldField = oldField in config && !(0, core_namespaceObject.isNullish)(config[oldField]);
+    if (hasNewField) return config[newField];
+    if (hasOldField) {
+        if (loggerInstance) loggerInstance.warn(`Config field '${oldField}' is deprecated. Please use '${newField}' instead. The old field will be removed in a future major version.`);
+        return config[oldField];
+    }
+    return defaultValue;
+}
+const TOOLBAR_INTERNAL_INSTANCE_NAME = 'ph_toolbar_internal';
+function isToolbarInstance(config) {
+    return config.name === TOOLBAR_INTERNAL_INSTANCE_NAME;
+}
+exports._copyAndTruncateStrings = __webpack_exports__._copyAndTruncateStrings;
+exports.addEventListener = __webpack_exports__.addEventListener;
+exports.each = __webpack_exports__.each;
+exports.eachArray = __webpack_exports__.eachArray;
+exports.entries = __webpack_exports__.entries;
+exports.extend = __webpack_exports__.extend;
+exports.find = __webpack_exports__.find;
+exports.isCrossDomainCookie = __webpack_exports__.isCrossDomainCookie;
+exports.isToolbarInstance = __webpack_exports__.isToolbarInstance;
+exports.migrateConfigField = __webpack_exports__.migrateConfigField;
+exports.safewrap = __webpack_exports__.safewrap;
+exports.safewrapClass = __webpack_exports__.safewrapClass;
+exports.stripEmptyProperties = __webpack_exports__.stripEmptyProperties;
+exports.trySafe = __webpack_exports__.trySafe;
+for(var __webpack_i__ in __webpack_exports__)if (-1 === [
+    "_copyAndTruncateStrings",
+    "addEventListener",
+    "each",
+    "eachArray",
+    "entries",
+    "extend",
+    "find",
+    "isCrossDomainCookie",
+    "isToolbarInstance",
+    "migrateConfigField",
+    "safewrap",
+    "safewrapClass",
+    "stripEmptyProperties",
+    "trySafe"
+].indexOf(__webpack_i__)) exports[__webpack_i__] = __webpack_exports__[__webpack_i__];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/utils/general-utils.mjs

@@ -0,0 +1,118 @@
+import { hasOwnProperty as core_hasOwnProperty, isArray, isFormData, isNullish, isNumber, isString } from "@posthog/core";
+import { logger } from "./logger.mjs";
+function find(value, predicate) {
+    for(let i = 0; i < value.length; i++)if (predicate(value[i])) return value[i];
+}
+function eachArray(obj, iterator) {
+    if (isArray(obj)) obj.forEach(iterator);
+}
+function each(obj, iterator) {
+    if (isNullish(obj)) return;
+    if (isArray(obj)) return void obj.forEach(iterator);
+    if (isFormData(obj)) return void obj.forEach((val, key)=>iterator(val, key));
+    for(const key in obj)if (core_hasOwnProperty.call(obj, key)) iterator(obj[key], key);
+}
+const extend = function(obj, ...args) {
+    for (const source of args)for(const prop in source)if (void 0 !== source[prop]) obj[prop] = source[prop];
+    return obj;
+};
+function entries(obj) {
+    const ownProps = Object.keys(obj);
+    let i = ownProps.length;
+    const resArray = new Array(i);
+    while(i--)resArray[i] = [
+        ownProps[i],
+        obj[ownProps[i]]
+    ];
+    return resArray;
+}
+const trySafe = function(fn) {
+    try {
+        return fn();
+    } catch  {
+        return;
+    }
+};
+const safewrap = function(f) {
+    return function(...args) {
+        try {
+            return f.apply(this, args);
+        } catch (e) {
+            logger.critical('Implementation error. Please turn on debug mode and open a ticket on https://app.posthog.com/home#panel=support%3Asupport%3A.');
+            logger.critical(e);
+        }
+    };
+};
+const safewrapClass = function(klass, functions) {
+    for(let i = 0; i < functions.length; i++)klass.prototype[functions[i]] = safewrap(klass.prototype[functions[i]]);
+};
+const stripEmptyProperties = function(p) {
+    const ret = {};
+    each(p, function(v, k) {
+        if (isString(v) && v.length > 0 || isNumber(v)) ret[k] = v;
+    });
+    return ret;
+};
+function deepCircularCopy(value, customizer) {
+    const COPY_IN_PROGRESS_SET = new Set();
+    function internalDeepCircularCopy(value, key) {
+        if (value !== Object(value)) return customizer ? customizer(value, key) : value;
+        if (COPY_IN_PROGRESS_SET.has(value)) return;
+        COPY_IN_PROGRESS_SET.add(value);
+        let result;
+        if (isArray(value)) {
+            result = [];
+            eachArray(value, (it)=>{
+                result.push(internalDeepCircularCopy(it));
+            });
+        } else {
+            const copy = {};
+            each(value, (val, key)=>{
+                if (!COPY_IN_PROGRESS_SET.has(val)) copy[key] = internalDeepCircularCopy(val, key);
+            });
+            result = copy;
+        }
+        return result;
+    }
+    return internalDeepCircularCopy(value);
+}
+function _copyAndTruncateStrings(object, maxStringLength) {
+    return deepCircularCopy(object, (value)=>{
+        if (isString(value)) return value.slice(0, maxStringLength);
+        return value;
+    });
+}
+const EXCLUDED_FROM_CROSS_SUBDOMAIN_COOKIE = [
+    'herokuapp.com',
+    'vercel.app',
+    'netlify.app'
+];
+function isCrossDomainCookie(documentLocation) {
+    const hostname = documentLocation?.hostname;
+    if (!isString(hostname)) return false;
+    const lastTwoParts = hostname.split('.').slice(-2).join('.');
+    for (const excluded of EXCLUDED_FROM_CROSS_SUBDOMAIN_COOKIE)if (lastTwoParts === excluded) return false;
+    return true;
+}
+function addEventListener(element, event, callback, options) {
+    const { capture = false, passive = true } = options ?? {};
+    element?.addEventListener(event, callback, {
+        capture,
+        passive
+    });
+}
+function migrateConfigField(config, newField, oldField, defaultValue, loggerInstance) {
+    const hasNewField = newField in config && !isNullish(config[newField]);
+    const hasOldField = oldField in config && !isNullish(config[oldField]);
+    if (hasNewField) return config[newField];
+    if (hasOldField) {
+        if (loggerInstance) loggerInstance.warn(`Config field '${oldField}' is deprecated. Please use '${newField}' instead. The old field will be removed in a future major version.`);
+        return config[oldField];
+    }
+    return defaultValue;
+}
+const TOOLBAR_INTERNAL_INSTANCE_NAME = 'ph_toolbar_internal';
+function isToolbarInstance(config) {
+    return config.name === TOOLBAR_INTERNAL_INSTANCE_NAME;
+}
+export { _copyAndTruncateStrings, addEventListener, each, eachArray, entries, extend, find, isCrossDomainCookie, isToolbarInstance, migrateConfigField, safewrap, safewrapClass, stripEmptyProperties, trySafe };

package/dist/utils/globals.d.ts

@@ -0,0 +1,25 @@
+declare const win: (Window & typeof globalThis) | undefined;
+export declare const navigator: Navigator | undefined;
+export declare const document: Document | undefined;
+export declare const location: Location | undefined;
+export declare const fetch: typeof globalThis.fetch | undefined;
+export declare const XMLHttpRequest: {
+    new (): XMLHttpRequest;
+    prototype: XMLHttpRequest;
+    readonly UNSENT: 0;
+    readonly OPENED: 1;
+    readonly HEADERS_RECEIVED: 2;
+    readonly LOADING: 3;
+    readonly DONE: 4;
+} | undefined;
+export declare const AbortController: {
+    new (): AbortController;
+    prototype: AbortController;
+} | undefined;
+export declare const CompressionStream: {
+    new (format: CompressionFormat): CompressionStream;
+    prototype: CompressionStream;
+} | undefined;
+export declare const userAgent: string | undefined;
+export declare function isBrowserOnline(): boolean;
+export { win as window };

package/dist/utils/globals.js

@@ -0,0 +1,75 @@
+"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__, {
+    AbortController: ()=>AbortController,
+    CompressionStream: ()=>CompressionStream,
+    XMLHttpRequest: ()=>XMLHttpRequest,
+    document: ()=>document,
+    fetch: ()=>fetch,
+    isBrowserOnline: ()=>isBrowserOnline,
+    location: ()=>location,
+    navigator: ()=>navigator,
+    userAgent: ()=>userAgent,
+    window: ()=>win
+});
+const win = 'undefined' != typeof window ? window : void 0;
+const global = 'undefined' != typeof globalThis ? globalThis : win;
+const navigator = global?.navigator;
+const document = global?.document;
+const location = global?.location;
+const fetch = global?.fetch;
+const XMLHttpRequest = global?.XMLHttpRequest && 'withCredentials' in new global.XMLHttpRequest() ? global.XMLHttpRequest : void 0;
+const AbortController = global?.AbortController;
+const CompressionStream = global?.CompressionStream;
+const userAgent = navigator?.userAgent;
+function isBrowserOnline() {
+    return !!(win && false !== win.navigator.onLine);
+}
+exports.AbortController = __webpack_exports__.AbortController;
+exports.CompressionStream = __webpack_exports__.CompressionStream;
+exports.XMLHttpRequest = __webpack_exports__.XMLHttpRequest;
+exports.document = __webpack_exports__.document;
+exports.fetch = __webpack_exports__.fetch;
+exports.isBrowserOnline = __webpack_exports__.isBrowserOnline;
+exports.location = __webpack_exports__.location;
+exports.navigator = __webpack_exports__.navigator;
+exports.userAgent = __webpack_exports__.userAgent;
+exports.window = __webpack_exports__.window;
+for(var __webpack_i__ in __webpack_exports__)if (-1 === [
+    "AbortController",
+    "CompressionStream",
+    "XMLHttpRequest",
+    "document",
+    "fetch",
+    "isBrowserOnline",
+    "location",
+    "navigator",
+    "userAgent",
+    "window"
+].indexOf(__webpack_i__)) exports[__webpack_i__] = __webpack_exports__[__webpack_i__];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});