humanbehavior-js 0.4.27 → 0.5.0

package/src/types/clack.d.ts

@@ -1,31 +0,0 @@
-declare module '@clack/prompts' {
-  export function intro(message: string): void;
-  export function outro(message: string): void;
-  export function cancel(message: string): void;
-  export function note(message: string, title?: string): void;
-  
-  export function text(options: {
-    message: string;
-    placeholder?: string;
-    defaultValue?: string;
-    validate?: (value: string) => string | undefined;
-  }): Promise<string>;
-  
-  export function select(options: {
-    message: string;
-    options: Array<{
-      label: string;
-      value: string;
-      hint?: string;
-    }>;
-  }): Promise<string>;
-  
-  export function confirm(options: {
-    message: string;
-  }): Promise<boolean>;
-  
-  export function spinner(): {
-    start(message: string): void;
-    stop(message?: string): void;
-  };
-}

package/src/utils/ip-detector.ts

@@ -1,158 +0,0 @@
-/**
- * IP Address Detection Utility
- * Attempts to get the client's public IP address using multiple methods
- */
-
-export interface IPInfo {
-    ip: string;
-    method: 'stun' | 'public-service' | 'fallback';
-    timestamp: number;
-}
-
-/**
- * Get IP address using STUN server (most reliable)
- */
-async function getIPFromSTUN(): Promise<string | null> {
-    try {
-        const pc = new RTCPeerConnection({
-            iceServers: [
-                { urls: 'stun:stun.l.google.com:19302' },
-                { urls: 'stun:stun1.l.google.com:19302' },
-                { urls: 'stun:stun2.l.google.com:19302' }
-            ]
-        });
-
-        return new Promise((resolve) => {
-            const timeout = setTimeout(() => {
-                pc.close();
-                resolve(null);
-            }, 5000);
-
-            pc.createDataChannel('');
-            pc.createOffer()
-                .then(offer => pc.setLocalDescription(offer))
-                .catch(() => resolve(null));
-
-            pc.onicecandidate = (event) => {
-                if (event.candidate) {
-                    const candidate = event.candidate.candidate;
-                    const match = candidate.match(/([0-9]{1,3}(\.[0-9]{1,3}){3})/);
-                    if (match) {
-                        clearTimeout(timeout);
-                        pc.close();
-                        resolve(match[1]);
-                    }
-                }
-            };
-        });
-    } catch (error) {
-        return null;
-    }
-}
-
-/**
- * Get IP address using public IP service (fallback)
- */
-async function getIPFromPublicService(): Promise<string | null> {
-    try {
-        const response = await fetch('https://api.ipify.org?format=json', {
-            method: 'GET'
-        });
-        
-        if (response.ok) {
-            const data = await response.json();
-            return data.ip;
-        }
-    } catch (error) {
-        // Try alternative service
-        try {
-            const response = await fetch('https://httpbin.org/ip', {
-                method: 'GET'
-            });
-            
-            if (response.ok) {
-                const data = await response.json();
-                return data.origin;
-            }
-        } catch (fallbackError) {
-            // Last resort
-            try {
-                const response = await fetch('https://api.myip.com', {
-                    method: 'GET'
-                });
-                
-                if (response.ok) {
-                    const data = await response.json();
-                    return data.ip;
-                }
-            } catch (lastError) {
-                return null;
-            }
-        }
-    }
-    
-    return null;
-}
-
-/**
- * Get client's public IP address
- * Tries STUN first (most reliable), then falls back to public services
- */
-export async function getClientIP(): Promise<IPInfo | null> {
-    const startTime = Date.now();
-    
-    // Try STUN first (most reliable and privacy-friendly)
-    const stunIP = await getIPFromSTUN();
-    if (stunIP) {
-        return {
-            ip: stunIP,
-            method: 'stun',
-            timestamp: startTime
-        };
-    }
-    
-    // Fallback to public IP service
-    const publicIP = await getIPFromPublicService();
-    if (publicIP) {
-        return {
-            ip: publicIP,
-            method: 'public-service',
-            timestamp: startTime
-        };
-    }
-    
-    return null;
-}
-
-/**
- * Get IP address with caching to avoid repeated requests
- */
-let cachedIP: IPInfo | null = null;
-let cacheTimestamp = 0;
-const CACHE_DURATION = 5 * 60 * 1000; // 5 minutes
-
-export async function getCachedIP(): Promise<IPInfo | null> {
-    const now = Date.now();
-    
-    // Return cached IP if still valid
-    if (cachedIP && (now - cacheTimestamp) < CACHE_DURATION) {
-        return cachedIP;
-    }
-    
-    // Get fresh IP
-    const ipInfo = await getClientIP();
-    if (ipInfo) {
-        cachedIP = ipInfo;
-        cacheTimestamp = now;
-    }
-    
-    return ipInfo;
-}
-
-/**
- * Clear IP cache (useful for testing or when network changes)
- */
-export function clearIPCache(): void {
-    cachedIP = null;
-    cacheTimestamp = 0;
-}

