@stacksjs/analytics 0.71.1 → 0.71.10

package/dist/capture.d.ts

@@ -0,0 +1,12 @@
+/** Should this request count as a pageview? Pure, testable. */
+export declare function isPageviewRequest(method: string, pathname: string, headers: Headers): boolean;
+/** Coarse classification - enough for the devices/browsers dashboards, nothing identifying. */
+export declare function classifyAgent(userAgent: string): { device: string, browser: string };
+/** The referrer's host, or null for direct/self traffic. */
+export declare function referrerHost(referrer: string | null, ownHost: string): string | null;
+/**
+ * Record one pageview. Fire-and-forget from the serving hot path - callers
+ * do `void recordPageview(...)`; a failed insert loses one statistic, never
+ * a page render.
+ */
+export declare function recordPageview(req: Request): Promise<void>;

package/dist/capture.js

@@ -0,0 +1 @@
+import{db,sqlDateTime}from"@stacksjs/database";const ASSET_EXT=/\.(?:css|js|mjs|map|png|jpe?g|gif|webp|avif|svg|ico|woff2?|ttf|otf|eot|txt|xml|json|webmanifest|mp[34]|webm|pdf|zip)$/i;export function isPageviewRequest(method,pathname,headers){if(method!=="GET")return!1;if(ASSET_EXT.test(pathname))return!1;if(pathname.startsWith("/api/")||pathname.startsWith("/__")||pathname.startsWith("/_"))return!1;const accept=headers.get("accept")??"";if(accept&&!accept.includes("text/html")&&!accept.includes("*/*"))return!1;const agent=(headers.get("user-agent")??"").toLowerCase();if(!agent)return!1;if(/bot|crawler|spider|preview|monitor|curl|wget|python-requests|headless/.test(agent))return!1;return!0}export function classifyAgent(userAgent){const agent=userAgent.toLowerCase(),device=/ipad|tablet/.test(agent)?"tablet":/mobi|iphone|android/.test(agent)?"mobile":"desktop",browser=agent.includes("edg/")?"edge":agent.includes("opr/")||agent.includes("opera")?"opera":agent.includes("firefox/")?"firefox":agent.includes("chrome/")||agent.includes("crios/")?"chrome":agent.includes("safari/")?"safari":"other";return{device,browser}}export function referrerHost(referrer,ownHost){if(!referrer)return null;try{const host=new URL(referrer).host.toLowerCase();return host&&host!==ownHost.toLowerCase()?host:null}catch{return null}}export async function recordPageview(req){try{const url=new URL(req.url);if(!isPageviewRequest(req.method,url.pathname,req.headers))return;const agent=req.headers.get("user-agent")??"",{device,browser}=classifyAgent(agent),now=sqlDateTime(new Date);await db.insertInto("analytics_events").values({name:"pageview",category:"web",path:url.pathname,properties:JSON.stringify({host:req.headers.get("x-forwarded-host")?.split(",")[0]?.trim()||url.host,referrer:referrerHost(req.headers.get("referer"),url.host),device,browser}),created_at:now,updated_at:now}).execute()}catch{}}

package/dist/drivers/fathom.d.ts

@@ -0,0 +1 @@
+export declare const fathomWip: 1;

package/dist/drivers/fathom.js

@@ -0,0 +1 @@
+export const fathomWip=1;

package/dist/drivers/index.d.ts

@@ -0,0 +1,2 @@
+export * from './fathom';
+export * from './self-hosted';

package/dist/drivers/index.js

@@ -0,0 +1 @@
+export*from"./fathom";export*from"./self-hosted";

package/dist/drivers/self-hosted.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Generate the self-hosted analytics tracking script
+ */
+export declare function generateSelfHostedScript(config: SelfHostedConfig): string;
+/**
+ * Generate the head tag for including self-hosted analytics
+ * Compatible with Stacks docs config.ts head array format
+ */
+export declare function getSelfHostedAnalyticsHead(config: SelfHostedConfig): [string, Record<string, string>][];
+/**
+ * Self-Hosted Analytics Driver
+ *
+ * This driver generates a minimal, privacy-focused tracking script
+ * that sends analytics data to your own API endpoint (powered by dynamodb-tooling analytics).
+ *
+ * Features:
+ * - No cookies required
+ * - Privacy-focused (hashed visitor IDs)
+ * - Do Not Track support
+ * - Page view tracking
+ * - Custom event tracking
+ * - Outbound link tracking (optional)
+ * - Hash-based routing support (optional)
+ */
+export declare interface SelfHostedConfig {
+  siteId: string
+  apiEndpoint: string
+  honorDnt?: boolean
+  trackHashChanges?: boolean
+  trackOutboundLinks?: boolean
+}

