Record Page View

curl -X POST https://api.bio.re/api/v1/analytics/pageview \
  -H 'Content-Type: application/json' \
  -d '{
    "sessionId": "ses-uuid-from-create",
    "url": "https://bio.re/alice",
    "path": "/alice",
    "title": "Alice on bio.re",
    "bioPageId": "11111111-2222-3333-4444-555555555555"
  }'

type RecordPageViewInput = {
  sessionId: string;
  url: string;
  path: string;
  title?: string;
  bioPageId?: string;
  linkClicked?: string;
};

type PageViewResult = { id: string | null; enteredAt?: string };

async function recordPageView(input: RecordPageViewInput): Promise<PageViewResult> {
  const res = await fetch('https://api.bio.re/api/v1/analytics/pageview', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(input),
  });
  const json = await res.json();
  return json.data;
}

// React Router / Next.js example — fire one pageview per route change.
let lastPageViewId: string | null = null;

useEffect(() => {
  if (!sessionId) return;

  // Fire-and-forget; capture id so pageLeave can finalize duration when leaving.
  recordPageView({
    sessionId,
    url: location.href,
    path: location.pathname,
    title: document.title,
  }).then(({ id }) => { lastPageViewId = id; });
}, [pathname]);

// On unmount / before route change, send the leave event for accurate last-view duration:
useEffect(() => {
  return () => {
    if (lastPageViewId) {
      const duration = Math.floor((Date.now() - mountedAt.current) / 1000);
      pageLeave(lastPageViewId, { duration, scrollDepth: getScrollPercent() });
    }
  };
}, []);