@maschinenlesbar.org/luftqualitaet-cli 0.0.1

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

@@ -0,0 +1,33 @@
+/** Base class for every error originating from this client. */
+export declare class LuftError 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 LuftApiError extends LuftError {
+    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 LuftNetworkError extends LuftError {
+}
+/** The response body could not be parsed as the expected JSON shape. */
+export declare class LuftParseError extends LuftError {
+}
+//# 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;IAUD,uEAAuE;IACvE,IAAI,WAAW,IAAI,OAAO,CAEzB;CACF;AAED,uEAAuE;AACvE,qBAAa,gBAAiB,SAAQ,SAAS;CAAG;AAElD,wEAAwE;AACxE,qBAAa,cAAe,SAAQ,SAAS;CAAG"}

package/dist/src/client/errors.js

@@ -0,0 +1,40 @@
+// Error types raised by the client. Kept free of any I/O so they are trivial to
+// construct in tests and to `instanceof`-check by consumers.
+/** Base class for every error originating from this client. */
+export class LuftError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = new.target.name;
+    }
+}
+/**
+ * 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 class LuftApiError extends LuftError {
+    status;
+    detail;
+    url;
+    method;
+    body;
+    constructor(args) {
+        const detailPart = args.detail ? `: ${args.detail}` : "";
+        super(`HTTP ${args.status} for ${args.method} ${args.url}${detailPart}`);
+        this.status = args.status;
+        this.url = args.url;
+        this.method = args.method;
+        this.body = args.body;
+        this.detail = args.detail;
+    }
+    /** True for statuses the API documents as transient and retry-able. */
+    get isRetryable() {
+        return this.status === 429 || this.status === 503;
+    }
+}
+/** A transport-level failure (DNS, connection reset, timeout, ...). */
+export class LuftNetworkError extends LuftError {
+}
+/** The response body could not be parsed as the expected JSON shape. */
+export class LuftParseError extends LuftError {
+}
+//# sourceMappingURL=errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/client/errors.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,6DAA6D;AAE7D,+DAA+D;AAC/D,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClC,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;IAC9B,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,YAAa,SAAQ,SAAS;IAChC,MAAM,CAAS;IACf,MAAM,CAAqB;IAC3B,GAAG,CAAS;IACZ,MAAM,CAAS;IACf,IAAI,CAAS;IAEtB,YAAY,IAMX;QACC,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,KAAK,CAAC,QAAQ,IAAI,CAAC,MAAM,QAAQ,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,GAAG,UAAU,EAAE,CAAC,CAAC;QACzE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACpB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED,uEAAuE;IACvE,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG,CAAC;IACpD,CAAC;CACF;AAED,uEAAuE;AACvE,MAAM,OAAO,gBAAiB,SAAQ,SAAS;CAAG;AAElD,wEAAwE;AACxE,MAAM,OAAO,cAAe,SAAQ,SAAS;CAAG"}

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

@@ -0,0 +1,26 @@
+import http from "node:http";
+export interface HttpRequest {
+    method: string;
+    /** Fully-qualified absolute URL. */
+    url: string;
+    headers?: Record<string, string>;
+    /** Optional request body (already serialised). */
+    body?: string | Buffer;
+    /** Per-request timeout in milliseconds. */
+    timeoutMs?: number;
+    /** Hard cap on the response body size in bytes; the request aborts if exceeded. */
+    maxResponseBytes?: number;
+}
+export interface HttpResponse {
+    status: number;
+    headers: http.IncomingHttpHeaders;
+    body: Buffer;
+}
+export type Transport = (request: HttpRequest) => Promise<HttpResponse>;
+/**
+ * Default transport. Resolves with the raw response (including non-2xx) — status
+ * interpretation is the client's job. Rejects only on transport-level failures
+ * (connection errors, timeouts, malformed URLs).
+ */
+export declare const nodeHttpTransport: Transport;
+//# sourceMappingURL=http.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/client/http.ts"],"names":[],"mappings":"AAQA,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mFAAmF;IACnF,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,IAAI,CAAC,mBAAmB,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;AAExE;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAuG5B,CAAC"}

package/dist/src/client/http.js

