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

package/README.md

@@ -19,6 +19,17 @@ builds work offline.
 | `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 |
+| `postcode-lookup`          | postcodes.io (ONS and OS data)      | none | One postcode's country, region, wards, and coordinates |
+| `explore-education-statistics` | Department for Education       | none | The most recent statistics releases, with their publish stamps |
+| `london-datastore`         | Greater London Authority            | none | Every dataset on the London Datastore |
+| `tna-discovery`            | The National Archives               | none | Catalogue records matching a search, with the total hit count |
+| `ukhsa-dashboard`          | UK Health Security Agency           | none | Metric points for new HIV diagnoses in England |
+| `nomis`                    | ONS Nomis                           | none | SDMX dataset definitions, with maintenance status and keywords |
+| `fingertips-indicators`    | Office for Health Improvement and Disparities | none | Public health indicator metadata, with unit, type, and data source |
+| `find-a-tender`            | Cabinet Office                      | none | Recent procurement notices as OCDS 1.1 releases |
+| `tfl-line-status`          | Transport for London                | none | Live status of every Tube line, with disruption reasons |
+| `public-health-scotland`   | Public Health Scotland              | none | Every dataset on the Public Health Scotland CKAN portal |
+| `nhsbsa-ckan`              | NHS Business Services Authority     | none | Every dataset on the NHSBSA CKAN portal |
 
 The flood-monitoring adapters use `environment.data.gov.uk` under the Open
 Government Licence v3:
@@ -89,6 +100,16 @@ under the Open Parliament Licence v3.0:
 The call needs a house and a date, so the adapter asks for the caller's own
 date rather than a fixed one.
 
+Eleven more keyless adapters landed on 2026-10-05: `postcode-lookup` reads
+one postcode from postcodes.io, `explore-education-statistics` reads the
+Department for Education's most recent releases, `london-datastore` and
+`public-health-scotland` and `nhsbsa-ckan` read CKAN catalogues, `tna-discovery`
+searches The National Archives catalogue, `ukhsa-dashboard` reads UKHSA metric
+points, `nomis` reads the ONS Nomis SDMX catalogue, `fingertips-indicators`
+reads OHID indicator metadata, `find-a-tender` reads OCDS procurement notices,
+and `tfl-line-status` reads live Tube status. Endpoints, exact curl commands,
+capture date, and licences are in `docs/CONNECTOR_DISCOVERY.md`.
+
 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,

package/dist/exploreEducationStatistics.d.ts

@@ -0,0 +1,72 @@
+import type { UkDataAdapter } from './types.js';
+/**
+ * The Department for Education's Explore Education Statistics publications
+ * API. Keyless, published under the Open Government Licence v3.
+ */
+export declare const EXPLORE_EDUCATION_STATISTICS_SOURCE_ID = "explore-education-statistics";
+/** Base URL for the Explore Education Statistics publications endpoint. */
+export declare const EXPLORE_EDUCATION_PUBLICATIONS_URL = "https://api.education.gov.uk/statistics/v1/publications";
+/** How many publications the adapter asks for per page by default. */
+export declare const EXPLORE_EDUCATION_PUBLICATIONS_PAGE_SIZE = 20;
+/** One published statistics release as the API lists it. */
+export interface ExploreEducationPublication {
+    id: string;
+    title: string;
+    /** URL-safe identifier, unique across releases. */
+    slug: string;
+    summary: string;
+    /** Publication stamp the API reports, ISO 8601 with an offset. */
+    lastPublishedIso: string;
+}
+/** One page of the publications catalogue plus the API's paging counts. */
+export interface ExploreEducationPublicationsPage {
+    page: number;
+    pageSize: number;
+    totalResults: number;
+    totalPages: number;
+    publications: ExploreEducationPublication[];
+}
+/** Rolled-up view of one publications page. */
+export interface ExploreEducationPublicationsSummary {
+    publicationCount: number;
+    /** Total releases the API holds, not just this page. */
+    totalResults: number;
+    /** The most recent publish stamp on this page, or "" when the page is empty. */
+    latestPublishedIso: string;
+}
+/**
+ * Builds a publications URL for one page.
+ *
+ * @param page - one-based page number
+ * @param pageSize - records per page
+ * @returns the publications catalogue URL
+ */
+export declare function buildExploreEducationPublicationsUrl(page: number, pageSize: number): string;
+/**
+ * Parses an Explore Education Statistics publications payload.
+ *
+ * @param payload - the raw JSON body from the publications endpoint
+ * @returns the page of publications plus the API's paging counts
+ */
+export declare function parseExploreEducationPublications(payload: unknown): ExploreEducationPublicationsPage;
+/**
+ * Sums one publications page.
+ *
+ * @param page - a page from {@link parseExploreEducationPublications}
+ * @returns publication counts and the newest publish stamp on the page
+ */
+export declare function summarizeExploreEducationPublications(page: ExploreEducationPublicationsPage): ExploreEducationPublicationsSummary;
+/**
+ * Lists one page of Explore Education Statistics publications.
+ *
+ * @param options - page, page size, and an optional fetch implementation
+ * @returns the page of publications the endpoint returns
+ */
+export declare function fetchExploreEducationPublications(options?: {
+    page?: number;
+    pageSize?: number;
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<ExploreEducationPublicationsPage>;
+/** Explore Education Statistics publications, keyless. */
+export declare const exploreEducationStatisticsAdapter: UkDataAdapter<ExploreEducationPublicationsPage>;
+//# sourceMappingURL=exploreEducationStatistics.d.ts.map

package/dist/exploreEducationStatistics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exploreEducationStatistics.d.ts","sourceRoot":"","sources":["../src/exploreEducationStatistics.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,sCAAsC,iCAAiC,CAAC;AAErF,2EAA2E;AAC3E,eAAO,MAAM,kCAAkC,4DACY,CAAC;AAE5D,sEAAsE;AACtE,eAAO,MAAM,wCAAwC,KAAK,CAAC;AAE3D,4DAA4D;AAC5D,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,2EAA2E;AAC3E,MAAM,WAAW,gCAAgC;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,2BAA2B,EAAE,CAAC;CAC7C;AAED,+CAA+C;AAC/C,MAAM,WAAW,mCAAmC;IAClD,gBAAgB,EAAE,MAAM,CAAC;IACzB,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAoBD;;;;;;GAMG;AACH,wBAAgB,oCAAoC,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE3F;AAED;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,OAAO,GACf,gCAAgC,CAkBlC;AAED;;;;;GAKG;AACH,wBAAgB,qCAAqC,CACnD,IAAI,EAAE,gCAAgC,GACrC,mCAAmC,CAerC;AAED;;;;;GAKG;AACH,wBAAsB,iCAAiC,CACrD,OAAO,GAAE;IACP,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CAChC,GACL,OAAO,CAAC,gCAAgC,CAAC,CAc3C;AAED,0DAA0D;AAC1D,eAAO,MAAM,iCAAiC,EAAE,aAAa,CAAC,gCAAgC,CAc7F,CAAC"}

package/dist/exploreEducationStatistics.js

@@ -0,0 +1,110 @@
+import { z } from 'zod';
+import { UkSourceApiError, UkSourceParseError } from './errors.js';
+import { readFixtureJson } from './fixtures.js';
+/**
+ * The Department for Education's Explore Education Statistics publications
+ * API. Keyless, published under the Open Government Licence v3.
+ */
+export const EXPLORE_EDUCATION_STATISTICS_SOURCE_ID = 'explore-education-statistics';
+/** Base URL for the Explore Education Statistics publications endpoint. */
+export const EXPLORE_EDUCATION_PUBLICATIONS_URL = 'https://api.education.gov.uk/statistics/v1/publications';
+/** How many publications the adapter asks for per page by default. */
+export const EXPLORE_EDUCATION_PUBLICATIONS_PAGE_SIZE = 20;
+const EXPLORE_EDUCATION_PUBLICATION_SCHEMA = z.object({
+    id: z.string(),
+    title: z.string(),
+    slug: z.string(),
+    summary: z.string().nullable().optional(),
+    lastPublished: z.string(),
+});
+const EXPLORE_EDUCATION_PUBLICATIONS_SCHEMA = z.object({
+    paging: z.object({
+        page: z.number(),
+        pageSize: z.number(),
+        totalResults: z.number(),
+        totalPages: z.number(),
+    }),
+    results: z.array(EXPLORE_EDUCATION_PUBLICATION_SCHEMA),
+});
+/**
+ * Builds a publications URL for one page.
+ *
+ * @param page - one-based page number
+ * @param pageSize - records per page
+ * @returns the publications catalogue URL
+ */
+export function buildExploreEducationPublicationsUrl(page, pageSize) {
+    return `${EXPLORE_EDUCATION_PUBLICATIONS_URL}?page=${page}&pageSize=${pageSize}`;
+}
+/**
+ * Parses an Explore Education Statistics publications payload.
+ *
+ * @param payload - the raw JSON body from the publications endpoint
+ * @returns the page of publications plus the API's paging counts
+ */
+export function parseExploreEducationPublications(payload) {
+    const parsed = EXPLORE_EDUCATION_PUBLICATIONS_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UkSourceParseError('explore-education-statistics', parsed.error.message);
+    }
+    return {
+        page: parsed.data.paging.page,
+        pageSize: parsed.data.paging.pageSize,
+        totalResults: parsed.data.paging.totalResults,
+        totalPages: parsed.data.paging.totalPages,
+        publications: parsed.data.results.map((publication) => ({
+            id: publication.id,
+            title: publication.title,
+            slug: publication.slug,
+            summary: publication.summary ?? '',
+            lastPublishedIso: publication.lastPublished,
+        })),
+    };
+}
+/**
+ * Sums one publications page.
+ *
+ * @param page - a page from {@link parseExploreEducationPublications}
+ * @returns publication counts and the newest publish stamp on the page
+ */
+export function summarizeExploreEducationPublications(page) {
+    let latestPublishedIso = '';
+    let latestPublishedEpoch = Number.NEGATIVE_INFINITY;
+    for (const publication of page.publications) {
+        const epoch = Date.parse(publication.lastPublishedIso);
+        if (Number.isFinite(epoch) && epoch > latestPublishedEpoch) {
+            latestPublishedEpoch = epoch;
+            latestPublishedIso = publication.lastPublishedIso;
+        }
+    }
+    return {
+        publicationCount: page.publications.length,
+        totalResults: page.totalResults,
+        latestPublishedIso,
+    };
+}
+/**
+ * Lists one page of Explore Education Statistics publications.
+ *
+ * @param options - page, page size, and an optional fetch implementation
+ * @returns the page of publications the endpoint returns
+ */
+export async function fetchExploreEducationPublications(options = {}) {
+    const { page = 1, pageSize = EXPLORE_EDUCATION_PUBLICATIONS_PAGE_SIZE, fetchImpl = globalThis.fetch, } = options;
+    const response = await fetchImpl(buildExploreEducationPublicationsUrl(page, pageSize));
+    if (!response.ok) {
+        throw new UkSourceApiError('explore-education-statistics', `HTTP ${response.status} listing publications`);
+    }
+    return parseExploreEducationPublications(await response.json());
+}
+/** Explore Education Statistics publications, keyless. */
+export const exploreEducationStatisticsAdapter = {
+    id: EXPLORE_EDUCATION_STATISTICS_SOURCE_ID,
+    name: 'Department for Education Explore Education Statistics publications',
+    auth: 'none',
+    description: 'The most recent statistics releases the Department for Education has published.',
+    fetchLive: (options) => fetchExploreEducationPublications(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    parse: parseExploreEducationPublications,
+    loadFixture: () => parseExploreEducationPublications(readFixtureJson('explore-education-statistics-2026-10-05.json')),
+};
+//# sourceMappingURL=exploreEducationStatistics.js.map

package/dist/exploreEducationStatistics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exploreEducationStatistics.js","sourceRoot":"","sources":["../src/exploreEducationStatistics.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;;;GAGG;AACH,MAAM,CAAC,MAAM,sCAAsC,GAAG,8BAA8B,CAAC;AAErF,2EAA2E;AAC3E,MAAM,CAAC,MAAM,kCAAkC,GAC7C,yDAAyD,CAAC;AAE5D,sEAAsE;AACtE,MAAM,CAAC,MAAM,wCAAwC,GAAG,EAAE,CAAC;AA+B3D,MAAM,oCAAoC,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACzC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;CAC1B,CAAC,CAAC;AAEH,MAAM,qCAAqC,GAAG,CAAC,CAAC,MAAM,CAAC;IACrD,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;QACxB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;KACvB,CAAC;IACF,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,oCAAoC,CAAC;CACvD,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,oCAAoC,CAAC,IAAY,EAAE,QAAgB;IACjF,OAAO,GAAG,kCAAkC,SAAS,IAAI,aAAa,QAAQ,EAAE,CAAC;AACnF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iCAAiC,CAC/C,OAAgB;IAEhB,MAAM,MAAM,GAAG,qCAAqC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACxE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,kBAAkB,CAAC,8BAA8B,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrF,CAAC;IACD,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI;QAC7B,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ;QACrC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY;QAC7C,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU;QACzC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YACtD,EAAE,EAAE,WAAW,CAAC,EAAE;YAClB,KAAK,EAAE,WAAW,CAAC,KAAK;YACxB,IAAI,EAAE,WAAW,CAAC,IAAI;YACtB,OAAO,EAAE,WAAW,CAAC,OAAO,IAAI,EAAE;YAClC,gBAAgB,EAAE,WAAW,CAAC,aAAa;SAC5C,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qCAAqC,CACnD,IAAsC;IAEtC,IAAI,kBAAkB,GAAG,EAAE,CAAC;IAC5B,IAAI,oBAAoB,GAAG,MAAM,CAAC,iBAAiB,CAAC;IACpD,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;QACvD,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,oBAAoB,EAAE,CAAC;YAC3D,oBAAoB,GAAG,KAAK,CAAC;YAC7B,kBAAkB,GAAG,WAAW,CAAC,gBAAgB,CAAC;QACpD,CAAC;IACH,CAAC;IACD,OAAO;QACL,gBAAgB,EAAE,IAAI,CAAC,YAAY,CAAC,MAAM;QAC1C,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,kBAAkB;KACnB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iCAAiC,CACrD,UAII,EAAE;IAEN,MAAM,EACJ,IAAI,GAAG,CAAC,EACR,QAAQ,GAAG,wCAAwC,EACnD,SAAS,GAAG,UAAU,CAAC,KAAK,GAC7B,GAAG,OAAO,CAAC;IACZ,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,oCAAoC,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;IACvF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,gBAAgB,CACxB,8BAA8B,EAC9B,QAAQ,QAAQ,CAAC,MAAM,uBAAuB,CAC/C,CAAC;IACJ,CAAC;IACD,OAAO,iCAAiC,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AAClE,CAAC;AAED,0DAA0D;AAC1D,MAAM,CAAC,MAAM,iCAAiC,GAAoD;IAChG,EAAE,EAAE,sCAAsC;IAC1C,IAAI,EAAE,oEAAoE;IAC1E,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,iFAAiF;IAC9F,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,CAC/B,eAAe,CAAC,8CAA8C,CAAC,CAChE;CACJ,CAAC"}

package/dist/findATender.d.ts

@@ -0,0 +1,76 @@
+import type { UkDataAdapter } from './types.js';
+/**
+ * Find a Tender, the UK's post-Brexit public procurement service run by the
+ * Cabinet Office. Keyless, and the notices are published under the Open
+ * Government Licence v3, matching the licence the payload itself carries.
+ */
+export declare const FIND_A_TENDER_SOURCE_ID = "find-a-tender";
+/** The OCDS 1.1 release packages endpoint. */
+export declare const FIND_A_TENDER_RELEASE_PACKAGES_URL = "https://www.find-tender.service.gov.uk/api/1.0/ocdsReleasePackages";
+/** How many release packages the adapter asks for by default. */
+export declare const FIND_A_TENDER_RELEASE_LIMIT = 10;
+/** One Open Contracting Data Standard release, as Find a Tender publishes it. */
+export interface FindATenderRelease {
+    /** Open Contracting identifier shared by every release of one tender. */
+    ocid: string;
+    /** The release id, unique within the tender. */
+    id: string;
+    /** When the release was published, ISO 8601 with an offset. */
+    date: string;
+    /** Release tags, such as "tender", "award", or "contractAmendment". */
+    tags: string[];
+    tenderTitle: string;
+    /** Tender status, such as "active" or "complete", or "" when unset. */
+    tenderStatus: string;
+    procurementMethod: string;
+    buyerName: string;
+    /** The tender value amount, or null when the release leaves it out. */
+    tenderValueAmount: number | null;
+}
+/** One page of OCDS releases plus the package metadata around them. */
+export interface FindATenderReleasePage {
+    /** The package URI the service echoes back, including its own cursor. */
+    uri: string;
+    version: string;
+    publishedDate: string;
+    releases: FindATenderRelease[];
+}
+/** Release counts by tender status. */
+export interface FindATenderStatusCount {
+    status: string;
+    releaseCount: number;
+}
+/** Rolled-up view of one page of Find a Tender releases. */
+export interface FindATenderSummary {
+    releaseCount: number;
+    /** Releases with an unset tender status. */
+    unsetStatusCount: number;
+    statusCounts: FindATenderStatusCount[];
+}
+/**
+ * Parses an OCDS release packages payload into releases.
+ *
+ * @param payload - the raw JSON body from the release packages endpoint
+ * @returns the releases plus the package metadata
+ */
+export declare function parseFindATenderReleases(payload: unknown): FindATenderReleasePage;
+/**
+ * Counts the releases on one page by tender status.
+ *
+ * @param page - a page from {@link parseFindATenderReleases}
+ * @returns the release count and a per-status breakdown, most releases first
+ */
+export declare function summarizeFindATenderReleases(page: FindATenderReleasePage): FindATenderSummary;
+/**
+ * Lists the most recent Find a Tender release packages.
+ *
+ * @param options - release limit and an optional fetch implementation
+ * @returns the releases the endpoint returns
+ */
+export declare function fetchFindATenderReleases(options?: {
+    limit?: number;
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<FindATenderReleasePage>;
+/** Find a Tender OCDS release packages, keyless. */
+export declare const findATenderAdapter: UkDataAdapter<FindATenderReleasePage>;
+//# sourceMappingURL=findATender.d.ts.map

package/dist/findATender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findATender.d.ts","sourceRoot":"","sources":["../src/findATender.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,kBAAkB,CAAC;AAEvD,8CAA8C;AAC9C,eAAO,MAAM,kCAAkC,uEACuB,CAAC;AAEvE,iEAAiE;AACjE,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAE9C,iFAAiF;AACjF,MAAM,WAAW,kBAAkB;IACjC,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,EAAE,EAAE,MAAM,CAAC;IACX,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,uEAAuE;AACvE,MAAM,WAAW,sBAAsB;IACrC,yEAAyE;IACzE,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,kBAAkB,EAAE,CAAC;CAChC;AAED,uCAAuC;AACvC,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,4DAA4D;AAC5D,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,sBAAsB,EAAE,CAAC;CACxC;AA0BD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,sBAAsB,CAqBjF;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,sBAAsB,GAAG,kBAAkB,CAiB7F;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,sBAAsB,CAAC,CAOjC;AAED,oDAAoD;AACpD,eAAO,MAAM,kBAAkB,EAAE,aAAa,CAAC,sBAAsB,CAWpE,CAAC"}

package/dist/findATender.js

@@ -0,0 +1,109 @@
+import { z } from 'zod';
+import { UkSourceApiError, UkSourceParseError } from './errors.js';
+import { readFixtureJson } from './fixtures.js';
+/**
+ * Find a Tender, the UK's post-Brexit public procurement service run by the
+ * Cabinet Office. Keyless, and the notices are published under the Open
+ * Government Licence v3, matching the licence the payload itself carries.
+ */
+export const FIND_A_TENDER_SOURCE_ID = 'find-a-tender';
+/** The OCDS 1.1 release packages endpoint. */
+export const FIND_A_TENDER_RELEASE_PACKAGES_URL = 'https://www.find-tender.service.gov.uk/api/1.0/ocdsReleasePackages';
+/** How many release packages the adapter asks for by default. */
+export const FIND_A_TENDER_RELEASE_LIMIT = 10;
+const FIND_A_TENDER_RELEASE_SCHEMA = z.object({
+    ocid: z.string(),
+    id: z.string(),
+    date: z.string(),
+    tag: z.array(z.string()).optional(),
+    tender: z
+        .object({
+        title: z.string().nullable().optional(),
+        status: z.string().nullable().optional(),
+        procurementMethod: z.string().nullable().optional(),
+        value: z.object({ amount: z.number().nullable().optional() }).nullable().optional(),
+    })
+        .nullable()
+        .optional(),
+    buyer: z.object({ name: z.string().nullable().optional() }).nullable().optional(),
+});
+const FIND_A_TENDER_RELEASE_PACKAGE_SCHEMA = z.object({
+    uri: z.string(),
+    version: z.string(),
+    publishedDate: z.string(),
+    releases: z.array(FIND_A_TENDER_RELEASE_SCHEMA),
+});
+/**
+ * Parses an OCDS release packages payload into releases.
+ *
+ * @param payload - the raw JSON body from the release packages endpoint
+ * @returns the releases plus the package metadata
+ */
+export function parseFindATenderReleases(payload) {
+    const parsed = FIND_A_TENDER_RELEASE_PACKAGE_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UkSourceParseError('find-a-tender', parsed.error.message);
+    }
+    return {
+        uri: parsed.data.uri,
+        version: parsed.data.version,
+        publishedDate: parsed.data.publishedDate,
+        releases: parsed.data.releases.map((release) => ({
+            ocid: release.ocid,
+            id: release.id,
+            date: release.date,
+            tags: release.tag ?? [],
+            tenderTitle: release.tender?.title ?? '',
+            tenderStatus: release.tender?.status ?? '',
+            procurementMethod: release.tender?.procurementMethod ?? '',
+            buyerName: release.buyer?.name ?? '',
+            tenderValueAmount: release.tender?.value?.amount ?? null,
+        })),
+    };
+}
+/**
+ * Counts the releases on one page by tender status.
+ *
+ * @param page - a page from {@link parseFindATenderReleases}
+ * @returns the release count and a per-status breakdown, most releases first
+ */
+export function summarizeFindATenderReleases(page) {
+    const countByStatus = new Map();
+    let unsetStatusCount = 0;
+    for (const release of page.releases) {
+        if (release.tenderStatus === '') {
+            unsetStatusCount += 1;
+            continue;
+        }
+        countByStatus.set(release.tenderStatus, (countByStatus.get(release.tenderStatus) ?? 0) + 1);
+    }
+    const statusCounts = [...countByStatus.entries()]
+        .map(([status, releaseCount]) => ({ status, releaseCount }))
+        .sort((left, right) => right.releaseCount - left.releaseCount || left.status.localeCompare(right.status));
+    return { releaseCount: page.releases.length, unsetStatusCount, statusCounts };
+}
+/**
+ * Lists the most recent Find a Tender release packages.
+ *
+ * @param options - release limit and an optional fetch implementation
+ * @returns the releases the endpoint returns
+ */
+export async function fetchFindATenderReleases(options = {}) {
+    const { limit = FIND_A_TENDER_RELEASE_LIMIT, fetchImpl = globalThis.fetch } = options;
+    const response = await fetchImpl(`${FIND_A_TENDER_RELEASE_PACKAGES_URL}?limit=${limit}`);
+    if (!response.ok) {
+        throw new UkSourceApiError('find-a-tender', `HTTP ${response.status} listing releases`);
+    }
+    return parseFindATenderReleases(await response.json());
+}
+/** Find a Tender OCDS release packages, keyless. */
+export const findATenderAdapter = {
+    id: FIND_A_TENDER_SOURCE_ID,
+    name: 'Find a Tender OCDS release packages',
+    auth: 'none',
+    description: 'The most recent public procurement notices Find a Tender publishes.',
+    fetchLive: (options) => fetchFindATenderReleases(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    parse: parseFindATenderReleases,
+    loadFixture: () => parseFindATenderReleases(readFixtureJson('find-a-tender-2026-10-05.json')),
+};
+//# sourceMappingURL=findATender.js.map

package/dist/findATender.js.map

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

package/dist/fingertipsIndicators.d.ts

@@ -0,0 +1,67 @@
+import type { UkDataAdapter } from './types.js';
+/**
+ * The Office for Health Improvement and Disparities public health profiles,
+ * published by Fingertips. Keyless, under the Open Government Licence v3.
+ */
+export declare const FINGERTIPS_INDICATORS_SOURCE_ID = "fingertips-indicators";
+/** Base URL for the Fingertips indicator metadata call. */
+export declare const FINGERTIPS_INDICATOR_METADATA_URL = "https://fingertips.phe.org.uk/api/indicator_metadata/by_indicator_id";
+/** The indicator the adapter reads when the caller does not name one. */
+export declare const DEFAULT_FINGERTIPS_INDICATOR_IDS: number[];
+/** One public health indicator and the metadata behind it. */
+export interface FingertipsIndicatorMetadata {
+    indicatorId: number;
+    name: string;
+    /** The body that produced the figures, such as the ONS. */
+    dataSource: string;
+    /** The unit the indicator counts in, or "" when Fingertips leaves it out. */
+    unitLabel: string;
+    /** The measure type, such as "Life expectancy". */
+    valueType: string;
+    /** The year basis, such as "Calendar". */
+    yearType: string;
+    /** When Fingertips last uploaded data, or "" when unset. */
+    lastUploadedAt: string;
+    /** Fingertips' override stamp for the last change, or "" when unset. */
+    latestChangeTimestampOverride: string;
+}
+/** Rolled-up view of the indicators a call returns. */
+export interface FingertipsIndicatorsSummary {
+    indicatorCount: number;
+    /** The distinct data sources behind the indicators, sorted. */
+    dataSources: string[];
+}
+/**
+ * Builds the Fingertips indicator metadata URL for a set of indicator ids.
+ *
+ * @param indicatorIds - the indicator ids to read
+ * @returns the metadata URL, ids comma-separated
+ */
+export declare function buildFingertipsIndicatorUrl(indicatorIds: number[]): string;
+/**
+ * Parses a Fingertips indicator metadata payload.
+ *
+ * @param payload - the raw JSON body from the metadata endpoint
+ * @returns one entry per indicator the payload carries
+ */
+export declare function parseFingertipsIndicators(payload: unknown): FingertipsIndicatorMetadata[];
+/**
+ * Sums the indicators a call returns.
+ *
+ * @param indicators - indicators from {@link parseFingertipsIndicators}
+ * @returns the indicator count and the distinct data sources behind them
+ */
+export declare function summarizeFingertipsIndicators(indicators: FingertipsIndicatorMetadata[]): FingertipsIndicatorsSummary;
+/**
+ * Reads metadata for a set of Fingertips public health indicators.
+ *
+ * @param options - indicator ids and an optional fetch implementation
+ * @returns the indicator metadata the endpoint returns
+ */
+export declare function fetchFingertipsIndicators(options?: {
+    indicatorIds?: number[];
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<FingertipsIndicatorMetadata[]>;
+/** Fingertips public health indicator metadata, keyless. */
+export declare const fingertipsIndicatorsAdapter: UkDataAdapter<FingertipsIndicatorMetadata[]>;
+//# sourceMappingURL=fingertipsIndicators.d.ts.map

package/dist/fingertipsIndicators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingertipsIndicators.d.ts","sourceRoot":"","sources":["../src/fingertipsIndicators.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,+BAA+B,0BAA0B,CAAC;AAEvE,2DAA2D;AAC3D,eAAO,MAAM,iCAAiC,yEAC0B,CAAC;AAEzE,yEAAyE;AACzE,eAAO,MAAM,gCAAgC,EAAE,MAAM,EAAY,CAAC;AAElE,8DAA8D;AAC9D,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,cAAc,EAAE,MAAM,CAAC;IACvB,wEAAwE;IACxE,6BAA6B,EAAE,MAAM,CAAC;CACvC;AAED,uDAAuD;AACvD,MAAM,WAAW,2BAA2B;IAC1C,cAAc,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAkBD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,CAE1E;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,2BAA2B,EAAE,CAezF;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,2BAA2B,EAAE,GACxC,2BAA2B,CAK7B;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAAO,GAC7E,OAAO,CAAC,2BAA2B,EAAE,CAAC,CAOxC;AAED,4DAA4D;AAC5D,eAAO,MAAM,2BAA2B,EAAE,aAAa,CAAC,2BAA2B,EAAE,CAapF,CAAC"}

package/dist/fingertipsIndicators.js

@@ -0,0 +1,94 @@
+import { z } from 'zod';
+import { UkSourceApiError, UkSourceParseError } from './errors.js';
+import { readFixtureJson } from './fixtures.js';
+/**
+ * The Office for Health Improvement and Disparities public health profiles,
+ * published by Fingertips. Keyless, under the Open Government Licence v3.
+ */
+export const FINGERTIPS_INDICATORS_SOURCE_ID = 'fingertips-indicators';
+/** Base URL for the Fingertips indicator metadata call. */
+export const FINGERTIPS_INDICATOR_METADATA_URL = 'https://fingertips.phe.org.uk/api/indicator_metadata/by_indicator_id';
+/** The indicator the adapter reads when the caller does not name one. */
+export const DEFAULT_FINGERTIPS_INDICATOR_IDS = [90366];
+const FINGERTIPS_INDICATOR_SCHEMA = z.object({
+    IID: z.number(),
+    LatestChangeTimestampOverride: z.string().nullable().optional(),
+    Unit: z.object({ Label: z.string() }).nullable().optional(),
+    YearType: z.object({ Name: z.string() }).nullable().optional(),
+    ValueType: z.object({ Name: z.string() }).nullable().optional(),
+    Descriptive: z
+        .object({ Name: z.string(), DataSource: z.string().nullable().optional() })
+        .nullable()
+        .optional(),
+    DataChange: z.object({ LastUploadedAt: z.string().nullable().optional() }).nullable().optional(),
+});
+/** Indicator metadata keyed by indicator id, as Fingertips returns it. */
+const FINGERTIPS_INDICATORS_SCHEMA = z.record(z.string(), FINGERTIPS_INDICATOR_SCHEMA);
+/**
+ * Builds the Fingertips indicator metadata URL for a set of indicator ids.
+ *
+ * @param indicatorIds - the indicator ids to read
+ * @returns the metadata URL, ids comma-separated
+ */
+export function buildFingertipsIndicatorUrl(indicatorIds) {
+    return `${FINGERTIPS_INDICATOR_METADATA_URL}?indicator_ids=${indicatorIds.join(',')}`;
+}
+/**
+ * Parses a Fingertips indicator metadata payload.
+ *
+ * @param payload - the raw JSON body from the metadata endpoint
+ * @returns one entry per indicator the payload carries
+ */
+export function parseFingertipsIndicators(payload) {
+    const parsed = FINGERTIPS_INDICATORS_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UkSourceParseError('fingertips-indicators', parsed.error.message);
+    }
+    return Object.values(parsed.data).map((indicator) => ({
+        indicatorId: indicator.IID,
+        name: indicator.Descriptive?.Name ?? '',
+        dataSource: indicator.Descriptive?.DataSource ?? '',
+        unitLabel: indicator.Unit?.Label ?? '',
+        valueType: indicator.ValueType?.Name ?? '',
+        yearType: indicator.YearType?.Name ?? '',
+        lastUploadedAt: indicator.DataChange?.LastUploadedAt ?? '',
+        latestChangeTimestampOverride: indicator.LatestChangeTimestampOverride ?? '',
+    }));
+}
+/**
+ * Sums the indicators a call returns.
+ *
+ * @param indicators - indicators from {@link parseFingertipsIndicators}
+ * @returns the indicator count and the distinct data sources behind them
+ */
+export function summarizeFingertipsIndicators(indicators) {
+    const dataSources = [...new Set(indicators.map((indicator) => indicator.dataSource))]
+        .filter((dataSource) => dataSource !== '')
+        .sort((left, right) => left.localeCompare(right));
+    return { indicatorCount: indicators.length, dataSources };
+}
+/**
+ * Reads metadata for a set of Fingertips public health indicators.
+ *
+ * @param options - indicator ids and an optional fetch implementation
+ * @returns the indicator metadata the endpoint returns
+ */
+export async function fetchFingertipsIndicators(options = {}) {
+    const { indicatorIds = DEFAULT_FINGERTIPS_INDICATOR_IDS, fetchImpl = globalThis.fetch } = options;
+    const response = await fetchImpl(buildFingertipsIndicatorUrl(indicatorIds));
+    if (!response.ok) {
+        throw new UkSourceApiError('fingertips-indicators', `HTTP ${response.status} reading metadata`);
+    }
+    return parseFingertipsIndicators(await response.json());
+}
+/** Fingertips public health indicator metadata, keyless. */
+export const fingertipsIndicatorsAdapter = {
+    id: FINGERTIPS_INDICATORS_SOURCE_ID,
+    name: 'Office for Health Improvement and Disparities Fingertips indicators',
+    auth: 'none',
+    description: 'Metadata for the public health indicators Fingertips publishes, with their sources.',
+    fetchLive: (options) => fetchFingertipsIndicators(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    parse: parseFingertipsIndicators,
+    loadFixture: () => parseFingertipsIndicators(readFixtureJson('fingertips-indicators-2026-10-05.json')),
+};
+//# sourceMappingURL=fingertipsIndicators.js.map

package/dist/fingertipsIndicators.js.map

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