@wxt-dev/analytics 0.5.0 → 0.5.2

package/README.md

@@ -10,15 +10,19 @@ Report analytics events from your web extension extension.
 ## Install With WXT
 
 1. Install the NPM package:
+
    ```bash
    pnpm i @wxt-dev/analytics
    ```
+
 2. In your `wxt.config.ts`, add the WXT module:
+
    ```ts
    export default defineConfig({
      modules: ['@wxt-dev/analytics/module'],
    });
    ```
+
 3. In your `<srcDir>/app.config.ts`, add a provider:
 
    ```ts
@@ -49,9 +53,11 @@ Report analytics events from your web extension extension.
 ## Install Without WXT
 
 1. Install the NPM package:
+
    ```bash
    pnpm i @wxt-dev/analytics
    ```
+
 2. Create an `analytics` instance:
 
    ```ts
@@ -66,10 +72,12 @@ Report analytics events from your web extension extension.
    ```
 
 3. Import your analytics module in the background to initialize the message listener:
+
    ```ts
    // background.ts
    import './utils/analytics';
    ```
+
 4. Then use your `analytics` instance to report events:
 
    ```ts

package/dist/background-plugin.d.mts

@@ -1,3 +1,6 @@
-declare const _default: () => void;
+import "#analytics";
 
-export { _default as default };
+//#region modules/analytics/background-plugin.d.ts
+declare const _default: () => void;
+//#endregion
+export { _default as default };

package/dist/background-plugin.mjs

@@ -1,6 +1,7 @@
-import '#analytics';
+import "#analytics";
 
-const backgroundPlugin = () => {
-};
+//#region modules/analytics/background-plugin.ts
+var background_plugin_default = () => {};
 
-export { backgroundPlugin as default };
+//#endregion
+export { background_plugin_default as default };

package/dist/index.d.mts

@@ -1,12 +1,13 @@
-import { AnalyticsConfig, Analytics, AnalyticsProvider } from './types.mjs';
+import { Analytics, AnalyticsConfig, AnalyticsProvider } from "./types.mjs";
 
+//#region modules/analytics/client.d.ts
 declare function createAnalytics(config?: AnalyticsConfig): Analytics;
-declare function defineAnalyticsProvider<T = never>(definition: (
-/** The analytics object. */
-analytics: Analytics, 
-/** Config passed into the analytics module from `app.config.ts`. */
-config: AnalyticsConfig, 
-/** Provider options */
-options: T) => ReturnType<AnalyticsProvider>): (options: T) => AnalyticsProvider;
+declare function defineAnalyticsProvider<T = never>(definition: (/** The analytics object. */
+
+analytics: Analytics, /** Config passed into the analytics module from `app.config.ts`. */
 
-export { createAnalytics, defineAnalyticsProvider };
+config: AnalyticsConfig, /** Provider options */
+
+options: T) => ReturnType<AnalyticsProvider>): (options: T) => AnalyticsProvider;
+//#endregion
+export { createAnalytics, defineAnalyticsProvider };

package/dist/index.mjs

@@ -1,205 +1,177 @@
-import { UAParser } from 'ua-parser-js';
+import { UAParser } from "ua-parser-js";
+import { browser } from "@wxt-dev/browser";
 
+//#region modules/analytics/client.ts
 const ANALYTICS_PORT = "@wxt-dev/analytics";
+const INTERACTIVE_TAGS = new Set([
+	"A",
+	"BUTTON",
+	"INPUT",
+	"SELECT",
+	"TEXTAREA"
+]);
+const INTERACTIVE_ROLES = new Set([
+	"button",
+	"link",
+	"checkbox",
+	"menuitem",
+	"tab",
+	"radio"
+]);
 function createAnalytics(config) {
-  if (typeof chrome === "undefined" || !chrome?.runtime?.id)
-    throw Error(
-      "Cannot use WXT analytics in contexts without access to the browser.runtime APIs"
-    );
-  if (config == null) {
-    console.warn(
-      "[@wxt-dev/analytics] Config not provided to createAnalytics. If you're using WXT, add the 'analytics' property to '<srcDir>/app.config.ts'."
-    );
-  }
-  if (location.pathname === "/background.js")
-    return createBackgroundAnalytics(config);
-  return createFrontendAnalytics();
+	if (!browser?.runtime?.id) throw Error("Cannot use WXT analytics in contexts without access to the browser.runtime APIs");
+	if (config == null) console.warn("[@wxt-dev/analytics] Config not provided to createAnalytics. If you're using WXT, add the 'analytics' property to '<srcDir>/app.config.ts'.");
+	if (location.pathname === "/background.js") return createBackgroundAnalytics(config);
+	return createFrontendAnalytics();
 }
