@foxford/den 3.7.0 → 4.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foxford/den",
-  "version": "3.7.0",
+  "version": "4.1.0",
   "description": "Den — декларативный метафреймворк Foxford (core runtime)",
   "keywords": [
     "foxford",
@@ -30,6 +30,7 @@
     "den": "./den.js"
   },
   "dependencies": {
+    "@prometheus-io/client": "0.16.1",
     "fastify": "^5.12.1",
     "@foxford/ioc": "^1.1.2",
     "@foxford/logger": "^1.2.2"
@@ -75,6 +76,11 @@
       "require": "./island/index.cjs",
       "types": "./island/index.d.ts"
     },
+    "./ops": {
+      "import": "./ops/index.js",
+      "require": "./ops/index.cjs",
+      "types": "./ops/index.d.ts"
+    },
     "./serve": {
       "import": "./serve/index.js",
       "require": "./serve/index.cjs",
@@ -89,17 +95,19 @@
     "adapter.js",
     "bin",
     "builder",
-    "chunk-2GTQK2PZ.js",
     "chunk-3RX2OSUL.js",
     "chunk-6FNC3XMI.js",
     "chunk-6QV4L6R2.cjs",
+    "chunk-7FOG2MJV.js",
+    "chunk-A2CYL5LY.js",
     "chunk-A6ZPAM6Z.cjs",
     "chunk-C7BM4DGX.cjs",
     "chunk-E23E2VUC.js",
     "chunk-E56BKBQZ.js",
     "chunk-H5DKRHHQ.cjs",
+    "chunk-HJFBEJT6.cjs",
+    "chunk-IATA5QZ7.cjs",
     "chunk-KQAB6C6Q.cjs",
-    "chunk-P4J4M2WZ.cjs",
     "chunk-QTWJTYZW.cjs",
     "chunk-RG7ZV5BD.js",
     "chunk-T5QVCXVB.cjs",
@@ -107,33 +115,34 @@
     "chunk-WBHHHICS.js",
     "chunk-XOJ2VWX4.cjs",
     "chunk-XQ7EHXHG.js",
-    "define-repository-AO7JI6Cb.d.ts",
-    "define-repository-C0MI-J32.d.cts",
-    "define-slot-BEeHNEph.d.cts",
-    "define-slot-CdWdFM16.d.ts",
+    "define-repository-Ck45La_2.d.ts",
+    "define-repository-DAyeXF48.d.cts",
+    "define-slot-BTlLQ__T.d.ts",
+    "define-slot-C6hrdJS3.d.cts",
     "define.cjs",
     "define.d.cts",
     "define.d.ts",
     "define.js",
     "den.js",
-    "descriptor-BSaHM5B4.d.ts",
-    "descriptor-C2j6Zz6c.d.cts",
+    "descriptor-CNJFrEbS.d.ts",
+    "descriptor-DmfJP4jQ.d.cts",
     "index.cjs",
     "index.d.cts",
     "index.d.ts",
     "index.js",
     "island",
+    "ops",
     "package.json",
-    "routes-BvV405k4.d.cts",
-    "routes-Di3K_0uQ.d.ts",
+    "routes-DQ4ud4bu.d.cts",
+    "routes-TkIxQ0Uc.d.ts",
     "serve",
     "server-render-CocWXQKC.d.cts",
     "server-render-CocWXQKC.d.ts",
-    "types-BxMQ-VOd.d.cts",
-    "types-BxMQ-VOd.d.ts",
-    "view-adapter-DMLlp3Iu.d.cts",
-    "view-adapter-DNLRSFka.d.ts"
+    "types-Ccd5bmt1.d.cts",
+    "types-Ccd5bmt1.d.ts",
+    "view-adapter-CrHh7CjB.d.cts",
+    "view-adapter-DPDvv09J.d.ts"
   ],
-  "sha": "c642307",
+  "sha": "c941b51",
   "scripts": {}
 }

