@kreiseck/kasseneck-api 0.6.45 → 0.7.0

package/dist/cjs/partner/fehler.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Die Fehlercodes der Partner-API und das, was ein Integrator daraufhin tun
+ * muss.
+ *
+ * Das Backend antwortet auf jeden fachlichen Ausgang mit HTTP 200 und legt
+ * seine Entscheidung in `data.code` (siehe `docs/api/partner.md` im Backend).
+ * Der Transport hebt den Code an `KasseneckApiError.code` — hier steht, was er
+ * bedeutet.
+ *
+ * **Warum die Texte hier stehen und nicht nur im Backend:** die Meldung des
+ * Servers sagt, WAS ist. Sie sagt nicht, was der Aufrufer als naechstes tut,
+ * und sie kann es auch nicht — dafuer muesste sie seinen Ablauf kennen. Diese
+ * Datei ist deshalb kein zweiter Abdruck der Doku, sondern die
+ * Handlungsanweisung daneben.
+ *
+ * **Der Katalog ist vollstaendig.** Die Quelle ist `docs/api/fehlercodes.json`
+ * im Backend (Abzug aus `partner-core.FEHLER_KATALOG`); ein Code, den nur eine
+ * Seite kennt, ist fuer einen Aufrufer nicht von „gibt es nicht" zu
+ * unterscheiden. Deshalb stehen hier BEIDE Flaechen: die der Schnittstelle
+ * ([PARTNER_FEHLER_CODES]) und die des Partner-Portals
+ * ([PARTNER_PORTAL_FEHLER_CODES]).
+ */
+/**
+ * Alle Codes, die die **Schnittstelle** kennt. Als Liste und nicht nur als
+ * Typ, damit ein Aufrufer sie zur Laufzeit durchgehen kann (Katalogseite,
+ * Selbsttest der eigenen Fehlerbehandlung).
+ *
+ * Reihenfolge und Bestand wie im Abzug des Backends.
+ */
+export declare const PARTNER_FEHLER_CODES: readonly ["validation", "rate_limited", "app_not_found", "app_not_accepted", "kein_partnerbetrieb", "live_not_allowed", "customer_exists", "customer_conflict", "customer_limit", "zugang_nicht_erlaubt", "email_taken", "no_email", "fon_missing", "signature_pending", "request_not_found", "signature_missing", "signature_unknown", "signature_ambiguous", "signature_not_ready", "signature_limit", "signature_failed", "module_inactive", "cashregister_limit", "cashregister_not_found", "activation_failed", "webhook_limit", "webhook_inactive", "event_not_subscribed"];
+/**
+ * Die Codes, die nur im **Partner-Portal** entstehen — beim Pflegen der App,
+ * der Schluessel, der Mitglieder und der Signaturkarten.
+ *
+ * Sie stehen hier, obwohl kein Aufruf dieses Clients sie ausloest: der
+ * Fehlerkatalog ist eine Liste, und eine halbe Liste ist schlimmer als keine.
+ * Wer eine Katalogseite baut oder eine fremde Antwort einsortiert, findet
+ * damit jeden Code des Backends wieder.
+ */
+export declare const PARTNER_PORTAL_FEHLER_CODES: readonly ["app_locked", "version_locked", "invalid_transition", "no_accepted_app", "consent", "key_limit", "last_owner", "auth_user_exists", "card_missing", "card_duplicate", "card_not_verified", "already_assigned"];
+export type PartnerFehlerCode = typeof PARTNER_FEHLER_CODES[number];
+export type PartnerPortalFehlerCode = typeof PARTNER_PORTAL_FEHLER_CODES[number];
+/** Ein Code aus einer der beiden Flaechen. */
+export type PartnerCode = PartnerFehlerCode | PartnerPortalFehlerCode;
+export declare function istPartnerFehlerCode(wert: unknown): wert is PartnerFehlerCode;
+export declare function istPartnerPortalFehlerCode(wert: unknown): wert is PartnerPortalFehlerCode;
+/**
+ * Der Handlungssatz zu einem Code — aus beiden Flaechen. `undefined` fuer
+ * einen Code, den dieses Paket nicht kennt; ein erfundener Satz waere
+ * schlimmer als keiner.
+ */
+export declare function partnerFehlerRat(code: string): string | undefined;
+/** Der Fehlercode eines geworfenen Fehlers — `undefined`, wenn es keiner der unseren ist. */
+export declare function partnerFehlerCode(error: unknown): string | undefined;
+/** Kurzform fuer `catch (e) { if (istPartnerFehler(e, 'signature_missing')) … }`. */
+export declare function istPartnerFehler(error: unknown, code: PartnerCode): boolean;
+/** Ein Feldfehler aus `data.errors[]` einer `validation`-Antwort. */
+export interface PartnerFeldFehler {
+    /**
+     * Der Feldpfad, so wie er im gesendeten Betrieb steht — verschachtelt und je
+     * Kontakt: `address.land`, `tax_details.ustid`, `contacts.1.abteilung`.
+     */
+    field: string;
+    message: string;
+}
+/** Die Feldfehler einer `validation`-Antwort; leer, wenn es keine sind. */
+export declare function partnerFeldFehler(error: unknown): PartnerFeldFehler[];
+/**
+ * Wie lange `rate_limited` noch gilt, in Sekunden. `undefined`, wenn der
+ * Fehler kein `rate_limited` ist oder das Backend keine Angabe macht.
+ */
+export declare function partnerWartezeitSek(error: unknown): number | undefined;

package/dist/cjs/partner/fehler.js

