📈 Open source, privacy-first web analytics — a cookie-less Google Analytics alternative with built-in error tracking and performance monitoring. Self-host it or use our cloud. Get started for free!
TypeScript chartsclickhousedockergdprgoogle-analyticsmetricsmonitoringmysqlnestjsprivacyredisself-hostedselfhostedstatisticstailwindcssweb-analyticswebanalyticswebsite
import {
type ActionFunctionArgs,
type LoaderFunctionArgs,
data,
} from 'react-router'
import {
getSessionReplaysServer,
getSessionReplayServer,
deleteSessionReplayServer,
getGoalSessionsServer,
getFeatureFlagStatsServer,
getFeatureFlagProfilesServer,
getGoalStatsServer,
getGoalChartServer,
getExperimentResultsServer,
getExperimentServer,
getGoalServer,
getProjectGoalsServer,
getProjectFeatureFlagsServer,
getProjectServer,
getFiltersServer,
getDataDeletionPreviewServer,
getLiveVisitorsServer,
getBotProtectionStatsServer,
getJourneysServer,
getJourneySessionsServer,
getGSCKeywordsServer,
getRevenueStatusServer,
getRevenueDataServer,
getOverallStatsServer,
type AnalyticsParams,
type SessionReplaysResponse,
type SessionReplayResponse,
type DeleteSessionReplayResponse,
type GoalSessionsResponse,
type FeatureFlagStats,
type FeatureFlagProfilesResponse,
type GoalStats,
type GoalChartData,
type ExperimentResults,
type Experiment,
type Goal,
type GoalsResponse,
type FeatureFlagsResponse,
type Project,
type LiveStats,
type BotProtectionStats,
type BotProtectionPeriod,
type JourneysResponse,
type JourneySessionsResponse,
type GSCKeywordsResponse,
type RevenueStatus,
type RevenueDataResponse,
type OverallObject,
type DataDeletionPreview,
} from '~/api/api.server'
import type { V2Filter } from '~/api/v2/types'
import { getProjectPasswordCookie } from '~/utils/session.server'
function formatDateForBackend(dateStr: string | undefined): string | undefined {
if (!dateStr) return undefined
if (/^\d{4}-\d{2}-\d{2}$/.test(dateStr)) {
return dateStr
}
const date = new Date(dateStr)
if (!Number.isNaN(date.getTime())) {
return date.toISOString()
}
return undefined
}
interface ProxyRequest {
action:
| 'getSessionReplays'
| 'getSessionReplay'
| 'deleteSessionReplay'
| 'getFeatureFlagStats'
| 'getFeatureFlagProfiles'
| 'getGoalStats'
| 'getGoalChart'
| 'getExperimentResults'
| 'getExperiment'
| 'getGoal'
| 'getProjectGoals'
| 'getProjectFeatureFlags'
| 'getProject'
| 'getFilters'
| 'getDataDeletionPreview'
| 'getLiveVisitors'
| 'getBotProtectionStats'
| 'getJourneys'
| 'getJourneySessions'
| 'getGSCKeywords'
| 'getRevenueStatus'
| 'getRevenueData'
| 'getOverallStats'
| 'getGoalSessions'
projectId: string
pids?: string[]
flagId?: string
goalId?: string
experimentId?: string
psid?: string
replayId?: string
filterType?: string
params: {
timeBucket?: string
period?: string
from?: string
to?: string
timezone?: string
filters?: V2Filter[]
take?: number
skip?: number
resultFilter?: string
search?: string
page?: string
query?: string
step?: number
steps?: number
journeys?: number
goalId?: string
sessionEvent?: 'traffic' | 'performance' | 'error'
}
}
interface ProxyResponse<T> {
data: T | null
error: string | null
}
export async function action({ request }: ActionFunctionArgs) {
const body = (await request.json()) as ProxyRequest
const { action, projectId, pids, params } = body
// Prefer the header: cookies are not sent in cross-site iframe embeds
const password =
request.headers.get('x-password') ||
getProjectPasswordCookie(request, projectId)
const analyticsParams: AnalyticsParams & {
take?: number
skip?: number
options?: Record<string, unknown>
sessionEvent?: 'traffic' | 'performance' | 'error'
} = {
timeBucket: params.timeBucket || 'day',
period: params.period || '7d',
from: formatDateForBackend(params.from),
to: formatDateForBackend(params.to),
timezone: params.timezone || 'UTC',
filters: params.filters || [],
password: password || undefined,
take: params.take,
skip: params.skip,
sessionEvent: params.sessionEvent,
}
try {
switch (action) {
case 'getSessionReplays': {
const result = await getSessionReplaysServer(
request,
projectId,
analyticsParams,
)
return data<ProxyResponse<SessionReplaysResponse>>({
data: result.data,
error: result.error
? Array.isArray(result.error)
? result.error.join(', ')
: result.error
: null,
})
}
case 'getSessionReplay': {
if (!body.psid) {
return data<ProxyResponse<SessionReplayResponse>>(
{ data: null, error: 'psid is required' },
{ status: 400 },
)
}
const result = await getSessionReplayServer(
request,
projectId,
body.psid,
body.replayId,
password || undefined,
)
return data<ProxyResponse<SessionReplayResponse>>({
data: result.data,
error: result.error
? Array.isArray(result.error)
? result.error.join(', ')
: result.error
: null,
})
}
case 'deleteSessionReplay': {
if (!body.psid) {
return data<ProxyResponse<DeleteSessionReplayResponse>>(
{ data: null, error: 'psid is required' },
{ status: 400 },
)
}
const result = await deleteSessionReplayServer(
request,
projectId,
body.psid,
body.replayId,
password || undefined,
)
if (result.error) {
return data<ProxyResponse<DeleteSessionReplayResponse>>(
{
data: null,
error: Array.isArray(result.error)
? result.error.join(', ')
: result.error,
},
{ status: 400 },
)
}
return data<ProxyResponse<DeleteSessionReplayResponse>>({
data: result.data,
error: null,
})
}
case 'getGoalSessions': {
const goalId = body.goalId || params.goalId
if (!goalId) {
return data<ProxyResponse<GoalSessionsResponse>>(
{ data: null, error: 'goalId is required' },
{ status: 400 },
)
}
const result = await getGoalSessionsServer(request, goalId, {
period: analyticsParams.period,
from: analyticsParams.from,
to: analyticsParams.to,
timezone: analyticsParams.timezone,
take: params.take,
skip: params.skip,
})
return data<ProxyResponse<GoalSessionsResponse>>({
data: result.data,
error: result.error
? Array.isArray(result.error)
? result.error.join(', ')
: result.error
: null,
})
}
case 'getFeatureFlagStats': {
if (!body.flagId) {
return data<ProxyResponse<null>>(
{ data: null, error: 'flagId is required' },
{ status: 400 },
)
}
const result = await getFeatureFlagStatsServer(
request,
body.flagId,
params.period || '7d',
formatDateForBackend(params.from) || '',
formatDateForBackend(params.to) || '',
params.timezone,
)
return data<ProxyResponse<FeatureFlagStats>>({
data: result.data,
error: result.error
? Array.isArray(result.error)
? result.error.join(', ')
: result.error
: null,
})
}
case 'getFeatureFlagProfiles': {
if (!body.flagId) {
return data<ProxyResponse<null>>(
{ data: null, error: 'flagId is required' },
{ status: 400 },
)
}
const result = await getFeatureFlagProfilesServer(
request,
body.flagId,
params.period || '7d',
formatDateForBackend(params.from) || '',
formatDateForBackend(params.to) || '',
params.timezone,
params.take || 15,
params.skip || 0,
params.resultFilter,
)
return data<ProxyResponse<FeatureFlagProfilesResponse>>({
data: result.data,
error: result.error
? Array.isArray(result.error)
? result.error.join(', ')
: result.error
: null,
})
}
case 'getGoalStats': {
if (!body.goalId) {
return data<ProxyResponse<null>>(
{ data: null, error: 'goalId is required' },
{ status: 400 },
)
}
const result = await getGoalStatsServer(
request,
body.goalId,
params.period || '7d',
formatDateForBackend(params.from) || '',
formatDateForBackend(params.to) || '',
params.timezone,
params.filters || [],
)
return data<ProxyResponse<GoalStats>>({
data: result.data,
error: result.error
? Array.isArray(result.error)
? result.error.join(', ')
: result.error
: null,
})
}
case 'getGoalChart': {
if (!body.goalId) {
return data<ProxyResponse<null>>(
{ data: null, error: 'goalId is required' },
{ status: 400 },
)
}
const result = await getGoalChartServer(
request,
body.goalId,
params.period || '7d',
formatDateForBackend(params.from) || '',
formatDateForBackend(params.to) || '',
params.timeBucket || 'day',
params.timezone,
params.filters || [],
)
return data<ProxyResponse<{ chart: GoalChartData }>>({
data: result.data,
error: result.error
? Array.isArray(result.error)
? result.error.join(', ')
: result.error
: null,
})
}
case 'getExperimentResults': {
if (!body.experimentId) {
return data<ProxyResponse<null>>(
{ data: null, error: 'experimentId is required' },
{ status: 400 },
)
}
const result = await getExperimentResultsServer(
request,
body.experimentId,
params.period || '7d',
params.timeBucket || 'day',
formatDateForBackend(params.from) || '',
formatDateForBackend(params.to) || '',
params.timezone,
params.filters || [],
password || undefined,
)
return data<ProxyResponse<ExperimentResults>>({
data: result.data,
error: result.error
? Array.isArray(result.error)
? result.error.join(', ')
: result.error
: null,
})
}
case 'getExperiment': {
if (!body.experimentId) {
return data<ProxyResponse<null>>(
{ data: null, error: 'experimentId is required' },
{ status: 400 },
)
}
const result = await getExperimentServer(
request,
body.experimentId,
password || undefined,
)
return data<ProxyResponse<Experiment>>({
data: result.data,
error: result.error
? Array.isArray(result.error)
? result.error.join(', ')
: result.error
: null,
})
}
case 'getGoal': {
if (!body.goalId) {
return data<ProxyResponse<null>>(
{ data: null, error: 'goalId is required' },
{ status: 400 },
)
}
const result = await getGoalServer(
request,
body.goalId,
password || undefined,
)
return data<ProxyResponse<Goal>>({
data: result.data,
error: result.error
? Array.isArray(result.error)
? result.error.join(', ')
: result.error
: null,
})
}
case 'getProjectGoals': {
const result = await getProjectGoalsServer(
request,
projectId,
params.take || 100,
params.skip || 0,
params.search,
)
return data<ProxyResponse<GoalsResponse>>({
data: result.data,
error: result.error
? Array.isArray(result.error)
? result.error.join(', ')
: result.error
: null,
})
}
case 'getProjectFeatureFlags': {
const result = await getProjectFeatureFlagsServer(
request,
projectId,
params.take || 100,
params.skip || 0,
params.search,
)
return data<ProxyResponse<FeatureFlagsResponse>>({
data: result.data,
error: result.error
? Array.isArray(result.error)
? result.error.join(', ')
: result.error
: null,
})
}
case 'getProject': {
const result = await getProjectServer(
request,
projectId,
password || undefined,
)
return data<ProxyResponse<Project>>({
data: result.data,
error: result.error
? Array.isArray(result.error)
? result.error.join(', ')
: result.error
: null,
})
}
case 'getFilters': {
if (!body.filterType) {
return data<ProxyResponse<null>>(
{ data: null, error: 'filterType is required' },
{ status: 400 },
)
}
const result = await getFiltersServer(
request,
projectId,
body.filterType,
password || undefined,
)
return data<ProxyResponse<string[]>>({
data: result.data,
error: result.error
? Array.isArray(result.error)
? result.error.join(', ')
: result.error
: null,
})
}
case 'getDataDeletionPreview': {
const result = await getDataDeletionPreviewServer(request, projectId, {
filters: params.filters || [],
from: formatDateForBackend(params.from),
to: formatDateForBackend(params.to),
})
return data<ProxyResponse<DataDeletionPreview>>({
data: result.data,
error: result.error
? Array.isArray(result.error)
? result.error.join(', ')
: result.error
: null,
})
}
case 'getLiveVisitors': {
const pids = body.pids || [projectId]
const result = await getLiveVisitorsServer(
request,
pids,
password || undefined,
)
return data<ProxyResponse<LiveStats>>({
data: result.data,
error: result.error
? Array.isArray(result.error)
? result.error.join(', ')
: result.error
: null,
})
}
case 'getBotProtectionStats': {
const period = (params.period as BotProtectionPeriod) || '30d'
const validPeriods: BotProtectionPeriod[] = ['7d', '30d', '90d']
const safePeriod = validPeriods.includes(period) ? period : '30d'
const result = await getBotProtectionStatsServer(
request,
projectId,
safePeriod,
password || undefined,
)
return data<ProxyResponse<BotProtectionStats>>({
data: result.data,
error: result.error
? Array.isArray(result.error)
? result.error.join(', ')
: result.error
: null,
})
}
case 'getJourneys': {
const result = await getJourneysServer(request, projectId, {
period: params.period,
filters: params.filters,
from: formatDateForBackend(params.from),
to: formatDateForBackend(params.to),
timezone: params.timezone,
steps: params.steps,
journeys: params.journeys,
password: password || undefined,
})
return data<ProxyResponse<JourneysResponse>>({
data: result.data,
error: result.error
? Array.isArray(result.error)
? result.error.join(', ')
: result.error
: null,
})
}
case 'getJourneySessions': {
const result = await getJourneySessionsServer(request, projectId, {
period: analyticsParams.period,
from: analyticsParams.from,
to: analyticsParams.to,
timezone: analyticsParams.timezone,
step: params.step ?? 1,
page: params.page ?? '',
take: params.take,
skip: params.skip,
password: analyticsParams.password,
filters: params.filters || [],
})
return data<ProxyResponse<JourneySessionsResponse>>({
data: result.data,
error: result.error
? Array.isArray(result.error)
? result.error.join(', ')
: result.error
: null,
})
}
case 'getGSCKeywords': {
const result = await getGSCKeywordsServer(request, projectId, {
period: params.period,
from: formatDateForBackend(params.from),
to: formatDateForBackend(params.to),
timezone: params.timezone,
password: password || undefined,
})
return data<ProxyResponse<GSCKeywordsResponse>>({
data: result.data,
error: result.error
? Array.isArray(result.error)
? result.error.join(', ')
: result.error
: null,
})
}
case 'getRevenueStatus': {
const result = await getRevenueStatusServer(request, projectId)
return data<ProxyResponse<RevenueStatus>>({
data: result.data,
error: result.error
? Array.isArray(result.error)
? result.error.join(', ')
: result.error
: null,
})
}
case 'getRevenueData': {
const result = await getRevenueDataServer(request, projectId, {
period: params.period || '7d',
from: formatDateForBackend(params.from),
to: formatDateForBackend(params.to),
timezone: params.timezone,
timeBucket: params.timeBucket,
})
return data<ProxyResponse<RevenueDataResponse>>({
data: result.data,
error: result.error
? Array.isArray(result.error)
? result.error.join(', ')
: result.error
: null,
})
}
case 'getOverallStats': {
if (!pids || pids.length === 0) {
return data<ProxyResponse<null>>(
{ data: null, error: 'pids is required' },
{ status: 400 },
)
}
const result = await getOverallStatsServer(request, pids, {
timeBucket: params.timeBucket || 'day',
period: params.period || '7d',
from: formatDateForBackend(params.from),
to: formatDateForBackend(params.to),
timezone: params.timezone || 'UTC',
filters: params.filters || [],
includeChart: true,
})
return data<ProxyResponse<Record<string, OverallObject>>>({
data: result.data,
error: result.error
? Array.isArray(result.error)
? result.error.join(', ')
: result.error
: null,
})
}
default:
return data<ProxyResponse<null>>(
{ data: null, error: `Unknown action: ${action}` },
{ status: 400 },
)
}
} catch (error) {
console.error('[api.analytics] Proxy request failed:', error)
return data<ProxyResponse<null>>(
{
data: null,
error: error instanceof Error ? error.message : 'Unknown error',
},
{ status: 500 },
)
}
}
export async function loader({ request: _request }: LoaderFunctionArgs) {
return data({ error: 'Use POST method' }, { status: 405 })
}