+/**
+* Creates an analytics client in the background responsible for uploading events to the server to avoid CORS errors.
+*/
 function createBackgroundAnalytics(config) {
-  const userIdStorage = config?.userId ?? defineStorageItem("wxt-analytics:user-id");
-  const userPropertiesStorage = config?.userProperties ?? defineStorageItem(
-    "wxt-analytics:user-properties",
-    {}
-  );
-  const enabled = config?.enabled ?? defineStorageItem("local:wxt-analytics:enabled", false);
-  const platformInfo = chrome.runtime.getPlatformInfo();
-  const userAgent = UAParser();
-  let userId = Promise.resolve(userIdStorage.getValue()).then(
-    (id) => id ?? globalThis.crypto.randomUUID()
-  );
-  let userProperties = userPropertiesStorage.getValue();
-  const manifest = chrome.runtime.getManifest();
-  const getBackgroundMeta = () => ({
-    timestamp: Date.now(),
-    // Don't track sessions for the background, it can be running
-    // indefinitely, and will inflate session duration stats.
-    sessionId: void 0,
-    language: navigator.language,
-    referrer: void 0,
-    screen: void 0,
-    url: location.href,
-    title: void 0
-  });
-  const getBaseEvent = async (meta) => {
-    const platform = await platformInfo;
-    return {
-      meta,
-      user: {
-        id: await userId,
-        properties: {
-          version: config?.version ?? manifest.version_name ?? manifest.version,
-          wxtMode: import.meta.env.MODE,
-          wxtBrowser: import.meta.env.BROWSER,
-          arch: platform.arch,
-          os: platform.os,
-          browser: userAgent.browser.name,
-          browserVersion: userAgent.browser.version,
-          ...await userProperties
-        }
-      }
-    };
-  };
-  const analytics = {
-    identify: async (newUserId, newUserProperties = {}, meta = getBackgroundMeta()) => {
-      userId = Promise.resolve(newUserId);
-      userProperties = Promise.resolve(newUserProperties);
-      await Promise.all([
-        userIdStorage.setValue?.(newUserId),
-        userPropertiesStorage.setValue?.(newUserProperties)
-      ]);
-      const event = await getBaseEvent(meta);
-      if (config?.debug) console.debug("[@wxt-dev/analytics] identify", event);
-      if (await enabled.getValue()) {
-        await Promise.allSettled(
-          providers.map((provider) => provider.identify(event))
-        );
-      } else if (config?.debug) {
-        console.debug(
-          "[@wxt-dev/analytics] Analytics disabled, identify() not uploaded"
-        );
-      }
-    },
-    page: async (location2, meta = getBackgroundMeta()) => {
-      const baseEvent = await getBaseEvent(meta);
-      const event = {
-        ...baseEvent,
-        page: {
-          url: meta?.url ?? globalThis.location?.href,
-          location: location2,
-          title: meta?.title ?? globalThis.document?.title
-        }
-      };
-      if (config?.debug) console.debug("[@wxt-dev/analytics] page", event);
-      if (await enabled.getValue()) {
-        await Promise.allSettled(
-          providers.map((provider) => provider.page(event))
-        );
-      } else if (config?.debug) {
-        console.debug(
-          "[@wxt-dev/analytics] Analytics disabled, page() not uploaded"
-        );
-      }
-    },
-    track: async (eventName, eventProperties, meta = getBackgroundMeta()) => {
-      const baseEvent = await getBaseEvent(meta);
-      const event = {
-        ...baseEvent,
-        event: { name: eventName, properties: eventProperties }
-      };
-      if (config?.debug) console.debug("[@wxt-dev/analytics] track", event);
-      if (await enabled.getValue()) {
-        await Promise.allSettled(
-          providers.map((provider) => provider.track(event))
-        );
-      } else if (config?.debug) {
-        console.debug(
-          "[@wxt-dev/analytics] Analytics disabled, track() not uploaded"
-        );
-      }
-    },
-    setEnabled: async (newEnabled) => {
-      await enabled.setValue?.(newEnabled);
-    },
-    autoTrack: () => {
-      return () => {
-      };
-    }
-  };
-  const providers = config?.providers?.map((provider) => provider(analytics, config)) ?? [];
-  chrome.runtime.onConnect.addListener((port) => {
-    if (port.name === ANALYTICS_PORT) {
-      port.onMessage.addListener(({ fn, args }) => {
-        void analytics[fn]?.(...args);
-      });
-    }
-  });
-  return analytics;
+	const userIdStorage = config?.userId ?? defineStorageItem("wxt-analytics:user-id");
+	const userPropertiesStorage = config?.userProperties ?? defineStorageItem("wxt-analytics:user-properties", {});
+	const enabled = config?.enabled ?? defineStorageItem("local:wxt-analytics:enabled", false);
+	const platformInfo = browser.runtime.getPlatformInfo();
+	const userAgent = UAParser();
+	let userId = Promise.resolve(userIdStorage.getValue()).then((id) => id ?? globalThis.crypto.randomUUID());
+	let userProperties = userPropertiesStorage.getValue();
+	const manifest = browser.runtime.getManifest();
+	const getBackgroundMeta = () => ({
+		timestamp: Date.now(),
+		sessionId: void 0,
+		language: navigator.language,
+		referrer: void 0,
+		screen: void 0,
+		url: location.href,
+		title: void 0
+	});
+	const getBaseEvent = async (meta) => {
+		const { arch, os } = await platformInfo;
+		return {
+			meta,
+			user: {
+				id: await userId,
+				properties: {
+					version: config?.version ?? manifest.version_name ?? manifest.version,
+					wxtMode: import.meta.env.MODE,
+					wxtBrowser: import.meta.env.BROWSER,
+					arch,
+					os,
+					browser: userAgent.browser.name,
+					browserVersion: userAgent.browser.version,
+					...await userProperties
+				}
+			}
+		};
+	};
+	const analytics = {
+		identify: async (newUserId, newUserProperties = {}, meta = getBackgroundMeta()) => {
+			userId = Promise.resolve(newUserId);
+			userProperties = Promise.resolve(newUserProperties);
+			await Promise.all([userIdStorage.setValue?.(newUserId), userPropertiesStorage.setValue?.(newUserProperties)]);
+			const event = await getBaseEvent(meta);
+			if (config?.debug) console.debug("[@wxt-dev/analytics] identify", event);
+			if (await enabled.getValue()) await Promise.allSettled(providers.map((provider) => provider.identify(event)));
+			else if (config?.debug) console.debug("[@wxt-dev/analytics] Analytics disabled, identify() not uploaded");
+		},
+		page: async (location, meta = getBackgroundMeta()) => {
+			const event = {
+				...await getBaseEvent(meta),
+				page: {
+					url: meta?.url ?? globalThis.location?.href,
+					location,
+					title: meta?.title ?? globalThis.document?.title
+				}
+			};
+			if (config?.debug) console.debug("[@wxt-dev/analytics] page", event);
+			if (await enabled.getValue()) await Promise.allSettled(providers.map((provider) => provider.page(event)));
+			else if (config?.debug) console.debug("[@wxt-dev/analytics] Analytics disabled, page() not uploaded");
+		},
+		track: async (eventName, eventProperties, meta = getBackgroundMeta()) => {
+			const event = {
+				...await getBaseEvent(meta),
+				event: {
+					name: eventName,
+					properties: eventProperties
+				}
+			};
+			if (config?.debug) console.debug("[@wxt-dev/analytics] track", event);
+			if (await enabled.getValue()) await Promise.allSettled(providers.map((provider) => provider.track(event)));
+			else if (config?.debug) console.debug("[@wxt-dev/analytics] Analytics disabled, track() not uploaded");
+		},
+		setEnabled: async (newEnabled) => {
+			await enabled.setValue?.(newEnabled);
+		},
+		autoTrack: () => {
+			return () => {};
+		}
+	};
+	const providers = config?.providers?.map((provider) => provider(analytics, config)) ?? [];
+	browser.runtime.onConnect.addListener((port) => {
+		if (port.name === ANALYTICS_PORT) port.onMessage.addListener(({ fn, args }) => {
+			analytics[fn]?.(...args);
+		});
+	});
+	return analytics;
 }
