@mailwoman/corpus 10.3.0 → 10.5.0

package/lib/adapters.ts

@@ -19,7 +19,7 @@
  *   what the adapter reads: BAN covers France and ten overseas jurisdictions, Matrikkelen covers
  *   Norway and Svalbard, and Ryhti's one national file covers Åland beside the Finnish mainland.
  *
- *   Flanders is the counter-case worth stating. Its adapter sits under `be` and covers the Flemish
+ *   Flanders is the counter-case. Its adapter sits under `be` and covers the Flemish
  *   Region only, because Brussels and Wallonia publish the INSPIRE theme through their own
  *   services, so Belgium needs three adapters rather than one.
  *
@@ -64,6 +64,7 @@ import { ryhtiAdapter } from "#fi/adapters/ryhti/adapter"
 import { annuaireEducationAdapter } from "#fr/adapters/annuaire-education/adapter"
 import { banAdapter } from "#fr/adapters/ban/adapter"
 import { finessAdapter } from "#fr/adapters/finess/adapter"
+import { gbOSOpenAdapter } from "#gb/adapters/os-open/adapter"
 import { itANACAdapter } from "#it/adapters/anac/adapter"
 import { bdAdressesAdapter } from "#lu/adapters/bd-adresses/adapter"
 import { varisAdapter } from "#lv/adapters/varis/adapter"
@@ -88,7 +89,7 @@ import { usgovNPPESAdapter } from "#us/adapters/usgov/nppes/adapter"
 /**
  * Built-in adapters.
  *
- * Order is significant, because `corpus build` iterates this list to drive every adapter in turn.
+ * Order matters, because `corpus build` iterates this list to drive every adapter in turn.
  * The order runs coarse-first (admin, then postcode), then street-level
  * (BAN FR, tiger US, OpenAddresses global), then adversarial-source (FCC BDC US, HRSA fqhc US).
  *
@@ -120,6 +121,7 @@ export const BUILTIN_ADAPTERS: readonly CorpusAdapter[] = [
 	esBizkaiaAdapter,
 	esGipuzkoaAdapter,
 	esNavarraAdapter,
+	gbOSOpenAdapter,
 	tigerAdapter,
 	openaddressesAdapter,
 	overtureAdapter,

package/lib/au/adapters/gnaf/adapter.ts

@@ -45,7 +45,7 @@ interface GNAFTuple {
 }
 
 /**
- * The address layouts an AU address actually arrives in.
+ * The address layouts an AU address arrives in.
  *
  * The model already handles postcode-trailing (canonical); the two postcode-leading
  * forms are the ones it fails, so they show the change.

package/lib/be/adapters/brussels/adapter.ts

@@ -51,7 +51,7 @@
  * Nine addresses write `<ad:component xlink:href=""/>` in the postal-zone slot, so those nine state
  * no postcode: `BE.BRUSSELS.BRIC.ADM.ADPT.220623`, `.220631`, `.220635`, `.256972`, `.257005` and
  * four more, in Bruxelles and Schaerbeek. `componentHrefs` skips an empty href, so an unwary reader
- * yields those rows with the postcode simply missing. This adapter refuses them and
+ * yields those rows with no postcode and no error. This adapter refuses them and
  * counts them under {@link Refusals.noPostcode}, because a postcode the publisher left unstated is
  * not a postcode this repository may read as absent from the address.
  *
@@ -163,7 +163,7 @@ export const BRUSSELS_SOURCE_REGISTER = SourceRegister.BrusselsInspireAddresses
 export const BRUSSELS_COUNTRIES: readonly string[] = ["BE"]
 
 /**
- * The license label recorded on every row.
+ * Every emitted row records this license label.
  *
  * The register's source `be-property-building-3` elects `CC-BY-4.0` for Paradigm, read from
  * the `gmd:useConstraints` of ISO 19139 record `260abd6f-c5b4-4a79-aa80-d6c265002d65`.
@@ -224,7 +224,7 @@ const COMPONENT_TYPES = ["ad:ThoroughfareName", "ad:PostalDescriptor", "ad:Admin
  * An address reaching the reader with fewer readable references has written one of them empty.
  *
  * That count is how the nine postcode-less addresses are told apart from an
- * address whose reference simply does not resolve.
+ * address whose reference does not resolve.
  */
 const COMPONENTS_PER_ADDRESS = 7
 

