@kreiseck/kasseneck-api 0.31.0 → 1.0.0-rc.2

package/dist/esm/partner/typen.d.ts

@@ -14,8 +14,12 @@
  * Compilerfehler sein und keine `validation`-Antwort vom Server.
  *
  * **Die Formen sind die der `/v3`** (seit 0.28.0): Feldnamen und Werte, auf
- * die ein Programm verzweigt, sind englisch; Texte fuer Menschen (`message`,
- * `note`, `statusText`, `nextSteps`) bleiben deutsch, die Fehlercodes ebenso.
+ * die ein Programm verzweigt, sind englisch, die Fehlercodes ebenso; Texte fuer
+ * Menschen (`message`, `note`, `statusText`, `nextSteps`) bleiben deutsch.
+ *
+ * Die Listen in GROSSSCHRIFT (`LEGAL_FORMS`, `CONTRACT_KINDS` …) sind die
+ * Zielwerte der Kataloge im Vertrags-Export des Backends
+ * (`fixtures/v3/v3-vokabular.json`, `catalogs`); die Tests halten sie gleich.
  */
 import type { KasseneckSecret } from './secret.js';
 /**
@@ -79,22 +83,19 @@ export interface PartnerInfo {
  * englisch. `/v3` weist die deutschen Werte aus `/v1` (`einzel`, `verein`,
  * `sonstige`) mit `validation` ab, statt sie still zu uebersetzen.
  */
-export type LegalForm = 'sole_proprietor' | 'eu' | 'og' | 'kg' | 'gmbh' | 'gmbhcokg' | 'ag' | 'association' | 'other';
-/** @deprecated Seit 0.28.0 dasselbe wie [LegalForm] (englische Werte der `/v3`). */
-export type Rechtsform = LegalForm;
+export declare const LEGAL_FORMS: readonly ["sole_proprietor", "eu", "og", "kg", "gmbh", "gmbhcokg", "ag", "association", "other"];
+export type LegalForm = typeof LEGAL_FORMS[number];
 /**
  * Bundesland als ISO-3166-2-Code: `AT-1` Burgenland, `AT-2` Kaernten,
  * `AT-3` Niederoesterreich, `AT-4` Oberoesterreich, `AT-5` Salzburg,
  * `AT-6` Steiermark, `AT-7` Tirol, `AT-8` Vorarlberg, `AT-9` Wien.
  */
