@maschinenlesbar.org/ladesaeulenregister-cli 0.0.1

package/LICENSING.md

@@ -0,0 +1,47 @@
+# Licensing
+
+`ladesaeulenregister-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 `ladesaeulenregister-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,69 @@
+# ladesaeulenregister-cli
+
+A dependency-light **TypeScript client + CLI** for the **Ladesäulenregister** — the
+Bundesnetzagentur's register of public EV charging stations in Germany (~111k
+Ladeeinrichtungen). Backed by a public **ArcGIS FeatureServer**. A
+[bund.dev](https://bund.dev) API.
+
+- **No API key.** The public charging-station data is open.
+- **Zero runtime HTTP dependencies.** Built on `node:http`/`https`; the CLI's only
+  runtime dependency is `commander`.
+- **Library + CLI.** Use the typed `LadesaeulenClient`, or the `ladesaeulen` command.
+
+> **We provide the tool, not the data.** The data is © the Bundesnetzagentur under
+> **CC BY 4.0** — free to use with attribution. See [DATA_LICENSE.md](DATA_LICENSE.md).
+
+## Install
+
+```bash
+npm install -g @maschinenlesbar.org/ladesaeulenregister-cli   # the `ladesaeulen` command
+# or as a library:
+npm install @maschinenlesbar.org/ladesaeulenregister-cli
+```
+
+## CLI
+
+```bash
+ladesaeulen stations --count                                   # total public stations → 111524
+ladesaeulen stations --where "Ort='Berlin' AND Typ='Schnellladeeinrichtung'" --count   # → 660
+ladesaeulen stations --near 52.52,13.405 --radius 1 --count    # within 1 km of a point → 124
+ladesaeulen stations --where "state='Bayern'" --limit 20       # a page of stations
+ladesaeulen stations --geojson --limit 200 > stations.geojson  # GeoJSON for a map
+ladesaeulen count-by state                                     # stations per Bundesland
+ladesaeulen fields                                             # the queryable columns
+```
+
+- **`stations`** searches with an SQL `--where`, paging (`--limit`/`--offset`),
+  sorting (`--order-by`), field selection (`--fields`), a spatial `--near`/`--radius`,
+  and `--count` (just the number) or `--geojson` output.
+- **`count-by <field>`** aggregates (e.g. per `state`, `Typ`, `Betreiber`).
+- **`fields`** lists the queryable columns (build `--where`/`--fields`/`count-by`).
+
+Filter values are **SQL, case-sensitive, single-quoted** (`Ort='Berlin'`). Global
+flags: `--base-url`, `--timeout`, `--user-agent`, `--max-retries`,
+`--max-response-bytes`, `--compact`. See [Usage.md](Usage.md).
+
+## Library
+
+```ts
+import { LadesaeulenClient } from "@maschinenlesbar.org/ladesaeulenregister-cli";
+
+const c = new LadesaeulenClient();
+await c.count({ where: "Typ='Schnellladeeinrichtung'" });          // number
+await c.countBy("state");                                          // per Bundesland
+const near = await c.stations({ near: { lat: 52.52, lon: 13.405, radiusKm: 1 } });
+```
+
+## Documentation
+
+- [Usage.md](Usage.md) — commands, the `--where`/spatial options, exit codes
+- [DEVELOPING.md](DEVELOPING.md) — architecture, testing, the ArcGIS specifics
+- [GLOSSARY.md](GLOSSARY.md) — the register's fields and terms
+- [DATA_LICENSE.md](DATA_LICENSE.md) — the CC BY 4.0 data terms
+- [SKILLS.md](SKILLS.md) — the Claude Code skills this repo ships
+
+## Licence
+
+Code is dual-licensed **AGPL-3.0-or-later OR commercial** — see
+[LICENSING.md](LICENSING.md). No external code contributions are accepted (see
+[CONTRIBUTING.md](CONTRIBUTING.md)); bug reports and AGPL forks are welcome.

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"stations.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/stations.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AA0CxC,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAwEtE"}

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

