@foxford/den 4.0.0 → 4.1.0

package/README.mdx

@@ -182,6 +182,23 @@ describeDocument(): DocumentContribution {
 }
 ```
 
+Для нескольких процессов одного приложения:
+
+```bash
+WORKERS=2 node build/server.mjs
+```
+
+По умолчанию `WORKERS=1`. Все воркеры слушают общий прикладной порт, primary держит
+один служебный порт с их суммарными метриками. `server.configure` выполняется в каждом
+воркере; память и контейнеры процессов отдельные. Значение задаётся каждому приложению
+и должно быть положительным целым. После обновления Den приложение нужно пересобрать,
+чтобы новая точка входа начала читать `WORKERS`. Переменная работает и в `den dev`,
+но локальное хранилище dev-трасс между воркерами не объединяется.
+
+При остановке Den дожидается активных запросов; зависшие воркеры принудительно
+завершаются через 10 секунд. Ошибка запуска или выход любого воркера завершает группу
+с ошибкой, чтобы внешний супервизор мог перезапустить приложение целиком.
+
 Рантайм вокруг дескриптора отдаёт три ручки:
 
 | Ручка                                  | Ответ                                       |
@@ -189,7 +206,7 @@ describeDocument(): DocumentContribution {
 | `QUERY /_render` + `{ url, inputs?, backendHeaders? }`  | `200` + ответ `renderApp` телом             |
 | `GET /_render?url=<path+search>`       | то же без входных данных хоста              |
 | `GET /_routes`                         | `200` + массив regex-строк заявки на адреса |
-| `GET /healthz`, `GET /livez` на втором порту | `200 ok` |
+| `GET /healthz`, `GET /livez` на втором порту | `200 ok`; в кластере `/livez` проверяет heartbeat воркеров |
 | `GET /metrics` на втором порту | Prometheus-метрики Node/process и HTTP |
 
 `QUERY` — безопасный метод с телом (RFC 9110): адрес и входные данные хоста едут JSON-ом,
@@ -215,10 +232,19 @@ describeDocument(): DocumentContribution {
 Для совместной разработки объявляются локальные `server.port` и `server.opsPort`;
 production server.mjs использует production-умолчания.
 
-`/healthz` — простой GET с `200`, `/livez` — `200`, `/metrics` — экспорт полного
+`/healthz` — простой GET с `200`, `/livez` — проверка доступности, `/metrics` — экспорт полного
 штатного набора Node/process, дополнительных resourceUsage и HTTP-измерений.
 На основном порту служебные пути отвечают `404`.
-Метрики не зависят от DSN Sentry; `instance.close()` закрывает оба сервера.
+Метрики не зависят от DSN Sentry. Метод `close()` результата `await serveAppProcess(...)`
+закрывает всю группу; у прямого `serveApp` прежний `instance.close()` закрывает оба
+сервера одного процесса.
+
+Для занятости event loop используйте `nodejs_eventloop_utilization_ratio`:
+в кластере это максимум по воркерам, от 0 до 1. Сопоставляйте его с lag и временем
+ответа. Штатный `nodejs_eventloop_utilization_summary` суммирует quantile воркеров
+и для такого алерта не подходит. `/livez` остаётся зелёным, пока жив хотя бы один
+воркер; `/metrics` при неответившем воркере вернёт `503` через 5 секунд. Ошибки и
+длительность scrape тоже должны попадать в мониторинг.
 
 Для своего сервера доступен отдельный подпуть без Fastify:
 
@@ -345,6 +371,6 @@ export default defineAppConfig({
 | `@foxford/den/island`  | остров: жизненный цикл, шов `renderApp`, порт `ViewAdapter`, очередь клиентских падений (`reportIslandError`) |
 
 
-| `@foxford/den/serve`   | сетевой транспорт: `serveApp`, `appPlugin`                  |
+| `@foxford/den/serve`   | сетевой транспорт: `serveAppProcess`, `serveApp`, `appPlugin` |
 | `@foxford/den/build`   | конфиг приложения и сборка: `defineAppConfig`, `buildApp`   |
 | `@foxford/den/bin`     | точка входа команды `den`                                   |

package/bin/den.cjs

@@ -1,7 +1,7 @@
 "use strict";
 
 
-var _chunkOC4LQ2CKcjs = require('../chunk-OC4LQ2CK.cjs');
+var _chunkIATA5QZ7cjs = require('../chunk-IATA5QZ7.cjs');
 require('../chunk-KQAB6C6Q.cjs');
 require('../chunk-A6ZPAM6Z.cjs');
 
@@ -70,11 +70,11 @@ function run(argv) {
     }
     const target = { base: options["base"], root: (_a = options["root"]) != null ? _a : process.cwd() };
     if (command === "build") {
-      yield _chunkOC4LQ2CKcjs.buildApp.call(void 0, target);
+      yield _chunkIATA5QZ7cjs.buildApp.call(void 0, target);
       return;
     }
     if (command === "dev") {
-      yield _chunkOC4LQ2CKcjs.devApp.call(void 0, target);
+      yield _chunkIATA5QZ7cjs.devApp.call(void 0, target);
       return;
     }
     fail(`\u043D\u0435\u0438\u0437\u0432\u0435\u0441\u0442\u043D\u0430\u044F \u043A\u043E\u043C\u0430\u043D\u0434\u0430 \xAB${command}\xBB`);

package/bin/den.js

@@ -1,7 +1,7 @@
 import {
   buildApp,
   devApp
-} from "../chunk-FMRORLLE.js";
+} from "../chunk-7FOG2MJV.js";
 import "../chunk-RG7ZV5BD.js";
 import "../chunk-TPBI6TOU.js";
 import {

package/builder/index.cjs

@@ -2,7 +2,7 @@
 
 
 
-var _chunkOC4LQ2CKcjs = require('../chunk-OC4LQ2CK.cjs');
+var _chunkIATA5QZ7cjs = require('../chunk-IATA5QZ7.cjs');
 require('../chunk-KQAB6C6Q.cjs');
 require('../chunk-A6ZPAM6Z.cjs');
 require('../chunk-T5QVCXVB.cjs');
@@ -10,4 +10,4 @@ require('../chunk-T5QVCXVB.cjs');
 
 
 
-exports.buildApp = _chunkOC4LQ2CKcjs.buildApp; exports.defineAppConfig = _chunkOC4LQ2CKcjs.defineAppConfig; exports.devApp = _chunkOC4LQ2CKcjs.devApp;
+exports.buildApp = _chunkIATA5QZ7cjs.buildApp; exports.defineAppConfig = _chunkIATA5QZ7cjs.defineAppConfig; exports.devApp = _chunkIATA5QZ7cjs.devApp;

package/builder/index.js

@@ -2,7 +2,7 @@ import {
   buildApp,
   defineAppConfig,
   devApp
-} from "../chunk-FMRORLLE.js";
+} from "../chunk-7FOG2MJV.js";
 import "../chunk-RG7ZV5BD.js";
 import "../chunk-TPBI6TOU.js";
 import "../chunk-6FNC3XMI.js";

package/{chunk-FMRORLLE.js → chunk-7FOG2MJV.js}

@@ -134,7 +134,7 @@ function generateServerProcess(configPath, base, mode) {
 ` : "";
   return `import { fileURLToPath } from 'node:url'
 
-import { loadAppEnv, serveApp } from '@foxford/den/serve'
+import { loadAppEnv, serveAppProcess } from '@foxford/den/serve'
 
 import app from ${JSON.stringify(VIRTUAL_SERVER_APP)}
 import config from ${JSON.stringify(configPath)}
@@ -142,11 +142,12 @@ import config from ${JSON.stringify(configPath)}
 // \u0423\u043C\u043E\u043B\u0447\u0430\u043D\u0438\u044F \u043E\u043A\u0440\u0443\u0436\u0435\u043D\u0438\u044F \u2014 \u0434\u043E \u043F\u0435\u0440\u0432\u043E\u0433\u043E \u0447\u0442\u0435\u043D\u0438\u044F: \u043F\u043E\u0440\u0442 \u0438 \u0430\u0434\u0440\u0435\u0441\u0430 \u0447\u0438\u0442\u0430\u044E\u0442\u0441\u044F \u043D\u0438\u0436\u0435
 loadAppEnv(fileURLToPath(new URL('..', import.meta.url)))
 
-await serveApp(app, {
+await serveAppProcess(app, {
 ${assets}  configure: config.server?.configure,
   host: process.env.HOST,
   ops: { host: process.env.OPS_HOST, port: Number(process.env.SERVICE_PORT ?? ${mode === "development" ? "config.server?.opsPort ?? 9090" : "9090"}) },
   port: Number(process.env.PORT ?? ${mode === "development" ? "config.server?.port ?? " : ""}${String(DEFAULT_PORT)}),
+  workers: Number(process.env.WORKERS ?? 1),
 })
 `;
 }