+/**
+* Creates an analytics client for non-background contexts.
+*/
 function createFrontendAnalytics() {
-  const port = chrome.runtime.connect({ name: ANALYTICS_PORT });
-  const sessionId = Date.now();
-  const getFrontendMetadata = () => ({
-    sessionId,
-    timestamp: Date.now(),
-    language: navigator.language,
-    referrer: globalThis.document?.referrer || void 0,
-    screen: globalThis.window ? `${globalThis.window.screen.width}x${globalThis.window.screen.height}` : void 0,
-    url: location.href,
-    title: document.title || void 0
-  });
-  const methodForwarder = (fn) => (...args) => {
-    port.postMessage({ fn, args: [...args, getFrontendMetadata()] });
-  };
-  const analytics = {
-    identify: methodForwarder("identify"),
-    page: methodForwarder("page"),
-    track: methodForwarder("track"),
-    setEnabled: methodForwarder("setEnabled"),
-    autoTrack: (root) => {
-      const onClick = (event) => {
-        const element = event.target;
-        if (!element || !INTERACTIVE_TAGS.has(element.tagName) && !INTERACTIVE_ROLES.has(element.getAttribute("role")))
-          return;
-        void analytics.track("click", {
-          tagName: element.tagName?.toLowerCase(),
-          id: element.id || void 0,
-          className: element.className || void 0,
-          textContent: element.textContent?.substring(0, 50) || void 0,
-          // Limit text content length
-          href: element.href
-        });
-      };
-      root.addEventListener("click", onClick, { capture: true, passive: true });
-      return () => {
-        root.removeEventListener("click", onClick);
-      };
-    }
-  };
-  return analytics;
+	const port = browser.runtime.connect({ name: ANALYTICS_PORT });
+	const sessionId = Date.now();
+	const getFrontendMetadata = () => ({
+		sessionId,
+		timestamp: Date.now(),
+		language: navigator.language,
+		referrer: globalThis.document?.referrer || void 0,
+		screen: globalThis.window ? `${globalThis.window.screen.width}x${globalThis.window.screen.height}` : void 0,
+		url: location.href,
+		title: document.title || void 0
+	});
+	const methodForwarder = (fn) => (...args) => {
+		port.postMessage({
+			fn,
+			args: [...args, getFrontendMetadata()]
+		});
+	};
+	const analytics = {
+		identify: methodForwarder("identify"),
+		page: methodForwarder("page"),
+		track: methodForwarder("track"),
+		setEnabled: methodForwarder("setEnabled"),
+		autoTrack: (root) => {
+			const onClick = (event) => {
+				const element = event.target;
+				if (!element || !INTERACTIVE_TAGS.has(element.tagName) && !INTERACTIVE_ROLES.has(element.getAttribute("role"))) return;
+				analytics.track("click", {
+					tagName: element.tagName?.toLowerCase(),
+					id: element.id || void 0,
+					className: element.className || void 0,
+					textContent: element.textContent?.substring(0, 50) || void 0,
+					href: element.href
+				});
+			};
+			root.addEventListener("click", onClick, {
+				capture: true,
+				passive: true
+			});
+			return () => {
+				root.removeEventListener("click", onClick);
+			};
+		}
+	};
+	return analytics;
 }
 function defineStorageItem(key, defaultValue) {
-  return {
-    getValue: async () => (await chrome.storage.local.get(key))[key] ?? defaultValue,
-    setValue: (newValue) => chrome.storage.local.set({ [key]: newValue })
-  };
+	return {
+		getValue: async () => (await browser.storage.local.get(key))[key] ?? defaultValue,
+		setValue: (newValue) => browser.storage.local.set({ [key]: newValue })
+	};
 }
