List Locales

curl https://api.bio.re/api/v1/locales

type Locale = {
  code: string;
  name: string;
  nativeName: string;
  isRtl: boolean;
  isDefault: boolean;
};

type LocaleListResponse = {
  locales: Locale[];
  versions: Record<string, number>;
};

async function listLocales(): Promise<LocaleListResponse> {
  const res = await fetch('https://api.bio.re/api/v1/locales');
  const json = await res.json();
  if (!res.ok || !json.success) {
    throw Object.assign(new Error(json?.error?.message ?? 'Locales fetch failed'), {
      code: json?.error?.code,
    });
  }
  return json.data;
}

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

export const i18nKeys = {
  locales: () => ['i18n', 'locales'] as const,
  bundle: (locale: string, version: number) =>
    ['i18n', 'bundle', locale, version] as const,
};

// Refresh the locale list every 5 min — matches the L2 Redis TTL.
// When `versions[locale]` changes, downstream useBundle queries with the
// same locale but a new version will be fresh cache misses (different key).
export function useLocales() {
  return useQuery({
    queryKey: i18nKeys.locales(),
    queryFn: async () => {
      const res = await fetch('/api/v1/locales');
      const json = await res.json();
      if (!res.ok || !json.success) {
        throw Object.assign(new Error(json?.error?.message ?? 'Locales fetch failed'), {
          code: json?.error?.code,
        });
      }
      return json.data as LocaleListResponse;
    },
    staleTime: 5 * 60_000,
  });
}