@urbankitstudio/atlas 0.9.5 → 0.9.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,88 @@
1
1
  # @urbankitstudio/atlas Changelog
2
2
 
3
+ ## 0.9.7 (2026-11-15)
4
+
5
+ A field can now declare an opt-in role, and Dooly County, Georgia, is the first record that declares any. `totals`
6
+ stay at 546 counties, 522 endpoints and 494 counties with an endpoint. **Additive.** `SearchField` gains an
7
+ optional key and the type `SearchFieldRole` is exported. Nothing is removed or renamed, and code written against
8
+ 0.9.6 reads every record exactly as before: it reads Dooly's `address1` and `stdirect` as the plain columns they
9
+ were.
10
+
11
+ - **`SearchField.role`** (type `SearchFieldRole`, optional): a role the column plays beside the ones its name and
12
+ label suggest. Read every other column as you would without it. At most one field per role on an endpoint, and
13
+ never on an endpoint with an `ownerJoin`.
14
+ - `"mailing-fallback"`: a second owner-mailing line. Read it ONLY when the endpoint's primary mailing column is
15
+ blank or a placeholder such as "N/A" (never when the primary is masked, like `"*, *, * #####"`,
16
+ `"#####-####"`, `"(***)"` or `"#, #, #"`: no letter or digit outside one trailing ZIP, and an asterisk, two or
17
+ more "#" or a mask glyph such as a bullet or a block; never when it is withheld from you; a lone "#", "-",
18
+ "?", "." or "~" is no mask), and ONLY when the value, invisible characters ignored, is a mailing line: a whole
19
+ house number then a word (`"123 MAIN ST"`, `"123 1/2 MAIN ST"`; not `"1/2 INT ..."`, not numbers only), a P O
20
+ Box or P O Drawer with its number (`"P O BOX 77"`, `"PO BOX 77"`, `"POST OFFICE BOX 77"`), or a rural route
21
+ box (`"RR 2 BOX 15"`, `"HC 63 BOX 1"`), with no owner-entity, share, c/o or attention word on it (LLC, INC,
22
+ INCORPORATED, CORP, CORPORATION, COMPANY, LTD, LP, LLP, TRUST, TRUSTEE(S), ESTATE, HEIRS, ET AL, ET UX, INT,
23
+ INTEREST, OWNER(S), PERCENT, PER CENT, PCT, "%", "1 OF 2", C/O, C\O, C/0, CARE OF, ATTN, ATTENTION) and no
24
+ word that says a value is withheld (CONFIDENTIAL, REDACTED, WITHHELD, PROTECTED, SUPPRESSED, RESTRICTED, NOT
25
+ DISCLOSED). The words are read after Unicode NFKC and split on anything that is not a letter or digit (a
26
+ control or zero-width character too), with a run of single letters as one word, so `"L.L.C."`, `"L L C"`, a
27
+ fullwidth LLC and an LLC behind a NUL are LLC. A spelled-out entity word directly before a street suffix is
28
+ part of a street name (`"123 ESTATE DR"`, `"40 TRUST RD"`, `"9 COMPANY ST"`) only when nothing follows the
29
+ suffix, or only one unit word (APT, UNIT, STE, SUITE, FL, FLOOR, RM, ROOM) and its value, a letter or up to
30
+ four digits or the two together (`"123 ESTATE DR APT 5"`); after any other tail it is the owner's (`"100 TEST
31
+ FAMILY TRUST ST LOUIS MO"`, `"5 TEST TRUST CT 06001"`, `"7 TEST ESTATE PT 2"`, `"123 TEST ESTATE DR N"`).
32
+ Bare CO is no entity word (`"123 CO RD 45"`). A c/o line or a second owner name is not the address. A county
33
+ redaction marker on the fallback line ("CONFIDENTIAL") withholds the whole row, owner included, whatever the
34
+ primary holds, as one in the primary would.
35
+ - `"situs-directional"`: the directional of a site address split into a house-number column and a street-name
36
+ column. Compose the address as house number, directional, street name, using the value only when it is a
37
+ direction (N, S, E, W, NE, NW, SE, SW, or the word spelled out), and never into a house number and street
38
+ that are a redaction marker ("0 CONFIDENTIAL" stays as it is, and the row is withheld). A redaction marker in
39
+ the directional column itself withholds the whole row. Only on a column whose name or label names a
40
+ direction ("dir", "direction" or "directional" as a word of its own, a pre, post, st or suf prefix allowed:
41
+ `PRE_DIR`, "Street Direction"; not `DIRECTOR` or "Direct Bill Flag"), and never on one that reads as the
42
+ owner, the parcel id, a mailing column, the house number, the street name, or a unit or suffix.
43
+ - **Dooly County, Georgia** (`ga-dooly`): `address1` is the `"mailing-fallback"` for `address2`, and `stdirect` is
44
+ the `"situs-directional"`. On 1,255 parcels `address2` is blank and `address1` holds the line (1,053 start with a
45
+ digit, 194 are P O Boxes, 2 are c/o lines and 6 are something else), and 1,247 of them are mailing lines under
46
+ the rule above (every digit-led line and every P O Box); 686 parcels carry a directional, one of them a "Q" that
47
+ is not a direction. The record's notes say the same.
48
+
49
+ For an agent: on `ga-dooly`, when `address2` is blank, read `address1` under the rule above before you report the
50
+ owner's mailing address as missing, and put `stdirect` between `house_no` and `street_nam` when you show or match
51
+ a site address.
52
+
53
+ Billing on the hosted paid paths (enrich, bulk, MCP `enrich_address`, `radius_owners`): a Dooly row whose mailing
54
+ address comes from `address1` bills as delivered, 1 unit, also where its owner is blank or a county "update in
55
+ progress" notice (before, such a row billed 0: a parcel-only row, or a refunded source-updating row). A row
56
+ withheld on a redaction marker in `address1` or in `stdirect` bills 0. A geocoded address carrying the directional
57
+ can now match a Dooly parcel exactly, and bills as any exact match does. Some rows that bill 0 before and after
58
+ change only their reason: a refunded source-updating row is now a withheld parcel-only row where a marker in
59
+ `address1` or `stdirect` withholds it, where its fallback fills the mailing beside a marker site, or where the
60
+ directional resolves a decline to a withheld parcel; a decline that the directional now resolves to a withheld or
61
+ owner-blank parcel is now that parcel-only row; and an owner-blank parcel-only row withheld on a marker in
62
+ `address1` or `stdirect` now reads as withheld (`parcel-only-owner-unavailable`, not `parcel-only-owner-blank`).
63
+ On `radius_owners`, a Dooly row with a blank parcel id and no object id is deduplicated on its owner, mailing and
64
+ site, which now carry the fallback and the directional, so two such rows that read alike before can count as two.
65
+
66
+ ## 0.9.6 (2026-11-15)
67
+
68
+ Dooly County, Georgia, which a user searched for, joins the atlas with an endpoint. `totals.counties` moves from
69
+ 545 to 546, `totals.endpoints` from 521 to 522 and `totals.countiesWithEndpoint` from 493 to 494. **Patch.** Data
70
+ only: no type, function or field of the package changed.
71
+
72
+ - **Dooly County, Georgia** (`ga-dooly`, FIPS 13093), on the county's own ArcGIS Online feature service
73
+ (`https://services9.arcgis.com/x9uoDq5JB3OouaRv/arcgis/rest/services/Parcel_Regions_w_WinGAP/FeatureServer/0`),
74
+ the standard WinGAP export that joins the tax roll to the parcel polygons: 7,344 parcels, last edited 2026-11-05.
75
+ The owner is `lastname`, which holds the whole owner string. There is no combined site-address column: the
76
+ situs is `house_no` (an integer) plus `street_nam`, listed as a house-number and street-name pair, with
77
+ `stdirect`, `sttype`, `extension` and `unit` beside them. The owner mailing address is `address2` (the street on
78
+ most rows), `address1` (a c/o line, or the street when `address2` is blank), `address3`, `city`, `state` and
79
+ `zip_code`. `Parcel_No` is a fixed-width id padded with spaces, so query its parts exactly (`Map`, `Block`,
80
+ `Parcel` and `SubParcel`) or match the full padded value. `license` is `unknown`: the item publishes no licence text, and the
81
+ county's Terms of Use say only that public records are available for reuse consistent with Georgia law.
82
+
83
+ For an agent: `findCountyByFips("13093")` used to return `undefined`; it now returns this record. Trim string
84
+ values: the layer pads them to the column width.
85
+
3
86
  ## 0.9.5 (2026-11-14)
