/** * Adapter for CSO PxStat table EBA02 "Domestic Building Energy Rating" — * annual counts of BER certificates by rating, area, and period of * construction. CC-BY 4.0. This gives area/era-typical BER context; it can * never tell you a specific home's rating (SPEC §4.7). * * Matrix and dimension codes pinned 2026-07-11 from * `PxStat.Data.Cube_API.ReadMetadata/EBA02/JSON-stat/2.0/en` (table last * updated 2026-05-01). Dimensions: STATISTIC × Year (TLIST(A1), 2009–2026) * × BER Rating (C03440V04149) × Dwelling Type (C03151V03803) × Main Space * Heating Fuel (C03442V04151) × Period of Construction (C03441V04150) × * County/Dublin Postal District (C03444V04153). The full cube is too large * to fetch, so we use the JSON-RPC endpoint with a dimension filter. */ /** Area labels exactly as published in EBA02 (code → label), pinned 2026-07-11. */ export declare const AREA_LABELS: Record; /** Construction periods as published (label → code), pinned 2026-07-11. */ export declare const PERIOD_CODES: Record; export declare const BER_GRADES: readonly ["A1", "A2", "A3", "B1", "B2", "B3", "C", "D", "E", "F-G"]; /** * Resolve free-text area input ("dublin 9", "D6W", "co cork", "Galway City") * to an EBA02 area code. Returns null when nothing matches. */ export declare function resolveAreaCode(input: string): string | null; export interface BerDistribution { area_label: string; period_of_construction: string; certificates_total: number; audit_years: string; distribution: Array<{ grade: string; certificates: number; share_pct: number | null; }>; } /** * Fetch the BER grade distribution for an area (+ optional construction * period), aggregated across all audit years in the table. Cached 30d. */ export declare function queryBerDistribution(areaCode: string, periodCode: string, // "-" for all fetchImpl?: typeof fetch): Promise; export declare const CSO_BER_META: { readonly source: "CSO Ireland, table EBA02 'Domestic Building Energy Rating' (BER audits published by SEAI)"; readonly source_url: "https://data.cso.ie/table/EBA02"; readonly licence: "CC-BY 4.0 (data.gov.ie / CSO PxStat)"; readonly data_vintage: "Annual table, last updated 2026-05-01; certificate counts by audit year 2009 onwards"; }; /** SEAI's public BER register — the only way to know a specific home's BER. */ export declare const SEAI_REGISTER_URL = "https://ndber.seai.ie/PASS/BER/Search.aspx";