@posthog/core - npm Package Compare versions

Comparing version 1.30.14 to 1.31.0

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

@@ -11,2 +11,11 @@ /**
 /**
+ * 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.
@@ -20,4 +29,6 @@ * The order of the checks are important since many user agents
  * 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;
 /**
@@ -31,3 +42,3 @@ * This function detects which browser version is running this script,
  */
-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];
@@ -34,0 +45,0 @@ export declare const detectDevice: (user_agent: string) => string;

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

@@ -1,1 +0,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"}

dist/utils/user-agent-utils.js

@@ -81,2 +81,3 @@ "use strict";
 const BRAVE = 'Brave';
+const GOOGLE_SEARCH_APP = 'Google Search App';
 const BROWSER_VERSION_REGEX_SUFFIX = '(\\d+(\\.\\d+)?)';
@@ -109,6 +110,7 @@ const DEFAULT_BROWSER_VERSION_REGEX = new RegExp('Version/' + BROWSER_VERSION_REGEX_SUFFIX);
 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;
@@ -210,2 +212,5 @@ if ((0, external_string_utils_js_namespaceObject.includes)(user_agent, ' OPR/')) return OPERA;
     ],
+    [GOOGLE_SEARCH_APP]: [
+        new RegExp('GSA\\/' + BROWSER_VERSION_REGEX_SUFFIX)
+    ],
     [INTERNET_EXPLORER]: [
@@ -218,4 +223,4 @@ new RegExp('(rv:|MSIE )' + 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];
@@ -222,0 +227,0 @@ if ((0, external_type_utils_js_namespaceObject.isUndefined)(regexes)) return null;

dist/utils/user-agent-utils.mjs

@@ -49,2 +49,3 @@ import { includes } from "./string-utils.mjs";
 const BRAVE = 'Brave';
+const GOOGLE_SEARCH_APP = 'Google Search App';
 const BROWSER_VERSION_REGEX_SUFFIX = '(\\d+(\\.\\d+)?)';
@@ -77,6 +78,7 @@ const DEFAULT_BROWSER_VERSION_REGEX = new RegExp('Version/' + BROWSER_VERSION_REGEX_SUFFIX);
 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;
@@ -178,2 +180,5 @@ if (includes(user_agent, ' OPR/')) return OPERA;
     ],
+    [GOOGLE_SEARCH_APP]: [
+        new RegExp('GSA\\/' + BROWSER_VERSION_REGEX_SUFFIX)
+    ],
     [INTERNET_EXPLORER]: [
@@ -186,4 +191,4 @@ new RegExp('(rv:|MSIE )' + 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];
@@ -190,0 +195,0 @@ if (isUndefined(regexes)) return null;

package.json

 {
   "name": "@posthog/core",
-  "version": "1.30.14",
+  "version": "1.31.0",
   "license": "MIT",
@@ -70,3 +70,3 @@ "main": "dist/index.js",
   "dependencies": {
-    "@posthog/types": "1.383.3"
+    "@posthog/types": "1.384.0"
   },
@@ -73,0 +73,0 @@ "devDependencies": {

src/utils/user-agent-utils.ts

@@ -60,2 +60,3 @@ import { includes } from './string-utils'
 const BRAVE = 'Brave'
+const GOOGLE_SEARCH_APP = 'Google Search App'
 
@@ -84,2 +85,14 @@ const BROWSER_VERSION_REGEX_SUFFIX = '(\\d+(\\.\\d+)?)'
 
+/**
+ * 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')
@@ -124,2 +137,4 @@ const PLAYSTATION_REGEX = new RegExp(PLAYSTATION + ' \\w+', 'i')
  * behaviour.
+ *
+ * `options` toggles opt-in UA-detection tweaks (see `BrowserDetectionOptions`).
  */
@@ -129,3 +144,4 @@ export const detectBrowser = function (
   vendor: string | undefined,
-  hints?: BrowserDetectionHints
+  hints?: BrowserDetectionHints,
+  options?: BrowserDetectionOptions
 ): string {
@@ -142,2 +158,10 @@ vendor = vendor || '' // vendor is undefined for at least IE9
 
+  // 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')) {
@@ -245,2 +269,3 @@ return OPERA_MINI
   [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)],
@@ -261,5 +286,6 @@ Mozilla: [new RegExp('rv:' + BROWSER_VERSION_REGEX_SUFFIX)],
   vendor: string | undefined,
-  hints?: BrowserDetectionHints
+  hints?: BrowserDetectionHints,
+  options?: BrowserDetectionOptions
 ): number | null {
-  const browser = detectBrowser(userAgent, vendor, hints)
+  const browser = detectBrowser(userAgent, vendor, hints, options)
 
@@ -266,0 +292,0 @@ // Desktop / Android Brave has no parseable UA version, so it returns null

New alerts

URL strings

Supply chain risk

Package contains fragments of external URLs or IP addresses, which the package may be accessing at runtime.

Found 1 instance in 1 package

Fixed alerts

URL strings

Supply chain risk

Package contains fragments of external URLs or IP addresses, which the package may be accessing at runtime.

Found 1 instance in 1 package

Improved metrics

Total package byte prevSize

1061925

0.24%

Lines of code

24926

0.18%

Dependency changes

• + Added

  @posthog/types@1.384.0
  (transitive)

• - Removed

  @posthog/types@1.383.3
  (transitive)

• Updated

  @posthog/types@1.384.0