feat(frontend): add useLibrarySearch, useLibrarySyncStatus, useTriggerSync, useAdminSettings hooks

k-tv-frontend/hooks/use-admin-settings.ts

@@ -0,0 +1,28 @@
+"use client";
+
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { api } from "@/lib/api";
+import { useAuthContext } from "@/context/auth-context";
+import type { AdminSettings } from "@/lib/types";
+
+export function useAdminSettings() {
+  const { token } = useAuthContext();
+  return useQuery({
+    queryKey: ["admin", "settings"],
+    queryFn: () => api.admin.getSettings(token!),
+    enabled: !!token,
+    staleTime: 5 * 60 * 1000,
+  });
+}
+
+export function useUpdateAdminSettings() {
+  const { token } = useAuthContext();
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: (patch: Partial<AdminSettings>) =>
+      api.admin.updateSettings(token!, patch),
+    onSuccess: (data: AdminSettings) => {
+      queryClient.setQueryData(["admin", "settings"], data);
+    },
+  });
+}

k-tv-frontend/hooks/use-library-search.ts

@@ -0,0 +1,34 @@
+"use client";
+
+import { useQuery } from "@tanstack/react-query";
+import { api } from "@/lib/api";
+import { useAuthContext } from "@/context/auth-context";
+
+export interface LibrarySearchParams {
+  q?: string;
+  type?: string;
+  series?: string[];
+  collection?: string;
+  provider?: string;
+  decade?: number;
+  min_duration?: number;
+  max_duration?: number;
+  genres?: string[];
+  offset?: number;
+  limit?: number;
+}
+
+/**
+ * Paginated library search — always enabled, DB-backed (fast).
+ * Separate from useLibraryItems in use-library.ts which is snapshot-based
+ * and used only for block editor filter preview.
+ */
+export function useLibrarySearch(params: LibrarySearchParams) {
+  const { token } = useAuthContext();
+  return useQuery({
+    queryKey: ["library", "search", params],
+    queryFn: () => api.library.itemsPage(token!, params),
+    enabled: !!token,
+    staleTime: 2 * 60 * 1000,
+  });
+}

k-tv-frontend/hooks/use-library-sync.ts

@@ -0,0 +1,28 @@
+"use client";
+
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { api } from "@/lib/api";
+import { useAuthContext } from "@/context/auth-context";
+
+export function useLibrarySyncStatus() {
+  const { token } = useAuthContext();
+  return useQuery({
+    queryKey: ["library", "sync"],
+    queryFn: () => api.library.syncStatus(token!),
+    enabled: !!token,
+    staleTime: 30 * 1000,
+    refetchInterval: 10 * 1000,
+  });
+}
+
+export function useTriggerSync() {
+  const { token } = useAuthContext();
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: () => api.library.triggerSync(token!),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ["library", "search"] });
+      queryClient.invalidateQueries({ queryKey: ["library", "sync"] });
+    },
+  });
+}