-const INTERACTIVE_TAGS = /* @__PURE__ */ new Set([
-  "A",
-  "BUTTON",
-  "INPUT",
-  "SELECT",
-  "TEXTAREA"
-]);
-const INTERACTIVE_ROLES = /* @__PURE__ */ new Set([
-  "button",
-  "link",
-  "checkbox",
-  "menuitem",
-  "tab",
-  "radio"
-]);
 function defineAnalyticsProvider(definition) {
-  return (options) => (analytics, config) => definition(analytics, config, options);
+	return (options) => (analytics, config) => definition(analytics, config, options);
 }
 
-export { createAnalytics, defineAnalyticsProvider };
+//#endregion
+export { createAnalytics, defineAnalyticsProvider };

package/dist/module.d.mts

@@ -1,11 +1,13 @@
-import * as wxt from 'wxt';
-import { AnalyticsConfig } from './types.mjs';
+import { AnalyticsConfig } from "./types.mjs";
+import * as wxt from "wxt";
+import "wxt/utils/define-app-config";
 
+//#region modules/analytics/index.d.ts
 declare module 'wxt/utils/define-app-config' {
-    interface WxtAppConfig {
-        analytics: AnalyticsConfig;
-    }
+  interface WxtAppConfig {
+    analytics: AnalyticsConfig;
+  }
 }
 declare const _default: wxt.WxtModule<wxt.WxtModuleOptions>;
-
-export { _default as default };
+//#endregion
+export { _default as default };

package/dist/module.mjs

@@ -1,61 +1,52 @@
-import 'wxt';
-import 'wxt/utils/define-app-config';
-import { defineWxtModule, addAlias, addWxtPlugin, addViteConfig } from 'wxt/modules';
-import { resolve } from 'node:path';
+import "wxt";
+import "wxt/utils/define-app-config";
+import { addAlias, addViteConfig, addWxtPlugin, defineWxtModule } from "wxt/modules";
+import { resolve } from "node:path";
 
