@maschinenlesbar.org/nina-warnungen-cli 0.0.1

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

@@ -0,0 +1,69 @@
+import type { CliDeps } from "./io.js";
+import type { EngineOptions, RawResponse } from "../client/engine.js";
+/**
+ * commander value-parser: a plain non-negative decimal integer.
+ *
+ * Only accepts an optional leading run of digits with no sign, decimal point,
+ * whitespace, exponent or radix prefix. This deliberately rejects forms that
+ * `Number()` would otherwise coerce (e.g. "", "  5", "0x10", "1e3", "5.0",
+ * "Infinity"), so a typo never silently becomes a surprising value.
+ */
+export declare function parseIntArg(value: string): number;
+/**
+ * Validate a positional argument against an allowed set (commander does not
+ * support .choices() on positional args). Throws a NinaError so run() prints a
+ * clear message and exits 1.
+ */
+export declare function assertEnum<T extends string>(value: string, allowed: readonly T[], argName: string): T;
+/**
+ * Validate a required free-form positional (an identifier or region key). An
+ * empty or whitespace-only value would build a path like `dashboard/.json` and
+ * come back as a remote 404 for what is really a local input error; reject it
+ * up front with a clear message (exit 1) instead.
+ */
+export declare function requireIdentifier(value: string, argName: string): string;
+export interface GlobalOptions {
+    baseUrl?: string;
+    timeout?: number;
+    userAgent?: string;
+    maxRetries?: number;
+    maxResponseBytes?: number;
+    compact?: boolean;
+    output?: string;
+}
+/** Translate resolved global CLI options into client EngineOptions. */
+export declare function toEngineOptions(global: GlobalOptions): EngineOptions;
+/**
+ * Render a JSON value, pretty by default, compact with --compact. Writes to the
+ * file given by --output when present (so `-o` is honoured for JSON commands, not
+ * only raw downloads), otherwise to stdout. When writing a file we print a short
+ * confirmation to stderr so stdout stays clean for piping.
+ */
+export declare function renderJson(deps: CliDeps, global: GlobalOptions, value: unknown): void;
+/**
+ * Render a raw (binary/text) download. Writes to the file given by --output, or
+ * to stdout otherwise. Prints a short confirmation to stderr when writing a file
+ * so stdout stays clean for piping.
+ *
+ * `expectContentType` is an optional substring sanity check. A misconfigured
+ * gateway can return an HTML error page with a 200 status; without this the bytes
+ * would be saved silently to e.g. `out.geojson`. We do not fail (the body may be
+ * valid with an unusual type), but we warn to stderr so the surprise is visible.
+ */
+export declare function renderRaw(deps: CliDeps, global: GlobalOptions, response: RawResponse, expectContentType?: string): 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;AAEvC,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEtE;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASjD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EACzC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,SAAS,CAAC,EAAE,EACrB,OAAO,EAAE,MAAM,GACd,CAAC,CAKH;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAKxE;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;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAQpE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAUrF;AAeD;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,WAAW,EACrB,iBAAiB,CAAC,EAAE,MAAM,GACzB,IAAI,CAcN;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,133 @@
+// Shared helpers used across CLI command groups: option parsers, the global
+// option resolver, and the two result-rendering paths (JSON and raw download).
+import { InvalidArgumentError } from "commander";
+import { NinaError } from "../client/errors.js";
+/**
+ * commander value-parser: a plain non-negative decimal integer.
+ *
+ * Only accepts an optional leading run of digits with no sign, decimal point,
+ * whitespace, exponent or radix prefix. This deliberately rejects forms that
+ * `Number()` would otherwise coerce (e.g. "", "  5", "0x10", "1e3", "5.0",
+ * "Infinity"), so a typo never silently becomes a surprising value.
+ */
+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("Value is too large.");
+    }
+    return n;
+}
+/**
+ * Validate a positional argument against an allowed set (commander does not
+ * support .choices() on positional args). Throws a NinaError so run() prints a
+ * clear message and exits 1.
+ */
+export function assertEnum(value, allowed, argName) {
+    if (!allowed.includes(value)) {
+        throw new NinaError(`Invalid ${argName} "${value}". Expected one of: ${allowed.join(", ")}.`);
+    }
+    return value;
+}
+/**
+ * Validate a required free-form positional (an identifier or region key). An
+ * empty or whitespace-only value would build a path like `dashboard/.json` and
+ * come back as a remote 404 for what is really a local input error; reject it
+ * up front with a clear message (exit 1) instead.
+ */
+export function requireIdentifier(value, argName) {
+    if (value.trim() === "") {
+        throw new NinaError(`A non-empty ${argName} is required.`);
+    }
+    return value;
+}
+/** Translate resolved global CLI options into client EngineOptions. */
+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, pretty by default, compact with --compact. Writes to the
+ * file given by --output when present (so `-o` is honoured for JSON commands, not
+ * only raw downloads), otherwise to stdout. When writing a file we print a short
+ * confirmation to stderr so stdout stays clean for piping.
+ */
+export function renderJson(deps, global, value) {
+    const text = global.compact ? JSON.stringify(value) : JSON.stringify(value, null, 2);
+    const output = resolveOutput(global.output);
+    if (output !== undefined) {
+        const data = Buffer.from(text + "\n", "utf8");
+        deps.io.writeFile(output, data);
+        deps.io.err(`Wrote ${data.length} bytes to ${output}`);
+    }
+    else {
+        deps.io.out(text);
+    }
+}
+/**
+ * Resolve the --output target. `undefined` means "no -o given" (write to stdout).
+ * An explicitly empty string is a user error (e.g. `--output "$OUT"` with an
+ * unset variable) and must not silently fall through to stdout, so we reject it.
+ */
+function resolveOutput(output) {
+    if (output === undefined)
+        return undefined;
+    if (output === "") {
+        throw new NinaError("--output requires a non-empty file path.");
+    }
+    return output;
+}
+/**
+ * Render a raw (binary/text) download. Writes to the file given by --output, or
+ * to stdout otherwise. Prints a short confirmation to stderr when writing a file
+ * so stdout stays clean for piping.
+ *
+ * `expectContentType` is an optional substring sanity check. A misconfigured
+ * gateway can return an HTML error page with a 200 status; without this the bytes
+ * would be saved silently to e.g. `out.geojson`. We do not fail (the body may be
+ * valid with an unusual type), but we warn to stderr so the surprise is visible.
+ */
+export function renderRaw(deps, global, response, expectContentType) {
+    if (expectContentType && !response.contentType.toLowerCase().includes(expectContentType)) {
+        deps.io.err(`Warning: expected a "${expectContentType}" response but got ` +
+            `"${response.contentType || "(none)"}". The body may not be what you expect.`);
+    }
+    const output = resolveOutput(global.output);
+    if (output !== undefined) {
+        deps.io.writeFile(output, response.data);
+        deps.io.err(`Wrote ${response.data.length} bytes to ${output}`);
+    }
+    else {
+        deps.io.outBinary(response.data);
+    }
+}
+/**
+ * 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

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

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

package/dist/src/client/client.d.ts

@@ -0,0 +1,45 @@
+import { RequestEngine, type EngineOptions, type RawResponse } from "./engine.js";
+import type { NinaSource } from "./enums.js";
+import type { MapWarning, WarningDetail, DashboardEntry, ArchiveMapping, Notfalltipps, EventCodes, DataVersion } from "./types.js";
+/** Single-warning retrieval (full payload + geometry). */
+declare class WarningsResource {
+    private readonly engine;
+    constructor(engine: RequestEngine);
+    /** The full CAP-derived warning for an identifier. */
+    get(identifier: string): Promise<WarningDetail>;
+    /** The warning's geometry as GeoJSON (returned as raw bytes). */
+    geojson(identifier: string): Promise<RawResponse>;
+}
+/** The MoWaS archive (historical warnings + their revision history). */
+declare class ArchiveResource {
+    private readonly engine;
+    constructor(engine: RequestEngine);
+    /** Revision history for an archived MoWaS identifier. */
+    mapping(identifier: string): Promise<ArchiveMapping>;
+    /** A specific archived MoWaS warning (same shape as a live warning). */
+    get(identifier: string): Promise<WarningDetail>;
+}
+/** Static reference data published alongside the warnings. */
+declare class ReferenceResource {
+    private readonly engine;
+    constructor(engine: RequestEngine);
+    /** Emergency-preparedness tips (Notfalltipps), German. */
+    notfalltipps(): Promise<Notfalltipps>;
+    /** The CAP event-code catalogue (maps event keys to icons/labels). */
+    eventCodes(): Promise<EventCodes>;
+    /** Current data version/hash (useful for change detection / polling). */
+    dataVersion(): Promise<DataVersion>;
+}
+export declare class NinaClient {
+    private readonly engine;
+    readonly warnings: WarningsResource;
+    readonly archive: ArchiveResource;
+    readonly reference: ReferenceResource;
+    constructor(options?: EngineOptions);
+    /** Current warnings from one source, e.g. `mapData("dwd")`. */
+    mapData(source: NinaSource): Promise<MapWarning[]>;
+    /** Warnings affecting a region, keyed by Amtlicher Regionalschlüssel (ARS/AGS). */
+    dashboard(ars: string): Promise<DashboardEntry[]>;
+}
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/src/client/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/client/client.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EACb,cAAc,EACd,cAAc,EACd,YAAY,EACZ,UAAU,EACV,WAAW,EACZ,MAAM,YAAY,CAAC;AAMpB,0DAA0D;AAC1D,cAAM,gBAAgB;IACR,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAElD,sDAAsD;IACtD,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAI/C,iEAAiE;IACjE,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAGlD;AAED,wEAAwE;AACxE,cAAM,eAAe;IACP,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAElD,yDAAyD;IACzD,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAIpD,wEAAwE;IACxE,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CAGhD;AAED,8DAA8D;AAC9D,cAAM,iBAAiB;IACT,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAElD,0DAA0D;IAC1D,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC;IAIrC,sEAAsE;IACtE,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC;IAIjC,yEAAyE;IACzE,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC;CAGpC;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IAEvC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;gBAE1B,OAAO,GAAE,aAAkB;IAOvC,+DAA+D;IAC/D,OAAO,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAIlD,mFAAmF;IACnF,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;CAGlD"}

