@wxt-dev/analytics 0.2.2 → 0.2.4

package/dist/client.d.mts

@@ -1,4 +1,4 @@
-import { A as AnalyticsConfig, a as Analytics } from './shared/analytics.5d517cf0.mjs';
+import { A as AnalyticsConfig, a as Analytics } from './shared/analytics.079e9952.mjs';
 
 declare function createAnalytics(config?: AnalyticsConfig): Analytics;
 

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { A as AnalyticsConfig, a as Analytics } from './shared/analytics.5d517cf0.js';
+import { A as AnalyticsConfig, a as Analytics } from './shared/analytics.079e9952.js';
 
 declare function createAnalytics(config?: AnalyticsConfig): Analytics;
 

package/dist/client.mjs

@@ -13,12 +13,12 @@ function createAnalytics(config) {
   }
   if (location.pathname === "/background.js")
     return createBackgroundAnalytics(config);
-  return createFrontendAnalytics();
+  return createFrontendAnalytics(config);
 }
 function createBackgroundAnalytics(config) {
-  const userIdStorage = config?.userId ?? defineStorageItem("local:wxt-analytics:user-id");
+  const userIdStorage = config?.userId ?? defineStorageItem("wxt-analytics:user-id");
   const userPropertiesStorage = config?.userProperties ?? defineStorageItem(
-    "local:wxt-analytics:user-properties",
+    "wxt-analytics:user-properties",
     {}
   );
   const enabled = config?.enabled ?? defineStorageItem("local:wxt-analytics:enabled", false);
@@ -80,7 +80,9 @@ function createBackgroundAnalytics(config) {
           providers.map((provider) => provider.identify(event))
         );
       } else if (config?.debug) {
-        console.debug("[analytics] Disabled, identify() not called");
+        console.debug(
+          "[analytics] Analytics disabled, identify() not uploaded"
+        );
       }
     },
     page: async (url, forwardMeta) => {
@@ -100,7 +102,7 @@ function createBackgroundAnalytics(config) {
           providers.map((provider) => provider.page(event))
         );
       } else if (config?.debug) {
-        console.debug("[analytics] Disabled, page() not called");
+        console.debug("[analytics] Analytics disabled, page() not uploaded");
       }
     },
     track: async (eventName, eventProperties, forwardMeta) => {
@@ -116,7 +118,7 @@ function createBackgroundAnalytics(config) {
           providers.map((provider) => provider.track(event))
         );
       } else if (config?.debug) {
-        console.debug("[analytics] Disabled, track() not called");
+        console.debug("[analytics] Analytics disabled, track() not uploaded");
       }
     },
     setEnabled: async (newEnabled) => {
@@ -137,7 +139,7 @@ function createBackgroundAnalytics(config) {
   });
   return analytics;
 }
