@ozdao/scriptorium 0.0.0-stage → 0.1.1

package/src/server.js

@@ -0,0 +1,59 @@
+// Сервер сайта документации: express + статика. Порт слушает раннер martyrs
+// (builder/start.js), SSR-рендер страниц он же вешает поверх этого приложения.
+// Env и резолв-хуки уже стоят: register выполняет bin/scriptorium.js до этого файла.
+// Грузится в node без сборки, поэтому импорты только относительные: хуки martyrs
+// ведут '@/' в src/ корня приложения (documentation/src), которого нет.
+import path from 'node:path';
+import http from 'node:http';
+import { fileURLToPath } from 'node:url';
+import express from 'express';
+import cookies from 'cookie-parser';
+
+import { docs_dir, loadSiteConfig } from './content/scan.js';
+
+// Статика пакета: favicon по умолчанию.
+const package_public = fileURLToPath(new URL('../public', import.meta.url));
+
+const createServer = async () => {
+  const site_config = await loadSiteConfig();
+
+  const app = express();
+
+  app.set('trust proxy', 'loopback');
+  app.use(cookies());
+
+  // Тема по умолчанию (config.appearance) — через ту же cookie theme, по которой
+  // рендерер martyrs (vue-app-renderer.js) ставит data-theme на <html> уже в
+  // SSR-ответе: страница приходит в нужной теме, без мигания. Выбор читателя —
+  // его cookie, она сильнее умолчания. 'auto' — без умолчания: тема системы.
+  if (site_config.appearance !== 'auto') {
+    app.use((req, res, next) => {
+      if (!req.cookies.theme) req.cookies.theme = site_config.appearance;
+      next();
+    });
+  }
+
+  // documentation/public — первой: там генерируемое сборкой (sw.js, спрайт
+  // иконок, шрифты) и своё пользователя, оно перекрывает умолчания пакета.
+  // Папки может не быть — express.static тогда просто пропускает запрос.
+  app.use(express.static(path.join(docs_dir, 'public')));
+  app.use(express.static(package_public));
+
+  const server = http.createServer(app);
+
+  // scriptorium start: SIGTERM (systemd, деплой) — штатный выход с кодом 0,
+  // а не 143. В dev этот файл живёт в воркере бэкенда, сигналы туда не
+  // приходят: остановку ведёт главный поток (builder/dev.js, сообщение close).
+  process.once('SIGTERM', () => {
+    server.close(() => process.exit(0));
+    server.closeAllConnections();
+  });
+
+  return { app, server };
+};
+
+export { createServer };
+
+export default {
+  createServer,
+};