@@ -0,0 +1,199 @@
+"use strict";
+/**
+ * Die Fehlercodes der Partner-API und das, was ein Integrator daraufhin tun
+ * muss.
+ *
+ * Das Backend antwortet auf jeden fachlichen Ausgang mit HTTP 200 und legt
+ * seine Entscheidung in `data.code` (siehe `docs/api/partner.md` im Backend).
+ * Der Transport hebt den Code an `KasseneckApiError.code` — hier steht, was er
+ * bedeutet.
+ *
+ * **Warum die Texte hier stehen und nicht nur im Backend:** die Meldung des
+ * Servers sagt, WAS ist. Sie sagt nicht, was der Aufrufer als naechstes tut,
+ * und sie kann es auch nicht — dafuer muesste sie seinen Ablauf kennen. Diese
+ * Datei ist deshalb kein zweiter Abdruck der Doku, sondern die
+ * Handlungsanweisung daneben.
+ *
+ * **Der Katalog ist vollstaendig.** Die Quelle ist `docs/api/fehlercodes.json`
+ * im Backend (Abzug aus `partner-core.FEHLER_KATALOG`); ein Code, den nur eine
+ * Seite kennt, ist fuer einen Aufrufer nicht von „gibt es nicht" zu
+ * unterscheiden. Deshalb stehen hier BEIDE Flaechen: die der Schnittstelle
+ * ([PARTNER_FEHLER_CODES]) und die des Partner-Portals
+ * ([PARTNER_PORTAL_FEHLER_CODES]).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PARTNER_PORTAL_FEHLER_CODES = exports.PARTNER_FEHLER_CODES = void 0;
+exports.istPartnerFehlerCode = istPartnerFehlerCode;
+exports.istPartnerPortalFehlerCode = istPartnerPortalFehlerCode;
+exports.partnerFehlerRat = partnerFehlerRat;
+exports.partnerFehlerCode = partnerFehlerCode;
+exports.istPartnerFehler = istPartnerFehler;
+exports.partnerFeldFehler = partnerFeldFehler;
+exports.partnerWartezeitSek = partnerWartezeitSek;
+const errors_js_1 = require("../client/errors.js");
+/**
+ * Alle Codes, die die **Schnittstelle** kennt. Als Liste und nicht nur als
+ * Typ, damit ein Aufrufer sie zur Laufzeit durchgehen kann (Katalogseite,
+ * Selbsttest der eigenen Fehlerbehandlung).
+ *
+ * Reihenfolge und Bestand wie im Abzug des Backends.
+ */
+exports.PARTNER_FEHLER_CODES = [
+    // Eingabe, Konto und Takt
+    'validation',
+    'rate_limited',
+    'app_not_found',
+    'app_not_accepted',
+    'kein_partnerbetrieb',
+    'live_not_allowed',
+    // Betrieb anlegen
+    'customer_exists',
+    'customer_conflict',
+    'customer_limit',
+    'zugang_nicht_erlaubt',
+    'email_taken',
+    'no_email',
+    // Signatur
+    'fon_missing',
+    'signature_pending',
+    'request_not_found',
+    'signature_missing',
+    'signature_unknown',
+    'signature_ambiguous',
+    'signature_not_ready',
+    'signature_limit',
+    'signature_failed',
+    // Kasse
+    'module_inactive',
+    'cashregister_limit',
+    'cashregister_not_found',
+    'activation_failed',
+    // Webhooks
+    'webhook_limit',
+    'webhook_inactive',
+    'event_not_subscribed',
+];
+/**
+ * Die Codes, die nur im **Partner-Portal** entstehen — beim Pflegen der App,
+ * der Schluessel, der Mitglieder und der Signaturkarten.
+ *
+ * Sie stehen hier, obwohl kein Aufruf dieses Clients sie ausloest: der
+ * Fehlerkatalog ist eine Liste, und eine halbe Liste ist schlimmer als keine.
+ * Wer eine Katalogseite baut oder eine fremde Antwort einsortiert, findet
+ * damit jeden Code des Backends wieder.
+ */
+exports.PARTNER_PORTAL_FEHLER_CODES = [
+    'app_locked',
+    'version_locked',
+    'invalid_transition',
+    'no_accepted_app',
+    'consent',
+    'key_limit',
+    'last_owner',
+    'auth_user_exists',
+    'card_missing',
+    'card_duplicate',
+    'card_not_verified',
+    'already_assigned',
+];
+function istPartnerFehlerCode(wert) {
+    return typeof wert === 'string' && exports.PARTNER_FEHLER_CODES.includes(wert);
+}
+function istPartnerPortalFehlerCode(wert) {
+    return typeof wert === 'string' && exports.PARTNER_PORTAL_FEHLER_CODES.includes(wert);
+}
+/**
+ * Was der Aufrufer tun muss. Ein Satz je Code, in der zweiten Person — nicht
+ * die Wiederholung der Server-Meldung, sondern der naechste Handgriff.
+ *
+ * Jeder Code des Katalogs steht hier; `partner-client.test.ts` haelt das fest.
+ * Ein Code ohne Satz waere schlimmer als ein fehlender Code: er sieht aus wie
+ * behandelt und sagt nichts.
+ */
+const RAT = {
+    // -- Schnittstelle --------------------------------------------------------
+    validation: 'Eingaben pruefen — data.errors nennt Feld und Grund, verschachtelt mit vollem Pfad (address.zip, contacts.0.email). Auch ein UNBEKANNTES Feld ist ein Formfehler: es wird abgewiesen und nicht stillschweigend verworfen. Es wurde nichts angelegt.',
+    rate_limited: 'Zu viele Aufrufe. data.retryAfterSec Sekunden warten und denselben Aufruf wiederholen.',
+    app_not_found: 'Die appId gibt es nicht. getPartnerInfo liefert die eigenen Apps samt id.',
+    app_not_accepted: 'Diese App hat noch keine abgenommene Version. Mit einem pk_test_-Schluessel oder mit env:"test" geht es sofort weiter; live erst nach der Abnahme.',
+    kein_partnerbetrieb: 'Dieser Betrieb gehoert nicht zu diesem Partner-Konto. Die eigenen stehen in listPartnerCustomers.',
+    live_not_allowed: 'Ein Test-Schluessel erzeugt nichts Echtes. Fuer einen Live-Betrieb den Live-Schluessel nehmen — umgekehrt darf ein Live-Schluessel mit env:"test" sehr wohl einen Testbetrieb anlegen.',
+    customer_exists: 'Diesen Betrieb gibt es schon (data.customerId). Mit derselben customerId weiterarbeiten.',
+    customer_conflict: 'Die Steuernummer ist bei Kasseneck bereits registriert. Die Zuordnung zum Partner macht Kasseneck — hello@kasseneck.at.',
+    customer_limit: 'Das Tageslimit fuer neue Betriebe ist erreicht (data.max, data.resetAt). Morgen weiter.',
+    zugang_nicht_erlaubt: 'Fuer dieses Partner-Konto sind Zugaenge zum Kundenpanel nicht freigeschaltet — es entstand NICHTS, auch kein Betrieb. Ohne zugang{invite:true} erneut anlegen oder die Freischaltung erfragen (Stand: getPartnerInfo.partner.canCreateAccess).',
+    email_taken: 'Fuer diese E-Mail gibt es schon einen Kasseneck-Zugang. Eine andere Adresse waehlen, auf die Einladung verzichten oder den Betrieb zuordnen lassen.',
+    no_email: 'Im Konto des Betriebs steht keine E-Mail-Adresse. Ohne sie geht weder eine Einladung noch der FinanzOnline-Link hinaus.',
+    fon_missing: 'Der Betrieb hat noch keinen FinanzOnline-Zugang. sendPartnerCustomerFonLink senden und customer.fon_verified abwarten. Betrifft das ANMELDEN der Signatureinheit, nicht das Beantragen.',
+    signature_pending: 'Fuer diesen Betrieb laeuft bereits ein Antrag. Auf signature.ready warten.',
+    request_not_found: 'Diese signaturId gibt es nicht. getCustomerSignatureStatus nennt die des Betriebs.',
+    signature_missing: 'Der Betrieb hat ueberhaupt keine Signatur, und jede Kasse bezieht sich auf eine. Zuerst requestCustomerSignature.',
+    signature_unknown: 'Die genannte signaturId gehoert nicht zu diesem Betrieb. getCustomerSignatureStatus nennt die seinen.',
+    signature_ambiguous: 'Der Betrieb hat mehrere Signaturen; welche die Kasse benutzt, muss dastehen. Eine aus data.choices als signaturId mitgeben.',
+    signature_not_ready: 'Die Signatur DIESER Kasse ist noch nicht bereit. Auf signature.ready warten; eine mit automatic:true angelegte Kasse geht danach von selbst live.',
+    signature_limit: 'Hoechstens zehn Signaturen je Betrieb. Eine bestehende benutzen, statt mit additional:true eine weitere zu beantragen.',
+    signature_failed: 'FinanzOnline hat die Anmeldung abgelehnt (data.rc). Kasseneck klaert das — hello@kasseneck.at.',
+    module_inactive: 'Das Modul (data.modul) ist fuer diesen Betrieb nicht gebucht. Kasseneck schaltet es frei.',
+    cashregister_limit: 'Hoechstens 20 Registrierkassen je Betrieb. Eine bestehende nutzen.',
+    cashregister_not_found: 'Diese cashregisterId gibt es bei diesem Betrieb nicht.',
+    activation_failed: 'Die Inbetriebnahme blieb an data.step haengen (ggf. data.rc). activateCashregister erneut aufrufen — jeder Schritt ist idempotent, der Lauf setzt an der Bruchstelle an.',
+    webhook_limit: 'Hoechstens 10 Webhook-Endpunkte je Partner. Einen ungenutzten loeschen.',
+    webhook_inactive: 'Der Webhook steht auf active:false. Zuerst aktivieren, dann erneut proben.',
+    event_not_subscribed: 'Der Endpunkt abonniert dieses Ereignis nicht — auch eine Probe bekommt nur, was in seiner events-Liste steht. events erweitern und erneut versuchen.',
+    // -- Partner-Portal -------------------------------------------------------
+    app_locked: 'Name, Verteilungen und Kontakt einer App sind fest, sobald eine Version geprueft wird. Aenderungen daran gehen ueber Kasseneck.',
+    version_locked: 'Diese App-Version wird geprueft oder ist abgenommen. Fuer Aenderungen eine neue Version anlegen.',
+    invalid_transition: 'Dieser Statuswechsel ist nicht vorgesehen. Den geltenden Stand laden und von dort weitergehen.',
+    no_accepted_app: 'Einen Live-Schluessel gibt es erst nach der Abnahme einer App. Bis dahin mit dem pk_test_-Schluessel arbeiten.',
+    consent: 'Der Datenschutzhinweis wurde nicht bestaetigt. Ohne die Bestaetigung entsteht nichts.',
+    key_limit: 'Mehr aktive Schluessel je Umgebung als erlaubt. Zuerst einen widerrufen, dann einen neuen erzeugen.',
+    last_owner: 'Der letzte Inhaber eines Partner-Kontos laesst sich nicht entfernen. Zuerst einen zweiten ernennen.',
+    auth_user_exists: 'Diese E-Mail-Adresse ist bereits einem Konto zugeordnet. Eine andere waehlen.',
+    card_missing: 'Zu diesem Antrag sind noch keine Kartendaten eingetragen.',
+    card_duplicate: 'Diese Seriennummer ist bei Kasseneck schon eingetragen — die Karte ist bereits erfasst.',
+    card_not_verified: 'Die Kartendaten sind noch nicht geprueft. Die Pruefung abwarten (data.request).',
+    already_assigned: 'Fuer diesen Antrag sind bereits Kartendaten eingetragen; ein zweiter Satz ueberschreibt nichts.',
+};
+/**
+ * Der Handlungssatz zu einem Code — aus beiden Flaechen. `undefined` fuer
+ * einen Code, den dieses Paket nicht kennt; ein erfundener Satz waere
+ * schlimmer als keiner.
+ */
+function partnerFehlerRat(code) {
+    return RAT[code];
+}
+/** Der Fehlercode eines geworfenen Fehlers — `undefined`, wenn es keiner der unseren ist. */
+function partnerFehlerCode(error) {
+    return error instanceof errors_js_1.KasseneckApiError ? error.code : undefined;
+}
+/** Kurzform fuer `catch (e) { if (istPartnerFehler(e, 'signature_missing')) … }`. */
+function istPartnerFehler(error, code) {
+    return partnerFehlerCode(error) === code;
+}
+/** Die Feldfehler einer `validation`-Antwort; leer, wenn es keine sind. */
+function partnerFeldFehler(error) {
+    if (!(error instanceof errors_js_1.KasseneckApiError))
+        return [];
+    const roh = error.details['errors'];
+    if (!Array.isArray(roh))
+        return [];
+    const raus = [];
+    for (const eintrag of roh) {
+        if (eintrag === null || typeof eintrag !== 'object')
+            continue;
+        const { field, message } = eintrag;
+        if (typeof field === 'string' && typeof message === 'string')
+            raus.push({ field, message });
+    }
+    return raus;
+}
+/**
+ * Wie lange `rate_limited` noch gilt, in Sekunden. `undefined`, wenn der
+ * Fehler kein `rate_limited` ist oder das Backend keine Angabe macht.
+ */
+function partnerWartezeitSek(error) {
+    if (partnerFehlerCode(error) !== 'rate_limited')
+        return undefined;
+    const wert = error.details['retryAfterSec'];
+    return typeof wert === 'number' && Number.isFinite(wert) && wert >= 0 ? wert : undefined;
+}

