@uk-open-data-connectors/uk-sources 0.1.0

package/README.md

@@ -0,0 +1,206 @@
+# @uk-open-data-connectors/uk-sources
+
+Uniform TypeScript adapters for UK public data sources. Every adapter has the
+same shape: a live fetch, a strict parse, and a committed fixture fallback so
+builds work offline.
+
+## Adapters
+
+| id                         | Source                              | Auth | What it does                                                 |
+| -------------------------- | ----------------------------------- | ---- | ------------------------------------------------------------ |
+| `flood-stations`           | Environment Agency flood-monitoring | none | Monitoring stations with river and catchment                 |
+| `flood-readings`           | Environment Agency flood-monitoring | none | Recent water levels for one station, newest first            |
+| `ons-datasets`             | ONS beta API dataset catalogue      | none | Every dataset the ONS lists, with its state and stamp        |
+| `food-hygiene-authorities` | Food Standards Agency food hygiene  | none | Every local authority register, with its establishment count |
+| `tfl-bike-points`          | Transport for London cycle hire     | none | Every Santander Cycles docking station, with docking points and docked bikes |
+| `planning-datasets`        | Planning Data platform (MHCLG)      | none | Every planning dataset, with the records published behind it |
+| `ancient-woodland`         | Natural England ancient woodland    | none | Ancient woodland polygons for England, counted by type and size |
+| `bank-rate`                | Bank of England Bank Rate           | none | The daily official Bank Rate, one reading per business day since 1975 |
+| `police-crimes`            | Home Office police.uk               | none | Street-level crime within a mile of a point, counted by crime type and outcome |
+| `carbon-intensity`         | National Energy System Operator     | none | Half-hourly carbon intensity for Great Britain, with the window's cleanest and dirtiest half hours |
+| `parliament-seats`         | UK Parliament Members API           | none | Seats each party holds in the Commons, with the members counted behind them |
+
+The flood-monitoring adapters use `environment.data.gov.uk` under the Open
+Government Licence v3:
+<https://environment.data.gov.uk/flood-monitoring/doc/reference>
+
+The ONS adapter uses the beta API behind the ONS website rebuild,
+<https://api.beta.ons.gov.uk/v1/datasets>, also keyless and under the Open
+Government Licence v3.
+
+The food hygiene adapter uses the FSA Food Hygiene Rating Scheme API,
+<https://api.ratings.food.gov.uk/Authorities/basic>, also keyless and under the
+Open Government Licence v3. It answers only with the version header the FSA
+asks for, `x-api-version: 2`; without it the endpoint returns HTTP 404.
+
+The Planning Data platform adapter uses the dataset catalogue behind
+<https://www.planning.data.gov.uk/dataset>, <https://www.planning.data.gov.uk/dataset.json>,
+which answers without a key under the Open Government Licence v3. The file
+lists datasets alongside the platform's pipeline configuration and provenance
+tables, so the adapter keeps the entries whose `realm` is `dataset`.
+
+The ancient woodland adapter uses Natural England's Ancient Woodland (England)
+layer on the Defra ArcGIS estate,
+<https://services.arcgis.com/JJzESW51TqeY9uat/arcgis/rest/services/Ancient_Woodland_England/FeatureServer/0>,
+which answers without a key under the Open Government Licence v3. The layer
+carries more than fifty thousand polygons, past ArcGIS's page size, so the
+adapter reads the counts from the service's own statistics queries instead of
+downloading the features.
+
+The Bank Rate adapter uses the Bank of England's Interactive Statistical
+Database (IADB),
+<https://www.bankofengland.co.uk/boeapps/database/_iadb-fromshowcolumns.asp>,
+which answers without a key. The daily series, `IUDBEDR`, starts on 2 January
+1975; asking for an earlier start returns the database's error page instead of
+a CSV, so the adapter starts there. The Bank's published terms place
+reproduction of Database data under the Open Government Licence v3:
+<https://www.bankofengland.co.uk/legal>.
+
+The recorded crime adapter uses the Home Office police.uk API,
+<https://data.police.uk/api/crimes-street/all-crime>, which answers without a
+key under the Open Government Licence v3. It holds the last 36 months of
+street-level crime from the 44 forces of England, Wales and Northern Ireland,
+so nothing here covers Scotland. A call takes a point and returns everything
+within a mile of it, which is why the adapter counts around one point rather
+than a boundary, and it asks for one month at a time to stay inside the API's
+limit of 15 requests a second.
+
+The docking station adapter uses TfL's Unified API,
+<https://api.tfl.gov.uk/BikePoint>, which answers without a key. TfL asks for
+an app key above the free rate limit, so `fetchTflBikePoints` takes an optional
+key and sends it as the `app_key` query parameter. The data is published as TfL
+Open Data: <https://tfl.gov.uk/info-for/open-data-users/>.
+
+The carbon intensity adapter uses the National Energy System Operator's Carbon
+Intensity API, <https://api.carbonintensity.org.uk/intensity>, which answers
+without a key. It is the official half-hourly series for Great Britain, with a
+reading and a grade for every half hour, and the API's own terms place the data
+under the Creative Commons Attribution 4.0 licence:
+<https://terms.carbonintensity.org.uk/>. The API refuses a range longer than 31
+days, so the adapter reads whole days and asks for a window that ends at the
+start of today, which keeps every reading in it a settled one.
+
+The Parliament seat adapter uses the UK Parliament Members API,
+<https://members-api.parliament.uk/api/Parties/StateOfTheParties>, which
+answers without a key. It is the current state of the parties in each house,
+with the seats a party holds and the members counted behind them, published
+under the Open Parliament Licence v3.0:
+<https://www.parliament.uk/site-information/copyright-parliament/open-parliament-licence/>.
+The call needs a house and a date, so the adapter asks for the caller's own
+date rather than a fixed one.
+
+Note on sources that look obvious but are not usable: `api.ons.gov.uk` was
+retired on 2024-11-25 and now answers every request with a decommission notice.
+The beta API at `api.beta.ons.gov.uk/v1` replaced it for dataset metadata,
+editions, versions, and observations.
+
+## Usage
+
+```ts
+import { fetchFloodStationReadings, summarizeFloodReadings } from '@uk-open-data-connectors/uk-sources';
+import { fetchOnsDatasets, summarizeOnsDatasets } from '@uk-open-data-connectors/uk-sources';
+import { fetchFoodHygieneAuthorities, summarizeFoodHygieneAuthorities } from '@uk-open-data-connectors/uk-sources';
+import { fetchTflBikePoints, summarizeTflBikePoints } from '@uk-open-data-connectors/uk-sources';
+import { fetchPlanningDatasets, summarizePlanningDatasets } from '@uk-open-data-connectors/uk-sources';
+import { fetchAncientWoodlandProfile } from '@uk-open-data-connectors/uk-sources';
+import { fetchBankRateObservations, summarizeBankRateSeries } from '@uk-open-data-connectors/uk-sources';
+import { fetchPoliceCrimeSummary } from '@uk-open-data-connectors/uk-sources';
+import { fetchCarbonIntensityWindow } from '@uk-open-data-connectors/uk-sources';
+import { fetchParliamentSeats } from '@uk-open-data-connectors/uk-sources';
+
+const readings = await fetchFloodStationReadings('1029TH', { limit: 96 });
+const summary = summarizeFloodReadings(readings);
+console.log(summary.latest?.value, summary.trend);
+
+const catalogue = summarizeOnsDatasets(await fetchOnsDatasets());
+console.log(catalogue.datasetCount, catalogue.yearCounts);
+
+const registers = summarizeFoodHygieneAuthorities(await fetchFoodHygieneAuthorities());
+console.log(registers.authorityCount, registers.establishmentCount);
+
+const docks = summarizeTflBikePoints(await fetchTflBikePoints());
+console.log(docks.stationCount, docks.dockCount, docks.largestStations[0]?.name);
+
+const planning = summarizePlanningDatasets(await fetchPlanningDatasets());
+console.log(planning.datasetCount, planning.entityCount, planning.emptyDatasetCount);
+
+const woodland = await fetchAncientWoodlandProfile();
+console.log(woodland.recordCount, woodland.totalHectares, woodland.sizeBands[0]?.recordCount);
+
+const intensity = await fetchCarbonIntensityWindow();
+console.log(intensity.periodCount, intensity.averageIntensity, intensity.lowestPeriod.intensity);
+
+const seats = await fetchParliamentSeats();
+console.log(seats.seatCount, seats.partyCount, seats.largestParty.party.name);
+```
+
+## UK Parliament seats
+
+`fetchParliamentSeats` reads the state of the parties in the House of Commons
+and returns the seat counts a page can print.
+
+```ts
+import { fetchParliamentSeats } from '@uk-open-data-connectors/uk-sources';
+
+const seats = await fetchParliamentSeats();
+// { seatCount: 650, partyCount: 18, majorityThreshold: 326, ... }
+console.log(seats.largestParty.party.name, seats.largestParty.seatCount);
+```
+
+The payload is validated with this schema before anything is counted:
+
+```ts
+const PARLIAMENT_PARTY_SCHEMA = z.object({
+  id: z.number().int(),
+  name: z.string().nullable(),
+  abbreviation: z.string().nullable(),
+  backgroundColour: z.string().nullable(),
+  foregroundColour: z.string().nullable(),
+  isIndependentParty: z.boolean(),
+});
+
+const PARLIAMENT_SEAT_COUNT_SCHEMA = z.object({
+  male: z.number().int().nonnegative().nullable(),
+  female: z.number().int().nonnegative().nullable(),
+  nonBinary: z.number().int().nonnegative().nullable(),
+  total: z.number().int(),
+  party: PARLIAMENT_PARTY_SCHEMA.nullable(),
+});
+
+const PARLIAMENT_RESPONSE_SCHEMA = z.object({
+  items: z.array(z.object({ value: PARLIAMENT_SEAT_COUNT_SCHEMA.nullable() })).nullable(),
+});
+```
+
+The public surface also carries `buildParliamentSeatsUrl(house, forDate)` for
+a specific house and date, `formatParliamentQueryDate(date)` for the
+`YYYY-MM-DD` the path takes, and `parseParliamentSeats(payload)` /
+`summarizeParliamentPartySeats(seats)` for parsing a payload or a list of
+parties on its own. `PARLIAMENT_COMMONS_HOUSE` is 1 and
+`PARLIAMENT_LORDS_HOUSE` is 2.
+
+Quirks worth knowing before you build on this:
+
+- A vacant seat appears as its own party, named `Vacant`, with one seat and
+  no members behind it. The summary keeps it in `seats` and reports the gap
+  per row as `unallocatedSeatCount`, so `male + female + nonBinary` can sit
+  below `seatCount`.
+- `backgroundColour` and `foregroundColour` are null for a few parties,
+  including the Speaker, so a chart needs its own fallback colour rather than
+  reading the field straight.
+- The house is a path segment, not a query parameter: 1 is the Commons and 2
+  is the Lords, and the same call returns peers for house 2.
+- The call can be slow. One request here timed out at 25 seconds and the next
+  answered in two, so give it a generous timeout and keep a committed fixture
+  fallback.
+- The date is part of the call, so a page that wants "today" has to send its
+  own date; the response does not echo the date or the house back.
+
+## Tests
+
+Unit tests run against the committed fixtures in `src/fixtures`, offline.
+
+```bash
+npm run test --workspace @uk-open-data-connectors/uk-sources
+npm run test:smoke --workspace @uk-open-data-connectors/uk-sources   # hits the live APIs
+```

