@loamly/tracker 1.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +82 -0
- package/dist/index.cjs +584 -0
- package/dist/index.cjs.map +1 -0
- package/dist/index.d.mts +146 -0
- package/dist/index.d.ts +146 -0
- package/dist/index.mjs +551 -0
- package/dist/index.mjs.map +1 -0
- package/dist/loamly.iife.global.js +594 -0
- package/dist/loamly.iife.global.js.map +1 -0
- package/dist/loamly.iife.min.global.js +2 -0
- package/dist/loamly.iife.min.global.js.map +1 -0
- package/package.json +68 -0
- package/src/browser.ts +81 -0
- package/src/config.ts +59 -0
- package/src/core.ts +428 -0
- package/src/detection/index.ts +13 -0
- package/src/detection/navigation-timing.ts +117 -0
- package/src/detection/referrer.ts +98 -0
- package/src/index.ts +31 -0
- package/src/types.ts +100 -0
- package/src/utils.ts +130 -0
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
"use strict";var Loamly=(()=>{var S=Object.defineProperty;var H=Object.getOwnPropertyDescriptor;var B=Object.getOwnPropertyNames;var F=Object.prototype.hasOwnProperty;var z=(e,t)=>{for(var n in t)S(e,n,{get:t[n],enumerable:!0})},V=(e,t,n,i)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of B(t))!F.call(e,o)&&o!==n&&S(e,o,{get:()=>t[o],enumerable:!(i=H(t,o))||i.enumerable});return e};var j=e=>V(S({},"__esModule",{value:!0}),e);var it={};z(it,{default:()=>nt,loamly:()=>w});var p="1.6.0",d={apiHost:"https://app.loamly.ai",endpoints:{visit:"/api/ingest/visit",behavioral:"/api/ingest/behavioral",session:"/api/ingest/session",resolve:"/api/tracker/resolve",health:"/api/tracker/health",ping:"/api/tracker/ping"},pingInterval:3e4,batchSize:10,batchTimeout:5e3,sessionTimeout:18e5,maxTextLength:100,timeSpentThresholdMs:5e3},_={"chatgpt.com":"chatgpt","chat.openai.com":"chatgpt","claude.ai":"claude","perplexity.ai":"perplexity","bard.google.com":"bard","gemini.google.com":"gemini","copilot.microsoft.com":"copilot","github.com/copilot":"github-copilot","you.com":"you","phind.com":"phind","poe.com":"poe"};function N(){try{let e=performance.getEntriesByType("navigation");if(!e||e.length===0)return{nav_type:"unknown",confidence:0,signals:["no_timing_data"]};let t=e[0],n=[],i=0,o=t.fetchStart-t.startTime;o<5?(i+=.25,n.push("instant_fetch_start")):o<20&&(i+=.15,n.push("fast_fetch_start")),t.domainLookupEnd-t.domainLookupStart===0&&(i+=.15,n.push("no_dns_lookup")),t.connectEnd-t.connectStart===0&&(i+=.15,n.push("no_tcp_connect")),t.redirectCount===0&&(i+=.1,n.push("no_redirects")),q(t)<10&&(i+=.15,n.push("uniform_timing")),(!document.referrer||document.referrer==="")&&(i+=.1,n.push("no_referrer"));let x=Math.min(i,1);return{nav_type:i>=.5?"likely_paste":"likely_click",confidence:Math.round(x*1e3)/1e3,signals:n}}catch{return{nav_type:"unknown",confidence:0,signals:["detection_error"]}}}function q(e){let t=[e.fetchStart-e.startTime,e.domainLookupEnd-e.domainLookupStart,e.connectEnd-e.connectStart,e.responseStart-e.requestStart].filter(o=>o>=0);if(t.length===0)return 100;let n=t.reduce((o,r)=>o+r,0)/t.length,i=t.reduce((o,r)=>o+Math.pow(r-n,2),0)/t.length;return Math.sqrt(i)}function D(e){if(!e)return null;try{let n=new URL(e).hostname.toLowerCase();for(let[i,o]of Object.entries(_))if(n.includes(i)||e.includes(i))return{isAI:!0,platform:o,confidence:.95,method:"referrer"};return null}catch{for(let[t,n]of Object.entries(_))if(e.toLowerCase().includes(t.toLowerCase()))return{isAI:!0,platform:n,confidence:.85,method:"referrer"};return null}}function R(e){try{let n=new URL(e).searchParams.get("utm_source")?.toLowerCase();if(n){for(let[i,o]of Object.entries(_))if(n.includes(i.split(".")[0]))return{isAI:!0,platform:o,confidence:.99,method:"referrer"};if(n.includes("ai")||n.includes("llm")||n.includes("chatbot"))return{isAI:!0,platform:n,confidence:.9,method:"referrer"}}return null}catch{return null}}function T(){return typeof crypto<"u"&&crypto.randomUUID?crypto.randomUUID():"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,e=>{let t=Math.random()*16|0;return(e==="x"?t:t&3|8).toString(16)})}function C(){try{let e=localStorage.getItem("_loamly_vid");if(e)return e;let t=T();return localStorage.setItem("_loamly_vid",t),t}catch{return T()}}function O(){try{let e=sessionStorage.getItem("loamly_session"),t=sessionStorage.getItem("loamly_start");if(e&&t)return{sessionId:e,isNew:!1};let n=T(),i=Date.now().toString();return sessionStorage.setItem("loamly_session",n),sessionStorage.setItem("loamly_start",i),{sessionId:n,isNew:!0}}catch{return{sessionId:T(),isNew:!0}}}function I(e){let t={};try{let n=new URL(e).searchParams,i=["utm_source","utm_medium","utm_campaign","utm_term","utm_content"];for(let o of i){let r=n.get(o);r&&(t[o]=r)}}catch{}return t}function b(e,t){return e.length<=t?e:e.substring(0,t-3)+"..."}async function g(e,t,n=1e4){try{let i=new AbortController,o=setTimeout(()=>i.abort(),n),r=await fetch(e,{...t,signal:i.signal});return clearTimeout(o),r}catch{return null}}function M(e,t){return typeof navigator<"u"&&navigator.sendBeacon?navigator.sendBeacon(e,JSON.stringify(t)):!1}var k={apiHost:d.apiHost},f=!1,L=!1,l=null,u=null,A=null,y=null,m=null;function a(...e){L&&console.log("[Loamly]",...e)}function v(e){return`${k.apiHost}${e}`}function G(e={}){if(f){a("Already initialized");return}k={...k,...e,apiHost:e.apiHost||d.apiHost},L=e.debug??!1,a("Initializing Loamly Tracker v"+p),l=C(),a("Visitor ID:",l);let t=O();u=t.sessionId,A=Date.now(),a("Session ID:",u,t.isNew?"(new)":"(existing)"),y=N(),a("Navigation timing:",y),m=D(document.referrer)||R(window.location.href),m&&a("AI detected:",m),f=!0,e.disableAutoPageview||P(),e.disableBehavioral||$(),a("Initialization complete")}function P(e){if(!f){a("Not initialized, call init() first");return}let t=e||window.location.href,n={visitor_id:l,session_id:u,url:t,referrer:document.referrer||null,title:document.title||null,utm_source:I(t).utm_source||null,utm_medium:I(t).utm_medium||null,utm_campaign:I(t).utm_campaign||null,user_agent:navigator.userAgent,screen_width:window.screen?.width,screen_height:window.screen?.height,language:navigator.language,timezone:Intl.DateTimeFormat().resolvedOptions().timeZone,tracker_version:p,navigation_timing:y,ai_platform:m?.platform||null,is_ai_referrer:m?.isAI||!1};a("Pageview:",n),g(v(d.endpoints.visit),{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(n)})}function U(e,t={}){if(!f){a("Not initialized, call init() first");return}let n={visitor_id:l,session_id:u,event_name:e,event_type:"custom",properties:t.properties||{},revenue:t.revenue,currency:t.currency||"USD",url:window.location.href,timestamp:new Date().toISOString(),tracker_version:p};a("Event:",e,n),g(v("/api/ingest/event"),{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(n)})}function J(e,t,n="USD"){U(e,{revenue:t,currency:n,properties:{type:"conversion"}})}function K(e,t={}){if(!f){a("Not initialized, call init() first");return}a("Identify:",e,t);let n={visitor_id:l,session_id:u,user_id:e,traits:t,timestamp:new Date().toISOString()};g(v("/api/ingest/identify"),{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(n)})}function $(){let e=0,t=0,n=Date.now(),i=!1;window.addEventListener("scroll",()=>{i||(requestAnimationFrame(()=>{let r=Math.round((window.scrollY+window.innerHeight)/document.documentElement.scrollHeight*100);if(r>e){e=r;let s=[25,50,75,100];for(let c of s)r>=c&&t<c&&(t=c,h("scroll_depth",{depth:c}))}i=!1}),i=!0)});let o=()=>{let r=Date.now(),s=r-n;s>=d.timeSpentThresholdMs&&(n=r,h("time_spent",{seconds:Math.round(s/1e3),total_seconds:Math.round((r-(A||r))/1e3)}))};document.addEventListener("visibilitychange",()=>{document.visibilityState==="hidden"&&o()}),window.addEventListener("beforeunload",()=>{o(),e>0&&M(v(d.endpoints.behavioral),{visitor_id:l,session_id:u,event_type:"scroll_depth_final",data:{depth:e},url:window.location.href})}),document.addEventListener("focusin",r=>{let s=r.target;(s.tagName==="INPUT"||s.tagName==="TEXTAREA"||s.tagName==="SELECT")&&h("form_focus",{field_type:s.tagName.toLowerCase(),field_name:s.name||s.id||"unknown"})}),document.addEventListener("submit",r=>{let s=r.target;h("form_submit",{form_id:s.id||s.name||"unknown",form_action:s.action?new URL(s.action).pathname:"unknown"})}),document.addEventListener("click",r=>{let c=r.target.closest("a");if(c&&c.href){let x=c.hostname!==window.location.hostname;h("click",{element:"link",href:b(c.href,200),text:b(c.textContent||"",100),is_external:x})}})}function h(e,t){let n={visitor_id:l,session_id:u,event_type:e,data:t,url:window.location.href,timestamp:new Date().toISOString(),tracker_version:p};a("Behavioral:",e,t),g(v(d.endpoints.behavioral),{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(n)})}function W(){return u}function X(){return l}function Y(){return m}function Z(){return y}function Q(){return f}function tt(){a("Resetting tracker"),f=!1,l=null,u=null,A=null,y=null,m=null;try{sessionStorage.removeItem("loamly_session"),sessionStorage.removeItem("loamly_start")}catch{}}function et(e){L=e,a("Debug mode:",e?"enabled":"disabled")}var w={init:G,pageview:P,track:U,conversion:J,identify:K,getSessionId:W,getVisitorId:X,getAIDetection:Y,getNavigationTiming:Z,isInitialized:Q,reset:tt,debug:et};function E(){let e=document.getElementsByTagName("script"),t=null;for(let i of e)if(i.src.includes("loamly")||i.dataset.loamly!==void 0){t=i;break}if(!t)return;let n={};t.dataset.apiKey&&(n.apiKey=t.dataset.apiKey),t.dataset.apiHost&&(n.apiHost=t.dataset.apiHost),t.dataset.debug==="true"&&(n.debug=!0),t.dataset.disableAutoPageview==="true"&&(n.disableAutoPageview=!0),t.dataset.disableBehavioral==="true"&&(n.disableBehavioral=!0),(n.apiKey||t.dataset.loamly!==void 0)&&w.init(n)}typeof document<"u"&&(document.readyState==="loading"?document.addEventListener("DOMContentLoaded",E):typeof requestIdleCallback<"u"?requestIdleCallback(E):setTimeout(E,0));var nt=w;return j(it);})();
|
|
2
|
+
//# sourceMappingURL=loamly.iife.min.global.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/browser.ts","../src/config.ts","../src/detection/navigation-timing.ts","../src/detection/referrer.ts","../src/utils.ts","../src/core.ts"],"sourcesContent":["/**\n * Loamly Tracker - Browser Bundle (IIFE)\n * \n * This file is the entry point for the browser script tag version.\n * It auto-initializes from data attributes on the script tag.\n * \n * Usage:\n * <script src=\"https://unpkg.com/@loamly/tracker\" data-api-key=\"your-key\"></script>\n * \n * @module @loamly/tracker/browser\n */\n\nimport { loamly } from './core'\nimport type { LoamlyConfig } from './types'\n\n// Auto-initialize from script tag data attributes\nfunction autoInit(): void {\n // Find the script tag that loaded us\n const scripts = document.getElementsByTagName('script')\n let scriptTag: HTMLScriptElement | null = null\n \n for (const script of scripts) {\n if (script.src.includes('loamly') || script.dataset.loamly !== undefined) {\n scriptTag = script\n break\n }\n }\n\n if (!scriptTag) {\n // No matching script tag found, don't auto-init\n return\n }\n\n // Extract configuration from data attributes\n const config: LoamlyConfig = {}\n \n if (scriptTag.dataset.apiKey) {\n config.apiKey = scriptTag.dataset.apiKey\n }\n \n if (scriptTag.dataset.apiHost) {\n config.apiHost = scriptTag.dataset.apiHost\n }\n \n if (scriptTag.dataset.debug === 'true') {\n config.debug = true\n }\n \n if (scriptTag.dataset.disableAutoPageview === 'true') {\n config.disableAutoPageview = true\n }\n \n if (scriptTag.dataset.disableBehavioral === 'true') {\n config.disableBehavioral = true\n }\n\n // Initialize if we have configuration\n if (config.apiKey || scriptTag.dataset.loamly !== undefined) {\n loamly.init(config)\n }\n}\n\n// Run auto-init when DOM is ready\nif (typeof document !== 'undefined') {\n if (document.readyState === 'loading') {\n document.addEventListener('DOMContentLoaded', autoInit)\n } else {\n // Use requestIdleCallback if available for non-blocking init\n if (typeof requestIdleCallback !== 'undefined') {\n requestIdleCallback(autoInit)\n } else {\n setTimeout(autoInit, 0)\n }\n }\n}\n\n// Export for manual usage\nexport { loamly }\nexport default loamly\n\n\n","/**\n * Loamly Tracker Configuration\n * @module @loamly/tracker\n */\n\nexport const VERSION = '1.6.0'\n\nexport const DEFAULT_CONFIG = {\n apiHost: 'https://app.loamly.ai',\n endpoints: {\n visit: '/api/ingest/visit',\n behavioral: '/api/ingest/behavioral',\n session: '/api/ingest/session',\n resolve: '/api/tracker/resolve',\n health: '/api/tracker/health',\n ping: '/api/tracker/ping',\n },\n pingInterval: 30000, // 30 seconds\n batchSize: 10,\n batchTimeout: 5000,\n sessionTimeout: 1800000, // 30 minutes\n maxTextLength: 100,\n timeSpentThresholdMs: 5000, // Only send time_spent when delta >= 5 seconds\n} as const\n\n/**\n * Known AI platforms for referrer detection\n */\nexport const AI_PLATFORMS: Record<string, string> = {\n 'chatgpt.com': 'chatgpt',\n 'chat.openai.com': 'chatgpt',\n 'claude.ai': 'claude',\n 'perplexity.ai': 'perplexity',\n 'bard.google.com': 'bard',\n 'gemini.google.com': 'gemini',\n 'copilot.microsoft.com': 'copilot',\n 'github.com/copilot': 'github-copilot',\n 'you.com': 'you',\n 'phind.com': 'phind',\n 'poe.com': 'poe',\n}\n\n/**\n * User agents of known AI crawlers\n */\nexport const AI_BOT_PATTERNS = [\n 'GPTBot',\n 'ChatGPT-User',\n 'ClaudeBot',\n 'Claude-Web',\n 'PerplexityBot',\n 'Amazonbot',\n 'Google-Extended',\n 'CCBot',\n 'anthropic-ai',\n 'cohere-ai',\n]\n\n\n","/**\n * Navigation Timing API Detection\n * \n * Detects whether the user arrived via paste (from AI chat) vs click\n * by analyzing Navigation Timing API patterns.\n * \n * @module @loamly/tracker/detection\n */\n\nimport type { NavigationTiming } from '../types'\n\n/**\n * Analyze Navigation Timing API to detect paste vs click navigation\n * \n * When users paste a URL (common after copying from AI chat), \n * the timing patterns are distinctive:\n * 1. fetchStart is virtually immediate after navigationStart\n * 2. DNS/connect times are often 0 (cached or direct)\n * 3. No redirect chain\n * 4. Uniform timing patterns\n * \n * @returns NavigationTiming result with type and confidence\n */\nexport function detectNavigationType(): NavigationTiming {\n try {\n const entries = performance.getEntriesByType('navigation') as PerformanceNavigationTiming[]\n \n if (!entries || entries.length === 0) {\n return { nav_type: 'unknown', confidence: 0, signals: ['no_timing_data'] }\n }\n\n const nav = entries[0]\n const signals: string[] = []\n let pasteScore = 0\n\n // Signal 1: fetchStart delta from navigationStart\n // Paste navigation typically has very small delta (< 5ms)\n const fetchStartDelta = nav.fetchStart - nav.startTime\n if (fetchStartDelta < 5) {\n pasteScore += 0.25\n signals.push('instant_fetch_start')\n } else if (fetchStartDelta < 20) {\n pasteScore += 0.15\n signals.push('fast_fetch_start')\n }\n\n // Signal 2: DNS lookup time\n // Paste = likely 0 (direct URL entry, no link warmup)\n const dnsTime = nav.domainLookupEnd - nav.domainLookupStart\n if (dnsTime === 0) {\n pasteScore += 0.15\n signals.push('no_dns_lookup')\n }\n\n // Signal 3: TCP connect time\n // Paste = likely 0 (no preconnect from previous page)\n const connectTime = nav.connectEnd - nav.connectStart\n if (connectTime === 0) {\n pasteScore += 0.15\n signals.push('no_tcp_connect')\n }\n\n // Signal 4: No redirects\n // Paste URLs are typically direct, no redirects\n if (nav.redirectCount === 0) {\n pasteScore += 0.1\n signals.push('no_redirects')\n }\n\n // Signal 5: Timing uniformity check\n // Paste navigation tends to have more uniform patterns\n const timingVariance = calculateTimingVariance(nav)\n if (timingVariance < 10) {\n pasteScore += 0.15\n signals.push('uniform_timing')\n }\n\n // Signal 6: No referrer (common for paste)\n if (!document.referrer || document.referrer === '') {\n pasteScore += 0.1\n signals.push('no_referrer')\n }\n\n // Determine navigation type based on score\n const confidence = Math.min(pasteScore, 1)\n const nav_type = pasteScore >= 0.5 ? 'likely_paste' : 'likely_click'\n\n return {\n nav_type,\n confidence: Math.round(confidence * 1000) / 1000,\n signals,\n }\n } catch {\n return { nav_type: 'unknown', confidence: 0, signals: ['detection_error'] }\n }\n}\n\n/**\n * Calculate timing variance to detect paste patterns\n */\nfunction calculateTimingVariance(nav: PerformanceNavigationTiming): number {\n const timings = [\n nav.fetchStart - nav.startTime,\n nav.domainLookupEnd - nav.domainLookupStart,\n nav.connectEnd - nav.connectStart,\n nav.responseStart - nav.requestStart,\n ].filter((t) => t >= 0)\n\n if (timings.length === 0) return 100\n\n const mean = timings.reduce((a, b) => a + b, 0) / timings.length\n const variance = timings.reduce((sum, t) => sum + Math.pow(t - mean, 2), 0) / timings.length\n \n return Math.sqrt(variance)\n}\n\n\n","/**\n * Referrer-based AI Detection\n * \n * Detects when users arrive from known AI platforms\n * based on the document.referrer header.\n * \n * @module @loamly/tracker/detection\n */\n\nimport { AI_PLATFORMS } from '../config'\nimport type { AIDetectionResult } from '../types'\n\n/**\n * Detect AI platform from referrer URL\n * \n * @param referrer - The document.referrer value\n * @returns AI detection result or null if no AI detected\n */\nexport function detectAIFromReferrer(referrer: string): AIDetectionResult | null {\n if (!referrer) {\n return null\n }\n\n try {\n const url = new URL(referrer)\n const hostname = url.hostname.toLowerCase()\n\n // Check against known AI platforms\n for (const [pattern, platform] of Object.entries(AI_PLATFORMS)) {\n if (hostname.includes(pattern) || referrer.includes(pattern)) {\n return {\n isAI: true,\n platform,\n confidence: 0.95, // High confidence when referrer matches\n method: 'referrer',\n }\n }\n }\n\n return null\n } catch {\n // Invalid URL, try pattern matching on raw string\n for (const [pattern, platform] of Object.entries(AI_PLATFORMS)) {\n if (referrer.toLowerCase().includes(pattern.toLowerCase())) {\n return {\n isAI: true,\n platform,\n confidence: 0.85,\n method: 'referrer',\n }\n }\n }\n return null\n }\n}\n\n/**\n * Extract AI platform from UTM parameters\n * \n * @param url - The current page URL\n * @returns AI platform name or null\n */\nexport function detectAIFromUTM(url: string): AIDetectionResult | null {\n try {\n const params = new URL(url).searchParams\n \n // Check utm_source for AI platforms\n const utmSource = params.get('utm_source')?.toLowerCase()\n if (utmSource) {\n for (const [pattern, platform] of Object.entries(AI_PLATFORMS)) {\n if (utmSource.includes(pattern.split('.')[0])) {\n return {\n isAI: true,\n platform,\n confidence: 0.99, // Very high confidence from explicit UTM\n method: 'referrer',\n }\n }\n }\n \n // Generic AI source patterns\n if (utmSource.includes('ai') || utmSource.includes('llm') || utmSource.includes('chatbot')) {\n return {\n isAI: true,\n platform: utmSource,\n confidence: 0.9,\n method: 'referrer',\n }\n }\n }\n\n return null\n } catch {\n return null\n }\n}\n\n\n","/**\n * Utility functions for Loamly Tracker\n * @module @loamly/tracker\n */\n\n/**\n * Generate a UUID v4\n */\nexport function generateUUID(): string {\n if (typeof crypto !== 'undefined' && crypto.randomUUID) {\n return crypto.randomUUID()\n }\n \n // Fallback for older browsers\n return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {\n const r = (Math.random() * 16) | 0\n const v = c === 'x' ? r : (r & 0x3) | 0x8\n return v.toString(16)\n })\n}\n\n/**\n * Get or create a persistent visitor ID\n * (Privacy-respecting, no cookies)\n */\nexport function getVisitorId(): string {\n // Try to get from localStorage first\n try {\n const stored = localStorage.getItem('_loamly_vid')\n if (stored) return stored\n \n const newId = generateUUID()\n localStorage.setItem('_loamly_vid', newId)\n return newId\n } catch {\n // localStorage not available, generate ephemeral ID\n return generateUUID()\n }\n}\n\n/**\n * Get or create a session ID using sessionStorage\n * (Cookie-free session tracking)\n */\nexport function getSessionId(): { sessionId: string; isNew: boolean } {\n try {\n const storedSession = sessionStorage.getItem('loamly_session')\n const storedStart = sessionStorage.getItem('loamly_start')\n \n if (storedSession && storedStart) {\n return { sessionId: storedSession, isNew: false }\n }\n \n const newSession = generateUUID()\n const startTime = Date.now().toString()\n \n sessionStorage.setItem('loamly_session', newSession)\n sessionStorage.setItem('loamly_start', startTime)\n \n return { sessionId: newSession, isNew: true }\n } catch {\n // sessionStorage not available\n return { sessionId: generateUUID(), isNew: true }\n }\n}\n\n/**\n * Extract UTM parameters from URL\n */\nexport function extractUTMParams(url: string): Record<string, string> {\n const params: Record<string, string> = {}\n \n try {\n const searchParams = new URL(url).searchParams\n const utmKeys = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content']\n \n for (const key of utmKeys) {\n const value = searchParams.get(key)\n if (value) params[key] = value\n }\n } catch {\n // Invalid URL\n }\n \n return params\n}\n\n/**\n * Truncate text to max length\n */\nexport function truncateText(text: string, maxLength: number): string {\n if (text.length <= maxLength) return text\n return text.substring(0, maxLength - 3) + '...'\n}\n\n/**\n * Safe fetch with timeout\n */\nexport async function safeFetch(\n url: string,\n options: RequestInit,\n timeout = 10000\n): Promise<Response | null> {\n try {\n const controller = new AbortController()\n const timeoutId = setTimeout(() => controller.abort(), timeout)\n \n const response = await fetch(url, {\n ...options,\n signal: controller.signal,\n })\n \n clearTimeout(timeoutId)\n return response\n } catch {\n return null\n }\n}\n\n/**\n * Send beacon (for unload events)\n */\nexport function sendBeacon(url: string, data: unknown): boolean {\n if (typeof navigator !== 'undefined' && navigator.sendBeacon) {\n return navigator.sendBeacon(url, JSON.stringify(data))\n }\n return false\n}\n\n\n","/**\n * Loamly Tracker Core\n * \n * Cookie-free, privacy-first analytics with AI traffic detection.\n * \n * @module @loamly/tracker\n */\n\nimport { VERSION, DEFAULT_CONFIG } from './config'\nimport { detectNavigationType } from './detection/navigation-timing'\nimport { detectAIFromReferrer, detectAIFromUTM } from './detection/referrer'\nimport { \n getVisitorId, \n getSessionId, \n extractUTMParams, \n truncateText,\n safeFetch,\n sendBeacon \n} from './utils'\nimport type { \n LoamlyConfig, \n LoamlyTracker, \n TrackEventOptions, \n NavigationTiming,\n AIDetectionResult \n} from './types'\n\n// State\nlet config: LoamlyConfig & { apiHost: string } = { apiHost: DEFAULT_CONFIG.apiHost }\nlet initialized = false\nlet debugMode = false\nlet visitorId: string | null = null\nlet sessionId: string | null = null\nlet sessionStartTime: number | null = null\nlet navigationTiming: NavigationTiming | null = null\nlet aiDetection: AIDetectionResult | null = null\n\n/**\n * Debug logger\n */\nfunction log(...args: unknown[]): void {\n if (debugMode) {\n console.log('[Loamly]', ...args)\n }\n}\n\n/**\n * Build API endpoint URL\n */\nfunction endpoint(path: string): string {\n return `${config.apiHost}${path}`\n}\n\n/**\n * Initialize the tracker\n */\nfunction init(userConfig: LoamlyConfig = {}): void {\n if (initialized) {\n log('Already initialized')\n return\n }\n\n config = {\n ...config,\n ...userConfig,\n apiHost: userConfig.apiHost || DEFAULT_CONFIG.apiHost,\n }\n \n debugMode = userConfig.debug ?? false\n \n log('Initializing Loamly Tracker v' + VERSION)\n \n // Get/create visitor ID\n visitorId = getVisitorId()\n log('Visitor ID:', visitorId)\n \n // Get/create session\n const session = getSessionId()\n sessionId = session.sessionId\n sessionStartTime = Date.now()\n log('Session ID:', sessionId, session.isNew ? '(new)' : '(existing)')\n \n // Detect navigation timing (paste vs click)\n navigationTiming = detectNavigationType()\n log('Navigation timing:', navigationTiming)\n \n // Detect AI from referrer\n aiDetection = detectAIFromReferrer(document.referrer) || detectAIFromUTM(window.location.href)\n if (aiDetection) {\n log('AI detected:', aiDetection)\n }\n \n initialized = true\n \n // Auto pageview unless disabled\n if (!userConfig.disableAutoPageview) {\n pageview()\n }\n \n // Set up behavioral tracking unless disabled\n if (!userConfig.disableBehavioral) {\n setupBehavioralTracking()\n }\n \n log('Initialization complete')\n}\n\n/**\n * Track a page view\n */\nfunction pageview(customUrl?: string): void {\n if (!initialized) {\n log('Not initialized, call init() first')\n return\n }\n\n const url = customUrl || window.location.href\n const payload = {\n visitor_id: visitorId,\n session_id: sessionId,\n url,\n referrer: document.referrer || null,\n title: document.title || null,\n utm_source: extractUTMParams(url).utm_source || null,\n utm_medium: extractUTMParams(url).utm_medium || null,\n utm_campaign: extractUTMParams(url).utm_campaign || null,\n user_agent: navigator.userAgent,\n screen_width: window.screen?.width,\n screen_height: window.screen?.height,\n language: navigator.language,\n timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,\n tracker_version: VERSION,\n navigation_timing: navigationTiming,\n ai_platform: aiDetection?.platform || null,\n is_ai_referrer: aiDetection?.isAI || false,\n }\n\n log('Pageview:', payload)\n\n safeFetch(endpoint(DEFAULT_CONFIG.endpoints.visit), {\n method: 'POST',\n headers: { 'Content-Type': 'application/json' },\n body: JSON.stringify(payload),\n })\n}\n\n/**\n * Track a custom event\n */\nfunction track(eventName: string, options: TrackEventOptions = {}): void {\n if (!initialized) {\n log('Not initialized, call init() first')\n return\n }\n\n const payload = {\n visitor_id: visitorId,\n session_id: sessionId,\n event_name: eventName,\n event_type: 'custom',\n properties: options.properties || {},\n revenue: options.revenue,\n currency: options.currency || 'USD',\n url: window.location.href,\n timestamp: new Date().toISOString(),\n tracker_version: VERSION,\n }\n\n log('Event:', eventName, payload)\n\n safeFetch(endpoint('/api/ingest/event'), {\n method: 'POST',\n headers: { 'Content-Type': 'application/json' },\n body: JSON.stringify(payload),\n })\n}\n\n/**\n * Track a conversion/revenue event\n */\nfunction conversion(eventName: string, revenue: number, currency = 'USD'): void {\n track(eventName, { revenue, currency, properties: { type: 'conversion' } })\n}\n\n/**\n * Identify a user\n */\nfunction identify(userId: string, traits: Record<string, unknown> = {}): void {\n if (!initialized) {\n log('Not initialized, call init() first')\n return\n }\n\n log('Identify:', userId, traits)\n\n const payload = {\n visitor_id: visitorId,\n session_id: sessionId,\n user_id: userId,\n traits,\n timestamp: new Date().toISOString(),\n }\n\n safeFetch(endpoint('/api/ingest/identify'), {\n method: 'POST',\n headers: { 'Content-Type': 'application/json' },\n body: JSON.stringify(payload),\n })\n}\n\n/**\n * Set up behavioral tracking (scroll, time spent, etc.)\n */\nfunction setupBehavioralTracking(): void {\n let maxScrollDepth = 0\n let lastScrollUpdate = 0\n let lastTimeUpdate = Date.now()\n\n // Scroll tracking with requestAnimationFrame throttling\n let scrollTicking = false\n \n window.addEventListener('scroll', () => {\n if (!scrollTicking) {\n requestAnimationFrame(() => {\n const scrollPercent = Math.round(\n ((window.scrollY + window.innerHeight) / document.documentElement.scrollHeight) * 100\n )\n \n if (scrollPercent > maxScrollDepth) {\n maxScrollDepth = scrollPercent\n \n // Report at milestones (25%, 50%, 75%, 100%)\n const milestones = [25, 50, 75, 100]\n for (const milestone of milestones) {\n if (scrollPercent >= milestone && lastScrollUpdate < milestone) {\n lastScrollUpdate = milestone\n sendBehavioralEvent('scroll_depth', { depth: milestone })\n }\n }\n }\n \n scrollTicking = false\n })\n scrollTicking = true\n }\n })\n\n // Time spent tracking (every 5 seconds minimum)\n const trackTimeSpent = (): void => {\n const now = Date.now()\n const delta = now - lastTimeUpdate\n \n if (delta >= DEFAULT_CONFIG.timeSpentThresholdMs) {\n lastTimeUpdate = now\n sendBehavioralEvent('time_spent', { \n seconds: Math.round(delta / 1000),\n total_seconds: Math.round((now - (sessionStartTime || now)) / 1000)\n })\n }\n }\n\n // Track on visibility change\n document.addEventListener('visibilitychange', () => {\n if (document.visibilityState === 'hidden') {\n trackTimeSpent()\n }\n })\n\n // Track on page unload\n window.addEventListener('beforeunload', () => {\n trackTimeSpent()\n \n // Send final scroll depth\n if (maxScrollDepth > 0) {\n sendBeacon(endpoint(DEFAULT_CONFIG.endpoints.behavioral), {\n visitor_id: visitorId,\n session_id: sessionId,\n event_type: 'scroll_depth_final',\n data: { depth: maxScrollDepth },\n url: window.location.href,\n })\n }\n })\n\n // Form interaction tracking\n document.addEventListener('focusin', (e) => {\n const target = e.target as HTMLElement\n if (target.tagName === 'INPUT' || target.tagName === 'TEXTAREA' || target.tagName === 'SELECT') {\n sendBehavioralEvent('form_focus', {\n field_type: target.tagName.toLowerCase(),\n field_name: (target as HTMLInputElement).name || (target as HTMLInputElement).id || 'unknown',\n })\n }\n })\n\n // Form submit tracking\n document.addEventListener('submit', (e) => {\n const form = e.target as HTMLFormElement\n sendBehavioralEvent('form_submit', {\n form_id: form.id || form.name || 'unknown',\n form_action: form.action ? new URL(form.action).pathname : 'unknown',\n })\n })\n\n // Click tracking for links\n document.addEventListener('click', (e) => {\n const target = e.target as HTMLElement\n const link = target.closest('a')\n \n if (link && link.href) {\n const isExternal = link.hostname !== window.location.hostname\n sendBehavioralEvent('click', {\n element: 'link',\n href: truncateText(link.href, 200),\n text: truncateText(link.textContent || '', 100),\n is_external: isExternal,\n })\n }\n })\n}\n\n/**\n * Send a behavioral event\n */\nfunction sendBehavioralEvent(eventType: string, data: Record<string, unknown>): void {\n const payload = {\n visitor_id: visitorId,\n session_id: sessionId,\n event_type: eventType,\n data,\n url: window.location.href,\n timestamp: new Date().toISOString(),\n tracker_version: VERSION,\n }\n\n log('Behavioral:', eventType, data)\n\n safeFetch(endpoint(DEFAULT_CONFIG.endpoints.behavioral), {\n method: 'POST',\n headers: { 'Content-Type': 'application/json' },\n body: JSON.stringify(payload),\n })\n}\n\n/**\n * Get current session ID\n */\nfunction getCurrentSessionId(): string | null {\n return sessionId\n}\n\n/**\n * Get current visitor ID\n */\nfunction getCurrentVisitorId(): string | null {\n return visitorId\n}\n\n/**\n * Get AI detection result\n */\nfunction getAIDetectionResult(): AIDetectionResult | null {\n return aiDetection\n}\n\n/**\n * Get navigation timing result\n */\nfunction getNavigationTimingResult(): NavigationTiming | null {\n return navigationTiming\n}\n\n/**\n * Check if initialized\n */\nfunction isTrackerInitialized(): boolean {\n return initialized\n}\n\n/**\n * Reset the tracker\n */\nfunction reset(): void {\n log('Resetting tracker')\n initialized = false\n visitorId = null\n sessionId = null\n sessionStartTime = null\n navigationTiming = null\n aiDetection = null\n \n try {\n sessionStorage.removeItem('loamly_session')\n sessionStorage.removeItem('loamly_start')\n } catch {\n // Ignore\n }\n}\n\n/**\n * Enable/disable debug mode\n */\nfunction setDebug(enabled: boolean): void {\n debugMode = enabled\n log('Debug mode:', enabled ? 'enabled' : 'disabled')\n}\n\n/**\n * The Loamly Tracker instance\n */\nexport const loamly: LoamlyTracker = {\n init,\n pageview,\n track,\n conversion,\n identify,\n getSessionId: getCurrentSessionId,\n getVisitorId: getCurrentVisitorId,\n getAIDetection: getAIDetectionResult,\n getNavigationTiming: getNavigationTimingResult,\n isInitialized: isTrackerInitialized,\n reset,\n debug: setDebug,\n}\n\nexport default loamly\n\n\n"],"mappings":"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","names":["browser_exports","__export","browser_default","loamly","VERSION","DEFAULT_CONFIG","AI_PLATFORMS","detectNavigationType","entries","nav","signals","pasteScore","fetchStartDelta","calculateTimingVariance","confidence","timings","t","mean","a","b","variance","sum","detectAIFromReferrer","referrer","hostname","pattern","platform","AI_PLATFORMS","detectAIFromUTM","url","utmSource","generateUUID","c","r","getVisitorId","stored","newId","getSessionId","storedSession","storedStart","newSession","startTime","extractUTMParams","url","params","searchParams","utmKeys","key","value","truncateText","text","maxLength","safeFetch","options","timeout","controller","timeoutId","response","sendBeacon","data","config","DEFAULT_CONFIG","initialized","debugMode","visitorId","sessionId","sessionStartTime","navigationTiming","aiDetection","log","args","endpoint","path","init","userConfig","VERSION","getVisitorId","session","getSessionId","detectNavigationType","detectAIFromReferrer","detectAIFromUTM","pageview","setupBehavioralTracking","customUrl","url","payload","extractUTMParams","safeFetch","track","eventName","options","conversion","revenue","currency","identify","userId","traits","maxScrollDepth","lastScrollUpdate","lastTimeUpdate","scrollTicking","scrollPercent","milestones","milestone","sendBehavioralEvent","trackTimeSpent","now","delta","sendBeacon","e","target","form","link","isExternal","truncateText","eventType","data","getCurrentSessionId","getCurrentVisitorId","getAIDetectionResult","getNavigationTimingResult","isTrackerInitialized","reset","setDebug","enabled","loamly","autoInit","scripts","scriptTag","script","config","loamly","browser_default","loamly"]}
|
package/package.json
ADDED
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@loamly/tracker",
|
|
3
|
+
"version": "1.6.0",
|
|
4
|
+
"description": "Open-source AI traffic detection for websites",
|
|
5
|
+
"author": "Loamly <hello@loamly.ai>",
|
|
6
|
+
"license": "MIT",
|
|
7
|
+
"homepage": "https://loamly.ai",
|
|
8
|
+
"repository": {
|
|
9
|
+
"type": "git",
|
|
10
|
+
"url": "git+https://github.com/loamly/loamly.git",
|
|
11
|
+
"directory": "packages/tracker"
|
|
12
|
+
},
|
|
13
|
+
"bugs": {
|
|
14
|
+
"url": "https://github.com/loamly/loamly/issues"
|
|
15
|
+
},
|
|
16
|
+
"keywords": [
|
|
17
|
+
"analytics",
|
|
18
|
+
"ai-traffic",
|
|
19
|
+
"tracking",
|
|
20
|
+
"dark-traffic",
|
|
21
|
+
"chatgpt",
|
|
22
|
+
"claude",
|
|
23
|
+
"perplexity",
|
|
24
|
+
"open-source"
|
|
25
|
+
],
|
|
26
|
+
"main": "./dist/index.cjs",
|
|
27
|
+
"module": "./dist/index.mjs",
|
|
28
|
+
"unpkg": "./dist/loamly.iife.min.global.js",
|
|
29
|
+
"jsdelivr": "./dist/loamly.iife.min.global.js",
|
|
30
|
+
"types": "./dist/index.d.ts",
|
|
31
|
+
"exports": {
|
|
32
|
+
".": {
|
|
33
|
+
"types": "./dist/index.d.ts",
|
|
34
|
+
"import": "./dist/index.mjs",
|
|
35
|
+
"require": "./dist/index.cjs"
|
|
36
|
+
},
|
|
37
|
+
"./browser": "./dist/loamly.iife.min.global.js",
|
|
38
|
+
"./script": "./dist/loamly.iife.min.global.js"
|
|
39
|
+
},
|
|
40
|
+
"files": [
|
|
41
|
+
"dist",
|
|
42
|
+
"src",
|
|
43
|
+
"README.md"
|
|
44
|
+
],
|
|
45
|
+
"sideEffects": false,
|
|
46
|
+
"engines": {
|
|
47
|
+
"node": ">=18"
|
|
48
|
+
},
|
|
49
|
+
"scripts": {
|
|
50
|
+
"build": "tsup",
|
|
51
|
+
"dev": "tsup --watch",
|
|
52
|
+
"typecheck": "tsc --noEmit",
|
|
53
|
+
"test": "vitest run",
|
|
54
|
+
"clean": "rm -rf dist"
|
|
55
|
+
},
|
|
56
|
+
"devDependencies": {
|
|
57
|
+
"@types/node": "^20.10.0",
|
|
58
|
+
"tsup": "^8.0.1",
|
|
59
|
+
"typescript": "^5.3.3",
|
|
60
|
+
"vitest": "^1.1.0"
|
|
61
|
+
},
|
|
62
|
+
"publishConfig": {
|
|
63
|
+
"access": "public",
|
|
64
|
+
"registry": "https://registry.npmjs.org/"
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
|
package/src/browser.ts
ADDED
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Loamly Tracker - Browser Bundle (IIFE)
|
|
3
|
+
*
|
|
4
|
+
* This file is the entry point for the browser script tag version.
|
|
5
|
+
* It auto-initializes from data attributes on the script tag.
|
|
6
|
+
*
|
|
7
|
+
* Usage:
|
|
8
|
+
* <script src="https://unpkg.com/@loamly/tracker" data-api-key="your-key"></script>
|
|
9
|
+
*
|
|
10
|
+
* @module @loamly/tracker/browser
|
|
11
|
+
*/
|
|
12
|
+
|
|
13
|
+
import { loamly } from './core'
|
|
14
|
+
import type { LoamlyConfig } from './types'
|
|
15
|
+
|
|
16
|
+
// Auto-initialize from script tag data attributes
|
|
17
|
+
function autoInit(): void {
|
|
18
|
+
// Find the script tag that loaded us
|
|
19
|
+
const scripts = document.getElementsByTagName('script')
|
|
20
|
+
let scriptTag: HTMLScriptElement | null = null
|
|
21
|
+
|
|
22
|
+
for (const script of scripts) {
|
|
23
|
+
if (script.src.includes('loamly') || script.dataset.loamly !== undefined) {
|
|
24
|
+
scriptTag = script
|
|
25
|
+
break
|
|
26
|
+
}
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
if (!scriptTag) {
|
|
30
|
+
// No matching script tag found, don't auto-init
|
|
31
|
+
return
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
// Extract configuration from data attributes
|
|
35
|
+
const config: LoamlyConfig = {}
|
|
36
|
+
|
|
37
|
+
if (scriptTag.dataset.apiKey) {
|
|
38
|
+
config.apiKey = scriptTag.dataset.apiKey
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
if (scriptTag.dataset.apiHost) {
|
|
42
|
+
config.apiHost = scriptTag.dataset.apiHost
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
if (scriptTag.dataset.debug === 'true') {
|
|
46
|
+
config.debug = true
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
if (scriptTag.dataset.disableAutoPageview === 'true') {
|
|
50
|
+
config.disableAutoPageview = true
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
if (scriptTag.dataset.disableBehavioral === 'true') {
|
|
54
|
+
config.disableBehavioral = true
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
// Initialize if we have configuration
|
|
58
|
+
if (config.apiKey || scriptTag.dataset.loamly !== undefined) {
|
|
59
|
+
loamly.init(config)
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
// Run auto-init when DOM is ready
|
|
64
|
+
if (typeof document !== 'undefined') {
|
|
65
|
+
if (document.readyState === 'loading') {
|
|
66
|
+
document.addEventListener('DOMContentLoaded', autoInit)
|
|
67
|
+
} else {
|
|
68
|
+
// Use requestIdleCallback if available for non-blocking init
|
|
69
|
+
if (typeof requestIdleCallback !== 'undefined') {
|
|
70
|
+
requestIdleCallback(autoInit)
|
|
71
|
+
} else {
|
|
72
|
+
setTimeout(autoInit, 0)
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
// Export for manual usage
|
|
78
|
+
export { loamly }
|
|
79
|
+
export default loamly
|
|
80
|
+
|
|
81
|
+
|
package/src/config.ts
ADDED
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Loamly Tracker Configuration
|
|
3
|
+
* @module @loamly/tracker
|
|
4
|
+
*/
|
|
5
|
+
|
|
6
|
+
export const VERSION = '1.6.0'
|
|
7
|
+
|
|
8
|
+
export const DEFAULT_CONFIG = {
|
|
9
|
+
apiHost: 'https://app.loamly.ai',
|
|
10
|
+
endpoints: {
|
|
11
|
+
visit: '/api/ingest/visit',
|
|
12
|
+
behavioral: '/api/ingest/behavioral',
|
|
13
|
+
session: '/api/ingest/session',
|
|
14
|
+
resolve: '/api/tracker/resolve',
|
|
15
|
+
health: '/api/tracker/health',
|
|
16
|
+
ping: '/api/tracker/ping',
|
|
17
|
+
},
|
|
18
|
+
pingInterval: 30000, // 30 seconds
|
|
19
|
+
batchSize: 10,
|
|
20
|
+
batchTimeout: 5000,
|
|
21
|
+
sessionTimeout: 1800000, // 30 minutes
|
|
22
|
+
maxTextLength: 100,
|
|
23
|
+
timeSpentThresholdMs: 5000, // Only send time_spent when delta >= 5 seconds
|
|
24
|
+
} as const
|
|
25
|
+
|
|
26
|
+
/**
|
|
27
|
+
* Known AI platforms for referrer detection
|
|
28
|
+
*/
|
|
29
|
+
export const AI_PLATFORMS: Record<string, string> = {
|
|
30
|
+
'chatgpt.com': 'chatgpt',
|
|
31
|
+
'chat.openai.com': 'chatgpt',
|
|
32
|
+
'claude.ai': 'claude',
|
|
33
|
+
'perplexity.ai': 'perplexity',
|
|
34
|
+
'bard.google.com': 'bard',
|
|
35
|
+
'gemini.google.com': 'gemini',
|
|
36
|
+
'copilot.microsoft.com': 'copilot',
|
|
37
|
+
'github.com/copilot': 'github-copilot',
|
|
38
|
+
'you.com': 'you',
|
|
39
|
+
'phind.com': 'phind',
|
|
40
|
+
'poe.com': 'poe',
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
/**
|
|
44
|
+
* User agents of known AI crawlers
|
|
45
|
+
*/
|
|
46
|
+
export const AI_BOT_PATTERNS = [
|
|
47
|
+
'GPTBot',
|
|
48
|
+
'ChatGPT-User',
|
|
49
|
+
'ClaudeBot',
|
|
50
|
+
'Claude-Web',
|
|
51
|
+
'PerplexityBot',
|
|
52
|
+
'Amazonbot',
|
|
53
|
+
'Google-Extended',
|
|
54
|
+
'CCBot',
|
|
55
|
+
'anthropic-ai',
|
|
56
|
+
'cohere-ai',
|
|
57
|
+
]
|
|
58
|
+
|
|
59
|
+
|