@tracelog/lib 2.1.1 → 2.1.2

package/dist/public-api.d.mts

@@ -688,6 +688,8 @@ interface State {
     hasStartSession: boolean;
     suppressNextScroll: boolean;
     scrollEventCount?: number;
+    sessionReferrer?: string;
+    sessionUtm?: UTM;
 }
 
 /**
@@ -1613,58 +1615,6 @@ declare class EventManager extends StateManager {
      * @internal
      */
     private cleanupExpiredSessionCounts;
-    /**
-     * Returns the referrer if it's external, or 'Direct' if internal/empty.
-     *
-     * **Purpose**: Filter out internal referrers (same domain) to ensure
-     * accurate traffic source attribution. Internal referrers occur when:
-     * - Session expires and user navigates within the same site
-     * - User opens new tab from an internal link
-     * - Page refresh after session timeout
-     *
-     * **Logic**:
-     * - Empty referrer → 'Direct'
-     * - Referrer from same domain or subdomain → 'Direct' (internal navigation)
-     * - External referrer → Returns original referrer
-     *
-     * **Subdomain Detection**:
-     * - `www.example.com` → `example.com` ✓ (internal)
-     * - `blog.example.com` → `example.com` ✓ (internal)
-     * - `example.com` → `www.example.com` ✓ (internal)
-     *
-     * @returns External referrer URL or 'Direct'
-     *
-     * @internal
-     */
-    private getExternalReferrer;
-    /**
-     * Checks if two hostnames belong to the same domain (including subdomains).
-     * Extracts root domain and compares to handle cross-subdomain navigation.
-     *
-     * @example
-     * isSameDomain('www.example.com', 'example.com') // true
-     * isSameDomain('app.example.com', 'www.example.com') // true
-     * isSameDomain('example.co.uk', 'app.example.co.uk') // true
-     *
-     * @param hostname1 - First hostname (e.g., 'www.example.com')
-     * @param hostname2 - Second hostname (e.g., 'app.example.com')
-     * @returns true if same root domain
-     *
-     * @internal
-     */
-    private isSameDomain;
-    /**
-     * Extracts the root (registrable) domain from a hostname.
-     * Handles both standard TLDs (.com, .org) and compound TLDs (.co.uk, .com.br).
-     *
-     * @example
-     * getRootDomain('www.example.com') // 'example.com'
-     * getRootDomain('app.blog.example.com') // 'example.com'
-     * getRootDomain('shop.example.co.uk') // 'example.co.uk'
-     *
-     * @internal
-     */
-    private getRootDomain;
     /**
      * Persists current session event counts to localStorage (debounced).
      *

package/dist/public-api.d.ts

@@ -688,6 +688,8 @@ interface State {
     hasStartSession: boolean;
     suppressNextScroll: boolean;
     scrollEventCount?: number;
+    sessionReferrer?: string;
+    sessionUtm?: UTM;
 }
 
 /**
@@ -1613,58 +1615,6 @@ declare class EventManager extends StateManager {
      * @internal
      */
     private cleanupExpiredSessionCounts;
-    /**
-     * Returns the referrer if it's external, or 'Direct' if internal/empty.
-     *
-     * **Purpose**: Filter out internal referrers (same domain) to ensure
-     * accurate traffic source attribution. Internal referrers occur when:
-     * - Session expires and user navigates within the same site
-     * - User opens new tab from an internal link
-     * - Page refresh after session timeout
-     *
-     * **Logic**:
-     * - Empty referrer → 'Direct'
-     * - Referrer from same domain or subdomain → 'Direct' (internal navigation)
-     * - External referrer → Returns original referrer
-     *
-     * **Subdomain Detection**:
-     * - `www.example.com` → `example.com` ✓ (internal)
-     * - `blog.example.com` → `example.com` ✓ (internal)
-     * - `example.com` → `www.example.com` ✓ (internal)
-     *
-     * @returns External referrer URL or 'Direct'
-     *
-     * @internal
-     */
-    private getExternalReferrer;
-    /**
-     * Checks if two hostnames belong to the same domain (including subdomains).
-     * Extracts root domain and compares to handle cross-subdomain navigation.
-     *
-     * @example
-     * isSameDomain('www.example.com', 'example.com') // true
-     * isSameDomain('app.example.com', 'www.example.com') // true
-     * isSameDomain('example.co.uk', 'app.example.co.uk') // true
-     *
-     * @param hostname1 - First hostname (e.g., 'www.example.com')
-     * @param hostname2 - Second hostname (e.g., 'app.example.com')
-     * @returns true if same root domain
-     *
-     * @internal
-     */
-    private isSameDomain;
-    /**
-     * Extracts the root (registrable) domain from a hostname.
-     * Handles both standard TLDs (.com, .org) and compound TLDs (.co.uk, .com.br).
-     *
-     * @example
-     * getRootDomain('www.example.com') // 'example.com'
-     * getRootDomain('app.blog.example.com') // 'example.com'
-     * getRootDomain('shop.example.co.uk') // 'example.co.uk'
-     *
-     * @internal
-     */
-    private getRootDomain;
     /**
      * Persists current session event counts to localStorage (debounced).
      *