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

package/dist/publicHealthScotland.js

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+import { UkSourceParseError } from './errors.js';
+import { httpGet } from './http.js';
+import { readFixtureJson } from './fixtures.js';
+/**
+ * Public Health Scotland's open data portal, served by CKAN. Keyless, and the
+ * datasets are published under the Open Government Licence v3.
+ */
+export const PUBLIC_HEALTH_SCOTLAND_SOURCE_ID = 'public-health-scotland';
+/** The CKAN package_list call on the Public Health Scotland portal. */
+export const PUBLIC_HEALTH_SCOTLAND_PACKAGE_LIST_URL = 'https://www.opendata.nhs.scot/api/3/action/package_list';
+const PUBLIC_HEALTH_SCOTLAND_PACKAGE_LIST_SCHEMA = z.object({
+    success: z.boolean(),
+    result: z.array(z.string()),
+});
+/**
+ * Parses a Public Health Scotland package_list payload.
+ *
+ * @param payload - the raw JSON body from the CKAN package_list call
+ * @returns one entry per dataset in the catalogue
+ */
+export function parsePublicHealthScotlandDatasets(payload) {
+    const parsed = PUBLIC_HEALTH_SCOTLAND_PACKAGE_LIST_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UkSourceParseError('public-health-scotland', parsed.error.message);
+    }
+    return parsed.data.result.map((name) => ({ name }));
+}
+/**
+ * Counts the Public Health Scotland catalogue.
+ *
+ * @param datasets - dataset names from {@link parsePublicHealthScotlandDatasets}
+ * @returns the number of datasets listed
+ */
+export function summarizePublicHealthScotlandDatasets(datasets) {
+    return { packageCount: datasets.length };
+}
+/**
+ * Lists every dataset in the Public Health Scotland catalogue.
+ *
+ * @param options - an optional fetch implementation
+ * @returns the package names the catalogue returns
+ */
+export async function fetchPublicHealthScotlandDatasets(options = {}) {
+    const { fetchImpl = globalThis.fetch } = options;
+    const response = await httpGet('public-health-scotland', PUBLIC_HEALTH_SCOTLAND_PACKAGE_LIST_URL, { fetchImpl });
+    return parsePublicHealthScotlandDatasets(await response.json());
+}
+/** Public Health Scotland open data catalogue, keyless. */
+export const publicHealthScotlandAdapter = {
+    id: PUBLIC_HEALTH_SCOTLAND_SOURCE_ID,
+    name: 'Public Health Scotland open data catalogue',
+    auth: 'none',
+    description: 'Every dataset Public Health Scotland publishes on its open data portal.',
+    fetchLive: (options) => fetchPublicHealthScotlandDatasets(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    parse: parsePublicHealthScotlandDatasets,
+    loadFixture: () => parsePublicHealthScotlandDatasets(readFixtureJson('public-health-scotland-2026-10-05.json')),
+};
+//# sourceMappingURL=publicHealthScotland.js.map

package/dist/publicHealthScotland.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publicHealthScotland.js","sourceRoot":"","sources":["../src/publicHealthScotland.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGhD;;;GAGG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,wBAAwB,CAAC;AAEzE,uEAAuE;AACvE,MAAM,CAAC,MAAM,uCAAuC,GAClD,yDAAyD,CAAC;AAa5D,MAAM,0CAA0C,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1D,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC5B,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,UAAU,iCAAiC,CAAC,OAAgB;IAChE,MAAM,MAAM,GAAG,0CAA0C,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC7E,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,kBAAkB,CAAC,wBAAwB,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACtD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qCAAqC,CACnD,QAAuC;IAEvC,OAAO,EAAE,YAAY,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;AAC3C,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iCAAiC,CACrD,UAAmD,EAAE;IAErD,MAAM,EAAE,SAAS,GAAG,UAAU,CAAC,KAAK,EAAE,GAAG,OAAO,CAAC;IACjD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAC5B,wBAAwB,EACxB,uCAAuC,EACvC,EAAE,SAAS,EAAE,CACd,CAAC;IACF,OAAO,iCAAiC,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AAClE,CAAC;AAED,2DAA2D;AAC3D,MAAM,CAAC,MAAM,2BAA2B,GAAiD;IACvF,EAAE,EAAE,gCAAgC;IACpC,IAAI,EAAE,4CAA4C;IAClD,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,yEAAyE;IACtF,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE,CACrB,iCAAiC,CAC/B,OAAO,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CACzE;IACH,KAAK,EAAE,iCAAiC;IACxC,WAAW,EAAE,GAAG,EAAE,CAChB,iCAAiC,CAAC,eAAe,CAAC,wCAAwC,CAAC,CAAC;CAC/F,CAAC"}

package/dist/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,aAAa,EAAkB,aAAa,EAAE,MAAM,YAAY,CAAC;AAE/E,iEAAiE;AACjE,eAAO,MAAM,eAAe,EAAE,aAAa,CAAC,OAAO,CAAC,EAYnD,CAAC;AAEF,uCAAuC;AACvC,wBAAgB,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,SAAS,CAE3E;AAED,mEAAmE;AACnE,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,EACzB,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAAE,GACjE,OAAO,CAAC,aAAa,CAAC,CAwBxB;AAED,iFAAiF;AACjF,wBAAsB,qBAAqB,CAAC,OAAO,CAAC,EAAE;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACrC,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAW3B"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,aAAa,EAAkB,aAAa,EAAE,MAAM,YAAY,CAAC;AAE/E,iEAAiE;AACjE,eAAO,MAAM,eAAe,EAAE,aAAa,CAAC,OAAO,CAAC,EAwBnD,CAAC;AAEF,uCAAuC;AACvC,wBAAgB,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,SAAS,CAE3E;AAED,mEAAmE;AACnE,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,EACzB,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAAE,GACjE,OAAO,CAAC,aAAa,CAAC,CAwBxB;AAED,iFAAiF;AACjF,wBAAsB,qBAAqB,CAAC,OAAO,CAAC,EAAE;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACrC,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAW3B"}