-const index = defineWxtModule({
-  name: "analytics",
-  imports: [{ name: "analytics", from: "#analytics" }],
-  setup(wxt) {
-    const wxtAnalyticsFolder = resolve(wxt.config.wxtDir, "analytics");
-    const wxtAnalyticsIndex = resolve(wxtAnalyticsFolder, "index.ts");
-    const clientModuleId = "@wxt-dev/analytics" ;
-    const pluginModuleId = "@wxt-dev/analytics/background-plugin" ;
-    wxt.hook("build:manifestGenerated", (_, manifest) => {
-      manifest.permissions ??= [];
-      if (!manifest.permissions.includes("storage")) {
-        manifest.permissions.push("storage");
-      }
-    });
-    const wxtAnalyticsCode = [
-      `import { createAnalytics } from '${clientModuleId }';`,
-      `import { useAppConfig } from '#imports';`,
-      ``,
-      `export const analytics = createAnalytics(useAppConfig().analytics);`,
-      ``
-    ].join("\n");
-    addAlias(wxt, "#analytics", wxtAnalyticsIndex);
-    wxt.hook("prepare:types", async (_, entries) => {
-      entries.push({
-        path: wxtAnalyticsIndex,
-        text: wxtAnalyticsCode
-      });
-    });
-    wxt.hook("entrypoints:resolved", (_, entrypoints) => {
-      const hasBackground = entrypoints.find(
-        (entry) => entry.type === "background"
-      );
-      if (!hasBackground) {
-        entrypoints.push({
-          type: "background",
-          inputPath: "virtual:user-background",
-          name: "background",
-          options: {},
-          outputDir: wxt.config.outDir,
-          skipped: false
-        });
-      }
-    });
-    addWxtPlugin(wxt, pluginModuleId);
-    addViteConfig(wxt, () => ({
-      optimizeDeps: {
-        // Ensure the "#analytics" import is processed by vite in the background plugin
-        exclude: ["@wxt-dev/analytics"],
-        // Ensure the CJS subdependency is preprocessed into ESM
-        include: ["@wxt-dev/analytics > ua-parser-js"]
-      }
-    }));
-  }
+//#region modules/analytics/index.ts
+var analytics_default = defineWxtModule({
+	name: "analytics",
+	imports: [{
+		name: "analytics",
+		from: "#analytics"
+	}],
+	setup(wxt) {
+		const wxtAnalyticsIndex = resolve(resolve(wxt.config.wxtDir, "analytics"), "index.ts");
+		const clientModuleId = "@wxt-dev/analytics";
+		const pluginModuleId = "@wxt-dev/analytics/background-plugin";
+		wxt.hook("build:manifestGenerated", (_, manifest) => {
+			manifest.permissions ??= [];
+			if (!manifest.permissions.includes("storage")) manifest.permissions.push("storage");
+		});
+		const wxtAnalyticsCode = `import { createAnalytics } from '${clientModuleId}';
+import { useAppConfig } from '#imports';
+
+export const analytics = createAnalytics(useAppConfig().analytics);
+`;
+		addAlias(wxt, "#analytics", wxtAnalyticsIndex);
+		wxt.hook("prepare:types", async (_, entries) => {
+			entries.push({
+				path: wxtAnalyticsIndex,
+				text: wxtAnalyticsCode
+			});
+		});
+		wxt.hook("entrypoints:resolved", (_, entrypoints) => {
+			if (!entrypoints.find((entry) => entry.type === "background")) entrypoints.push({
+				type: "background",
+				inputPath: "virtual:user-background",
+				name: "background",
+				options: {},
+				outputDir: wxt.config.outDir,
+				skipped: false
+			});
+		});
+		addWxtPlugin(wxt, pluginModuleId);
+		addViteConfig(wxt, () => ({ optimizeDeps: {
+			exclude: ["@wxt-dev/analytics"],
+			include: ["@wxt-dev/analytics > ua-parser-js"]
+		} }));
+	}
 });
 
-export { index as default };
+//#endregion
+export { analytics_default as default };

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

@@ -1,9 +1,11 @@
-import { AnalyticsProvider } from '../types.mjs';
+import { AnalyticsProvider } from "../types.mjs";
 
+//#region modules/analytics/providers/google-analytics-4.d.ts
 interface GoogleAnalytics4ProviderOptions {
-    apiSecret: string;
-    measurementId: string;
+  apiUrl?: string;
+  apiSecret: string;
+  measurementId: string;
 }
 declare const googleAnalytics4: (options: GoogleAnalytics4ProviderOptions) => AnalyticsProvider;
-
-export { type GoogleAnalytics4ProviderOptions, googleAnalytics4 };
+//#endregion
+export { GoogleAnalytics4ProviderOptions, googleAnalytics4 };

package/dist/providers/google-analytics-4.mjs

@@ -1,61 +1,48 @@
-import { defineAnalyticsProvider } from '../index.mjs';
-import 'ua-parser-js';
+import { defineAnalyticsProvider } from "../index.mjs";
 
+//#region modules/analytics/providers/google-analytics-4.ts
 const DEFAULT_ENGAGEMENT_TIME_IN_MSEC = 100;
-const googleAnalytics4 = defineAnalyticsProvider(
-  (_, config, options) => {
-    const send = async (data, eventName, eventProperties) => {
-      const url = new URL(
-        config?.debug ? "/debug/mp/collect" : "/mp/collect",
-        "https://www.google-analytics.com"
-      );
-      if (options.apiSecret)
-        url.searchParams.set("api_secret", options.apiSecret);
-      if (options.measurementId)
-        url.searchParams.set("measurement_id", options.measurementId);
-      const userProperties = {
-        language: data.meta.language,
-        screen: data.meta.screen,
-        ...data.user.properties
-      };
-      const mappedUserProperties = Object.fromEntries(
-        Object.entries(userProperties).map(([name, value]) => [
-          name,
-          value == null ? void 0 : { value }
-        ])
-      );
-      await fetch(url.href, {
-        method: "POST",
-        body: JSON.stringify({
-          client_id: data.user.id,
-          consent: {
-            ad_user_data: "DENIED",
-            ad_personalization: "DENIED"
-          },
-          user_properties: mappedUserProperties,
-          events: [
-            {
-              name: eventName,
-              params: {
-                session_id: data.meta.sessionId,
-                engagement_time_msec: DEFAULT_ENGAGEMENT_TIME_IN_MSEC,
-                ...eventProperties
-              }
-            }
-          ]
-        })
-      });
-    };
-    return {
-      identify: () => Promise.resolve(),
-      // No-op, user data uploaded in page/track
-      page: (event) => send(event, "page_view", {
-        page_title: event.page.title,
-        page_location: event.page.location
-      }),
-      track: (event) => send(event, event.event.name, event.event.properties)
-    };
-  }
-);
+const googleAnalytics4 = defineAnalyticsProvider((_, config, options) => {
+	const send = async (data, eventName, eventProperties) => {
+		const url = new URL(config?.debug ? "/debug/mp/collect" : "/mp/collect", options.apiUrl ?? "https://www.google-analytics.com");
+		if (options.apiSecret) url.searchParams.set("api_secret", options.apiSecret);
+		if (options.measurementId) url.searchParams.set("measurement_id", options.measurementId);
+		const userProperties = {
+			language: data.meta.language,
+			screen: data.meta.screen,
+			...data.user.properties
+		};
+		const mappedUserProperties = Object.fromEntries(Object.entries(userProperties).map(([name, value]) => [name, value == null ? void 0 : { value }]));
+		await fetch(url.href, {
+			method: "POST",
+			body: JSON.stringify({
+				client_id: data.user.id,
+				consent: {
+					ad_user_data: "DENIED",
+					ad_personalization: "DENIED"
+				},
+				user_properties: mappedUserProperties,
+				user_agent: navigator.userAgent,
+				events: [{
+					name: eventName,
+					params: {
+						session_id: data.meta.sessionId,
+						engagement_time_msec: DEFAULT_ENGAGEMENT_TIME_IN_MSEC,
+						...eventProperties
+					}
+				}]
+			})
+		});
+	};
+	return {
+		identify: () => Promise.resolve(),
+		page: (event) => send(event, "page_view", {
+			page_title: event.page.title,
+			page_location: event.page.location
+		}),
+		track: (event) => send(event, event.event.name, event.event.properties)
+	};
+});
 
-export { googleAnalytics4 };
+//#endregion
+export { googleAnalytics4 };

package/dist/providers/umami.d.mts

@@ -1,10 +1,11 @@
-import { AnalyticsProvider } from '../types.mjs';
+import { AnalyticsProvider } from "../types.mjs";
 
+//#region modules/analytics/providers/umami.d.ts
 interface UmamiProviderOptions {
-    apiUrl: string;
-    websiteId: string;
-    domain: string;
+  apiUrl: string;
+  websiteId: string;
+  domain: string;
 }
 declare const umami: (options: UmamiProviderOptions) => AnalyticsProvider;
-
-export { type UmamiProviderOptions, umami };
+//#endregion
+export { UmamiProviderOptions, umami };

package/dist/providers/umami.mjs

@@ -1,54 +1,51 @@
-import { defineAnalyticsProvider } from '../index.mjs';
-import 'ua-parser-js';
+import { defineAnalyticsProvider } from "../index.mjs";
 
-const umami = defineAnalyticsProvider(
-  (_, config, options) => {
-    const send = (payload) => {
-      if (config.debug) {
-        console.debug("[@wxt-dev/analytics] Sending event to Umami:", payload);
-      }
-      return fetch(`${options.apiUrl}/send`, {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json"
-        },
-        body: JSON.stringify({ type: "event", payload })
-      });
-    };
-    return {
-      identify: () => Promise.resolve(),
-      // No-op, user data uploaded in page/track
-      page: async (event) => {
-        await send({
-          name: "page_view",
-          website: options.websiteId,
-          url: event.page.url,
-          hostname: options.domain,
-          language: event.meta.language ?? "",
-          referrer: event.meta.referrer ?? "",
-          screen: event.meta.screen ?? "",
-          title: event.page.title ?? "<blank>",
-          data: event.user.properties
-        });
-      },
-      track: async (event) => {
-        await send({
-          name: event.event.name,
-          website: options.websiteId,
-          url: event.meta.url ?? "/",
-          title: "<blank>",
-          hostname: options.domain,
-          language: event.meta.language ?? "",
-          referrer: event.meta.referrer ?? "",
-          screen: event.meta.screen ?? "",
-          data: {
-            ...event.event.properties,
-            ...event.user.properties
-          }
-        });
-      }
-    };
-  }
-);
+//#region modules/analytics/providers/umami.ts
+const umami = defineAnalyticsProvider((_, config, options) => {
+	const send = (payload) => {
+		if (config.debug) console.debug("[@wxt-dev/analytics] Sending event to Umami:", payload);
+		return fetch(`${options.apiUrl}/send`, {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify({
+				type: "event",
+				payload
+			})
+		});
+	};
+	return {
+		identify: () => Promise.resolve(),
+		page: async (event) => {
+			await send({
+				name: "page_view",
+				website: options.websiteId,
+				url: event.page.url,
+				hostname: options.domain,
+				language: event.meta.language ?? "",
+				referrer: event.meta.referrer ?? "",
+				screen: event.meta.screen ?? "",
+				title: event.page.title ?? "<blank>",
+				data: event.user.properties
+			});
+		},
+		track: async (event) => {
+			await send({
+				name: event.event.name,
+				website: options.websiteId,
+				url: event.meta.url ?? "/",
+				title: "<blank>",
+				hostname: options.domain,
+				language: event.meta.language ?? "",
+				referrer: event.meta.referrer ?? "",
+				screen: event.meta.screen ?? "",
+				data: {
+					...event.event.properties,
+					...event.user.properties
+				}
+			});
+		}
+	};
+});
 
-export { umami };
+//#endregion
+export { umami };

package/dist/types.d.mts

@@ -1,90 +1,88 @@
+//#region modules/analytics/types.d.ts
 interface Analytics {
-    /** Report a page change. */
-    page: (url: string) => void;
-    /** Report a custom event. */
-    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. */
-    autoTrack: (root: Document | ShadowRoot | Element) => () => void;
-    /** Calls `config.enabled.setValue`. */
-    setEnabled: (enabled: boolean) => void;
+  /** Report a page change. */
+  page: (url: string) => void;
+  /** Report a custom event. */
+  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. */
+  autoTrack: (root: Document | ShadowRoot | Element) => () => void;
+  /** Calls `config.enabled.setValue`. */
+  setEnabled: (enabled: boolean) => void;
 }
 interface AnalyticsConfig {
-    /**
-     * Array of providers to send analytics to.
-     */
-    providers: AnalyticsProvider[];
-    /**
-     * Enable debug logs and other provider-specific debugging features.
-     */
-    debug?: boolean;
-    /**
-     * Your extension's version, reported alongside events.
-     * @default browser.runtime.getManifest().version`.
-     */
-    version?: string;
-    /**
-     * Configure how the enabled flag is persisted. Defaults to using `browser.storage.local`.
-     */
-    enabled?: AnalyticsStorageItem<boolean>;
-    /**
-     * Configure how the user Id is persisted. Defaults to using `browser.storage.local`.
-     */
-    userId?: AnalyticsStorageItem<string>;
-    /**
-     * Configure how user properties are persisted. Defaults to using `browser.storage.local`.
-     */
-    userProperties?: AnalyticsStorageItem<Record<string, string>>;
+  /**
+   * Array of providers to send analytics to.
+   */
+  providers: AnalyticsProvider[];
+  /**
+   * Enable debug logs and other provider-specific debugging features.
+   */
+  debug?: boolean;
+  /**
+   * Your extension's version, reported alongside events.
+   * @default browser.runtime.getManifest().version`.
+   */
+  version?: string;
+  /**
+   * Configure how the enabled flag is persisted. Defaults to using `browser.storage.local`.
+   */
+  enabled?: AnalyticsStorageItem<boolean>;
+  /**
+   * Configure how the user Id is persisted. Defaults to using `browser.storage.local`.
+   */
+  userId?: AnalyticsStorageItem<string>;
+  /**
+   * Configure how user properties are persisted. Defaults to using `browser.storage.local`.
+   */
+  userProperties?: AnalyticsStorageItem<Record<string, string>>;
 }
 interface AnalyticsStorageItem<T> {
-    getValue: () => T | Promise<T>;
-    setValue?: (newValue: T) => void | Promise<void>;
+  getValue: () => T | Promise<T>;
+  setValue?: (newValue: T) => void | Promise<void>;
 }
 type AnalyticsProvider = (analytics: Analytics, config: AnalyticsConfig) => {
-    /** Upload a page view event. */
-    page: (event: AnalyticsPageViewEvent) => Promise<void>;
-    /** Upload a custom event. */
-    track: (event: AnalyticsTrackEvent) => Promise<void>;
-    /** Upload information about the user. */
-    identify: (event: BaseAnalyticsEvent) => Promise<void>;
+  /** Upload a page view event. */page: (event: AnalyticsPageViewEvent) => Promise<void>; /** Upload a custom event. */
+  track: (event: AnalyticsTrackEvent) => Promise<void>; /** Upload information about the user. */
+  identify: (event: BaseAnalyticsEvent) => Promise<void>;
 };
 interface BaseAnalyticsEvent {
-    meta: AnalyticsEventMetadata;
-    user: {
-        id: string;
-        properties: Record<string, string | undefined>;
-    };
+  meta: AnalyticsEventMetadata;
+  user: {
+    id: string;
+    properties: Record<string, string | undefined>;
+  };
 }
 interface AnalyticsEventMetadata {
-    /** Identifier of the session the event was fired from. */
-    sessionId: number | undefined;
-    /** `Date.now()` of when the event was reported. */
-    timestamp: number;
-    /** Ex: `"1920x1080"`. */
-    screen: string | undefined;
-    /** `document.referrer` */
-    referrer: string | undefined;
-    /** `navigator.language` */
-    language: string | undefined;
-    /** `location.href` */
-    url: string | undefined;
-    /** `document.title` */
-    title: string | undefined;
+  /** Identifier of the session the event was fired from. */
+  sessionId: number | undefined;
+  /** `Date.now()` of when the event was reported. */
+  timestamp: number;
+  /** Ex: `"1920x1080"`. */
+  screen: string | undefined;
+  /** `document.referrer` */
+  referrer: string | undefined;
+  /** `navigator.language` */
+  language: string | undefined;
+  /** `location.href` */
+  url: string | undefined;
+  /** `document.title` */
+  title: string | undefined;
 }
 interface AnalyticsPageInfo {
-    url: string;
-    title: string | undefined;
-    location: string | undefined;
+  url: string;
+  title: string | undefined;
+  location: string | undefined;
 }
 interface AnalyticsPageViewEvent extends BaseAnalyticsEvent {
-    page: AnalyticsPageInfo;
+  page: AnalyticsPageInfo;
 }
 interface AnalyticsTrackEvent extends BaseAnalyticsEvent {
-    event: {
-        name: string;
-        properties?: Record<string, string>;
-    };
+  event: {
+    name: string;
+    properties?: Record<string, string>;
+  };
 }
-
-export type { Analytics, AnalyticsConfig, AnalyticsEventMetadata, AnalyticsPageInfo, AnalyticsPageViewEvent, AnalyticsProvider, AnalyticsStorageItem, AnalyticsTrackEvent, BaseAnalyticsEvent };
+//#endregion
+export { Analytics, AnalyticsConfig, AnalyticsEventMetadata, AnalyticsPageInfo, AnalyticsPageViewEvent, AnalyticsProvider, AnalyticsStorageItem, AnalyticsTrackEvent, BaseAnalyticsEvent };

package/dist/types.mjs

@@ -1 +1 @@
-
+export {  };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wxt-dev/analytics",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Add analytics to your web extension",
   "repository": {
     "type": "git",
@@ -35,7 +35,7 @@
     }
   },
   "module": "./dist/index.mjs",