@@ -0,0 +1,111 @@
+// HTTP transport built on Node's built-in `http`/`https` modules — no axios,
+// no fetch polyfill, no third-party HTTP client.
+//
+// The transport is a plain function so it can be trivially swapped out in tests
+// (inject a `mock.fn()` returning a canned HttpResponse) without touching the
+// network. The default implementation below is exercised against a real local
+// `http.createServer` in the test-suite.
+import http from "node:http";
+import https from "node:https";
+import { LuftNetworkError } from "./errors.js";
+/**
+ * Default transport. Resolves with the raw response (including non-2xx) — status
+ * interpretation is the client's job. Rejects only on transport-level failures
+ * (connection errors, timeouts, malformed URLs).
+ */
+export const nodeHttpTransport = (request) => new Promise((resolve, reject) => {
+    let url;
+    try {
+        url = new URL(request.url);
+    }
+    catch {
+        reject(new LuftNetworkError(`Invalid URL: ${request.url}`));
+        return;
+    }
+    // Only http/https are supported. Reject anything else up front with a clear,
+    // typed error instead of letting Node throw an opaque ERR_INVALID_PROTOCOL
+    // (and so this never reaches the file:/ftp:/etc. drivers).
+    if (url.protocol !== "http:" && url.protocol !== "https:") {
+        reject(new LuftNetworkError(`Unsupported protocol "${url.protocol}" in URL: ${request.url}`));
+        return;
+    }
+    const isHttps = url.protocol === "https:";
+    const driver = isHttps ? https : http;
+    const maxBytes = request.maxResponseBytes;
+    const req = driver.request(url, {
+        method: request.method,
+        headers: request.headers,
+    }, (res) => {
+        const chunks = [];
+        let received = 0;
+        let aborted = false;
+        res.on("data", (chunk) => {
+            if (aborted)
+                return;
+            received += chunk.length;
+            if (maxBytes !== undefined && received > maxBytes) {
+                aborted = true;
+                res.destroy();
+                reject(new LuftNetworkError(`Response exceeded maxResponseBytes (${maxBytes})`));
+                return;
+            }
+            chunks.push(chunk);
+        });
+        res.on("end", () => {
+            if (aborted)
+                return;
+            resolve({
+                status: res.statusCode ?? 0,
+                headers: res.headers,
+                body: Buffer.concat(chunks),
+            });
+        });
+        res.on("error", (err) => {
+            if (aborted)
+                return; // we already rejected with the size-cap error
+            reject(new LuftNetworkError(`Response stream error: ${err.message}`, { cause: err }));
+        });
+    });
+    // Only treat the timeout as a *timeout* if the socket was actually
+    // connected. A pending DNS/connect failure can outrace the timer (an
+    // unresolvable host may take longer to fail than the timeout window); in
+    // that case we want the real DNS/connect failure to surface, not a
+    // misleading "Request timed out" message.
+    let connected = false;
+    let dnsError;
+    req.on("socket", (socket) => {
+        // A failed DNS lookup reports here before the socket emits "error";
+        // capture it so a racing timeout can report the true cause.
+        socket.on("lookup", (err) => {
+            if (err)
+                dnsError = err;
+        });
+        socket.on("connect", () => {
+            connected = true;
+        });
+    });
+    if (request.timeoutMs && request.timeoutMs > 0) {
+        req.setTimeout(request.timeoutMs, () => {
+            if (connected) {
+                req.destroy(new LuftNetworkError(`Request timed out after ${request.timeoutMs}ms`));
+            }
+            else if (dnsError) {
+                // DNS resolution already failed; report that, not a timeout.
+                req.destroy(new LuftNetworkError(dnsError.message, { cause: dnsError }));
+            }
+            else {
+                // Still in the connect/DNS phase with no socket yet. Attribute the
+                // failure to that phase rather than claiming a generic request timeout.
+                req.destroy(new LuftNetworkError(`Could not connect to ${url.host} within ${request.timeoutMs}ms (host unresolved or unreachable)`));
+            }
+        });
+    }
+    req.on("error", (err) => {
+        // A timeout destroy already passes an LuftNetworkError; don't double-wrap.
+        reject(err instanceof LuftNetworkError ? err : new LuftNetworkError(err.message, { cause: err }));
+    });
+    if (request.body !== undefined)
+        req.write(request.body);
+    req.end();
+});
+//# sourceMappingURL=http.js.map

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

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

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