package/dist/registry.js

@@ -1,13 +1,25 @@
 import { ancientWoodlandAdapter } from './ancientWoodland.js';
 import { bankRateAdapter } from './bankRate.js';
 import { carbonIntensityAdapter } from './carbonIntensity.js';
+import { exploreEducationStatisticsAdapter } from './exploreEducationStatistics.js';
+import { findATenderAdapter } from './findATender.js';
+import { fingertipsIndicatorsAdapter } from './fingertipsIndicators.js';
 import { floodReadingsAdapter, floodStationsAdapter } from './floodMonitoring.js';
 import { foodHygieneAuthoritiesAdapter } from './foodHygiene.js';
+import { londonDatastoreAdapter } from './londonDatastore.js';
+import { nesoGenerationMixAdapter } from './nesoGenerationMix.js';
+import { nhsbsaCkanAdapter } from './nhsbsaCkan.js';
+import { nomisAdapter } from './nomis.js';
 import { onsDatasetsAdapter } from './onsDatasets.js';
 import { parliamentSeatsAdapter } from './parliamentSeats.js';
 import { planningDatasetsAdapter } from './planningDatasets.js';
 import { policeCrimesAdapter } from './policeCrimes.js';
+import { postcodeLookupAdapter } from './postcodeLookup.js';
+import { publicHealthScotlandAdapter } from './publicHealthScotland.js';
 import { tflBikePointsAdapter } from './tflBikePoints.js';
