source: Klonkt/src/server.js@ 6be57b4

main
Last change on this file since 6be57b4 was 6be57b4, checked in by roboburr <roboburr@…>, 3 months ago

Embeddable player (premium feature #7)

Standalone /embed page (no shell) with a compact audio player for the site
tracks, intended for an <iframe> on external sites. The page runs on the klonkt
origin, so audio requests from the iframe remain same-origin -> the
/audio/stream gate lets them through, even on an external site. Helmet's
X-Frame-Options + frame-ancestors are overridden per route (frame-ancestors *)
so external embedding is allowed.

  • routes/embed.js (premium-gated): GET /embed.
  • views/pages/embed-player.ejs: standalone HTML, inline css/js, play/pause, track click, auto-next, progress bar; themable on site.accent.
  • admin-audio: embedUrl + "Embeddable player" section with copyable iframe code + preview link (premium).

node --check passed.

Co-Authored-By: Claude <noreply@…>

  • Property mode set to 100644
File size: 19.3 KB
Line 
1/**
2 * Klonkt Beta — server bootstrap
3 *
4 * Persoonlijk multi-site platform — Node + SQLite + htmx.
5 * Stack: Express + better-sqlite3 + EJS + htmx + ws.
6 */
7
8import 'dotenv/config';
9import express from 'express';
10import helmet from 'helmet';
11import session from 'express-session';
12import bodyParser from 'body-parser';
13import path from 'path';
14import fs from 'fs';
15import { fileURLToPath } from 'url';
16import http from 'http';
17import db, { initializeDatabase } from './config/database.js';
18import { SqliteSessionStore } from './services/SqliteSessionStore.js';
19import { ensurePrimarySite } from './services/ensurePrimarySite.js';
20import PrutterService from './services/PrutterService.js';
21import { WebSocketServer } from 'ws';
22
23import { resolveSite, loadAudioTracks, loadTheme } from './middleware/site.js';
24import { isViewer } from './middleware/auth.js';
25import { renderPage } from './middleware/render.js';
26import authRoutes from './routes/auth.js';
27import accountRoutes from './routes/account.js';
28import adminRoutes from './routes/admin.js';
29import adminAudioRoutes from './routes/admin-audio.js';
30import adminPlaylistsRoutes from './routes/admin-playlists.js';
31import adminSitesRoutes from './routes/admin-sites.js';
32import adminUsersRoutes from './routes/admin-users.js';
33import adminCommentsRoutes from './routes/admin-comments.js';
34import adminSettingsRoutes from './routes/admin-settings.js';
35import adminSeoRoutes from './routes/admin-seo.js';
36import prutterRoutes from './routes/prutter.js';
37import audioRoutes from './routes/audio.js';
38import searchRoutes from './routes/search.js';
39import commentsRoutes from './routes/comments.js';
40import tagsRoutes from './routes/tags.js';
41import typesRoutes from './routes/types.js';
42import usersRoutes from './routes/users.js';
43import feedRoutes from './routes/feed.js';
44import hubRoutes from './routes/hub.js';
45import artistsRoutes from './routes/artists.js';
46import postsRoutes from './routes/posts.js';
47import federationRoutes from './routes/federation.js';
48import { startCircleSyncLoop } from './services/CircleService.js';
49import adminCircleRoutes from './routes/admin-circle.js';
50import adminUpdatesRoutes from './routes/admin-updates.js';
51import adminPatreonRoutes from './routes/admin-patreon.js';
52import adminStatsRoutes from './routes/admin-stats.js';
53import circleRoutes from './routes/circle.js';
54import epkRoutes from './routes/epk.js';
55import newsletterRoutes from './routes/newsletter.js';
56import adminNewsletterRoutes from './routes/admin-newsletter.js';
57import downloadRoutes from './routes/download.js';
58import linkbioRoutes from './routes/linkbio.js';
59import embedRoutes from './routes/embed.js';
60
61if (!process.env.SESSION_SECRET) {
62 console.error('❌ FATAL: SESSION_SECRET is required');
63 process.exit(1);
64}
65
66if (process.env.NODE_ENV === 'production' && process.env.SESSION_SECRET.length < 32) {
67 console.error('❌ FATAL: SESSION_SECRET too weak for production');
68 process.exit(1);
69}
70
71const __dirname = path.dirname(fileURLToPath(import.meta.url));
72const PORT = process.env.PORT || 3000;
73const isDev = process.env.NODE_ENV !== 'production';
74
75const app = express();
76const server = http.createServer(app);
77
78app.use(helmet({
79 contentSecurityPolicy: {
80 directives: {
81 defaultSrc: ["'self'"],
82 scriptSrc: [
83 "'self'",
84 "'unsafe-inline'",
85 // Eigen custom-embeds (embed-player.js) laden de OFFICIELE player-API's
86 // van deze hosts. Zonder deze whitelist blokkeert de CSP ze stil (alleen
87 // een console-fout) en faalt de embed-speler.
88 "https://www.youtube.com", // YouTube IFrame Player API (+ www-widgetapi.js)
89 "https://s.ytimg.com", // YouTube player-assets
90 "https://w.soundcloud.com", // SoundCloud Widget API (api.js)
91 "https://open.spotify.com", // Spotify iFrame API
92 ],
93 // Helmet's default zet script-src-attr op 'none', wat ALLE inline event-
94 // handlers (onchange/onclick/onsubmit) blokkeert — daardoor deed o.a. de
95 // avatar-upload (<input onchange="this.form.submit()">) en de rol-dropdown
96 // niets. We staan inline handlers expliciet toe, consistent met de al
97 // toegestane inline <script> hierboven.
98 scriptSrcAttr: ["'unsafe-inline'"],
99 styleSrc: ["'self'", "'unsafe-inline'"],
100 imgSrc: ["'self'", "data:", "https:"],
101 connectSrc: ["'self'", "wss:", "ws:"],
102 // blob: is required for the audio player — it fetch()es track bytes and
103 // plays from a blob: object URL (Spotify-style). Without blob: here the
104 // CSP silently blocks <audio>.src = blob:… → the player fires 'error' and
105 // auto-skips every track. 'self'/https: do NOT imply blob:.
106 mediaSrc: ["'self'", "https:", "blob:"],
107 fontSrc: ["'self'"],
108 frameSrc: [
109 "'self'",
110 "https://open.spotify.com",
111 "https://w.soundcloud.com",
112 "https://bandcamp.com",
113 "https://embed.music.apple.com",
114 "https://www.youtube-nocookie.com",
115 "https://www.youtube.com", // YouTube IFrame API maakt soms een www.youtube.com-iframe
116 "https://player.vimeo.com",
117 ],
118 },
119 },
120 hsts: { maxAge: 31536000, includeSubDomains: true, preload: true },
121 frameguard: { action: 'sameorigin' },
122 referrerPolicy: { policy: 'no-referrer-when-downgrade' },
123}));
124
125app.set('view engine', 'ejs');
126app.set('views', path.join(__dirname, 'views'));
127
128app.use(bodyParser.urlencoded({ extended: true, limit: '10mb' }));
129app.use(bodyParser.json({ limit: '10mb' }));
130
131// Trust one upstream proxy in production. NPM (or Caddy / nginx) terminates
132// HTTPS and forwards to us over plain HTTP, setting X-Forwarded-Proto: https.
133// Without this, Express sees req.protocol === 'http' and won't issue secure
134// cookies — sessions never persist past the redirect after login.
135if (!isDev) app.set('trust proxy', 1);
136
137// Schema aanmaken/bijwerken VÓÓR iets de DB aanraakt: de session-store doet
138// bij constructie al een query op de `sessions`-tabel, dus bij een verse
139// install moeten de tabellen eerst bestaan (anders: "no such table: sessions"
140// → crash-loop op de allereerste boot).
141initializeDatabase();
142
143// Vangnet: garandeer dat er altijd een primaire site is (solo/hub/circle).
144// Idempotent — doet niets als er al een site is of nog geen beheerder.
145ensurePrimarySite();
146
147// Session middleware extracted into a variable so the WebSocket upgrade
148// handler can reuse it (it needs req.session to authenticate sockets).
149const sessionMiddleware = session({
150 store: new SqliteSessionStore(),
151 secret: process.env.SESSION_SECRET,
152 resave: false,
153 saveUninitialized: false,
154 name: 'pcms.sid',
155 cookie: {
156 httpOnly: true,
157 secure: !isDev,
158 sameSite: 'lax',
159 maxAge: 30 * 24 * 60 * 60 * 1000,
160 },
161});
162app.use(sessionMiddleware);
163
164app.use('/assets', express.static(path.join(__dirname, 'assets'), { maxAge: isDev ? 0 : '1y' }));
165app.use('/media', express.static(process.env.MEDIA_PATH || './storage/media', {
166 // Publieke media (post-covers, avatars) moet door andere Klonkt-sites in hun
167 // CIRKEL cross-origin embedbaar zijn. Helmet zet standaard CORP=same-origin,
168 // wat die afbeeldingen in de browser blokkeert (bestand komt wél binnen, maar
169 // de browser weigert 'm te tonen). Voor /media dus expliciet cross-origin.
170 setHeaders: (res) => res.setHeader('Cross-Origin-Resource-Policy', 'cross-origin'),
171}));
172
173// (Verwijderd) TWA / digital-asset-links — alleen nodig voor de APK/TWA-variant.
174// Klonkt is PWA-only; geen assetlinks.json meer.
175
176// Cirkels: periodieke achtergrond-sync van remote instances (no-op tenzij tenancy='circle').
177startCircleSyncLoop();
178
179// Bundle HTMX: copy from node_modules into our own assets dir so we can serve
180// it locally (no third-party CDN). Idempotent — only copies if size differs.
181(function ensureLocalHtmx() {
182 const src = path.join(__dirname, '..', 'node_modules', 'htmx.org', 'dist', 'htmx.min.js');
183 const dest = path.join(__dirname, 'assets', 'js', 'htmx.min.js');
184 try {
185 const srcStat = fs.statSync(src);
186 const destStat = fs.existsSync(dest) ? fs.statSync(dest) : null;
187 if (!destStat || destStat.size !== srcStat.size) {
188 fs.copyFileSync(src, dest);
189 console.log(`📦 HTMX bundled locally: ${srcStat.size} bytes`);
190 }
191 } catch (e) {
192 console.warn('⚠️ Could not bundle HTMX:', e.message, '— run `npm install`');
193 }
194})();
195
196// Singleton PrutterService — routes get it via req.app.locals.prutter.
197const prutter = new PrutterService(db);
198app.locals.prutter = prutter;
199
200// Cirkels-federatie: publieke, site-agnostische endpoints (/.klonkt/*).
201// Vóór resolveSite/theme — ze hebben geen site-context nodig.
202app.use(federationRoutes);
203
204app.use(resolveSite);
205app.use(loadAudioTracks);
206app.use(loadTheme);
207
208// Lichtgewicht CSRF-defense: weiger cross-origin state-wijzigende requests.
209// Same-origin forms + HTMX sturen een matchende Origin; ontbreekt Origin dan
210// laten we door (non-browser clients). sameSite:'lax' op de sessiecookie is de
211// tweede laag. (Geldt niet voor GET/HEAD/OPTIONS.)
212app.use((req, res, next) => {
213 if (req.method === 'GET' || req.method === 'HEAD' || req.method === 'OPTIONS') return next();
214 const origin = req.get('origin');
215 if (!origin) return next(); // geen Origin -> geen browser-CSRF-vector
216 let originHost;
217 try { originHost = new URL(origin).host; } catch { return res.status(403).send('Ongeldige origin'); }
218 if (originHost !== req.get('host')) return res.status(403).send('Cross-origin request geweigerd');
219 next();
220});
221
222// Kijker-accounts: alles bekijken mag (incl. Beheer), niets wijzigen. Dit is de
223// ENIGE schrijf-blokkade — fail-closed, vóór alle route-handlers. Elke state-
224// wijzigende methode wordt geweigerd (de login-POST zet de sessie pas ná deze
225// guard, dus die valt er niet onder). I.p.v. rauwe 403-tekst tonen we een nette
226// pagina (of, bij HTMX, een ingeswapte melding).
227app.use((req, res, next) => {
228 const mutating = req.method !== 'GET' && req.method !== 'HEAD' && req.method !== 'OPTIONS';
229 if (mutating && isViewer(req.session?.user)) {
230 if (req.headers['hx-request'] === 'true') {
231 // htmx swapt niet op 4xx; stuur 200 + retarget zodat de melding in #pcms-main verschijnt.
232 res.setHeader('HX-Retarget', '#pcms-main');
233 res.setHeader('HX-Reswap', 'innerHTML');
234 res.status(200);
235 } else {
236 res.status(403);
237 }
238 return renderPage(req, res, 'pages/viewer-blocked', {
239 pageTitle: 'Kijker-modus',
240 bodyClass: 'on-special',
241 });
242 }
243 next();
244});
245
246app.use('/auth', authRoutes);
247app.use('/account', accountRoutes);
248app.use('/admin/audio', adminAudioRoutes);
249app.use('/admin/playlists', adminPlaylistsRoutes);
250app.use('/admin/sites', adminSitesRoutes);
251app.use('/admin/users', adminUsersRoutes);
252app.use('/admin/comments', adminCommentsRoutes);
253app.use('/admin/settings', adminSettingsRoutes);
254app.use('/admin/seo', adminSeoRoutes);
255app.use('/admin/circle', adminCircleRoutes);
256app.use('/admin/updates', adminUpdatesRoutes);
257app.use('/admin/patreon', adminPatreonRoutes);
258app.use('/admin/stats', adminStatsRoutes);
259app.use('/admin/newsletter', adminNewsletterRoutes);
260app.use('/admin', adminRoutes);
261app.use('/prutter', prutterRoutes);
262app.use('/audio', audioRoutes);
263app.use('/search', searchRoutes);
264app.use('/comments', commentsRoutes);
265app.use('/tag', tagsRoutes);
266app.use('/type', typesRoutes);
267app.use('/users', usersRoutes);
268// Feed/sitemap routes are mounted at root because they're at well-known paths
269app.use('/', feedRoutes);
270app.use('/leden', artistsRoutes); // doorzoekbare leden-directory (alleen hub; solo: next())
271app.get('/artiesten', (req, res) => res.redirect(301, req.originalUrl.replace(/^\/artiesten/, '/leden'))); // oude URL -> /leden
272app.use('/', hubRoutes); // hub-overview op '/' (solo: next() -> postsRoutes)
273app.use('/', circleRoutes); // /cirkel-feed (solo/hub: next() -> postsRoutes)
274app.use('/', epkRoutes); // /pers perskit (premium; niet-premium: next() -> 404)
275app.use('/', newsletterRoutes); // /nieuwsbrief in/uitschrijven (premium; niet-premium: next())
276app.use('/', downloadRoutes); // /downloads + /download/:id download-voor-email (premium)
277app.use('/', linkbioRoutes); // /links link-in-bio + klikstats (premium)
278app.use('/', embedRoutes); // /embed inbedbare audiospeler (premium)
279app.use('/', postsRoutes);
280
281app.get('/manifest.webmanifest', (req, res) => {
282 const site = res.locals.site;
283
284 // PWA scope: confines installed apps to ONE site. If a user is in the
285 // bedrijf1 PWA and clicks a link to /sites/bedrijf2/..., the browser will
286 // open it in a regular tab (out-of-scope) instead of within the PWA.
287 // Same applies to APK packaging — the WebView is locked to this scope.
288 //
289 // For path-mounted sites: scope = /sites/<slug>/
290 // For root/subdomain sites: scope = /
291 const base = res.locals.siteUrlBase || ''; // '' or '/sites/<slug>'
292 const scope = (base || '') + '/';
293 const startUrl = (base || '') + '/?source=pwa';
294
295 // A stable identity per site so installs don't collide (Chromium uses `id`).
296 // NB: een id-wissel orphant bestaande PWA-installs (er is geen migratie die een
297 // install over een id-verandering heen tilt) — wie een site al als PWA had,
298 // moet 'm één keer opnieuw installeren. Data blijft server-side, dus niets kwijt.
299 const idBase = site?.slug ? `klonkt-${site.slug}` : 'klonkt';
300
301 res.set('Cache-Control', 'no-cache');
302 res.json({
303 id: idBase,
304 name: site?.title || 'Klonkt',
305 short_name: (site?.title || 'Klonkt').slice(0, 12),
306 description: site?.description || site?.tagline || '',
307 scope,
308 start_url: startUrl,
309 display: 'standalone',
310 display_override: ['standalone', 'minimal-ui'],
311 orientation: 'any',
312 background_color: '#1a1a17',
313 theme_color: site?.accent || '#c2410c',
314 lang: site?.language || 'nl',
315 icons: [
316 { src: '/favicon.svg', sizes: 'any', type: 'image/svg+xml' },
317 { src: '/favicon.ico', sizes: '64x64', type: 'image/x-icon' },
318 ],
319 // Hint to capable browsers: capture all in-scope links inside the PWA
320 capture_links: 'existing-client-navigate',
321 });
322});
323
324// Favicon — served as SVG so it picks up the site's accent color dynamically.
325// Browsers also request /favicon.ico by convention; we serve the same SVG
326// content there with a forgiving content-type since modern browsers accept it.
327function _renderFavicon(res, accent) {
328 const safeAccent = /^#[0-9a-fA-F]{3,8}$/.test(accent) ? accent : '#c2410c';
329 // Site mark: rounded square in the site accent + bold white 'K' (Klonkt)
330 const svg = `<?xml version="1.0" encoding="UTF-8"?>
331<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64">
332 <rect width="64" height="64" rx="14" fill="${safeAccent}"/>
333 <text x="50%" y="50%" dy="0.35em" text-anchor="middle"
334 font-family="Arial, Helvetica, sans-serif"
335 font-size="42" font-weight="800" fill="#fff">K</text>
336</svg>`;
337 res.set('Content-Type', 'image/svg+xml');
338 res.set('Cache-Control', 'public, max-age=86400');
339 res.send(svg);
340}
341
342app.get('/favicon.svg', (req, res) => {
343 _renderFavicon(res, res.locals.site?.accent);
344});
345app.get('/favicon.ico', (req, res) => {
346 // Browsers requesting .ico will accept SVG content; chrome/firefox both fine.
347 // Keeping the route prevents 404 spam in the console.
348 _renderFavicon(res, res.locals.site?.accent);
349});
350
351app.get('/sw.js', (req, res) => {
352 res.set('Content-Type', 'application/javascript');
353 res.set('Cache-Control', 'no-cache');
354 res.send(`
355const CACHE_VERSION = 'pcms-v11-' + new Date().toISOString().split('T')[0];
356self.addEventListener('install', e => {
357 e.waitUntil(caches.open(CACHE_VERSION).then(c => c.addAll(['/'])));
358 self.skipWaiting();
359});
360self.addEventListener('activate', e => {
361 e.waitUntil(caches.keys().then(keys => Promise.all(
362 keys.filter(k => k !== CACHE_VERSION).map(k => caches.delete(k))
363 )));
364 self.clients.claim();
365});
366// ALLEEN navigaties (HTML-pagina's) onderscheppen, voor een offline-fallback.
367// Afbeeldingen, CSS, JS en /media NIET aanraken — laat de browser die native
368// afhandelen. Anders kon een mislukte netwerk-fetch terugvallen op een lege
369// cache-match (undefined) en zo een afbeelding "kapot" maken bij een gewone
370// refresh (hard reload omzeilt de SW en werkte daarom wél).
371self.addEventListener('fetch', e => {
372 if (e.request.method !== 'GET') return;
373 if (e.request.mode !== 'navigate') return; // alleen page-loads
374 e.respondWith(
375 fetch(e.request).catch(() => caches.match('/').then(r => r || Response.error()))
376 );
377});
378 `);
379});
380
381process.on('unhandledRejection', (reason) => {
382 console.error('⚠️ Unhandled Rejection:', reason);
383});
384
385app.use((err, req, res, next) => {
386 console.error('❌ Error:', err);
387 res.status(err.status || 500).send(
388 isDev ? `<pre>${err.stack || err.message}</pre>` : 'Internal Server Error'
389 );
390});
391
392app.use((req, res) => {
393 res.status(404).send(`
394 <div style="font-family:system-ui;max-width:500px;margin:4rem auto;text-align:center;padding:2rem;">
395 <h1 style="font-size:5rem;margin:0;color:#c33;">404</h1>
396 <p>Not found</p>
397 <a href="/" style="color:#c2410c;">← Home</a>
398 </div>
399 `);
400});
401
402// ==================== WebSocket: Prutter real-time ====================
403// Authenticate via the existing session cookie. We reuse sessionMiddleware
404// during the HTTP upgrade so req.session is populated; if no user, abort.
405const wss = new WebSocketServer({ noServer: true });
406
407server.on('upgrade', (req, socket, head) => {
408 if (req.url !== '/ws/prutter') {
409 socket.destroy();
410 return;
411 }
412 // Run session middleware on the upgrade request.
413 // (Express's middleware accepts (req, res, next); we pass a stub res.)
414 const stubRes = { setHeader: () => {}, getHeader: () => undefined, on: () => {}, end: () => {} };
415 sessionMiddleware(req, stubRes, () => {
416 if (!req.session?.user) {
417 socket.write('HTTP/1.1 401 Unauthorized\r\n\r\n');
418 socket.destroy();
419 return;
420 }
421 // Kijker-accounts zijn alleen-lezen: weiger de WS-upgrade. De HTTP-guard
422 // dekt geen WS, dus dit is de plek om schrijven via een (toekomstige)
423 // message-handler te voorkomen.
424 if (isViewer(req.session.user)) {
425 socket.write('HTTP/1.1 403 Forbidden\r\n\r\n');
426 socket.destroy();
427 return;
428 }
429 wss.handleUpgrade(req, socket, head, (ws) => {
430 ws.userId = req.session.user.id;
431 wss.emit('connection', ws, req);
432 });
433 });
434});
435
436wss.on('connection', (ws) => {
437 prutter.addConnection(ws.userId, ws);
438 ws.on('close', () => prutter.removeConnection(ws.userId, ws));
439 ws.on('error', () => prutter.removeConnection(ws.userId, ws));
440 // Optional: ping every 30s to keep connections alive through proxies
441 ws.isAlive = true;
442 ws.on('pong', () => { ws.isAlive = true; });
443});
444const wsPing = setInterval(() => {
445 for (const ws of wss.clients) {
446 if (ws.isAlive === false) { ws.terminate(); continue; }
447 ws.isAlive = false;
448 try { ws.ping(); } catch {}
449 }
450}, 30000);
451if (wsPing.unref) wsPing.unref();
452
453server.listen(PORT, () => {
454 console.log('');
455 console.log('🪶 Klonkt Beta');
456 console.log(` http://localhost:${PORT}`);
457 console.log('');
458 console.log(` ✓ Security: Helmet, CSP, secure sessions`);
459 console.log(` ✓ Privacy: Self-hosted fonts, no third-party requests`);
460 console.log(` ✓ Layout: v9 editorial feel (top nav, profile header)`);
461 console.log(` ✓ Auth: wachtwoord (beheer) + Google (luisteraars) / logout`);
462 console.log(` ✓ Posts: create / edit / view / archive`);
463 console.log(` ✓ Realtime: WebSocket server ready (Prutter)`);
464 console.log('');
465 console.log(` Mode: ${isDev ? 'development' : 'PRODUCTION'}`);
466 console.log('');
467});
468
469export default app;
Note: See TracBrowser for help on using the repository browser.