The Postgres development platform. Supabase gives you a dedicated Postgres database to build your web, mobile, and AI applications.
TypeScript aialternativeauthdatabasedenoembeddingsexamplefirebasenextjsoauth2pgvectorpostgispostgrespostgresqlpostgrestrealtimesupabasevectorswebsockets
feat(telemetry): add dev telemetry toolbar (#42259)
Sean Oliver6bbe2c3297cf
diff --git a/.github/CODEOWNERS b/.github/CODEOWNERSindex a355b309cea..1d631f4a7dc 100644--- a/.github/CODEOWNERS+++ b/.github/CODEOWNERS@@ -2,6 +2,7 @@/packages/shared-data/pricing.ts @supabase/billing/packages/shared-data/plans.ts @supabase/billing/packages/common/telemetry-constants.ts @supabase/growth-eng+/packages/dev-tools/ @supabase/growth-eng/packages/pg-meta @supabase/postgres @avallete/packages/ui-patterns @supabase/design@@ -22,4 +23,4 @@/apps/studio/data/sql/queries/ @supabase/postgres @avallete-/packages/shared-data/compute-disk-limits.ts @supabase/infra\ No newline at end of file+/packages/shared-data/compute-disk-limits.ts @supabase/infradiff --git a/apps/docs/components/Navigation/NavigationMenu/TopNavBar.tsx b/apps/docs/components/Navigation/NavigationMenu/TopNavBar.tsxindex c56f34d0fe9..c88b9525ed5 100644--- a/apps/docs/components/Navigation/NavigationMenu/TopNavBar.tsx+++ b/apps/docs/components/Navigation/NavigationMenu/TopNavBar.tsx@@ -8,6 +8,7 @@ import { memo, useState } from 'react'import { useIsLoggedIn, useIsUserLoading, useUser } from 'common'import { isFeatureEnabled } from 'common/enabled-features'+import { DevToolbarTrigger } from 'dev-tools'import { Button, buttonVariants, cn } from 'ui'import { AuthenticatedDropdownMenu, CommandMenuTriggerInput } from 'ui-patterns'import { getCustomContent } from '../../../lib/custom-content/getCustomContent'@@ -43,6 +44,7 @@ const TopNavBar: FC = () => {</div><div className="flex gap-2 items-center">+ <DevToolbarTrigger /><CommandMenuTriggerInputplaceholder={<>diff --git a/apps/docs/features/app.providers.tsx b/apps/docs/features/app.providers.tsxindex 99e73b93c98..6d6caf07877 100644--- a/apps/docs/features/app.providers.tsx+++ b/apps/docs/features/app.providers.tsx@@ -1,6 +1,7 @@import type { PropsWithChildren } from 'react'import { FeatureFlagProvider, IS_PLATFORM, ThemeProvider } from 'common'+import { DevToolbar, DevToolbarProvider } from 'dev-tools'import { SonnerToaster, TooltipProvider } from 'ui'import SiteLayout from '~/layouts/SiteLayout'import { API_URL } from '~/lib/constants'@@ -19,22 +20,25 @@ function GlobalProviders({ children }: PropsWithChildren) {<QueryClientProvider><AuthContainer><FeatureFlagProvider API_URL={API_URL} enabled={IS_PLATFORM}>- <PageTelemetry />- <ScrollRestoration />- <ThemeProvider defaultTheme="system" enableSystem disableTransitionOnChange>- <TooltipProvider delayDuration={0}>- <DocsCommandProvider>- <div className="flex flex-col">- <SiteLayout>- {children}- <DocsCommandMenu />- </SiteLayout>- <ThemeSandbox />- </div>- </DocsCommandProvider>- <SonnerToaster position="top-right" />- </TooltipProvider>- </ThemeProvider>+ <DevToolbarProvider apiUrl={API_URL}>+ <PageTelemetry />+ <ScrollRestoration />+ <ThemeProvider defaultTheme="system" enableSystem disableTransitionOnChange>+ <TooltipProvider delayDuration={0}>+ <DocsCommandProvider>+ <div className="flex flex-col">+ <SiteLayout>+ {children}+ <DocsCommandMenu />+ </SiteLayout>+ <ThemeSandbox />+ </div>+ </DocsCommandProvider>+ <SonnerToaster position="top-right" />+ <DevToolbar />+ </TooltipProvider>+ </ThemeProvider>+ </DevToolbarProvider></FeatureFlagProvider></AuthContainer></QueryClientProvider>diff --git a/apps/docs/package.json b/apps/docs/package.jsonindex a3d5c5914c1..4e4ab01a5fe 100644--- a/apps/docs/package.json+++ b/apps/docs/package.json@@ -63,6 +63,7 @@"common": "workspace:*","common-tags": "^1.8.2","config": "workspace:*",+ "dev-tools": "workspace:*","eslint-config-supabase": "workspace:*","framer-motion": "^11.0.3","github-slugger": "^2.0.0",diff --git a/apps/studio/components/layouts/ProjectLayout/LayoutHeader/LayoutHeader.tsx b/apps/studio/components/layouts/ProjectLayout/LayoutHeader/LayoutHeader.tsxindex fb17a705f34..6f663be1e76 100644--- a/apps/studio/components/layouts/ProjectLayout/LayoutHeader/LayoutHeader.tsx+++ b/apps/studio/components/layouts/ProjectLayout/LayoutHeader/LayoutHeader.tsx@@ -22,7 +22,7 @@ import { ReactNode, useMemo } from 'react'import { useAppStateSnapshot } from 'state/app-state'import { Badge, cn } from 'ui'import { CommandMenuTriggerInput } from 'ui-patterns'-+import { DevToolbarTrigger } from 'dev-tools'import { BreadcrumbsView } from './BreadcrumbsView'import { FeedbackDropdown } from './FeedbackDropdown/FeedbackDropdown'import { HelpPopover } from './HelpPopover'@@ -215,6 +215,7 @@ export const LayoutHeader = ({{customHeaderComponents && customHeaderComponents}{IS_PLATFORM ? (<>+ <DevToolbarTrigger /><FeedbackDropdown /><div className="flex items-center gap-2">diff --git a/apps/studio/package.json b/apps/studio/package.jsonindex 68d43465df2..49615234eec 100644--- a/apps/studio/package.json+++ b/apps/studio/package.json@@ -84,6 +84,7 @@"cron-parser": "^4.9.0","cronstrue": "^2.50.0","crypto-js": "^4.2.0",+ "dev-tools": "workspace:*","d3-geo": "^3.1.1","dayjs": "^1.11.10","dnd-core": "^16.0.1",diff --git a/apps/studio/pages/_app.tsx b/apps/studio/pages/_app.tsxindex 3156d1c20c0..5875b41e480 100644--- a/apps/studio/pages/_app.tsx+++ b/apps/studio/pages/_app.tsx@@ -23,22 +23,11 @@ import { loader } from '@monaco-editor/react'import * as Sentry from '@sentry/nextjs'import { HydrationBoundary, QueryClientProvider } from '@tanstack/react-query'import { ReactQueryDevtools } from '@tanstack/react-query-devtools'-import dayjs from 'dayjs'-import customParseFormat from 'dayjs/plugin/customParseFormat'-import duration from 'dayjs/plugin/duration'-import relativeTime from 'dayjs/plugin/relativeTime'-import timezone from 'dayjs/plugin/timezone'-import utc from 'dayjs/plugin/utc'-import Head from 'next/head'-import { NuqsAdapter } from 'nuqs/adapters/next/pages'-import { type ComponentProps, ErrorInfo, useCallback } from 'react'-import { ErrorBoundary } from 'react-error-boundary'-import {FeatureFlagProvider,- getFlags,TelemetryTagManager,ThemeProvider,+ getFlags,useThemeSandbox,} from 'common'import MetaFaviconsPagesRouter from 'common/MetaFavicons/pages-router'@@ -49,8 +38,15 @@ import FeaturePreviewModal from 'components/interfaces/App/FeaturePreview/Featurimport { MonacoThemeProvider } from 'components/interfaces/App/MonacoThemeProvider'import { RouteValidationWrapper } from 'components/interfaces/App/RouteValidationWrapper'import { MainScrollContainerProvider } from 'components/layouts/MainScrollContainerContext'+import { DevToolbar, DevToolbarProvider } from 'dev-tools'import { GlobalErrorBoundaryState } from 'components/ui/ErrorBoundary/GlobalErrorBoundaryState'import { useRootQueryClient } from 'data/query-client'+import dayjs from 'dayjs'+import customParseFormat from 'dayjs/plugin/customParseFormat'+import duration from 'dayjs/plugin/duration'+import relativeTime from 'dayjs/plugin/relativeTime'+import timezone from 'dayjs/plugin/timezone'+import utc from 'dayjs/plugin/utc'import { customFont, sourceCodePro } from 'fonts'import { useCustomContent } from 'hooks/custom-content/useCustomContent'import { useSelectedOrganizationQuery } from 'hooks/misc/useSelectedOrganization'@@ -58,6 +54,10 @@ import { AuthProvider } from 'lib/auth'import { API_URL, BASE_PATH, IS_PLATFORM, useDefaultProvider } from 'lib/constants'import { ProfileProvider } from 'lib/profile'import { Telemetry } from 'lib/telemetry'+import Head from 'next/head'+import { NuqsAdapter } from 'nuqs/adapters/next/pages'+import { type ComponentProps, ErrorInfo, useCallback } from 'react'+import { ErrorBoundary } from 'react-error-boundary'import { AiAssistantStateContextProvider } from 'state/ai-assistant-state'import type { AppPropsWithLayout } from 'types'import { SonnerToaster, TooltipProvider } from 'ui'@@ -173,19 +173,22 @@ function CustomApp({ Component, pageProps }: AppPropsWithLayout) {enableSystemdisableTransitionOnChange>- <AiAssistantStateContextProvider>- <CommandProvider>- <FeaturePreviewContextProvider>- <MainScrollContainerProvider>- {getLayout(<Component {...pageProps} />)}- </MainScrollContainerProvider>- <StudioCommandMenu />- <FeaturePreviewModal />- </FeaturePreviewContextProvider>- <SonnerToaster position="top-right" />- <MonacoThemeProvider />- </CommandProvider>- </AiAssistantStateContextProvider>+ <DevToolbarProvider apiUrl={API_URL}>+ <AiAssistantStateContextProvider>+ <CommandProvider>+ <FeaturePreviewContextProvider>+ <MainScrollContainerProvider>+ {getLayout(<Component {...pageProps} />)}+ </MainScrollContainerProvider>+ <StudioCommandMenu />+ <FeaturePreviewModal />+ </FeaturePreviewContextProvider>+ <SonnerToaster position="top-right" />+ <MonacoThemeProvider />+ </CommandProvider>+ </AiAssistantStateContextProvider>+ <DevToolbar />+ </DevToolbarProvider></ThemeProvider></RouteValidationWrapper></TooltipProvider>diff --git a/apps/www/app/providers.tsx b/apps/www/app/providers.tsxindex 298b3b390ea..663b4d9c206 100644--- a/apps/www/app/providers.tsx+++ b/apps/www/app/providers.tsx@@ -11,6 +11,7 @@ import {useThemeSandbox,} from 'common'import { WwwCommandMenu } from 'components/CommandMenu'+import { DevToolbar, DevToolbarProvider } from 'dev-tools'import { API_URL } from 'lib/constants'import { themes, TooltipProvider, SonnerToaster } from 'ui'import { CommandProvider } from 'ui-patterns/CommandMenu'@@ -25,21 +26,28 @@ function Providers({ children }: { children: React.ReactNode }) {<NuqsAdapter><AuthProvider><FeatureFlagProvider API_URL={API_URL} enabled={IS_PLATFORM}>- <ThemeProvider themes={themes.map((t) => t.value)} enableSystem disableTransitionOnChange>- <TooltipProvider delayDuration={0}>- <CommandProvider>- <TelemetryTagManager />- <SonnerToaster position="top-right" />- <Suspense fallback={null}>{children}</Suspense>- <WwwCommandMenu />- <PageTelemetry- API_URL={API_URL}- hasAcceptedConsent={hasAcceptedConsent}- enabled={IS_PLATFORM}- />- </CommandProvider>- </TooltipProvider>- </ThemeProvider>+ <DevToolbarProvider apiUrl={API_URL}>+ <ThemeProvider+ themes={themes.map((t) => t.value)}+ enableSystem+ disableTransitionOnChange+ >+ <TooltipProvider delayDuration={0}>+ <CommandProvider>+ <TelemetryTagManager />+ <SonnerToaster position="top-right" />+ <Suspense fallback={null}>{children}</Suspense>+ <WwwCommandMenu />+ <PageTelemetry+ API_URL={API_URL}+ hasAcceptedConsent={hasAcceptedConsent}+ enabled={IS_PLATFORM}+ />+ <DevToolbar />+ </CommandProvider>+ </TooltipProvider>+ </ThemeProvider>+ </DevToolbarProvider></FeatureFlagProvider></AuthProvider></NuqsAdapter>diff --git a/apps/www/components/Nav/index.tsx b/apps/www/components/Nav/index.tsxindex ce02b7cd8bc..01ed84f4cc0 100644--- a/apps/www/components/Nav/index.tsx+++ b/apps/www/components/Nav/index.tsx@@ -6,6 +6,7 @@ import React, { useState } from 'react'import { useWindowSize } from 'react-use'import { useIsLoggedIn, useIsUserLoading, useUser } from 'common'+import { DevToolbarTrigger } from 'dev-tools'import { Button, buttonVariants, cn } from 'ui'import { AuthenticatedDropdownMenu } from 'ui-patterns'@@ -155,6 +156,7 @@ const Nav = ({ hideNavbar, stickyNavbar = true }: Props) => {isUserLoading ? 'opacity-0' : 'opacity-100')}>+ <DevToolbarTrigger /><GitHubButton />{isLoggedIn ? (<>diff --git a/apps/www/package.json b/apps/www/package.jsonindex a2432a74126..15905a8a84b 100644--- a/apps/www/package.json+++ b/apps/www/package.json@@ -45,6 +45,7 @@"common-tags": "^1.8.2","config": "workspace:*","dayjs": "^1.11.12",+ "dev-tools": "workspace:*","eslint-config-supabase": "workspace:*","framer-motion": "^11.0.3","globby": "^13.2.2",diff --git a/apps/www/pages/_app.tsx b/apps/www/pages/_app.tsxindex 55a845f09b0..3b043b098fd 100644--- a/apps/www/pages/_app.tsx+++ b/apps/www/pages/_app.tsx@@ -11,6 +11,7 @@ import {ThemeProvider,useThemeSandbox,} from 'common'+import { DevToolbar, DevToolbarProvider } from 'dev-tools'import { DefaultSeo } from 'next-seo'import type { AppProps } from 'next/app'import Head from 'next/head'@@ -90,25 +91,28 @@ export default function App({ Component, pageProps }: AppProps) {<AuthProvider>{/* [TODO] I think we need to deconflict with the providers in layout.tsx? */}<FeatureFlagProvider API_URL={API_URL} enabled={{ cc: true, ph: false }}>- <ThemeProvider- themes={themes.map((theme) => theme.value)}- enableSystem- disableTransitionOnChange- forcedTheme={forceDarkMode ? 'dark' : undefined}- >- <TooltipProvider delayDuration={0}>- <CommandProvider app="www" onTelemetry={onTelemetry}>- <SonnerToaster position="top-right" />- <Component {...pageProps} />- <WwwCommandMenu />- <PageTelemetry- API_URL={API_URL}- hasAcceptedConsent={hasAcceptedConsent}- enabled={IS_PLATFORM}- />- </CommandProvider>- </TooltipProvider>- </ThemeProvider>+ <DevToolbarProvider apiUrl={API_URL}>+ <ThemeProvider+ themes={themes.map((theme) => theme.value)}+ enableSystem+ disableTransitionOnChange+ forcedTheme={forceDarkMode ? 'dark' : undefined}+ >+ <TooltipProvider delayDuration={0}>+ <CommandProvider app="www" onTelemetry={onTelemetry}>+ <SonnerToaster position="top-right" />+ <Component {...pageProps} />+ <WwwCommandMenu />+ <PageTelemetry+ API_URL={API_URL}+ hasAcceptedConsent={hasAcceptedConsent}+ enabled={IS_PLATFORM}+ />+ <DevToolbar />+ </CommandProvider>+ </TooltipProvider>+ </ThemeProvider>+ </DevToolbarProvider></FeatureFlagProvider></AuthProvider><TelemetryTagManager />diff --git a/packages/common/feature-flags.tsx b/packages/common/feature-flags.tsxindex 7a82f84a5e6..cbaaba96c9c 100644--- a/packages/common/feature-flags.tsx+++ b/packages/common/feature-flags.tsx@@ -163,17 +163,50 @@ export const FeatureFlagProvider = ({: Promise.resolve([]),])+ const isLocalDev = process.env.NODE_ENV === 'development'++ const safeParse = (+ value: string | undefined+ ): Record<string, boolean | number | string> => {+ if (!value) return {}+ try {+ return JSON.parse(value)+ } catch {+ return {}+ }+ }+// Process PostHog flags if loadedif (Object.keys(flags).length > 0) {- flagStore.posthog = flags+ // Apply local dev overrides for PostHog flags+ if (isLocalDev) {+ try {+ const cookies = getCookies()+ const phOverrides = safeParse(cookies['x-ph-flag-overrides'])+ flagStore.posthog = { ...flags, ...phOverrides }+ } catch {+ flagStore.posthog = flags+ }+ } else {+ flagStore.posthog = flags+ }}// Process ConfigCat flags if loadedif (flagValues.length > 0) {- let overridesCookieValue: Record<string, boolean> = {}+ let overridesCookieValue: Record<string, boolean | number | string> = {}+try {const cookies = getCookies()- overridesCookieValue = JSON.parse(cookies['vercel-flag-overrides'])+ // Merge overrides: vercel-flag-overrides first, then x-cc-flag-overrides (local only)+ // x-cc-flag-overrides takes precedence in local dev+ const vercelOverrides = safeParse(cookies['vercel-flag-overrides'])+ const ccOverrides = isLocalDev ? safeParse(cookies['x-cc-flag-overrides']) : {}++ overridesCookieValue = {+ ...vercelOverrides,+ ...ccOverrides, // local overrides take precedence+ }} catch {}flagValues.forEach((item) => {diff --git a/packages/common/posthog-client.ts b/packages/common/posthog-client.tsindex 2f0c3fcf828..24284840a02 100644--- a/packages/common/posthog-client.ts+++ b/packages/common/posthog-client.ts@@ -4,6 +4,17 @@ import posthog, { PostHogConfig } from 'posthog-js'// (e.g. if a user navigates around a lot before accepting consent)const MAX_PENDING_EVENTS = 20+export interface ClientTelemetryEvent {+ id: string+ timestamp: number+ eventType: 'capture' | 'identify' | 'pageview' | 'pageleave'+ eventName: string+ distinctId?: string+ properties?: Record<string, unknown>+}++type ClientTelemetryListener = (event: ClientTelemetryEvent) => void+interface PostHogClientConfig {apiKey?: stringapiHost?: string@@ -21,6 +32,7 @@ class PostHogClient {private pendingExposures: Array<{ experimentId: string; properties: Record<string, any> }> = []private config: PostHogClientConfigprivate readonly maxPendingEvents = MAX_PENDING_EVENTS+ private devListeners: Set<ClientTelemetryListener> = new Set()constructor(config: PostHogClientConfig = {}) {const apiHost =@@ -119,6 +131,8 @@ class PostHogClient {}posthog.capture('$pageview', properties, { transport: 'sendBeacon' })++ this.emitToDevListeners('pageview', '$pageview', properties)} catch (error) {console.error('PostHog pageview capture failed:', error)}@@ -140,6 +154,8 @@ class PostHogClient {try {// Use sendBeacon for page leave to survive tab closeposthog.capture('$pageleave', properties, { transport: 'sendBeacon' })++ this.emitToDevListeners('pageleave', '$pageleave', properties)} catch (error) {console.error('PostHog pageleave capture failed:', error)}@@ -156,6 +172,8 @@ class PostHogClient {try {posthog.identify(userId, properties)++ this.emitToDevListeners('identify', '$identify', { userId, ...properties })} catch (error) {console.error('PostHog identify failed:', error)}@@ -285,6 +303,44 @@ class PostHogClient {console.error('PostHog experiment exposure capture failed:', error)}}++ subscribeToEvents(listener: ClientTelemetryListener): () => void {+ this.devListeners.add(listener)+ return () => this.devListeners.delete(listener)+ }++ private emitToDevListeners(+ eventType: ClientTelemetryEvent['eventType'],+ eventName: string,+ properties?: Record<string, unknown>+ ) {+ if (this.devListeners.size === 0) return++ let distinctId: string | undefined+ try {+ const id = posthog.get_distinct_id?.()+ if (id && id.length > 0) {+ distinctId = id+ }+ } catch {}++ const event: ClientTelemetryEvent = {+ id: `client-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`,+ timestamp: Date.now(),+ eventType,+ eventName,+ distinctId,+ properties,+ }++ this.devListeners.forEach((listener) => {+ try {+ listener(event)+ } catch (e) {+ console.error('Dev telemetry listener error:', e)+ }+ })+ }}export const posthogClient = new PostHogClient()diff --git a/packages/common/telemetry.tsx b/packages/common/telemetry.tsxindex a1965ed9ff3..29c416c8bd9 100644--- a/packages/common/telemetry.tsx+++ b/packages/common/telemetry.tsx@@ -14,7 +14,7 @@ import { useFeatureFlags } from './feature-flags'import { post } from './fetchWrappers'import { ensurePlatformSuffix, isBrowser } from './helpers'import { useParams, useTelemetryCookie } from './hooks'-import { posthogClient } from './posthog-client'+import { posthogClient, type ClientTelemetryEvent } from './posthog-client'import { TelemetryEvent } from './telemetry-constants'import {clearTelemetryDataCookie,@@ -22,7 +22,7 @@ import {getTelemetryCookieOptions,} from './telemetry-utils'-export { posthogClient }+export { posthogClient, type ClientTelemetryEvent }const { TELEMETRY_DATA } = LOCAL_STORAGE_KEYSdiff --git a/packages/dev-tools/DevToolbar.test.tsx b/packages/dev-tools/DevToolbar.test.tsxnew file mode 100644index 00000000000..0029db6dfd3--- /dev/null+++ b/packages/dev-tools/DevToolbar.test.tsx@@ -0,0 +1,386 @@+import { act, render, screen, waitFor } from '@testing-library/react'+import userEvent from '@testing-library/user-event'+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'++declare global {+ interface Window {+ devTelemetry?: () => void+ }+}++// Mock common package+vi.mock('common', async () => {+ return {+ useParams: () => ({ ref: 'default' }),+ useFeatureFlags: () => ({+ posthog: {},+ configcat: {},+ }),+ posthogClient: {+ subscribeToEvents: vi.fn(() => () => {}),+ },+ ensurePlatformSuffix: (url: string) => url,+ }+})++const originalEnv = process.env.NODE_ENV++/**+ * Helper to render the full component tree as used in production.+ * The Provider sets up window.devTelemetry and manages state.+ * The Trigger shows the activity icon in the header.+ * The Toolbar is the actual panel/sheet.+ */+async function renderFullToolbar() {+ const { DevToolbarProvider } = await import('./DevToolbarContext')+ const { DevToolbarTrigger } = await import('./DevToolbarTrigger')+ const { DevToolbar } = await import('./DevToolbar')++ return render(+ <DevToolbarProvider apiUrl="http://localhost:3000">+ <DevToolbarTrigger />+ <DevToolbar />+ </DevToolbarProvider>+ )+}++describe('DevToolbar', () => {+ beforeEach(() => {+ const store = new Map<string, string>()+ const localStorageMock = {+ getItem: (key: string) => store.get(key) ?? null,+ setItem: (key: string, value: string) => {+ store.set(key, value)+ },+ removeItem: (key: string) => {+ store.delete(key)+ },+ clear: () => {+ store.clear()+ },+ key: (index: number) => Array.from(store.keys())[index] ?? null,+ get length() {+ return store.size+ },+ }++ Object.defineProperty(globalThis, 'localStorage', {+ value: localStorageMock,+ writable: true,+ })++ localStorage.clear()+ delete window.devTelemetry+ vi.spyOn(console, 'warn').mockImplementation(() => {})+ vi.spyOn(console, 'error').mockImplementation(() => {})+ })++ afterEach(() => {+ process.env.NODE_ENV = originalEnv+ vi.resetModules()+ vi.restoreAllMocks()+ })++ describe('when not in local development', () => {+ beforeEach(() => {+ process.env.NODE_ENV = 'production'+ })++ it('returns null and does not render anything', async () => {+ vi.resetModules()+ const { container } = await renderFullToolbar()++ // Neither trigger nor toolbar should render in production+ expect(container.querySelector('button')).toBeNull()+ })++ it('does not register window.devTelemetry', async () => {+ vi.resetModules()+ await renderFullToolbar()++ expect(window.devTelemetry).toBeUndefined()+ })+ })++ describe('when in local development but not enabled', () => {+ beforeEach(() => {+ process.env.NODE_ENV = 'development'+ })++ it('does not render trigger when toolbar is not enabled', async () => {+ vi.resetModules()+ const { container } = await renderFullToolbar()++ // Trigger should not render when not enabled+ expect(container.querySelector('button')).toBeNull()+ })++ it('registers window.devTelemetry function', async () => {+ vi.resetModules()+ await renderFullToolbar()++ expect(window.devTelemetry).toBeDefined()+ expect(typeof window.devTelemetry).toBe('function')+ })+ })++ describe('when in local development and enabled', () => {+ beforeEach(() => {+ process.env.NODE_ENV = 'development'+ localStorage.setItem('dev-telemetry-toolbar-enabled', 'true')+ })++ it('renders the trigger button when enabled via localStorage', async () => {+ vi.resetModules()+ await renderFullToolbar()++ // The trigger should be a button with the Activity icon+ const triggerButton = screen.getByRole('button')+ expect(triggerButton).toBeInTheDocument()+ })++ it('opens the toolbar sheet when trigger is clicked', async () => {+ vi.resetModules()+ const user = userEvent.setup()+ await renderFullToolbar()++ const triggerButton = screen.getByRole('button')+ await user.click(triggerButton)++ // Sheet should open with the title+ await waitFor(() => {+ expect(screen.getByText('Dev Telemetry')).toBeInTheDocument()+ })+ })++ it('shows Events and Flags tabs in the toolbar', async () => {+ vi.resetModules()+ const user = userEvent.setup()+ await renderFullToolbar()++ const triggerButton = screen.getByRole('button')+ await user.click(triggerButton)++ await waitFor(() => {+ expect(screen.getByRole('tab', { name: /Events/i })).toBeInTheDocument()+ expect(screen.getByRole('tab', { name: /Flags/i })).toBeInTheDocument()+ })+ })++ it('shows "Local Only" badge in toolbar header', async () => {+ vi.resetModules()+ const user = userEvent.setup()+ await renderFullToolbar()++ const triggerButton = screen.getByRole('button')+ await user.click(triggerButton)++ await waitFor(() => {+ expect(screen.getByText('Local Only')).toBeInTheDocument()+ })+ })+ })++ describe('window.devTelemetry function', () => {+ beforeEach(() => {+ process.env.NODE_ENV = 'development'+ })++ it('enables toolbar when called', async () => {+ vi.resetModules()+ const { rerender } = await renderFullToolbar()++ // Trigger should not be visible initially+ expect(screen.queryByRole('button')).not.toBeInTheDocument()++ // Call devTelemetry to enable+ act(() => {+ window.devTelemetry?.()+ })++ // Re-import and rerender to pick up state change+ vi.resetModules()+ const { DevToolbarProvider } = await import('./DevToolbarContext')+ const { DevToolbarTrigger } = await import('./DevToolbarTrigger')+ const { DevToolbar } = await import('./DevToolbar')++ rerender(+ <DevToolbarProvider apiUrl="http://localhost:3000">+ <DevToolbarTrigger />+ <DevToolbar />+ </DevToolbarProvider>+ )++ expect(localStorage.getItem('dev-telemetry-toolbar-enabled')).toBe('true')+ })+ })++ describe('cleanup', () => {+ it('removes window.devTelemetry on unmount', async () => {+ process.env.NODE_ENV = 'development'++ vi.resetModules()+ const result = await renderFullToolbar()++ expect(window.devTelemetry).toBeDefined()++ result.unmount()++ expect(window.devTelemetry).toBeUndefined()+ })+ })++ describe('EventCard keyboard accessibility', () => {+ beforeEach(() => {+ process.env.NODE_ENV = 'development'+ localStorage.setItem('dev-telemetry-toolbar-enabled', 'true')+ })++ it('toolbar renders correctly with empty events state', async () => {+ vi.resetModules()++ const user = userEvent.setup()+ await renderFullToolbar()++ const triggerButton = screen.getByRole('button')+ await user.click(triggerButton)++ await waitFor(() => {+ expect(screen.getByText('Dev Telemetry')).toBeInTheDocument()+ })++ // Events tab should be active by default and show empty state+ expect(screen.getByText(/No events yet/i)).toBeInTheDocument()+ })+ })++ describe('Flag override UI', () => {+ beforeEach(() => {+ process.env.NODE_ENV = 'development'+ localStorage.setItem('dev-telemetry-toolbar-enabled', 'true')+ })++ it('shows PostHog and ConfigCat sub-tabs in Flags tab', async () => {+ vi.resetModules()+ const user = userEvent.setup()+ await renderFullToolbar()++ const triggerButton = screen.getByRole('button')+ await user.click(triggerButton)++ // Switch to Flags tab+ await waitFor(() => {+ expect(screen.getByRole('tab', { name: /Flags/i })).toBeInTheDocument()+ })++ const flagsTab = screen.getByRole('tab', { name: /Flags/i })+ await user.click(flagsTab)++ await waitFor(() => {+ expect(screen.getByRole('tab', { name: /PostHog/i })).toBeInTheDocument()+ expect(screen.getByRole('tab', { name: /ConfigCat/i })).toBeInTheDocument()+ })+ })+ })+})++describe('DevToolbar utils', () => {+ describe('safeJsonParse', () => {+ it('logs warning for invalid JSON in local environment', async () => {+ process.env.NODE_ENV = 'development'+ const consoleSpy = vi.spyOn(console, 'warn')++ vi.resetModules()+ const { safeJsonParse } = await import('./utils')++ const result = safeJsonParse('invalid json', {}, 'test context')++ expect(result).toEqual({})+ expect(consoleSpy).toHaveBeenCalledWith(+ expect.stringContaining('[DevToolbar] Failed to parse JSON'),+ expect.anything()+ )+ })++ it('returns fallback for undefined input', async () => {+ vi.resetModules()+ const { safeJsonParse } = await import('./utils')++ const result = safeJsonParse(undefined, { default: true })++ expect(result).toEqual({ default: true })+ })++ it('parses valid JSON correctly', async () => {+ vi.resetModules()+ const { safeJsonParse } = await import('./utils')++ const result = safeJsonParse('{"key": "value"}', {})++ expect(result).toEqual({ key: 'value' })+ })+ })++ describe('parseOverrideValue', () => {+ it('preserves number type when original is number', async () => {+ vi.resetModules()+ const { parseOverrideValue } = await import('./utils')++ // String input should be converted to number+ expect(parseOverrideValue('42', 0)).toBe(42)+ expect(parseOverrideValue('3.14', 0)).toBe(3.14)+ })++ it('returns original for invalid number strings', async () => {+ vi.resetModules()+ const { parseOverrideValue } = await import('./utils')++ expect(parseOverrideValue('not a number', 5)).toBe(5)+ })++ it('preserves boolean type', async () => {+ vi.resetModules()+ const { parseOverrideValue } = await import('./utils')++ expect(parseOverrideValue(true, false)).toBe(true)+ expect(parseOverrideValue(false, true)).toBe(false)+ })++ it('preserves string type', async () => {+ vi.resetModules()+ const { parseOverrideValue } = await import('./utils')++ expect(parseOverrideValue('new value', 'original')).toBe('new value')+ expect(parseOverrideValue(123, 'original')).toBe('123')+ })+ })++ describe('valuesAreEqual', () => {+ it('handles number/string comparison', async () => {+ vi.resetModules()+ const { valuesAreEqual } = await import('./utils')++ expect(valuesAreEqual(42, '42')).toBe(true)+ expect(valuesAreEqual('42', 42)).toBe(true)+ expect(valuesAreEqual(42, '43')).toBe(false)+ })++ it('handles boolean comparison strictly', async () => {+ vi.resetModules()+ const { valuesAreEqual } = await import('./utils')++ expect(valuesAreEqual(true, true)).toBe(true)+ expect(valuesAreEqual(false, false)).toBe(true)+ expect(valuesAreEqual(true, false)).toBe(false)+ })++ it('handles null values', async () => {+ vi.resetModules()+ const { valuesAreEqual } = await import('./utils')++ expect(valuesAreEqual(null, null)).toBe(true)+ expect(valuesAreEqual(null, 'value')).toBe(false)+ expect(valuesAreEqual('value', null)).toBe(false)+ })+ })+})diff --git a/packages/dev-tools/DevToolbar.tsx b/packages/dev-tools/DevToolbar.tsxnew file mode 100644index 00000000000..3fcc9eac762--- /dev/null+++ b/packages/dev-tools/DevToolbar.tsx@@ -0,0 +1,438 @@+'use client'++import { useFeatureFlags } from 'common'+import { Activity, ChevronDown, ChevronUp, Flag } from 'lucide-react'+import {+ type ChangeEvent,+ type Dispatch,+ type SetStateAction,+ useCallback,+ useEffect,+ useState,+} from 'react'+import {+ Badge,+ Button,+ Input_Shadcn_ as Input,+ Sheet,+ SheetContent,+ SheetDescription,+ SheetHeader,+ SheetTitle,+ Switch,+ Tabs_Shadcn_ as Tabs,+ TabsContent_Shadcn_ as TabsContent,+ TabsList_Shadcn_ as TabsList,+ TabsTrigger_Shadcn_ as TabsTrigger,+ cn,+} from 'ui'++import { useDevToolbar } from './DevToolbarContext'+import type { DevTelemetryEvent } from './types'+import {+ CC_ORIGINALS_KEY,+ PH_ORIGINALS_KEY,+ deleteCookie,+ getCookie,+ parseOverrideValue,+ readOriginals,+ safeJsonParse,+ setCookie,+ valuesAreEqual,+ writeOriginals,+} from './utils'++const IS_LOCAL_DEV = process.env.NODE_ENV === 'development'++function EventCard({ event }: { event: DevTelemetryEvent }) {+ const [isExpanded, setIsExpanded] = useState(false)++ const handleToggle = () => setIsExpanded((prev) => !prev)++ return (+ <div className="border rounded-md p-3 bg-surface-100">+ <button+ type="button"+ aria-expanded={isExpanded}+ aria-label={`${event.eventName} event details`}+ className="flex items-start justify-between cursor-pointer gap-4 focus:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 rounded-sm w-full text-left"+ onClick={handleToggle}+ >+ <div className="flex flex-col gap-1 min-w-0 flex-1">+ <div className="flex items-start gap-2 flex-wrap">+ <Badge variant={event.source === 'client' ? 'default' : 'success'} className="shrink-0">+ {event.source}+ </Badge>+ <Badge variant="secondary" className="shrink-0">+ {event.eventType}+ </Badge>+ <span className="font-mono text-sm break-all">{event.eventName}</span>+ </div>+ {event.distinctId && (+ <div+ className="text-xs text-foreground-muted font-mono truncate"+ title={event.distinctId}+ >+ ID: {event.distinctId}+ </div>+ )}+ </div>+ <div className="flex items-center gap-2 text-foreground-muted shrink-0">+ <span className="text-xs whitespace-nowrap">+ {new Date(event.timestamp).toLocaleTimeString()}+ </span>+ {isExpanded ? <ChevronUp className="w-4 h-4" /> : <ChevronDown className="w-4 h-4" />}+ </div>+ </button>++ {isExpanded && (+ <pre className="mt-3 p-2 bg-surface-200 rounded text-xs overflow-x-auto max-h-[300px] overflow-y-auto">+ {JSON.stringify(event.properties, null, 2)}+ </pre>+ )}+ </div>+ )+}++function FlagCard({+ flagName,+ currentValue,+ originalValue,+ isOverridden,+ onToggle,+}: {+ flagName: string+ currentValue: unknown+ originalValue: unknown+ isOverridden: boolean+ onToggle: (value: unknown) => void+}) {+ const valueType = typeof originalValue+ const isNull = originalValue === null+ const inputProps = {+ value: String(currentValue),+ onChange: (event: ChangeEvent<HTMLInputElement>) => onToggle(event.target.value),+ className: 'w-32',+ }++ return (+ <div className={cn('border rounded-md p-3', isOverridden && 'border-warning bg-warning/5')}>+ <div className="flex items-center justify-between">+ <div className="flex items-center gap-2 flex-1 min-w-0">+ <span className="font-mono text-sm truncate">{flagName}</span>+ {isOverridden && (+ <Badge variant="warning" className="shrink-0">+ Overridden+ </Badge>+ )}+ {isNull && (+ <Badge variant="secondary" className="shrink-0">+ null+ </Badge>+ )}+ </div>++ {isNull ? (+ <Input value="null" disabled className="w-32 opacity-50" />+ ) : valueType === 'boolean' ? (+ <Switch+ checked={currentValue as boolean}+ onCheckedChange={(checked) => onToggle(checked)}+ />+ ) : valueType === 'number' ? (+ <Input type="number" {...inputProps} />+ ) : (+ <Input {...inputProps} />+ )}+ </div>++ {isOverridden && (+ <div className="mt-2 text-xs text-foreground-muted">+ Original:{' '}+ <code className="bg-surface-200 px-1 rounded">{JSON.stringify(originalValue)}</code>+ </div>+ )}+ </div>+ )+}++export function DevToolbar() {+ const { isEnabled, isOpen, setIsOpen, events, setEvents } = useDevToolbar()+ const [activeTab, setActiveTab] = useState<string>('events')+ const [flagsSubTab, setFlagsSubTab] = useState<'posthog' | 'configcat'>('posthog')+ const [eventFilter, setEventFilter] = useState<string>('')+ const { posthog: posthogFlags, configcat: configcatFlags } = useFeatureFlags()+ const [phFlagOverrides, setPhFlagOverrides] = useState<Record<string, unknown>>({})+ const [ccFlagOverrides, setCcFlagOverrides] = useState<Record<string, unknown>>({})+ const [phFlagOriginals, setPhFlagOriginals] = useState<Record<string, unknown>>({})+ const [ccFlagOriginals, setCcFlagOriginals] = useState<Record<string, unknown>>({})++ const loadOverrides = useCallback(+ (cookieName: string, label: string, setter: (value: Record<string, unknown>) => void) => {+ const parsed = safeJsonParse<Record<string, unknown>>(getCookie(cookieName), {}, label)+ if (Object.keys(parsed).length > 0) {+ setter(parsed)+ }+ },+ []+ )++ const saveOverrides = useCallback(+ (+ cookieName: string,+ overrides: Record<string, unknown>,+ setter: (value: Record<string, unknown>) => void+ ) => {+ setter(overrides)+ if (Object.keys(overrides).length > 0) {+ setCookie(cookieName, JSON.stringify(overrides), '/')+ } else {+ deleteCookie(cookieName)+ }+ },+ []+ )++ const updateOriginals = useCallback(+ (+ storageKey: typeof PH_ORIGINALS_KEY | typeof CC_ORIGINALS_KEY,+ setter: Dispatch<SetStateAction<Record<string, unknown>>>+ ) =>+ (updater: (prev: Record<string, unknown>) => Record<string, unknown>) => {+ setter((prev) => {+ const next = updater(prev)+ writeOriginals(storageKey, next)+ return next+ })+ },+ []+ )++ useEffect(() => {+ loadOverrides('x-ph-flag-overrides', 'PostHog flag overrides', setPhFlagOverrides)+ loadOverrides('x-cc-flag-overrides', 'ConfigCat flag overrides', setCcFlagOverrides)+ }, [loadOverrides])++ useEffect(() => {+ setPhFlagOriginals(readOriginals(PH_ORIGINALS_KEY))+ setCcFlagOriginals(readOriginals(CC_ORIGINALS_KEY))+ }, [])++ const updatePhOriginals = updateOriginals(PH_ORIGINALS_KEY, setPhFlagOriginals)+ const updateCcOriginals = updateOriginals(CC_ORIGINALS_KEY, setCcFlagOriginals)++ const togglePhFlagOverride = (flagName: string, value: unknown) => {+ const originalValue = phFlagOriginals[flagName] ?? posthogFlags[flagName]+ const parsedValue = parseOverrideValue(value, originalValue)+ if (valuesAreEqual(parsedValue, originalValue)) {+ const newOverrides = { ...phFlagOverrides }+ delete newOverrides[flagName]+ saveOverrides('x-ph-flag-overrides', newOverrides, setPhFlagOverrides)+ return+ }++ updatePhOriginals((prev) =>+ flagName in prev ? prev : { ...prev, [flagName]: posthogFlags[flagName] }+ )+ const newOverrides = { ...phFlagOverrides, [flagName]: parsedValue }+ saveOverrides('x-ph-flag-overrides', newOverrides, setPhFlagOverrides)+ }++ const toggleCcFlagOverride = (flagName: string, value: unknown) => {+ const originalValue = ccFlagOriginals[flagName] ?? configcatFlags[flagName]+ const parsedValue = parseOverrideValue(value, originalValue)+ if (valuesAreEqual(parsedValue, originalValue)) {+ const newOverrides = { ...ccFlagOverrides }+ delete newOverrides[flagName]+ saveOverrides('x-cc-flag-overrides', newOverrides, setCcFlagOverrides)+ return+ }++ updateCcOriginals((prev) =>+ flagName in prev ? prev : { ...prev, [flagName]: configcatFlags[flagName] }+ )+ const newOverrides = { ...ccFlagOverrides, [flagName]: parsedValue }+ saveOverrides('x-cc-flag-overrides', newOverrides, setCcFlagOverrides)+ }++ const clearAllOverrides = () => {+ setPhFlagOverrides({})+ setCcFlagOverrides({})+ setPhFlagOriginals({})+ setCcFlagOriginals({})+ deleteCookie('x-ph-flag-overrides')+ deleteCookie('x-cc-flag-overrides')+ writeOriginals(PH_ORIGINALS_KEY, {})+ writeOriginals(CC_ORIGINALS_KEY, {})+ window.location.reload()+ }++ const normalizedFilter = eventFilter.trim().toLowerCase()+ const filteredEvents = (+ normalizedFilter+ ? events.filter(+ (e) =>+ e.eventName.toLowerCase().includes(normalizedFilter) ||+ e.eventType.toLowerCase().includes(normalizedFilter)+ )+ : events+ )+ .slice()+ .sort((a, b) => b.timestamp - a.timestamp)++ const phOverrideCount = Object.keys(phFlagOverrides).length+ const ccOverrideCount = Object.keys(ccFlagOverrides).length+ const totalOverrideCount = phOverrideCount + ccOverrideCount++ if (!IS_LOCAL_DEV || !isEnabled) return null++ return (+ <Sheet open={isOpen} onOpenChange={setIsOpen}>+ <SheetContent+ side="bottom"+ size="lg"+ className="flex flex-col p-0 gap-0 overflow-hidden"+ onOpenAutoFocus={(event) => event.preventDefault()}+ >+ <SheetHeader className="px-6 py-4 border-b shrink-0 space-y-0">+ <div className="flex items-center gap-3">+ <Activity className="w-5 h-5 text-brand-500" />+ <SheetTitle className="text-lg font-semibold">Dev Telemetry</SheetTitle>+ <Badge variant="secondary">Local Only</Badge>+ </div>+ <SheetDescription className="sr-only">+ View telemetry events and feature flags for local development+ </SheetDescription>+ </SheetHeader>++ <div className="flex-1 flex flex-col min-h-0 overflow-hidden px-6 pt-4">+ <Tabs+ value={activeTab}+ onValueChange={setActiveTab}+ className="flex-1 flex flex-col min-h-0 overflow-hidden"+ >+ <TabsList className="shrink-0 mb-4">+ <TabsTrigger value="events" className="flex items-center gap-2 px-4">+ <Activity className="w-4 h-4" />+ Events ({filteredEvents.length})+ </TabsTrigger>+ <TabsTrigger value="flags" className="flex items-center gap-2 px-4">+ <Flag className="w-4 h-4" />+ Flags {totalOverrideCount > 0 && `(${totalOverrideCount} overrides)`}+ </TabsTrigger>+ </TabsList>+ {activeTab === 'events' && (+ <div className="flex-1 min-h-0 overflow-hidden flex flex-col">+ <div className="flex items-center gap-4 pb-4 shrink-0">+ <Input+ placeholder="Filter events..."+ value={eventFilter}+ onChange={(e) => setEventFilter(e.target.value)}+ className="flex-1"+ />+ <Button type="outline" onClick={() => setEvents([])}>+ Clear+ </Button>+ </div>++ <div className="flex-1 min-h-0 overflow-y-auto space-y-2 pb-6">+ {filteredEvents.length === 0 ? (+ <div className="text-center text-foreground-muted py-8">+ No events yet. Interact with the app to see telemetry events.+ </div>+ ) : (+ filteredEvents.map((event) => (+ <EventCard key={`${event.source}-${event.id}`} event={event} />+ ))+ )}+ </div>+ </div>+ )}++ {activeTab === 'flags' && (+ <div className="flex-1 min-h-0 overflow-hidden flex flex-col">+ {totalOverrideCount > 0 && (+ <div className="flex items-center justify-between p-3 bg-warning/10 rounded-md mb-4 shrink-0">+ <span className="text-sm text-warning">+ {totalOverrideCount} flag(s) overridden+ {phOverrideCount > 0 && ccOverrideCount > 0+ ? ` (${phOverrideCount} PostHog, ${ccOverrideCount} ConfigCat)`+ : ''}+ </span>+ <Button type="outline" onClick={clearAllOverrides}>+ Clear & Reload+ </Button>+ </div>+ )}++ <Tabs+ value={flagsSubTab}+ onValueChange={(v) => setFlagsSubTab(v as 'posthog' | 'configcat')}+ className="flex-1 flex flex-col min-h-0 overflow-hidden"+ >+ <TabsList className="shrink-0 mb-4">+ <TabsTrigger value="posthog" className="px-4">+ PostHog {phOverrideCount > 0 && `(${phOverrideCount})`}+ </TabsTrigger>+ <TabsTrigger value="configcat" className="px-4">+ ConfigCat {ccOverrideCount > 0 && `(${ccOverrideCount})`}+ </TabsTrigger>+ </TabsList>++ {flagsSubTab === 'posthog' && (+ <div className="flex-1 min-h-0 overflow-y-auto pb-6">+ <div className="space-y-4">+ {Object.keys(posthogFlags).length === 0 ? (+ <div className="text-center text-foreground-muted py-8">+ No PostHog feature flags loaded yet.+ </div>+ ) : (+ Object.entries(posthogFlags).map(([flagName, flagValue]) => (+ <FlagCard+ key={flagName}+ flagName={flagName}+ currentValue={+ phFlagOverrides[flagName] ?? phFlagOriginals[flagName] ?? flagValue+ }+ originalValue={phFlagOriginals[flagName] ?? flagValue}+ isOverridden={flagName in phFlagOverrides}+ onToggle={(value) => togglePhFlagOverride(flagName, value)}+ />+ ))+ )}+ </div>+ </div>+ )}+ {flagsSubTab === 'configcat' && (+ <div className="flex-1 min-h-0 overflow-y-auto pb-6">+ <div className="space-y-4">+ {Object.keys(configcatFlags).length === 0 ? (+ <div className="text-center text-foreground-muted py-8">+ No ConfigCat feature flags loaded yet.+ </div>+ ) : (+ Object.entries(configcatFlags).map(([flagName, flagValue]) => (+ <FlagCard+ key={flagName}+ flagName={flagName}+ currentValue={+ ccFlagOverrides[flagName] ?? ccFlagOriginals[flagName] ?? flagValue+ }+ originalValue={ccFlagOriginals[flagName] ?? flagValue}+ isOverridden={flagName in ccFlagOverrides}+ onToggle={(value) => toggleCcFlagOverride(flagName, value)}+ />+ ))+ )}+ </div>+ </div>+ )}+ </Tabs>+ </div>+ )}+ </Tabs>+ </div>+ </SheetContent>+ </Sheet>+ )+}diff --git a/packages/dev-tools/DevToolbarContext.tsx b/packages/dev-tools/DevToolbarContext.tsxnew file mode 100644index 00000000000..e1ef961fd97--- /dev/null+++ b/packages/dev-tools/DevToolbarContext.tsx@@ -0,0 +1,212 @@+'use client'++import { type ClientTelemetryEvent, ensurePlatformSuffix, posthogClient } from 'common'+import {+ type ReactNode,+ createContext,+ useCallback,+ useContext,+ useEffect,+ useRef,+ useState,+} from 'react'++import type {+ DevTelemetryEvent,+ DevTelemetryToolbarContextType,+ ServerTelemetryEvent,+} from './types'+import { getCookie } from './utils'++const IS_LOCAL_DEV = process.env.NODE_ENV === 'development'+const MAX_EVENTS = 200+const STORAGE_KEY = 'dev-telemetry-toolbar-enabled'++const SSE_INITIAL_RETRY_MS = 1000+const SSE_MAX_RETRY_MS = 30000+const SSE_BACKOFF_MULTIPLIER = 2++declare global {+ interface Window {+ devTelemetry?: () => void+ }+}++const DevToolbarContext = createContext<DevTelemetryToolbarContextType | null>(null)++interface DevToolbarProviderProps {+ children: ReactNode+ apiUrl: string+}++export function DevToolbarProvider({ children, apiUrl }: DevToolbarProviderProps) {+ const [isEnabled, setIsEnabled] = useState(false)+ const [isOpen, setIsOpen] = useState(false)+ const [events, setEvents] = useState<DevTelemetryEvent[]>([])++ const sseRetryDelayRef = useRef(SSE_INITIAL_RETRY_MS)+ const sseRetryTimeoutRef = useRef<NodeJS.Timeout | null>(null)++ const dismissToolbar = useCallback(() => {+ try {+ localStorage.removeItem(STORAGE_KEY)+ } catch {}+ setIsEnabled(false)+ setIsOpen(false)+ }, [])++ useEffect(() => {+ if (!IS_LOCAL_DEV) return++ let stored: string | null = null+ try {+ stored = localStorage.getItem(STORAGE_KEY)+ } catch {}+ if (stored === 'true') {+ setIsEnabled(true)+ }++ window.devTelemetry = () => {+ try {+ localStorage.setItem(STORAGE_KEY, 'true')+ } catch {}+ setIsEnabled(true)+ }++ return () => {+ delete window.devTelemetry+ }+ }, [])++ const appendEvent = useCallback((event: DevTelemetryEvent) => {+ setEvents((prev) => {+ const key = `${event.source}-${event.id}`+ if (prev.some((e) => `${e.source}-${e.id}` === key)) return prev+ return [...prev.slice(-(MAX_EVENTS - 1)), event]+ })+ }, [])++ useEffect(() => {+ if (!isEnabled) return++ const unsubscribe = posthogClient.subscribeToEvents((clientEvent: ClientTelemetryEvent) => {+ appendEvent({+ id: clientEvent.id,+ timestamp: clientEvent.timestamp,+ source: 'client',+ eventType: clientEvent.eventType,+ eventName: clientEvent.eventName,+ distinctId: clientEvent.distinctId,+ properties: clientEvent.properties,+ })+ })++ return unsubscribe+ }, [appendEvent, isEnabled])++ useEffect(() => {+ if (!isEnabled || typeof EventSource === 'undefined') return++ let eventSource: EventSource | null = null+ let isMounted = true++ const connect = () => {+ if (!isMounted) return++ const sessionId = getCookie('session_id')+ const streamUrl = `${ensurePlatformSuffix(apiUrl)}/telemetry/stream${+ sessionId ? `?session_id=${encodeURIComponent(sessionId)}` : ''+ }`++ eventSource = new EventSource(streamUrl, { withCredentials: true })++ eventSource.onopen = () => {+ sseRetryDelayRef.current = SSE_INITIAL_RETRY_MS+ }++ eventSource.onmessage = (event) => {+ try {+ const data = JSON.parse(event.data) as ServerTelemetryEvent+ appendEvent({+ id: data.id,+ timestamp: data.timestamp,+ source: 'server',+ eventType: data.eventType,+ eventName: data.eventName,+ distinctId: data.distinctId,+ properties: data.properties,+ })+ } catch (e) {+ console.error('[DevToolbar] Failed to parse SSE event:', e)+ }+ }++ eventSource.onerror = () => {+ if (!isMounted) return++ eventSource?.close()+ eventSource = null++ const delay = sseRetryDelayRef.current+ console.warn(`[DevToolbar] SSE connection error, reconnecting in ${delay}ms...`)++ if (sseRetryTimeoutRef.current) {+ clearTimeout(sseRetryTimeoutRef.current)+ sseRetryTimeoutRef.current = null+ }+ sseRetryTimeoutRef.current = setTimeout(() => {+ if (isMounted) {+ connect()+ }+ }, delay)++ sseRetryDelayRef.current = Math.min(delay * SSE_BACKOFF_MULTIPLIER, SSE_MAX_RETRY_MS)+ }+ }++ connect()++ return () => {+ isMounted = false+ eventSource?.close()+ if (sseRetryTimeoutRef.current) {+ clearTimeout(sseRetryTimeoutRef.current)+ sseRetryTimeoutRef.current = null+ }+ }+ }, [apiUrl, appendEvent, isEnabled])++ if (!IS_LOCAL_DEV) {+ return <>{children}</>+ }++ return (+ <DevToolbarContext.Provider+ value={{+ isEnabled,+ isOpen,+ setIsOpen,+ events,+ setEvents,+ dismissToolbar,+ }}+ >+ {children}+ </DevToolbarContext.Provider>+ )+}++export function useDevToolbar() {+ const context = useContext(DevToolbarContext)+ if (!context) {+ return {+ isEnabled: false,+ isOpen: false,+ setIsOpen: () => {},+ events: [],+ setEvents: () => {},+ dismissToolbar: () => {},+ }+ }+ return context+}diff --git a/packages/dev-tools/DevToolbarTrigger.tsx b/packages/dev-tools/DevToolbarTrigger.tsxnew file mode 100644index 00000000000..1a64eb43348--- /dev/null+++ b/packages/dev-tools/DevToolbarTrigger.tsx@@ -0,0 +1,113 @@+'use client'++import { Activity, EyeOff } from 'lucide-react'+import { useEffect, useRef, useState } from 'react'+import type { MouseEvent } from 'react'+import { Button, PopoverContent_Shadcn_, PopoverTrigger_Shadcn_, Popover_Shadcn_, cn } from 'ui'++import { useDevToolbar } from './DevToolbarContext'++const IS_LOCAL_DEV = process.env.NODE_ENV === 'development'++export function DevToolbarTrigger() {+ const { isEnabled, isOpen, setIsOpen, events, dismissToolbar } = useDevToolbar()+ const [popoverOpen, setPopoverOpen] = useState(false)+ const closeTimeoutRef = useRef<NodeJS.Timeout | null>(null)++ useEffect(() => {+ return () => {+ if (closeTimeoutRef.current) {+ clearTimeout(closeTimeoutRef.current)+ closeTimeoutRef.current = null+ }+ }+ }, [])++ if (!IS_LOCAL_DEV || !isEnabled) {+ return null+ }++ const eventCount = events.length++ const handleClick = () => {+ setPopoverOpen(false)+ setIsOpen(true)+ }++ const handleDismiss = () => {+ setPopoverOpen(false)+ dismissToolbar()+ }++ const handleMouseEnter = () => {+ if (closeTimeoutRef.current) {+ clearTimeout(closeTimeoutRef.current)+ closeTimeoutRef.current = null+ }+ setPopoverOpen(true)+ }++ const handleMouseLeave = () => {+ closeTimeoutRef.current = setTimeout(() => {+ setPopoverOpen(false)+ }, 100)+ }++ const handleTriggerMouseLeave = (event: MouseEvent<HTMLButtonElement>) => {+ handleMouseLeave()+ event.currentTarget.blur()+ }++ return (+ <Popover_Shadcn_ open={popoverOpen} onOpenChange={setPopoverOpen}>+ <PopoverTrigger_Shadcn_ asChild>+ <Button+ type="text"+ className={cn(+ 'relative rounded-full h-[32px] px-2',+ 'text-foreground-light hover:text-foreground',+ 'focus-visible:outline-0 focus-visible:outline-transparent focus-visible:outline-offset-0',+ isOpen && 'text-foreground bg-surface-300'+ )}+ aria-label="Open dev toolbar"+ onClick={handleClick}+ onMouseEnter={handleMouseEnter}+ onMouseLeave={handleTriggerMouseLeave}+ >+ <Activity className="w-4 h-4" />+ {eventCount > 0 && (+ <span+ className={cn(+ 'absolute -top-1 -right-1',+ 'h-4 min-w-4 px-0.5',+ 'inline-flex items-center justify-center',+ 'rounded-full bg-destructive text-white',+ 'text-[10px] font-medium leading-none'+ )}+ >+ {eventCount > 99 ? '99+' : eventCount}+ </span>+ )}+ </Button>+ </PopoverTrigger_Shadcn_>+ <PopoverContent_Shadcn_+ side="left"+ align="center"+ sideOffset={4}+ className="w-auto p-1"+ onMouseEnter={handleMouseEnter}+ onMouseLeave={handleMouseLeave}+ onOpenAutoFocus={(event) => event.preventDefault()}+ >+ <button+ type="button"+ className="flex items-center gap-2 px-2 py-1.5 text-sm rounded hover:bg-surface-200 text-foreground-light hover:text-foreground whitespace-nowrap"+ onClick={handleDismiss}+ >+ <EyeOff className="w-4 h-4 shrink-0" />+ <span>Hide</span>+ </button>+ </PopoverContent_Shadcn_>+ </Popover_Shadcn_>+ )+}diff --git a/packages/dev-tools/index.ts b/packages/dev-tools/index.tsnew file mode 100644index 00000000000..e682df49fa3--- /dev/null+++ b/packages/dev-tools/index.ts@@ -0,0 +1,36 @@+import type { ReactNode } from 'react'++import * as DevToolbarModule from './DevToolbar'+import * as DevToolbarContextModule from './DevToolbarContext'+import * as DevToolbarTriggerModule from './DevToolbarTrigger'+import type { DevTelemetryToolbarContextType } from './types'++// Tree-shaking pattern: conditionally export stubs in production+// The bundler replaces process.env.NODE_ENV at build time, making the+// ternary static. Combined with sideEffects: false, the implementation+// modules are eliminated from the production bundle.++const noopContext: DevTelemetryToolbarContextType = {+ isEnabled: false,+ isOpen: false,+ setIsOpen: () => {},+ events: [],+ setEvents: () => {},+ dismissToolbar: () => {},+}++export const DevToolbarProvider =+ process.env.NODE_ENV !== 'development'+ ? ({ children }: { children: ReactNode; apiUrl?: string }) => children+ : DevToolbarContextModule.DevToolbarProvider++export const useDevToolbar =+ process.env.NODE_ENV !== 'development' ? () => noopContext : DevToolbarContextModule.useDevToolbar++export const DevToolbar =+ process.env.NODE_ENV !== 'development' ? () => null : DevToolbarModule.DevToolbar++export const DevToolbarTrigger =+ process.env.NODE_ENV !== 'development' ? () => null : DevToolbarTriggerModule.DevToolbarTrigger++export type { DevTelemetryEvent, DevToolbarConfig } from './types'diff --git a/packages/dev-tools/package.json b/packages/dev-tools/package.jsonnew file mode 100644index 00000000000..251ff9b1282--- /dev/null+++ b/packages/dev-tools/package.json@@ -0,0 +1,39 @@+{+ "name": "dev-tools",+ "version": "0.0.0",+ "private": true,+ "sideEffects": false,+ "type": "module",+ "main": "./index.ts",+ "types": "./index.ts",+ "exports": {+ ".": "./index.ts"+ },+ "scripts": {+ "preinstall": "npx only-allow pnpm",+ "clean": "rimraf node_modules",+ "test": "vitest run",+ "test:watch": "vitest",+ "typecheck": "tsc --noEmit"+ },+ "dependencies": {+ "common": "workspace:*",+ "lucide-react": "*",+ "ui": "workspace:*"+ },+ "devDependencies": {+ "@testing-library/jest-dom": "^6.6.0",+ "@testing-library/react": "^16.0.0",+ "@testing-library/user-event": "^14.0.0",+ "@types/react": "catalog:",+ "@types/react-dom": "catalog:",+ "next-router-mock": "^0.9.13",+ "tsconfig": "workspace:*",+ "typescript": "catalog:",+ "vitest": "catalog:"+ },+ "peerDependencies": {+ "react": "catalog:",+ "react-dom": "catalog:"+ }+}diff --git a/packages/dev-tools/tsconfig.json b/packages/dev-tools/tsconfig.jsonnew file mode 100644index 00000000000..caf116d7d76--- /dev/null+++ b/packages/dev-tools/tsconfig.json@@ -0,0 +1,9 @@+{+ "extends": "tsconfig/react-library.json",+ "compilerOptions": {+ "outDir": "dist",+ "resolveJsonModule": true+ },+ "include": [".", "../ui/src/**/*.d.ts"],+ "exclude": ["dist", "node_modules"]+}diff --git a/packages/dev-tools/types.ts b/packages/dev-tools/types.tsnew file mode 100644index 00000000000..a55dffe3933--- /dev/null+++ b/packages/dev-tools/types.ts@@ -0,0 +1,35 @@+import type { Dispatch, SetStateAction } from 'react'++export interface DevTelemetryEvent {+ id: string+ timestamp: number+ source: 'client' | 'server'+ eventType: string+ eventName: string+ distinctId?: string+ properties?: Record<string, unknown>+}++export interface ServerTelemetryEvent {+ id: string+ timestamp: number+ sessionId: string+ eventType: 'capture' | 'identify' | 'groupIdentify' | 'alias'+ eventName: string+ distinctId: string+ properties?: Record<string, unknown>+ groups?: Record<string, string | number>+}++export interface DevToolbarConfig {+ apiUrl: string+}++export interface DevTelemetryToolbarContextType {+ isEnabled: boolean+ isOpen: boolean+ setIsOpen: (open: boolean) => void+ events: DevTelemetryEvent[]+ setEvents: Dispatch<SetStateAction<DevTelemetryEvent[]>>+ dismissToolbar: () => void+}diff --git a/packages/dev-tools/utils.ts b/packages/dev-tools/utils.tsnew file mode 100644index 00000000000..c8101330f47--- /dev/null+++ b/packages/dev-tools/utils.ts@@ -0,0 +1,90 @@+export function getCookie(name: string): string | undefined {+ if (typeof document === 'undefined') return undefined+ const escapedName = name.replace(/[-/\\^$*+?.()|[\]{}]/g, '\\$&')+ const match = document.cookie.match(new RegExp(`(^| )${escapedName}=([^;]+)`))+ return match ? decodeURIComponent(match[2]) : undefined+}++export function setCookie(name: string, value: string, path: string = '/') {+ if (typeof document === 'undefined') return+ document.cookie = `${name}=${encodeURIComponent(value)}; path=${path}`+}++export function deleteCookie(name: string) {+ if (typeof document === 'undefined') return+ document.cookie = `${name}=; path=/; expires=Thu, 01 Jan 1970 00:00:00 GMT`+}++export function safeJsonParse<T>(value: string | undefined, fallback: T, context?: string): T {+ if (!value) return fallback+ try {+ return JSON.parse(value) as T+ } catch (error) {+ if (process.env.NODE_ENV === 'development') {+ console.warn(`[DevToolbar] Failed to parse JSON${context ? ` for ${context}` : ''}:`, error)+ }+ return fallback+ }+}++export const PH_ORIGINALS_KEY = 'devToolbarFlagOriginals:posthog'+export const CC_ORIGINALS_KEY = 'devToolbarFlagOriginals:configcat'++export function readOriginals(+ key: typeof PH_ORIGINALS_KEY | typeof CC_ORIGINALS_KEY+): Record<string, unknown> {+ if (typeof window === 'undefined') return {}+ try {+ const stored = window.localStorage.getItem(key)+ return stored ? JSON.parse(stored) : {}+ } catch (error) {+ if (process.env.NODE_ENV === 'development') {+ console.warn(`[DevToolbar] Failed to read originals from ${key}:`, error)+ }+ return {}+ }+}++export function writeOriginals(+ key: typeof PH_ORIGINALS_KEY | typeof CC_ORIGINALS_KEY,+ value: Record<string, unknown>+) {+ if (typeof window === 'undefined') return+ if (Object.keys(value).length === 0) {+ window.localStorage.removeItem(key)+ return+ }+ window.localStorage.setItem(key, JSON.stringify(value))+}++export function valuesAreEqual(a: unknown, b: unknown): boolean {+ if (a === b) return true+ if (a == null || b == null) return false+ if (typeof a === 'number' || typeof b === 'number') {+ const numA = Number(a)+ const numB = Number(b)+ if (Number.isNaN(numA) || Number.isNaN(numB)) return false+ return numA === numB+ }+ if (typeof a === 'boolean' || typeof b === 'boolean') {+ return a === b+ }+ return String(a) === String(b)+}++export function parseOverrideValue(value: unknown, original: unknown): unknown {+ if (typeof original === 'number') {+ const parsed = Number(value)+ return Number.isNaN(parsed) ? original : parsed+ }+ if (typeof original === 'boolean') {+ if (typeof value === 'string') {+ return value.toLowerCase() === 'true'+ }+ return Boolean(value)+ }+ if (typeof original === 'string') {+ return String(value)+ }+ return value+}diff --git a/packages/dev-tools/vitest.config.ts b/packages/dev-tools/vitest.config.tsnew file mode 100644index 00000000000..489cb49b282--- /dev/null+++ b/packages/dev-tools/vitest.config.ts@@ -0,0 +1,14 @@+import { defineConfig } from 'vitest/config'++export default defineConfig({+ test: {+ environment: 'jsdom',+ setupFiles: ['./vitest.setup.ts'],+ reporters: [['default']],+ coverage: {+ reporter: ['lcov'],+ exclude: ['**/*.test.ts', '**/*.test.tsx'],+ include: ['**/*.ts', '**/*.tsx'],+ },+ },+})diff --git a/packages/dev-tools/vitest.setup.ts b/packages/dev-tools/vitest.setup.tsnew file mode 100644index 00000000000..3d8e21849f6--- /dev/null+++ b/packages/dev-tools/vitest.setup.ts@@ -0,0 +1,25 @@+/// <reference types="@testing-library/jest-dom" />++import '@testing-library/jest-dom/vitest'+import { cleanup } from '@testing-library/react'+import { afterEach, vi } from 'vitest'++Object.defineProperty(window, 'matchMedia', {+ writable: true,+ value: vi.fn().mockImplementation((query) => ({+ matches: false,+ media: query,+ onchange: null,+ addListener: vi.fn(), // deprecated+ removeListener: vi.fn(), // deprecated+ addEventListener: vi.fn(),+ removeEventListener: vi.fn(),+ dispatchEvent: vi.fn(),+ })),+})++vi.mock('next/navigation', () => require('next-router-mock/navigation'))++afterEach(() => {+ cleanup()+})diff --git a/pnpm-lock.yaml b/pnpm-lock.yamlindex faa4dd2006c..73db6c42f31 100644--- a/pnpm-lock.yaml+++ b/pnpm-lock.yaml@@ -468,6 +468,9 @@ importers:config:specifier: workspace:*version: link:../../packages/config+ dev-tools:+ specifier: workspace:*+ version: link:../../packages/dev-toolseslint-config-supabase:specifier: workspace:*version: link:../../packages/eslint-config-supabase@@ -1238,6 +1241,9 @@ importers:dayjs:specifier: ^1.11.10version: 1.11.13+ dev-tools:+ specifier: workspace:*+ version: link:../../packages/dev-toolsdnd-core:specifier: ^16.0.1version: 16.0.1@@ -1960,6 +1966,9 @@ importers:dayjs:specifier: ^1.11.12version: 1.11.13+ dev-tools:+ specifier: workspace:*+ version: link:../../packages/dev-toolseslint-config-supabase:specifier: workspace:*version: link:../../packages/eslint-config-supabase@@ -2444,6 +2453,52 @@ importers:specifier: 'catalog:'version: 5.9.2+ packages/dev-tools:+ dependencies:+ common:+ specifier: workspace:*+ version: link:../common+ lucide-react:+ specifier: '*'+ version: 0.511.0([email protected])+ react:+ specifier: 'catalog:'+ version: 18.3.1+ react-dom:+ specifier: 'catalog:'+ version: 18.3.1([email protected])+ ui:+ specifier: workspace:*+ version: link:../ui+ devDependencies:+ '@testing-library/jest-dom':+ specifier: ^6.6.0+ version: 6.6.3+ '@testing-library/react':+ specifier: ^16.0.0+ version: 16.0.0(@testing-library/[email protected])(@types/[email protected])(@types/[email protected])([email protected]([email protected]))([email protected])+ '@testing-library/user-event':+ specifier: ^14.0.0+ version: 14.6.1(@testing-library/[email protected])+ '@types/react':+ specifier: 'catalog:'+ version: 18.3.3+ '@types/react-dom':+ specifier: 'catalog:'+ version: 18.3.0+ next-router-mock:+ specifier: ^0.9.13+ version: 0.9.13([email protected](@babel/[email protected]([email protected]))(@opentelemetry/[email protected])(@playwright/[email protected])([email protected]([email protected]))([email protected])([email protected]))([email protected])+ tsconfig:+ specifier: workspace:*+ version: link:../tsconfig+ typescript:+ specifier: 'catalog:'+ version: 5.9.2+ vitest:+ specifier: 'catalog:'+ version: 3.2.4(@types/[email protected])(@vitest/[email protected])([email protected])([email protected]([email protected]))([email protected](@types/[email protected])([email protected]))([email protected])([email protected])([email protected])([email protected])([email protected])+packages/eslint-config-supabase:devDependencies:'@eslint/eslintrc':@@ -28639,6 +28694,10 @@ snapshots:dependencies:'@testing-library/dom': 10.1.0+ '@testing-library/[email protected](@testing-library/[email protected])':+ dependencies:+ '@testing-library/dom': 10.4.0+'@tokenizer/[email protected]': {}'@tootallnate/[email protected]': {}