package/{routes-BvV405k4.d.cts → routes-DQ4ud4bu.d.cts}

@@ -1,4 +1,4 @@
-import { G as GuardDefinition } from './types-BxMQ-VOd.cjs';
+import { G as GuardDefinition } from './types-Ccd5bmt1.cjs';
 
 /** Маршрут с политикой доступа. */
 interface RouteDeclaration {

package/{routes-Di3K_0uQ.d.ts → routes-TkIxQ0Uc.d.ts}

@@ -1,4 +1,4 @@
-import { G as GuardDefinition } from './types-BxMQ-VOd.js';
+import { G as GuardDefinition } from './types-Ccd5bmt1.js';
 
 /** Маршрут с политикой доступа. */
 interface RouteDeclaration {

package/serve/index.cjs

@@ -14,6 +14,15 @@ require('../chunk-6QV4L6R2.cjs');
 var _chunkA6ZPAM6Zcjs = require('../chunk-A6ZPAM6Z.cjs');
 
 
+
+
+
+
+var _chunkHJFBEJT6cjs = require('../chunk-HJFBEJT6.cjs');
+
+
+
+
 var _chunkT5QVCXVBcjs = require('../chunk-T5QVCXVB.cjs');
 
 // src/serve/index.ts
@@ -79,7 +88,7 @@ function matchClaim(app, pathname) {
   }
   return (_b = (_a = _chunkQTWJTYZWcjs.matchRoute.call(void 0, 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 = _chunkT5QVCXVBcjs.__spreadValues.call(void 0, _chunkT5QVCXVBcjs.__spreadValues.call(void 0, {}, typeof cookie === "string" && cookie !== "" ? { cookie } : {}), fromBody);
+  return { backendHeaders, cookies: _chunkQTWJTYZWcjs.parseCookieHeader.call(void 0, cookie), headers };
+}
+function backendHeadersOf(value) {
+  if (value === void 0) {
+    return void 0;
+  }
+  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 { cookies: _chunkQTWJTYZWcjs.parseCookieHeader.call(void 0, cookie), headers };
+  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 = _logger.log.getLogger(app.name)) != null ? _a : _chunkA6ZPAM6Zcjs.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 _chunkT5QVCXVBcjs.__async.call(void 0, 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 _chunkQTWJTYZWcjs.renderApp.call(void 0, 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
+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 = {}) {
-    var _a, _b, _c, _d;
+    var _a, _b, _c, _d, _e;
     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 = _chunkHJFBEJT6cjs.getProcessMetrics.call(void 0, );
+    metrics.startRuntime(app.name);
+    let ops;
+    const shutdown = () => {
+      void instance.close();
+    };
+    instance.addHook("onRequest", (req, reply, done) => {
+      if (_chunkHJFBEJT6cjs.isOpsPath.call(void 0, 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", () => _chunkT5QVCXVBcjs.__async.call(void 0, null, null, function* () {
+      for (const signal of SHUTDOWN_SIGNALS) {
+        process.removeListener(signal, shutdown);
+      }
+      if (ops) {
+        yield _chunkHJFBEJT6cjs.closeHttpServer.call(void 0, 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 _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) {
+      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(
@@ -195,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

@@ -1,9 +1,12 @@
 import { FastifyInstance, FastifyPluginAsync } from 'fastify';
-import { I as IslandDescriptor } from '../descriptor-C2j6Zz6c.cjs';
-import { A as AppRoute } from '../routes-BvV405k4.cjs';
-import '../define-slot-BEeHNEph.cjs';
-import '../types-BxMQ-VOd.cjs';
+import { I as IslandDescriptor } from '../descriptor-DmfJP4jQ.cjs';
+import { A as AppRoute } from '../routes-DQ4ud4bu.cjs';
+import { OpsOptions } from '../ops/index.cjs';
+import '../define-slot-C6hrdJS3.cjs';
+import '../types-Ccd5bmt1.cjs';
 import '@foxford/ioc';
+import '@prometheus-io/client';
+import 'node:http';
 
 /** Что раздаётся и по какому префиксу. */
 interface AppAssetsSource {
@@ -31,7 +34,7 @@ interface AppPluginOptions {
     slowRenderMs?: number;
 }
 /**
- * Регистрирует ручки приложения на инстансе fastify: `/_render`, `/_routes`, `/_health`.
+ * Регистрирует ручки приложения на инстансе fastify: `/_render`, `/_routes`.
  *
  * Плагином, поэтому монтируется и в свой сервер, и в чужой — под префиксом, рядом с ручками
  * потребителя, вместе с его плагинами.
@@ -41,6 +44,14 @@ interface AppPluginOptions {
  */
 declare const appPlugin: FastifyPluginAsync<AppPluginOptions>;
 
+interface AppProcess {
+    close: () => Promise<void>;
+}
+interface ServeAppProcessOptions extends ServeAppOptions {
+    /** Число процессов приложения; по умолчанию 1. Каждый воркер имеет свой контейнер. */
+    workers?: number;
+}
+
 /**
  * Кладёт умолчания из `<root>/.env` в окружение процесса.
  *
@@ -50,10 +61,14 @@ 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()`. */
     port?: number;
+    /** Второй HTTP-сервер для probes и метрик; false — подключается потребителем. */
+    ops?: OpsOptions | false;
     /** Интерфейс прослушивания. */
     host?: string;
     /** Порог, выше которого рендер считается медленным и уходит в `warn`, мс. */
@@ -88,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

@@ -1,9 +1,12 @@
 import { FastifyInstance, FastifyPluginAsync } from 'fastify';
-import { I as IslandDescriptor } from '../descriptor-BSaHM5B4.js';
-import { A as AppRoute } from '../routes-Di3K_0uQ.js';
-import '../define-slot-CdWdFM16.js';
-import '../types-BxMQ-VOd.js';
+import { I as IslandDescriptor } from '../descriptor-CNJFrEbS.js';
+import { A as AppRoute } from '../routes-TkIxQ0Uc.js';
+import { OpsOptions } from '../ops/index.js';
+import '../define-slot-BTlLQ__T.js';
+import '../types-Ccd5bmt1.js';
 import '@foxford/ioc';
+import '@prometheus-io/client';
+import 'node:http';
 
 /** Что раздаётся и по какому префиксу. */
 interface AppAssetsSource {
@@ -31,7 +34,7 @@ interface AppPluginOptions {
     slowRenderMs?: number;
 }
 /**
- * Регистрирует ручки приложения на инстансе fastify: `/_render`, `/_routes`, `/_health`.
+ * Регистрирует ручки приложения на инстансе fastify: `/_render`, `/_routes`.
  *
  * Плагином, поэтому монтируется и в свой сервер, и в чужой — под префиксом, рядом с ручками
  * потребителя, вместе с его плагинами.
@@ -41,6 +44,14 @@ interface AppPluginOptions {
  */
 declare const appPlugin: FastifyPluginAsync<AppPluginOptions>;
 
+interface AppProcess {
+    close: () => Promise<void>;
+}
+interface ServeAppProcessOptions extends ServeAppOptions {
+    /** Число процессов приложения; по умолчанию 1. Каждый воркер имеет свой контейнер. */
+    workers?: number;
+}
+
 /**
  * Кладёт умолчания из `<root>/.env` в окружение процесса.
  *
@@ -50,10 +61,14 @@ 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()`. */
     port?: number;
+    /** Второй HTTP-сервер для probes и метрик; false — подключается потребителем. */
+    ops?: OpsOptions | false;
     /** Интерфейс прослушивания. */
     host?: string;
     /** Порог, выше которого рендер считается медленным и уходит в `warn`, мс. */
@@ -88,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 };