@foxford/den 3.7.0 → 4.1.0

package/serve/index.js

@@ -13,12 +13,21 @@ import {
   logger
 } from "../chunk-TPBI6TOU.js";
 import {
-  __async
+  closeHttpServer,
+  clusterMetrics,
+  getProcessMetrics,
+  isOpsPath,
+  startOpsServer
+} from "../chunk-A2CYL5LY.js";
+import {
+  __async,
+  __spreadProps,
+  __spreadValues
 } from "../chunk-6FNC3XMI.js";
 
 // src/serve/index.ts
 import Fastify from "fastify";
-import { log as log2 } from "@foxford/logger";
+import { log as log4 } from "@foxford/logger";
 
 // src/serve/assets.ts
 import { createReadStream, existsSync, statSync } from "fs";
@@ -79,7 +88,7 @@ function matchClaim(app, pathname) {
   }
   return (_b = (_a = matchRoute(app.routes, pathname)) == null ? void 0 : _a.params) != null ? _b : null;
 }
-function browserContext(req) {
+function requestContextOf(req, fromBody) {
   const headers = {};
   const forwarded = {
     "accept-language": req.headers["x-forwarded-accept-language"],
@@ -91,22 +100,32 @@ function browserContext(req) {
     }
   }
   const cookie = req.headers.cookie;
-  if (typeof cookie === "string" && cookie !== "") {
-    headers.cookie = cookie;
+  const backendHeaders = __spreadValues(__spreadValues({}, typeof cookie === "string" && cookie !== "" ? { cookie } : {}), fromBody);
+  return { backendHeaders, cookies: parseCookieHeader(cookie), headers };
+}
+function backendHeadersOf(value) {
+  if (value === void 0) {
+    return void 0;
   }
-  return { cookies: parseCookieHeader(cookie), headers };
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    return "invalid";
+  }
+  const entries = Object.entries(value);
+  if (entries.some(([, single]) => typeof single !== "string")) {
+    return "invalid";
+  }
+  return Object.fromEntries(entries.map(([name, single]) => [name.toLowerCase(), single]));
 }
 var appPlugin = (instance, options) => {
   var _a, _b;
   const { app, slowRenderMs = DEFAULT_SLOW_RENDER_MS } = options;
   const appLog = (_a = log.getLogger(app.name)) != null ? _a : logger;
   const serveLog = (_b = appLog.getLogger("serve")) != null ? _b : appLog;
-  instance.get("/_health", () => "ok");
   instance.get("/_routes", (_req, reply) => {
     void reply.header("cache-control", "no-store");
     return claim(app);
   });
-  function handleRender(req, reply, target, inputs) {
+  function handleRender(req, reply, target, inputs, rawBackendHeaders) {
     return __async(this, null, function* () {
       if (typeof target !== "string" || !target.startsWith("/")) {
         return reply.code(400).send({ error: "\u043D\u0435 \u043F\u0435\u0440\u0435\u0434\u0430\u043D \u0438\u043B\u0438 \u043D\u0435\u0432\u0430\u043B\u0438\u0434\u0435\u043D \u043F\u0430\u0440\u0430\u043C\u0435\u0442\u0440 url" });
@@ -114,6 +133,10 @@ var appPlugin = (instance, options) => {
       if (inputs !== void 0 && (typeof inputs !== "object" || inputs === null || Array.isArray(inputs))) {
         return reply.code(400).send({ error: "inputs \u0434\u043E\u043B\u0436\u043D\u044B \u0431\u044B\u0442\u044C \u043E\u0431\u044A\u0435\u043A\u0442\u043E\u043C \u043F\u043E \u043A\u043B\u044E\u0447\u0443 token.description" });
       }
+      const backendHeaders = backendHeadersOf(rawBackendHeaders);
+      if (backendHeaders === "invalid") {
+        return reply.code(400).send({ error: "backendHeaders \u0434\u043E\u043B\u0436\u043D\u044B \u0431\u044B\u0442\u044C \u043E\u0431\u044A\u0435\u043A\u0442\u043E\u043C \xAB\u0438\u043C\u044F \u0437\u0430\u0433\u043E\u043B\u043E\u0432\u043A\u0430 \u2192 \u0441\u0442\u0440\u043E\u043A\u0430\xBB" });
+      }
       const { pathname, search } = new URL(target, "http://localhost");
       const params = matchClaim(app, pathname);
       if (params === null) {
@@ -123,7 +146,7 @@ var appPlugin = (instance, options) => {
       const startedAt = Date.now();
       try {
         const result = yield renderApp(app, {
-          context: browserContext(req),
+          context: requestContextOf(req, backendHeaders),
           inputs,
           params,
           pathname,
@@ -140,12 +163,15 @@ var appPlugin = (instance, options) => {
       }
     });
   }
-  instance.get("/_render", (req, reply) => handleRender(req, reply, req.query.url, void 0));
+  instance.get(
+    "/_render",
+    (req, reply) => handleRender(req, reply, req.query.url, void 0, void 0)
+  );
   instance.route({
     handler: (req, reply) => {
       var _a2;
       const body = (_a2 = req.body) != null ? _a2 : {};
-      return handleRender(req, reply, body.url, body.inputs);
+      return handleRender(req, reply, body.url, body.inputs, body.backendHeaders);
     },
     method: "QUERY",
     url: "/_render"
@@ -153,14 +179,235 @@ var appPlugin = (instance, options) => {
   return Promise.resolve();
 };
 
+// src/serve/process.ts
+import cluster from "cluster";
+import { log as log3 } from "@foxford/logger";
+
+// src/serve/worker.ts
+import { log as log2 } from "@foxford/logger";
+var ALIVE = "den:app-worker-alive";
+var SIGNALS = ["SIGTERM", "SIGINT"];
+var SHUTDOWN_MS = 1e4;
+function startWorker(appName, start) {
+  return __async(this, null, function* () {
+    const aggregation = clusterMetrics();
+    const logger2 = log2.getLogger(appName).getLogger("cluster");
+    let timer;
+    let closing;
+    const starting = start();
+    const close = () => {
+      closing != null ? closing : closing = (() => __async(null, null, function* () {
+        clearInterval(timer);
+        try {
+          const instance = yield starting;
+          yield instance.close();
+        } finally {
+          try {
+            if (process.connected) yield aggregation.shutdown();
+          } finally {
+            for (const signal of SIGNALS) process.removeListener(signal, shutdown);
+            process.removeListener("disconnect", shutdown);
+            if (process.connected) process.disconnect();
+          }
+        }
+      }))();
+      return closing;
+    };
+    const shutdown = () => {
+      const deadline = setTimeout(() => process.exit(1), SHUTDOWN_MS);
+      deadline.unref();
+      void close().then(() => process.exit(0)).catch((error) => {
+        logger2.error("\u043E\u0441\u0442\u0430\u043D\u043E\u0432\u043A\u0430 \u0432\u043E\u0440\u043A\u0435\u0440\u0430 \u043D\u0435 \u0437\u0430\u0432\u0435\u0440\u0448\u0438\u043B\u0430\u0441\u044C:", error);
+        process.exit(1);
+      });
+    };
+    for (const signal of SIGNALS) process.on(signal, shutdown);
+    process.once("disconnect", shutdown);
+    try {
+      yield starting;
+      if (!closing) {
+        const notify = () => {
+          var _a;
+          if (process.connected) (_a = process.send) == null ? void 0 : _a.call(process, { type: ALIVE });
+        };
+        timer = setInterval(notify, 2e3);
+        timer.unref();
+        notify();
+      }
+    } catch (error) {
+      yield close().catch(() => void 0);
+      throw error;
+    }
+    return { close };
+  });
+}
+
+// src/serve/process.ts
+var STARTUP_MS = 6e4;
+function startAppProcess(appName, options, start) {
+  return __async(this, null, function* () {
+    var _a;
+    const workers = (_a = options.workers) != null ? _a : 1;
+    if (!Number.isSafeInteger(workers) || workers < 1) {
+      throw new Error("WORKERS must be a positive integer");
+    }
+    if (workers === 1) {
+      const instance = yield start(options);
+      return { close: () => instance.close() };
+    }
+    const metrics = getProcessMetrics();
+    metrics.startRuntime(appName);
+    if (cluster.isWorker) {
+      return startWorker(appName, () => start(__spreadProps(__spreadValues({}, options), { gracefulShutdown: false, ops: false })));
+    }
+    return startPrimary(appName, options, workers);
+  });
+}
+function startPrimary(appName, options, workers) {
+  return __async(this, null, function* () {
+    const aggregation = clusterMetrics();
+    const logger2 = log3.getLogger(appName).getLogger("cluster");
+    const children = /* @__PURE__ */ new Set();
+    const alive = /* @__PURE__ */ new Map();
+    let ops;
+    let closing;
+    let started = false;
+    let resolveReady = () => void 0;
+    let rejectReady = () => void 0;
+    const ready = new Promise((resolve, reject) => {
+      resolveReady = resolve;
+      rejectReady = reject;
+    });
+    void ready.catch(() => void 0);
+    const timeout = setTimeout(() => rejectReady(new Error("Den workers startup timeout")), STARTUP_MS);
+    const onMessage = (worker, message) => {
+      if (children.has(worker) && typeof message === "object" && message !== null && "type" in message && message.type === ALIVE) {
+        alive.set(worker.id, Date.now());
+        if (alive.size === workers) resolveReady();
+      }
+    };
+    const close = () => {
+      closing != null ? closing : closing = (() => __async(null, null, function* () {
+        clearTimeout(timeout);
+        resolveReady();
+        cluster.removeListener("message", onMessage);
+        yield Promise.all([...children].map(stopWorker));
+        if (ops) yield closeHttpServer(ops);
+        yield aggregation.shutdown();
+        for (const signal of SIGNALS) process.removeListener(signal, shutdown);
+      }))();
+      return closing;
+    };
+    const shutdown = () => {
+      void close().then(() => process.exit()).catch((error) => {
+        logger2.error("\u043E\u0441\u0442\u0430\u043D\u043E\u0432\u043A\u0430 \u043A\u043B\u0430\u0441\u0442\u0435\u0440\u0430 \u043D\u0435 \u0437\u0430\u0432\u0435\u0440\u0448\u0438\u043B\u0430\u0441\u044C:", error);
+        process.exit(1);
+      });
+    };
+    const failed = (error) => {
+      if (closing) return;
+      if (!started) {
+        rejectReady(error);
+      } else {
+        logger2.error(error);
+        process.exitCode = 1;
+        shutdown();
+      }
+    };
+    cluster.on("message", onMessage);
+    if (options.gracefulShutdown !== false) {
+      for (const signal of SIGNALS) process.on(signal, shutdown);
+    }
+    try {
+      if (options.ops !== false) {
+        const supplied = options.ops;
+        ops = yield startOpsServer(__spreadProps(__spreadValues({}, supplied), {
+          collect: aggregation.collect,
+          contentType: aggregation.contentType,
+          isLive: () => {
+            var _a;
+            return [...children].some((worker) => {
+              var _a2;
+              return worker.isConnected() && Date.now() - ((_a2 = alive.get(worker.id)) != null ? _a2 : 0) < 1e4;
+            }) && ((_a = supplied == null ? void 0 : supplied.isLive) == null ? void 0 : _a.call(supplied)) !== false;
+          }
+        }));
+      }
+      if (closing) {
+        if (ops) yield closeHttpServer(ops);
+        yield closing;
+        return { close };
+      }
+      for (let i = 0; i < workers; i++) {
+        const worker = cluster.fork();
+        children.add(worker);
+        worker.once("error", failed);
+        worker.once("exit", (code, signal) => {
+          alive.delete(worker.id);
+          failed(new Error(`Den worker ${String(worker.process.pid)} exited (${String(code != null ? code : signal)})`));
+        });
+      }
+      yield ready;
+      started = true;
+      clearTimeout(timeout);
+      if (!closing) logger2.info(`\u0437\u0430\u043F\u0443\u0449\u0435\u043D\u043E \u0432\u043E\u0440\u043A\u0435\u0440\u043E\u0432: ${String(workers)}`);
+      return { close };
+    } catch (error) {
+      yield close();
+      throw error;
+    }
+  });
+}
+function stopWorker(worker) {
+  return __async(this, null, function* () {
+    if (worker.isDead()) return;
+    yield new Promise((resolve) => {
+      const timeout = setTimeout(() => worker.kill("SIGKILL"), SHUTDOWN_MS);
+      worker.once("exit", () => {
+        clearTimeout(timeout);
+        resolve();
+      });
+      worker.kill("SIGTERM");
+    });
+  });
+}
+
 // src/serve/index.ts
+function serveAppProcess(app, options = {}) {
+  return startAppProcess(app.name, options, (serveOptions) => serveApp(app, serveOptions));
+}
 var SHUTDOWN_SIGNALS = ["SIGTERM", "SIGINT"];
 function serveApp(_0) {
   return __async(this, arguments, function* (app, options = {}) {
-    var _a, _b, _c, _d;
-    const appLog = (_a = log2.getLogger(app.name)) != null ? _a : logger;
+    var _a, _b, _c, _d, _e;
+    const appLog = (_a = log4.getLogger(app.name)) != null ? _a : logger;
     const serveLog = (_b = appLog.getLogger("serve")) != null ? _b : appLog;
     const instance = Fastify({ logger: false });
+    const metrics = getProcessMetrics();
+    metrics.startRuntime(app.name);
+    let ops;
+    const shutdown = () => {
+      void instance.close();
+    };
+    instance.addHook("onRequest", (req, reply, done) => {
+      if (isOpsPath(req.url)) {
+        void reply.code(404).send();
+        return;
+      }
+      metrics.trackHttp(req.raw, reply.raw, () => {
+        var _a2;
+        return (_a2 = req.routeOptions.url) != null ? _a2 : "unmatched";
+      });
+      done();
+    });
+    instance.addHook("onClose", () => __async(null, null, function* () {
+      for (const signal of SHUTDOWN_SIGNALS) {
+        process.removeListener(signal, shutdown);
+      }
+      if (ops) {
+        yield closeHttpServer(ops);
+      }
+    }));
     yield instance.register(appPlugin, { app, slowRenderMs: options.slowRenderMs });
     if (options.assets) {
       registerAssets(instance, options.assets);
@@ -174,14 +421,19 @@ function serveApp(_0) {
       serveLog.info(`\u2190 ${String(reply.statusCode)} ${req.method} ${req.url} ${elapsed}\u043C\u0441`);
       done();
     });
-    yield (_c = options.configure) == null ? void 0 : _c.call(options, instance);
-    yield instance.listen({ host: options.host, port: (_d = options.port) != null ? _d : 0 });
+    try {
+      yield (_c = options.configure) == null ? void 0 : _c.call(options, instance);
+      if (options.ops !== false) {
+        ops = yield startOpsServer(options.ops);
+      }
+      yield instance.listen({ host: (_d = options.host) != null ? _d : "0.0.0.0", port: (_e = options.port) != null ? _e : 8080 });
+    } catch (error) {
+      yield instance.close();
+      throw error;
+    }
     if (options.gracefulShutdown !== false) {
       for (const signal of SHUTDOWN_SIGNALS) {
-        process.once(signal, () => {
-          serveLog.info(`${signal}: \u0437\u0430\u043A\u0440\u044B\u0432\u0430\u044E \u0438\u043D\u0441\u0442\u0430\u043D\u0441`);
-          void instance.close();
-        });
+        process.once(signal, shutdown);
       }
     }
     serveLog.info(
@@ -194,5 +446,6 @@ export {
   appPlugin,
   loadAppEnv,
   registerAssets,
-  serveApp
+  serveApp,
+  serveAppProcess
 };

package/{types-BxMQ-VOd.d.cts → types-Ccd5bmt1.d.cts}

@@ -477,14 +477,33 @@ declare class StateRegistry {
 }
 
 /**
- * Контекст HTTP-запроса — заголовки и cookies, переданные сервером.
- * На клиенте содержит пустые объекты.
+ * Реквизиты HTTP-запроса. Три поля отвечают на ТРИ РАЗНЫХ вопроса, и путать их нельзя:
+ * что прислал браузер, чему равна отдельная кука и что предъявлять бэкенду.
+ *
+ * На клиенте заголовков нет, куки берутся из документа, а реквизиты бэкенда подставляет
+ * сам браузер.
  */
 interface RequestContext {
-    /** HTTP-заголовки запроса (в нижнем регистре) */
+    /**
+     * Что прислал БРАУЗЕР: `host`, `accept-language` (в нижнем регистре).
+     *
+     * Читается для решений о рендере — собрать абсолютную ссылку, выбрать язык. Заголовка
+     * `cookie` здесь НЕТ намеренно: собери кто-нибудь по нему запрос — он отправил бы браузерную
+     * куку вместо реквизитов этого запроса, и на первом визите это был бы другой посетитель.
+     * Нужно значение куки — есть `cookies`; нужно сходить в бэкенд — есть `backendHeaders`.
+     */
     headers: Record<string, string>;
-    /** Распарсенные cookies из заголовка Cookie */
+    /** Разобранные куки — чтобы прочитать значение конкретной куки. */
     cookies: Record<string, string>;
+    /**
+     * Что предъявлять БЭКЕНДУ в каждом запросе: `cookie` и то, что бэкенд выдал хосту на
+     * бутстрапе своими заголовками (идентичность посетителя и прочее).
+     *
+     * Один набор на все походы приложения, и собирает его хост — до рендера и один раз.
+     * Навешивает на клиент расширение рантайма `@foxford/den-sdk`, поэтому прикладной код
+     * заголовков не касается вовсе.
+     */
+    backendHeaders?: Record<string, string>;
 }
 /**
  * Результат проверки guard.

package/{types-BxMQ-VOd.d.ts → types-Ccd5bmt1.d.ts}

@@ -477,14 +477,33 @@ declare class StateRegistry {
 }
 
 /**
- * Контекст HTTP-запроса — заголовки и cookies, переданные сервером.
- * На клиенте содержит пустые объекты.
+ * Реквизиты HTTP-запроса. Три поля отвечают на ТРИ РАЗНЫХ вопроса, и путать их нельзя:
+ * что прислал браузер, чему равна отдельная кука и что предъявлять бэкенду.
+ *
+ * На клиенте заголовков нет, куки берутся из документа, а реквизиты бэкенда подставляет
+ * сам браузер.
  */
 interface RequestContext {
-    /** HTTP-заголовки запроса (в нижнем регистре) */
+    /**
+     * Что прислал БРАУЗЕР: `host`, `accept-language` (в нижнем регистре).
+     *
+     * Читается для решений о рендере — собрать абсолютную ссылку, выбрать язык. Заголовка
+     * `cookie` здесь НЕТ намеренно: собери кто-нибудь по нему запрос — он отправил бы браузерную
+     * куку вместо реквизитов этого запроса, и на первом визите это был бы другой посетитель.
+     * Нужно значение куки — есть `cookies`; нужно сходить в бэкенд — есть `backendHeaders`.
+     */
     headers: Record<string, string>;
-    /** Распарсенные cookies из заголовка Cookie */
+    /** Разобранные куки — чтобы прочитать значение конкретной куки. */
     cookies: Record<string, string>;
+    /**
+     * Что предъявлять БЭКЕНДУ в каждом запросе: `cookie` и то, что бэкенд выдал хосту на
+     * бутстрапе своими заголовками (идентичность посетителя и прочее).
+     *
+     * Один набор на все походы приложения, и собирает его хост — до рендера и один раз.
+     * Навешивает на клиент расширение рантайма `@foxford/den-sdk`, поэтому прикладной код
+     * заголовков не касается вовсе.
+     */
+    backendHeaders?: Record<string, string>;
 }
 /**
  * Результат проверки guard.

package/{view-adapter-DMLlp3Iu.d.cts → view-adapter-CrHh7CjB.d.cts}

@@ -1,6 +1,6 @@
-import { I as IslandDescriptor } from './descriptor-C2j6Zz6c.cjs';
+import { I as IslandDescriptor } from './descriptor-DmfJP4jQ.cjs';
 import { S as ServerRenderResult } from './server-render-CocWXQKC.cjs';
-import { L as LayerDefinition, h as LayerConfig } from './types-BxMQ-VOd.cjs';
+import { L as LayerDefinition, h as LayerConfig } from './types-Ccd5bmt1.cjs';
 import { Container, Token } from '@foxford/ioc';
 
 /** Что нужно адаптеру, чтобы отрисовать остров на сервере. */

package/{view-adapter-DNLRSFka.d.ts → view-adapter-DPDvv09J.d.ts}

@@ -1,6 +1,6 @@
-import { I as IslandDescriptor } from './descriptor-BSaHM5B4.js';
+import { I as IslandDescriptor } from './descriptor-CNJFrEbS.js';
 import { S as ServerRenderResult } from './server-render-CocWXQKC.js';
-import { L as LayerDefinition, h as LayerConfig } from './types-BxMQ-VOd.js';
+import { L as LayerDefinition, h as LayerConfig } from './types-Ccd5bmt1.js';
 import { Container, Token } from '@foxford/ioc';
 
 /** Что нужно адаптеру, чтобы отрисовать остров на сервере. */