package/{chunk-DUU4MQ4B.js → chunk-A2CYL5LY.js}

@@ -11,17 +11,30 @@ import { Counter, Gauge as Gauge2, Histogram, Registry } from "@prometheus-io/cl
 
 // src/ops/runtime.ts
 import cluster from "cluster";
+import { performance as performance2 } from "perf_hooks";
 import { collectDefaultMetrics, Gauge } from "@prometheus-io/client";
 function collectRuntime(registry, appName) {
   registry.setDefaultLabels({ app: appName, process_role: cluster.isWorker ? "worker" : "main" });
   collectDefaultMetrics({ register: registry });
+  let previousElu = performance2.eventLoopUtilization();
+  new Gauge({
+    aggregator: "max",
+    collect() {
+      const current = performance2.eventLoopUtilization();
+      this.set(performance2.eventLoopUtilization(current, previousElu).utilization);
+      previousElu = current;
+    },
+    help: "Event loop utilization since the last scrape; maximum across workers",
+    name: "nodejs_eventloop_utilization_ratio",
+    registers: [registry]
+  });
   let previousCpu = process.cpuUsage();
-  let previousTime = performance.now();
+  let previousTime = performance2.now();
   new Gauge({
     aggregator: "sum",
     collect() {
       const currentCpu = process.cpuUsage();
-      const currentTime = performance.now();
+      const currentTime = performance2.now();
       const elapsed = currentTime - previousTime;
       this.set(
         elapsed > 0 ? (currentCpu.user - previousCpu.user + currentCpu.system - previousCpu.system) / (elapsed * 1e3) : 0

package/{chunk-2P5TAWRW.cjs → chunk-HJFBEJT6.cjs}

@@ -11,17 +11,30 @@ var _client = require('@prometheus-io/client');
 
 // src/ops/runtime.ts
 var _cluster = require('cluster'); var _cluster2 = _interopRequireDefault(_cluster);
+var _perf_hooks = require('perf_hooks');
 
 function collectRuntime(registry, appName) {
   registry.setDefaultLabels({ app: appName, process_role: _cluster2.default.isWorker ? "worker" : "main" });
   _client.collectDefaultMetrics.call(void 0, { register: registry });
+  let previousElu = _perf_hooks.performance.eventLoopUtilization();
+  new (0, _client.Gauge)({
+    aggregator: "max",
+    collect() {
+      const current = _perf_hooks.performance.eventLoopUtilization();
+      this.set(_perf_hooks.performance.eventLoopUtilization(current, previousElu).utilization);
+      previousElu = current;
+    },
+    help: "Event loop utilization since the last scrape; maximum across workers",
+    name: "nodejs_eventloop_utilization_ratio",
+    registers: [registry]
+  });
   let previousCpu = process.cpuUsage();
-  let previousTime = performance.now();
+  let previousTime = _perf_hooks.performance.now();
   new (0, _client.Gauge)({
     aggregator: "sum",
     collect() {
       const currentCpu = process.cpuUsage();
-      const currentTime = performance.now();
+      const currentTime = _perf_hooks.performance.now();
       const elapsed = currentTime - previousTime;
       this.set(
         elapsed > 0 ? (currentCpu.user - previousCpu.user + currentCpu.system - previousCpu.system) / (elapsed * 1e3) : 0

package/{chunk-OC4LQ2CK.cjs → chunk-IATA5QZ7.cjs}

@@ -134,7 +134,7 @@ function generateServerProcess(configPath, base, mode) {
 ` : "";
   return `import { fileURLToPath } from 'node:url'
 
-import { loadAppEnv, serveApp } from '@foxford/den/serve'
+import { loadAppEnv, serveAppProcess } from '@foxford/den/serve'
 
 import app from ${JSON.stringify(VIRTUAL_SERVER_APP)}
 import config from ${JSON.stringify(configPath)}
@@ -142,11 +142,12 @@ import config from ${JSON.stringify(configPath)}
 // \u0423\u043C\u043E\u043B\u0447\u0430\u043D\u0438\u044F \u043E\u043A\u0440\u0443\u0436\u0435\u043D\u0438\u044F \u2014 \u0434\u043E \u043F\u0435\u0440\u0432\u043E\u0433\u043E \u0447\u0442\u0435\u043D\u0438\u044F: \u043F\u043E\u0440\u0442 \u0438 \u0430\u0434\u0440\u0435\u0441\u0430 \u0447\u0438\u0442\u0430\u044E\u0442\u0441\u044F \u043D\u0438\u0436\u0435
 loadAppEnv(fileURLToPath(new URL('..', import.meta.url)))
 
-await serveApp(app, {
+await serveAppProcess(app, {
 ${assets}  configure: config.server?.configure,
   host: process.env.HOST,
   ops: { host: process.env.OPS_HOST, port: Number(process.env.SERVICE_PORT ?? ${mode === "development" ? "config.server?.opsPort ?? 9090" : "9090"}) },
   port: Number(process.env.PORT ?? ${mode === "development" ? "config.server?.port ?? " : ""}${String(DEFAULT_PORT)}),
+  workers: Number(process.env.WORKERS ?? 1),
 })
 `;
 }

package/ops/index.cjs

@@ -5,7 +5,7 @@
 
 
 
-var _chunk2P5TAWRWcjs = require('../chunk-2P5TAWRW.cjs');
+var _chunkHJFBEJT6cjs = require('../chunk-HJFBEJT6.cjs');
 require('../chunk-T5QVCXVB.cjs');
 
 
@@ -14,4 +14,4 @@ require('../chunk-T5QVCXVB.cjs');
 
 
 
-exports.ProcessMetrics = _chunk2P5TAWRWcjs.ProcessMetrics; exports.closeHttpServer = _chunk2P5TAWRWcjs.closeHttpServer; exports.clusterMetrics = _chunk2P5TAWRWcjs.clusterMetrics; exports.getProcessMetrics = _chunk2P5TAWRWcjs.getProcessMetrics; exports.isOpsPath = _chunk2P5TAWRWcjs.isOpsPath; exports.startOpsServer = _chunk2P5TAWRWcjs.startOpsServer;
+exports.ProcessMetrics = _chunkHJFBEJT6cjs.ProcessMetrics; exports.closeHttpServer = _chunkHJFBEJT6cjs.closeHttpServer; exports.clusterMetrics = _chunkHJFBEJT6cjs.clusterMetrics; exports.getProcessMetrics = _chunkHJFBEJT6cjs.getProcessMetrics; exports.isOpsPath = _chunkHJFBEJT6cjs.isOpsPath; exports.startOpsServer = _chunkHJFBEJT6cjs.startOpsServer;

package/ops/index.js

@@ -5,7 +5,7 @@ import {
   getProcessMetrics,
   isOpsPath,
   startOpsServer
-} from "../chunk-DUU4MQ4B.js";
+} from "../chunk-A2CYL5LY.js";
 import "../chunk-6FNC3XMI.js";
 export {
   ProcessMetrics,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foxford/den",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "description": "Den — декларативный метафреймворк Foxford (core runtime)",
   "keywords": [
     "foxford",
@@ -95,19 +95,19 @@
     "adapter.js",
     "bin",
     "builder",
-    "chunk-2P5TAWRW.cjs",
     "chunk-3RX2OSUL.js",
     "chunk-6FNC3XMI.js",
     "chunk-6QV4L6R2.cjs",
+    "chunk-7FOG2MJV.js",
+    "chunk-A2CYL5LY.js",
     "chunk-A6ZPAM6Z.cjs",
     "chunk-C7BM4DGX.cjs",
-    "chunk-DUU4MQ4B.js",
     "chunk-E23E2VUC.js",
     "chunk-E56BKBQZ.js",
-    "chunk-FMRORLLE.js",
     "chunk-H5DKRHHQ.cjs",
+    "chunk-HJFBEJT6.cjs",
+    "chunk-IATA5QZ7.cjs",
     "chunk-KQAB6C6Q.cjs",
-    "chunk-OC4LQ2CK.cjs",
     "chunk-QTWJTYZW.cjs",
     "chunk-RG7ZV5BD.js",
     "chunk-T5QVCXVB.cjs",
@@ -143,6 +143,6 @@
     "view-adapter-CrHh7CjB.d.cts",
     "view-adapter-DPDvv09J.d.ts"
   ],
-  "sha": "46c9d1a",
+  "sha": "c941b51",
   "scripts": {}
 }

package/serve/index.cjs

@@ -17,7 +17,9 @@ var _chunkA6ZPAM6Zcjs = require('../chunk-A6ZPAM6Z.cjs');
 
 
 
-var _chunk2P5TAWRWcjs = require('../chunk-2P5TAWRW.cjs');
+
+var _chunkHJFBEJT6cjs = require('../chunk-HJFBEJT6.cjs');
+
 
 
 
@@ -177,7 +179,203 @@ var appPlugin = (instance, options) => {
   return Promise.resolve();
 };
 
+// src/serve/process.ts
+var _cluster = require('cluster'); var _cluster2 = _interopRequireDefault(_cluster);
+
+
+// src/serve/worker.ts
+
+var ALIVE = "den:app-worker-alive";
+var SIGNALS = ["SIGTERM", "SIGINT"];
+var SHUTDOWN_MS = 1e4;
+function startWorker(appName, start) {
+  return _chunkT5QVCXVBcjs.__async.call(void 0, this, null, function* () {
+    const aggregation = _chunkHJFBEJT6cjs.clusterMetrics.call(void 0, );
+    const logger2 = _logger.log.getLogger(appName).getLogger("cluster");
+    let timer;
+    let closing;
+    const starting = start();
+    const close = () => {
+      closing != null ? closing : closing = (() => _chunkT5QVCXVBcjs.__async.call(void 0, 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 _chunkT5QVCXVBcjs.__async.call(void 0, 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 = _chunkHJFBEJT6cjs.getProcessMetrics.call(void 0, );
+    metrics.startRuntime(appName);
+    if (_cluster2.default.isWorker) {
+      return startWorker(appName, () => start(_chunkT5QVCXVBcjs.__spreadProps.call(void 0, _chunkT5QVCXVBcjs.__spreadValues.call(void 0, {}, options), { gracefulShutdown: false, ops: false })));
+    }
+    return startPrimary(appName, options, workers);
+  });
+}
+function startPrimary(appName, options, workers) {
+  return _chunkT5QVCXVBcjs.__async.call(void 0, this, null, function* () {
+    const aggregation = _chunkHJFBEJT6cjs.clusterMetrics.call(void 0, );
+    const logger2 = _logger.log.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 = (() => _chunkT5QVCXVBcjs.__async.call(void 0, null, null, function* () {
+        clearTimeout(timeout);
+        resolveReady();
+        _cluster2.default.removeListener("message", onMessage);
+        yield Promise.all([...children].map(stopWorker));
+        if (ops) yield _chunkHJFBEJT6cjs.closeHttpServer.call(void 0, 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();
+      }
+    };
+    _cluster2.default.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 _chunkHJFBEJT6cjs.startOpsServer.call(void 0, _chunkT5QVCXVBcjs.__spreadProps.call(void 0, _chunkT5QVCXVBcjs.__spreadValues.call(void 0, {}, 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 _chunkHJFBEJT6cjs.closeHttpServer.call(void 0, ops);
+        yield closing;
+        return { close };
+      }
+      for (let i = 0; i < workers; i++) {
+        const worker = _cluster2.default.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 _chunkT5QVCXVBcjs.__async.call(void 0, 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 _chunkT5QVCXVBcjs.__async.call(void 0, this, arguments, function* (app, options = {}) {
@@ -185,14 +383,14 @@ function serveApp(_0) {
     const appLog = (_a = _logger.log.getLogger(app.name)) != null ? _a : _chunkA6ZPAM6Zcjs.logger;
     const serveLog = (_b = appLog.getLogger("serve")) != null ? _b : appLog;
     const instance = _fastify2.default.call(void 0, { logger: false });
-    const metrics = _chunk2P5TAWRWcjs.getProcessMetrics.call(void 0, );
+    const metrics = _chunkHJFBEJT6cjs.getProcessMetrics.call(void 0, );
     metrics.startRuntime(app.name);
     let ops;
     const shutdown = () => {
       void instance.close();
     };
     instance.addHook("onRequest", (req, reply, done) => {
-      if (_chunk2P5TAWRWcjs.isOpsPath.call(void 0, req.url)) {
+      if (_chunkHJFBEJT6cjs.isOpsPath.call(void 0, req.url)) {
         void reply.code(404).send();
         return;
       }
@@ -207,7 +405,7 @@ function serveApp(_0) {
         process.removeListener(signal, shutdown);
       }
       if (ops) {
-        yield _chunk2P5TAWRWcjs.closeHttpServer.call(void 0, ops);
+        yield _chunkHJFBEJT6cjs.closeHttpServer.call(void 0, ops);
       }
     }));
     yield instance.register(appPlugin, { app, slowRenderMs: options.slowRenderMs });
@@ -226,7 +424,7 @@ function serveApp(_0) {
     try {
       yield (_c = options.configure) == null ? void 0 : _c.call(options, instance);
       if (options.ops !== false) {
-        ops = yield _chunk2P5TAWRWcjs.startOpsServer.call(void 0, options.ops);
+        ops = yield _chunkHJFBEJT6cjs.startOpsServer.call(void 0, options.ops);
       }
       yield instance.listen({ host: (_d = options.host) != null ? _d : "0.0.0.0", port: (_e = options.port) != null ? _e : 8080 });
     } catch (error) {
@@ -249,4 +447,5 @@ function serveApp(_0) {
 
 
 
-exports.appPlugin = appPlugin; exports.loadAppEnv = _chunkKQAB6C6Qcjs.loadAppEnv; exports.registerAssets = registerAssets; exports.serveApp = serveApp;
+
+exports.appPlugin = appPlugin; exports.loadAppEnv = _chunkKQAB6C6Qcjs.loadAppEnv; exports.registerAssets = registerAssets; exports.serveApp = serveApp; exports.serveAppProcess = serveAppProcess;

package/serve/index.d.cts

@@ -44,6 +44,14 @@ interface AppPluginOptions {
  */
 declare const appPlugin: FastifyPluginAsync<AppPluginOptions>;
 
+interface AppProcess {
+    close: () => Promise<void>;
+}
+interface ServeAppProcessOptions extends ServeAppOptions {
+    /** Число процессов приложения; по умолчанию 1. Каждый воркер имеет свой контейнер. */
+    workers?: number;
+}
+
 /**
  * Кладёт умолчания из `<root>/.env` в окружение процесса.
  *
@@ -53,6 +61,8 @@ declare const appPlugin: FastifyPluginAsync<AppPluginOptions>;
  */
 declare function loadAppEnv(root: string): void;
 
+/** Точка входа самостоятельного процесса: один инстанс либо cluster с общим портом. */
+declare function serveAppProcess(app: ServableApp, options?: ServeAppProcessOptions): Promise<AppProcess>;
 /** Настройки инстанса. */
 interface ServeAppOptions {
     /** Порт; `0` — свободный, фактический смотри в `server.addresses()`. */
@@ -93,4 +103,4 @@ interface ServeAppOptions {
  */
 declare function serveApp(app: ServableApp, options?: ServeAppOptions): Promise<FastifyInstance>;
 
-export { type AppAssetsSource, type AppPluginOptions, type ServableApp, type ServeAppOptions, appPlugin, loadAppEnv, registerAssets, serveApp };
+export { type AppAssetsSource, type AppPluginOptions, type AppProcess, type ServableApp, type ServeAppOptions, type ServeAppProcessOptions, appPlugin, loadAppEnv, registerAssets, serveApp, serveAppProcess };

package/serve/index.d.ts

@@ -44,6 +44,14 @@ interface AppPluginOptions {
  */
 declare const appPlugin: FastifyPluginAsync<AppPluginOptions>;
 
+interface AppProcess {
+    close: () => Promise<void>;
+}
+interface ServeAppProcessOptions extends ServeAppOptions {
+    /** Число процессов приложения; по умолчанию 1. Каждый воркер имеет свой контейнер. */
+    workers?: number;
+}
+
 /**
  * Кладёт умолчания из `<root>/.env` в окружение процесса.
  *
@@ -53,6 +61,8 @@ declare const appPlugin: FastifyPluginAsync<AppPluginOptions>;
  */
 declare function loadAppEnv(root: string): void;
 
+/** Точка входа самостоятельного процесса: один инстанс либо cluster с общим портом. */
+declare function serveAppProcess(app: ServableApp, options?: ServeAppProcessOptions): Promise<AppProcess>;
 /** Настройки инстанса. */
 interface ServeAppOptions {
     /** Порт; `0` — свободный, фактический смотри в `server.addresses()`. */
@@ -93,4 +103,4 @@ interface ServeAppOptions {
  */
 declare function serveApp(app: ServableApp, options?: ServeAppOptions): Promise<FastifyInstance>;
 
-export { type AppAssetsSource, type AppPluginOptions, type ServableApp, type ServeAppOptions, appPlugin, loadAppEnv, registerAssets, serveApp };
+export { type AppAssetsSource, type AppPluginOptions, type AppProcess, type ServableApp, type ServeAppOptions, type ServeAppProcessOptions, appPlugin, loadAppEnv, registerAssets, serveApp, serveAppProcess };

package/serve/index.js

@@ -14,18 +14,20 @@ import {
 } from "../chunk-TPBI6TOU.js";
 import {
   closeHttpServer,
+  clusterMetrics,
   getProcessMetrics,
   isOpsPath,
   startOpsServer
-} from "../chunk-DUU4MQ4B.js";
+} 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";
@@ -177,12 +179,208 @@ 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, _e;
-    const appLog = (_a = log2.getLogger(app.name)) != null ? _a : logger;
+    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();
@@ -248,5 +446,6 @@ export {
   appPlugin,
   loadAppEnv,
   registerAssets,
-  serveApp
+  serveApp,
+  serveAppProcess
 };