solo-analytics 0.2.0 → 0.3.2

package/README.md

@@ -1,418 +1,320 @@
-# 📊 Solo Analytics
+# Solo Analytics
 
-A lightweight TypeScript library for comprehensive browser and device information collection with a clean API surface.
+**Read browser context once. Use it anywhere.**
 
-[![npm version](https://img.shields.io/npm/v/solo-analytics.svg?style=flat-square)](https://www.npmjs.com/package/solo-analytics)
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue?style=flat-square)](https://www.typescriptlang.org/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg?style=flat-square)](https://github.com/cesswhite/solo-analytics/blob/main/LICENSE)
-[![Bundle Size](https://img.shields.io/bundlephobia/minzip/solo-analytics?style=flat-square)](https://bundlephobia.com/package/solo-analytics)
-
-## Features
-
-- 🔍 Extensive browser, OS, and device detection with full TypeScript support
-- 📱 Precise mobile, tablet, and desktop device classification
-- 🌐 Network connectivity and performance data
-- 📏 Screen and viewport dimensions with orientation detection
-- ⚡ Comprehensive performance metrics (navigation, timing, memory)
-- 🌍 Locale, timezone, and environment information
-- ⚙️ Advanced feature detection (camera, microphone, battery, etc.)
-- 🔒 Incognito/private mode detection
-- 🔄 Auto-refresh capability for dynamic metrics
-
-## Installation
+Solo Analytics collects device, network, and environment data from the browser and returns it as a typed object. No backend, no vendor, no tracking — you decide what to do with the data.
 
 ```bash
 npm install solo-analytics
 ```
 
-## Basic Usage
+---
+
+## Quick start
 
 ```typescript
 import { useSoloAnalytics } from "solo-analytics";
 
-// Initialize with default options
 const analytics = useSoloAnalytics();
 
-// Access common properties
-console.log("Mobile device:", analytics.isMobile);
-console.log("Browser:", analytics.browserName);
-console.log("OS:", analytics.osName);
+// Shortcuts for common checks
+console.log(analytics.isMobile); // true | false
+console.log(analytics.browserName); // "Chrome", "Safari", "Firefox"…
+console.log(analytics.osName); // "macOS", "Windows", "Android"…
+
+// Full payload
+console.log(analytics.data);
 
-// Access the complete data object
-console.log("Full analytics data:", analytics.data);
+// Clean up when you're done (SPAs, component unmount)
+analytics.destroy();
 ```
 
-## Configuration Options
+That is the entire API surface for most use cases. Everything below explains what you get, how to configure it, and how to integrate it in your stack.
 
-```typescript
-import { useSoloAnalytics } from "solo-analytics";
+---
 
-const analytics = useSoloAnalytics({
-  // Automatically refresh dynamic data (network, performance)
-  autoRefresh: true,
-  // Refresh interval in milliseconds (default: 30000)
-  refreshInterval: 10000,
-  // Track page visibility changes
-  trackVisibility: true,
-  // Skip expensive async probes (incognito, battery, media, permissions)
-  detectFeatures: true,
-  // Defer async probes to idle time (default: true, recommended)
-  lazyFeatures: true,
-});
+## What problem does this solve?
+
+Most analytics SDKs are built to **send events to a vendor**. Solo Analytics does something different: it **reads context from the browser** and hands it back to you.
+
+Typical uses:
+
+| Goal                      | Example                                                                                                 |
+| ------------------------- | ------------------------------------------------------------------------------------------------------- |
+| Enrich your own analytics | Attach `{ browser, device, network }` to every event you already send to PostHog, Mixpanel, or your API |
+| Adapt the UI              | Show a lite mode on slow connections (`effectiveType === "2g"`) or adjust layout for mobile             |
+| Debug client environments | One object instead of scattered `navigator` / `window` checks                                           |
+
+**What it is not:** a tracking product. It does not phone home, set cookies, or manage sessions.
+
+---
+
+## How it works
+
+When you call `useSoloAnalytics()`, the library collects data in two phases:
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  Phase 1 — Immediate (sync)                                 │
+│  User agent, screen, locale, network snapshot, performance  │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│  Phase 2 — Deferred (async, on idle time by default)        │
+│  Incognito hint, battery, camera/mic, permission states     │
+└─────────────────────────────────────────────────────────────┘
 ```
 
-## API Reference
+- **Sync data** is available right after initialization.
+- **Async probes** run when the browser is idle (`requestIdleCallback`) so they do not block rendering. Call `refresh()` if you need them immediately.
 
-The `useSoloAnalytics()` function returns an object with the following methods and properties:
+Despite the `use` prefix (Vue convention), the function is **framework-agnostic**. Same API in React, Nuxt, Svelte, or plain JavaScript.
 
-### Methods
+---
 
-- `refresh()`: Manually triggers a refresh of all analytics data
-- `destroy()`: Cleans up all event listeners and timers to prevent memory leaks
+## The data object
 
-### Convenience Properties
+`analytics.data` is a `SoloAnalyticsInfo` object. Here is what each section contains and when you might use it.
 
-- `isMobile`: Whether the device is a mobile phone
-- `isTablet`: Whether the device is a tablet
-- `isDesktop`: Whether the device is a desktop computer
-- `isOnline`: Current network connection state
-- `isVisible`: Whether the page is currently visible
-- `browserName`: The name of the browser
-- `osName`: The name of the operating system
+### Browser, OS, and device
 
-### Complete Data
+Parsed from `navigator.userAgent`:
 
-- `data`: An object containing all detailed analytics information
+```typescript
+analytics.data.browser; // name, version, engine, vendor…
+analytics.data.os; // name, version, architecture
+analytics.data.device; // type, isMobile, isTablet, isDesktop, touch…
+```
+
+Shortcuts on the return value:
 
-## Data Structure
+```typescript
+analytics.isMobile; // analytics.data.device.isMobile
+analytics.isTablet;
+analytics.isDesktop;
+analytics.browserName; // analytics.data.browser.name
+analytics.osName; // analytics.data.os.name
+```
 
-The `data` object contains the following structure:
+### Screen
 
 ```typescript
-interface SoloAnalyticsInfo {
-  browser: {
-    name: string;
-    version: string;
-    major: string;
-    userAgent: string;
-    vendor: string;
-    engine: string;
-    engineVersion: string;
-  };
-  os: {
-    name: string;
-    version: string;
-    architecture: string;
-  };
-  device: {
-    type: "mobile" | "tablet" | "desktop" | "unknown";
-    vendor: string;
-    model: string;
-    orientation: "portrait" | "landscape";
-    isMobile: boolean;
-    isTablet: boolean;
-    isDesktop: boolean;
-    touch: boolean;
-  };
-  network: {
-    online: boolean;
-    effectiveType: string;
-    downlink: number;
-    rtt: number;
-    saveData: boolean;
-  };
-  screen: {
-    width: number;
-    height: number;
-    availWidth: number;
-    availHeight: number;
-    colorDepth: number;
-    orientation: string;
-    pixelRatio: number;
-    touchPoints: number;
-  };
-  performance: {
-    memory: {
-      jsHeapSizeLimit: number;
-      totalJSHeapSize: number;
-      usedJSHeapSize: number;
-    } | null;
-    navigation: {
-      type: string;
-      redirectCount: number;
-    };
-    timing: {
-      loadTime: number;
-      domContentLoaded: number;
-      firstPaint: number | null;
-      firstContentfulPaint: number | null;
-    };
-  };
-  location: {
-    timeZone: string;
-    language: string;
-    languages: string[];
-    isRestricted: boolean;
-    doNotTrack: boolean | null;
-    cookiesEnabled: boolean;
-    localStorage: boolean;
-    sessionStorage: boolean;
-  };
-  pageVisibility: "visible" | "hidden";
-  referrer: string;
-  isIncognito: boolean;
-  hasCamera: boolean | null;
-  hasMicrophone: boolean | null;
-  hasBattery: boolean | null;
-  batteryLevel: number | null;
-  batteryCharging: boolean | null;
-  permissions: Record<string, string>;
-}
+analytics.data.screen;
+// width, height, availWidth, availHeight
+// pixelRatio, colorDepth, orientation, touchPoints
 ```
 
-## Framework Integration Examples
+Useful for responsive decisions, screenshot tooling, or debugging layout issues reported by users.
 
-### React
+### Network
 
-```tsx
-import { useEffect, useState } from "react";
-import { useSoloAnalytics, SoloAnalyticsReturn } from "solo-analytics";
+```typescript
+analytics.data.network;
+// online, effectiveType ("4g", "3g", "slow-2g"…)
+// downlink (Mbps), rtt (ms), saveData
+```
 
-function DeviceInfo() {
-  const [analytics, setAnalytics] = useState<SoloAnalyticsReturn | null>(null);
+Also exposed as `analytics.isOnline`. Enable `autoRefresh: true` if you need live updates when connection quality changes.
 
-  useEffect(() => {
-    // Initialize on the client side
-    const analyticsInstance = useSoloAnalytics();
-    setAnalytics(analyticsInstance);
-
-    // Cleanup on unmount
-    return () => {
-      analyticsInstance.destroy();
-    };
-  }, []);
+### Performance
 
-  if (!analytics) return <div>Loading...</div>;
-
-  return (
-    <div>
-      <h1>Device Information</h1>
-      <p>
-        Type:{" "}
-        {analytics.isMobile
-          ? "Mobile"
-          : analytics.isTablet
-          ? "Tablet"
-          : "Desktop"}
-      </p>
-      <p>Browser: {analytics.browserName}</p>
-      <p>Operating System: {analytics.osName}</p>
-      <p>Network Status: {analytics.isOnline ? "Online" : "Offline"}</p>
-    </div>
-  );
-}
+```typescript
+analytics.data.performance;
+// navigation type, load timing, first paint / FCP
+// memory (Chrome only — null elsewhere)
 ```
 
-### Vue 3
+### Environment and privacy signals
 
-```vue
-<template>
-  <div>
-    <h1>Device Information</h1>
-    <p>Type: {{ deviceType }}</p>
-    <p>Browser: {{ analytics.browserName }}</p>
-    <p>Operating System: {{ analytics.osName }}</p>
-    <p>Network Status: {{ analytics.isOnline ? "Online" : "Offline" }}</p>
-  </div>
-</template>
+```typescript
+analytics.data.location;
+// timeZone, language, languages
+// cookiesEnabled, localStorage, sessionStorage
+// doNotTrack, isRestricted (iframe detection)
+```
 
-<script setup lang="ts">
-import { onMounted, onUnmounted, ref, computed } from "vue";
-import { useSoloAnalytics, SoloAnalyticsReturn } from "solo-analytics";
+### Optional async fields
 
-const analytics = ref<SoloAnalyticsReturn | null>(null);
+Populated after idle-time probes (or immediately after `await analytics.refresh()`):
 
-onMounted(() => {
-  analytics.value = useSoloAnalytics({
-    trackVisibility: true,
-  });
-});
+```typescript
+analytics.data.isIncognito; // best-effort hint — see Limitations
+analytics.data.hasCamera; // boolean | null
+analytics.data.hasMicrophone; // boolean | null
+analytics.data.hasBattery;
+analytics.data.batteryLevel;
+analytics.data.batteryCharging;
+analytics.data.permissions; // Record<string, string>
+```
 
-onUnmounted(() => {
-  analytics.value?.destroy();
+Set `detectFeatures: false` to skip async probes entirely.
+
+---
+
+## Configuration
+
+All options are optional. Defaults are sensible for most apps.
+
+```typescript
+const analytics = useSoloAnalytics({
+  autoRefresh: false, // poll network + performance on an interval
+  refreshInterval: 30000, // ms between polls (only when autoRefresh: true)
+  trackVisibility: true, // update pageVisibility on visibilitychange
+  detectFeatures: true, // run async probes (incognito, battery, media…)
+  lazyFeatures: true, // defer async probes to idle time
 });
+```
+
+| Option            | Default | When to change it                                                                      |
+| ----------------- | ------- | -------------------------------------------------------------------------------------- |
+| `autoRefresh`     | `false` | Set `true` if network or performance data must stay current (e.g. connection-aware UI) |
+| `refreshInterval` | `30000` | Lower for faster updates; higher to reduce work                                        |
+| `trackVisibility` | `true`  | Set `false` if you never read `pageVisibility` or `isVisible`                          |
+| `detectFeatures`  | `true`  | Set `false` for minimal bundle work — UA, screen, and network only                     |
+| `lazyFeatures`    | `true`  | Set `false` if you need camera/battery/incognito data on first paint                   |
+
+### Minimal setup (fastest)
 
-const deviceType = computed(() => {
-  if (!analytics.value) return "Unknown";
+Only sync data — no idle callbacks, no async probes:
 
-  if (analytics.value.isMobile) return "Mobile";
-  if (analytics.value.isTablet) return "Tablet";
-  return "Desktop";
+```typescript
+const analytics = useSoloAnalytics({
+  detectFeatures: false,
+  trackVisibility: false,
 });
-</script>
 ```
 
-### Nuxt 3
+---
 
-```vue
-<template>
-  <div>
-    <h1>Device Information</h1>
-    <div v-if="analytics">
-      <p>Type: {{ deviceType }}</p>
-      <p>Browser: {{ analytics.browserName }}</p>
-      <p>Operating System: {{ analytics.osName }}</p>
-      <p>Network Status: {{ analytics.isOnline ? "Online" : "Offline" }}</p>
-    </div>
-    <div v-else>
-      <p>Loading device information...</p>
-    </div>
-  </div>
-</template>
+## Framework integration
+
+Initialize **on the client only**. The library guards missing `window` / `navigator`; on the server, `data` stays at its initial empty state.
 
+### Vue / Nuxt
+
+```vue
 <script setup lang="ts">
-import { ref, computed } from "vue";
-import { useSoloAnalytics, SoloAnalyticsReturn } from "solo-analytics";
+import { onMounted, onUnmounted, ref } from "vue";
+import { useSoloAnalytics } from "solo-analytics";
 
-const analytics = ref<SoloAnalyticsReturn | null>(null);
+const isMobile = ref(false);
+let analytics: ReturnType<typeof useSoloAnalytics> | null = null;
 
-// Important: Only initialize on client-side to avoid SSR issues
 onMounted(() => {
-  analytics.value = useSoloAnalytics({
-    trackVisibility: true,
-    autoRefresh: true,
-    refreshInterval: 15000,
-  });
+  analytics = useSoloAnalytics();
+  isMobile.value = analytics.isMobile;
 });
 
-onBeforeUnmount(() => {
-  if (analytics.value) {
-    analytics.value.destroy();
-  }
-});
-
-const deviceType = computed(() => {
-  if (!analytics.value) return "Unknown";
-
-  if (analytics.value.isMobile) return "Mobile";
-  if (analytics.value.isTablet) return "Tablet";
-  return "Desktop";
+onUnmounted(() => {
+  analytics?.destroy();
 });
 </script>
 ```
 
-### Vanilla JavaScript
-
-```html
-<script type="module">
-  import { useSoloAnalytics } from "solo-analytics";
+In Nuxt, keep initialization inside `onMounted` — not in `<script setup>` top level during SSR.
 
-  document.addEventListener("DOMContentLoaded", () => {
-    const analytics = useSoloAnalytics();
+### React
 
-    // Display information on the page
-    document.getElementById("deviceType").textContent = analytics.isMobile
-      ? "Mobile"
-      : analytics.isTablet
-      ? "Tablet"
-      : "Desktop";
-
-    document.getElementById(
-      "browserInfo"
-    ).textContent = `${analytics.browserName} on ${analytics.osName}`;
-
-    // Cleanup on window close
-    window.addEventListener("beforeunload", () => {
-      analytics.destroy();
-    });
-  });
-</script>
-```
+```tsx
+import { useEffect, useState } from "react";
+import { useSoloAnalytics } from "solo-analytics";
 
-## Browser Compatibility
+function App() {
+  const [isMobile, setIsMobile] = useState(false);
 
-Solo Analytics is compatible with all modern browsers, including:
+  useEffect(() => {
+    const analytics = useSoloAnalytics();
+    setIsMobile(analytics.isMobile);
+    return () => analytics.destroy();
+  }, []);
 
-- Chrome 60+
-- Firefox 55+
-- Safari 11+
-- Edge 16+
-- Opera 47+
-- iOS Safari 11+
-- Android Browser 67+
+  return <div>{isMobile ? "Mobile" : "Desktop"}</div>;
+}
+```
 
-Some advanced features may not be available in older browsers but the library includes graceful fallbacks.
+### Vanilla JS
 
-## Development
+See the [demo playground](src/demo/main.ts): call `useSoloAnalytics()`, read `analytics.data`, call `analytics.refresh()` on demand, and `analytics.destroy()` on `beforeunload`.
 
-```bash
-# Install dependencies
-npm install
+---
 
-# Run development server (demo playground)
-npm run dev
+## API reference
 
-# Type-check and build for production
-npm run build
+| Member        | Type                | Description                              |
+| ------------- | ------------------- | ---------------------------------------- |
+| `data`        | `SoloAnalyticsInfo` | Full context object (updates in place)   |
+| `refresh()`   | `Promise<void>`     | Re-collect sync, dynamic, and async data |
+| `destroy()`   | `void`              | Clear timers and event listeners         |
+| `isMobile`    | `boolean`           | Device class shortcut                    |
+| `isTablet`    | `boolean`           | Device class shortcut                    |
+| `isDesktop`   | `boolean`           | Device class shortcut                    |
+| `isOnline`    | `boolean`           | `navigator.onLine`                       |
+| `isVisible`   | `boolean`           | Page is currently visible                |
+| `browserName` | `string`            | Parsed browser name                      |
+| `osName`      | `string`            | Parsed OS name                           |
 
-# Run tests
-npm test
+### Exported types
 
-# Watch tests during development
-npm run test:watch
+```typescript
+import type {
+  SoloAnalyticsInfo,
+  SoloAnalyticsOptions,
+  SoloAnalyticsReturn,
+  BrowserInfo,
+  DeviceInfo,
+  NetworkInfo,
+  ScreenInfo,
+  PerformanceInfo,
+  LocationInfo,
+  OSInfo,
+} from "solo-analytics";
 ```
 
-## Performance
+### Reactivity note
 
-Solo Analytics is designed to stay off the critical path:
+`data` is a **mutable object** updated in place. There is no subscription API — after async probes finish, call `refresh()` or read getters again. In Vue/React, copy values into reactive state if you need re-renders.
 
-| Metric | Value |
-|--------|-------|
-| ESM bundle (gzip) | ~3.5 KB |
-| UMD bundle (gzip) | ~3.1 KB |
-| `sideEffects` | `false` (tree-shakeable) |
+---
 
-**Recommendations:**
+## Limitations (read before relying on edge cases)
 
-- Use `lazyFeatures: true` (default) so async probes run during idle time
-- Set `detectFeatures: false` if you only need UA, screen, and network data
-- Call `destroy()` when unmounting in SPAs to clear timers and listeners
-- Initialize client-side only (`onMounted` in Vue/Nuxt, `useEffect` in React)
+| Topic                   | What to expect                                                                                                         |
+| ----------------------- | ---------------------------------------------------------------------------------------------------------------------- |
+| **User-agent parsing**  | Regex-based, not a full UA database. Edge cases exist (iPad desktop mode, new browsers, reduced UA strings).           |
+| **Client Hints**        | `navigator.userAgentData` is not used yet.                                                                             |
+| **Performance memory**  | `performance.memory` is Chrome-only; other browsers return `null`.                                                     |
+| **Incognito detection** | Best-effort via IndexedDB — unreliable across browsers. Treat as a hint, not proof.                                    |
+| **Camera / microphone** | `enumerateDevices` may return empty until the user grants permission. `false` does not always mean hardware is absent. |
+| **SSR**                 | Server-side calls produce empty defaults. Always init on the client.                                                   |
 
-## Contributing
+---
 
-Contributions are welcome! Please feel free to submit a Pull Request.
+## Bundle size
 
-1. Fork the repository
-2. Create your feature branch (`git checkout -b feature/amazing-feature`)
-3. Commit your changes (`git commit -m 'Add some amazing feature'`)
-4. Push to the branch (`git push origin feature/amazing-feature`)
-5. Open a Pull Request
+Roughly **3–4 KB gzipped**. `sideEffects: false` in `package.json` — bundlers can tree-shake unused exports.
 
-## Repository
+---
 
-GitHub: [https://github.com/cesswhite/solo-analytics](https://github.com/cesswhite/solo-analytics)
+## Development
 
-## License
+This project uses [Vite+](https://viteplus.dev/) (`vp` CLI: Vite, Vitest, Oxlint, Oxfmt, tsdown).
 
-MIT License
+```bash
+npm install
+vp dev                # local demo playground
+vp pack               # build library (ESM + CJS + types)
+vp test               # unit tests
+vp test run --coverage
+vp check              # format, lint, type-check
+vp check --fix        # auto-fix format/lint
+```
 
-Copyright (c) 2025 Céss White
+---
 
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+## Contributing
 
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+Issues and pull requests welcome on [GitHub](https://github.com/cesswhite/solo-analytics).
+
+## License
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+[MIT](LICENSE) — Copyright (c) 2025 Céss White

package/dist/index.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});async function e(){return new Promise(e=>{if(typeof window>`u`||typeof indexedDB>`u`){e(!1);return}let t=!1,n=n=>{t||(t=!0,clearTimeout(r),e(n))},r=setTimeout(()=>n(!1),1e3),i=indexedDB.open(`test`);i.onerror=()=>n(!0),i.onsuccess=()=>{i.result?.close(),n(!1)}})}async function t(){if(typeof navigator>`u`||!navigator.mediaDevices||!navigator.mediaDevices.enumerateDevices)return{hasCamera:null,hasMicrophone:null};try{let e=await navigator.mediaDevices.enumerateDevices();return{hasCamera:e.some(e=>e.kind===`videoinput`),hasMicrophone:e.some(e=>e.kind===`audioinput`)}}catch{return{hasCamera:null,hasMicrophone:null}}}async function n(){if(typeof navigator>`u`||!navigator.getBattery)return{hasBattery:null,level:null,charging:null};try{let e=await navigator.getBattery();return{hasBattery:!0,level:e.level,charging:e.charging}}catch{return{hasBattery:null,level:null,charging:null}}}async function r(){if(typeof navigator>`u`||!navigator.permissions||!navigator.permissions.query)return{};let e={},t=await Promise.all([`geolocation`,`notifications`,`push`,`midi`,`camera`,`microphone`,`background-sync`,`accelerometer`,`gyroscope`,`magnetometer`].map(async e=>{try{return[e,(await navigator.permissions.query({name:e})).state]}catch{return[e,`not-supported`]}}));for(let[n,r]of t)e[n]=r;return e}function i(){if(typeof window>`u`||typeof navigator>`u`)return{timeZone:``,language:``,languages:[],isRestricted:!1,doNotTrack:null,cookiesEnabled:!1,localStorage:!1,sessionStorage:!1};let e=Intl.DateTimeFormat().resolvedOptions().timeZone,t=navigator.language||``,n=navigator.languages?Array.from(navigator.languages):[t],r=!1;try{r=window.self!==window.top}catch{r=!0}let i=null;navigator.doNotTrack===`1`||navigator.doNotTrack===`yes`?i=!0:(navigator.doNotTrack===`0`||navigator.doNotTrack===`no`)&&(i=!1);let a=navigator.cookieEnabled,o=e=>{try{let t=window[e],n=`__test_${e}__`;return t.setItem(n,`test`),t.removeItem(n),!0}catch{return!1}};return{timeZone:e,language:t,languages:n,isRestricted:r,doNotTrack:i,cookiesEnabled:a,localStorage:o(`localStorage`),sessionStorage:o(`sessionStorage`)}}function a(){let e=typeof navigator<`u`?navigator.onLine:!1,t=`unknown`,n=0,r=0,i=!1;if(navigator?.connection){let e=navigator.connection;t=e.effectiveType||t,n=e.downlink||n,r=e.rtt||r,i=e.saveData||i}return{online:e,effectiveType:t,downlink:n,rtt:r,saveData:i}}function o(){return typeof window>`u`?{memory:null,navigation:{type:`Unknown`,redirectCount:0},timing:{loadTime:0,domContentLoaded:0,firstPaint:null,firstContentfulPaint:null}}:{memory:(()=>{if(window.performance?.memory){let e=window.performance.memory;return{jsHeapSizeLimit:e.jsHeapSizeLimit,totalJSHeapSize:e.totalJSHeapSize,usedJSHeapSize:e.usedJSHeapSize}}return null})(),navigation:window.performance?.navigation?{type:[`navigate`,`reload`,`back_forward`,`prerender`][window.performance.navigation.type]||`Unknown`,redirectCount:window.performance.navigation.redirectCount}:{type:`Unknown`,redirectCount:0},timing:(()=>{if(!window.performance?.timing)return{loadTime:0,domContentLoaded:0,firstPaint:null,firstContentfulPaint:null};let e=window.performance.timing,t=e.loadEventEnd-e.navigationStart,n=e.domContentLoadedEventEnd-e.navigationStart,r=null,i=null;if(window.performance&&typeof window.performance.getEntriesByType==`function`){let e=window.performance.getEntriesByType(`paint`),t=e.find(e=>e.name===`first-paint`),n=e.find(e=>e.name===`first-contentful-paint`);t&&(r=t.startTime),n&&(i=n.startTime)}return{loadTime:t,domContentLoaded:n,firstPaint:r,firstContentfulPaint:i}})()}}function s(e,t=2e3){if(typeof window>`u`){Promise.resolve().then(e);return}let n=()=>{Promise.resolve(e())};if(`requestIdleCallback`in window){window.requestIdleCallback(()=>n(),{timeout:t});return}setTimeout(n,0)}function c(){if(typeof window>`u`||typeof screen>`u`)return{width:0,height:0,availWidth:0,availHeight:0,colorDepth:0,orientation:`unknown`,pixelRatio:1,touchPoints:0};let e=`unknown`;e=window.innerHeight>window.innerWidth?`portrait`:`landscape`,screen.orientation?.type&&(e=screen.orientation.type);let t=window.devicePixelRatio||1,n=navigator.maxTouchPoints||0;return{width:screen.width,height:screen.height,availWidth:screen.availWidth,availHeight:screen.availHeight,colorDepth:screen.colorDepth,orientation:e,pixelRatio:t,touchPoints:n}}function l(e,t={}){let n=t.vendor??(typeof navigator<`u`?navigator.vendor:``),r=t.innerWidth??(typeof window<`u`?window.innerWidth:1024),i=t.innerHeight??(typeof window<`u`?window.innerHeight:768),a=t.maxTouchPoints??(typeof navigator<`u`&&`maxTouchPoints`in navigator?navigator.maxTouchPoints:0);return{browser:(()=>{for(let t of[{name:`Edge`,regex:/Edg(?:e|A|iOS)?\/([0-9.]+)/},{name:`Samsung Browser`,regex:/SamsungBrowser\/([0-9.]+)/},{name:`Opera`,regex:/(?:Opera|OPR)\/([0-9.]+)/},{name:`Firefox`,regex:/Firefox\/([0-9.]+)/},{name:`Chrome`,regex:/Chrome\/([0-9.]+)/},{name:`Safari`,regex:/Version\/([0-9.]+).*Safari/},{name:`IE`,regex:/MSIE|Trident/}]){let r=e.match(t.regex);if(r){let i=r[1]||``,a=i.split(`.`)[0]||``,o=`Unknown`,s=``;if(e.includes(`AppleWebKit`)){let t=e.match(/AppleWebKit\/([0-9.]+)/);o=`WebKit`,s=t?t[1]:``}else if(e.includes(`Gecko`)){o=`Gecko`;let t=e.match(/rv:([0-9.]+)/);s=t?t[1]:``}else if(e.includes(`Trident`)){o=`Trident`;let t=e.match(/Trident\/([0-9.]+)/);s=t?t[1]:``}return{name:t.name,version:i,major:a,userAgent:e,vendor:n,engine:o,engineVersion:s}}}return{name:`Unknown`,version:``,major:``,userAgent:e,vendor:n,engine:`Unknown`,engineVersion:``}})(),os:(()=>{for(let t of[{name:`iOS`,regex:/iPhone|iPad|iPod/},{name:`Android`,regex:/Android ([0-9.]+)/},{name:`Windows`,regex:/Windows NT ([0-9.]+)/},{name:`macOS`,regex:/Mac OS X ([0-9_.]+)/},{name:`Linux`,regex:/Linux/}]){let n=e.match(t.regex);if(n){let r=``;return n[1]&&(r=t.name===`macOS`?n[1].replace(/_/g,`.`):n[1]),{name:t.name,version:r,architecture:e.includes(`x64`)||e.includes(`x86_64`)?`64-bit`:`32-bit`}}}return{name:`Unknown`,version:``,architecture:e.includes(`x64`)||e.includes(`x86_64`)?`64-bit`:`32-bit`}})(),device:(()=>{let t=/Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(e),n=/iPad|Android(?!.*Mobile)/i.test(e),o=`Unknown`,s=`Unknown`;if(e.includes(`iPhone`)||e.includes(`iPad`)||e.includes(`iPod`))o=`Apple`,e.includes(`iPhone`)&&(s=`iPhone`),e.includes(`iPad`)&&(s=`iPad`),e.includes(`iPod`)&&(s=`iPod`);else if(e.includes(`Samsung`))o=`Samsung`;else if(e.includes(`Pixel`)){o=`Google`;let t=e.match(/Pixel ([0-9XL]+)/);t&&(s=`Pixel ${t[1]}`)}let c=n?`tablet`:t?`mobile`:`desktop`;return{type:c,vendor:o,model:s,orientation:i>r?`portrait`:`landscape`,isMobile:c===`mobile`,isTablet:c===`tablet`,isDesktop:c===`desktop`,touch:a>0}})()}}const u=()=>({browser:{name:``,version:``,major:``,userAgent:``,vendor:``,engine:``,engineVersion:``},os:{name:``,version:``,architecture:``},device:{type:`unknown`,vendor:``,model:``,orientation:`portrait`,isMobile:!1,isTablet:!1,isDesktop:!1,touch:!1},network:{online:!1,effectiveType:``,downlink:0,rtt:0,saveData:!1},screen:{width:0,height:0,availWidth:0,availHeight:0,colorDepth:0,orientation:``,pixelRatio:1,touchPoints:0},performance:{memory:null,navigation:{type:``,redirectCount:0},timing:{loadTime:0,domContentLoaded:0,firstPaint:null,firstContentfulPaint:null}},location:{timeZone:``,language:``,languages:[],isRestricted:!1,doNotTrack:null,cookiesEnabled:!1,localStorage:!1,sessionStorage:!1},pageVisibility:`visible`,referrer:``,isIncognito:!1,hasCamera:null,hasMicrophone:null,hasBattery:null,batteryLevel:null,batteryCharging:null,permissions:{}});function d(d={}){let{autoRefresh:f=!1,refreshInterval:p=3e4,trackVisibility:m=!0,detectFeatures:h=!0,lazyFeatures:g=!0}=d,_=u(),v=null,y=null,b=!1,x=()=>{if(typeof navigator>`u`||typeof window>`u`)return;let e=navigator.userAgent,{browser:t,os:n,device:r}=l(e);Object.assign(_,{browser:t,os:n,device:r,screen:c(),location:i(),referrer:document.referrer})},S=async()=>{if(!h||b)return;let[i,a,o,s]=await Promise.all([e(),t(),n(),r()]);b||Object.assign(_,{isIncognito:i,hasCamera:a.hasCamera,hasMicrophone:a.hasMicrophone,hasBattery:o.hasBattery,batteryLevel:o.level,batteryCharging:o.charging,permissions:s})},C=()=>{typeof navigator>`u`||typeof window>`u`||Object.assign(_,{network:a(),performance:o(),pageVisibility:document.visibilityState===`visible`?`visible`:`hidden`})},w=()=>{if(!h)return;let e=()=>{S()};if(g){s(e);return}e()};if(m&&typeof document<`u`){let e=()=>{_.pageVisibility=document.visibilityState===`visible`?`visible`:`hidden`};document.addEventListener(`visibilitychange`,e),v=e}return f&&typeof window<`u`&&(y=setInterval(C,p)),x(),C(),w(),{data:_,refresh:async()=>{x(),C(),await S()},destroy:()=>{b=!0,y!==null&&(clearInterval(y),y=null),v&&typeof document<`u`&&(document.removeEventListener(`visibilitychange`,v),v=null)},get isMobile(){return _.device.isMobile},get isTablet(){return _.device.isTablet},get isDesktop(){return _.device.isDesktop},get isOnline(){return _.network.online},get isVisible(){return _.pageVisibility===`visible`},get browserName(){return _.browser.name},get osName(){return _.os.name}}}exports.useSoloAnalytics=d;
+//# sourceMappingURL=index.cjs.map