@@ -0,0 +1,11 @@
+export { LuftqualitaetClient } from "./client.js";
+export { RequestEngine, DEFAULT_BASE_URL } from "./engine.js";
+export type { EngineOptions, RawResponse } from "./engine.js";
+export { nodeHttpTransport } from "./http.js";
+export type { Transport, HttpRequest, HttpResponse } from "./http.js";
+export { buildQueryString } from "./query.js";
+export type { QueryParams, QueryValue } from "./query.js";
+export { LuftError, LuftApiError, LuftNetworkError, LuftParseError } from "./errors.js";
+export * from "./enums.js";
+export * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC9D,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAExF,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/src/client/index.js

@@ -0,0 +1,9 @@
+// Public entry point for the API client library.
+export { LuftqualitaetClient } from "./client.js";
+export { RequestEngine, DEFAULT_BASE_URL } from "./engine.js";
+export { nodeHttpTransport } from "./http.js";
+export { buildQueryString } from "./query.js";
+export { LuftError, LuftApiError, LuftNetworkError, LuftParseError } from "./errors.js";
+export * from "./enums.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA,iDAAiD;AAEjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAExF,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

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

@@ -0,0 +1,9 @@
+export type QueryPrimitive = string | number | boolean | Date | null | undefined;
+export type QueryValue = QueryPrimitive | QueryPrimitive[];
+export type QueryParams = Record<string, QueryValue>;
+/**
+ * Build a query string (without a leading `?`) from a params object.
+ * Returns an empty string when no parameters survive filtering.
+ */
+export declare function buildQueryString(params: QueryParams): string;
+//# sourceMappingURL=query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/client/query.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC;AACjF,MAAM,MAAM,UAAU,GAAG,cAAc,GAAG,cAAc,EAAE,CAAC;AAC3D,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAQrD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAe5D"}

package/dist/src/client/query.js

@@ -0,0 +1,33 @@
+// Tiny, dependency-free query-string builder.
+//   - `undefined` / `null` values are omitted entirely
+//   - arrays are serialised as repeated keys (`?id=a&id=b`)
+//   - booleans become the strings "true"/"false"
+//   - Date values become full ISO-8601 strings
+//   - everything else is coerced with String()
+function serializeScalar(value) {
+    if (value instanceof Date)
+        return value.toISOString();
+    if (typeof value === "boolean")
+        return value ? "true" : "false";
+    return String(value);
+}
+/**
+ * Build a query string (without a leading `?`) from a params object.
+ * Returns an empty string when no parameters survive filtering.
+ */
+export function buildQueryString(params) {
+    const search = new URLSearchParams();
+    for (const [key, raw] of Object.entries(params)) {
+        if (raw === undefined || raw === null)
+            continue;
+        const values = Array.isArray(raw) ? raw : [raw];
+        for (const value of values) {
+            if (value === undefined || value === null)
+                continue;
+            search.append(key, serializeScalar(value));
+        }
+    }
+    // URLSearchParams encodes spaces as "+"; "%20" is more broadly interoperable.
+    return search.toString().replace(/\+/g, "%20");
+}
+//# sourceMappingURL=query.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/client/query.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,uDAAuD;AACvD,4DAA4D;AAC5D,iDAAiD;AACjD,+CAA+C;AAC/C,+CAA+C;AAM/C,SAAS,eAAe,CAAC,KAAgD;IACvE,IAAI,KAAK,YAAY,IAAI;QAAE,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;IACtD,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IAChE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAmB;IAClD,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IAErC,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAChD,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI;YAAE,SAAS;QAEhD,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAChD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;gBAAE,SAAS;YACpD,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,8EAA8E;IAC9E,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AACjD,CAAC"}

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