package/dist/cjs/partner/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * `@kreiseck/kasseneck-api/partner` — alles, was ein Partner-Softwarehaus
+ * ueber die Kasseneck-Schnittstelle tut.
+ *
+ * Ein eigener Unterpfad und nicht die Wurzel, aus zwei Gruenden: der
+ * Partner-Schluessel gehoert auf einen **Server** (er kann Betriebe anlegen und
+ * deren Geheimnisse holen), und die Kassen-Seite des Pakets soll ihn nicht
+ * versehentlich in ein Browser-Buendel ziehen.
+ *
+ * Die Beschreibung der Endpunkte steht **nicht** hier, sondern in der Referenz
+ * des Backends (`docs/api/partner.md`, kompakt `docs/api/partner.llms.txt`).
+ * Was hier steht, ist die Benutzung dieses Clients.
+ *
+ * Reihenfolge der Kette: [PARTNER_ABLAUF].
+ */
+export { createPartnerApi, type PartnerApi, type PartnerApiOptions } from './api.js';
+export { partnerKeyAuth, partnerKeyEnv, type PartnerKeyAuthOptions } from './auth.js';
+export { PARTNER_ABLAUF, naechsterSchritt, type AblaufSchritt, } from './ablauf.js';
+export { PARTNER_FEHLER_CODES, PARTNER_PORTAL_FEHLER_CODES, istPartnerFehlerCode, istPartnerPortalFehlerCode, istPartnerFehler, partnerFehlerCode, partnerFehlerRat, partnerFeldFehler, partnerWartezeitSek, type PartnerCode, type PartnerFehlerCode, type PartnerPortalFehlerCode, type PartnerFeldFehler, } from './fehler.js';
+export { BETRIEB_FELDER, unbekannteBetriebsfelder, type BetriebFeld, } from './betrieb.js';
+export { KasseneckSecret, SECRET_MASKE } from './secret.js';
+export { getPartnerInfo, createPartnerCustomer, listPartnerCustomers, checkPartnerCustomerEmail, getPartnerCustomer, sendPartnerCustomerFonLink, requestCustomerSignature, getCustomerSignatureStatus, createCustomerCashregister, activateCashregister, listCustomerCashregisters, getCustomerCredentials, } from './endpunkte.js';
+export { createPartnerWebhook, listPartnerWebhooks, rotatePartnerWebhookSecret, updatePartnerWebhook, deletePartnerWebhook, sendPartnerWebhookTest, listPartnerWebhookDeliveries, parseWebhookEvent, istPartnerWebhookEvent, PARTNER_WEBHOOK_EVENTS, WEBHOOK_UMSCHLAG_FELDER, type PartnerWebhookEvent, type PartnerWebhookEventType, type PartnerWebhook, type CreateWebhookOptions, type CreateWebhookResult, type WebhookPatch, type WebhookListe, type WebhookZustellung, type WebhookTestResult, type WebhookEventResult, } from './webhooks.js';
+export { verifyWebhookSignature, parseSignatureHeader, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_EVENT_HEADER, WEBHOOK_DELIVERY_HEADER, WEBHOOK_TOLERANCE_SEC, WEBHOOK_RETRY_PLAN_SEC, WEBHOOK_MAX_ATTEMPTS, WEBHOOK_TIMEOUT_MS, WEBHOOK_LIMIT, type VerifyWebhookOptions, type WebhookVerifyResult, type WebhookVerifyReason, } from './webhook-signatur.js';
+export { PARTNER_ENVS } from './typen.js';
+export type { PartnerEnv, PartnerScope, PartnerApp, PartnerInfo, Rechtsform, Bundesland, KontaktRolle, BetriebAdresse, BetriebSteuer, BetriebKontakt, BetriebSteuerberater, Betrieb, CreateCustomerOptions, CreateCustomerResult, KundenStatus, KundenZeile, AvvStand, ListCustomersOptions, KundenListe, Kunde, FonLinkResult, SignaturAntragStatus, SignaturHistorieEintrag, SignaturAntrag, RequestSignatureResult, SignaturStand, KassenSchritt, KassenStatus, Kasse, CreateCashregisterOptions, CreateCashregisterResult, ActivateCashregisterResult, KassenListe, CustomerCashregisterCredential, CustomerCredentials, } from './typen.js';
+/** `credentials:read` — nicht im Standardsatz, siehe typen.ts. */
+export { SCOPE_CREDENTIALS } from './typen.js';