-function createFrontendAnalytics() {
+function createFrontendAnalytics(config) {
   const port = chrome.runtime.connect({ name: ANALYTICS_PORT });
   const sessionId = Date.now();
   const getMetadata = () => ({
@@ -148,15 +150,29 @@ function createFrontendAnalytics() {
     screen: globalThis.window ? `${globalThis.window.screen.width}x${globalThis.window.screen.height}` : void 0,
     url: location.href
   });
-  const methodForwarder = (fn) => (...args) => port.postMessage({ fn, args: [...args, getMetadata()] });
+  const methodForwarder = (fn) => (...args) => {
+    if (config?.debug) {
+      console.debug(
+        `[analytics] Sending ${fn} to background for upload`,
+        ...args
+      );
+    }
+    port.postMessage({ fn, args: [...args, getMetadata()] });
+  };
   const analytics = {
     identify: methodForwarder("identify"),
     page: methodForwarder("page"),
     track: methodForwarder("track"),
     setEnabled: methodForwarder("setEnabled"),
     autoTrack: (root) => {
+      if (config?.debug) {
+        console.debug("[analytics] autoTrack() called!");
+      }
       const onClick = (event) => {
         const element = event.target;
+        if (config?.debug) {
+          console.debug("[analytics] autoTrack() element clicked", element);
+        }
         if (!element || !INTERACTIVE_TAGS.has(element.tagName) && !INTERACTIVE_ROLES.has(element.getAttribute("role")))
           return;
         void analytics.track("click", {

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import * as wxt from 'wxt';
-import { A as AnalyticsConfig } from './shared/analytics.5d517cf0.mjs';
+import { A as AnalyticsConfig } from './shared/analytics.079e9952.mjs';
 
 declare module 'wxt/sandbox' {
     interface WxtAppConfig {

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as wxt from 'wxt';
-import { A as AnalyticsConfig } from './shared/analytics.5d517cf0.js';
+import { A as AnalyticsConfig } from './shared/analytics.079e9952.js';
 
 declare module 'wxt/sandbox' {
     interface WxtAppConfig {

package/dist/providers/google-analytics-4.d.mts

@@ -1,4 +1,4 @@
-import { b as AnalyticsProvider } from '../shared/analytics.5d517cf0.mjs';
+import { b as AnalyticsProvider } from '../shared/analytics.079e9952.mjs';
 
 interface GoogleAnalyticsProviderOptions {
     apiSecret: string;

package/dist/providers/google-analytics-4.d.ts

@@ -1,4 +1,4 @@
-import { b as AnalyticsProvider } from '../shared/analytics.5d517cf0.js';
+import { b as AnalyticsProvider } from '../shared/analytics.079e9952.js';
 
 interface GoogleAnalyticsProviderOptions {
     apiSecret: string;

package/dist/providers/umami.d.mts

@@ -1,4 +1,4 @@
-import { b as AnalyticsProvider } from '../shared/analytics.5d517cf0.mjs';
+import { b as AnalyticsProvider } from '../shared/analytics.079e9952.mjs';
 
 interface UmamiProviderOptions {
     baseUrl: string;

package/dist/providers/umami.d.ts

@@ -1,4 +1,4 @@
-import { b as AnalyticsProvider } from '../shared/analytics.5d517cf0.js';
+import { b as AnalyticsProvider } from '../shared/analytics.079e9952.js';
 
 interface UmamiProviderOptions {
     baseUrl: string;

package/dist/shared/{analytics.5d517cf0.d.mts → analytics.079e9952.d.mts}

@@ -2,7 +2,7 @@ interface Analytics {
     /** Report a page change */
     page: (url: string) => void;
     /** Report a custom event */
-    track: (eventName: string, eventProperties: Record<string, string>) => void;
+    track: (eventName: string, eventProperties?: Record<string, string>) => void;
     /** Save information about the user */
     identify: (userId: string, userProperties?: Record<string, string>) => void;
     /** Automatically setup and track user interactions, returning a function to remove any listeners that were setup. */
@@ -24,7 +24,7 @@ interface AnalyticsConfig {
      */
     version?: string;
     /**
-     * Configure how the enabled flag is persisted
+     * Configure how the enabled flag is persisted. Defaults to using `""` in local extension storage.
      */
     enabled?: AnalyticsStorageItem<boolean>;
     /**

package/dist/shared/{analytics.5d517cf0.d.ts → analytics.079e9952.d.ts}

@@ -2,7 +2,7 @@ interface Analytics {
     /** Report a page change */
     page: (url: string) => void;
     /** Report a custom event */
-    track: (eventName: string, eventProperties: Record<string, string>) => void;
+    track: (eventName: string, eventProperties?: Record<string, string>) => void;
     /** Save information about the user */
     identify: (userId: string, userProperties?: Record<string, string>) => void;
     /** Automatically setup and track user interactions, returning a function to remove any listeners that were setup. */
@@ -24,7 +24,7 @@ interface AnalyticsConfig {
      */
     version?: string;
     /**
-     * Configure how the enabled flag is persisted
+     * Configure how the enabled flag is persisted. Defaults to using `""` in local extension storage.
      */
     enabled?: AnalyticsStorageItem<boolean>;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wxt-dev/analytics",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Add analytics to your web extension",
   "repository": {
     "type": "git",