:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
import { type MetricChange } from '@posthog/quill-charts'
import { IntervalType } from '~/types'
// Above this magnitude the exact percentage is noise (it comes from a near-zero start), so show ∞ instead.
export const MAX_CHANGE_PERCENT = 10_000 // ≈100×
export type MetricSummary = 'total' | 'average' | 'latest'
export const METRIC_SUMMARY_DEFAULT: MetricSummary = 'total'
export const METRIC_SUMMARY_LABELS: Record<MetricSummary, string> = {
total: 'Total',
average: 'Avg',
latest: 'Latest',
}
export const METRIC_SHOW_CHANGE_DEFAULT = true
export const METRIC_COLOR_BY_DIRECTION_DEFAULT = false
export const METRIC_DEFAULT_INCREASE_COLOR = '#388600'
export const METRIC_DEFAULT_DECREASE_COLOR = '#db3707'
const finiteValues = (data: number[] | undefined): number[] => (data ?? []).filter((v) => Number.isFinite(v))
const mean = (values: number[]): number => values.reduce((sum, v) => sum + v, 0) / values.length
const meanOfFinite = (data: number[] | undefined): number | undefined => {
const finite = finiteValues(data)
return finite.length === 0 ? undefined : mean(finite)
}
// Percentage change from `start` to `end`. Renders ∞ when the start is zero (infinite) or the magnitude
// is so large the exact percentage is just noise. A missing endpoint yields `undefined` (no pill).
function changeBetween(start: number | undefined, end: number | undefined): MetricChange | null | undefined {
if (start == null || end == null) {
return undefined
}
if (start === 0) {
return end === 0 ? null : { value: end > 0 ? 1 : -1, label: '∞' }
}
const percent = ((end - start) / Math.abs(start)) * 100
return Math.abs(percent) >= MAX_CHANGE_PERCENT ? { value: percent, label: '∞' } : { value: percent }
}
export function computeMetricChange(data: number[] | undefined): MetricChange | null | undefined {
const finite = finiteValues(data)
return finite.length < 2 ? undefined : changeBetween(finite[0], finite[finite.length - 1])
}
// Falls back to the total when the series has no finite points.
export function computeMetricSummary(summary: MetricSummary, total: number, data: number[] | undefined): number {
if (summary === 'total') {
return total
}
const finite = finiteValues(data)
if (finite.length === 0) {
return total
}
return summary === 'latest' ? finite[finite.length - 1] : mean(finite)
}
export interface MetricLineColorOptions {
colorByDirection: boolean
change: MetricChange | null | undefined
increaseColor: string
decreaseColor: string
/** Color used when the line is not colored by direction. */
fallback?: string
}
export function resolveMetricLineColor({
colorByDirection,
change,
increaseColor,
decreaseColor,
fallback,
}: MetricLineColorOptions): string | undefined {
if (!colorByDirection || change == null) {
return fallback
}
return change.value >= 0 ? increaseColor : decreaseColor
}
export interface MetricSeriesSummary {
total: number
data: number[] | undefined
}
interface ComparableSeries {
count: number
data: number[]
compare_label?: string | null
}
// Matched by `compare_label`, not array position (the backend doesn't guarantee order).
export function selectPreviousSeriesSummary(
results: readonly ComparableSeries[] | undefined
): MetricSeriesSummary | undefined {
const previous = results?.find((series) => series.compare_label === 'previous')
return previous ? { total: previous.count, data: previous.data } : undefined
}
export function selectCurrentSeries<T extends { compare_label?: string | null }>(
results: readonly T[] | undefined
): T | undefined {
return results?.find((series) => series.compare_label !== 'previous') ?? results?.[0]
}
export function computeMetricSummaryChange(
summary: MetricSummary,
current: MetricSeriesSummary,
previous: MetricSeriesSummary | undefined
): MetricChange | null | undefined {
if (previous && summary !== 'latest') {
return summary === 'total'
? changeBetween(previous.total, current.total)
: changeBetween(meanOfFinite(previous.data), meanOfFinite(current.data))
}
return computeMetricChange(current.data)
}
// Keep in sync with computeMetricSummaryChange — same total/average-vs-previous vs first→last split.
export function getMetricChangeTooltip(
summary: MetricSummary,
hasComparison: boolean,
interval: IntervalType | null | undefined
): string {
if (!hasComparison || summary === 'latest') {
const noun = interval ?? 'day'
return `Comparing the first ${noun}'s value to the most recent ${noun}'s value.`
}
return summary === 'total'
? "Comparing this period's total to the previous period's total."
: "Comparing this period's average to the previous period's average."
}