@urbankitstudio/atlas 0.9.0 → 0.9.1

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,41 @@
1
1
  # @urbankitstudio/atlas Changelog
2
2
 
3
+ ## 0.9.1 (2026-11-11)
4
+
5
+ One county is added, and it is the first whose owners come from a joined table. `totals` move from 538 counties,
6
+ 521 endpoints and 493 counties with an endpoint to 539, 522 and 494.
7
+
8
+ **Patch.** Data only: no type, function or existing record changed.
9
+
10
+ - **Sussex County, Delaware** (`de-sussex`, FIPS 10005) is the first record that carries `ownerJoin` (declared
11
+ in 0.9.0). Its parcel layer, `Parcels_PIN/MapServer/0`, has the polygons and the parcel id in `Name`, and no
12
+ owner. The owner rows are in table 1 of the same service, `OwnershipInformation`, keyed by `PIN`: a parcel's
13
+ owners are the table rows whose `PIN` equals the parcel's `Name`.
14
+ - The endpoint's `searchFields` lists `Name` alone. The table's eight columns are in `ownerJoin.fields`, so
15
+ code that ignores `ownerJoin` sees a layer with a parcel id and no owner, which is true of the layer.
16
+ - The owner name is `FULLNAME`, and `Second_Owner_Name` holds a second owner. The owner's mailing address is
17
+ split over four columns: `MAILINGADDRESS` is the street line, and the city, state and ZIP are `CITY`,
18
+ `STATE` and `ZIPCODE`. Read each column's `label`.
19
+ - `multiple` is `"rows"` and `maxRowsPerKey` is 1000. About a fifth of the table's rows carry an assessment
20
+ unit, so one parcel can hold several ownership rows, and one PIN holds more rows than the table returns to
21
+ one query. `rowIdField` is `PINWASSEMENTUNIT`, which is not unique.
22
+ - Some parcels have no row in the table. Treat them as parcels with no owner on record, not as an error.
23
+ - The layer publishes no site address, so the record answers a search by PIN and a lookup by location.
24
+ - The service states no licence, so `license` is `unknown`. Its copyright text, `Sussex County Government`, is
25
+ the record's `credit`.
26
+ - **What the hosted API returns for this county.** A paid radius list carries the owner name and the mailing
27
+ street line. The city, state and ZIP stay in the county table's columns and are not joined onto that line. The
28
+ hosted answers read the joined table too: they send no capability block for Sussex's owner name or owner
29
+ mailing address, which is how they mark a field plainly available, and an enrichment row says
30
+ `owner_data_available: true`. A single-address lookup or a bulk row still returns `source-incomplete` for
31
+ Sussex, because the layer has no site address to match.
32
+ - **No function in this package reads `ownerJoin.fields`.** `reviewedCapability` returns reviewed records only,
33
+ as before, and `buildParcelLookupDeepLink` reads the layer's own `searchFields`. Read the owner columns from
34
+ `endpoint.ownerJoin.fields`.
35
+ - The registry's validator gains one rule for a record with an `ownerJoin`: an owner's notice must be matchable
36
+ on it. The layer's `parcelKey` column has to read as a parcel id, and the table's `key` column must not read
37
+ as an address or a name.
38
+
3
39
  ## 0.9.0 (2026-11-10)
4
40
 
5
41
  Two record shapes are declared for counties whose owner data does not sit on the parcel layer itself. **No record
package/README.md CHANGED
@@ -346,8 +346,9 @@ owner there is protected.
346
346
 
347
347
  ## Some counties keep owners in a separate table
348
348
 
349
- Declared in 0.9.0 and **carried by no record yet**: the types are here so your
350
- code can be ready, and every record reads exactly as it did in 0.8.x.
349
+ Declared in 0.9.0 and carried by one record from 0.9.1: **Sussex County,
350
+ Delaware** (`de-sussex`, FIPS 10005). Every other record reads exactly as it did
351
+ in 0.8.x.
351
352
 
352
353
  An endpoint may carry `ownerJoin` (type `OwnerJoin`). Its parcel layer has the
353
354
  polygons and a parcel id but no owner; the owner rows are in a table of the same
@@ -364,11 +365,20 @@ service, at `ownerJoin.url`. A parcel's owners are the table rows whose
364
365
  - `orderField` is a unique, stable column of the table. Send it as
365
366
  `orderByFields` whenever you send `resultOffset`.
366
367
  - `multiple: "rows"` means a key with several rows stands for several ownership