package/dist/drivers/self-hosted.js

@@ -0,0 +1,56 @@
+export function generateSelfHostedScript(config){if(!config.siteId||!config.apiEndpoint)return"";const siteId=escapeAttr(config.siteId),apiEndpoint=escapeAttr(config.apiEndpoint),honorDnt=config.honorDnt?'if(n.doNotTrack==="1")return;':"",hashTracking=config.trackHashChanges?"w.addEventListener('hashchange',pv);":"",outboundTracking=config.trackOutboundLinks?`
+  d.addEventListener('click',function(e){
+    var a=e.target.closest('a');
+    if(a&&a.hostname!==location.hostname){
+      t('outbound',{url:a.href});
+    }
+  });`:"";return`<!-- Stacks Self-Hosted Analytics -->
+<script data-site="${siteId}" data-api="${apiEndpoint}" defer>
+(function(){
+  'use strict';
+  var d=document,w=window,n=navigator,s=d.currentScript;
+  var site=s.dataset.site,api=s.dataset.api;
+  ${honorDnt}
+  var q=[],sid=Math.random().toString(36).slice(2);
+  function t(e,p){
+    var x=new XMLHttpRequest();
+    x.open('POST',api+'/collect',true);
+    x.setRequestHeader('Content-Type','application/json');
+    // Strip the URL's query string before sending. location.href includes
+    // tokens / session IDs / search terms that shouldn't reach the
+    // analytics backend. Same goes for document.referrer when it points
+    // back to our own domain (path is fine, query is not).
+    var safeUrl=location.origin+location.pathname+location.hash;
+    var safeRef=d.referrer?d.referrer.split('?')[0]:'';
+    x.send(JSON.stringify({
+      s:site,sid:sid,e:e,p:p||{},
+      u:safeUrl,r:safeRef,t:d.title,
+      sw:screen.width,sh:screen.height
+    }));
+  }
+  function pv(){t('pageview');}
+  ${hashTracking}
+  ${outboundTracking}
+  if(d.readyState==='complete')pv();
+  else w.addEventListener('load',pv);
+  w.stacksAnalytics={track:function(n,v){t('event',{name:n,value:v});}};
+})();
+</script>`}export function getSelfHostedAnalyticsHead(config){if(!config.siteId||!config.apiEndpoint)return[];return[["script",{"data-site":config.siteId,"data-api":config.apiEndpoint,defer:"",innerHTML:generateInlineScript(config)}]]}function generateInlineScript(config){const honorDnt=config.honorDnt?'if(n.doNotTrack==="1")return;':"",hashTracking=config.trackHashChanges?"w.addEventListener('hashchange',pv);":"",outboundTracking=config.trackOutboundLinks?"d.addEventListener('click',function(e){var a=e.target.closest('a');if(a&&a.hostname!==location.hostname){t('outbound',{url:a.href});}});":"";return`(function(){
+'use strict';
+var d=document,w=window,n=navigator,s=d.currentScript;
+var site=s.dataset.site,api=s.dataset.api;
+${honorDnt}
+var q=[],sid=Math.random().toString(36).slice(2);
+function t(e,p){
+var x=new XMLHttpRequest();
+x.open('POST',api+'/collect',true);
+x.setRequestHeader('Content-Type','application/json');
+var safeUrl=location.origin+location.pathname+location.hash;var safeRef=d.referrer?d.referrer.split('?')[0]:'';x.send(JSON.stringify({s:site,sid:sid,e:e,p:p||{},u:safeUrl,r:safeRef,t:d.title,sw:screen.width,sh:screen.height}));
+}
+function pv(){t('pageview');}
+${hashTracking}
+${outboundTracking}
+if(d.readyState==='complete')pv();
+else w.addEventListener('load',pv);
+w.stacksAnalytics={track:function(n,v){t('event',{name:n,value:v});}};
+})();`}function escapeAttr(str){return str.replace(/&/g,"&amp;").replace(/"/g,"&quot;").replace(/'/g,"&#39;").replace(/</g,"&lt;").replace(/>/g,"&gt;")}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { classifyAgent, isPageviewRequest, recordPageview, referrerHost } from './capture';
+export * from './drivers/index';

package/dist/index.js

@@ -1,57 +1 @@
-// @bun
-var W=1;function j(m){if(!m.siteId||!m.apiEndpoint)return"";let x=q(m.siteId),w=q(m.apiEndpoint),P=m.honorDnt?'if(n.doNotTrack==="1")return;':"",v=m.trackHashChanges?"w.addEventListener('hashchange',pv);":"",y=m.trackOutboundLinks?`
-  d.addEventListener('click',function(e){
-    var a=e.target.closest('a');
-    if(a&&a.hostname!==location.hostname){
-      t('outbound',{url:a.href});
-    }
-  });`:"";return`<!-- Stacks Self-Hosted Analytics -->
-<script data-site="${x}" data-api="${w}" defer>
-(function(){
-  'use strict';
-  var d=document,w=window,n=navigator,s=d.currentScript;
-  var site=s.dataset.site,api=s.dataset.api;
-  ${P}
-  var q=[],sid=Math.random().toString(36).slice(2);
-  function t(e,p){
-    var x=new XMLHttpRequest();
-    x.open('POST',api+'/collect',true);
-    x.setRequestHeader('Content-Type','application/json');
-    // Strip the URL's query string before sending. location.href includes
-    // tokens / session IDs / search terms that shouldn't reach the
-    // analytics backend. Same goes for document.referrer when it points
-    // back to our own domain (path is fine, query is not).
-    var safeUrl=location.origin+location.pathname+location.hash;
-    var safeRef=d.referrer?d.referrer.split('?')[0]:'';
-    x.send(JSON.stringify({
-      s:site,sid:sid,e:e,p:p||{},
-      u:safeUrl,r:safeRef,t:d.title,
-      sw:screen.width,sh:screen.height
-    }));
-  }
-  function pv(){t('pageview');}
-  ${v}
-  ${y}
-  if(d.readyState==='complete')pv();
-  else w.addEventListener('load',pv);
-  w.stacksAnalytics={track:function(n,v){t('event',{name:n,value:v});}};
-})();
-</script>`}function z(m){if(!m.siteId||!m.apiEndpoint)return[];return[["script",{"data-site":m.siteId,"data-api":m.apiEndpoint,defer:"",innerHTML:R(m)}]]}function R(m){let x=m.honorDnt?'if(n.doNotTrack==="1")return;':"",w=m.trackHashChanges?"w.addEventListener('hashchange',pv);":"",P=m.trackOutboundLinks?"d.addEventListener('click',function(e){var a=e.target.closest('a');if(a&&a.hostname!==location.hostname){t('outbound',{url:a.href});}});":"";return`(function(){
-'use strict';
-var d=document,w=window,n=navigator,s=d.currentScript;
-var site=s.dataset.site,api=s.dataset.api;
-${x}
-var q=[],sid=Math.random().toString(36).slice(2);
-function t(e,p){
-var x=new XMLHttpRequest();
-x.open('POST',api+'/collect',true);
-x.setRequestHeader('Content-Type','application/json');
-var safeUrl=location.origin+location.pathname+location.hash;var safeRef=d.referrer?d.referrer.split('?')[0]:'';x.send(JSON.stringify({s:site,sid:sid,e:e,p:p||{},u:safeUrl,r:safeRef,t:d.title,sw:screen.width,sh:screen.height}));
-}
-function pv(){t('pageview');}
-${w}
-${P}
-if(d.readyState==='complete')pv();
-else w.addEventListener('load',pv);
-w.stacksAnalytics={track:function(n,v){t('event',{name:n,value:v});}};
-})();`}function q(m){return m.replace(/&/g,"&amp;").replace(/"/g,"&quot;").replace(/'/g,"&#39;").replace(/</g,"&lt;").replace(/>/g,"&gt;")}export{K as referrerHost,J as recordPageview,H as isPageviewRequest,z as getSelfHostedAnalyticsHead,j as generateSelfHostedScript,W as fathomWip,G as classifyAgent};
+export{classifyAgent,isPageviewRequest,recordPageview,referrerHost}from"./capture";export*from"./drivers";

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/analytics",
   "type": "module",
   "sideEffects": false,
-  "version": "0.71.1",
+  "version": "0.71.10",
   "description": "Stacks Analytics. Privacy-friendly.",
   "author": "Chris Breuer",
   "contributors": [