Track Event

curl -X POST https://api.bio.re/api/v1/analytics/track \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "event": "bio_link_click",
    "sessionId": "session-uuid-from-create",
    "properties": { "linkId": "abc-123", "position": 2 }
  }'

type TrackInput = {
  event: string;
  sessionId?: string;
  properties?: Record<string, unknown>;
};

async function track(accessToken: string, input: TrackInput): Promise<void> {
  const res = await fetch('https://api.bio.re/api/v1/analytics/track', {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${accessToken}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify(input),
  });
  if (!res.ok) {
    const json = await res.json().catch(() => null);
    throw Object.assign(new Error(json?.error?.message ?? 'Track failed'), {
      code: json?.error?.code,
    });
  }
  // Don't await success — fire-and-forget at the call site if you don't care.
}

import { useMutation } from '@tanstack/react-query';

export function useTrackEvent() {
  return useMutation({
    mutationFn: async (input: TrackInput) => {
      const res = await fetch('/api/v1/analytics/track', {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify(input),
      });
      if (!res.ok) {
        // Don't surface to the user — instrumentation failures shouldn't be UX errors.
        return;
      }
    },
    // Don't retry — duplicates are worse than missing one event.
    retry: false,
  });
}