@grainql/analytics-web 2.2.1 → 2.3.0

package/dist/attribution.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Attribution and Referral Tracking for Grain Analytics
+ * Handles referral categorization and first-touch attribution
+ */
+export type ReferrerCategory = 'organic' | 'paid' | 'social' | 'direct' | 'email' | 'referral';
+export interface UTMParameters {
+    utm_source?: string;
+    utm_medium?: string;
+    utm_campaign?: string;
+    utm_term?: string;
+    utm_content?: string;
+}
+export interface FirstTouchAttribution {
+    source: string;
+    medium: string;
+    campaign: string;
+    referrer: string;
+    referrer_category: ReferrerCategory;
+    timestamp: number;
+}
+/**
+ * Categorize referrer based on domain and parameters
+ */
+export declare function categorizeReferrer(referrer: string, currentUrl?: string): ReferrerCategory;
+/**
+ * Parse UTM parameters from URL
+ */
+export declare function parseUTMParameters(url: string): UTMParameters;
+/**
+ * Get first-touch attribution from localStorage
+ */
+export declare function getFirstTouchAttribution(tenantId: string): FirstTouchAttribution | null;
+/**
+ * Set first-touch attribution in localStorage
+ */
+export declare function setFirstTouchAttribution(tenantId: string, attribution: FirstTouchAttribution): void;
+/**
+ * Get or create first-touch attribution
+ */
+export declare function getOrCreateFirstTouchAttribution(tenantId: string, referrer: string, currentUrl: string, utmParams: UTMParameters): FirstTouchAttribution;
+export declare function getSessionUTMParameters(): UTMParameters | null;
+export declare function setSessionUTMParameters(params: UTMParameters): void;
+/**
+ * Clear session UTM parameters
+ */
+export declare function clearSessionUTMParameters(): void;
+//# sourceMappingURL=attribution.d.ts.map

package/dist/attribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attribution.d.ts","sourceRoot":"","sources":["../src/attribution.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;AAE/F,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,gBAAgB,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB;AAkFD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,GAAE,MAAW,GAAG,gBAAgB,CAsC9F;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAqB7D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,CAgBvF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,qBAAqB,GACjC,IAAI,CAWN;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,aAAa,GACvB,qBAAqB,CAwBvB;AAOD,wBAAgB,uBAAuB,IAAI,aAAa,GAAG,IAAI,CAE9D;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAEnE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}

package/dist/attribution.js

