web-manager 4.0.30 → 4.0.31

package/CHANGELOG.md

@@ -15,6 +15,14 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 - `Security` in case of vulnerabilities.
 
 ---
+## [4.0.31] - 2025-12-03
+### Added
+- Added HTML data attributes (`data-platform`, `data-runtime`, `data-device`) on initialization for CSS targeting.
+- Added `getPlatform()`, `getRuntime()`, `isMobile()`, and `getDeviceType()` as standalone exported utility functions.
+
+### Changed
+- Refactored `getContext()` to use the new standalone functions and include `deviceType` and `runtime` in client info.
+
 ## [4.0.29] - 2025-12-02
 ### Fixed
 - Fixed notification subscription storing to incorrect Firestore path (`users/{uid}/notifications/{token}` → `notifications/{token}`).

package/dist/index.js

@@ -75,6 +75,9 @@ class Manager {
       // Store configuration as-is
       this.config = this._processConfiguration(configuration);
 
+      // Set platform and runtime on HTML element
+      this._setHtmlDataAttributes();
+
       // Initialize Firebase if enabled
       if (this.config.firebase?.app?.enabled) {
         await this._initializeFirebase();
@@ -306,6 +309,24 @@ class Manager {
     }
   }
 
+  _setHtmlDataAttributes() {
+    // Skip if not in browser environment
+    if (typeof document === 'undefined') {
+      return;
+    }
+
+    const $html = document.documentElement;
+
+    // Set platform (OS) - windows, mac, linux, ios, android, chromeos, unknown
+    $html.dataset.platform = utilities.getPlatform();
+
+    // Set runtime - web, extension, electron, node
+    $html.dataset.runtime = utilities.getRuntime();
+
+    // Set device type - mobile, tablet, desktop
+    $html.dataset.device = utilities.getDeviceType();
+  }
+
   async _initializeFirebase() {
     const firebaseConfig = this.config.firebase.app.config;
 
@@ -427,14 +448,17 @@ class Manager {
   }
 
   _startVersionCheck() {
-    // Re-focus events
-    window.addEventListener('focus', () => {
-      this._checkVersion();
-    });
+    // Quit if window is not available
+    if (typeof window !== 'undefined') {
+      // Re-focus events
+      window.addEventListener('focus', () => {
+        this._checkVersion();
+      });
 
-    window.addEventListener('online', () => {
-      this._checkVersion();
-    });
+      window.addEventListener('online', () => {
+        this._checkVersion();
+      });
+    }
 
     // Set up interval
     this._versionCheckInterval = setInterval(() => {
@@ -443,6 +467,12 @@ class Manager {
   }
 
   _setupNotificationAutoRequest() {
+    // Quit if document is not available
+    if (typeof document === 'undefined') {
+      return;
+    }
+
+    // Set up click listener to request notification permissions
     const handleClick = () => {
       // Remove listener after first click
       document.removeEventListener('click', handleClick);
@@ -539,8 +569,15 @@ class Manager {
         return; // No update needed
       }
 
+      // New version detected
       console.log('[Version] New version detected, reloading page...');
 
+      // If running in a non-browser environment, warn and return
+      if (typeof window === 'undefined') {
+        console.warn('[Version] Cannot reload in non-browser environment');
+        return;
+      }
+
       // Force page reload
       window.onbeforeunload = function () {
         return undefined;

package/dist/modules/utilities.js

@@ -94,55 +94,105 @@ export function showNotification(message, options = {}) {
   }
 }
 
-// Get context information
-export function getContext() {
-  // Check if mobile
-  function isMobile() {
-    try {
-      // Try modern API first
-      const m = navigator.userAgentData?.mobile;
-      if (typeof m !== 'undefined') {
-        return m === true;
-      }
-    } catch (e) {
-      // Silent fail
-    }
+// Get platform (OS)
+export function getPlatform() {
+  const ua = navigator.userAgent.toLowerCase();
+  const platform = (navigator.userAgentData?.platform || navigator.platform || '').toLowerCase();
+
+  // Check userAgent for mobile platforms (more reliable than platform string)
+  if (/iphone|ipad|ipod/.test(ua)) {
+    return 'ios';
+  }
+  if (/android/.test(ua)) {
+    return 'android';
+  }
 
-    // Fallback to media query
-    try {
-      return window.matchMedia('(max-width: 767px)').matches;
-    } catch (e) {
-      return false;
-    }
+  // Check platform string for desktop OS
+  if (/win/.test(platform)) {
+    return 'windows';
+  }
+  if (/mac/.test(platform)) {
+    return 'mac';
+  }
+  if (/cros/.test(ua)) {
+    return 'chromeos';
+  }
+  if (/linux/.test(platform)) {
+    return 'linux';
+  }
+
+  return 'unknown';
+}
+
+// Get runtime environment
+export function getRuntime() {
+  // Browser extension
+  if (typeof chrome !== 'undefined' && chrome.runtime?.id) {
+    return 'extension';
+  }
+
+  // Electron
+  if (typeof process !== 'undefined' && process.versions?.electron) {
+    return 'electron';
+  }
+
+  // Node.js (no window)
+  if (typeof window === 'undefined') {
+    return 'node';
   }
 
-  // Get platform
-  function getPlatform() {
-    const platform = (navigator.userAgentData?.platform || navigator.platform || 'unknown').toLowerCase();
-
-    if (/iphone|ipad|ipod/.test(platform)) {
-      return 'ios';
-    } else if (/android/.test(platform)) {
-      return 'android';
-    } else if (/win/.test(platform)) {
-      return 'windows';
-    } else if (/mac/.test(platform)) {
-      return 'macos';
-    } else if (/linux/.test(platform)) {
-      return 'linux';
-    } else if (/cros/.test(platform)) {
-      return 'chromeos';
-    } else {
-      return 'unknown';
+  // Default: web browser
+  return 'web';
+}
+
+// Check if mobile device
+export function isMobile() {
+  try {
+    // Try modern API first
+    const m = navigator.userAgentData?.mobile;
+    if (typeof m !== 'undefined') {
+      return m === true;
     }
+  } catch (e) {
+    // Silent fail
+  }
+
+  // Fallback to media query
+  try {
+    return window.matchMedia('(max-width: 767px)').matches;
+  } catch (e) {
+    return false;
+  }
+}
+
+// Get device type based on screen width
+export function getDeviceType() {
+  const width = window.innerWidth;
+
+  // Mobile: < 768px (Bootstrap's md breakpoint)
+  if (width < 768) {
+    return 'mobile';
   }
 
+  // Tablet: 768px - 1199px (between md and xl)
+  if (width < 1200) {
+    return 'tablet';
+  }
+
+  // Desktop: >= 1200px
+  return 'desktop';
+}
+
+// Get context information
+export function getContext() {
   // Return context information
   return {
     client: {
       language: navigator.language,
       mobile: isMobile(),
+      deviceType: getDeviceType(),
       platform: getPlatform(),
+      runtime: getRuntime(),
       userAgent: navigator.userAgent,
       url: window.location.href,
     },
@@ -160,6 +210,6 @@ export function getContext() {
     // viewport: {
     //   width: window.innerWidth,
     //   height: window.innerHeight,
-    // }
+    // },
   };
 }

package/firebase-debug.log

@@ -322,3 +322,59 @@
 [debug] [2025-12-02T21:13:04.584Z] > authorizing via signed-in user (ian.wiedenman@gmail.com)
 [debug] [2025-12-02T21:13:04.585Z] > command requires scopes: ["email","openid","https://www.googleapis.com/auth/cloudplatformprojects.readonly","https://www.googleapis.com/auth/firebase","https://www.googleapis.com/auth/cloud-platform"]
 [debug] [2025-12-02T21:13:04.585Z] > authorizing via signed-in user (ian.wiedenman@gmail.com)
+[debug] [2025-12-04T02:16:36.479Z] > command requires scopes: ["email","openid","https://www.googleapis.com/auth/cloudplatformprojects.readonly","https://www.googleapis.com/auth/firebase","https://www.googleapis.com/auth/cloud-platform"]
+[debug] [2025-12-04T02:16:36.482Z] > authorizing via signed-in user (ian.wiedenman@gmail.com)
+[debug] [2025-12-04T02:16:36.482Z] > command requires scopes: ["email","openid","https://www.googleapis.com/auth/cloudplatformprojects.readonly","https://www.googleapis.com/auth/firebase","https://www.googleapis.com/auth/cloud-platform"]
+[debug] [2025-12-04T02:16:36.482Z] > authorizing via signed-in user (ian.wiedenman@gmail.com)
+[debug] [2025-12-04T02:16:36.546Z] > command requires scopes: ["email","openid","https://www.googleapis.com/auth/cloudplatformprojects.readonly","https://www.googleapis.com/auth/firebase","https://www.googleapis.com/auth/cloud-platform"]
+[debug] [2025-12-04T02:16:36.547Z] > authorizing via signed-in user (ian.wiedenman@gmail.com)
+[debug] [2025-12-04T02:16:36.547Z] > command requires scopes: ["email","openid","https://www.googleapis.com/auth/cloudplatformprojects.readonly","https://www.googleapis.com/auth/firebase","https://www.googleapis.com/auth/cloud-platform"]
+[debug] [2025-12-04T02:16:36.549Z] > authorizing via signed-in user (ian.wiedenman@gmail.com)
+[debug] [2025-12-04T02:16:36.550Z] > command requires scopes: ["email","openid","https://www.googleapis.com/auth/cloudplatformprojects.readonly","https://www.googleapis.com/auth/firebase","https://www.googleapis.com/auth/cloud-platform"]
+[debug] [2025-12-04T02:16:36.550Z] > authorizing via signed-in user (ian.wiedenman@gmail.com)
+[debug] [2025-12-04T02:16:36.583Z] > command requires scopes: ["email","openid","https://www.googleapis.com/auth/cloudplatformprojects.readonly","https://www.googleapis.com/auth/firebase","https://www.googleapis.com/auth/cloud-platform"]
+[debug] [2025-12-04T02:16:36.583Z] > authorizing via signed-in user (ian.wiedenman@gmail.com)
+[debug] [2025-12-04T02:16:36.610Z] > command requires scopes: ["email","openid","https://www.googleapis.com/auth/cloudplatformprojects.readonly","https://www.googleapis.com/auth/firebase","https://www.googleapis.com/auth/cloud-platform"]
+[debug] [2025-12-04T02:16:36.610Z] > authorizing via signed-in user (ian.wiedenman@gmail.com)
+[debug] [2025-12-04T02:16:36.611Z] > command requires scopes: ["email","openid","https://www.googleapis.com/auth/cloudplatformprojects.readonly","https://www.googleapis.com/auth/firebase","https://www.googleapis.com/auth/cloud-platform"]
+[debug] [2025-12-04T02:16:36.612Z] > authorizing via signed-in user (ian.wiedenman@gmail.com)
+[debug] [2025-12-04T02:16:36.615Z] > command requires scopes: ["email","openid","https://www.googleapis.com/auth/cloudplatformprojects.readonly","https://www.googleapis.com/auth/firebase","https://www.googleapis.com/auth/cloud-platform"]
+[debug] [2025-12-04T02:16:36.616Z] > authorizing via signed-in user (ian.wiedenman@gmail.com)
+[debug] [2025-12-04T02:16:36.616Z] > command requires scopes: ["email","openid","https://www.googleapis.com/auth/cloudplatformprojects.readonly","https://www.googleapis.com/auth/firebase","https://www.googleapis.com/auth/cloud-platform"]
+[debug] [2025-12-04T02:16:36.616Z] > authorizing via signed-in user (ian.wiedenman@gmail.com)
+[debug] [2025-12-04T02:16:36.620Z] > command requires scopes: ["email","openid","https://www.googleapis.com/auth/cloudplatformprojects.readonly","https://www.googleapis.com/auth/firebase","https://www.googleapis.com/auth/cloud-platform"]
+[debug] [2025-12-04T02:16:36.620Z] > authorizing via signed-in user (ian.wiedenman@gmail.com)
+[debug] [2025-12-04T02:16:36.621Z] > command requires scopes: ["email","openid","https://www.googleapis.com/auth/cloudplatformprojects.readonly","https://www.googleapis.com/auth/firebase","https://www.googleapis.com/auth/cloud-platform"]
+[debug] [2025-12-04T02:16:36.621Z] > authorizing via signed-in user (ian.wiedenman@gmail.com)
+[debug] [2025-12-04T02:16:36.624Z] > command requires scopes: ["email","openid","https://www.googleapis.com/auth/cloudplatformprojects.readonly","https://www.googleapis.com/auth/firebase","https://www.googleapis.com/auth/cloud-platform"]
+[debug] [2025-12-04T02:16:36.624Z] > authorizing via signed-in user (ian.wiedenman@gmail.com)
+[debug] [2025-12-04T02:16:36.624Z] > command requires scopes: ["email","openid","https://www.googleapis.com/auth/cloudplatformprojects.readonly","https://www.googleapis.com/auth/firebase","https://www.googleapis.com/auth/cloud-platform"]
+[debug] [2025-12-04T02:16:36.625Z] > authorizing via signed-in user (ian.wiedenman@gmail.com)
+[debug] [2025-12-04T02:16:38.036Z] > command requires scopes: ["email","openid","https://www.googleapis.com/auth/cloudplatformprojects.readonly","https://www.googleapis.com/auth/firebase","https://www.googleapis.com/auth/cloud-platform"]
+[debug] [2025-12-04T02:16:38.038Z] > authorizing via signed-in user (ian.wiedenman@gmail.com)
+[debug] [2025-12-04T02:16:38.038Z] > command requires scopes: ["email","openid","https://www.googleapis.com/auth/cloudplatformprojects.readonly","https://www.googleapis.com/auth/firebase","https://www.googleapis.com/auth/cloud-platform"]
+[debug] [2025-12-04T02:16:38.038Z] > authorizing via signed-in user (ian.wiedenman@gmail.com)
+[debug] [2025-12-04T02:16:38.049Z] > command requires scopes: ["email","openid","https://www.googleapis.com/auth/cloudplatformprojects.readonly","https://www.googleapis.com/auth/firebase","https://www.googleapis.com/auth/cloud-platform"]
+[debug] [2025-12-04T02:16:38.049Z] > authorizing via signed-in user (ian.wiedenman@gmail.com)
+[debug] [2025-12-04T02:16:38.070Z] > command requires scopes: ["email","openid","https://www.googleapis.com/auth/cloudplatformprojects.readonly","https://www.googleapis.com/auth/firebase","https://www.googleapis.com/auth/cloud-platform"]
+[debug] [2025-12-04T02:16:38.070Z] > authorizing via signed-in user (ian.wiedenman@gmail.com)
+[debug] [2025-12-04T02:16:38.071Z] > command requires scopes: ["email","openid","https://www.googleapis.com/auth/cloudplatformprojects.readonly","https://www.googleapis.com/auth/firebase","https://www.googleapis.com/auth/cloud-platform"]
+[debug] [2025-12-04T02:16:38.071Z] > authorizing via signed-in user (ian.wiedenman@gmail.com)
+[debug] [2025-12-04T02:16:38.075Z] > command requires scopes: ["email","openid","https://www.googleapis.com/auth/cloudplatformprojects.readonly","https://www.googleapis.com/auth/firebase","https://www.googleapis.com/auth/cloud-platform"]
+[debug] [2025-12-04T02:16:38.076Z] > authorizing via signed-in user (ian.wiedenman@gmail.com)
+[debug] [2025-12-04T02:16:38.076Z] > command requires scopes: ["email","openid","https://www.googleapis.com/auth/cloudplatformprojects.readonly","https://www.googleapis.com/auth/firebase","https://www.googleapis.com/auth/cloud-platform"]
+[debug] [2025-12-04T02:16:38.076Z] > authorizing via signed-in user (ian.wiedenman@gmail.com)
+[debug] [2025-12-04T02:16:38.272Z] > command requires scopes: ["email","openid","https://www.googleapis.com/auth/cloudplatformprojects.readonly","https://www.googleapis.com/auth/firebase","https://www.googleapis.com/auth/cloud-platform"]
+[debug] [2025-12-04T02:16:38.275Z] > authorizing via signed-in user (ian.wiedenman@gmail.com)
+[debug] [2025-12-04T02:16:38.275Z] > command requires scopes: ["email","openid","https://www.googleapis.com/auth/cloudplatformprojects.readonly","https://www.googleapis.com/auth/firebase","https://www.googleapis.com/auth/cloud-platform"]
+[debug] [2025-12-04T02:16:38.275Z] > authorizing via signed-in user (ian.wiedenman@gmail.com)
+[debug] [2025-12-04T02:16:38.284Z] > command requires scopes: ["email","openid","https://www.googleapis.com/auth/cloudplatformprojects.readonly","https://www.googleapis.com/auth/firebase","https://www.googleapis.com/auth/cloud-platform"]
+[debug] [2025-12-04T02:16:38.284Z] > authorizing via signed-in user (ian.wiedenman@gmail.com)
+[debug] [2025-12-04T02:16:38.302Z] > command requires scopes: ["email","openid","https://www.googleapis.com/auth/cloudplatformprojects.readonly","https://www.googleapis.com/auth/firebase","https://www.googleapis.com/auth/cloud-platform"]
+[debug] [2025-12-04T02:16:38.302Z] > authorizing via signed-in user (ian.wiedenman@gmail.com)
+[debug] [2025-12-04T02:16:38.303Z] > command requires scopes: ["email","openid","https://www.googleapis.com/auth/cloudplatformprojects.readonly","https://www.googleapis.com/auth/firebase","https://www.googleapis.com/auth/cloud-platform"]
+[debug] [2025-12-04T02:16:38.303Z] > authorizing via signed-in user (ian.wiedenman@gmail.com)
+[debug] [2025-12-04T02:16:38.304Z] > command requires scopes: ["email","openid","https://www.googleapis.com/auth/cloudplatformprojects.readonly","https://www.googleapis.com/auth/firebase","https://www.googleapis.com/auth/cloud-platform"]
+[debug] [2025-12-04T02:16:38.304Z] > authorizing via signed-in user (ian.wiedenman@gmail.com)
+[debug] [2025-12-04T02:16:38.306Z] > command requires scopes: ["email","openid","https://www.googleapis.com/auth/cloudplatformprojects.readonly","https://www.googleapis.com/auth/firebase","https://www.googleapis.com/auth/cloud-platform"]
+[debug] [2025-12-04T02:16:38.306Z] > authorizing via signed-in user (ian.wiedenman@gmail.com)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "web-manager",
-  "version": "4.0.30",
+  "version": "4.0.31",
   "description": "Easily access important variables such as the query string, current domain, and current page in a single object.",
   "main": "dist/index.js",
   "module": "src/index.js",