@urbankitstudio/atlas 0.6.45 → 0.6.47

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,73 @@
1
1
  # @urbankitstudio/atlas Changelog
2
2
 
3
+ ## 0.6.47 — 2026-10-26
4
+
5
+ No data change. The hosted API, the hosted MCP and the site's free tools now read `safeValues`: they keep
6
+ a flagged layer's row only when its flag cell is one of the listed safe values and, trimmed and
7
+ upper-cased, holds no marker value anywhere in it, whatever the marker's length. Every other row is
8
+ withheld as `county-redacted`, a NULL cell included, and so is every row of a layer whose flag lists no
9
+ safe values. That is the rule this package's README has advised since 0.6.46, up to padding: trailing
10
+ U+0020 spaces are ignored on both sides of a string safe value, and an integer safe value also matches
11
+ text that trims (JavaScript `trim`) to its decimal form, so the hosted reader also keeps unpadded or
12
+ whitespace-wrapped forms of a safe cell. None of those forms can carry a marker: the marker test reads the
13
+ cell itself, and validate-atlas refuses a safe value that holds one. On the 2026-10-25 measurements that
14
+ newly withholds Harris's 5,235 and Collin's 15,003 NULL-flag rows; Ector is unchanged. A withheld row is
15
+ never billed: PAYG never meters it, and a plan unit reserved before the row was found withheld is refunded.
16
+ When that refund cannot be confirmed, the unit still counts against the quota and the response says so
17
+ (`plan_quota.refund` on `enrich_address`, `refunded: false` on a bulk row, radius's `charged`). A pay-as-you-go replay of an MCP `enrich_address` operation already paid returns the stored result as it would be served today, withheld when its county now withholds it, keeping the original `billed`, `operation_id` and charge and charging nothing new. When the stored result's county cannot be established, that replay is withheld as `county-unresolved`, with owner, mailing address, site address, parcel id and its county fields null where the stored result has them (a field it lacks stays absent). When the fresh lookup is itself withheld as `county-redacted`, that is the reason returned instead, and the same fields stay withheld. The README and the `ConfidentialFlag` comment no longer say the hosted reader serves a NULL
18
+ cell as unflagged.
19
+
20
+ ## 0.6.46 — 2026-10-26
21
+
22
+ Every confidential-flagged record now lists the exact raw cells its layer holds for an UNFLAGGED owner, and
23
+ the advised `where` keeps only those. `ConfidentialFlag` gains `safeValues?: Array<string | number>`
24
+ (optional in the type so older data still type-checks; present on all three flagged records). `totals` are
25
+ unchanged.
26
+
27
+ ### Why: a contains test in SQL cannot be trusted on every backend
28
+
29
+ The 0.6.44 clause `CAST(<field> AS VARCHAR(255)) NOT LIKE '%<value>%'` is a contains test written in SQL,
30
+ and an adversarial review showed it cannot match the JavaScript rule (trim, upper-case, contains) on every
31
+ county backend: non-ASCII upper-casing, an embedded NUL that stops `LIKE`, the 255-character cast and mixed
32
+ encodings can each let a flagged cell read as clean. The fix is fail-closed: AND `<field> IN (<safeValues>)`,
33
+ so a row survives only when its raw cell is exactly a value measured as safe, whatever the backend does with
34
+ text. The rule for consumers: keep a row only if its raw cell equals a listed safe value AND the cell,
35
+ trimmed and upper-cased, contains no marker value; a NULL or missing cell is flagged.
36
+
37
+ ### The measured safe values
38
+
39
+ Measured live 2026-10-26 with `returnDistinctValues` (complete lists, `exceededTransferLimit` false):
40
+
41
+ - **Harris** (`tx-harris`, `confidential_flag`, a string): `[" ", "N ", "NNN ",
42
+ "NNNNNNNNNN"]`, every entry ten characters (ten spaces; `N` and nine spaces; `NNN` and seven spaces; ten
43
+ `N`s).
44
+ - **Collin** (`tx-collin`, `GIS_DBO_AD_Entity_confidential_`, a string): `["F"]`.
45
+ - **Ector** (`tx-ector`, `conf_flg`, a small integer): `[0]`, a JSON number.
46
+
47
+ `<field> IN (<safeValues>)` keeps exactly the rows the 0.6.44 clause keeps (Harris 1,541,671; Collin 435,783;
48
+ Ector 77,042), and the two ANDed together keep the same counts.
49
+
50
+ ### The flagged records' sample queries carry both clauses
51
+
52
+ Each `sampleQuery` appends ` AND <field> IN (...)` inside its `where`, after the CAST clause. Strings are
53
+ single-quoted with `'` doubled, integers bare, joined by `, ` in the listed order; the column is not cast and
54
+ not upper-cased:
55
+
56
+ - **Harris**: `... AND confidential_flag IN (' ', 'N ', 'NNN ', 'NNNNNNNNNN')`
57
+ - **Collin**: `... AND GIS_DBO_AD_Entity_confidential_ IN ('F')`
58
+ - **Ector**: `... AND conf_flg IN (0)`
59
+
60
+ Each record's `notes` gives the same clause. The published directory CSV/JSON probe, the site's owner-search
61
+ examples and the `llms-full.txt` line for these counties carry it too.
62
+
63
+ `validate-atlas` now fails a `confidentialFlag` without a non-empty `safeValues`; a safe value that is neither a
64
+ printable-ASCII string without a backslash (`/^[\x20-\x5b\x5d-\x7e]*$/`, padding and the empty string
65
+ allowed; a backend that reads `\` as an escape would end the literal early) nor a safe integer; a
66
+ repeated safe value; a safe value that is itself flagged (trimmed and upper-cased, it contains a marker
67
+ value, so listing it would let a flagged row through); a `sampleQuery` whose `where` does not end with both
68
+ clauses; and two registrations of one layer whose `safeValues` differ. The hosted reader
69
+ (`isConfidentialFlagged`) does not read `safeValues` yet.
70
+
3
71
  ## 0.6.45 — 2026-10-25
4
72
 
5
73
  Two counties join, each with a searchable owner-name field: Stafford County, Virginia (`va-stafford`, FIPS
package/README.md CHANGED
@@ -252,20 +252,31 @@ written.
252
252
 
253
253
  ## Some layers flag an owner's record confidential
254
254
 
255
- An endpoint may carry `confidentialFlag: { field, values }` (type `ConfidentialFlag`).
256
- Texas Tax Code §25.025 lets peace officers, judges, family-violence victims and
257
- others have their home address kept confidential in appraisal records, and Harris
258
- (`confidential_flag`, `"Y"`) and Collin (`GIS_DBO_AD_Entity_confidential_`, `"T"`)
259
- publish those accounts with the owner and a flag column beside it. A row whose
260
- flag is set must not be shown or passed on. Request the column whenever you
261
- request the owner, and drop a row whose cell, trimmed and upper-cased, equals a
262
- listed value or, for a one-character value, contains it (Harris packs one flag per
263
- ownership slot into a ten-character string: `"YNNNNNNNNN"` is slot 1 confidential).
264
- Treat a row that lacks the column as flagged. The hosted API and MCP withhold such
265
- a row with `withheld: "county-redacted"`. Ector (`conf_flg`, `"1"`) carries a forward
266
- guess: the column was 0 on every row when measured, so the marker names a value the
255
+ An endpoint may carry `confidentialFlag: { field, values, safeValues }` (type
256
+ `ConfidentialFlag`). Texas Tax Code §25.025 lets peace officers, judges,
257
+ family-violence victims and others have their home address kept confidential in
258
+ appraisal records, and Harris (`confidential_flag`, `"Y"`) and Collin
259
+ (`GIS_DBO_AD_Entity_confidential_`, `"T"`) publish those accounts with the owner
260
+ and a flag column beside it. A row whose flag is set must not be shown or passed
261
+ on. Request the column whenever you request the owner, and keep a row only if its
262
+ raw cell equals one of `safeValues` AND the cell, trimmed and upper-cased, contains
263
+ no listed value (Harris packs one flag per ownership slot into a ten-character
264
+ string: `"YNNNNNNNNN"` is slot 1 confidential). A NULL cell, or a row that lacks
265
+ the column, is flagged. The hosted API and MCP withhold a flagged row with
266
+ `withheld: "county-redacted"`. Ector (`conf_flg`, `"1"`) carries a forward guess:
267
+ the column was 0 on every row when measured, so the marker names a value the
267
268
  county has not yet published (the record's `notes` say so).
268
269
 
270
+ `safeValues` lists the exact raw cells each layer holds for an unflagged owner,
271
+ measured 2026-10-26 with `returnDistinctValues` (complete lists): Harris
272
+ `[" ", "N ", "NNN ", "NNNNNNNNNN"]`, every entry ten
273
+ characters with its padding (ten spaces; `N` and nine spaces; `NNN` and seven
274
+ spaces; ten `N`s); Collin `["F"]`; Ector `[0]`, a number, because `conf_flg` is
275
+ an integer column. It is there because a contains test written in SQL cannot
276
+ match the rule above on every county backend (non-ASCII upper-casing, an embedded
277
+ NUL that stops `LIKE`, the 255-character cast, mixed encodings): a cell that is
278
+ not exactly a listed safe value drops out, whatever the backend does with text.
279
+
269
280
  In a `where` clause, cast the column to text first: a one-character value needs
270
281
  `CAST(<field> AS VARCHAR(255)) NOT LIKE '%<value>%'` (an equality test keeps
271
282
  Harris's `"YNNNNNNNNN"` rows), and that includes Collin's `"T"`; a longer value
@@ -280,23 +291,48 @@ filter in your own code trims. `UPPER(CAST(<field> AS VARCHAR(255)))` also runs
280
291
  on all three if you want the comparison case-blind. Measured 2026-10-25: Harris
281
292
  has 470,972 blank cells that hold spaces, and the clause keeps them; it also has
282
293
  5,235 NULL cells, and Collin has 15,003. A NULL cell fails the clause and the
283
- row drops out; a missing column makes the query fail. The hosted API serves a
284
- NULL cell as unflagged, so the SQL route and the hosted API differ on those rows
285
- (Harris 5,235 and Collin 15,003, measured 2026-10-25). Each flagged record's
286
- `sampleQuery` requests the column and carries the clause.
294
+ row drops out; a missing column makes the query fail. Since 0.6.47 the hosted API,
295
+ the hosted MCP and the site's free tools keep the same rows, plus unpadded or
296
+ whitespace-wrapped forms of a safe cell, none of which can carry a marker: they
297
+ ignore trailing spaces (U+0020) on both sides of a string safe value, match an
298
+ integer safe value against text that trims (JavaScript `trim`) to its decimal
299
+ form, withhold a cell that holds a listed value anywhere in it, whatever that
300
+ value's length, and withhold every row of a layer whose flag lists no safe
301
+ values. So they withhold those NULL rows too.
302
+
303
+ Then AND `<field> IN (<safeValues>)`, with the column neither cast nor
304
+ upper-cased: strings single-quoted with `'` doubled, integers bare, joined by
305
+ `, ` in the listed order. Harris:
306
+ `confidential_flag IN (' ', 'N ', 'NNN ', 'NNNNNNNNNN')`;
307
+ Collin: `GIS_DBO_AD_Entity_confidential_ IN ('F')`; Ector: `conf_flg IN (0)`.
308
+ Measured live 2026-10-26, the IN clause alone keeps exactly the rows the cast
309
+ clause keeps (Harris 1,541,671; Collin 435,783; Ector 77,042), and so do the two
310
+ ANDed together. Each flagged record's `sampleQuery` requests the column and
311
+ carries both clauses.
287
312
 
288
313
  ```ts
289
314
  import { findCountyByFips } from "@urbankitstudio/atlas";
290
315
 
291
316
  const endpoint = findCountyByFips("48201")!.endpoints[0];
292
- const flag = endpoint.confidentialFlag; // { field: "confidential_flag", values: ["Y"] }
317
+ const flag = endpoint.confidentialFlag; // { field: "confidential_flag", values: ["Y"], safeValues: [...] }
293
318
  const cell = flag ? `CAST(${flag.field} AS VARCHAR(255))` : null;
319
+ const literal = (v: string | number) => (typeof v === "number" ? String(v) : `'${v.replace(/'/g, "''")}'`);
320
+ // A flag without safeValues cannot keep flagged rows out, so its query returns no rows.
294
321
  const notFlagged = flag