@@ -0,0 +1,228 @@
+"use strict";
+/**
+ * Attribution and Referral Tracking for Grain Analytics
+ * Handles referral categorization and first-touch attribution
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.categorizeReferrer = categorizeReferrer;
+exports.parseUTMParameters = parseUTMParameters;
+exports.getFirstTouchAttribution = getFirstTouchAttribution;
+exports.setFirstTouchAttribution = setFirstTouchAttribution;
+exports.getOrCreateFirstTouchAttribution = getOrCreateFirstTouchAttribution;
+exports.getSessionUTMParameters = getSessionUTMParameters;
+exports.setSessionUTMParameters = setSessionUTMParameters;
+exports.clearSessionUTMParameters = clearSessionUTMParameters;
+/**
+ * Known paid search parameters
+ */
+const PAID_SEARCH_PARAMS = [
+    'gclid', // Google Ads
+    'msclkid', // Microsoft Ads
+    'fbclid', // Facebook Ads
+    'ttclid', // TikTok Ads
+    'li_fat_id', // LinkedIn Ads
+    'twclid', // Twitter Ads
+    'ScCid', // Snapchat Ads
+];
+/**
+ * Known social media domains
+ */
+const SOCIAL_DOMAINS = [
+    'facebook.com',
+    'twitter.com',
+    'x.com',
+    'linkedin.com',
+    'instagram.com',
+    'pinterest.com',
+    'reddit.com',
+    'tiktok.com',
+    'youtube.com',
+    'snapchat.com',
+    't.co', // Twitter short links
+    'fb.me', // Facebook short links
+    'lnkd.in', // LinkedIn short links
+];
+/**
+ * Known organic search engines
+ */
+const SEARCH_ENGINES = [
+    'google.',
+    'bing.com',
+    'yahoo.com',
+    'duckduckgo.com',
+    'baidu.com',
+    'yandex.com',
+    'ecosia.org',
+    'ask.com',
+];
+/**
+ * Email client domains
+ */
+const EMAIL_DOMAINS = [
+    'mail.google.com',
+    'outlook.live.com',
+    'mail.yahoo.com',
+    'mail.aol.com',
+];
+/**
+ * Extract domain from URL
+ */
+function extractDomain(url) {
+    try {
+        const urlObj = new URL(url);
+        return urlObj.hostname.toLowerCase();
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Check if URL contains paid search parameters
+ */
+function hasPaidSearchParams(url) {
+    try {
+        const urlObj = new URL(url);
+        return PAID_SEARCH_PARAMS.some(param => urlObj.searchParams.has(param));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Categorize referrer based on domain and parameters
+ */
+function categorizeReferrer(referrer, currentUrl = '') {
+    // Direct traffic (no referrer)
+    if (!referrer || referrer.trim() === '') {
+        return 'direct';
+    }
+    const domain = extractDomain(referrer);
+    // Same domain = direct
+    if (currentUrl) {
+        const currentDomain = extractDomain(currentUrl);
+        if (domain === currentDomain) {
+            return 'direct';
+        }
+    }
+    // Check for paid search parameters
+    if (hasPaidSearchParams(referrer) || hasPaidSearchParams(currentUrl)) {
+        return 'paid';
+    }
+    // Email clients
+    if (EMAIL_DOMAINS.some(emailDomain => domain.includes(emailDomain))) {
+        return 'email';
+    }
+    // Social media
+    if (SOCIAL_DOMAINS.some(socialDomain => domain.includes(socialDomain))) {
+        return 'social';
+    }
+    // Organic search engines
+    if (SEARCH_ENGINES.some(searchEngine => domain.includes(searchEngine))) {
+        return 'organic';
+    }
+    // Everything else is referral
+    return 'referral';
+}
+/**
+ * Parse UTM parameters from URL
+ */
+function parseUTMParameters(url) {
+    try {
+        const urlObj = new URL(url);
+        const params = {};
+        const utmSource = urlObj.searchParams.get('utm_source');
+        const utmMedium = urlObj.searchParams.get('utm_medium');
+        const utmCampaign = urlObj.searchParams.get('utm_campaign');
+        const utmTerm = urlObj.searchParams.get('utm_term');
+        const utmContent = urlObj.searchParams.get('utm_content');
+        if (utmSource)
+            params.utm_source = utmSource;
+        if (utmMedium)
+            params.utm_medium = utmMedium;
+        if (utmCampaign)
+            params.utm_campaign = utmCampaign;
+        if (utmTerm)
+            params.utm_term = utmTerm;
+        if (utmContent)
+            params.utm_content = utmContent;
+        return params;
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Get first-touch attribution from localStorage
+ */
+function getFirstTouchAttribution(tenantId) {
+    if (typeof window === 'undefined' || typeof localStorage === 'undefined') {
+        return null;
+    }
+    try {
+        const key = `_grain_first_touch_${tenantId}`;
+        const stored = localStorage.getItem(key);
+        if (stored) {
+            return JSON.parse(stored);
+        }
+    }
+    catch (error) {
+        console.warn('[Grain Attribution] Failed to retrieve first-touch attribution:', error);
+    }
+    return null;
+}
+/**
+ * Set first-touch attribution in localStorage
+ */
+function setFirstTouchAttribution(tenantId, attribution) {
+    if (typeof window === 'undefined' || typeof localStorage === 'undefined') {
+        return;
+    }
+    try {
+        const key = `_grain_first_touch_${tenantId}`;
+        localStorage.setItem(key, JSON.stringify(attribution));
+    }
+    catch (error) {
+        console.warn('[Grain Attribution] Failed to store first-touch attribution:', error);
+    }
+}
+/**
+ * Get or create first-touch attribution
+ */
+function getOrCreateFirstTouchAttribution(tenantId, referrer, currentUrl, utmParams) {
+    // Try to get existing first-touch
+    const existing = getFirstTouchAttribution(tenantId);
+    if (existing) {
+        return existing;
+    }
+    // Create new first-touch attribution
+    const referrerCategory = categorizeReferrer(referrer, currentUrl);
+    const referrerDomain = extractDomain(referrer);
+    const firstTouch = {
+        source: utmParams.utm_source || referrerDomain || 'direct',
+        medium: utmParams.utm_medium || referrerCategory,
+        campaign: utmParams.utm_campaign || 'none',
+        referrer: referrer || 'direct',
+        referrer_category: referrerCategory,
+        timestamp: Date.now(),
+    };
+    // Store it
+    setFirstTouchAttribution(tenantId, firstTouch);
+    return firstTouch;
+}
+/**
+ * Get session UTM parameters (memory-only, not persisted across page loads)
+ */
+let sessionUTMParams = null;
+function getSessionUTMParameters() {
+    return sessionUTMParams;
+}
+function setSessionUTMParameters(params) {
+    sessionUTMParams = params;
+}
+/**
+ * Clear session UTM parameters
+ */
+function clearSessionUTMParameters() {
+    sessionUTMParams = null;
+}
+//# sourceMappingURL=attribution.js.map

package/dist/cjs/attribution.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Attribution and Referral Tracking for Grain Analytics
+ * Handles referral categorization and first-touch attribution
+ */
+export type ReferrerCategory = 'organic' | 'paid' | 'social' | 'direct' | 'email' | 'referral';
+export interface UTMParameters {
+    utm_source?: string;
+    utm_medium?: string;
+    utm_campaign?: string;
+    utm_term?: string;
+    utm_content?: string;
+}
+export interface FirstTouchAttribution {
+    source: string;
+    medium: string;
+    campaign: string;
+    referrer: string;
+    referrer_category: ReferrerCategory;
+    timestamp: number;
+}
+/**
+ * Categorize referrer based on domain and parameters
+ */
+export declare function categorizeReferrer(referrer: string, currentUrl?: string): ReferrerCategory;
+/**
+ * Parse UTM parameters from URL
+ */
+export declare function parseUTMParameters(url: string): UTMParameters;
+/**
+ * Get first-touch attribution from localStorage
+ */
+export declare function getFirstTouchAttribution(tenantId: string): FirstTouchAttribution | null;
+/**
+ * Set first-touch attribution in localStorage
+ */
+export declare function setFirstTouchAttribution(tenantId: string, attribution: FirstTouchAttribution): void;
+/**
+ * Get or create first-touch attribution
+ */
+export declare function getOrCreateFirstTouchAttribution(tenantId: string, referrer: string, currentUrl: string, utmParams: UTMParameters): FirstTouchAttribution;
+export declare function getSessionUTMParameters(): UTMParameters | null;
+export declare function setSessionUTMParameters(params: UTMParameters): void;
+/**
+ * Clear session UTM parameters
+ */
+export declare function clearSessionUTMParameters(): void;
+//# sourceMappingURL=attribution.d.ts.map

package/dist/cjs/attribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attribution.d.ts","sourceRoot":"","sources":["../../src/attribution.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;AAE/F,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,gBAAgB,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB;AAkFD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,GAAE,MAAW,GAAG,gBAAgB,CAsC9F;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAqB7D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,CAgBvF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,qBAAqB,GACjC,IAAI,CAWN;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,aAAa,GACvB,qBAAqB,CAwBvB;AAOD,wBAAgB,uBAAuB,IAAI,aAAa,GAAG,IAAI,CAE9D;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAEnE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}

package/dist/cjs/attribution.js

@@ -0,0 +1,228 @@
+"use strict";
+/**
+ * Attribution and Referral Tracking for Grain Analytics
+ * Handles referral categorization and first-touch attribution
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.categorizeReferrer = categorizeReferrer;
+exports.parseUTMParameters = parseUTMParameters;
+exports.getFirstTouchAttribution = getFirstTouchAttribution;
+exports.setFirstTouchAttribution = setFirstTouchAttribution;
+exports.getOrCreateFirstTouchAttribution = getOrCreateFirstTouchAttribution;
+exports.getSessionUTMParameters = getSessionUTMParameters;
+exports.setSessionUTMParameters = setSessionUTMParameters;
+exports.clearSessionUTMParameters = clearSessionUTMParameters;
+/**
+ * Known paid search parameters
+ */
+const PAID_SEARCH_PARAMS = [
+    'gclid', // Google Ads
+    'msclkid', // Microsoft Ads
+    'fbclid', // Facebook Ads
+    'ttclid', // TikTok Ads
+    'li_fat_id', // LinkedIn Ads
+    'twclid', // Twitter Ads
+    'ScCid', // Snapchat Ads
+];
+/**
+ * Known social media domains
+ */
+const SOCIAL_DOMAINS = [
+    'facebook.com',
+    'twitter.com',
+    'x.com',
+    'linkedin.com',
+    'instagram.com',
+    'pinterest.com',
+    'reddit.com',
+    'tiktok.com',
+    'youtube.com',
+    'snapchat.com',
+    't.co', // Twitter short links
+    'fb.me', // Facebook short links
+    'lnkd.in', // LinkedIn short links
+];
+/**
+ * Known organic search engines
+ */
+const SEARCH_ENGINES = [
+    'google.',
+    'bing.com',
+    'yahoo.com',
+    'duckduckgo.com',
+    'baidu.com',
+    'yandex.com',
+    'ecosia.org',
+    'ask.com',
+];
+/**
+ * Email client domains
+ */
+const EMAIL_DOMAINS = [
+    'mail.google.com',
+    'outlook.live.com',
+    'mail.yahoo.com',
+    'mail.aol.com',
+];
+/**
+ * Extract domain from URL
+ */
+function extractDomain(url) {
+    try {
+        const urlObj = new URL(url);
+        return urlObj.hostname.toLowerCase();
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Check if URL contains paid search parameters
+ */
+function hasPaidSearchParams(url) {
+    try {
+        const urlObj = new URL(url);
+        return PAID_SEARCH_PARAMS.some(param => urlObj.searchParams.has(param));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Categorize referrer based on domain and parameters
+ */
+function categorizeReferrer(referrer, currentUrl = '') {
+    // Direct traffic (no referrer)
+    if (!referrer || referrer.trim() === '') {
+        return 'direct';
+    }
+    const domain = extractDomain(referrer);
+    // Same domain = direct
+    if (currentUrl) {
+        const currentDomain = extractDomain(currentUrl);
+        if (domain === currentDomain) {
+            return 'direct';
+        }
+    }
+    // Check for paid search parameters
+    if (hasPaidSearchParams(referrer) || hasPaidSearchParams(currentUrl)) {
+        return 'paid';
+    }
+    // Email clients
+    if (EMAIL_DOMAINS.some(emailDomain => domain.includes(emailDomain))) {
+        return 'email';
+    }
+    // Social media
+    if (SOCIAL_DOMAINS.some(socialDomain => domain.includes(socialDomain))) {
+        return 'social';
+    }
+    // Organic search engines
+    if (SEARCH_ENGINES.some(searchEngine => domain.includes(searchEngine))) {
+        return 'organic';
+    }
+    // Everything else is referral
+    return 'referral';
+}
+/**
+ * Parse UTM parameters from URL
+ */
+function parseUTMParameters(url) {
+    try {
+        const urlObj = new URL(url);
+        const params = {};
+        const utmSource = urlObj.searchParams.get('utm_source');
+        const utmMedium = urlObj.searchParams.get('utm_medium');
+        const utmCampaign = urlObj.searchParams.get('utm_campaign');
+        const utmTerm = urlObj.searchParams.get('utm_term');
+        const utmContent = urlObj.searchParams.get('utm_content');
+        if (utmSource)
+            params.utm_source = utmSource;
+        if (utmMedium)
+            params.utm_medium = utmMedium;
+        if (utmCampaign)
+            params.utm_campaign = utmCampaign;
+        if (utmTerm)
+            params.utm_term = utmTerm;
+        if (utmContent)
+            params.utm_content = utmContent;
+        return params;
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Get first-touch attribution from localStorage
+ */
+function getFirstTouchAttribution(tenantId) {
+    if (typeof window === 'undefined' || typeof localStorage === 'undefined') {
+        return null;
+    }
+    try {
+        const key = `_grain_first_touch_${tenantId}`;
+        const stored = localStorage.getItem(key);
+        if (stored) {
+            return JSON.parse(stored);
+        }
+    }
+    catch (error) {
+        console.warn('[Grain Attribution] Failed to retrieve first-touch attribution:', error);
+    }
+    return null;
+}
+/**
+ * Set first-touch attribution in localStorage
+ */
+function setFirstTouchAttribution(tenantId, attribution) {
+    if (typeof window === 'undefined' || typeof localStorage === 'undefined') {
+        return;
+    }
+    try {
+        const key = `_grain_first_touch_${tenantId}`;
+        localStorage.setItem(key, JSON.stringify(attribution));
+    }
+    catch (error) {
+        console.warn('[Grain Attribution] Failed to store first-touch attribution:', error);
+    }
+}
+/**
+ * Get or create first-touch attribution
+ */
+function getOrCreateFirstTouchAttribution(tenantId, referrer, currentUrl, utmParams) {
+    // Try to get existing first-touch
+    const existing = getFirstTouchAttribution(tenantId);
+    if (existing) {
+        return existing;
+    }
+    // Create new first-touch attribution
+    const referrerCategory = categorizeReferrer(referrer, currentUrl);
+    const referrerDomain = extractDomain(referrer);
+    const firstTouch = {
+        source: utmParams.utm_source || referrerDomain || 'direct',
+        medium: utmParams.utm_medium || referrerCategory,
+        campaign: utmParams.utm_campaign || 'none',
+        referrer: referrer || 'direct',
+        referrer_category: referrerCategory,
+        timestamp: Date.now(),
+    };
+    // Store it
+    setFirstTouchAttribution(tenantId, firstTouch);
+    return firstTouch;
+}
+/**
+ * Get session UTM parameters (memory-only, not persisted across page loads)
+ */
+let sessionUTMParams = null;
+function getSessionUTMParameters() {
+    return sessionUTMParams;
+}
+function setSessionUTMParameters(params) {
+    sessionUTMParams = params;
+}
+/**
+ * Clear session UTM parameters
+ */
+function clearSessionUTMParameters() {
+    sessionUTMParams = null;
+}
+//# sourceMappingURL=attribution.js.map

package/dist/cjs/attribution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attribution.js","sourceRoot":"","sources":["../../src/attribution.ts"],"names":[],"mappings":"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"}

package/dist/cjs/heartbeat.d.ts

@@ -13,6 +13,7 @@ export interface HeartbeatTracker {
     hasConsent(category?: string): boolean;
     getEffectiveUserId(): string;
     getEphemeralSessionId(): string;
+    getSessionId(): string;
     getCurrentPage(): string | null;
     getEventCountSinceLastHeartbeat(): number;
     resetEventCountSinceLastHeartbeat(): void;

package/dist/cjs/heartbeat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"heartbeat.d.ts","sourceRoot":"","sources":["../../src/heartbeat.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/E,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACvC,kBAAkB,IAAI,MAAM,CAAC;IAC7B,qBAAqB,IAAI,MAAM,CAAC;IAChC,cAAc,IAAI,MAAM,GAAG,IAAI,CAAC;IAChC,+BAA+B,IAAI,MAAM,CAAC;IAC1C,iCAAiC,IAAI,IAAI,CAAC;CAC3C;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,wBAAwB,CAAS;gBAGvC,OAAO,EAAE,gBAAgB,EACzB,gBAAgB,EAAE,gBAAgB,EAClC,MAAM,EAAE,eAAe;IAezB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAkB7B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAyB7B;;OAEG;IACH,OAAO,CAAC,aAAa;IA0CrB;;OAEG;IACH,OAAO,IAAI,IAAI;CAchB"}
+{"version":3,"file":"heartbeat.d.ts","sourceRoot":"","sources":["../../src/heartbeat.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/E,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACvC,kBAAkB,IAAI,MAAM,CAAC;IAC7B,qBAAqB,IAAI,MAAM,CAAC;IAChC,YAAY,IAAI,MAAM,CAAC;IACvB,cAAc,IAAI,MAAM,GAAG,IAAI,CAAC;IAChC,+BAA+B,IAAI,MAAM,CAAC;IAC1C,iCAAiC,IAAI,IAAI,CAAC;CAC3C;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,wBAAwB,CAAS;gBAGvC,OAAO,EAAE,gBAAgB,EACzB,gBAAgB,EAAE,gBAAgB,EAClC,MAAM,EAAE,eAAe;IAezB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAkB7B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAyB7B;;OAEG;IACH,OAAO,CAAC,aAAa;IA2CrB;;OAEG;IACH,OAAO,IAAI,IAAI;CAchB"}

package/dist/cjs/heartbeat.js

@@ -74,7 +74,6 @@ class HeartbeatManager {
         const hasConsent = this.tracker.hasConsent('analytics');
         // Base properties (always included)
         const properties = {
-            type: 'heartbeat',
             heartbeat_type: heartbeatType,
             status: isActive ? 'active' : 'inactive',
             timestamp: now,
@@ -85,6 +84,7 @@ class HeartbeatManager {
             if (page) {
                 properties.page = page;
             }
+            properties.session_id = this.tracker.getSessionId();
             // Only include duration and event count for periodic heartbeats
             if (heartbeatType === 'periodic') {
                 properties.duration = now - this.lastHeartbeatTime;

package/dist/cjs/heartbeat.js.map

@@ -1 +1 @@
-{"version":3,"file":"heartbeat.js","sourceRoot":"","sources":["../../src/heartbeat.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"heartbeat.js","sourceRoot":"","sources":["../../src/heartbeat.ts"],"names":[],"mappings":"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"}

package/dist/cjs/index.d.ts

@@ -6,6 +6,9 @@ import { ConsentState, ConsentMode } from './consent';
 import { CookieConfig } from './cookies';
 import { type HeartbeatTracker } from './heartbeat';
 import { type PageTracker } from './page-tracking';
+import { categorizeReferrer, parseUTMParameters, type ReferrerCategory, type UTMParameters, type FirstTouchAttribution } from './attribution';
+export type { ReferrerCategory, UTMParameters, FirstTouchAttribution };
+export { categorizeReferrer, parseUTMParameters };
 export interface GrainEvent {
     eventName: string;
     userId?: string;
@@ -213,6 +216,8 @@ export declare class GrainAnalytics implements HeartbeatTracker, PageTracker {
     private pageTrackingManager;
     private ephemeralSessionId;
     private eventCountSinceLastHeartbeat;
+    private sessionStartTime;
+    private sessionEventCount;
     constructor(config: GrainConfig);
     private validateConfig;
     /**
@@ -285,6 +290,26 @@ export declare class GrainAnalytics implements HeartbeatTracker, PageTracker {
      * Initialize automatic tracking (heartbeat and page views)
      */
     private initializeAutomaticTracking;
+    /**
+     * Track session start event
+     */
+    private trackSessionStart;
+    /**
+     * Track session end event
+     */
+    private trackSessionEnd;
+    /**
+     * Detect browser name
+     */
+    private getBrowser;
+    /**
+     * Detect operating system
+     */
+    private getOS;
+    /**
+     * Detect device type (Mobile, Tablet, Desktop)
+     */
+    private getDeviceType;
     /**
      * Handle consent granted - upgrade ephemeral session to persistent user
      */