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

package/dist/londonDatastore.js

@@ -0,0 +1,64 @@
+import { z } from 'zod';
+import { UkSourceParseError } from './errors.js';
+import { httpGet } from './http.js';
+import { readFixtureJson } from './fixtures.js';
+/**
+ * The London Datastore, the Greater London Authority's open data catalogue,
+ * served by CKAN. Keyless, published under the Open Government Licence v3.
+ */
+export const LONDON_DATASTORE_SOURCE_ID = 'london-datastore';
+/**
+ * The CKAN package_list call. The service answers a 307 redirect from this
+ * path to /api/action/package_list, which fetch follows on its own.
+ */
+export const LONDON_DATASTORE_PACKAGE_LIST_URL = 'https://data.london.gov.uk/api/3/action/package_list';
+const LONDON_DATASTORE_PACKAGE_LIST_SCHEMA = z.object({
+    success: z.boolean(),
+    result: z.array(z.string()),
+});
+/**
+ * Parses a London Datastore 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 parseLondonDatastorePackages(payload) {
+    const parsed = LONDON_DATASTORE_PACKAGE_LIST_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UkSourceParseError('london-datastore', parsed.error.message);
+    }
+    return parsed.data.result.map((name) => ({ name }));
+}
+/**
+ * Counts the London Datastore catalogue.
+ *
+ * @param packages - package names from {@link parseLondonDatastorePackages}
+ * @returns the number of datasets listed
+ */
+export function summarizeLondonDatastorePackages(packages) {
+    return { packageCount: packages.length };
+}
+/**
+ * Lists every dataset in the London Datastore catalogue.
+ *
+ * @param options - an optional fetch implementation
+ * @returns the package names the catalogue returns
+ */
+export async function fetchLondonDatastorePackages(options = {}) {
+    const { fetchImpl = globalThis.fetch } = options;
+    const response = await httpGet('london-datastore', LONDON_DATASTORE_PACKAGE_LIST_URL, {
+        fetchImpl,
+    });
+    return parseLondonDatastorePackages(await response.json());
+}
+/** London Datastore catalogue, keyless. */
+export const londonDatastoreAdapter = {
+    id: LONDON_DATASTORE_SOURCE_ID,
+    name: 'London Datastore dataset catalogue',
+    auth: 'none',
+    description: 'Every dataset the Greater London Authority lists on the London Datastore.',
+    fetchLive: (options) => fetchLondonDatastorePackages(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    parse: parseLondonDatastorePackages,
+    loadFixture: () => parseLondonDatastorePackages(readFixtureJson('london-datastore-2026-10-05.json')),
+};
+//# sourceMappingURL=londonDatastore.js.map

package/dist/londonDatastore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"londonDatastore.js","sourceRoot":"","sources":["../src/londonDatastore.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,0BAA0B,GAAG,kBAAkB,CAAC;AAE7D;;;GAGG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAC5C,sDAAsD,CAAC;AAazD,MAAM,oCAAoC,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,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,4BAA4B,CAAC,OAAgB;IAC3D,MAAM,MAAM,GAAG,oCAAoC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACvE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,kBAAkB,CAAC,kBAAkB,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACzE,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,gCAAgC,CAC9C,QAAkC;IAElC,OAAO,EAAE,YAAY,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;AAC3C,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,UAAmD,EAAE;IAErD,MAAM,EAAE,SAAS,GAAG,UAAU,CAAC,KAAK,EAAE,GAAG,OAAO,CAAC;IACjD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,kBAAkB,EAAE,iCAAiC,EAAE;QACpF,SAAS;KACV,CAAC,CAAC;IACH,OAAO,4BAA4B,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,2CAA2C;AAC3C,MAAM,CAAC,MAAM,sBAAsB,GAA4C;IAC7E,EAAE,EAAE,0BAA0B;IAC9B,IAAI,EAAE,oCAAoC;IAC1C,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,2EAA2E;IACxF,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE,CACrB,4BAA4B,CAC1B,OAAO,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CACzE;IACH,KAAK,EAAE,4BAA4B;IACnC,WAAW,EAAE,GAAG,EAAE,CAChB,4BAA4B,CAAC,eAAe,CAAC,kCAAkC,CAAC,CAAC;CACpF,CAAC"}

package/dist/nesoGenerationMix.d.ts

@@ -0,0 +1,128 @@
+import type { UkDataAdapter } from './types.js';
+/**
+ * Half-hourly Great Britain generation by fuel, from the National Energy
+ * System Operator's open data portal. Keyless: the CKAN datastore search
+ * answers without a key, and the portal publishes under the NESO Open Data
+ * Licence.
+ *
+ * The portal moved house. The dataset was first published at
+ * <https://data.nationalgrideso.com/>, which no longer resolves now the GB
+ * system operator trades as NESO. The same datasets are served from
+ * <https://api.neso.energy/>, which is what this adapter reads.
+ */
+export declare const NESO_GENERATION_MIX_SOURCE_ID = "neso-generation-mix";
+/** The portal's CKAN API root. */
+export declare const NESO_DATA_PORTAL_API_BASE_URL = "https://api.neso.energy";
+/** The datastore search call every read of the portal is built from. */
+export declare const NESO_DATASTORE_SEARCH_URL = "https://api.neso.energy/api/3/action/datastore_search";
+/** The "Historic GB Generation Mix" resource: one row per half hour since 2009. */
+export declare const NESO_GENERATION_MIX_RESOURCE_ID = "f93d1835-75bc-43e5-84ad-12472b180a98";
+/** Half hours in the default window: seven whole days. */
+export declare const DEFAULT_NESO_GENERATION_MIX_HALF_HOURS = 336;
+/**
+ * The most half hours one read asks for. The datastore will answer with more,
+ * but a window past ten weeks stops being the recent picture the summary is
+ * for, and the whole window is held in memory to be rolled up.
+ */
+export declare const MAX_NESO_GENERATION_MIX_HALF_HOURS = 3360;
+/**
+ * Every fuel the resource reports, in the order the portal lists the columns.
+ * `WIND_EMB` is embedded wind: turbines on the distribution networks, counted
+ * separately from the transmission-connected `WIND`.
+ */
+export declare const NESO_GENERATION_FUELS: readonly ["GAS", "COAL", "NUCLEAR", "WIND", "WIND_EMB", "HYDRO", "IMPORTS", "BIOMASS", "OTHER", "SOLAR", "STORAGE"];
+/** One of the fuel columns the resource carries. */
+export type NesoGenerationFuel = (typeof NESO_GENERATION_FUELS)[number];
+/** One fuel's reading for one half hour. */
+export interface NesoGenerationFuelReading {
+    fuel: NesoGenerationFuel;
+    /** The portal's own number for that fuel over the half hour, in megawatts. */
+    megawatts: number;
+}
+/** One half hour of the series, with the row the portal holds for it. */
+export interface NesoGenerationHalfHour {
+    /** Start of the half hour, as the portal writes it: `2026-10-17T16:00:00`. */
+    datetime: string;
+    /** What the portal says the half hour generated in total, in megawatts. */
+    totalMegawatts: number;
+    /** The half hour's carbon intensity, in grams of CO2 per kilowatt hour. */
+    carbonIntensity: number;
+    /** The half hour's low-carbon output, as the portal counts it, in megawatts. */
+    lowCarbonMegawatts: number;
+    /** Output per fuel, in the order of {@link NESO_GENERATION_FUELS}. */
+    fuels: NesoGenerationFuelReading[];
+}
+/** One fuel rolled up across the window. */
+export interface NesoGenerationFuelShare {
+    fuel: NesoGenerationFuel;
+    /** Mean output over the window, in megawatts, rounded to a whole number. */
+    averageMegawatts: number;
+    /** The most the fuel reached in any half hour of the window. */
+    peakMegawatts: number;
+    /** Its share of the window's total generation, to one decimal place. */
+    sharePercent: number;
+}
+/** A window of half hours, rolled up into the numbers a page prints. */
+export interface NesoGenerationMixWindow {
+    /** Half hours the window holds. */
+    halfHourCount: number;
+    /** Start of the oldest half hour in the window. */
+    firstHalfHourAt: string;
+    /** Start of the newest half hour in the window. */
+    lastHalfHourAt: string;
+    /** Mean total generation over the window, in megawatts. */
+    averageTotalMegawatts: number;
+    /** Mean carbon intensity over the window, in gCO2/kWh. */
+    averageCarbonIntensity: number;
+    /** Share of the window's generation the portal counts as low carbon. */
+    lowCarbonSharePercent: number;
+    /** Mean output per fuel, largest first. */
+    fuelShares: NesoGenerationFuelShare[];
+    /** The half hour with the lowest carbon intensity. */
+    cleanestHalfHour: NesoGenerationHalfHour;
+    /** The half hour with the highest carbon intensity. */
+    dirtiestHalfHour: NesoGenerationHalfHour;
+    /** Every half hour in the window, oldest first. */
+    halfHours: NesoGenerationHalfHour[];
+}
+/**
+ * Builds the URL for one window of half hours.
+ *
+ * The datastore answers newest first, which is the order a page wants when it
+ * is showing the last few days, and the parse puts the window back in time
+ * order before rolling it up.
+ *
+ * @param options - how many half hours to ask for, and which resource
+ * @returns the datastore search URL, with its query already encoded
+ */
+export declare function buildNesoGenerationMixUrl(options?: {
+    halfHours?: number;
+    resourceId?: string;
+}): string;
+/**
+ * Parses a datastore response into the readings the page draws.
+ *
+ * Every check here is one the page would otherwise show as a wrong number: a
+ * datetime that is not on a half-hour boundary, two rows for the same half
+ * hour, a fuel or total that is missing, or a row where the portal's own
+ * generation figure is not a positive number. Anything that fails throws
+ * rather than quietly joining the totals.
+ *
+ * @param payload - the datastore response, or the committed fixture of one
+ * @returns every half hour in the window, oldest first, with its totals
+ */
+export declare function parseNesoGenerationMix(payload: unknown): NesoGenerationMixWindow;
+/**
+ * Reads the most recent half hours of Great Britain's generation mix.
+ *
+ * @param options - how many half hours to ask for, and an optional fetch implementation
+ * @returns every half hour in the read window, oldest first, with its totals
+ */
+export declare function fetchNesoGenerationMixWindow(options?: {
+    halfHours?: number;
+    resourceId?: string;
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<NesoGenerationMixWindow>;
+/** National Energy System Operator generation mix, half-hourly and keyless. */
+export declare const nesoGenerationMixAdapter: UkDataAdapter<NesoGenerationMixWindow>;
+//# sourceMappingURL=nesoGenerationMix.d.ts.map

package/dist/nesoGenerationMix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nesoGenerationMix.d.ts","sourceRoot":"","sources":["../src/nesoGenerationMix.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,6BAA6B,wBAAwB,CAAC;AAEnE,kCAAkC;AAClC,eAAO,MAAM,6BAA6B,4BAA4B,CAAC;AAEvE,wEAAwE;AACxE,eAAO,MAAM,yBAAyB,0DAAmE,CAAC;AAE1G,mFAAmF;AACnF,eAAO,MAAM,+BAA+B,yCAAyC,CAAC;AAEtF,0DAA0D;AAC1D,eAAO,MAAM,sCAAsC,MAAM,CAAC;AAE1D;;;;GAIG;AACH,eAAO,MAAM,kCAAkC,OAAO,CAAC;AAEvD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,qHAYxB,CAAC;AAEX,oDAAoD;AACpD,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE,4CAA4C;AAC5C,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,kBAAkB,CAAC;IACzB,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,yEAAyE;AACzE,MAAM,WAAW,sBAAsB;IACrC,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,cAAc,EAAE,MAAM,CAAC;IACvB,2EAA2E;IAC3E,eAAe,EAAE,MAAM,CAAC;IACxB,gFAAgF;IAChF,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sEAAsE;IACtE,KAAK,EAAE,yBAAyB,EAAE,CAAC;CACpC;AAED,4CAA4C;AAC5C,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,kBAAkB,CAAC;IACzB,4EAA4E;IAC5E,gBAAgB,EAAE,MAAM,CAAC;IACzB,gEAAgE;IAChE,aAAa,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wEAAwE;AACxE,MAAM,WAAW,uBAAuB;IACtC,mCAAmC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,eAAe,EAAE,MAAM,CAAC;IACxB,mDAAmD;IACnD,cAAc,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,qBAAqB,EAAE,MAAM,CAAC;IAC9B,0DAA0D;IAC1D,sBAAsB,EAAE,MAAM,CAAC;IAC/B,wEAAwE;IACxE,qBAAqB,EAAE,MAAM,CAAC;IAC9B,2CAA2C;IAC3C,UAAU,EAAE,uBAAuB,EAAE,CAAC;IACtC,sDAAsD;IACtD,gBAAgB,EAAE,sBAAsB,CAAC;IACzC,uDAAuD;IACvD,gBAAgB,EAAE,sBAAsB,CAAC;IACzC,mDAAmD;IACnD,SAAS,EAAE,sBAAsB,EAAE,CAAC;CACrC;AA0CD;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GACxD,MAAM,CAqBR;AA8DD;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,uBAAuB,CAqEhF;AAED;;;;;GAKG;AACH,wBAAsB,4BAA4B,CAChD,OAAO,GAAE;IACP,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CAChC,GACL,OAAO,CAAC,uBAAuB,CAAC,CASlC;AAED,+EAA+E;AAC/E,eAAO,MAAM,wBAAwB,EAAE,aAAa,CAAC,uBAAuB,CAY3E,CAAC"}

package/dist/nesoGenerationMix.js

@@ -0,0 +1,241 @@
+import { z } from 'zod';
+import { UkSourceParseError } from './errors.js';
+import { readFixtureJson } from './fixtures.js';
+import { httpGet } from './http.js';
+/**
+ * Half-hourly Great Britain generation by fuel, from the National Energy
+ * System Operator's open data portal. Keyless: the CKAN datastore search
+ * answers without a key, and the portal publishes under the NESO Open Data
+ * Licence.
+ *
+ * The portal moved house. The dataset was first published at
+ * <https://data.nationalgrideso.com/>, which no longer resolves now the GB
+ * system operator trades as NESO. The same datasets are served from
+ * <https://api.neso.energy/>, which is what this adapter reads.
+ */
+export const NESO_GENERATION_MIX_SOURCE_ID = 'neso-generation-mix';
+/** The portal's CKAN API root. */
+export const NESO_DATA_PORTAL_API_BASE_URL = 'https://api.neso.energy';
+/** The datastore search call every read of the portal is built from. */
+export const NESO_DATASTORE_SEARCH_URL = `${NESO_DATA_PORTAL_API_BASE_URL}/api/3/action/datastore_search`;
+/** The "Historic GB Generation Mix" resource: one row per half hour since 2009. */
+export const NESO_GENERATION_MIX_RESOURCE_ID = 'f93d1835-75bc-43e5-84ad-12472b180a98';
+/** Half hours in the default window: seven whole days. */
+export const DEFAULT_NESO_GENERATION_MIX_HALF_HOURS = 336;
+/**
+ * The most half hours one read asks for. The datastore will answer with more,
+ * but a window past ten weeks stops being the recent picture the summary is
+ * for, and the whole window is held in memory to be rolled up.
+ */
+export const MAX_NESO_GENERATION_MIX_HALF_HOURS = 3360;
+/**
+ * Every fuel the resource reports, in the order the portal lists the columns.
+ * `WIND_EMB` is embedded wind: turbines on the distribution networks, counted
+ * separately from the transmission-connected `WIND`.
+ */
+export const NESO_GENERATION_FUELS = [
+    'GAS',
+    'COAL',
+    'NUCLEAR',
+    'WIND',
+    'WIND_EMB',
+    'HYDRO',
+    'IMPORTS',
+    'BIOMASS',
+    'OTHER',
+    'SOLAR',
+    'STORAGE',
+];
+// One line per fuel column the resource carries, spelled out rather than
+// built from NESO_GENERATION_FUELS, so the parsed record is typed with those
+// keys and a renamed or missing column fails at the schema.
+const NESO_GENERATION_MIX_RESPONSE_SCHEMA = z.object({
+    success: z.boolean(),
+    result: z.object({
+        total: z.number(),
+        records: z.array(z.object({
+            DATETIME: z.string(),
+            GENERATION: z.number(),
+            CARBON_INTENSITY: z.number(),
+            LOW_CARBON: z.number(),
+            GAS: z.number(),
+            COAL: z.number(),
+            NUCLEAR: z.number(),
+            WIND: z.number(),
+            WIND_EMB: z.number(),
+            HYDRO: z.number(),
+            IMPORTS: z.number(),
+            BIOMASS: z.number(),
+            OTHER: z.number(),
+            SOLAR: z.number(),
+            STORAGE: z.number(),
+        })),
+    }),
+});
+/** The portal writes datetimes to the minute, at the start of a half hour. */
+const NESO_DATETIME_PATTERN = /^\d{4}-\d{2}-\d{2}T\d{2}:(00|30):00$/;
+/** Milliseconds in a half hour, for checking one reading runs to the next. */
+const MILLISECONDS_PER_HALF_HOUR = 30 * 60 * 1000;
+/** Rounds a share to one decimal place. */
+function toSharePercent(part, whole) {
+    return Math.round((part / whole) * 1000) / 10;
+}
+/**
+ * Builds the URL for one window of half hours.
+ *
+ * The datastore answers newest first, which is the order a page wants when it
+ * is showing the last few days, and the parse puts the window back in time
+ * order before rolling it up.
+ *
+ * @param options - how many half hours to ask for, and which resource
+ * @returns the datastore search URL, with its query already encoded
+ */
+export function buildNesoGenerationMixUrl(options = {}) {
+    const halfHours = options.halfHours ?? DEFAULT_NESO_GENERATION_MIX_HALF_HOURS;
+    if (!Number.isInteger(halfHours) || halfHours < 1) {
+        throw new UkSourceParseError(NESO_GENERATION_MIX_SOURCE_ID, `a window of ${String(halfHours)} half hours is not a whole number of half hours`);
+    }
+    if (halfHours > MAX_NESO_GENERATION_MIX_HALF_HOURS) {
+        throw new UkSourceParseError(NESO_GENERATION_MIX_SOURCE_ID, `this adapter reads at most ${String(MAX_NESO_GENERATION_MIX_HALF_HOURS)} half hours at a time`);
+    }
+    const resourceId = options.resourceId ?? NESO_GENERATION_MIX_RESOURCE_ID;
+    const query = new URLSearchParams({
+        resource_id: resourceId,
+        sort: 'DATETIME desc',
+        limit: String(halfHours),
+    });
+    return `${NESO_DATASTORE_SEARCH_URL}?${query.toString()}`;
+}
+/** Rolls a window of half hours up into the numbers the page prints. */
+function summarizeNesoGenerationMix(halfHours) {
+    const firstHalfHour = halfHours[0];
+    const lastHalfHour = halfHours.at(-1);
+    if (firstHalfHour === undefined || lastHalfHour === undefined) {
+        throw new UkSourceParseError(NESO_GENERATION_MIX_SOURCE_ID, 'the window holds no half hours');
+    }
+    let totalMegawatts = 0;
+    let carbonIntensityTotal = 0;
+    let lowCarbonMegawatts = 0;
+    const megawattsByFuel = new Map(NESO_GENERATION_FUELS.map((fuel) => [fuel, 0]));
+    const peakByFuel = new Map(NESO_GENERATION_FUELS.map((fuel) => [fuel, Number.NEGATIVE_INFINITY]));
+    for (const halfHour of halfHours) {
+        totalMegawatts += halfHour.totalMegawatts;
+        carbonIntensityTotal += halfHour.carbonIntensity;
+        lowCarbonMegawatts += halfHour.lowCarbonMegawatts;
+        for (const reading of halfHour.fuels) {
+            megawattsByFuel.set(reading.fuel, (megawattsByFuel.get(reading.fuel) ?? 0) + reading.megawatts);
+            peakByFuel.set(reading.fuel, Math.max(peakByFuel.get(reading.fuel) ?? 0, reading.megawatts));
+        }
+    }
+    const halfHourCount = halfHours.length;
+    const fuelShares = NESO_GENERATION_FUELS.map((fuel) => ({
+        fuel,
+        averageMegawatts: Math.round((megawattsByFuel.get(fuel) ?? 0) / halfHourCount),
+        peakMegawatts: peakByFuel.get(fuel) ?? 0,
+        sharePercent: toSharePercent(megawattsByFuel.get(fuel) ?? 0, totalMegawatts),
+    })).sort((left, right) => right.averageMegawatts - left.averageMegawatts);
+    const cleanestHalfHour = halfHours.reduce((cleanest, halfHour) => halfHour.carbonIntensity < cleanest.carbonIntensity ? halfHour : cleanest);
+    const dirtiestHalfHour = halfHours.reduce((dirtiest, halfHour) => halfHour.carbonIntensity > dirtiest.carbonIntensity ? halfHour : dirtiest);
+    return {
+        halfHourCount,
+        firstHalfHourAt: firstHalfHour.datetime,
+        lastHalfHourAt: lastHalfHour.datetime,
+        averageTotalMegawatts: Math.round(totalMegawatts / halfHourCount),
+        averageCarbonIntensity: Math.round(carbonIntensityTotal / halfHourCount),
+        lowCarbonSharePercent: toSharePercent(lowCarbonMegawatts, totalMegawatts),
+        fuelShares,
+        cleanestHalfHour,
+        dirtiestHalfHour,
+        halfHours,
+    };
+}
+/**
+ * Parses a datastore response into the readings the page draws.
+ *
+ * Every check here is one the page would otherwise show as a wrong number: a
+ * datetime that is not on a half-hour boundary, two rows for the same half
+ * hour, a fuel or total that is missing, or a row where the portal's own
+ * generation figure is not a positive number. Anything that fails throws
+ * rather than quietly joining the totals.
+ *
+ * @param payload - the datastore response, or the committed fixture of one
+ * @returns every half hour in the window, oldest first, with its totals
+ */
+export function parseNesoGenerationMix(payload) {
+    const parsed = NESO_GENERATION_MIX_RESPONSE_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UkSourceParseError(NESO_GENERATION_MIX_SOURCE_ID, parsed.error.message);
+    }
+    if (!parsed.data.success) {
+        throw new UkSourceParseError(NESO_GENERATION_MIX_SOURCE_ID, 'the datastore reported a failure');
+    }
+    const records = parsed.data.result.records;
+    if (records.length === 0) {
+        throw new UkSourceParseError(NESO_GENERATION_MIX_SOURCE_ID, 'the window returned no half hours');
+    }
+    const seen = new Set();
+    const halfHours = records.map((record) => {
+        if (!NESO_DATETIME_PATTERN.test(record.DATETIME)) {
+            throw new UkSourceParseError(NESO_GENERATION_MIX_SOURCE_ID, `expected a half hour as YYYY-MM-DDThh:mm:00, got ${JSON.stringify(record.DATETIME)}`);
+        }
+        if (seen.has(record.DATETIME)) {
+            throw new UkSourceParseError(NESO_GENERATION_MIX_SOURCE_ID, `two rows for the half hour starting ${record.DATETIME}`);
+        }
+        seen.add(record.DATETIME);
+        if (record.GENERATION <= 0) {
+            throw new UkSourceParseError(NESO_GENERATION_MIX_SOURCE_ID, `the half hour starting ${record.DATETIME} generated ${String(record.GENERATION)} MW`);
+        }
+        if (record.CARBON_INTENSITY <= 0) {
+            throw new UkSourceParseError(NESO_GENERATION_MIX_SOURCE_ID, `the half hour starting ${record.DATETIME} carries no carbon intensity`);
+        }
+        return {
+            datetime: record.DATETIME,
+            totalMegawatts: record.GENERATION,
+            carbonIntensity: record.CARBON_INTENSITY,
+            lowCarbonMegawatts: record.LOW_CARBON,
+            fuels: NESO_GENERATION_FUELS.map((fuel) => ({ fuel, megawatts: record[fuel] })),
+        };
+    });
+    halfHours.sort((left, right) => left.datetime.localeCompare(right.datetime));
+    for (let index = 1; index < halfHours.length; index += 1) {
+        const previous = halfHours[index - 1];
+        const current = halfHours[index];
+        if (previous === undefined || current === undefined) {
+            continue;
+        }
+        const gap = Date.parse(current.datetime) - Date.parse(previous.datetime);
+        if (gap !== MILLISECONDS_PER_HALF_HOUR) {
+            throw new UkSourceParseError(NESO_GENERATION_MIX_SOURCE_ID, `the readings jump from ${previous.datetime} to ${current.datetime}`);
+        }
+    }
+    return summarizeNesoGenerationMix(halfHours);
+}
+/**
+ * Reads the most recent half hours of Great Britain's generation mix.
+ *
+ * @param options - how many half hours to ask for, and an optional fetch implementation
+ * @returns every half hour in the read window, oldest first, with its totals
+ */
+export async function fetchNesoGenerationMixWindow(options = {}) {
+    const url = buildNesoGenerationMixUrl({
+        ...(options.halfHours === undefined ? {} : { halfHours: options.halfHours }),
+        ...(options.resourceId === undefined ? {} : { resourceId: options.resourceId }),
+    });
+    const response = await httpGet(NESO_GENERATION_MIX_SOURCE_ID, url, {
+        ...(options.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    });
+    return parseNesoGenerationMix(await response.json());
+}
+/** National Energy System Operator generation mix, half-hourly and keyless. */
+export const nesoGenerationMixAdapter = {
+    id: NESO_GENERATION_MIX_SOURCE_ID,
+    name: 'National Energy System Operator generation mix',
+    auth: 'none',
+    description: 'Half-hourly Great Britain generation by fuel, with the cleanest and dirtiest half hours in the window.',
+    fetchLive: (options) => fetchNesoGenerationMixWindow({
+        ...(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    }),
+    parse: parseNesoGenerationMix,
+    loadFixture: () => parseNesoGenerationMix(readFixtureJson('neso-generation-mix-2026-10-18.json')),
+};
+//# sourceMappingURL=nesoGenerationMix.js.map

package/dist/nesoGenerationMix.js.map

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

package/dist/nhsbsaCkan.d.ts

@@ -0,0 +1,43 @@
+import type { UkDataAdapter } from './types.js';
+/**
+ * The NHS Business Services Authority open data portal, served by CKAN.
+ * Keyless, published under the Open Government Licence v3.
+ */
+export declare const NHSBSA_CKAN_SOURCE_ID = "nhsbsa-ckan";
+/** The CKAN package_list call on the NHSBSA portal. */
+export declare const NHSBSA_CKAN_PACKAGE_LIST_URL = "https://opendata.nhsbsa.net/api/3/action/package_list";
+/** One dataset in the NHSBSA catalogue. */
+export interface NhsbsaDataset {
+    /** CKAN package name, the identifier used in every other CKAN call. */
+    name: string;
+}
+/** Rolled-up view of the NHSBSA catalogue. */
+export interface NhsbsaCkanSummary {
+    packageCount: number;
+}
+/**
+ * Parses an NHSBSA package_list payload.
+ *
+ * @param payload - the raw JSON body from the CKAN package_list call
+ * @returns one entry per dataset in the catalogue
+ */
+export declare function parseNhsbsaCkanPackages(payload: unknown): NhsbsaDataset[];
+/**
+ * Counts the NHSBSA catalogue.
+ *
+ * @param datasets - dataset names from {@link parseNhsbsaCkanPackages}
+ * @returns the number of datasets listed
+ */
+export declare function summarizeNhsbsaCkanPackages(datasets: NhsbsaDataset[]): NhsbsaCkanSummary;
+/**
+ * Lists every dataset in the NHSBSA catalogue.
+ *
+ * @param options - an optional fetch implementation
+ * @returns the package names the catalogue returns
+ */
+export declare function fetchNhsbsaCkanPackages(options?: {
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<NhsbsaDataset[]>;
+/** NHS Business Services Authority open data catalogue, keyless. */
+export declare const nhsbsaCkanAdapter: UkDataAdapter<NhsbsaDataset[]>;
+//# sourceMappingURL=nhsbsaCkan.d.ts.map

package/dist/nhsbsaCkan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nhsbsaCkan.d.ts","sourceRoot":"","sources":["../src/nhsbsaCkan.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,gBAAgB,CAAC;AAEnD,uDAAuD;AACvD,eAAO,MAAM,4BAA4B,0DAA0D,CAAC;AAEpG,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;CACd;AAED,8CAA8C;AAC9C,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAC;CACtB;AAOD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,EAAE,CAMzE;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,iBAAiB,CAExF;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAAO,GACpD,OAAO,CAAC,aAAa,EAAE,CAAC,CAI1B;AAED,oEAAoE;AACpE,eAAO,MAAM,iBAAiB,EAAE,aAAa,CAAC,aAAa,EAAE,CAW5D,CAAC"}

package/dist/nhsbsaCkan.js

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+import { UkSourceParseError } from './errors.js';
+import { httpGet } from './http.js';
+import { readFixtureJson } from './fixtures.js';
+/**
+ * The NHS Business Services Authority open data portal, served by CKAN.
+ * Keyless, published under the Open Government Licence v3.
+ */
+export const NHSBSA_CKAN_SOURCE_ID = 'nhsbsa-ckan';
+/** The CKAN package_list call on the NHSBSA portal. */
+export const NHSBSA_CKAN_PACKAGE_LIST_URL = 'https://opendata.nhsbsa.net/api/3/action/package_list';
+const NHSBSA_CKAN_PACKAGE_LIST_SCHEMA = z.object({
+    success: z.boolean(),
+    result: z.array(z.string()),
+});
+/**
+ * Parses an NHSBSA 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 parseNhsbsaCkanPackages(payload) {
+    const parsed = NHSBSA_CKAN_PACKAGE_LIST_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UkSourceParseError('nhsbsa-ckan', parsed.error.message);
+    }
+    return parsed.data.result.map((name) => ({ name }));
+}
+/**
+ * Counts the NHSBSA catalogue.
+ *
+ * @param datasets - dataset names from {@link parseNhsbsaCkanPackages}
+ * @returns the number of datasets listed
+ */
+export function summarizeNhsbsaCkanPackages(datasets) {
+    return { packageCount: datasets.length };
+}
+/**
+ * Lists every dataset in the NHSBSA catalogue.
+ *
+ * @param options - an optional fetch implementation
+ * @returns the package names the catalogue returns
+ */
+export async function fetchNhsbsaCkanPackages(options = {}) {
+    const { fetchImpl = globalThis.fetch } = options;
+    const response = await httpGet('nhsbsa-ckan', NHSBSA_CKAN_PACKAGE_LIST_URL, { fetchImpl });
+    return parseNhsbsaCkanPackages(await response.json());
+}
+/** NHS Business Services Authority open data catalogue, keyless. */
+export const nhsbsaCkanAdapter = {
+    id: NHSBSA_CKAN_SOURCE_ID,
+    name: 'NHS Business Services Authority open data catalogue',
+    auth: 'none',
+    description: 'Every dataset the NHS Business Services Authority publishes on its CKAN portal.',
+    fetchLive: (options) => fetchNhsbsaCkanPackages(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    parse: parseNhsbsaCkanPackages,
+    loadFixture: () => parseNhsbsaCkanPackages(readFixtureJson('nhsbsa-ckan-2026-10-05.json')),
+};
+//# sourceMappingURL=nhsbsaCkan.js.map

package/dist/nhsbsaCkan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nhsbsaCkan.js","sourceRoot":"","sources":["../src/nhsbsaCkan.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,qBAAqB,GAAG,aAAa,CAAC;AAEnD,uDAAuD;AACvD,MAAM,CAAC,MAAM,4BAA4B,GAAG,uDAAuD,CAAC;AAapG,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,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,uBAAuB,CAAC,OAAgB;IACtD,MAAM,MAAM,GAAG,+BAA+B,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAClE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,kBAAkB,CAAC,aAAa,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACpE,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,2BAA2B,CAAC,QAAyB;IACnE,OAAO,EAAE,YAAY,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;AAC3C,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,UAAmD,EAAE;IAErD,MAAM,EAAE,SAAS,GAAG,UAAU,CAAC,KAAK,EAAE,GAAG,OAAO,CAAC;IACjD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,aAAa,EAAE,4BAA4B,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IAC3F,OAAO,uBAAuB,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AACxD,CAAC;AAED,oEAAoE;AACpE,MAAM,CAAC,MAAM,iBAAiB,GAAmC;IAC/D,EAAE,EAAE,qBAAqB;IACzB,IAAI,EAAE,qDAAqD;IAC3D,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,iFAAiF;IAC9F,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE,CACrB,uBAAuB,CACrB,OAAO,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CACzE;IACH,KAAK,EAAE,uBAAuB;IAC9B,WAAW,EAAE,GAAG,EAAE,CAAC,uBAAuB,CAAC,eAAe,CAAC,6BAA6B,CAAC,CAAC;CAC3F,CAAC"}

package/dist/nomis.d.ts

@@ -0,0 +1,71 @@
+import type { UkDataAdapter } from './types.js';
+/**
+ * Nomis, the Office for National Statistics' online labour-market database,
+ * run with the University of Durham. Keyless, published under the Open
+ * Government Licence v3.
+ */
+export declare const NOMIS_SOURCE_ID = "nomis";
+/**
+ * The SDMX dataset definitions catalogue. It carries one definition per
+ * dataset, with the dimensions and annotations behind it.
+ */
+export declare const NOMIS_DATASET_DEFINITIONS_URL = "https://www.nomisweb.co.uk/api/v01/dataset/def.sdmx.json";
+/** Annotation titles this adapter reads out of each dataset definition. */
+export declare const NOMIS_STATUS_ANNOTATION = "Status";
+export declare const NOMIS_KEYWORDS_ANNOTATION = "Keywords";
+export declare const NOMIS_UNITS_ANNOTATION = "Units";
+export declare const NOMIS_LAST_UPDATED_ANNOTATION = "LastUpdated";
+/** One dataset definition from the Nomis SDMX catalogue. */
+export interface NomisDatasetDefinition {
+    /** Nomis dataset id, such as NM_1_1. */
+    id: string;
+    name: string;
+    agencyId: string;
+    version: number;
+    /** The API's own URI slug for the dataset. */
+    uri: string;
+    /** Maintenance status, such as "Current (being actively updated)". */
+    status: string;
+    /** Comma-separated keywords the catalogue tags the dataset with. */
+    keywords: string;
+    /** The units the dataset counts in, or "" when the catalogue leaves them out. */
+    units: string;
+    /** The catalogue's own last-updated stamp, or "" when it leaves it out. */
+    lastUpdated: string;
+}
+/** Dataset definitions counted by their catalogue status. */
+export interface NomisStatusCount {
+    status: string;
+    datasetCount: number;
+}
+/** Rolled-up view of the Nomis dataset catalogue. */
+export interface NomisCatalogSummary {
+    datasetCount: number;
+    statusCounts: NomisStatusCount[];
+}
+/**
+ * Parses a Nomis SDMX dataset definitions payload.
+ *
+ * @param payload - the raw JSON body from the definitions catalogue
+ * @returns one definition per dataset the catalogue lists
+ */
+export declare function parseNomisDatasetDefinitions(payload: unknown): NomisDatasetDefinition[];
+/**
+ * Counts the catalogue by dataset status.
+ *
+ * @param definitions - definitions from {@link parseNomisDatasetDefinitions}
+ * @returns the dataset count and a per-status breakdown, most datasets first
+ */
+export declare function summarizeNomisDatasetDefinitions(definitions: NomisDatasetDefinition[]): NomisCatalogSummary;
+/**
+ * Lists every dataset definition in the Nomis SDMX catalogue.
+ *
+ * @param options - an optional fetch implementation
+ * @returns the definitions the catalogue returns
+ */
+export declare function fetchNomisDatasetDefinitions(options?: {
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<NomisDatasetDefinition[]>;
+/** Nomis SDMX dataset definitions, keyless. */
+export declare const nomisAdapter: UkDataAdapter<NomisDatasetDefinition[]>;
+//# sourceMappingURL=nomis.d.ts.map

package/dist/nomis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nomis.d.ts","sourceRoot":"","sources":["../src/nomis.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,eAAe,UAAU,CAAC;AAEvC;;;GAGG;AACH,eAAO,MAAM,6BAA6B,6DACkB,CAAC;AAE7D,2EAA2E;AAC3E,eAAO,MAAM,uBAAuB,WAAW,CAAC;AAChD,eAAO,MAAM,yBAAyB,aAAa,CAAC;AACpD,eAAO,MAAM,sBAAsB,UAAU,CAAC;AAC9C,eAAO,MAAM,6BAA6B,gBAAgB,CAAC;AAE3D,4DAA4D;AAC5D,MAAM,WAAW,sBAAsB;IACrC,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,6DAA6D;AAC7D,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,qDAAqD;AACrD,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,gBAAgB,EAAE,CAAC;CAClC;AAiDD;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,OAAO,GAAG,sBAAsB,EAAE,CAoBvF;AAED;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC9C,WAAW,EAAE,sBAAsB,EAAE,GACpC,mBAAmB,CAYrB;AAED;;;;;GAKG;AACH,wBAAsB,4BAA4B,CAChD,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAAO,GACpD,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAInC;AAED,+CAA+C;AAC/C,eAAO,MAAM,YAAY,EAAE,aAAa,CAAC,sBAAsB,EAAE,CAWhE,CAAC"}