295
- ? flag.values.map((v) => (v.length === 1 ? `${cell} NOT LIKE '%${v}%'` : `${cell} <> '${v}'`)).join(" AND ")
322
+ ? flag.safeValues?.length
323
+ ? [
324
+ ...flag.values.map((v) => (v.length === 1 ? `${cell} NOT LIKE '%${v}%'` : `${cell} <> '${v}'`)),
325
+ `${flag.field} IN (${flag.safeValues.map(literal).join(", ")})`,
326
+ ].join(" AND ")
327
+ : "1=0"
296
328
  : null;
297
329
  const where = notFlagged ? `(${where0}) AND ${notFlagged}` : where0;
298
330
  ```
299
331
 
332
+ From 0.6.46 every flagged record carries a non-empty `safeValues`; the registry's
333
+ validator refuses a marker without one, or with a safe value that is itself
334
+ flagged.
335
+
300
336
  An absent `confidentialFlag` means the layer publishes no such column, not that no
301
337
  owner there is protected.
302
338
 
package/data/texas.json CHANGED
@@ -32,8 +32,8 @@
32
32
  { "name": "site_zip", "label": "Site ZIP", "searchable": true },
33
33
  { "name": "mail_addr_1", "label": "Mailing Address", "searchable": true }
34
34
  ],
35
- "confidentialFlag": { "field": "confidential_flag", "values": ["Y"] },
36
- "sampleQuery": "https://www.gis.hctx.net/arcgis/rest/services/HCAD/Parcels/MapServer/0/query?where=UPPER(owner_name_1)%20LIKE%20UPPER('%25SMITH%25')%20AND%20CAST(confidential_flag%20AS%20VARCHAR(255))%20NOT%20LIKE%20'%25Y%25'&outFields=HCAD_NUM,owner_name_1,site_str_num,site_str_name,site_city,confidential_flag&returnGeometry=false&f=json&resultRecordCount=10",
35
+ "confidentialFlag": { "field": "confidential_flag", "values": ["Y"], "safeValues": [" ", "N ", "NNN ", "NNNNNNNNNN"] },
36
+ "sampleQuery": "https://www.gis.hctx.net/arcgis/rest/services/HCAD/Parcels/MapServer/0/query?where=UPPER(owner_name_1)%20LIKE%20UPPER('%25SMITH%25')%20AND%20CAST(confidential_flag%20AS%20VARCHAR(255))%20NOT%20LIKE%20'%25Y%25'%20AND%20confidential_flag%20IN%20('%20%20%20%20%20%20%20%20%20%20',%20'N%20%20%20%20%20%20%20%20%20',%20'NNN%20%20%20%20%20%20%20',%20'NNNNNNNNNN')&outFields=HCAD_NUM,owner_name_1,site_str_num,site_str_name,site_city,confidential_flag&returnGeometry=false&f=json&resultRecordCount=10",
37
37
  "license": "public",
38
38
  "licenseUrl": "https://geo-harriscounty.opendata.arcgis.com/",
39
39
  "status": "live",
@@ -46,7 +46,7 @@
46
46
  "url": "https://geo-harriscounty.opendata.arcgis.com/",
47
47
  "email": null
48
48
  },
49
- "notes": "Harris County, Texas (Houston metro, pop. 4.7M, county seat Houston) is the most populous Texas county and third-most populous in the US. The data authority is HCAD, Harris Central Appraisal District, which maintains property appraisal records independently of the county government. 62 fields confirmed, including HCAD_NUM (parcel ID), acct_num, owner_name_1/2/3 (up to three ownership slots with own_pct_1/2/3 percentage shares), site_str_num, site_str_name, site_city, site_zip, mail_addr_1/2/3, mail_city, mail_state, mail_zip, land_use, land_value, bld_value, total_appraised_val, new_owner_date, and yr_impr. Owner name is public under the Texas Public Information Act; Texas Tax Code §25.025 allows certain categories of persons (peace officers, judges, domestic violence victims, and others) to request suppression of their home address from appraisal district records. HCAD publishes those accounts WITH the owner and marks them in confidential_flag, a ten-character string holding one Y/N per ownership slot (measured 2026-10-24: 1,551,736 rows; 'Y ' 1,658 and 'YNNNNNNNNN' 3,172, so 4,830 flagged, every Y in slot 1; 'NNNNNNNNNN' 1,066,977, 'N ' 3,721, blank 470,972, and 'NNN ' 1 measured 2026-10-25). The registry's confidentialFlag marker names that column, so a flagged row is withheld on every hosted surface (the REST API, the hosted MCP and the free tools, under any spelling of the layer URL); the stdio MCP server (@urbankitstudio/mcp-atlas) adds the exclusion to its own owner query in its next release; add AND CAST(confidential_flag AS VARCHAR(255)) NOT LIKE '%Y%' to any query of your own, as the sampleQuery does (measured 2026-10-25: 1,551,736 rows, 4,830 flagged and 5,235 with a NULL cell, and the clause keeps 1,541,671, dropping both: a NULL cell fails closed). Owner-name LIKE query confirmed live. Max record count = 1000 per query. The HCAD open-data hub at geo-harriscounty.opendata.arcgis.com provides bulk downloads. A sibling service on the same server covers HCAD_MUD (Municipal Utility District) boundaries."
49
+ "notes": "Harris County, Texas (Houston metro, pop. 4.7M, county seat Houston) is the most populous Texas county and third-most populous in the US. The data authority is HCAD, Harris Central Appraisal District, which maintains property appraisal records independently of the county government. 62 fields confirmed, including HCAD_NUM (parcel ID), acct_num, owner_name_1/2/3 (up to three ownership slots with own_pct_1/2/3 percentage shares), site_str_num, site_str_name, site_city, site_zip, mail_addr_1/2/3, mail_city, mail_state, mail_zip, land_use, land_value, bld_value, total_appraised_val, new_owner_date, and yr_impr. Owner name is public under the Texas Public Information Act; Texas Tax Code §25.025 allows certain categories of persons (peace officers, judges, domestic violence victims, and others) to request suppression of their home address from appraisal district records. HCAD publishes those accounts WITH the owner and marks them in confidential_flag, a ten-character string holding one Y/N per ownership slot (measured 2026-10-24: 1,551,736 rows; 'Y ' 1,658 and 'YNNNNNNNNN' 3,172, so 4,830 flagged, every Y in slot 1; 'NNNNNNNNNN' 1,066,977, 'N ' 3,721, blank 470,972, and 'NNN ' 1 measured 2026-10-25). The registry's confidentialFlag marker names that column, so a flagged row is withheld on every hosted surface (the REST API, the hosted MCP and the free tools, under any spelling of the layer URL); the stdio MCP server (@urbankitstudio/mcp-atlas) adds the exclusion to its own owner query in its next release; add AND CAST(confidential_flag AS VARCHAR(255)) NOT LIKE '%Y%' AND confidential_flag IN (' ', 'N ', 'NNN ', 'NNNNNNNNNN') to any query of your own, as the sampleQuery does (measured 2026-10-25: 1,551,736 rows, 4,830 flagged and 5,235 with a NULL cell, and the CAST clause keeps 1,541,671, dropping both: a NULL cell fails closed). The IN list is confidentialFlag.safeValues, every distinct raw cell an unflagged owner holds, each ten characters with its padding: ten spaces, N and nine spaces, NNN and seven spaces, ten Ns (measured 2026-10-26 with returnDistinctValues): a cell that is not exactly one of them drops out whatever the server's text handling does, and the IN clause alone, or both clauses together, keep the same 1,541,671 rows. Owner-name LIKE query confirmed live. Max record count = 1000 per query. The HCAD open-data hub at geo-harriscounty.opendata.arcgis.com provides bulk downloads. A sibling service on the same server covers HCAD_MUD (Municipal Utility District) boundaries."
50
50
  },
51
51
  {
52
52
  "id": "tx-travis",
@@ -260,8 +260,8 @@
260
260
  { "name": "GIS_DBO_Parcel_PROP_ID", "label": "Property ID (key)", "searchable": true },
261
261
  { "name": "GIS_DBO_Parcel_GEO_ID", "label": "Geographic ID", "searchable": true }
262
262
  ],
263
- "confidentialFlag": { "field": "GIS_DBO_AD_Entity_confidential_", "values": ["T"] },
264
- "sampleQuery": "https://gismaps.cityofallen.org/arcgis/rest/services/ReferenceData/Collin_County_Appraisal_District_Parcels/MapServer/1/query?where=UPPER(GIS_DBO_AD_Entity_file_as_name)%20LIKE%20UPPER('%25SMITH%25')%20AND%20CAST(GIS_DBO_AD_Entity_confidential_%20AS%20VARCHAR(255))%20NOT%20LIKE%20'%25T%25'&outFields=GIS_DBO_Parcel_PROP_ID,GIS_DBO_AD_Entity_file_as_name,GIS_DBO_AD_Entity_situs_display,GIS_DBO_AD_Entity_confidential_&returnGeometry=false&f=json&resultRecordCount=10",
263
+ "confidentialFlag": { "field": "GIS_DBO_AD_Entity_confidential_", "values": ["T"], "safeValues": ["F"] },
264
+ "sampleQuery": "https://gismaps.cityofallen.org/arcgis/rest/services/ReferenceData/Collin_County_Appraisal_District_Parcels/MapServer/1/query?where=UPPER(GIS_DBO_AD_Entity_file_as_name)%20LIKE%20UPPER('%25SMITH%25')%20AND%20CAST(GIS_DBO_AD_Entity_confidential_%20AS%20VARCHAR(255))%20NOT%20LIKE%20'%25T%25'%20AND%20GIS_DBO_AD_Entity_confidential_%20IN%20('F')&outFields=GIS_DBO_Parcel_PROP_ID,GIS_DBO_AD_Entity_file_as_name,GIS_DBO_AD_Entity_situs_display,GIS_DBO_AD_Entity_confidential_&returnGeometry=false&f=json&resultRecordCount=10",
265
265
  "license": "public",
266
266
  "licenseUrl": "https://www.collincad.org/",
267
267
  "status": "live",
@@ -274,7 +274,7 @@
274
274
  "url": "https://www.collincad.org/",
275
275
  "email": null
276
276
  },
277
- "notes": "Collin County, Texas (Plano / Frisco / McKinney, pop. ~1.1M, among the fastest-growing US counties) publishes Collin Central Appraisal District (CCAD) parcels through a City of Allen ArcGIS MapServer. Owner search uses the joined field GIS_DBO_AD_Entity_file_as_name; the situs (site) address is GIS_DBO_AD_Entity_situs_display; the parcel key is GIS_DBO_Parcel_PROP_ID. The GIS_DBO_ table-join prefixes must be used verbatim in WHERE clauses. Owner LIKE query confirmed live 2026-05-30. Texas Tax Code §25.025 lets protected persons (peace officers, judges, family-violence victims) suppress owner/address records; CCAD publishes those accounts WITH the owner and marks them in GIS_DBO_AD_Entity_confidential_ (alias 'Confidential Flag (t/f)': measured 2026-10-25, 'T' on 1,598, 'F' on 435,783 and NULL on 15,003 of 452,384 rows). The registry's confidentialFlag marker names that column, so a flagged row is withheld on every hosted surface (the REST API, the hosted MCP and the free tools, under any spelling of the layer URL); the stdio MCP server (@urbankitstudio/mcp-atlas) adds the exclusion to its own owner query in its next release; add AND CAST(GIS_DBO_AD_Entity_confidential_ AS VARCHAR(255)) NOT LIKE '%T%' to any query of your own, as the sampleQuery does (measured 2026-10-25: 452,384 rows, 1,598 'T' and 15,003 with a NULL cell, and the clause keeps 435,783, dropping both: a NULL cell fails closed)."
277
+ "notes": "Collin County, Texas (Plano / Frisco / McKinney, pop. ~1.1M, among the fastest-growing US counties) publishes Collin Central Appraisal District (CCAD) parcels through a City of Allen ArcGIS MapServer. Owner search uses the joined field GIS_DBO_AD_Entity_file_as_name; the situs (site) address is GIS_DBO_AD_Entity_situs_display; the parcel key is GIS_DBO_Parcel_PROP_ID. The GIS_DBO_ table-join prefixes must be used verbatim in WHERE clauses. Owner LIKE query confirmed live 2026-05-30. Texas Tax Code §25.025 lets protected persons (peace officers, judges, family-violence victims) suppress owner/address records; CCAD publishes those accounts WITH the owner and marks them in GIS_DBO_AD_Entity_confidential_ (alias 'Confidential Flag (t/f)': measured 2026-10-25, 'T' on 1,598, 'F' on 435,783 and NULL on 15,003 of 452,384 rows). The registry's confidentialFlag marker names that column, so a flagged row is withheld on every hosted surface (the REST API, the hosted MCP and the free tools, under any spelling of the layer URL); the stdio MCP server (@urbankitstudio/mcp-atlas) adds the exclusion to its own owner query in its next release; add AND CAST(GIS_DBO_AD_Entity_confidential_ AS VARCHAR(255)) NOT LIKE '%T%' AND GIS_DBO_AD_Entity_confidential_ IN ('F') to any query of your own, as the sampleQuery does (measured 2026-10-25: 452,384 rows, 1,598 'T' and 15,003 with a NULL cell, and the CAST clause keeps 435,783, dropping both: a NULL cell fails closed). The IN list is confidentialFlag.safeValues, every distinct raw cell an unflagged owner holds (measured 2026-10-26 with returnDistinctValues): a cell that is not exactly 'F' drops out whatever the server's text handling does, and the IN clause alone, or both clauses together, keep the same 435,783 rows."
278
278
  },
279
279
  {
280
280
  "id": "tx-denton",
@@ -652,8 +652,8 @@
652
652
  { "name": "use_dscr", "label": "Land Use Description", "searchable": false },
653
653
  { "name": "tax_val", "label": "Taxable Value", "searchable": false }
654
654
  ],
655
- "confidentialFlag": { "field": "conf_flg", "values": ["1"] },
656
- "sampleQuery": "https://gis11.cama.io/arcgis/rest/services/Ector/EctorCounty_Basemap/MapServer/0/query?where=UPPER(owner_name)%20LIKE%20UPPER('%25SMITH%25')%20AND%20CAST(conf_flg%20AS%20VARCHAR(255))%20NOT%20LIKE%20'%251%25'&outFields=PIN,owner_name,owner_addr,conf_flg&returnGeometry=false&f=json&resultRecordCount=10",
655
+ "confidentialFlag": { "field": "conf_flg", "values": ["1"], "safeValues": [0] },
656
+ "sampleQuery": "https://gis11.cama.io/arcgis/rest/services/Ector/EctorCounty_Basemap/MapServer/0/query?where=UPPER(owner_name)%20LIKE%20UPPER('%25SMITH%25')%20AND%20CAST(conf_flg%20AS%20VARCHAR(255))%20NOT%20LIKE%20'%251%25'%20AND%20conf_flg%20IN%20(0)&outFields=PIN,owner_name,owner_addr,conf_flg&returnGeometry=false&f=json&resultRecordCount=10",
657
657
  "license": "unknown",
658
658
  "licenseUrl": "https://www.ectorcad.org/",
659
659
  "status": "live",
@@ -666,7 +666,7 @@
666
666
  "url": "https://www.ectorcad.org/",
667
667
  "email": null
668
668
  },
669
- "notes": "Ector County, Texas (county seat Odessa; FIPS 48135) was asked for through the free tools. The parcels are Ector County Appraisal District (Ector CAD) data, published as layer 0 ('ParcelFabric') of the Ector/EctorCounty_Basemap MapServer on gis11.cama.io, the server of the district's appraisal-software vendor (the layer is titled 'Ector County Appraisal District (public view)' on ArcGIS Online and the server's Ector folder also carries the district's aerials, features and thematic maps): 77,042 parcels on 2026-10-14, 76,779 of them with an owner (263 null). The owner is owner_name (the layer's display field); the owner mailing address is owner_addr, ONE line that includes the city and state (76,545 rows, 73,482 containing 'TX'); the parcel id is PIN (a formatted account number such as 5-5-5 digit groups, all 77,042 rows) with strap, dsp_strap and gis_parcel_id (76,779 rows each). NO SITUS COLUMN: the layer publishes no site-address field at all, so an address lookup cannot be answered from it; the registry therefore lists owner, mailing address and parcel id only, and an address-to-parcel lookup must go through a geocoded point query (inSR 4326 point intersect, verified: a point in downtown Odessa returned one parcel) rather than a text LIKE. CONFIDENTIAL OWNERS (Texas Tax Code §25.025): the layer carries a conf_flg column (smallint). Measured 2026-10-24, conf_flg = 0 on all 77,042 rows and no row carries a CONFIDENTIAL marker, so no value meaning 'confidential' has ever been observed here. The registry's confidentialFlag marker (conf_flg = 1) is a forward GUESS, not a measurement: it reads a future non-zero cell as flagged (the reader compares the cell as text, and a one-character value also matches inside the cell, so 10 or 21 would read as flagged too), at the cost of asserting a value Ector has never published. Re-measure before relying on it. In a where clause use AND CAST(conf_flg AS VARCHAR(255)) NOT LIKE '%1%', as the sampleQuery does: conf_flg is an integer, and the un-cast conf_flg NOT LIKE '%1%' answers with an ArcGIS error (code 400, inside an HTTP 200 response; 2026-10-25). 0 rows are flagged deleted. CORS answers Access-Control-Allow-Origin with the calling origin (checked with Origin https://urbankitstudio.com). maxRecordCount is only 1000 (pagination supported); the layer is Texas Central state plane (wkid 102739). Currency: the layer document carries no editing date; the newest dos_timestamp (date of sale) is 2026-08-05 and the newest last_rev_dt (last revision) is 2026-08-10. LICENSE AND DURABILITY: no license text; the host is a vendor server (ArcGIS 10.71) and not the district's own domain, so the URL can move when the vendor migrates the district; re-resolve from Ector CAD if the liveness probe flags it. The contact is Ector CAD. Verified 2026-10-14: a count, resultRecordCount=10 and an owner LIKE query (356 rows for %SMITH%) and a point query.",
669
+ "notes": "Ector County, Texas (county seat Odessa; FIPS 48135) was asked for through the free tools. The parcels are Ector County Appraisal District (Ector CAD) data, published as layer 0 ('ParcelFabric') of the Ector/EctorCounty_Basemap MapServer on gis11.cama.io, the server of the district's appraisal-software vendor (the layer is titled 'Ector County Appraisal District (public view)' on ArcGIS Online and the server's Ector folder also carries the district's aerials, features and thematic maps): 77,042 parcels on 2026-10-14, 76,779 of them with an owner (263 null). The owner is owner_name (the layer's display field); the owner mailing address is owner_addr, ONE line that includes the city and state (76,545 rows, 73,482 containing 'TX'); the parcel id is PIN (a formatted account number such as 5-5-5 digit groups, all 77,042 rows) with strap, dsp_strap and gis_parcel_id (76,779 rows each). NO SITUS COLUMN: the layer publishes no site-address field at all, so an address lookup cannot be answered from it; the registry therefore lists owner, mailing address and parcel id only, and an address-to-parcel lookup must go through a geocoded point query (inSR 4326 point intersect, verified: a point in downtown Odessa returned one parcel) rather than a text LIKE. CONFIDENTIAL OWNERS (Texas Tax Code §25.025): the layer carries a conf_flg column (smallint). Measured 2026-10-24, conf_flg = 0 on all 77,042 rows and no row carries a CONFIDENTIAL marker, so no value meaning 'confidential' has ever been observed here. The registry's confidentialFlag marker (conf_flg = 1) is a forward GUESS, not a measurement: it reads a future non-zero cell as flagged (the reader compares the cell as text, and a one-character value also matches inside the cell, so 10 or 21 would read as flagged too), at the cost of asserting a value Ector has never published. Re-measure before relying on it. In a where clause use AND CAST(conf_flg AS VARCHAR(255)) NOT LIKE '%1%' AND conf_flg IN (0), as the sampleQuery does: conf_flg is an integer, and the un-cast conf_flg NOT LIKE '%1%' answers with an ArcGIS error (code 400, inside an HTTP 200 response; 2026-10-25). The IN list is confidentialFlag.safeValues, the one distinct value the column holds (0, an integer, so it is not quoted; measured 2026-10-26 with returnDistinctValues): any other cell drops out, and the IN clause alone, or both clauses together, keep all 77,042 rows. 0 rows are flagged deleted. CORS answers Access-Control-Allow-Origin with the calling origin (checked with Origin https://urbankitstudio.com). maxRecordCount is only 1000 (pagination supported); the layer is Texas Central state plane (wkid 102739). Currency: the layer document carries no editing date; the newest dos_timestamp (date of sale) is 2026-08-05 and the newest last_rev_dt (last revision) is 2026-08-10. LICENSE AND DURABILITY: no license text; the host is a vendor server (ArcGIS 10.71) and not the district's own domain, so the URL can move when the vendor migrates the district; re-resolve from Ector CAD if the liveness probe flags it. The contact is Ector CAD. Verified 2026-10-14: a count, resultRecordCount=10 and an owner LIKE query (356 rows for %SMITH%) and a point query.",
670
670
  "addedAt": "2026-10-14"
671
671
  },
672
672
  {
package/dist/index.cjs CHANGED
@@ -36918,8 +36918,8 @@ var texas_default = {
36918
36918
  { name: "site_zip", label: "Site ZIP", searchable: true },
36919
36919
  { name: "mail_addr_1", label: "Mailing Address", searchable: true }
36920
36920
  ],
36921
- confidentialFlag: { field: "confidential_flag", values: ["Y"] },
36922
- sampleQuery: "https://www.gis.hctx.net/arcgis/rest/services/HCAD/Parcels/MapServer/0/query?where=UPPER(owner_name_1)%20LIKE%20UPPER('%25SMITH%25')%20AND%20CAST(confidential_flag%20AS%20VARCHAR(255))%20NOT%20LIKE%20'%25Y%25'&outFields=HCAD_NUM,owner_name_1,site_str_num,site_str_name,site_city,confidential_flag&returnGeometry=false&f=json&resultRecordCount=10",
36921
+ confidentialFlag: { field: "confidential_flag", values: ["Y"], safeValues: [" ", "N ", "NNN ", "NNNNNNNNNN"] },
36922
+ sampleQuery: "https://www.gis.hctx.net/arcgis/rest/services/HCAD/Parcels/MapServer/0/query?where=UPPER(owner_name_1)%20LIKE%20UPPER('%25SMITH%25')%20AND%20CAST(confidential_flag%20AS%20VARCHAR(255))%20NOT%20LIKE%20'%25Y%25'%20AND%20confidential_flag%20IN%20('%20%20%20%20%20%20%20%20%20%20',%20'N%20%20%20%20%20%20%20%20%20',%20'NNN%20%20%20%20%20%20%20',%20'NNNNNNNNNN')&outFields=HCAD_NUM,owner_name_1,site_str_num,site_str_name,site_city,confidential_flag&returnGeometry=false&f=json&resultRecordCount=10",
36923
36923
  license: "public",
36924
36924
  licenseUrl: "https://geo-harriscounty.opendata.arcgis.com/",
36925
36925
  status: "live",
@@ -36932,7 +36932,7 @@ var texas_default = {
36932
36932
  url: "https://geo-harriscounty.opendata.arcgis.com/",
36933
36933
  email: null
36934
36934
  },
36935
- notes: "Harris County, Texas (Houston metro, pop. 4.7M, county seat Houston) is the most populous Texas county and third-most populous in the US. The data authority is HCAD, Harris Central Appraisal District, which maintains property appraisal records independently of the county government. 62 fields confirmed, including HCAD_NUM (parcel ID), acct_num, owner_name_1/2/3 (up to three ownership slots with own_pct_1/2/3 percentage shares), site_str_num, site_str_name, site_city, site_zip, mail_addr_1/2/3, mail_city, mail_state, mail_zip, land_use, land_value, bld_value, total_appraised_val, new_owner_date, and yr_impr. Owner name is public under the Texas Public Information Act; Texas Tax Code \xA725.025 allows certain categories of persons (peace officers, judges, domestic violence victims, and others) to request suppression of their home address from appraisal district records. HCAD publishes those accounts WITH the owner and marks them in confidential_flag, a ten-character string holding one Y/N per ownership slot (measured 2026-10-24: 1,551,736 rows; 'Y ' 1,658 and 'YNNNNNNNNN' 3,172, so 4,830 flagged, every Y in slot 1; 'NNNNNNNNNN' 1,066,977, 'N ' 3,721, blank 470,972, and 'NNN ' 1 measured 2026-10-25). The registry's confidentialFlag marker names that column, so a flagged row is withheld on every hosted surface (the REST API, the hosted MCP and the free tools, under any spelling of the layer URL); the stdio MCP server (@urbankitstudio/mcp-atlas) adds the exclusion to its own owner query in its next release; add AND CAST(confidential_flag AS VARCHAR(255)) NOT LIKE '%Y%' to any query of your own, as the sampleQuery does (measured 2026-10-25: 1,551,736 rows, 4,830 flagged and 5,235 with a NULL cell, and the clause keeps 1,541,671, dropping both: a NULL cell fails closed). Owner-name LIKE query confirmed live. Max record count = 1000 per query. The HCAD open-data hub at geo-harriscounty.opendata.arcgis.com provides bulk downloads. A sibling service on the same server covers HCAD_MUD (Municipal Utility District) boundaries."
36935
+ notes: "Harris County, Texas (Houston metro, pop. 4.7M, county seat Houston) is the most populous Texas county and third-most populous in the US. The data authority is HCAD, Harris Central Appraisal District, which maintains property appraisal records independently of the county government. 62 fields confirmed, including HCAD_NUM (parcel ID), acct_num, owner_name_1/2/3 (up to three ownership slots with own_pct_1/2/3 percentage shares), site_str_num, site_str_name, site_city, site_zip, mail_addr_1/2/3, mail_city, mail_state, mail_zip, land_use, land_value, bld_value, total_appraised_val, new_owner_date, and yr_impr. Owner name is public under the Texas Public Information Act; Texas Tax Code \xA725.025 allows certain categories of persons (peace officers, judges, domestic violence victims, and others) to request suppression of their home address from appraisal district records. HCAD publishes those accounts WITH the owner and marks them in confidential_flag, a ten-character string holding one Y/N per ownership slot (measured 2026-10-24: 1,551,736 rows; 'Y ' 1,658 and 'YNNNNNNNNN' 3,172, so 4,830 flagged, every Y in slot 1; 'NNNNNNNNNN' 1,066,977, 'N ' 3,721, blank 470,972, and 'NNN ' 1 measured 2026-10-25). The registry's confidentialFlag marker names that column, so a flagged row is withheld on every hosted surface (the REST API, the hosted MCP and the free tools, under any spelling of the layer URL); the stdio MCP server (@urbankitstudio/mcp-atlas) adds the exclusion to its own owner query in its next release; add AND CAST(confidential_flag AS VARCHAR(255)) NOT LIKE '%Y%' AND confidential_flag IN (' ', 'N ', 'NNN ', 'NNNNNNNNNN') to any query of your own, as the sampleQuery does (measured 2026-10-25: 1,551,736 rows, 4,830 flagged and 5,235 with a NULL cell, and the CAST clause keeps 1,541,671, dropping both: a NULL cell fails closed). The IN list is confidentialFlag.safeValues, every distinct raw cell an unflagged owner holds, each ten characters with its padding: ten spaces, N and nine spaces, NNN and seven spaces, ten Ns (measured 2026-10-26 with returnDistinctValues): a cell that is not exactly one of them drops out whatever the server's text handling does, and the IN clause alone, or both clauses together, keep the same 1,541,671 rows. Owner-name LIKE query confirmed live. Max record count = 1000 per query. The HCAD open-data hub at geo-harriscounty.opendata.arcgis.com provides bulk downloads. A sibling service on the same server covers HCAD_MUD (Municipal Utility District) boundaries."
36936
36936
  },
36937
36937
  {
36938
36938
  id: "tx-travis",
@@ -37145,8 +37145,8 @@ var texas_default = {
37145
37145
  { name: "GIS_DBO_Parcel_PROP_ID", label: "Property ID (key)", searchable: true },
37146
37146
  { name: "GIS_DBO_Parcel_GEO_ID", label: "Geographic ID", searchable: true }
37147
37147
  ],
37148
- confidentialFlag: { field: "GIS_DBO_AD_Entity_confidential_", values: ["T"] },
37149
- sampleQuery: "https://gismaps.cityofallen.org/arcgis/rest/services/ReferenceData/Collin_County_Appraisal_District_Parcels/MapServer/1/query?where=UPPER(GIS_DBO_AD_Entity_file_as_name)%20LIKE%20UPPER('%25SMITH%25')%20AND%20CAST(GIS_DBO_AD_Entity_confidential_%20AS%20VARCHAR(255))%20NOT%20LIKE%20'%25T%25'&outFields=GIS_DBO_Parcel_PROP_ID,GIS_DBO_AD_Entity_file_as_name,GIS_DBO_AD_Entity_situs_display,GIS_DBO_AD_Entity_confidential_&returnGeometry=false&f=json&resultRecordCount=10",
37148
+ confidentialFlag: { field: "GIS_DBO_AD_Entity_confidential_", values: ["T"], safeValues: ["F"] },
37149
+ sampleQuery: "https://gismaps.cityofallen.org/arcgis/rest/services/ReferenceData/Collin_County_Appraisal_District_Parcels/MapServer/1/query?where=UPPER(GIS_DBO_AD_Entity_file_as_name)%20LIKE%20UPPER('%25SMITH%25')%20AND%20CAST(GIS_DBO_AD_Entity_confidential_%20AS%20VARCHAR(255))%20NOT%20LIKE%20'%25T%25'%20AND%20GIS_DBO_AD_Entity_confidential_%20IN%20('F')&outFields=GIS_DBO_Parcel_PROP_ID,GIS_DBO_AD_Entity_file_as_name,GIS_DBO_AD_Entity_situs_display,GIS_DBO_AD_Entity_confidential_&returnGeometry=false&f=json&resultRecordCount=10",
37150
37150
  license: "public",
37151
37151
  licenseUrl: "https://www.collincad.org/",
37152
37152
  status: "live",
@@ -37159,7 +37159,7 @@ var texas_default = {
37159
37159
  url: "https://www.collincad.org/",
37160
37160
  email: null
37161
37161
  },
37162
- notes: "Collin County, Texas (Plano / Frisco / McKinney, pop. ~1.1M, among the fastest-growing US counties) publishes Collin Central Appraisal District (CCAD) parcels through a City of Allen ArcGIS MapServer. Owner search uses the joined field GIS_DBO_AD_Entity_file_as_name; the situs (site) address is GIS_DBO_AD_Entity_situs_display; the parcel key is GIS_DBO_Parcel_PROP_ID. The GIS_DBO_ table-join prefixes must be used verbatim in WHERE clauses. Owner LIKE query confirmed live 2026-05-30. Texas Tax Code \xA725.025 lets protected persons (peace officers, judges, family-violence victims) suppress owner/address records; CCAD publishes those accounts WITH the owner and marks them in GIS_DBO_AD_Entity_confidential_ (alias 'Confidential Flag (t/f)': measured 2026-10-25, 'T' on 1,598, 'F' on 435,783 and NULL on 15,003 of 452,384 rows). The registry's confidentialFlag marker names that column, so a flagged row is withheld on every hosted surface (the REST API, the hosted MCP and the free tools, under any spelling of the layer URL); the stdio MCP server (@urbankitstudio/mcp-atlas) adds the exclusion to its own owner query in its next release; add AND CAST(GIS_DBO_AD_Entity_confidential_ AS VARCHAR(255)) NOT LIKE '%T%' to any query of your own, as the sampleQuery does (measured 2026-10-25: 452,384 rows, 1,598 'T' and 15,003 with a NULL cell, and the clause keeps 435,783, dropping both: a NULL cell fails closed)."
37162
+ notes: "Collin County, Texas (Plano / Frisco / McKinney, pop. ~1.1M, among the fastest-growing US counties) publishes Collin Central Appraisal District (CCAD) parcels through a City of Allen ArcGIS MapServer. Owner search uses the joined field GIS_DBO_AD_Entity_file_as_name; the situs (site) address is GIS_DBO_AD_Entity_situs_display; the parcel key is GIS_DBO_Parcel_PROP_ID. The GIS_DBO_ table-join prefixes must be used verbatim in WHERE clauses. Owner LIKE query confirmed live 2026-05-30. Texas Tax Code \xA725.025 lets protected persons (peace officers, judges, family-violence victims) suppress owner/address records; CCAD publishes those accounts WITH the owner and marks them in GIS_DBO_AD_Entity_confidential_ (alias 'Confidential Flag (t/f)': measured 2026-10-25, 'T' on 1,598, 'F' on 435,783 and NULL on 15,003 of 452,384 rows). The registry's confidentialFlag marker names that column, so a flagged row is withheld on every hosted surface (the REST API, the hosted MCP and the free tools, under any spelling of the layer URL); the stdio MCP server (@urbankitstudio/mcp-atlas) adds the exclusion to its own owner query in its next release; add AND CAST(GIS_DBO_AD_Entity_confidential_ AS VARCHAR(255)) NOT LIKE '%T%' AND GIS_DBO_AD_Entity_confidential_ IN ('F') to any query of your own, as the sampleQuery does (measured 2026-10-25: 452,384 rows, 1,598 'T' and 15,003 with a NULL cell, and the CAST clause keeps 435,783, dropping both: a NULL cell fails closed). The IN list is confidentialFlag.safeValues, every distinct raw cell an unflagged owner holds (measured 2026-10-26 with returnDistinctValues): a cell that is not exactly 'F' drops out whatever the server's text handling does, and the IN clause alone, or both clauses together, keep the same 435,783 rows."
37163
37163
  },
37164
37164
  {
37165
37165
  id: "tx-denton",
@@ -37537,8 +37537,8 @@ var texas_default = {
37537
37537
  { name: "use_dscr", label: "Land Use Description", searchable: false },
37538
37538
  { name: "tax_val", label: "Taxable Value", searchable: false }
37539
37539
  ],
37540
- confidentialFlag: { field: "conf_flg", values: ["1"] },
37541
- sampleQuery: "https://gis11.cama.io/arcgis/rest/services/Ector/EctorCounty_Basemap/MapServer/0/query?where=UPPER(owner_name)%20LIKE%20UPPER('%25SMITH%25')%20AND%20CAST(conf_flg%20AS%20VARCHAR(255))%20NOT%20LIKE%20'%251%25'&outFields=PIN,owner_name,owner_addr,conf_flg&returnGeometry=false&f=json&resultRecordCount=10",
37540
+ confidentialFlag: { field: "conf_flg", values: ["1"], safeValues: [0] },
37541
+ sampleQuery: "https://gis11.cama.io/arcgis/rest/services/Ector/EctorCounty_Basemap/MapServer/0/query?where=UPPER(owner_name)%20LIKE%20UPPER('%25SMITH%25')%20AND%20CAST(conf_flg%20AS%20VARCHAR(255))%20NOT%20LIKE%20'%251%25'%20AND%20conf_flg%20IN%20(0)&outFields=PIN,owner_name,owner_addr,conf_flg&returnGeometry=false&f=json&resultRecordCount=10",
37542
37542
  license: "unknown",
37543
37543
  licenseUrl: "https://www.ectorcad.org/",
37544
37544
  status: "live",
@@ -37551,7 +37551,7 @@ var texas_default = {
37551
37551
  url: "https://www.ectorcad.org/",
37552
37552
  email: null
37553
37553
  },
37554
- notes: "Ector County, Texas (county seat Odessa; FIPS 48135) was asked for through the free tools. The parcels are Ector County Appraisal District (Ector CAD) data, published as layer 0 ('ParcelFabric') of the Ector/EctorCounty_Basemap MapServer on gis11.cama.io, the server of the district's appraisal-software vendor (the layer is titled 'Ector County Appraisal District (public view)' on ArcGIS Online and the server's Ector folder also carries the district's aerials, features and thematic maps): 77,042 parcels on 2026-10-14, 76,779 of them with an owner (263 null). The owner is owner_name (the layer's display field); the owner mailing address is owner_addr, ONE line that includes the city and state (76,545 rows, 73,482 containing 'TX'); the parcel id is PIN (a formatted account number such as 5-5-5 digit groups, all 77,042 rows) with strap, dsp_strap and gis_parcel_id (76,779 rows each). NO SITUS COLUMN: the layer publishes no site-address field at all, so an address lookup cannot be answered from it; the registry therefore lists owner, mailing address and parcel id only, and an address-to-parcel lookup must go through a geocoded point query (inSR 4326 point intersect, verified: a point in downtown Odessa returned one parcel) rather than a text LIKE. CONFIDENTIAL OWNERS (Texas Tax Code \xA725.025): the layer carries a conf_flg column (smallint). Measured 2026-10-24, conf_flg = 0 on all 77,042 rows and no row carries a CONFIDENTIAL marker, so no value meaning 'confidential' has ever been observed here. The registry's confidentialFlag marker (conf_flg = 1) is a forward GUESS, not a measurement: it reads a future non-zero cell as flagged (the reader compares the cell as text, and a one-character value also matches inside the cell, so 10 or 21 would read as flagged too), at the cost of asserting a value Ector has never published. Re-measure before relying on it. In a where clause use AND CAST(conf_flg AS VARCHAR(255)) NOT LIKE '%1%', as the sampleQuery does: conf_flg is an integer, and the un-cast conf_flg NOT LIKE '%1%' answers with an ArcGIS error (code 400, inside an HTTP 200 response; 2026-10-25). 0 rows are flagged deleted. CORS answers Access-Control-Allow-Origin with the calling origin (checked with Origin https://urbankitstudio.com). maxRecordCount is only 1000 (pagination supported); the layer is Texas Central state plane (wkid 102739). Currency: the layer document carries no editing date; the newest dos_timestamp (date of sale) is 2026-08-05 and the newest last_rev_dt (last revision) is 2026-08-10. LICENSE AND DURABILITY: no license text; the host is a vendor server (ArcGIS 10.71) and not the district's own domain, so the URL can move when the vendor migrates the district; re-resolve from Ector CAD if the liveness probe flags it. The contact is Ector CAD. Verified 2026-10-14: a count, resultRecordCount=10 and an owner LIKE query (356 rows for %SMITH%) and a point query.",
37554
+ notes: "Ector County, Texas (county seat Odessa; FIPS 48135) was asked for through the free tools. The parcels are Ector County Appraisal District (Ector CAD) data, published as layer 0 ('ParcelFabric') of the Ector/EctorCounty_Basemap MapServer on gis11.cama.io, the server of the district's appraisal-software vendor (the layer is titled 'Ector County Appraisal District (public view)' on ArcGIS Online and the server's Ector folder also carries the district's aerials, features and thematic maps): 77,042 parcels on 2026-10-14, 76,779 of them with an owner (263 null). The owner is owner_name (the layer's display field); the owner mailing address is owner_addr, ONE line that includes the city and state (76,545 rows, 73,482 containing 'TX'); the parcel id is PIN (a formatted account number such as 5-5-5 digit groups, all 77,042 rows) with strap, dsp_strap and gis_parcel_id (76,779 rows each). NO SITUS COLUMN: the layer publishes no site-address field at all, so an address lookup cannot be answered from it; the registry therefore lists owner, mailing address and parcel id only, and an address-to-parcel lookup must go through a geocoded point query (inSR 4326 point intersect, verified: a point in downtown Odessa returned one parcel) rather than a text LIKE. CONFIDENTIAL OWNERS (Texas Tax Code \xA725.025): the layer carries a conf_flg column (smallint). Measured 2026-10-24, conf_flg = 0 on all 77,042 rows and no row carries a CONFIDENTIAL marker, so no value meaning 'confidential' has ever been observed here. The registry's confidentialFlag marker (conf_flg = 1) is a forward GUESS, not a measurement: it reads a future non-zero cell as flagged (the reader compares the cell as text, and a one-character value also matches inside the cell, so 10 or 21 would read as flagged too), at the cost of asserting a value Ector has never published. Re-measure before relying on it. In a where clause use AND CAST(conf_flg AS VARCHAR(255)) NOT LIKE '%1%' AND conf_flg IN (0), as the sampleQuery does: conf_flg is an integer, and the un-cast conf_flg NOT LIKE '%1%' answers with an ArcGIS error (code 400, inside an HTTP 200 response; 2026-10-25). The IN list is confidentialFlag.safeValues, the one distinct value the column holds (0, an integer, so it is not quoted; measured 2026-10-26 with returnDistinctValues): any other cell drops out, and the IN clause alone, or both clauses together, keep all 77,042 rows. 0 rows are flagged deleted. CORS answers Access-Control-Allow-Origin with the calling origin (checked with Origin https://urbankitstudio.com). maxRecordCount is only 1000 (pagination supported); the layer is Texas Central state plane (wkid 102739). Currency: the layer document carries no editing date; the newest dos_timestamp (date of sale) is 2026-08-05 and the newest last_rev_dt (last revision) is 2026-08-10. LICENSE AND DURABILITY: no license text; the host is a vendor server (ArcGIS 10.71) and not the district's own domain, so the URL can move when the vendor migrates the district; re-resolve from Ector CAD if the liveness probe flags it. The contact is Ector CAD. Verified 2026-10-14: a count, resultRecordCount=10 and an owner LIKE query (356 rows for %SMITH%) and a point query.",
37555
37555
  addedAt: "2026-10-14"
37556
37556
  },
37557
37557
  {
package/dist/index.d.cts CHANGED
@@ -203,15 +203,19 @@ interface SearchField {
203
203
  searchable: boolean;
204
204
  }
205
205
  /**
206
- * The county's own "this owner's record is confidential" column on a layer, and
207
- * the values that say so. Texas Tax Code §25.025 lets peace officers, judges,
208
- * family-violence victims and others have their home address kept confidential
209
- * in appraisal records; Harris (HCAD) and Collin publish the owner anyway with a
210
- * flag column beside it (`confidential_flag` "Y", `GIS_DBO_AD_Entity_confidential_`
211
- * "T"); Ector's (`conf_flg` "1") is the recorded guess, since no flagged row
212
- * had been observed when it was measured. A row whose flag is set must not be
213
- * shown or passed on. Either add one clause per value to every query against
214
- * the layer: for a ONE-character value
206
+ * The county's own "this owner's record is confidential" column on a layer, the
207
+ * values that say so, and the raw cells measured as safe. Texas Tax Code §25.025
208
+ * lets peace officers, judges, family-violence victims and others have their
209
+ * home address kept confidential in appraisal records; Harris (HCAD) and Collin
210
+ * publish the owner anyway with a flag column beside it (`confidential_flag`
211
+ * "Y", `GIS_DBO_AD_Entity_confidential_` "T"); Ector's (`conf_flg` "1") is the
212
+ * recorded guess, since no flagged row had been observed when it was measured.
213
+ * A row whose flag is set must not be shown or passed on.
214
+ *
215
+ * The rule: keep a row only if its raw cell equals one of `safeValues` AND the
216
+ * cell, trimmed and upper-cased, contains no listed value; a NULL or missing
217
+ * cell is flagged. In SQL that is two clauses ANDed to every query against the
218
+ * layer. First, one per value: for a ONE-character value
215
219
  * `AND CAST(<field> AS VARCHAR(255)) NOT LIKE '%<value>%'` (HCAD packs one flag
216
220
  * per ownership slot into a ten-character string, so "YNNNNNNNNN" is slot 1
217
221
  * confidential and an equality test would keep it; Collin's "T" takes this
@@ -220,19 +224,41 @@ interface SearchField {
220
224
  * answers there with an ArcGIS error (code 400, inside an HTTP 200 response).
221
225
  * Never TRIM the column in SQL: `TRIM(<field>)` answers with the same error on
222
226
  * all three layers, so the SQL route compares the untrimmed text
223
- * (`UPPER(CAST(<field> AS VARCHAR(255)))` does run). Harris's 470,972 blank
224
- * cells hold spaces and the clause keeps them; Harris also has 5,235 NULL cells
225
- * and Collin 15,003 (2026-10-25). A NULL cell fails the clause and the row drops
226
- * out; a missing column makes the query fail. That is fail-closed, unlike the
227
- * hosted reader, which serves a null cell as "no flag recorded". Or drop the row yourself when the cell, trimmed
228
- * and upper-cased, equals a listed value or, for a one-character value,
229
- * contains it. Request the column whenever you request the owner, and treat a
230
- * row that lacks it as flagged. The hosted API and MCP withhold such a row with
231
- * `withheld: "county-redacted"`.
227
+ * (`UPPER(CAST(<field> AS VARCHAR(255)))` does run). Then
228
+ * `AND <field> IN (<safeValues>)`: a contains test written in SQL cannot match
229
+ * the rule on every county backend (non-ASCII upper-casing, an embedded NUL
230
+ * that stops LIKE, the 255-character cast, mixed encodings), so a cell that is
231
+ * not exactly a known-safe value drops out whatever the backend does with
232
+ * text. Each record's `sampleQuery` carries both clauses. Harris's 470,972
233
+ * blank cells hold spaces and both clauses keep them; Harris also has 5,235
234
+ * NULL cells and Collin 15,003 (2026-10-25). A NULL cell fails both clauses
235
+ * and the row drops out; a missing column makes the query fail. That is
236
+ * fail-closed. Since 0.6.47 the hosted reader (the hosted API, the hosted MCP
237
+ * and the site's free tools) keeps the same rows, plus unpadded or
238
+ * whitespace-wrapped forms of a safe cell, none of which can carry a marker: it
239
+ * ignores trailing spaces (U+0020) on both sides of a string safe value,
240
+ * matches an integer safe value against text that trims (JavaScript `trim`) to
241
+ * its decimal form, withholds a cell that holds a listed value anywhere in it,
242
+ * whatever that value's length, and withholds every row of a layer whose flag
243
+ * lists no safe values. Or apply the rule to each row yourself. Request the
244
+ * column whenever you request the owner. The hosted API and MCP withhold a
245
+ * flagged row with `withheld: "county-redacted"`.
232
246
  */
233
247
  interface ConfidentialFlag {
234
248
  field: string;
235
249
  values: string[];
250
+ /**
251
+ * The exact raw cells the layer holds for an UNFLAGGED owner, strings with
252
+ * their padding and integers for an integer column (measured 2026-10-26 with
253
+ * returnDistinctValues: Harris `[" ", "N ", "NNN ",
254
+ * "NNNNNNNNNN"]`, each ten characters; Collin `["F"]`; Ector `[0]`). In SQL,
255
+ * `<field> IN (' ', 'N ', ...)`: strings single-quoted with
256
+ * `'` doubled, integers bare, in the listed order, the column neither cast
257
+ * nor upper-cased. validate-atlas requires it on every record that carries a
258
+ * confidentialFlag (since 0.6.46); it is optional in the type so data older
259
+ * than that still type-checks.
260
+ */
261
+ safeValues?: Array<string | number>;
236
262
  }
