Add agencies API integration

Author: jamesg8025

frontend/providers/SearchProvider.tsx

@@ -2,7 +2,7 @@
 import { createContext, useCallback, useContext, useMemo, useState } from "react"
 import { apiFetch } from "@/utils/apiFetch"
 import { useAuth } from "@/providers/AuthProvider"
-import { SearchRequest, SearchResponse, PaginatedSearchResponses } from "@/utils/api"
+import { SearchRequest, SearchResponse, PaginatedSearchResponses, AgenciesRequest, AgenciesApiResponse } from "@/utils/api"
 import API_ROUTES, { apiBaseUrl } from "@/utils/apiRoutes"
 import { ApiError } from "@/utils/apiError"
 import { useRouter, useSearchParams } from "next/navigation"
@@ -11,6 +11,9 @@ interface SearchContext {
   searchAll: (
     query: Omit<SearchRequest, "access_token" | "accessToken">
   ) => Promise<PaginatedSearchResponses>
+  searchAgencies: (
+    params: Omit<AgenciesRequest, "access_token" | "accessToken">
+  ) => Promise<AgenciesApiResponse>
   searchResults?: PaginatedSearchResponses
   loading: boolean
 }
@@ -94,5 +97,50 @@ function useHook(): SearchContext {
     [accessToken, refreshAccessToken, router]
   )
 
-  return useMemo(() => ({ searchAll, searchResults, loading }), [searchResults, searchAll, loading])
+  const searchAgencies = useCallback(
+    async (params: Omit<AgenciesRequest, "access_token" | "accessToken">) => {
+      if (!accessToken) throw new ApiError("No access token", "NO_ACCESS_TOKEN", 401)
+        setLoading(true)
+
+        try {
+          const queryParams = new URLSearchParams()
+          Object.entries(params).forEach(([key, value]) => {
+            if (value !== undefined) {
+              queryParams.set(key, String(value))
+            }
+          })
+
+          const apiUrl = `${apiBaseUrl}${API_ROUTES.agencies}?${queryParams.toString()}`
+
+          const response = await apiFetch(apiBaseUrl, {
+            method: "GET",
+            headers: {
+              "Content-Type": "application/json"
+            }
+          })
+
+          if (!response.ok) {
+            throw new Error("Failed to search agencies")
+          }
+
+          const data: AgenciesApiResponse = await response.json()
+          return data
+        } catch (error) {
+          console.error("Error searching agencies:", error)
+          return {
+            error: String(error),
+            results: [],
+            page: 0,
+            per_page: 0,
+            pages: 0,
+            total: 0
+          }
+        } finally {
+          setLoading(false)
+        }
+    },
+    [accessToken]
+  )
+
+  return useMemo(() => ({ searchAll, searchResults, loading }), [searchResults, searchAll, searchResults, loading])
 }

frontend/utils/api.ts

@@ -59,3 +59,32 @@ export type PaginatedSearchResponses = {
   total: number
   results: SearchResponse[]
 }
+
+export interface AgenciesRequest extends AuthenticatedRequest {
+  name?: string
+  city?: string
+  state?: string
+  zip_code?: string
+  jurisdiction?: string
+  page?: number
+  per_page?: number  
+}
+
+export interface AgencyResponse {
+  uid: string
+  title: string
+  subtitle: string
+  content_type: string
+  source: string
+  last_updated: string
+  // Could add other agency-specific fields here, as needed
+}
+
+export type AgenciesApiResponse = {
+  results: AgencyResponse[]
+  page: number
+  per_page: number
+  pages: number
+  total: number
+  error?: string
+}

frontend/utils/apiRoutes.ts

@@ -8,7 +8,8 @@ const API_ROUTES = {
   search: {
     all: "/search/",
     incidents: "/incidents/search"
-  }
+  },
+  agencies: "/api/v1/agencies"
 }
 
 export const apiBaseUrl: string =