Skip to content

The Postgres development platform. Supabase gives you a dedicated Postgres database to build your web, mobile, and AI applications.

feat(studio): add click tracking for top bar buttons (#45414)

Mert YEREKAPANda81b2f14d0a
diff --git a/apps/studio/components/interfaces/ConnectButton/ConnectButton.tsx b/apps/studio/components/interfaces/ConnectButton/ConnectButton.tsx
index baa8260000c..21eb07ae123 100644
--- a/apps/studio/components/interfaces/ConnectButton/ConnectButton.tsx
+++ b/apps/studio/components/interfaces/ConnectButton/ConnectButton.tsx
@@ -6,6 +6,7 @@ import { Button, cn } from 'ui'
import { ButtonTooltip } from '@/components/ui/ButtonTooltip'
import { useSelectedProjectQuery } from '@/hooks/misc/useSelectedProject'
import { PROJECT_STATUS } from '@/lib/constants'
+import { useTrack } from '@/lib/telemetry/track'
import { useAppStateSnapshot } from '@/state/app-state'
interface ConnectButtonProps {
@@ -17,6 +18,7 @@ export const ConnectButton = ({ buttonType = 'default', className }: ConnectButt
const { data: selectedProject } = useSelectedProjectQuery()
const { setConnectSheetSource } = useAppStateSnapshot()
const isActiveHealthy = selectedProject?.status === PROJECT_STATUS.ACTIVE_HEALTHY
+ const track = useTrack()
const [, setShowConnect] = useQueryState('showConnect', parseAsBoolean.withDefault(false))
@@ -27,6 +29,7 @@ export const ConnectButton = ({ buttonType = 'default', className }: ConnectButt
className={cn('rounded-full', className)}
icon={<Plug className="rotate-90" />}
onClick={() => {
+ track('header_connect_button_clicked')
setConnectSheetSource('header_button')
setShowConnect(true)
}}
diff --git a/apps/studio/components/interfaces/LocalDropdown.test.tsx b/apps/studio/components/interfaces/LocalDropdown.test.tsx
index db89a51e9da..f34fa0c2b7f 100644
--- a/apps/studio/components/interfaces/LocalDropdown.test.tsx
+++ b/apps/studio/components/interfaces/LocalDropdown.test.tsx
@@ -60,6 +60,8 @@ vi.mock('./App/FeaturePreview/FeaturePreviewContext', () => ({
}),
}))
+vi.mock('@/lib/telemetry/track', () => ({ useTrack: () => vi.fn() }))
+
vi.mock('ui', async () => {
const React = await import('react')
diff --git a/apps/studio/components/interfaces/LocalDropdown.tsx b/apps/studio/components/interfaces/LocalDropdown.tsx
index 766fdd9d463..de4f1ea3bf1 100644
--- a/apps/studio/components/interfaces/LocalDropdown.tsx
+++ b/apps/studio/components/interfaces/LocalDropdown.tsx
@@ -20,6 +20,7 @@ import {
import { ButtonTooltip } from '../ui/ButtonTooltip'
import { useFeaturePreviewModal } from './App/FeaturePreview/FeaturePreviewContext'
import { ProfileImage } from '@/components/ui/ProfileImage'
+import { useTrack } from '@/lib/telemetry/track'
import { useAppStateSnapshot } from '@/state/app-state'
export const LocalDropdown = ({
@@ -33,9 +34,14 @@ export const LocalDropdown = ({
const { theme, setTheme } = useTheme()
const appStateSnapshot = useAppStateSnapshot()
const { toggleFeaturePreviewModal } = useFeaturePreviewModal()
+ const track = useTrack()
return (
- <DropdownMenu>
+ <DropdownMenu
+ onOpenChange={(open) => {
+ if (open) track('header_local_dropdown_opened')
+ }}
+ >
<DropdownMenuTrigger className={cn('border shrink-0 px-3', triggerClassName)} asChild>
<ButtonTooltip
type="default"
diff --git a/apps/studio/components/interfaces/UserDropdown.tsx b/apps/studio/components/interfaces/UserDropdown.tsx
index c389f1279d6..599bd1d8fb1 100644
--- a/apps/studio/components/interfaces/UserDropdown.tsx
+++ b/apps/studio/components/interfaces/UserDropdown.tsx
@@ -23,6 +23,7 @@ import { ProfileImage } from '@/components/ui/ProfileImage'
import { useIsFeatureEnabled } from '@/hooks/misc/useIsFeatureEnabled'
import { IS_PLATFORM } from '@/lib/constants'
import { useProfileNameAndPicture } from '@/lib/profile'
+import { useTrack } from '@/lib/telemetry/track'
import { useAppStateSnapshot } from '@/state/app-state'
export function UserDropdown({
@@ -39,9 +40,14 @@ export function UserDropdown({
const { username, avatarUrl, primaryEmail, isLoading } = useProfileNameAndPicture()
const { toggleFeaturePreviewModal } = useFeaturePreviewModal()
+ const track = useTrack()
return (
- <DropdownMenu>
+ <DropdownMenu
+ onOpenChange={(open) => {
+ if (open) track('header_user_dropdown_opened')
+ }}
+ >
<DropdownMenuTrigger asChild className={cn('border shrink-0 px-3', triggerClassName)}>
<ButtonTooltip
type="default"
diff --git a/apps/studio/components/layouts/AppLayout/AdvisorButton.tsx b/apps/studio/components/layouts/AppLayout/AdvisorButton.tsx
index c4582ce3297..61c2c13599c 100644
--- a/apps/studio/components/layouts/AppLayout/AdvisorButton.tsx
+++ b/apps/studio/components/layouts/AppLayout/AdvisorButton.tsx
@@ -7,10 +7,12 @@ import { useAdvisorSignals } from '@/components/ui/AdvisorPanel/useAdvisorSignal
import { ButtonTooltip } from '@/components/ui/ButtonTooltip'
import { useProjectLintsQuery } from '@/data/lint/lint-query'
import { useNotificationsV2Query } from '@/data/notifications/notifications-v2-query'
+import { useTrack } from '@/lib/telemetry/track'
import { useSidebarManagerSnapshot } from '@/state/sidebar-manager-state'
export const AdvisorButton = ({ projectRef }: { projectRef?: string }) => {
const { toggleSidebar, activeSidebar } = useSidebarManagerSnapshot()
+ const track = useTrack()
const { data: lints } = useProjectLintsQuery({ projectRef })
const { data: signalItems } = useAdvisorSignals({ projectRef })
@@ -36,6 +38,7 @@ export const AdvisorButton = ({ projectRef }: { projectRef?: string }) => {
const isOpen = activeSidebar?.id === SIDEBAR_KEYS.ADVISOR_PANEL
const handleClick = () => {
+ track('header_advisor_button_clicked')
toggleSidebar(SIDEBAR_KEYS.ADVISOR_PANEL)
}
diff --git a/apps/studio/components/layouts/AppLayout/AssistantButton.tsx b/apps/studio/components/layouts/AppLayout/AssistantButton.tsx
index bb70352b8df..2a61e166eca 100644
--- a/apps/studio/components/layouts/AppLayout/AssistantButton.tsx
+++ b/apps/studio/components/layouts/AppLayout/AssistantButton.tsx
@@ -2,6 +2,7 @@ import { AiIconAnimation, cn, KeyboardShortcut } from 'ui'
import { SIDEBAR_KEYS } from '@/components/layouts/ProjectLayout/LayoutSidebar/LayoutSidebarProvider'
import { ButtonTooltip } from '@/components/ui/ButtonTooltip'
+import { useTrack } from '@/lib/telemetry/track'
import { SHORTCUT_IDS } from '@/state/shortcuts/registry'
import { useIsShortcutEnabled } from '@/state/shortcuts/useIsShortcutEnabled'
import { useSidebarManagerSnapshot } from '@/state/sidebar-manager-state'
@@ -9,6 +10,7 @@ import { useSidebarManagerSnapshot } from '@/state/sidebar-manager-state'
export const AssistantButton = () => {
const { activeSidebar, toggleSidebar } = useSidebarManagerSnapshot()
const isAIAssistantHotkeyEnabled = useIsShortcutEnabled(SHORTCUT_IDS.AI_ASSISTANT_TOGGLE)
+ const track = useTrack()
const isOpen = activeSidebar?.id === SIDEBAR_KEYS.AI_ASSISTANT
@@ -22,6 +24,7 @@ export const AssistantButton = () => {
isOpen && 'bg-foreground text-background'
)}
onClick={() => {
+ track('header_assistant_button_clicked')
toggleSidebar(SIDEBAR_KEYS.AI_ASSISTANT)
}}
tooltip={{
diff --git a/apps/studio/components/layouts/AppLayout/BranchDropdown.tsx b/apps/studio/components/layouts/AppLayout/BranchDropdown.tsx
index 1e81c16acbd..760a051d3a0 100644
--- a/apps/studio/components/layouts/AppLayout/BranchDropdown.tsx
+++ b/apps/studio/components/layouts/AppLayout/BranchDropdown.tsx
@@ -9,6 +9,7 @@ import { useEmbeddedCloseHandler } from './useEmbeddedCloseHandler'
import { useBranchesQuery } from '@/data/branches/branches-query'
import type { Branch } from '@/data/branches/branches-query'
import { useSelectedProjectQuery } from '@/hooks/misc/useSelectedProject'
+import { useTrack } from '@/lib/telemetry/track'
import { useAppStateSnapshot } from '@/state/app-state'
interface BranchDropdownProps {
@@ -28,6 +29,12 @@ export const BranchDropdown = ({
const [open, setOpen] = useState(false)
const close = useEmbeddedCloseHandler(embedded, onClose, setOpen)
+ const track = useTrack()
+
+ const handleOpenChange = (next: boolean) => {
+ if (next) track('header_branch_dropdown_opened')
+ setOpen(next)
+ }
const projectRef = projectDetails?.parent_project_ref || ref
@@ -100,7 +107,7 @@ export const BranchDropdown = ({
linkClassName="flex items-center gap-2 shrink-0"
commandContent={commandContent}
open={open}
- onOpenChange={setOpen}
+ onOpenChange={handleOpenChange}
/>
)
}
diff --git a/apps/studio/components/layouts/AppLayout/InlineEditorButton.tsx b/apps/studio/components/layouts/AppLayout/InlineEditorButton.tsx
index ab02ed41a82..faf8293b247 100644
--- a/apps/studio/components/layouts/AppLayout/InlineEditorButton.tsx
+++ b/apps/studio/components/layouts/AppLayout/InlineEditorButton.tsx
@@ -3,6 +3,7 @@ import { cn, KeyboardShortcut } from 'ui'
import { SIDEBAR_KEYS } from '@/components/layouts/ProjectLayout/LayoutSidebar/LayoutSidebarProvider'
import { ButtonTooltip } from '@/components/ui/ButtonTooltip'
+import { useTrack } from '@/lib/telemetry/track'
import { SHORTCUT_IDS } from '@/state/shortcuts/registry'
import { useIsShortcutEnabled } from '@/state/shortcuts/useIsShortcutEnabled'
import { useSidebarManagerSnapshot } from '@/state/sidebar-manager-state'
@@ -16,8 +17,10 @@ const InlineEditorKeyboardTooltip = () => {
export const InlineEditorButton = () => {
const { activeSidebar, toggleSidebar } = useSidebarManagerSnapshot()
const isOpen = activeSidebar?.id === SIDEBAR_KEYS.EDITOR_PANEL
+ const track = useTrack()
const handleClick = () => {
+ track('header_inline_editor_button_clicked')
toggleSidebar(SIDEBAR_KEYS.EDITOR_PANEL)
}
diff --git a/apps/studio/components/layouts/AppLayout/OrganizationDropdown.tsx b/apps/studio/components/layouts/AppLayout/OrganizationDropdown.tsx
index 834b95a6576..3cbf12abc33 100644
--- a/apps/studio/components/layouts/AppLayout/OrganizationDropdown.tsx
+++ b/apps/studio/components/layouts/AppLayout/OrganizationDropdown.tsx
@@ -12,6 +12,7 @@ import PartnerIcon from '@/components/ui/PartnerIcon'
import { useOrganizationsQuery } from '@/data/organizations/organizations-query'
import { useIsFeatureEnabled } from '@/hooks/misc/useIsFeatureEnabled'
import { useSelectedOrganizationQuery } from '@/hooks/misc/useSelectedOrganization'
+import { useTrack } from '@/lib/telemetry/track'
interface OrganizationDropdownProps {
embedded?: boolean
@@ -40,6 +41,12 @@ export const OrganizationDropdown = ({
const [open, setOpen] = useState(false)
const close = useEmbeddedCloseHandler(embedded, onClose, setOpen)
+ const track = useTrack()
+
+ const handleOpenChange = (next: boolean) => {
+ if (next) track('header_organization_dropdown_opened')
+ setOpen(next)
+ }
if (isLoadingOrganizations && !embedded)
return <ShimmeringLoader className="p-2 md:mr-2 w-[90px]" />
@@ -84,7 +91,7 @@ export const OrganizationDropdown = ({
}
commandContent={commandContent}
open={open}
- onOpenChange={setOpen}
+ onOpenChange={handleOpenChange}
/>
)
}
diff --git a/apps/studio/components/layouts/AppLayout/ProjectDropdown.tsx b/apps/studio/components/layouts/AppLayout/ProjectDropdown.tsx
index 1e1d7bc0cd3..f4b52381c8b 100644
--- a/apps/studio/components/layouts/AppLayout/ProjectDropdown.tsx
+++ b/apps/studio/components/layouts/AppLayout/ProjectDropdown.tsx
@@ -21,6 +21,7 @@ import { useSelectedOrganizationQuery } from '@/hooks/misc/useSelectedOrganizati
import { useSelectedProjectQuery } from '@/hooks/misc/useSelectedProject'
import { IS_PLATFORM } from '@/lib/constants'
import type { ManagedBy } from '@/lib/constants/infrastructure'
+import { useTrack } from '@/lib/telemetry/track'
// --- Sub-components ---
@@ -140,6 +141,7 @@ export const ProjectDropdown = ({
const selectedProject = parentProject ?? project
const projectCreationEnabled = useIsFeatureEnabled('projects:create')
+ const track = useTrack()
const [open, setOpen] = useState(false)
const close = useEmbeddedCloseHandler(embedded, onClose, setOpen)
@@ -153,7 +155,12 @@ export const ProjectDropdown = ({
if (!embedded) return <ShimmeringLoader className="p-2 md:mr-2 md:w-[90px]" />
}
- const handleSetOpen = embedded ? (_value: boolean) => onClose?.() : setOpen
+ const handleSetOpen = embedded
+ ? (_value: boolean) => onClose?.()
+ : (next: boolean) => {
+ if (next) track('header_project_dropdown_opened')
+ setOpen(next)
+ }
const selectorProps = {
open,
diff --git a/apps/studio/components/layouts/Navigation/LayoutHeader/FeedbackDropdown/FeedbackDropdown.tsx b/apps/studio/components/layouts/Navigation/LayoutHeader/FeedbackDropdown/FeedbackDropdown.tsx
index 7e326d04311..d4c8a50ba0b 100644
--- a/apps/studio/components/layouts/Navigation/LayoutHeader/FeedbackDropdown/FeedbackDropdown.tsx
+++ b/apps/studio/components/layouts/Navigation/LayoutHeader/FeedbackDropdown/FeedbackDropdown.tsx
@@ -17,6 +17,7 @@ import { getSupportLinkQueryParams } from '@/components/ui/HelpPanel/HelpPanel.u
import { HelpSection } from '@/components/ui/HelpPanel/HelpSection'
import { useSelectedOrganizationQuery } from '@/hooks/misc/useSelectedOrganization'
import { useSelectedProjectQuery } from '@/hooks/misc/useSelectedProject'
+import { useTrack } from '@/lib/telemetry/track'
import { useAiAssistantStateSnapshot } from '@/state/ai-assistant-state'
import { useSidebarManagerSnapshot } from '@/state/sidebar-manager-state'
@@ -28,6 +29,7 @@ export const FeedbackDropdown = ({ className }: { className?: string }) => {
const { openSidebar } = useSidebarManagerSnapshot()
const [isOpen, setIsOpen] = useState(false)
const [stage, setStage] = useState<'select' | 'issue-options' | 'widget'>('select')
+ const track = useTrack()
const projectRef = project?.parent_project_ref ?? (router.query.ref as string | undefined)
const supportLinkQueryParams = getSupportLinkQueryParams(
@@ -41,6 +43,7 @@ export const FeedbackDropdown = ({ className }: { className?: string }) => {
modal={false}
open={isOpen}
onOpenChange={(e) => {
+ if (e) track('header_feedback_dropdown_opened')
setIsOpen(e)
if (!e) setStage('select')
}}
diff --git a/apps/studio/components/layouts/Navigation/LayoutHeader/HomeIcon.tsx b/apps/studio/components/layouts/Navigation/LayoutHeader/HomeIcon.tsx
index 266fad72ddd..2203a98c43d 100644
--- a/apps/studio/components/layouts/Navigation/LayoutHeader/HomeIcon.tsx
+++ b/apps/studio/components/layouts/Navigation/LayoutHeader/HomeIcon.tsx
@@ -8,10 +8,12 @@ import { useIsFeatureEnabled } from '@/hooks/misc/useIsFeatureEnabled'
import { useLocalStorageQuery } from '@/hooks/misc/useLocalStorage'
import { useSelectedOrganizationQuery } from '@/hooks/misc/useSelectedOrganization'
import { IS_PLATFORM } from '@/lib/constants'
+import { useTrack } from '@/lib/telemetry/track'
export const HomeIcon = ({ className }: { className?: string }) => {
const { data: selectedOrganization } = useSelectedOrganizationQuery()
const { data: organizations } = useOrganizationsQuery()
+ const track = useTrack()
const largeLogo = useIsFeatureEnabled('branding:large_logo')
@@ -31,7 +33,11 @@ export const HomeIcon = ({ className }: { className?: string }) => {
const href = IS_PLATFORM ? getDefaultOrgRedirect() : '/project/default'
return (
- <Link href={href} className={cn('items-center justify-center shrink-0 flex', className)}>
+ <Link
+ href={href}
+ onClick={() => track('header_home_logo_clicked')}
+ className={cn('items-center justify-center shrink-0 flex', className)}
+ >
<img
alt="Supabase"
src={`${router.basePath}/img/supabase-logo.svg`}
diff --git a/apps/studio/components/layouts/Navigation/LayoutHeader/LayoutHeader.tsx b/apps/studio/components/layouts/Navigation/LayoutHeader/LayoutHeader.tsx
index a332384c80f..3540b0dda5d 100644
--- a/apps/studio/components/layouts/Navigation/LayoutHeader/LayoutHeader.tsx
+++ b/apps/studio/components/layouts/Navigation/LayoutHeader/LayoutHeader.tsx
@@ -30,6 +30,7 @@ import { useOrgUsageQuery } from '@/data/usage/org-usage-query'
import { useSelectedOrganizationQuery } from '@/hooks/misc/useSelectedOrganization'
import { useSelectedProjectQuery } from '@/hooks/misc/useSelectedProject'
import { IS_PLATFORM } from '@/lib/constants'
+import { useTrack } from '@/lib/telemetry/track'
import { SHORTCUT_IDS } from '@/state/shortcuts/registry'
import { useIsShortcutEnabled } from '@/state/shortcuts/useIsShortcutEnabled'
@@ -69,6 +70,7 @@ export const LayoutHeader = ({
const { ref: projectRef, slug } = useParams()
const { data: selectedProject } = useSelectedProjectQuery()
const { data: selectedOrganization } = useSelectedOrganizationQuery()
+ const track = useTrack()
const commandMenuEnabled = useIsShortcutEnabled(SHORTCUT_IDS.COMMAND_MENU_OPEN)
@@ -104,6 +106,7 @@ export const LayoutHeader = ({
<div className="flex items-center justify-center border-r flex-0 md:hidden h-full aspect-square">
<Link
href={backToDashboardURL}
+ onClick={() => track('header_back_to_dashboard_clicked')}
className="flex items-center justify-center border-none bg-transparent! rounded-md min-w-[30px] w-[30px] h-[30px] text-foreground-lighter hover:text-foreground transition-colors"
>
<ChevronLeft strokeWidth={1.5} size={16} />
@@ -160,7 +163,10 @@ export const LayoutHeader = ({
{exceedingLimits && (
<div className="ml-2">
- <Link href={`/org/${selectedOrganization?.slug}/usage`}>
+ <Link
+ href={`/org/${selectedOrganization?.slug}/usage`}
+ onClick={() => track('header_exceeding_usage_badge_clicked')}
+ >
<Badge variant="destructive">Exceeding usage limits</Badge>
</Link>
</div>
diff --git a/apps/studio/components/layouts/Navigation/LayoutHeader/LocalVersionPopover.tsx b/apps/studio/components/layouts/Navigation/LayoutHeader/LocalVersionPopover.tsx
index 868986497ad..5a33232935d 100644
--- a/apps/studio/components/layouts/Navigation/LayoutHeader/LocalVersionPopover.tsx
+++ b/apps/studio/components/layouts/Navigation/LayoutHeader/LocalVersionPopover.tsx
@@ -25,9 +25,11 @@ import { DocsButton } from '@/components/ui/DocsButton'
import { InlineLink } from '@/components/ui/InlineLink'
import { useCLIReleaseVersionQuery } from '@/data/misc/cli-release-version-query'
import { DOCS_URL } from '@/lib/constants'
+import { useTrack } from '@/lib/telemetry/track'
export const LocalVersionPopover = () => {
const { data, isSuccess } = useCLIReleaseVersionQuery()
+ const track = useTrack()
const currentCliVersion = data?.current
const latestCliVersion = data?.latest
const hasLatestCLIVersion = isSuccess && !!latestCliVersion
@@ -49,7 +51,11 @@ export const LocalVersionPopover = () => {
if (!isSuccess || !currentCliVersion) return null
return (
- <Popover_Shadcn_>
+ <Popover_Shadcn_
+ onOpenChange={(open) => {
+ if (open) track('header_local_version_popover_opened')
+ }}
+ >
<PopoverTrigger_Shadcn_ className="flex items-center">
<Badge variant={isBeta ? 'warning' : hasUpdate ? 'success' : 'default'}>
{isBeta ? 'Beta' : hasUpdate ? 'Update available' : 'Latest'}
diff --git a/apps/studio/components/layouts/Navigation/LayoutHeader/MergeRequestButton.tsx b/apps/studio/components/layouts/Navigation/LayoutHeader/MergeRequestButton.tsx
index 7c56a418696..49f08ee4b28 100644
--- a/apps/studio/components/layouts/Navigation/LayoutHeader/MergeRequestButton.tsx
+++ b/apps/studio/components/layouts/Navigation/LayoutHeader/MergeRequestButton.tsx
@@ -9,6 +9,7 @@ import { useBranchesQuery } from '@/data/branches/branches-query'
import { useSendEventMutation } from '@/data/telemetry/send-event-mutation'
import { useSelectedOrganizationQuery } from '@/hooks/misc/useSelectedOrganization'
import { useSelectedProjectQuery } from '@/hooks/misc/useSelectedProject'
+import { useTrack } from '@/lib/telemetry/track'
export const MergeRequestButton = () => {
const { ref } = useParams()
@@ -21,6 +22,7 @@ export const MergeRequestButton = () => {
const { data: branches } = useBranchesQuery({ projectRef }, { enabled: Boolean(projectDetails) })
const { mutate: sendEvent } = useSendEventMutation()
+ const track = useTrack()
const { mutate: updateBranch, isPending: isUpdating } = useBranchUpdateMutation({
onError: () => {
@@ -37,6 +39,7 @@ export const MergeRequestButton = () => {
const buttonLabel = hasReviewRequested ? 'Review merge request' : 'Open merge request'
const handleClick = () => {
+ track('header_merge_request_button_clicked', { hasReviewRequested })
if (hasReviewRequested) {
router.push(`/project/${selectedBranch.project_ref}/merge`)
} else {
diff --git a/packages/common/telemetry-constants.ts b/packages/common/telemetry-constants.ts
index 1320da9f1c9..df9c23ee250 100644
--- a/packages/common/telemetry-constants.ts
+++ b/packages/common/telemetry-constants.ts
@@ -3203,6 +3203,177 @@ export interface UnifiedLogsRowClickedEvent {
groups: TelemetryGroups
}
+/**
+ * User clicked the Supabase logo in the top-left corner of the page header.
+ *
+ * @group Events
+ * @source studio
+ */
+export interface HeaderHomeLogoClickedEvent {
+ action: 'header_home_logo_clicked'
+ groups: Partial<TelemetryGroups>
+}
+
+/**
+ * User clicked the mobile back-to-dashboard chevron in the page header.
+ *
+ * @group Events
+ * @source studio
+ */
+export interface HeaderBackToDashboardClickedEvent {
+ action: 'header_back_to_dashboard_clicked'
+ groups: Partial<TelemetryGroups>
+}
+
+/**
+ * User clicked the "Exceeding usage limits" badge in the page header.
+ *
+ * @group Events
+ * @source studio
+ */
+export interface HeaderExceedingUsageBadgeClickedEvent {
+ action: 'header_exceeding_usage_badge_clicked'
+ groups: Partial<TelemetryGroups>
+}
+
+/**
+ * User opened the organization dropdown in the page header.
+ *
+ * @group Events
+ * @source studio
+ */
+export interface HeaderOrganizationDropdownOpenedEvent {
+ action: 'header_organization_dropdown_opened'
+ groups: Partial<TelemetryGroups>
+}
+
+/**
+ * User opened the project dropdown in the page header.
+ *
+ * @group Events
+ * @source studio
+ */
+export interface HeaderProjectDropdownOpenedEvent {
+ action: 'header_project_dropdown_opened'
+ groups: Partial<TelemetryGroups>
+}
+
+/**
+ * User opened the branch dropdown in the page header.
+ *
+ * @group Events
+ * @source studio
+ */
+export interface HeaderBranchDropdownOpenedEvent {
+ action: 'header_branch_dropdown_opened'
+ groups: Partial<TelemetryGroups>
+}
+
+/**
+ * User clicked the merge-request trigger button in the page header.
+ * Fires on click; the existing branch_create_merge_request_button_clicked
+ * fires only on successful merge-request creation.
+ *
+ * @group Events
+ * @source studio
+ */
+export interface HeaderMergeRequestButtonClickedEvent {
+ action: 'header_merge_request_button_clicked'
+ properties: {
+ /** Whether a review has already been requested for this branch. */
+ hasReviewRequested: boolean
+ }
+ groups: TelemetryGroups
+}
+
+/**
+ * User clicked the "Connect" button in the page header.
+ *
+ * @group Events
+ * @source studio
+ */
+export interface HeaderConnectButtonClickedEvent {
+ action: 'header_connect_button_clicked'
+ groups: TelemetryGroups
+}
+
+/**
+ * User opened the feedback dropdown in the page header.
+ *
+ * @group Events
+ * @source studio
+ */
+export interface HeaderFeedbackDropdownOpenedEvent {
+ action: 'header_feedback_dropdown_opened'
+ groups: Partial<TelemetryGroups>
+}
+
+/**
+ * User clicked the Advisor Center toggle button in the page header.
+ *
+ * @group Events
+ * @source studio
+ */
+export interface HeaderAdvisorButtonClickedEvent {
+ action: 'header_advisor_button_clicked'
+ groups: Partial<TelemetryGroups>
+}
+
+/**
+ * User clicked the Inline SQL Editor toggle button in the page header.
+ *
+ * @group Events
+ * @source studio
+ */
+export interface HeaderInlineEditorButtonClickedEvent {
+ action: 'header_inline_editor_button_clicked'
+ groups: Partial<TelemetryGroups>
+}
+
+/**
+ * User clicked the AI Assistant toggle button in the page header.
+ *
+ * @group Events
+ * @source studio
+ */
+export interface HeaderAssistantButtonClickedEvent {
+ action: 'header_assistant_button_clicked'
+ groups: Partial<TelemetryGroups>
+}
+
+/**
+ * User opened the user/account dropdown in the page header.
+ *
+ * @group Events
+ * @source studio
+ */
+export interface HeaderUserDropdownOpenedEvent {
+ action: 'header_user_dropdown_opened'
+ groups: Partial<TelemetryGroups>
+}
+
+/**
+ * User opened the local-development settings dropdown in the page header.
+ *
+ * @group Events
+ * @source studio
+ */
+export interface HeaderLocalDropdownOpenedEvent {
+ action: 'header_local_dropdown_opened'
+ groups: Partial<TelemetryGroups>
+}
+
+/**
+ * User opened the local CLI version popover in the page header.
+ *
+ * @group Events
+ * @source studio
+ */
+export interface HeaderLocalVersionPopoverOpenedEvent {
+ action: 'header_local_version_popover_opened'
+ groups: Partial<TelemetryGroups>
+}
+
/**
* @hidden
*/
@@ -3383,3 +3554,18 @@ export type TelemetryEvent =
| ResourceExhaustionBannerUpgradeClickedEvent
| ResourceExhaustionBannerAiAssistantClickedEvent
| UnifiedLogsRowClickedEvent
+ | HeaderHomeLogoClickedEvent
+ | HeaderBackToDashboardClickedEvent
+ | HeaderExceedingUsageBadgeClickedEvent
+ | HeaderOrganizationDropdownOpenedEvent
+ | HeaderProjectDropdownOpenedEvent
+ | HeaderBranchDropdownOpenedEvent
+ | HeaderMergeRequestButtonClickedEvent
+ | HeaderConnectButtonClickedEvent
+ | HeaderFeedbackDropdownOpenedEvent
+ | HeaderAdvisorButtonClickedEvent
+ | HeaderInlineEditorButtonClickedEvent
+ | HeaderAssistantButtonClickedEvent
+ | HeaderUserDropdownOpenedEvent
+ | HeaderLocalDropdownOpenedEvent
+ | HeaderLocalVersionPopoverOpenedEvent