-  "types": "./dist/index.d.ts",
+  "types": "./dist/index.d.mts",
   "files": [
     "dist"
   ],
@@ -43,21 +43,19 @@
     "wxt": ">=0.20.0"
   },
   "devDependencies": {
-    "@aklinker1/check": "^1.4.5",
-    "@types/chrome": "^0.0.280",
     "@types/ua-parser-js": "^0.7.39",
-    "publint": "^0.2.12",
-    "typescript": "^5.6.3",
-    "unbuild": "^3.5.0",
-    "wxt": "0.20.0"
+    "publint": "^0.3.17",
+    "typescript": "^5.9.3",
+    "wxt": "0.20.16"
   },
   "dependencies": {
-    "ua-parser-js": "^1.0.40"
+    "ua-parser-js": "^1.0.40",
+    "@wxt-dev/browser": "^0.1.36"
   },
   "scripts": {
     "dev": "buildc --deps-only -- wxt",
     "dev:build": "buildc --deps-only -- wxt build",
     "check": "pnpm build && check",
-    "build": "buildc -- unbuild"
+    "build": "buildc -- tsdown"
   }
 }

package/dist/background-plugin.d.ts

@@ -1,3 +0,0 @@
-declare const _default: () => void;
-
-export { _default as default };

package/dist/index.d.ts