package/dist/cjs/partner/index.js

@@ -0,0 +1,84 @@
+"use strict";
+/**
+ * `@kreiseck/kasseneck-api/partner` — alles, was ein Partner-Softwarehaus
+ * ueber die Kasseneck-Schnittstelle tut.
+ *
+ * Ein eigener Unterpfad und nicht die Wurzel, aus zwei Gruenden: der
+ * Partner-Schluessel gehoert auf einen **Server** (er kann Betriebe anlegen und
+ * deren Geheimnisse holen), und die Kassen-Seite des Pakets soll ihn nicht
+ * versehentlich in ein Browser-Buendel ziehen.
+ *
+ * Die Beschreibung der Endpunkte steht **nicht** hier, sondern in der Referenz
+ * des Backends (`docs/api/partner.md`, kompakt `docs/api/partner.llms.txt`).
+ * Was hier steht, ist die Benutzung dieses Clients.
+ *
+ * Reihenfolge der Kette: [PARTNER_ABLAUF].
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WEBHOOK_TIMEOUT_MS = exports.WEBHOOK_MAX_ATTEMPTS = exports.WEBHOOK_RETRY_PLAN_SEC = exports.WEBHOOK_TOLERANCE_SEC = exports.WEBHOOK_DELIVERY_HEADER = exports.WEBHOOK_EVENT_HEADER = exports.WEBHOOK_SIGNATURE_HEADER = exports.parseSignatureHeader = exports.verifyWebhookSignature = exports.WEBHOOK_UMSCHLAG_FELDER = exports.PARTNER_WEBHOOK_EVENTS = exports.istPartnerWebhookEvent = exports.parseWebhookEvent = exports.listPartnerWebhookDeliveries = exports.sendPartnerWebhookTest = exports.deletePartnerWebhook = exports.updatePartnerWebhook = exports.rotatePartnerWebhookSecret = exports.listPartnerWebhooks = exports.createPartnerWebhook = exports.getCustomerCredentials = exports.listCustomerCashregisters = exports.activateCashregister = exports.createCustomerCashregister = exports.getCustomerSignatureStatus = exports.requestCustomerSignature = exports.sendPartnerCustomerFonLink = exports.getPartnerCustomer = exports.checkPartnerCustomerEmail = exports.listPartnerCustomers = exports.createPartnerCustomer = exports.getPartnerInfo = exports.SECRET_MASKE = exports.KasseneckSecret = exports.unbekannteBetriebsfelder = exports.BETRIEB_FELDER = exports.partnerWartezeitSek = exports.partnerFeldFehler = exports.partnerFehlerRat = exports.partnerFehlerCode = exports.istPartnerFehler = exports.istPartnerPortalFehlerCode = exports.istPartnerFehlerCode = exports.PARTNER_PORTAL_FEHLER_CODES = exports.PARTNER_FEHLER_CODES = exports.naechsterSchritt = exports.PARTNER_ABLAUF = exports.partnerKeyEnv = exports.partnerKeyAuth = exports.createPartnerApi = void 0;
+exports.SCOPE_CREDENTIALS = exports.PARTNER_ENVS = exports.WEBHOOK_LIMIT = void 0;
+var api_js_1 = require("./api.js");
+Object.defineProperty(exports, "createPartnerApi", { enumerable: true, get: function () { return api_js_1.createPartnerApi; } });
+var auth_js_1 = require("./auth.js");
+Object.defineProperty(exports, "partnerKeyAuth", { enumerable: true, get: function () { return auth_js_1.partnerKeyAuth; } });
+Object.defineProperty(exports, "partnerKeyEnv", { enumerable: true, get: function () { return auth_js_1.partnerKeyEnv; } });
+var ablauf_js_1 = require("./ablauf.js");
+Object.defineProperty(exports, "PARTNER_ABLAUF", { enumerable: true, get: function () { return ablauf_js_1.PARTNER_ABLAUF; } });
+Object.defineProperty(exports, "naechsterSchritt", { enumerable: true, get: function () { return ablauf_js_1.naechsterSchritt; } });
+var fehler_js_1 = require("./fehler.js");
+Object.defineProperty(exports, "PARTNER_FEHLER_CODES", { enumerable: true, get: function () { return fehler_js_1.PARTNER_FEHLER_CODES; } });
+Object.defineProperty(exports, "PARTNER_PORTAL_FEHLER_CODES", { enumerable: true, get: function () { return fehler_js_1.PARTNER_PORTAL_FEHLER_CODES; } });
+Object.defineProperty(exports, "istPartnerFehlerCode", { enumerable: true, get: function () { return fehler_js_1.istPartnerFehlerCode; } });
+Object.defineProperty(exports, "istPartnerPortalFehlerCode", { enumerable: true, get: function () { return fehler_js_1.istPartnerPortalFehlerCode; } });
+Object.defineProperty(exports, "istPartnerFehler", { enumerable: true, get: function () { return fehler_js_1.istPartnerFehler; } });
+Object.defineProperty(exports, "partnerFehlerCode", { enumerable: true, get: function () { return fehler_js_1.partnerFehlerCode; } });
+Object.defineProperty(exports, "partnerFehlerRat", { enumerable: true, get: function () { return fehler_js_1.partnerFehlerRat; } });
+Object.defineProperty(exports, "partnerFeldFehler", { enumerable: true, get: function () { return fehler_js_1.partnerFeldFehler; } });
+Object.defineProperty(exports, "partnerWartezeitSek", { enumerable: true, get: function () { return fehler_js_1.partnerWartezeitSek; } });
+var betrieb_js_1 = require("./betrieb.js");
+Object.defineProperty(exports, "BETRIEB_FELDER", { enumerable: true, get: function () { return betrieb_js_1.BETRIEB_FELDER; } });
+Object.defineProperty(exports, "unbekannteBetriebsfelder", { enumerable: true, get: function () { return betrieb_js_1.unbekannteBetriebsfelder; } });
+var secret_js_1 = require("./secret.js");
+Object.defineProperty(exports, "KasseneckSecret", { enumerable: true, get: function () { return secret_js_1.KasseneckSecret; } });
+Object.defineProperty(exports, "SECRET_MASKE", { enumerable: true, get: function () { return secret_js_1.SECRET_MASKE; } });
+var endpunkte_js_1 = require("./endpunkte.js");
+Object.defineProperty(exports, "getPartnerInfo", { enumerable: true, get: function () { return endpunkte_js_1.getPartnerInfo; } });
+Object.defineProperty(exports, "createPartnerCustomer", { enumerable: true, get: function () { return endpunkte_js_1.createPartnerCustomer; } });
+Object.defineProperty(exports, "listPartnerCustomers", { enumerable: true, get: function () { return endpunkte_js_1.listPartnerCustomers; } });
+Object.defineProperty(exports, "checkPartnerCustomerEmail", { enumerable: true, get: function () { return endpunkte_js_1.checkPartnerCustomerEmail; } });
+Object.defineProperty(exports, "getPartnerCustomer", { enumerable: true, get: function () { return endpunkte_js_1.getPartnerCustomer; } });
+Object.defineProperty(exports, "sendPartnerCustomerFonLink", { enumerable: true, get: function () { return endpunkte_js_1.sendPartnerCustomerFonLink; } });
+Object.defineProperty(exports, "requestCustomerSignature", { enumerable: true, get: function () { return endpunkte_js_1.requestCustomerSignature; } });
+Object.defineProperty(exports, "getCustomerSignatureStatus", { enumerable: true, get: function () { return endpunkte_js_1.getCustomerSignatureStatus; } });
+Object.defineProperty(exports, "createCustomerCashregister", { enumerable: true, get: function () { return endpunkte_js_1.createCustomerCashregister; } });
+Object.defineProperty(exports, "activateCashregister", { enumerable: true, get: function () { return endpunkte_js_1.activateCashregister; } });
+Object.defineProperty(exports, "listCustomerCashregisters", { enumerable: true, get: function () { return endpunkte_js_1.listCustomerCashregisters; } });
+Object.defineProperty(exports, "getCustomerCredentials", { enumerable: true, get: function () { return endpunkte_js_1.getCustomerCredentials; } });
+var webhooks_js_1 = require("./webhooks.js");
+Object.defineProperty(exports, "createPartnerWebhook", { enumerable: true, get: function () { return webhooks_js_1.createPartnerWebhook; } });
+Object.defineProperty(exports, "listPartnerWebhooks", { enumerable: true, get: function () { return webhooks_js_1.listPartnerWebhooks; } });
+Object.defineProperty(exports, "rotatePartnerWebhookSecret", { enumerable: true, get: function () { return webhooks_js_1.rotatePartnerWebhookSecret; } });
+Object.defineProperty(exports, "updatePartnerWebhook", { enumerable: true, get: function () { return webhooks_js_1.updatePartnerWebhook; } });
+Object.defineProperty(exports, "deletePartnerWebhook", { enumerable: true, get: function () { return webhooks_js_1.deletePartnerWebhook; } });
+Object.defineProperty(exports, "sendPartnerWebhookTest", { enumerable: true, get: function () { return webhooks_js_1.sendPartnerWebhookTest; } });
+Object.defineProperty(exports, "listPartnerWebhookDeliveries", { enumerable: true, get: function () { return webhooks_js_1.listPartnerWebhookDeliveries; } });
+Object.defineProperty(exports, "parseWebhookEvent", { enumerable: true, get: function () { return webhooks_js_1.parseWebhookEvent; } });
+Object.defineProperty(exports, "istPartnerWebhookEvent", { enumerable: true, get: function () { return webhooks_js_1.istPartnerWebhookEvent; } });
+Object.defineProperty(exports, "PARTNER_WEBHOOK_EVENTS", { enumerable: true, get: function () { return webhooks_js_1.PARTNER_WEBHOOK_EVENTS; } });
+Object.defineProperty(exports, "WEBHOOK_UMSCHLAG_FELDER", { enumerable: true, get: function () { return webhooks_js_1.WEBHOOK_UMSCHLAG_FELDER; } });
+var webhook_signatur_js_1 = require("./webhook-signatur.js");
+Object.defineProperty(exports, "verifyWebhookSignature", { enumerable: true, get: function () { return webhook_signatur_js_1.verifyWebhookSignature; } });
+Object.defineProperty(exports, "parseSignatureHeader", { enumerable: true, get: function () { return webhook_signatur_js_1.parseSignatureHeader; } });
+Object.defineProperty(exports, "WEBHOOK_SIGNATURE_HEADER", { enumerable: true, get: function () { return webhook_signatur_js_1.WEBHOOK_SIGNATURE_HEADER; } });
+Object.defineProperty(exports, "WEBHOOK_EVENT_HEADER", { enumerable: true, get: function () { return webhook_signatur_js_1.WEBHOOK_EVENT_HEADER; } });
+Object.defineProperty(exports, "WEBHOOK_DELIVERY_HEADER", { enumerable: true, get: function () { return webhook_signatur_js_1.WEBHOOK_DELIVERY_HEADER; } });
+Object.defineProperty(exports, "WEBHOOK_TOLERANCE_SEC", { enumerable: true, get: function () { return webhook_signatur_js_1.WEBHOOK_TOLERANCE_SEC; } });
+Object.defineProperty(exports, "WEBHOOK_RETRY_PLAN_SEC", { enumerable: true, get: function () { return webhook_signatur_js_1.WEBHOOK_RETRY_PLAN_SEC; } });
+Object.defineProperty(exports, "WEBHOOK_MAX_ATTEMPTS", { enumerable: true, get: function () { return webhook_signatur_js_1.WEBHOOK_MAX_ATTEMPTS; } });
+Object.defineProperty(exports, "WEBHOOK_TIMEOUT_MS", { enumerable: true, get: function () { return webhook_signatur_js_1.WEBHOOK_TIMEOUT_MS; } });
+Object.defineProperty(exports, "WEBHOOK_LIMIT", { enumerable: true, get: function () { return webhook_signatur_js_1.WEBHOOK_LIMIT; } });
+var typen_js_1 = require("./typen.js");
+Object.defineProperty(exports, "PARTNER_ENVS", { enumerable: true, get: function () { return typen_js_1.PARTNER_ENVS; } });
+/** `credentials:read` — nicht im Standardsatz, siehe typen.ts. */
+var typen_js_2 = require("./typen.js");
+Object.defineProperty(exports, "SCOPE_CREDENTIALS", { enumerable: true, get: function () { return typen_js_2.SCOPE_CREDENTIALS; } });

