@yadimon/steuer-spar-erklaerung-api 0.1.0-beta.10

package/LICENSE

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

package/README.md

@@ -0,0 +1,85 @@
+# @yadimon/steuer-spar-erklaerung-api
+
+> **Beta und inoffiziell.** Dieses Projekt ist nicht mit Wolters Kluwer
+> verbunden. Es sendet keine Steuererklärung und ersetzt keine Steuerberatung.
+
+Lokaler Windows-x64-API-Wrapper für SteuerSparErklärung. Das Paket stellt die
+installierte Desktop-Anwendung über eine ausschließlich an `127.0.0.1`
+gebundene, token-geschützte HTTP-API und eine direkte CLI bereit.
+
+## Rolle des Pakets
+
+Dieses Paket ist die lokale Ausführungsschicht:
+
+- HTTP-API und direkte API-CLI;
+- Windows-PowerShell-5.1- und Native-Runtime;
+- versionierte Produktprofile für geprüfte SteuerSparErklärung-Builds;
+- Arbeitskopien, Backups, read-only Analyse und freigegebene UI-Automation;
+- technischer Konfigurationshelfer für den öffentlichen Setup-Skill.
+
+Der geführte Einrichtungs-Wizard ist der
+[`steuer-spar-erklaerung-setup`-Skill](https://github.com/yadimon/steuer-spar-erklaerung-mcp/tree/main/skills/steuer-spar-erklaerung-setup),
+nicht die Produktrolle dieses npm-Pakets.
+Der MCP-Server ist bewusst **nicht** enthalten; er liegt im getrennten Paket
+[`@yadimon/steuer-spar-erklaerung-mcp`](https://www.npmjs.com/package/@yadimon/steuer-spar-erklaerung-mcp).
+
+## Voraussetzungen
+
+- Windows x64;
+- installierte SteuerSparErklärung 2025 / Engine-Major 31;
+- Node.js 22 oder neuer für diesen npm-Installationsweg.
+
+Ohne Node.js/npm kann stattdessen das vollständige portable Windows-Release
+aus den [GitHub Releases](https://github.com/yadimon/steuer-spar-erklaerung-mcp/releases)
+verwendet werden.
+
+## Installation und direkte API-Nutzung
+
+Für einen einzelnen Lauf ist keine globale Paketinstallation nötig. Der erste
+Foreground-Start erzeugt eine lokale Standardkonfiguration, falls noch keine
+vorhanden ist. Der Fallordner gilt nur für diesen Prozess:
+
+```powershell
+npx.cmd -y @yadimon/steuer-spar-erklaerung-api --case-dir "C:\Pfad\zum\Fallordner"
+```
+
+Das Terminal bleibt offen. Aus einem zweiten Terminal ruft die mitgelieferte
+CLI die API auf, ohne das lokale Token anzuzeigen:
+
+```powershell
+npx.cmd -y -p @yadimon/steuer-spar-erklaerung-api steuer-spar-erklaerung-call discovery
+npx.cmd -y -p @yadimon/steuer-spar-erklaerung-api steuer-spar-erklaerung-call health
+```
+
+`Strg+C` beendet die API. Dieser kurze Weg registriert kein MCP und erzeugt
+keinen dauerhaften Launcher im NPX-Cache.
+
+Für eine dauerhafte Installation bleiben die drei Befehle global verfügbar:
+
+```powershell
+npm install --global @yadimon/steuer-spar-erklaerung-api@beta
+steuer-spar-erklaerung-api --help
+steuer-spar-erklaerung-call --help
+steuer-spar-erklaerung-setup --check
+```
+
+Für die geführte Einrichtung sollte ein Agent den Setup-Skill verwenden. Er
+bestätigt Steuerfall und Belegordner, installiert bei Bedarf API und MCP in
+derselben Version und ruft den technischen Konfigurationshelfer dieses Pakets
+auf. Dadurch bleiben Nutzerführung und API-Runtime klar getrennt.
+
+## Sicherheitsgrenzen
+
+- API nur auf Loopback mit Bearer-Token;
+- lokale Pfade und Steuerdaten bleiben auf dem Windows-PC;
+- Originalfälle werden nicht überschrieben;
+- Änderungen nur an gebundenen Arbeitskopien und mit Readback;
+- ELSTER, Versand und sonstige Übermittlung ans Finanzamt sind gesperrt;
+- Profil 2024 bleibt experimentell und ist im Nutzer-Setup nicht freigegeben.
+
+Vollständiger Schnellstart, Skill-Installation, unterstützte Operationen und
+Verifikation stehen im
+[Repository](https://github.com/yadimon/steuer-spar-erklaerung-mcp#readme).
+Sicherheitsprobleme bitte nach
+[`SECURITY.md`](https://github.com/yadimon/steuer-spar-erklaerung-mcp/blob/main/SECURITY.md)
+melden.

package/dist/abort.js

@@ -0,0 +1,22 @@
+export async function withCombinedAbortSignal(signals, action) {
+    const controller = new AbortController();
+    const active = [...new Set(signals.filter((signal) => Boolean(signal)))];
+    const listeners = new Map();
+    for (const signal of active) {
+        if (signal.aborted) {
+            controller.abort(signal.reason);
+            break;
+        }
+        const abort = () => controller.abort(signal.reason);
+        listeners.set(signal, abort);
+        signal.addEventListener("abort", abort, { once: true });
+    }
+    try {
+        return await action(controller.signal);
+    }
+    finally {
+        for (const [signal, abort] of listeners)
+            signal.removeEventListener("abort", abort);
+    }
+}
+//# sourceMappingURL=abort.js.map

package/dist/abort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.js","sourceRoot":"","sources":["../../../src/abort.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAuC,EACvC,MAA2C;IAE3C,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAyB,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAChG,MAAM,SAAS,GAAG,IAAI,GAAG,EAA2B,CAAC;IACrD,KAAK,MAAM,MAAM,IAAI,MAAM,EAAE,CAAC;QAC5B,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAChC,MAAM;QACR,CAAC;QACD,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACpD,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC7B,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;YAAS,CAAC;QACT,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,SAAS;YAAE,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACtF,CAAC;AACH,CAAC"}

package/dist/abortable.js

@@ -0,0 +1,37 @@
+export function abortError() {
+    return new DOMException("Aborted", "AbortError");
+}
+/**
+ * Bindet eine nicht nativ abortierbare Promise an ein Signal. Falls das
+ * Ergebnis erst nach dem Abbruch eintrifft, kann der Aufrufer den spaeten
+ * Handle oder eine andere Ressource gezielt freigeben.
+ */
+export function abortable(operation, signal, cleanupLateResult) {
+    return new Promise((resolvePromise, rejectPromise) => {
+        let settled = false;
+        const finish = () => {
+            if (settled)
+                return false;
+            settled = true;
+            signal.removeEventListener("abort", onAbort);
+            return true;
+        };
+        const onAbort = () => {
+            if (finish())
+                rejectPromise(abortError());
+        };
+        signal.addEventListener("abort", onAbort, { once: true });
+        if (signal.aborted)
+            onAbort();
+        operation.then((value) => {
+            if (finish())
+                resolvePromise(value);
+            else
+                void cleanupLateResult?.(value);
+        }, (error) => {
+            if (finish())
+                rejectPromise(error);
+        });
+    });
+}
+//# sourceMappingURL=abortable.js.map

package/dist/abortable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abortable.js","sourceRoot":"","sources":["../../../src/abortable.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,UAAU;IACxB,OAAO,IAAI,YAAY,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;AACnD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CACvB,SAAqB,EACrB,MAAmB,EACnB,iBAAsD;IAEtD,OAAO,IAAI,OAAO,CAAI,CAAC,cAAc,EAAE,aAAa,EAAE,EAAE;QACtD,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,MAAM,GAAG,GAAY,EAAE;YAC3B,IAAI,OAAO;gBAAE,OAAO,KAAK,CAAC;YAC1B,OAAO,GAAG,IAAI,CAAC;YACf,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7C,OAAO,IAAI,CAAC;QACd,CAAC,CAAC;QACF,MAAM,OAAO,GAAG,GAAS,EAAE;YACzB,IAAI,MAAM,EAAE;gBAAE,aAAa,CAAC,UAAU,EAAE,CAAC,CAAC;QAC5C,CAAC,CAAC;QACF,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,IAAI,MAAM,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;QAC9B,SAAS,CAAC,IAAI,CACZ,CAAC,KAAK,EAAE,EAAE;YACR,IAAI,MAAM,EAAE;gBAAE,cAAc,CAAC,KAAK,CAAC,CAAC;;gBAC/B,KAAK,iBAAiB,EAAE,CAAC,KAAK,CAAC,CAAC;QACvC,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;YACjB,IAAI,MAAM,EAAE;gBAAE,aAAa,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/api-cli-journal.js

@@ -0,0 +1,75 @@
+import { closeSync, fsyncSync, openSync, writeSync } from "node:fs";
+import { randomUUID } from "node:crypto";
+import { ApiClientError } from "./api-client-error.js";
+function appendDurably(fileDescriptor, entry) {
+    writeSync(fileDescriptor, `${JSON.stringify(entry)}\n`, null, "utf8");
+    fsyncSync(fileDescriptor);
+}
+export function createCliJournal(path, context) {
+    let fileDescriptor;
+    try {
+        fileDescriptor = openSync(path, "wx", 0o600);
+    }
+    catch (error) {
+        const code = error && typeof error === "object" && "code" in error ? error.code : undefined;
+        if (code === "EEXIST") {
+            throw new ApiClientError(`Journaldatei existiert bereits und wird nicht ueberschrieben: ${path}`, "bad-args");
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        throw new ApiClientError(`Journaldatei kann nicht sicher angelegt werden: ${message}`, "bad-args");
+    }
+    const invocationId = randomUUID();
+    try {
+        appendDurably(fileDescriptor, {
+            schemaVersion: 1,
+            invocationId,
+            status: "pending",
+            command: context.command,
+            ...(context.targetOperation ? { targetOperation: context.targetOperation } : {}),
+            startedAt: new Date().toISOString(),
+        });
+    }
+    catch (error) {
+        try {
+            closeSync(fileDescriptor);
+        }
+        catch { /* Der Schreibfehler bleibt massgeblich. */ }
+        const message = error instanceof Error ? error.message : String(error);
+        throw new ApiClientError(`Journaldatei konnte nicht dauerhaft initialisiert werden: ${message}`, "bad-args");
+    }
+    let closed = false;
+    let finished = false;
+    return {
+        complete(result, exitCode) {
+            appendDurably(fileDescriptor, {
+                schemaVersion: 1,
+                invocationId,
+                status: "complete",
+                exitCode,
+                finishedAt: new Date().toISOString(),
+                result,
+            });
+            finished = true;
+        },
+        error(kind, message, exitCode) {
+            if (finished)
+                return;
+            appendDurably(fileDescriptor, {
+                schemaVersion: 1,
+                invocationId,
+                status: "error",
+                exitCode,
+                kind,
+                error: message,
+                finishedAt: new Date().toISOString(),
+            });
+        },
+        close() {
+            if (closed)
+                return;
+            closed = true;
+            closeSync(fileDescriptor);
+        },
+    };
+}
+//# sourceMappingURL=api-cli-journal.js.map

package/dist/api-cli-journal.js.map

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

package/dist/api-cli.js

@@ -0,0 +1,172 @@
+#!/usr/bin/env node
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { ApiClientError } from "./api-client-error.js";
+import { MAX_API_BODY_BYTES } from "./api-contract.js";
+import { parseJsonBytesStrict, readJsonFileStrict } from "./json-files.js";
+const usage = [
+    "Aufruf:",
+    "  steuer-spar-erklaerung-call health [--config <config.json>] [--journal-file <new.jsonl>]",
+    "  steuer-spar-erklaerung-call <operation> --args-file <args.json|-> [--timeout-ms <ms>] [--config <config.json>] [--journal-file <new.jsonl>]",
+    "  steuer-spar-erklaerung-call discovery [--config <config.json>] [--journal-file <new.jsonl>]",
+    "  steuer-spar-erklaerung-call describe <operation> [--config <config.json>] [--journal-file <new.jsonl>]",
+    "  steuer-spar-erklaerung-call openapi [--config <config.json>] [--journal-file <new.jsonl>]",
+    "",
+    "Mit --args-file - kommt ein begrenztes JSON-Objekt ueber stdin.",
+    "Argumentwerte werden absichtlich nicht direkt in der Kommandozeile akzeptiert.",
+    "--journal-file legt vor dem Aufruf exklusiv ein dauerhaftes pending/result-Protokoll an und ueberschreibt nie.",
+].join("\n");
+function parseCliArguments(argv) {
+    const command = argv[0];
+    if (!command) {
+        throw new ApiClientError(usage, "usage");
+    }
+    let argsFile;
+    let configPath;
+    let journalFile;
+    let timeoutMs = 90_000;
+    let targetOperation;
+    let optionStart = 1;
+    if (command === "describe") {
+        targetOperation = argv[1];
+        if (!targetOperation || targetOperation.startsWith("--")) {
+            throw new ApiClientError(`describe braucht einen Operationsnamen.\n${usage}`, "usage");
+        }
+        optionStart = 2;
+    }
+    for (let index = optionStart; index < argv.length; index += 1) {
+        const option = argv[index];
+        const value = argv[index + 1];
+        if (!["--args-file", "--config", "--journal-file", "--timeout-ms"].includes(option ?? "")) {
+            throw new ApiClientError(`Unbekannte Option '${option}'.\n${usage}`, "usage");
+        }
+        if (!value || value.startsWith("--")) {
+            throw new ApiClientError(`Option '${option}' braucht einen Wert.\n${usage}`, "usage");
+        }
+        if (option === "--args-file")
+            argsFile = value === "-" ? "-" : resolve(value);
+        if (option === "--config")
+            configPath = resolve(value);
+        if (option === "--journal-file")
+            journalFile = resolve(value);
+        if (option === "--timeout-ms") {
+            timeoutMs = Number(value);
+            if (!Number.isInteger(timeoutMs)) {
+                throw new ApiClientError("--timeout-ms muss eine ganze Zahl sein.", "usage");
+            }
+        }
+        index += 1;
+    }
+    if (["discovery", "describe", "openapi"].includes(command) && argsFile) {
+        throw new ApiClientError(`${command} akzeptiert keine Argumentdatei.`, "usage");
+    }
+    return {
+        command,
+        timeoutMs,
+        ...(targetOperation ? { targetOperation } : {}),
+        ...(argsFile ? { argsFile } : {}),
+        ...(configPath ? { configPath } : {}),
+        ...(journalFile ? { journalFile } : {}),
+    };
+}
+async function loadClientOptions(configPath) {
+    if (!configPath && process.env.SSE_API_TOKEN)
+        return {};
+    const { environmentForExplicitApiConfig, loadApiServerConfig } = await import("./api-config.js");
+    const env = configPath ? environmentForExplicitApiConfig(configPath) : { ...process.env };
+    const config = loadApiServerConfig(env);
+    const host = config.host === "::1" ? "[::1]" : config.host;
+    return { baseUrl: `http://${host}:${config.port}`, token: config.token };
+}
+export async function readCliInputBounded(stream, maxBytes = MAX_API_BODY_BYTES) {
+    if (!Number.isInteger(maxBytes) || maxBytes < 1) {
+        throw new ApiClientError("CLI-Eingabelimit muss eine positive ganze Zahl sein.", "bad-args");
+    }
+    const chunks = [];
+    let total = 0;
+    for await (const chunk of stream) {
+        if (typeof chunk !== "string" && !(chunk instanceof Uint8Array)) {
+            throw new ApiClientError("CLI-stdin lieferte einen ungueltigen Datentyp.", "bad-args");
+        }
+        const bytes = Buffer.from(chunk);
+        total += bytes.length;
+        if (total > maxBytes) {
+            throw new ApiClientError(`CLI-stdin ist groesser als ${maxBytes} Bytes.`, "bad-args");
+        }
+        chunks.push(bytes);
+    }
+    return Buffer.concat(chunks, total);
+}
+async function readOperationArgs(argsFile) {
+    if (!argsFile)
+        return {};
+    let parsed;
+    try {
+        parsed = argsFile === "-"
+            ? parseJsonBytesStrict(await readCliInputBounded(process.stdin), "API-CLI-stdin")
+            : readJsonFileStrict(argsFile, "API-CLI-Argumentdatei", MAX_API_BODY_BYTES);
+    }
+    catch (error) {
+        if (error instanceof ApiClientError)
+            throw error;
+        const message = error instanceof Error ? error.message : String(error);
+        throw new ApiClientError(message, "bad-args");
+    }
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new ApiClientError("API-CLI-Eingabe muss ein JSON-Objekt enthalten.", "bad-args");
+    }
+    return parsed;
+}
+export async function runApiCli(argv) {
+    if (argv[0] === "--help" || argv[0] === "-h") {
+        process.stdout.write(`${usage}\n`);
+        return 0;
+    }
+    const cli = parseCliArguments(argv);
+    const journal = cli.journalFile
+        ? (await import("./api-cli-journal.js")).createCliJournal(cli.journalFile, cli)
+        : undefined;
+    try {
+        const [options, client] = await Promise.all([
+            loadClientOptions(cli.configPath),
+            import("./api-client.js"),
+        ]);
+        let output;
+        if (cli.command === "discovery")
+            output = await client.readApiDiscovery(options);
+        else if (cli.command === "describe")
+            output = await client.readApiOperationDiscovery(cli.targetOperation, options);
+        else if (cli.command === "openapi")
+            output = await client.readOpenApiDocument(options);
+        else
+            output = await client.callApiOperation(cli.command, await readOperationArgs(cli.argsFile), cli.timeoutMs, options);
+        const exitCode = output && typeof output === "object" && "ok" in output && output.ok === false ? 1 : 0;
+        journal?.complete(output, exitCode);
+        process.stdout.write(`${JSON.stringify(output, null, 2)}\n`);
+        return exitCode;
+    }
+    catch (error) {
+        const kind = error instanceof ApiClientError ? error.kind : "unexpected";
+        const message = error instanceof Error ? error.message : String(error);
+        const exitCode = kind === "usage" || kind === "bad-args" ? 2 : 1;
+        try {
+            journal?.error(kind, message, exitCode);
+        }
+        catch {
+            // Der urspruengliche API-/CLI-Fehler bleibt massgeblich, auch wenn das Journalmedium ausfaellt.
+        }
+        throw error;
+    }
+    finally {
+        journal?.close();
+    }
+}
+if (process.argv[1] && resolve(process.argv[1]) === resolve(fileURLToPath(import.meta.url))) {
+    runApiCli(process.argv.slice(2)).then((exitCode) => { process.exitCode = exitCode; }, (error) => {
+        const kind = error instanceof ApiClientError ? error.kind : "unexpected";
+        const message = error instanceof Error ? error.message : String(error);
+        process.stderr.write(`SSE-API-CLI (${kind}): ${message}\n`);
+        process.exitCode = kind === "usage" || kind === "bad-args" ? 2 : 1;
+    });
+}
+//# sourceMappingURL=api-cli.js.map

package/dist/api-cli.js.map

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

package/dist/api-client-error.js

@@ -0,0 +1,9 @@
+export class ApiClientError extends Error {
+    kind;
+    constructor(message, kind = "api") {
+        super(message);
+        this.kind = kind;
+        this.name = "ApiClientError";
+    }
+}
+//# sourceMappingURL=api-client-error.js.map

package/dist/api-client-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client-error.js","sourceRoot":"","sources":["../../../src/api-client-error.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,cAAe,SAAQ,KAAK;IACD;IAAtC,YAAY,OAAe,EAAW,OAAe,KAAK;QACxD,KAAK,CAAC,OAAO,CAAC,CAAC;QADqB,SAAI,GAAJ,IAAI,CAAgB;QAExD,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF"}