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

package/dist/tnaDiscovery.js

@@ -0,0 +1,101 @@
+import { z } from 'zod';
+import { UkSourceApiError, UkSourceParseError } from './errors.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 fetchImpl(buildTnaDiscoverySearchUrl(query), {
+        headers: { Accept: TNA_DISCOVERY_ACCEPT_HEADER },
+    });
+    if (!response.ok) {
+        throw new UkSourceApiError('tna-discovery', `HTTP ${response.status} searching records`);
+    }
+    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":"AAIA,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,CAO1B;AAED,uEAAuE;AACvE,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAAC,eAAe,CAWhE,CAAC"}

package/dist/ukhsaDashboard.js

@@ -0,0 +1,136 @@
+import { z } from 'zod';
+import { UkSourceApiError, UkSourceParseError } from './errors.js';
+import { readFixtureJson } from './fixtures.js';
+/**
+ * The UK Health Security Agency data dashboard API. Keyless, published under
+ * the Open Government Licence v3.
+ */
+export const UKHSA_DASHBOARD_SOURCE_ID = 'ukhsa-dashboard';
+/** Root of the UKHSA data dashboard API. */
+export 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 const UKHSA_DASHBOARD_METRIC_PATH = '/themes/infectious_disease/sub_themes/bloodborne/topics/HIV' +
+    '/geography_types/Nation/geographies/England/metrics/HIV_cases_newDiagnoses';
+/** How many metric points the adapter asks for per page by default. */
+export const UKHSA_DASHBOARD_PAGE_SIZE = 10;
+const UKHSA_METRIC_POINT_SCHEMA = z.object({
+    theme: z.string(),
+    sub_theme: z.string(),
+    topic: z.string(),
+    geography_type: z.string(),
+    geography: z.string(),
+    geography_code: z.string().nullable().optional(),
+    metric: z.string(),
+    metric_group: z.string().nullable().optional(),
+    stratum: z.string().nullable().optional(),
+    sex: z.string(),
+    age: z.string(),
+    year: z.number(),
+    month: z.number().nullable().optional(),
+    epiweek: z.number().nullable().optional(),
+    date: z.string(),
+    metric_value: z.number().nullable().optional(),
+    in_reporting_delay_period: z.boolean(),
+});
+const UKHSA_METRIC_PAGE_SCHEMA = z.object({
+    count: z.number(),
+    results: z.array(UKHSA_METRIC_POINT_SCHEMA),
+});
+/**
+ * Builds the metric URL for one page size.
+ *
+ * @param pageSize - how many metric points to ask for
+ * @returns the metric endpoint URL
+ */
+export function buildUkhsaMetricUrl(pageSize) {
+    return `${UKHSA_DASHBOARD_API_BASE_URL}${UKHSA_DASHBOARD_METRIC_PATH}?page_size=${pageSize}`;
+}
+/**
+ * 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 function parseUkhsaMetricPoints(payload) {
+    const parsed = UKHSA_METRIC_PAGE_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UkSourceParseError('ukhsa-dashboard', parsed.error.message);
+    }
+    return {
+        totalCount: parsed.data.count,
+        points: parsed.data.results.map((point) => ({
+            theme: point.theme,
+            subTheme: point.sub_theme,
+            topic: point.topic,
+            geographyType: point.geography_type,
+            geography: point.geography,
+            geographyCode: point.geography_code ?? '',
+            metric: point.metric,
+            metricGroup: point.metric_group ?? '',
+            stratum: point.stratum ?? '',
+            sex: point.sex,
+            age: point.age,
+            year: point.year,
+            month: point.month ?? null,
+            epiweek: point.epiweek ?? null,
+            date: point.date,
+            metricValue: point.metric_value ?? null,
+            inReportingDelayPeriod: point.in_reporting_delay_period,
+        })),
+    };
+}
+/**
+ * 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 function summarizeUkhsaMetricPoints(page) {
+    let firstDate = '';
+    let lastDate = '';
+    let latestValue = null;
+    for (const point of page.points) {
+        if (firstDate === '' || point.date < firstDate) {
+            firstDate = point.date;
+        }
+        if (point.date >= lastDate) {
+            lastDate = point.date;
+            latestValue = point.metricValue;
+        }
+    }
+    return {
+        pointCount: page.points.length,
+        totalCount: page.totalCount,
+        firstDate,
+        lastDate,
+        latestValue,
+    };
+}
+/**
+ * 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 async function fetchUkhsaMetricPoints(options = {}) {
+    const { pageSize = UKHSA_DASHBOARD_PAGE_SIZE, fetchImpl = globalThis.fetch } = options;
+    const response = await fetchImpl(buildUkhsaMetricUrl(pageSize));
+    if (!response.ok) {
+        throw new UkSourceApiError('ukhsa-dashboard', `HTTP ${response.status} reading metric points`);
+    }
+    return parseUkhsaMetricPoints(await response.json());
+}
+/** UK Health Security Agency data dashboard metric points, keyless. */
+export const ukhsaDashboardAdapter = {
+    id: UKHSA_DASHBOARD_SOURCE_ID,
+    name: 'UK Health Security Agency data dashboard',
+    auth: 'none',
+    description: 'New HIV diagnoses in England, as annual counts from the UKHSA dashboard.',
+    fetchLive: (options) => fetchUkhsaMetricPoints(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    parse: parseUkhsaMetricPoints,
+    loadFixture: () => parseUkhsaMetricPoints(readFixtureJson('ukhsa-dashboard-2026-10-05.json')),
+};
+//# sourceMappingURL=ukhsaDashboard.js.map

package/dist/ukhsaDashboard.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uk-open-data-connectors/uk-sources",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",
@@ -31,7 +31,7 @@
   "devDependencies": {
     "@uk-open-data-connectors/config-eslint": "*",
     "@uk-open-data-connectors/config-typescript": "*",
-    "@types/node": "22.20.4",
+    "@types/node": "22.20.5",
     "eslint": "9.39.5",
     "typescript": "6.0.3",
     "vitest": "3.2.7"
@@ -42,5 +42,13 @@
   "publishConfig": {
     "access": "public"
   },
-  "description": "Uniform TypeScript adapters for UK public data sources"
+  "description": "Uniform TypeScript adapters for UK public data sources",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/olitreadwell/uk-open-data-connectors.git"
+  },
+  "homepage": "https://github.com/olitreadwell/uk-open-data-connectors#readme",
+  "bugs": {
+    "url": "https://github.com/olitreadwell/uk-open-data-connectors/issues"
+  }
 }