/**
 * useKeyStats Hook
 *
 * TanStack Query hook for fetching integration key statistics for a tenant.
 *
 * Features:
 * - Automatic caching with 1-minute stale time (stats update frequently)
 * - Background refetching
 * - Request deduplication
 *
 * @layer Presentation - TanStack Query Hook
 */

import { useQuery } from '@tanstack/react-query';
import { queryKeys } from '@/lib/query-keys';
import { integrationKeysApi } from '@/infrastructure/http/api/integration-keys/api';

interface KeyStats {
  total: number;
  active: number;
  revoked: number;
  expired: number;
}

interface UseKeyStatsOptions {
  enabled?: boolean;
}

/**
 * Fetches integration key statistics for a tenant
 *
 * @param tenantId - Tenant ID to get statistics for
 * @param options - Query options (enabled, etc.)
 * @returns TanStack Query result with statistics
 *
 * @example
 * ```typescript
 * const { data: stats, isLoading, error } = useKeyStats('tenant-123');
 *
 * if (isLoading) return <Spinner />;
 * if (error) return <Error message={error.message} />;
 * if (!stats) return null;
 *
 * return (
 *   <div>
 *     <StatCard label="Total Keys" value={stats.total} />
 *     <StatCard label="Active" value={stats.active} />
 *     <StatCard label="Revoked" value={stats.revoked} />
 *     <StatCard label="Expired" value={stats.expired} />
 *   </div>
 * );
 * ```
 */
export function useKeyStats(tenantId: string | undefined, options?: UseKeyStatsOptions) {
  return useQuery<KeyStats, Error>({
    queryKey: queryKeys.integrationKeys.stats(tenantId || ''),
    queryFn: async () => {
      if (!tenantId) {
        throw new Error('Tenant ID is required');
      }

      return await integrationKeysApi.getStats(tenantId);
    },
    enabled: options?.enabled !== false && !!tenantId,
    staleTime: 1 * 60 * 1000, // 1 minute (stats update frequently)
  });
}