qwik-umami 1.0.2 → 1.1.0

package/README.md

@@ -4,12 +4,13 @@
 [![license](https://img.shields.io/npm/l/qwik-umami.svg)](https://github.com/murcisluis/qwik-umami/blob/main/LICENSE)
 [![bundle size](https://img.shields.io/bundlephobia/minzip/qwik-umami)](https://bundlephobia.com/package/qwik-umami)
 
-SSR-safe [Umami Analytics](https://umami.is) integration for [Qwik](https://qwik.dev). Drop-in component + hook for automatic page views and custom event tracking.
+SSR-safe [Umami Analytics](https://umami.is) integration for [Qwik](https://qwik.dev). Drop-in component + utility functions for automatic page views, custom event tracking, and server-side analytics.
 
 - **Zero config** — one component in `root.tsx` and you're tracking
 - **SSR-safe** — no-ops on the server, hydrates on the client
+- **Server-side tracking** — send events from `routeLoader$`, `routeAction$`, or `server$`
 - **Self-hosted ready** — works with Umami Cloud and self-hosted instances
-- **Typed** — full TypeScript support with exported types
+- **Typed** — full TypeScript support, typed against the official Umami API
 - **Lightweight** — no runtime dependencies, just Qwik as peer dep
 
 ## Installation
@@ -46,39 +47,45 @@ export default component$(() => {
 
 That's it. Page views are tracked automatically.
 
-### 2. Track custom events
-
-Use the `useUmamiTrack` hook in any component:
+### 2. Track custom events (client-side)
 
 ```tsx
 import { component$ } from '@builder.io/qwik';
-import { useUmamiTrack } from 'qwik-umami';
+import { umamiTrack } from 'qwik-umami';
 
 export const SignupButton = component$(() => {
-  const { track } = useUmamiTrack();
-
   return (
-    <button onClick$={() => track('signup-click', { plan: 'pro' })}>
+    <button onClick$={() => umamiTrack('signup-click', { plan: 'pro' })}>
       Start free trial
     </button>
   );
 });
 ```
 
-### Self-hosted Umami
+### 3. Track events server-side
+
+Use `serverUmamiTrack` inside `routeLoader$`, `routeAction$`, or `server$`:
 
 ```tsx
-<UmamiScript
-  websiteId="your-website-id"
-  src="https://your-umami-instance.com/script.js"
-/>
+import { routeAction$ } from '@builder.io/qwik-city';
+import { serverUmamiTrack } from 'qwik-umami/server';
+
+const options = {
+  websiteId: import.meta.env.UMAMI_WEBSITE_ID,
+  hostUrl: import.meta.env.UMAMI_HOST_URL,
+};
+
+export const useCheckout = routeAction$(async (data) => {
+  await serverUmamiTrack(options, 'purchase', { plan: data.plan });
+  // ...
+});
 ```
 
 ## API
 
 ### `<UmamiScript>`
 
-Component that loads the Umami tracking script. Checks service availability before loading and handles errors gracefully.
+Component that loads the Umami tracking script. Uses `useTask$` with `isServer` guard to preserve Qwik's resumability model. Loads via `requestIdleCallback` by default to avoid blocking the main thread.
 
 | Prop | Type | Default | Description |
 | --- | --- | --- | --- |
@@ -86,61 +93,218 @@ Component that loads the Umami tracking script. Checks service availability befo
 | `src` | `string` | `https://cloud.umami.is/script.js` | URL of the tracking script |
 | `hostUrl` | `string` | — | Custom host URL for data collection |
 | `autoTrack` | `boolean` | `true` | Enable automatic page view tracking |
-| `domains` | `string` | — | Comma-separated allowed domains |
-| `dataDomains` | `string` | — | Comma-separated data domains |
+| `domains` | `string` | — | Comma-separated list of allowed domains |
+| `tag` | `string` | — | Assign events to a specific tag |
+| `excludeSearch` | `boolean` | — | Exclude URL search parameters from tracking |
+| `excludeHash` | `boolean` | — | Exclude URL hash fragments from tracking |
+| `doNotTrack` | `boolean` | — | Respect the browser's Do Not Track setting |
+| `strategy` | `'eager' \| 'idle'` | `'idle'` | `'idle'` defers loading via `requestIdleCallback`, `'eager'` loads immediately |
 
-### `useUmamiTrack()`
+---
 
-Hook that returns a `track` function for sending custom events.
+### `umamiTrack()`
+
+Client-side utility function. SSR-safe (no-op on server). Import from `'qwik-umami'`.
 
 ```ts
-const { track } = useUmamiTrack();
+// Track a pageview manually
+umamiTrack();
+
+// Track a named event
+umamiTrack('button-click');
 
-// Simple event
-track('button-click');
+// Track an event with data
+umamiTrack('purchase', { plan: 'pro', price: 29 });
 
-// Event with data
-track('purchase', { product: 'plan-pro', price: 29 });
+// Track with a full custom payload
+umamiTrack({ website: 'id', url: '/checkout', title: 'Checkout' });
 ```
 
-**Behavior:**
-- SSR-safe: no-op on the server, works after hydration
-- Silent in production, logs warnings in development if Umami isn't loaded
-- Gracefully handles ad blockers and network failures — no errors, no broken pages
+---
 
-### Types
+### `umamiIdentify()`
+
+Associates the current session with a user or custom data. Client-side only. Import from `'qwik-umami'`.
 
 ```ts
-import type { UmamiConfig, UmamiEventData } from 'qwik-umami';
+// Identify with session data only
+umamiIdentify({ plan: 'pro', role: 'admin' });
+
+// Identify with a unique ID
+umamiIdentify('user-123');
 
-// UmamiConfig — props for <UmamiScript>
-// UmamiEventData — Record<string, string | number | boolean>
+// Identify with a unique ID and data
+umamiIdentify('user-123', { plan: 'pro' });
+```
+
+---
+
+### `serverUmamiTrack()`
+
+Server-side event tracking. Works in `routeLoader$`, `routeAction$`, `server$`. Import from `'qwik-umami/server'`.
+
+```ts
+import { serverUmamiTrack } from 'qwik-umami/server';
+import type { UmamiServerOptions } from 'qwik-umami/server';
+
+const options: UmamiServerOptions = {
+  websiteId: 'your-website-id',
+  hostUrl: 'https://your-umami-instance.com', // or https://cloud.umami.is
+};
+
+// Track a named event
+await serverUmamiTrack(options, 'signup');
+
+// Track with data
+await serverUmamiTrack(options, 'purchase', { plan: 'pro', amount: 29 });
+
+// Track with full payload
+await serverUmamiTrack(options, {
+  url: '/checkout',
+  title: 'Checkout',
+  name: 'page-view',
+});
+```
+
+---
+
+### `createUmamiPlugin()`
+
+Server-side Qwik City plugin for automatic page view tracking. Tracks every page request via the Umami API without requiring the client-side script. Import from `'qwik-umami/server'`. Requires `@builder.io/qwik-city` as peer dependency.
+
+```ts
+// src/routes/plugin@umami.ts
+import { createUmamiPlugin } from 'qwik-umami/server';
+
+export const onRequest = createUmamiPlugin({
+  websiteId: import.meta.env.PUBLIC_UMAMI_ID,
+  hostUrl: import.meta.env.UMAMI_HOST_URL,
+});
+```
+
+| Option | Type | Default | Description |
+| --- | --- | --- | --- |
+| `websiteId` | `string` | **required** | Your Umami website ID |
+| `hostUrl` | `string` | **required** | Umami instance URL |
+| `userAgent` | `string` | request UA | Custom user-agent for tracking requests |
+| `filter` | `(url: URL, headers: Headers) => boolean` | — | Return `false` to skip tracking for specific routes |
+
+**How it works:**
+- Only tracks `GET` requests (skips POST, PUT, DELETE, etc.)
+- Automatically ignores static assets (`.js`, `.css`, `.png`, `.ico`, etc.)
+- Fire-and-forget — the tracking request does NOT block the response
+- Extracts `referrer`, `language`, and `user-agent` from request headers
+
+**Filter example:**
+
+```ts
+export const onRequest = createUmamiPlugin({
+  websiteId: 'your-id',
+  hostUrl: 'https://your-umami.com',
+  filter: (url) => !url.pathname.startsWith('/api/'),
+});
+```
+
+---
+
+### `serverUmamiIdentify()`
+
+Server-side session identification. Import from `'qwik-umami/server'`.
+
+```ts
+import { serverUmamiIdentify } from 'qwik-umami/server';
+
+await serverUmamiIdentify(options, { userId: 'abc', plan: 'pro' });
+```
+
+---
+
+### Types
+
+```ts
+import type {
+  UmamiConfig,        // Props for <UmamiScript>
+  UmamiEventData,     // Record<string, string | number | boolean>
+  UmamiPayload,       // Full browser tracker payload
+} from 'qwik-umami';
+
+import type {
+  UmamiServerOptions,  // { websiteId, hostUrl, userAgent? }
+  UmamiServerPayload,  // Server-side payload shape
+  UmamiPluginOptions,  // { websiteId, hostUrl, userAgent?, filter? }
+} from 'qwik-umami/server';
 ```
 
 ## Real-world example
 
-Tracking a full auth + conversion funnel:
+```tsx
+// Tracking a full auth + conversion funnel
+
+// Landing page CTA (client)
+<button onClick$={() => umamiTrack('cta-click', { location: 'hero' })}>
+  Get started
+</button>
+
+// Auth action (server)
+export const useLogin = routeAction$(async (data) => {
+  const user = await loginUser(data);
+  await serverUmamiTrack(options, 'login', { success: true });
+  return user;
+});
+
+// Identify after login (client)
+umamiIdentify(user.id, { plan: user.plan });
+```
+
+## Self-hosted Umami
 
 ```tsx
-// Landing page CTA
-track('cta-click', { location: 'hero', label: 'get-started' });
+<UmamiScript
+  websiteId="your-website-id"
+  src="https://your-umami-instance.com/script.js"
+/>
+```
 
-// Auth events
-track('login', { success: true });
-track('register', { success: true });
+```ts
+const options = {
+  websiteId: 'your-website-id',
+  hostUrl: 'https://your-umami-instance.com',
+};
+```
 
-// App events
-track('project-create');
-track('project-open', { status: 'ACTIVE' });
-track('chat-message-sent', { hasAttachments: false });
+## Which approach should I use?
+
+| Approach | Best for |
+| --- | --- |
+| **`<UmamiScript>` only** | Most apps — full browser data (screen size, timezone, JS events) |
+| **`createUmamiPlugin` only** | Server-rendered sites, bot tracking, ad-blocker resilience |
+| **Both together** | Maximum coverage — use plugin for page views + component for events |
+
+**Using both together:**
+
+```tsx
+// src/routes/plugin@umami.ts — handles page views server-side
+import { createUmamiPlugin } from 'qwik-umami/server';
+
+export const onRequest = createUmamiPlugin({
+  websiteId: import.meta.env.PUBLIC_UMAMI_ID,
+  hostUrl: import.meta.env.UMAMI_HOST_URL,
+});
+```
+
+```tsx
+// src/root.tsx — handles custom events client-side (autoTrack disabled to avoid duplicate page views)
+<UmamiScript websiteId="your-website-id" autoTrack={false} />
 ```
 
 ## How it works
 
-1. `<UmamiScript>` uses Qwik's `useVisibleTask$` to load the tracker script client-side only
-2. Before injecting the `<script>`, it sends a HEAD request to verify the Umami service is reachable (3s timeout)
-3. If the service is down or blocked, it fails silently — no errors, no broken pages
-4. `useUmamiTrack()` checks for `window.umami` before calling `track()` — safe everywhere
+1. `<UmamiScript>` uses Qwik's `useTask$` with an `isServer` guard — preserves resumability (no eager JS download)
+2. By default, the script loads via `requestIdleCallback` to avoid blocking the main thread
+3. If the script fails to load (blocked by ad blocker, network error), it fails silently and cleans up
+4. `umamiTrack()` and `umamiIdentify()` check for `window.umami` before calling — safe everywhere
+5. `serverUmamiTrack()` and `serverUmamiIdentify()` POST directly to the Umami `/api/send` endpoint — no browser required
+6. `createUmamiPlugin()` intercepts every GET request at the middleware level and sends a page view to Umami — fire-and-forget, never blocks the response
 
 ## License
 

package/lib/index.qwik.cjs

@@ -1,72 +1,99 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const qwik = require("@builder.io/qwik");
-const UmamiScript = qwik.component$(({ websiteId, src = "https://cloud.umami.is/script.js", hostUrl, autoTrack = true, domains, dataDomains }) => {
-  qwik.useVisibleTask$(() => {
+const build = require("@builder.io/qwik/build");
+const UmamiScript = qwik.component$(({ websiteId, src = "https://cloud.umami.is/script.js", hostUrl, autoTrack = true, domains, tag, excludeSearch, excludeHash, doNotTrack, strategy = "idle" }) => {
+  qwik.useTask$(({ cleanup }) => {
+    if (build.isServer) return;
     if (document.querySelector(`script[data-website-id="${websiteId}"]`)) {
       return;
     }
-    const checkAndLoadScript = async () => {
-      try {
-        const controller = new AbortController();
-        const timeoutId = setTimeout(() => controller.abort(), 3e3);
-        await fetch(src, {
-          method: "HEAD",
-          mode: "no-cors",
-          signal: controller.signal
-        });
-        clearTimeout(timeoutId);
-        loadUmamiScript();
-      } catch (error) {
+    let script = null;
+    const loadScript = () => {
+      script = document.createElement("script");
+      script.defer = true;
+      script.src = src;
+      script.setAttribute("data-website-id", websiteId);
+      if (hostUrl) {
+        script.setAttribute("data-host-url", hostUrl);
       }
-    };
-    const loadUmamiScript = () => {
-      try {
-        const script = document.createElement("script");
-        script.defer = true;
-        script.src = src;
-        script.setAttribute("data-website-id", websiteId);
-        if (hostUrl) {
-          script.setAttribute("data-host-url", hostUrl);
-        }
-        if (!autoTrack) {
-          script.setAttribute("data-auto-track", "false");
-        }
-        if (domains) {
-          script.setAttribute("data-domains", domains);
-        }
-        if (dataDomains) {
-          script.setAttribute("data-data-domains", dataDomains);
-        }
-        script.onerror = () => {
-          if (false) ;
-          script.remove();
-        };
-        script.onload = () => {
-          if (false) ;
-        };
-        document.head.appendChild(script);
-      } catch (error) {
+      if (!autoTrack) {
+        script.setAttribute("data-auto-track", "false");
+      }
+      if (domains) {
+        script.setAttribute("data-domains", domains);
+      }
+      if (tag) {
+        script.setAttribute("data-tag", tag);
+      }
+      if (excludeSearch) {
+        script.setAttribute("data-exclude-search", "true");
+      }
+      if (excludeHash) {
+        script.setAttribute("data-exclude-hash", "true");
+      }
+      if (doNotTrack) {
+        script.setAttribute("data-do-not-track", "true");
       }
+      script.onerror = () => {
+        script?.remove();
+        script = null;
+      };
+      document.head.appendChild(script);
     };
-    checkAndLoadScript();
+    if (strategy === "eager") {
+      loadScript();
+    } else {
+      if ("requestIdleCallback" in window) {
+        const id = window.requestIdleCallback(loadScript);
+        cleanup(() => {
+          window.cancelIdleCallback(id);
+          script?.remove();
+        });
+        return;
+      }
+      const timeoutId = setTimeout(loadScript, 0);
+      cleanup(() => {
+        clearTimeout(timeoutId);
+        script?.remove();
+      });
+      return;
+    }
+    cleanup(() => {
+      script?.remove();
+    });
   });
   return null;
 });
-const useUmamiTrack = () => {
-  const store = qwik.useStore({
-    track: qwik.$(function(eventName, eventData) {
-      if (typeof window === "undefined") return;
-      try {
-        if (window.umami?.track) {
-          window.umami.track(eventName, eventData);
-        } else if (false) ;
-      } catch (error) {
+function umamiTrack(eventNameOrPayload, data) {
+  if (typeof window === "undefined") return;
+  try {
+    if (window.umami?.track) {
+      if (eventNameOrPayload === void 0) {
+        window.umami.track();
+      } else if (typeof eventNameOrPayload === "string") {
+        window.umami.track(eventNameOrPayload, data);
+      } else {
+        window.umami.track(eventNameOrPayload);
       }
-    })
-  });
-  return store;
-};
+    } else if (false) ;
+  } catch (error) {
+  }
+}
+function umamiIdentify(uniqueIdOrData, data) {
+  if (typeof window === "undefined") return;
+  try {
+    if (window.umami?.identify) {
+      if (typeof uniqueIdOrData === "string") {
+        window.umami.identify(uniqueIdOrData, data);
+      } else {
+        window.umami.identify(uniqueIdOrData);
+      }
+    } else if (false) ;
+  } catch (error) {
+  }
+}
 exports.UmamiScript = UmamiScript;
-exports.useUmamiTrack = useUmamiTrack;
+exports.umamiIdentify = umamiIdentify;
+exports.umamiTrack = umamiTrack;
 //# sourceMappingURL=index.qwik.cjs.map

package/lib/index.qwik.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.qwik.cjs","sources":["../src/components/umami-script.tsx","../src/hooks/use-umami-track.ts"],"sourcesContent":["import { component$, useVisibleTask$ } from '@builder.io/qwik';\r\nimport type { UmamiConfig } from '../types';\r\n\r\nexport const UmamiScript = component$<UmamiConfig>(\r\n  ({\r\n    websiteId,\r\n    src = 'https://cloud.umami.is/script.js',\r\n    hostUrl,\r\n    autoTrack = true,\r\n    domains,\r\n    dataDomains,\r\n  }) => {\r\n    // eslint-disable-next-line qwik/no-use-visible-task\r\n    useVisibleTask$(() => {\r\n      if (document.querySelector(`script[data-website-id=\"${websiteId}\"]`)) {\r\n        return;\r\n      }\r\n\r\n      const checkAndLoadScript = async () => {\r\n        try {\r\n          const controller = new AbortController();\r\n          const timeoutId = setTimeout(() => controller.abort(), 3000);\r\n\r\n          await fetch(src, {\r\n            method: 'HEAD',\r\n            mode: 'no-cors',\r\n            signal: controller.signal,\r\n          });\r\n\r\n          clearTimeout(timeoutId);\r\n          loadUmamiScript();\r\n        } catch (error) {\r\n          if (import.meta.env.DEV) {\r\n            console.warn(\r\n              '[qwik-umami] Service unavailable, tracking temporarily disabled',\r\n              error,\r\n            );\r\n          }\r\n        }\r\n      };\r\n\r\n      const loadUmamiScript = () => {\r\n        try {\r\n          const script = document.createElement('script');\r\n          script.defer = true;\r\n          script.src = src;\r\n          script.setAttribute('data-website-id', websiteId);\r\n\r\n          if (hostUrl) {\r\n            script.setAttribute('data-host-url', hostUrl);\r\n          }\r\n\r\n          if (!autoTrack) {\r\n            script.setAttribute('data-auto-track', 'false');\r\n          }\r\n\r\n          if (domains) {\r\n            script.setAttribute('data-domains', domains);\r\n          }\r\n\r\n          if (dataDomains) {\r\n            script.setAttribute('data-data-domains', dataDomains);\r\n          }\r\n\r\n          script.onerror = () => {\r\n            if (import.meta.env.DEV) {\r\n              console.warn('[qwik-umami] Failed to load script');\r\n            }\r\n            script.remove();\r\n          };\r\n\r\n          script.onload = () => {\r\n            if (import.meta.env.DEV) {\r\n              console.log('[qwik-umami] Script loaded successfully');\r\n            }\r\n          };\r\n\r\n          document.head.appendChild(script);\r\n        } catch (error) {\r\n          if (import.meta.env.DEV) {\r\n            console.warn('[qwik-umami] Initialization error:', error);\r\n          }\r\n        }\r\n      };\r\n\r\n      checkAndLoadScript();\r\n    });\r\n\r\n    return null;\r\n  },\r\n);\r\n","import { $, useStore } from '@builder.io/qwik';\r\nimport type { UmamiEventData } from '../types';\r\n\r\nexport const useUmamiTrack = () => {\r\n  const store = useStore({\r\n    track: $(function (eventName: string, eventData?: UmamiEventData) {\r\n      if (typeof window === 'undefined') return;\r\n      try {\r\n        if (window.umami?.track) {\r\n          window.umami.track(eventName, eventData);\r\n        } else if (import.meta.env.DEV) {\r\n          console.warn('[qwik-umami] Tracking unavailable for event:', eventName);\r\n        }\r\n      } catch (error) {\r\n        if (import.meta.env.DEV) {\r\n          console.warn('[qwik-umami] Error sending event:', eventName, error);\r\n        }\r\n      }\r\n    }),\r\n  });\r\n\r\n  return store;\r\n};\r\n"],"names":["component$","useVisibleTask$","useStore","$"],"mappings":";;;AAGO,MAAM,cAAcA,KAAAA,WACzB,CAAC,EACC,WACA,MAAM,oCACN,SACA,YAAY,MACZ,SACA,YAAA,MACD;AAECC,OAAAA,gBAAgB,MAAA;AACd,QAAI,SAAS,cAAc,2BAA2B,SAAA,IAAa,GAAG;AACpE;AAAA,IACF;AAEA,UAAM,qBAAqB,YAAA;AACzB,UAAI;AACF,cAAM,aAAa,IAAI,gBAAA;AACvB,cAAM,YAAY,WAAW,MAAM,WAAW,MAAA,GAAS,GAAA;AAEvD,cAAM,MAAM,KAAK;AAAA,UACf,QAAQ;AAAA,UACR,MAAM;AAAA,UACN,QAAQ,WAAW;AAAA,QAAA,CACrB;AAEA,qBAAa,SAAA;AACb,wBAAA;AAAA,MACF,SAAS,OAAO;AAAA,MAOhB;AAAA,IACF;AAEA,UAAM,kBAAkB,MAAA;AACtB,UAAI;AACF,cAAM,SAAS,SAAS,cAAc,QAAA;AACtC,eAAO,QAAQ;AACf,eAAO,MAAM;AACb,eAAO,aAAa,mBAAmB,SAAA;AAEvC,YAAI,SAAS;AACX,iBAAO,aAAa,iBAAiB,OAAA;AAAA,QACvC;AAEA,YAAI,CAAC,WAAW;AACd,iBAAO,aAAa,mBAAmB,OAAA;AAAA,QACzC;AAEA,YAAI,SAAS;AACX,iBAAO,aAAa,gBAAgB,OAAA;AAAA,QACtC;AAEA,YAAI,aAAa;AACf,iBAAO,aAAa,qBAAqB,WAAA;AAAA,QAC3C;AAEA,eAAO,UAAU,MAAA;AACf,cAAI,MAAqB;AAGzB,iBAAO,OAAA;AAAA,QACT;AAEA,eAAO,SAAS,MAAA;AACd,cAAI,MAAqB;AAAA,QAG3B;AAEA,iBAAS,KAAK,YAAY,MAAA;AAAA,MAC5B,SAAS,OAAO;AAAA,MAIhB;AAAA,IACF;AAEA,uBAAA;AAAA,EACF,CAAA;AAEA,SAAO;AACT,CAAA;ACtFK,MAAM,gBAAgB,MAAA;AAC3B,QAAM,QAAQC,KAAAA,SAAS;AAAA,IACrB,OAAOC,KAAAA,EAAE,SAAU,WAAmB,WAA0B;AAC9D,UAAI,OAAO,WAAW,YAAa;AACnC,UAAI;AACF,YAAI,OAAO,OAAO,OAAO;AACvB,iBAAO,MAAM,MAAM,WAAW,SAAA;AAAA,QAChC,WAAW,MAAqB;AAAA,MAGlC,SAAS,OAAO;AAAA,MAIhB;AAAA,IACF,CAAA;AAAA,EAAA,CACF;AAEA,SAAO;AACT;;;"}
+{"version":3,"file":"index.qwik.cjs","sources":["../src/components/umami-script.tsx","../src/utils/track.ts"],"sourcesContent":["import { component$, useTask$ } from '@builder.io/qwik';\nimport { isServer } from '@builder.io/qwik/build';\nimport type { UmamiConfig } from '../types';\n\nexport const UmamiScript = component$<UmamiConfig>(\n  ({\n    websiteId,\n    src = 'https://cloud.umami.is/script.js',\n    hostUrl,\n    autoTrack = true,\n    domains,\n    tag,\n    excludeSearch,\n    excludeHash,\n    doNotTrack,\n    strategy = 'idle',\n  }) => {\n    useTask$(({ cleanup }) => {\n      if (isServer) return;\n\n      if (document.querySelector(`script[data-website-id=\"${websiteId}\"]`)) {\n        return;\n      }\n\n      let script: HTMLScriptElement | null = null;\n\n      const loadScript = () => {\n        script = document.createElement('script');\n        script.defer = true;\n        script.src = src;\n        script.setAttribute('data-website-id', websiteId);\n\n        if (hostUrl) {\n          script.setAttribute('data-host-url', hostUrl);\n        }\n\n        if (!autoTrack) {\n          script.setAttribute('data-auto-track', 'false');\n        }\n\n        if (domains) {\n          script.setAttribute('data-domains', domains);\n        }\n\n        if (tag) {\n          script.setAttribute('data-tag', tag);\n        }\n\n        if (excludeSearch) {\n          script.setAttribute('data-exclude-search', 'true');\n        }\n\n        if (excludeHash) {\n          script.setAttribute('data-exclude-hash', 'true');\n        }\n\n        if (doNotTrack) {\n          script.setAttribute('data-do-not-track', 'true');\n        }\n\n        script.onerror = () => {\n          if (import.meta.env.DEV) {\n            console.warn('[qwik-umami] Failed to load script');\n          }\n          script?.remove();\n          script = null;\n        };\n\n        if (import.meta.env.DEV) {\n          script.onload = () => {\n            console.log('[qwik-umami] Script loaded successfully');\n          };\n        }\n\n        document.head.appendChild(script);\n      };\n\n      if (strategy === 'eager') {\n        loadScript();\n      } else {\n        if ('requestIdleCallback' in window) {\n          const id = window.requestIdleCallback(loadScript);\n          cleanup(() => {\n            window.cancelIdleCallback(id);\n            script?.remove();\n          });\n          return;\n        }\n        const timeoutId = setTimeout(loadScript, 0);\n        cleanup(() => {\n          clearTimeout(timeoutId);\n          script?.remove();\n        });\n        return;\n      }\n\n      cleanup(() => {\n        script?.remove();\n      });\n    });\n\n    return null;\n  },\n);\n","import type { UmamiEventData, UmamiPayload } from '../types';\r\n\r\nexport function umamiTrack(): void;\r\nexport function umamiTrack(payload: UmamiPayload): void;\r\nexport function umamiTrack(eventName: string): void;\r\nexport function umamiTrack(eventName: string, data: UmamiEventData): void;\r\nexport function umamiTrack(\r\n  eventNameOrPayload?: string | UmamiPayload,\r\n  data?: UmamiEventData,\r\n): void {\r\n  if (typeof window === 'undefined') return;\r\n\r\n  try {\r\n    if (window.umami?.track) {\r\n      if (eventNameOrPayload === undefined) {\r\n        window.umami.track();\r\n      } else if (typeof eventNameOrPayload === 'string') {\r\n        window.umami.track(eventNameOrPayload, data!);\r\n      } else {\r\n        window.umami.track(eventNameOrPayload);\r\n      }\r\n    } else if (import.meta.env.DEV) {\r\n      console.warn('[qwik-umami] Tracking unavailable');\r\n    }\r\n  } catch (error) {\r\n    if (import.meta.env.DEV) {\r\n      console.warn('[qwik-umami] Error sending event:', eventNameOrPayload, error);\r\n    }\r\n  }\r\n}\r\n\r\nexport function umamiIdentify(data: UmamiEventData): void;\r\nexport function umamiIdentify(uniqueId: string): void;\r\nexport function umamiIdentify(uniqueId: string, data: UmamiEventData): void;\r\nexport function umamiIdentify(\r\n  uniqueIdOrData: string | UmamiEventData,\r\n  data?: UmamiEventData,\r\n): void {\r\n  if (typeof window === 'undefined') return;\r\n\r\n  try {\r\n    if (window.umami?.identify) {\r\n      if (typeof uniqueIdOrData === 'string') {\r\n        window.umami.identify(uniqueIdOrData, data!);\r\n      } else {\r\n        window.umami.identify(uniqueIdOrData);\r\n      }\r\n    } else if (import.meta.env.DEV) {\r\n      console.warn('[qwik-umami] Identify unavailable');\r\n    }\r\n  } catch (error) {\r\n    if (import.meta.env.DEV) {\r\n      console.warn('[qwik-umami] Error identifying:', error);\r\n    }\r\n  }\r\n}\r\n"],"names":["component$","useTask$","isServer"],"mappings":";;;;AAIO,MAAM,cAAcA,KAAAA,WACzB,CAAC,EACC,WACA,MAAM,oCACN,SACA,YAAY,MACZ,SACA,KACA,eACA,aACA,YACA,WAAW,aACZ;AACCC,gBAAS,CAAC,EAAE,cAAS;AACnB,QAAIC,eAAU;AAEd,QAAI,SAAS,cAAc,2BAA2B,SAAA,IAAa,GAAG;AACpE;AAAA,IACF;AAEA,QAAI,SAAmC;AAEvC,UAAM,aAAa,MAAA;AACjB,eAAS,SAAS,cAAc,QAAA;AAChC,aAAO,QAAQ;AACf,aAAO,MAAM;AACb,aAAO,aAAa,mBAAmB,SAAA;AAEvC,UAAI,SAAS;AACX,eAAO,aAAa,iBAAiB,OAAA;AAAA,MACvC;AAEA,UAAI,CAAC,WAAW;AACd,eAAO,aAAa,mBAAmB,OAAA;AAAA,MACzC;AAEA,UAAI,SAAS;AACX,eAAO,aAAa,gBAAgB,OAAA;AAAA,MACtC;AAEA,UAAI,KAAK;AACP,eAAO,aAAa,YAAY,GAAA;AAAA,MAClC;AAEA,UAAI,eAAe;AACjB,eAAO,aAAa,uBAAuB,MAAA;AAAA,MAC7C;AAEA,UAAI,aAAa;AACf,eAAO,aAAa,qBAAqB,MAAA;AAAA,MAC3C;AAEA,UAAI,YAAY;AACd,eAAO,aAAa,qBAAqB,MAAA;AAAA,MAC3C;AAEA,aAAO,UAAU,MAAA;AAIf,gBAAQ,OAAA;AACR,iBAAS;AAAA,MACX;AAQA,eAAS,KAAK,YAAY,MAAA;AAAA,IAC5B;AAEA,QAAI,aAAa,SAAS;AACxB,iBAAA;AAAA,IACF,OAAO;AACL,UAAI,yBAAyB,QAAQ;AACnC,cAAM,KAAK,OAAO,oBAAoB,UAAA;AACtC,gBAAQ,MAAA;AACN,iBAAO,mBAAmB,EAAA;AAC1B,kBAAQ,OAAA;AAAA,QACV,CAAA;AACA;AAAA,MACF;AACA,YAAM,YAAY,WAAW,YAAY,CAAA;AACzC,cAAQ,MAAA;AACN,qBAAa,SAAA;AACb,gBAAQ,OAAA;AAAA,MACV,CAAA;AACA;AAAA,IACF;AAEA,YAAQ,MAAA;AACN,cAAQ,OAAA;AAAA,IACV,CAAA;AAAA,EACF,CAAA;AAEA,SAAO;AACT,CAAA;AChGK,SAAS,WACd,oBACA,MAAqB;AAErB,MAAI,OAAO,WAAW,YAAa;AAEnC,MAAI;AACF,QAAI,OAAO,OAAO,OAAO;AACvB,UAAI,uBAAuB,QAAW;AACpC,eAAO,MAAM,MAAA;AAAA,MACf,WAAW,OAAO,uBAAuB,UAAU;AACjD,eAAO,MAAM,MAAM,oBAAoB,IAAA;AAAA,MACzC,OAAO;AACL,eAAO,MAAM,MAAM,kBAAA;AAAA,MACrB;AAAA,IACF,WAAW,MAAqB;AAAA,EAGlC,SAAS,OAAO;AAAA,EAIhB;AACF;AAKO,SAAS,cACd,gBACA,MAAqB;AAErB,MAAI,OAAO,WAAW,YAAa;AAEnC,MAAI;AACF,QAAI,OAAO,OAAO,UAAU;AAC1B,UAAI,OAAO,mBAAmB,UAAU;AACtC,eAAO,MAAM,SAAS,gBAAgB,IAAA;AAAA,MACxC,OAAO;AACL,eAAO,MAAM,SAAS,cAAA;AAAA,MACxB;AAAA,IACF,WAAW,MAAqB;AAAA,EAGlC,SAAS,OAAO;AAAA,EAIhB;AACF;;;;"}