// src/hooks/queries/useActivityLogQuery.ts import { useQuery } from '@tanstack/react-query'; import { fetchActivityLog } from '../../services/apiClient'; import { queryKeys } from '../../config/queryKeys'; import type { ActivityLogItem } from '../../types'; /** * Query hook for fetching the admin activity log. * * The activity log contains a record of all administrative actions * performed in the system. This data changes frequently as new * actions are logged, so it has a shorter stale time. * * @param limit - Maximum number of entries to fetch (default: 20) * @param offset - Number of entries to skip for pagination (default: 0) * @returns Query result with activity log entries * * @example * ```tsx * const { data: activityLog, isLoading, error } = useActivityLogQuery(20, 0); * ``` */ export const useActivityLogQuery = (limit: number = 20, offset: number = 0) => { return useQuery({ queryKey: queryKeys.activityLog(limit, offset), queryFn: async (): Promise => { const response = await fetchActivityLog(limit, offset); if (!response.ok) { const error = await response.json().catch(() => ({ message: `Request failed with status ${response.status}`, })); throw new Error(error.message || 'Failed to fetch activity log'); } const json = await response.json(); // ADR-028: API returns { success: true, data: [...] } // If success is false or data is not an array, return empty array to prevent .map() errors if (!json.success || !Array.isArray(json.data)) { return []; } return json.data; }, // Activity log changes frequently, keep stale time short staleTime: 1000 * 30, // 30 seconds }); };