package/src/utils/logger.ts

@@ -1,144 +0,0 @@
-export enum LogLevel {
-  NONE = 0,
-  ERROR = 1,
-  WARN = 2,
-  INFO = 3,
-  DEBUG = 4
-}
-
-export interface LoggerConfig {
-  level: LogLevel;
-  enableConsole: boolean;
-  enableStorage: boolean;
-}
-
-class Logger {
-  private config: LoggerConfig = {
-    level: LogLevel.ERROR, // Default to only errors in production
-    enableConsole: true,
-    enableStorage: false
-  };
-
-  private isBrowser = typeof window !== 'undefined';
-
-  constructor(config?: Partial<LoggerConfig>) {
-    if (config) {
-      this.config = { ...this.config, ...config };
-    }
-  }
-
-  setConfig(config: Partial<LoggerConfig>): void {
-    this.config = { ...this.config, ...config };
-  }
-
-  private shouldLog(level: LogLevel): boolean {
-    return level <= this.config.level;
-  }
-
-  private formatMessage(level: string, message: string, ...args: any[]): string {
-    const timestamp = new Date().toISOString();
-    return `[HumanBehavior ${level}] ${timestamp}: ${message}`;
-  }
-
-  error(message: string, ...args: any[]): void {
-    if (!this.shouldLog(LogLevel.ERROR)) return;
-    
-    const formattedMessage = this.formatMessage('ERROR', message);
-    
-    if (this.config.enableConsole) {
-      console.error(formattedMessage, ...args);
-    }
-    
-    if (this.config.enableStorage && this.isBrowser) {
-      this.logToStorage(formattedMessage, args);
-    }
-  }
-
-  warn(message: string, ...args: any[]): void {
-    if (!this.shouldLog(LogLevel.WARN)) return;
-    
-    const formattedMessage = this.formatMessage('WARN', message);
-    
-    if (this.config.enableConsole) {
-      console.warn(formattedMessage, ...args);
-    }
-    
-    if (this.config.enableStorage && this.isBrowser) {
-      this.logToStorage(formattedMessage, args);
-    }
-  }
-
-  info(message: string, ...args: any[]): void {
-    if (!this.shouldLog(LogLevel.INFO)) return;
-    
-    const formattedMessage = this.formatMessage('INFO', message);
-    
-    if (this.config.enableConsole) {
-      console.log(formattedMessage, ...args);
-    }
-    
-    if (this.config.enableStorage && this.isBrowser) {
-      this.logToStorage(formattedMessage, args);
-    }
-  }
-
-  debug(message: string, ...args: any[]): void {
-    if (!this.shouldLog(LogLevel.DEBUG)) return;
-    
-    const formattedMessage = this.formatMessage('DEBUG', message);
-    
-    if (this.config.enableConsole) {
-      console.log(formattedMessage, ...args);
-    }
-    
-    if (this.config.enableStorage && this.isBrowser) {
-      this.logToStorage(formattedMessage, args);
-    }
-  }
-
-  private logToStorage(message: string, args: any[]): void {
-    try {
-      const logs = JSON.parse(localStorage.getItem('human_behavior_logs') || '[]');
-      const logEntry = {
-        message,
-        args: args.length > 0 ? args : undefined,
-        timestamp: Date.now()
-      };
-      logs.push(logEntry);
-      
-      // Keep only last 1000 logs to prevent storage bloat
-      if (logs.length > 1000) {
-        logs.splice(0, logs.length - 1000);
-      }
-      
-      localStorage.setItem('human_behavior_logs', JSON.stringify(logs));
-    } catch (e) {
-      // Silently fail if storage is not available
-    }
-  }
-
-  getLogs(): any[] {
-    if (!this.isBrowser) return [];
-    
-    try {
-      return JSON.parse(localStorage.getItem('human_behavior_logs') || '[]');
-    } catch (e) {
-      return [];
-    }
-  }
-
-  clearLogs(): void {
-    if (this.isBrowser) {
-      localStorage.removeItem('human_behavior_logs');
-    }
-  }
-}
-
-// Create singleton instance
-export const logger = new Logger();
-
-// Export convenience methods
-export const logError = (message: string, ...args: any[]) => logger.error(message, ...args);
-export const logWarn = (message: string, ...args: any[]) => logger.warn(message, ...args);
-export const logInfo = (message: string, ...args: any[]) => logger.info(message, ...args);
-export const logDebug = (message: string, ...args: any[]) => logger.debug(message, ...args); 

