@urbankitstudio/atlas 0.5.1 → 0.5.3

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Leo Yong
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Leo Yong
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,110 +1,146 @@
-# @urbankitstudio/atlas
-
-JS SDK for the **UrbanKit County Parcel REST API Atlas** — a curated index of public ArcGIS REST endpoints for US county parcel data, with searchable field metadata, sample queries, and license info.
-
-Use it to:
-
-- Look up the parcel REST endpoint for a given US county (e.g. Kane County, IL).
-- Discover which fields are searchable on each endpoint (PIN, owner name, address).
-- Build deep-links into the UrbanKit parcel lookup tool.
-
-The data is the same set powering [urbankitstudio.com/parcel-atlas](https://urbankitstudio.com/parcel-atlas), bundled offline so your code does not need to make a runtime network request.
-
-## Install
-
-```bash
-npm i @urbankitstudio/atlas
-```
-
-Works in Node.js (>=18) and modern bundlers (Vite, webpack, esbuild, Rollup, Next.js, Remix). Ships ESM + CJS with full TypeScript types. No runtime dependencies. `sideEffects: false`.
-
-## Quick start
-
-### 1. List populated states
-
-```ts
-import { listStates } from "@urbankitstudio/atlas";
-
-const populated = listStates().filter((s) => s.populated);
-// [{ slug: "arizona", name: "Arizona", abbrev: "AZ", countyCount: 1, ... }, ...]
-```
-
-### 2. Look up a county by slug
-
-```ts
-import { findCounty } from "@urbankitstudio/atlas";
-
-const kane = findCounty("illinois", "kane-county");
-if (kane) {
-  console.log(kane.endpoints[0].url);
-  // → https://gis.kanecountyil.gov/...
-
-  const pin = kane.endpoints[0].searchFields.find((f) => f.name === "PIN");
-  console.log(pin?.label);
-  // → "Parcel Identification Number (PIN)"
-}
-```
-
-### 3. Look up a county by FIPS code
-
-```ts
-import { findCountyByFips } from "@urbankitstudio/atlas";
-
-const kane = findCountyByFips("17089"); // 5-digit county FIPS (state + county)
-if (kane) {
-  console.log(kane.county, kane.stateSlug);
-  // → Kane illinois
-}
-// Unknown, malformed, or non-5-digit input returns undefined (never throws).
-```
-
-### 4. Build a parcel-lookup deep-link
-
-```ts
-import { findCounty, buildParcelLookupDeepLink } from "@urbankitstudio/atlas";
-
-const kane = findCounty("illinois", "kane-county")!;
-const link = buildParcelLookupDeepLink(kane.endpoints[0]);
-// → https://urbankitstudio.com/tools/parcel-lookup?endpoint=https%3A%2F%2F...&fieldHint=TaxName
-```
-
-## API
-
-| Function | Returns |
-|---|---|
-| `listStates()` | `StateIndexEntry[]` — all 50 states + `populated` flag |
-| `findState(stateSlug)` | `StateFile \| undefined` |
-| `findCounty(stateSlug, countySlug)` | `CountyRecord \| undefined` |
-| `findCountyByFips(fips)` | `CountyRecord \| undefined` — match by 5-digit county FIPS |
-| `listCountiesByState(stateSlug)` | `CountyRecord[]` |
-| `buildParcelLookupDeepLink(endpoint)` | URL string into the UrbanKit lookup tool |
-| `slugify(s)`, `countySlugFromName(s)` | string helpers matching the atlas slug convention |
-| `statePath(slug)`, `countyPath(state, county)` | URL paths under `/parcel-atlas` |
-
-The full typed root is also exported as `atlas`:
-
-```ts
-import { atlas } from "@urbankitstudio/atlas";
-
-atlas.version;          // string
-atlas.lastUpdated;      // ISO date
-atlas.totals;           // { states, counties, endpoints }
-atlas.byStateSlug;      // Map<stateSlug, StateFile>
-```
-
-## Coverage today
-
-The atlas currently bundles **155 counties across all 50 US states**, covering the largest counties in each. Call `listStates()` to enumerate the full set; every state is now populated with at least one verified county endpoint.
-
-Counties are added as their public REST endpoints are verified. Package versions bump when data refreshes — pin to a minor range (`^0.x`) to receive new counties without breaking changes.
-
-The live, browseable atlas lives at [urbankitstudio.com/parcel-atlas](https://urbankitstudio.com/parcel-atlas).
-
-## License
-
-MIT — see [LICENSE](./LICENSE). © 2026 Leo Yong.
-
-This package's atlas dataset (the open **discovery layer** — county → REST endpoint
-mappings and field metadata) is provided under MIT. Live, always-fresh and enriched
-data — geocoding, address→parcel resolution, bulk enrichment, and the data-availability
-SLA — are the paid [UrbanKit Studio API](https://urbankitstudio.com/pricing).
+# @urbankitstudio/atlas
+
+JS SDK for the **UrbanKit County Parcel REST API Atlas** — a curated index of public ArcGIS REST endpoints for US county parcel data, with searchable field metadata, sample queries, and license info.
+
+Use it to:
+
+- Look up the parcel REST endpoint for a given US county (e.g. Kane County, IL).
+- Discover which fields are searchable on each endpoint (PIN, owner name, address).
+- Build deep-links into the UrbanKit parcel lookup tool.
+
+The data is the same set powering [urbankitstudio.com/parcel-atlas](https://urbankitstudio.com/parcel-atlas), bundled offline so your code does not need to make a runtime network request.
+
+## Install
+
+```bash
+npm i @urbankitstudio/atlas
+```
+
+Works in Node.js (>=18) and modern bundlers (Vite, webpack, esbuild, Rollup, Next.js, Remix). Ships ESM + CJS with full TypeScript types. No runtime dependencies. `sideEffects: false`.
+
+## Quick start
+
+### 1. List populated states
+
+```ts
+import { listStates } from "@urbankitstudio/atlas";
+
+const populated = listStates().filter((s) => s.populated);
+// [{ slug: "arizona", name: "Arizona", abbrev: "AZ", countyCount: 1, ... }, ...]
+```
+
+### 2. Look up a county by slug
+
+```ts
+import { findCounty } from "@urbankitstudio/atlas";
+
+const kane = findCounty("illinois", "kane-county");
+if (kane) {
+  console.log(kane.endpoints[0].url);
+  // → https://gis.kanecountyil.gov/...
+
+  const pin = kane.endpoints[0].searchFields.find((f) => f.name === "PIN");
+  console.log(pin?.label);
+  // → "Parcel Identification Number (PIN)"
+}
+```
+
+### 3. Look up a county by FIPS code
+
+```ts
+import { findCountyByFips } from "@urbankitstudio/atlas";
+
+const kane = findCountyByFips("17089"); // 5-digit county FIPS (state + county)
+if (kane) {
+  console.log(kane.county, kane.stateSlug);
+  // → Kane illinois
+}
+// Unknown, malformed, or non-5-digit input returns undefined (never throws).
+```
+
+### 4. Build a parcel-lookup deep-link
+
+```ts
+import { findCounty, buildParcelLookupDeepLink } from "@urbankitstudio/atlas";
+
+const kane = findCounty("illinois", "kane-county")!;
+const link = buildParcelLookupDeepLink(kane.endpoints[0]);
+// → https://urbankitstudio.com/tools/parcel-lookup?endpoint=https%3A%2F%2F...&fieldHint=TaxName
+```
+
+## API
+
+| Function | Returns |
+|---|---|
+| `listStates()` | `StateIndexEntry[]` — all 50 states + `populated` flag |
+| `findState(stateSlug)` | `StateFile \| undefined` |
+| `findCounty(stateSlug, countySlug)` | `CountyRecord \| undefined` |
+| `findCountyByFips(fips)` | `CountyRecord \| undefined` — match by 5-digit county FIPS |
+| `listCountiesByState(stateSlug)` | `CountyRecord[]` |
+| `buildParcelLookupDeepLink(endpoint)` | URL string into the UrbanKit lookup tool |
+| `slugify(s)`, `countySlugFromName(s)` | string helpers matching the atlas slug convention |
+| `statePath(slug)`, `countyPath(state, county)` | URL paths under `/parcel-atlas` |
+
+The full typed root is also exported as `atlas`:
+
+```ts
+import { atlas } from "@urbankitstudio/atlas";
+
+atlas.version;          // string
+atlas.lastUpdated;      // ISO date
+atlas.totals;           // { states, counties, endpoints }
+atlas.byStateSlug;      // Map<stateSlug, StateFile>
+```
+
+## `status` is a publish-time claim, not a live signal
+
+This package ships static JSON and makes no network calls, so `status` and
+`lastVerified` on every endpoint describe what was true **when the version you
+installed was published**. `status: "live"` means a check passed before publish —
+not that the endpoint is up right now. A county can go down the day after a
+release and every installed copy keeps saying `"live"` until the next one.
+
+The distinction is not hypothetical: on 2026-08-04 a county was being served as
+`"live"` from its registry entry while the liveness probe had it down that same
+afternoon.
+
+For the current answer, ask the health endpoint — no API key, refreshed every
+two hours:
+
+```ts
+import { LIVE_STATUS_URL } from "@urbankitstudio/atlas";
+
+const res = await fetch(`${LIVE_STATUS_URL}?fips=17089`);
+const health = await res.json();
+// { ok: true, found: true, county_fips: "17089",
+//   status: "ok" | "degraded" | "down" | "unknown",
+//   consecutive_failures, last_ok_at, checked_at }
+```
+
+Two cases to handle rather than ignore:
+
+- **`found: false`** means no observation exists — the county may be untracked or
+  never probed. It is *not* a statement that the endpoint is healthy.
+- **A `503`** means the health store itself was unreachable. Also not a health
+  claim.
+
+Treat both as *unknown*. Neither should render as "up".
+
+Omit `?fips=` to get every tracked county in one call.
+
+## Coverage today
+
+The atlas currently bundles **155 counties across all 50 US states**, covering the largest counties in each. Call `listStates()` to enumerate the full set; every state is now populated with at least one verified county endpoint.
+
+Counties are added as their public REST endpoints are verified. Package versions bump when data refreshes — pin to a minor range (`^0.x`) to receive new counties without breaking changes.
+
+The live, browseable atlas lives at [urbankitstudio.com/parcel-atlas](https://urbankitstudio.com/parcel-atlas).
+
+## License
+
+MIT — see [LICENSE](./LICENSE). © 2026 Leo Yong.
+
+This package's atlas dataset (the open **discovery layer** — county → REST endpoint
+mappings and field metadata) is provided under MIT. Live, always-fresh and enriched
+data — geocoding, address→parcel resolution, bulk enrichment, and the data-availability
+SLA — are the paid [UrbanKit Studio API](https://urbankitstudio.com/pricing).

package/data/alabama.json

@@ -1,103 +1,103 @@
-{
-  "stateSlug": "alabama",
-  "stateName": "Alabama",
-  "stateAbbrev": "AL",
-  "lastUpdated": "2026-06-20",
-  "counties": [
-    {
-      "id": "al-shelby",
-      "state": "AL",
-      "stateName": "Alabama",
-      "stateSlug": "alabama",
-      "county": "Shelby",
-      "countySlug": "shelby-county",
-      "countyFips": "01117",
-      "hasPublicRest": true,
-      "endpoints": [
-        {
-          "url": "https://maps.shelbyal.com/gisserver/rest/services/LegacyServices/Cadastral_2022/MapServer/91",
-          "serviceType": "MapServer",
-          "layerIndex": 91,
-          "layerName": "Parcels",
-          "supportsQuery": true,
-          "corsEnabled": null,
-          "searchFields": [
-            { "name": "Parcel_Num", "label": "Parcel Number", "searchable": true },
-            { "name": "NAM1", "label": "Owner Name 1", "searchable": true },
-            { "name": "NAM2", "label": "Owner Name 2", "searchable": false },
-            { "name": "ADR1", "label": "Owner Address Line 1", "searchable": false },
-            { "name": "ADR2", "label": "Owner Address Line 2", "searchable": false },
-            { "name": "CITY", "label": "Owner City", "searchable": false },
-            { "name": "STATE", "label": "Owner State", "searchable": false },
-            { "name": "ZIP", "label": "Owner ZIP", "searchable": false },
-            { "name": "PROP_ADR", "label": "Property Address", "searchable": true },
-            { "name": "Subd_Name", "label": "Subdivision Name", "searchable": false },
-            { "name": "Zoning", "label": "Zoning", "searchable": false },
-            { "name": "ACRES", "label": "Acres", "searchable": false },
-            { "name": "PROP_CLASS", "label": "Property Class", "searchable": false }
-          ],
-          "sampleQuery": "https://maps.shelbyal.com/gisserver/rest/services/LegacyServices/Cadastral_2022/MapServer/91/query?where=UPPER(NAM1)+LIKE+UPPER('%25SMITH%25')&outFields=Parcel_Num,NAM1,NAM2,ADR1,CITY,PROP_ADR,Subd_Name&returnGeometry=false&f=json&resultRecordCount=10",
-          "license": "public",
-          "licenseUrl": "https://maps.shelbyal.com/",
-          "status": "live",
-          "lastVerified": "2026-06-20",
-          "verifiedBy": "automated"
-        }
-      ],
-      "contact": {
-        "department": "Shelby County GIS / Shelby County Commission",
-        "url": "https://maps.shelbyal.com/",
-        "email": null
-      },
-      "notes": "Shelby County AL (Birmingham south suburbs, Hoover, Alabaster, Helena, Pelham, Calera; county seat Columbiana; FIPS 01117; fastest-growing county in AL) uses MapServer layer 91 (layerIndex=91) in the Cadastral_2022 service at maps.shelbyal.com. The layer has 160+ fields including Parcel_Num, NAM1, NAM2 (owner names), ADR1/ADR2, CITY, STATE, ZIP, ZIP4 (owner mailing address), PROP_ADR (property address), Subd_Name, Zoning, ACRES, SQUARE_FEET, PROP_CLASS, DIST, SCH_DIST, LN_VL1/LN_VL2, CUR_USE_VL, various CIMP/IMP improvement codes and values, tax sale fields, and audit timestamps. Owner search via UPPER(NAM1) LIKE on NAM1 works. Verified 2026-06-20: SMITH returns Shelby County addresses (e.g., 'SMITH GLENDA & ADAMS MIRIAM ROLLS & MIKE'). Note: layerIndex 91 is non-standard. Must specify /91 in the URL. Do not confuse with Shelby County TN (Memphis, FIPS 47157) already in the atlas."
-    },
-    {
-      "id": "al-jefferson",
-      "state": "AL",
-      "stateName": "Alabama",
-      "stateSlug": "alabama",
-      "county": "Jefferson",
-      "countySlug": "jefferson-county",
-      "countyFips": "01073",
-      "hasPublicRest": true,
-      "endpoints": [
-        {
-          "url": "https://jccgis.jccal.org/server/rest/services/Basemap/Parcels/MapServer/0",
-          "serviceType": "MapServer",
-          "layerIndex": 0,
-          "layerName": "Parcels",
-          "supportsQuery": true,
-          "corsEnabled": null,
-          "searchFields": [
-            { "name": "PARCELID", "label": "Parcel ID", "searchable": true },
-            { "name": "OWNERNAME", "label": "Owner Name", "searchable": true },
-            { "name": "PROP_MAIL", "label": "Property Mailing Address", "searchable": false },
-            { "name": "Street_Name", "label": "Street Name", "searchable": true },
-            { "name": "Bldg_Number", "label": "Building Number", "searchable": false },
-            { "name": "ADDR_PSPR", "label": "Address (Street Number+Prefix)", "searchable": false },
-            { "name": "APARTMENT", "label": "Apartment", "searchable": false },
-            { "name": "CITYMAIL", "label": "Mailing City", "searchable": false },
-            { "name": "ZIP_MAIL", "label": "Mailing ZIP", "searchable": false },
-            { "name": "STATE_Mail", "label": "Mailing State", "searchable": false },
-            { "name": "Legal_Desc", "label": "Legal Description", "searchable": false },
-            { "name": "Property_City", "label": "Property City", "searchable": false },
-            { "name": "ACRES_APR", "label": "Appraised Acres", "searchable": false },
-            { "name": "AssdValue", "label": "Assessed Value", "searchable": false }
-          ],
-          "sampleQuery": "https://jccgis.jccal.org/server/rest/services/Basemap/Parcels/MapServer/0/query?where=UPPER(OWNERNAME)+LIKE+UPPER('%25SMITH%25')&outFields=PARCELID,OWNERNAME,PROP_MAIL,Street_Name,Property_City&returnGeometry=false&f=json&resultRecordCount=10",
-          "license": "public",
-          "licenseUrl": "https://www.jccal.org/Default.asp?ID=1220&pg=Enterprise+GIS",
-          "status": "live",
-          "lastVerified": "2026-06-27",
-          "verifiedBy": "automated"
-        }
-      ],
-      "contact": {
-        "department": "Jefferson County Commission GIS / Information Technology Services, EGIS",
-        "url": "https://data-jeffco-al.opendata.arcgis.com/",
-        "email": null
-      },
-      "notes": "Jefferson County AL (Birmingham, pop. 670,000; FIPS 01073) Basemap/Parcels layer. Data maintained by Jefferson County Tax Assessor Office and updated nightly. 76 fields in live schema as of 2026-06-27: OBJECTID, Unique_ID, PID, TAX_TOWNSH, ISP_SECTION, SEC, QSECTION, BLOCK, PARCEL, PARCELID, APP_PID, DISTRICT, ESN_NUM, ADDR_PSPR, Bldg_Number, Street_Name, Street_Type, Street_Dir, APARTMENT, ADDRAPT_PS, OWNERNAME, PROP_MAIL, CITYMAIL, ZIP_MAIL, STATE_Mail, Legal_Desc, Property_City, Property_State, NEIGHBOR_N, SUBDIV_NAME, ADDR_APR, ZIP, TotalMHValue, PrevParcelLand/Imp/Total, Water, Sewer, Gas, ACRES_APR, GIS_ACRES, Remarks, Name2, Plat_Book/Page (×2), NbhdCd, Ownership, Topography, RoadAcc, MaintDate, CITY, NbhName, PriMunCode, SecMunCode, PriAcreage, SecAcreage, LegalRemarks, ParcelNo, Division, RecordYear, SchDist, MapNumber, Sqft, FIREDEPTNAME, Cls, BLDG_IND, TAX_CODE, OBY_IND, AssdValue, Territory, FireFee_District. NOTE 2026-06-27: ZONING_BOE is no longer in the live schema (schema drift), removed from searchFields. OWNERNAME field returns padded fixed-width strings (trim on use). Note: distinct from Jefferson County CO (FIPS 08059) and Jefferson County KY (Louisville; FIPS 21111) already in atlas. Verified 2026-06-27: metadata 200, query 200, 410K+ parcels."
-    }
-  ]
-}
+{
+  "stateSlug": "alabama",
+  "stateName": "Alabama",
+  "stateAbbrev": "AL",
+  "lastUpdated": "2026-06-20",
+  "counties": [
+    {
+      "id": "al-shelby",
+      "state": "AL",
+      "stateName": "Alabama",
+      "stateSlug": "alabama",
+      "county": "Shelby",
+      "countySlug": "shelby-county",
+      "countyFips": "01117",
+      "hasPublicRest": true,
+      "endpoints": [
+        {
+          "url": "https://maps.shelbyal.com/gisserver/rest/services/LegacyServices/Cadastral_2022/MapServer/91",
+          "serviceType": "MapServer",
+          "layerIndex": 91,
+          "layerName": "Parcels",
+          "supportsQuery": true,
+          "corsEnabled": null,
+          "searchFields": [
+            { "name": "Parcel_Num", "label": "Parcel Number", "searchable": true },
+            { "name": "NAM1", "label": "Owner Name 1", "searchable": true },
+            { "name": "NAM2", "label": "Owner Name 2", "searchable": false },
+            { "name": "ADR1", "label": "Owner Address Line 1", "searchable": false },
+            { "name": "ADR2", "label": "Owner Address Line 2", "searchable": false },
+            { "name": "CITY", "label": "Owner City", "searchable": false },
+            { "name": "STATE", "label": "Owner State", "searchable": false },
+            { "name": "ZIP", "label": "Owner ZIP", "searchable": false },
+            { "name": "PROP_ADR", "label": "Property Address", "searchable": true },
+            { "name": "Subd_Name", "label": "Subdivision Name", "searchable": false },
+            { "name": "Zoning", "label": "Zoning", "searchable": false },
+            { "name": "ACRES", "label": "Acres", "searchable": false },
+            { "name": "PROP_CLASS", "label": "Property Class", "searchable": false }
+          ],
+          "sampleQuery": "https://maps.shelbyal.com/gisserver/rest/services/LegacyServices/Cadastral_2022/MapServer/91/query?where=UPPER(NAM1)+LIKE+UPPER('%25SMITH%25')&outFields=Parcel_Num,NAM1,NAM2,ADR1,CITY,PROP_ADR,Subd_Name&returnGeometry=false&f=json&resultRecordCount=10",
+          "license": "public",
+          "licenseUrl": "https://maps.shelbyal.com/",
+          "status": "live",
+          "lastVerified": "2026-06-20",
+          "verifiedBy": "automated"
+        }
+      ],
+      "contact": {
+        "department": "Shelby County GIS / Shelby County Commission",
+        "url": "https://maps.shelbyal.com/",
+        "email": null
+      },
+      "notes": "Shelby County AL (Birmingham south suburbs, Hoover, Alabaster, Helena, Pelham, Calera; county seat Columbiana; FIPS 01117; fastest-growing county in AL) uses MapServer layer 91 (layerIndex=91) in the Cadastral_2022 service at maps.shelbyal.com. The layer has 160+ fields including Parcel_Num, NAM1, NAM2 (owner names), ADR1/ADR2, CITY, STATE, ZIP, ZIP4 (owner mailing address), PROP_ADR (property address), Subd_Name, Zoning, ACRES, SQUARE_FEET, PROP_CLASS, DIST, SCH_DIST, LN_VL1/LN_VL2, CUR_USE_VL, various CIMP/IMP improvement codes and values, tax sale fields, and audit timestamps. Owner search via UPPER(NAM1) LIKE on NAM1 works. Verified 2026-06-20: SMITH returns Shelby County addresses (e.g., 'SMITH GLENDA & ADAMS MIRIAM ROLLS & MIKE'). Note: layerIndex 91 is non-standard. Must specify /91 in the URL. Do not confuse with Shelby County TN (Memphis, FIPS 47157) already in the atlas."
+    },
+    {
+      "id": "al-jefferson",
+      "state": "AL",
+      "stateName": "Alabama",
+      "stateSlug": "alabama",
+      "county": "Jefferson",
+      "countySlug": "jefferson-county",
+      "countyFips": "01073",
+      "hasPublicRest": true,
+      "endpoints": [
+        {
+          "url": "https://jccgis.jccal.org/server/rest/services/Basemap/Parcels/MapServer/0",
+          "serviceType": "MapServer",
+          "layerIndex": 0,
+          "layerName": "Parcels",
+          "supportsQuery": true,
+          "corsEnabled": null,
+          "searchFields": [
+            { "name": "PARCELID", "label": "Parcel ID", "searchable": true },
+            { "name": "OWNERNAME", "label": "Owner Name", "searchable": true },
+            { "name": "PROP_MAIL", "label": "Property Mailing Address", "searchable": false },
+            { "name": "Street_Name", "label": "Street Name", "searchable": true },
+            { "name": "Bldg_Number", "label": "Building Number", "searchable": false },
+            { "name": "ADDR_PSPR", "label": "Address (Street Number+Prefix)", "searchable": false },
+            { "name": "APARTMENT", "label": "Apartment", "searchable": false },
+            { "name": "CITYMAIL", "label": "Mailing City", "searchable": false },
+            { "name": "ZIP_MAIL", "label": "Mailing ZIP", "searchable": false },
+            { "name": "STATE_Mail", "label": "Mailing State", "searchable": false },
+            { "name": "Legal_Desc", "label": "Legal Description", "searchable": false },
+            { "name": "Property_City", "label": "Property City", "searchable": false },
+            { "name": "ACRES_APR", "label": "Appraised Acres", "searchable": false },
+            { "name": "AssdValue", "label": "Assessed Value", "searchable": false }
+          ],
+          "sampleQuery": "https://jccgis.jccal.org/server/rest/services/Basemap/Parcels/MapServer/0/query?where=UPPER(OWNERNAME)+LIKE+UPPER('%25SMITH%25')&outFields=PARCELID,OWNERNAME,PROP_MAIL,Street_Name,Property_City&returnGeometry=false&f=json&resultRecordCount=10",
+          "license": "public",
+          "licenseUrl": "https://www.jccal.org/Default.asp?ID=1220&pg=Enterprise+GIS",
+          "status": "live",
+          "lastVerified": "2026-06-27",
+          "verifiedBy": "automated"
+        }
+      ],
+      "contact": {
+        "department": "Jefferson County Commission GIS / Information Technology Services, EGIS",
+        "url": "https://data-jeffco-al.opendata.arcgis.com/",
+        "email": null
+      },
+      "notes": "Jefferson County AL (Birmingham, pop. 670,000; FIPS 01073) Basemap/Parcels layer. Data maintained by Jefferson County Tax Assessor Office and updated nightly. 76 fields in live schema as of 2026-06-27: OBJECTID, Unique_ID, PID, TAX_TOWNSH, ISP_SECTION, SEC, QSECTION, BLOCK, PARCEL, PARCELID, APP_PID, DISTRICT, ESN_NUM, ADDR_PSPR, Bldg_Number, Street_Name, Street_Type, Street_Dir, APARTMENT, ADDRAPT_PS, OWNERNAME, PROP_MAIL, CITYMAIL, ZIP_MAIL, STATE_Mail, Legal_Desc, Property_City, Property_State, NEIGHBOR_N, SUBDIV_NAME, ADDR_APR, ZIP, TotalMHValue, PrevParcelLand/Imp/Total, Water, Sewer, Gas, ACRES_APR, GIS_ACRES, Remarks, Name2, Plat_Book/Page (×2), NbhdCd, Ownership, Topography, RoadAcc, MaintDate, CITY, NbhName, PriMunCode, SecMunCode, PriAcreage, SecAcreage, LegalRemarks, ParcelNo, Division, RecordYear, SchDist, MapNumber, Sqft, FIREDEPTNAME, Cls, BLDG_IND, TAX_CODE, OBY_IND, AssdValue, Territory, FireFee_District. NOTE 2026-06-27: ZONING_BOE is no longer in the live schema (schema drift), removed from searchFields. OWNERNAME field returns padded fixed-width strings (trim on use). Note: distinct from Jefferson County CO (FIPS 08059) and Jefferson County KY (Louisville; FIPS 21111) already in atlas. Verified 2026-06-27: metadata 200, query 200, 410K+ parcels."
+    }
+  ]
+}

package/data/alaska.json

@@ -1,51 +1,51 @@
-{
-  "stateSlug": "alaska",
-  "stateName": "Alaska",
-  "stateAbbrev": "AK",
-  "lastUpdated": "2026-05-15",
-  "counties": [
-    {
-      "id": "ak-anchorage",
-      "state": "AK",
-      "stateName": "Alaska",
-      "stateSlug": "alaska",
-      "county": "Anchorage",
-      "countySlug": "anchorage-municipality",
-      "countyFips": "02020",
-      "hasPublicRest": true,
-      "endpoints": [
-        {
-          "url": "https://services1.arcgis.com/7HDiw78fcUiM2BWn/arcgis/rest/services/AK_Parcels/FeatureServer/0",
-          "serviceType": "FeatureServer",
-          "layerIndex": 0,
-          "layerName": "AK_Parcels",
-          "supportsQuery": true,
-          "corsEnabled": null,
-          "searchFields": [
-            { "name": "parcel_id", "label": "Parcel ID", "searchable": true },
-            { "name": "owner", "label": "Owner Name", "searchable": true },
-            { "name": "alt_owner", "label": "Alternate Owner Name", "searchable": true },
-            { "name": "property_type", "label": "Property Type (Residential/Commercial/etc.)", "searchable": false },
-            { "name": "property_use", "label": "Property Use Description", "searchable": false },
-            { "name": "land_value", "label": "Land Value", "searchable": false },
-            { "name": "building_value", "label": "Building Value", "searchable": false },
-            { "name": "total_value", "label": "Total Assessed Value", "searchable": false },
-            { "name": "local_gov", "label": "Local Government (filter: Anchorage Municipality)", "searchable": true }
-          ],
-          "sampleQuery": "https://services1.arcgis.com/7HDiw78fcUiM2BWn/arcgis/rest/services/AK_Parcels/FeatureServer/0/query?where=UPPER(local_gov)+LIKE+'%25ANCHORAGE%25'+AND+UPPER(owner)+LIKE+UPPER('%25SMITH%25')&outFields=parcel_id,owner,alt_owner,property_type,land_value,total_value,local_gov&returnGeometry=false&f=json&resultRecordCount=10",
-          "license": "public",
-          "licenseUrl": "https://services1.arcgis.com/7HDiw78fcUiM2BWn/arcgis/rest/services/AK_Parcels/FeatureServer",
-          "status": "live",
-          "lastVerified": "2026-05-15",
-          "verifiedBy": "manual"
-        }
-      ],
-      "contact": {
-        "department": "Alaska Statewide Parcel Layer (combined from local government sources)",
-        "url": "https://services1.arcgis.com/7HDiw78fcUiM2BWn/arcgis/rest/services/AK_Parcels/FeatureServer",
-        "email": null
-      },
-      "notes": "15 fields confirmed: OBJECTID, parcel_id, owner, alt_owner, property_type, property_use, land_value, building_value, total_value, local_gov, datetime_processed, feature_id, Shape__Area, Shape__Length, GlobalID. This is the Alaska Statewide Parcel FeatureServer, combining parcel data from various local government bodies in Alaska. Filter by local_gov field, use UPPER(local_gov) LIKE '%ANCHORAGE%' for Anchorage Municipality parcels (confirmed returning real parcels including United Airlines, residential, etc.). Owner query confirmed working. NOTE: Alaska does not have counties. It has boroughs and a small number of unified municipalities. Anchorage is officially the Municipality of Anchorage (FIPS 02020). This statewide service also covers Fairbanks North Star Borough, Matanuska-Susitna Borough, and other AK jurisdictions via the local_gov field. Coverage and completeness vary by participating jurisdiction."
-    }
-  ]
-}
+{
+  "stateSlug": "alaska",
+  "stateName": "Alaska",
+  "stateAbbrev": "AK",
+  "lastUpdated": "2026-05-15",
+  "counties": [
+    {
+      "id": "ak-anchorage",
+      "state": "AK",
+      "stateName": "Alaska",
+      "stateSlug": "alaska",
+      "county": "Anchorage",
+      "countySlug": "anchorage-municipality",
+      "countyFips": "02020",
+      "hasPublicRest": true,
+      "endpoints": [
+        {
+          "url": "https://services1.arcgis.com/7HDiw78fcUiM2BWn/arcgis/rest/services/AK_Parcels/FeatureServer/0",
+          "serviceType": "FeatureServer",
+          "layerIndex": 0,
+          "layerName": "AK_Parcels",
+          "supportsQuery": true,
+          "corsEnabled": null,
+          "searchFields": [
+            { "name": "parcel_id", "label": "Parcel ID", "searchable": true },
+            { "name": "owner", "label": "Owner Name", "searchable": true },
+            { "name": "alt_owner", "label": "Alternate Owner Name", "searchable": true },
+            { "name": "property_type", "label": "Property Type (Residential/Commercial/etc.)", "searchable": false },
+            { "name": "property_use", "label": "Property Use Description", "searchable": false },
+            { "name": "land_value", "label": "Land Value", "searchable": false },
+            { "name": "building_value", "label": "Building Value", "searchable": false },
+            { "name": "total_value", "label": "Total Assessed Value", "searchable": false },
+            { "name": "local_gov", "label": "Local Government (filter: Anchorage Municipality)", "searchable": true }
+          ],
+          "sampleQuery": "https://services1.arcgis.com/7HDiw78fcUiM2BWn/arcgis/rest/services/AK_Parcels/FeatureServer/0/query?where=UPPER(local_gov)+LIKE+'%25ANCHORAGE%25'+AND+UPPER(owner)+LIKE+UPPER('%25SMITH%25')&outFields=parcel_id,owner,alt_owner,property_type,land_value,total_value,local_gov&returnGeometry=false&f=json&resultRecordCount=10",
+          "license": "public",
+          "licenseUrl": "https://services1.arcgis.com/7HDiw78fcUiM2BWn/arcgis/rest/services/AK_Parcels/FeatureServer",
+          "status": "live",
+          "lastVerified": "2026-05-15",
+          "verifiedBy": "manual"
+        }
+      ],
+      "contact": {
+        "department": "Alaska Statewide Parcel Layer (combined from local government sources)",
+        "url": "https://services1.arcgis.com/7HDiw78fcUiM2BWn/arcgis/rest/services/AK_Parcels/FeatureServer",
+        "email": null
+      },
+      "notes": "15 fields confirmed: OBJECTID, parcel_id, owner, alt_owner, property_type, property_use, land_value, building_value, total_value, local_gov, datetime_processed, feature_id, Shape__Area, Shape__Length, GlobalID. This is the Alaska Statewide Parcel FeatureServer, combining parcel data from various local government bodies in Alaska. Filter by local_gov field, use UPPER(local_gov) LIKE '%ANCHORAGE%' for Anchorage Municipality parcels (confirmed returning real parcels including United Airlines, residential, etc.). Owner query confirmed working. NOTE: Alaska does not have counties. It has boroughs and a small number of unified municipalities. Anchorage is officially the Municipality of Anchorage (FIPS 02020). This statewide service also covers Fairbanks North Star Borough, Matanuska-Susitna Borough, and other AK jurisdictions via the local_gov field. Coverage and completeness vary by participating jurisdiction."
+    }
+  ]
+}