+import { tflLineStatusAdapter } from './tflLineStatus.js';
+import { tnaDiscoveryAdapter } from './tnaDiscovery.js';
+import { ukhsaDashboardAdapter } from './ukhsaDashboard.js';
 /** Every UK data source behind the uniform adapter interface. */
 export const UK_DATA_SOURCES = [
     floodStationsAdapter,
@@ -21,6 +33,18 @@ export const UK_DATA_SOURCES = [
     policeCrimesAdapter,
     carbonIntensityAdapter,
     parliamentSeatsAdapter,
+    postcodeLookupAdapter,
+    exploreEducationStatisticsAdapter,
+    londonDatastoreAdapter,
+    tnaDiscoveryAdapter,
+    ukhsaDashboardAdapter,
+    nomisAdapter,
+    fingertipsIndicatorsAdapter,
+    findATenderAdapter,
+    tflLineStatusAdapter,
+    publicHealthScotlandAdapter,
+    nhsbsaCkanAdapter,
+    nesoGenerationMixAdapter,
 ];
 /** Looks up a source adapter by id. */
 export function getUkDataSource(id) {

package/dist/registry.js.map

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

package/dist/tflBikePoints.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tflBikePoints.d.ts","sourceRoot":"","sources":["../src/tflBikePoints.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,qCAAqC,CAAC;AAEtE,6EAA6E;AAC7E,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAEhD,6DAA6D;AAC7D,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,qEAAqE;IACrE,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,+DAA+D;AAC/D,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gEAAgE;IAChE,eAAe,EAAE,cAAc,EAAE,CAAC;CACnC;AAwED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,EAAE,CAwBrE;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,cAAc,EAAE,EAC1B,mBAAmB,GAAE,MAAsC,GAC1D,qBAAqB,CAYvB;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAAO,GACrE,OAAO,CAAC,cAAc,EAAE,CAAC,CAc3B;AAED,uEAAuE;AACvE,eAAO,MAAM,oBAAoB,EAAE,aAAa,CAAC,cAAc,EAAE,CAYhE,CAAC"}
+{"version":3,"file":"tflBikePoints.d.ts","sourceRoot":"","sources":["../src/tflBikePoints.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,qCAAqC,CAAC;AAEtE,6EAA6E;AAC7E,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAEhD,6DAA6D;AAC7D,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,qEAAqE;IACrE,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,+DAA+D;AAC/D,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gEAAgE;IAChE,eAAe,EAAE,cAAc,EAAE,CAAC;CACnC;AAwED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,EAAE,CAwBrE;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,cAAc,EAAE,EAC1B,mBAAmB,GAAE,MAAsC,GAC1D,qBAAqB,CAYvB;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAAO,GACrE,OAAO,CAAC,cAAc,EAAE,CAAC,CAS3B;AAED,uEAAuE;AACvE,eAAO,MAAM,oBAAoB,EAAE,aAAa,CAAC,cAAc,EAAE,CAYhE,CAAC"}

package/dist/tflBikePoints.js

@@ -1,5 +1,7 @@
 import { z } from 'zod';
-import { UkSourceApiError, UkSourceParseError } from './errors.js';
+import { normalizeSourceApiKey } from './apiKey.js';
+import { UkSourceParseError } from './errors.js';
+import { httpGet } from './http.js';
 import { readFixtureJson } from './fixtures.js';
 /**
  * Transport for London's Santander Cycles docking station list. Keyless: the
@@ -123,14 +125,12 @@ export function summarizeTflBikePoints(stations, largestStationLimit = DEFAULT_L
  * @returns the docking stations the endpoint returns
  */
 export async function fetchTflBikePoints(options = {}) {
-    const { apiKey, fetchImpl = globalThis.fetch } = options;
+    const { apiKey: rawApiKey, fetchImpl = globalThis.fetch } = options;
+    const apiKey = normalizeSourceApiKey(rawApiKey);
     const url = apiKey === undefined
         ? TFL_BIKE_POINTS_URL
         : `${TFL_BIKE_POINTS_URL}?app_key=${encodeURIComponent(apiKey)}`;
-    const response = await fetchImpl(url);
-    if (!response.ok) {
-        throw new UkSourceApiError('tfl-bike-points', `HTTP ${response.status} listing docking stations`);
-    }
+    const response = await httpGet('tfl-bike-points', url, { fetchImpl });
     return parseTflBikePoints(await response.json());
 }
 /** Transport for London Santander Cycles docking stations, keyless. */

package/dist/tflBikePoints.js.map

@@ -1 +1 @@
-{"version":3,"file":"tflBikePoints.js","sourceRoot":"","sources":["../src/tflBikePoints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,kCAAkC,CAAC;AAEtE,6EAA6E;AAC7E,MAAM,CAAC,MAAM,6BAA6B,GAAG,EAAE,CAAC;AA6BhD,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,oBAAoB,EAAE,CAAC,CAAC,KAAK,CAC3B,CAAC,CAAC,MAAM,CAAC;QACP,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;QACf,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;KAClB,CAAC,CACH;CACF,CAAC,CAAC;AAEH,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;AAEpD,kFAAkF;AAClF,MAAM,cAAc,GAAG,SAAS,CAAC;AACjC,MAAM,cAAc,GAAG,SAAS,CAAC;AACjC,MAAM,uBAAuB,GAAG,UAAU,CAAC;AAC3C,MAAM,oBAAoB,GAAG,cAAc,CAAC;AAC5C,MAAM,aAAa,GAAG,WAAW,CAAC;AAClC,MAAM,gBAAgB,GAAG,aAAa,CAAC;AAEvC;;;;;GAKG;AACH,SAAS,cAAc,CAAC,OAAyC;IAC/D,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACjG,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,iBAAiB,CACxB,UAA+B,EAC/B,GAAW,EACX,WAAmB;IAEnB,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC3C,MAAM,IAAI,kBAAkB,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,WAAW,EAAE,CAAC,CAAC;IACjF,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,kBAAkB,CAC1B,iBAAiB,EACjB,GAAG,GAAG,KAAK,GAAG,QAAQ,WAAW,kBAAkB,CACpD,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,eAAe,CAAC,IAAY;IACnC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAChE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACpD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,kBAAkB,CAAC,iBAAiB,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,QAAQ,GAAqB,EAAE,CAAC;IACtC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC3D,SAAS;QACX,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC;YACZ,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,IAAI;YACJ,SAAS,EAAE,iBAAiB,CAAC,UAAU,EAAE,cAAc,EAAE,IAAI,CAAC;YAC9D,SAAS,EAAE,iBAAiB,CAAC,UAAU,EAAE,cAAc,EAAE,IAAI,CAAC;YAC9D,iBAAiB,EAAE,iBAAiB,CAAC,UAAU,EAAE,uBAAuB,EAAE,IAAI,CAAC;YAC/E,cAAc,EAAE,iBAAiB,CAAC,UAAU,EAAE,oBAAoB,EAAE,IAAI,CAAC;YACzE,SAAS,EAAE,UAAU,CAAC,GAAG,CAAC,aAAa,CAAC,KAAK,MAAM;SACpD,CAAC,CAAC;IACL,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CACpC,QAA0B,EAC1B,sBAA8B,6BAA6B;IAE3D,MAAM,eAAe,GAAG,CAAC,GAAG,QAAQ,CAAC;SAClC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;SAC9F,KAAK,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC;IAEjC,OAAO;QACL,YAAY,EAAE,QAAQ,CAAC,MAAM;QAC7B,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,KAAK,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;QAC5E,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,KAAK,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;QAC5E,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,KAAK,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;QAC5F,eAAe;KAChB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,UAAoE,EAAE;IAEtE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,UAAU,CAAC,KAAK,EAAE,GAAG,OAAO,CAAC;IACzD,MAAM,GAAG,GACP,MAAM,KAAK,SAAS;QAClB,CAAC,CAAC,mBAAmB;QACrB,CAAC,CAAC,GAAG,mBAAmB,YAAY,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;IACrE,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,gBAAgB,CACxB,iBAAiB,EACjB,QAAQ,QAAQ,CAAC,MAAM,2BAA2B,CACnD,CAAC;IACJ,CAAC;IACD,OAAO,kBAAkB,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AACnD,CAAC;AAED,uEAAuE;AACvE,MAAM,CAAC,MAAM,oBAAoB,GAAoC;IACnE,EAAE,EAAE,iBAAiB;IACrB,IAAI,EAAE,wDAAwD;IAC9D,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,mFAAmF;IAChG,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE,CACrB,kBAAkB,CAAC;QACjB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;QACpE,GAAG,CAAC,OAAO,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC;KAC9E,CAAC;IACJ,KAAK,EAAE,kBAAkB;IACzB,WAAW,EAAE,GAAG,EAAE,CAAC,kBAAkB,CAAC,eAAe,CAAC,sBAAsB,CAAC,CAAC;CAC/E,CAAC"}
+{"version":3,"file":"tflBikePoints.js","sourceRoot":"","sources":["../src/tflBikePoints.ts"],"names":[],"mappings":"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"}

package/dist/tflLineStatus.d.ts

@@ -0,0 +1,59 @@
+import type { UkDataAdapter } from './types.js';
+/**
+ * Transport for London's live Tube line status. Keyless: the endpoint answers
+ * without an app key, and TfL asks for one only above the free rate limit.
+ * Published as TfL Open Data.
+ */
+export declare const TFL_LINE_STATUS_SOURCE_ID = "tfl-line-status";
+/** The Tube line status endpoint, covering every Tube line at once. */
+export declare const TFL_LINE_STATUS_URL = "https://api.tfl.gov.uk/Line/Mode/tube/Status";
+/** TfL's severity code for a line running a good service. */
+export declare const TFL_LINE_STATUS_GOOD_SERVICE_SEVERITY = 10;
+/** One Tube line and the service status TfL reports for it. */
+export interface TflLineStatus {
+    /** TfL's line id, such as "bakerloo". */
+    id: string;
+    name: string;
+    modeName: string;
+    /** TfL's numeric severity, 10 for a good service. */
+    statusSeverity: number;
+    /** TfL's own wording for the severity, such as "Minor Delays". */
+    statusSeverityDescription: string;
+    /** The operator's explanation, or "" when there is nothing to explain. */
+    reason: string;
+}
+/** Rolled-up view of the Tube line status list. */
+export interface TflLineStatusSummary {
+    lineCount: number;
+    /** Lines TfL reports at good-service severity. */
+    goodServiceCount: number;
+    /** The lines running below a good service, in TfL's order. */
+    disruptedLines: TflLineStatus[];
+}
+/**
+ * Parses a TfL line status payload into one record per line.
+ *
+ * @param payload - the raw JSON body from the line status endpoint
+ * @returns one record per Tube line, in TfL's order
+ */
+export declare function parseTflLineStatuses(payload: unknown): TflLineStatus[];
+/**
+ * Counts the lines and keeps the ones running below a good service.
+ *
+ * @param lines - lines from {@link parseTflLineStatuses}
+ * @returns line and good-service counts plus the disrupted lines
+ */
+export declare function summarizeTflLineStatuses(lines: TflLineStatus[]): TflLineStatusSummary;
+/**
+ * Reads the live status of every Tube line from TfL.
+ *
+ * @param options - an optional app key and fetch implementation
+ * @returns the line statuses the endpoint returns
+ */
+export declare function fetchTflLineStatuses(options?: {
+    apiKey?: string;
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<TflLineStatus[]>;
+/** Transport for London Tube line status, keyless. */
+export declare const tflLineStatusAdapter: UkDataAdapter<TflLineStatus[]>;
+//# sourceMappingURL=tflLineStatus.d.ts.map

package/dist/tflLineStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tflLineStatus.d.ts","sourceRoot":"","sources":["../src/tflLineStatus.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,oBAAoB,CAAC;AAE3D,uEAAuE;AACvE,eAAO,MAAM,mBAAmB,iDAAiD,CAAC;AAElF,6DAA6D;AAC7D,eAAO,MAAM,qCAAqC,KAAK,CAAC;AAExD,+DAA+D;AAC/D,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,cAAc,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,yBAAyB,EAAE,MAAM,CAAC;IAClC,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,mDAAmD;AACnD,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,gBAAgB,EAAE,MAAM,CAAC;IACzB,8DAA8D;IAC9D,cAAc,EAAE,aAAa,EAAE,CAAC;CACjC;AAkBD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,EAAE,CAgBtE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,oBAAoB,CAUrF;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAAO,GACrE,OAAO,CAAC,aAAa,EAAE,CAAC,CAQ1B;AAED,sDAAsD;AACtD,eAAO,MAAM,oBAAoB,EAAE,aAAa,CAAC,aAAa,EAAE,CAY/D,CAAC"}

package/dist/tflLineStatus.js

@@ -0,0 +1,91 @@
+import { z } from 'zod';
+import { UkSourceParseError } from './errors.js';
+import { httpGet } from './http.js';
+import { readFixtureJson } from './fixtures.js';
+/**
+ * Transport for London's live Tube line status. Keyless: the endpoint answers
+ * without an app key, and TfL asks for one only above the free rate limit.
+ * Published as TfL Open Data.
+ */
+export const TFL_LINE_STATUS_SOURCE_ID = 'tfl-line-status';
+/** The Tube line status endpoint, covering every Tube line at once. */
+export const TFL_LINE_STATUS_URL = 'https://api.tfl.gov.uk/Line/Mode/tube/Status';
+/** TfL's severity code for a line running a good service. */
+export const TFL_LINE_STATUS_GOOD_SERVICE_SEVERITY = 10;
+const TFL_LINE_STATUS_ENTRY_SCHEMA = z.object({
+    id: z.number(),
+    statusSeverity: z.number(),
+    statusSeverityDescription: z.string(),
+    reason: z.string().optional(),
+});
+const TFL_LINE_SCHEMA = z.object({
+    id: z.string(),
+    name: z.string(),
+    modeName: z.string(),
+    lineStatuses: z.array(TFL_LINE_STATUS_ENTRY_SCHEMA).min(1),
+});
+const TFL_LINES_SCHEMA = z.array(TFL_LINE_SCHEMA);
+/**
+ * Parses a TfL line status payload into one record per line.
+ *
+ * @param payload - the raw JSON body from the line status endpoint
+ * @returns one record per Tube line, in TfL's order
+ */
+export function parseTflLineStatuses(payload) {
+    const parsed = TFL_LINES_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UkSourceParseError('tfl-line-status', parsed.error.message);
+    }
+    return parsed.data.map((line) => {
+        const status = line.lineStatuses[0];
+        return {
+            id: line.id,
+            name: line.name,
+            modeName: line.modeName,
+            statusSeverity: status?.statusSeverity ?? 0,
+            statusSeverityDescription: status?.statusSeverityDescription ?? '',
+            reason: status?.reason ?? '',
+        };
+    });
+}
+/**
+ * Counts the lines and keeps the ones running below a good service.
+ *
+ * @param lines - lines from {@link parseTflLineStatuses}
+ * @returns line and good-service counts plus the disrupted lines
+ */
+export function summarizeTflLineStatuses(lines) {
+    return {
+        lineCount: lines.length,
+        goodServiceCount: lines.filter((line) => line.statusSeverity === TFL_LINE_STATUS_GOOD_SERVICE_SEVERITY).length,
+        disruptedLines: lines.filter((line) => line.statusSeverity !== TFL_LINE_STATUS_GOOD_SERVICE_SEVERITY),
+    };
+}
+/**
+ * Reads the live status of every Tube line from TfL.
+ *
+ * @param options - an optional app key and fetch implementation
+ * @returns the line statuses the endpoint returns
+ */
+export async function fetchTflLineStatuses(options = {}) {
+    const { apiKey, fetchImpl = globalThis.fetch } = options;
+    const url = apiKey === undefined
+        ? TFL_LINE_STATUS_URL
+        : `${TFL_LINE_STATUS_URL}?app_key=${encodeURIComponent(apiKey)}`;
+    const response = await httpGet('tfl-line-status', url, { fetchImpl });
+    return parseTflLineStatuses(await response.json());
+}
+/** Transport for London Tube line status, keyless. */
+export const tflLineStatusAdapter = {
+    id: TFL_LINE_STATUS_SOURCE_ID,
+    name: 'Transport for London Tube line status',
+    auth: 'none',
+    description: 'The live service status of every Tube line, with disruption reasons.',
+    fetchLive: (options) => fetchTflLineStatuses({
+        ...(options?.apiKey === undefined ? {} : { apiKey: options.apiKey }),
+        ...(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    }),
+    parse: parseTflLineStatuses,
+    loadFixture: () => parseTflLineStatuses(readFixtureJson('tfl-line-status-2026-10-05.json')),
+};
+//# sourceMappingURL=tflLineStatus.js.map

package/dist/tflLineStatus.js.map

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

package/dist/tnaDiscovery.d.ts

@@ -0,0 +1,76 @@
+import type { UkDataAdapter } from './types.js';
+/**
+ * Discovery, The National Archives' catalogue search API. Keyless, and the
+ * catalogue metadata is published under the Open Government Licence v3.
+ */
+export declare const TNA_DISCOVERY_SOURCE_ID = "tna-discovery";
+/** Base URL for the Discovery record search. */
+export declare const TNA_DISCOVERY_SEARCH_URL = "https://discovery.nationalarchives.gov.uk/API/search/records";
+/**
+ * The header Discovery expects for a JSON answer. On 2026-10-05 the endpoint
+ * also answered JSON without it, but the adapter sends it either way.
+ */
+export declare const TNA_DISCOVERY_ACCEPT_HEADER = "application/json";
+/** The search term the adapter asks for when the caller does not name one. */
+export declare const DEFAULT_TNA_DISCOVERY_QUERY = "test";
+/** One catalogue record Discovery returns for a search. */
+export interface TnaDiscoveryRecord {
+    id: string;
+    /** The archive's own reference, such as a catalogue piece number. */
+    reference: string;
+    title: string;
+    description: string;
+    /** The date range the record covers, as the archive writes it. */
+    coveringDates: string;
+    /** Depth in the catalogue hierarchy, or null when the record leaves it out. */
+    catalogueLevel: number | null;
+    /** The department code the record belongs to, or "" when unset. */
+    department: string;
+    /** Repositories holding the record. */
+    heldBy: string[];
+}
+/** One page of Discovery search results plus the total hit count. */
+export interface TnaDiscoverySearchResult {
+    /** Total records matching the query, not just this page. */
+    totalCount: number;
+    records: TnaDiscoveryRecord[];
+}
+/** Rolled-up view of one Discovery search page. */
+export interface TnaDiscoverySearchSummary {
+    recordCount: number;
+    totalCount: number;
+}
+/**
+ * Builds a Discovery record search URL for one query.
+ *
+ * @param query - the free-text search term
+ * @returns the record search URL
+ */
+export declare function buildTnaDiscoverySearchUrl(query: string): string;
+/**
+ * Parses a Discovery record search payload.
+ *
+ * @param payload - the raw JSON body from the record search endpoint
+ * @returns the page of catalogue records plus the total hit count
+ */
+export declare function parseTnaDiscoveryRecords(payload: unknown): TnaDiscoverySearchResult;
+/**
+ * Sums one Discovery search page.
+ *
+ * @param result - a page from {@link parseTnaDiscoveryRecords}
+ * @returns the page size and the total hit count
+ */
+export declare function summarizeTnaDiscoverySearch(result: TnaDiscoverySearchResult): TnaDiscoverySearchSummary;
+/**
+ * Searches the Discovery catalogue for one query.
+ *
+ * @param options - the search term and an optional fetch implementation
+ * @returns the page of records the search endpoint returns
+ */
+export declare function fetchTnaDiscoveryRecords(options?: {
+    query?: string;
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<TnaDiscoverySearchResult>;
+/** The National Archives Discovery catalogue search, keyless. */
+export declare const tnaDiscoveryAdapter: UkDataAdapter<TnaDiscoverySearchResult>;
+//# sourceMappingURL=tnaDiscovery.d.ts.map

package/dist/tnaDiscovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tnaDiscovery.d.ts","sourceRoot":"","sources":["../src/tnaDiscovery.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,uBAAuB,kBAAkB,CAAC;AAEvD,gDAAgD;AAChD,eAAO,MAAM,wBAAwB,iEAC2B,CAAC;AAEjE;;;GAGG;AACH,eAAO,MAAM,2BAA2B,qBAAqB,CAAC;AAE9D,8EAA8E;AAC9E,eAAO,MAAM,2BAA2B,SAAS,CAAC;AAElD,2DAA2D;AAC3D,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,aAAa,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,mEAAmE;IACnE,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,qEAAqE;AACrE,MAAM,WAAW,wBAAwB;IACvC,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,kBAAkB,EAAE,CAAC;CAC/B;AAED,mDAAmD;AACnD,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAkBD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,wBAAwB,CAkBnF;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,wBAAwB,GAC/B,yBAAyB,CAE3B;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAAO,GACpE,OAAO,CAAC,wBAAwB,CAAC,CAOnC;AAED,iEAAiE;AACjE,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAAC,wBAAwB,CAWvE,CAAC"}

package/dist/tnaDiscovery.js

@@ -0,0 +1,100 @@
+import { z } from 'zod';
+import { UkSourceParseError } from './errors.js';
+import { httpGet } from './http.js';
+import { readFixtureJson } from './fixtures.js';
+/**
+ * Discovery, The National Archives' catalogue search API. Keyless, and the
+ * catalogue metadata is published under the Open Government Licence v3.
+ */
+export const TNA_DISCOVERY_SOURCE_ID = 'tna-discovery';
+/** Base URL for the Discovery record search. */
+export const TNA_DISCOVERY_SEARCH_URL = 'https://discovery.nationalarchives.gov.uk/API/search/records';
+/**
+ * The header Discovery expects for a JSON answer. On 2026-10-05 the endpoint
+ * also answered JSON without it, but the adapter sends it either way.
+ */
+export const TNA_DISCOVERY_ACCEPT_HEADER = 'application/json';
+/** The search term the adapter asks for when the caller does not name one. */
+export const DEFAULT_TNA_DISCOVERY_QUERY = 'test';
+const TNA_DISCOVERY_RECORD_SCHEMA = z.object({
+    id: z.string(),
+    reference: z.string().nullable().optional(),
+    title: z.string().nullable().optional(),
+    description: z.string().nullable().optional(),
+    coveringDates: z.string().nullable().optional(),
+    catalogueLevel: z.number().nullable().optional(),
+    department: z.string().nullable().optional(),
+    heldBy: z.array(z.string()).nullable().optional(),
+});
+const TNA_DISCOVERY_SEARCH_SCHEMA = z.object({
+    records: z.array(TNA_DISCOVERY_RECORD_SCHEMA),
+    count: z.number(),
+});
+/**
+ * Builds a Discovery record search URL for one query.
+ *
+ * @param query - the free-text search term
+ * @returns the record search URL
+ */
+export function buildTnaDiscoverySearchUrl(query) {
+    return `${TNA_DISCOVERY_SEARCH_URL}?sps.searchQuery=${encodeURIComponent(query)}`;
+}
+/**
+ * Parses a Discovery record search payload.
+ *
+ * @param payload - the raw JSON body from the record search endpoint
+ * @returns the page of catalogue records plus the total hit count
+ */
+export function parseTnaDiscoveryRecords(payload) {
+    const parsed = TNA_DISCOVERY_SEARCH_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UkSourceParseError('tna-discovery', parsed.error.message);
+    }
+    return {
+        totalCount: parsed.data.count,
+        records: parsed.data.records.map((record) => ({
+            id: record.id,
+            reference: record.reference ?? '',
+            title: record.title ?? '',
+            description: record.description ?? '',
+            coveringDates: record.coveringDates ?? '',
+            catalogueLevel: record.catalogueLevel ?? null,
+            department: record.department ?? '',
+            heldBy: record.heldBy ?? [],
+        })),
+    };
+}
+/**
+ * Sums one Discovery search page.
+ *
+ * @param result - a page from {@link parseTnaDiscoveryRecords}
+ * @returns the page size and the total hit count
+ */
+export function summarizeTnaDiscoverySearch(result) {
+    return { recordCount: result.records.length, totalCount: result.totalCount };
+}
+/**
+ * Searches the Discovery catalogue for one query.
+ *
+ * @param options - the search term and an optional fetch implementation
+ * @returns the page of records the search endpoint returns
+ */
+export async function fetchTnaDiscoveryRecords(options = {}) {
+    const { query = DEFAULT_TNA_DISCOVERY_QUERY, fetchImpl = globalThis.fetch } = options;
+    const response = await httpGet('tna-discovery', buildTnaDiscoverySearchUrl(query), {
+        fetchImpl,
+        headers: { Accept: TNA_DISCOVERY_ACCEPT_HEADER },
+    });
+    return parseTnaDiscoveryRecords(await response.json());
+}
+/** The National Archives Discovery catalogue search, keyless. */
+export const tnaDiscoveryAdapter = {
+    id: TNA_DISCOVERY_SOURCE_ID,
+    name: 'The National Archives Discovery catalogue search',
+    auth: 'none',
+    description: `Catalogue records matching "${DEFAULT_TNA_DISCOVERY_QUERY}", with the total hit count.`,
+    fetchLive: (options) => fetchTnaDiscoveryRecords(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    parse: parseTnaDiscoveryRecords,
+    loadFixture: () => parseTnaDiscoveryRecords(readFixtureJson('tna-discovery-2026-10-05.json')),
+};
+//# sourceMappingURL=tnaDiscovery.js.map

package/dist/tnaDiscovery.js.map

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

package/dist/ukhsaDashboard.d.ts

@@ -0,0 +1,92 @@
+import type { UkDataAdapter } from './types.js';
+/**
+ * The UK Health Security Agency data dashboard API. Keyless, published under
+ * the Open Government Licence v3.
+ */
+export declare const UKHSA_DASHBOARD_SOURCE_ID = "ukhsa-dashboard";
+/** Root of the UKHSA data dashboard API. */
+export declare const UKHSA_DASHBOARD_API_BASE_URL = "https://api.ukhsa-dashboard.data.gov.uk";
+/**
+ * The metric the adapter reads: new HIV diagnoses in England, a country-level
+ * annual series the dashboard publishes with real counts.
+ */
+export declare const UKHSA_DASHBOARD_METRIC_PATH: string;
+/** How many metric points the adapter asks for per page by default. */
+export declare const UKHSA_DASHBOARD_PAGE_SIZE = 10;
+/** One metric point from the UKHSA dashboard. */
+export interface UkhsaMetricPoint {
+    theme: string;
+    subTheme: string;
+    topic: string;
+    geographyType: string;
+    geography: string;
+    /** ONS geography code for the area, or "" when the API leaves it out. */
+    geographyCode: string;
+    metric: string;
+    metricGroup: string;
+    stratum: string;
+    /** "all" for the whole population, otherwise a named subgroup. */
+    sex: string;
+    age: string;
+    year: number;
+    /** Calendar month, 1 to 12, or null for a point that is not monthly. */
+    month: number | null;
+    /** Epidemiological week, or null for a point that is not weekly. */
+    epiweek: number | null;
+    /** The point's date, ISO 8601. */
+    date: string;
+    /** The measured value, or null where the API publishes none. */
+    metricValue: number | null;
+    /** True while the dashboard flags the point as still settling. */
+    inReportingDelayPeriod: boolean;
+}
+/** One page of UKHSA metric points plus the API's total count. */
+export interface UkhsaMetricPage {
+    /** Total points the API holds for the metric, not just this page. */
+    totalCount: number;
+    points: UkhsaMetricPoint[];
+}
+/** Rolled-up view of one page of UKHSA metric points. */
+export interface UkhsaMetricSummary {
+    pointCount: number;
+    totalCount: number;
+    /** Earliest and latest dates on the page, "" when the page is empty. */
+    firstDate: string;
+    lastDate: string;
+    /** The value on the latest point, or null when the page is empty. */
+    latestValue: number | null;
+}
+/**
+ * Builds the metric URL for one page size.
+ *
+ * @param pageSize - how many metric points to ask for
+ * @returns the metric endpoint URL
+ */
+export declare function buildUkhsaMetricUrl(pageSize: number): string;
+/**
+ * Parses a UKHSA dashboard metric payload.
+ *
+ * @param payload - the raw JSON body from the metric endpoint
+ * @returns the page of metric points plus the API's total count
+ */
+export declare function parseUkhsaMetricPoints(payload: unknown): UkhsaMetricPage;
+/**
+ * Sums one page of UKHSA metric points.
+ *
+ * @param page - a page from {@link parseUkhsaMetricPoints}
+ * @returns point counts, the date range on the page, and the latest value
+ */
+export declare function summarizeUkhsaMetricPoints(page: UkhsaMetricPage): UkhsaMetricSummary;
+/**
+ * Reads one page of UKHSA dashboard metric points.
+ *
+ * @param options - page size and an optional fetch implementation
+ * @returns the page of metric points the endpoint returns
+ */
+export declare function fetchUkhsaMetricPoints(options?: {
+    pageSize?: number;
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<UkhsaMetricPage>;
+/** UK Health Security Agency data dashboard metric points, keyless. */
+export declare const ukhsaDashboardAdapter: UkDataAdapter<UkhsaMetricPage>;
+//# sourceMappingURL=ukhsaDashboard.d.ts.map

package/dist/ukhsaDashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ukhsaDashboard.d.ts","sourceRoot":"","sources":["../src/ukhsaDashboard.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,yBAAyB,oBAAoB,CAAC;AAE3D,4CAA4C;AAC5C,eAAO,MAAM,4BAA4B,4CAA4C,CAAC;AAEtF;;;GAGG;AACH,eAAO,MAAM,2BAA2B,QAEsC,CAAC;AAE/E,uEAAuE;AACvE,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAE5C,iDAAiD;AACjD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,oEAAoE;IACpE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,kEAAkE;IAClE,sBAAsB,EAAE,OAAO,CAAC;CACjC;AAED,kEAAkE;AAClE,MAAM,WAAW,eAAe;IAC9B,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAED,yDAAyD;AACzD,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AA2BD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,CA2BxE;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,eAAe,GAAG,kBAAkB,CAoBpF;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAAO,GACvE,OAAO,CAAC,eAAe,CAAC,CAI1B;AAED,uEAAuE;AACvE,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAAC,eAAe,CAWhE,CAAC"}