@wxt-dev/analytics 0.2.1 → 0.2.3

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);
@@ -137,7 +137,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 +148,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/index.mjs

@@ -18,9 +18,10 @@ const index = defineWxtModule({
       "analytics/index.ts"
     );
     const analyticsModuleCode = `
-      import { createAnalytics } from '@wxt-dev/analytics/client';
+import { createAnalytics } from '@wxt-dev/analytics/client';
+import { useAppConfig } from 'wxt/client';
 
-      export const analytics = createAnalytics(useAppConfig().analytics);
+export const analytics = createAnalytics(useAppConfig().analytics);
     `;
     addAlias(wxt, "#analytics", analyticsModulePath);
     wxt.hook("prepare:types", async (_, entries) => {

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.1",
+  "version": "0.2.3",
   "description": "Add analytics to your web extension",
   "repository": {
     "type": "git",