Download Export

curl https://api.bio.re/api/v1/gdpr/export/a1b2c3d4-e5f6-7890-abcd-ef1234567890/download \
  -H "Authorization: Bearer $ACCESS_TOKEN"

type GdprExportDownload = {
  downloadUrl: string;
  expiresAt: string;
};

async function getExportDownload(accessToken: string, id: string): Promise<GdprExportDownload> {
  const res = await fetch(`https://api.bio.re/api/v1/gdpr/export/${id}/download`, {
    headers: { Authorization: `Bearer ${accessToken}` },
  });
  const json = await res.json();
  if (!res.ok || !json.success) {
    throw Object.assign(new Error(json?.error?.message ?? 'Download URL fetch failed'), {
      code: json?.error?.code,
    });
  }
  return json.data;
}

// Trigger the download immediately so the URL doesn't linger in memory
function triggerDownload(downloadUrl: string) {
  const a = document.createElement('a');
  a.href = downloadUrl;
  a.download = '';
  document.body.appendChild(a);
  a.click();
  a.remove();
}

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

export function useGetExportDownload() {
  // Mutation — not a query — because it produces a side-effect (triggers download)
  // and we never want to cache the signed URL.
  return useMutation({
    mutationFn: async (id: string) => {
      const res = await fetch(`/api/v1/gdpr/export/${id}/download`);
      const json = await res.json();
      if (!res.ok || !json.success) {
        throw Object.assign(new Error(json?.error?.message ?? 'Download URL fetch failed'), {
          code: json?.error?.code,
          i18nKey: json?.error?.i18nKey,
        });
      }
      return json.data as GdprExportDownload;
    },
  });
}