@urbankitstudio/atlas 0.9.6 → 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,68 @@
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
+
3
66
  ## 0.9.6 (2026-11-15)
4
67
 
5
68
  Dooly County, Georgia, which a user searched for, joins the atlas with an endpoint. `totals.counties` moves from
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
package/data/georgia.json CHANGED
@@ -533,12 +533,12 @@
533
533
  { "name": "lastname", "label": "Owner Name", "searchable": true },
534
534
  { "name": "house_no", "label": "House Number", "searchable": true },
535
535
  { "name": "street_nam", "label": "Street Name", "searchable": true },
536
- { "name": "stdirect", "label": "Street Direction", "searchable": false },
536
+ { "name": "stdirect", "label": "Street Direction", "searchable": false, "role": "situs-directional" },
537
537
  { "name": "sttype", "label": "Street Type", "searchable": false },
538
538
  { "name": "extension", "label": "House Number Suffix", "searchable": false },
539
539
  { "name": "unit", "label": "Unit", "searchable": false },
540
540
  { "name": "address2", "label": "Owner Mailing Address", "searchable": true },
541
- { "name": "address1", "label": "Owner Mailing Line 1 (c/o or street)", "searchable": false },
541
+ { "name": "address1", "label": "Owner Mailing Line 1 (c/o or street)", "searchable": false, "role": "mailing-fallback" },
542
542
  { "name": "address3", "label": "Owner Mailing Line 3", "searchable": false },
543
543
  { "name": "city", "label": "Owner Mailing City", "searchable": true },
544
544
  { "name": "state", "label": "Owner Mailing State", "searchable": false },
@@ -562,7 +562,7 @@
562
562
  "url": "https://qpublic.schneidercorp.com/Application.aspx?App=doolyCountyGA",
563
563
  "email": null
564
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). 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, so on the 1,255 rows whose street or P O Box sits in address1 alone (address2 blank) it reads blank. 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.",
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
566
  "addedAt": "2026-11-15"
567
567
  }
568
568
  ]
package/dist/index.cjs CHANGED
@@ -16267,12 +16267,12 @@ var georgia_default = {
16267
16267
  { name: "lastname", label: "Owner Name", searchable: true },
16268
16268
  { name: "house_no", label: "House Number", searchable: true },
16269
16269
  { name: "street_nam", label: "Street Name", searchable: true },
16270
- { name: "stdirect", label: "Street Direction", searchable: false },
16270
+ { name: "stdirect", label: "Street Direction", searchable: false, role: "situs-directional" },
16271
16271
  { name: "sttype", label: "Street Type", searchable: false },
16272
16272
  { name: "extension", label: "House Number Suffix", searchable: false },
16273
16273
  { name: "unit", label: "Unit", searchable: false },
16274
16274
  { name: "address2", label: "Owner Mailing Address", searchable: true },
16275
- { name: "address1", label: "Owner Mailing Line 1 (c/o or street)", searchable: false },
16275
+ { name: "address1", label: "Owner Mailing Line 1 (c/o or street)", searchable: false, role: "mailing-fallback" },
16276
16276
  { name: "address3", label: "Owner Mailing Line 3", searchable: false },
16277
16277
  { name: "city", label: "Owner Mailing City", searchable: true },
16278
16278
  { name: "state", label: "Owner Mailing State", searchable: false },
@@ -16296,7 +16296,7 @@ var georgia_default = {
16296
16296
  url: "https://qpublic.schneidercorp.com/Application.aspx?App=doolyCountyGA",
16297
16297
  email: null
16298
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). 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, so on the 1,255 rows whose street or P O Box sits in address1 alone (address2 blank) it reads blank. 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.",
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
16300
  addedAt: "2026-11-15"
16301
16301
  }
16302
16302
  ]
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
@@ -16265,12 +16265,12 @@ var georgia_default = {
16265
16265
  { name: "lastname", label: "Owner Name", searchable: true },
16266
16266
  { name: "house_no", label: "House Number", searchable: true },
16267
16267
  { name: "street_nam", label: "Street Name", searchable: true },
16268
- { name: "stdirect", label: "Street Direction", searchable: false },
16268
+ { name: "stdirect", label: "Street Direction", searchable: false, role: "situs-directional" },
16269
16269
  { name: "sttype", label: "Street Type", searchable: false },
16270
16270
  { name: "extension", label: "House Number Suffix", searchable: false },
16271
16271
  { name: "unit", label: "Unit", searchable: false },
16272
16272
  { name: "address2", label: "Owner Mailing Address", searchable: true },
16273
- { name: "address1", label: "Owner Mailing Line 1 (c/o or street)", searchable: false },
16273
+ { name: "address1", label: "Owner Mailing Line 1 (c/o or street)", searchable: false, role: "mailing-fallback" },
16274
16274
  { name: "address3", label: "Owner Mailing Line 3", searchable: false },
16275
16275
  { name: "city", label: "Owner Mailing City", searchable: true },
16276
16276
  { name: "state", label: "Owner Mailing State", searchable: false },
@@ -16294,7 +16294,7 @@ var georgia_default = {
16294
16294
  url: "https://qpublic.schneidercorp.com/Application.aspx?App=doolyCountyGA",
16295
16295
  email: null
16296
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). 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, so on the 1,255 rows whose street or P O Box sits in address1 alone (address2 blank) it reads blank. 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.",
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
16298
  addedAt: "2026-11-15"
16299
16299
  }
16300
16300
  ]
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@urbankitstudio/atlas",
3
- "version": "0.9.6",
3
+ "version": "0.9.7",
4
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",