package/dist/cjs/partner/secret.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Ein Geheimnis eines fremden Betriebs — der `api_key` und die Kassen-Token,
+ * die `getCustomerCredentials` liefert.
+ *
+ * **Warum ein eigener Typ und nicht `string`:** diese Werte gehoeren einem
+ * Dritten. Wer sie hat, kann in seinem Namen Belege signieren — und ein Beleg
+ * ist nach RKSV nicht zuruecknehmbar. Ein `string` in einem Antwortobjekt
+ * landet aber genau dort, wo Objekte nun einmal landen: in
+ * `console.log(antwort)`, in `JSON.stringify(antwort)` unter einem Fehler, im
+ * Rumpf eines Fehlerberichts, in einer Mail an den Kunden. Kein einziger
+ * dieser Wege ist boese gemeint, und jeder einzelne gibt den Schluessel weiter.
+ *
+ * Deshalb kommt man hier nur ueber **einen** benannten Weg an den Wert:
+ * [reveal]. Der Name ist mit Absicht so gewaehlt, dass eine Suche nach
+ * `.reveal(` in einer fremden Codebasis genau die Stellen zeigt, an denen ein
+ * Geheimnis das Objekt verlaesst.
+ *
+ * **Wie die Maskierung haelt.** Der Wert liegt in einer `WeakMap` neben dem
+ * Objekt, nicht *im* Objekt: die Instanz hat kein einziges eigenes Feld mit
+ * dem Klartext, und was nicht da ist, kann auch kein Ausgabeweg finden — auch
+ * keiner, den dieses Paket nicht kennt. Die Ueberschreibungen von `toString`,
+ * `toJSON`, `Symbol.toPrimitive` und dem Node-Inspektor kommen **zusaetzlich**,
+ * damit die Maske nicht als `[object Object]` erscheint, sondern als Satz, der
+ * sagt, was fehlt und warum.
+ *
+ * Ein privates Klassenfeld (`#wert`) waere die naheliegende Alternative und
+ * reicht nicht: `util.inspect` zeigt private Felder in neueren Node-Fassungen
+ * an, und ein Fehlerdienst, der ein Objekt tief durchlaeuft, kommt ohnehin nur
+ * an das, was am Objekt haengt. Die WeakMap loest beides auf einmal.
+ */
+/** Wie ein maskiertes Geheimnis in Text erscheint. */
+export declare const SECRET_MASKE = "\u00ABverborgen\u00BB";
+export declare class KasseneckSecret {
+    /**
+     * Wofuer dieses Geheimnis steht (`apiKey`, `cashregisterToken`). Kein
+     * Geheimnis, nur eine Beschriftung — sie steht in der Maske, damit ein
+     * Protokoll erkennen laesst, WELCHER Wert fehlt.
+     */
+    readonly label: string;
+    constructor(label: string, wert: string);
+    /**
+     * Der Klartext. Der einzige Weg heraus — und die Stelle, an der ein
+     * Aufrufer sich entscheidet, das Geheimnis weiterzugeben.
+     *
+     * Verschluesselt speichern. Nie protokollieren, nie in eine Mail, nie in
+     * einen Fehlerbericht.
+     */
+    reveal(): string;
+    /** Ob ueberhaupt ein Wert da ist — ohne ihn anzufassen. */
+    get vorhanden(): boolean;
+    toString(): string;
+    /**
+     * Greift bei `JSON.stringify` — dem Weg, auf dem ein Geheimnis am
+     * unauffaelligsten in ein Protokoll rutscht.
+     */
+    toJSON(): string;
+    /**
+     * Greift bei `` `${geheimnis}` `` und bei `'' + geheimnis`. Ohne diese
+     * Ueberschreibung stuende zwar dasselbe wie in [toString], aber
+     * `Symbol.toPrimitive` hat Vorrang — wer ihn spaeter versehentlich anders
+     * belegt, umgeht die Maske.
+     */
+    [Symbol.toPrimitive](): string;
+}
+/** Baut ein Geheimnis aus einem Antwortfeld; fehlt es, entsteht ein leeres. */
+export declare function alsSecret(label: string, wert: unknown): KasseneckSecret;

