@posthog/core 1.30.14 → 1.31.0

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

@@ -7,6 +7,15 @@
 export interface BrowserDetectionHints {
     brave?: boolean;
 }
+/**
+ * Opt-in tweaks to UA-string detection. These change how existing traffic is
+ * attributed, so the host SDK gates them (behind its `2026-05-30` config
+ * defaults) rather than enabling them unconditionally — turning one on
+ * reattributes browsers that were previously reported as something else.
+ */
+export interface BrowserDetectionOptions {
+    detectGoogleSearchApp?: boolean;
+}
 /**
  * This function detects which browser is running this script.
  * The order of the checks are important since many user agents
@@ -16,8 +25,10 @@ export interface BrowserDetectionHints {
  * detect browsers that intentionally do not identify themselves in the UA
  * string. When omitted, only UA-string detection runs — preserving the previous
  * behaviour.
+ *
+ * `options` toggles opt-in UA-detection tweaks (see `BrowserDetectionOptions`).
  */
-export declare const detectBrowser: (user_agent: string, vendor: string | undefined, hints?: BrowserDetectionHints) => string;
+export declare const detectBrowser: (user_agent: string, vendor: string | undefined, hints?: BrowserDetectionHints, options?: BrowserDetectionOptions) => string;
 /**
  * This function detects which browser version is running this script,
  * parsing major and minor version (e.g., 42.1). User agent strings from:
@@ -26,7 +37,7 @@ export declare const detectBrowser: (user_agent: string, vendor: string | undefi
  * `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, hints?: BrowserDetectionHints) => number | null;
+export declare const detectBrowserVersion: (userAgent: string, vendor: string | undefined, hints?: BrowserDetectionHints, options?: BrowserDetectionOptions) => 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, options?: {

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

@@ -1 +1 @@
-{"version":3,"file":"user-agent-utils.d.ts","sourceRoot":"","sources":["../../src/utils/user-agent-utils.ts"],"names":[],"mappings":"AA+DA;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IAGpC,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAuCD;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,GACxB,YAAY,MAAM,EAClB,QAAQ,MAAM,GAAG,SAAS,EAC1B,QAAQ,qBAAqB,KAC5B,MAmFF,CAAA;AAkCD;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAC/B,WAAW,MAAM,EACjB,QAAQ,MAAM,GAAG,SAAS,EAC1B,QAAQ,qBAAqB,KAC5B,MAAM,GAAG,IAmBX,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,GAC3B,YAAY,MAAM,EAClB,UAAU;IACR,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B,KACA,MA4BF,CAAA"}
+{"version":3,"file":"user-agent-utils.d.ts","sourceRoot":"","sources":["../../src/utils/user-agent-utils.ts"],"names":[],"mappings":"AAgEA;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IAGpC,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AASD;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IAGtC,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAChC;AAgCD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,GACxB,YAAY,MAAM,EAClB,QAAQ,MAAM,GAAG,SAAS,EAC1B,QAAQ,qBAAqB,EAC7B,UAAU,uBAAuB,KAChC,MA2FF,CAAA;AAmCD;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAC/B,WAAW,MAAM,EACjB,QAAQ,MAAM,GAAG,SAAS,EAC1B,QAAQ,qBAAqB,EAC7B,UAAU,uBAAuB,KAChC,MAAM,GAAG,IAmBX,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,GAC3B,YAAY,MAAM,EAClB,UAAU;IACR,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B,KACA,MA4BF,CAAA"}

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

@@ -78,6 +78,7 @@ const DUCKDUCKGO = 'DuckDuckGo';
 const PALE_MOON = 'Pale Moon';
 const WATERFOX = 'Waterfox';
 const BRAVE = 'Brave';
+const GOOGLE_SEARCH_APP = 'Google Search App';
 const BROWSER_VERSION_REGEX_SUFFIX = '(\\d+(\\.\\d+)?)';
 const DEFAULT_BROWSER_VERSION_REGEX = new RegExp('Version/' + BROWSER_VERSION_REGEX_SUFFIX);
 function browserFromHints(hints) {
@@ -105,10 +106,11 @@ 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, hints) {
+const detectBrowser = function(user_agent, vendor, hints, options) {
     vendor = vendor || '';
     const fromHints = browserFromHints(hints);
     if (fromHints) return fromHints;
+    if (options?.detectGoogleSearchApp && (0, external_string_utils_js_namespaceObject.includes)(user_agent, 'GSA/')) return GOOGLE_SEARCH_APP;
     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;
@@ -205,6 +207,9 @@ const versionRegexes = {
     [WATERFOX]: [
         new RegExp(WATERFOX + '\\/' + BROWSER_VERSION_REGEX_SUFFIX)
     ],
+    [GOOGLE_SEARCH_APP]: [
+        new RegExp('GSA\\/' + BROWSER_VERSION_REGEX_SUFFIX)
+    ],
     [INTERNET_EXPLORER]: [
         new RegExp('(rv:|MSIE )' + BROWSER_VERSION_REGEX_SUFFIX)
     ],
@@ -212,8 +217,8 @@ const versionRegexes = {
         new RegExp('rv:' + BROWSER_VERSION_REGEX_SUFFIX)
     ]
 };
-const detectBrowserVersion = function(userAgent, vendor, hints) {
-    const browser = detectBrowser(userAgent, vendor, hints);
+const detectBrowserVersion = function(userAgent, vendor, hints, options) {
+    const browser = detectBrowser(userAgent, vendor, hints, options);
     const regexes = versionRegexes[browser];
     if ((0, external_type_utils_js_namespaceObject.isUndefined)(regexes)) return null;
     for(let i = 0; i < regexes.length; i++){

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

@@ -46,6 +46,7 @@ const DUCKDUCKGO = 'DuckDuckGo';
 const PALE_MOON = 'Pale Moon';
 const WATERFOX = 'Waterfox';
 const BRAVE = 'Brave';
+const GOOGLE_SEARCH_APP = 'Google Search App';
 const BROWSER_VERSION_REGEX_SUFFIX = '(\\d+(\\.\\d+)?)';
 const DEFAULT_BROWSER_VERSION_REGEX = new RegExp('Version/' + BROWSER_VERSION_REGEX_SUFFIX);
 function browserFromHints(hints) {
@@ -73,10 +74,11 @@ 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, hints) {
+const detectBrowser = function(user_agent, vendor, hints, options) {
     vendor = vendor || '';
     const fromHints = browserFromHints(hints);
     if (fromHints) return fromHints;
+    if (options?.detectGoogleSearchApp && includes(user_agent, 'GSA/')) return GOOGLE_SEARCH_APP;
     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;
@@ -173,6 +175,9 @@ const versionRegexes = {
     [WATERFOX]: [
         new RegExp(WATERFOX + '\\/' + BROWSER_VERSION_REGEX_SUFFIX)
     ],
+    [GOOGLE_SEARCH_APP]: [
+        new RegExp('GSA\\/' + BROWSER_VERSION_REGEX_SUFFIX)
+    ],
     [INTERNET_EXPLORER]: [
         new RegExp('(rv:|MSIE )' + BROWSER_VERSION_REGEX_SUFFIX)
     ],
@@ -180,8 +185,8 @@ const versionRegexes = {
         new RegExp('rv:' + BROWSER_VERSION_REGEX_SUFFIX)
     ]
 };
-const detectBrowserVersion = function(userAgent, vendor, hints) {
-    const browser = detectBrowser(userAgent, vendor, hints);
+const detectBrowserVersion = function(userAgent, vendor, hints, options) {
+    const browser = detectBrowser(userAgent, vendor, hints, options);
     const regexes = versionRegexes[browser];
     if (isUndefined(regexes)) return null;
     for(let i = 0; i < regexes.length; i++){

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@posthog/core",
-  "version": "1.30.14",
+  "version": "1.31.0",
   "license": "MIT",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -67,7 +67,7 @@
     }
   },
   "dependencies": {
-    "@posthog/types": "1.383.3"
+    "@posthog/types": "1.384.0"
   },
   "devDependencies": {
     "@rslib/core": "0.10.6",

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

@@ -57,6 +57,7 @@ const DUCKDUCKGO = 'DuckDuckGo'
 const PALE_MOON = 'Pale Moon'
 const WATERFOX = 'Waterfox'
 const BRAVE = 'Brave'
+const GOOGLE_SEARCH_APP = 'Google Search App'
 
 const BROWSER_VERSION_REGEX_SUFFIX = '(\\d+(\\.\\d+)?)'
 const DEFAULT_BROWSER_VERSION_REGEX = new RegExp('Version/' + BROWSER_VERSION_REGEX_SUFFIX)
@@ -80,6 +81,18 @@ function browserFromHints(hints: BrowserDetectionHints | undefined): string | nu
   return null
 }
 
+/**
+ * Opt-in tweaks to UA-string detection. These change how existing traffic is
+ * attributed, so the host SDK gates them (behind its `2026-05-30` config
+ * defaults) rather than enabling them unconditionally — turning one on
+ * reattributes browsers that were previously reported as something else.
+ */
+export interface BrowserDetectionOptions {
+  // Surface the Google Search App as its own browser via its `GSA/` UA marker
+  // instead of the underlying webview (Mobile Safari on iOS, Chrome on Android).
+  detectGoogleSearchApp?: boolean
+}
+
 const XBOX_REGEX = new RegExp(XBOX, 'i')
 const PLAYSTATION_REGEX = new RegExp(PLAYSTATION + ' \\w+', 'i')
 const NINTENDO_REGEX = new RegExp(NINTENDO + ' \\w+', 'i')
