pageta/apps/extension/scripts/check.mjs

#!/usr/bin/env node
/**
 * Prüft die Erweiterung, ohne einen Browser zu starten.
 *
 * Eine Erweiterung hat keinen Compiler, der einen beim Tippfehler
 * aufhält — das Ding scheitert sonst erst beim Laden im Browser, mit einer
 * Fehlermeldung in einer Konsole, die niemand offen hat. Diese Prüfungen
 * fangen genau die Fehler, die dabei entstehen:
 *   - Manifest ist kein gültiges JSON / falsche Version
 *   - eine im Manifest genannte Datei fehlt
 *   - eine Berechtigung ist eingeschlichen, die wir bewusst nicht wollen
 *   - eine Skript-Datei hat einen Syntaxfehler
 */

import { readFileSync, writeFileSync, existsSync, mkdirSync, rmSync } from 'node:fs';
import { execFileSync } from 'node:child_process';
import { join, dirname } from 'node:path';
import { fileURLToPath } from 'node:url';

const ROOT = join(dirname(fileURLToPath(import.meta.url)), '..');
const fehler = [];
const ok = (msg) => console.log(`  ✓ ${msg}`);

// ─── Manifest ────────────────────────────────────────────────────────
let manifest;
try {
	manifest = JSON.parse(readFileSync(join(ROOT, 'manifest.json'), 'utf8'));
	ok('manifest.json ist gültiges JSON');
} catch (e) {
	console.error(`  ✗ manifest.json: ${e.message}`);
	process.exit(1);
}

if (manifest.manifest_version !== 3) fehler.push('manifest_version muss 3 sein');
else ok('Manifest V3');

for (const feld of ['name', 'version', 'description', 'icons', 'action', 'background']) {
	if (!manifest[feld]) fehler.push(`Feld fehlt: ${feld}`);
}

// ─── Referenzierte Dateien existieren ────────────────────────────────
const referenziert = [
	...Object.values(manifest.icons ?? {}),
	...Object.values(manifest.action?.default_icon ?? {}),
	manifest.background?.service_worker,
	...(manifest.background?.scripts ?? []),
	manifest.options_ui?.page,
].filter(Boolean);

for (const datei of new Set(referenziert)) {
	if (!existsSync(join(ROOT, datei))) fehler.push(`im Manifest genannt, aber nicht da: ${datei}`);
}
ok(`${new Set(referenziert).size} referenzierte Dateien vorhanden`);

// ─── Berechtigungen: nur das Nötige ──────────────────────────────────
// Bewusste Liste. Wächst sie, ist das eine Entscheidung — kein Versehen.
// Begründung je Eintrag steht in background.js und README.md.
const ERLAUBT = new Set(['activeTab', 'scripting', 'storage']);
for (const p of manifest.permissions ?? []) {
	if (!ERLAUBT.has(p)) {
		fehler.push(
			`Berechtigung "${p}" ist nicht in der bewussten Liste. ` +
				'Wenn sie wirklich nötig ist: hier eintragen UND in README.md begründen.',
		);
	}
}
// `<all_urls>` als feste host_permission wäre eine dauerhafte Leseerlaubnis
// für jede Seite — genau das, was activeTab vermeidet.
for (const h of manifest.host_permissions ?? []) {
	if (h.includes('*://*/') || h === '<all_urls>') {
		fehler.push(`host_permissions enthält "${h}" — das ist eine dauerhafte Leseerlaubnis.`);
	}
}
ok('Berechtigungen bleiben im vereinbarten Rahmen');

// ─── Geteilte Sammel-Logik: eine Quelle, zwei Kopien ─────────────────
// `page-collector.js` wird von der Web-App (als Bookmarklet-Quelltext) UND
// von hier (via `executeScript`) benutzt. Ein Bundler, der beide bedient,
// existiert nicht — die Erweiterung hat bewusst keinen Build. Also: Kopie,
// aber eine nachweislich gleiche.
const COLLECTOR = 'page-collector.js';
const ORIGINAL = join(ROOT, '..', 'web', 'src', 'lib', COLLECTOR);
const KOPIE = join(ROOT, COLLECTOR);
if (!existsSync(KOPIE)) {
	fehler.push(`${COLLECTOR} fehlt — background.js importiert es.`);
} else if (!existsSync(ORIGINAL)) {
	fehler.push(`Original nicht gefunden: ${ORIGINAL}`);
} else if (readFileSync(ORIGINAL, 'utf8') !== readFileSync(KOPIE, 'utf8')) {
	fehler.push(
		`${COLLECTOR} weicht von apps/web/src/lib/${COLLECTOR} ab. ` +
			`Beide müssen zeichengleich sein: cp apps/web/src/lib/${COLLECTOR} apps/extension/${COLLECTOR}`,
	);
} else {
	ok(`${COLLECTOR} ist deckungsgleich mit der Web-App`);
}

// ─── Skripte parsen ──────────────────────────────────────────────────
// `node --check` parst, ohne auszuführen — Ausführen würde Browser-APIs
// anfassen, die es in Node nicht gibt. Die Kopie mit `.mjs` sorgt dafür,
// dass Node `import`/`export` akzeptiert (die Erweiterung lädt als Modul,
// siehe manifest.background.type).
mkdirSync(join(ROOT, 'dist'), { recursive: true });
for (const datei of ['background.js', 'page-collector.js', 'options.js']) {
	const pfad = join(ROOT, datei);
	if (!existsSync(pfad)) continue;
	const temp = join(ROOT, 'dist', `.syntax-check-${datei}.mjs`);
	try {
		writeFileSync(temp, readFileSync(pfad, 'utf8'));
		execFileSync(process.execPath, ['--check', temp], { stdio: 'pipe' });
		ok(`${datei} parst`);
	} catch (e) {
		fehler.push(`${datei}: ${(e.stderr?.toString() || e.message).trim()}`);
	} finally {
		rmSync(temp, { force: true });
	}
}

if (fehler.length) {
	console.error(`\n${fehler.length} Problem(e):`);
	for (const f of fehler) console.error(`  ✗ ${f}`);
	process.exit(1);
}
console.log('\nErweiterung: grün.');