package/dist/ancientWoodland.d.ts

@@ -0,0 +1,102 @@
+import type { UkDataAdapter } from './types.js';
+/**
+ * Natural England's Ancient Woodland (England) polygons, served from the Defra
+ * ArcGIS estate. The layer behind the Ancient Woodland Inventory: land that
+ * has carried continuous woodland cover since at least 1600. Keyless, and
+ * published under the Open Government Licence v3.
+ */
+export declare const ANCIENT_WOODLAND_QUERY_URL = "https://services.arcgis.com/JJzESW51TqeY9uat/arcgis/rest/services/Ancient_Woodland_England/FeatureServer/0/query";
+/** The dataset's page on the Natural England open data hub. */
+export declare const ANCIENT_WOODLAND_DATASET_URL = "https://naturalengland-defra.opendata.arcgis.com/datasets/ancient-woodland-england";
+/** The source id these errors and probes carry. */
+export declare const ANCIENT_WOODLAND_SOURCE_ID = "ancient-woodland";
+/** The three woodland types the layer's STATUS field uses. */
+export type AncientWoodlandCategoryId = 'asnw' | 'paws' | 'awp';
+/** One woodland type in the layer, with the name Natural England gives it. */
+export interface AncientWoodlandCategory {
+    id: AncientWoodlandCategoryId;
+    /** The value the layer writes in its STATUS field. */
+    status: string;
+    label: string;
+    description: string;
+}
+/**
+ * The layer's own abbreviations, spelled out: Ancient Semi-Natural Woodland,
+ * Plantation on an Ancient Woodland Site, and Ancient Wood Pasture.
+ */
+export declare const ANCIENT_WOODLAND_CATEGORIES: readonly AncientWoodlandCategory[];
+/** One size band the profile counts woodland records into. */
+export interface AncientWoodlandSizeBandDefinition {
+    label: string;
+    /** Lower bound in hectares, inclusive. */
+    minHectares: number;
+    /** Upper bound in hectares, exclusive; absent on the open top band. */
+    maxHectares?: number;
+    /** The where clause this band asks the layer for. */
+    where: string;
+}
+/**
+ * The size bands the profile counts records into, smallest first. The first
+ * band is open at the bottom because a handful of records carry areas below
+ * the 0.25 hectare mapping threshold.
+ */
+export declare const ANCIENT_WOODLAND_SIZE_BANDS: readonly AncientWoodlandSizeBandDefinition[];
+/** One size band with the records the layer returned for it. */
+export interface AncientWoodlandSizeBand {
+    label: string;
+    minHectares: number;
+    maxHectares?: number;
+    recordCount: number;
+    /** Records in this band, counted by woodland type. */
+    categoryCounts: Record<AncientWoodlandCategoryId, number>;
+}
+/** Everything the ancient woodland story draws, counted by the layer itself. */
+export interface AncientWoodlandProfile {
+    recordCount: number;
+    totalHectares: number;
+    largestRecordHectares: number;
+    averageRecordHectares: number;
+    /** Records per woodland type across the whole layer. */
+    categoryCounts: Record<AncientWoodlandCategoryId, number>;
+    /** Hectares per woodland type across the whole layer. */
+    categoryHectares: Record<AncientWoodlandCategoryId, number>;
+    /** One entry per size band, smallest first. */
+    sizeBands: AncientWoodlandSizeBand[];
+}
+/** The raw layer responses one profile is parsed from. */
+export interface AncientWoodlandResponses {
+    /** Count, sum, max, and average over the whole layer. */
+    totals: unknown;
+    /** Count and area per woodland type over the whole layer. */
+    categoryTotals: unknown;
+    /** One grouped count response per entry in {@link ANCIENT_WOODLAND_SIZE_BANDS}. */
+    sizeBandCounts: unknown[];
+}
+/**
+ * Adds up the layer's counts and woodland types from its own statistics.
+ *
+ * The size bands are asked for one at a time, so the parser checks that they
+ * add up to the layer's own total before trusting them: a query that silently
+ * drops records would otherwise show as a short bar rather than an error.
+ *
+ * @param payload - the raw responses, or the committed fixture of them
+ * @returns record, area, and size-band counts for the layer
+ */
+export declare function parseAncientWoodlandProfile(payload: unknown): AncientWoodlandProfile;
+/**
+ * Counts England's ancient woodland from Natural England's own layer.
+ *
+ * The layer holds more than fifty thousand polygons, well past ArcGIS's page
+ * size, so the counts come from the service's statistics rather than from a
+ * download: one query for the layer totals, one for the woodland types, and
+ * one per size band.
+ *
+ * @param options - an optional fetch implementation
+ * @returns record, area, and size-band counts for the layer
+ */
+export declare function fetchAncientWoodlandProfile(options?: {
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<AncientWoodlandProfile>;
+/** Natural England's ancient woodland layer for England, keyless. */
+export declare const ancientWoodlandAdapter: UkDataAdapter<AncientWoodlandProfile>;
+//# sourceMappingURL=ancientWoodland.d.ts.map

package/dist/ancientWoodland.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ancientWoodland.d.ts","sourceRoot":"","sources":["../src/ancientWoodland.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,qHAC6E,CAAC;AAErH,+DAA+D;AAC/D,eAAO,MAAM,4BAA4B,uFAC6C,CAAC;AAEvF,mDAAmD;AACnD,eAAO,MAAM,0BAA0B,qBAAqB,CAAC;AAE7D,8DAA8D;AAC9D,MAAM,MAAM,yBAAyB,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAEhE,8EAA8E;AAC9E,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,yBAAyB,CAAC;IAC9B,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,eAAO,MAAM,2BAA2B,EAAE,SAAS,uBAAuB,EAoBzE,CAAC;AAEF,8DAA8D;AAC9D,MAAM,WAAW,iCAAiC;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,EAAE,SAAS,iCAAiC,EA6BnF,CAAC;AAEF,gEAAgE;AAChE,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,cAAc,EAAE,MAAM,CAAC,yBAAyB,EAAE,MAAM,CAAC,CAAC;CAC3D;AAED,gFAAgF;AAChF,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,wDAAwD;IACxD,cAAc,EAAE,MAAM,CAAC,yBAAyB,EAAE,MAAM,CAAC,CAAC;IAC1D,yDAAyD;IACzD,gBAAgB,EAAE,MAAM,CAAC,yBAAyB,EAAE,MAAM,CAAC,CAAC;IAC5D,+CAA+C;IAC/C,SAAS,EAAE,uBAAuB,EAAE,CAAC;CACtC;AAED,0DAA0D;AAC1D,MAAM,WAAW,wBAAwB;IACvC,yDAAyD;IACzD,MAAM,EAAE,OAAO,CAAC;IAChB,6DAA6D;IAC7D,cAAc,EAAE,OAAO,CAAC;IACxB,mFAAmF;IACnF,cAAc,EAAE,OAAO,EAAE,CAAC;CAC3B;AAqDD;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,GAAG,sBAAsB,CAuEpF;AAsDD;;;;;;;;;;GAUG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAAO,GACpD,OAAO,CAAC,sBAAsB,CAAC,CAkBjC;AAED,qEAAqE;AACrE,eAAO,MAAM,sBAAsB,EAAE,aAAa,CAAC,sBAAsB,CAWxE,CAAC"}

package/dist/ancientWoodland.js

@@ -0,0 +1,245 @@
+import { z } from 'zod';
+import { UkSourceApiError, UkSourceParseError } from './errors.js';
+import { readFixtureJson } from './fixtures.js';
+/**
+ * Natural England's Ancient Woodland (England) polygons, served from the Defra
+ * ArcGIS estate. The layer behind the Ancient Woodland Inventory: land that
+ * has carried continuous woodland cover since at least 1600. Keyless, and
+ * published under the Open Government Licence v3.
+ */
+export const ANCIENT_WOODLAND_QUERY_URL = 'https://services.arcgis.com/JJzESW51TqeY9uat/arcgis/rest/services/Ancient_Woodland_England/FeatureServer/0/query';
+/** The dataset's page on the Natural England open data hub. */
+export const ANCIENT_WOODLAND_DATASET_URL = 'https://naturalengland-defra.opendata.arcgis.com/datasets/ancient-woodland-england';
+/** The source id these errors and probes carry. */
+export const ANCIENT_WOODLAND_SOURCE_ID = 'ancient-woodland';
+/**
+ * The layer's own abbreviations, spelled out: Ancient Semi-Natural Woodland,
+ * Plantation on an Ancient Woodland Site, and Ancient Wood Pasture.
+ */
+export const ANCIENT_WOODLAND_CATEGORIES = [
+    {
+        id: 'asnw',
+        status: 'ASNW',
+        label: 'Ancient semi-natural woodland',
+        description: 'Native tree and shrub cover that has never been cleared and replanted.',
+    },
+    {
+        id: 'paws',
+        status: 'PAWS',
+        label: 'Plantation on ancient woodland',
+        description: 'Woodland that was felled and replanted, often with conifers, on ground that has been wooded since 1600.',
+    },
+    {
+        id: 'awp',
+        status: 'AWP',
+        label: 'Ancient wood pasture',
+        description: 'Wooded ground grazed by livestock or deer, usually with veteran trees.',
+    },
+];
+/**
+ * The size bands the profile counts records into, smallest first. The first
+ * band is open at the bottom because a handful of records carry areas below
+ * the 0.25 hectare mapping threshold.
+ */
+export const ANCIENT_WOODLAND_SIZE_BANDS = [
+    { label: 'Under 1 hectare', minHectares: 0, maxHectares: 1, where: 'AREA < 1' },
+    { label: '1 to 2 hectares', minHectares: 1, maxHectares: 2, where: 'AREA >= 1 AND AREA < 2' },
+    { label: '2 to 5 hectares', minHectares: 2, maxHectares: 5, where: 'AREA >= 2 AND AREA < 5' },
+    {
+        label: '5 to 10 hectares',
+        minHectares: 5,
+        maxHectares: 10,
+        where: 'AREA >= 5 AND AREA < 10',
+    },
+    {
+        label: '10 to 20 hectares',
+        minHectares: 10,
+        maxHectares: 20,
+        where: 'AREA >= 10 AND AREA < 20',
+    },
+    {
+        label: '20 to 50 hectares',
+        minHectares: 20,
+        maxHectares: 50,
+        where: 'AREA >= 20 AND AREA < 50',
+    },
+    {
+        label: '50 to 100 hectares',
+        minHectares: 50,
+        maxHectares: 100,
+        where: 'AREA >= 50 AND AREA < 100',
+    },
+    { label: '100 hectares or more', minHectares: 100, where: 'AREA >= 100' },
+];
+const ARCGIS_STATISTICS_RESPONSE_SCHEMA = z.object({
+    features: z.array(z.object({ attributes: z.record(z.unknown()) })),
+});
+const ANCIENT_WOODLAND_RESPONSES_SCHEMA = z.object({
+    totals: ARCGIS_STATISTICS_RESPONSE_SCHEMA,
+    categoryTotals: ARCGIS_STATISTICS_RESPONSE_SCHEMA,
+    sizeBandCounts: z.array(ARCGIS_STATISTICS_RESPONSE_SCHEMA),
+});
+/** The ArcGIS error body, which arrives with HTTP 200 rather than a 4xx. */
+const ARCGIS_ERROR_SCHEMA = z.object({
+    error: z.object({ message: z.string().optional() }),
+});
+/** Every category starts at zero, so a missing type reads as none rather than undefined. */
+function emptyCategoryRecord() {
+    return { asnw: 0, paws: 0, awp: 0 };
+}
+/** Looks up the woodland type behind one STATUS value, or throws when it is new. */
+function categoryIdForStatus(status) {
+    const match = ANCIENT_WOODLAND_CATEGORIES.find((category) => category.status === status);
+    if (match === undefined) {
+        throw new UkSourceParseError(ANCIENT_WOODLAND_SOURCE_ID, `unrecognised woodland status ${JSON.stringify(status)}`);
+    }
+    return match.id;
+}
+/** Reads one numeric attribute, naming it when the layer left it out. */
+function readNumberAttribute(attributes, name) {
+    const raw = attributes[name];
+    if (typeof raw !== 'number' || !Number.isFinite(raw)) {
+        throw new UkSourceParseError(ANCIENT_WOODLAND_SOURCE_ID, `expected a number in "${name}", got ${JSON.stringify(raw)}`);
+    }
+    return raw;
+}
+/** Reads the single row of a whole-layer statistics response. */
+function readAttributeRows(response) {
+    return response.features.map((feature) => feature.attributes);
+}
+/**
+ * Adds up the layer's counts and woodland types from its own statistics.
+ *
+ * The size bands are asked for one at a time, so the parser checks that they
+ * add up to the layer's own total before trusting them: a query that silently
+ * drops records would otherwise show as a short bar rather than an error.
+ *
+ * @param payload - the raw responses, or the committed fixture of them
+ * @returns record, area, and size-band counts for the layer
+ */
+export function parseAncientWoodlandProfile(payload) {
+    const parsed = ANCIENT_WOODLAND_RESPONSES_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UkSourceParseError(ANCIENT_WOODLAND_SOURCE_ID, parsed.error.message);
+    }
+    const { totals, categoryTotals, sizeBandCounts } = parsed.data;
+    if (sizeBandCounts.length !== ANCIENT_WOODLAND_SIZE_BANDS.length) {
+        throw new UkSourceParseError(ANCIENT_WOODLAND_SOURCE_ID, `expected ${ANCIENT_WOODLAND_SIZE_BANDS.length} size band responses, got ${sizeBandCounts.length}`);
+    }
+    const totalsRow = readAttributeRows(totals)[0];
+    if (totalsRow === undefined) {
+        throw new UkSourceParseError(ANCIENT_WOODLAND_SOURCE_ID, 'the totals query returned no rows');
+    }
+    const recordCount = readNumberAttribute(totalsRow, 'recordCount');
+    const categoryCounts = emptyCategoryRecord();
+    const categoryHectares = emptyCategoryRecord();
+    for (const row of readAttributeRows(categoryTotals)) {
+        const categoryId = categoryIdForStatus(row.STATUS);
+        categoryCounts[categoryId] = readNumberAttribute(row, 'recordCount');
+        categoryHectares[categoryId] = readNumberAttribute(row, 'hectares');
+    }
+    const sizeBands = ANCIENT_WOODLAND_SIZE_BANDS.map((definition, index) => {
+        const response = sizeBandCounts[index];
+        if (response === undefined) {
+            throw new UkSourceParseError(ANCIENT_WOODLAND_SOURCE_ID, `no response for the "${definition.label}" band`);
+        }
+        const bandCounts = emptyCategoryRecord();
+        for (const row of readAttributeRows(response)) {
+            bandCounts[categoryIdForStatus(row.STATUS)] = readNumberAttribute(row, 'recordCount');
+        }
+        const bandTotal = ANCIENT_WOODLAND_CATEGORIES.reduce((total, category) => total + bandCounts[category.id], 0);
+        return {
+            label: definition.label,
+            minHectares: definition.minHectares,
+            ...(definition.maxHectares === undefined ? {} : { maxHectares: definition.maxHectares }),
+            recordCount: bandTotal,
+            categoryCounts: bandCounts,
+        };
+    });
+    const bandRecordCount = sizeBands.reduce((total, band) => total + band.recordCount, 0);
+    if (bandRecordCount !== recordCount) {
+        throw new UkSourceParseError(ANCIENT_WOODLAND_SOURCE_ID, `the size bands hold ${bandRecordCount} records against a layer total of ${recordCount}`);
+    }
+    return {
+        recordCount,
+        totalHectares: readNumberAttribute(totalsRow, 'hectares'),
+        largestRecordHectares: readNumberAttribute(totalsRow, 'largestHectares'),
+        averageRecordHectares: readNumberAttribute(totalsRow, 'averageHectares'),
+        categoryCounts,
+        categoryHectares,
+        sizeBands,
+    };
+}
+/** Count and area per group, the shape every query here asks for. */
+const COUNT_AND_AREA_STATISTICS = [
+    { statisticType: 'count', onStatisticField: 'OBJECTID', outStatisticFieldName: 'recordCount' },
+    { statisticType: 'sum', onStatisticField: 'AREA', outStatisticFieldName: 'hectares' },
+];
+/** Count, area, largest, and average over the whole layer. */
+const LAYER_TOTALS_STATISTICS = [
+    ...COUNT_AND_AREA_STATISTICS,
+    { statisticType: 'max', onStatisticField: 'AREA', outStatisticFieldName: 'largestHectares' },
+    { statisticType: 'avg', onStatisticField: 'AREA', outStatisticFieldName: 'averageHectares' },
+];
+/** Runs one statistics query, turning ArcGIS's 200-with-an-error into a throw. */
+async function queryArcgisStatistics(fetchImpl, query) {
+    const url = new URL(ANCIENT_WOODLAND_QUERY_URL);
+    url.searchParams.set('where', query.where);
+    url.searchParams.set('outStatistics', JSON.stringify(query.statistics));
+    if (query.groupByField !== undefined) {
+        url.searchParams.set('groupByFieldsForStatistics', query.groupByField);
+    }
+    url.searchParams.set('returnGeometry', 'false');
+    url.searchParams.set('f', 'json');
+    const response = await fetchImpl(url);
+    if (!response.ok) {
+        throw new UkSourceApiError(ANCIENT_WOODLAND_SOURCE_ID, `HTTP ${response.status} querying the ancient woodland layer`);
+    }
+    const payload = await response.json();
+    const arcgisError = ARCGIS_ERROR_SCHEMA.safeParse(payload);
+    if (arcgisError.success) {
+        throw new UkSourceApiError(ANCIENT_WOODLAND_SOURCE_ID, arcgisError.data.error.message ?? 'the layer rejected a statistics query');
+    }
+    return payload;
+}
+/**
+ * Counts England's ancient woodland from Natural England's own layer.
+ *
+ * The layer holds more than fifty thousand polygons, well past ArcGIS's page
+ * size, so the counts come from the service's statistics rather than from a
+ * download: one query for the layer totals, one for the woodland types, and
+ * one per size band.
+ *
+ * @param options - an optional fetch implementation
+ * @returns record, area, and size-band counts for the layer
+ */
+export async function fetchAncientWoodlandProfile(options = {}) {
+    const { fetchImpl = globalThis.fetch } = options;
+    const [totals, categoryTotals, ...sizeBandCounts] = await Promise.all([
+        queryArcgisStatistics(fetchImpl, { where: '1=1', statistics: LAYER_TOTALS_STATISTICS }),
+        queryArcgisStatistics(fetchImpl, {
+            where: '1=1',
+            statistics: COUNT_AND_AREA_STATISTICS,
+            groupByField: 'STATUS',
+        }),
+        ...ANCIENT_WOODLAND_SIZE_BANDS.map((band) => queryArcgisStatistics(fetchImpl, {
+            where: band.where,
+            statistics: COUNT_AND_AREA_STATISTICS,
+            groupByField: 'STATUS',
+        })),
+    ]);
+    return parseAncientWoodlandProfile({ totals, categoryTotals, sizeBandCounts });
+}
+/** Natural England's ancient woodland layer for England, keyless. */
+export const ancientWoodlandAdapter = {
+    id: ANCIENT_WOODLAND_SOURCE_ID,
+    name: 'Natural England ancient woodland (England)',
+    auth: 'none',
+    description: 'Ancient woodland polygons for England, counted by woodland type and by size.',
+    fetchLive: (options) => fetchAncientWoodlandProfile({
+        ...(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    }),
+    parse: parseAncientWoodlandProfile,
+    loadFixture: () => parseAncientWoodlandProfile(readFixtureJson('ancient-woodland.json')),
+};
+//# sourceMappingURL=ancientWoodland.js.map

package/dist/ancientWoodland.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ancientWoodland.js","sourceRoot":"","sources":["../src/ancientWoodland.ts"],"names":[],"mappings":"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"}