@halfdays/resolve-parcel

Address/TMS → fully-attributed Charleston County parcel resolver, backed by the lowcountry Supabase ETL.

Install

npm install @halfdays/resolve-parcel

Usage

import { resolveParcel } from "@halfdays/resolve-parcel";

const parcel = await resolveParcel(
  { address: "87 Tradd Street, Charleston, SC 29401" },
  {
    supabaseUrl: process.env.LOWCOUNTRY_URL,
    supabaseAnonKey: process.env.LOWCOUNTRY_ANON_KEY,
  }
);

if (parcel) {
  console.log(parcel.pid, parcel.site_address, parcel.zoning_district);
}

You can also pass a pre-built Supabase client:

import { createClient } from "@supabase/supabase-js";
import { resolveParcel } from "@halfdays/resolve-parcel";

const client = createClient(url, serviceKey, { auth: { persistSession: false } });
const parcel = await resolveParcel({ tms: "4570600118" }, { client });

Resolution order

1. TMS lookup (digits-only normalized)
2. Address trigram match against address_points
3. Address trigram match against parcels.address
4. ArcGIS geocoder → spatial lookup via parcel_at_point()
5. null if nothing matches

API

resolveParcel(input, options?)

• input: { address?: string; tms?: string }
• options:
  • client?: SupabaseClient — pre-built client (skips env-var lookup)
  • supabaseUrl?: string — falls back to SUPABASE_URL / NEXT_PUBLIC_SUPABASE_URL
  • supabaseAnonKey?: string — falls back to SUPABASE_ANON_KEY / NEXT_PUBLIC_SUPABASE_ANON_KEY
  • minSimilarity?: number — trigram threshold for non-exact matches (default 0.6)
  • geocoderUrl?: string — override the ArcGIS geocoder URL
  • fetchImpl?: typeof fetch — override the global fetch

Returns Promise<ResolvedParcel | null>.

See resolve-parcel.ts for the full ResolvedParcel shape (geometry, overlays, jurisdiction, etc.).

License

MIT