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

package/dist/parliamentSeats.js

@@ -0,0 +1,202 @@
+import { z } from 'zod';
+import { UkSourceApiError, UkSourceParseError } from './errors.js';
+import { readFixtureJson } from './fixtures.js';
+/**
+ * The state of the parties in each house of the UK Parliament, from the
+ * Members API. The API answers without a key and Parliament publishes the
+ * data under the Open Parliament Licence v3.0:
+ * <https://www.parliament.uk/site-information/copyright-parliament/open-parliament-licence/>
+ */
+export const PARLIAMENT_SEATS_SOURCE_ID = 'parliament-seats';
+/** Root every call here is built from. */
+export const PARLIAMENT_MEMBERS_API_BASE_URL = 'https://members-api.parliament.uk/api';
+/** Path for the state of the parties in one house on one date. */
+export const PARLIAMENT_STATE_OF_PARTIES_PATH = 'Parties/StateOfTheParties';
+/**
+ * The house number the API uses for the Commons. The Swagger schema behind
+ * `House` carries exactly two values: 1 for the Commons, 2 for the Lords.
+ */
+export const PARLIAMENT_COMMONS_HOUSE = 1;
+/** The house number the API uses for the Lords. */
+export const PARLIAMENT_LORDS_HOUSE = 2;
+const PARLIAMENT_PARTY_SCHEMA = z.object({
+    id: z.number().int(),
+    name: z.string().nullable(),
+    abbreviation: z.string().nullable(),
+    backgroundColour: z.string().nullable(),
+    foregroundColour: z.string().nullable(),
+    isIndependentParty: z.boolean(),
+});
+const PARLIAMENT_SEAT_COUNT_SCHEMA = z.object({
+    male: z.number().int().nonnegative().nullable(),
+    female: z.number().int().nonnegative().nullable(),
+    nonBinary: z.number().int().nonnegative().nullable(),
+    total: z.number().int(),
+    party: PARLIAMENT_PARTY_SCHEMA.nullable(),
+});
+const PARLIAMENT_RESPONSE_SCHEMA = z.object({
+    items: z.array(z.object({ value: PARLIAMENT_SEAT_COUNT_SCHEMA.nullable() })).nullable(),
+});
+/**
+ * Formats a date as the `YYYY-MM-DD` the path takes, in UK local time.
+ *
+ * @param date - the instant to format
+ * @returns the date the API reads, for example `2026-10-01`
+ */
+export function formatParliamentQueryDate(date) {
+    return new Intl.DateTimeFormat('en-CA', {
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        timeZone: 'Europe/London',
+    }).format(date);
+}
+/**
+ * Builds the state-of-the-parties URL for one house and one date.
+ *
+ * @param house - 1 for the Commons, 2 for the Lords
+ * @param forDate - the date to ask for, as `YYYY-MM-DD`
+ * @returns the full URL
+ */
+export function buildParliamentSeatsUrl(house, forDate) {
+    return `${PARLIAMENT_MEMBERS_API_BASE_URL}/${PARLIAMENT_STATE_OF_PARTIES_PATH}/${String(house)}/${forDate}`;
+}
+/** Turns one API row into a party with its seats, or throws naming the row. */
+function readParliamentPartySeats(row) {
+    const party = row.party;
+    if (party === null) {
+        throw new UkSourceParseError(PARLIAMENT_SEATS_SOURCE_ID, 'a party row carried no party');
+    }
+    const name = (party.name ?? '').trim();
+    if (name === '') {
+        throw new UkSourceParseError(PARLIAMENT_SEATS_SOURCE_ID, 'a party row carried no name');
+    }
+    if (row.total <= 0) {
+        throw new UkSourceParseError(PARLIAMENT_SEATS_SOURCE_ID, `${name} holds ${String(row.total)} seats, which cannot be right`);
+    }
+    const maleCount = row.male ?? 0;
+    const femaleCount = row.female ?? 0;
+    const nonBinaryCount = row.nonBinary ?? 0;
+    const memberCount = maleCount + femaleCount + nonBinaryCount;
+    if (memberCount > row.total) {
+        throw new UkSourceParseError(PARLIAMENT_SEATS_SOURCE_ID, `${name} names ${String(memberCount)} members across ${String(row.total)} seats`);
+    }
+    return {
+        party: {
+            id: party.id,
+            name,
+            abbreviation: (party.abbreviation ?? '').trim(),
+            backgroundColour: party.backgroundColour,
+            foregroundColour: party.foregroundColour,
+            isIndependent: party.isIndependentParty,
+        },
+        seatCount: row.total,
+        maleCount,
+        femaleCount,
+        nonBinaryCount,
+        unallocatedSeatCount: row.total - memberCount,
+    };
+}
+/**
+ * Parses a state-of-the-parties payload into the seats each party holds.
+ *
+ * A row the API cannot explain fails the parse rather than quietly shifting
+ * the totals: a missing party, a blank name, a party with no seats, or the
+ * same party listed twice all throw.
+ *
+ * @param payload - the API response, or the committed fixture of one
+ * @returns one entry per party, in the order the API sent them
+ */
+export function parseParliamentPartySeats(payload) {
+    const parsed = PARLIAMENT_RESPONSE_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UkSourceParseError(PARLIAMENT_SEATS_SOURCE_ID, parsed.error.message);
+    }
+    const rows = parsed.data.items ?? [];
+    if (rows.length === 0) {
+        throw new UkSourceParseError(PARLIAMENT_SEATS_SOURCE_ID, 'the house returned no parties');
+    }
+    const seenPartyIds = new Set();
+    const seats = rows.map((row) => {
+        if (row.value === null) {
+            throw new UkSourceParseError(PARLIAMENT_SEATS_SOURCE_ID, 'a party row carried no seat count');
+        }
+        const entry = readParliamentPartySeats(row.value);
+        if (seenPartyIds.has(entry.party.id)) {
+            throw new UkSourceParseError(PARLIAMENT_SEATS_SOURCE_ID, `${entry.party.name} is listed more than once (party ${String(entry.party.id)})`);
+        }
+        seenPartyIds.add(entry.party.id);
+        return entry;
+    });
+    return seats;
+}
+/**
+ * Rolls a party list into the totals a page prints.
+ *
+ * @param seats - parties as parsed from the payload
+ * @returns the seat total, the party count, the majority line, and the ranking
+ */
+export function summarizeParliamentPartySeats(seats) {
+    if (seats.length === 0) {
+        throw new UkSourceParseError(PARLIAMENT_SEATS_SOURCE_ID, 'no parties to summarise');
+    }
+    const seatCount = seats.reduce((sum, entry) => sum + entry.seatCount, 0);
+    const ordered = [...seats].sort((left, right) => {
+        if (right.seatCount !== left.seatCount) {
+            return right.seatCount - left.seatCount;
+        }
+        return left.party.name.localeCompare(right.party.name);
+    });
+    const largestParty = ordered[0];
+    if (largestParty === undefined) {
+        throw new UkSourceParseError(PARLIAMENT_SEATS_SOURCE_ID, 'no parties to rank');
+    }
+    return {
+        seatCount,
+        partyCount: ordered.length,
+        majorityThreshold: Math.floor(seatCount / 2) + 1,
+        partiesWithOneSeat: ordered.filter((entry) => entry.seatCount === 1).length,
+        seats: ordered,
+        largestParty,
+    };
+}
+/**
+ * Parses a state-of-the-parties payload straight into the summary a page prints.
+ *
+ * @param payload - the API response, or the committed fixture of one
+ * @returns the seat total, the party count, the majority line, and the ranking
+ */
+export function parseParliamentSeats(payload) {
+    return summarizeParliamentPartySeats(parseParliamentPartySeats(payload));
+}
+/**
+ * Reads the state of the parties in one house, the Commons by default.
+ *
+ * The API needs a date as well as a house and answers with the composition on
+ * that date, so the caller's own date is the one asked for.
+ *
+ * @param options - the house, the date, and an optional fetch implementation
+ * @returns the seat total, the party count, the majority line, and the ranking
+ */
+export async function fetchParliamentSeats(options = {}) {
+    const house = options.house ?? PARLIAMENT_COMMONS_HOUSE;
+    const forDate = options.forDate ?? formatParliamentQueryDate(options.now ?? new Date());
+    const fetchImpl = options.fetchImpl ?? globalThis.fetch;
+    const url = buildParliamentSeatsUrl(house, forDate);
+    const response = await fetchImpl(url, { headers: { accept: 'application/json' } });
+    if (!response.ok) {
+        throw new UkSourceApiError(PARLIAMENT_SEATS_SOURCE_ID, `HTTP ${response.status} from ${url}`);
+    }
+    return parseParliamentSeats(await response.json());
+}
+/** UK Parliament state of the parties, keyless. */
+export const parliamentSeatsAdapter = {
+    id: PARLIAMENT_SEATS_SOURCE_ID,
+    name: 'UK Parliament state of the parties',
+    auth: 'none',
+    description: 'Seats each party holds in the House of Commons, with the members counted behind them.',
+    fetchLive: (options) => fetchParliamentSeats(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    parse: parseParliamentSeats,
+    loadFixture: () => parseParliamentSeats(readFixtureJson('parliament-seats.json')),
+};
+//# sourceMappingURL=parliamentSeats.js.map

package/dist/parliamentSeats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parliamentSeats.js","sourceRoot":"","sources":["../src/parliamentSeats.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;;;;;GAKG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,kBAAkB,CAAC;AAE7D,0CAA0C;AAC1C,MAAM,CAAC,MAAM,+BAA+B,GAAG,uCAAuC,CAAC;AAEvF,kEAAkE;AAClE,MAAM,CAAC,MAAM,gCAAgC,GAAG,2BAA2B,CAAC;AAE5E;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAE1C,mDAAmD;AACnD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AA4CxC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACvC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACvC,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE;CAChC,CAAC,CAAC;AAEH,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IAC/C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACjD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACpD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACvB,KAAK,EAAE,uBAAuB,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC;AAEH,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,4BAA4B,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;CACxF,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAAU;IAClD,OAAO,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;QACtC,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,SAAS;QAChB,GAAG,EAAE,SAAS;QACd,QAAQ,EAAE,eAAe;KAC1B,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAClB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAa,EAAE,OAAe;IACpE,OAAO,GAAG,+BAA+B,IAAI,gCAAgC,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;AAC9G,CAAC;AAED,+EAA+E;AAC/E,SAAS,wBAAwB,CAC/B,GAAiD;IAEjD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;IACxB,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,kBAAkB,CAAC,0BAA0B,EAAE,8BAA8B,CAAC,CAAC;IAC3F,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACvC,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;QAChB,MAAM,IAAI,kBAAkB,CAAC,0BAA0B,EAAE,6BAA6B,CAAC,CAAC;IAC1F,CAAC;IACD,IAAI,GAAG,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,kBAAkB,CAC1B,0BAA0B,EAC1B,GAAG,IAAI,UAAU,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,+BAA+B,CAClE,CAAC;IACJ,CAAC;IACD,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC;IAChC,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;IACpC,MAAM,cAAc,GAAG,GAAG,CAAC,SAAS,IAAI,CAAC,CAAC;IAC1C,MAAM,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,cAAc,CAAC;IAC7D,IAAI,WAAW,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC;QAC5B,MAAM,IAAI,kBAAkB,CAC1B,0BAA0B,EAC1B,GAAG,IAAI,UAAU,MAAM,CAAC,WAAW,CAAC,mBAAmB,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CACjF,CAAC;IACJ,CAAC;IACD,OAAO;QACL,KAAK,EAAE;YACL,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,IAAI;YACJ,YAAY,EAAE,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;YAC/C,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;YACxC,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;YACxC,aAAa,EAAE,KAAK,CAAC,kBAAkB;SACxC;QACD,SAAS,EAAE,GAAG,CAAC,KAAK;QACpB,SAAS;QACT,WAAW;QACX,cAAc;QACd,oBAAoB,EAAE,GAAG,CAAC,KAAK,GAAG,WAAW;KAC9C,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAgB;IACxD,MAAM,MAAM,GAAG,0BAA0B,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC7D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,kBAAkB,CAAC,0BAA0B,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACjF,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IACrC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,kBAAkB,CAAC,0BAA0B,EAAE,+BAA+B,CAAC,CAAC;IAC5F,CAAC;IACD,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QAC7B,IAAI,GAAG,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACvB,MAAM,IAAI,kBAAkB,CAAC,0BAA0B,EAAE,mCAAmC,CAAC,CAAC;QAChG,CAAC;QACD,MAAM,KAAK,GAAG,wBAAwB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAClD,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,kBAAkB,CAC1B,0BAA0B,EAC1B,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,oCAAoC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CACjF,CAAC;QACJ,CAAC;QACD,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACjC,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAC3C,KAA6B;IAE7B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,kBAAkB,CAAC,0BAA0B,EAAE,yBAAyB,CAAC,CAAC;IACtF,CAAC;IACD,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IACzE,MAAM,OAAO,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC9C,IAAI,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;YACvC,OAAO,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAC1C,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IACH,MAAM,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,IAAI,kBAAkB,CAAC,0BAA0B,EAAE,oBAAoB,CAAC,CAAC;IACjF,CAAC;IACD,OAAO;QACL,SAAS;QACT,UAAU,EAAE,OAAO,CAAC,MAAM;QAC1B,iBAAiB,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC;QAChD,kBAAkB,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,MAAM;QAC3E,KAAK,EAAE,OAAO;QACd,YAAY;KACb,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,OAAO,6BAA6B,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,UAKI,EAAE;IAEN,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,wBAAwB,CAAC;IACxD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,yBAAyB,CAAC,OAAO,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC;IACxF,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,UAAU,CAAC,KAAK,CAAC;IACxD,MAAM,GAAG,GAAG,uBAAuB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;IACnF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,gBAAgB,CAAC,0BAA0B,EAAE,QAAQ,QAAQ,CAAC,MAAM,SAAS,GAAG,EAAE,CAAC,CAAC;IAChG,CAAC;IACD,OAAO,oBAAoB,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AACrD,CAAC;AAED,mDAAmD;AACnD,MAAM,CAAC,MAAM,sBAAsB,GAAyC;IAC1E,EAAE,EAAE,0BAA0B;IAC9B,IAAI,EAAE,oCAAoC;IAC1C,IAAI,EAAE,MAAM;IACZ,WAAW,EACT,uFAAuF;IACzF,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE,CACrB,oBAAoB,CAAC,OAAO,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC;IAChG,KAAK,EAAE,oBAAoB;IAC3B,WAAW,EAAE,GAAG,EAAE,CAAC,oBAAoB,CAAC,eAAe,CAAC,uBAAuB,CAAC,CAAC;CAClF,CAAC"}

package/dist/planningDatasets.d.ts

@@ -0,0 +1,65 @@
+import type { UkDataAdapter } from './types.js';
+/**
+ * The Planning Data platform's dataset catalogue, published by the Ministry of
+ * Housing, Communities and Local Government. Keyless, and the same feed the
+ * platform's own datasets page reads:
+ * <https://www.planning.data.gov.uk/dataset>
+ */
+export declare const PLANNING_DATASETS_URL = "https://www.planning.data.gov.uk/dataset.json";
+/** How many of the largest datasets the summary keeps by default. */
+export declare const DEFAULT_LARGEST_DATASET_LIMIT = 10;
+/**
+ * The realm value that marks a dataset entry. The same file also carries the
+ * platform's pipeline configuration, data specifications, and provenance
+ * tables, which are not datasets and hold no records.
+ */
+export declare const PLANNING_DATASET_REALM = "dataset";
+/** One dataset the platform lists, with the records published behind it. */
+export interface PlanningDataset {
+    /** Dataset identifier, the value the API takes in its `dataset=` parameter. */
+    dataset: string;
+    name: string;
+    /** Records published for this dataset; 0 while it is still being built. */
+    entityCount: number;
+    themes: string[];
+    typology: string;
+    phase: string;
+    licence: string;
+}
+/** Rolled-up shape of the platform's dataset list. */
+export interface PlanningDatasetSummary {
+    datasetCount: number;
+    /** Records summed across every dataset. */
+    entityCount: number;
+    /** Datasets listed with no records published yet. */
+    emptyDatasetCount: number;
+    /** The datasets holding the most records, largest first. */
+    largestDatasets: PlanningDataset[];
+}
+/**
+ * Parses a Planning Data /dataset.json payload into datasets.
+ *
+ * @param payload - the raw JSON body from the dataset catalogue
+ * @returns one entry per dataset, in the order the platform lists them
+ */
+export declare function parsePlanningDatasets(payload: unknown): PlanningDataset[];
+/**
+ * Totals the catalogue and keeps the datasets holding the most records.
+ *
+ * @param datasets - datasets from {@link parsePlanningDatasets}
+ * @param largestDatasetLimit - how many to keep in `largestDatasets`
+ * @returns dataset, record, and empty-dataset counts plus the largest datasets
+ */
+export declare function summarizePlanningDatasets(datasets: PlanningDataset[], largestDatasetLimit?: number): PlanningDatasetSummary;
+/**
+ * Lists every dataset on the Planning Data platform.
+ *
+ * @param options - an optional fetch implementation
+ * @returns the datasets the catalogue returns
+ */
+export declare function fetchPlanningDatasets(options?: {
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<PlanningDataset[]>;
+/** Planning Data platform datasets, published by MHCLG and keyless. */
+export declare const planningDatasetsAdapter: UkDataAdapter<PlanningDataset[]>;
+//# sourceMappingURL=planningDatasets.d.ts.map

package/dist/planningDatasets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planningDatasets.d.ts","sourceRoot":"","sources":["../src/planningDatasets.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,kDAAkD,CAAC;AAErF,qEAAqE;AACrE,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,YAAY,CAAC;AAEhD,4EAA4E;AAC5E,MAAM,WAAW,eAAe;IAC9B,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,sDAAsD;AACtD,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,4DAA4D;IAC5D,eAAe,EAAE,eAAe,EAAE,CAAC;CACpC;AAoBD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,EAAE,CAgBzE;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,eAAe,EAAE,EAC3B,mBAAmB,GAAE,MAAsC,GAC1D,sBAAsB,CAaxB;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAAO,GACpD,OAAO,CAAC,eAAe,EAAE,CAAC,CAO5B;AAED,uEAAuE;AACvE,eAAO,MAAM,uBAAuB,EAAE,aAAa,CAAC,eAAe,EAAE,CASpE,CAAC"}

package/dist/planningDatasets.js

@@ -0,0 +1,100 @@
+import { z } from 'zod';
+import { UkSourceApiError, UkSourceParseError } from './errors.js';
+import { readFixtureJson } from './fixtures.js';
+/**
+ * The Planning Data platform's dataset catalogue, published by the Ministry of
+ * Housing, Communities and Local Government. Keyless, and the same feed the
+ * platform's own datasets page reads:
+ * <https://www.planning.data.gov.uk/dataset>
+ */
+export const PLANNING_DATASETS_URL = 'https://www.planning.data.gov.uk/dataset.json';
+/** How many of the largest datasets the summary keeps by default. */
+export const DEFAULT_LARGEST_DATASET_LIMIT = 10;
+/**
+ * The realm value that marks a dataset entry. The same file also carries the
+ * platform's pipeline configuration, data specifications, and provenance
+ * tables, which are not datasets and hold no records.
+ */
+export const PLANNING_DATASET_REALM = 'dataset';
+// Only the fields the summary reads are required. The catalogue grows fields
+// as the platform does, and a new or missing optional field on one entry
+// should not take the whole list down with it.
+const PLANNING_DATASET_SCHEMA = z.object({
+    dataset: z.string(),
+    name: z.string(),
+    'entity-count': z.number(),
+    realm: z.string(),
+    themes: z.array(z.string()).optional(),
+    typology: z.string().optional(),
+    phase: z.string().optional(),
+    licence: z.string().optional(),
+});
+const PLANNING_DATASETS_RESPONSE_SCHEMA = z.object({
+    datasets: z.array(PLANNING_DATASET_SCHEMA),
+});
+/**
+ * Parses a Planning Data /dataset.json payload into datasets.
+ *
+ * @param payload - the raw JSON body from the dataset catalogue
+ * @returns one entry per dataset, in the order the platform lists them
+ */
+export function parsePlanningDatasets(payload) {
+    const parsed = PLANNING_DATASETS_RESPONSE_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UkSourceParseError('planning-datasets', parsed.error.message);
+    }
+    return parsed.data.datasets
+        .filter((entry) => entry.realm === PLANNING_DATASET_REALM)
+        .map((entry) => ({
+        dataset: entry.dataset,
+        name: entry.name,
+        entityCount: entry['entity-count'],
+        themes: entry.themes ?? [],
+        typology: entry.typology ?? '',
+        phase: entry.phase ?? '',
+        licence: entry.licence ?? '',
+    }));
+}
+/**
+ * Totals the catalogue and keeps the datasets holding the most records.
+ *
+ * @param datasets - datasets from {@link parsePlanningDatasets}
+ * @param largestDatasetLimit - how many to keep in `largestDatasets`
+ * @returns dataset, record, and empty-dataset counts plus the largest datasets
+ */
+export function summarizePlanningDatasets(datasets, largestDatasetLimit = DEFAULT_LARGEST_DATASET_LIMIT) {
+    const largestDatasets = [...datasets]
+        .sort((left, right) => right.entityCount - left.entityCount || left.name.localeCompare(right.name))
+        .slice(0, largestDatasetLimit);
+    return {
+        datasetCount: datasets.length,
+        entityCount: datasets.reduce((total, dataset) => total + dataset.entityCount, 0),
+        emptyDatasetCount: datasets.filter((dataset) => dataset.entityCount === 0).length,
+        largestDatasets,
+    };
+}
+/**
+ * Lists every dataset on the Planning Data platform.
+ *
+ * @param options - an optional fetch implementation
+ * @returns the datasets the catalogue returns
+ */
+export async function fetchPlanningDatasets(options = {}) {
+    const { fetchImpl = globalThis.fetch } = options;
+    const response = await fetchImpl(PLANNING_DATASETS_URL);
+    if (!response.ok) {
+        throw new UkSourceApiError('planning-datasets', `HTTP ${response.status} listing datasets`);
+    }
+    return parsePlanningDatasets(await response.json());
+}
+/** Planning Data platform datasets, published by MHCLG and keyless. */
+export const planningDatasetsAdapter = {
+    id: 'planning-datasets',
+    name: 'Ministry of Housing, Communities and Local Government planning datasets',
+    auth: 'none',
+    description: 'Every dataset the Planning Data platform lists, with the records behind it.',
+    fetchLive: (options) => fetchPlanningDatasets(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    parse: parsePlanningDatasets,
+    loadFixture: () => parsePlanningDatasets(readFixtureJson('planning-datasets.json')),
+};
+//# sourceMappingURL=planningDatasets.js.map

package/dist/planningDatasets.js.map

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

package/dist/policeCrimes.d.ts

@@ -0,0 +1,152 @@
+import type { UkDataAdapter } from './types.js';
+/**
+ * Street-level recorded crime from the Home Office's police.uk open data API.
+ * Every police force in England, Wales and Northern Ireland publishes to it,
+ * keyless and monthly, under the Open Government Licence v3:
+ * <https://data.police.uk/docs/>
+ */
+export declare const POLICE_CRIMES_SOURCE_ID = "police-crimes";
+/** The API root every call here is built from. */
+export declare const POLICE_API_BASE_URL = "https://data.police.uk/api";
+/** Street-level crime within a mile of a point, for one published month. */
+export declare const POLICE_STREET_CRIMES_URL = "https://data.police.uk/api/crimes-street/all-crime";
+/** The months the API holds, newest first, with the forces behind each. */
+export declare const POLICE_STREET_DATES_URL = "https://data.police.uk/api/crimes-street-dates";
+/** The crime types the API uses, with the label it gives each one. */
+export declare const POLICE_CRIME_CATEGORIES_URL = "https://data.police.uk/api/crime-categories";
+/**
+ * The radius the API answers for. Its street-level endpoints take a point and
+ * return everything within one mile of it; there is no way to ask for less.
+ */
+export declare const POLICE_STREET_CRIMES_RADIUS_MILES = 1;
+/** How many published months the summary covers by default. */
+export declare const DEFAULT_POLICE_CRIME_MONTH_COUNT = 12;
+/** The point the story counts around, and the name the page gives it. */
+export declare const DEFAULT_POLICE_CRIME_LOCATION: {
+    readonly label: "Leeds city centre";
+    readonly latitude: 53.7997;
+    readonly longitude: -1.5492;
+};
+/** A point the API answers for, with the name the page shows. */
+export interface PoliceCrimeLocation {
+    label: string;
+    latitude: number;
+    longitude: number;
+}
+/** One crime type the API uses. */
+export interface PoliceCrimeCategory {
+    /** The value records carry, e.g. "violent-crime". */
+    slug: string;
+    /** The label the API gives it, e.g. "Violence and sexual offences". */
+    name: string;
+}
+/** One crime type with the records counted against it. */
+export interface PoliceCategoryCount {
+    slug: string;
+    name: string;
+    recordCount: number;
+}
+/** One outcome with the records that ended in it. */
+export interface PoliceOutcomeCount {
+    /** The API's outcome label, or null when the record carries no outcome yet. */
+    outcome: string | null;
+    recordCount: number;
+}
+/** One published month with its records counted by type. */
+export interface PoliceMonthCount {
+    /** The month as YYYY-MM. */
+    month: string;
+    recordCount: number;
+    /** Record counts for this month, biggest first. */
+    categoryCounts: PoliceCategoryCount[];
+}
+/** Everything the recorded crime story draws. */
+export interface PoliceCrimeSummary {
+    /** How many published months the window covers. */
+    monthCount: number;
+    recordCount: number;
+    /** Oldest month in the window. */
+    firstMonth: string;
+    /** Newest month in the window. */
+    latestMonth: string;
+    /** Record counts across the whole window, biggest first. */
+    categoryCounts: PoliceCategoryCount[];
+    /** Outcome counts across the whole window, biggest first. */
+    outcomeCounts: PoliceOutcomeCount[];
+    /** One entry per month, oldest first. */
+    months: PoliceMonthCount[];
+    busiestMonth: PoliceMonthCount;
+    quietestMonth: PoliceMonthCount;
+    topCategory: PoliceCategoryCount;
+    topOutcome: PoliceOutcomeCount;
+}
+/** The raw API responses one summary is parsed from. */
+export interface PoliceCrimeResponses {
+    /** The `/crime-categories` response. */
+    categories: unknown;
+    /** One `/crimes-street/all-crime` response per month, newest first. */
+    months: {
+        month: string;
+        records: unknown;
+    }[];
+}
+/**
+ * Parses the API responses behind one window into the counts the chart draws.
+ *
+ * The API writes one record per offence, so the counts come from the same read
+ * the page renders. Every check here is one the page would otherwise show as a
+ * wrong number: a month that came back empty, a record filed under a month
+ * other than the one it was asked for, or a crime type the category list does
+ * not carry all throw rather than quietly changing the totals.
+ *
+ * @param payload - the raw responses, or the committed fixture of them
+ * @returns the counts, with months oldest first
+ */
+export declare function parsePoliceCrimeSummary(payload: unknown): PoliceCrimeSummary;
+/**
+ * Builds the street-level crime URL for one point and one month.
+ *
+ * @param options - where to count, and which month to ask for
+ * @returns the full query URL
+ */
+export declare function buildPoliceStreetCrimesUrl(options: {
+    latitude: number;
+    longitude: number;
+    month: string;
+}): string;
+/**
+ * Lists the months the API holds street-level crime for, newest first.
+ *
+ * @param options - an optional fetch implementation
+ * @returns the published months as YYYY-MM
+ */
+export declare function fetchPoliceCrimeMonths(options?: {
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<string[]>;
+/**
+ * Reads the crime types the API uses.
+ *
+ * @param options - an optional fetch implementation
+ * @returns one entry per crime type
+ */
+export declare function fetchPoliceCrimeCategories(options?: {
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<unknown>;
+/**
+ * Counts recorded crime within a mile of a point over the latest months.
+ *
+ * The months are read one at a time rather than in one burst, because the API
+ * is free to use and rate-limited per caller. A window of a year is 13 calls.
+ *
+ * @param options - where to count, how many months, and an optional fetch implementation
+ * @returns the counts for the window
+ */
+export declare function fetchPoliceCrimeSummary(options?: {
+    latitude?: number;
+    longitude?: number;
+    monthCount?: number;
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<PoliceCrimeSummary>;
+/** Home Office street-level recorded crime, keyless. */
+export declare const policeCrimesAdapter: UkDataAdapter<PoliceCrimeSummary>;
+//# sourceMappingURL=policeCrimes.d.ts.map

package/dist/policeCrimes.d.ts.map

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