package/dist/src/client/client.js

@@ -0,0 +1,81 @@
+// NinaClient — a typed client over the open (no-auth) endpoints of the NINA API
+// (https://warnung.bund.de/api31), the federal civil-protection warning system
+// run by the BBK (Bundesamt für Bevölkerungsschutz und Katastrophenhilfe).
+//
+//   client.mapData("mowas")        // current alerts from a source
+//   client.warnings.get(id)        // full CAP warning
+//   client.dashboard(ars)          // alerts for a region (Amtlicher Regionalschlüssel)
+import { RequestEngine } from "./engine.js";
+const API = "/api31";
+const ACCEPT_GEOJSON = "application/geo+json";
+const enc = encodeURIComponent;
+/** Single-warning retrieval (full payload + geometry). */
+class WarningsResource {
+    engine;
+    constructor(engine) {
+        this.engine = engine;
+    }
+    /** The full CAP-derived warning for an identifier. */
+    get(identifier) {
+        return this.engine.getJson(`${API}/warnings/${enc(identifier)}.json`);
+    }
+    /** The warning's geometry as GeoJSON (returned as raw bytes). */
+    geojson(identifier) {
+        return this.engine.getRaw(`${API}/warnings/${enc(identifier)}.geojson`, ACCEPT_GEOJSON);
+    }
+}
+/** The MoWaS archive (historical warnings + their revision history). */
+class ArchiveResource {
+    engine;
+    constructor(engine) {
+        this.engine = engine;
+    }
+    /** Revision history for an archived MoWaS identifier. */
+    mapping(identifier) {
+        return this.engine.getJson(`${API}/archive.mowas/${enc(identifier)}-mapping.json`);
+    }
+    /** A specific archived MoWaS warning (same shape as a live warning). */
+    get(identifier) {
+        return this.engine.getJson(`${API}/archive.mowas/${enc(identifier)}.json`);
+    }
+}
+/** Static reference data published alongside the warnings. */
+class ReferenceResource {
+    engine;
+    constructor(engine) {
+        this.engine = engine;
+    }
+    /** Emergency-preparedness tips (Notfalltipps), German. */
+    notfalltipps() {
+        return this.engine.getJson(`${API}/appdata/gsb/notfalltipps/DE/notfalltipps.json`);
+    }
+    /** The CAP event-code catalogue (maps event keys to icons/labels). */
+    eventCodes() {
+        return this.engine.getJson(`${API}/appdata/gsb/eventCodes/eventCodes.json`);
+    }
+    /** Current data version/hash (useful for change detection / polling). */
+    dataVersion() {
+        return this.engine.getJson(`${API}/dynamic/version/dataVersion.json`);
+    }
+}
+export class NinaClient {
+    engine;
+    warnings;
+    archive;
+    reference;
+    constructor(options = {}) {
+        this.engine = new RequestEngine(options);
+        this.warnings = new WarningsResource(this.engine);
+        this.archive = new ArchiveResource(this.engine);
+        this.reference = new ReferenceResource(this.engine);
+    }
+    /** Current warnings from one source, e.g. `mapData("dwd")`. */
+    mapData(source) {
+        return this.engine.getJson(`${API}/${source}/mapData.json`);
+    }
+    /** Warnings affecting a region, keyed by Amtlicher Regionalschlüssel (ARS/AGS). */
+    dashboard(ars) {
+        return this.engine.getJson(`${API}/dashboard/${enc(ars)}.json`);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/src/client/client.js.map

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

package/dist/src/client/engine.d.ts

@@ -0,0 +1,53 @@
+import { type Transport } from "./http.js";
+import { type QueryParams } from "./query.js";
+export declare const DEFAULT_BASE_URL = "https://warnung.bund.de";
+export interface RawResponse {
+    data: Buffer;
+    contentType: string;
+    status: number;
+}
+export interface EngineOptions {
+    /** Base URL of the API. Defaults to https://warnung.bund.de */
+    baseUrl?: string;
+    /** Swappable transport. Defaults to the built-in node http/https transport. */
+    transport?: Transport;
+    /** Value of the User-Agent header. */
+    userAgent?: string;
+    /** Per-request timeout in milliseconds (0 disables). */
+    timeoutMs?: number;
+    /** Number of automatic retries for transient (429/503) responses. */
+    maxRetries?: number;
+    /** Base backoff between retries in milliseconds (grows linearly). */
+    retryDelayMs?: number;
+    /**
+     * Hard cap on response body size in bytes (defends against memory exhaustion
+     * from a hostile/buggy endpoint). Defaults to 100 MiB; set to 0 for no limit.
+     */
+    maxResponseBytes?: number;
+    /** Injectable sleep, primarily for deterministic tests. */
+    sleep?: (ms: number) => Promise<void>;
+}
+export declare class RequestEngine {
+    private readonly baseUrl;
+    private readonly transport;
+    private readonly userAgent;
+    private readonly timeoutMs;
+    private readonly maxRetries;
+    private readonly retryDelayMs;
+    private readonly maxResponseBytes;
+    private readonly sleep;
+    constructor(options?: EngineOptions);
+    /** Build a fully-qualified URL from a path and optional query parameters. */
+    buildUrl(path: string, query?: QueryParams): string;
+    /** Perform a request with Accept negotiation and transient-error retries. */
+    request(method: string, path: string, options?: {
+        query?: QueryParams;
+        accept: string;
+    }): Promise<RawResponse>;
+    /** Perform a GET expecting JSON and parse it into `T`. */
+    getJson<T>(path: string, query?: QueryParams): Promise<T>;
+    /** Perform a GET returning the raw bytes (GeoJSON / RSS / image downloads). */
+    getRaw(path: string, accept: string, query?: QueryParams): Promise<RawResponse>;
+    private toApiError;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/src/client/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/client/engine.ts"],"names":[],"mappings":"AAIA,OAAO,EAAqB,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAGhE,eAAO,MAAM,gBAAgB,4BAA4B,CAAC;AAG1D,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,2DAA2D;IAC3D,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAeD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;gBAE1C,OAAO,GAAE,aAAkB;IAWvC,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,MAAM;IAMnD,6EAA6E;IACvE,OAAO,CACX,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,WAAW,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAmC,GAChF,OAAO,CAAC,WAAW,CAAC;IAmCvB,0DAA0D;IACpD,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IAU/D,+EAA+E;IACzE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAIrF,OAAO,CAAC,UAAU;CAYnB"}

package/dist/src/client/engine.js

@@ -0,0 +1,105 @@
+// The request engine: turns logical (method, path, query) calls into HTTP
+// requests via a Transport, applies retry/backoff for transient statuses
+// (429, 503), and decodes responses.
+import { nodeHttpTransport } from "./http.js";
+import { buildQueryString } from "./query.js";
+import { NinaApiError, NinaParseError } from "./errors.js";
+export const DEFAULT_BASE_URL = "https://warnung.bund.de";
+const DEFAULT_USER_AGENT = "nina-warnungen-cli";
+const DEFAULT_MAX_RESPONSE_BYTES = 100 * 1024 * 1024;
+/**
+ * Upper bound on retry attempts. Without a cap, a host stuck on 429/503 combined
+ * with the linear backoff (`retryDelayMs * attempt`) makes the total wait grow
+ * quadratically, so a large `--max-retries` (up to MAX_SAFE_INTEGER) would hang
+ * the process for hours. 10 retries is well beyond any realistic transient blip.
+ */
+const MAX_RETRIES_CAP = 10;
+const realSleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+export class RequestEngine {
+    baseUrl;
+    transport;
+    userAgent;
+    timeoutMs;
+    maxRetries;
+    retryDelayMs;
+    maxResponseBytes;
+    sleep;
+    constructor(options = {}) {
+        this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+        this.transport = options.transport ?? nodeHttpTransport;
+        this.userAgent = options.userAgent ?? DEFAULT_USER_AGENT;
+        this.timeoutMs = options.timeoutMs ?? 30_000;
+        this.maxRetries = Math.min(options.maxRetries ?? 2, MAX_RETRIES_CAP);
+        this.retryDelayMs = options.retryDelayMs ?? 200;
+        this.maxResponseBytes = options.maxResponseBytes ?? DEFAULT_MAX_RESPONSE_BYTES;
+        this.sleep = options.sleep ?? realSleep;
+    }
+    /** Build a fully-qualified URL from a path and optional query parameters. */
+    buildUrl(path, query) {
+        const normalizedPath = path.startsWith("/") ? path : `/${path}`;
+        const qs = query ? buildQueryString(query) : "";
+        return `${this.baseUrl}${normalizedPath}${qs ? `?${qs}` : ""}`;
+    }
+    /** Perform a request with Accept negotiation and transient-error retries. */
+    async request(method, path, options = { accept: "application/json" }) {
+        const url = this.buildUrl(path, options.query);
+        const headers = {
+            Accept: options.accept,
+            "User-Agent": this.userAgent,
+        };
+        let attempt = 0;
+        // attempts = initial try + maxRetries
+        for (;;) {
+            const response = await this.transport({
+                method,
+                url,
+                headers,
+                timeoutMs: this.timeoutMs,
+                ...(this.maxResponseBytes > 0 ? { maxResponseBytes: this.maxResponseBytes } : {}),
+            });
+            const status = response.status;
+            const retryable = status === 429 || status === 503;
+            if (retryable && attempt < this.maxRetries) {
+                attempt += 1;
+                await this.sleep(this.retryDelayMs * attempt);
+                continue;
+            }
+            const contentType = String(response.headers["content-type"] ?? "");
+            if (status < 200 || status >= 300) {
+                throw this.toApiError(method, url, status, response.body);
+            }
+            return { data: response.body, contentType, status };
+        }
+    }
+    /** Perform a GET expecting JSON and parse it into `T`. */
+    async getJson(path, query) {
+        const res = await this.request("GET", path, { query, accept: "application/json" });
+        const text = res.data.toString("utf8");
+        try {
+            return JSON.parse(text);
+        }
+        catch (cause) {
+            throw new NinaParseError(`Failed to parse JSON response from ${path}`, { cause });
+        }
+    }
+    /** Perform a GET returning the raw bytes (GeoJSON / RSS / image downloads). */
+    async getRaw(path, accept, query) {
+        return this.request("GET", path, { query, accept });
+    }
+    toApiError(method, url, status, body) {
+        const text = body.toString("utf8");
+        let detail;
+        try {
+            const parsed = JSON.parse(text);
+            if (parsed && typeof parsed.detail === "string")
+                detail = parsed.detail;
+            else if (parsed && typeof parsed.message === "string")
+                detail = parsed.message;
+        }
+        catch {
+            // Non-JSON error body; leave detail undefined.
+        }
+        return new NinaApiError({ status, url, method, body: text, detail });
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/src/client/engine.js.map

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

package/dist/src/client/enums.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The warning "providers" NINA aggregates, each exposed at `/{source}/mapData.json`:
+ *   mowas   — Modulares Warnsystem (Bund/Länder civil-protection alerts)
+ *   katwarn — KATWARN municipal alerting
+ *   biwapp  — BIWAPP municipal alerting
+ *   dwd     — Deutscher Wetterdienst severe-weather warnings
+ *   lhp     — Länderübergreifendes Hochwasser Portal (flood warnings)
+ *   police  — police incident reports
+ */
+export declare const NinaSourceValues: readonly ["mowas", "katwarn", "biwapp", "dwd", "lhp", "police"];
+export type NinaSource = (typeof NinaSourceValues)[number];
+/** Severity levels used in CAP-derived warning payloads. */
+export declare const SeverityValues: readonly ["Minor", "Moderate", "Severe", "Extreme", "Unknown"];
+export type Severity = (typeof SeverityValues)[number];
+//# sourceMappingURL=enums.d.ts.map

package/dist/src/client/enums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../../../src/client/enums.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,iEAAkE,CAAC;AAChG,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,4DAA4D;AAC5D,eAAO,MAAM,cAAc,gEAAiE,CAAC;AAC7F,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/src/client/enums.js

@@ -0,0 +1,15 @@
+// Enum-like value sets. These const arrays double as runtime CLI choice
+// validators and as TS union types.
+/**
+ * The warning "providers" NINA aggregates, each exposed at `/{source}/mapData.json`:
+ *   mowas   — Modulares Warnsystem (Bund/Länder civil-protection alerts)
+ *   katwarn — KATWARN municipal alerting
+ *   biwapp  — BIWAPP municipal alerting
+ *   dwd     — Deutscher Wetterdienst severe-weather warnings
+ *   lhp     — Länderübergreifendes Hochwasser Portal (flood warnings)
+ *   police  — police incident reports
+ */
+export const NinaSourceValues = ["mowas", "katwarn", "biwapp", "dwd", "lhp", "police"];
+/** Severity levels used in CAP-derived warning payloads. */
+export const SeverityValues = ["Minor", "Moderate", "Severe", "Extreme", "Unknown"];
+//# sourceMappingURL=enums.js.map

package/dist/src/client/enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.js","sourceRoot":"","sources":["../../../src/client/enums.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,oCAAoC;AAEpC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAU,CAAC;AAGhG,4DAA4D;AAC5D,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAU,CAAC"}

package/dist/src/client/errors.d.ts

@@ -0,0 +1,36 @@
+/** Base class for every error originating from this client. */
+export declare class NinaError extends Error {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * The API responded with a non-2xx status code. `detail` holds a human-readable
+ * message extracted from the response body when one is present.
+ */
+export declare class NinaApiError extends NinaError {
+    readonly status: number;
+    readonly detail: string | undefined;
+    readonly url: string;
+    readonly method: string;
+    readonly body: string;
+    constructor(args: {
+        status: number;
+        url: string;
+        method: string;
+        body: string;
+        detail?: string;
+    });
+    /** True for statuses the API documents as transient and retry-able. */
+    get isRetryable(): boolean;
+}
+/** A transport-level failure (DNS, connection reset, timeout, ...). */
+export declare class NinaNetworkError extends NinaError {
+}
+/** The response body could not be parsed as the expected JSON shape. */
+export declare class NinaParseError extends NinaError {
+}
+/** A local I/O failure, e.g. writing the --output file (no such dir, EISDIR). */
+export declare class NinaIOError extends NinaError {
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/src/client/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/client/errors.ts"],"names":[],"mappings":"AAGA,+DAA+D;AAC/D,qBAAa,SAAU,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI3D;AAED;;;GAGG;AACH,qBAAa,YAAa,SAAQ,SAAS;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;IAaD,uEAAuE;IACvE,IAAI,WAAW,IAAI,OAAO,CAEzB;CACF;AAgBD,uEAAuE;AACvE,qBAAa,gBAAiB,SAAQ,SAAS;CAAG;AAElD,wEAAwE;AACxE,qBAAa,cAAe,SAAQ,SAAS;CAAG;AAEhD,iFAAiF;AACjF,qBAAa,WAAY,SAAQ,SAAS;CAAG"}