web_app/src/api/jurisdictionMappingUnmapped.ts

/** Live drill-down for jurisdictions missing a primary website URL. */

export type UnmappedDrillEntity = 'state' | 'cities' | 'towns' | 'counties' | 'schools'

export type UnmappedDrillParams = {
  entity: UnmappedDrillEntity
  state_code?: string
  acs_population_tier?: string
  acs_income_level?: string
  limit?: number
  offset?: number
}

export type UnmappedDrillRow = {
  jurisdiction_id: string
  name: string
  state_code: string
  jurisdiction_type: string
  geoid?: string | null
  municipality_place_kind?: string | null
  n_website_candidate_rows?: number | null
  has_naco_source?: boolean | null
  has_uscm_source?: boolean | null
  has_nces_directory_source?: boolean | null
  has_gsa_source?: boolean | null
  has_league_source?: boolean | null
  has_wikidata_source?: boolean | null
  has_override_source?: boolean | null
  acs_population_tier?: string | null
  acs_income_level?: string | null
}

export type UnmappedDrillResponse = {
  entity: string
  state_code: string | null
  acs_population_tier: string | null
  acs_income_level: string | null
  total: number
  limit: number
  offset: number
  rows: UnmappedDrillRow[]
}

export async function fetchUnmappedJurisdictions(
  params: UnmappedDrillParams,
  signal?: AbortSignal,
): Promise<UnmappedDrillResponse> {
  const u = new URL('/api/jurisdiction-mapping/unmapped', window.location.origin)
  u.searchParams.set('entity', params.entity)
  if (params.state_code) u.searchParams.set('state_code', params.state_code)
  if (params.acs_population_tier) u.searchParams.set('acs_population_tier', params.acs_population_tier)
  if (params.acs_income_level) u.searchParams.set('acs_income_level', params.acs_income_level)
  if (params.limit != null) u.searchParams.set('limit', String(params.limit))
  if (params.offset != null) u.searchParams.set('offset', String(params.offset))

  const res = await fetch(u.toString(), { credentials: 'include', signal })
  if (!res.ok) {
    let detail = `HTTP ${res.status}`
    try {
      const body = (await res.json()) as { detail?: string }
      if (body.detail) detail = body.detail
    } catch {
      /* ignore */
    }
    throw new Error(detail)
  }
  return (await res.json()) as UnmappedDrillResponse
}