qwik-umami 1.0.3 → 1.1.1

package/README.md

@@ -85,7 +85,7 @@ export const useCheckout = routeAction$(async (data) => {
 
 ### `<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 `useVisibleTask$` for guaranteed one-shot client initialization. Loads via `requestIdleCallback` by default (`strategy: 'idle'`) to avoid blocking the main thread.
 
 | Prop | Type | Default | Description |
 | --- | --- | --- | --- |
@@ -98,6 +98,7 @@ Component that loads the Umami tracking script. Checks service availability befo
 | `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 |
 
 ---
 
@@ -167,6 +168,45 @@ await serverUmamiTrack(options, {
 
 ---
 
+### `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'`.
@@ -189,8 +229,9 @@ import type {
 } from 'qwik-umami';
 
 import type {
-  UmamiServerOptions, // { websiteId, hostUrl, userAgent? }
-  UmamiServerPayload, // Server-side payload shape
+  UmamiServerOptions,  // { websiteId, hostUrl, userAgent? }
+  UmamiServerPayload,  // Server-side payload shape
+  UmamiPluginOptions,  // { websiteId, hostUrl, userAgent?, filter? }
 } from 'qwik-umami/server';
 ```
 
@@ -231,13 +272,39 @@ const options = {
 };
 ```
 
+## 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 Umami is reachable (3s timeout)
-3. If the service is down or blocked, it fails silently — no errors, no broken pages
+1. `<UmamiScript>` uses Qwik's `useVisibleTask$` for guaranteed one-shot client initialization
+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,64 +1,65 @@
 "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, tag, excludeSearch, excludeHash, doNotTrack }) => {
-  qwik.useVisibleTask$(() => {
+const UmamiScript = qwik.component$(({ websiteId, src = "https://cloud.umami.is/script.js", hostUrl, autoTrack = true, domains, tag, excludeSearch, excludeHash, doNotTrack, strategy = "idle" }) => {
+  qwik.useVisibleTask$(({ cleanup }) => {
     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 (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 = () => {
-          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;
 });

package/lib/index.qwik.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.qwik.cjs","sources":["../src/components/umami-script.tsx","../src/utils/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    tag,\r\n    excludeSearch,\r\n    excludeHash,\r\n    doNotTrack,\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 (tag) {\r\n            script.setAttribute('data-tag', tag);\r\n          }\r\n\r\n          if (excludeSearch) {\r\n            script.setAttribute('data-exclude-search', 'true');\r\n          }\r\n\r\n          if (excludeHash) {\r\n            script.setAttribute('data-exclude-hash', 'true');\r\n          }\r\n\r\n          if (doNotTrack) {\r\n            script.setAttribute('data-do-not-track', 'true');\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 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$","useVisibleTask$"],"mappings":";;;AAGO,MAAM,cAAcA,KAAAA,WACzB,CAAC,EACC,WACA,MAAM,oCACN,SACA,YAAY,MACZ,SACA,KACA,eACA,aACA,iBACD;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,KAAK;AACP,iBAAO,aAAa,YAAY,GAAA;AAAA,QAClC;AAEA,YAAI,eAAe;AACjB,iBAAO,aAAa,uBAAuB,MAAA;AAAA,QAC7C;AAEA,YAAI,aAAa;AACf,iBAAO,aAAa,qBAAqB,MAAA;AAAA,QAC3C;AAEA,YAAI,YAAY;AACd,iBAAO,aAAa,qBAAqB,MAAA;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;AClGK,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;;;;"}
+{"version":3,"file":"index.qwik.cjs","sources":["../src/components/umami-script.tsx","../src/utils/track.ts"],"sourcesContent":["import { component$, useVisibleTask$ } from '@builder.io/qwik';\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    // eslint-disable-next-line qwik/no-use-visible-task\n    useVisibleTask$(({ cleanup }) => {\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$","useVisibleTask$"],"mappings":";;;AAGO,MAAM,cAAcA,KAAAA,WACzB,CAAC,EACC,WACA,MAAM,oCACN,SACA,YAAY,MACZ,SACA,KACA,eACA,aACA,YACA,WAAW,aACZ;AAECC,uBAAgB,CAAC,EAAE,cAAS;AAC1B,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;AC9FK,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;;;;"}

package/lib/index.qwik.mjs

@@ -1,62 +1,63 @@
 import { component$, useVisibleTask$ } from "@builder.io/qwik";
-const UmamiScript = component$(({ websiteId, src = "https://cloud.umami.is/script.js", hostUrl, autoTrack = true, domains, tag, excludeSearch, excludeHash, doNotTrack }) => {
-  useVisibleTask$(() => {
+const UmamiScript = component$(({ websiteId, src = "https://cloud.umami.is/script.js", hostUrl, autoTrack = true, domains, tag, excludeSearch, excludeHash, doNotTrack, strategy = "idle" }) => {
+  useVisibleTask$(({ cleanup }) => {
     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 (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 = () => {
-          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;
 });

package/lib/index.qwik.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.qwik.mjs","sources":["../src/components/umami-script.tsx","../src/utils/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    tag,\r\n    excludeSearch,\r\n    excludeHash,\r\n    doNotTrack,\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 (tag) {\r\n            script.setAttribute('data-tag', tag);\r\n          }\r\n\r\n          if (excludeSearch) {\r\n            script.setAttribute('data-exclude-search', 'true');\r\n          }\r\n\r\n          if (excludeHash) {\r\n            script.setAttribute('data-exclude-hash', 'true');\r\n          }\r\n\r\n          if (doNotTrack) {\r\n            script.setAttribute('data-do-not-track', 'true');\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 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":[],"mappings":";AAGO,MAAM,cAAc,WACzB,CAAC,EACC,WACA,MAAM,oCACN,SACA,YAAY,MACZ,SACA,KACA,eACA,aACA,iBACD;AAEC,kBAAgB,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,KAAK;AACP,iBAAO,aAAa,YAAY,GAAA;AAAA,QAClC;AAEA,YAAI,eAAe;AACjB,iBAAO,aAAa,uBAAuB,MAAA;AAAA,QAC7C;AAEA,YAAI,aAAa;AACf,iBAAO,aAAa,qBAAqB,MAAA;AAAA,QAC3C;AAEA,YAAI,YAAY;AACd,iBAAO,aAAa,qBAAqB,MAAA;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;AClGK,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;"}
+{"version":3,"file":"index.qwik.mjs","sources":["../src/components/umami-script.tsx","../src/utils/track.ts"],"sourcesContent":["import { component$, useVisibleTask$ } from '@builder.io/qwik';\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    // eslint-disable-next-line qwik/no-use-visible-task\n    useVisibleTask$(({ cleanup }) => {\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":[],"mappings":";AAGO,MAAM,cAAc,WACzB,CAAC,EACC,WACA,MAAM,oCACN,SACA,YAAY,MACZ,SACA,KACA,eACA,aACA,YACA,WAAW,aACZ;AAEC,kBAAgB,CAAC,EAAE,cAAS;AAC1B,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;AC9FK,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;"}

package/lib/server.cjs

@@ -33,6 +33,28 @@ async function serverUmamiIdentify(options, data) {
     data
   }, "identify");
 }
+const IGNORED_EXTENSIONS = /\.(js|css|ico|png|jpg|jpeg|gif|svg|webp|woff2?|ttf|eot|map|json)$/;
+function createUmamiPlugin(options) {
+  return async ({ url, headers, method }) => {
+    if (method !== "GET") return;
+    if (IGNORED_EXTENSIONS.test(url.pathname)) return;
+    if (options.filter && !options.filter(url, headers)) return;
+    const language = headers.get("accept-language")?.split(",")[0];
+    const referrer = headers.get("referer") || void 0;
+    const userAgent = headers.get("user-agent") || void 0;
+    serverUmamiTrack({
+      websiteId: options.websiteId,
+      hostUrl: options.hostUrl,
+      userAgent: userAgent || options.userAgent
+    }, {
+      url: url.pathname + url.search,
+      referrer,
+      language: language || void 0
+    }).catch(() => {
+    });
+  };
+}
+exports.createUmamiPlugin = createUmamiPlugin;
 exports.serverUmamiIdentify = serverUmamiIdentify;
 exports.serverUmamiTrack = serverUmamiTrack;
 //# sourceMappingURL=server.cjs.map

package/lib/server.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"server.cjs","sources":["../src/server/umami-server.ts"],"sourcesContent":["import type { UmamiEventData, UmamiServerOptions, UmamiServerPayload } from '../types';\r\n\r\nconst UMAMI_VERSION = '2.0.0';\r\nconst DEFAULT_USER_AGENT = `Mozilla/5.0 (compatible; qwik-umami/${UMAMI_VERSION})`;\r\n\r\nasync function send(\r\n  options: UmamiServerOptions,\r\n  payload: UmamiServerPayload,\r\n  type: 'event' | 'identify' = 'event',\r\n): Promise<Response> {\r\n  const { hostUrl, websiteId, userAgent = DEFAULT_USER_AGENT } = options;\r\n\r\n  return fetch(`${hostUrl}/api/send`, {\r\n    method: 'POST',\r\n    headers: {\r\n      'Content-Type': 'application/json',\r\n      'User-Agent': userAgent,\r\n    },\r\n    body: JSON.stringify({\r\n      type,\r\n      payload: { website: websiteId, ...payload },\r\n    }),\r\n  });\r\n}\r\n\r\nexport async function serverUmamiTrack(\r\n  options: UmamiServerOptions,\r\n  event: string | UmamiServerPayload,\r\n  data?: UmamiEventData,\r\n): Promise<Response> {\r\n  if (typeof event === 'string') {\r\n    return send(options, { name: event, data });\r\n  }\r\n  return send(options, event);\r\n}\r\n\r\nexport async function serverUmamiIdentify(\r\n  options: UmamiServerOptions,\r\n  data: UmamiEventData,\r\n): Promise<Response> {\r\n  return send(options, { data }, 'identify');\r\n}\r\n"],"names":[],"mappings":";;AAEA,MAAM,gBAAgB;AACtB,MAAM,qBAAqB,uCAAuC,aAAA;AAElE,eAAe,KACb,SACA,SACA,OAA6B,SAAO;AAEpC,QAAM,EAAE,SAAS,WAAW,YAAY,uBAAuB;AAE/D,SAAO,MAAM,GAAG,OAAA,aAAoB;AAAA,IAClC,QAAQ;AAAA,IACR,SAAS;AAAA,MACP,gBAAgB;AAAA,MAChB,cAAc;AAAA,IAAA;AAAA,IAEhB,MAAM,KAAK,UAAU;AAAA,MACnB;AAAA,MACA,SAAS;AAAA,QAAE,SAAS;AAAA,QAAW,GAAG;AAAA,MAAA;AAAA,IAAQ,CAC5C;AAAA,EAAA,CACF;AACF;AAEA,eAAsB,iBACpB,SACA,OACA,MAAqB;AAErB,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,KAAK,SAAS;AAAA,MAAE,MAAM;AAAA,MAAO;AAAA,IAAA,CAAK;AAAA,EAC3C;AACA,SAAO,KAAK,SAAS,KAAA;AACvB;AAEA,eAAsB,oBACpB,SACA,MAAoB;AAEpB,SAAO,KAAK,SAAS;AAAA,IAAE;AAAA,EAAA,GAAQ,UAAA;AACjC;;;"}
+{"version":3,"file":"server.cjs","sources":["../src/server/umami-server.ts","../src/server/umami-plugin.ts"],"sourcesContent":["import type { UmamiEventData, UmamiServerOptions, UmamiServerPayload } from '../types';\r\n\r\nconst UMAMI_VERSION = '2.0.0';\r\nconst DEFAULT_USER_AGENT = `Mozilla/5.0 (compatible; qwik-umami/${UMAMI_VERSION})`;\r\n\r\nasync function send(\r\n  options: UmamiServerOptions,\r\n  payload: UmamiServerPayload,\r\n  type: 'event' | 'identify' = 'event',\r\n): Promise<Response> {\r\n  const { hostUrl, websiteId, userAgent = DEFAULT_USER_AGENT } = options;\r\n\r\n  return fetch(`${hostUrl}/api/send`, {\r\n    method: 'POST',\r\n    headers: {\r\n      'Content-Type': 'application/json',\r\n      'User-Agent': userAgent,\r\n    },\r\n    body: JSON.stringify({\r\n      type,\r\n      payload: { website: websiteId, ...payload },\r\n    }),\r\n  });\r\n}\r\n\r\nexport async function serverUmamiTrack(\r\n  options: UmamiServerOptions,\r\n  event: string | UmamiServerPayload,\r\n  data?: UmamiEventData,\r\n): Promise<Response> {\r\n  if (typeof event === 'string') {\r\n    return send(options, { name: event, data });\r\n  }\r\n  return send(options, event);\r\n}\r\n\r\nexport async function serverUmamiIdentify(\r\n  options: UmamiServerOptions,\r\n  data: UmamiEventData,\r\n): Promise<Response> {\r\n  return send(options, { data }, 'identify');\r\n}\r\n","import type { RequestHandler } from '@builder.io/qwik-city';\nimport type { UmamiPluginOptions } from '../types';\nimport { serverUmamiTrack } from './umami-server';\n\nconst IGNORED_EXTENSIONS =\n  /\\.(js|css|ico|png|jpg|jpeg|gif|svg|webp|woff2?|ttf|eot|map|json)$/;\n\nexport function createUmamiPlugin(options: UmamiPluginOptions): RequestHandler {\n  return async ({ url, headers, method }) => {\n    if (method !== 'GET') return;\n    if (IGNORED_EXTENSIONS.test(url.pathname)) return;\n\n    if (options.filter && !options.filter(url, headers)) return;\n\n    const language = headers.get('accept-language')?.split(',')[0];\n    const referrer = headers.get('referer') || undefined;\n    const userAgent = headers.get('user-agent') || undefined;\n\n    serverUmamiTrack(\n      {\n        websiteId: options.websiteId,\n        hostUrl: options.hostUrl,\n        userAgent: userAgent || options.userAgent,\n      },\n      {\n        url: url.pathname + url.search,\n        referrer,\n        language: language || undefined,\n      },\n    ).catch(() => {});\n  };\n}\n"],"names":[],"mappings":";;AAEA,MAAM,gBAAgB;AACtB,MAAM,qBAAqB,uCAAuC,aAAA;AAElE,eAAe,KACb,SACA,SACA,OAA6B,SAAO;AAEpC,QAAM,EAAE,SAAS,WAAW,YAAY,uBAAuB;AAE/D,SAAO,MAAM,GAAG,OAAA,aAAoB;AAAA,IAClC,QAAQ;AAAA,IACR,SAAS;AAAA,MACP,gBAAgB;AAAA,MAChB,cAAc;AAAA,IAAA;AAAA,IAEhB,MAAM,KAAK,UAAU;AAAA,MACnB;AAAA,MACA,SAAS;AAAA,QAAE,SAAS;AAAA,QAAW,GAAG;AAAA,MAAA;AAAA,IAAQ,CAC5C;AAAA,EAAA,CACF;AACF;AAEA,eAAsB,iBACpB,SACA,OACA,MAAqB;AAErB,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,KAAK,SAAS;AAAA,MAAE,MAAM;AAAA,MAAO;AAAA,IAAA,CAAK;AAAA,EAC3C;AACA,SAAO,KAAK,SAAS,KAAA;AACvB;AAEA,eAAsB,oBACpB,SACA,MAAoB;AAEpB,SAAO,KAAK,SAAS;AAAA,IAAE;AAAA,EAAA,GAAQ,UAAA;AACjC;ACrCA,MAAM,qBACJ;AAEK,SAAS,kBAAkB,SAA2B;AAC3D,SAAO,OAAO,EAAE,KAAK,SAAS,aAAQ;AACpC,QAAI,WAAW,MAAO;AACtB,QAAI,mBAAmB,KAAK,IAAI,QAAQ,EAAG;AAE3C,QAAI,QAAQ,UAAU,CAAC,QAAQ,OAAO,KAAK,OAAA,EAAU;AAErD,UAAM,WAAW,QAAQ,IAAI,oBAAoB,MAAM,GAAA,EAAK,CAAA;AAC5D,UAAM,WAAW,QAAQ,IAAI,SAAA,KAAc;AAC3C,UAAM,YAAY,QAAQ,IAAI,YAAA,KAAiB;AAE/C,qBACE;AAAA,MACE,WAAW,QAAQ;AAAA,MACnB,SAAS,QAAQ;AAAA,MACjB,WAAW,aAAa,QAAQ;AAAA,IAAA,GAElC;AAAA,MACE,KAAK,IAAI,WAAW,IAAI;AAAA,MACxB;AAAA,MACA,UAAU,YAAY;AAAA,IAAA,CACxB,EACA,MAAM,MAAA;AAAA,IAAO,CAAA;AAAA,EACjB;AACF;;;;"}

package/lib/server.mjs

@@ -31,7 +31,29 @@ async function serverUmamiIdentify(options, data) {
     data
   }, "identify");
 }
+const IGNORED_EXTENSIONS = /\.(js|css|ico|png|jpg|jpeg|gif|svg|webp|woff2?|ttf|eot|map|json)$/;
+function createUmamiPlugin(options) {
+  return async ({ url, headers, method }) => {
+    if (method !== "GET") return;
+    if (IGNORED_EXTENSIONS.test(url.pathname)) return;
+    if (options.filter && !options.filter(url, headers)) return;
+    const language = headers.get("accept-language")?.split(",")[0];
+    const referrer = headers.get("referer") || void 0;
+    const userAgent = headers.get("user-agent") || void 0;
+    serverUmamiTrack({
+      websiteId: options.websiteId,
+      hostUrl: options.hostUrl,
+      userAgent: userAgent || options.userAgent
+    }, {
+      url: url.pathname + url.search,
+      referrer,
+      language: language || void 0
+    }).catch(() => {
+    });
+  };
+}
 export {
+  createUmamiPlugin,
   serverUmamiIdentify,
   serverUmamiTrack
 };

package/lib/server.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"server.mjs","sources":["../src/server/umami-server.ts"],"sourcesContent":["import type { UmamiEventData, UmamiServerOptions, UmamiServerPayload } from '../types';\r\n\r\nconst UMAMI_VERSION = '2.0.0';\r\nconst DEFAULT_USER_AGENT = `Mozilla/5.0 (compatible; qwik-umami/${UMAMI_VERSION})`;\r\n\r\nasync function send(\r\n  options: UmamiServerOptions,\r\n  payload: UmamiServerPayload,\r\n  type: 'event' | 'identify' = 'event',\r\n): Promise<Response> {\r\n  const { hostUrl, websiteId, userAgent = DEFAULT_USER_AGENT } = options;\r\n\r\n  return fetch(`${hostUrl}/api/send`, {\r\n    method: 'POST',\r\n    headers: {\r\n      'Content-Type': 'application/json',\r\n      'User-Agent': userAgent,\r\n    },\r\n    body: JSON.stringify({\r\n      type,\r\n      payload: { website: websiteId, ...payload },\r\n    }),\r\n  });\r\n}\r\n\r\nexport async function serverUmamiTrack(\r\n  options: UmamiServerOptions,\r\n  event: string | UmamiServerPayload,\r\n  data?: UmamiEventData,\r\n): Promise<Response> {\r\n  if (typeof event === 'string') {\r\n    return send(options, { name: event, data });\r\n  }\r\n  return send(options, event);\r\n}\r\n\r\nexport async function serverUmamiIdentify(\r\n  options: UmamiServerOptions,\r\n  data: UmamiEventData,\r\n): Promise<Response> {\r\n  return send(options, { data }, 'identify');\r\n}\r\n"],"names":[],"mappings":"AAEA,MAAM,gBAAgB;AACtB,MAAM,qBAAqB,uCAAuC,aAAA;AAElE,eAAe,KACb,SACA,SACA,OAA6B,SAAO;AAEpC,QAAM,EAAE,SAAS,WAAW,YAAY,uBAAuB;AAE/D,SAAO,MAAM,GAAG,OAAA,aAAoB;AAAA,IAClC,QAAQ;AAAA,IACR,SAAS;AAAA,MACP,gBAAgB;AAAA,MAChB,cAAc;AAAA,IAAA;AAAA,IAEhB,MAAM,KAAK,UAAU;AAAA,MACnB;AAAA,MACA,SAAS;AAAA,QAAE,SAAS;AAAA,QAAW,GAAG;AAAA,MAAA;AAAA,IAAQ,CAC5C;AAAA,EAAA,CACF;AACF;AAEA,eAAsB,iBACpB,SACA,OACA,MAAqB;AAErB,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,KAAK,SAAS;AAAA,MAAE,MAAM;AAAA,MAAO;AAAA,IAAA,CAAK;AAAA,EAC3C;AACA,SAAO,KAAK,SAAS,KAAA;AACvB;AAEA,eAAsB,oBACpB,SACA,MAAoB;AAEpB,SAAO,KAAK,SAAS;AAAA,IAAE;AAAA,EAAA,GAAQ,UAAA;AACjC;"}
+{"version":3,"file":"server.mjs","sources":["../src/server/umami-server.ts","../src/server/umami-plugin.ts"],"sourcesContent":["import type { UmamiEventData, UmamiServerOptions, UmamiServerPayload } from '../types';\r\n\r\nconst UMAMI_VERSION = '2.0.0';\r\nconst DEFAULT_USER_AGENT = `Mozilla/5.0 (compatible; qwik-umami/${UMAMI_VERSION})`;\r\n\r\nasync function send(\r\n  options: UmamiServerOptions,\r\n  payload: UmamiServerPayload,\r\n  type: 'event' | 'identify' = 'event',\r\n): Promise<Response> {\r\n  const { hostUrl, websiteId, userAgent = DEFAULT_USER_AGENT } = options;\r\n\r\n  return fetch(`${hostUrl}/api/send`, {\r\n    method: 'POST',\r\n    headers: {\r\n      'Content-Type': 'application/json',\r\n      'User-Agent': userAgent,\r\n    },\r\n    body: JSON.stringify({\r\n      type,\r\n      payload: { website: websiteId, ...payload },\r\n    }),\r\n  });\r\n}\r\n\r\nexport async function serverUmamiTrack(\r\n  options: UmamiServerOptions,\r\n  event: string | UmamiServerPayload,\r\n  data?: UmamiEventData,\r\n): Promise<Response> {\r\n  if (typeof event === 'string') {\r\n    return send(options, { name: event, data });\r\n  }\r\n  return send(options, event);\r\n}\r\n\r\nexport async function serverUmamiIdentify(\r\n  options: UmamiServerOptions,\r\n  data: UmamiEventData,\r\n): Promise<Response> {\r\n  return send(options, { data }, 'identify');\r\n}\r\n","import type { RequestHandler } from '@builder.io/qwik-city';\nimport type { UmamiPluginOptions } from '../types';\nimport { serverUmamiTrack } from './umami-server';\n\nconst IGNORED_EXTENSIONS =\n  /\\.(js|css|ico|png|jpg|jpeg|gif|svg|webp|woff2?|ttf|eot|map|json)$/;\n\nexport function createUmamiPlugin(options: UmamiPluginOptions): RequestHandler {\n  return async ({ url, headers, method }) => {\n    if (method !== 'GET') return;\n    if (IGNORED_EXTENSIONS.test(url.pathname)) return;\n\n    if (options.filter && !options.filter(url, headers)) return;\n\n    const language = headers.get('accept-language')?.split(',')[0];\n    const referrer = headers.get('referer') || undefined;\n    const userAgent = headers.get('user-agent') || undefined;\n\n    serverUmamiTrack(\n      {\n        websiteId: options.websiteId,\n        hostUrl: options.hostUrl,\n        userAgent: userAgent || options.userAgent,\n      },\n      {\n        url: url.pathname + url.search,\n        referrer,\n        language: language || undefined,\n      },\n    ).catch(() => {});\n  };\n}\n"],"names":[],"mappings":"AAEA,MAAM,gBAAgB;AACtB,MAAM,qBAAqB,uCAAuC,aAAA;AAElE,eAAe,KACb,SACA,SACA,OAA6B,SAAO;AAEpC,QAAM,EAAE,SAAS,WAAW,YAAY,uBAAuB;AAE/D,SAAO,MAAM,GAAG,OAAA,aAAoB;AAAA,IAClC,QAAQ;AAAA,IACR,SAAS;AAAA,MACP,gBAAgB;AAAA,MAChB,cAAc;AAAA,IAAA;AAAA,IAEhB,MAAM,KAAK,UAAU;AAAA,MACnB;AAAA,MACA,SAAS;AAAA,QAAE,SAAS;AAAA,QAAW,GAAG;AAAA,MAAA;AAAA,IAAQ,CAC5C;AAAA,EAAA,CACF;AACF;AAEA,eAAsB,iBACpB,SACA,OACA,MAAqB;AAErB,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,KAAK,SAAS;AAAA,MAAE,MAAM;AAAA,MAAO;AAAA,IAAA,CAAK;AAAA,EAC3C;AACA,SAAO,KAAK,SAAS,KAAA;AACvB;AAEA,eAAsB,oBACpB,SACA,MAAoB;AAEpB,SAAO,KAAK,SAAS;AAAA,IAAE;AAAA,EAAA,GAAQ,UAAA;AACjC;ACrCA,MAAM,qBACJ;AAEK,SAAS,kBAAkB,SAA2B;AAC3D,SAAO,OAAO,EAAE,KAAK,SAAS,aAAQ;AACpC,QAAI,WAAW,MAAO;AACtB,QAAI,mBAAmB,KAAK,IAAI,QAAQ,EAAG;AAE3C,QAAI,QAAQ,UAAU,CAAC,QAAQ,OAAO,KAAK,OAAA,EAAU;AAErD,UAAM,WAAW,QAAQ,IAAI,oBAAoB,MAAM,GAAA,EAAK,CAAA;AAC5D,UAAM,WAAW,QAAQ,IAAI,SAAA,KAAc;AAC3C,UAAM,YAAY,QAAQ,IAAI,YAAA,KAAiB;AAE/C,qBACE;AAAA,MACE,WAAW,QAAQ;AAAA,MACnB,SAAS,QAAQ;AAAA,MACjB,WAAW,aAAa,QAAQ;AAAA,IAAA,GAElC;AAAA,MACE,KAAK,IAAI,WAAW,IAAI;AAAA,MACxB;AAAA,MACA,UAAU,YAAY;AAAA,IAAA,CACxB,EACA,MAAM,MAAA;AAAA,IAAO,CAAA;AAAA,EACjB;AACF;"}

package/lib-types/server/index.d.ts

@@ -1,2 +1,3 @@
 export { serverUmamiTrack, serverUmamiIdentify } from './umami-server';
-export type { UmamiServerOptions, UmamiServerPayload, UmamiEventData } from '../types';
+export { createUmamiPlugin } from './umami-plugin';
+export type { UmamiServerOptions, UmamiServerPayload, UmamiEventData, UmamiPluginOptions, } from '../types';

package/lib-types/server/umami-plugin.d.ts

@@ -0,0 +1,3 @@
+import type { RequestHandler } from '@builder.io/qwik-city';
+import type { UmamiPluginOptions } from '../types';
+export declare function createUmamiPlugin(options: UmamiPluginOptions): RequestHandler;

package/lib-types/types.d.ts

@@ -8,6 +8,7 @@ export interface UmamiConfig {
     excludeSearch?: boolean;
     excludeHash?: boolean;
     doNotTrack?: boolean;
+    strategy?: 'eager' | 'idle';
 }
 export type UmamiEventData = Record<string, string | number | boolean>;
 export type UmamiPayload = {
@@ -35,6 +36,12 @@ export interface UmamiServerPayload {
     name?: string;
     data?: UmamiEventData;
 }
+export interface UmamiPluginOptions {
+    websiteId: string;
+    hostUrl: string;
+    userAgent?: string;
+    filter?: (url: URL, headers: Headers) => boolean;
+}
 export interface UmamiTracker {
     track(): void;
     track(payload: UmamiPayload): void;

package/llms.txt

@@ -6,6 +6,7 @@
 
 - npm: `qwik-umami`
 - Peer dependency: `@builder.io/qwik >= 1.0.0`
+- Optional peer dependency: `@builder.io/qwik-city >= 1.0.0` (only needed for `createUmamiPlugin`)
 - No runtime dependencies
 - Two entry points: `qwik-umami` (browser) and `qwik-umami/server` (server-side)
 
@@ -17,13 +18,13 @@ import { UmamiScript, umamiTrack, umamiIdentify } from 'qwik-umami';
 import type { UmamiConfig, UmamiEventData, UmamiPayload } from 'qwik-umami';
 
 // Server — import from 'qwik-umami/server'
-import { serverUmamiTrack, serverUmamiIdentify } from 'qwik-umami/server';
-import type { UmamiServerOptions, UmamiServerPayload } from 'qwik-umami/server';
+import { serverUmamiTrack, serverUmamiIdentify, createUmamiPlugin } from 'qwik-umami/server';
+import type { UmamiServerOptions, UmamiServerPayload, UmamiPluginOptions } from 'qwik-umami/server';
 ```
 
 ## UmamiScript component
 
-Qwik component. Place in `<head>` inside `root.tsx`. Loads the Umami tracker script client-side only using `useVisibleTask$`. Renders `null`.
+Qwik component. Place in `<head>` inside `root.tsx`. Loads the Umami tracker script client-side only using `useVisibleTask$` (one-shot client init). Renders `null`.
 
 ```tsx
 // Minimum setup — automatic page view tracking
@@ -49,11 +50,14 @@ Qwik component. Place in `<head>` inside `root.tsx`. Loads the Umami tracker scr
 | excludeSearch | boolean | — | no |
 | excludeHash | boolean | — | no |
 | doNotTrack | boolean | — | no |
+| strategy | 'eager' \| 'idle' | 'idle' | no |
 
 Implementation details:
 - Deduplication: checks `document.querySelector('script[data-website-id]')` before loading
-- Availability check: sends HEAD request with 3s timeout before injecting script
-- Fails silently if service is unreachable or blocked by ad blocker
+- Uses `requestIdleCallback` by default (`strategy: 'idle'`) to avoid blocking the main thread
+- Set `strategy: 'eager'` to load immediately on component mount
+- Cleanup removes the script element on component unmount
+- Fails silently if script fails to load (onerror handler)
 
 ## umamiTrack()
 
@@ -115,6 +119,44 @@ function serverUmamiTrack(options: UmamiServerOptions, payload: UmamiServerPaylo
 
 HTTP call: `POST ${hostUrl}/api/send` with body `{ type: 'event', payload: { website, ...payload } }`
 
+## createUmamiPlugin()
+
+Factory that returns a Qwik City `RequestHandler` for server-side page view tracking. Use inside `plugin@umami.ts`. Tracks every GET request as a page view via the Umami API, without requiring the client-side script. Fire-and-forget (does NOT block the response).
+
+```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,
+});
+```
+
+### UmamiPluginOptions
+
+| Prop | Type | Default | Required |
+| --- | --- | --- | --- |
+| websiteId | string | — | yes |
+| hostUrl | string | — | yes |
+| userAgent | string | request user-agent | no |
+| filter | (url: URL, headers: Headers) => boolean | — | no |
+
+Implementation details:
+- Only tracks GET requests (skips POST, PUT, etc.)
+- Ignores static asset requests (.js, .css, .png, .ico, etc.)
+- Custom `filter` function to exclude specific routes (return false to skip)
+- Extracts referrer, language, and user-agent from request headers
+- Fire-and-forget: errors are silently caught, response is never blocked
+
+### When to use which
+
+| Approach | Best for |
+| --- | --- |
+| `<UmamiScript>` only | Most apps — full browser data (screen, timezone, JS events) |
+| `createUmamiPlugin` only | Server-rendered sites, bots, ad-blocker resilience, no JS needed |
+| Both together | Maximum coverage — set `autoTrack: false` on `<UmamiScript>` to avoid duplicate page views, use client for events only |
+
 ## serverUmamiIdentify()
 
 Server-side session identification. POSTs to `/api/send` with `type: 'identify'`.
@@ -143,6 +185,7 @@ interface UmamiConfig {
   excludeSearch?: boolean
   excludeHash?: boolean
   doNotTrack?: boolean
+  strategy?: 'eager' | 'idle'
 }
 
 type UmamiPayload = {
@@ -172,6 +215,13 @@ interface UmamiServerPayload {
   name?: string
   data?: UmamiEventData
 }
+
+interface UmamiPluginOptions {
+  websiteId: string
+  hostUrl: string
+  userAgent?: string
+  filter?: (url: URL, headers: Headers) => boolean
+}
 ```
 
 ## Source structure
@@ -186,7 +236,8 @@ src/
 │   └── track.ts                 # umamiTrack() and umamiIdentify()
 └── server/
     ├── index.ts                 # Server barrel export
-    └── umami-server.ts          # serverUmamiTrack() and serverUmamiIdentify()
+    ├── umami-server.ts          # serverUmamiTrack() and serverUmamiIdentify()
+    └── umami-plugin.ts          # createUmamiPlugin() factory
 ```
 
 ## Important notes for LLMs
@@ -195,5 +246,7 @@ src/
 - Do NOT prefix `umamiTrack` with `use` — it is not a Qwik hook. The `use` prefix is reserved for functions that call Qwik primitives like `useSignal`, `useStore`, etc.
 - `serverUmamiTrack` and `serverUmamiIdentify` must only be used in server contexts (routeLoader$, routeAction$, server$). They use `fetch` directly and have no browser guards.
 - `<UmamiScript>` renders `null`. It is a side-effect-only component.
+- `createUmamiPlugin` returns a `RequestHandler` — it must be exported as `onRequest` from a `plugin@name.ts` file. It requires `@builder.io/qwik-city` as peer dependency.
+- When using both `createUmamiPlugin` AND `<UmamiScript>`, set `autoTrack: false` on the component to avoid duplicate page views. The plugin handles page views server-side, the component handles custom events client-side.
 - Do NOT use `data-umami-event` HTML attributes. Use `umamiTrack()` instead for proper Qwik integration.
 - `UmamiEventData` values are limited by Umami: strings max 500 chars, numbers max 4 decimal places, max 50 properties per object.

package/package.json

@@ -1,65 +1,72 @@
-{
-  "name": "qwik-umami",
-  "version": "1.0.3",
-  "description": "SSR-safe Umami Analytics component and hook for Qwik — automatic page views + custom event tracking with zero config",
-  "type": "module",
-  "main": "./lib/index.qwik.mjs",
-  "qwik": "./lib/index.qwik.mjs",
-  "types": "./lib-types/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./lib/index.qwik.mjs",
-      "require": "./lib/index.qwik.cjs",
-      "types": "./lib-types/index.d.ts"
-    },
-    "./server": {
-      "import": "./lib/server.mjs",
-      "require": "./lib/server.cjs",
-      "types": "./lib-types/server/index.d.ts"
-    }
-  },
-  "files": [
-    "lib",
-    "lib-types",
-    "llms.txt"
-  ],
-  "scripts": {
-    "build": "vite build --mode lib && tsc --emitDeclarationOnly",
-    "dev": "vite",
-    "type-check": "tsc --noEmit"
-  },
-  "keywords": [
-    "qwik",
-    "qwik-city",
-    "analytics",
-    "umami",
-    "tracking",
-    "privacy",
-    "ssr",
-    "page-views",
-    "event-tracking",
-    "self-hosted",
-    "google-analytics-alternative"
-  ],
-  "author": {
-    "name": "murcisluis",
-    "url": "https://github.com/murcisluis"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/murcisluis/qwik-umami"
-  },
-  "homepage": "https://github.com/murcisluis/qwik-umami#readme",
-  "bugs": {
-    "url": "https://github.com/murcisluis/qwik-umami/issues"
-  },
-  "license": "MIT",
-  "peerDependencies": {
-    "@builder.io/qwik": ">=1.0.0"
-  },
-  "devDependencies": {
-    "@builder.io/qwik": "^1.13.0",
-    "typescript": "^5.4.0",
-    "vite": "^5.0.0"
-  }
-}
+{
+  "name": "qwik-umami",
+  "version": "1.1.1",
+  "description": "SSR-safe Umami Analytics component and hook for Qwik — automatic page views + custom event tracking with zero config",
+  "type": "module",
+  "main": "./lib/index.qwik.mjs",
+  "qwik": "./lib/index.qwik.mjs",
+  "types": "./lib-types/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./lib/index.qwik.mjs",
+      "require": "./lib/index.qwik.cjs",
+      "types": "./lib-types/index.d.ts"
+    },
+    "./server": {
+      "import": "./lib/server.mjs",
+      "require": "./lib/server.cjs",
+      "types": "./lib-types/server/index.d.ts"
+    }
+  },
+  "files": [
+    "lib",
+    "lib-types",
+    "llms.txt"
+  ],
+  "scripts": {
+    "build": "vite build --mode lib && tsc --emitDeclarationOnly",
+    "dev": "vite",
+    "type-check": "tsc --noEmit"
+  },
+  "keywords": [
+    "qwik",
+    "qwik-city",
+    "analytics",
+    "umami",
+    "tracking",
+    "privacy",
+    "ssr",
+    "page-views",
+    "event-tracking",
+    "self-hosted",
+    "google-analytics-alternative"
+  ],
+  "author": {
+    "name": "murcisluis",
+    "url": "https://github.com/murcisluis"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/murcisluis/qwik-umami.git"
+  },
+  "homepage": "https://github.com/murcisluis/qwik-umami#readme",
+  "bugs": {
+    "url": "https://github.com/murcisluis/qwik-umami/issues"
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "@builder.io/qwik": ">=1.0.0",
+    "@builder.io/qwik-city": ">=1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@builder.io/qwik-city": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@builder.io/qwik": "^1.19.0",
+    "@builder.io/qwik-city": "^1.19.0",
+    "typescript": "^5.4.0",
+    "vite": "^5.0.0"
+  }
+}