Get Wallet Activity

curl 'https://api.bio.re/api/v1/wallet/activity?page=1&limit=20&type=CREDIT' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

type WalletTransactionType = 'CREDIT' | 'DEBIT' | 'EXPIRY' | 'CHARGEBACK';

type WalletActivityItem = {
  id: string;
  walletId: string;
  type: WalletTransactionType | 'PAYOUT';
  amount: string;
  balanceBefore: string;
  balanceAfter: string;
  referenceType: string;
  referenceId: string;
  description: string;
  createdAt: string;
};

type WalletActivity = {
  items: WalletActivityItem[];
  total: number;
  page: number;
  limit: number;
  totalPages: number;
};

async function getWalletActivity(
  accessToken: string,
  filter: { type?: WalletTransactionType; page?: number; limit?: number } = {},
): Promise<WalletActivity> {
  const url = new URL('https://api.bio.re/api/v1/wallet/activity');
  if (filter.type) url.searchParams.set('type', filter.type);
  if (filter.page) url.searchParams.set('page', String(filter.page));
  if (filter.limit) url.searchParams.set('limit', String(filter.limit));
  const res = await fetch(url, {
    headers: { Authorization: `Bearer ${accessToken}` },
  });
  const json = await res.json();
  if (!res.ok || !json.success) {
    throw Object.assign(new Error(json?.error?.message ?? 'Wallet activity fetch failed'), {
      code: json?.error?.code,
    });
  }
  return json.data;
}

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

export const walletKeys = {
  activity: (filter: { type?: string; page?: number; limit?: number }) =>
    ['wallet', 'activity', filter] as const,
};

export function useWalletActivity(filter: {
  type?: WalletTransactionType;
  page?: number;
  limit?: number;
} = {}) {
  return useQuery({
    queryKey: walletKeys.activity(filter),
    queryFn: async () => {
      const url = new URL('/api/v1/wallet/activity', window.location.origin);
      if (filter.type) url.searchParams.set('type', filter.type);
      if (filter.page) url.searchParams.set('page', String(filter.page));
      if (filter.limit) url.searchParams.set('limit', String(filter.limit));
      const res = await fetch(url);
      const json = await res.json();
      if (!res.ok || !json.success) {
        throw Object.assign(new Error(json?.error?.message ?? 'Wallet activity fetch failed'), {
          code: json?.error?.code,
          i18nKey: json?.error?.i18nKey,
        });
      }
      return json.data as WalletActivity;
    },
    placeholderData: keepPreviousData, // smooth pagination UX
    staleTime: 30_000,
  });
}