@@ -1,12 +0,0 @@
-import { AnalyticsConfig, Analytics, AnalyticsProvider } from './types.js';
-
-declare function createAnalytics(config?: AnalyticsConfig): Analytics;
-declare function defineAnalyticsProvider<T = never>(definition: (
-/** The analytics object. */
-analytics: Analytics, 
-/** Config passed into the analytics module from `app.config.ts`. */
-config: AnalyticsConfig, 
-/** Provider options */
-options: T) => ReturnType<AnalyticsProvider>): (options: T) => AnalyticsProvider;
-
-export { createAnalytics, defineAnalyticsProvider };

package/dist/module.d.ts

@@ -1,11 +0,0 @@
-import * as wxt from 'wxt';
-import { AnalyticsConfig } from './types.js';
-
-declare module 'wxt/utils/define-app-config' {
-    interface WxtAppConfig {
-        analytics: AnalyticsConfig;
-    }
-}
-declare const _default: wxt.WxtModule<wxt.WxtModuleOptions>;
-
-export { _default as default };

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

@@ -1,9 +0,0 @@
-import { AnalyticsProvider } from '../types.js';
-
-interface GoogleAnalytics4ProviderOptions {
-    apiSecret: string;
-    measurementId: string;
-}
-declare const googleAnalytics4: (options: GoogleAnalytics4ProviderOptions) => AnalyticsProvider;
-
-export { type GoogleAnalytics4ProviderOptions, googleAnalytics4 };

