feat(journeys): add frontend API client and SWR hooks

2026-03-12 21:24:39 +01:00
parent 6964be9610
commit 7336f9126e
2 changed files with 146 additions and 0 deletions
--- a/lib/api/journeys.ts
+++ b/lib/api/journeys.ts
@@ -0,0 +1,93 @@
+import apiRequest from './client'
+
+// ─── Types ──────────────────────────────────────────────────────────
+
+export interface PathTransition {
+  from_path: string
+  to_path: string
+  step_index: number
+  session_count: number
+}
+
+export interface TransitionsResponse {
+  transitions: PathTransition[]
+  total_sessions: number
+}
+
+export interface TopPath {
+  page_sequence: string[]
+  session_count: number
+  avg_duration: number
+}
+
+export interface EntryPoint {
+  path: string
+  session_count: number
+}
+
+// ─── Helpers ────────────────────────────────────────────────────────
+
+function buildQuery(opts: {
+  startDate?: string
+  endDate?: string
+  depth?: number
+  limit?: number
+  min_sessions?: number
+  entry_path?: string
+}): string {
+  const params = new URLSearchParams()
+  if (opts.startDate) params.append('start_date', opts.startDate)
+  if (opts.endDate) params.append('end_date', opts.endDate)
+  if (opts.depth != null) params.append('depth', opts.depth.toString())
+  if (opts.limit != null) params.append('limit', opts.limit.toString())
+  if (opts.min_sessions != null) params.append('min_sessions', opts.min_sessions.toString())
+  if (opts.entry_path) params.append('entry_path', opts.entry_path)
+  const query = params.toString()
+  return query ? `?${query}` : ''
+}
+
+// ─── API Functions ──────────────────────────────────────────────────
+
+export function getJourneyTransitions(
+  siteId: string,
+  startDate?: string,
+  endDate?: string,
+  opts?: { depth?: number; minSessions?: number; entryPath?: string }
+): Promise<TransitionsResponse> {
+  return apiRequest<TransitionsResponse>(
+    `/sites/${siteId}/journeys/transitions${buildQuery({
+      startDate,
+      endDate,
+      depth: opts?.depth,
+      min_sessions: opts?.minSessions,
+      entry_path: opts?.entryPath,
+    })}`
+  ).then(r => r ?? { transitions: [], total_sessions: 0 })
+}
+
+export function getJourneyTopPaths(
+  siteId: string,
+  startDate?: string,
+  endDate?: string,
+  opts?: { limit?: number; minSessions?: number; entryPath?: string }
+): Promise<TopPath[]> {
+  return apiRequest<{ paths: TopPath[] }>(
+    `/sites/${siteId}/journeys/top-paths${buildQuery({
+      startDate,
+      endDate,
+      limit: opts?.limit,
+      min_sessions: opts?.minSessions,
+      entry_path: opts?.entryPath,
+    })}`
+  ).then(r => r?.paths ?? [])
+}
+
+export function getJourneyEntryPoints(
+  siteId: string,
+  startDate?: string,
+  endDate?: string
+): Promise<EntryPoint[]> {
+  return apiRequest<{ entry_points: EntryPoint[] }>(
+    `/sites/${siteId}/journeys/entry-points${buildQuery({ startDate, endDate })}`
+  ).then(r => r?.entry_points ?? [])
+}