npm - @uk-energy/neso - Versions diffs - 0.1.0 → 0.1.1 - Mend

@uk-energy/neso 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/CHANGELOG.md CHANGED Viewed

@@ -1,5 +1,10 @@
 # @uk-energy/neso
+## 0.1.1
+- The CKAN layer now lives in `@uk-energy/core` (`CkanClient`); `neso.ckan.*`, the helpers and
+  the `Ckan*` / `Datastore*` types are re-exported here, so nothing changes for callers.
 ## 0.1.0
 - `NesoClient` for the NESO Data Portal (CKAN 2.8): `ckan.*` (`packageShow`, `packageSearch`,

package/LICENSE CHANGED Viewed

@@ -1,21 +1,21 @@
-MIT License
-Copyright (c) 2026 Joshua Serpis
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+Copyright (c) 2026 Joshua Serpis
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs CHANGED Viewed

@@ -30,12 +30,10 @@ function financialYearInName(name) {
 function resourceForFinancialYear(resources, startYear) {
   return resources.find((r) => r.datastore_active && financialYearInName(r.name) === startYear);
 }
-// src/client.ts
 var BASE_URL = "https://api.neso.energy/api/3/action";
 var DEFAULT_RATE_LIMIT = { requestsPerSecond: 5, burst: 10 };
 var DEFAULT_CACHE_TTL_MS = 10 * 60 * 1e3;
-var MAX_PAGE_SIZE = 32e3;
+var MAX_PAGE_SIZE = core.CKAN_MAX_PAGE_SIZE;
 var PACKAGES = {
   thermalConstraintCosts: "thermal-constraint-costs",
   constraintBreakdown: "constraint-breakdown",
@@ -45,45 +43,6 @@ var PACKAGES = {
   dailyBalancingCosts: "daily-balancing-costs-balancing-services-use-of-system",
   demandFlexibility: "demand-flexibility"
 };
-var DECIMAL = /^-?\d+(\.\d+)?([eE][-+]?\d+)?$/;
-var NUMERIC_TYPES = /* @__PURE__ */ new Set([
-  "numeric",
-  "int4",
-  "int8",
-  "float8",
-  "float4",
-  "int",
-  "double precision"
-]);
-function normaliseRows(records, fields, extraNumeric = []) {
-  const numeric = new Set(extraNumeric);
-  for (const f of fields) if (NUMERIC_TYPES.has(f.type)) numeric.add(f.id);
-  return records.map((r) => {
-    const out = {};
-    for (const [k, v] of Object.entries(r)) {
-      if (k === "_full_text") continue;
-      if (numeric.has(k) && typeof v === "string" && DECIMAL.test(v.trim())) {
-        const n = Number(v);
-        out[k] = Number.isFinite(n) ? n : v;
-      } else {
-        out[k] = v;
-      }
-    }
-    return out;
-  });
-}
-function ident(name) {
-  return `"${name.replace(/"/g, '""')}"`;
-}
-function literal(value) {
-  return typeof value === "number" ? String(value) : `'${value.replace(/'/g, "''")}'`;
-}
-function rangeSql(resourceId, column, from, to, orderBy, opts = {}) {
-  const upper = opts.toExclusive ? "<" : "<=";
-  const extra = opts.where ? ` AND ${opts.where}` : "";
-  const order = orderBy.length ? ` ORDER BY ${orderBy.map(ident).join(", ")}` : "";
-  return `SELECT * FROM ${ident(resourceId)} WHERE ${ident(column)} >= ${literal(from)} AND ${ident(column)} ${upper} ${literal(to)}${extra}${order}`;
-}
 function localRange(from, to) {
   const f = core.londonDate(from);
   const t = core.londonDate(to);
@@ -97,8 +56,8 @@ function nextDay(date) {
 }
 var NesoClient = class {
   http;
-  packageCache = /* @__PURE__ */ new Map();
-  packageTtlMs;
+  /** Raw CKAN API (`@uk-energy/core` `CkanClient`): `packageShow` (memoised), `datastoreSearch`, `datastoreAll`, `sql`… */
+  ckan;
   constructor(opts = {}) {
     this.http = new core.HttpClient({
       baseUrl: BASE_URL,
@@ -106,91 +65,19 @@ var NesoClient = class {
       cacheTtlMs: opts.cache ? DEFAULT_CACHE_TTL_MS : 0,
       ...opts
     });
-    this.packageTtlMs = opts.cacheTtlMs ?? DEFAULT_CACHE_TTL_MS;
+    this.ckan = new core.CkanClient(this.http, {
+      packageTtlMs: opts.cacheTtlMs ?? DEFAULT_CACHE_TTL_MS,
+      maxPageSize: MAX_PAGE_SIZE
+    });
   }
   /** Any CKAN action; unwraps `{ success, result }` and throws `UkEnergyError` on `success: false`. */
   async action(name, query) {
-    const res = await this.http.get(name, query);
-    if (!res || typeof res !== "object" || !("success" in res)) {
-      throw new core.UkEnergyError(`Unexpected response shape for ${name}`);
-    }
-    if (!res.success) {
-      throw new core.UkEnergyError(`${name}: ${res.error?.message ?? JSON.stringify(res.error)}`);
-    }
-    return res.result;
+    return this.ckan.action(name, query);
   }
-  /** Raw CKAN API. */
-  ckan = {
-    /** Dataset metadata and its resources (memoised for `cacheTtlMs`, default 10 minutes). */
-    packageShow: async (id) => {
-      const hit = this.packageCache.get(id);
-      if (hit && Date.now() - hit.at < this.packageTtlMs) return hit.value;
-      const value = this.action("package_show", { id }).then((pkg) => {
-        if (!pkg || !Array.isArray(pkg.resources)) {
-          throw new core.UkEnergyError(`package_show: unexpected shape for ${id}`);
-        }
-        return pkg;
-      });
-      this.packageCache.set(id, { at: Date.now(), value });
-      value.catch(() => this.packageCache.delete(id));
-      return value;
-    },
-    /** Search datasets by free text. */
-    packageSearch: async (q, rows = 20) => this.action("package_search", { q, rows }),
-    resourceShow: async (id) => this.action("resource_show", { id }),
-    /** One page of a datastore resource (up to 32,000 rows). Rows are normalised (see `normaliseRows`). */
-    datastoreSearch: async (resourceId, opts = {}) => {
-      const query = {
-        resource_id: resourceId,
-        limit: opts.limit ?? MAX_PAGE_SIZE,
-        sort: opts.sort ?? "_id"
-      };
-      if (opts.offset !== void 0) query.offset = opts.offset;
-      if (opts.filters) query.filters = JSON.stringify(opts.filters);
-      if (opts.fields) query.fields = opts.fields.join(",");
-      if (opts.q) query.q = opts.q;
-      const res = await this.action("datastore_search", query);
-      if (!Array.isArray(res?.records)) {
-        throw new core.UkEnergyError("Unexpected response shape for datastore_search");
-      }
-      return { ...res, records: normaliseRows(res.records, res.fields ?? []) };
-    },
-    /** Every row of a datastore resource, paging by `limit` (default 32,000). */
-    datastoreAll: async (resourceId, opts = {}) => {
-      const pageSize = Math.min(opts.limit ?? MAX_PAGE_SIZE, MAX_PAGE_SIZE);
-      const out = [];
-      for await (const page of core.pages({
-        fetchPage: (offset) => this.ckan.datastoreSearch(resourceId, {
-          ...opts,
-          limit: pageSize,
-          offset: offset ?? 0
-        }),
-        items: (p) => p.records,
-        nextCursor: core.offsetCursor(pageSize, (p) => p.records.length)
-      })) {
-        out.push(...page.records);
-      }
-      return out;
-    },
-    /**
-     * `datastore_search_sql`: read-only PostgreSQL over the datastore. Resource ids are the
-     * table names (quote them). Numeric columns come back as strings from this endpoint; they
-     * are converted using the `fields` types, and `_full_text` is dropped.
-     */
-    sql: async (sql, extraNumeric = []) => {
-      const res = await this.action("datastore_search_sql", {
-        sql
-      });
-      if (!Array.isArray(res?.records)) {
-        throw new core.UkEnergyError("Unexpected response shape for datastore_search_sql");
-      }
-      return normaliseRows(res.records, res.fields ?? [], extraNumeric);
-    }
-  };
   /** Resolving resources inside datasets. */
   resources = {
     /** All datastore-backed resources of a dataset. */
-    datastore: async (packageId) => (await this.ckan.packageShow(packageId)).resources.filter((r) => r.datastore_active),
+    datastore: async (packageId) => this.ckan.datastoreResources(packageId),
     /** The resource for a GB financial year (`2025` = April 2025 – March 2026), by name. */
     forFinancialYear: async (packageId, startYear) => {
       const pkg = await this.ckan.packageShow(packageId);
@@ -203,14 +90,7 @@ var NesoClient = class {
       return r;
     },
     /** The datastore resource whose name matches exactly (or the regex), e.g. "DFS Utilisation Report". */
-    byName: async (packageId, name) => {
-      const list = await this.resources.datastore(packageId);
-      const r = list.find(
-        (x) => typeof name === "string" ? x.name.trim() === name.trim() : name.test(x.name)
-      );
-      if (!r) throw new core.UkEnergyError(`${packageId}: no datastore resource named ${String(name)}`);
-      return r;
-    }
+    byName: async (packageId, name) => this.ckan.resourceByName(packageId, name)
   };
   /** Rows of a per-financial-year dataset for an inclusive date range, across year boundaries. */
   async byFinancialYear(packageId, column, range, orderBy, opts = {}) {
@@ -218,7 +98,7 @@ var NesoClient = class {
     const out = [];
     for (const fy of financialYearsBetween(from, to)) {
       const resource = await this.resources.forFinancialYear(packageId, fy);
-      const sql = rangeSql(resource.id, column, from, to, orderBy, { where: opts.where });
+      const sql = core.rangeSql(resource.id, column, from, to, orderBy, { where: opts.where });
       out.push(...await this.ckan.sql(sql, opts.extraNumeric));
     }
     return out;
@@ -235,7 +115,7 @@ var NesoClient = class {
       "Settlement Date",
       { from, to },
       ["Settlement Date", "Constraint Group"],
-      constraintGroup ? { where: `${ident("Constraint Group")} = ${literal(constraintGroup)}` } : {}
+      constraintGroup ? { where: `${core.ident("Constraint Group")} = ${core.literal(constraintGroup)}` } : {}
     ),
     /**
      * Daily constraint cost (£) and volume (MWh) by type: thermal, voltage, inertia, largest
@@ -262,7 +142,7 @@ var NesoClient = class {
     dayAheadFlows: async (from, to, constraintGroup) => {
       const [f, t] = localRange(from, to);
       const r = await this.resources.byName(PACKAGES.dayAheadConstraintFlows, /Flows and Limits/);
-      const sql = rangeSql(
+      const sql = core.rangeSql(
         r.id,
         "Date_ Time GMT_BST",
         `${f}T00:00:00`,
@@ -270,7 +150,7 @@ var NesoClient = class {
         ["Constraint Group", "Date_ Time GMT_BST"],
         {
           toExclusive: true,
-          where: constraintGroup ? `${ident("Constraint Group")} = ${literal(constraintGroup)}` : void 0
+          where: constraintGroup ? `${core.ident("Constraint Group")} = ${core.literal(constraintGroup)}` : void 0
         }
       );
       return this.ckan.sql(sql);
@@ -303,10 +183,26 @@ var NesoClient = class {
   async dfsRange(name, from, to, orderBy) {
     const [f, t] = localRange(from, to);
     const r = await this.resources.byName(PACKAGES.demandFlexibility, name);
-    return this.ckan.sql(rangeSql(r.id, "Delivery Date", f, t, orderBy));
+    return this.ckan.sql(core.rangeSql(r.id, "Delivery Date", f, t, orderBy));
   }
 };
+Object.defineProperty(exports, "ident", {
+  enumerable: true,
+  get: function () { return core.ident; }
+});
+Object.defineProperty(exports, "literal", {
+  enumerable: true,
+  get: function () { return core.literal; }
+});
+Object.defineProperty(exports, "normaliseRows", {
+  enumerable: true,
+  get: function () { return core.normaliseRows; }
+});
+Object.defineProperty(exports, "rangeSql", {
+  enumerable: true,
+  get: function () { return core.rangeSql; }
+});
 exports.BASE_URL = BASE_URL;
 exports.DEFAULT_CACHE_TTL_MS = DEFAULT_CACHE_TTL_MS;
 exports.DEFAULT_RATE_LIMIT = DEFAULT_RATE_LIMIT;
@@ -316,10 +212,6 @@ exports.PACKAGES = PACKAGES;
 exports.financialYearInName = financialYearInName;
 exports.financialYearOf = financialYearOf;
 exports.financialYearsBetween = financialYearsBetween;
-exports.ident = ident;
-exports.literal = literal;
-exports.normaliseRows = normaliseRows;
-exports.rangeSql = rangeSql;
 exports.resourceForFinancialYear = resourceForFinancialYear;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/resources.ts","../src/client.ts"],"names":["londonDate","UkEnergyError","HttpClient","pages","offsetCursor"],"mappings":"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","file":"index.cjs","sourcesContent":["/*\n Financial-year arithmetic and resource-name matching for datasets split one resource per\n * GB financial year (1 April – 31 March): \"Thermal Constraint Costs Data 25-26\",\n * \"Constraint Breakdown 2025-2026\", \"Daily Balancing Costs 2025-2026\".\n /\nimport type { CkanResource } from \"./types.js\";\n\n/* Financial year a date (\"YYYY-MM-DD\") falls in, as its starting calendar year. /\nexport function financialYearOf(date: string): number {\n const year = Number(date.slice(0, 4));\n const month = Number(date.slice(5, 7));\n return month >= 4 ? year : year - 1;\n}\n\n/* Starting years of every financial year touched by an inclusive date range. /\nexport function financialYearsBetween(from: string, to: string): number[] {\n const first = financialYearOf(from);\n const last = financialYearOf(to);\n const out: number[] = [];\n for (let y = first; y <= last; y++) out.push(y);\n return out;\n}\n\nconst YEAR_SPAN = /(?<!\\d)(\\d{4}\|\\d{2})\\s[-/–]\\s(\\d{4}\|\\d{2})(?!\\d)/g;\n\n/* The financial year a resource name refers to (\"25-26\" / \"2025-2026\" → 2025), or undefined. /\nexport function financialYearInName(name: string): number \| undefined {\n for (const m of name.matchAll(YEAR_SPAN)) {\n if (!m[1] \|\| !m[2]) continue;\n const start = m[1].length === 2 ? 2000 + Number(m[1]) : Number(m[1]);\n const end = m[2].length === 2 ? 2000 + Number(m[2]) : Number(m[2]);\n if (end === start + 1) return start;\n }\n return undefined;\n}\n\n/* The datastore resource of a dataset for one financial year, if any. /\nexport function resourceForFinancialYear(\n resources: readonly CkanResource[],\n startYear: number,\n): CkanResource \| undefined {\n return resources.find((r) => r.datastore_active && financialYearInName(r.name) === startYear);\n}\n","/\n Client for the NESO Data Portal (https://www.neso.energy/data-portal), a CKAN 2.8 instance at\n * https://api.neso.energy/api/3/action/. No API key. Datasets (\"packages\") hold \"resources\";\n * tabular resources are loaded into a Postgres datastore that `datastore_search` and\n * `datastore_search_sql` query. Many datasets split one resource per GB financial year\n * (April–March), so the helpers resolve the right resource(s) for a date range.\n \n const neso = new NesoClient();\n * const costs = await neso.constraints.thermalCosts(\"2025-04-01\", \"2025-04-07\"); // £/day per boundary\n * const dfs = await neso.dfs.summary(\"2026-10-20\", \"2026-10-22\");\n * const rows = await neso.ckan.sql(`SELECT * FROM \"407f3e9d-…\" WHERE \"Settlement Date\" = '2025-04-01'`);\n \n Licence: National Energy SO Open Data Licence v1.0 (OGL v3 based): copy, adapt, use\n * commercially, with the attribution \"Supported by National Energy SO Open Data\".\n /\nimport {\n type DateInput,\n HttpClient,\n type HttpClientOptions,\n londonDate,\n offsetCursor,\n pages,\n type Query,\n type RateLimit,\n UkEnergyError,\n} from \"@uk-energy/core\";\nimport { financialYearsBetween, resourceForFinancialYear } from \"./resources.js\";\nimport type {\n CkanPackage,\n CkanPackageSearch,\n CkanResource,\n CkanResponse,\n ConstraintBreakdownRow,\n ConstraintForecastRow,\n ConstraintLimitRow,\n DailyBalancingCostRow,\n DatastoreField,\n DatastoreRow,\n DatastoreSearchOptions,\n DatastoreSearchResult,\n DatastoreSqlResult,\n DayAheadFlowRow,\n DfsRequirementRow,\n DfsSummaryRow,\n DfsUtilisationRow,\n ThermalConstraintCostRow,\n} from \"./types.js\";\n\nexport const BASE_URL = \"https://api.neso.energy/api/3/action\";\n\n/\n No limit is published; the licence only reserves the right to throttle \"excessive use\".\n * 5 rps / burst 10 is comfortably polite for a shared public CKAN.\n /\nexport const DEFAULT_RATE_LIMIT: RateLimit = { requestsPerSecond: 5, burst: 10 };\n\n/* Resources update daily or weekly; package metadata is memoised for this long. /\nexport const DEFAULT_CACHE_TTL_MS = 10 60 * 1000;\n\n/** The portal returns up to this many rows per `datastore_search` page. /\nexport const MAX_PAGE_SIZE = 32_000;\n\n/* Dataset (package) names on the portal that the helpers use. /\nexport const PACKAGES = {\n thermalConstraintCosts: \"thermal-constraint-costs\",\n constraintBreakdown: \"constraint-breakdown\",\n constraintCostForecast24m: \"24-months-ahead-constraint-cost-forecast\",\n constraintLimits24m: \"24-months-ahead-constraint-limits\",\n dayAheadConstraintFlows: \"day-ahead-constraint-flows-and-limits\",\n dailyBalancingCosts: \"daily-balancing-costs-balancing-services-use-of-system\",\n demandFlexibility: \"demand-flexibility\",\n} as const;\n\nexport interface NesoClientOptions extends Omit<HttpClientOptions, \"baseUrl\"> {\n baseUrl?: string;\n}\n\n/* Inclusive date range; strings are \"YYYY-MM-DD\", `Date`s are GB-local calendar days. /\ninterface DateRange {\n from: DateInput;\n to: DateInput;\n}\n\nconst DECIMAL = /^-?\\d+(\\.\\d+)?([eE][-+]?\\d+)?$/;\n\nconst NUMERIC_TYPES = new Set([\n \"numeric\",\n \"int4\",\n \"int8\",\n \"float8\",\n \"float4\",\n \"int\",\n \"double precision\",\n]);\n\n/\n The SQL endpoint returns `numeric` columns as strings (\"252\"); `datastore_search` returns\n * numbers. Make rows consistent: numeric-typed columns become numbers, `_full_text` goes.\n /\nexport function normaliseRows<Row extends object>(\n records: readonly DatastoreRow[],\n fields: readonly DatastoreField[],\n extraNumeric: readonly string[] = [],\n): Row[] {\n const numeric = new Set(extraNumeric);\n for (const f of fields) if (NUMERIC_TYPES.has(f.type)) numeric.add(f.id);\n return records.map((r) => {\n const out: DatastoreRow = {};\n for (const [k, v] of Object.entries(r)) {\n if (k === \"_full_text\") continue;\n if (numeric.has(k) && typeof v === \"string\" && DECIMAL.test(v.trim())) {\n const n = Number(v);\n out[k] = Number.isFinite(n) ? n : v;\n } else {\n out[k] = v;\n }\n }\n return out as Row;\n });\n}\n\n/* Double-quote an identifier for the SQL endpoint. /\nexport function ident(name: string): string {\n return `\"${name.replace(/\"/g, '\"\"')}\"`;\n}\n\n/* Single-quote a literal for the SQL endpoint. /\nexport function literal(value: string \| number): string {\n return typeof value === \"number\" ? String(value) : `'${value.replace(/'/g, \"''\")}'`;\n}\n\n/\n `SELECT * FROM \"resource\" WHERE \"col\" >= 'from' AND \"col\" <= 'to' ORDER BY …` — the shape\n * every date-range helper uses. `toExclusive` switches the upper bound to `<` for timestamps.\n /\nexport function rangeSql(\n resourceId: string,\n column: string,\n from: string,\n to: string,\n orderBy: readonly string[],\n opts: { toExclusive?: boolean; where?: string \| undefined } = {},\n): string {\n const upper = opts.toExclusive ? \"<\" : \"<=\";\n const extra = opts.where ? ` AND ${opts.where}` : \"\";\n const order = orderBy.length ? ` ORDER BY ${orderBy.map(ident).join(\", \")}` : \"\";\n return `SELECT FROM ${ident(resourceId)} WHERE ${ident(column)} >= ${literal(from)} AND ${ident(column)} ${upper} ${literal(to)}${extra}${order}`;\n}\n\n/** Inclusive GB-local date range: `Date`s are read as Europe/London calendar days. /\nfunction localRange(from: DateInput, to: DateInput): [string, string] {\n const f = londonDate(from);\n const t = londonDate(to);\n if (f > t) throw new UkEnergyError(`from (${f}) is after to (${t})`);\n return [f, t];\n}\n\nfunction nextDay(date: string): string {\n const d = new Date(`${date}T00:00:00Z`);\n d.setUTCDate(d.getUTCDate() + 1);\n return d.toISOString().slice(0, 10);\n}\n\nexport class NesoClient {\n readonly http: HttpClient;\n private readonly packageCache = new Map<string, { at: number; value: Promise<CkanPackage> }>();\n private readonly packageTtlMs: number;\n\n constructor(opts: NesoClientOptions = {}) {\n this.http = new HttpClient({\n baseUrl: BASE_URL,\n rateLimit: DEFAULT_RATE_LIMIT,\n cacheTtlMs: opts.cache ? DEFAULT_CACHE_TTL_MS : 0,\n ...opts,\n });\n this.packageTtlMs = opts.cacheTtlMs ?? DEFAULT_CACHE_TTL_MS;\n }\n\n /* Any CKAN action; unwraps `{ success, result }` and throws `UkEnergyError` on `success: false`. /\n async action<T>(name: string, query?: Query): Promise<T> {\n const res = await this.http.get<CkanResponse<T>>(name, query);\n if (!res \|\| typeof res !== \"object\" \|\| !(\"success\" in res)) {\n throw new UkEnergyError(`Unexpected response shape for ${name}`);\n }\n if (!res.success) {\n throw new UkEnergyError(`${name}: ${res.error?.message ?? JSON.stringify(res.error)}`);\n }\n return res.result;\n }\n\n /* Raw CKAN API. /\n readonly ckan = {\n /* Dataset metadata and its resources (memoised for `cacheTtlMs`, default 10 minutes). /\n packageShow: async (id: string): Promise<CkanPackage> => {\n const hit = this.packageCache.get(id);\n if (hit && Date.now() - hit.at < this.packageTtlMs) return hit.value;\n const value = this.action<CkanPackage>(\"package_show\", { id }).then((pkg) => {\n if (!pkg \|\| !Array.isArray(pkg.resources)) {\n throw new UkEnergyError(`package_show: unexpected shape for ${id}`);\n }\n return pkg;\n });\n this.packageCache.set(id, { at: Date.now(), value });\n value.catch(() => this.packageCache.delete(id));\n return value;\n },\n /* Search datasets by free text. /\n packageSearch: async (q: string, rows = 20): Promise<CkanPackageSearch> =>\n this.action(\"package_search\", { q, rows }),\n resourceShow: async (id: string): Promise<CkanResource> => this.action(\"resource_show\", { id }),\n /* One page of a datastore resource (up to 32,000 rows). Rows are normalised (see `normaliseRows`). /\n datastoreSearch: async <Row extends object = DatastoreRow>(\n resourceId: string,\n opts: DatastoreSearchOptions = {},\n ): Promise<DatastoreSearchResult<Row>> => {\n const query: Query = {\n resource_id: resourceId,\n limit: opts.limit ?? MAX_PAGE_SIZE,\n sort: opts.sort ?? \"_id\",\n };\n if (opts.offset !== undefined) query.offset = opts.offset;\n if (opts.filters) query.filters = JSON.stringify(opts.filters);\n if (opts.fields) query.fields = opts.fields.join(\",\");\n if (opts.q) query.q = opts.q;\n const res = await this.action<DatastoreSearchResult<DatastoreRow>>(\"datastore_search\", query);\n if (!Array.isArray(res?.records)) {\n throw new UkEnergyError(\"Unexpected response shape for datastore_search\");\n }\n return { ...res, records: normaliseRows<Row>(res.records, res.fields ?? []) };\n },\n /* Every row of a datastore resource, paging by `limit` (default 32,000). /\n datastoreAll: async <Row extends object = DatastoreRow>(\n resourceId: string,\n opts: Omit<DatastoreSearchOptions, \"offset\"> = {},\n ): Promise<Row[]> => {\n const pageSize = Math.min(opts.limit ?? MAX_PAGE_SIZE, MAX_PAGE_SIZE);\n const out: Row[] = [];\n for await (const page of pages<DatastoreSearchResult<Row>, Row, number>({\n fetchPage: (offset) =>\n this.ckan.datastoreSearch<Row>(resourceId, {\n ...opts,\n limit: pageSize,\n offset: offset ?? 0,\n }),\n items: (p) => p.records,\n nextCursor: offsetCursor(pageSize, (p) => p.records.length),\n })) {\n out.push(...page.records);\n }\n return out;\n },\n /\n `datastore_search_sql`: read-only PostgreSQL over the datastore. Resource ids are the\n * table names (quote them). Numeric columns come back as strings from this endpoint; they\n * are converted using the `fields` types, and `_full_text` is dropped.\n /\n sql: async <Row extends object = DatastoreRow>(\n sql: string,\n extraNumeric: readonly string[] = [],\n ): Promise<Row[]> => {\n const res = await this.action<DatastoreSqlResult<DatastoreRow>>(\"datastore_search_sql\", {\n sql,\n });\n if (!Array.isArray(res?.records)) {\n throw new UkEnergyError(\"Unexpected response shape for datastore_search_sql\");\n }\n return normaliseRows<Row>(res.records, res.fields ?? [], extraNumeric);\n },\n };\n\n /* Resolving resources inside datasets. /\n readonly resources = {\n /* All datastore-backed resources of a dataset. /\n datastore: async (packageId: string): Promise<CkanResource[]> =>\n (await this.ckan.packageShow(packageId)).resources.filter((r) => r.datastore_active),\n /* The resource for a GB financial year (`2025` = April 2025 – March 2026), by name. /\n forFinancialYear: async (packageId: string, startYear: number): Promise<CkanResource> => {\n const pkg = await this.ckan.packageShow(packageId);\n const r = resourceForFinancialYear(pkg.resources, startYear);\n if (!r) {\n throw new UkEnergyError(\n `${packageId}: no datastore resource for financial year ${startYear}/${(startYear + 1) % 100}`,\n );\n }\n return r;\n },\n /* The datastore resource whose name matches exactly (or the regex), e.g. \"DFS Utilisation Report\". /\n byName: async (packageId: string, name: string \| RegExp): Promise<CkanResource> => {\n const list = await this.resources.datastore(packageId);\n const r = list.find((x) =>\n typeof name === \"string\" ? x.name.trim() === name.trim() : name.test(x.name),\n );\n if (!r) throw new UkEnergyError(`${packageId}: no datastore resource named ${String(name)}`);\n return r;\n },\n };\n\n /* Rows of a per-financial-year dataset for an inclusive date range, across year boundaries. /\n private async byFinancialYear<Row extends object>(\n packageId: string,\n column: string,\n range: DateRange,\n orderBy: readonly string[],\n opts: { where?: string \| undefined; extraNumeric?: readonly string[] } = {},\n ): Promise<Row[]> {\n const [from, to] = localRange(range.from, range.to);\n const out: Row[] = [];\n for (const fy of financialYearsBetween(from, to)) {\n const resource = await this.resources.forFinancialYear(packageId, fy);\n const sql = rangeSql(resource.id, column, from, to, orderBy, { where: opts.where });\n out.push(...(await this.ckan.sql<Row>(sql, opts.extraNumeric)));\n }\n return out;\n }\n\n /* Transmission constraint costs and forecasts. /\n readonly constraints = {\n /\n Thermal constraint cost per boundary per day (£), `thermal-constraint-costs`. One row per\n * constraint group per settlement date, e.g. SCOTEX, SSHARN, SEIMP (Scottish export\n * boundaries), ESTEX, SWALEX.\n /\n thermalCosts: async (\n from: DateInput,\n to: DateInput,\n constraintGroup?: string,\n ): Promise<ThermalConstraintCostRow[]> =>\n this.byFinancialYear(\n PACKAGES.thermalConstraintCosts,\n \"Settlement Date\",\n { from, to },\n [\"Settlement Date\", \"Constraint Group\"],\n constraintGroup\n ? { where: `${ident(\"Constraint Group\")} = ${literal(constraintGroup)}` }\n : {},\n ),\n /\n Daily constraint cost (£) and volume (MWh) by type: thermal, voltage, inertia, largest\n * loss (`constraint-breakdown`). Thermal volume is negative (energy turned down).\n /\n breakdown: async (from: DateInput, to: DateInput): Promise<ConstraintBreakdownRow[]> =>\n this.byFinancialYear(PACKAGES.constraintBreakdown, \"Date\", { from, to }, [\"Date\"], {\n // \"Thermal constraints cost\" is typed text in some years\n extraNumeric: [\"Thermal constraints cost\"],\n }),\n /* NESO's 24-month-ahead constraint cost forecast, £m per month (24 rows). /\n forecast24m: async (): Promise<ConstraintForecastRow[]> => {\n const r = await this.resources.byName(PACKAGES.constraintCostForecast24m, /Forecast/);\n return this.ckan.datastoreAll<ConstraintForecastRow>(r.id);\n },\n /* 24-month-ahead boundary limits (MW) per week; boundary columns vary by publication. /\n limits24m: async (): Promise<ConstraintLimitRow[]> => {\n const r = await this.resources.byName(PACKAGES.constraintLimits24m, /limits/i);\n return this.ckan.datastoreAll<ConstraintLimitRow>(r.id);\n },\n /\n Day-ahead forecast flow vs limit per boundary, half-hourly, for a range of local dates\n * (`day-ahead-constraint-flows-and-limits`, ~750k rows, so always filtered by SQL).\n /\n dayAheadFlows: async (\n from: DateInput,\n to: DateInput,\n constraintGroup?: string,\n ): Promise<DayAheadFlowRow[]> => {\n const [f, t] = localRange(from, to);\n const r = await this.resources.byName(PACKAGES.dayAheadConstraintFlows, /Flows and Limits/);\n const sql = rangeSql(\n r.id,\n \"Date_ Time GMT_BST\",\n `${f}T00:00:00`,\n `${nextDay(t)}T00:00:00`,\n [\"Constraint Group\", \"Date_ Time GMT_BST\"],\n {\n toExclusive: true,\n where: constraintGroup\n ? `${ident(\"Constraint Group\")} = ${literal(constraintGroup)}`\n : undefined,\n },\n );\n return this.ckan.sql<DayAheadFlowRow>(sql);\n },\n /* Daily balancing (BSUoS) costs per settlement period by category, incl. `Constraints` (£). /\n dailyBalancingCosts: async (from: DateInput, to: DateInput): Promise<DailyBalancingCostRow[]> =>\n this.byFinancialYear(PACKAGES.dailyBalancingCosts, \"SETT_DATE\", { from, to }, [\n \"SETT_DATE\",\n \"SETT_PERIOD\",\n ]),\n };\n\n /* Demand Flexibility Service (current season; archives are separate resources). /\n readonly dfs = {\n /* Published requirements per event window, by delivery date. /\n requirements: async (from: DateInput, to: DateInput): Promise<DfsRequirementRow[]> =>\n this.dfsRange<DfsRequirementRow>(\"DFS Service Requirement\", from, to, [\n \"Event ID\",\n \"From_UTC\",\n ]),\n /* Accepted/rejected bids per participant unit per event window. /\n utilisation: async (from: DateInput, to: DateInput): Promise<DfsUtilisationRow[]> =>\n this.dfsRange<DfsUtilisationRow>(\"DFS Utilisation Report\", from, to, [\n \"Event ID\",\n \"From_UTC\",\n \"DFS Unit ID\",\n ]),\n /* Procured MW, accepted cost and settled volume/cost per event window. */\n summary: async (from: DateInput, to: DateInput): Promise<DfsSummaryRow[]> =>\n this.dfsRange<DfsSummaryRow>(\"DFS Utilisation Report Summary\", from, to, [\n \"Event ID\",\n \"From_UTC\",\n ]),\n };\n\n private async dfsRange<Row extends object>(\n name: string,\n from: DateInput,\n to: DateInput,\n orderBy: readonly string[],\n ): Promise<Row[]> {\n const [f, t] = localRange(from, to);\n const r = await this.resources.byName(PACKAGES.demandFlexibility, name);\n return this.ckan.sql<Row>(rangeSql(r.id, \"Delivery Date\", f, t, orderBy));\n }\n}\n"]}
1	+ {"version":3,"sources":["../src/resources.ts","../src/client.ts"],"names":["CKAN_MAX_PAGE_SIZE","londonDate","UkEnergyError","HttpClient","CkanClient","rangeSql","ident","literal"],"mappings":"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","file":"index.cjs","sourcesContent":["/*\n Financial-year arithmetic and resource-name matching for datasets split one resource per\n * GB financial year (1 April – 31 March): \"Thermal Constraint Costs Data 25-26\",\n * \"Constraint Breakdown 2025-2026\", \"Daily Balancing Costs 2025-2026\".\n /\nimport type { CkanResource } from \"./types.js\";\n\n/* Financial year a date (\"YYYY-MM-DD\") falls in, as its starting calendar year. /\nexport function financialYearOf(date: string): number {\n const year = Number(date.slice(0, 4));\n const month = Number(date.slice(5, 7));\n return month >= 4 ? year : year - 1;\n}\n\n/* Starting years of every financial year touched by an inclusive date range. /\nexport function financialYearsBetween(from: string, to: string): number[] {\n const first = financialYearOf(from);\n const last = financialYearOf(to);\n const out: number[] = [];\n for (let y = first; y <= last; y++) out.push(y);\n return out;\n}\n\nconst YEAR_SPAN = /(?<!\\d)(\\d{4}\|\\d{2})\\s[-/–]\\s(\\d{4}\|\\d{2})(?!\\d)/g;\n\n/* The financial year a resource name refers to (\"25-26\" / \"2025-2026\" → 2025), or undefined. /\nexport function financialYearInName(name: string): number \| undefined {\n for (const m of name.matchAll(YEAR_SPAN)) {\n if (!m[1] \|\| !m[2]) continue;\n const start = m[1].length === 2 ? 2000 + Number(m[1]) : Number(m[1]);\n const end = m[2].length === 2 ? 2000 + Number(m[2]) : Number(m[2]);\n if (end === start + 1) return start;\n }\n return undefined;\n}\n\n/* The datastore resource of a dataset for one financial year, if any. /\nexport function resourceForFinancialYear(\n resources: readonly CkanResource[],\n startYear: number,\n): CkanResource \| undefined {\n return resources.find((r) => r.datastore_active && financialYearInName(r.name) === startYear);\n}\n","/\n Client for the NESO Data Portal (https://www.neso.energy/data-portal), a CKAN 2.8 instance at\n * https://api.neso.energy/api/3/action/. No API key. Datasets (\"packages\") hold \"resources\";\n * tabular resources are loaded into a Postgres datastore that `datastore_search` and\n * `datastore_search_sql` query. Many datasets split one resource per GB financial year\n * (April–March), so the helpers resolve the right resource(s) for a date range.\n \n const neso = new NesoClient();\n * const costs = await neso.constraints.thermalCosts(\"2025-04-01\", \"2025-04-07\"); // £/day per boundary\n * const dfs = await neso.dfs.summary(\"2026-10-20\", \"2026-10-22\");\n * const rows = await neso.ckan.sql(`SELECT * FROM \"407f3e9d-…\" WHERE \"Settlement Date\" = '2025-04-01'`);\n \n Licence: National Energy SO Open Data Licence v1.0 (OGL v3 based): copy, adapt, use\n * commercially, with the attribution \"Supported by National Energy SO Open Data\".\n /\nimport {\n CKAN_MAX_PAGE_SIZE,\n CkanClient,\n type CkanResource,\n type DateInput,\n HttpClient,\n type HttpClientOptions,\n ident,\n literal,\n londonDate,\n type Query,\n type RateLimit,\n rangeSql,\n UkEnergyError,\n} from \"@uk-energy/core\";\nimport { financialYearsBetween, resourceForFinancialYear } from \"./resources.js\";\nimport type {\n ConstraintBreakdownRow,\n ConstraintForecastRow,\n ConstraintLimitRow,\n DailyBalancingCostRow,\n DayAheadFlowRow,\n DfsRequirementRow,\n DfsSummaryRow,\n DfsUtilisationRow,\n ThermalConstraintCostRow,\n} from \"./types.js\";\n\nexport const BASE_URL = \"https://api.neso.energy/api/3/action\";\n\n/\n No limit is published; the licence only reserves the right to throttle \"excessive use\".\n * 5 rps / burst 10 is comfortably polite for a shared public CKAN.\n /\nexport const DEFAULT_RATE_LIMIT: RateLimit = { requestsPerSecond: 5, burst: 10 };\n\n/* Resources update daily or weekly; package metadata is memoised for this long. /\nexport const DEFAULT_CACHE_TTL_MS = 10 60 * 1000;\n\n/** The portal returns up to this many rows per `datastore_search` page. /\nexport const MAX_PAGE_SIZE = CKAN_MAX_PAGE_SIZE;\n\n/* Dataset (package) names on the portal that the helpers use. /\nexport const PACKAGES = {\n thermalConstraintCosts: \"thermal-constraint-costs\",\n constraintBreakdown: \"constraint-breakdown\",\n constraintCostForecast24m: \"24-months-ahead-constraint-cost-forecast\",\n constraintLimits24m: \"24-months-ahead-constraint-limits\",\n dayAheadConstraintFlows: \"day-ahead-constraint-flows-and-limits\",\n dailyBalancingCosts: \"daily-balancing-costs-balancing-services-use-of-system\",\n demandFlexibility: \"demand-flexibility\",\n} as const;\n\nexport interface NesoClientOptions extends Omit<HttpClientOptions, \"baseUrl\"> {\n baseUrl?: string;\n}\n\n/* Inclusive date range; strings are \"YYYY-MM-DD\", `Date`s are GB-local calendar days. /\ninterface DateRange {\n from: DateInput;\n to: DateInput;\n}\n\nexport { ident, literal, normaliseRows, rangeSql } from \"@uk-energy/core\";\n\n/* Inclusive GB-local date range: `Date`s are read as Europe/London calendar days. /\nfunction localRange(from: DateInput, to: DateInput): [string, string] {\n const f = londonDate(from);\n const t = londonDate(to);\n if (f > t) throw new UkEnergyError(`from (${f}) is after to (${t})`);\n return [f, t];\n}\n\nfunction nextDay(date: string): string {\n const d = new Date(`${date}T00:00:00Z`);\n d.setUTCDate(d.getUTCDate() + 1);\n return d.toISOString().slice(0, 10);\n}\n\nexport class NesoClient {\n readonly http: HttpClient;\n /* Raw CKAN API (`@uk-energy/core` `CkanClient`): `packageShow` (memoised), `datastoreSearch`, `datastoreAll`, `sql`… /\n readonly ckan: CkanClient;\n\n constructor(opts: NesoClientOptions = {}) {\n this.http = new HttpClient({\n baseUrl: BASE_URL,\n rateLimit: DEFAULT_RATE_LIMIT,\n cacheTtlMs: opts.cache ? DEFAULT_CACHE_TTL_MS : 0,\n ...opts,\n });\n this.ckan = new CkanClient(this.http, {\n packageTtlMs: opts.cacheTtlMs ?? DEFAULT_CACHE_TTL_MS,\n maxPageSize: MAX_PAGE_SIZE,\n });\n }\n\n /* Any CKAN action; unwraps `{ success, result }` and throws `UkEnergyError` on `success: false`. /\n async action<T>(name: string, query?: Query): Promise<T> {\n return this.ckan.action<T>(name, query);\n }\n\n /* Resolving resources inside datasets. /\n readonly resources = {\n /* All datastore-backed resources of a dataset. /\n datastore: async (packageId: string): Promise<CkanResource[]> =>\n this.ckan.datastoreResources(packageId),\n /* The resource for a GB financial year (`2025` = April 2025 – March 2026), by name. /\n forFinancialYear: async (packageId: string, startYear: number): Promise<CkanResource> => {\n const pkg = await this.ckan.packageShow(packageId);\n const r = resourceForFinancialYear(pkg.resources, startYear);\n if (!r) {\n throw new UkEnergyError(\n `${packageId}: no datastore resource for financial year ${startYear}/${(startYear + 1) % 100}`,\n );\n }\n return r;\n },\n /* The datastore resource whose name matches exactly (or the regex), e.g. \"DFS Utilisation Report\". /\n byName: async (packageId: string, name: string \| RegExp): Promise<CkanResource> =>\n this.ckan.resourceByName(packageId, name),\n };\n\n /* Rows of a per-financial-year dataset for an inclusive date range, across year boundaries. /\n private async byFinancialYear<Row extends object>(\n packageId: string,\n column: string,\n range: DateRange,\n orderBy: readonly string[],\n opts: { where?: string \| undefined; extraNumeric?: readonly string[] } = {},\n ): Promise<Row[]> {\n const [from, to] = localRange(range.from, range.to);\n const out: Row[] = [];\n for (const fy of financialYearsBetween(from, to)) {\n const resource = await this.resources.forFinancialYear(packageId, fy);\n const sql = rangeSql(resource.id, column, from, to, orderBy, { where: opts.where });\n out.push(...(await this.ckan.sql<Row>(sql, opts.extraNumeric)));\n }\n return out;\n }\n\n /* Transmission constraint costs and forecasts. /\n readonly constraints = {\n /\n Thermal constraint cost per boundary per day (£), `thermal-constraint-costs`. One row per\n * constraint group per settlement date, e.g. SCOTEX, SSHARN, SEIMP (Scottish export\n * boundaries), ESTEX, SWALEX.\n /\n thermalCosts: async (\n from: DateInput,\n to: DateInput,\n constraintGroup?: string,\n ): Promise<ThermalConstraintCostRow[]> =>\n this.byFinancialYear(\n PACKAGES.thermalConstraintCosts,\n \"Settlement Date\",\n { from, to },\n [\"Settlement Date\", \"Constraint Group\"],\n constraintGroup\n ? { where: `${ident(\"Constraint Group\")} = ${literal(constraintGroup)}` }\n : {},\n ),\n /\n Daily constraint cost (£) and volume (MWh) by type: thermal, voltage, inertia, largest\n * loss (`constraint-breakdown`). Thermal volume is negative (energy turned down).\n /\n breakdown: async (from: DateInput, to: DateInput): Promise<ConstraintBreakdownRow[]> =>\n this.byFinancialYear(PACKAGES.constraintBreakdown, \"Date\", { from, to }, [\"Date\"], {\n // \"Thermal constraints cost\" is typed text in some years\n extraNumeric: [\"Thermal constraints cost\"],\n }),\n /* NESO's 24-month-ahead constraint cost forecast, £m per month (24 rows). /\n forecast24m: async (): Promise<ConstraintForecastRow[]> => {\n const r = await this.resources.byName(PACKAGES.constraintCostForecast24m, /Forecast/);\n return this.ckan.datastoreAll<ConstraintForecastRow>(r.id);\n },\n /* 24-month-ahead boundary limits (MW) per week; boundary columns vary by publication. /\n limits24m: async (): Promise<ConstraintLimitRow[]> => {\n const r = await this.resources.byName(PACKAGES.constraintLimits24m, /limits/i);\n return this.ckan.datastoreAll<ConstraintLimitRow>(r.id);\n },\n /\n Day-ahead forecast flow vs limit per boundary, half-hourly, for a range of local dates\n * (`day-ahead-constraint-flows-and-limits`, ~750k rows, so always filtered by SQL).\n /\n dayAheadFlows: async (\n from: DateInput,\n to: DateInput,\n constraintGroup?: string,\n ): Promise<DayAheadFlowRow[]> => {\n const [f, t] = localRange(from, to);\n const r = await this.resources.byName(PACKAGES.dayAheadConstraintFlows, /Flows and Limits/);\n const sql = rangeSql(\n r.id,\n \"Date_ Time GMT_BST\",\n `${f}T00:00:00`,\n `${nextDay(t)}T00:00:00`,\n [\"Constraint Group\", \"Date_ Time GMT_BST\"],\n {\n toExclusive: true,\n where: constraintGroup\n ? `${ident(\"Constraint Group\")} = ${literal(constraintGroup)}`\n : undefined,\n },\n );\n return this.ckan.sql<DayAheadFlowRow>(sql);\n },\n /* Daily balancing (BSUoS) costs per settlement period by category, incl. `Constraints` (£). /\n dailyBalancingCosts: async (from: DateInput, to: DateInput): Promise<DailyBalancingCostRow[]> =>\n this.byFinancialYear(PACKAGES.dailyBalancingCosts, \"SETT_DATE\", { from, to }, [\n \"SETT_DATE\",\n \"SETT_PERIOD\",\n ]),\n };\n\n /* Demand Flexibility Service (current season; archives are separate resources). /\n readonly dfs = {\n /* Published requirements per event window, by delivery date. /\n requirements: async (from: DateInput, to: DateInput): Promise<DfsRequirementRow[]> =>\n this.dfsRange<DfsRequirementRow>(\"DFS Service Requirement\", from, to, [\n \"Event ID\",\n \"From_UTC\",\n ]),\n /* Accepted/rejected bids per participant unit per event window. /\n utilisation: async (from: DateInput, to: DateInput): Promise<DfsUtilisationRow[]> =>\n this.dfsRange<DfsUtilisationRow>(\"DFS Utilisation Report\", from, to, [\n \"Event ID\",\n \"From_UTC\",\n \"DFS Unit ID\",\n ]),\n /* Procured MW, accepted cost and settled volume/cost per event window. */\n summary: async (from: DateInput, to: DateInput): Promise<DfsSummaryRow[]> =>\n this.dfsRange<DfsSummaryRow>(\"DFS Utilisation Report Summary\", from, to, [\n \"Event ID\",\n \"From_UTC\",\n ]),\n };\n\n private async dfsRange<Row extends object>(\n name: string,\n from: DateInput,\n to: DateInput,\n orderBy: readonly string[],\n ): Promise<Row[]> {\n const [f, t] = localRange(from, to);\n const r = await this.resources.byName(PACKAGES.demandFlexibility, name);\n return this.ckan.sql<Row>(rangeSql(r.id, \"Delivery Date\", f, t, orderBy));\n }\n}\n"]}

package/dist/index.d.cts CHANGED Viewed

@@ -1,4 +1,5 @@
-import { RateLimit, HttpClient, HttpClientOptions, Query, DateInput } from '@uk-energy/core';
+import { RateLimit, HttpClient, CkanClient, HttpClientOptions, Query, CkanResource, DateInput } from '@uk-energy/core';
+export { CkanFailure, CkanPackage, CkanPackageSearch, CkanResource, CkanResponse, CkanSuccess, DatastoreField, DatastoreRow, DatastoreSearchOptions, DatastoreSearchResult, DatastoreSqlResult, ident, literal, normaliseRows, rangeSql } from '@uk-energy/core';
 /**
  * Shapes of the NESO Data Portal (CKAN 2.8) API and of the datasets this package wraps.
@@ -8,103 +9,7 @@ import { RateLimit, HttpClient, HttpClientOptions, Query, DateInput } from '@uk-
  *
  * Supported by National Energy SO Open Data.
  */
-interface CkanSuccess<T> {
-    help: string;
-    success: true;
-    result: T;
-}
-interface CkanFailure {
-    help: string;
-    success: false;
-    error: {
-        message?: string;
-        __type?: string;
-        [field: string]: unknown;
-    };
-}
-type CkanResponse<T> = CkanSuccess<T> | CkanFailure;
-interface CkanResource {
-    id: string;
-    package_id: string;
-    name: string;
-    description: string;
-    format: string;
-    url: string;
-    /** True when the resource is loaded into the datastore (CSV/XLSX pushed to Postgres). */
-    datastore_active: boolean;
-    last_modified: string | null;
-    created: string;
-    size: number | null;
-    position: number;
-    state: string;
-    mimetype: string | null;
-}
-interface CkanPackage {
-    id: string;
-    name: string;
-    title: string;
-    notes: string;
-    license_id: string;
-    license_title: string;
-    license_url?: string;
-    metadata_created: string;
-    metadata_modified: string;
-    num_resources: number;
-    organization: {
-        name: string;
-        title: string;
-    } | null;
-    resources: CkanResource[];
-    tags: {
-        name: string;
-        display_name: string;
-    }[];
-    extras: {
-        key: string;
-        value: string;
-    }[];
-}
-interface CkanPackageSearch {
-    count: number;
-    results: CkanPackage[];
-}
-/** Datastore column: `int4`, `numeric`, `text`, `date`, `timestamp`, `tsvector`… */
-interface DatastoreField {
-    id: string;
-    type: string;
-}
-interface DatastoreSearchResult<Row = DatastoreRow> {
-    resource_id: string;
-    fields: DatastoreField[];
-    records: Row[];
-    total: number;
-    limit?: number;
-    offset?: number;
-    _links?: {
-        start?: string;
-        next?: string;
-        prev?: string;
-    };
-}
-interface DatastoreSqlResult<Row = DatastoreRow> {
-    sql: string;
-    fields: DatastoreField[];
-    records: Row[];
-}
-type DatastoreRow = Record<string, string | number | boolean | null>;
-interface DatastoreSearchOptions {
-    /** Rows per request; the portal returns everything up to 32,000 in one page. */
-    limit?: number;
-    offset?: number;
-    /** e.g. `"_id"` or `"Settlement Date desc"`. */
-    sort?: string;
-    /** Equality filters, `{ "Constraint Group": "ESTEX" }`. */
-    filters?: Record<string, string | number | boolean | (string | number)[]>;
-    /** Columns to return. */
-    fields?: string[];
-    /** Full-text query. */
-    q?: string;
-}
 /** `thermal-constraint-costs`, one row per boundary per day. */
 interface ThermalConstraintCostRow {
     _id: number;
@@ -256,48 +161,14 @@ declare const PACKAGES: {
 interface NesoClientOptions extends Omit<HttpClientOptions, "baseUrl"> {
     baseUrl?: string;
 }
-/**
- * The SQL endpoint returns `numeric` columns as strings ("252"); `datastore_search` returns
- * numbers. Make rows consistent: numeric-typed columns become numbers, `_full_text` goes.
- */
-declare function normaliseRows<Row extends object>(records: readonly DatastoreRow[], fields: readonly DatastoreField[], extraNumeric?: readonly string[]): Row[];
-/** Double-quote an identifier for the SQL endpoint. */
-declare function ident(name: string): string;
-/** Single-quote a literal for the SQL endpoint. */
-declare function literal(value: string | number): string;
-/**
- * `SELECT * FROM "resource" WHERE "col" >= 'from' AND "col" <= 'to' ORDER BY …` — the shape
- * every date-range helper uses. `toExclusive` switches the upper bound to `<` for timestamps.
- */
-declare function rangeSql(resourceId: string, column: string, from: string, to: string, orderBy: readonly string[], opts?: {
-    toExclusive?: boolean;
-    where?: string | undefined;
-}): string;
 declare class NesoClient {
     readonly http: HttpClient;
-    private readonly packageCache;
-    private readonly packageTtlMs;
+    /** Raw CKAN API (`@uk-energy/core` `CkanClient`): `packageShow` (memoised), `datastoreSearch`, `datastoreAll`, `sql`… */
+    readonly ckan: CkanClient;
     constructor(opts?: NesoClientOptions);
     /** Any CKAN action; unwraps `{ success, result }` and throws `UkEnergyError` on `success: false`. */
     action<T>(name: string, query?: Query): Promise<T>;
-    /** Raw CKAN API. */
-    readonly ckan: {
-        /** Dataset metadata and its resources (memoised for `cacheTtlMs`, default 10 minutes). */
-        packageShow: (id: string) => Promise<CkanPackage>;
-        /** Search datasets by free text. */
-        packageSearch: (q: string, rows?: number) => Promise<CkanPackageSearch>;
-        resourceShow: (id: string) => Promise<CkanResource>;
-        /** One page of a datastore resource (up to 32,000 rows). Rows are normalised (see `normaliseRows`). */
-        datastoreSearch: <Row extends object = DatastoreRow>(resourceId: string, opts?: DatastoreSearchOptions) => Promise<DatastoreSearchResult<Row>>;
-        /** Every row of a datastore resource, paging by `limit` (default 32,000). */
-        datastoreAll: <Row extends object = DatastoreRow>(resourceId: string, opts?: Omit<DatastoreSearchOptions, "offset">) => Promise<Row[]>;
-        /**
-         * `datastore_search_sql`: read-only PostgreSQL over the datastore. Resource ids are the
-         * table names (quote them). Numeric columns come back as strings from this endpoint; they
-         * are converted using the `fields` types, and `_full_text` is dropped.
-         */
-        sql: <Row extends object = DatastoreRow>(sql: string, extraNumeric?: readonly string[]) => Promise<Row[]>;
-    };
     /** Resolving resources inside datasets. */
     readonly resources: {
         /** All datastore-backed resources of a dataset. */
@@ -361,5 +232,5 @@ declare function financialYearInName(name: string): number | undefined;
 /** The datastore resource of a dataset for one financial year, if any. */
 declare function resourceForFinancialYear(resources: readonly CkanResource[], startYear: number): CkanResource | undefined;
-export { BASE_URL, DEFAULT_CACHE_TTL_MS, DEFAULT_RATE_LIMIT, MAX_PAGE_SIZE, NesoClient, PACKAGES, financialYearInName, financialYearOf, financialYearsBetween, ident, literal, normaliseRows, rangeSql, resourceForFinancialYear };
-export type { CkanFailure, CkanPackage, CkanPackageSearch, CkanResource, CkanResponse, CkanSuccess, ConstraintBreakdownRow, ConstraintForecastRow, ConstraintLimitRow, DailyBalancingCostRow, DatastoreField, DatastoreRow, DatastoreSearchOptions, DatastoreSearchResult, DatastoreSqlResult, DayAheadFlowRow, DfsRequirementRow, DfsSummaryRow, DfsUtilisationRow, NesoClientOptions, ThermalConstraintCostRow };
+export { BASE_URL, DEFAULT_CACHE_TTL_MS, DEFAULT_RATE_LIMIT, MAX_PAGE_SIZE, NesoClient, PACKAGES, financialYearInName, financialYearOf, financialYearsBetween, resourceForFinancialYear };
+export type { ConstraintBreakdownRow, ConstraintForecastRow, ConstraintLimitRow, DailyBalancingCostRow, DayAheadFlowRow, DfsRequirementRow, DfsSummaryRow, DfsUtilisationRow, NesoClientOptions, ThermalConstraintCostRow };

package/dist/index.d.ts CHANGED Viewed

@@ -1,4 +1,5 @@
-import { RateLimit, HttpClient, HttpClientOptions, Query, DateInput } from '@uk-energy/core';
+import { RateLimit, HttpClient, CkanClient, HttpClientOptions, Query, CkanResource, DateInput } from '@uk-energy/core';
+export { CkanFailure, CkanPackage, CkanPackageSearch, CkanResource, CkanResponse, CkanSuccess, DatastoreField, DatastoreRow, DatastoreSearchOptions, DatastoreSearchResult, DatastoreSqlResult, ident, literal, normaliseRows, rangeSql } from '@uk-energy/core';
 /**
  * Shapes of the NESO Data Portal (CKAN 2.8) API and of the datasets this package wraps.
@@ -8,103 +9,7 @@ import { RateLimit, HttpClient, HttpClientOptions, Query, DateInput } from '@uk-
  *
  * Supported by National Energy SO Open Data.
  */
-interface CkanSuccess<T> {
-    help: string;
-    success: true;
-    result: T;
-}
-interface CkanFailure {
-    help: string;
-    success: false;
-    error: {
-        message?: string;
-        __type?: string;
-        [field: string]: unknown;
-    };
-}
-type CkanResponse<T> = CkanSuccess<T> | CkanFailure;
-interface CkanResource {
-    id: string;
-    package_id: string;
-    name: string;
-    description: string;
-    format: string;
-    url: string;
-    /** True when the resource is loaded into the datastore (CSV/XLSX pushed to Postgres). */
-    datastore_active: boolean;
-    last_modified: string | null;
-    created: string;
-    size: number | null;
-    position: number;
-    state: string;
-    mimetype: string | null;
-}
-interface CkanPackage {
-    id: string;
-    name: string;
-    title: string;
-    notes: string;
-    license_id: string;
-    license_title: string;
-    license_url?: string;
-    metadata_created: string;
-    metadata_modified: string;
-    num_resources: number;
-    organization: {
-        name: string;
-        title: string;
-    } | null;
-    resources: CkanResource[];
-    tags: {
-        name: string;
-        display_name: string;
-    }[];
-    extras: {
-        key: string;
-        value: string;
-    }[];
-}
-interface CkanPackageSearch {
-    count: number;
-    results: CkanPackage[];
-}
-/** Datastore column: `int4`, `numeric`, `text`, `date`, `timestamp`, `tsvector`… */
-interface DatastoreField {
-    id: string;
-    type: string;
-}
-interface DatastoreSearchResult<Row = DatastoreRow> {
-    resource_id: string;
-    fields: DatastoreField[];
-    records: Row[];
-    total: number;
-    limit?: number;
-    offset?: number;
-    _links?: {
-        start?: string;
-        next?: string;
-        prev?: string;
-    };
-}
-interface DatastoreSqlResult<Row = DatastoreRow> {
-    sql: string;
-    fields: DatastoreField[];
-    records: Row[];
-}
-type DatastoreRow = Record<string, string | number | boolean | null>;
-interface DatastoreSearchOptions {
-    /** Rows per request; the portal returns everything up to 32,000 in one page. */
-    limit?: number;
-    offset?: number;
-    /** e.g. `"_id"` or `"Settlement Date desc"`. */
-    sort?: string;
-    /** Equality filters, `{ "Constraint Group": "ESTEX" }`. */
-    filters?: Record<string, string | number | boolean | (string | number)[]>;
-    /** Columns to return. */
-    fields?: string[];
-    /** Full-text query. */
-    q?: string;
-}
 /** `thermal-constraint-costs`, one row per boundary per day. */
 interface ThermalConstraintCostRow {
     _id: number;
@@ -256,48 +161,14 @@ declare const PACKAGES: {
 interface NesoClientOptions extends Omit<HttpClientOptions, "baseUrl"> {
     baseUrl?: string;
 }
-/**
- * The SQL endpoint returns `numeric` columns as strings ("252"); `datastore_search` returns
- * numbers. Make rows consistent: numeric-typed columns become numbers, `_full_text` goes.
- */
-declare function normaliseRows<Row extends object>(records: readonly DatastoreRow[], fields: readonly DatastoreField[], extraNumeric?: readonly string[]): Row[];
-/** Double-quote an identifier for the SQL endpoint. */
-declare function ident(name: string): string;
-/** Single-quote a literal for the SQL endpoint. */
-declare function literal(value: string | number): string;
-/**
- * `SELECT * FROM "resource" WHERE "col" >= 'from' AND "col" <= 'to' ORDER BY …` — the shape
- * every date-range helper uses. `toExclusive` switches the upper bound to `<` for timestamps.
- */
-declare function rangeSql(resourceId: string, column: string, from: string, to: string, orderBy: readonly string[], opts?: {
-    toExclusive?: boolean;
-    where?: string | undefined;
-}): string;
 declare class NesoClient {
     readonly http: HttpClient;
-    private readonly packageCache;
-    private readonly packageTtlMs;
+    /** Raw CKAN API (`@uk-energy/core` `CkanClient`): `packageShow` (memoised), `datastoreSearch`, `datastoreAll`, `sql`… */
+    readonly ckan: CkanClient;
     constructor(opts?: NesoClientOptions);
     /** Any CKAN action; unwraps `{ success, result }` and throws `UkEnergyError` on `success: false`. */
     action<T>(name: string, query?: Query): Promise<T>;
-    /** Raw CKAN API. */
-    readonly ckan: {
-        /** Dataset metadata and its resources (memoised for `cacheTtlMs`, default 10 minutes). */
-        packageShow: (id: string) => Promise<CkanPackage>;
-        /** Search datasets by free text. */
-        packageSearch: (q: string, rows?: number) => Promise<CkanPackageSearch>;
-        resourceShow: (id: string) => Promise<CkanResource>;
-        /** One page of a datastore resource (up to 32,000 rows). Rows are normalised (see `normaliseRows`). */
-        datastoreSearch: <Row extends object = DatastoreRow>(resourceId: string, opts?: DatastoreSearchOptions) => Promise<DatastoreSearchResult<Row>>;
-        /** Every row of a datastore resource, paging by `limit` (default 32,000). */
-        datastoreAll: <Row extends object = DatastoreRow>(resourceId: string, opts?: Omit<DatastoreSearchOptions, "offset">) => Promise<Row[]>;
-        /**
-         * `datastore_search_sql`: read-only PostgreSQL over the datastore. Resource ids are the
-         * table names (quote them). Numeric columns come back as strings from this endpoint; they
-         * are converted using the `fields` types, and `_full_text` is dropped.
-         */
-        sql: <Row extends object = DatastoreRow>(sql: string, extraNumeric?: readonly string[]) => Promise<Row[]>;
-    };
     /** Resolving resources inside datasets. */
     readonly resources: {
         /** All datastore-backed resources of a dataset. */
@@ -361,5 +232,5 @@ declare function financialYearInName(name: string): number | undefined;
 /** The datastore resource of a dataset for one financial year, if any. */
 declare function resourceForFinancialYear(resources: readonly CkanResource[], startYear: number): CkanResource | undefined;
-export { BASE_URL, DEFAULT_CACHE_TTL_MS, DEFAULT_RATE_LIMIT, MAX_PAGE_SIZE, NesoClient, PACKAGES, financialYearInName, financialYearOf, financialYearsBetween, ident, literal, normaliseRows, rangeSql, resourceForFinancialYear };
-export type { CkanFailure, CkanPackage, CkanPackageSearch, CkanResource, CkanResponse, CkanSuccess, ConstraintBreakdownRow, ConstraintForecastRow, ConstraintLimitRow, DailyBalancingCostRow, DatastoreField, DatastoreRow, DatastoreSearchOptions, DatastoreSearchResult, DatastoreSqlResult, DayAheadFlowRow, DfsRequirementRow, DfsSummaryRow, DfsUtilisationRow, NesoClientOptions, ThermalConstraintCostRow };
+export { BASE_URL, DEFAULT_CACHE_TTL_MS, DEFAULT_RATE_LIMIT, MAX_PAGE_SIZE, NesoClient, PACKAGES, financialYearInName, financialYearOf, financialYearsBetween, resourceForFinancialYear };
+export type { ConstraintBreakdownRow, ConstraintForecastRow, ConstraintLimitRow, DailyBalancingCostRow, DayAheadFlowRow, DfsRequirementRow, DfsSummaryRow, DfsUtilisationRow, NesoClientOptions, ThermalConstraintCostRow };

package/dist/index.js CHANGED Viewed

@@ -1,4 +1,5 @@
-import { HttpClient, UkEnergyError, pages, offsetCursor, londonDate } from '@uk-energy/core';
+import { CKAN_MAX_PAGE_SIZE, HttpClient, CkanClient, UkEnergyError, rangeSql, ident, literal, londonDate } from '@uk-energy/core';
+export { ident, literal, normaliseRows, rangeSql } from '@uk-energy/core';
 // src/client.ts
@@ -28,12 +29,10 @@ function financialYearInName(name) {
 function resourceForFinancialYear(resources, startYear) {
   return resources.find((r) => r.datastore_active && financialYearInName(r.name) === startYear);
 }
-// src/client.ts
 var BASE_URL = "https://api.neso.energy/api/3/action";
 var DEFAULT_RATE_LIMIT = { requestsPerSecond: 5, burst: 10 };
 var DEFAULT_CACHE_TTL_MS = 10 * 60 * 1e3;
-var MAX_PAGE_SIZE = 32e3;
+var MAX_PAGE_SIZE = CKAN_MAX_PAGE_SIZE;
 var PACKAGES = {
   thermalConstraintCosts: "thermal-constraint-costs",
   constraintBreakdown: "constraint-breakdown",
@@ -43,45 +42,6 @@ var PACKAGES = {
   dailyBalancingCosts: "daily-balancing-costs-balancing-services-use-of-system",
   demandFlexibility: "demand-flexibility"
 };
-var DECIMAL = /^-?\d+(\.\d+)?([eE][-+]?\d+)?$/;
-var NUMERIC_TYPES = /* @__PURE__ */ new Set([
-  "numeric",
-  "int4",
-  "int8",
-  "float8",
-  "float4",
-  "int",
-  "double precision"
-]);
-function normaliseRows(records, fields, extraNumeric = []) {
-  const numeric = new Set(extraNumeric);
-  for (const f of fields) if (NUMERIC_TYPES.has(f.type)) numeric.add(f.id);
-  return records.map((r) => {
-    const out = {};
-    for (const [k, v] of Object.entries(r)) {
-      if (k === "_full_text") continue;
-      if (numeric.has(k) && typeof v === "string" && DECIMAL.test(v.trim())) {
-        const n = Number(v);
-        out[k] = Number.isFinite(n) ? n : v;
-      } else {
-        out[k] = v;
-      }
-    }
-    return out;
-  });
-}
-function ident(name) {
-  return `"${name.replace(/"/g, '""')}"`;
-}
-function literal(value) {
-  return typeof value === "number" ? String(value) : `'${value.replace(/'/g, "''")}'`;
-}
-function rangeSql(resourceId, column, from, to, orderBy, opts = {}) {
-  const upper = opts.toExclusive ? "<" : "<=";
-  const extra = opts.where ? ` AND ${opts.where}` : "";
-  const order = orderBy.length ? ` ORDER BY ${orderBy.map(ident).join(", ")}` : "";
-  return `SELECT * FROM ${ident(resourceId)} WHERE ${ident(column)} >= ${literal(from)} AND ${ident(column)} ${upper} ${literal(to)}${extra}${order}`;
-}
 function localRange(from, to) {
   const f = londonDate(from);
   const t = londonDate(to);
@@ -95,8 +55,8 @@ function nextDay(date) {
 }
 var NesoClient = class {
   http;
-  packageCache = /* @__PURE__ */ new Map();
-  packageTtlMs;
+  /** Raw CKAN API (`@uk-energy/core` `CkanClient`): `packageShow` (memoised), `datastoreSearch`, `datastoreAll`, `sql`… */
+  ckan;
   constructor(opts = {}) {
     this.http = new HttpClient({
       baseUrl: BASE_URL,
@@ -104,91 +64,19 @@ var NesoClient = class {
       cacheTtlMs: opts.cache ? DEFAULT_CACHE_TTL_MS : 0,
       ...opts
     });
-    this.packageTtlMs = opts.cacheTtlMs ?? DEFAULT_CACHE_TTL_MS;
+    this.ckan = new CkanClient(this.http, {
+      packageTtlMs: opts.cacheTtlMs ?? DEFAULT_CACHE_TTL_MS,
+      maxPageSize: MAX_PAGE_SIZE
+    });
   }
   /** Any CKAN action; unwraps `{ success, result }` and throws `UkEnergyError` on `success: false`. */
   async action(name, query) {
-    const res = await this.http.get(name, query);
-    if (!res || typeof res !== "object" || !("success" in res)) {
-      throw new UkEnergyError(`Unexpected response shape for ${name}`);
-    }
-    if (!res.success) {
-      throw new UkEnergyError(`${name}: ${res.error?.message ?? JSON.stringify(res.error)}`);
-    }
-    return res.result;
+    return this.ckan.action(name, query);
   }
-  /** Raw CKAN API. */
-  ckan = {
-    /** Dataset metadata and its resources (memoised for `cacheTtlMs`, default 10 minutes). */
-    packageShow: async (id) => {
-      const hit = this.packageCache.get(id);
-      if (hit && Date.now() - hit.at < this.packageTtlMs) return hit.value;
-      const value = this.action("package_show", { id }).then((pkg) => {
-        if (!pkg || !Array.isArray(pkg.resources)) {
-          throw new UkEnergyError(`package_show: unexpected shape for ${id}`);
-        }
-        return pkg;
-      });
-      this.packageCache.set(id, { at: Date.now(), value });
-      value.catch(() => this.packageCache.delete(id));
-      return value;
-    },
-    /** Search datasets by free text. */
-    packageSearch: async (q, rows = 20) => this.action("package_search", { q, rows }),
-    resourceShow: async (id) => this.action("resource_show", { id }),
-    /** One page of a datastore resource (up to 32,000 rows). Rows are normalised (see `normaliseRows`). */
-    datastoreSearch: async (resourceId, opts = {}) => {
-      const query = {
-        resource_id: resourceId,
-        limit: opts.limit ?? MAX_PAGE_SIZE,
-        sort: opts.sort ?? "_id"
-      };
-      if (opts.offset !== void 0) query.offset = opts.offset;
-      if (opts.filters) query.filters = JSON.stringify(opts.filters);
-      if (opts.fields) query.fields = opts.fields.join(",");
-      if (opts.q) query.q = opts.q;
-      const res = await this.action("datastore_search", query);
-      if (!Array.isArray(res?.records)) {
-        throw new UkEnergyError("Unexpected response shape for datastore_search");
-      }
-      return { ...res, records: normaliseRows(res.records, res.fields ?? []) };
-    },
-    /** Every row of a datastore resource, paging by `limit` (default 32,000). */
-    datastoreAll: async (resourceId, opts = {}) => {
-      const pageSize = Math.min(opts.limit ?? MAX_PAGE_SIZE, MAX_PAGE_SIZE);
-      const out = [];
-      for await (const page of pages({
-        fetchPage: (offset) => this.ckan.datastoreSearch(resourceId, {
-          ...opts,
-          limit: pageSize,
-          offset: offset ?? 0
-        }),
-        items: (p) => p.records,
-        nextCursor: offsetCursor(pageSize, (p) => p.records.length)
-      })) {
-        out.push(...page.records);
-      }
-      return out;
-    },
-    /**
-     * `datastore_search_sql`: read-only PostgreSQL over the datastore. Resource ids are the
-     * table names (quote them). Numeric columns come back as strings from this endpoint; they
-     * are converted using the `fields` types, and `_full_text` is dropped.
-     */
-    sql: async (sql, extraNumeric = []) => {
-      const res = await this.action("datastore_search_sql", {
-        sql
-      });
-      if (!Array.isArray(res?.records)) {
-        throw new UkEnergyError("Unexpected response shape for datastore_search_sql");
-      }
-      return normaliseRows(res.records, res.fields ?? [], extraNumeric);
-    }
-  };
   /** Resolving resources inside datasets. */
   resources = {
     /** All datastore-backed resources of a dataset. */
-    datastore: async (packageId) => (await this.ckan.packageShow(packageId)).resources.filter((r) => r.datastore_active),
+    datastore: async (packageId) => this.ckan.datastoreResources(packageId),
     /** The resource for a GB financial year (`2025` = April 2025 – March 2026), by name. */
     forFinancialYear: async (packageId, startYear) => {
       const pkg = await this.ckan.packageShow(packageId);
@@ -201,14 +89,7 @@ var NesoClient = class {
       return r;
     },
     /** The datastore resource whose name matches exactly (or the regex), e.g. "DFS Utilisation Report". */
-    byName: async (packageId, name) => {
-      const list = await this.resources.datastore(packageId);
-      const r = list.find(
-        (x) => typeof name === "string" ? x.name.trim() === name.trim() : name.test(x.name)
-      );
-      if (!r) throw new UkEnergyError(`${packageId}: no datastore resource named ${String(name)}`);
-      return r;
-    }
+    byName: async (packageId, name) => this.ckan.resourceByName(packageId, name)
   };
   /** Rows of a per-financial-year dataset for an inclusive date range, across year boundaries. */
   async byFinancialYear(packageId, column, range, orderBy, opts = {}) {
@@ -305,6 +186,6 @@ var NesoClient = class {
   }
 };
-export { BASE_URL, DEFAULT_CACHE_TTL_MS, DEFAULT_RATE_LIMIT, MAX_PAGE_SIZE, NesoClient, PACKAGES, financialYearInName, financialYearOf, financialYearsBetween, ident, literal, normaliseRows, rangeSql, resourceForFinancialYear };
+export { BASE_URL, DEFAULT_CACHE_TTL_MS, DEFAULT_RATE_LIMIT, MAX_PAGE_SIZE, NesoClient, PACKAGES, financialYearInName, financialYearOf, financialYearsBetween, resourceForFinancialYear };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/resources.ts","../src/client.ts"],"names":[],"mappings":";;;;;AAQO,SAAS,gBAAgB,IAAA,EAAsB;AACpD,EAAA,MAAM,OAAO,MAAA,CAAO,IAAA,CAAK,KAAA,CAAM,CAAA,EAAG,CAAC,CAAC,CAAA;AACpC,EAAA,MAAM,QAAQ,MAAA,CAAO,IAAA,CAAK,KAAA,CAAM,CAAA,EAAG,CAAC,CAAC,CAAA;AACrC,EAAA,OAAO,KAAA,IAAS,CAAA,GAAI,IAAA,GAAO,IAAA,GAAO,CAAA;AACpC;AAGO,SAAS,qBAAA,CAAsB,MAAc,EAAA,EAAsB;AACxE,EAAA,MAAM,KAAA,GAAQ,gBAAgB,IAAI,CAAA;AAClC,EAAA,MAAM,IAAA,GAAO,gBAAgB,EAAE,CAAA;AAC/B,EAAA,MAAM,MAAgB,EAAC;AACvB,EAAA,KAAA,IAAS,IAAI,KAAA,EAAO,CAAA,IAAK,MAAM,CAAA,EAAA,EAAK,GAAA,CAAI,KAAK,CAAC,CAAA;AAC9C,EAAA,OAAO,GAAA;AACT;AAEA,IAAM,SAAA,GAAY,qDAAA;AAGX,SAAS,oBAAoB,IAAA,EAAkC;AACpE,EAAA,KAAA,MAAW,CAAA,IAAK,IAAA,CAAK,QAAA,CAAS,SAAS,CAAA,EAAG;AACxC,IAAA,IAAI,CAAC,CAAA,CAAE,CAAC,KAAK,CAAC,CAAA,CAAE,CAAC,CAAA,EAAG;AACpB,IAAA,MAAM,KAAA,GAAQ,CAAA,CAAE,CAAC,CAAA,CAAE,WAAW,CAAA,GAAI,GAAA,GAAO,MAAA,CAAO,CAAA,CAAE,CAAC,CAAC,CAAA,GAAI,MAAA,CAAO,CAAA,CAAE,CAAC,CAAC,CAAA;AACnE,IAAA,MAAM,GAAA,GAAM,CAAA,CAAE,CAAC,CAAA,CAAE,WAAW,CAAA,GAAI,GAAA,GAAO,MAAA,CAAO,CAAA,CAAE,CAAC,CAAC,CAAA,GAAI,MAAA,CAAO,CAAA,CAAE,CAAC,CAAC,CAAA;AACjE,IAAA,IAAI,GAAA,KAAQ,KAAA,GAAQ,CAAA,EAAG,OAAO,KAAA;AAAA,EAChC;AACA,EAAA,OAAO,MAAA;AACT;AAGO,SAAS,wBAAA,CACd,WACA,SAAA,EAC0B;AAC1B,EAAA,OAAO,SAAA,CAAU,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,oBAAoB,mBAAA,CAAoB,CAAA,CAAE,IAAI,CAAA,KAAM,SAAS,CAAA;AAC9F;;;ACMO,IAAM,QAAA,GAAW;AAMjB,IAAM,kBAAA,GAAgC,EAAE,iBAAA,EAAmB,CAAA,EAAG,OAAO,EAAA;AAGrE,IAAM,oBAAA,GAAuB,KAAK,EAAA,GAAK;AAGvC,IAAM,aAAA,GAAgB;AAGtB,IAAM,QAAA,GAAW;AAAA,EACtB,sBAAA,EAAwB,0BAAA;AAAA,EACxB,mBAAA,EAAqB,sBAAA;AAAA,EACrB,yBAAA,EAA2B,0CAAA;AAAA,EAC3B,mBAAA,EAAqB,mCAAA;AAAA,EACrB,uBAAA,EAAyB,uCAAA;AAAA,EACzB,mBAAA,EAAqB,wDAAA;AAAA,EACrB,iBAAA,EAAmB;AACrB;AAYA,IAAM,OAAA,GAAU,gCAAA;AAEhB,IAAM,aAAA,uBAAoB,GAAA,CAAI;AAAA,EAC5B,SAAA;AAAA,EACA,MAAA;AAAA,EACA,MAAA;AAAA,EACA,QAAA;AAAA,EACA,QAAA;AAAA,EACA,KAAA;AAAA,EACA;AACF,CAAC,CAAA;AAMM,SAAS,aAAA,CACd,OAAA,EACA,MAAA,EACA,YAAA,GAAkC,EAAC,EAC5B;AACP,EAAA,MAAM,OAAA,GAAU,IAAI,GAAA,CAAI,YAAY,CAAA;AACpC,EAAA,KAAA,MAAW,CAAA,IAAK,MAAA,EAAQ,IAAI,aAAA,CAAc,GAAA,CAAI,CAAA,CAAE,IAAI,CAAA,EAAG,OAAA,CAAQ,GAAA,CAAI,CAAA,CAAE,EAAE,CAAA;AACvE,EAAA,OAAO,OAAA,CAAQ,GAAA,CAAI,CAAC,CAAA,KAAM;AACxB,IAAA,MAAM,MAAoB,EAAC;AAC3B,IAAA,KAAA,MAAW,CAAC,CAAA,EAAG,CAAC,KAAK,MAAA,CAAO,OAAA,CAAQ,CAAC,CAAA,EAAG;AACtC,MAAA,IAAI,MAAM,YAAA,EAAc;AACxB,MAAA,IAAI,OAAA,CAAQ,GAAA,CAAI,CAAC,CAAA,IAAK,OAAO,CAAA,KAAM,QAAA,IAAY,OAAA,CAAQ,IAAA,CAAK,CAAA,CAAE,IAAA,EAAM,CAAA,EAAG;AACrE,QAAA,MAAM,CAAA,GAAI,OAAO,CAAC,CAAA;AAClB,QAAA,GAAA,CAAI,CAAC,CAAA,GAAI,MAAA,CAAO,QAAA,CAAS,CAAC,IAAI,CAAA,GAAI,CAAA;AAAA,MACpC,CAAA,MAAO;AACL,QAAA,GAAA,CAAI,CAAC,CAAA,GAAI,CAAA;AAAA,MACX;AAAA,IACF;AACA,IAAA,OAAO,GAAA;AAAA,EACT,CAAC,CAAA;AACH;AAGO,SAAS,MAAM,IAAA,EAAsB;AAC1C,EAAA,OAAO,CAAA,CAAA,EAAI,IAAA,CAAK,OAAA,CAAQ,IAAA,EAAM,IAAI,CAAC,CAAA,CAAA,CAAA;AACrC;AAGO,SAAS,QAAQ,KAAA,EAAgC;AACtD,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA,GAAW,MAAA,CAAO,KAAK,CAAA,GAAI,CAAA,CAAA,EAAI,KAAA,CAAM,OAAA,CAAQ,IAAA,EAAM,IAAI,CAAC,CAAA,CAAA,CAAA;AAClF;AAMO,SAAS,QAAA,CACd,YACA,MAAA,EACA,IAAA,EACA,IACA,OAAA,EACA,IAAA,GAA8D,EAAC,EACvD;AACR,EAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,WAAA,GAAc,GAAA,GAAM,IAAA;AACvC,EAAA,MAAM,QAAQ,IAAA,CAAK,KAAA,GAAQ,CAAA,KAAA,EAAQ,IAAA,CAAK,KAAK,CAAA,CAAA,GAAK,EAAA;AAClD,EAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,MAAA,GAAS,CAAA,UAAA,EAAa,OAAA,CAAQ,GAAA,CAAI,KAAK,CAAA,CAAE,IAAA,CAAK,IAAI,CAAC,CAAA,CAAA,GAAK,EAAA;AAC9E,EAAA,OAAO,CAAA,cAAA,EAAiB,KAAA,CAAM,UAAU,CAAC,CAAA,OAAA,EAAU,MAAM,MAAM,CAAC,CAAA,IAAA,EAAO,OAAA,CAAQ,IAAI,CAAC,QAAQ,KAAA,CAAM,MAAM,CAAC,CAAA,CAAA,EAAI,KAAK,CAAA,CAAA,EAAI,OAAA,CAAQ,EAAE,CAAC,CAAA,EAAG,KAAK,CAAA,EAAG,KAAK,CAAA,CAAA;AACnJ;AAGA,SAAS,UAAA,CAAW,MAAiB,EAAA,EAAiC;AACpE,EAAA,MAAM,CAAA,GAAI,WAAW,IAAI,CAAA;AACzB,EAAA,MAAM,CAAA,GAAI,WAAW,EAAE,CAAA;AACvB,EAAA,IAAI,CAAA,GAAI,GAAG,MAAM,IAAI,cAAc,CAAA,MAAA,EAAS,CAAC,CAAA,eAAA,EAAkB,CAAC,CAAA,CAAA,CAAG,CAAA;AACnE,EAAA,OAAO,CAAC,GAAG,CAAC,CAAA;AACd;AAEA,SAAS,QAAQ,IAAA,EAAsB;AACrC,EAAA,MAAM,CAAA,mBAAI,IAAI,IAAA,CAAK,CAAA,EAAG,IAAI,CAAA,UAAA,CAAY,CAAA;AACtC,EAAA,CAAA,CAAE,UAAA,CAAW,CAAA,CAAE,UAAA,EAAW,GAAI,CAAC,CAAA;AAC/B,EAAA,OAAO,CAAA,CAAE,WAAA,EAAY,CAAE,KAAA,CAAM,GAAG,EAAE,CAAA;AACpC;AAEO,IAAM,aAAN,MAAiB;AAAA,EACb,IAAA;AAAA,EACQ,YAAA,uBAAmB,GAAA,EAAyD;AAAA,EAC5E,YAAA;AAAA,EAEjB,WAAA,CAAY,IAAA,GAA0B,EAAC,EAAG;AACxC,IAAA,IAAA,CAAK,IAAA,GAAO,IAAI,UAAA,CAAW;AAAA,MACzB,OAAA,EAAS,QAAA;AAAA,MACT,SAAA,EAAW,kBAAA;AAAA,MACX,UAAA,EAAY,IAAA,CAAK,KAAA,GAAQ,oBAAA,GAAuB,CAAA;AAAA,MAChD,GAAG;AAAA,KACJ,CAAA;AACD,IAAA,IAAA,CAAK,YAAA,GAAe,KAAK,UAAA,IAAc,oBAAA;AAAA,EACzC;AAAA;AAAA,EAGA,MAAM,MAAA,CAAU,IAAA,EAAc,KAAA,EAA2B;AACvD,IAAA,MAAM,MAAM,MAAM,IAAA,CAAK,IAAA,CAAK,GAAA,CAAqB,MAAM,KAAK,CAAA;AAC5D,IAAA,IAAI,CAAC,GAAA,IAAO,OAAO,QAAQ,QAAA,IAAY,EAAE,aAAa,GAAA,CAAA,EAAM;AAC1D,MAAA,MAAM,IAAI,aAAA,CAAc,CAAA,8BAAA,EAAiC,IAAI,CAAA,CAAE,CAAA;AAAA,IACjE;AACA,IAAA,IAAI,CAAC,IAAI,OAAA,EAAS;AAChB,MAAA,MAAM,IAAI,aAAA,CAAc,CAAA,EAAG,IAAI,CAAA,EAAA,EAAK,GAAA,CAAI,KAAA,EAAO,OAAA,IAAW,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,KAAK,CAAC,CAAA,CAAE,CAAA;AAAA,IACvF;AACA,IAAA,OAAO,GAAA,CAAI,MAAA;AAAA,EACb;AAAA;AAAA,EAGS,IAAA,GAAO;AAAA;AAAA,IAEd,WAAA,EAAa,OAAO,EAAA,KAAqC;AACvD,MAAA,MAAM,GAAA,GAAM,IAAA,CAAK,YAAA,CAAa,GAAA,CAAI,EAAE,CAAA;AACpC,MAAA,IAAI,GAAA,IAAO,KAAK,GAAA,EAAI,GAAI,IAAI,EAAA,GAAK,IAAA,CAAK,YAAA,EAAc,OAAO,GAAA,CAAI,KAAA;AAC/D,MAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,MAAA,CAAoB,cAAA,EAAgB,EAAE,IAAI,CAAA,CAAE,IAAA,CAAK,CAAC,GAAA,KAAQ;AAC3E,QAAA,IAAI,CAAC,GAAA,IAAO,CAAC,MAAM,OAAA,CAAQ,GAAA,CAAI,SAAS,CAAA,EAAG;AACzC,UAAA,MAAM,IAAI,aAAA,CAAc,CAAA,mCAAA,EAAsC,EAAE,CAAA,CAAE,CAAA;AAAA,QACpE;AACA,QAAA,OAAO,GAAA;AAAA,MACT,CAAC,CAAA;AACD,MAAA,IAAA,CAAK,YAAA,CAAa,IAAI,EAAA,EAAI,EAAE,IAAI,IAAA,CAAK,GAAA,EAAI,EAAG,KAAA,EAAO,CAAA;AACnD,MAAA,KAAA,CAAM,MAAM,MAAM,IAAA,CAAK,YAAA,CAAa,MAAA,CAAO,EAAE,CAAC,CAAA;AAC9C,MAAA,OAAO,KAAA;AAAA,IACT,CAAA;AAAA;AAAA,IAEA,aAAA,EAAe,OAAO,CAAA,EAAW,IAAA,GAAO,EAAA,KACtC,IAAA,CAAK,MAAA,CAAO,gBAAA,EAAkB,EAAE,CAAA,EAAG,IAAA,EAAM,CAAA;AAAA,IAC3C,YAAA,EAAc,OAAO,EAAA,KAAsC,IAAA,CAAK,OAAO,eAAA,EAAiB,EAAE,IAAI,CAAA;AAAA;AAAA,IAE9F,eAAA,EAAiB,OACf,UAAA,EACA,IAAA,GAA+B,EAAC,KACQ;AACxC,MAAA,MAAM,KAAA,GAAe;AAAA,QACnB,WAAA,EAAa,UAAA;AAAA,QACb,KAAA,EAAO,KAAK,KAAA,IAAS,aAAA;AAAA,QACrB,IAAA,EAAM,KAAK,IAAA,IAAQ;AAAA,OACrB;AACA,MAAA,IAAI,IAAA,CAAK,MAAA,KAAW,MAAA,EAAW,KAAA,CAAM,SAAS,IAAA,CAAK,MAAA;AACnD,MAAA,IAAI,KAAK,OAAA,EAAS,KAAA,CAAM,UAAU,IAAA,CAAK,SAAA,CAAU,KAAK,OAAO,CAAA;AAC7D,MAAA,IAAI,KAAK,MAAA,EAAQ,KAAA,CAAM,SAAS,IAAA,CAAK,MAAA,CAAO,KAAK,GAAG,CAAA;AACpD,MAAA,IAAI,IAAA,CAAK,CAAA,EAAG,KAAA,CAAM,CAAA,GAAI,IAAA,CAAK,CAAA;AAC3B,MAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,MAAA,CAA4C,oBAAoB,KAAK,CAAA;AAC5F,MAAA,IAAI,CAAC,KAAA,CAAM,OAAA,CAAQ,GAAA,EAAK,OAAO,CAAA,EAAG;AAChC,QAAA,MAAM,IAAI,cAAc,gDAAgD,CAAA;AAAA,MAC1E;AACA,MAAA,OAAO,EAAE,GAAG,GAAA,EAAK,OAAA,EAAS,aAAA,CAAmB,GAAA,CAAI,OAAA,EAAS,GAAA,CAAI,MAAA,IAAU,EAAE,CAAA,EAAE;AAAA,IAC9E,CAAA;AAAA;AAAA,IAEA,YAAA,EAAc,OACZ,UAAA,EACA,IAAA,GAA+C,EAAC,KAC7B;AACnB,MAAA,MAAM,WAAW,IAAA,CAAK,GAAA,CAAI,IAAA,CAAK,KAAA,IAAS,eAAe,aAAa,CAAA;AACpE,MAAA,MAAM,MAAa,EAAC;AACpB,MAAA,WAAA,MAAiB,QAAQ,KAAA,CAA+C;AAAA,QACtE,WAAW,CAAC,MAAA,KACV,IAAA,CAAK,IAAA,CAAK,gBAAqB,UAAA,EAAY;AAAA,UACzC,GAAG,IAAA;AAAA,UACH,KAAA,EAAO,QAAA;AAAA,UACP,QAAQ,MAAA,IAAU;AAAA,SACnB,CAAA;AAAA,QACH,KAAA,EAAO,CAAC,CAAA,KAAM,CAAA,CAAE,OAAA;AAAA,QAChB,YAAY,YAAA,CAAa,QAAA,EAAU,CAAC,CAAA,KAAM,CAAA,CAAE,QAAQ,MAAM;AAAA,OAC3D,CAAA,EAAG;AACF,QAAA,GAAA,CAAI,IAAA,CAAK,GAAG,IAAA,CAAK,OAAO,CAAA;AAAA,MAC1B;AACA,MAAA,OAAO,GAAA;AAAA,IACT,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAMA,GAAA,EAAK,OACH,GAAA,EACA,YAAA,GAAkC,EAAC,KAChB;AACnB,MAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,MAAA,CAAyC,sBAAA,EAAwB;AAAA,QACtF;AAAA,OACD,CAAA;AACD,MAAA,IAAI,CAAC,KAAA,CAAM,OAAA,CAAQ,GAAA,EAAK,OAAO,CAAA,EAAG;AAChC,QAAA,MAAM,IAAI,cAAc,oDAAoD,CAAA;AAAA,MAC9E;AACA,MAAA,OAAO,cAAmB,GAAA,CAAI,OAAA,EAAS,IAAI,MAAA,IAAU,IAAI,YAAY,CAAA;AAAA,IACvE;AAAA,GACF;AAAA;AAAA,EAGS,SAAA,GAAY;AAAA;AAAA,IAEnB,SAAA,EAAW,OAAO,SAAA,KAAA,CACf,MAAM,KAAK,IAAA,CAAK,WAAA,CAAY,SAAS,CAAA,EAAG,SAAA,CAAU,MAAA,CAAO,CAAC,CAAA,KAAM,EAAE,gBAAgB,CAAA;AAAA;AAAA,IAErF,gBAAA,EAAkB,OAAO,SAAA,EAAmB,SAAA,KAA6C;AACvF,MAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,IAAA,CAAK,YAAY,SAAS,CAAA;AACjD,MAAA,MAAM,CAAA,GAAI,wBAAA,CAAyB,GAAA,CAAI,SAAA,EAAW,SAAS,CAAA;AAC3D,MAAA,IAAI,CAAC,CAAA,EAAG;AACN,QAAA,MAAM,IAAI,aAAA;AAAA,UACR,GAAG,SAAS,CAAA,2CAAA,EAA8C,SAAS,CAAA,CAAA,EAAA,CAAK,SAAA,GAAY,KAAK,GAAG,CAAA;AAAA,SAC9F;AAAA,MACF;AACA,MAAA,OAAO,CAAA;AAAA,IACT,CAAA;AAAA;AAAA,IAEA,MAAA,EAAQ,OAAO,SAAA,EAAmB,IAAA,KAAiD;AACjF,MAAA,MAAM,IAAA,GAAO,MAAM,IAAA,CAAK,SAAA,CAAU,UAAU,SAAS,CAAA;AACrD,MAAA,MAAM,IAAI,IAAA,CAAK,IAAA;AAAA,QAAK,CAAC,CAAA,KACnB,OAAO,IAAA,KAAS,WAAW,CAAA,CAAE,IAAA,CAAK,IAAA,EAAK,KAAM,KAAK,IAAA,EAAK,GAAI,IAAA,CAAK,IAAA,CAAK,EAAE,IAAI;AAAA,OAC7E;AACA,MAAA,IAAI,CAAC,CAAA,EAAG,MAAM,IAAI,aAAA,CAAc,CAAA,EAAG,SAAS,CAAA,8BAAA,EAAiC,MAAA,CAAO,IAAI,CAAC,CAAA,CAAE,CAAA;AAC3F,MAAA,OAAO,CAAA;AAAA,IACT;AAAA,GACF;AAAA;AAAA,EAGA,MAAc,gBACZ,SAAA,EACA,MAAA,EACA,OACA,OAAA,EACA,IAAA,GAAyE,EAAC,EAC1D;AAChB,IAAA,MAAM,CAAC,MAAM,EAAE,CAAA,GAAI,WAAW,KAAA,CAAM,IAAA,EAAM,MAAM,EAAE,CAAA;AAClD,IAAA,MAAM,MAAa,EAAC;AACpB,IAAA,KAAA,MAAW,EAAA,IAAM,qBAAA,CAAsB,IAAA,EAAM,EAAE,CAAA,EAAG;AAChD,MAAA,MAAM,WAAW,MAAM,IAAA,CAAK,SAAA,CAAU,gBAAA,CAAiB,WAAW,EAAE,CAAA;AACpE,MAAA,MAAM,GAAA,GAAM,QAAA,CAAS,QAAA,CAAS,EAAA,EAAI,MAAA,EAAQ,IAAA,EAAM,EAAA,EAAI,OAAA,EAAS,EAAE,KAAA,EAAO,IAAA,CAAK,KAAA,EAAO,CAAA;AAClF,MAAA,GAAA,CAAI,IAAA,CAAK,GAAI,MAAM,IAAA,CAAK,KAAK,GAAA,CAAS,GAAA,EAAK,IAAA,CAAK,YAAY,CAAE,CAAA;AAAA,IAChE;AACA,IAAA,OAAO,GAAA;AAAA,EACT;AAAA;AAAA,EAGS,WAAA,GAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAMrB,YAAA,EAAc,OACZ,IAAA,EACA,EAAA,EACA,oBAEA,IAAA,CAAK,eAAA;AAAA,MACH,QAAA,CAAS,sBAAA;AAAA,MACT,iBAAA;AAAA,MACA,EAAE,MAAM,EAAA,EAAG;AAAA,MACX,CAAC,mBAAmB,kBAAkB,CAAA;AAAA,MACtC,eAAA,GACI,EAAE,KAAA,EAAO,CAAA,EAAG,KAAA,CAAM,kBAAkB,CAAC,CAAA,GAAA,EAAM,OAAA,CAAQ,eAAe,CAAC,CAAA,CAAA,KACnE;AAAC,KACP;AAAA;AAAA;AAAA;AAAA;AAAA,IAKF,SAAA,EAAW,OAAO,IAAA,EAAiB,EAAA,KACjC,KAAK,eAAA,CAAgB,QAAA,CAAS,mBAAA,EAAqB,MAAA,EAAQ,EAAE,IAAA,EAAM,EAAA,EAAG,EAAG,CAAC,MAAM,CAAA,EAAG;AAAA;AAAA,MAEjF,YAAA,EAAc,CAAC,0BAA0B;AAAA,KAC1C,CAAA;AAAA;AAAA,IAEH,aAAa,YAA8C;AACzD,MAAA,MAAM,IAAI,MAAM,IAAA,CAAK,UAAU,MAAA,CAAO,QAAA,CAAS,2BAA2B,UAAU,CAAA;AACpF,MAAA,OAAO,IAAA,CAAK,IAAA,CAAK,YAAA,CAAoC,CAAA,CAAE,EAAE,CAAA;AAAA,IAC3D,CAAA;AAAA;AAAA,IAEA,WAAW,YAA2C;AACpD,MAAA,MAAM,IAAI,MAAM,IAAA,CAAK,UAAU,MAAA,CAAO,QAAA,CAAS,qBAAqB,SAAS,CAAA;AAC7E,MAAA,OAAO,IAAA,CAAK,IAAA,CAAK,YAAA,CAAiC,CAAA,CAAE,EAAE,CAAA;AAAA,IACxD,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAKA,aAAA,EAAe,OACb,IAAA,EACA,EAAA,EACA,eAAA,KAC+B;AAC/B,MAAA,MAAM,CAAC,CAAA,EAAG,CAAC,CAAA,GAAI,UAAA,CAAW,MAAM,EAAE,CAAA;AAClC,MAAA,MAAM,IAAI,MAAM,IAAA,CAAK,UAAU,MAAA,CAAO,QAAA,CAAS,yBAAyB,kBAAkB,CAAA;AAC1F,MAAA,MAAM,GAAA,GAAM,QAAA;AAAA,QACV,CAAA,CAAE,EAAA;AAAA,QACF,oBAAA;AAAA,QACA,GAAG,CAAC,CAAA,SAAA,CAAA;AAAA,QACJ,CAAA,EAAG,OAAA,CAAQ,CAAC,CAAC,CAAA,SAAA,CAAA;AAAA,QACb,CAAC,oBAAoB,oBAAoB,CAAA;AAAA,QACzC;AAAA,UACE,WAAA,EAAa,IAAA;AAAA,UACb,KAAA,EAAO,eAAA,GACH,CAAA,EAAG,KAAA,CAAM,kBAAkB,CAAC,CAAA,GAAA,EAAM,OAAA,CAAQ,eAAe,CAAC,CAAA,CAAA,GAC1D;AAAA;AACN,OACF;AACA,MAAA,OAAO,IAAA,CAAK,IAAA,CAAK,GAAA,CAAqB,GAAG,CAAA;AAAA,IAC3C,CAAA;AAAA;AAAA,IAEA,mBAAA,EAAqB,OAAO,IAAA,EAAiB,EAAA,KAC3C,IAAA,CAAK,eAAA,CAAgB,QAAA,CAAS,mBAAA,EAAqB,WAAA,EAAa,EAAE,IAAA,EAAM,EAAA,EAAG,EAAG;AAAA,MAC5E,WAAA;AAAA,MACA;AAAA,KACD;AAAA,GACL;AAAA;AAAA,EAGS,GAAA,GAAM;AAAA;AAAA,IAEb,YAAA,EAAc,OAAO,IAAA,EAAiB,EAAA,KACpC,KAAK,QAAA,CAA4B,yBAAA,EAA2B,MAAM,EAAA,EAAI;AAAA,MACpE,UAAA;AAAA,MACA;AAAA,KACD,CAAA;AAAA;AAAA,IAEH,WAAA,EAAa,OAAO,IAAA,EAAiB,EAAA,KACnC,KAAK,QAAA,CAA4B,wBAAA,EAA0B,MAAM,EAAA,EAAI;AAAA,MACnE,UAAA;AAAA,MACA,UAAA;AAAA,MACA;AAAA,KACD,CAAA;AAAA;AAAA,IAEH,OAAA,EAAS,OAAO,IAAA,EAAiB,EAAA,KAC/B,KAAK,QAAA,CAAwB,gCAAA,EAAkC,MAAM,EAAA,EAAI;AAAA,MACvE,UAAA;AAAA,MACA;AAAA,KACD;AAAA,GACL;AAAA,EAEA,MAAc,QAAA,CACZ,IAAA,EACA,IAAA,EACA,IACA,OAAA,EACgB;AAChB,IAAA,MAAM,CAAC,CAAA,EAAG,CAAC,CAAA,GAAI,UAAA,CAAW,MAAM,EAAE,CAAA;AAClC,IAAA,MAAM,IAAI,MAAM,IAAA,CAAK,UAAU,MAAA,CAAO,QAAA,CAAS,mBAAmB,IAAI,CAAA;AACtE,IAAA,OAAO,IAAA,CAAK,IAAA,CAAK,GAAA,CAAS,QAAA,CAAS,CAAA,CAAE,IAAI,eAAA,EAAiB,CAAA,EAAG,CAAA,EAAG,OAAO,CAAC,CAAA;AAAA,EAC1E;AACF","file":"index.js","sourcesContent":["/*\n Financial-year arithmetic and resource-name matching for datasets split one resource per\n * GB financial year (1 April – 31 March): \"Thermal Constraint Costs Data 25-26\",\n * \"Constraint Breakdown 2025-2026\", \"Daily Balancing Costs 2025-2026\".\n /\nimport type { CkanResource } from \"./types.js\";\n\n/* Financial year a date (\"YYYY-MM-DD\") falls in, as its starting calendar year. /\nexport function financialYearOf(date: string): number {\n const year = Number(date.slice(0, 4));\n const month = Number(date.slice(5, 7));\n return month >= 4 ? year : year - 1;\n}\n\n/* Starting years of every financial year touched by an inclusive date range. /\nexport function financialYearsBetween(from: string, to: string): number[] {\n const first = financialYearOf(from);\n const last = financialYearOf(to);\n const out: number[] = [];\n for (let y = first; y <= last; y++) out.push(y);\n return out;\n}\n\nconst YEAR_SPAN = /(?<!\\d)(\\d{4}\|\\d{2})\\s[-/–]\\s(\\d{4}\|\\d{2})(?!\\d)/g;\n\n/* The financial year a resource name refers to (\"25-26\" / \"2025-2026\" → 2025), or undefined. /\nexport function financialYearInName(name: string): number \| undefined {\n for (const m of name.matchAll(YEAR_SPAN)) {\n if (!m[1] \|\| !m[2]) continue;\n const start = m[1].length === 2 ? 2000 + Number(m[1]) : Number(m[1]);\n const end = m[2].length === 2 ? 2000 + Number(m[2]) : Number(m[2]);\n if (end === start + 1) return start;\n }\n return undefined;\n}\n\n/* The datastore resource of a dataset for one financial year, if any. /\nexport function resourceForFinancialYear(\n resources: readonly CkanResource[],\n startYear: number,\n): CkanResource \| undefined {\n return resources.find((r) => r.datastore_active && financialYearInName(r.name) === startYear);\n}\n","/\n Client for the NESO Data Portal (https://www.neso.energy/data-portal), a CKAN 2.8 instance at\n * https://api.neso.energy/api/3/action/. No API key. Datasets (\"packages\") hold \"resources\";\n * tabular resources are loaded into a Postgres datastore that `datastore_search` and\n * `datastore_search_sql` query. Many datasets split one resource per GB financial year\n * (April–March), so the helpers resolve the right resource(s) for a date range.\n \n const neso = new NesoClient();\n * const costs = await neso.constraints.thermalCosts(\"2025-04-01\", \"2025-04-07\"); // £/day per boundary\n * const dfs = await neso.dfs.summary(\"2026-10-20\", \"2026-10-22\");\n * const rows = await neso.ckan.sql(`SELECT * FROM \"407f3e9d-…\" WHERE \"Settlement Date\" = '2025-04-01'`);\n \n Licence: National Energy SO Open Data Licence v1.0 (OGL v3 based): copy, adapt, use\n * commercially, with the attribution \"Supported by National Energy SO Open Data\".\n /\nimport {\n type DateInput,\n HttpClient,\n type HttpClientOptions,\n londonDate,\n offsetCursor,\n pages,\n type Query,\n type RateLimit,\n UkEnergyError,\n} from \"@uk-energy/core\";\nimport { financialYearsBetween, resourceForFinancialYear } from \"./resources.js\";\nimport type {\n CkanPackage,\n CkanPackageSearch,\n CkanResource,\n CkanResponse,\n ConstraintBreakdownRow,\n ConstraintForecastRow,\n ConstraintLimitRow,\n DailyBalancingCostRow,\n DatastoreField,\n DatastoreRow,\n DatastoreSearchOptions,\n DatastoreSearchResult,\n DatastoreSqlResult,\n DayAheadFlowRow,\n DfsRequirementRow,\n DfsSummaryRow,\n DfsUtilisationRow,\n ThermalConstraintCostRow,\n} from \"./types.js\";\n\nexport const BASE_URL = \"https://api.neso.energy/api/3/action\";\n\n/\n No limit is published; the licence only reserves the right to throttle \"excessive use\".\n * 5 rps / burst 10 is comfortably polite for a shared public CKAN.\n /\nexport const DEFAULT_RATE_LIMIT: RateLimit = { requestsPerSecond: 5, burst: 10 };\n\n/* Resources update daily or weekly; package metadata is memoised for this long. /\nexport const DEFAULT_CACHE_TTL_MS = 10 60 * 1000;\n\n/** The portal returns up to this many rows per `datastore_search` page. /\nexport const MAX_PAGE_SIZE = 32_000;\n\n/* Dataset (package) names on the portal that the helpers use. /\nexport const PACKAGES = {\n thermalConstraintCosts: \"thermal-constraint-costs\",\n constraintBreakdown: \"constraint-breakdown\",\n constraintCostForecast24m: \"24-months-ahead-constraint-cost-forecast\",\n constraintLimits24m: \"24-months-ahead-constraint-limits\",\n dayAheadConstraintFlows: \"day-ahead-constraint-flows-and-limits\",\n dailyBalancingCosts: \"daily-balancing-costs-balancing-services-use-of-system\",\n demandFlexibility: \"demand-flexibility\",\n} as const;\n\nexport interface NesoClientOptions extends Omit<HttpClientOptions, \"baseUrl\"> {\n baseUrl?: string;\n}\n\n/* Inclusive date range; strings are \"YYYY-MM-DD\", `Date`s are GB-local calendar days. /\ninterface DateRange {\n from: DateInput;\n to: DateInput;\n}\n\nconst DECIMAL = /^-?\\d+(\\.\\d+)?([eE][-+]?\\d+)?$/;\n\nconst NUMERIC_TYPES = new Set([\n \"numeric\",\n \"int4\",\n \"int8\",\n \"float8\",\n \"float4\",\n \"int\",\n \"double precision\",\n]);\n\n/\n The SQL endpoint returns `numeric` columns as strings (\"252\"); `datastore_search` returns\n * numbers. Make rows consistent: numeric-typed columns become numbers, `_full_text` goes.\n /\nexport function normaliseRows<Row extends object>(\n records: readonly DatastoreRow[],\n fields: readonly DatastoreField[],\n extraNumeric: readonly string[] = [],\n): Row[] {\n const numeric = new Set(extraNumeric);\n for (const f of fields) if (NUMERIC_TYPES.has(f.type)) numeric.add(f.id);\n return records.map((r) => {\n const out: DatastoreRow = {};\n for (const [k, v] of Object.entries(r)) {\n if (k === \"_full_text\") continue;\n if (numeric.has(k) && typeof v === \"string\" && DECIMAL.test(v.trim())) {\n const n = Number(v);\n out[k] = Number.isFinite(n) ? n : v;\n } else {\n out[k] = v;\n }\n }\n return out as Row;\n });\n}\n\n/* Double-quote an identifier for the SQL endpoint. /\nexport function ident(name: string): string {\n return `\"${name.replace(/\"/g, '\"\"')}\"`;\n}\n\n/* Single-quote a literal for the SQL endpoint. /\nexport function literal(value: string \| number): string {\n return typeof value === \"number\" ? String(value) : `'${value.replace(/'/g, \"''\")}'`;\n}\n\n/\n `SELECT * FROM \"resource\" WHERE \"col\" >= 'from' AND \"col\" <= 'to' ORDER BY …` — the shape\n * every date-range helper uses. `toExclusive` switches the upper bound to `<` for timestamps.\n /\nexport function rangeSql(\n resourceId: string,\n column: string,\n from: string,\n to: string,\n orderBy: readonly string[],\n opts: { toExclusive?: boolean; where?: string \| undefined } = {},\n): string {\n const upper = opts.toExclusive ? \"<\" : \"<=\";\n const extra = opts.where ? ` AND ${opts.where}` : \"\";\n const order = orderBy.length ? ` ORDER BY ${orderBy.map(ident).join(\", \")}` : \"\";\n return `SELECT FROM ${ident(resourceId)} WHERE ${ident(column)} >= ${literal(from)} AND ${ident(column)} ${upper} ${literal(to)}${extra}${order}`;\n}\n\n/** Inclusive GB-local date range: `Date`s are read as Europe/London calendar days. /\nfunction localRange(from: DateInput, to: DateInput): [string, string] {\n const f = londonDate(from);\n const t = londonDate(to);\n if (f > t) throw new UkEnergyError(`from (${f}) is after to (${t})`);\n return [f, t];\n}\n\nfunction nextDay(date: string): string {\n const d = new Date(`${date}T00:00:00Z`);\n d.setUTCDate(d.getUTCDate() + 1);\n return d.toISOString().slice(0, 10);\n}\n\nexport class NesoClient {\n readonly http: HttpClient;\n private readonly packageCache = new Map<string, { at: number; value: Promise<CkanPackage> }>();\n private readonly packageTtlMs: number;\n\n constructor(opts: NesoClientOptions = {}) {\n this.http = new HttpClient({\n baseUrl: BASE_URL,\n rateLimit: DEFAULT_RATE_LIMIT,\n cacheTtlMs: opts.cache ? DEFAULT_CACHE_TTL_MS : 0,\n ...opts,\n });\n this.packageTtlMs = opts.cacheTtlMs ?? DEFAULT_CACHE_TTL_MS;\n }\n\n /* Any CKAN action; unwraps `{ success, result }` and throws `UkEnergyError` on `success: false`. /\n async action<T>(name: string, query?: Query): Promise<T> {\n const res = await this.http.get<CkanResponse<T>>(name, query);\n if (!res \|\| typeof res !== \"object\" \|\| !(\"success\" in res)) {\n throw new UkEnergyError(`Unexpected response shape for ${name}`);\n }\n if (!res.success) {\n throw new UkEnergyError(`${name}: ${res.error?.message ?? JSON.stringify(res.error)}`);\n }\n return res.result;\n }\n\n /* Raw CKAN API. /\n readonly ckan = {\n /* Dataset metadata and its resources (memoised for `cacheTtlMs`, default 10 minutes). /\n packageShow: async (id: string): Promise<CkanPackage> => {\n const hit = this.packageCache.get(id);\n if (hit && Date.now() - hit.at < this.packageTtlMs) return hit.value;\n const value = this.action<CkanPackage>(\"package_show\", { id }).then((pkg) => {\n if (!pkg \|\| !Array.isArray(pkg.resources)) {\n throw new UkEnergyError(`package_show: unexpected shape for ${id}`);\n }\n return pkg;\n });\n this.packageCache.set(id, { at: Date.now(), value });\n value.catch(() => this.packageCache.delete(id));\n return value;\n },\n /* Search datasets by free text. /\n packageSearch: async (q: string, rows = 20): Promise<CkanPackageSearch> =>\n this.action(\"package_search\", { q, rows }),\n resourceShow: async (id: string): Promise<CkanResource> => this.action(\"resource_show\", { id }),\n /* One page of a datastore resource (up to 32,000 rows). Rows are normalised (see `normaliseRows`). /\n datastoreSearch: async <Row extends object = DatastoreRow>(\n resourceId: string,\n opts: DatastoreSearchOptions = {},\n ): Promise<DatastoreSearchResult<Row>> => {\n const query: Query = {\n resource_id: resourceId,\n limit: opts.limit ?? MAX_PAGE_SIZE,\n sort: opts.sort ?? \"_id\",\n };\n if (opts.offset !== undefined) query.offset = opts.offset;\n if (opts.filters) query.filters = JSON.stringify(opts.filters);\n if (opts.fields) query.fields = opts.fields.join(\",\");\n if (opts.q) query.q = opts.q;\n const res = await this.action<DatastoreSearchResult<DatastoreRow>>(\"datastore_search\", query);\n if (!Array.isArray(res?.records)) {\n throw new UkEnergyError(\"Unexpected response shape for datastore_search\");\n }\n return { ...res, records: normaliseRows<Row>(res.records, res.fields ?? []) };\n },\n /* Every row of a datastore resource, paging by `limit` (default 32,000). /\n datastoreAll: async <Row extends object = DatastoreRow>(\n resourceId: string,\n opts: Omit<DatastoreSearchOptions, \"offset\"> = {},\n ): Promise<Row[]> => {\n const pageSize = Math.min(opts.limit ?? MAX_PAGE_SIZE, MAX_PAGE_SIZE);\n const out: Row[] = [];\n for await (const page of pages<DatastoreSearchResult<Row>, Row, number>({\n fetchPage: (offset) =>\n this.ckan.datastoreSearch<Row>(resourceId, {\n ...opts,\n limit: pageSize,\n offset: offset ?? 0,\n }),\n items: (p) => p.records,\n nextCursor: offsetCursor(pageSize, (p) => p.records.length),\n })) {\n out.push(...page.records);\n }\n return out;\n },\n /\n `datastore_search_sql`: read-only PostgreSQL over the datastore. Resource ids are the\n * table names (quote them). Numeric columns come back as strings from this endpoint; they\n * are converted using the `fields` types, and `_full_text` is dropped.\n /\n sql: async <Row extends object = DatastoreRow>(\n sql: string,\n extraNumeric: readonly string[] = [],\n ): Promise<Row[]> => {\n const res = await this.action<DatastoreSqlResult<DatastoreRow>>(\"datastore_search_sql\", {\n sql,\n });\n if (!Array.isArray(res?.records)) {\n throw new UkEnergyError(\"Unexpected response shape for datastore_search_sql\");\n }\n return normaliseRows<Row>(res.records, res.fields ?? [], extraNumeric);\n },\n };\n\n /* Resolving resources inside datasets. /\n readonly resources = {\n /* All datastore-backed resources of a dataset. /\n datastore: async (packageId: string): Promise<CkanResource[]> =>\n (await this.ckan.packageShow(packageId)).resources.filter((r) => r.datastore_active),\n /* The resource for a GB financial year (`2025` = April 2025 – March 2026), by name. /\n forFinancialYear: async (packageId: string, startYear: number): Promise<CkanResource> => {\n const pkg = await this.ckan.packageShow(packageId);\n const r = resourceForFinancialYear(pkg.resources, startYear);\n if (!r) {\n throw new UkEnergyError(\n `${packageId}: no datastore resource for financial year ${startYear}/${(startYear + 1) % 100}`,\n );\n }\n return r;\n },\n /* The datastore resource whose name matches exactly (or the regex), e.g. \"DFS Utilisation Report\". /\n byName: async (packageId: string, name: string \| RegExp): Promise<CkanResource> => {\n const list = await this.resources.datastore(packageId);\n const r = list.find((x) =>\n typeof name === \"string\" ? x.name.trim() === name.trim() : name.test(x.name),\n );\n if (!r) throw new UkEnergyError(`${packageId}: no datastore resource named ${String(name)}`);\n return r;\n },\n };\n\n /* Rows of a per-financial-year dataset for an inclusive date range, across year boundaries. /\n private async byFinancialYear<Row extends object>(\n packageId: string,\n column: string,\n range: DateRange,\n orderBy: readonly string[],\n opts: { where?: string \| undefined; extraNumeric?: readonly string[] } = {},\n ): Promise<Row[]> {\n const [from, to] = localRange(range.from, range.to);\n const out: Row[] = [];\n for (const fy of financialYearsBetween(from, to)) {\n const resource = await this.resources.forFinancialYear(packageId, fy);\n const sql = rangeSql(resource.id, column, from, to, orderBy, { where: opts.where });\n out.push(...(await this.ckan.sql<Row>(sql, opts.extraNumeric)));\n }\n return out;\n }\n\n /* Transmission constraint costs and forecasts. /\n readonly constraints = {\n /\n Thermal constraint cost per boundary per day (£), `thermal-constraint-costs`. One row per\n * constraint group per settlement date, e.g. SCOTEX, SSHARN, SEIMP (Scottish export\n * boundaries), ESTEX, SWALEX.\n /\n thermalCosts: async (\n from: DateInput,\n to: DateInput,\n constraintGroup?: string,\n ): Promise<ThermalConstraintCostRow[]> =>\n this.byFinancialYear(\n PACKAGES.thermalConstraintCosts,\n \"Settlement Date\",\n { from, to },\n [\"Settlement Date\", \"Constraint Group\"],\n constraintGroup\n ? { where: `${ident(\"Constraint Group\")} = ${literal(constraintGroup)}` }\n : {},\n ),\n /\n Daily constraint cost (£) and volume (MWh) by type: thermal, voltage, inertia, largest\n * loss (`constraint-breakdown`). Thermal volume is negative (energy turned down).\n /\n breakdown: async (from: DateInput, to: DateInput): Promise<ConstraintBreakdownRow[]> =>\n this.byFinancialYear(PACKAGES.constraintBreakdown, \"Date\", { from, to }, [\"Date\"], {\n // \"Thermal constraints cost\" is typed text in some years\n extraNumeric: [\"Thermal constraints cost\"],\n }),\n /* NESO's 24-month-ahead constraint cost forecast, £m per month (24 rows). /\n forecast24m: async (): Promise<ConstraintForecastRow[]> => {\n const r = await this.resources.byName(PACKAGES.constraintCostForecast24m, /Forecast/);\n return this.ckan.datastoreAll<ConstraintForecastRow>(r.id);\n },\n /* 24-month-ahead boundary limits (MW) per week; boundary columns vary by publication. /\n limits24m: async (): Promise<ConstraintLimitRow[]> => {\n const r = await this.resources.byName(PACKAGES.constraintLimits24m, /limits/i);\n return this.ckan.datastoreAll<ConstraintLimitRow>(r.id);\n },\n /\n Day-ahead forecast flow vs limit per boundary, half-hourly, for a range of local dates\n * (`day-ahead-constraint-flows-and-limits`, ~750k rows, so always filtered by SQL).\n /\n dayAheadFlows: async (\n from: DateInput,\n to: DateInput,\n constraintGroup?: string,\n ): Promise<DayAheadFlowRow[]> => {\n const [f, t] = localRange(from, to);\n const r = await this.resources.byName(PACKAGES.dayAheadConstraintFlows, /Flows and Limits/);\n const sql = rangeSql(\n r.id,\n \"Date_ Time GMT_BST\",\n `${f}T00:00:00`,\n `${nextDay(t)}T00:00:00`,\n [\"Constraint Group\", \"Date_ Time GMT_BST\"],\n {\n toExclusive: true,\n where: constraintGroup\n ? `${ident(\"Constraint Group\")} = ${literal(constraintGroup)}`\n : undefined,\n },\n );\n return this.ckan.sql<DayAheadFlowRow>(sql);\n },\n /* Daily balancing (BSUoS) costs per settlement period by category, incl. `Constraints` (£). /\n dailyBalancingCosts: async (from: DateInput, to: DateInput): Promise<DailyBalancingCostRow[]> =>\n this.byFinancialYear(PACKAGES.dailyBalancingCosts, \"SETT_DATE\", { from, to }, [\n \"SETT_DATE\",\n \"SETT_PERIOD\",\n ]),\n };\n\n /* Demand Flexibility Service (current season; archives are separate resources). /\n readonly dfs = {\n /* Published requirements per event window, by delivery date. /\n requirements: async (from: DateInput, to: DateInput): Promise<DfsRequirementRow[]> =>\n this.dfsRange<DfsRequirementRow>(\"DFS Service Requirement\", from, to, [\n \"Event ID\",\n \"From_UTC\",\n ]),\n /* Accepted/rejected bids per participant unit per event window. /\n utilisation: async (from: DateInput, to: DateInput): Promise<DfsUtilisationRow[]> =>\n this.dfsRange<DfsUtilisationRow>(\"DFS Utilisation Report\", from, to, [\n \"Event ID\",\n \"From_UTC\",\n \"DFS Unit ID\",\n ]),\n /* Procured MW, accepted cost and settled volume/cost per event window. */\n summary: async (from: DateInput, to: DateInput): Promise<DfsSummaryRow[]> =>\n this.dfsRange<DfsSummaryRow>(\"DFS Utilisation Report Summary\", from, to, [\n \"Event ID\",\n \"From_UTC\",\n ]),\n };\n\n private async dfsRange<Row extends object>(\n name: string,\n from: DateInput,\n to: DateInput,\n orderBy: readonly string[],\n ): Promise<Row[]> {\n const [f, t] = localRange(from, to);\n const r = await this.resources.byName(PACKAGES.demandFlexibility, name);\n return this.ckan.sql<Row>(rangeSql(r.id, \"Delivery Date\", f, t, orderBy));\n }\n}\n"]}
1	+ {"version":3,"sources":["../src/resources.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/*\n Financial-year arithmetic and resource-name matching for datasets split one resource per\n * GB financial year (1 April – 31 March): \"Thermal Constraint Costs Data 25-26\",\n * \"Constraint Breakdown 2025-2026\", \"Daily Balancing Costs 2025-2026\".\n /\nimport type { CkanResource } from \"./types.js\";\n\n/* Financial year a date (\"YYYY-MM-DD\") falls in, as its starting calendar year. /\nexport function financialYearOf(date: string): number {\n const year = Number(date.slice(0, 4));\n const month = Number(date.slice(5, 7));\n return month >= 4 ? year : year - 1;\n}\n\n/* Starting years of every financial year touched by an inclusive date range. /\nexport function financialYearsBetween(from: string, to: string): number[] {\n const first = financialYearOf(from);\n const last = financialYearOf(to);\n const out: number[] = [];\n for (let y = first; y <= last; y++) out.push(y);\n return out;\n}\n\nconst YEAR_SPAN = /(?<!\\d)(\\d{4}\|\\d{2})\\s[-/–]\\s(\\d{4}\|\\d{2})(?!\\d)/g;\n\n/* The financial year a resource name refers to (\"25-26\" / \"2025-2026\" → 2025), or undefined. /\nexport function financialYearInName(name: string): number \| undefined {\n for (const m of name.matchAll(YEAR_SPAN)) {\n if (!m[1] \|\| !m[2]) continue;\n const start = m[1].length === 2 ? 2000 + Number(m[1]) : Number(m[1]);\n const end = m[2].length === 2 ? 2000 + Number(m[2]) : Number(m[2]);\n if (end === start + 1) return start;\n }\n return undefined;\n}\n\n/* The datastore resource of a dataset for one financial year, if any. /\nexport function resourceForFinancialYear(\n resources: readonly CkanResource[],\n startYear: number,\n): CkanResource \| undefined {\n return resources.find((r) => r.datastore_active && financialYearInName(r.name) === startYear);\n}\n","/\n Client for the NESO Data Portal (https://www.neso.energy/data-portal), a CKAN 2.8 instance at\n * https://api.neso.energy/api/3/action/. No API key. Datasets (\"packages\") hold \"resources\";\n * tabular resources are loaded into a Postgres datastore that `datastore_search` and\n * `datastore_search_sql` query. Many datasets split one resource per GB financial year\n * (April–March), so the helpers resolve the right resource(s) for a date range.\n \n const neso = new NesoClient();\n * const costs = await neso.constraints.thermalCosts(\"2025-04-01\", \"2025-04-07\"); // £/day per boundary\n * const dfs = await neso.dfs.summary(\"2026-10-20\", \"2026-10-22\");\n * const rows = await neso.ckan.sql(`SELECT * FROM \"407f3e9d-…\" WHERE \"Settlement Date\" = '2025-04-01'`);\n \n Licence: National Energy SO Open Data Licence v1.0 (OGL v3 based): copy, adapt, use\n * commercially, with the attribution \"Supported by National Energy SO Open Data\".\n /\nimport {\n CKAN_MAX_PAGE_SIZE,\n CkanClient,\n type CkanResource,\n type DateInput,\n HttpClient,\n type HttpClientOptions,\n ident,\n literal,\n londonDate,\n type Query,\n type RateLimit,\n rangeSql,\n UkEnergyError,\n} from \"@uk-energy/core\";\nimport { financialYearsBetween, resourceForFinancialYear } from \"./resources.js\";\nimport type {\n ConstraintBreakdownRow,\n ConstraintForecastRow,\n ConstraintLimitRow,\n DailyBalancingCostRow,\n DayAheadFlowRow,\n DfsRequirementRow,\n DfsSummaryRow,\n DfsUtilisationRow,\n ThermalConstraintCostRow,\n} from \"./types.js\";\n\nexport const BASE_URL = \"https://api.neso.energy/api/3/action\";\n\n/\n No limit is published; the licence only reserves the right to throttle \"excessive use\".\n * 5 rps / burst 10 is comfortably polite for a shared public CKAN.\n /\nexport const DEFAULT_RATE_LIMIT: RateLimit = { requestsPerSecond: 5, burst: 10 };\n\n/* Resources update daily or weekly; package metadata is memoised for this long. /\nexport const DEFAULT_CACHE_TTL_MS = 10 60 * 1000;\n\n/** The portal returns up to this many rows per `datastore_search` page. /\nexport const MAX_PAGE_SIZE = CKAN_MAX_PAGE_SIZE;\n\n/* Dataset (package) names on the portal that the helpers use. /\nexport const PACKAGES = {\n thermalConstraintCosts: \"thermal-constraint-costs\",\n constraintBreakdown: \"constraint-breakdown\",\n constraintCostForecast24m: \"24-months-ahead-constraint-cost-forecast\",\n constraintLimits24m: \"24-months-ahead-constraint-limits\",\n dayAheadConstraintFlows: \"day-ahead-constraint-flows-and-limits\",\n dailyBalancingCosts: \"daily-balancing-costs-balancing-services-use-of-system\",\n demandFlexibility: \"demand-flexibility\",\n} as const;\n\nexport interface NesoClientOptions extends Omit<HttpClientOptions, \"baseUrl\"> {\n baseUrl?: string;\n}\n\n/* Inclusive date range; strings are \"YYYY-MM-DD\", `Date`s are GB-local calendar days. /\ninterface DateRange {\n from: DateInput;\n to: DateInput;\n}\n\nexport { ident, literal, normaliseRows, rangeSql } from \"@uk-energy/core\";\n\n/* Inclusive GB-local date range: `Date`s are read as Europe/London calendar days. /\nfunction localRange(from: DateInput, to: DateInput): [string, string] {\n const f = londonDate(from);\n const t = londonDate(to);\n if (f > t) throw new UkEnergyError(`from (${f}) is after to (${t})`);\n return [f, t];\n}\n\nfunction nextDay(date: string): string {\n const d = new Date(`${date}T00:00:00Z`);\n d.setUTCDate(d.getUTCDate() + 1);\n return d.toISOString().slice(0, 10);\n}\n\nexport class NesoClient {\n readonly http: HttpClient;\n /* Raw CKAN API (`@uk-energy/core` `CkanClient`): `packageShow` (memoised), `datastoreSearch`, `datastoreAll`, `sql`… /\n readonly ckan: CkanClient;\n\n constructor(opts: NesoClientOptions = {}) {\n this.http = new HttpClient({\n baseUrl: BASE_URL,\n rateLimit: DEFAULT_RATE_LIMIT,\n cacheTtlMs: opts.cache ? DEFAULT_CACHE_TTL_MS : 0,\n ...opts,\n });\n this.ckan = new CkanClient(this.http, {\n packageTtlMs: opts.cacheTtlMs ?? DEFAULT_CACHE_TTL_MS,\n maxPageSize: MAX_PAGE_SIZE,\n });\n }\n\n /* Any CKAN action; unwraps `{ success, result }` and throws `UkEnergyError` on `success: false`. /\n async action<T>(name: string, query?: Query): Promise<T> {\n return this.ckan.action<T>(name, query);\n }\n\n /* Resolving resources inside datasets. /\n readonly resources = {\n /* All datastore-backed resources of a dataset. /\n datastore: async (packageId: string): Promise<CkanResource[]> =>\n this.ckan.datastoreResources(packageId),\n /* The resource for a GB financial year (`2025` = April 2025 – March 2026), by name. /\n forFinancialYear: async (packageId: string, startYear: number): Promise<CkanResource> => {\n const pkg = await this.ckan.packageShow(packageId);\n const r = resourceForFinancialYear(pkg.resources, startYear);\n if (!r) {\n throw new UkEnergyError(\n `${packageId}: no datastore resource for financial year ${startYear}/${(startYear + 1) % 100}`,\n );\n }\n return r;\n },\n /* The datastore resource whose name matches exactly (or the regex), e.g. \"DFS Utilisation Report\". /\n byName: async (packageId: string, name: string \| RegExp): Promise<CkanResource> =>\n this.ckan.resourceByName(packageId, name),\n };\n\n /* Rows of a per-financial-year dataset for an inclusive date range, across year boundaries. /\n private async byFinancialYear<Row extends object>(\n packageId: string,\n column: string,\n range: DateRange,\n orderBy: readonly string[],\n opts: { where?: string \| undefined; extraNumeric?: readonly string[] } = {},\n ): Promise<Row[]> {\n const [from, to] = localRange(range.from, range.to);\n const out: Row[] = [];\n for (const fy of financialYearsBetween(from, to)) {\n const resource = await this.resources.forFinancialYear(packageId, fy);\n const sql = rangeSql(resource.id, column, from, to, orderBy, { where: opts.where });\n out.push(...(await this.ckan.sql<Row>(sql, opts.extraNumeric)));\n }\n return out;\n }\n\n /* Transmission constraint costs and forecasts. /\n readonly constraints = {\n /\n Thermal constraint cost per boundary per day (£), `thermal-constraint-costs`. One row per\n * constraint group per settlement date, e.g. SCOTEX, SSHARN, SEIMP (Scottish export\n * boundaries), ESTEX, SWALEX.\n /\n thermalCosts: async (\n from: DateInput,\n to: DateInput,\n constraintGroup?: string,\n ): Promise<ThermalConstraintCostRow[]> =>\n this.byFinancialYear(\n PACKAGES.thermalConstraintCosts,\n \"Settlement Date\",\n { from, to },\n [\"Settlement Date\", \"Constraint Group\"],\n constraintGroup\n ? { where: `${ident(\"Constraint Group\")} = ${literal(constraintGroup)}` }\n : {},\n ),\n /\n Daily constraint cost (£) and volume (MWh) by type: thermal, voltage, inertia, largest\n * loss (`constraint-breakdown`). Thermal volume is negative (energy turned down).\n /\n breakdown: async (from: DateInput, to: DateInput): Promise<ConstraintBreakdownRow[]> =>\n this.byFinancialYear(PACKAGES.constraintBreakdown, \"Date\", { from, to }, [\"Date\"], {\n // \"Thermal constraints cost\" is typed text in some years\n extraNumeric: [\"Thermal constraints cost\"],\n }),\n /* NESO's 24-month-ahead constraint cost forecast, £m per month (24 rows). /\n forecast24m: async (): Promise<ConstraintForecastRow[]> => {\n const r = await this.resources.byName(PACKAGES.constraintCostForecast24m, /Forecast/);\n return this.ckan.datastoreAll<ConstraintForecastRow>(r.id);\n },\n /* 24-month-ahead boundary limits (MW) per week; boundary columns vary by publication. /\n limits24m: async (): Promise<ConstraintLimitRow[]> => {\n const r = await this.resources.byName(PACKAGES.constraintLimits24m, /limits/i);\n return this.ckan.datastoreAll<ConstraintLimitRow>(r.id);\n },\n /\n Day-ahead forecast flow vs limit per boundary, half-hourly, for a range of local dates\n * (`day-ahead-constraint-flows-and-limits`, ~750k rows, so always filtered by SQL).\n /\n dayAheadFlows: async (\n from: DateInput,\n to: DateInput,\n constraintGroup?: string,\n ): Promise<DayAheadFlowRow[]> => {\n const [f, t] = localRange(from, to);\n const r = await this.resources.byName(PACKAGES.dayAheadConstraintFlows, /Flows and Limits/);\n const sql = rangeSql(\n r.id,\n \"Date_ Time GMT_BST\",\n `${f}T00:00:00`,\n `${nextDay(t)}T00:00:00`,\n [\"Constraint Group\", \"Date_ Time GMT_BST\"],\n {\n toExclusive: true,\n where: constraintGroup\n ? `${ident(\"Constraint Group\")} = ${literal(constraintGroup)}`\n : undefined,\n },\n );\n return this.ckan.sql<DayAheadFlowRow>(sql);\n },\n /* Daily balancing (BSUoS) costs per settlement period by category, incl. `Constraints` (£). /\n dailyBalancingCosts: async (from: DateInput, to: DateInput): Promise<DailyBalancingCostRow[]> =>\n this.byFinancialYear(PACKAGES.dailyBalancingCosts, \"SETT_DATE\", { from, to }, [\n \"SETT_DATE\",\n \"SETT_PERIOD\",\n ]),\n };\n\n /* Demand Flexibility Service (current season; archives are separate resources). /\n readonly dfs = {\n /* Published requirements per event window, by delivery date. /\n requirements: async (from: DateInput, to: DateInput): Promise<DfsRequirementRow[]> =>\n this.dfsRange<DfsRequirementRow>(\"DFS Service Requirement\", from, to, [\n \"Event ID\",\n \"From_UTC\",\n ]),\n /* Accepted/rejected bids per participant unit per event window. /\n utilisation: async (from: DateInput, to: DateInput): Promise<DfsUtilisationRow[]> =>\n this.dfsRange<DfsUtilisationRow>(\"DFS Utilisation Report\", from, to, [\n \"Event ID\",\n \"From_UTC\",\n \"DFS Unit ID\",\n ]),\n /* Procured MW, accepted cost and settled volume/cost per event window. */\n summary: async (from: DateInput, to: DateInput): Promise<DfsSummaryRow[]> =>\n this.dfsRange<DfsSummaryRow>(\"DFS Utilisation Report Summary\", from, to, [\n \"Event ID\",\n \"From_UTC\",\n ]),\n };\n\n private async dfsRange<Row extends object>(\n name: string,\n from: DateInput,\n to: DateInput,\n orderBy: readonly string[],\n ): Promise<Row[]> {\n const [f, t] = localRange(from, to);\n const r = await this.resources.byName(PACKAGES.demandFlexibility, name);\n return this.ckan.sql<Row>(rangeSql(r.id, \"Delivery Date\", f, t, orderBy));\n }\n}\n"]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@uk-energy/neso",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Typed client for the NESO Data Portal (CKAN): datastore search and SQL, thermal constraint costs, constraint breakdown and forecasts, day-ahead boundary flows, Demand Flexibility Service, daily balancing costs. Part of uk-energy-sdk.",
   "license": "MIT",
   "type": "module",
@@ -44,7 +44,7 @@
     "uk-energy"
   ],
   "dependencies": {
-    "@uk-energy/core": "^0.2.0"
+    "@uk-energy/core": "^0.3.0"
   },
   "publishConfig": {
     "access": "public"