237
263
  interface EndpointRecord {
238
264
  url: string;
@@ -327,7 +353,8 @@ interface EndpointRecord {
327
353
  maxRecordCount?: number;
328
354
  /** The layer's own confidential-owner flag column (see {@link ConfidentialFlag}).
329
355
  * Present on tx-harris, tx-collin and tx-ector (Ector's marker is the
330
- * recorded guess: no flagged row observed yet). Absent means the layer publishes no
356
+ * recorded guess: no flagged row observed yet), each with its measured
357
+ * `safeValues`. Absent means the layer publishes no
331
358
  * such column, not that no owner there is protected. */
332
359
  confidentialFlag?: ConfidentialFlag;
333
360
  sampleQuery: string | null;
package/dist/index.d.ts CHANGED
@@ -203,15 +203,19 @@ interface SearchField {
203
203
  searchable: boolean;
204
204
  }
205
205
  /**
206
- * The county's own "this owner's record is confidential" column on a layer, and
207
- * the values that say so. Texas Tax Code §25.025 lets peace officers, judges,
208
- * family-violence victims and others have their home address kept confidential
209
- * in appraisal records; Harris (HCAD) and Collin publish the owner anyway with a
210
- * flag column beside it (`confidential_flag` "Y", `GIS_DBO_AD_Entity_confidential_`
211
- * "T"); Ector's (`conf_flg` "1") is the recorded guess, since no flagged row
212
- * had been observed when it was measured. A row whose flag is set must not be
213
- * shown or passed on. Either add one clause per value to every query against
214
- * the layer: for a ONE-character value
206
+ * The county's own "this owner's record is confidential" column on a layer, the
207
+ * values that say so, and the raw cells measured as safe. Texas Tax Code §25.025
208
+ * lets peace officers, judges, family-violence victims and others have their
209
+ * home address kept confidential in appraisal records; Harris (HCAD) and Collin
210
+ * publish the owner anyway with a flag column beside it (`confidential_flag`
211
+ * "Y", `GIS_DBO_AD_Entity_confidential_` "T"); Ector's (`conf_flg` "1") is the
212
+ * recorded guess, since no flagged row had been observed when it was measured.
213
+ * A row whose flag is set must not be shown or passed on.
214
+ *
215
+ * The rule: keep a row only if its raw cell equals one of `safeValues` AND the
216
+ * cell, trimmed and upper-cased, contains no listed value; a NULL or missing
217
+ * cell is flagged. In SQL that is two clauses ANDed to every query against the
218
+ * layer. First, one per value: for a ONE-character value
215
219
  * `AND CAST(<field> AS VARCHAR(255)) NOT LIKE '%<value>%'` (HCAD packs one flag
216
220
  * per ownership slot into a ten-character string, so "YNNNNNNNNN" is slot 1
217
221
  * confidential and an equality test would keep it; Collin's "T" takes this
@@ -220,19 +224,41 @@ interface SearchField {
220
224
  * answers there with an ArcGIS error (code 400, inside an HTTP 200 response).
221
225
  * Never TRIM the column in SQL: `TRIM(<field>)` answers with the same error on
222
226
  * all three layers, so the SQL route compares the untrimmed text
223
- * (`UPPER(CAST(<field> AS VARCHAR(255)))` does run). Harris's 470,972 blank
224
- * cells hold spaces and the clause keeps them; Harris also has 5,235 NULL cells
225
- * and Collin 15,003 (2026-10-25). A NULL cell fails the clause and the row drops
226
- * out; a missing column makes the query fail. That is fail-closed, unlike the
227
- * hosted reader, which serves a null cell as "no flag recorded". Or drop the row yourself when the cell, trimmed
228
- * and upper-cased, equals a listed value or, for a one-character value,
229
- * contains it. Request the column whenever you request the owner, and treat a
230
- * row that lacks it as flagged. The hosted API and MCP withhold such a row with
231
- * `withheld: "county-redacted"`.
227
+ * (`UPPER(CAST(<field> AS VARCHAR(255)))` does run). Then
228
+ * `AND <field> IN (<safeValues>)`: a contains test written in SQL cannot match
229
+ * the rule on every county backend (non-ASCII upper-casing, an embedded NUL
230
+ * that stops LIKE, the 255-character cast, mixed encodings), so a cell that is
231
+ * not exactly a known-safe value drops out whatever the backend does with
232
+ * text. Each record's `sampleQuery` carries both clauses. Harris's 470,972
233
+ * blank cells hold spaces and both clauses keep them; Harris also has 5,235
234
+ * NULL cells and Collin 15,003 (2026-10-25). A NULL cell fails both clauses
235
+ * and the row drops out; a missing column makes the query fail. That is
236
+ * fail-closed. Since 0.6.47 the hosted reader (the hosted API, the hosted MCP
237
+ * and the site's free tools) keeps the same rows, plus unpadded or
238
+ * whitespace-wrapped forms of a safe cell, none of which can carry a marker: it
239
+ * ignores trailing spaces (U+0020) on both sides of a string safe value,
240
+ * matches an integer safe value against text that trims (JavaScript `trim`) to
241
+ * its decimal form, withholds a cell that holds a listed value anywhere in it,
242
+ * whatever that value's length, and withholds every row of a layer whose flag
243
+ * lists no safe values. Or apply the rule to each row yourself. Request the
244
+ * column whenever you request the owner. The hosted API and MCP withhold a
245
+ * flagged row with `withheld: "county-redacted"`.
232
246
  */
233
247
  interface ConfidentialFlag {
234
248
  field: string;
235
249
  values: string[];
250
+ /**
251
+ * The exact raw cells the layer holds for an UNFLAGGED owner, strings with
252
+ * their padding and integers for an integer column (measured 2026-10-26 with
253
+ * returnDistinctValues: Harris `[" ", "N ", "NNN ",
254
+ * "NNNNNNNNNN"]`, each ten characters; Collin `["F"]`; Ector `[0]`). In SQL,
255
+ * `<field> IN (' ', 'N ', ...)`: strings single-quoted with
256
+ * `'` doubled, integers bare, in the listed order, the column neither cast
257
+ * nor upper-cased. validate-atlas requires it on every record that carries a
258
+ * confidentialFlag (since 0.6.46); it is optional in the type so data older
259
+ * than that still type-checks.
260
+ */
261
+ safeValues?: Array<string | number>;
236
262
  }
237
263
  interface EndpointRecord {
238
264
  url: string;
@@ -327,7 +353,8 @@ interface EndpointRecord {
327
353
  maxRecordCount?: number;
328
354
  /** The layer's own confidential-owner flag column (see {@link ConfidentialFlag}).
329
355
  * Present on tx-harris, tx-collin and tx-ector (Ector's marker is the
330
- * recorded guess: no flagged row observed yet). Absent means the layer publishes no
356
+ * recorded guess: no flagged row observed yet), each with its measured
357
+ * `safeValues`. Absent means the layer publishes no
331
358
  * such column, not that no owner there is protected. */
332
359
  confidentialFlag?: ConfidentialFlag;
333
360
  sampleQuery: string | null;
package/dist/index.js CHANGED
@@ -36916,8 +36916,8 @@ var texas_default = {
36916
36916
  { name: "site_zip", label: "Site ZIP", searchable: true },
36917
36917
  { name: "mail_addr_1", label: "Mailing Address", searchable: true }
36918
36918
  ],
36919
- confidentialFlag: { field: "confidential_flag", values: ["Y"] },
36920
- sampleQuery: "https://www.gis.hctx.net/arcgis/rest/services/HCAD/Parcels/MapServer/0/query?where=UPPER(owner_name_1)%20LIKE%20UPPER('%25SMITH%25')%20AND%20CAST(confidential_flag%20AS%20VARCHAR(255))%20NOT%20LIKE%20'%25Y%25'&outFields=HCAD_NUM,owner_name_1,site_str_num,site_str_name,site_city,confidential_flag&returnGeometry=false&f=json&resultRecordCount=10",
36919
+ confidentialFlag: { field: "confidential_flag", values: ["Y"], safeValues: [" ", "N ", "NNN ", "NNNNNNNNNN"] },
36920
+ sampleQuery: "https://www.gis.hctx.net/arcgis/rest/services/HCAD/Parcels/MapServer/0/query?where=UPPER(owner_name_1)%20LIKE%20UPPER('%25SMITH%25')%20AND%20CAST(confidential_flag%20AS%20VARCHAR(255))%20NOT%20LIKE%20'%25Y%25'%20AND%20confidential_flag%20IN%20('%20%20%20%20%20%20%20%20%20%20',%20'N%20%20%20%20%20%20%20%20%20',%20'NNN%20%20%20%20%20%20%20',%20'NNNNNNNNNN')&outFields=HCAD_NUM,owner_name_1,site_str_num,site_str_name,site_city,confidential_flag&returnGeometry=false&f=json&resultRecordCount=10",
36921
36921
  license: "public",
36922
36922
  licenseUrl: "https://geo-harriscounty.opendata.arcgis.com/",
36923
36923
  status: "live",
@@ -36930,7 +36930,7 @@ var texas_default = {
36930
36930
  url: "https://geo-harriscounty.opendata.arcgis.com/",
36931
36931
  email: null
36932
36932
  },
36933
- notes: "Harris County, Texas (Houston metro, pop. 4.7M, county seat Houston) is the most populous Texas county and third-most populous in the US. The data authority is HCAD, Harris Central Appraisal District, which maintains property appraisal records independently of the county government. 62 fields confirmed, including HCAD_NUM (parcel ID), acct_num, owner_name_1/2/3 (up to three ownership slots with own_pct_1/2/3 percentage shares), site_str_num, site_str_name, site_city, site_zip, mail_addr_1/2/3, mail_city, mail_state, mail_zip, land_use, land_value, bld_value, total_appraised_val, new_owner_date, and yr_impr. Owner name is public under the Texas Public Information Act; Texas Tax Code \xA725.025 allows certain categories of persons (peace officers, judges, domestic violence victims, and others) to request suppression of their home address from appraisal district records. HCAD publishes those accounts WITH the owner and marks them in confidential_flag, a ten-character string holding one Y/N per ownership slot (measured 2026-10-24: 1,551,736 rows; 'Y ' 1,658 and 'YNNNNNNNNN' 3,172, so 4,830 flagged, every Y in slot 1; 'NNNNNNNNNN' 1,066,977, 'N ' 3,721, blank 470,972, and 'NNN ' 1 measured 2026-10-25). The registry's confidentialFlag marker names that column, so a flagged row is withheld on every hosted surface (the REST API, the hosted MCP and the free tools, under any spelling of the layer URL); the stdio MCP server (@urbankitstudio/mcp-atlas) adds the exclusion to its own owner query in its next release; add AND CAST(confidential_flag AS VARCHAR(255)) NOT LIKE '%Y%' to any query of your own, as the sampleQuery does (measured 2026-10-25: 1,551,736 rows, 4,830 flagged and 5,235 with a NULL cell, and the clause keeps 1,541,671, dropping both: a NULL cell fails closed). Owner-name LIKE query confirmed live. Max record count = 1000 per query. The HCAD open-data hub at geo-harriscounty.opendata.arcgis.com provides bulk downloads. A sibling service on the same server covers HCAD_MUD (Municipal Utility District) boundaries."
36933
+ notes: "Harris County, Texas (Houston metro, pop. 4.7M, county seat Houston) is the most populous Texas county and third-most populous in the US. The data authority is HCAD, Harris Central Appraisal District, which maintains property appraisal records independently of the county government. 62 fields confirmed, including HCAD_NUM (parcel ID), acct_num, owner_name_1/2/3 (up to three ownership slots with own_pct_1/2/3 percentage shares), site_str_num, site_str_name, site_city, site_zip, mail_addr_1/2/3, mail_city, mail_state, mail_zip, land_use, land_value, bld_value, total_appraised_val, new_owner_date, and yr_impr. Owner name is public under the Texas Public Information Act; Texas Tax Code \xA725.025 allows certain categories of persons (peace officers, judges, domestic violence victims, and others) to request suppression of their home address from appraisal district records. HCAD publishes those accounts WITH the owner and marks them in confidential_flag, a ten-character string holding one Y/N per ownership slot (measured 2026-10-24: 1,551,736 rows; 'Y ' 1,658 and 'YNNNNNNNNN' 3,172, so 4,830 flagged, every Y in slot 1; 'NNNNNNNNNN' 1,066,977, 'N ' 3,721, blank 470,972, and 'NNN ' 1 measured 2026-10-25). The registry's confidentialFlag marker names that column, so a flagged row is withheld on every hosted surface (the REST API, the hosted MCP and the free tools, under any spelling of the layer URL); the stdio MCP server (@urbankitstudio/mcp-atlas) adds the exclusion to its own owner query in its next release; add AND CAST(confidential_flag AS VARCHAR(255)) NOT LIKE '%Y%' AND confidential_flag IN (' ', 'N ', 'NNN ', 'NNNNNNNNNN') to any query of your own, as the sampleQuery does (measured 2026-10-25: 1,551,736 rows, 4,830 flagged and 5,235 with a NULL cell, and the CAST clause keeps 1,541,671, dropping both: a NULL cell fails closed). The IN list is confidentialFlag.safeValues, every distinct raw cell an unflagged owner holds, each ten characters with its padding: ten spaces, N and nine spaces, NNN and seven spaces, ten Ns (measured 2026-10-26 with returnDistinctValues): a cell that is not exactly one of them drops out whatever the server's text handling does, and the IN clause alone, or both clauses together, keep the same 1,541,671 rows. Owner-name LIKE query confirmed live. Max record count = 1000 per query. The HCAD open-data hub at geo-harriscounty.opendata.arcgis.com provides bulk downloads. A sibling service on the same server covers HCAD_MUD (Municipal Utility District) boundaries."
36934
36934
  },
36935
36935
  {
36936
36936
  id: "tx-travis",
@@ -37143,8 +37143,8 @@ var texas_default = {
37143
37143
  { name: "GIS_DBO_Parcel_PROP_ID", label: "Property ID (key)", searchable: true },
37144
37144
  { name: "GIS_DBO_Parcel_GEO_ID", label: "Geographic ID", searchable: true }
37145
37145
  ],
37146
- confidentialFlag: { field: "GIS_DBO_AD_Entity_confidential_", values: ["T"] },
37147
- sampleQuery: "https://gismaps.cityofallen.org/arcgis/rest/services/ReferenceData/Collin_County_Appraisal_District_Parcels/MapServer/1/query?where=UPPER(GIS_DBO_AD_Entity_file_as_name)%20LIKE%20UPPER('%25SMITH%25')%20AND%20CAST(GIS_DBO_AD_Entity_confidential_%20AS%20VARCHAR(255))%20NOT%20LIKE%20'%25T%25'&outFields=GIS_DBO_Parcel_PROP_ID,GIS_DBO_AD_Entity_file_as_name,GIS_DBO_AD_Entity_situs_display,GIS_DBO_AD_Entity_confidential_&returnGeometry=false&f=json&resultRecordCount=10",
37146
+ confidentialFlag: { field: "GIS_DBO_AD_Entity_confidential_", values: ["T"], safeValues: ["F"] },
37147
+ sampleQuery: "https://gismaps.cityofallen.org/arcgis/rest/services/ReferenceData/Collin_County_Appraisal_District_Parcels/MapServer/1/query?where=UPPER(GIS_DBO_AD_Entity_file_as_name)%20LIKE%20UPPER('%25SMITH%25')%20AND%20CAST(GIS_DBO_AD_Entity_confidential_%20AS%20VARCHAR(255))%20NOT%20LIKE%20'%25T%25'%20AND%20GIS_DBO_AD_Entity_confidential_%20IN%20('F')&outFields=GIS_DBO_Parcel_PROP_ID,GIS_DBO_AD_Entity_file_as_name,GIS_DBO_AD_Entity_situs_display,GIS_DBO_AD_Entity_confidential_&returnGeometry=false&f=json&resultRecordCount=10",
37148
37148
  license: "public",
37149
37149
  licenseUrl: "https://www.collincad.org/",
37150
37150
  status: "live",
@@ -37157,7 +37157,7 @@ var texas_default = {
37157
37157
  url: "https://www.collincad.org/",
37158
37158
  email: null
37159
37159
  },
37160
- notes: "Collin County, Texas (Plano / Frisco / McKinney, pop. ~1.1M, among the fastest-growing US counties) publishes Collin Central Appraisal District (CCAD) parcels through a City of Allen ArcGIS MapServer. Owner search uses the joined field GIS_DBO_AD_Entity_file_as_name; the situs (site) address is GIS_DBO_AD_Entity_situs_display; the parcel key is GIS_DBO_Parcel_PROP_ID. The GIS_DBO_ table-join prefixes must be used verbatim in WHERE clauses. Owner LIKE query confirmed live 2026-05-30. Texas Tax Code \xA725.025 lets protected persons (peace officers, judges, family-violence victims) suppress owner/address records; CCAD publishes those accounts WITH the owner and marks them in GIS_DBO_AD_Entity_confidential_ (alias 'Confidential Flag (t/f)': measured 2026-10-25, 'T' on 1,598, 'F' on 435,783 and NULL on 15,003 of 452,384 rows). The registry's confidentialFlag marker names that column, so a flagged row is withheld on every hosted surface (the REST API, the hosted MCP and the free tools, under any spelling of the layer URL); the stdio MCP server (@urbankitstudio/mcp-atlas) adds the exclusion to its own owner query in its next release; add AND CAST(GIS_DBO_AD_Entity_confidential_ AS VARCHAR(255)) NOT LIKE '%T%' to any query of your own, as the sampleQuery does (measured 2026-10-25: 452,384 rows, 1,598 'T' and 15,003 with a NULL cell, and the clause keeps 435,783, dropping both: a NULL cell fails closed)."
37160
+ notes: "Collin County, Texas (Plano / Frisco / McKinney, pop. ~1.1M, among the fastest-growing US counties) publishes Collin Central Appraisal District (CCAD) parcels through a City of Allen ArcGIS MapServer. Owner search uses the joined field GIS_DBO_AD_Entity_file_as_name; the situs (site) address is GIS_DBO_AD_Entity_situs_display; the parcel key is GIS_DBO_Parcel_PROP_ID. The GIS_DBO_ table-join prefixes must be used verbatim in WHERE clauses. Owner LIKE query confirmed live 2026-05-30. Texas Tax Code \xA725.025 lets protected persons (peace officers, judges, family-violence victims) suppress owner/address records; CCAD publishes those accounts WITH the owner and marks them in GIS_DBO_AD_Entity_confidential_ (alias 'Confidential Flag (t/f)': measured 2026-10-25, 'T' on 1,598, 'F' on 435,783 and NULL on 15,003 of 452,384 rows). The registry's confidentialFlag marker names that column, so a flagged row is withheld on every hosted surface (the REST API, the hosted MCP and the free tools, under any spelling of the layer URL); the stdio MCP server (@urbankitstudio/mcp-atlas) adds the exclusion to its own owner query in its next release; add AND CAST(GIS_DBO_AD_Entity_confidential_ AS VARCHAR(255)) NOT LIKE '%T%' AND GIS_DBO_AD_Entity_confidential_ IN ('F') to any query of your own, as the sampleQuery does (measured 2026-10-25: 452,384 rows, 1,598 'T' and 15,003 with a NULL cell, and the CAST clause keeps 435,783, dropping both: a NULL cell fails closed). The IN list is confidentialFlag.safeValues, every distinct raw cell an unflagged owner holds (measured 2026-10-26 with returnDistinctValues): a cell that is not exactly 'F' drops out whatever the server's text handling does, and the IN clause alone, or both clauses together, keep the same 435,783 rows."
37161
37161
  },
37162
37162
  {
37163
37163
  id: "tx-denton",
@@ -37535,8 +37535,8 @@ var texas_default = {
37535
37535
  { name: "use_dscr", label: "Land Use Description", searchable: false },
37536
37536
  { name: "tax_val", label: "Taxable Value", searchable: false }
37537
37537
  ],
37538
- confidentialFlag: { field: "conf_flg", values: ["1"] },
37539
- sampleQuery: "https://gis11.cama.io/arcgis/rest/services/Ector/EctorCounty_Basemap/MapServer/0/query?where=UPPER(owner_name)%20LIKE%20UPPER('%25SMITH%25')%20AND%20CAST(conf_flg%20AS%20VARCHAR(255))%20NOT%20LIKE%20'%251%25'&outFields=PIN,owner_name,owner_addr,conf_flg&returnGeometry=false&f=json&resultRecordCount=10",
37538
+ confidentialFlag: { field: "conf_flg", values: ["1"], safeValues: [0] },
37539
+ sampleQuery: "https://gis11.cama.io/arcgis/rest/services/Ector/EctorCounty_Basemap/MapServer/0/query?where=UPPER(owner_name)%20LIKE%20UPPER('%25SMITH%25')%20AND%20CAST(conf_flg%20AS%20VARCHAR(255))%20NOT%20LIKE%20'%251%25'%20AND%20conf_flg%20IN%20(0)&outFields=PIN,owner_name,owner_addr,conf_flg&returnGeometry=false&f=json&resultRecordCount=10",
37540
37540
  license: "unknown",
37541
37541
  licenseUrl: "https://www.ectorcad.org/",
37542
37542
  status: "live",
@@ -37549,7 +37549,7 @@ var texas_default = {
37549
37549
  url: "https://www.ectorcad.org/",
37550
37550
  email: null
37551
37551
  },
37552
- notes: "Ector County, Texas (county seat Odessa; FIPS 48135) was asked for through the free tools. The parcels are Ector County Appraisal District (Ector CAD) data, published as layer 0 ('ParcelFabric') of the Ector/EctorCounty_Basemap MapServer on gis11.cama.io, the server of the district's appraisal-software vendor (the layer is titled 'Ector County Appraisal District (public view)' on ArcGIS Online and the server's Ector folder also carries the district's aerials, features and thematic maps): 77,042 parcels on 2026-10-14, 76,779 of them with an owner (263 null). The owner is owner_name (the layer's display field); the owner mailing address is owner_addr, ONE line that includes the city and state (76,545 rows, 73,482 containing 'TX'); the parcel id is PIN (a formatted account number such as 5-5-5 digit groups, all 77,042 rows) with strap, dsp_strap and gis_parcel_id (76,779 rows each). NO SITUS COLUMN: the layer publishes no site-address field at all, so an address lookup cannot be answered from it; the registry therefore lists owner, mailing address and parcel id only, and an address-to-parcel lookup must go through a geocoded point query (inSR 4326 point intersect, verified: a point in downtown Odessa returned one parcel) rather than a text LIKE. CONFIDENTIAL OWNERS (Texas Tax Code \xA725.025): the layer carries a conf_flg column (smallint). Measured 2026-10-24, conf_flg = 0 on all 77,042 rows and no row carries a CONFIDENTIAL marker, so no value meaning 'confidential' has ever been observed here. The registry's confidentialFlag marker (conf_flg = 1) is a forward GUESS, not a measurement: it reads a future non-zero cell as flagged (the reader compares the cell as text, and a one-character value also matches inside the cell, so 10 or 21 would read as flagged too), at the cost of asserting a value Ector has never published. Re-measure before relying on it. In a where clause use AND CAST(conf_flg AS VARCHAR(255)) NOT LIKE '%1%', as the sampleQuery does: conf_flg is an integer, and the un-cast conf_flg NOT LIKE '%1%' answers with an ArcGIS error (code 400, inside an HTTP 200 response; 2026-10-25). 0 rows are flagged deleted. CORS answers Access-Control-Allow-Origin with the calling origin (checked with Origin https://urbankitstudio.com). maxRecordCount is only 1000 (pagination supported); the layer is Texas Central state plane (wkid 102739). Currency: the layer document carries no editing date; the newest dos_timestamp (date of sale) is 2026-08-05 and the newest last_rev_dt (last revision) is 2026-08-10. LICENSE AND DURABILITY: no license text; the host is a vendor server (ArcGIS 10.71) and not the district's own domain, so the URL can move when the vendor migrates the district; re-resolve from Ector CAD if the liveness probe flags it. The contact is Ector CAD. Verified 2026-10-14: a count, resultRecordCount=10 and an owner LIKE query (356 rows for %SMITH%) and a point query.",
37552
+ notes: "Ector County, Texas (county seat Odessa; FIPS 48135) was asked for through the free tools. The parcels are Ector County Appraisal District (Ector CAD) data, published as layer 0 ('ParcelFabric') of the Ector/EctorCounty_Basemap MapServer on gis11.cama.io, the server of the district's appraisal-software vendor (the layer is titled 'Ector County Appraisal District (public view)' on ArcGIS Online and the server's Ector folder also carries the district's aerials, features and thematic maps): 77,042 parcels on 2026-10-14, 76,779 of them with an owner (263 null). The owner is owner_name (the layer's display field); the owner mailing address is owner_addr, ONE line that includes the city and state (76,545 rows, 73,482 containing 'TX'); the parcel id is PIN (a formatted account number such as 5-5-5 digit groups, all 77,042 rows) with strap, dsp_strap and gis_parcel_id (76,779 rows each). NO SITUS COLUMN: the layer publishes no site-address field at all, so an address lookup cannot be answered from it; the registry therefore lists owner, mailing address and parcel id only, and an address-to-parcel lookup must go through a geocoded point query (inSR 4326 point intersect, verified: a point in downtown Odessa returned one parcel) rather than a text LIKE. CONFIDENTIAL OWNERS (Texas Tax Code \xA725.025): the layer carries a conf_flg column (smallint). Measured 2026-10-24, conf_flg = 0 on all 77,042 rows and no row carries a CONFIDENTIAL marker, so no value meaning 'confidential' has ever been observed here. The registry's confidentialFlag marker (conf_flg = 1) is a forward GUESS, not a measurement: it reads a future non-zero cell as flagged (the reader compares the cell as text, and a one-character value also matches inside the cell, so 10 or 21 would read as flagged too), at the cost of asserting a value Ector has never published. Re-measure before relying on it. In a where clause use AND CAST(conf_flg AS VARCHAR(255)) NOT LIKE '%1%' AND conf_flg IN (0), as the sampleQuery does: conf_flg is an integer, and the un-cast conf_flg NOT LIKE '%1%' answers with an ArcGIS error (code 400, inside an HTTP 200 response; 2026-10-25). The IN list is confidentialFlag.safeValues, the one distinct value the column holds (0, an integer, so it is not quoted; measured 2026-10-26 with returnDistinctValues): any other cell drops out, and the IN clause alone, or both clauses together, keep all 77,042 rows. 0 rows are flagged deleted. CORS answers Access-Control-Allow-Origin with the calling origin (checked with Origin https://urbankitstudio.com). maxRecordCount is only 1000 (pagination supported); the layer is Texas Central state plane (wkid 102739). Currency: the layer document carries no editing date; the newest dos_timestamp (date of sale) is 2026-08-05 and the newest last_rev_dt (last revision) is 2026-08-10. LICENSE AND DURABILITY: no license text; the host is a vendor server (ArcGIS 10.71) and not the district's own domain, so the URL can move when the vendor migrates the district; re-resolve from Ector CAD if the liveness probe flags it. The contact is Ector CAD. Verified 2026-10-14: a count, resultRecordCount=10 and an owner LIKE query (356 rows for %SMITH%) and a point query.",
37553
37553
  addedAt: "2026-10-14"
37554
37554
  },
37555
37555
  {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@urbankitstudio/atlas",
3
- "version": "0.6.45",
3
+ "version": "0.6.47",
4
4
  "description": "JS SDK for the UrbanKit County Parcel REST API Atlas: 503 counties across all 50 US states and DC, 498 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",