supabase/studio/lib/telemetry.ts

import { post } from 'lib/common/fetch'
import { API_URL, IS_PLATFORM } from 'lib/constants'
import { User } from 'types'
import { NextRouter } from 'next/router'

export interface TelemetryProps {
  screenResolution?: string
  language: string
}

const sendEvent = (
  event: {
    category: string
    action: string
    label: string
    value?: string
  },
  gaProps: TelemetryProps,
  router: NextRouter
) => {
  if (!IS_PLATFORM) return

  const { category, action, label, value } = event

  return post(`${API_URL}/telemetry/event`, {
    action: action,
    category: category,
    label: label,
    value: value,
    page_referrer: document?.referrer,
    page_title: document?.title,
    page_location: router.asPath,
    ga: {
      screen_resolution: gaProps?.screenResolution,
      language: gaProps?.language,
    },
  })
}

/**
 * TODO: GA4 doesn't have identify method.
 * We may or may not need gaClientId here. Confirm later
 */
const sendIdentify = (user: User, gaProps?: TelemetryProps) => {
  if (!IS_PLATFORM) return

  return post(`${API_URL}/telemetry/identify`, {
    user,
    ga: {
      screen_resolution: gaProps?.screenResolution,
      language: gaProps?.language,
    },
  })
}

const sendActivity = (
  event: {
    activity: string
    source: string
    projectRef?: string
    orgId?: string
    data?: object
  },
  router: NextRouter
) => {
  if (!IS_PLATFORM) return

  const { activity, source, projectRef, orgId, data } = event

  const properties = {
    activity,
    source,
    page: {
      path: router.route,
      location: router.asPath,
      referrer: document?.referrer || '',
      title: document?.title || '',
    },
    ...(data && { data }),
    // add if included, else estimate from path
    ...(projectRef && { projectRef }),
    ...(router.route.includes('/project/') &&
      !projectRef && {
        projectRef: router.asPath.split('/project/')[1].split('/')[0],
      }),
    ...(orgId && { orgId }),
    ...(router.route.includes('/org/') &&
      !orgId && { orgId: router.asPath.split('/org/')[1].split('/')[0] }),
  }
  return post(`${API_URL}/telemetry/activity`, properties)
}

export default {
  sendEvent,
  sendIdentify,
  sendActivity,
}