package/src/utils/property-detector.ts

@@ -1,345 +0,0 @@
-/**
- * Automatic Property Detection for HumanBehavior SDK
- * Captures device type, location, and initial referrer information
- */
-
-// Check if we're in a browser environment
-const isBrowser = typeof window !== 'undefined';
-
-export interface DeviceInfo {
-    device_type: string;
-    browser: string;
-    browser_version: string;
-    os: string;
-    os_version: string;
-    device_model?: string;
-    screen_resolution: string;
-    viewport_size: string;
-    color_depth: number;
-    timezone: string;
-    language: string;
-    languages: string[];
-    raw_user_agent?: string;
-}
-
-export interface LocationInfo {
-    current_url: string;
-    pathname: string;
-    search: string;
-    hash: string;
-    title: string;
-    referrer: string;
-    referrer_domain: string;
-    initial_referrer: string;
-    initial_referrer_domain: string;
-    initial_host?: string;
-    utm_source?: string;
-    utm_medium?: string;
-    utm_campaign?: string;
-    utm_term?: string;
-    utm_content?: string;
-}
-
-export interface AutomaticProperties extends DeviceInfo, LocationInfo {}
-
-/**
- * Detect device type based on user agent and screen size
- */
-function detectDeviceType(): string {
-    if (!isBrowser) return 'unknown';
-    
-    const userAgent = navigator.userAgent.toLowerCase();
-    const screenWidth = window.screen.width;
-    const screenHeight = window.screen.height;
-    
-    // Mobile detection
-    if (/mobile|android|iphone|ipad|ipod|blackberry|windows phone/i.test(userAgent)) {
-        if (/ipad/i.test(userAgent) || (screenWidth >= 768 && screenHeight >= 1024)) {
-            return 'tablet';
-        }
-        return 'mobile';
-    }
-    
-    // Desktop detection
-    if (/windows|macintosh|linux/i.test(userAgent)) {
-        return 'desktop';
-    }
-    
-    return 'unknown';
-}
-
-/**
- * Extract browser information from user agent
- */
-function detectBrowser(): { browser: string; browser_version: string } {
-    if (!isBrowser) return { browser: 'unknown', browser_version: 'unknown' };
-    
-    const userAgent = navigator.userAgent;
-    
-    // Chrome
-    if (/chrome/i.test(userAgent) && !/edge/i.test(userAgent)) {
-        const match = userAgent.match(/chrome\/(\d+)/i);
-        return {
-            browser: 'chrome',
-            browser_version: match ? match[1] : 'unknown'
-        };
-    }
-    
-    // Firefox
-    if (/firefox/i.test(userAgent)) {
-        const match = userAgent.match(/firefox\/(\d+)/i);
-        return {
-            browser: 'firefox',
-            browser_version: match ? match[1] : 'unknown'
-        };
-    }
-    
-    // Safari
-    if (/safari/i.test(userAgent) && !/chrome/i.test(userAgent)) {
-        const match = userAgent.match(/version\/(\d+)/i);
-        return {
-            browser: 'safari',
-            browser_version: match ? match[1] : 'unknown'
-        };
-    }
-    
-    // Edge
-    if (/edge/i.test(userAgent)) {
-        const match = userAgent.match(/edge\/(\d+)/i);
-        return {
-            browser: 'edge',
-            browser_version: match ? match[1] : 'unknown'
-        };
-    }
-    
-    // Internet Explorer
-    if (/msie|trident/i.test(userAgent)) {
-        const match = userAgent.match(/msie (\d+)/i) || userAgent.match(/rv:(\d+)/i);
-        return {
-            browser: 'ie',
-            browser_version: match ? match[1] : 'unknown'
-        };
-    }
-    
-    return { browser: 'unknown', browser_version: 'unknown' };
-}
-
-/**
- * Extract operating system information from user agent
- */
-function detectOS(): { os: string; os_version: string } {
-    if (!isBrowser) return { os: 'unknown', os_version: 'unknown' };
-    
-    const userAgent = navigator.userAgent;
-    
-    // Windows
-    if (/windows/i.test(userAgent)) {
-        const match = userAgent.match(/windows nt (\d+\.\d+)/i);
-        let version = 'unknown';
-        if (match) {
-            const versionNum = parseFloat(match[1]);
-            if (versionNum === 10.0) version = '10';
-            else if (versionNum === 6.3) version = '8.1';
-            else if (versionNum === 6.2) version = '8';
-            else if (versionNum === 6.1) version = '7';
-            else version = match[1];
-        }
-        return { os: 'windows', os_version: version };
-    }
-    
-    // macOS
-    if (/macintosh|mac os x/i.test(userAgent)) {
-        const match = userAgent.match(/mac os x (\d+[._]\d+)/i);
-        return {
-            os: 'macos',
-            os_version: match ? match[1].replace('_', '.') : 'unknown'
-        };
-    }
-    
-    // iOS
-    if (/iphone|ipad|ipod/i.test(userAgent)) {
-        const match = userAgent.match(/os (\d+[._]\d+)/i);
-        return {
-            os: 'ios',
-            os_version: match ? match[1].replace('_', '.') : 'unknown'
-        };
-    }
-    
-    // Android
-    if (/android/i.test(userAgent)) {
-        const match = userAgent.match(/android (\d+\.\d+)/i);
-        return {
-            os: 'android',
-            os_version: match ? match[1] : 'unknown'
-        };
-    }
-    
-    // Linux
-    if (/linux/i.test(userAgent)) {
-        return { os: 'linux', os_version: 'unknown' };
-    }
-    
-    return { os: 'unknown', os_version: 'unknown' };
-}
-
-/**
- * Extract UTM parameters from URL
- */
-function extractUTMParams(url: string): Record<string, string> {
-    const urlObj = new URL(url);
-    const utmParams: Record<string, string> = {};
-    
-    const utmKeys = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content'];
-    
-    utmKeys.forEach(key => {
-        const value = urlObj.searchParams.get(key);
-        if (value) {
-            utmParams[key] = value;
-        }
-    });
-    
-    return utmParams;
-}
-
-/**
- * Extract domain from URL
- */
-function extractDomain(url: string): string {
-    try {
-        const urlObj = new URL(url);
-        return urlObj.hostname;
-    } catch {
-        return '';
-    }
-}
-
-/**
- * Get device information
- */
-export function getDeviceInfo(): DeviceInfo {
-    if (!isBrowser) {
-        return {
-            device_type: 'unknown',
-            browser: 'unknown',
-            browser_version: 'unknown',
-            os: 'unknown',
-            os_version: 'unknown',
-            screen_resolution: 'unknown',
-            viewport_size: 'unknown',
-            color_depth: 0,
-            timezone: 'unknown',
-            language: 'unknown',
-            languages: []
-        };
-    }
-    
-    const { browser, browser_version } = detectBrowser();
-    const { os, os_version } = detectOS();
-    
-    return {
-        device_type: detectDeviceType(),
-        browser,
-        browser_version,
-        os,
-        os_version,
-        screen_resolution: `${window.screen.width}x${window.screen.height}`,
-        viewport_size: `${window.innerWidth}x${window.innerHeight}`,
-        color_depth: window.screen.colorDepth,
-        timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
-        language: navigator.language,
-        languages: [...(navigator.languages || [navigator.language])],
-        raw_user_agent: navigator.userAgent
-    };
-}
-
-/**
- * Get location information
- */
-export function getLocationInfo(): LocationInfo {
-    if (!isBrowser) {
-        return {
-            current_url: '',
-            pathname: '',
-            search: '',
-            hash: '',
-            title: '',
-            referrer: '',
-            referrer_domain: '',
-            initial_referrer: '',
-            initial_referrer_domain: ''
-        };
-    }
-    
-    const currentUrl = window.location.href;
-    const referrer = document.referrer;
-    const utmParams = extractUTMParams(currentUrl);
-    
-    return {
-        current_url: currentUrl,
-        pathname: window.location.pathname,
-        search: window.location.search,
-        hash: window.location.hash,
-        title: document.title,
-        referrer,
-        referrer_domain: extractDomain(referrer),
-        initial_referrer: referrer,
-        initial_referrer_domain: extractDomain(referrer),
-        initial_host: window.location.hostname,
-        ...utmParams
-    };
-}
-
-/**
- * Get all automatic properties
- */
-export function getAutomaticProperties(): AutomaticProperties {
-    return {
-        ...getDeviceInfo(),
-        ...getLocationInfo()
-    };
-}
-
-/**
- * Get initial properties that should be captured once per session
- */
-export function getInitialProperties(): Record<string, any> {
-    if (!isBrowser) return {};
-    
-    const locationInfo = getLocationInfo();
-    
-    return {
-        initial_referrer: locationInfo.initial_referrer,
-        initial_referrer_domain: locationInfo.initial_referrer_domain,
-        initial_url: locationInfo.current_url,
-        initial_pathname: locationInfo.pathname,
-        initial_utm_source: locationInfo.utm_source,
-        initial_utm_medium: locationInfo.utm_medium,
-        initial_utm_campaign: locationInfo.utm_campaign,
-        initial_utm_term: locationInfo.utm_term,
-        initial_utm_content: locationInfo.utm_content
-    };
-}
-
-/**
- * Get current page properties (changes with navigation)
- */
-export function getCurrentPageProperties(): Record<string, any> {
-    if (!isBrowser) return {};
-    
-    const locationInfo = getLocationInfo();
-    
-    return {
-        current_url: locationInfo.current_url,
-        pathname: locationInfo.pathname,
-        search: locationInfo.search,
-        hash: locationInfo.hash,
-        title: locationInfo.title,
-        referrer: locationInfo.referrer,
-        referrer_domain: locationInfo.referrer_domain,
-        utm_source: locationInfo.utm_source,
-        utm_medium: locationInfo.utm_medium,
-        utm_campaign: locationInfo.utm_campaign,
-        utm_term: locationInfo.utm_term,
-        utm_content: locationInfo.utm_content
-    };
-}