-export type AustrianState = 'AT-1' | 'AT-2' | 'AT-3' | 'AT-4' | 'AT-5' | 'AT-6' | 'AT-7' | 'AT-8' | 'AT-9';
-/** @deprecated Seit 0.28.0 dasselbe wie [AustrianState] (ISO-Codes der `/v3`). */
-export type Bundesland = AustrianState;
-/** Rolle einer Kontaktperson; `/v1` sagte `geschaeftsfuehrung`, `buchhaltung`, `technik`, `kasse`. */
-export type ContactRole = 'management' | 'accounting' | 'technical' | 'pos';
-/** @deprecated Seit 0.28.0 dasselbe wie [ContactRole] (englische Werte der `/v3`). */
-export type KontaktRolle = ContactRole;
-export interface BetriebAdresse {
+export declare const AUSTRIAN_STATES: readonly ["AT-1", "AT-2", "AT-3", "AT-4", "AT-5", "AT-6", "AT-7", "AT-8", "AT-9"];
+export type AustrianState = typeof AUSTRIAN_STATES[number];
+/** Rollen einer Kontaktperson; `/v1` sagte `geschaeftsfuehrung`, `buchhaltung`, `technik`, `kasse`. */
+export declare const CONTACT_ROLES: readonly ["management", "accounting", "technical", "pos"];
+export type ContactRole = typeof CONTACT_ROLES[number];
+export interface BusinessAddress {
     street: string;
     /** Hausnummer, kurz und alphanumerisch: `49`, `12a`, `49/5`. */
     number?: string;
@@ -102,7 +103,7 @@ export interface BetriebAdresse {
     zip: string;
     city: string;
 }
-export interface BetriebSteuer {
+export interface BusinessTaxDetails {
     /** Steuernummer im Format `12-345/6789`; die Pruefziffer wird geprueft. */
     taxNumber: string;
     smallBusiness: boolean;
@@ -114,13 +115,13 @@ export interface BetriebSteuer {
     /** GLN, 13 Ziffern. */
     gln?: string;
 }
-export interface BetriebKontakt {
+export interface BusinessContact {
     name: string;
     email: string;
     phone?: string;
     roles?: ContactRole[];
 }
-export interface BetriebSteuerberater {
+export interface BusinessTaxAdvisor {
     name: string;
     email: string;
     phone: string;
@@ -135,21 +136,21 @@ export interface BetriebSteuerberater {
  * **Genau diese Felder, kein weiteres.** Das Backend weist ein unbekanntes
  * Feld ab, statt es stillschweigend zu verwerfen, und nennt seinen vollen
  * Pfad (`address.land`, `contacts.0.rolle`). Deshalb hat dieser Typ dieselbe
- * Liste wie `partner-core.BETRIEB_FELDER` — ein ueberzaehliges Feld ist hier
+ * Liste wie `partner-core.BETRIEB_FELDER`: ein ueberzaehliges Feld ist hier
  * ein Compilerfehler und nicht erst eine Antwort vom Server. Fuer Daten, die
  * nicht durch die Typpruefung kommen (Datenbank, Formular), beantwortet
- * [unbekannteBetriebsfelder] dieselbe Frage zur Laufzeit.
+ * [unknownBusinessFields] dieselbe Frage zur Laufzeit.
  */
-export interface Betrieb {
+export interface Business {
     companyName: string;
     legalForm: LegalForm;
     /** Anmeldung des Betriebs im Kasseneck-Panel; darf dort noch keinen Zugang haben. */
     email: string;
-    address: BetriebAdresse;
+    address: BusinessAddress;
     state: AustrianState;
-    taxDetails: BetriebSteuer;
+    taxDetails: BusinessTaxDetails;
     /** Mindestens einer, hoechstens zehn. */
-    contacts: BetriebKontakt[];
+    contacts: BusinessContact[];
     billingEmail?: string;
     /** Firmenbuchnummer, z. B. `FN 123456 a`. */
     companyRegister?: string;
@@ -158,11 +159,11 @@ export interface Betrieb {
     web?: string;
     phone?: string;
     industry?: string;
-    taxAdvisor?: BetriebSteuerberater;
+    taxAdvisor?: BusinessTaxAdvisor;
 }
 export interface CreateCustomerOptions {
     appId: string;
-    business: Betrieb;
+    business: Business;
     /**
      * Eigener Schluessel gegen Doppelanlage, hoechstens 120 Zeichen. Derselbe
      * Schluessel liefert die gespeicherte Antwort zurueck — auch bei abweichendem
@@ -197,9 +198,10 @@ export interface CreateCustomerOptions {
      */
     env?: PartnerEnv;
 }
-export type KundenStatus = 'created' | 'fon_configured' | 'signature_requested' | 'signature_ready' | 'cashregister_created' | 'live' | 'blocked' | (string & {});
-/** Abrechnungsrhythmus eines Entgelts; `/v1` sagte `monat`, `jahr`, `einmal`. */
-export type FeeInterval = 'monthly' | 'yearly' | 'once';
+export type PartnerCustomerStatus = 'created' | 'fon_configured' | 'signature_requested' | 'signature_ready' | 'cashregister_created' | 'live' | 'blocked' | (string & {});
+/** Abrechnungsrhythmen eines Entgelts; `/v1` sagte `monat`, `jahr`, `einmal`. */
+export declare const FEE_INTERVALS: readonly ["monthly", "yearly", "once"];
+export type FeeInterval = typeof FEE_INTERVALS[number];
 /**
  * Das Entgelt, das mit einem Aufruf gebucht wurde: nur dann in der Antwort,
  * wenn die Konditionen des Partners dafuer einen Preis vorsehen. Unter `/v1`
@@ -214,7 +216,7 @@ export interface PartnerFee {
 }
 export interface CreateCustomerResult {
     customerId: string;
-    status: KundenStatus;
+    status: PartnerCustomerStatus;
     env: PartnerEnv;
     companyName: string;
     appId: string;
@@ -232,7 +234,8 @@ export interface CreateCustomerResult {
  * Wie das Partnerkonto den AVV handhabt; `/v1` sagte `direkt`, `vollmacht`,
  * `unterauftrag`.
  */
-export type AvvMode = 'direct' | 'power_of_attorney' | 'subprocessor';
+export declare const AVV_MODES: readonly ["direct", "power_of_attorney", "subprocessor"];
+export type AvvMode = typeof AVV_MODES[number];
 /**
  * Stand eines Vertrags des Betriebs mit Kasseneck: `pending` (noch nicht
  * bestaetigt), `confirmed`, `outdated` (eine neuere Pflichtfassung ist zu
@@ -245,64 +248,64 @@ export type AvvMode = 'direct' | 'power_of_attorney' | 'subprocessor';
  * `customer.terms_accepted` melden die Bestaetigung. In der Testumgebung sind
  * sie nicht noetig.
  */
-export interface VertragStand {
+export interface ContractStatus {
     status: 'pending' | 'confirmed' | 'outdated' | 'not_required' | (string & {});
     version: string | null;
     confirmedAt: number | null;
 }
 /**
  * Stand des Auftragsverarbeitungsvertrags (AVV, Art. 28 DSGVO). Zusaetzlich zu
- * [VertragStand] der Status `via_partner` (der Partnervertrag deckt den AVV,
+ * [ContractStatus] der Status `via_partner` (der Partnervertrag deckt den AVV,
  * Weg `subprocessor`) und `mode`, der Weg des Partnerkontos.
  */
-export interface AvvStand extends VertragStand {
-    status: VertragStand['status'] | 'via_partner';
+export interface AvvStatus extends ContractStatus {
+    status: ContractStatus['status'] | 'via_partner';
     mode: AvvMode | (string & {}) | null;
 }
 /** FinanzOnline-Stand in der Liste: ist der Link draussen, geoeffnet, der Zugang geprueft? */
-export interface KundenFonStand {
+export interface PartnerCustomerFonStatus {
     configured: boolean;
     linkSentAt: number | null;
     /** Erste Oeffnung; wird mit einem Ersatz-Link zurueckgesetzt. */
     linkOpenedAt: number | null;
 }
-export interface KundenZeile {
+export interface PartnerCustomerSummary {
     customerId: string;
     companyName: string;
-    status: KundenStatus;
+    status: PartnerCustomerStatus;
     appId: string | null;
     env: PartnerEnv;
     createdAt: number | null;
     /** FinanzOnline-Stand; `null`, wenn die Antwort ihn nicht fuehrt. */
-    fon: KundenFonStand | null;
+    fon: PartnerCustomerFonStatus | null;
     /**
      * AVV-Stand; `null`, wenn die Antwort ihn nicht fuehrt. Kein erfundenes
      * `pending`: "nicht mitgeliefert" und "nicht bestaetigt" sind zweierlei.
      */
-    avv: AvvStand | null;
+    avv: AvvStatus | null;
     /** Stand des Nutzungsvertrags; `null`, wenn die Antwort ihn nicht fuehrt. */
-    terms: VertragStand | null;
+    terms: ContractStatus | null;
 }
 export interface ListCustomersOptions {
-    status?: KundenStatus;
+    status?: PartnerCustomerStatus;
     /** 1 bis 200; Vorgabe 50. */
     limit?: number;
     cursor?: string;
 }
-export interface KundenListe {
-    customers: KundenZeile[];
+export interface PartnerCustomerList {
+    customers: PartnerCustomerSummary[];
     /** Weiter mit diesem Wert als `cursor`; `null` heisst: das war alles. */
     cursor: string | null;
     total: number;
 }
-export interface Kunde extends KundenZeile {
+export interface PartnerCustomer extends PartnerCustomerSummary {
     statusAt: number | null;
     liveEnabled: boolean;
     createdAt: number | null;
     createdVia: string | null;
     business: Record<string, unknown>;
     /** In der Einzelsicht zusaetzlich: wann geprueft, an welche (maskierte) Adresse der Link ging. */
-    fon: KundenFonStand & {
+    fon: PartnerCustomerFonStatus & {
         verifiedAt: number | null;
         linkSentTo: string | null;
     };
@@ -318,33 +321,88 @@ export interface FonLinkResult {
     sentTo: string;
     expiresAt: number;
 }
+/**
+ * Vertragsarten: `avv` (Auftragsverarbeitungsvertrag, Art. 28 DSGVO) und
+ * `terms` (Nutzungsvertrag, unter `/v1` `nutzung`).
+ */
+export declare const CONTRACT_KINDS: readonly ["avv", "terms"];
+export type ContractKind = typeof CONTRACT_KINDS[number];
+/**
+ * Wo der Betrieb bestaetigt hat. Unter `v1` hiessen die ersten fuenf
+ * `einrichten`, `prozess`, `partner_vollmacht`, `admin_papier`,
+ * `papier_upload`; `app` und `portal` sind in beiden Sprachen gleich.
+ */
+export declare const CONTRACT_SOURCES: readonly ["setup_link", "process_link", "partner_power_of_attorney", "admin_paper", "paper_upload", "app", "portal"];
+/** Offen fuer spaeter ergaenzte Wege, siehe [CONTRACT_SOURCES]. */
+export type ContractSource = typeof CONTRACT_SOURCES[number] | (string & {});
+/**
+ * Meldung einer Zustimmung, die der Partner **in Vollmacht** fuer den Betrieb
+ * eingeholt hat (`reportCustomerContract`).
+ *
+ * Geht nur, wenn das Partnerkonto auf dem Vollmachtsweg steht
+ * (`mode_not_allowed`) und sein Partnervertrag das Vollmachtskapitel traegt
+ * (`power_of_attorney_missing`). Der Vollmachtsweg nimmt nur `kind: 'avv'`;
+ * `terms` beantwortet der Server mit `kind_not_allowed`.
+ */
+export interface ReportCustomerContractOptions {
+    customerId: string;
+    kind: ContractKind;
+    /** Die Fassung, der zugestimmt wurde; muss die geltende sein. */
+    version: string;
+    /**
+     * Pruefsumme des gezeigten Vertragstexts. Weicht sie von der geltenden ab,
+     * kommt `text_changed` mit der geltenden in `data.textHash`.
+     */
+    textHash: string;
+    /** Wer zugestimmt hat. */
+    name: string;
+    /** In welcher Funktion (z. B. Inhaberin, Geschaeftsfuehrer); unter `/v1` `funktion`. */
+    signerRole: string;
+    /**
+     * Zeitpunkt der Zustimmung in Unix-Millisekunden; ohne Angabe gilt der
+     * Eingang beim Server. Nicht in der Zukunft, nicht aelter als ein Jahr.
+     */
+    acceptedAt?: number;
+}
+export interface ReportCustomerContractResult {
+    /** Kennung des Vertragsdatensatzes; unter `/v1` `vertragId`. */
+    contractId: string;
+    /** Unix-Millisekunden; unter `/v1` `bestaetigtAt`. */
+    confirmedAt: number | null;
+    kind: ContractKind | (string & {});
+    version: string;
+}
 /**
  * `requested → assigned → registered → ready`. `registered` heisst: die
  * Einheit ist FinanzOnline bekannt; `ready` heisst: sie darf signieren. In der
  * Testumgebung wird ohne `registered` direkt `ready` erreicht.
  */
-export type SignaturAntragStatus = 'requested' | 'assigned' | 'registered' | 'ready' | 'failed' | 'cancelled' | (string & {});
+export type SignatureRequestStatus = 'requested' | 'assigned' | 'registered' | 'ready' | 'failed' | 'cancelled' | (string & {});
 /**
  * Gruende in der Historie eines Signaturantrags. `card_entered` und
  * `finanzonline` hiessen unter `/v1` `karte_eingetragen` und `fon`.
  */
-export type SignatureHistoryReason = 'api' | 'portal' | 'card_entered' | 'finanzonline' | 'automation_off' | 'test_environment' | 'no_stock' | (string & {});
+export declare const SIGNATURE_HISTORY_REASONS: readonly ["api", "portal", "card_entered", "finanzonline", "automation_off", "test_environment", "no_stock"];
+/** Offen fuer spaeter ergaenzte Gruende, siehe [SIGNATURE_HISTORY_REASONS]. */
+export type SignatureHistoryReason = typeof SIGNATURE_HISTORY_REASONS[number] | (string & {});
 /**
- * `error.code` eines Signaturantrags oder einer Signatur (`SignaturAntrag`,
+ * `error.code` eines Signaturantrags oder einer Signatur (`SignatureRequest`,
  * `CustomerSignature`). Hiess unter `/v1` `kunde_nicht_gefunden` /
  * `unvollstaendig` / `fon_fehler`; dieser Client spricht seit 0.28.0 nur noch
  * `/v3` und sieht darum nur die englische Form.
  */
-export type SignatureErrorCode = 'customer_not_found' | 'incomplete' | 'finanzonline_error' | (string & {});
-export interface SignaturHistorieEintrag {
-    from: SignaturAntragStatus | null;
-    to: SignaturAntragStatus;
+export declare const SIGNATURE_ERROR_CODES: readonly ["customer_not_found", "incomplete", "finanzonline_error"];
+/** Offen fuer spaeter ergaenzte Codes, siehe [SIGNATURE_ERROR_CODES]. */
+export type SignatureErrorCode = typeof SIGNATURE_ERROR_CODES[number] | (string & {});
+export interface SignatureHistoryEntry {
+    from: SignatureRequestStatus | null;
+    to: SignatureRequestStatus;
     at: number;
     reason: SignatureHistoryReason | null;
 }
-export interface SignaturAntrag {
+export interface SignatureRequest {
     requestId: string;
-    status: SignaturAntragStatus;
+    status: SignatureRequestStatus;
     statusText: string;
     /** Art der Signatureinheit; heute nur `signature_card`. */
     kind: string;
@@ -358,7 +416,7 @@ export interface SignaturAntrag {
     requestedVia: string | null;
     createdAt: number | null;
     updatedAt: number | null;
-    history: SignaturHistorieEintrag[];
+    history: SignatureHistoryEntry[];
 }
 export interface RequestSignatureOptions {
     /** Art der Signatureinheit; heute nur `signature_card` (Vorgabe). */
@@ -367,7 +425,7 @@ export interface RequestSignatureOptions {
     additional?: boolean;
 }
 export interface RequestSignatureResult {
-    request: SignaturAntrag;
+    request: SignatureRequest;
     /** `true`, wenn schon ein Antrag lief — dann ist es der laufende. */
     replayed: boolean;
     note: string | null;
@@ -381,7 +439,7 @@ export interface RequestSignatureResult {
  */
 export interface CustomerSignature {
     signatureRequestId: string;
-    status: SignaturAntragStatus | 'decommissioned';
+    status: SignatureRequestStatus | 'decommissioned';
     statusText: string;
     inProgress: boolean;
     ready: boolean;
@@ -397,7 +455,7 @@ export interface CustomerSignature {
     createdAt: number | null;
     updatedAt: number | null;
 }
-export interface SignaturStand {
+export interface CustomerSignatureStatus {
     customerId: string;
     /** Die Kurzform: hat der Betrieb ueberhaupt eine brauchbare Signatur? */
     signature: {
@@ -407,29 +465,29 @@ export interface SignaturStand {
     };
     /** Jede Signatur einzeln. */
     signatures: CustomerSignature[];
-    requests: SignaturAntrag[];
+    requests: SignatureRequest[];
     fon: {
         present: boolean;
         verifiedAt: number | null;
     };
 }
 /** Die Schritte der Inbetriebnahme, in dieser Reihenfolge. */
-export type KassenSchritt = 'signature' | 'register_cashregister' | 'start_receipt' | 'transmit_start_receipt' | (string & {});
-export type KassenStatus = 'draft' | 'in_progress' | 'live' | 'failed' | (string & {});
-export interface Kasse {
+export type CashregisterActivationStep = 'signature' | 'register_cashregister' | 'start_receipt' | 'transmit_start_receipt' | (string & {});
+export type CustomerCashregisterStatus = 'draft' | 'in_progress' | 'live' | 'failed' | (string & {});
+export interface CustomerCashregister {
     cashregisterId: string;
     name: string | null;
-    status: KassenStatus;
+    status: CustomerCashregisterStatus;
     statusText: string;
     /** `true`: die Kasse geht von selbst live, sobald die Signatur bereit ist. */
     automatic: boolean;
     /** Der naechste offene Schritt; `null`, wenn die Kasse live ist. */
-    step: KassenSchritt | null;
+    step: CashregisterActivationStep | null;
     stepText: string | null;
-    completedSteps: KassenSchritt[];
+    completedSteps: CashregisterActivationStep[];
     /** Die Schritte, die fuer genau diese Kasse gelten (Testumgebung: weniger). */
     steps: {
-        key: KassenSchritt;
+        key: CashregisterActivationStep;
         text: string;
     }[];
     signatureId: string | null;
@@ -438,7 +496,7 @@ export interface Kasse {
         code: string | null;
         message: string | null;
         rc: string | null;
-        step: KassenSchritt | null;
+        step: CashregisterActivationStep | null;
         at: number | null;
     } | null;
     createdAt: number | null;
@@ -463,23 +521,23 @@ export interface CreateCashregisterOptions {
     signatureRequestId?: string;
 }
 export interface CreateCashregisterResult {
-    cashregister: Kasse;
+    cashregister: CustomerCashregister;
     activation: {
         started: boolean;
         ok: boolean | null;
-        step: KassenSchritt | null;
+        step: CashregisterActivationStep | null;
         /** `signature_not_ready` oder `automation_off`, wenn nicht gestartet wurde. */
         reason: string | null;
     };
 }
 export interface ActivateCashregisterResult {
-    cashregister: Kasse;
+    cashregister: CustomerCashregister;
     /** `true`: die Kasse war schon live, es wurde nichts getan. */
     unchanged: boolean;
 }
-export interface KassenListe {
+export interface CustomerCashregisterList {
     customerId: string;
-    cashregisters: Kasse[];
+    cashregisters: CustomerCashregister[];
     signatureReady: boolean;
 }
 /**

package/dist/esm/partner/typen.js

@@ -14,8 +14,12 @@
  * Compilerfehler sein und keine `validation`-Antwort vom Server.
  *
  * **Die Formen sind die der `/v3`** (seit 0.28.0): Feldnamen und Werte, auf
- * die ein Programm verzweigt, sind englisch; Texte fuer Menschen (`message`,
- * `note`, `statusText`, `nextSteps`) bleiben deutsch, die Fehlercodes ebenso.
+ * die ein Programm verzweigt, sind englisch, die Fehlercodes ebenso; Texte fuer
+ * Menschen (`message`, `note`, `statusText`, `nextSteps`) bleiben deutsch.
+ *
+ * Die Listen in GROSSSCHRIFT (`LEGAL_FORMS`, `CONTRACT_KINDS` …) sind die
+ * Zielwerte der Kataloge im Vertrags-Export des Backends
+ * (`fixtures/v3/v3-vokabular.json`, `catalogs`); die Tests halten sie gleich.
  */
 // ---------------------------------------------------------------------------
 // Partner und Schluessel
@@ -32,3 +36,72 @@ export const PARTNER_ENVS = ['live', 'test'];
  * angelegt.
  */
 export const SCOPE_CREDENTIALS = 'credentials:read';
+// ---------------------------------------------------------------------------
+// Betrieb anlegen
+// ---------------------------------------------------------------------------
+/**
+ * Rechtsform des Betriebs, so wie `/v3` sie schreibt und liest.
+ *
+ * Die oesterreichischen Kurzformen (`eu`, `og`, `kg`, `gmbh`, `gmbhcokg`, `ag`)
+ * bleiben wie sie sind; nur die drei Woerter, die es auf Englisch gibt, sind
+ * englisch. `/v3` weist die deutschen Werte aus `/v1` (`einzel`, `verein`,
+ * `sonstige`) mit `validation` ab, statt sie still zu uebersetzen.
+ */
+export const LEGAL_FORMS = ['sole_proprietor', 'eu', 'og', 'kg', 'gmbh', 'gmbhcokg', 'ag', 'association', 'other'];
+/**
+ * Bundesland als ISO-3166-2-Code: `AT-1` Burgenland, `AT-2` Kaernten,
+ * `AT-3` Niederoesterreich, `AT-4` Oberoesterreich, `AT-5` Salzburg,
+ * `AT-6` Steiermark, `AT-7` Tirol, `AT-8` Vorarlberg, `AT-9` Wien.
+ */
+export const AUSTRIAN_STATES = ['AT-1', 'AT-2', 'AT-3', 'AT-4', 'AT-5', 'AT-6', 'AT-7', 'AT-8', 'AT-9'];
+/** Rollen einer Kontaktperson; `/v1` sagte `geschaeftsfuehrung`, `buchhaltung`, `technik`, `kasse`. */
+export const CONTACT_ROLES = ['management', 'accounting', 'technical', 'pos'];
+/** Abrechnungsrhythmen eines Entgelts; `/v1` sagte `monat`, `jahr`, `einmal`. */
+export const FEE_INTERVALS = ['monthly', 'yearly', 'once'];
+/**
+ * Wie das Partnerkonto den AVV handhabt; `/v1` sagte `direkt`, `vollmacht`,
+ * `unterauftrag`.
+ */
+export const AVV_MODES = ['direct', 'power_of_attorney', 'subprocessor'];
+// ---------------------------------------------------------------------------
+// Vertraege des Betriebs
+// ---------------------------------------------------------------------------
+/**
+ * Vertragsarten: `avv` (Auftragsverarbeitungsvertrag, Art. 28 DSGVO) und
+ * `terms` (Nutzungsvertrag, unter `/v1` `nutzung`).
+ */
+export const CONTRACT_KINDS = ['avv', 'terms'];
+/**
+ * Wo der Betrieb bestaetigt hat. Unter `v1` hiessen die ersten fuenf
+ * `einrichten`, `prozess`, `partner_vollmacht`, `admin_papier`,
+ * `papier_upload`; `app` und `portal` sind in beiden Sprachen gleich.
+ */
+export const CONTRACT_SOURCES = [
+    'setup_link',
+    'process_link',
+    'partner_power_of_attorney',
+    'admin_paper',
+    'paper_upload',
+    'app',
+    'portal',
+];
+/**
+ * Gruende in der Historie eines Signaturantrags. `card_entered` und
+ * `finanzonline` hiessen unter `/v1` `karte_eingetragen` und `fon`.
+ */
+export const SIGNATURE_HISTORY_REASONS = [
+    'api',
+    'portal',
+    'card_entered',
+    'finanzonline',
+    'automation_off',
+    'test_environment',
+    'no_stock',
+];
+/**
+ * `error.code` eines Signaturantrags oder einer Signatur (`SignatureRequest`,
+ * `CustomerSignature`). Hiess unter `/v1` `kunde_nicht_gefunden` /
+ * `unvollstaendig` / `fon_fehler`; dieser Client spricht seit 0.28.0 nur noch
+ * `/v3` und sieht darum nur die englische Form.
+ */
+export const SIGNATURE_ERROR_CODES = ['customer_not_found', 'incomplete', 'finanzonline_error'];

package/dist/esm/partner/webhook-signatur.d.ts

@@ -84,12 +84,12 @@ export interface VerifyWebhookOptions {
  * Ausnahme im Inneren wird zur Ablehnung. Ein Aufrufer, der nur `ok` abfragt,
  * kann damit nichts falsch machen.
  */
-export declare function verifyWebhookSignature(optionen: VerifyWebhookOptions): Promise<WebhookVerifyResult>;
+export declare function verifyWebhookSignature(options: VerifyWebhookOptions): Promise<WebhookVerifyResult>;
 /**
  * Zerlegt den Signaturkopf. `null`, wenn kein brauchbarer Zeitstempel oder gar
  * kein `v1=`-Anteil darin steht.
  */
-export declare function parseSignatureHeader(kopf: string): {
+export declare function parseSignatureHeader(header: string): {
     t: number;
     v1: string[];
 } | null;

package/dist/esm/partner/webhook-signatur.js

@@ -55,30 +55,30 @@ export const WEBHOOK_LIMIT = 10;
  * Ausnahme im Inneren wird zur Ablehnung. Ein Aufrufer, der nur `ok` abfragt,
  * kann damit nichts falsch machen.
  */
-export async function verifyWebhookSignature(optionen) {
+export async function verifyWebhookSignature(options) {
     try {
-        const secrets = (Array.isArray(optionen.secret) ? optionen.secret : [optionen.secret]).filter((s) => typeof s === 'string' && s.length > 0);
+        const secrets = (Array.isArray(options.secret) ? options.secret : [options.secret]).filter((s) => typeof s === 'string' && s.length > 0);
         if (!secrets.length)
             return { ok: false, reason: 'secret-missing' };
-        if (typeof optionen.signatureHeader !== 'string' || !optionen.signatureHeader.trim()) {
+        if (typeof options.signatureHeader !== 'string' || !options.signatureHeader.trim()) {
             return { ok: false, reason: 'header-missing' };
         }
-        const kopf = parseSignatureHeader(optionen.signatureHeader);
+        const kopf = parseSignatureHeader(options.signatureHeader);
         if (kopf === null)
             return { ok: false, reason: 'header-malformed' };
-        if (optionen.body === undefined || optionen.body === null)
+        if (options.body === undefined || options.body === null)
             return { ok: false, reason: 'body-missing' };
-        const jetzt = typeof optionen.nowSec === 'number' && Number.isFinite(optionen.nowSec)
-            ? optionen.nowSec
+        const jetzt = typeof options.nowSec === 'number' && Number.isFinite(options.nowSec)
+            ? options.nowSec
             : Math.floor(Date.now() / 1000);
-        const toleranz = typeof optionen.toleranceSec === 'number' && Number.isFinite(optionen.toleranceSec)
-            ? optionen.toleranceSec
+        const toleranz = typeof options.toleranceSec === 'number' && Number.isFinite(options.toleranceSec)
+            ? options.toleranceSec
             : WEBHOOK_TOLERANCE_SEC;
         // In BEIDE Richtungen: eine vorgehende Uhr auf der Gegenseite darf ein
         // altes Ereignis nicht wieder gueltig machen.
         if (Math.abs(jetzt - kopf.t) > toleranz)
             return { ok: false, reason: 'timestamp-outside-window' };
-        const nachricht = signierteBytes(kopf.t, optionen.body);
+        const nachricht = signierteBytes(kopf.t, options.body);
         for (const secret of secrets) {
             const soll = await hmacSha256(secret, nachricht);
             for (const v1 of kopf.v1) {
@@ -98,8 +98,8 @@ export async function verifyWebhookSignature(optionen) {
  * Zerlegt den Signaturkopf. `null`, wenn kein brauchbarer Zeitstempel oder gar
  * kein `v1=`-Anteil darin steht.
  */
-export function parseSignatureHeader(kopf) {
-    const teile = String(kopf).split(',').map((x) => x.trim());
+export function parseSignatureHeader(header) {
+    const teile = String(header).split(',').map((x) => x.trim());
     const tTeil = teile.find((x) => x.startsWith('t='));
     const v1 = teile.filter((x) => x.startsWith('v1=')).map((x) => x.slice(3));
     if (!tTeil || !v1.length)