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

package/dist/foodHygiene.d.ts

@@ -0,0 +1,68 @@
+import type { UkDataAdapter } from './types.js';
+/**
+ * The Food Standards Agency food hygiene register list. Keyless, published by
+ * the FSA under the Open Government Licence v3.
+ *
+ * The endpoint only answers when the FSA's version header is sent with it:
+ * called bare it returns HTTP 404 with "The API 'Authorities' doesn't exist".
+ */
+export declare const FSA_AUTHORITIES_URL = "https://api.ratings.food.gov.uk/Authorities/basic";
+/** Header the FSA food hygiene API requires on every request. */
+export declare const FSA_API_VERSION_HEADER = "x-api-version";
+/** Version of the FSA API this adapter speaks. Version 1 no longer answers. */
+export declare const FSA_API_VERSION = "2";
+/** How many of the largest registers the summary keeps by default. */
+export declare const DEFAULT_LARGEST_AUTHORITY_LIMIT = 10;
+/**
+ * Which scheme a register runs. The Food Hygiene Rating Scheme (FHRS) covers
+ * England, Wales, and Northern Ireland. The Food Hygiene Information Scheme
+ * (FHIS) covers Scotland, where premises are rated pass or improve.
+ */
+export type FoodHygieneScheme = 'fhrs' | 'fhis';
+/** One local authority's food hygiene register, as the FSA lists it. */
+export interface FoodHygieneAuthority {
+    localAuthorityId: number;
+    /** The FSA's own code for the authority, which it publishes as a string. */
+    localAuthorityCode: string;
+    localAuthorityName: string;
+    /** How many establishments the register holds. */
+    establishmentCount: number;
+    scheme: FoodHygieneScheme;
+}
+/** Rolled-up counts across every register the FSA publishes. */
+export interface FoodHygieneSummary {
+    authorityCount: number;
+    /** Establishments summed across every register. */
+    establishmentCount: number;
+    fhrsAuthorityCount: number;
+    fhisAuthorityCount: number;
+    /** The registers holding the most establishments, largest first. */
+    largestAuthorities: FoodHygieneAuthority[];
+}
+/**
+ * Parses an FSA /Authorities payload into registers.
+ *
+ * @param payload - the raw JSON body from the register endpoint
+ * @returns one flattened register per local authority
+ */
+export declare function parseFoodHygieneAuthorities(payload: unknown): FoodHygieneAuthority[];
+/**
+ * Totals the registers and keeps the largest ones.
+ *
+ * @param authorities - registers from {@link parseFoodHygieneAuthorities}
+ * @param largestAuthorityLimit - how many registers to keep in `largestAuthorities`
+ * @returns register, establishment, and scheme counts plus the largest registers
+ */
+export declare function summarizeFoodHygieneAuthorities(authorities: FoodHygieneAuthority[], largestAuthorityLimit?: number): FoodHygieneSummary;
+/**
+ * Lists every local authority food hygiene register from the FSA.
+ *
+ * @param options - an optional fetch implementation
+ * @returns the registers the endpoint returns
+ */
+export declare function fetchFoodHygieneAuthorities(options?: {
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<FoodHygieneAuthority[]>;
+/** Food Standards Agency food hygiene register adapter, keyless. */
+export declare const foodHygieneAuthoritiesAdapter: UkDataAdapter<FoodHygieneAuthority[]>;
+//# sourceMappingURL=foodHygiene.d.ts.map

package/dist/foodHygiene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"foodHygiene.d.ts","sourceRoot":"","sources":["../src/foodHygiene.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,sDAAsD,CAAC;AAEvF,iEAAiE;AACjE,eAAO,MAAM,sBAAsB,kBAAkB,CAAC;AAEtD,+EAA+E;AAC/E,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,sEAAsE;AACtE,eAAO,MAAM,+BAA+B,KAAK,CAAC;AAElD;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,CAAC;AAEhD,wEAAwE;AACxE,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,MAAM,CAAC;IACzB,4EAA4E;IAC5E,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kDAAkD;IAClD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAED,gEAAgE;AAChE,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oEAAoE;IACpE,kBAAkB,EAAE,oBAAoB,EAAE,CAAC;CAC5C;AA6BD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,GAAG,oBAAoB,EAAE,CAYpF;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,oBAAoB,EAAE,EACnC,qBAAqB,GAAE,MAAwC,GAC9D,kBAAkB,CAmBpB;AAED;;;;;GAKG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAAO,GACpD,OAAO,CAAC,oBAAoB,EAAE,CAAC,CASjC;AAED,oEAAoE;AACpE,eAAO,MAAM,6BAA6B,EAAE,aAAa,CAAC,oBAAoB,EAAE,CAW/E,CAAC"}

package/dist/foodHygiene.js

@@ -0,0 +1,103 @@
+import { z } from 'zod';
+import { UkSourceApiError, UkSourceParseError } from './errors.js';
+import { readFixtureJson } from './fixtures.js';
+/**
+ * The Food Standards Agency food hygiene register list. Keyless, published by
+ * the FSA under the Open Government Licence v3.
+ *
+ * The endpoint only answers when the FSA's version header is sent with it:
+ * called bare it returns HTTP 404 with "The API 'Authorities' doesn't exist".
+ */
+export const FSA_AUTHORITIES_URL = 'https://api.ratings.food.gov.uk/Authorities/basic';
+/** Header the FSA food hygiene API requires on every request. */
+export const FSA_API_VERSION_HEADER = 'x-api-version';
+/** Version of the FSA API this adapter speaks. Version 1 no longer answers. */
+export const FSA_API_VERSION = '2';
+/** How many of the largest registers the summary keeps by default. */
+export const DEFAULT_LARGEST_AUTHORITY_LIMIT = 10;
+const FSA_AUTHORITY_SCHEMA = z.object({
+    LocalAuthorityId: z.number(),
+    LocalAuthorityIdCode: z.string(),
+    Name: z.string(),
+    EstablishmentCount: z.number(),
+    SchemeType: z.number(),
+});
+const FSA_AUTHORITIES_RESPONSE_SCHEMA = z.object({
+    authorities: z.array(FSA_AUTHORITY_SCHEMA),
+});
+/** Scheme codes the FSA API uses: 1 is FHRS, 2 is FHIS. */
+const FSA_SCHEME_BY_TYPE = { 1: 'fhrs', 2: 'fhis' };
+/** Maps the API's scheme code, naming the register when the code is new. */
+function readFoodHygieneScheme(schemeType, localAuthorityName) {
+    const scheme = FSA_SCHEME_BY_TYPE[schemeType];
+    if (scheme === undefined) {
+        throw new UkSourceParseError('fsa-food-hygiene', `unknown scheme type ${schemeType} on ${localAuthorityName}`);
+    }
+    return scheme;
+}
+/**
+ * Parses an FSA /Authorities payload into registers.
+ *
+ * @param payload - the raw JSON body from the register endpoint
+ * @returns one flattened register per local authority
+ */
+export function parseFoodHygieneAuthorities(payload) {
+    const parsed = FSA_AUTHORITIES_RESPONSE_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UkSourceParseError('fsa-food-hygiene', parsed.error.message);
+    }
+    return parsed.data.authorities.map((authority) => ({
+        localAuthorityId: authority.LocalAuthorityId,
+        localAuthorityCode: authority.LocalAuthorityIdCode,
+        localAuthorityName: authority.Name,
+        establishmentCount: authority.EstablishmentCount,
+        scheme: readFoodHygieneScheme(authority.SchemeType, authority.Name),
+    }));
+}
+/**
+ * Totals the registers and keeps the largest ones.
+ *
+ * @param authorities - registers from {@link parseFoodHygieneAuthorities}
+ * @param largestAuthorityLimit - how many registers to keep in `largestAuthorities`
+ * @returns register, establishment, and scheme counts plus the largest registers
+ */
+export function summarizeFoodHygieneAuthorities(authorities, largestAuthorityLimit = DEFAULT_LARGEST_AUTHORITY_LIMIT) {
+    const largestAuthorities = [...authorities]
+        .sort((left, right) => right.establishmentCount - left.establishmentCount ||
+        left.localAuthorityName.localeCompare(right.localAuthorityName))
+        .slice(0, largestAuthorityLimit);
+    return {
+        authorityCount: authorities.length,
+        establishmentCount: authorities.reduce((total, authority) => total + authority.establishmentCount, 0),
+        fhrsAuthorityCount: authorities.filter((authority) => authority.scheme === 'fhrs').length,
+        fhisAuthorityCount: authorities.filter((authority) => authority.scheme === 'fhis').length,
+        largestAuthorities,
+    };
+}
+/**
+ * Lists every local authority food hygiene register from the FSA.
+ *
+ * @param options - an optional fetch implementation
+ * @returns the registers the endpoint returns
+ */
+export async function fetchFoodHygieneAuthorities(options = {}) {
+    const { fetchImpl = globalThis.fetch } = options;
+    const response = await fetchImpl(FSA_AUTHORITIES_URL, {
+        headers: { [FSA_API_VERSION_HEADER]: FSA_API_VERSION },
+    });
+    if (!response.ok) {
+        throw new UkSourceApiError('fsa-food-hygiene', `HTTP ${response.status} listing registers`);
+    }
+    return parseFoodHygieneAuthorities(await response.json());
+}
+/** Food Standards Agency food hygiene register adapter, keyless. */
+export const foodHygieneAuthoritiesAdapter = {
+    id: 'food-hygiene-authorities',
+    name: 'Food Standards Agency food hygiene registers',
+    auth: 'none',
+    description: 'Every local authority food hygiene register, with its establishment count.',
+    fetchLive: (options) => fetchFoodHygieneAuthorities(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    parse: parseFoodHygieneAuthorities,
+    loadFixture: () => parseFoodHygieneAuthorities(readFixtureJson('food-hygiene-authorities.json')),
+};
+//# sourceMappingURL=foodHygiene.js.map

package/dist/foodHygiene.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,47 @@
+/** Natural England ancient woodland polygons for England (keyless). */
+export { ANCIENT_WOODLAND_CATEGORIES, ANCIENT_WOODLAND_DATASET_URL, ANCIENT_WOODLAND_QUERY_URL, ANCIENT_WOODLAND_SIZE_BANDS, ANCIENT_WOODLAND_SOURCE_ID, ancientWoodlandAdapter, fetchAncientWoodlandProfile, parseAncientWoodlandProfile, } from './ancientWoodland.js';
+/** Ancient woodland types. */
+export type { AncientWoodlandCategory, AncientWoodlandCategoryId, AncientWoodlandProfile, AncientWoodlandResponses, AncientWoodlandSizeBand, AncientWoodlandSizeBandDefinition, } from './ancientWoodland.js';
+/** Bank of England Bank Rate, the daily official rate since 1975 (keyless). */
+export { bankRateAdapter, BANK_RATE_CSV_URL, BANK_RATE_FIRST_QUERY_DATE, BANK_RATE_SERIES_CODE, BANK_RATE_SOURCE_ID, buildBankRateCsvUrl, buildBankRateSpells, fetchBankRateObservations, formatBankRateQueryDate, parseBankRateCsv, summarizeBankRateSeries, } from './bankRate.js';
+/** Bank Rate types. */
+export type { BankRateObservation, BankRateSpell, BankRateSummary } from './bankRate.js';
+/** National Energy System Operator half-hourly carbon intensity (keyless). */
+export { buildCarbonIntensityWindowUrl, carbonIntensityAdapter, CARBON_INTENSITY_API_BASE_URL, CARBON_INTENSITY_INDEX_BANDS, CARBON_INTENSITY_MAX_WINDOW_DAYS, CARBON_INTENSITY_PERIOD_MINUTES, CARBON_INTENSITY_RANGE_URL, CARBON_INTENSITY_SOURCE_ID, DEFAULT_CARBON_INTENSITY_WINDOW_DAYS, fetchCarbonIntensityWindow, formatCarbonIntensityInstant, parseCarbonIntensityWindow, resolveCarbonIntensityWindow, } from './carbonIntensity.js';
+/** Carbon intensity types. */
+export type { CarbonIntensityBandCount, CarbonIntensityIndex, CarbonIntensityPeriod, CarbonIntensityWindow, } from './carbonIntensity.js';
+/** Errors shared by every UK source adapter. */
+export { UkSourceApiError, UkSourceError, UkSourceParseError } from './errors.js';
+/** Environment Agency flood-monitoring stations and readings (keyless). */
+export { DEFAULT_FLOOD_STATION_REFERENCE, fetchFloodStationReadings, fetchFloodStations, floodReadingsAdapter, floodStationsAdapter, parseFloodReadings, parseFloodStations, summarizeFloodReadings, } from './floodMonitoring.js';
+/** Flood-monitoring types. */
+export type { FloodMeasure, FloodReading, FloodReadingSummary, FloodStation, } from './floodMonitoring.js';
+/** Food Standards Agency food hygiene registers (keyless). */
+export { DEFAULT_LARGEST_AUTHORITY_LIMIT, fetchFoodHygieneAuthorities, foodHygieneAuthoritiesAdapter, FSA_API_VERSION, FSA_API_VERSION_HEADER, FSA_AUTHORITIES_URL, parseFoodHygieneAuthorities, summarizeFoodHygieneAuthorities, } from './foodHygiene.js';
+/** Food hygiene register types. */
+export type { FoodHygieneAuthority, FoodHygieneScheme, FoodHygieneSummary } from './foodHygiene.js';
+/** Office for National Statistics dataset catalogue (keyless). */
+export { fetchOnsDatasets, onsDatasetsAdapter, ONS_DATASETS_LIMIT, ONS_DATASETS_URL, parseOnsDatasets, summarizeOnsDatasets, } from './onsDatasets.js';
+/** ONS catalogue types. */
+export type { OnsDatasetRecord, OnsDatasetSummary, OnsDatasetYearCount } from './onsDatasets.js';
+/** UK Parliament state of the parties in the Commons and the Lords (keyless). */
+export { buildParliamentSeatsUrl, fetchParliamentSeats, formatParliamentQueryDate, parliamentSeatsAdapter, parseParliamentPartySeats, parseParliamentSeats, PARLIAMENT_COMMONS_HOUSE, PARLIAMENT_LORDS_HOUSE, PARLIAMENT_MEMBERS_API_BASE_URL, PARLIAMENT_SEATS_SOURCE_ID, PARLIAMENT_STATE_OF_PARTIES_PATH, summarizeParliamentPartySeats, } from './parliamentSeats.js';
+/** Parliament seat types. */
+export type { ParliamentHouse, ParliamentParty, ParliamentPartySeats, ParliamentSeatSummary, } from './parliamentSeats.js';
+/** Planning Data platform dataset catalogue, published by MHCLG (keyless). */
+export { DEFAULT_LARGEST_DATASET_LIMIT, fetchPlanningDatasets, parsePlanningDatasets, planningDatasetsAdapter, PLANNING_DATASET_REALM, PLANNING_DATASETS_URL, summarizePlanningDatasets, } from './planningDatasets.js';
+/** Planning dataset types. */
+export type { PlanningDataset, PlanningDatasetSummary } from './planningDatasets.js';
+/** Home Office police.uk street-level recorded crime (keyless). */
+export { buildPoliceStreetCrimesUrl, DEFAULT_POLICE_CRIME_LOCATION, DEFAULT_POLICE_CRIME_MONTH_COUNT, fetchPoliceCrimeCategories, fetchPoliceCrimeMonths, fetchPoliceCrimeSummary, parsePoliceCrimeSummary, policeCrimesAdapter, POLICE_API_BASE_URL, POLICE_CRIME_CATEGORIES_URL, POLICE_CRIMES_SOURCE_ID, POLICE_STREET_CRIMES_RADIUS_MILES, POLICE_STREET_CRIMES_URL, POLICE_STREET_DATES_URL, } from './policeCrimes.js';
+/** Recorded crime types. */
+export type { PoliceCategoryCount, PoliceCrimeCategory, PoliceCrimeLocation, PoliceCrimeResponses, PoliceCrimeSummary, PoliceMonthCount, PoliceOutcomeCount, } from './policeCrimes.js';
+/** Transport for London Santander Cycles docking stations (keyless). */
+export { DEFAULT_LARGEST_STATION_LIMIT, fetchTflBikePoints, parseTflBikePoints, summarizeTflBikePoints, tflBikePointsAdapter, TFL_BIKE_POINTS_URL, } from './tflBikePoints.js';
+/** Docking station types. */
+export type { DockingStation, DockingStationSummary } from './tflBikePoints.js';
+/** The uniform adapter registry and probe helpers. */
+export { UK_DATA_SOURCES, getUkDataSource, probeAllUkDataSources, probeUkDataSource, } from './registry.js';
+/** Shared adapter contract types. */
+export type { UkDataAdapter, UkFetchOptions, UkSourceAuth, UkSourceProbe } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,0BAA0B,EAC1B,2BAA2B,EAC3B,0BAA0B,EAC1B,sBAAsB,EACtB,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,sBAAsB,CAAC;AAC9B,8BAA8B;AAC9B,YAAY,EACV,uBAAuB,EACvB,yBAAyB,EACzB,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,iCAAiC,GAClC,MAAM,sBAAsB,CAAC;AAC9B,+EAA+E;AAC/E,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,0BAA0B,EAC1B,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,uBAAuB,EACvB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,eAAe,CAAC;AACvB,uBAAuB;AACvB,YAAY,EAAE,mBAAmB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACzF,8EAA8E;AAC9E,OAAO,EACL,6BAA6B,EAC7B,sBAAsB,EACtB,6BAA6B,EAC7B,4BAA4B,EAC5B,gCAAgC,EAChC,+BAA+B,EAC/B,0BAA0B,EAC1B,0BAA0B,EAC1B,oCAAoC,EACpC,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,sBAAsB,CAAC;AAC9B,8BAA8B;AAC9B,YAAY,EACV,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,gDAAgD;AAChD,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAClF,2EAA2E;AAC3E,OAAO,EACL,+BAA+B,EAC/B,yBAAyB,EACzB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,8BAA8B;AAC9B,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,YAAY,GACb,MAAM,sBAAsB,CAAC;AAC9B,8DAA8D;AAC9D,OAAO,EACL,+BAA+B,EAC/B,2BAA2B,EAC3B,6BAA6B,EAC7B,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACnB,2BAA2B,EAC3B,+BAA+B,GAChC,MAAM,kBAAkB,CAAC;AAC1B,mCAAmC;AACnC,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACpG,kEAAkE;AAClE,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,2BAA2B;AAC3B,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACjG,iFAAiF;AACjF,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,yBAAyB,EACzB,sBAAsB,EACtB,yBAAyB,EACzB,oBAAoB,EACpB,wBAAwB,EACxB,sBAAsB,EACtB,+BAA+B,EAC/B,0BAA0B,EAC1B,gCAAgC,EAChC,6BAA6B,GAC9B,MAAM,sBAAsB,CAAC;AAC9B,6BAA6B;AAC7B,YAAY,EACV,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,8EAA8E;AAC9E,OAAO,EACL,6BAA6B,EAC7B,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAC/B,8BAA8B;AAC9B,YAAY,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACrF,mEAAmE;AACnE,OAAO,EACL,0BAA0B,EAC1B,6BAA6B,EAC7B,gCAAgC,EAChC,0BAA0B,EAC1B,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,2BAA2B,EAC3B,uBAAuB,EACvB,iCAAiC,EACjC,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,4BAA4B;AAC5B,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAC3B,wEAAwE;AACxE,OAAO,EACL,6BAA6B,EAC7B,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,6BAA6B;AAC7B,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChF,sDAAsD;AACtD,OAAO,EACL,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AACvB,qCAAqC;AACrC,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,25 @@
+/** Natural England ancient woodland polygons for England (keyless). */
+export { ANCIENT_WOODLAND_CATEGORIES, ANCIENT_WOODLAND_DATASET_URL, ANCIENT_WOODLAND_QUERY_URL, ANCIENT_WOODLAND_SIZE_BANDS, ANCIENT_WOODLAND_SOURCE_ID, ancientWoodlandAdapter, fetchAncientWoodlandProfile, parseAncientWoodlandProfile, } from './ancientWoodland.js';
+/** Bank of England Bank Rate, the daily official rate since 1975 (keyless). */
+export { bankRateAdapter, BANK_RATE_CSV_URL, BANK_RATE_FIRST_QUERY_DATE, BANK_RATE_SERIES_CODE, BANK_RATE_SOURCE_ID, buildBankRateCsvUrl, buildBankRateSpells, fetchBankRateObservations, formatBankRateQueryDate, parseBankRateCsv, summarizeBankRateSeries, } from './bankRate.js';
+/** National Energy System Operator half-hourly carbon intensity (keyless). */
+export { buildCarbonIntensityWindowUrl, carbonIntensityAdapter, CARBON_INTENSITY_API_BASE_URL, CARBON_INTENSITY_INDEX_BANDS, CARBON_INTENSITY_MAX_WINDOW_DAYS, CARBON_INTENSITY_PERIOD_MINUTES, CARBON_INTENSITY_RANGE_URL, CARBON_INTENSITY_SOURCE_ID, DEFAULT_CARBON_INTENSITY_WINDOW_DAYS, fetchCarbonIntensityWindow, formatCarbonIntensityInstant, parseCarbonIntensityWindow, resolveCarbonIntensityWindow, } from './carbonIntensity.js';
+/** Errors shared by every UK source adapter. */
+export { UkSourceApiError, UkSourceError, UkSourceParseError } from './errors.js';
+/** Environment Agency flood-monitoring stations and readings (keyless). */
+export { DEFAULT_FLOOD_STATION_REFERENCE, fetchFloodStationReadings, fetchFloodStations, floodReadingsAdapter, floodStationsAdapter, parseFloodReadings, parseFloodStations, summarizeFloodReadings, } from './floodMonitoring.js';
+/** Food Standards Agency food hygiene registers (keyless). */
+export { DEFAULT_LARGEST_AUTHORITY_LIMIT, fetchFoodHygieneAuthorities, foodHygieneAuthoritiesAdapter, FSA_API_VERSION, FSA_API_VERSION_HEADER, FSA_AUTHORITIES_URL, parseFoodHygieneAuthorities, summarizeFoodHygieneAuthorities, } from './foodHygiene.js';
+/** Office for National Statistics dataset catalogue (keyless). */
+export { fetchOnsDatasets, onsDatasetsAdapter, ONS_DATASETS_LIMIT, ONS_DATASETS_URL, parseOnsDatasets, summarizeOnsDatasets, } from './onsDatasets.js';
+/** UK Parliament state of the parties in the Commons and the Lords (keyless). */
+export { buildParliamentSeatsUrl, fetchParliamentSeats, formatParliamentQueryDate, parliamentSeatsAdapter, parseParliamentPartySeats, parseParliamentSeats, PARLIAMENT_COMMONS_HOUSE, PARLIAMENT_LORDS_HOUSE, PARLIAMENT_MEMBERS_API_BASE_URL, PARLIAMENT_SEATS_SOURCE_ID, PARLIAMENT_STATE_OF_PARTIES_PATH, summarizeParliamentPartySeats, } from './parliamentSeats.js';
+/** Planning Data platform dataset catalogue, published by MHCLG (keyless). */
+export { DEFAULT_LARGEST_DATASET_LIMIT, fetchPlanningDatasets, parsePlanningDatasets, planningDatasetsAdapter, PLANNING_DATASET_REALM, PLANNING_DATASETS_URL, summarizePlanningDatasets, } from './planningDatasets.js';
+/** Home Office police.uk street-level recorded crime (keyless). */
+export { buildPoliceStreetCrimesUrl, DEFAULT_POLICE_CRIME_LOCATION, DEFAULT_POLICE_CRIME_MONTH_COUNT, fetchPoliceCrimeCategories, fetchPoliceCrimeMonths, fetchPoliceCrimeSummary, parsePoliceCrimeSummary, policeCrimesAdapter, POLICE_API_BASE_URL, POLICE_CRIME_CATEGORIES_URL, POLICE_CRIMES_SOURCE_ID, POLICE_STREET_CRIMES_RADIUS_MILES, POLICE_STREET_CRIMES_URL, POLICE_STREET_DATES_URL, } from './policeCrimes.js';
+/** Transport for London Santander Cycles docking stations (keyless). */
+export { DEFAULT_LARGEST_STATION_LIMIT, fetchTflBikePoints, parseTflBikePoints, summarizeTflBikePoints, tflBikePointsAdapter, TFL_BIKE_POINTS_URL, } from './tflBikePoints.js';
+/** The uniform adapter registry and probe helpers. */
+export { UK_DATA_SOURCES, getUkDataSource, probeAllUkDataSources, probeUkDataSource, } from './registry.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,0BAA0B,EAC1B,2BAA2B,EAC3B,0BAA0B,EAC1B,sBAAsB,EACtB,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,sBAAsB,CAAC;AAU9B,+EAA+E;AAC/E,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,0BAA0B,EAC1B,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,uBAAuB,EACvB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,eAAe,CAAC;AAGvB,8EAA8E;AAC9E,OAAO,EACL,6BAA6B,EAC7B,sBAAsB,EACtB,6BAA6B,EAC7B,4BAA4B,EAC5B,gCAAgC,EAChC,+BAA+B,EAC/B,0BAA0B,EAC1B,0BAA0B,EAC1B,oCAAoC,EACpC,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,sBAAsB,CAAC;AAQ9B,gDAAgD;AAChD,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAClF,2EAA2E;AAC3E,OAAO,EACL,+BAA+B,EAC/B,yBAAyB,EACzB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAQ9B,8DAA8D;AAC9D,OAAO,EACL,+BAA+B,EAC/B,2BAA2B,EAC3B,6BAA6B,EAC7B,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACnB,2BAA2B,EAC3B,+BAA+B,GAChC,MAAM,kBAAkB,CAAC;AAG1B,kEAAkE;AAClE,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAG1B,iFAAiF;AACjF,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,yBAAyB,EACzB,sBAAsB,EACtB,yBAAyB,EACzB,oBAAoB,EACpB,wBAAwB,EACxB,sBAAsB,EACtB,+BAA+B,EAC/B,0BAA0B,EAC1B,gCAAgC,EAChC,6BAA6B,GAC9B,MAAM,sBAAsB,CAAC;AAQ9B,8EAA8E;AAC9E,OAAO,EACL,6BAA6B,EAC7B,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAG/B,mEAAmE;AACnE,OAAO,EACL,0BAA0B,EAC1B,6BAA6B,EAC7B,gCAAgC,EAChC,0BAA0B,EAC1B,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,2BAA2B,EAC3B,uBAAuB,EACvB,iCAAiC,EACjC,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAW3B,wEAAwE;AACxE,OAAO,EACL,6BAA6B,EAC7B,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAG5B,sDAAsD;AACtD,OAAO,EACL,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,eAAe,CAAC"}

package/dist/onsDatasets.d.ts

@@ -0,0 +1,67 @@
+import type { UkDataAdapter } from './types.js';
+/**
+ * The ONS beta API dataset catalogue. Keyless, published by the Office for
+ * National Statistics under the Open Government Licence v3.
+ */
+export declare const ONS_DATASETS_URL = "https://api.beta.ons.gov.uk/v1/datasets?limit=1000";
+/**
+ * How many records the catalogue call asks for. The endpoint answers with its
+ * whole catalogue well below this, so the limit is a ceiling, not a page size.
+ */
+export declare const ONS_DATASETS_LIMIT = 1000;
+/** One dataset record as the ONS beta API lists it in the catalogue. */
+export interface OnsDatasetRecord {
+    id: string;
+    title: string;
+    /** Publication state the API reports, such as "published". */
+    state: string;
+    /** The API's own last-updated stamp for this record, ISO 8601. */
+    lastUpdatedIso: string;
+    /** The national-statistic flag, or null when the record leaves it out. */
+    isNationalStatistic: boolean | null;
+    keywords: string[];
+    /** Topic path from the record's taxonomy link, or "" when it has none. */
+    topicPath: string;
+}
+/** Catalogue records counted by the year in their last-updated stamp. */
+export interface OnsDatasetYearCount {
+    /** Calendar year taken from the stamp, as a four digit string. */
+    year: string;
+    datasetCount: number;
+}
+/** Rolled-up counts across the ONS dataset catalogue. */
+export interface OnsDatasetSummary {
+    datasetCount: number;
+    nationalStatisticCount: number;
+    /** Records that carry no national-statistic flag at all. */
+    unflaggedCount: number;
+    /** Records per last-updated year, oldest year first. */
+    yearCounts: OnsDatasetYearCount[];
+}
+/**
+ * Parses an ONS beta API /datasets payload into catalogue records.
+ *
+ * @param payload - the raw JSON body from the catalogue endpoint
+ * @returns one flattened record per dataset
+ */
+export declare function parseOnsDatasets(payload: unknown): OnsDatasetRecord[];
+/**
+ * Counts the catalogue by national-statistic flag and by last-updated year.
+ *
+ * @param records - dataset records from {@link parseOnsDatasets}
+ * @returns dataset, flag, and per-year counts
+ */
+export declare function summarizeOnsDatasets(records: OnsDatasetRecord[]): OnsDatasetSummary;
+/**
+ * Lists datasets from the ONS beta API catalogue.
+ *
+ * @param options - record limit and an optional fetch implementation
+ * @returns the catalogue records the endpoint returns
+ */
+export declare function fetchOnsDatasets(options?: {
+    limit?: number;
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<OnsDatasetRecord[]>;
+/** ONS beta API dataset catalogue adapter, keyless. */
+export declare const onsDatasetsAdapter: UkDataAdapter<OnsDatasetRecord[]>;
+//# sourceMappingURL=onsDatasets.d.ts.map

package/dist/onsDatasets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onsDatasets.d.ts","sourceRoot":"","sources":["../src/onsDatasets.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,uDAAuD,CAAC;AAErF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC,wEAAwE;AACxE,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,cAAc,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,mBAAmB,EAAE,OAAO,GAAG,IAAI,CAAC;IACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,yEAAyE;AACzE,MAAM,WAAW,mBAAmB;IAClC,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,yDAAyD;AACzD,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,4DAA4D;IAC5D,cAAc,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,UAAU,EAAE,mBAAmB,EAAE,CAAC;CACnC;AA0BD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,gBAAgB,EAAE,CAcrE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,iBAAiB,CA0BnF;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAAO,GACpE,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAO7B;AAED,uDAAuD;AACvD,eAAO,MAAM,kBAAkB,EAAE,aAAa,CAAC,gBAAgB,EAAE,CAShE,CAAC"}

package/dist/onsDatasets.js

@@ -0,0 +1,111 @@
+import { z } from 'zod';
+import { UkSourceApiError, UkSourceParseError } from './errors.js';
+import { readFixtureJson } from './fixtures.js';
+/**
+ * The ONS beta API dataset catalogue. Keyless, published by the Office for
+ * National Statistics under the Open Government Licence v3.
+ */
+export const ONS_DATASETS_URL = 'https://api.beta.ons.gov.uk/v1/datasets?limit=1000';
+/**
+ * How many records the catalogue call asks for. The endpoint answers with its
+ * whole catalogue well below this, so the limit is a ceiling, not a page size.
+ */
+export const ONS_DATASETS_LIMIT = 1000;
+const ONS_DATASET_SCHEMA = z.object({
+    id: z.string(),
+    title: z.string(),
+    state: z.string(),
+    last_updated: z.string(),
+    national_statistic: z.boolean().optional(),
+    keywords: z.array(z.string()).optional(),
+    links: z.object({ taxonomy: z.object({ href: z.string() }).optional() }).optional(),
+});
+const ONS_DATASETS_RESPONSE_SCHEMA = z.object({
+    items: z.array(ONS_DATASET_SCHEMA),
+});
+const ONS_TAXONOMY_PREFIX = 'https://api.beta.ons.gov.uk/v1/';
+/** Strips the API prefix from a taxonomy link so the topic path is readable. */
+function readTopicPath(href) {
+    if (href === undefined) {
+        return '';
+    }
+    return href.startsWith(ONS_TAXONOMY_PREFIX) ? href.slice(ONS_TAXONOMY_PREFIX.length) : href;
+}
+/**
+ * Parses an ONS beta API /datasets payload into catalogue records.
+ *
+ * @param payload - the raw JSON body from the catalogue endpoint
+ * @returns one flattened record per dataset
+ */
+export function parseOnsDatasets(payload) {
+    const parsed = ONS_DATASETS_RESPONSE_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UkSourceParseError('ons-datasets', parsed.error.message);
+    }
+    return parsed.data.items.map((item) => ({
+        id: item.id,
+        title: item.title,
+        state: item.state,
+        lastUpdatedIso: item.last_updated,
+        isNationalStatistic: item.national_statistic ?? null,
+        keywords: item.keywords ?? [],
+        topicPath: readTopicPath(item.links?.taxonomy?.href),
+    }));
+}
+/**
+ * Counts the catalogue by national-statistic flag and by last-updated year.
+ *
+ * @param records - dataset records from {@link parseOnsDatasets}
+ * @returns dataset, flag, and per-year counts
+ */
+export function summarizeOnsDatasets(records) {
+    const countByYear = new Map();
+    let nationalStatisticCount = 0;
+    let unflaggedCount = 0;
+    for (const record of records) {
+        if (record.isNationalStatistic === true) {
+            nationalStatisticCount += 1;
+        }
+        else if (record.isNationalStatistic === null) {
+            unflaggedCount += 1;
+        }
+        const year = record.lastUpdatedIso.slice(0, 4);
+        if (year !== '') {
+            countByYear.set(year, (countByYear.get(year) ?? 0) + 1);
+        }
+    }
+    const yearCounts = [...countByYear.entries()]
+        .map(([year, datasetCount]) => ({ year, datasetCount }))
+        .sort((left, right) => left.year.localeCompare(right.year));
+    return {
+        datasetCount: records.length,
+        nationalStatisticCount,
+        unflaggedCount,
+        yearCounts,
+    };
+}
+/**
+ * Lists datasets from the ONS beta API catalogue.
+ *
+ * @param options - record limit and an optional fetch implementation
+ * @returns the catalogue records the endpoint returns
+ */
+export async function fetchOnsDatasets(options = {}) {
+    const { limit = ONS_DATASETS_LIMIT, fetchImpl = globalThis.fetch } = options;
+    const response = await fetchImpl(`https://api.beta.ons.gov.uk/v1/datasets?limit=${limit}`);
+    if (!response.ok) {
+        throw new UkSourceApiError('ons-datasets', `HTTP ${response.status} listing datasets`);
+    }
+    return parseOnsDatasets(await response.json());
+}
+/** ONS beta API dataset catalogue adapter, keyless. */
+export const onsDatasetsAdapter = {
+    id: 'ons-datasets',
+    name: 'Office for National Statistics dataset catalogue',
+    auth: 'none',
+    description: 'Every dataset the ONS beta API lists, with its state and last-updated stamp.',
+    fetchLive: (options) => fetchOnsDatasets(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    parse: parseOnsDatasets,
+    loadFixture: () => parseOnsDatasets(readFixtureJson('ons-datasets.json')),
+};
+//# sourceMappingURL=onsDatasets.js.map

package/dist/onsDatasets.js.map

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

package/dist/parliamentSeats.d.ts

@@ -0,0 +1,115 @@
+import type { UkDataAdapter } from './types.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 declare const PARLIAMENT_SEATS_SOURCE_ID = "parliament-seats";
+/** Root every call here is built from. */
+export declare 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 declare 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 declare const PARLIAMENT_COMMONS_HOUSE = 1;
+/** The house number the API uses for the Lords. */
+export declare const PARLIAMENT_LORDS_HOUSE = 2;
+/** Which house a seat count belongs to. */
+export type ParliamentHouse = 'commons' | 'lords';
+/** One party as the Members API lists it, with the colours it publishes. */
+export interface ParliamentParty {
+    id: number;
+    name: string;
+    abbreviation: string;
+    /** Hex without the leading '#'. Null for the Speaker and a few others. */
+    backgroundColour: string | null;
+    /** Hex without the leading '#'. Null for the Speaker and a few others. */
+    foregroundColour: string | null;
+    isIndependent: boolean;
+}
+/** One party's seats, with the member counts the API reports behind them. */
+export interface ParliamentPartySeats {
+    party: ParliamentParty;
+    seatCount: number;
+    maleCount: number;
+    femaleCount: number;
+    nonBinaryCount: number;
+    /**
+     * Seats the API counts for the party but name no member. That is the vacant
+     * seat, and it is zero for every other row.
+     */
+    unallocatedSeatCount: number;
+}
+/** The state of the parties on one date, rolled up into the numbers a page prints. */
+export interface ParliamentSeatSummary {
+    /** Seats the house holds: 650 in the Commons while every seat is filled. */
+    seatCount: number;
+    partyCount: number;
+    /** Seats a party needs to hold more than half the house: 326 of 650. */
+    majorityThreshold: number;
+    partiesWithOneSeat: number;
+    /** Parties, largest first, ties broken by name. */
+    seats: ParliamentPartySeats[];
+    largestParty: ParliamentPartySeats;
+}
+/**
+ * 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 declare function formatParliamentQueryDate(date: Date): string;
+/**
+ * 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 declare function buildParliamentSeatsUrl(house: number, forDate: string): string;
+/**
+ * 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 declare function parseParliamentPartySeats(payload: unknown): ParliamentPartySeats[];
+/**
+ * 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 declare function summarizeParliamentPartySeats(seats: ParliamentPartySeats[]): ParliamentSeatSummary;
+/**
+ * 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 declare function parseParliamentSeats(payload: unknown): ParliamentSeatSummary;
+/**
+ * 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 declare function fetchParliamentSeats(options?: {
+    house?: number;
+    forDate?: string;
+    now?: Date;
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<ParliamentSeatSummary>;
+/** UK Parliament state of the parties, keyless. */
+export declare const parliamentSeatsAdapter: UkDataAdapter<ParliamentSeatSummary>;
+//# sourceMappingURL=parliamentSeats.d.ts.map

package/dist/parliamentSeats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parliamentSeats.d.ts","sourceRoot":"","sources":["../src/parliamentSeats.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,qBAAqB,CAAC;AAE7D,0CAA0C;AAC1C,eAAO,MAAM,+BAA+B,0CAA0C,CAAC;AAEvF,kEAAkE;AAClE,eAAO,MAAM,gCAAgC,8BAA8B,CAAC;AAE5E;;;GAGG;AACH,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C,mDAAmD;AACnD,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC,2CAA2C;AAC3C,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,OAAO,CAAC;AAElD,4EAA4E;AAC5E,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,0EAA0E;IAC1E,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,6EAA6E;AAC7E,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,eAAe,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,sFAAsF;AACtF,MAAM,WAAW,qBAAqB;IACpC,4EAA4E;IAC5E,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mDAAmD;IACnD,KAAK,EAAE,oBAAoB,EAAE,CAAC;IAC9B,YAAY,EAAE,oBAAoB,CAAC;CACpC;AAuBD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAO5D;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE9E;AA+CD;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,oBAAoB,EAAE,CAyBlF;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,oBAAoB,EAAE,GAC5B,qBAAqB,CAuBvB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,qBAAqB,CAE5E;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CAChC,GACL,OAAO,CAAC,qBAAqB,CAAC,CAUhC;AAED,mDAAmD;AACnD,eAAO,MAAM,sBAAsB,EAAE,aAAa,CAAC,qBAAqB,CAUvE,CAAC"}