@@ -0,0 +1,91 @@
+// Command group for the Ladesäulenregister CLI: the primary `stations` query
+// (filter / page / spatial / count / geojson), a `count-by` grouped aggregation,
+// and `fields` to list the queryable columns.
+import { LadesaeulenValidationError } from "../../client/errors.js";
+import { action, parseBoundedInt, parseIntArg, parseLatLon, parseNonEmpty, parsePositiveFloat, renderJson, } from "../shared.js";
+/**
+ * Roughly Germany's bounding box (generous margins). Used only to catch a likely
+ * latitude/longitude swap in `--near` (both numbers are valid lat AND lon, so the
+ * parser cannot tell them apart).
+ */
+function isOutsideGermany(lat, lon) {
+    return lat < 47 || lat > 56 || lon < 5 || lon > 16;
+}
+/** Build a StationQuery from this command's parsed options. */
+function buildStationQuery(opts) {
+    const q = {};
+    if (typeof opts["where"] === "string")
+        q.where = opts["where"];
+    if (typeof opts["limit"] === "number")
+        q.limit = opts["limit"];
+    if (typeof opts["offset"] === "number")
+        q.offset = opts["offset"];
+    if (typeof opts["orderBy"] === "string")
+        q.orderBy = opts["orderBy"];
+    if (typeof opts["fields"] === "string")
+        q.outFields = opts["fields"];
+    const near = opts["near"];
+    const radius = opts["radius"];
+    if (near !== undefined || radius !== undefined) {
+        if (near === undefined || radius === undefined) {
+            throw new LadesaeulenValidationError("--near and --radius must be given together.");
+        }
+        q.near = { lat: near.lat, lon: near.lon, radiusKm: radius };
+    }
+    return q;
+}
+export function registerCommands(program, deps) {
+    program
+        .command("stations")
+        .description("Search charging stations (Ladeeinrichtungen)")
+        .option("--where <sql>", "SQL filter, e.g. \"Ort='Berlin' AND Typ='Schnellladeeinrichtung'\"", parseNonEmpty)
+        .option("--limit <n>", "max rows per request (1..10000; the server returns at most ~2000 — page with --offset)", parseBoundedInt(1, 10000), 50)
+        .option("--offset <n>", "rows to skip (for paging)", parseIntArg)
+        .option("--order-by <spec>", "sort, e.g. \"Ort ASC\" or \"max_electric_power_station DESC\"", parseNonEmpty)
+        .option("--fields <list>", "comma-separated field list, or '*' for all (see `fields`)", parseNonEmpty)
+        .option("--near <lat,lon>", "only stations near this WGS84 point (needs --radius)", parseLatLon)
+        .option("--radius <km>", "search radius in km for --near", parsePositiveFloat)
+        .option("--count", "print only the number of matching stations")
+        .option("--geojson", "output a GeoJSON FeatureCollection instead of ArcGIS JSON")
+        .action(action(deps, async ({ client, global, opts }) => {
+        if (opts["count"] === true && opts["geojson"] === true) {
+            throw new LadesaeulenValidationError("--count and --geojson cannot be combined.");
+        }
+        const q = buildStationQuery(opts);
+        if (q.near && isOutsideGermany(q.near.lat, q.near.lon)) {
+            deps.io.err(`Note: --near point (lat ${q.near.lat}, lon ${q.near.lon}) is outside Germany — ` +
+                "did you swap latitude and longitude? --near expects lat,lon.");
+        }
+        if (opts["count"] === true) {
+            renderJson(deps, global, await client.count(q));
+        }
+        else if (opts["geojson"] === true) {
+            renderJson(deps, global, await client.geojson(q));
+        }
+        else {
+            const page = await client.stations(q);
+            if (page.exceededTransferLimit) {
+                deps.io.err("Note: more stations match than were returned (the server caps a page at ~2000 rows). " +
+                    "Page with --offset, or narrow --where.");
+            }
+            renderJson(deps, global, page);
+        }
+    }));
+    program
+        .command("count-by")
+        .description("Count stations grouped by a field, e.g. `count-by state` (per Bundesland)")
+        .argument("<field>", "field to group by (e.g. state, Typ, Betreiber, Ort)", parseNonEmpty)
+        .option("--where <sql>", "restrict to matching stations first", parseNonEmpty)
+        .action(action(deps, async ({ client, global, opts }, [field]) => {
+        const where = typeof opts["where"] === "string" ? opts["where"] : "1=1";
+        renderJson(deps, global, await client.countBy(field, where));
+    }));
+    program
+        .command("fields")
+        .description("List the queryable field names (for --where / --fields / count-by)")
+        .action(action(deps, async ({ client, global }) => {
+        const fields = await client.fields();
+        renderJson(deps, global, fields.map((f) => ({ name: f.name, type: f.type, alias: f.alias })));
+    }));
+}
+//# sourceMappingURL=stations.js.map

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

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

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,11 @@
+#!/usr/bin/env node
+// Bin shim: parse argv, run the CLI, and set the process exit code. All real
+// logic lives in run.ts (testable without spawning a subprocess).
+import { run } from "./run.js";
+run(process.argv.slice(2)).then((code) => {
+    process.exitCode = code;
+}, (err) => {
+    process.stderr.write(`Unexpected error: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exitCode = 1;
+});
+//# 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,6EAA6E;AAC7E,kEAAkE;AAElE,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAC7B,CAAC,IAAI,EAAE,EAAE;IACP,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;AAC1B,CAAC,EACD,CAAC,GAAY,EAAE,EAAE;IACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChG,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CACF,CAAC"}

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

@@ -0,0 +1,12 @@
+import type { LadesaeulenClient, LadesaeulenClientOptions } from "../client/client.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: LadesaeulenClientOptions): LadesaeulenClient;
+}
+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,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAEvF,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,wBAAwB,GAAG,iBAAiB,CAAC;CACpE;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.
+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,sEAAsE;AAetE,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. */
+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;AAsBvC,eAAO,MAAM,OAAO,QAAgB,CAAC;AAErC,8DAA8D;AAC9D,eAAO,MAAM,WAAW,EAAE,OAGzB,CAAC;AAEF,wBAAgB,YAAY,CAAC,IAAI,GAAE,OAAqB,GAAG,OAAO,CAiCjE"}

package/dist/src/cli/program.js

@@ -0,0 +1,53 @@
+// 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 { LadesaeulenClient } from "../client/client.js";
+import { parseIntArg, parseBoundedInt, parseHeaderValue, parseNonEmpty } from "./shared.js";
+import { registerCommands } from "./commands/stations.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. */
+export const defaultDeps = {
+    io: defaultIO,
+    createClient: (options) => new LadesaeulenClient(options),
+};
+export function buildProgram(deps = defaultDeps) {
+    const program = new Command();
+    program
+        .name("ladesaeulen")
+        .description("CLI for the Ladesäulenregister — the Bundesnetzagentur's register of public EV " +
+        "charging stations in Germany (~111k Ladeeinrichtungen). No API key needed. " +
+        "`stations` searches with an SQL --where, paging, spatial --near/--radius, --count " +
+        "or --geojson; `count-by` aggregates (e.g. per Bundesland); `fields` lists the " +
+        "queryable columns.")
+        .version(VERSION)
+        .option("--base-url <url>", "API base URL (the ArcGIS FeatureServer)", parseNonEmpty, "https://services-eu1.arcgis.com/TJm8oSvOdJUQvQT5/arcgis/rest/services/Ladesaeulen/FeatureServer")
+        .option("--timeout <ms>", "per-request timeout in ms (0 = no timeout)", parseIntArg)
+        .option("--user-agent <ua>", "User-Agent header value", parseHeaderValue)
+        .option("--max-retries <n>", "retries for transient 429/503 responses (0..10)", parseBoundedInt(0, 10))
+        .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();
+    registerCommands(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,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,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,8DAA8D;AAC9D,MAAM,CAAC,MAAM,WAAW,GAAY;IAClC,EAAE,EAAE,SAAS;IACb,YAAY,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,iBAAiB,CAAC,OAAO,CAAC;CAC1D,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,OAAgB,WAAW;IACtD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,aAAa,CAAC;SACnB,WAAW,CACV,iFAAiF;QAC/E,6EAA6E;QAC7E,oFAAoF;QACpF,gFAAgF;QAChF,oBAAoB,CACvB;SACA,OAAO,CAAC,OAAO,CAAC;SAChB,MAAM,CACL,kBAAkB,EAClB,yCAAyC,EACzC,aAAa,EACb,iGAAiG,CAClG;SACA,MAAM,CAAC,gBAAgB,EAAE,4CAA4C,EAAE,WAAW,CAAC;SACnF,MAAM,CAAC,mBAAmB,EAAE,yBAAyB,EAAE,gBAAgB,CAAC;SACxE,MAAM,CAAC,mBAAmB,EAAE,iDAAiD,EAAE,eAAe,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;SACtG,MAAM,CACL,0BAA0B,EAC1B,kEAAkE,EAClE,WAAW,CACZ;SACA,MAAM,CAAC,WAAW,EAAE,uDAAuD,CAAC;SAC5E,kBAAkB,EAAE,CAAC;IAExB,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAEhC,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;AAqCvC,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,OAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkDtF"}

package/dist/src/cli/run.js

@@ -0,0 +1,85 @@
+// Run the CLI and resolve to a process exit code. Kept separate from the bin
+// shim so tests can call run() directly with injected deps and assert on the
+// captured output and exit code without spawning a subprocess.
+import { CommanderError } from "commander";
+import { buildProgram, defaultDeps } from "./program.js";
+import { LadesaeulenApiError, LadesaeulenError, LadesaeulenNetworkError, LadesaeulenValidationError, } from "../client/errors.js";
+/**
+ * Process exit codes. Distinct codes let scripts tell apart a usage error, a
+ * missing resource, a transport failure, and a catch-all.
+ */
+const EXIT = {
+    /** Usage / parse / client-side validation error. */
+    USAGE: 2,
+    /** HTTP 404 — resource not found. */
+    NOT_FOUND: 4,
+    /** Network / transport failure (DNS, connection, timeout, size-cap). */
+    NETWORK: 6,
+    /** Any other error. */
+    OTHER: 1,
+};
+/**
+ * Apply exitOverride + output redirection to every command in the tree.
+ * commander does not propagate these to subcommands, so a parse error on a
+ * subcommand would otherwise call process.exit() and bypass our error handling.
+ */
+function configureTree(command, deps) {
+    command.exitOverride();
+    command.configureOutput({
+        writeOut: (str) => deps.io.out(str.replace(/\n$/, "")),
+        writeErr: (str) => deps.io.err(str.replace(/\n$/, "")),
+    });
+    for (const child of command.commands)
+        configureTree(child, deps);
+}
+export async function run(argv, deps = defaultDeps) {
+    const program = buildProgram(deps);
+    configureTree(program, deps);
+    // A bare invocation (no command) is a help request, not an error: print help
+    // to stdout and exit 0, matching `--help`.
+    if (argv.length === 0) {
+        deps.io.out(program.helpInformation().replace(/\n$/, ""));
+        return 0;
+    }
+    try {
+        await program.parseAsync(argv, { from: "user" });
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CommanderError) {
+            // Help/version requests exit 0; every genuine usage/parse error maps to a
+            // single USAGE code (commander's own exitCode is 1, indistinguishable from
+            // the catch-all).
+            return err.exitCode === 0 ? 0 : EXIT.USAGE;
+        }
+        if (err instanceof LadesaeulenValidationError) {
+            deps.io.err(`Error: ${err.message}`);
+            return EXIT.USAGE;
+        }
+        if (err instanceof LadesaeulenApiError) {
+            deps.io.err(`Error: ${err.message}`);
+            if (err.status === 404)
+                return EXIT.NOT_FOUND;
+            // A 3xx means the base URL redirected (the canonical host answers directly),
+            // so it is a base-URL misconfiguration — a usage error.
+            if (err.status !== undefined && err.status >= 300 && err.status < 400)
+                return EXIT.USAGE;
+            return EXIT.OTHER;
+        }
+        if (err instanceof LadesaeulenNetworkError) {
+            deps.io.err(`Error: ${err.message}`);
+            if (/maxResponseBytes/.test(err.message)) {
+                deps.io.err("Hint: the response exceeded the size cap. Lower --limit or raise " +
+                    "--max-response-bytes <n> (0 = unlimited).");
+            }
+            return EXIT.NETWORK;
+        }
+        if (err instanceof LadesaeulenError) {
+            deps.io.err(`Error: ${err.message}`);
+            return EXIT.OTHER;
+        }
+        deps.io.err(`Unexpected error: ${err instanceof Error ? err.message : String(err)}`);
+        return EXIT.OTHER;
+    }
+}
+//# sourceMappingURL=run.js.map

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

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

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

@@ -0,0 +1,56 @@
+import type { CliDeps } from "./io.js";
+import type { LadesaeulenClientOptions } from "../client/client.js";
+/**
+ * commander value-parser: a plain base-10 non-negative integer.
+ *
+ * Uses a strict regex rather than `Number()` coercion, which would otherwise
+ * accept empty/whitespace strings (`Number("") === 0`), hex/binary/scientific
+ * literals, signs, padding and decimals.
+ */
+export declare function parseIntArg(value: string): number;
+/** commander value-parser: a non-empty (after trimming) string. */
+export declare function parseNonEmpty(value: string): string;
+/** Build a commander value-parser for an integer constrained to [min, max]. */
+export declare function parseBoundedInt(min: number, max: number): (value: string) => number;
+/** commander value-parser: a strictly-positive decimal number (e.g. a radius in km). */
+export declare function parsePositiveFloat(value: string): number;
+/** commander value-parser for `--near`: a `lat,lon` pair in WGS84 degrees. */
+export declare function parseLatLon(value: string): {
+    lat: number;
+    lon: number;
+};
+/**
+ * commander value-parser for a value that ends up in an HTTP header (User-Agent).
+ * Rejects control characters — a CR/LF (or other C0/DEL byte) would otherwise reach
+ * Node's HTTP layer and throw an opaque `ERR_INVALID_CHAR`. Tab (0x09) is allowed;
+ * checked by char code so the source stays free of control bytes.
+ */
+export declare function parseHeaderValue(value: string): string;
+export interface GlobalOptions {
+    baseUrl?: string;
+    timeout?: number;
+    userAgent?: string;
+    maxRetries?: number;
+    maxResponseBytes?: number;
+    compact?: boolean;
+}
+/** Translate resolved global CLI options into client options. */
+export declare function toEngineOptions(global: GlobalOptions): LadesaeulenClientOptions;
+/** Render a JSON value to stdout, pretty by default, compact with --compact. */
+export declare function renderJson(deps: CliDeps, global: GlobalOptions, value: unknown): void;
+export interface ActionContext {
+    client: ReturnType<CliDeps["createClient"]>;
+    global: GlobalOptions;
+    /** This command's own parsed options. */
+    opts: Record<string, unknown>;
+}
+/**
+ * Wrap an async command action with consistent global-option resolution and
+ * client construction. The callback receives a context (client + resolved global
+ * options + this command's options) and the command's positional arguments.
+ *
+ * Commander invokes actions as (arg1, ..., argN, options, command); we slice off
+ * the trailing options object and command instance to recover the positionals.
+ */
+export declare function action(deps: CliDeps, fn: (ctx: ActionContext, positionals: string[]) => Promise<void>): (...args: unknown[]) => Promise<void>;
+//# sourceMappingURL=shared.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/cli/shared.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAEpE;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASjD;AAED,mEAAmE;AACnE,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKnD;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAOnF;AAED,wFAAwF;AACxF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMxD;AAED,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAQvE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQtD;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,iEAAiE;AACjE,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,wBAAwB,CAQ/E;AAED,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAGrF;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC;IAC5C,MAAM,EAAE,aAAa,CAAC;IACtB,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CACpB,IAAI,EAAE,OAAO,EACb,EAAE,EAAE,CAAC,GAAG,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,GAC/D,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAQvC"}

package/dist/src/cli/shared.js

@@ -0,0 +1,112 @@
+// Shared helpers used across CLI command groups: option parsers, the global
+// option resolver, and JSON rendering.
+import { InvalidArgumentError } from "commander";
+/**
+ * commander value-parser: a plain base-10 non-negative integer.
+ *
+ * Uses a strict regex rather than `Number()` coercion, which would otherwise
+ * accept empty/whitespace strings (`Number("") === 0`), hex/binary/scientific
+ * literals, signs, padding and decimals.
+ */
+export function parseIntArg(value) {
+    if (!/^[0-9]+$/.test(value)) {
+        throw new InvalidArgumentError("Expected a non-negative integer.");
+    }
+    const n = Number(value);
+    if (!Number.isSafeInteger(n)) {
+        throw new InvalidArgumentError("Expected a non-negative integer.");
+    }
+    return n;
+}
+/** commander value-parser: a non-empty (after trimming) string. */
+export function parseNonEmpty(value) {
+    if (value.trim() === "") {
+        throw new InvalidArgumentError("Expected a non-empty value.");
+    }
+    return value;
+}
+/** Build a commander value-parser for an integer constrained to [min, max]. */
+export function parseBoundedInt(min, max) {
+    return (value) => {
+        const n = parseIntArg(value);
+        if (n < min)
+            throw new InvalidArgumentError(`Must be >= ${min}.`);
+        if (n > max)
+            throw new InvalidArgumentError(`Must be <= ${max}.`);
+        return n;
+    };
+}
+/** commander value-parser: a strictly-positive decimal number (e.g. a radius in km). */
+export function parsePositiveFloat(value) {
+    const n = Number(value);
+    if (!Number.isFinite(n) || n <= 0) {
+        throw new InvalidArgumentError("Expected a positive number.");
+    }
+    return n;
+}
+/** commander value-parser for `--near`: a `lat,lon` pair in WGS84 degrees. */
+export function parseLatLon(value) {
+    const m = /^\s*(-?\d+(?:\.\d+)?)\s*,\s*(-?\d+(?:\.\d+)?)\s*$/.exec(value);
+    if (!m)
+        throw new InvalidArgumentError("Expected 'lat,lon' (e.g. 52.52,13.405).");
+    const lat = Number(m[1]);
+    const lon = Number(m[2]);
+    if (lat < -90 || lat > 90)
+        throw new InvalidArgumentError("Latitude must be between -90 and 90.");
+    if (lon < -180 || lon > 180)
+        throw new InvalidArgumentError("Longitude must be between -180 and 180.");
+    return { lat, lon };
+}
+/**
+ * commander value-parser for a value that ends up in an HTTP header (User-Agent).
+ * Rejects control characters — a CR/LF (or other C0/DEL byte) would otherwise reach
+ * Node's HTTP layer and throw an opaque `ERR_INVALID_CHAR`. Tab (0x09) is allowed;
+ * checked by char code so the source stays free of control bytes.
+ */
+export function parseHeaderValue(value) {
+    for (let i = 0; i < value.length; i++) {
+        const c = value.charCodeAt(i);
+        if ((c < 0x20 && c !== 0x09) || c === 0x7f) {
+            throw new InvalidArgumentError("Value contains control characters.");
+        }
+    }
+    return value;
+}
+/** Translate resolved global CLI options into client options. */
+export function toEngineOptions(global) {
+    const options = {};
+    if (global.baseUrl !== undefined)
+        options.baseUrl = global.baseUrl;
+    if (global.timeout !== undefined)
+        options.timeoutMs = global.timeout;
+    if (global.userAgent !== undefined)
+        options.userAgent = global.userAgent;
+    if (global.maxRetries !== undefined)
+        options.maxRetries = global.maxRetries;
+    if (global.maxResponseBytes !== undefined)
+        options.maxResponseBytes = global.maxResponseBytes;
+    return options;
+}
+/** Render a JSON value to stdout, pretty by default, compact with --compact. */
+export function renderJson(deps, global, value) {
+    const text = global.compact ? JSON.stringify(value) : JSON.stringify(value, null, 2);
+    deps.io.out(text);
+}
+/**
+ * Wrap an async command action with consistent global-option resolution and
+ * client construction. The callback receives a context (client + resolved global
+ * options + this command's options) and the command's positional arguments.
+ *
+ * Commander invokes actions as (arg1, ..., argN, options, command); we slice off
+ * the trailing options object and command instance to recover the positionals.
+ */
+export function action(deps, fn) {
+    return async (...args) => {
+        const command = args[args.length - 1];
+        const positionals = args.slice(0, Math.max(0, args.length - 2));
+        const global = command.optsWithGlobals();
+        const client = deps.createClient(toEngineOptions(global));
+        await fn({ client, global, opts: command.opts() }, positionals);
+    };
+}
+//# sourceMappingURL=shared.js.map