Janady13/llms-txt-hub / apps/web/lib/analytics.ts

Source identity

Field	Recorded value
Source type	GitHub source
Original record	Janady13/llms-txt-hub / apps/web/lib/analytics.ts
Date	Not specified in source
Repository	Janady13/llms-txt-hub
Revision	e0f4bf978d4df168369c7601d9c5f5ea89e84377
Branch	main
Path or archive member	apps/web/lib/analytics.ts
Original SHA-256	8ab1c2f593463b239551a99e3f7fb76b91ed2598ecb11bad271ca71f7a11500a
Git blob SHA	3bfdfddd37070f50c98539bd9fb6ed485ea0ffdd
Reading-copy SHA-256	8ab1c2f593463b239551a99e3f7fb76b91ed2598ecb11bad271ca71f7a11500a

Original source ↗

Recovered source transcript

Download complete source text ↓144 lines · 4.0 KB

// Event categories for better organization
export const ANALYTICS_EVENTS = {
  // Load More & Pagination
  LOAD_MORE: 'Load More',
  LOAD_MORE_WEBSITES: 'Load More Websites',
  LOAD_MORE_MEMBERS: 'Load More Members',
  SHOW_ALL_WEBSITES: 'Show All Websites',
  SHOW_LESS_WEBSITES: 'Show Less Websites',

  // Search & Discovery
  SEARCH_SUBMIT: 'Search Submit',
  SEARCH_AUTOCOMPLETE_CLICK: 'Search Autocomplete Click',
  SEARCH_FILTER: 'Search Filter',
  SEARCH_CLEAR: 'Search Clear',

  // Navigation & Links
  WEBSITE_CLICK: 'Website Click',
  MEMBER_PROFILE_CLICK: 'Member Profile Click',
  CATEGORY_CLICK: 'Category Click',
  EXTERNAL_LINK_CLICK: 'External Link Click',
  GITHUB_LINK_CLICK: 'GitHub Link Click',

  // Sorting & Filtering
  SORT_CHANGE: 'Sort Change',
  SORT_BY_NAME: 'Sort By Name',
  SORT_BY_LATEST: 'Sort By Latest',

  // Content Interactions
  WEBSITE_VIEW: 'Website View',
  MEMBER_VIEW: 'Member View',
  GUIDE_CLICK: 'Guide Click',
  FEATURED_PROJECT_CLICK: 'Featured Project Click',
  CREATOR_PROJECT_CLICK: 'Creator Project Click',

  // Actions
  SUBMIT_WEBSITE: 'Submit Website',
  JOIN_COMMUNITY: 'Join Community',
  NEWSLETTER_SIGNUP: 'Newsletter Signup',

  // Form Events
  FORM_STEP_START: 'Form Step Start',
  FORM_STEP_COMPLETE: 'Form Step Complete',
  FORM_ERROR: 'Form Error',
  FORM_ABANDON: 'Form Abandon',
  FETCH_METADATA_SUCCESS: 'Fetch Metadata Success',
  FETCH_METADATA_ERROR: 'Fetch Metadata Error',
  SUBMIT_SUCCESS: 'Submit Success',
  SUBMIT_ERROR: 'Submit Error',

  // Profile Events
  PROFILE_MODAL_OPEN: 'Profile Modal Open',
  PROFILE_UPDATE_SUCCESS: 'Profile Update Success',
  PROFILE_UPDATE_ERROR: 'Profile Update Error',
  PROFILE_VISIBILITY_TOGGLE: 'Profile Visibility Toggle',
  ACCOUNT_DELETE_START: 'Account Delete Start',
  ACCOUNT_DELETE_SUCCESS: 'Account Delete Success',
  ACCOUNT_DELETE_CANCEL: 'Account Delete Cancel',

  // Tools & Resources
  TOOL_CLICK: 'Tool Click',
  RSS_DOWNLOAD: 'RSS Download',
  LLMS_TXT_VIEW: 'LLMS.txt View',

  // Error & Edge Cases
  SEARCH_NO_RESULTS: 'Search No Results',
  PAGE_ERROR: 'Page Error',
  LOAD_MORE_ERROR: 'Load More Error',

  // Settings Events
  SETTINGS_PAGE_VIEW: 'Settings Page View',
  SETTINGS_TAB_CLICK: 'Settings Tab Click',
  SETTINGS_EXPORT_DATA: 'Export Data',
  SETTINGS_TOGGLE_CHANGE: 'Settings Toggle Change',
  SETTINGS_CONNECT_GITHUB: 'Connect GitHub',
  SETTINGS_DISCONNECT_SERVICE: 'Disconnect Service',
  SETTINGS_SAVE: 'Settings Save',
  SETTINGS_DANGER_ZONE_TOGGLE: 'Danger Zone Toggle',

  // Navigation Events (Profile/Settings)
  PROFILE_NAV_CLICK: 'Profile Navigation Click',
  SETTINGS_NAV_CLICK: 'Settings Navigation Click',
  BACK_TO_PROFILE_CLICK: 'Back to Profile Click'
} as const

type AnalyticsEvent = (typeof ANALYTICS_EVENTS)[keyof typeof ANALYTICS_EVENTS]

interface EventProps {
  // Common props
  source?: string
  section?: string
  category?: string
  value?: number | string

  // Load More specific
  items_loaded?: number
  total_items?: number
  page?: number

  // Search specific
  query?: string
  results_count?: number
  filter_type?: string

  // Navigation specific
  destination?: string
  website_name?: string
  member_name?: string

  // Sort specific
  from_sort?: string
  to_sort?: string

  // Content specific
  content_type?: 'website' | 'member' | 'guide' | 'project' | 'tool'
  content_slug?: string
}

/**
 * Track an event with OpenPanel analytics
 */
export function trackEvent(event: AnalyticsEvent, props?: EventProps) {
  if (typeof window === 'undefined') return

  const cleanProps: Record<string, string | number> = {}
  if (props) {
    Object.entries(props).forEach(([key, value]) => {
      if (value !== undefined) {
        cleanProps[key] = value
      }
    })
  }

  if (process.env.NODE_ENV === 'production') {
    try {
      window.op?.track(event, cleanProps)
    } catch (error) {
      console.warn('OpenPanel tracking failed:', error)
    }
  }
}

// Re-export convenience functions from helpers (split for file complexity limits)
export { analytics } from './analytics-helpers'