@maschinenlesbar.org/luftqualitaet-cli 0.0.1

package/LICENSING.md

@@ -0,0 +1,47 @@
+# Licensing
+
+`luftqualitaet-cli` is **dual-licensed**. You may use it under **either** of the
+following, at your choice:
+
+## 1. Open source — AGPL-3.0-or-later (default)
+
+Free to use, modify, and distribute under the
+[GNU Affero General Public License v3.0 or later](LICENSE).
+
+The key obligation is the AGPL's **§13 network clause**: if you run a modified
+version of this software to provide a service to others over a network, you must
+make the complete corresponding source code of your modified version available
+to the users of that service. The usual copyleft terms also apply when you
+distribute the software or works based on it.
+
+This is the right option for open-source projects, internal and personal use,
+evaluation, and anyone able to comply with the AGPL.
+
+## 2. Commercial license
+
+If the AGPL's obligations do not fit your situation — for example, you want to:
+
+- embed `luftqualitaet-cli` in a **closed-source / proprietary product**, or
+- run a **modified version as a proprietary network service (SaaS)** without
+  disclosing your source, or
+- keep your modifications private,
+
+then a separate **commercial license** is available. It grants use of the same
+code without the AGPL's copyleft and network-disclosure obligations, under
+negotiated terms.
+
+**To obtain a commercial license, contact:** sebs@2xs.org
+
+## Why this is possible
+
+The copyright holder owns 100% of the source code in this repository and can
+therefore offer it under more than one license simultaneously. This project does
+**not** accept external code contributions (see [CONTRIBUTING.md](CONTRIBUTING.md)),
+which keeps copyright ownership single and unambiguous — a prerequisite for
+offering the commercial option. The only third-party dependency that ships with
+the package, [`commander`](https://github.com/tj/commander.js), is MIT-licensed
+and compatible with both licensing options.
+
+---
+
+Copyright © 2026 Sebastian Schürmann. All rights reserved.

package/README.md

@@ -0,0 +1,208 @@
+# luftqualitaet-cli
+
+A TypeScript **API client** and **command-line interface** for the open
+[Umweltbundesamt Air Data API](https://luftqualitaet.api.bund.dev/)
+(`umweltbundesamt.de/api/air_data`) — German **air-quality** measurements,
+indices, annual balances, exceedances and the station/component metadata behind them.
+
+> This client targets `/api/air_data/v3`, the live API path, which supersedes the
+> **v2** OpenAPI spec published at [luftqualitaet.api.bund.dev](https://luftqualitaet.api.bund.dev/).
+
+New to the UBA Air Data API, or terms like *component*, *scope*, *station type*
+or the hour-ending time window? See **[GLOSSARY.md](GLOSSARY.md)** for the domain
+concepts and the project's own vocabulary.
+
+- **Zero runtime HTTP dependencies** — built on Node's built-in `http`/`https` (no axios, no fetch polyfill).
+- **One small dependency** for the CLI: [`commander`](https://github.com/tj/commander.js).
+- **Strongly typed** — typed parameter objects and the lang/index/use enums.
+- **Tested** — unit tests on Node's built-in test runner (`node --test`); every HTTP response is mocked (no real network in the suite).
+- **Read-only, no auth** — the UBA Air Data API needs no key; this client only reads.
+
+## Requirements
+
+- Node.js **>= 20** (uses the stable built-in test runner, ESM and top-level `await`).
+
+## Install
+
+```bash
+npm install
+npm run build        # compiles TypeScript to dist/
+```
+
+Run the CLI without a global install:
+
+```bash
+node dist/src/cli/index.js --help
+# or, after `npm link` / global install:
+luftqualitaet --help
+```
+
+---
+
+## How the API works
+
+UBA responses are **index + data** structures: an `indices` array names the
+columns and the payload is a compact map keyed by id/code/timestamp. This client
+returns those payloads faithfully (as JSON) and focuses on getting the request
+right. Look up station ids and component ids via `meta`, `components`, etc.
+
+### Global options
+
+| Option | Description |
+| --- | --- |
+| `--base-url <url>` | API base URL (default `https://www.umweltbundesamt.de`) |
+| `--timeout <ms>` | Per-request timeout (default `30000`) |
+| `--user-agent <ua>` | `User-Agent` header value |
+| `--max-retries <n>` | Retries for transient `429`/`503` responses (default `2`) |
+| `--max-response-bytes <n>` | Cap response body size in bytes (`0` = unlimited; default 100 MiB) |
+| `--compact` | Print JSON on a single line |
+
+Global options may be given either before or after the command, e.g.
+`luftqualitaet --compact components --lang de` or `luftqualitaet components --compact --lang de`.
+
+### Commands
+
+```text
+# Reference lists
+components | networks | scopes            [--lang de|en] [--index id|code]
+station-types | station-settings | transgression-types   [--lang de|en]
+
+# Data (a time window is date-from/time-from .. date-to/time-to, hour 1..24)
+airquality        --date-from --time-from --date-to --time-to --station
+airquality-limits
+measures          --date-from --time-from --date-to --time-to --station [--component] [--scope]
+measures-limits
+annual-balances   --component --year [--lang] [--index]
+transgressions    --component --year [--lang] [--index]
+thresholds        --use airquality|measure [--lang] [--component] [--scope]
+meta              --use airquality|measure|transgression|annualbalance|map [--lang] [--date-from --date-to]
+```
+
+### Examples
+
+```bash
+# Components (pollutants) in German, keyed by code
+luftqualitaet components --lang de --index code
+
+# Air-quality index for station 143 on one day
+luftqualitaet airquality --date-from 2024-01-01 --time-from 1 \
+  --date-to 2024-01-01 --time-to 24 --station 143
+
+# Annual PM10 (component 1) balance for 2023
+luftqualitaet annual-balances --component 1 --year 2023 --lang de
+
+# Metadata needed to pick stations/components for a measurement query
+luftqualitaet meta --use measure --lang de
+```
+
+Exit codes: `0` success, `4` on a `404` from the API, `1` for any other error, non-zero for usage errors.
+
+---
+
+## Library usage
+
+```ts
+import { LuftqualitaetClient, LuftApiError } from "@maschinenlesbar.org/luftqualitaet-cli";
+
+const client = new LuftqualitaetClient(); // defaults to https://www.umweltbundesamt.de
+
+const components = await client.components({ lang: "de" });
+const aq = await client.airquality({
+  date_from: "2024-01-01", time_from: 1, date_to: "2024-01-01", time_to: 24, station: 143,
+});
+
+try {
+  await client.thresholds({ use: "measure" });
+} catch (err) {
+  if (err instanceof LuftApiError) console.error(err.status, err.detail);
+}
+```
+
+### Client options
+
+```ts
+new LuftqualitaetClient({
+  baseUrl: "https://www.umweltbundesamt.de",
+  timeoutMs: 15_000,
+  maxRetries: 3,              // 429 / 503 are retried with linear backoff
+  maxResponseBytes: 50 << 20, // abort responses larger than 50 MiB (0 = unlimited)
+  userAgent: "my-app/1.0",
+  transport: customTransport, // inject your own HTTP transport
+});
+```
+
+### Methods
+
+`airquality`, `airqualityLimits`, `measures`, `measuresLimits`, `annualBalances`,
+`transgressions`, `components`, `networks`, `scopes`, `stationTypes`, `stationSettings`,
+`transgressionTypes`, `thresholds`, `meta`. The `LangValues` / `IndexValues` /
+`MetaUseValues` / `ThresholdUseValues` enums are exported for reference.
+
+---
+
+## Architecture
+
+```
+src/
+  client/
+    enums.ts     # Lang / IndexKind / MetaUse / ThresholdUse value sets
+    types.ts     # parameter objects (responses kept as faithful JsonObject)
+    query.ts     # dependency-free query-string builder
+    http.ts      # the Transport interface + default node:http/https transport
+    engine.ts    # URL building, retry/backoff, redirects (cross-origin headers stripped), JSON decoding, error mapping
+    errors.ts    # LuftError / LuftApiError / LuftNetworkError / LuftParseError
+    client.ts    # LuftqualitaetClient — the air-data surface over the engine
+  cli/
+    io.ts        # injectable I/O seam (stdout/stderr)
+    shared.ts    # option parsers, global-option resolver, JSON renderer
+    commands/    # reference lists + data endpoints
+    program.ts   # assembles the commander program from injectable deps
+    run.ts       # parses argv -> exit code (no process.exit; testable)
+    index.ts     # #! bin shim
+```
+
+**Design notes**
+
+- The HTTP layer is a single `Transport` function (`(req) => Promise<HttpResponse>`). The default
+  uses `node:http`/`node:https`; tests inject a mock. This keeps the client free of any HTTP framework.
+- The CLI is built around injectable `CliDeps` (client factory + I/O), so the whole program can be
+  driven in-process by tests with a mocked client and captured output — no subprocesses.
+- UBA responses are index/data structures whose exact shape varies by endpoint, so they are returned
+  as faithful raw `JsonObject`s rather than partially-guessed types.
+
+---
+
+## Testing
+
+```bash
+npm test          # builds, then runs `node --test` over dist/test
+```
+
+- **`query.test.ts`** — query-string serialisation.
+- **`http.test.ts`** — the default transport against a real loopback `http.createServer`.
+- **`engine.test.ts`** — URL building, JSON decoding, error mapping, 429/503 retry, redirects — mocked transport.
+- **`client.test.ts`** — a parameterized table over all 15 client methods asserting URL/query mapping plus parameter pruning — mocked transport.
+- **`cli.test.ts`** — end-to-end command parsing, domain validation (hour `1..24`, year `>= 2016`, positive ids, date format, conditional `meta` window) and exit codes — mocked client.
+
+## Continuous integration
+
+GitHub Actions workflows under `.github/workflows/`:
+
+- **ci.yml** — type-check, build and test on Node 20/22/24 for every push and PR.
+- **release.yml** — on a `v*` tag: verify the tag matches `package.json`, test, `npm pack`, and create a GitHub Release with the tarball.
+- **publish.yml** — manual dispatch: publish to npm via OIDC **Trusted Publishing** (no stored `NPM_TOKEN`) with provenance.
+- **docs.yml** — build TypeDoc API docs and deploy to GitHub Pages on each `v*` tag.
+
+## License
+
+**Dual-licensed** — use it under **either**:
+
+- **[AGPL-3.0-or-later](LICENSE)** (default, free). Note the AGPL's §13 network
+  clause: if you run a modified version as a network service, you must offer that
+  modified source to the service's users.
+- **Commercial license** (paid), for closed-source / proprietary or SaaS use
+  without the AGPL's obligations.
+
+See **[LICENSING.md](LICENSING.md)** for details, and **[CONTRIBUTING.md](CONTRIBUTING.md)**
+for the contribution policy (this project does not accept external code
+contributions). Commercial enquiries: **sebs@2xs.org**.

package/dist/src/cli/commands/data.d.ts

@@ -0,0 +1,4 @@
+import { type Command } from "commander";
+import type { CliDeps } from "../io.js";
+export declare function registerDataCommands(program: Command, deps: CliDeps): void;
+//# sourceMappingURL=data.d.ts.map

package/dist/src/cli/commands/data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/data.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAkExC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAsK1E"}

package/dist/src/cli/commands/data.js

@@ -0,0 +1,152 @@
+import { InvalidArgumentError } from "commander";
+import { action, assertEnum, index, lang, parseHour, parseIndexArg, parseLangArg, parsePositiveIntArg, parseYear, renderJson, } from "../shared.js";
+import { MetaUseValues, ThresholdUseValues } from "../../client/enums.js";
+import { LuftError } from "../../client/errors.js";
+/** commander value-parser: a real calendar date in `YYYY-MM-DD` form. */
+function parseDate(value) {
+    const match = /^(\d{4})-(\d{2})-(\d{2})$/.exec(value);
+    if (!match) {
+        throw new InvalidArgumentError("Expected a date in YYYY-MM-DD format.");
+    }
+    const year = Number(match[1]);
+    const month = Number(match[2]);
+    const day = Number(match[3]);
+    // Reject impossible calendar dates (e.g. 2024-13-40, 0000-00-00). Round-tripping
+    // through Date catches month/day overflow including leap-year boundaries.
+    const date = new Date(Date.UTC(year, month - 1, day));
+    if (date.getUTCFullYear() !== year ||
+        date.getUTCMonth() !== month - 1 ||
+        date.getUTCDate() !== day) {
+        throw new InvalidArgumentError(`Expected a valid calendar date, got "${value}".`);
+    }
+    return value;
+}
+/**
+ * Reject a reversed time window (start after end) locally, consistent with the
+ * other client-side guards (positive ids, year floor). The window is ordered by
+ * date first, then by hour-ending within the same date.
+ */
+function assertWindowOrdered(dateFrom, timeFrom, dateTo, timeTo) {
+    if (dateFrom > dateTo || (dateFrom === dateTo && timeFrom > timeTo)) {
+        throw new LuftError(`Window start (${dateFrom} ${timeFrom}:00) is after window end (${dateTo} ${timeTo}:00).`);
+    }
+}
+/** Add the shared time-window + station options required by the data endpoints. */
+function addWindowOptions(cmd) {
+    return cmd
+        .requiredOption("--date-from <YYYY-MM-DD>", "window start date", parseDate)
+        .requiredOption("--time-from <1-24>", "window start hour", parseHour)
+        .requiredOption("--date-to <YYYY-MM-DD>", "window end date", parseDate)
+        .requiredOption("--time-to <1-24>", "window end hour", parseHour)
+        .requiredOption("--station <id>", "station id", parsePositiveIntArg);
+}
+export function registerDataCommands(program, deps) {
+    addWindowOptions(program.command("airquality").description("Air-quality index data for a station/window")).action(action(deps, async ({ client, global, opts }) => {
+        assertWindowOrdered(String(opts["dateFrom"]), opts["timeFrom"], String(opts["dateTo"]), opts["timeTo"]);
+        renderJson(deps, global, await client.airquality({
+            date_from: String(opts["dateFrom"]),
+            time_from: opts["timeFrom"],
+            date_to: String(opts["dateTo"]),
+            time_to: opts["timeTo"],
+            station: opts["station"],
+        }));
+    }));
+    program
+        .command("airquality-limits")
+        .description("Available date range per station for air-quality data")
+        .action(action(deps, async ({ client, global }) => {
+        renderJson(deps, global, await client.airqualityLimits());
+    }));
+    addWindowOptions(program
+        .command("measures")
+        .description("Raw measurements for a station/window")
+        .option("--component <id>", "component id", parsePositiveIntArg)
+        .option("--scope <id>", "scope id", parsePositiveIntArg)).action(action(deps, async ({ client, global, opts }) => {
+        assertWindowOrdered(String(opts["dateFrom"]), opts["timeFrom"], String(opts["dateTo"]), opts["timeTo"]);
+        renderJson(deps, global, await client.measures({
+            date_from: String(opts["dateFrom"]),
+            time_from: opts["timeFrom"],
+            date_to: String(opts["dateTo"]),
+            time_to: opts["timeTo"],
+            station: opts["station"],
+            component: opts["component"],
+            scope: opts["scope"],
+        }));
+    }));
+    program
+        .command("measures-limits")
+        .description("Available date range per scope/component/station")
+        .action(action(deps, async ({ client, global }) => {
+        renderJson(deps, global, await client.measuresLimits());
+    }));
+    const yearComponent = [
+        {
+            name: "annual-balances",
+            method: "annualBalances",
+            desc: "Annual tabulations for a component and year",
+        },
+        {
+            name: "transgressions",
+            method: "transgressions",
+            desc: "Exceedances for a component and year",
+        },
+    ];
+    for (const { name, method, desc } of yearComponent) {
+        program
+            .command(name)
+            .description(desc)
+            .requiredOption("--component <id>", "component id", parsePositiveIntArg)
+            .requiredOption("--year <YYYY>", "year (>= 2016)", parseYear)
+            .option("--lang <lang>", "de | en", parseLangArg)
+            .option("--index <index>", "id | code", parseIndexArg)
+            .action(action(deps, async ({ client, global, opts }) => {
+            renderJson(deps, global, await client[method]({
+                component: opts["component"],
+                year: opts["year"],
+                lang: lang(opts),
+                index: index(opts),
+            }));
+        }));
+    }
+    program
+        .command("thresholds")
+        .description("Thresholds for a use (airquality | measure)")
+        .requiredOption("--use <use>", `${ThresholdUseValues.join(" | ")}`)
+        .option("--lang <lang>", "de | en", parseLangArg)
+        .option("--component <id>", "component id", parsePositiveIntArg)
+        .option("--scope <id>", "scope id", parsePositiveIntArg)
+        .action(action(deps, async ({ client, global, opts }) => {
+        renderJson(deps, global, await client.thresholds({
+            use: assertEnum(String(opts["use"]), ThresholdUseValues, "use"),
+            lang: lang(opts),
+            component: opts["component"],
+            scope: opts["scope"],
+        }));
+    }));
+    program
+        .command("meta")
+        .description("Combined metadata for a use")
+        .requiredOption("--use <use>", `${MetaUseValues.join(" | ")}`)
+        .option("--lang <lang>", "de | en", parseLangArg)
+        .option("--date-from <YYYY-MM-DD>", "required when use=airquality", parseDate)
+        .option("--date-to <YYYY-MM-DD>", "required when use=airquality", parseDate)
+        .option("--time-from <1-24>", "window start hour", parseHour)
+        .option("--time-to <1-24>", "window end hour", parseHour)
+        .action(action(deps, async ({ client, global, opts }) => {
+        const use = assertEnum(String(opts["use"]), MetaUseValues, "use");
+        const dateFrom = opts["dateFrom"];
+        const dateTo = opts["dateTo"];
+        if (use === "airquality" && (dateFrom === undefined || dateTo === undefined)) {
+            throw new LuftError("meta --use airquality requires --date-from and --date-to.");
+        }
+        renderJson(deps, global, await client.meta({
+            use,
+            lang: lang(opts),
+            date_from: dateFrom,
+            date_to: dateTo,
+            time_from: opts["timeFrom"],
+            time_to: opts["timeTo"],
+        }));
+    }));
+}
+//# sourceMappingURL=data.js.map

package/dist/src/cli/commands/data.js.map

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

package/dist/src/cli/commands/reference.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from "commander";
+import type { CliDeps } from "../io.js";
+export declare function registerReferenceCommands(program: Command, deps: CliDeps): void;
+//# sourceMappingURL=reference.d.ts.map

package/dist/src/cli/commands/reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/reference.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAGxC,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAuC/E"}

package/dist/src/cli/commands/reference.js

@@ -0,0 +1,33 @@
+import { action, index, lang, parseIndexArg, parseLangArg, renderJson } from "../shared.js";
+export function registerReferenceCommands(program, deps) {
+    const indexed = [
+        { name: "components", method: "components", desc: "List measured components (pollutants)" },
+        { name: "networks", method: "networks", desc: "List measurement networks" },
+        { name: "scopes", method: "scopes", desc: "List measurement scopes" },
+    ];
+    for (const { name, method, desc } of indexed) {
+        program
+            .command(name)
+            .description(desc)
+            .option("--lang <lang>", "de | en", parseLangArg)
+            .option("--index <index>", "id | code", parseIndexArg)
+            .action(action(deps, async ({ client, global, opts }) => {
+            renderJson(deps, global, await client[method]({ lang: lang(opts), index: index(opts) }));
+        }));
+    }
+    const simple = [
+        { name: "station-types", method: "stationTypes", desc: "List station types" },
+        { name: "station-settings", method: "stationSettings", desc: "List station settings" },
+        { name: "transgression-types", method: "transgressionTypes", desc: "List exceedance types" },
+    ];
+    for (const { name, method, desc } of simple) {
+        program
+            .command(name)
+            .description(desc)
+            .option("--lang <lang>", "de | en", parseLangArg)
+            .action(action(deps, async ({ client, global, opts }) => {
+            renderJson(deps, global, await client[method](lang(opts)));
+        }));
+    }
+}
+//# sourceMappingURL=reference.js.map

package/dist/src/cli/commands/reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.js","sourceRoot":"","sources":["../../../../src/cli/commands/reference.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE5F,MAAM,UAAU,yBAAyB,CAAC,OAAgB,EAAE,IAAa;IACvE,MAAM,OAAO,GAAmF;QAC9F,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,uCAAuC,EAAE;QAC3F,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,2BAA2B,EAAE;QAC3E,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,yBAAyB,EAAE;KACtE,CAAC;IACF,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,OAAO,EAAE,CAAC;QAC7C,OAAO;aACJ,OAAO,CAAC,IAAI,CAAC;aACb,WAAW,CAAC,IAAI,CAAC;aACjB,MAAM,CAAC,eAAe,EAAE,SAAS,EAAE,YAAY,CAAC;aAChD,MAAM,CAAC,iBAAiB,EAAE,WAAW,EAAE,aAAa,CAAC;aACrD,MAAM,CACL,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE;YAC9C,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3F,CAAC,CAAC,CACH,CAAC;IACN,CAAC;IAED,MAAM,MAAM,GAIN;QACJ,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,oBAAoB,EAAE;QAC7E,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,uBAAuB,EAAE;QACtF,EAAE,IAAI,EAAE,qBAAqB,EAAE,MAAM,EAAE,oBAAoB,EAAE,IAAI,EAAE,uBAAuB,EAAE;KAC7F,CAAC;IACF,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,MAAM,EAAE,CAAC;QAC5C,OAAO;aACJ,OAAO,CAAC,IAAI,CAAC;aACb,WAAW,CAAC,IAAI,CAAC;aACjB,MAAM,CAAC,eAAe,EAAE,SAAS,EAAE,YAAY,CAAC;aAChD,MAAM,CACL,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE;YAC9C,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7D,CAAC,CAAC,CACH,CAAC;IACN,CAAC;AACH,CAAC"}

package/dist/src/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/src/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/src/cli/index.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+// Binary entry point. Thin shim around run(); all logic lives in run.ts/program.ts.
+import { run } from "./run.js";
+const exitCode = await run(process.argv.slice(2));
+process.exitCode = exitCode;
+//# sourceMappingURL=index.js.map

package/dist/src/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":";AACA,oFAAoF;AAEpF,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAClD,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC"}

package/dist/src/cli/io.d.ts

@@ -0,0 +1,13 @@
+import type { LuftqualitaetClient } from "../client/client.js";
+import type { EngineOptions } from "../client/engine.js";
+export interface CliIO {
+    out(text: string): void;
+    err(text: string): void;
+}
+export interface CliDeps {
+    io: CliIO;
+    /** Build a client from the resolved global options (injectable for tests). */
+    createClient(options: EngineOptions): LuftqualitaetClient;
+}
+export declare const defaultIO: CliIO;
+//# sourceMappingURL=io.d.ts.map

package/dist/src/cli/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../../src/cli/io.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,WAAW,KAAK;IACpB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,KAAK,CAAC;IACV,8EAA8E;IAC9E,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,mBAAmB,CAAC;CAC3D;AAED,eAAO,MAAM,SAAS,EAAE,KAGvB,CAAC"}

package/dist/src/cli/io.js

@@ -0,0 +1,7 @@
+// I/O seam for the CLI. Everything the CLI writes goes through a CliIO object so
+// tests can capture output instead of hitting the real stdout/stderr/filesystem.
+export const defaultIO = {
+    out: (text) => process.stdout.write(text + "\n"),
+    err: (text) => process.stderr.write(text + "\n"),
+};
+//# sourceMappingURL=io.js.map

package/dist/src/cli/io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.js","sourceRoot":"","sources":["../../../src/cli/io.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,iFAAiF;AAgBjF,MAAM,CAAC,MAAM,SAAS,GAAU;IAC9B,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;IAChD,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;CACjD,CAAC"}

package/dist/src/cli/program.d.ts

@@ -0,0 +1,7 @@
+import { Command } from "commander";
+import type { CliDeps } from "./io.js";
+export declare const VERSION: string;
+/** Default dependencies: real client + real stdout/stderr/filesystem. */
+export declare const defaultDeps: CliDeps;
+export declare function buildProgram(deps?: CliDeps): Command;
+//# sourceMappingURL=program.d.ts.map

package/dist/src/cli/program.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../../../src/cli/program.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAuBvC,eAAO,MAAM,OAAO,QAAgB,CAAC;AAErC,yEAAyE;AACzE,eAAO,MAAM,WAAW,EAAE,OAGzB,CAAC;AAEF,wBAAgB,YAAY,CAAC,IAAI,GAAE,OAAqB,GAAG,OAAO,CA0BjE"}

package/dist/src/cli/program.js

@@ -0,0 +1,52 @@
+// Assemble the full commander program. The program is built around an injectable
+// CliDeps so the entire CLI can be driven in tests with a mocked client and
+// captured output.
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { Command } from "commander";
+import { defaultIO } from "./io.js";
+import { LuftqualitaetClient } from "../client/client.js";
+import { parseIntArg } from "./shared.js";
+import { registerReferenceCommands } from "./commands/reference.js";
+import { registerDataCommands } from "./commands/data.js";
+/**
+ * Single source of truth for the version: read from package.json at runtime
+ * rather than duplicating a literal that can silently drift after a release bump.
+ * From the compiled location (dist/src/cli/program.js) package.json is three
+ * directories up; the same offset holds for the source under src/cli.
+ */
+function readVersion() {
+    try {
+        const pkgUrl = new URL("../../../package.json", import.meta.url);
+        const pkg = JSON.parse(readFileSync(fileURLToPath(pkgUrl), "utf8"));
+        return pkg.version ?? "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+export const VERSION = readVersion();
+/** Default dependencies: real client + real stdout/stderr/filesystem. */
+export const defaultDeps = {
+    io: defaultIO,
+    createClient: (options) => new LuftqualitaetClient(options),
+};
+export function buildProgram(deps = defaultDeps) {
+    const program = new Command();
+    program
+        .name("luftqualitaet")
+        .description("CLI for the open Umweltbundesamt Air Data API " +
+        "(https://www.umweltbundesamt.de/api/air_data/v3)")
+        .version(VERSION)
+        .option("--base-url <url>", "API base URL", "https://www.umweltbundesamt.de")
+        .option("--timeout <ms>", "per-request timeout in milliseconds", parseIntArg)
+        .option("--user-agent <ua>", "User-Agent header value")
+        .option("--max-retries <n>", "retries for transient 429/503 responses", parseIntArg)
+        .option("--max-response-bytes <n>", "cap response body size in bytes (0 = unlimited; default 100 MiB)", parseIntArg)
+        .option("--compact", "print JSON on a single line instead of pretty-printed")
+        .showHelpAfterError();
+    registerReferenceCommands(program, deps);
+    registerDataCommands(program, deps);
+    return program;
+}
+//# sourceMappingURL=program.js.map

package/dist/src/cli/program.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.js","sourceRoot":"","sources":["../../../src/cli/program.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,4EAA4E;AAC5E,mBAAmB;AAEnB,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D;;;;;GAKG;AACH,SAAS,WAAW;IAClB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,uBAAuB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAyB,CAAC;QAC5F,OAAO,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC;AAErC,yEAAyE;AACzE,MAAM,CAAC,MAAM,WAAW,GAAY;IAClC,EAAE,EAAE,SAAS;IACb,YAAY,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,mBAAmB,CAAC,OAAO,CAAC;CAC5D,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,OAAgB,WAAW;IACtD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,eAAe,CAAC;SACrB,WAAW,CACV,gDAAgD;QAC9C,kDAAkD,CACrD;SACA,OAAO,CAAC,OAAO,CAAC;SAChB,MAAM,CAAC,kBAAkB,EAAE,cAAc,EAAE,gCAAgC,CAAC;SAC5E,MAAM,CAAC,gBAAgB,EAAE,qCAAqC,EAAE,WAAW,CAAC;SAC5E,MAAM,CAAC,mBAAmB,EAAE,yBAAyB,CAAC;SACtD,MAAM,CAAC,mBAAmB,EAAE,yCAAyC,EAAE,WAAW,CAAC;SACnF,MAAM,CACL,0BAA0B,EAC1B,kEAAkE,EAClE,WAAW,CACZ;SACA,MAAM,CAAC,WAAW,EAAE,uDAAuD,CAAC;SAC5E,kBAAkB,EAAE,CAAC;IAExB,yBAAyB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACzC,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAEpC,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/src/cli/run.d.ts

@@ -0,0 +1,3 @@
+import type { CliDeps } from "./io.js";
+export declare function run(argv: string[], deps?: CliDeps): Promise<number>;
+//# sourceMappingURL=run.d.ts.map

package/dist/src/cli/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/cli/run.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAiBvC,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,OAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBtF"}