4
87
 
5
88
  Three counties people searched for join the atlas. St. Mary's County, Maryland, has an endpoint; Plymouth County,
package/README.md CHANGED
@@ -393,6 +393,57 @@ const endpoint = findCountyByFips("17089")!.endpoints[0];
393
393
  const outFields = endpoint.searchFields.map(queryFieldName).join(",");
394
394
  ```
395
395
 
396
+ A `SearchField` may also carry `role` (type `SearchFieldRole`, since 0.9.7), an
397
+ opt-in role beside the ones its name and label suggest. Dooly County, Georgia
398
+ (`ga-dooly`) is the only record that declares any:
399
+
400
+ - `"mailing-fallback"` (Dooly's `address1`): a second owner-mailing line. Read
401
+ it only when the primary mailing column (Dooly's `address2`) is blank or a
402
+ placeholder such as "N/A", never when the primary is masked (an asterisk,
403
+ two or more "#" or a mask glyph, and no letter or digit outside a ZIP) or
404
+ was withheld, and only when the value is a mailing line: a whole house
405
+ number then a word, a P O Box or Drawer with its number, or a rural route
406
+ box, with no owner-entity, share, c/o or attention word on it (LLC, CORP,
407
+ COMPANY, TRUST, TRUSTEE, ESTATE, HEIRS, ET AL, ET UX, INT, OWNERS, PERCENT,
408
+ PCT, "1 OF 2", C/O, C\O, C/0, CARE OF, ATTN, ATTENTION and the like) and no
409
+ word that says a value is withheld (CONFIDENTIAL, REDACTED and the like).
410
+ Read the words after NFKC, split on anything that is not a letter or digit,
411
+ with a run of single letters as one word ("L.L.C." is LLC). A spelled-out
412
+ entity word directly before a street suffix is part of a street name
413
+ ("123 ESTATE DR", "40 TRUST RD") only when nothing follows the suffix, or
414
+ only a unit word and its value ("123 ESTATE DR APT 5"); after anything else
415
+ it is the owner's ("100 TEST FAMILY TRUST ST LOUIS MO", "5 TEST TRUST CT
416
+ 06001"). Bare CO is a county road ("123 CO RD 45"). A c/o line or a second
417
+ owner name on that line is not the address. A redaction marker on the
418
+ fallback line ("CONFIDENTIAL") withholds the whole row, whatever the primary
419
+ holds.
420
+ - `"situs-directional"` (Dooly's `stdirect`): the directional of a site address
421
+ split into house-number and street-name columns. Compose it between the two
422
+ when it is a direction (N, S, E, W, NE, NW, SE, SW, or spelled out), but
423
+ never into a house number and street that are a redaction marker
424
+ ("0 CONFIDENTIAL" stays as it is). A redaction marker in the directional
425
+ column itself withholds the whole row. Tag only a column whose name or label
426
+ names a direction ("dir", "direction" or "directional" as a word of its own,
427
+ a pre, post, st or suf prefix allowed; not DIRECTOR), never one that reads as
428
+ the owner, the parcel id, a mailing column, the house number, the street
429
+ name, or a unit or suffix.
430
+
431
+ Every other column reads as it would without the tag.
432
+
433
+ Billing on the hosted paid paths moves only on Dooly: a row whose mailing
434
+ address comes from the fallback bills like any delivered row; a row withheld
435
+ on a marker in the fallback or the directional bills 0; a geocoded address
436
+ carrying the directional can match exactly. Some unbilled rows change only
437
+ their reason (a refunded "source-updating" row that a marker in the fallback
438
+ or the directional withholds, or whose fallback fills beside a marker site, or
439
+ that the directional resolves to a withheld parcel, now reads as a withheld
440
+ parcel-only row; a decline the directional now resolves to a withheld or
441
+ owner-blank parcel reads as that parcel-only row; an owner-blank row withheld
442
+ on a marker in the fallback or the directional reads as withheld, not
443
+ owner-blank), and on `radius_owners` a row with a blank parcel id and no object
444
+ id is told apart from another by its composed site and fallback mailing, so two
445
+ such rows can now count as two.
446
+
396
447
  ## `addedAt` is the one date that never moves
397
448
 
398
449
  A county may carry `addedAt` (YYYY-MM-DD): the date it entered the atlas. It is
@@ -404,9 +455,9 @@ read `addedAt` and fall back to the oldest `lastVerified` only when it is absent
404
455
 
405
456
  ## Coverage today
406
457
 
407
- The atlas bundles **545 counties across all 50 US states and DC** (521 verified endpoints), covering the largest counties in each state, every county in Mississippi and all 100 of North Carolina's. Call `listStates()` to enumerate the full set.
458
+ The atlas bundles **546 counties across all 50 US states and DC** (522 verified endpoints), covering the largest counties in each state, every county in Mississippi and all 100 of North Carolina's. Call `listStates()` to enumerate the full set.
408
459
 
409
- Every state has at least one county on record, and 493 of the 545 carry a verified endpoint. The other 52 have `hasPublicRest: false` and an empty `endpoints` array, with a `coverage` block that gives the reason code and one sentence to show as is, `notes` with the detail, and a `contact` for the county office (its `department`, `url` and, where the county publishes one, `email`). The reasons vary. A county sells its owner data, runs no public query service, puts one behind a login or under terms that bar us from serving it, publishes a layer without owner names or with them blank, or runs a service that is down, stale or technically unusable. They ship rather than being omitted, so `findCounty()` still resolves them, and `coverageAnswer()` turns any of them into the answer the hosted MCP server and the REST API give. **Check `hasPublicRest`** rather than assuming every county has an endpoint; `totals.countiesWithEndpoint` gives the queryable count directly.
460
+ Every state has at least one county on record, and 494 of the 546 carry a verified endpoint. The other 52 have `hasPublicRest: false` and an empty `endpoints` array, with a `coverage` block that gives the reason code and one sentence to show as is, `notes` with the detail, and a `contact` for the county office (its `department`, `url` and, where the county publishes one, `email`). The reasons vary. A county sells its owner data, runs no public query service, puts one behind a login or under terms that bar us from serving it, publishes a layer without owner names or with them blank, or runs a service that is down, stale or technically unusable. They ship rather than being omitted, so `findCounty()` still resolves them, and `coverageAnswer()` turns any of them into the answer the hosted MCP server and the REST API give. **Check `hasPublicRest`** rather than assuming every county has an endpoint; `totals.countiesWithEndpoint` gives the queryable count directly.
410
461
 
411
462
  The city registries cover 30 cities with code-violation or building-permit datasets, 19 with zoning-case datasets. Call `listCities()` for the current set.
412
463
 
package/data/georgia.json CHANGED
@@ -2,7 +2,7 @@
2
2
  "stateSlug": "georgia",
3
3
  "stateName": "Georgia",
4
4
  "stateAbbrev": "GA",
5
- "lastUpdated": "2026-11-10",
5
+ "lastUpdated": "2026-11-15",
6
6
  "counties": [
7
7
  {
8
8
  "id": "ga-fulton",
@@ -510,6 +510,60 @@
510
510
  "summary": "Spalding County's public parcel layer has parcel ids but no owner names or mailing addresses, so we don't index it. The Tax Assessor's property search shows owners one parcel at a time. Request it and we'll tell you if that changes.",
511
511
  "checked": "2026-11-10"
512
512
  }
513
+ },
514
+ {
515
+ "id": "ga-dooly",
516
+ "state": "GA",
517
+ "stateName": "Georgia",
518
+ "stateSlug": "georgia",
519
+ "county": "Dooly",
520
+ "countySlug": "dooly-county",
521
+ "countyFips": "13093",
522
+ "hasPublicRest": true,
523
+ "endpoints": [
524
+ {
525
+ "url": "https://services9.arcgis.com/x9uoDq5JB3OouaRv/arcgis/rest/services/Parcel_Regions_w_WinGAP/FeatureServer/0",
526
+ "serviceType": "FeatureServer",
527
+ "layerIndex": 0,
528
+ "layerName": "Parcel_Regions_w_WinGAP",
529
+ "supportsQuery": true,
530
+ "corsEnabled": true,
531
+ "searchFields": [
532
+ { "name": "Parcel_No", "label": "Parcel ID", "searchable": true },
533
+ { "name": "lastname", "label": "Owner Name", "searchable": true },
534
+ { "name": "house_no", "label": "House Number", "searchable": true },
535
+ { "name": "street_nam", "label": "Street Name", "searchable": true },
536
+ { "name": "stdirect", "label": "Street Direction", "searchable": false, "role": "situs-directional" },
537
+ { "name": "sttype", "label": "Street Type", "searchable": false },
538
+ { "name": "extension", "label": "House Number Suffix", "searchable": false },
539
+ { "name": "unit", "label": "Unit", "searchable": false },
540
+ { "name": "address2", "label": "Owner Mailing Address", "searchable": true },
541
+ { "name": "address1", "label": "Owner Mailing Line 1 (c/o or street)", "searchable": false, "role": "mailing-fallback" },
542
+ { "name": "address3", "label": "Owner Mailing Line 3", "searchable": false },
543
+ { "name": "city", "label": "Owner Mailing City", "searchable": true },
544
+ { "name": "state", "label": "Owner Mailing State", "searchable": false },
545
+ { "name": "zip_code", "label": "Owner Mailing ZIP", "searchable": false },
546
+ { "name": "Realkey", "label": "CAMA Account Key (Realkey)", "searchable": false },
547
+ { "name": "totalacres", "label": "Total Acres", "searchable": false },
548
+ { "name": "digclass", "label": "Property Class", "searchable": false },
549
+ { "name": "zoningcode", "label": "Zoning Code", "searchable": false },
550
+ { "name": "curr_val", "label": "Current Value", "searchable": false }
551
+ ],
552
+ "sampleQuery": "https://services9.arcgis.com/x9uoDq5JB3OouaRv/arcgis/rest/services/Parcel_Regions_w_WinGAP/FeatureServer/0/query?where=UPPER(lastname)+LIKE+UPPER('%25SMITH%25')&outFields=Parcel_No,lastname,house_no,street_nam,sttype,address1,address2,city,state,zip_code&returnGeometry=false&f=json&resultRecordCount=10",
553
+ "license": "unknown",
554
+ "licenseUrl": "https://www.arcgis.com/home/item.html?id=1f883189ff944f74b71e8748c39a2d0d",
555
+ "status": "live",
556
+ "lastVerified": "2026-11-15",
557
+ "verifiedBy": "manual"
558
+ }
559
+ ],
560
+ "contact": {
561
+ "department": "Dooly County Board of Tax Assessors, Vienna GA",
562
+ "url": "https://qpublic.schneidercorp.com/Application.aspx?App=doolyCountyGA",
563
+ "email": null
564
+ },
565
+ "notes": "Dooly County, Georgia (county seat Vienna; FIPS 13093). Served by the county's own ArcGIS Online organisation (the one that also publishes the county's 911 addresses, voting districts and zoning layers): feature service Parcel_Regions_w_WinGAP, item 1f883189ff944f74b71e8748c39a2d0d, public, the standard WinGAP parcel export that joins the tax roll to the parcel polygons. Read 2026-11-15: 7,344 parcels, layer last edited 2026-11-05; lastname (the whole owner string, despite the column name) is non-blank on 7,324; firstname and middle are blank on all but a handful of rows and are not listed; UPPER(lastname) LIKE '%SMITH%' returns 143, the sample query's predicate. SITUS is split across columns with no combined situs column: house_no (an integer, 0 where the parcel has no number) and street_nam, with the directional in stdirect, the suffix in sttype and a house-number suffix and unit in extension and unit; the house number and street name are listed as the composite pair (as Hennepin MN's HOUSE_NO and STREET_NM are), and stdirect is declared the pair's directional (role situs-directional, atlas 0.9.7): 686 parcels carry one (E 254, N 196, W 134, S 101, and one Q, which is not a direction and is ignored), and the site address reads house_no, stdirect, street_nam. The owner MAILING address is spread over address1, address2 and address3 plus city, state and zip_code: address2 holds the street or P O Box on most rows (6,023), address1 holds a c/o or second-name line, or the street when address2 is blank (2,373 rows non-blank), so read all three. The record's mailing column is address2, and address1 is its declared fallback (role mailing-fallback, atlas 0.9.7), read only when address2 is blank: on the 1,255 rows whose street or P O Box sits in address1 alone (address2 blank), address1 is read only when it is a mailing line (a whole house number then a word, a P O Box or Drawer with its number, or a rural route box, with no owner-entity, share, c/o, attention or withheld word such as LLC, COMPANY, TRUSTEE, HEIRS, ET AL, INT, C/O, CARE OF, ATTN, ATTENTION, CONFIDENTIAL or 1 OF 2, however it is spelled, where an entity word directly before a street suffix is part of the street name when nothing but a unit and its number follows the suffix): 1,053 start with a digit and 194 are P O Boxes, and on 2026-11-15 1,247 of them are read, while 8 stay blank (the 2 c/o lines and 6 other values). A redaction marker in address1 or in stdirect withholds the row whatever address2 holds; none does on 2026-11-15. PARCEL ID: Parcel_No is a fixed-width string padded with spaces, the map, block and parcel in fixed columns (' 23 25' is map 23 parcel 25; 'U 5 1 1' is map U5 block 1 parcel 1). The id typed with single spaces ('23 25') matches nothing, and a LIKE with % between the parts can match more than one parcel (Parcel_No LIKE 'U 5%1%1' matched 2 on 2026-11-15), so query the parts exactly (Map = 'U5' AND Block = '1' AND Parcel = '1', with SubParcel for a lettered split) or match the full padded value. Realkey is the integer CAMA key, and qPub_Link deep-links each row's report on the county's qPublic site. String columns are padded, so trim the values. Capabilities Query only, maxRecordCount 2000 with pagination, WKID 102100, CORS open (Access-Control-Allow-Origin *). No row carries the no_release withhold flag. EXEMPTION COLUMN, NOT LISTED: homeexempt holds the homestead exemption codes. NOT USED: the regional commission's Dooly_County_Parcels layer, whose data is from 2022. TERMS: the ArcGIS Online item carries no licence, access or description text, and the county's Terms of Use (doolycountyga.gov/terms) say only that public records and government works are available for reuse consistent with Georgia law; no limit on sale or commercial use was found.",
566
+ "addedAt": "2026-11-15"
513
567
  }
514
568
  ]
515
569
  }
package/data/index.json CHANGED
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "version": "0.3.0",
3
- "lastUpdated": "2026-11-14",
3
+ "lastUpdated": "2026-11-15",
4
4
  "totals": {
5
5
  "states": 51,
6
- "counties": 545,
7
- "endpoints": 521,
8
- "countiesWithEndpoint": 493,
6
+ "counties": 546,
7
+ "endpoints": 522,
8
+ "countiesWithEndpoint": 494,
9
9
  "countiesUnprobeable": 1
10
10
  },
11
11
  "states": [
@@ -93,8 +93,8 @@
93
93
  "slug": "georgia",
94
94
  "name": "Georgia",
95
95
  "abbrev": "GA",
96
- "countyCount": 9,
97
- "endpointCount": 6,
96
+ "countyCount": 10,
97
+ "endpointCount": 7,
98
98
  "populated": true
99
99
  },
100
100
  {
package/dist/index.cjs CHANGED
@@ -398,12 +398,12 @@ function countyDownMessage(countyName) {
398
398
  // data/index.json
399
399
  var data_default = {
400
400
  version: "0.3.0",
401
- lastUpdated: "2026-11-14",
401
+ lastUpdated: "2026-11-15",
402
402
  totals: {
403
403
  states: 51,
404
- counties: 545,
405
- endpoints: 521,
406
- countiesWithEndpoint: 493,
404
+ counties: 546,
405
+ endpoints: 522,
406
+ countiesWithEndpoint: 494,
407
407
  countiesUnprobeable: 1
408
408
  },
409
409
  states: [
@@ -491,8 +491,8 @@ var data_default = {
491
491
  slug: "georgia",
492
492
  name: "Georgia",
493
493
  abbrev: "GA",
494
- countyCount: 9,
495
- endpointCount: 6,
494
+ countyCount: 10,
495
+ endpointCount: 7,
496
496
  populated: true
497
497
  },
498
498
  {
@@ -15736,7 +15736,7 @@ var georgia_default = {
15736
15736
  stateSlug: "georgia",
15737
15737
  stateName: "Georgia",
15738
15738
  stateAbbrev: "GA",
15739
- lastUpdated: "2026-11-10",
15739
+ lastUpdated: "2026-11-15",
15740
15740
  counties: [
15741
15741
  {
15742
15742
  id: "ga-fulton",
@@ -16244,6 +16244,60 @@ var georgia_default = {
16244
16244
  summary: "Spalding County's public parcel layer has parcel ids but no owner names or mailing addresses, so we don't index it. The Tax Assessor's property search shows owners one parcel at a time. Request it and we'll tell you if that changes.",
16245
16245
  checked: "2026-11-10"
16246
16246
  }
16247
+ },
16248
+ {
16249
+ id: "ga-dooly",
16250
+ state: "GA",
16251
+ stateName: "Georgia",
16252
+ stateSlug: "georgia",
16253
+ county: "Dooly",
16254
+ countySlug: "dooly-county",
16255
+ countyFips: "13093",
16256
+ hasPublicRest: true,
16257
+ endpoints: [
16258
+ {
16259
+ url: "https://services9.arcgis.com/x9uoDq5JB3OouaRv/arcgis/rest/services/Parcel_Regions_w_WinGAP/FeatureServer/0",
16260
+ serviceType: "FeatureServer",
16261
+ layerIndex: 0,
16262
+ layerName: "Parcel_Regions_w_WinGAP",
16263
+ supportsQuery: true,
16264
+ corsEnabled: true,
16265
+ searchFields: [
16266
+ { name: "Parcel_No", label: "Parcel ID", searchable: true },
16267
+ { name: "lastname", label: "Owner Name", searchable: true },
16268
+ { name: "house_no", label: "House Number", searchable: true },
16269
+ { name: "street_nam", label: "Street Name", searchable: true },
16270
+ { name: "stdirect", label: "Street Direction", searchable: false, role: "situs-directional" },
16271
+ { name: "sttype", label: "Street Type", searchable: false },
16272
+ { name: "extension", label: "House Number Suffix", searchable: false },
16273
+ { name: "unit", label: "Unit", searchable: false },
16274
+ { name: "address2", label: "Owner Mailing Address", searchable: true },
16275
+ { name: "address1", label: "Owner Mailing Line 1 (c/o or street)", searchable: false, role: "mailing-fallback" },
16276
+ { name: "address3", label: "Owner Mailing Line 3", searchable: false },
16277
+ { name: "city", label: "Owner Mailing City", searchable: true },
16278
+ { name: "state", label: "Owner Mailing State", searchable: false },
16279
+ { name: "zip_code", label: "Owner Mailing ZIP", searchable: false },
16280
+ { name: "Realkey", label: "CAMA Account Key (Realkey)", searchable: false },
16281
+ { name: "totalacres", label: "Total Acres", searchable: false },
16282
+ { name: "digclass", label: "Property Class", searchable: false },
16283
+ { name: "zoningcode", label: "Zoning Code", searchable: false },
16284
+ { name: "curr_val", label: "Current Value", searchable: false }
16285
+ ],
16286
+ sampleQuery: "https://services9.arcgis.com/x9uoDq5JB3OouaRv/arcgis/rest/services/Parcel_Regions_w_WinGAP/FeatureServer/0/query?where=UPPER(lastname)+LIKE+UPPER('%25SMITH%25')&outFields=Parcel_No,lastname,house_no,street_nam,sttype,address1,address2,city,state,zip_code&returnGeometry=false&f=json&resultRecordCount=10",
16287
+ license: "unknown",
16288
+ licenseUrl: "https://www.arcgis.com/home/item.html?id=1f883189ff944f74b71e8748c39a2d0d",
16289
+ status: "live",
16290
+ lastVerified: "2026-11-15",
16291
+ verifiedBy: "manual"
16292
+ }
16293
+ ],
16294
+ contact: {
16295
+ department: "Dooly County Board of Tax Assessors, Vienna GA",
16296
+ url: "https://qpublic.schneidercorp.com/Application.aspx?App=doolyCountyGA",
16297
+ email: null
16298
+ },
16299
+ notes: "Dooly County, Georgia (county seat Vienna; FIPS 13093). Served by the county's own ArcGIS Online organisation (the one that also publishes the county's 911 addresses, voting districts and zoning layers): feature service Parcel_Regions_w_WinGAP, item 1f883189ff944f74b71e8748c39a2d0d, public, the standard WinGAP parcel export that joins the tax roll to the parcel polygons. Read 2026-11-15: 7,344 parcels, layer last edited 2026-11-05; lastname (the whole owner string, despite the column name) is non-blank on 7,324; firstname and middle are blank on all but a handful of rows and are not listed; UPPER(lastname) LIKE '%SMITH%' returns 143, the sample query's predicate. SITUS is split across columns with no combined situs column: house_no (an integer, 0 where the parcel has no number) and street_nam, with the directional in stdirect, the suffix in sttype and a house-number suffix and unit in extension and unit; the house number and street name are listed as the composite pair (as Hennepin MN's HOUSE_NO and STREET_NM are), and stdirect is declared the pair's directional (role situs-directional, atlas 0.9.7): 686 parcels carry one (E 254, N 196, W 134, S 101, and one Q, which is not a direction and is ignored), and the site address reads house_no, stdirect, street_nam. The owner MAILING address is spread over address1, address2 and address3 plus city, state and zip_code: address2 holds the street or P O Box on most rows (6,023), address1 holds a c/o or second-name line, or the street when address2 is blank (2,373 rows non-blank), so read all three. The record's mailing column is address2, and address1 is its declared fallback (role mailing-fallback, atlas 0.9.7), read only when address2 is blank: on the 1,255 rows whose street or P O Box sits in address1 alone (address2 blank), address1 is read only when it is a mailing line (a whole house number then a word, a P O Box or Drawer with its number, or a rural route box, with no owner-entity, share, c/o, attention or withheld word such as LLC, COMPANY, TRUSTEE, HEIRS, ET AL, INT, C/O, CARE OF, ATTN, ATTENTION, CONFIDENTIAL or 1 OF 2, however it is spelled, where an entity word directly before a street suffix is part of the street name when nothing but a unit and its number follows the suffix): 1,053 start with a digit and 194 are P O Boxes, and on 2026-11-15 1,247 of them are read, while 8 stay blank (the 2 c/o lines and 6 other values). A redaction marker in address1 or in stdirect withholds the row whatever address2 holds; none does on 2026-11-15. PARCEL ID: Parcel_No is a fixed-width string padded with spaces, the map, block and parcel in fixed columns (' 23 25' is map 23 parcel 25; 'U 5 1 1' is map U5 block 1 parcel 1). The id typed with single spaces ('23 25') matches nothing, and a LIKE with % between the parts can match more than one parcel (Parcel_No LIKE 'U 5%1%1' matched 2 on 2026-11-15), so query the parts exactly (Map = 'U5' AND Block = '1' AND Parcel = '1', with SubParcel for a lettered split) or match the full padded value. Realkey is the integer CAMA key, and qPub_Link deep-links each row's report on the county's qPublic site. String columns are padded, so trim the values. Capabilities Query only, maxRecordCount 2000 with pagination, WKID 102100, CORS open (Access-Control-Allow-Origin *). No row carries the no_release withhold flag. EXEMPTION COLUMN, NOT LISTED: homeexempt holds the homestead exemption codes. NOT USED: the regional commission's Dooly_County_Parcels layer, whose data is from 2022. TERMS: the ArcGIS Online item carries no licence, access or description text, and the county's Terms of Use (doolycountyga.gov/terms) say only that public records and government works are available for reuse consistent with Georgia law; no limit on sale or commercial use was found.",
16300
+ addedAt: "2026-11-15"
16247
16301
  }
16248
16302
  ]
16249
16303
  };
package/dist/index.d.cts CHANGED
@@ -212,7 +212,73 @@ interface SearchField {
212
212
  * right when a record does carry one.
213
213
  */
214
214
  wireName?: string;
215
+ /**
216
+ * An opt-in role the column plays. Absent on almost every field; since 0.9.7
217
+ * Dooly County, Georgia (`ga-dooly`) is the first record that declares any.
218
+ * A tag adds a role: read every other column as you would without it.
219
+ *
220
+ * - `"mailing-fallback"`: a second owner-mailing line. Read it ONLY when the
221
+ * endpoint's primary mailing column holds nothing (a blank cell, or a
222
+ * placeholder such as "N/A"; never when the primary is masked, like
223
+ * `"*, *, * #####"`, `"#####-####"`, `"(***)"` or `"#, #, #"`: no letter
224
+ * or digit outside one trailing ZIP, and an asterisk, two or more "#", or a
225
+ * mask glyph such as a bullet or a block; nor when it was withheld from
226
+ * you; a lone "#", "-", "?", "." or "~" is no mask), and ONLY
227
+ * when the value, with invisible characters ignored, is a mailing line: a
228
+ * whole house number then a word (`"123 MAIN ST"`, `"123 1/2 MAIN ST"`;
229
+ * not `"1/2 INT ..."`, not numbers only), a P O Box or P O Drawer with its
230
+ * number (`"P O BOX 77"`, `"PO BOX 77"`, `"POST OFFICE BOX 77"`), or a
231
+ * rural route box (`"RR 2 BOX 15"`, `"HC 63 BOX 1"`), and carries no
232
+ * owner-entity, share, c/o or attention word (LLC, INC, INCORPORATED,
233
+ * CORP, CORPORATION, COMPANY, LTD, LP, LLP, TRUST, TRUSTEE(S), ESTATE,
234
+ * HEIRS, ET AL, ET UX, INT, INTEREST, OWNER(S), PERCENT, PER CENT, PCT,
235
+ * "%", "1 OF 2", C/O, C\O, C/0, CARE OF, ATTN, ATTENTION) and no word
236
+ * that says a value is withheld
237
+ * (CONFIDENTIAL, REDACTED, WITHHELD, PROTECTED, SUPPRESSED, RESTRICTED,
238
+ * NOT DISCLOSED). Read the words after Unicode NFKC, split on anything
239
+ * that is not a letter or digit (a control or zero-width character too),
240
+ * with a run of single letters as one word ("L.L.C." is LLC). One
241
+ * exception: a spelled-out entity word (INCORPORATED, CORPORATION,
242
+ * COMPANY, TRUST, TRUSTEE(S), ESTATE, HEIRS) directly before a street
243
+ * suffix is part of a street name (`"123 ESTATE DR"`, `"40 TRUST RD"`)
244
+ * only when nothing follows the suffix, or only one unit word (APT, UNIT,
245
+ * STE, SUITE, FL, FLOOR, RM, ROOM) and its value, a letter or up to four
246
+ * digits or the two together (`"123 ESTATE DR APT 5"`); after any other
247
+ * tail it is the owner's (`"100 TEST FAMILY TRUST ST LOUIS MO"`,
248
+ * `"5 TEST TRUST CT 06001"`, `"7 TEST ESTATE PT 2"`). Bare CO is no entity
249
+ * word (`"123 CO RD 45"`). Anything else on that
250
+ * line (a c/o line, a second owner name) is not the address.
251
+ * A county REDACTION MARKER on the fallback line ("CONFIDENTIAL",
252
+ * "REDACTED PER KRS 61.878") withholds the whole row, owner included,
253
+ * whatever the primary holds, exactly as one in the primary would.
254
+ * Dooly's primary is `address2`; `address1` is its fallback.
255
+ * - `"situs-directional"`: the street directional of a split site address
256
+ * (house number + street name columns, no single address column). Compose
257
+ * the site address as house number, directional, street name, and use the
258
+ * value only when it is a direction (N, S, E, W, NE, NW, SE, SW, or the
259
+ * word spelled out); Dooly's `stdirect` holds one "Q" that is not. Never
260
+ * compose it into a house number and street that together are a
261
+ * redaction marker ("0 CONFIDENTIAL" stays as it is, and the row is
262
+ * withheld). A redaction marker in the directional column itself
263
+ * ("CONFIDENTIAL") withholds the whole row. The tagged column is never
264
+ * itself the house number, the street name, the owner, the parcel id, a
265
+ * mailing column or a unit or suffix qualifier, and its name or label
266
+ * names a direction ("dir", "direction" or "directional" as a word of
267
+ * its own, a pre, post, st or suf prefix allowed: `PRE_DIR`, "Street
268
+ * Direction"; not `DIRECTOR` or "Direct Bill Flag"). A geocoded address without
269
+ * the directional still names the parcel when only one parcel at that
270
+ * number shares the street name; with it, the directional counts only
271
+ * beside a shared street-name word that is not itself a direction, and a
272
+ * parcel it alone singles out does not win over one at the same number
273
+ * and street whose directional is blank.
274
+ *
275
+ * At most one field per role on an endpoint, and never on
276
+ * `ownerJoin.fields`.
277
+ */
278
+ role?: SearchFieldRole;
215
279
  }
280
+ /** The opt-in column roles a record may declare ({@link SearchField.role}). Since 0.9.7. */
281
+ type SearchFieldRole = "mailing-fallback" | "situs-directional";
216
282
  /**
217
283
  * Owner rows that live in a separate TABLE of the same service, joined to the
218
284
  * endpoint's parcel polygons by a key: the polygons carry `parcelKey`, the
@@ -1353,4 +1419,4 @@ declare function citiesForCounty(stateSlug: string, countySlug: string): CitySum
1353
1419
  declare const cityPropertyIndex: CityPropertyIndex;
1354
1420
  declare const cityZoningIndex: CityZoningIndex;
1355
1421
 
1356
- export { ACCESS_FLAGS, ACCESS_PRESETS, ACCESS_REASONS, ATLAS_COUNTY_PAGE_BASE, type AccessFlag, type AccessFlags, type AccessPageRef, type AccessPreset, type AccessReason, type AccessRecordLike, type Atlas, type AtlasIndex, CITY_RECORD_LIMIT, CITY_STREET_MAX_LEN, COUNTY_RECHECK_REQUEST_MESSAGE, COUNTY_REQUEST_MESSAGE, COUNTY_REQUEST_URL, COVERAGE_REASONS, type CapabilityBasis, type CapabilityBasisType, type CapabilityField, type CapabilityOverrides, type CapabilityStatus, type CaseFieldMap, type CasesSource, type CityDatasetDescriptor, type CityFilter, type CityKind, type CityLookup, type CityPropertyIndex, type CityPropertyIndexEntry, type CityPropertyRecord, type CityProvider, type CityQueryTemplate, type CitySource, type CitySummary, type CityZoningIndex, type CityZoningIndexEntry, type CityZoningRecord, type ConfidentialFlag, type ContactInfo, type CountyAccessEntry, type CountyAdvisory, type CountyCoverage, type CountyPausedAnswer, type CountyProduct, type CountyRecord, type CountyRequestHint, type CountyRequestRef, type CoverageAnswer, type CoverageReason, type CoverageRecordLike, type CoverageStatus, type CoverageTextInput, type CurrentZoningFieldMap, type CurrentZoningSource, type DatasetKind, type DeepLinkCounty, type EndpointPresenceLike, type EndpointRecord, type EndpointStatus, type GeocoderConfig, type GeocoderProvider, LIVE_STATUS_URL, type LicenseType, NOT_IN_ATLAS_WHY, NO_PUBLIC_DATA_WHY, type OwnerJoin, POINT_PLACEHOLDER, PRESET_FLAGS, type PropertyDataset, type PropertyDatasets, type PropertyFieldMap, type PropertySource, type PropertySourceType, type PropertyStatusBuckets, type SearchField, type ServiceType, type SplitStreet, type StateFile, type StateIndexEntry, type VerifiedBy, type ZoningByAddressSource, type ZoningSourceType, type ZoningStatusBuckets, type ZoningToolKind, accessBlocks, atlas, atlasIndex, buildCityQuery, buildParcelLookupDeepLink, canonicalLayerUrl, casesLocationTemplate, casesQueryUrl, citiesForCounty, citiesForCountyIn, cityDatasetDescriptors, cityDatasets, cityPath, cityPropertyIndex, cityZoningIndex, countyDownMessage, countyHasEndpoint, countyOffersAttributeSearch, countyPath, countySlugFromName, coverageAnswer, coverageAnswerText, coverageOverridesPause, currentZoningTemplate, findCity, findCityIn, findCounty, findCountyByFips, findState, flagsFor, getCityProperty, getCityZoning, isReviewedUnservable, listCities, listCountiesByState, listStates, mergeCityIndexes, offersAttributeSearch, offersPagination, pausedAnswer, pausedFlags, presetOf, propertyQueryUrl, queryFieldName, requestHint, reviewedCapability, slugify, splitAddressStreetName, splitStreet, statePath, streetForDataset };
1422
+ export { ACCESS_FLAGS, ACCESS_PRESETS, ACCESS_REASONS, ATLAS_COUNTY_PAGE_BASE, type AccessFlag, type AccessFlags, type AccessPageRef, type AccessPreset, type AccessReason, type AccessRecordLike, type Atlas, type AtlasIndex, CITY_RECORD_LIMIT, CITY_STREET_MAX_LEN, COUNTY_RECHECK_REQUEST_MESSAGE, COUNTY_REQUEST_MESSAGE, COUNTY_REQUEST_URL, COVERAGE_REASONS, type CapabilityBasis, type CapabilityBasisType, type CapabilityField, type CapabilityOverrides, type CapabilityStatus, type CaseFieldMap, type CasesSource, type CityDatasetDescriptor, type CityFilter, type CityKind, type CityLookup, type CityPropertyIndex, type CityPropertyIndexEntry, type CityPropertyRecord, type CityProvider, type CityQueryTemplate, type CitySource, type CitySummary, type CityZoningIndex, type CityZoningIndexEntry, type CityZoningRecord, type ConfidentialFlag, type ContactInfo, type CountyAccessEntry, type CountyAdvisory, type CountyCoverage, type CountyPausedAnswer, type CountyProduct, type CountyRecord, type CountyRequestHint, type CountyRequestRef, type CoverageAnswer, type CoverageReason, type CoverageRecordLike, type CoverageStatus, type CoverageTextInput, type CurrentZoningFieldMap, type CurrentZoningSource, type DatasetKind, type DeepLinkCounty, type EndpointPresenceLike, type EndpointRecord, type EndpointStatus, type GeocoderConfig, type GeocoderProvider, LIVE_STATUS_URL, type LicenseType, NOT_IN_ATLAS_WHY, NO_PUBLIC_DATA_WHY, type OwnerJoin, POINT_PLACEHOLDER, PRESET_FLAGS, type PropertyDataset, type PropertyDatasets, type PropertyFieldMap, type PropertySource, type PropertySourceType, type PropertyStatusBuckets, type SearchField, type SearchFieldRole, type ServiceType, type SplitStreet, type StateFile, type StateIndexEntry, type VerifiedBy, type ZoningByAddressSource, type ZoningSourceType, type ZoningStatusBuckets, type ZoningToolKind, accessBlocks, atlas, atlasIndex, buildCityQuery, buildParcelLookupDeepLink, canonicalLayerUrl, casesLocationTemplate, casesQueryUrl, citiesForCounty, citiesForCountyIn, cityDatasetDescriptors, cityDatasets, cityPath, cityPropertyIndex, cityZoningIndex, countyDownMessage, countyHasEndpoint, countyOffersAttributeSearch, countyPath, countySlugFromName, coverageAnswer, coverageAnswerText, coverageOverridesPause, currentZoningTemplate, findCity, findCityIn, findCounty, findCountyByFips, findState, flagsFor, getCityProperty, getCityZoning, isReviewedUnservable, listCities, listCountiesByState, listStates, mergeCityIndexes, offersAttributeSearch, offersPagination, pausedAnswer, pausedFlags, presetOf, propertyQueryUrl, queryFieldName, requestHint, reviewedCapability, slugify, splitAddressStreetName, splitStreet, statePath, streetForDataset };
package/dist/index.d.ts CHANGED
@@ -212,7 +212,73 @@ interface SearchField {
212
212
  * right when a record does carry one.
213
213
  */
214
214
  wireName?: string;
215
+ /**
216
+ * An opt-in role the column plays. Absent on almost every field; since 0.9.7
217
+ * Dooly County, Georgia (`ga-dooly`) is the first record that declares any.
218
+ * A tag adds a role: read every other column as you would without it.
219
+ *
220
+ * - `"mailing-fallback"`: a second owner-mailing line. Read it ONLY when the
221
+ * endpoint's primary mailing column holds nothing (a blank cell, or a
222
+ * placeholder such as "N/A"; never when the primary is masked, like
223
+ * `"*, *, * #####"`, `"#####-####"`, `"(***)"` or `"#, #, #"`: no letter
224
+ * or digit outside one trailing ZIP, and an asterisk, two or more "#", or a
225
+ * mask glyph such as a bullet or a block; nor when it was withheld from
226
+ * you; a lone "#", "-", "?", "." or "~" is no mask), and ONLY
227
+ * when the value, with invisible characters ignored, is a mailing line: a
228
+ * whole house number then a word (`"123 MAIN ST"`, `"123 1/2 MAIN ST"`;
229
+ * not `"1/2 INT ..."`, not numbers only), a P O Box or P O Drawer with its
230
+ * number (`"P O BOX 77"`, `"PO BOX 77"`, `"POST OFFICE BOX 77"`), or a
231
+ * rural route box (`"RR 2 BOX 15"`, `"HC 63 BOX 1"`), and carries no
232
+ * owner-entity, share, c/o or attention word (LLC, INC, INCORPORATED,
233
+ * CORP, CORPORATION, COMPANY, LTD, LP, LLP, TRUST, TRUSTEE(S), ESTATE,
234
+ * HEIRS, ET AL, ET UX, INT, INTEREST, OWNER(S), PERCENT, PER CENT, PCT,
235
+ * "%", "1 OF 2", C/O, C\O, C/0, CARE OF, ATTN, ATTENTION) and no word
236
+ * that says a value is withheld
237
+ * (CONFIDENTIAL, REDACTED, WITHHELD, PROTECTED, SUPPRESSED, RESTRICTED,
238
+ * NOT DISCLOSED). Read the words after Unicode NFKC, split on anything
239
+ * that is not a letter or digit (a control or zero-width character too),
240
+ * with a run of single letters as one word ("L.L.C." is LLC). One
241
+ * exception: a spelled-out entity word (INCORPORATED, CORPORATION,
242
+ * COMPANY, TRUST, TRUSTEE(S), ESTATE, HEIRS) directly before a street
243
+ * suffix is part of a street name (`"123 ESTATE DR"`, `"40 TRUST RD"`)
244
+ * only when nothing follows the suffix, or only one unit word (APT, UNIT,
245
+ * STE, SUITE, FL, FLOOR, RM, ROOM) and its value, a letter or up to four
246
+ * digits or the two together (`"123 ESTATE DR APT 5"`); after any other
247
+ * tail it is the owner's (`"100 TEST FAMILY TRUST ST LOUIS MO"`,
248
+ * `"5 TEST TRUST CT 06001"`, `"7 TEST ESTATE PT 2"`). Bare CO is no entity
249
+ * word (`"123 CO RD 45"`). Anything else on that
250
+ * line (a c/o line, a second owner name) is not the address.
251
+ * A county REDACTION MARKER on the fallback line ("CONFIDENTIAL",
252
+ * "REDACTED PER KRS 61.878") withholds the whole row, owner included,
253
+ * whatever the primary holds, exactly as one in the primary would.
254
+ * Dooly's primary is `address2`; `address1` is its fallback.
255
+ * - `"situs-directional"`: the street directional of a split site address
256
+ * (house number + street name columns, no single address column). Compose
257
+ * the site address as house number, directional, street name, and use the
258
+ * value only when it is a direction (N, S, E, W, NE, NW, SE, SW, or the
259
+ * word spelled out); Dooly's `stdirect` holds one "Q" that is not. Never
260
+ * compose it into a house number and street that together are a
261
+ * redaction marker ("0 CONFIDENTIAL" stays as it is, and the row is
262
+ * withheld). A redaction marker in the directional column itself
263
+ * ("CONFIDENTIAL") withholds the whole row. The tagged column is never
264
+ * itself the house number, the street name, the owner, the parcel id, a
265
+ * mailing column or a unit or suffix qualifier, and its name or label
266
+ * names a direction ("dir", "direction" or "directional" as a word of
267
+ * its own, a pre, post, st or suf prefix allowed: `PRE_DIR`, "Street
268
+ * Direction"; not `DIRECTOR` or "Direct Bill Flag"). A geocoded address without
269
+ * the directional still names the parcel when only one parcel at that
270
+ * number shares the street name; with it, the directional counts only
271
+ * beside a shared street-name word that is not itself a direction, and a
272
+ * parcel it alone singles out does not win over one at the same number
273
+ * and street whose directional is blank.
274
+ *
275
+ * At most one field per role on an endpoint, and never on
276
+ * `ownerJoin.fields`.
277
+ */
278
+ role?: SearchFieldRole;
215
279
  }
280
+ /** The opt-in column roles a record may declare ({@link SearchField.role}). Since 0.9.7. */
281
+ type SearchFieldRole = "mailing-fallback" | "situs-directional";
216
282
  /**
217
283
  * Owner rows that live in a separate TABLE of the same service, joined to the
218
284
  * endpoint's parcel polygons by a key: the polygons carry `parcelKey`, the
@@ -1353,4 +1419,4 @@ declare function citiesForCounty(stateSlug: string, countySlug: string): CitySum
1353
1419
  declare const cityPropertyIndex: CityPropertyIndex;
1354
1420
  declare const cityZoningIndex: CityZoningIndex;
1355
1421
 
1356
- export { ACCESS_FLAGS, ACCESS_PRESETS, ACCESS_REASONS, ATLAS_COUNTY_PAGE_BASE, type AccessFlag, type AccessFlags, type AccessPageRef, type AccessPreset, type AccessReason, type AccessRecordLike, type Atlas, type AtlasIndex, CITY_RECORD_LIMIT, CITY_STREET_MAX_LEN, COUNTY_RECHECK_REQUEST_MESSAGE, COUNTY_REQUEST_MESSAGE, COUNTY_REQUEST_URL, COVERAGE_REASONS, type CapabilityBasis, type CapabilityBasisType, type CapabilityField, type CapabilityOverrides, type CapabilityStatus, type CaseFieldMap, type CasesSource, type CityDatasetDescriptor, type CityFilter, type CityKind, type CityLookup, type CityPropertyIndex, type CityPropertyIndexEntry, type CityPropertyRecord, type CityProvider, type CityQueryTemplate, type CitySource, type CitySummary, type CityZoningIndex, type CityZoningIndexEntry, type CityZoningRecord, type ConfidentialFlag, type ContactInfo, type CountyAccessEntry, type CountyAdvisory, type CountyCoverage, type CountyPausedAnswer, type CountyProduct, type CountyRecord, type CountyRequestHint, type CountyRequestRef, type CoverageAnswer, type CoverageReason, type CoverageRecordLike, type CoverageStatus, type CoverageTextInput, type CurrentZoningFieldMap, type CurrentZoningSource, type DatasetKind, type DeepLinkCounty, type EndpointPresenceLike, type EndpointRecord, type EndpointStatus, type GeocoderConfig, type GeocoderProvider, LIVE_STATUS_URL, type LicenseType, NOT_IN_ATLAS_WHY, NO_PUBLIC_DATA_WHY, type OwnerJoin, POINT_PLACEHOLDER, PRESET_FLAGS, type PropertyDataset, type PropertyDatasets, type PropertyFieldMap, type PropertySource, type PropertySourceType, type PropertyStatusBuckets, type SearchField, type ServiceType, type SplitStreet, type StateFile, type StateIndexEntry, type VerifiedBy, type ZoningByAddressSource, type ZoningSourceType, type ZoningStatusBuckets, type ZoningToolKind, accessBlocks, atlas, atlasIndex, buildCityQuery, buildParcelLookupDeepLink, canonicalLayerUrl, casesLocationTemplate, casesQueryUrl, citiesForCounty, citiesForCountyIn, cityDatasetDescriptors, cityDatasets, cityPath, cityPropertyIndex, cityZoningIndex, countyDownMessage, countyHasEndpoint, countyOffersAttributeSearch, countyPath, countySlugFromName, coverageAnswer, coverageAnswerText, coverageOverridesPause, currentZoningTemplate, findCity, findCityIn, findCounty, findCountyByFips, findState, flagsFor, getCityProperty, getCityZoning, isReviewedUnservable, listCities, listCountiesByState, listStates, mergeCityIndexes, offersAttributeSearch, offersPagination, pausedAnswer, pausedFlags, presetOf, propertyQueryUrl, queryFieldName, requestHint, reviewedCapability, slugify, splitAddressStreetName, splitStreet, statePath, streetForDataset };
1422
+ export { ACCESS_FLAGS, ACCESS_PRESETS, ACCESS_REASONS, ATLAS_COUNTY_PAGE_BASE, type AccessFlag, type AccessFlags, type AccessPageRef, type AccessPreset, type AccessReason, type AccessRecordLike, type Atlas, type AtlasIndex, CITY_RECORD_LIMIT, CITY_STREET_MAX_LEN, COUNTY_RECHECK_REQUEST_MESSAGE, COUNTY_REQUEST_MESSAGE, COUNTY_REQUEST_URL, COVERAGE_REASONS, type CapabilityBasis, type CapabilityBasisType, type CapabilityField, type CapabilityOverrides, type CapabilityStatus, type CaseFieldMap, type CasesSource, type CityDatasetDescriptor, type CityFilter, type CityKind, type CityLookup, type CityPropertyIndex, type CityPropertyIndexEntry, type CityPropertyRecord, type CityProvider, type CityQueryTemplate, type CitySource, type CitySummary, type CityZoningIndex, type CityZoningIndexEntry, type CityZoningRecord, type ConfidentialFlag, type ContactInfo, type CountyAccessEntry, type CountyAdvisory, type CountyCoverage, type CountyPausedAnswer, type CountyProduct, type CountyRecord, type CountyRequestHint, type CountyRequestRef, type CoverageAnswer, type CoverageReason, type CoverageRecordLike, type CoverageStatus, type CoverageTextInput, type CurrentZoningFieldMap, type CurrentZoningSource, type DatasetKind, type DeepLinkCounty, type EndpointPresenceLike, type EndpointRecord, type EndpointStatus, type GeocoderConfig, type GeocoderProvider, LIVE_STATUS_URL, type LicenseType, NOT_IN_ATLAS_WHY, NO_PUBLIC_DATA_WHY, type OwnerJoin, POINT_PLACEHOLDER, PRESET_FLAGS, type PropertyDataset, type PropertyDatasets, type PropertyFieldMap, type PropertySource, type PropertySourceType, type PropertyStatusBuckets, type SearchField, type SearchFieldRole, type ServiceType, type SplitStreet, type StateFile, type StateIndexEntry, type VerifiedBy, type ZoningByAddressSource, type ZoningSourceType, type ZoningStatusBuckets, type ZoningToolKind, accessBlocks, atlas, atlasIndex, buildCityQuery, buildParcelLookupDeepLink, canonicalLayerUrl, casesLocationTemplate, casesQueryUrl, citiesForCounty, citiesForCountyIn, cityDatasetDescriptors, cityDatasets, cityPath, cityPropertyIndex, cityZoningIndex, countyDownMessage, countyHasEndpoint, countyOffersAttributeSearch, countyPath, countySlugFromName, coverageAnswer, coverageAnswerText, coverageOverridesPause, currentZoningTemplate, findCity, findCityIn, findCounty, findCountyByFips, findState, flagsFor, getCityProperty, getCityZoning, isReviewedUnservable, listCities, listCountiesByState, listStates, mergeCityIndexes, offersAttributeSearch, offersPagination, pausedAnswer, pausedFlags, presetOf, propertyQueryUrl, queryFieldName, requestHint, reviewedCapability, slugify, splitAddressStreetName, splitStreet, statePath, streetForDataset };
package/dist/index.js CHANGED
@@ -396,12 +396,12 @@ function countyDownMessage(countyName) {
396
396
  // data/index.json
397
397
  var data_default = {
398
398
  version: "0.3.0",
399
- lastUpdated: "2026-11-14",
399
+ lastUpdated: "2026-11-15",
400
400
  totals: {
401
401
  states: 51,
402
- counties: 545,
403
- endpoints: 521,
404
- countiesWithEndpoint: 493,
402
+ counties: 546,
403
+ endpoints: 522,
404
+ countiesWithEndpoint: 494,
405
405
  countiesUnprobeable: 1
406
406
  },
407
407
  states: [
@@ -489,8 +489,8 @@ var data_default = {
489
489
  slug: "georgia",
490
490
  name: "Georgia",
491
491
  abbrev: "GA",
492
- countyCount: 9,
493
- endpointCount: 6,
492
+ countyCount: 10,
493
+ endpointCount: 7,
494
494
  populated: true
495
495
  },
496
496
  {
@@ -15734,7 +15734,7 @@ var georgia_default = {
15734
15734
  stateSlug: "georgia",
15735
15735
  stateName: "Georgia",
15736
15736
  stateAbbrev: "GA",
15737
- lastUpdated: "2026-11-10",
15737
+ lastUpdated: "2026-11-15",
15738
15738
  counties: [
15739
15739
  {
15740
15740
  id: "ga-fulton",
@@ -16242,6 +16242,60 @@ var georgia_default = {
16242
16242
  summary: "Spalding County's public parcel layer has parcel ids but no owner names or mailing addresses, so we don't index it. The Tax Assessor's property search shows owners one parcel at a time. Request it and we'll tell you if that changes.",
16243
16243
  checked: "2026-11-10"
16244
16244
  }
16245
+ },
16246
+ {
16247
+ id: "ga-dooly",
16248
+ state: "GA",
16249
+ stateName: "Georgia",
16250
+ stateSlug: "georgia",
16251
+ county: "Dooly",
16252
+ countySlug: "dooly-county",
16253
+ countyFips: "13093",
16254
+ hasPublicRest: true,
16255
+ endpoints: [
16256
+ {
16257
+ url: "https://services9.arcgis.com/x9uoDq5JB3OouaRv/arcgis/rest/services/Parcel_Regions_w_WinGAP/FeatureServer/0",
16258
+ serviceType: "FeatureServer",
16259
+ layerIndex: 0,
16260
+ layerName: "Parcel_Regions_w_WinGAP",
16261
+ supportsQuery: true,
16262
+ corsEnabled: true,
16263
+ searchFields: [
16264
+ { name: "Parcel_No", label: "Parcel ID", searchable: true },
16265
+ { name: "lastname", label: "Owner Name", searchable: true },
16266
+ { name: "house_no", label: "House Number", searchable: true },
16267
+ { name: "street_nam", label: "Street Name", searchable: true },
16268
+ { name: "stdirect", label: "Street Direction", searchable: false, role: "situs-directional" },
16269
+ { name: "sttype", label: "Street Type", searchable: false },
16270
+ { name: "extension", label: "House Number Suffix", searchable: false },
16271
+ { name: "unit", label: "Unit", searchable: false },
16272
+ { name: "address2", label: "Owner Mailing Address", searchable: true },
16273
+ { name: "address1", label: "Owner Mailing Line 1 (c/o or street)", searchable: false, role: "mailing-fallback" },
16274
+ { name: "address3", label: "Owner Mailing Line 3", searchable: false },
16275
+ { name: "city", label: "Owner Mailing City", searchable: true },
16276
+ { name: "state", label: "Owner Mailing State", searchable: false },
16277
+ { name: "zip_code", label: "Owner Mailing ZIP", searchable: false },
16278
+ { name: "Realkey", label: "CAMA Account Key (Realkey)", searchable: false },
16279
+ { name: "totalacres", label: "Total Acres", searchable: false },
16280
+ { name: "digclass", label: "Property Class", searchable: false },
16281
+ { name: "zoningcode", label: "Zoning Code", searchable: false },
16282
+ { name: "curr_val", label: "Current Value", searchable: false }
16283
+ ],
16284
+ sampleQuery: "https://services9.arcgis.com/x9uoDq5JB3OouaRv/arcgis/rest/services/Parcel_Regions_w_WinGAP/FeatureServer/0/query?where=UPPER(lastname)+LIKE+UPPER('%25SMITH%25')&outFields=Parcel_No,lastname,house_no,street_nam,sttype,address1,address2,city,state,zip_code&returnGeometry=false&f=json&resultRecordCount=10",
16285
+ license: "unknown",
16286
+ licenseUrl: "https://www.arcgis.com/home/item.html?id=1f883189ff944f74b71e8748c39a2d0d",
16287
+ status: "live",
16288
+ lastVerified: "2026-11-15",
16289
+ verifiedBy: "manual"
16290
+ }
16291
+ ],
16292
+ contact: {
16293
+ department: "Dooly County Board of Tax Assessors, Vienna GA",
16294
+ url: "https://qpublic.schneidercorp.com/Application.aspx?App=doolyCountyGA",
16295
+ email: null
16296
+ },
16297
+ notes: "Dooly County, Georgia (county seat Vienna; FIPS 13093). Served by the county's own ArcGIS Online organisation (the one that also publishes the county's 911 addresses, voting districts and zoning layers): feature service Parcel_Regions_w_WinGAP, item 1f883189ff944f74b71e8748c39a2d0d, public, the standard WinGAP parcel export that joins the tax roll to the parcel polygons. Read 2026-11-15: 7,344 parcels, layer last edited 2026-11-05; lastname (the whole owner string, despite the column name) is non-blank on 7,324; firstname and middle are blank on all but a handful of rows and are not listed; UPPER(lastname) LIKE '%SMITH%' returns 143, the sample query's predicate. SITUS is split across columns with no combined situs column: house_no (an integer, 0 where the parcel has no number) and street_nam, with the directional in stdirect, the suffix in sttype and a house-number suffix and unit in extension and unit; the house number and street name are listed as the composite pair (as Hennepin MN's HOUSE_NO and STREET_NM are), and stdirect is declared the pair's directional (role situs-directional, atlas 0.9.7): 686 parcels carry one (E 254, N 196, W 134, S 101, and one Q, which is not a direction and is ignored), and the site address reads house_no, stdirect, street_nam. The owner MAILING address is spread over address1, address2 and address3 plus city, state and zip_code: address2 holds the street or P O Box on most rows (6,023), address1 holds a c/o or second-name line, or the street when address2 is blank (2,373 rows non-blank), so read all three. The record's mailing column is address2, and address1 is its declared fallback (role mailing-fallback, atlas 0.9.7), read only when address2 is blank: on the 1,255 rows whose street or P O Box sits in address1 alone (address2 blank), address1 is read only when it is a mailing line (a whole house number then a word, a P O Box or Drawer with its number, or a rural route box, with no owner-entity, share, c/o, attention or withheld word such as LLC, COMPANY, TRUSTEE, HEIRS, ET AL, INT, C/O, CARE OF, ATTN, ATTENTION, CONFIDENTIAL or 1 OF 2, however it is spelled, where an entity word directly before a street suffix is part of the street name when nothing but a unit and its number follows the suffix): 1,053 start with a digit and 194 are P O Boxes, and on 2026-11-15 1,247 of them are read, while 8 stay blank (the 2 c/o lines and 6 other values). A redaction marker in address1 or in stdirect withholds the row whatever address2 holds; none does on 2026-11-15. PARCEL ID: Parcel_No is a fixed-width string padded with spaces, the map, block and parcel in fixed columns (' 23 25' is map 23 parcel 25; 'U 5 1 1' is map U5 block 1 parcel 1). The id typed with single spaces ('23 25') matches nothing, and a LIKE with % between the parts can match more than one parcel (Parcel_No LIKE 'U 5%1%1' matched 2 on 2026-11-15), so query the parts exactly (Map = 'U5' AND Block = '1' AND Parcel = '1', with SubParcel for a lettered split) or match the full padded value. Realkey is the integer CAMA key, and qPub_Link deep-links each row's report on the county's qPublic site. String columns are padded, so trim the values. Capabilities Query only, maxRecordCount 2000 with pagination, WKID 102100, CORS open (Access-Control-Allow-Origin *). No row carries the no_release withhold flag. EXEMPTION COLUMN, NOT LISTED: homeexempt holds the homestead exemption codes. NOT USED: the regional commission's Dooly_County_Parcels layer, whose data is from 2022. TERMS: the ArcGIS Online item carries no licence, access or description text, and the county's Terms of Use (doolycountyga.gov/terms) say only that public records and government works are available for reuse consistent with Georgia law; no limit on sale or commercial use was found.",
16298
+ addedAt: "2026-11-15"
16245
16299
  }
16246
16300
  ]
16247
16301
  };
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@urbankitstudio/atlas",
3
- "version": "0.9.5",
4
- "description": "JS SDK for the UrbanKit County Parcel REST API Atlas: 545 counties across all 50 US states and DC, 521 verified public ArcGIS REST endpoints for county parcel data, with searchable field metadata, sample queries and license info, plus verified city code-violation, building-permit and zoning-case datasets.",
3
+ "version": "0.9.7",
4
+ "description": "JS SDK for the UrbanKit County Parcel REST API Atlas: 546 counties across all 50 US states and DC, 522 verified public ArcGIS REST endpoints for county parcel data, with searchable field metadata, sample queries and license info, plus verified city code-violation, building-permit and zoning-case datasets.",
5
5
  "keywords": [
6
6
  "parcel",
7
7
  "arcgis",