feat: PocketVeto v1.0.0 — initial public release

Self-hosted US Congress monitoring platform with AI policy briefs,
bill/member/topic follows, ntfy + RSS + email notifications,
alignment scoring, collections, and draft-letter generator.

Authored by: Jack Levy

frontend/lib/hooks/useBills.ts

@@ -0,0 +1,46 @@
+import { useQuery } from "@tanstack/react-query";
+import { billsAPI } from "../api";
+
+export function useBills(params?: Record<string, unknown>) {
+  return useQuery({
+    queryKey: ["bills", params],
+    queryFn: () => billsAPI.list(params),
+    staleTime: 5 * 60 * 1000,
+  });
+}
+
+export function useBill(id: string) {
+  return useQuery({
+    queryKey: ["bill", id],
+    queryFn: () => billsAPI.get(id),
+    staleTime: 2 * 60 * 1000,
+    enabled: !!id,
+  });
+}
+
+export function useBillActions(id: string) {
+  return useQuery({
+    queryKey: ["bill-actions", id],
+    queryFn: () => billsAPI.getActions(id),
+    staleTime: 5 * 60 * 1000,
+    enabled: !!id,
+  });
+}
+
+export function useBillNews(id: string) {
+  return useQuery({
+    queryKey: ["bill-news", id],
+    queryFn: () => billsAPI.getNews(id),
+    staleTime: 0, // Always fetch fresh — news arrives async after brief generation
+    enabled: !!id,
+  });
+}
+
+export function useBillTrend(id: string, days = 30) {
+  return useQuery({
+    queryKey: ["bill-trend", id, days],
+    queryFn: () => billsAPI.getTrend(id, days),
+    staleTime: 60 * 60 * 1000,
+    enabled: !!id,
+  });
+}

frontend/lib/hooks/useDashboard.ts

@@ -0,0 +1,13 @@
+import { useQuery } from "@tanstack/react-query";
+import { dashboardAPI } from "../api";
+import { useAuthStore } from "@/stores/authStore";
+
+export function useDashboard() {
+  const token = useAuthStore((s) => s.token);
+  return useQuery({
+    queryKey: ["dashboard", !!token],
+    queryFn: () => dashboardAPI.get(),
+    staleTime: 2 * 60 * 1000,
+    refetchInterval: 5 * 60 * 1000,
+  });
+}

frontend/lib/hooks/useFollows.ts

@@ -0,0 +1,50 @@
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { followsAPI } from "../api";
+import { useAuthStore } from "@/stores/authStore";
+
+export function useFollows() {
+  const token = useAuthStore((s) => s.token);
+  return useQuery({
+    queryKey: ["follows"],
+    queryFn: () => followsAPI.list(),
+    staleTime: 30 * 1000,
+    enabled: !!token,
+  });
+}
+
+export function useAddFollow() {
+  const qc = useQueryClient();
+  return useMutation({
+    mutationFn: ({ type, value }: { type: string; value: string }) =>
+      followsAPI.add(type, value),
+    onSuccess: () => {
+      qc.invalidateQueries({ queryKey: ["follows"] });
+      qc.invalidateQueries({ queryKey: ["dashboard"] });
+    },
+  });
+}
+
+export function useRemoveFollow() {
+  const qc = useQueryClient();
+  return useMutation({
+    mutationFn: (id: number) => followsAPI.remove(id),
+    onSuccess: () => {
+      qc.invalidateQueries({ queryKey: ["follows"] });
+      qc.invalidateQueries({ queryKey: ["dashboard"] });
+    },
+  });
+}
+
+export function useIsFollowing(type: string, value: string) {
+  const { data: follows = [] } = useFollows();
+  return follows.find((f) => f.follow_type === type && f.follow_value === value);
+}
+
+export function useUpdateFollowMode() {
+  const qc = useQueryClient();
+  return useMutation({
+    mutationFn: ({ id, mode }: { id: number; mode: string }) =>
+      followsAPI.updateMode(id, mode),
+    onSuccess: () => qc.invalidateQueries({ queryKey: ["follows"] }),
+  });
+}

frontend/lib/hooks/useMembers.ts

@@ -0,0 +1,46 @@
+import { useQuery } from "@tanstack/react-query";
+import { membersAPI } from "../api";
+
+export function useMembers(params?: Record<string, unknown>) {
+  return useQuery({
+    queryKey: ["members", params],
+    queryFn: () => membersAPI.list(params),
+    staleTime: 10 * 60 * 1000,
+  });
+}
+
+export function useMember(id: string) {
+  return useQuery({
+    queryKey: ["member", id],
+    queryFn: () => membersAPI.get(id),
+    staleTime: 10 * 60 * 1000,
+    enabled: !!id,
+  });
+}
+
+export function useMemberBills(id: string) {
+  return useQuery({
+    queryKey: ["member-bills", id],
+    queryFn: () => membersAPI.getBills(id),
+    staleTime: 5 * 60 * 1000,
+    enabled: !!id,
+  });
+}
+
+export function useMemberTrend(id: string, days = 30) {
+  return useQuery({
+    queryKey: ["member-trend", id, days],
+    queryFn: () => membersAPI.getTrend(id, days),
+    staleTime: 60 * 60 * 1000,
+    enabled: !!id,
+  });
+}
+
+export function useMemberNews(id: string) {
+  return useQuery({
+    queryKey: ["member-news", id],
+    queryFn: () => membersAPI.getNews(id),
+    staleTime: 10 * 60 * 1000,
+    enabled: !!id,
+  });
+}