package/lib/be/adapters/vlaanderen/adapter.ts

@@ -282,7 +282,7 @@ export function componentResourceID(href: string): string | null {
  * A Flemish street name read apart from the homonym discriminator that follows it.
  *
  * `gn:text` on an `ad:ThoroughfareName` states more than the street name: the name,
- * an underscore, and a discriminator that is usually empty.
+ * an underscore, and a discriminator that is empty in most identifiers.
  * Over 20,000 values at twenty offsets, 19,979 end with `_` and the remaining
  * 21 have a discriminator after it.
  *

package/lib/be/adapters/wallonie/adapter.ts

@@ -183,7 +183,7 @@ export const WALLONIE_SOURCE_REGISTER = SourceRegister.WallonieInspireAddresses
 export const WALLONIE_COUNTRIES: readonly string[] = ["BE"]
 
 /**
- * The license recorded on every row.
+ * Every emitted row records this license.
  *
  * The register's elected decision for `unchecked-access-free-be-service-public-de-wallonie-spw`
  * records `spdx: "CC-BY-4.0"`, and `electedLicenseLabel` answers the SPDX id when one is recorded.

package/lib/build/align.ts

@@ -90,7 +90,7 @@ export interface AlignPhaseResult {
 	ineligibleSources: Map<string, readonly string[]>
 
 	/**
-	 * The license cache used by this phase.
+	 * The license cache this phase uses.
 	 *
 	 * Its `refusedValues()` method returns every value it refused.
 	 */

package/lib/build.ts

@@ -104,7 +104,7 @@ export async function buildCorpus(opts: BuildCorpusOptions): Promise<BuildCorpus
 	opts.onProgress?.("parquet", "writing parquet files")
 
 	// Each split gets its own generator seeded from one base, so a split's row order does
-	// not depend on how many rows the earlier splits happened to contain.
+	// not depend on the number of rows the earlier splits happened to contain.
 	const shuffled = (path: PathBuilderLike, salt: number) =>
 		shuffleWithinWindow(streamJSONL<LabeledRow>(path), makeMulberry32(shuffleSeed + salt), shuffleWindow)
 

package/lib/cz/adapters/cuzk/adapter.ts

@@ -15,7 +15,7 @@
  * to read. The `ad:component` hrefs look external, because ČÚZK writes an absolute WFS stored-query
  * URL on `services.cuzk.cz`. The `Id=` parameter of each one matches a `gml:id` in the file at hand.
  * Measured over `584282.xml`: 5,460 component references across 1,365 addresses, 0 of them reaching
- * outside the archive. Only `ad:parcel` and `ad:building` point at genuinely separate themes, and
+ * outside the archive. Only `ad:parcel` and `ad:building` point at separate themes, and
  * the adapter reads neither.
  *
  * ČÚZK states one condition of use and states it uniformly. Every one of the 6,259 `rights` elements
@@ -62,7 +62,7 @@ export const CZ_CUZK_ADAPTER_ID = "cz-cuzk"
 export const CZ_CUZK_COUNTRIES: readonly string[] = ["CZ"]
 
 /**
- * The license recorded on every row.
+ * Every emitted row records this license.
  *
  * INSPIRE's controlled value, in the English the register renders it to, because ČÚZK
  * names no license instrument and the register therefore writes no SPDX identifier.

package/lib/cz/tools/fetch/cuzk.ts

@@ -123,11 +123,11 @@ export const CZ_CUZK_REQUEST_INTERVAL_MS = 250
 const ZIP_SIGNATURE = "PK"
 
 /**
- * How many archives are written between two manifest writes.
+ * The number of archives written between two manifest writes.
  *
  * The manifest is what makes an interrupted harvest resumable, and writing it
  * after every archive would rewrite a 6,258-entry document 6,258 times.
- * At this interval an interruption re-fetches at most this many archives that are already on disk.
+ * At this interval an interruption re-fetches at most this number of archives that are already on disk.
  */
 const MANIFEST_INTERVAL = 25
 
@@ -352,7 +352,7 @@ export interface CzCuzkHarvestManifest extends SourceCollectionManifest {
 	 */
 	projection: CzCuzkProjection
 	/**
-	 * How many municipalities the service document listed when this manifest was written.
+	 * The number of municipalities the service document listed when this manifest was written.
 	 *
 	 * The denominator for `files`, read from the feed on each run rather than fixed here.
 	 */
@@ -379,7 +379,7 @@ export interface HarvestCzCuzkOptions {
 	 */
 	municipalities?: readonly string[]
 	/**
-	 * Stop after this many municipalities, counting the ones already on disk.
+	 * Stop after this number of municipalities, counting the ones already on disk.
 	 *
 	 * A bounded run rather than all 6,258.
 	 */
@@ -407,7 +407,7 @@ export interface HarvestCzCuzkOptions {
 /**
  * Whether the archive recorded for one municipality is still the one the feed now describes.
  *
- * Three conditions, and the first is what saves 6,258 requests: the service
+ * Three conditions must hold, and the first is what saves 6,258 requests: the service
  * document states the same modification time it stated when the file was fetched,
  * the file is still there, and it is still the length that was recorded for it.
  */
@@ -451,7 +451,7 @@ export async function harvestCzCuzk(
 
 	// MARK: Read the service document
 	//
-	// One request, and it states the modification time of every archive the service offers.
+	// One request states the modification time of every archive the service offers.
 
 	report?.(`=== ${SLUG}: reading ${CZ_CUZK_SERVICE_FEED_URL}`)
 

package/lib/de/recipes/locale.ts

@@ -15,7 +15,7 @@
  * Two registers are absent from the OA tuples. A comma-free single line (`Neusser Str. 12 Nippes 50733
  * Köln`) segments as one unit at stage 2. With one segment, the placetype-pair prior never fires.
  * The model then reads `Nippes` as a second street. The one-value-per-tag projection deletes it.
- * `--comma-free-fraction` renders that many native-order rows with `" "` as the line separator. OA
+ * `--comma-free-fraction` renders that share of native-order rows with `" "` as the line separator. OA
  * rows also lack a district, so `--ortsteil-fraction` rows borrow a WOF Ortsteil of the tuple's
  * own locality as `dependent_locality`. The German spelling is recovered from the `names` table
  * ({@link ortsteilSurface}) because WOF's `spr.name` for DE neighborhoods is the ascii-folded label.

package/lib/dk/adapters/inspire/adapter.ts

@@ -93,7 +93,7 @@ export const DK_INSPIRE_COUNTRIES: readonly string[] = ["DK"]
 export const DK_INSPIRE_REQUIRED_TABLES: readonly string[] = ["address", "postaldescriptor", "thoroughfarename"]
 
 /**
- * How many rows Kysely buffers per chunk while streaming the join.
+ * The number of rows Kysely buffers per chunk while streaming the join.
  */
 const STREAM_CHUNK_ROWS = 2000
 

package/lib/ee/tools/fetch/ads.ts

@@ -76,7 +76,7 @@ export const EE_ADS_SORT_BY = "gml_id"
  * Features per page.
  *
  * The service's `CountDefault` is 1,000,000 and it honors `count=10000`, which is where the page
- * size is set: a 10,000-feature page is 31,198,909 bytes, and a larger page buys fewer requests
+ * size is set: a 10,000-feature page is 31,198,909 bytes, and a larger page needs fewer requests
  * at the cost of holding a larger body in memory and losing more work when one request fails.
  */
 export const EE_ADS_PAGE_SIZE = 10_000
@@ -135,7 +135,7 @@ export interface HarvestADSOptions {
 	 */
 	pageSize?: number
 	/**
-	 * Stop once the manifest holds this many pages, for a probe rather than a full harvest.
+	 * Stop once the manifest holds this number of pages, for a probe rather than a full harvest.
 	 */
 	maxPages?: number
 	signal?: AbortSignal

package/lib/es/adapters/bizkaia/adapter.ts

@@ -164,7 +164,7 @@ const MUNICIPALITY_LEVEL = "3rdOrder"
 const HOUSE_NUMBER_TYPE = "buildingIdentifier"
 
 /**
- * How many dot-separated fields a designator has.
+ * The number of dot-separated fields a designator has.
  *
  * Municipality, street, number: `48.001.00026.003` splits the municipality code across two.
  */

package/lib/es/adapters/navarra/adapter.ts

@@ -14,8 +14,8 @@
  * no such mapping and this adapter claims none. It reads one archive or a directory of them. A
  * caller harvests all 272 by pointing it at the directory.
  *
- * This publisher is read entirely from its references' titles, and that is what separates it from
- * every other INSPIRE reader here. Its own file publishes no `AD:ThoroughfareName`,
+ * This publisher is read entirely from its references' titles. No other INSPIRE reader
+ * here reads its addresses that way. Its own file publishes no `AD:ThoroughfareName`,
  * `AD:PostalDescriptor` or `AD:AdminUnitName` feature at all: partition 1 holds 29 distinct element
  * names across 115 addresses and none of them is a component feature. Each address instead holds
  * six `AD:component` references whose `xlink:title` states the value:

package/lib/es/cadastre.ts

@@ -72,8 +72,8 @@ export function spanishHouseNumber(
  * `ES.SDGC.PD.55.101.` and `ES.GFA.PD.059.`, against no feature of that id.
  *
  * Those truncated references are the only unresolvable ones measured in either file.
- * A reader taking every unresolved reference as an absence would also swallow a genuinely
- * broken join, so the two are separated here and every other unresolved reference raises.
+ * A reader taking every unresolved reference as an absence would also swallow a broken join,
+ * so the two are separated here and every other unresolved reference raises.
  */
 export function referenceStatesNoValue(key: string): boolean {
 	return key.trim().endsWith(".")

package/lib/es/tools/fetch/bizkaia.ts

@@ -16,10 +16,10 @@
  *   archives therefore reads every address in the province without its street, its postcode or
  *   its municipality. This harvest acquires both services into one directory for that reason.
  *
- *   Each component type is read in one request, and that is the only way this service serves it. Its
+ *   Each component type is read in one request. This service serves a type no other way. Its
  *   capabilities document states `ImplementsResultPaging` as `FALSE` and `CountDefault` as `1000`, so
  *   a reader that paged a type would receive the first page again. The harvest therefore asks
- *   `RESULTTYPE=hits` for the type's count and then asks for that many features in one `GetFeature`,
+ *   `RESULTTYPE=hits` for the type's count and then asks for that number of features in one `GetFeature`,
  *   and {@linkcode fetchBizkaiaComponentDocument} raises where the document returns fewer than the
  *   count. A truncated component document is the failure that would otherwise reach the adapter as
  *   an unresolved reference per address.
@@ -121,11 +121,11 @@ export const ES_BIZKAIA_REQUEST_INTERVAL_MS = 250
 const BODY_TIMEOUT_MS = 600_000
 
 /**
- * How many archives are written between two manifest writes.
+ * The number of archives written between two manifest writes.
  *
  * The manifest is what makes an interrupted harvest resumable, and writing it
  * after every archive would rewrite the whole document once per municipality.
- * At this interval an interruption re-fetches at most this many archives already on disk.
+ * At this interval an interruption re-fetches at most this number of archives already on disk.
  */
 const MANIFEST_INTERVAL = 25
 
@@ -306,7 +306,7 @@ export interface ESBizkaiaHarvestManifest extends SourceCollectionManifest {
 	 */
 	feed_updated: string | null
 	/**
-	 * How many municipalities the service document listed when this manifest was written.
+	 * The number of municipalities the service document listed when this manifest was written.
 	 *
 	 * The denominator for `files`, read from the feed on each run rather than fixed here.
 	 */
@@ -332,7 +332,7 @@ export interface HarvestESBizkaiaOptions {
 	 */
 	municipalities?: readonly string[]
 	/**
-	 * Stop after this many municipalities, counting the ones already on disk.
+	 * Stop after this number of municipalities, counting the ones already on disk.
 	 */
 	limit?: number
 	/**
@@ -390,7 +390,7 @@ async function archiveIsCurrent(
 /**
  * Reads one component feature type whole and writes it beside the archives.
  *
- * Two requests per type: `RESULTTYPE=hits` for the count, then one `GetFeature` for that many features.
+ * Two requests per type: `RESULTTYPE=hits` for the count, then one `GetFeature` for that number of features.
  * `COUNT` is asked one above the stated count, so a service whose hits response
  * undercounts its own matches answers with more features than it claimed
  * rather than with exactly the number the harvest asked for.
@@ -487,7 +487,7 @@ export async function harvestESBizkaia(
 
 	// MARK: Read the service document
 	//
-	// One request, and it states the version of every archive the service offers.
+	// One request states the version of every archive the service offers.
 
 	report?.(`=== ${ES_BIZKAIA_ADAPTER_ID}: reading ${ES_BIZKAIA_SERVICE_URL}`)
 

package/lib/es/tools/fetch/catastro.ts

@@ -105,11 +105,11 @@ export const ES_CATASTRO_REQUEST_INTERVAL_MS = 250
 const SLUG = ES_CATASTRO_ADAPTER_ID
 
 /**
- * How many archives are written between two manifest writes.
+ * The number of archives written between two manifest writes.
  *
  * The manifest is what makes an interrupted harvest resumable, and writing it after every
  * archive would rewrite a document with one entry per municipality once per municipality.
- * At this interval an interruption re-fetches at most this many archives that are already on disk.
+ * At this interval an interruption re-fetches at most this number of archives that are already on disk.
  */
 const MANIFEST_INTERVAL = 25
 
@@ -416,18 +416,18 @@ export interface ESCatastroArchiveEntry extends SourceManifest {
  */
 export interface ESCatastroHarvestManifest extends SourceCollectionManifest {
 	/**
-	 * How many territorial offices the service document listed, read from the feed on each run.
+	 * The number of territorial offices the service document listed, read from the feed on each run.
 	 */
 	provinces_listed: number
 	/**
-	 * How many of those offices this run read a province feed for.
+	 * The number of those offices this run read a province feed for.
 	 *
 	 * A bounded run reads fewer, so this is the denominator for `municipalities_listed`
 	 * rather than a count of the country.
 	 */
 	provinces_harvested: number
 	/**
-	 * How many municipalities the province feeds this run read listed between them.
+	 * The number of municipalities the province feeds this run read listed between them.
 	 */
 	municipalities_listed: number
 	files: ESCatastroArchiveEntry[]
@@ -453,7 +453,7 @@ export interface HarvestESCatastroOptions {
 	 */
 	municipalities?: readonly string[]
 	/**
-	 * Stop after this many municipalities, counting the ones already on disk.
+	 * Stop after this number of municipalities, counting the ones already on disk.
 	 */
 	limit?: number
 	/**

package/lib/es/tools/fetch/navarra.ts

@@ -91,10 +91,10 @@ export const ES_NAVARRA_REQUEST_INTERVAL_MS = 250
 const SLUG = ES_NAVARRA_ADAPTER_ID
 
 /**
- * How many archives are written between two manifest writes.
+ * The number of archives written between two manifest writes.
  *
  * The manifest is what makes an interrupted harvest resumable.
- * At this interval an interruption re-fetches at most this many archives that are already on disk.
+ * At this interval an interruption re-fetches at most this number of archives that are already on disk.
  */
 const MANIFEST_INTERVAL = 25
 
@@ -217,7 +217,7 @@ export interface ESNavarraArchiveEntry extends SourceManifest {
  */
 export interface ESNavarraHarvestManifest extends SourceCollectionManifest {
 	/**
-	 * How many partitions the service document listed when this manifest was written.
+	 * The number of partitions the service document listed when this manifest was written.
 	 *
 	 * The denominator for `files`, read from the feed on each run rather than fixed here.
 	 */
@@ -238,7 +238,7 @@ export interface HarvestESNavarraOptions {
 	 */
 	partitions?: readonly string[]
 	/**
-	 * Stop after this many partitions, counting the ones already on disk.
+	 * Stop after this number of partitions, counting the ones already on disk.
 	 */
 	limit?: number
 	/**

package/lib/fingerprints.ts

@@ -4,8 +4,8 @@
  * @author Teffen Ellis, et al.
  * @file A fixed-capacity set of 128-bit fingerprints in one flat `Uint32Array`.
  *
- *   The adapter runner deduplicates by holding every key it has seen. A V8 `Set` refuses its 16,777,217th
- *   entry outright, so the runner capped itself at 10,000,000 keys. Three adapters passed that cap in
+ *   The adapter runner deduplicates by holding every key it has seen. A V8 `Set` throws on its 16,777,217th
+ *   entry, so the runner capped itself at 10,000,000 keys. Three adapters passed that cap in
  *   `v0.7.0-de-holdout`. The duplicate census over that build measured what the cap costs: of the
  *   2,491,399 duplicate rows the three adapters wrote, 1,490,992 duplicate a key first seen after the cap.
  *   A membership test on a capped set cannot refuse those rows.
@@ -77,7 +77,7 @@ export class FingerprintSet {
 	}
 
 	/**
-	 * How many keys this table accepts before {@linkcode add} throws.
+	 * The number of keys this table accepts before {@linkcode add} throws.
 	 */
 	get limit(): number {
 		return this.#limit

package/lib/fr/adapters/finess/adapter.ts

@@ -32,8 +32,8 @@
  *
  * Every FINESS establishment is an organization's site: a hospital, a pharmacy, a laboratory, a
  * service office. Three categories house the people they serve in a private dwelling. In `462`
- * Lieux de vie et d'accueil the staff live with the people they receive. A `238` Centre d'accueil
- * familial spécialisé places patients with host families, as a `236` Service de placement familial
+ * Lieux de vie et d'accueil the staff live with the people they receive. A FINESS category `238`
+ * establishment, specialized family reception, places patients with host families, as a `236` Service de placement familial
  * does. An address in those three can be a family's home, so they are refused under
  * {@linkcode FinessRefusal.FamilyPlacement}, as is an establishment whose name states family
  * placement or a lieu de vie under another category. A row whose street type is TRE-R35's `CHEZ`,
@@ -56,7 +56,7 @@
  *
  * A digit in `voie` is refused under {@linkcode FinessRefusal.StreetDigitUnplaced} unless the digits
  * name the street, as a numbered route (`NATIONALE 2`) or a date (`DU 22 MAI`) does. The number has
- * its own field, so a digit left in the name is a box, a building or a door: `VALLÉE 3 BP 208`,
+ * its own field, so a digit left in the street name is a box, a building or a door: `VALLÉE 3 BP 208`,
  * `DIAKA BAT A4 PORTE 2`.
  *
  * ## The lieu-dit and box line, and the routing line
@@ -166,8 +166,9 @@ export const FR_FINESS_COUNTRIES: readonly string[] = [
 ]
 
 /**
- * The establishment categories whose address can be a private dwelling: lieux de vie et
- * d'accueil, centres d'accueil familial spécialisés and services de placement familial.
+ * The establishment categories whose address can be a private dwelling: FINESS
+ * categories `462` (lieux de vie et d'accueil), `238` (specialized family reception)
+ * and `236` (services de placement familial).
  */
 export const FINESS_FAMILY_PLACEMENT_CATEGORIES: ReadonlySet<string> = new Set(["236", "238", "462"])
 

package/lib/fr/adapters/finess/voie-type.ts

@@ -41,7 +41,7 @@ import { decomposeFrStreet } from "#fr/street-decompose"
  *
  * `VAL` keeps the code as its word.
  * TRE-R35 displays it as `Vallée, vallon`, two words the code does not choose between,
- * and `Val` is itself the written word of many French place names.
+ * and `Val` is itself the written word in French place names such as `Val-d'Isère`.
  */
 export const TRE_R35_VOIE_TYPES: Readonly<Record<string, string | null>> = {
 	ANSE: "anse",

package/lib/fr/tools/fetch/annuaire-education.ts

@@ -15,7 +15,7 @@
  *
  * Two checks keep a short transfer from reading as a small directory. The records endpoint is asked
  * for the `total_count` of the same filter before the export, and the written file must hold exactly
- * that many lines. A mismatch removes the file and fails the fetch. A re-run compares the catalog
+ * that number of lines. A mismatch removes the file and fails the fetch. A re-run compares the catalog
  * record's `modified` against the manifest and makes no transfer when they agree and the file is on
  * disk at the recorded length.
  */
@@ -75,7 +75,7 @@ export function annuaireExportURL(): string {
 }
 
 /**
- * The records URL that answers how many records the overseas filter selects.
+ * The records URL that answers with the count of records the overseas filter selects.
  */
 export function annuaireCountURL(): string {
 	return `${ANNUAIRE_EDUCATION_API_URL}/records?where=${encodeURIComponent(annuaireOverseasFilter())}&limit=0`
@@ -135,7 +135,7 @@ export async function readAnnuaireCatalog(
 }
 
 /**
- * Read how many records the overseas filter selects.
+ * Read the count of records the overseas filter selects.
  *
  * @throws When the endpoint answers no `total_count`.
  */