package/dist/cjs/partner/secret.js

@@ -0,0 +1,95 @@
+"use strict";
+/**
+ * Ein Geheimnis eines fremden Betriebs — der `api_key` und die Kassen-Token,
+ * die `getCustomerCredentials` liefert.
+ *
+ * **Warum ein eigener Typ und nicht `string`:** diese Werte gehoeren einem
+ * Dritten. Wer sie hat, kann in seinem Namen Belege signieren — und ein Beleg
+ * ist nach RKSV nicht zuruecknehmbar. Ein `string` in einem Antwortobjekt
+ * landet aber genau dort, wo Objekte nun einmal landen: in
+ * `console.log(antwort)`, in `JSON.stringify(antwort)` unter einem Fehler, im
+ * Rumpf eines Fehlerberichts, in einer Mail an den Kunden. Kein einziger
+ * dieser Wege ist boese gemeint, und jeder einzelne gibt den Schluessel weiter.
+ *
+ * Deshalb kommt man hier nur ueber **einen** benannten Weg an den Wert:
+ * [reveal]. Der Name ist mit Absicht so gewaehlt, dass eine Suche nach
+ * `.reveal(` in einer fremden Codebasis genau die Stellen zeigt, an denen ein
+ * Geheimnis das Objekt verlaesst.
+ *
+ * **Wie die Maskierung haelt.** Der Wert liegt in einer `WeakMap` neben dem
+ * Objekt, nicht *im* Objekt: die Instanz hat kein einziges eigenes Feld mit
+ * dem Klartext, und was nicht da ist, kann auch kein Ausgabeweg finden — auch
+ * keiner, den dieses Paket nicht kennt. Die Ueberschreibungen von `toString`,
+ * `toJSON`, `Symbol.toPrimitive` und dem Node-Inspektor kommen **zusaetzlich**,
+ * damit die Maske nicht als `[object Object]` erscheint, sondern als Satz, der
+ * sagt, was fehlt und warum.
+ *
+ * Ein privates Klassenfeld (`#wert`) waere die naheliegende Alternative und
+ * reicht nicht: `util.inspect` zeigt private Felder in neueren Node-Fassungen
+ * an, und ein Fehlerdienst, der ein Objekt tief durchlaeuft, kommt ohnehin nur
+ * an das, was am Objekt haengt. Die WeakMap loest beides auf einmal.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KasseneckSecret = exports.SECRET_MASKE = void 0;
+exports.alsSecret = alsSecret;
+/**
+ * Der Klartext, ausserhalb der Instanz. `WeakMap`, damit ein weggeworfenes
+ * Geheimnis samt Wert eingesammelt werden kann.
+ */
+const werte = new WeakMap();
+/** Wie ein maskiertes Geheimnis in Text erscheint. */
+exports.SECRET_MASKE = '«verborgen»';
+class KasseneckSecret {
+    /**
+     * Wofuer dieses Geheimnis steht (`apiKey`, `cashregisterToken`). Kein
+     * Geheimnis, nur eine Beschriftung — sie steht in der Maske, damit ein
+     * Protokoll erkennen laesst, WELCHER Wert fehlt.
+     */
+    label;
+    constructor(label, wert) {
+        this.label = label;
+        werte.set(this, wert);
+    }
+    /**
+     * Der Klartext. Der einzige Weg heraus — und die Stelle, an der ein
+     * Aufrufer sich entscheidet, das Geheimnis weiterzugeben.
+     *
+     * Verschluesselt speichern. Nie protokollieren, nie in eine Mail, nie in
+     * einen Fehlerbericht.
+     */
+    reveal() {
+        return werte.get(this) ?? '';
+    }
+    /** Ob ueberhaupt ein Wert da ist — ohne ihn anzufassen. */
+    get vorhanden() {
+        return (werte.get(this) ?? '').length > 0;
+    }
+    toString() {
+        return `[${this.label} ${exports.SECRET_MASKE}]`;
+    }
+    /**
+     * Greift bei `JSON.stringify` — dem Weg, auf dem ein Geheimnis am
+     * unauffaelligsten in ein Protokoll rutscht.
+     */
+    toJSON() {
+        return this.toString();
+    }
+    /**
+     * Greift bei `` `${geheimnis}` `` und bei `'' + geheimnis`. Ohne diese
+     * Ueberschreibung stuende zwar dasselbe wie in [toString], aber
+     * `Symbol.toPrimitive` hat Vorrang — wer ihn spaeter versehentlich anders
+     * belegt, umgeht die Maske.
+     */
+    [Symbol.toPrimitive]() {
+        return this.toString();
+    }
+    /** Greift bei `console.log`, `util.inspect` und den meisten Fehlerdiensten. */
+    [Symbol.for('nodejs.util.inspect.custom')]() {
+        return this.toString();
+    }
+}
+exports.KasseneckSecret = KasseneckSecret;
+/** Baut ein Geheimnis aus einem Antwortfeld; fehlt es, entsteht ein leeres. */
+function alsSecret(label, wert) {
+    return new KasseneckSecret(label, typeof wert === 'string' ? wert : '');
+}