@@ -0,0 +1,57 @@
+import type { Lang, IndexKind, MetaUse, ThresholdUse } from "./enums.js";
+export type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type JsonObject = {
+    [key: string]: JsonValue;
+};
+/** A generic UBA response (typically `{ request, indices, data, count, ... }`). */
+export type AirDataResult = JsonObject;
+/** Common options for the reference-list endpoints. */
+export interface ListParams {
+    lang?: Lang;
+    index?: IndexKind;
+}
+/** The time window + station shared by the data endpoints. */
+export interface WindowParams {
+    /** Start date, YYYY-MM-DD. */
+    date_from: string;
+    /** Start hour, 1..24. */
+    time_from: number;
+    /** End date, YYYY-MM-DD. */
+    date_to: string;
+    /** End hour, 1..24. */
+    time_to: number;
+    /** Station id. */
+    station: number;
+}
+/** Parameters for `/measures/json` (a window plus optional component/scope). */
+export interface MeasuresParams extends WindowParams {
+    component?: number;
+    scope?: number;
+}
+/** Parameters for `/annualbalances/json` and `/transgressions/json`. */
+export interface YearComponentParams {
+    component: number;
+    /** Four-digit year, >= 2016. */
+    year: number;
+    lang?: Lang;
+    index?: IndexKind;
+}
+/** Parameters for `/thresholds/json`. */
+export interface ThresholdParams {
+    use: ThresholdUse;
+    lang?: Lang;
+    component?: number;
+    scope?: number;
+}
+/** Parameters for `/meta/json`. */
+export interface MetaParams {
+    use: MetaUse;
+    lang?: Lang;
+    date_from?: string;
+    date_to?: string;
+    time_from?: number;
+    time_to?: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/client/types.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEzE,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,EAAE,GACX;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AACjC,MAAM,MAAM,UAAU,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEtD,mFAAmF;AACnF,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC;AAEvC,uDAAuD;AACvD,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,8DAA8D;AAC9D,MAAM,WAAW,YAAY;IAC3B,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,gFAAgF;AAChF,MAAM,WAAW,cAAe,SAAQ,YAAY;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wEAAwE;AACxE,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,yCAAyC;AACzC,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,YAAY,CAAC;IAClB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,mCAAmC;AACnC,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/src/client/types.js

@@ -0,0 +1,8 @@
+// Domain types for the Umweltbundesamt Air Data API (umweltbundesamt.de).
+//
+// The API returns "index + data" structures whose row layout is described by an
+// `indices` array and whose payload shape varies by endpoint and parameters, so
+// responses are exposed as faithful raw `JsonObject`s. The parameter objects for
+// the data endpoints are typed precisely.
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/client/types.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,EAAE;AACF,gFAAgF;AAChF,gFAAgF;AAChF,iFAAiF;AACjF,0CAA0C"}

package/dist/src/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./client/index.js";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/src/index.js

@@ -0,0 +1,3 @@
+// Library root. Import from here when using autobahn-cli as a dependency.
+export * from "./client/index.js";
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,cAAc,mBAAmB,CAAC"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@maschinenlesbar.org/luftqualitaet-cli",
+  "version": "0.0.1",
+  "description": "TypeScript API client and CLI for the open Umweltbundesamt Air Data API (umweltbundesamt.de)",
+  "type": "module",
+  "bin": {
+    "luftqualitaet": "dist/src/cli/index.js"
+  },
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    }
+  },
+  "files": [
+    "dist/src",
+    "LICENSING.md",
+    "CONTRIBUTING.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
+    "build": "tsc -p tsconfig.json",
+    "prepack": "npm run build",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "pretest": "npm run build",
+    "test": "node --test dist/test/*.test.js",
+    "docs": "typedoc src/index.ts --out out",
+    "start": "node dist/src/cli/index.js"
+  },
+  "keywords": [
+    "umweltbundesamt",
+    "uba",
+    "luftqualitaet",
+    "air-quality",
+    "environment",
+    "germany",
+    "cli",
+    "api-client"
+  ],
+  "author": "Sebastian Schürmann <sebs@2xs.org>",
+  "license": "AGPL-3.0-or-later",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/maschinenlesbar-org/luftqualitaet-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/maschinenlesbar-org/luftqualitaet-cli/issues"
+  },
+  "homepage": "https://github.com/maschinenlesbar-org/luftqualitaet-cli#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "commander": "15.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.19",
+    "typedoc": "0.28.19",
+    "typescript": "6.0.3"
+  }
+}