Webklar-Kundenbereich/server/services/legalDocs.js

// Dokument-Registry der veroeffentlichten Rechtstexte (je Fassung feste Dateien unter public/rechtliches/):
// Saetze 'analyse' (AVV, Leistungsbeschreibung der Website-Analyse) und 'termine' (Leistungsbeschreibung, AVV und
// Widerrufsbelehrung mit Muster-Widerrufsformular des Terminplaners). analyseLegal.js ist ein duenner Wrapper darum.
// Die Fassung ist der Berliner Kalendertag der Texte (JJJJ-MM-TT); eine ausgelieferte Fassung wird nie ueberschrieben.
import { access, readFile } from 'node:fs/promises'
import { fileURLToPath } from 'node:url'
import { join } from 'node:path'
import { Router } from 'express'
import { config } from '../config.js'

const publicDir = fileURLToPath(new URL('../../public/', import.meta.url))
const VERSION_RE = /^\d{4}-\d{2}-\d{2}$/

/**
 * Dokumente je Satz in Anhangsreihenfolge: slug = Dateiname der HTML-Seite und des PDFs (<slug>-<Fassung>.html|pdf),
 * pdf = Dateiname des Mail-Anhangs (<pdf>-<Fassung>.pdf). config.js baut die Adressen des Terminplaners aus denselben
 * Slugs (config.js darf diese Datei nicht importieren); test/legalDocs.test.js gleicht beide ab.
 */
const SAETZE = {
  analyse: {
    avv: { slug: 'avv-website-analyse', pdf: 'AVV-Website-Analyse' },
    lb: { slug: 'leistungsbeschreibung-website-analyse', pdf: 'Leistungsbeschreibung-Website-Analyse' },
  },
  termine: {
    lb: { slug: 'leistungsbeschreibung-terminplaner', pdf: 'Leistungsbeschreibung-Terminplaner' },
    avv: { slug: 'avv-terminplaner', pdf: 'AVV-Terminplaner' },
    widerruf: { slug: 'widerrufsbelehrung-funktionen', pdf: 'Widerrufsbelehrung-Muster-Widerrufsformular' },
  },
}

/** Satz, dessen Dokumente eine Funktion (Registerschluessel) mit der Bestellung bekommt; News hat keine. */
const FUNKTION_SATZ = { news: null, termine: 'termine' }

/** Aktuelle Fassung je Satz, bei jedem Aufruf aus config gelesen (Tests aendern sie zur Laufzeit). */
const aktuelleFassung = (satz) => (satz === 'analyse' ? config.analyse.avvVersion : config.termine.avvVersion)

function satzDokumente(satz) {
  if (typeof satz !== 'string' || !Object.hasOwn(SAETZE, satz)) throw new Error('Rechtstexte: unbekannter Satz')
  return SAETZE[satz]
}

function pruefeFassung(version) {
  if (!VERSION_RE.test(String(version))) throw new Error('Rechtstexte: ungültige Fassung')
  return String(version)
}

/** Adressen der versionierten HTML-Seiten: { [doc]: '/rechtliches/<slug>-<Fassung>.html' }. */
export function legalPaths(satz, version) {
  const dokumente = satzDokumente(satz)
  const v = pruefeFassung(version)
  return Object.fromEntries(Object.entries(dokumente).map(([doc, d]) => [doc, `/rechtliches/${d.slug}-${v}.html`]))
}

/** PDF je Dokument: { [doc]: { filename (Anhangsname), path (Datei unter public/rechtliches/) } }. */
export function legalPdfFiles(satz, version) {
  const dokumente = satzDokumente(satz)
  const v = pruefeFassung(version)
  return Object.fromEntries(
    Object.entries(dokumente).map(([doc, d]) => [doc, { filename: `${d.pdf}-${v}.pdf`, path: join(publicDir, 'rechtliches', `${d.slug}-${v}.pdf`) }])
  )
}

/**
 * PDFs als Mail-Anhaenge in der Reihenfolge des Satzes (termine: lb, avv, widerruf; analyse: avv, lb); wirft, wenn eine
 * Datei fehlt oder nicht lesbar ist. ohne: Dokumente, die nicht angehaengt werden (sie muessen nicht vorhanden sein).
 */
export async function legalPdfAttachments(satz, version, { ohne = [] } = {}) {
  const dateien = legalPdfFiles(satz, version)
  for (const doc of ohne) {
    if (!Object.hasOwn(dateien, doc)) throw new Error('Rechtstexte: unbekanntes Dokument')
  }
  return Promise.all(
    Object.entries(dateien)
      .filter(([doc]) => !ohne.includes(doc))
      .map(async ([, f]) => ({ filename: f.filename, content: await readFile(f.path), contentType: 'application/pdf' }))
  )
}

function funktionSatz(featureKey) {
  if (typeof featureKey !== 'string' || !Object.hasOwn(FUNKTION_SATZ, featureKey)) throw new Error('Rechtstexte: unbekannte Funktion')
  return FUNKTION_SATZ[featureKey]
}

/**
 * Anhaenge der Bestellmail einer Funktion in der aktuellen Fassung: termine => Satz 'termine', news => []. Wirft bei
 * unbekannter Funktion und bei fehlender Datei (der Aufrufer entscheidet, was dann geschieht).
 */
export async function featureLegalAttachments(featureKey, opts) {
  const satz = funktionSatz(featureKey)
  return satz ? legalPdfAttachments(satz, aktuelleFassung(satz), opts) : []
}

/**
 * true, wenn alle Rechtsdokumente der Funktion in der aktuellen Fassung vorliegen: HTML-Seiten (die die Bestellseite
 * verlinkt) und PDFs (die Mail anhaengt). Unbekannte Funktion und jeder Lesefehler: false (fail-closed).
 */
export async function featureLegalReady(featureKey) {
  try {
    const satz = funktionSatz(featureKey)
    if (!satz) return true
    const v = aktuelleFassung(satz)
    await Promise.all(Object.values(legalPaths(satz, v)).map((adresse) => access(join(publicDir, adresse))))
    await legalPdfAttachments(satz, v)
    return true
  } catch {
    return false
  }
}

/**
 * Adressen ohne Fassung (/rechtliches/<slug>.html) liefern die Datei der aktuellen Fassung aus config. Nur fuer
 * Menschen und die WOMS-Karten: keine Mail und kein Zustimmungstext darf sie verlinken, denn sie aendern sich mit der
 * Fassung. Gehoert vor express.static; fehlt die Datei, geht die Anfrage weiter (404). saetze: welche Saetze bedient
 * werden, dir: Verzeichnis der Dateien (Standard public/rechtliches, Tests uebergeben ein eigenes).
 */
export function legalRouter({ saetze = Object.keys(SAETZE), dir = join(publicDir, 'rechtliches') } = {}) {
  const router = Router()
  for (const satz of saetze) {
    for (const d of Object.values(satzDokumente(satz))) {
      router.get(`/${d.slug}.html`, (_req, res, next) => {
        const datei = join(dir, `${d.slug}-${pruefeFassung(aktuelleFassung(satz))}.html`)
        res.sendFile(datei, (err) => err && next(err.code === 'ENOENT' ? undefined : err))
      })
    }
  }
  return router
}