@@ -119,11 +132,14 @@ const safariCheck = (ua: string, vendor?: string) => (vendor && includes(vendor,
  * detect browsers that intentionally do not identify themselves in the UA
  * string. When omitted, only UA-string detection runs — preserving the previous
  * behaviour.
+ *
+ * `options` toggles opt-in UA-detection tweaks (see `BrowserDetectionOptions`).
  */
 export const detectBrowser = function (
   user_agent: string,
   vendor: string | undefined,
-  hints?: BrowserDetectionHints
+  hints?: BrowserDetectionHints,
+  options?: BrowserDetectionOptions
 ): string {
   vendor = vendor || '' // vendor is undefined for at least IE9
 
@@ -135,6 +151,14 @@ export const detectBrowser = function (
     return fromHints
   }
 
+  // The Google Search App embeds a platform webview, so its UA otherwise looks
+  // like Mobile Safari (iOS) or Chrome (Android). The `GSA/` marker is present
+  // on every platform, so checking it first lets us attribute GSA consistently
+  // — it must precede the Chrome and Safari branches that would match instead.
+  if (options?.detectGoogleSearchApp && includes(user_agent, 'GSA/')) {
+    return GOOGLE_SEARCH_APP
+  }
+
   if (includes(user_agent, ' OPR/') && includes(user_agent, 'Mini')) {
     return OPERA_MINI
   } else if (includes(user_agent, ' OPR/')) {
@@ -237,6 +261,7 @@ const versionRegexes: Record<string, RegExp[]> = {
   [DUCKDUCKGO]: [new RegExp('(DuckDuckGo|Ddg)\\/' + BROWSER_VERSION_REGEX_SUFFIX)],
   [PALE_MOON]: [new RegExp('PaleMoon\\/' + BROWSER_VERSION_REGEX_SUFFIX)],
   [WATERFOX]: [new RegExp(WATERFOX + '\\/' + BROWSER_VERSION_REGEX_SUFFIX)],
+  [GOOGLE_SEARCH_APP]: [new RegExp('GSA\\/' + BROWSER_VERSION_REGEX_SUFFIX)],
   [INTERNET_EXPLORER]: [new RegExp('(rv:|MSIE )' + BROWSER_VERSION_REGEX_SUFFIX)],
   Mozilla: [new RegExp('rv:' + BROWSER_VERSION_REGEX_SUFFIX)],
 }
@@ -252,9 +277,10 @@ const versionRegexes: Record<string, RegExp[]> = {
 export const detectBrowserVersion = function (
   userAgent: string,
   vendor: string | undefined,
-  hints?: BrowserDetectionHints
+  hints?: BrowserDetectionHints,
+  options?: BrowserDetectionOptions
 ): number | null {
-  const browser = detectBrowser(userAgent, vendor, hints)
+  const browser = detectBrowser(userAgent, vendor, hints, options)
 
   // Desktop / Android Brave has no parseable UA version, so it returns null
   // below: its `versionRegexes` entry only matches the iOS `Brave/` marker