Testclient fase 2, 3 en 5: opdrachtregel, bedieningsvlak en toetsen

De client staat. Een register (owners.json met naam, mnemonic en OwnerId), acht
opdrachten op de opdrachtregel, en een bedieningsvlak op 127.0.0.1:4380 met per
eigenaar de knoppen uit PLAN.md 4b. Start.bat en Start.command erbij op verzoek
van de gebruiker: die draaien npm install als het nodig is, waarschuwen als .env
ontbreekt, openen de browser en houden het venster open bij een fout.

OPEN.md punt 1 is opgelost voordat het een probleem werd. src/probe.js doet de
WebSocket-upgrade met node:http in plaats van met de WebSocket van Node, want
die geeft je bij een weigering een error en geen statuscode. De opdracht klop en
de knop Aankloppen tonen dus 101 of 401, en dat is precies wat de proeven uit
4c moeten kunnen aflezen.

Twee echte fouten gevonden en vastgezet in een toets. De databasemap werd niet
aangemaakt, en omdat better-sqlite3 dat in een worker meldt was het symptoom een
lees die nooit antwoordde. En evolu.insert geeft meteen een id terug maar zet de
schrijfactie in de wachtrij van de worker, dus wie vlak daarna afsluit is de rij
kwijt; schrijf wacht nu op een query erachter en de toets sluit af en heropent.

tests/test_client_register.mjs heeft geen pakketten nodig, want register.js,
argumenten.js en config.js raken Evolu niet aan. Drie mutaties geprobeerd en
alle drie lieten de juiste toets omvallen.

In de browser nagekeken: schrijven en teruglezen werkt vanuit de pagina, de
gegevens zijn dezelfde als die van de opdrachtregel, en licht en donker kloppen.

Alles wat de relay raakt is gebouwd en niets ervan is beproefd; daarvoor wacht
er een RELAY_URL in .env, en die komt van de gebruiker.

Suite: 475 goed, 0 fout over alle negen de toetsen.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

tools/relay-client/src/config.js

@@ -0,0 +1,99 @@
+// ═══════════════════════════════════════════════════════════════════════════════
+//  Waar staat de relay, en waar mogen de gegevens staan.
+//
+//  Het adres van de Umbrel staat NIET in deze repo en hoort daar ook niet in:
+//  dit is een publieke app store, en de .gitignore van de repo-root heeft er een
+//  eigen kopje over. Het komt dus uit de omgeving, met `.env` als de gewone weg
+//  en `.env.sample` als het voorbeeld dat wél in de repo staat.
+//
+//  Geen dotenv-pakket: dat is een afhankelijkheid voor twintig regels, en die
+//  twintig regels zijn hier beter te lezen dan de instellingen van een pakket.
+// ═══════════════════════════════════════════════════════════════════════════════
+
+import { readFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+/** De wortel van dit gereedschap, ongeacht vanwaar het gestart wordt. */
+export const WORTEL = resolve(dirname(fileURLToPath(import.meta.url)), '..');
+
+/**
+ * Leest een `.env`-bestand.
+ *
+ * Regels van de vorm `NAAM=waarde`. Lege regels en regels die met `#` beginnen
+ * worden overgeslagen, en aanhalingstekens om de waarde gaan eraf. Meer niet: wie
+ * hier een regel met een dubbele bodem in zet, krijgt hem letterlijk terug.
+ */
+export const leesEnvBestand = (inhoud) => {
+  const uit = {};
+  for (const regel of inhoud.split(/\r?\n/)) {
+    const kaal = regel.trim();
+    if (kaal === '' || kaal.startsWith('#')) continue;
+    const isGelijk = kaal.indexOf('=');
+    if (isGelijk <= 0) continue;
+    const naam = kaal.slice(0, isGelijk).trim();
+    let waarde = kaal.slice(isGelijk + 1).trim();
+    if (
+      (waarde.startsWith('"') && waarde.endsWith('"') && waarde.length >= 2)
+      || (waarde.startsWith("'") && waarde.endsWith("'") && waarde.length >= 2)
+    ) {
+      waarde = waarde.slice(1, -1);
+    }
+    uit[naam] = waarde;
+  }
+  return uit;
+};
+
+/**
+ * Maakt van een adres een WebSocket-URL, of gooit met uitleg.
+ *
+ * De relay is een WebSocket-server, dus `ws://` of `wss://`. Een `http://` dat
+ * iemand uit de adresbalk plakt wordt omgezet in plaats van geweigerd: dat is
+ * de meest voorkomende vergissing en er is niets dubbelzinnigs aan.
+ *
+ * Wat er wél uitkomt is een adres zonder schema (`umbrel.local:3852`), en dat
+ * krijgt `ws://`. Zonder poort blijft het zoals het is: achter een reverse proxy
+ * met TLS is `wss://host` zonder poort juist de goede vorm.
+ */
+export const naarRelayUrl = (adres) => {
+  if (typeof adres !== 'string' || adres.trim() === '') {
+    throw new Error('Geen relay-adres. Zet RELAY_URL in .env; zie .env.sample.');
+  }
+  const kaal = adres.trim();
+
+  if (kaal.startsWith('ws://') || kaal.startsWith('wss://')) return kaal;
+  if (kaal.startsWith('http://')) return `ws://${kaal.slice('http://'.length)}`;
+  if (kaal.startsWith('https://')) return `wss://${kaal.slice('https://'.length)}`;
+  if (kaal.includes('://')) {
+    throw new Error(`"${kaal}" heeft een schema dat hier niets betekent. Gebruik ws:// of wss://.`);
+  }
+  return `ws://${kaal}`;
+};
+
+/**
+ * De instellingen: eerst de omgeving, dan `.env`, dan de standaardwaarden.
+ *
+ * De omgeving wint van het bestand, zodat je één keer iets anders kunt proberen
+ * zonder het bestand aan te raken.
+ */
+export const leesConfig = ({ env = process.env, wortel = WORTEL } = {}) => {
+  let uitBestand = {};
+  try {
+    uitBestand = leesEnvBestand(readFileSync(join(wortel, '.env'), 'utf8'));
+  } catch (oorzaak) {
+    if (oorzaak.code !== 'ENOENT') throw oorzaak;
+  }
+
+  const haal = (naam) => env[naam] ?? uitBestand[naam];
+
+  const adres = haal('RELAY_URL');
+
+  return {
+    /** Het adres van de relay, of `null` als het er niet is. */
+    relayUrl: adres ? naarRelayUrl(adres) : null,
+    /** Waar het register en de databases staan. */
+    dataDir: resolve(wortel, haal('DATA_DIR') ?? 'data'),
+    /** De poort van het bedieningsvlak. */
+    uiPoort: Number.parseInt(haal('UI_PORT') ?? '4380', 10),
+  };
+};