367
- records, up to `maxRowsPerKey` rows (always present with it, at most the
368
- table's `maxRecordCount`). A key with more rows than that, or any key with
369
- several rows when `multiple` is absent, has no owner you can state.
368
+ records, up to `maxRowsPerKey` distinct rows (always present with it, at most
369
+ the table's `maxRecordCount`), counted after de-duplication. A key with more
370
+ distinct rows than that, or any key with several distinct rows when
371
+ `multiple` is absent, has no owner you can state.
370
372
  - `rowIdField`, when present, labels the rows of one key. It is not unique:
371
- de-duplicate the rows of one key by the owner and mailing content you read.
373
+ de-duplicate the rows of one key by the owner and mailing content you read,
374
+ and drop a row whose values another row of the key already carries.
375
+ - Read each table column's `label` before you use it. Sussex splits the owner's
376
+ mailing address over four columns: `MAILINGADDRESS` is the street line, and
377
+ the city, state and ZIP are `CITY`, `STATE` and `ZIPCODE`.
378
+ - No function in this package reads `ownerJoin.fields` for you
379
+ (`reviewedCapability` returns reviewed records only, and
380
+ `buildParcelLookupDeepLink` reads the layer's `searchFields`). On a joined
381
+ record, read the owner columns from `endpoint.ownerJoin.fields` yourself.
372
382
 
373
383
  A `SearchField` may carry `wireName`: the column's fully qualified name on a
374
384
  layer that answers with `table.column` names, while `name` stays the bare last
@@ -394,9 +404,9 @@ read `addedAt` and fall back to the oldest `lastVerified` only when it is absent
394
404
 
395
405
  ## Coverage today
396
406
 
397
- The atlas bundles **538 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.
407
+ The atlas bundles **539 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.
398
408
 
399
- Every state has at least one county on record, and 493 of the 538 carry a verified endpoint. The other 45 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.
409
+ Every state has at least one county on record, and 494 of the 539 carry a verified endpoint. The other 45 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.
400
410
 
401
411
  The city registries cover 30 cities with code-violation or building-permit datasets, 19 with zoning-case datasets. Call `listCities()` for the current set.
402
412
 
@@ -429,6 +439,7 @@ The parcel layers the atlas points to belong to their publishers. These publishe
429
439
  | `ok-creek` (0.8.0) | INCOG's Parcels_CreekCo [item](https://map11.incog.org/arcgis11wa/rest/services/Parcels_CreekCo/MapServer/0/iteminfo) credits the Creek County Assessor and carries INCOG's use-of-this-information disclaimer | Creek County Assessor; published by INCOG. USE OF THIS INFORMATION: This dataset has been created for illustrative purposes only. Although every effort has been made to produce the most current, correct and clearly expressed data possible, all geographic information has limitations due to scale, resolution, date and interpretation of the original source materials. This dataset is based on data collected from various sources that can change over time and without notice. Therefore, the dataset provided is not intended to replace any official source. You should not act or refrain from acting based upon this feature class without independently verifying the information and, if necessary, obtaining professional advice. The burden of determining the accuracy, completeness, timeliness of information rest solely on the user. Copyright © 2016 INCOG |
430
440
  | `mo-jasper` (0.8.0) | The City of Joplin's JascoParcels52626 [item](https://www.arcgis.com/home/item.html?id=5d47528e4f1c42dc806a55e28b7e1c19) licence text: informational and general mapping use, no warranty, verify with Jasper County | Jasper County, Missouri parcel data, published by the City of Joplin GIS. This dataset is provided for informational and general mapping purposes only. It is not intended for use as a legal survey, title record, deed description, or authoritative determination of property boundaries or ownership. The City of Joplin makes no warranty regarding the accuracy, completeness, currency, or fitness of the data for a particular purpose. Users assume responsibility for independently verifying information with Jasper County or another appropriate authoritative source. The City of Joplin and Jasper County are not responsible for decisions, damages, or losses resulting from use of this dataset. |
431
441
  | `mi-muskegon` (0.8.0) | The county's [GIS Data Download / Use Agreement](https://gis.muskegoncountygis.com/open_data/documents/MCGIS_Data_Download_Use_Agreement_v2026.pdf) (v2026), clause 8: this notice on every derivative work. Clause 5 also requires its disclaimer in the use agreement of any application of the Data, and the license is revocable (clause 9: the county may charge in future); see the record's `notes` | Reproduced with permission granted Muskegon County, Michigan. Some information has been provided subject to a non-exclusive, limited, and revocable license granted by Muskegon County, Michigan. |
442
+ | `de-sussex` (0.9.1) | The Parcels_PIN service's copyright text names the county; the service states no licence, so `license` is `unknown` | Sussex County Government |
432
443
  | `md-montgomery` | Reuse allowed, attribution requested | Montgomery County Planning Department (M-NCPPC) |
433
444
  | `md-prince-georges` | Reuse allowed, attribution requested | Prince George's County Planning Department (M-NCPPC) |
434
445
  | `nc-wake` | [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) | Wake County (Wake County GIS, Wake County Revenue) |
@@ -2,7 +2,7 @@
2
2
  "stateSlug": "delaware",
3
3
  "stateName": "Delaware",
4
4
  "stateAbbrev": "DE",
5
- "lastUpdated": "2026-06-20",
5
+ "lastUpdated": "2026-11-11",
6
6
  "counties": [
7
7
  {
8
8
  "id": "de-new-castle",
@@ -41,6 +41,65 @@
41
41
  "email": null
42
42
  },
43
43
  "notes": "New Castle County DE (Wilmington/Newark metro; county seat Wilmington; FIPS 10003; most populous of Delaware's 3 counties, pop. ~570,000) publishes a public ArcGIS MapServer parcel layer hosted by NCCDE GIS (Foundation/Base_Layers/MapServer/0, 'Parcels', ~203,753 features, no token required). Key fields: PRCLID (parcel ID / APN), CNTCTLAST (owner last name / contact, the searchable owner field), OWNADDR (owner mailing address), ADDRESS (property situs address). Owner-name search via UPPER(CNTCTLAST) LIKE UPPER('%NAME%') works. Verified 2026-06-20: UPPER(CNTCTLAST) LIKE UPPER('%SMITH%') returns Wilmington-area parcels. Delaware has only 3 counties (New Castle, Kent, Sussex); Kent and Sussex are served separately. Do not confuse with New Castle in Pennsylvania (Lawrence County, PA)."
44
+ },
45
+ {
46
+ "id": "de-sussex",
47
+ "state": "DE",
48
+ "stateName": "Delaware",
49
+ "stateSlug": "delaware",
50
+ "county": "Sussex",
51
+ "countySlug": "sussex-county",
52
+ "countyFips": "10005",
53
+ "hasPublicRest": true,
54
+ "endpoints": [
55
+ {
56
+ "url": "https://map.sussexcountyde.gov/trdserver/rest/services/Geographic_Information_Office/Parcels_PIN/MapServer/0",
57
+ "serviceType": "MapServer",
58
+ "layerIndex": 0,
59
+ "layerName": "Tax Parcels",
60
+ "supportsQuery": true,
61
+ "corsEnabled": true,
62
+ "searchFields": [
63
+ { "name": "Name", "label": "Parcel ID (PIN)", "searchable": true }
64
+ ],
65
+ "ownerJoin": {
66
+ "url": "https://map.sussexcountyde.gov/trdserver/rest/services/Geographic_Information_Office/Parcels_PIN/MapServer/1",
67
+ "layerName": "OwnershipInformation",
68
+ "key": "PIN",
69
+ "parcelKey": "Name",
70
+ "fields": [
71
+ { "name": "PIN", "label": "Parcel ID (PIN)", "searchable": true },
72
+ { "name": "PINWASSEMENTUNIT", "label": "PIN with Assessment Unit", "searchable": false },
73
+ { "name": "FULLNAME", "label": "Owner Name", "searchable": true },
74
+ { "name": "Second_Owner_Name", "label": "Second Owner Name", "searchable": false },
75
+ { "name": "MAILINGADDRESS", "label": "Owner Mailing Address", "searchable": false },
76
+ { "name": "CITY", "label": "Owner Mailing City", "searchable": false },
77
+ { "name": "STATE", "label": "Owner Mailing State", "searchable": false },
78
+ { "name": "ZIPCODE", "label": "Owner Mailing ZIP", "searchable": false }
79
+ ],
80
+ "rowIdField": "PINWASSEMENTUNIT",
81
+ "multiple": "rows",
82
+ "maxRowsPerKey": 1000,
83
+ "orderField": "OBJECTID_1",
84
+ "maxRecordCount": 1000,
85
+ "lastVerified": "2026-11-11"
86
+ },
87
+ "sampleQuery": "https://map.sussexcountyde.gov/trdserver/rest/services/Geographic_Information_Office/Parcels_PIN/MapServer/0/query?where=Name%3D%27133-11.00-8.00%27&outFields=Name&returnGeometry=false&f=json",
88
+ "license": "unknown",
89
+ "licenseUrl": null,
90
+ "status": "live",
91
+ "lastVerified": "2026-11-11",
92
+ "verifiedBy": "manual"
93
+ }
94
+ ],
95
+ "contact": {
96
+ "department": "Sussex County Government, Geographic Information Office (the name of the parcel service's folder)",
97
+ "url": "https://map.sussexcountyde.gov/trdserver/rest/services/Geographic_Information_Office/Parcels_PIN/MapServer",
98
+ "email": null
99
+ },
100
+ "notes": "Sussex County, Delaware (Georgetown; FIPS 10005). The county's own ArcGIS Server at map.sussexcountyde.gov publishes Geographic_Information_Office/Parcels_PIN, a MapServer it describes as 'Sussex County Delaware Tax Parcel Map with Related Ownership Information Table'. THE OWNERS ARE NOT ON THE PARCEL LAYER. Layer 0, 'Tax Parcels', holds the polygons (165,012 on 2026-11-11) and is documented here by one column: Name, which is the parcel's PIN (133-11.00-8.00: digits, dashes and dots, not zero-padded). It carries no owner and no site address. The owner rows are in table 1 of the same service, 'OwnershipInformation' (208,124 rows), keyed by PIN; the service itself relates the layer's Name to the table's PIN, one parcel to many rows, and this record names that table as the layer's owner join. The table has no geometry, so it is asked by key only (PIN IN a list of parcel PINs), never by location, and every row it returns must echo a key that was asked. On the table, FULLNAME is the owner (null or empty on none of its rows) and Second_Owner_Name a second owner; MAILINGADDRESS is the street line of the owner's mailing address (null or empty on 274 rows), and the city, state and ZIP are the separate columns CITY, STATE and ZIPCODE. A paid radius list carries the owner name and the mailing street line; the city, state and ZIP stay in the county table's columns and are not joined onto that line. SEVERAL ROWS PER PARCEL: 43,273 table rows (20.8%) carry an assessment unit, where PINWASSEMENTUNIT is the PIN, a dash and the unit; that column labels the rows of one PIN but is not unique, so a parcel's rows are told apart by the owner and mailing line they carry. One PIN holds 1,093 rows, more than the table returns to one query. Some parcels have no table row at all (51 neighbouring lots of map block 233-11.00 on 2026-11-10); they are served without an owner. NO SITE ADDRESS is published on the layer or the table, so an address lookup cannot be answered from this record: a search by PIN and a point or radius lookup are what it offers. Verified 2026-11-11: Name = '133-11.00-8.00' returned one parcel, the sample query's predicate; five PINs read off the layer were asked of the table and every row it returned echoed an asked key; UPPER(FULLNAME) LIKE '%SMITH%' counted 1,603 table rows. maxRecordCount is 1,000 on the layer and on the table, with pagination; capabilities Map, Query and Data; ArcGIS Server 11.3; native Web Mercator (WKID 102100); the server reflects the caller's Origin for CORS. TERMS: the service's copyright text reads 'Sussex County Government' and no license text is published on the service, so the license is recorded as unknown and the copyright text is carried as the credit. The contact URL is the parcel service's own page, which answered HTTP 200 on 2026-11-11; the county's website was not read. Credit: Sussex County Government",
101
+ "credit": "Sussex County Government",
102
+ "addedAt": "2026-11-11"
44
103
  }
45
104
  ]
46
105
  }
package/data/index.json CHANGED
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "version": "0.3.0",
3
- "lastUpdated": "2026-11-10",
3
+ "lastUpdated": "2026-11-11",
4
4
  "totals": {
5
5
  "states": 51,
6
- "counties": 538,
7
- "endpoints": 521,
8
- "countiesWithEndpoint": 493,
6
+ "counties": 539,
7
+ "endpoints": 522,
8
+ "countiesWithEndpoint": 494,
9
9
  "countiesUnprobeable": 1
10
10
  },
11
11
  "states": [
@@ -69,8 +69,8 @@
69
69
  "slug": "delaware",
70
70
  "name": "Delaware",
71
71
  "abbrev": "DE",
72
- "countyCount": 1,
73
- "endpointCount": 1,
72
+ "countyCount": 2,
73
+ "endpointCount": 2,
74
74
  "populated": true
75
75
  },
76
76
  {
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-10",
401
+ lastUpdated: "2026-11-11",
402
402
  totals: {
403
403
  states: 51,
404
- counties: 538,
405
- endpoints: 521,
406
- countiesWithEndpoint: 493,
404
+ counties: 539,
405
+ endpoints: 522,
406
+ countiesWithEndpoint: 494,
407
407
  countiesUnprobeable: 1
408
408
  },
409
409
  states: [
@@ -467,8 +467,8 @@ var data_default = {
467
467
  slug: "delaware",
468
468
  name: "Delaware",
469
469
  abbrev: "DE",
470
- countyCount: 1,
471
- endpointCount: 1,
470
+ countyCount: 2,
471
+ endpointCount: 2,
472
472
  populated: true
473
473
  },
474
474
  {
@@ -5921,7 +5921,7 @@ var delaware_default = {
5921
5921
  stateSlug: "delaware",
5922
5922
  stateName: "Delaware",
5923
5923
  stateAbbrev: "DE",
5924
- lastUpdated: "2026-06-20",
5924
+ lastUpdated: "2026-11-11",
5925
5925
  counties: [
5926
5926
  {
5927
5927
  id: "de-new-castle",
@@ -5960,6 +5960,65 @@ var delaware_default = {
5960
5960
  email: null
5961
5961
  },
5962
5962
  notes: "New Castle County DE (Wilmington/Newark metro; county seat Wilmington; FIPS 10003; most populous of Delaware's 3 counties, pop. ~570,000) publishes a public ArcGIS MapServer parcel layer hosted by NCCDE GIS (Foundation/Base_Layers/MapServer/0, 'Parcels', ~203,753 features, no token required). Key fields: PRCLID (parcel ID / APN), CNTCTLAST (owner last name / contact, the searchable owner field), OWNADDR (owner mailing address), ADDRESS (property situs address). Owner-name search via UPPER(CNTCTLAST) LIKE UPPER('%NAME%') works. Verified 2026-06-20: UPPER(CNTCTLAST) LIKE UPPER('%SMITH%') returns Wilmington-area parcels. Delaware has only 3 counties (New Castle, Kent, Sussex); Kent and Sussex are served separately. Do not confuse with New Castle in Pennsylvania (Lawrence County, PA)."
5963
+ },
5964
+ {
5965
+ id: "de-sussex",
5966
+ state: "DE",
5967
+ stateName: "Delaware",
5968
+ stateSlug: "delaware",
5969
+ county: "Sussex",
5970
+ countySlug: "sussex-county",
5971
+ countyFips: "10005",
5972
+ hasPublicRest: true,
5973
+ endpoints: [
5974
+ {
5975
+ url: "https://map.sussexcountyde.gov/trdserver/rest/services/Geographic_Information_Office/Parcels_PIN/MapServer/0",
5976
+ serviceType: "MapServer",
5977
+ layerIndex: 0,
5978
+ layerName: "Tax Parcels",
5979
+ supportsQuery: true,
5980
+ corsEnabled: true,
5981
+ searchFields: [
5982
+ { name: "Name", label: "Parcel ID (PIN)", searchable: true }
5983
+ ],
5984
+ ownerJoin: {
5985
+ url: "https://map.sussexcountyde.gov/trdserver/rest/services/Geographic_Information_Office/Parcels_PIN/MapServer/1",
5986
+ layerName: "OwnershipInformation",
5987
+ key: "PIN",
5988
+ parcelKey: "Name",
5989
+ fields: [
5990
+ { name: "PIN", label: "Parcel ID (PIN)", searchable: true },
5991
+ { name: "PINWASSEMENTUNIT", label: "PIN with Assessment Unit", searchable: false },
5992
+ { name: "FULLNAME", label: "Owner Name", searchable: true },
5993
+ { name: "Second_Owner_Name", label: "Second Owner Name", searchable: false },
5994
+ { name: "MAILINGADDRESS", label: "Owner Mailing Address", searchable: false },
5995
+ { name: "CITY", label: "Owner Mailing City", searchable: false },
5996
+ { name: "STATE", label: "Owner Mailing State", searchable: false },
5997
+ { name: "ZIPCODE", label: "Owner Mailing ZIP", searchable: false }
5998
+ ],
5999
+ rowIdField: "PINWASSEMENTUNIT",
6000
+ multiple: "rows",
6001
+ maxRowsPerKey: 1e3,
6002
+ orderField: "OBJECTID_1",
6003
+ maxRecordCount: 1e3,
6004
+ lastVerified: "2026-11-11"
6005
+ },
6006
+ sampleQuery: "https://map.sussexcountyde.gov/trdserver/rest/services/Geographic_Information_Office/Parcels_PIN/MapServer/0/query?where=Name%3D%27133-11.00-8.00%27&outFields=Name&returnGeometry=false&f=json",
6007
+ license: "unknown",
6008
+ licenseUrl: null,
6009
+ status: "live",
6010
+ lastVerified: "2026-11-11",
6011
+ verifiedBy: "manual"
6012
+ }
6013
+ ],
6014
+ contact: {
6015
+ department: "Sussex County Government, Geographic Information Office (the name of the parcel service's folder)",
6016
+ url: "https://map.sussexcountyde.gov/trdserver/rest/services/Geographic_Information_Office/Parcels_PIN/MapServer",
6017
+ email: null
6018
+ },
6019
+ notes: "Sussex County, Delaware (Georgetown; FIPS 10005). The county's own ArcGIS Server at map.sussexcountyde.gov publishes Geographic_Information_Office/Parcels_PIN, a MapServer it describes as 'Sussex County Delaware Tax Parcel Map with Related Ownership Information Table'. THE OWNERS ARE NOT ON THE PARCEL LAYER. Layer 0, 'Tax Parcels', holds the polygons (165,012 on 2026-11-11) and is documented here by one column: Name, which is the parcel's PIN (133-11.00-8.00: digits, dashes and dots, not zero-padded). It carries no owner and no site address. The owner rows are in table 1 of the same service, 'OwnershipInformation' (208,124 rows), keyed by PIN; the service itself relates the layer's Name to the table's PIN, one parcel to many rows, and this record names that table as the layer's owner join. The table has no geometry, so it is asked by key only (PIN IN a list of parcel PINs), never by location, and every row it returns must echo a key that was asked. On the table, FULLNAME is the owner (null or empty on none of its rows) and Second_Owner_Name a second owner; MAILINGADDRESS is the street line of the owner's mailing address (null or empty on 274 rows), and the city, state and ZIP are the separate columns CITY, STATE and ZIPCODE. A paid radius list carries the owner name and the mailing street line; the city, state and ZIP stay in the county table's columns and are not joined onto that line. SEVERAL ROWS PER PARCEL: 43,273 table rows (20.8%) carry an assessment unit, where PINWASSEMENTUNIT is the PIN, a dash and the unit; that column labels the rows of one PIN but is not unique, so a parcel's rows are told apart by the owner and mailing line they carry. One PIN holds 1,093 rows, more than the table returns to one query. Some parcels have no table row at all (51 neighbouring lots of map block 233-11.00 on 2026-11-10); they are served without an owner. NO SITE ADDRESS is published on the layer or the table, so an address lookup cannot be answered from this record: a search by PIN and a point or radius lookup are what it offers. Verified 2026-11-11: Name = '133-11.00-8.00' returned one parcel, the sample query's predicate; five PINs read off the layer were asked of the table and every row it returned echoed an asked key; UPPER(FULLNAME) LIKE '%SMITH%' counted 1,603 table rows. maxRecordCount is 1,000 on the layer and on the table, with pagination; capabilities Map, Query and Data; ArcGIS Server 11.3; native Web Mercator (WKID 102100); the server reflects the caller's Origin for CORS. TERMS: the service's copyright text reads 'Sussex County Government' and no license text is published on the service, so the license is recorded as unknown and the copyright text is carried as the credit. The contact URL is the parcel service's own page, which answered HTTP 200 on 2026-11-11; the county's website was not read. Credit: Sussex County Government",
6020
+ credit: "Sussex County Government",
6021
+ addedAt: "2026-11-11"
5963
6022
  }
5964
6023
  ]
5965
6024
  };
package/dist/index.d.cts CHANGED
@@ -217,8 +217,8 @@ interface SearchField {
217
217
  * Owner rows that live in a separate TABLE of the same service, joined to the
218
218
  * endpoint's parcel polygons by a key: the polygons carry `parcelKey`, the
219
219
  * table carries `key`, and a parcel's owners are the table rows whose `key`
220
- * equals its `parcelKey` value. Declared since 0.9.0 and carried by NO record
221
- * yet.
220
+ * equals its `parcelKey` value. Declared since 0.9.0; Sussex County, Delaware
221
+ * (0.9.1) is the first record that carries one.
222
222
  *
223
223
  * The table has no geometry. Query it by key only
224
224
  * (`<key> IN ('<value>', ...)`, each `'` doubled), never spatially: an ArcGIS
@@ -252,10 +252,13 @@ interface OwnerJoin {
252
252
  * up to `maxRowsPerKey` of them. Absent: treat a key with several rows as
253
253
  * having no single owner rather than picking one. */
254
254
  multiple?: "rows";
255
- /** The most table rows one key may hold and still be read as its ownership
256
- * records: an integer from 1 to `maxRecordCount`, present exactly when
257
- * `multiple` is `"rows"`. Treat a key with more rows as having no owner you
258
- * can state (a single key can hold more rows than one query returns). */
255
+ /** The most distinct ownership rows one key may hold and still be read as its
256
+ * ownership records: an integer from 1 to `maxRecordCount`, present exactly
257
+ * when `multiple` is `"rows"`. Count a key's rows after de-duplicating them
258
+ * by the owner and mailing content you read and dropping any row that says
259
+ * nothing another row of the key does not. Treat a key with more than that
260
+ * as having no owner you can state (a single key can hold more rows than one
261
+ * query returns). */
259
262
  maxRowsPerKey?: number;
260
263
  /** A unique, stable column to order the table's pages by: send it as
261
264
  * `orderByFields` whenever you send `resultOffset`, or a paged read can
@@ -423,7 +426,8 @@ interface EndpointRecord {
423
426
  * such column, not that no owner there is protected. */
424
427
  confidentialFlag?: ConfidentialFlag;
425
428
  /** The table that holds this layer's owner rows (see {@link OwnerJoin}).
426
- * Declared since 0.9.0; absent on every record today. */
429
+ * Declared since 0.9.0; carried by Sussex County, Delaware since 0.9.1 and
430
+ * absent on every other record. */
427
431
  ownerJoin?: OwnerJoin;
428
432
  sampleQuery: string | null;
429
433
  license: LicenseType;
@@ -492,7 +496,9 @@ interface CapabilityBasis {
492
496
  * deliberately does not derive it: a second implementation of that
493
497
  * classification would drift from the one the API bills against, and you would
494
498
  * have no way to tell which was right. Read `endpoints[].searchFields` for the
495
- * mechanical answer, and treat an entry here as outranking it.
499
+ * mechanical answer, plus `endpoints[].ownerJoin.fields` on a layer whose owner
500
+ * rows sit in a joined table (see {@link OwnerJoin}), and treat an entry here
501
+ * as outranking it.
496
502
  */
497
503
  type CapabilityOverrides = Partial<Record<CapabilityField, {
498
504
  status: CapabilityStatus;
@@ -631,7 +637,8 @@ declare function countyOffersAttributeSearch(county: Pick<CountyRecord, "endpoin
631
637
  * Null is the common answer and it is not a failure: it means nobody has had to
632
638
  * write anything down about that field for that county, so the ordinary rules
633
639
  * apply. Read `county.endpoints[].searchFields` to see what the layer actually
634
- * documents.
640
+ * documents, and `endpoints[].ownerJoin.fields` for the owner columns of a
641
+ * layer that keeps them in a joined table.
635
642
  *
636
643
  * A non-null answer is the part worth branching on. It was entered by a human
637
644
  * who checked something a field list cannot show, and it outranks whatever the
@@ -646,7 +653,8 @@ declare function reviewedCapability(county: Pick<CountyRecord, "capabilityOverri
646
653
  * reason. Use it to decide whether to promise a user the field at all.
647
654
  *
648
655
  * False does NOT mean "available". It means no reviewed record says otherwise,
649
- * so fall back to the endpoint's documented `searchFields`.
656
+ * so fall back to the endpoint's documented `searchFields` (and its
657
+ * `ownerJoin.fields`, where it has a joined owner table).
650
658
  */
651
659
  declare function isReviewedUnservable(county: Pick<CountyRecord, "capabilityOverrides">, field: CapabilityField): boolean;
652
660
 
package/dist/index.d.ts CHANGED
@@ -217,8 +217,8 @@ interface SearchField {
217
217
  * Owner rows that live in a separate TABLE of the same service, joined to the
218
218
  * endpoint's parcel polygons by a key: the polygons carry `parcelKey`, the
219
219
  * table carries `key`, and a parcel's owners are the table rows whose `key`
220
- * equals its `parcelKey` value. Declared since 0.9.0 and carried by NO record
221
- * yet.
220
+ * equals its `parcelKey` value. Declared since 0.9.0; Sussex County, Delaware
221
+ * (0.9.1) is the first record that carries one.
222
222
  *
223
223
  * The table has no geometry. Query it by key only
224
224
  * (`<key> IN ('<value>', ...)`, each `'` doubled), never spatially: an ArcGIS
@@ -252,10 +252,13 @@ interface OwnerJoin {
252
252
  * up to `maxRowsPerKey` of them. Absent: treat a key with several rows as
253
253
  * having no single owner rather than picking one. */
254
254
  multiple?: "rows";
255
- /** The most table rows one key may hold and still be read as its ownership
256
- * records: an integer from 1 to `maxRecordCount`, present exactly when
257
- * `multiple` is `"rows"`. Treat a key with more rows as having no owner you
258
- * can state (a single key can hold more rows than one query returns). */
255
+ /** The most distinct ownership rows one key may hold and still be read as its
256
+ * ownership records: an integer from 1 to `maxRecordCount`, present exactly
257
+ * when `multiple` is `"rows"`. Count a key's rows after de-duplicating them
258
+ * by the owner and mailing content you read and dropping any row that says
259
+ * nothing another row of the key does not. Treat a key with more than that
260
+ * as having no owner you can state (a single key can hold more rows than one
261
+ * query returns). */
259
262
  maxRowsPerKey?: number;
260
263
  /** A unique, stable column to order the table's pages by: send it as
261
264
  * `orderByFields` whenever you send `resultOffset`, or a paged read can
@@ -423,7 +426,8 @@ interface EndpointRecord {
423
426
  * such column, not that no owner there is protected. */
424
427
  confidentialFlag?: ConfidentialFlag;
425
428
  /** The table that holds this layer's owner rows (see {@link OwnerJoin}).
426
- * Declared since 0.9.0; absent on every record today. */
429
+ * Declared since 0.9.0; carried by Sussex County, Delaware since 0.9.1 and
430
+ * absent on every other record. */
427
431
  ownerJoin?: OwnerJoin;
428
432
  sampleQuery: string | null;
429
433
  license: LicenseType;
@@ -492,7 +496,9 @@ interface CapabilityBasis {
492
496
  * deliberately does not derive it: a second implementation of that
493
497
  * classification would drift from the one the API bills against, and you would
494
498
  * have no way to tell which was right. Read `endpoints[].searchFields` for the
495
- * mechanical answer, and treat an entry here as outranking it.
499
+ * mechanical answer, plus `endpoints[].ownerJoin.fields` on a layer whose owner
500
+ * rows sit in a joined table (see {@link OwnerJoin}), and treat an entry here
501
+ * as outranking it.
496
502
  */
497
503
  type CapabilityOverrides = Partial<Record<CapabilityField, {
498
504
  status: CapabilityStatus;
@@ -631,7 +637,8 @@ declare function countyOffersAttributeSearch(county: Pick<CountyRecord, "endpoin
631
637
  * Null is the common answer and it is not a failure: it means nobody has had to
632
638
  * write anything down about that field for that county, so the ordinary rules
633
639
  * apply. Read `county.endpoints[].searchFields` to see what the layer actually
634
- * documents.
640
+ * documents, and `endpoints[].ownerJoin.fields` for the owner columns of a
641
+ * layer that keeps them in a joined table.
635
642
  *
636
643
  * A non-null answer is the part worth branching on. It was entered by a human
637
644
  * who checked something a field list cannot show, and it outranks whatever the
@@ -646,7 +653,8 @@ declare function reviewedCapability(county: Pick<CountyRecord, "capabilityOverri
646
653
  * reason. Use it to decide whether to promise a user the field at all.
647
654
  *
648
655
  * False does NOT mean "available". It means no reviewed record says otherwise,
649
- * so fall back to the endpoint's documented `searchFields`.
656
+ * so fall back to the endpoint's documented `searchFields` (and its
657
+ * `ownerJoin.fields`, where it has a joined owner table).
650
658
  */
651
659
  declare function isReviewedUnservable(county: Pick<CountyRecord, "capabilityOverrides">, field: CapabilityField): boolean;
652
660
 
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-10",
399
+ lastUpdated: "2026-11-11",
400
400
  totals: {
401
401
  states: 51,
402
- counties: 538,
403
- endpoints: 521,
404
- countiesWithEndpoint: 493,
402
+ counties: 539,
403
+ endpoints: 522,
404
+ countiesWithEndpoint: 494,
405
405
  countiesUnprobeable: 1
406
406
  },
407
407
  states: [
@@ -465,8 +465,8 @@ var data_default = {
465
465
  slug: "delaware",
466
466
  name: "Delaware",
467
467
  abbrev: "DE",
468
- countyCount: 1,
469
- endpointCount: 1,
468
+ countyCount: 2,
469
+ endpointCount: 2,
470
470
  populated: true
471
471
  },
472
472
  {
@@ -5919,7 +5919,7 @@ var delaware_default = {
5919
5919
  stateSlug: "delaware",
5920
5920
  stateName: "Delaware",
5921
5921
  stateAbbrev: "DE",
5922
- lastUpdated: "2026-06-20",
5922
+ lastUpdated: "2026-11-11",
5923
5923
  counties: [
5924
5924
  {
5925
5925
  id: "de-new-castle",
@@ -5958,6 +5958,65 @@ var delaware_default = {
5958
5958
  email: null
5959
5959
  },
5960
5960
  notes: "New Castle County DE (Wilmington/Newark metro; county seat Wilmington; FIPS 10003; most populous of Delaware's 3 counties, pop. ~570,000) publishes a public ArcGIS MapServer parcel layer hosted by NCCDE GIS (Foundation/Base_Layers/MapServer/0, 'Parcels', ~203,753 features, no token required). Key fields: PRCLID (parcel ID / APN), CNTCTLAST (owner last name / contact, the searchable owner field), OWNADDR (owner mailing address), ADDRESS (property situs address). Owner-name search via UPPER(CNTCTLAST) LIKE UPPER('%NAME%') works. Verified 2026-06-20: UPPER(CNTCTLAST) LIKE UPPER('%SMITH%') returns Wilmington-area parcels. Delaware has only 3 counties (New Castle, Kent, Sussex); Kent and Sussex are served separately. Do not confuse with New Castle in Pennsylvania (Lawrence County, PA)."
5961
+ },
5962
+ {
5963
+ id: "de-sussex",
5964
+ state: "DE",
5965
+ stateName: "Delaware",
5966
+ stateSlug: "delaware",
5967
+ county: "Sussex",
5968
+ countySlug: "sussex-county",
5969
+ countyFips: "10005",
5970
+ hasPublicRest: true,
5971
+ endpoints: [
5972
+ {
5973
+ url: "https://map.sussexcountyde.gov/trdserver/rest/services/Geographic_Information_Office/Parcels_PIN/MapServer/0",
5974
+ serviceType: "MapServer",
5975
+ layerIndex: 0,
5976
+ layerName: "Tax Parcels",
5977
+ supportsQuery: true,
5978
+ corsEnabled: true,
5979
+ searchFields: [
5980
+ { name: "Name", label: "Parcel ID (PIN)", searchable: true }
5981
+ ],
5982
+ ownerJoin: {
5983
+ url: "https://map.sussexcountyde.gov/trdserver/rest/services/Geographic_Information_Office/Parcels_PIN/MapServer/1",
5984
+ layerName: "OwnershipInformation",
5985
+ key: "PIN",
5986
+ parcelKey: "Name",
5987
+ fields: [
5988
+ { name: "PIN", label: "Parcel ID (PIN)", searchable: true },
5989
+ { name: "PINWASSEMENTUNIT", label: "PIN with Assessment Unit", searchable: false },
5990
+ { name: "FULLNAME", label: "Owner Name", searchable: true },
5991
+ { name: "Second_Owner_Name", label: "Second Owner Name", searchable: false },
5992
+ { name: "MAILINGADDRESS", label: "Owner Mailing Address", searchable: false },
5993
+ { name: "CITY", label: "Owner Mailing City", searchable: false },
5994
+ { name: "STATE", label: "Owner Mailing State", searchable: false },
5995
+ { name: "ZIPCODE", label: "Owner Mailing ZIP", searchable: false }
5996
+ ],
5997
+ rowIdField: "PINWASSEMENTUNIT",
5998
+ multiple: "rows",
5999
+ maxRowsPerKey: 1e3,
6000
+ orderField: "OBJECTID_1",
6001
+ maxRecordCount: 1e3,
6002
+ lastVerified: "2026-11-11"
6003
+ },
6004
+ sampleQuery: "https://map.sussexcountyde.gov/trdserver/rest/services/Geographic_Information_Office/Parcels_PIN/MapServer/0/query?where=Name%3D%27133-11.00-8.00%27&outFields=Name&returnGeometry=false&f=json",
6005
+ license: "unknown",
6006
+ licenseUrl: null,
6007
+ status: "live",
6008
+ lastVerified: "2026-11-11",
6009
+ verifiedBy: "manual"
6010
+ }
6011
+ ],
6012
+ contact: {
6013
+ department: "Sussex County Government, Geographic Information Office (the name of the parcel service's folder)",
6014
+ url: "https://map.sussexcountyde.gov/trdserver/rest/services/Geographic_Information_Office/Parcels_PIN/MapServer",
6015
+ email: null
6016
+ },
6017
+ notes: "Sussex County, Delaware (Georgetown; FIPS 10005). The county's own ArcGIS Server at map.sussexcountyde.gov publishes Geographic_Information_Office/Parcels_PIN, a MapServer it describes as 'Sussex County Delaware Tax Parcel Map with Related Ownership Information Table'. THE OWNERS ARE NOT ON THE PARCEL LAYER. Layer 0, 'Tax Parcels', holds the polygons (165,012 on 2026-11-11) and is documented here by one column: Name, which is the parcel's PIN (133-11.00-8.00: digits, dashes and dots, not zero-padded). It carries no owner and no site address. The owner rows are in table 1 of the same service, 'OwnershipInformation' (208,124 rows), keyed by PIN; the service itself relates the layer's Name to the table's PIN, one parcel to many rows, and this record names that table as the layer's owner join. The table has no geometry, so it is asked by key only (PIN IN a list of parcel PINs), never by location, and every row it returns must echo a key that was asked. On the table, FULLNAME is the owner (null or empty on none of its rows) and Second_Owner_Name a second owner; MAILINGADDRESS is the street line of the owner's mailing address (null or empty on 274 rows), and the city, state and ZIP are the separate columns CITY, STATE and ZIPCODE. A paid radius list carries the owner name and the mailing street line; the city, state and ZIP stay in the county table's columns and are not joined onto that line. SEVERAL ROWS PER PARCEL: 43,273 table rows (20.8%) carry an assessment unit, where PINWASSEMENTUNIT is the PIN, a dash and the unit; that column labels the rows of one PIN but is not unique, so a parcel's rows are told apart by the owner and mailing line they carry. One PIN holds 1,093 rows, more than the table returns to one query. Some parcels have no table row at all (51 neighbouring lots of map block 233-11.00 on 2026-11-10); they are served without an owner. NO SITE ADDRESS is published on the layer or the table, so an address lookup cannot be answered from this record: a search by PIN and a point or radius lookup are what it offers. Verified 2026-11-11: Name = '133-11.00-8.00' returned one parcel, the sample query's predicate; five PINs read off the layer were asked of the table and every row it returned echoed an asked key; UPPER(FULLNAME) LIKE '%SMITH%' counted 1,603 table rows. maxRecordCount is 1,000 on the layer and on the table, with pagination; capabilities Map, Query and Data; ArcGIS Server 11.3; native Web Mercator (WKID 102100); the server reflects the caller's Origin for CORS. TERMS: the service's copyright text reads 'Sussex County Government' and no license text is published on the service, so the license is recorded as unknown and the copyright text is carried as the credit. The contact URL is the parcel service's own page, which answered HTTP 200 on 2026-11-11; the county's website was not read. Credit: Sussex County Government",
6018
+ credit: "Sussex County Government",
6019
+ addedAt: "2026-11-11"
5961
6020
  }
5962
6021
  ]
5963
6022
  };
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@urbankitstudio/atlas",
3
- "version": "0.9.0",
4
- "description": "JS SDK for the UrbanKit County Parcel REST API Atlas: 538 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.1",
4
+ "description": "JS SDK for the UrbanKit County Parcel REST API Atlas: 539 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",