List Help Categories

curl https://api.bio.re/api/v1/public/help/categories
curl 'https://api.bio.re/api/v1/public/help/categories?locale=tr'

type PublicHelpCategory = {
  id: string;
  slug: string;
  name: string;
  description: string | null;
  icon: string | null;
  iconBackground: string | null;
  sortOrder: number;
  articleCount: number;
};

async function listHelpCategories(locale?: string): Promise<PublicHelpCategory[]> {
  const url = new URL('https://api.bio.re/api/v1/public/help/categories');
  if (locale) url.searchParams.set('locale', locale);
  const res = await fetch(url);
  const json = await res.json();
  if (!res.ok || !json.success) {
    throw Object.assign(new Error(json?.error?.message ?? 'Help categories fetch failed'), {
      code: json?.error?.code,
    });
  }
  return json.data;
}

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

export const contentKeys = {
  helpCategories: (locale?: string) =>
    ['content', 'help', 'categories', locale ?? 'all'] as const,
};

export function useHelpCategories(locale?: string) {
  return useQuery({
    queryKey: contentKeys.helpCategories(locale),
    queryFn: async () => {
      const url = new URL('/api/v1/public/help/categories', window.location.origin);
      if (locale) url.searchParams.set('locale', locale);
      const res = await fetch(url);
      const json = await res.json();
      if (!res.ok || !json.success) {
        throw Object.assign(new Error(json?.error?.message ?? 'Help categories fetch failed'), {
          code: json?.error?.code,
          i18nKey: json?.error?.i18nKey,
        });
      }
      return json.data as PublicHelpCategory[];
    },
    staleTime: 5 * 60_000,
  });
}