package/dist/providers/umami.d.ts

@@ -1,10 +0,0 @@
-import { AnalyticsProvider } from '../types.js';
-
-interface UmamiProviderOptions {
-    apiUrl: string;
-    websiteId: string;
-    domain: string;
-}
-declare const umami: (options: UmamiProviderOptions) => AnalyticsProvider;
-
-export { type UmamiProviderOptions, umami };

package/dist/types.d.ts

@@ -1,90 +0,0 @@
-interface Analytics {
-    /** Report a page change. */
-    page: (url: string) => void;
-    /** Report a custom event. */
-    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. */
-    autoTrack: (root: Document | ShadowRoot | Element) => () => void;
-    /** Calls `config.enabled.setValue`. */
-    setEnabled: (enabled: boolean) => void;
-}
-interface AnalyticsConfig {
-    /**
-     * Array of providers to send analytics to.
-     */
-    providers: AnalyticsProvider[];
-    /**
-     * Enable debug logs and other provider-specific debugging features.
-     */
-    debug?: boolean;
-    /**
-     * Your extension's version, reported alongside events.
-     * @default browser.runtime.getManifest().version`.
-     */
-    version?: string;
-    /**
-     * Configure how the enabled flag is persisted. Defaults to using `browser.storage.local`.
-     */
-    enabled?: AnalyticsStorageItem<boolean>;
-    /**
-     * Configure how the user Id is persisted. Defaults to using `browser.storage.local`.
-     */
-    userId?: AnalyticsStorageItem<string>;
-    /**
-     * Configure how user properties are persisted. Defaults to using `browser.storage.local`.
-     */
-    userProperties?: AnalyticsStorageItem<Record<string, string>>;
-}
-interface AnalyticsStorageItem<T> {
-    getValue: () => T | Promise<T>;
-    setValue?: (newValue: T) => void | Promise<void>;
-}
-type AnalyticsProvider = (analytics: Analytics, config: AnalyticsConfig) => {
-    /** Upload a page view event. */
-    page: (event: AnalyticsPageViewEvent) => Promise<void>;
-    /** Upload a custom event. */
-    track: (event: AnalyticsTrackEvent) => Promise<void>;
-    /** Upload information about the user. */
-    identify: (event: BaseAnalyticsEvent) => Promise<void>;
-};
-interface BaseAnalyticsEvent {
-    meta: AnalyticsEventMetadata;
-    user: {
-        id: string;
-        properties: Record<string, string | undefined>;
-    };
-}
-interface AnalyticsEventMetadata {
-    /** Identifier of the session the event was fired from. */
-    sessionId: number | undefined;
-    /** `Date.now()` of when the event was reported. */
-    timestamp: number;
-    /** Ex: `"1920x1080"`. */
-    screen: string | undefined;
-    /** `document.referrer` */
-    referrer: string | undefined;
-    /** `navigator.language` */
-    language: string | undefined;
-    /** `location.href` */
-    url: string | undefined;
-    /** `document.title` */
-    title: string | undefined;
-}
-interface AnalyticsPageInfo {
-    url: string;
-    title: string | undefined;
-    location: string | undefined;
-}
-interface AnalyticsPageViewEvent extends BaseAnalyticsEvent {
-    page: AnalyticsPageInfo;
-}
-interface AnalyticsTrackEvent extends BaseAnalyticsEvent {
-    event: {
-        name: string;
-        properties?: Record<string, string>;
-    };
-}
-
-export type { Analytics, AnalyticsConfig, AnalyticsEventMetadata, AnalyticsPageInfo, AnalyticsPageViewEvent, AnalyticsProvider, AnalyticsStorageItem, AnalyticsTrackEvent, BaseAnalyticsEvent };