@foxford/den 3.0.0 → 3.1.1

package/island/index.js

@@ -1,169 +1,27 @@
+import {
+  activateIslandViewModels,
+  collectDocumentContribution,
+  collectIslandState,
+  createIslandContainer,
+  getAppContainer,
+  hydrateIslandState,
+  isDocumentSource,
+  matchRoute,
+  normalizeRoutes,
+  pathPattern,
+  renderApp,
+  resolveEagerUnits
+} from "../chunk-TPHJUDHG.js";
 import {
   ViewLayerToken,
   resolveViewAdapter,
   viewAdapterOf
 } from "../chunk-E23E2VUC.js";
+import "../chunk-3RX2OSUL.js";
+import "../chunk-TPBI6TOU.js";
 import {
-  LoggerToken,
-  logger,
-  unitLogger
-} from "../chunk-TPBI6TOU.js";
-import {
-  __async,
   __spreadValues
-} from "../chunk-HJO26HIQ.js";
-
-// src/island/document.ts
-function isDocumentSource(value) {
-  return typeof value === "object" && value !== null && typeof value.describeDocument === "function";
-}
-
-// src/island/lifecycle.ts
-import { log } from "@foxford/logger";
-
-// src/island/runtime.ts
-import { Container } from "@foxford/ioc";
-var appContainer = null;
-function getAppContainer() {
-  var _a;
-  if (appContainer === null) {
-    appContainer = new Container();
-    ((_a = logger.getLogger("island:runtime")) != null ? _a : logger).debug("app-\u043A\u043E\u043D\u0442\u0435\u0439\u043D\u0435\u0440 \u0441\u043E\u0437\u0434\u0430\u043D");
-  }
-  return appContainer;
-}
-
-// src/island/lifecycle.ts
-var EMPTY_ROUTE = { params: {}, pathname: "", search: "" };
-var REDIRECT_FOUND = 302;
-function createIslandContainer(descriptor, options = {}) {
-  var _a, _b, _c, _d, _e;
-  const { parent = getAppContainer() } = options;
-  const appLog = (_b = log.getLogger((_a = descriptor.name) != null ? _a : "app")) != null ? _b : logger;
-  const islandLog = (_c = appLog.getLogger("client")) != null ? _c : appLog;
-  try {
-    const container = parent.createChild();
-    container.bind(LoggerToken).toValue(islandLog);
-    descriptor.viewLayer.register(container);
-    const viewModels = (_d = descriptor.viewModels) != null ? _d : [];
-    const slots = Object.entries((_e = descriptor.slots) != null ? _e : {});
-    islandLog.info(
-      `\u043E\u0441\u0442\u0440\u043E\u0432: \u043A\u043E\u043D\u0442\u0435\u0439\u043D\u0435\u0440 \u0441\u043E\u0437\u0434\u0430\u043D (units=${descriptor.units.length}, vms=${viewModels.length}, slots=${slots.length})`
-    );
-    for (const unit of descriptor.units) {
-      unit.register(container);
-    }
-    for (const vm of viewModels) {
-      vm.register(container);
-    }
-    for (const [name, slot] of slots) {
-      slot.register(container, name);
-    }
-    return container;
-  } catch (error) {
-    islandLog.error("\u043E\u0441\u0442\u0440\u043E\u0432: \u0441\u0431\u043E\u0440\u043A\u0430 \u043A\u043E\u043D\u0442\u0435\u0439\u043D\u0435\u0440\u0430 \u0443\u043F\u0430\u043B\u0430", error);
-    return null;
-  }
-}
-function hydrateIslandState(container, descriptor, denState) {
-  var _a, _b;
-  for (const vm of (_a = descriptor.viewModels) != null ? _a : []) {
-    const instance = container.resolve(vm.token);
-    const saved = denState[vm.token.description];
-    if (saved !== void 0 && typeof ((_b = instance.state) == null ? void 0 : _b.set) === "function") {
-      unitLogger(container, vm.token.description).debug("\u0433\u0438\u0434\u0440\u0430\u0446\u0438\u044F VM \u0438\u0437 denState");
-      instance.state.set(saved);
-    }
-  }
-}
-function activateIslandViewModels(_0, _1) {
-  return __async(this, arguments, function* (container, descriptor, route = EMPTY_ROUTE) {
-    var _a;
-    yield Promise.all(
-      ((_a = descriptor.viewModels) != null ? _a : []).map((vm) => __async(null, null, function* () {
-        var _a2;
-        const instance = container.resolve(vm.token);
-        unitLogger(container, vm.token.description).debug(`\u0430\u043A\u0442\u0438\u0432\u0430\u0446\u0438\u044F VM (${route.pathname || "\u2014"})`);
-        yield (_a2 = instance.activate) == null ? void 0 : _a2.call(instance, route);
-      }))
-    );
-  });
-}
-function collectIslandState(container, descriptor) {
-  var _a, _b;
-  const state = {};
-  for (const vm of (_a = descriptor.viewModels) != null ? _a : []) {
-    const instance = container.resolve(vm.token);
-    if (typeof ((_b = instance.state) == null ? void 0 : _b.get) === "function") {
-      state[vm.token.description] = instance.state.get();
-    }
-  }
-  return state;
-}
-function collectDocumentContribution(container, descriptor) {
-  var _a, _b;
-  const contribution = {};
-  for (const vm of (_a = descriptor.viewModels) != null ? _a : []) {
-    const instance = container.resolve(vm.token);
-    if (!isDocumentSource(instance)) {
-      continue;
-    }
-    const part = instance.describeDocument();
-    if (part.head) {
-      contribution.head = __spreadValues(__spreadValues({}, contribution.head), part.head);
-    }
-    const declared = part.status !== void 0 || part.redirect !== void 0;
-    if (declared && contribution.status === void 0) {
-      contribution.status = (_b = part.status) != null ? _b : REDIRECT_FOUND;
-      contribution.redirect = part.redirect;
-    }
-  }
-  return contribution;
-}
-function resolveEagerUnits(container, descriptor) {
-  var _a;
-  for (const token of (_a = descriptor.eager) != null ? _a : []) {
-    const instance = container.resolve(token);
-    unitLogger(container, token.description).debug("eager: \u0435\u0434\u0438\u043D\u0438\u0446\u0430 \u043F\u043E\u0434\u043D\u044F\u0442\u0430 \u043F\u0440\u0438 \u043C\u043E\u043D\u0442\u0438\u0440\u043E\u0432\u0430\u043D\u0438\u0438");
-    if (instance instanceof Promise) {
-      instance.catch(
-        (error) => unitLogger(container, token.description).error("eager: \u0435\u0434\u0438\u043D\u0438\u0446\u0430 \u043D\u0435 \u043F\u043E\u0434\u043D\u044F\u043B\u0430\u0441\u044C", error)
-      );
-    }
-  }
-}
-
-// src/island/render.ts
-var STATUS_OK = 200;
-function renderApp(descriptor, request) {
-  return __async(this, null, function* () {
-    var _a, _b;
-    const route = {
-      params: (_a = request.params) != null ? _a : {},
-      pathname: request.pathname,
-      search: (_b = request.search) != null ? _b : ""
-    };
-    const container = createIslandContainer(descriptor, { parent: request.parent });
-    if (container === null) {
-      throw new Error(`den/island: \u043F\u0440\u0438\u043B\u043E\u0436\u0435\u043D\u0438\u0435 \xAB${descriptor.name}\xBB \u043D\u0435 \u0441\u043E\u0431\u0440\u0430\u043B\u043E\u0441\u044C \u2014 \u0440\u0435\u043D\u0434\u0435\u0440 \u043D\u0435\u0432\u043E\u0437\u043C\u043E\u0436\u0435\u043D`);
-    }
-    try {
-      yield activateIslandViewModels(container, descriptor, route);
-      const { head, redirect, status = STATUS_OK } = collectDocumentContribution(container, descriptor);
-      if (status !== STATUS_OK) {
-        return { head, html: "", redirect, state: {}, status };
-      }
-      const state = collectIslandState(container, descriptor);
-      const rendered = resolveViewAdapter(container).renderIsland(descriptor, {
-        container,
-        slots: request.slots
-      });
-      return { head, headHtml: rendered.head, html: rendered.html, state, status };
-    } finally {
-      yield container.dispose();
-    }
-  });
-}
+} from "../chunk-6FNC3XMI.js";
 
 // src/island/slot-address.ts
 function slotAddress(app, slot) {
@@ -209,11 +67,6 @@ function describeIsland(descriptor, denState) {
     viewModels: ((_b = descriptor.viewModels) != null ? _b : []).map((vm) => vm.token.description)
   };
 }
-
-// src/island/routes.ts
-function normalizeRoutes(routes = []) {
-  return routes.map((route) => typeof route === "string" ? { source: route } : route);
-}
 export {
   ViewLayerToken,
   activateIslandViewModels,
@@ -225,7 +78,9 @@ export {
   getIslandsSnapshot,
   hydrateIslandState,
   isDocumentSource,
+  matchRoute,
   normalizeRoutes,
+  pathPattern,
   registerIsland,
   renderApp,
   resolveEagerUnits,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foxford/den",
-  "version": "3.0.0",
+  "version": "3.1.1",
   "description": "Den — декларативный метафреймворк Foxford (core runtime)",
   "keywords": [
     "foxford",
@@ -19,9 +19,21 @@
     }
   ],
   "type": "module",
+  "bin": {
+    "den": "./den.js"
+  },
   "dependencies": {
-    "@foxford/ioc": "^1.1.2",
-    "@foxford/logger": "^1.2.2"
+    "fastify": "^5.11.2",
+    "@foxford/logger": "^1.2.2",
+    "@foxford/ioc": "^1.1.2"
+  },
+  "peerDependencies": {
+    "vite": ">=5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": true
+    }
   },
   "main": "./index.cjs",
   "module": "./index.js",
@@ -36,6 +48,16 @@
       "require": "./adapter.cjs",
       "types": "./adapter.d.ts"
     },
+    "./bin": {
+      "import": "./bin/den.js",
+      "require": "./bin/den.cjs",
+      "types": "./bin/den.d.ts"
+    },
+    "./build": {
+      "import": "./builder/index.js",
+      "require": "./builder/index.cjs",
+      "types": "./builder/index.d.ts"
+    },
     "./define": {
       "import": "./define.js",
       "require": "./define.cjs",
@@ -45,6 +67,11 @@
       "import": "./island/index.js",
       "require": "./island/index.cjs",
       "types": "./island/index.d.ts"
+    },
+    "./serve": {
+      "import": "./serve/index.js",
+      "require": "./serve/index.cjs",
+      "types": "./serve/index.d.ts"
     }
   },
   "files": [
@@ -53,35 +80,51 @@
     "adapter.d.cts",
     "adapter.d.ts",
     "adapter.js",
-    "chunk-5DJZZML5.cjs",
+    "bin",
+    "builder",
+    "chunk-3RX2OSUL.js",
+    "chunk-6FNC3XMI.js",
+    "chunk-6QV4L6R2.cjs",
     "chunk-A6ZPAM6Z.cjs",
     "chunk-C7BM4DGX.cjs",
     "chunk-E23E2VUC.js",
-    "chunk-HJO26HIQ.js",
+    "chunk-MCN4GFEQ.js",
+    "chunk-OKRO4G4L.cjs",
+    "chunk-REFU7UMG.js",
+    "chunk-T5QVCXVB.cjs",
     "chunk-TPBI6TOU.js",
+    "chunk-TPHJUDHG.js",
     "chunk-WBHHHICS.js",
-    "chunk-WRQC6BVJ.js",
-    "chunk-XHYR3SGG.cjs",
     "chunk-XOJ2VWX4.cjs",
-    "define-repository-Ca62_YCy.d.ts",
-    "define-repository-MDEWHqM7.d.cts",
-    "define-slot-BKvArA02.d.cts",
-    "define-slot-Dil8Kr1A.d.ts",
+    "chunk-Z5BL4DJA.cjs",
+    "chunk-ZOU6W6ZQ.cjs",
+    "define-repository-CwAXed2X.d.cts",
+    "define-repository-q_T4hqeP.d.ts",
+    "define-slot-Cngzae6i.d.ts",
+    "define-slot-DYNCLDJY.d.cts",
     "define.cjs",
     "define.d.cts",
     "define.d.ts",
     "define.js",
+    "den.js",
+    "descriptor-DQ6Gi7A_.d.ts",
+    "descriptor-Dujg_1on.d.cts",
     "index.cjs",
     "index.d.cts",
     "index.d.ts",
     "index.js",
     "island",
     "package.json",
-    "types-COwVwgzE.d.cts",
-    "types-COwVwgzE.d.ts",
-    "view-adapter-BvDC5O4y.d.cts",
-    "view-adapter-DtNgyjIf.d.ts"
+    "routes-0uXJ0fux.d.ts",
+    "routes-B0hDrkiF.d.cts",
+    "serve",
+    "server-render-CocWXQKC.d.cts",
+    "server-render-CocWXQKC.d.ts",
+    "types-Dx5qGiwk.d.cts",
+    "types-Dx5qGiwk.d.ts",
+    "view-adapter-B4gEb-ms.d.ts",
+    "view-adapter-DJ7yB6Ml.d.cts"
   ],
-  "sha": "ba6123d",
+  "sha": "dd4b7ca",
   "scripts": {}
 }

package/routes-0uXJ0fux.d.ts

@@ -0,0 +1,64 @@
+import { G as GuardDefinition } from './types-Dx5qGiwk.js';
+
+/** Маршрут с политикой доступа. */
+interface RouteDeclaration {
+    /** Regex-источник адреса (`'^/cabinet/billing'`, `'.*'`). */
+    source: string;
+    /**
+     * Guard-ы этого маршрута — поверх guard-ов приложения и хоста. Пусто — маршрут открыт
+     * настолько, насколько открыто само приложение.
+     */
+    guards?: ReadonlyArray<GuardDefinition>;
+}
+/**
+ * Заявка на адрес: голая строка — публичный маршрут, объект — маршрут со своей политикой.
+ * Обе формы лежат в одном массиве, и порядок значим так же, как раньше: хост раздаёт путь
+ * первому заявившему, поэтому частные записи ставятся выше общих.
+ */
+type AppRoute = string | RouteDeclaration;
+/**
+ * Приводит заявки к одной форме — чтобы хост и dev-инструменты не разбирали union каждый сам.
+ *
+ * @param routes - Заявки приложения (строки и/или записи)
+ * @returns Записи маршрутов в порядке объявления
+ */
+declare function normalizeRoutes(routes?: ReadonlyArray<AppRoute>): RouteDeclaration[];
+/** Совпадение адреса с заявкой: сама запись и выделенные ею параметры. */
+interface RouteMatch {
+    route: RouteDeclaration;
+    /** Именованные группы совпавшего маршрута; пусто, если их нет. */
+    params: Record<string, string>;
+}
+/**
+ * Ищет первую заявку, которой принадлежит путь, и выделяет её параметры.
+ *
+ * Один матчер на всех, потому что совпадений в системе два и они обязаны сходиться: хост решает
+ * по нему, кому отдать адрес, а рантайм приложения — своё ли это. Разойдись они, приложение
+ * получало бы запросы по путям, которых не заявляло.
+ *
+ * Параметры — именованные группы регулярки (`(?<slug>[^/]+)`); писать их руками не нужно,
+ * для этого есть {@link pathPattern}. Безымянные группы в параметры не попадают: у них нет
+ * имени, под которым их ждать.
+ *
+ * @param routes - Заявки приложения в порядке объявления
+ * @param pathname - Путь без search
+ * @returns Совпадение либо `null`
+ */
+declare function matchRoute(routes: ReadonlyArray<AppRoute> | undefined, pathname: string): RouteMatch | null;
+/**
+ * Делает из шаблона адреса источник регулярки с именованными группами:
+ * `'/:foo/:bar'` → `'^/(?<foo>[^/]+)/(?<bar>[^/]+)$'`.
+ *
+ * Отдельным помощником, а не распознаванием `:` прямо в `source`: заявка объявляется
+ * регуляркой, и в ней двоеточие — обычный символ. Угадывай мы синтаксис по содержимому
+ * строки — законная регулярка однажды молча сменила бы смысл.
+ *
+ * Шаблон привязан к обоим концам (`^…$`): `'/:slug'` означает один сегмент, а не «путь,
+ * который где-то внутри похож на сегмент».
+ *
+ * @param pattern - Шаблон адреса с сегментами-параметрами
+ * @returns Источник для {@link RouteDeclaration.source}
+ */
+declare function pathPattern(pattern: string): string;
+
+export { type AppRoute as A, type RouteDeclaration as R, type RouteMatch as a, matchRoute as m, normalizeRoutes as n, pathPattern as p };

package/routes-B0hDrkiF.d.cts

@@ -0,0 +1,64 @@
+import { G as GuardDefinition } from './types-Dx5qGiwk.cjs';
+
+/** Маршрут с политикой доступа. */
+interface RouteDeclaration {
+    /** Regex-источник адреса (`'^/cabinet/billing'`, `'.*'`). */
+    source: string;
+    /**
+     * Guard-ы этого маршрута — поверх guard-ов приложения и хоста. Пусто — маршрут открыт
+     * настолько, насколько открыто само приложение.
+     */
+    guards?: ReadonlyArray<GuardDefinition>;
+}
+/**
+ * Заявка на адрес: голая строка — публичный маршрут, объект — маршрут со своей политикой.
+ * Обе формы лежат в одном массиве, и порядок значим так же, как раньше: хост раздаёт путь
+ * первому заявившему, поэтому частные записи ставятся выше общих.
+ */
+type AppRoute = string | RouteDeclaration;
+/**
+ * Приводит заявки к одной форме — чтобы хост и dev-инструменты не разбирали union каждый сам.
+ *
+ * @param routes - Заявки приложения (строки и/или записи)
+ * @returns Записи маршрутов в порядке объявления
+ */
+declare function normalizeRoutes(routes?: ReadonlyArray<AppRoute>): RouteDeclaration[];
+/** Совпадение адреса с заявкой: сама запись и выделенные ею параметры. */
+interface RouteMatch {
+    route: RouteDeclaration;
+    /** Именованные группы совпавшего маршрута; пусто, если их нет. */
+    params: Record<string, string>;
+}
+/**
+ * Ищет первую заявку, которой принадлежит путь, и выделяет её параметры.
+ *
+ * Один матчер на всех, потому что совпадений в системе два и они обязаны сходиться: хост решает
+ * по нему, кому отдать адрес, а рантайм приложения — своё ли это. Разойдись они, приложение
+ * получало бы запросы по путям, которых не заявляло.
+ *
+ * Параметры — именованные группы регулярки (`(?<slug>[^/]+)`); писать их руками не нужно,
+ * для этого есть {@link pathPattern}. Безымянные группы в параметры не попадают: у них нет
+ * имени, под которым их ждать.
+ *
+ * @param routes - Заявки приложения в порядке объявления
+ * @param pathname - Путь без search
+ * @returns Совпадение либо `null`
+ */
+declare function matchRoute(routes: ReadonlyArray<AppRoute> | undefined, pathname: string): RouteMatch | null;
+/**
+ * Делает из шаблона адреса источник регулярки с именованными группами:
+ * `'/:foo/:bar'` → `'^/(?<foo>[^/]+)/(?<bar>[^/]+)$'`.
+ *
+ * Отдельным помощником, а не распознаванием `:` прямо в `source`: заявка объявляется
+ * регуляркой, и в ней двоеточие — обычный символ. Угадывай мы синтаксис по содержимому
+ * строки — законная регулярка однажды молча сменила бы смысл.
+ *
+ * Шаблон привязан к обоим концам (`^…$`): `'/:slug'` означает один сегмент, а не «путь,
+ * который где-то внутри похож на сегмент».
+ *
+ * @param pattern - Шаблон адреса с сегментами-параметрами
+ * @returns Источник для {@link RouteDeclaration.source}
+ */
+declare function pathPattern(pattern: string): string;
+
+export { type AppRoute as A, type RouteDeclaration as R, type RouteMatch as a, matchRoute as m, normalizeRoutes as n, pathPattern as p };

package/serve/index.cjs

@@ -0,0 +1,137 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+
+
+var _chunkZOU6W6ZQcjs = require('../chunk-ZOU6W6ZQ.cjs');
+require('../chunk-XOJ2VWX4.cjs');
+require('../chunk-6QV4L6R2.cjs');
+
+
+var _chunkA6ZPAM6Zcjs = require('../chunk-A6ZPAM6Z.cjs');
+
+
+var _chunkT5QVCXVBcjs = require('../chunk-T5QVCXVB.cjs');
+
+// src/serve/index.ts
+var _fastify = require('fastify'); var _fastify2 = _interopRequireDefault(_fastify);
+var _logger = require('@foxford/logger');
+
+// src/serve/plugin.ts
+
+var DEFAULT_SLOW_RENDER_MS = 1e3;
+function claim(app) {
+  return _chunkZOU6W6ZQcjs.normalizeRoutes.call(void 0, app.routes).map((route) => route.source);
+}
+function matchClaim(app, pathname) {
+  var _a, _b;
+  if (claim(app).length === 0) {
+    return {};
+  }
+  return (_b = (_a = _chunkZOU6W6ZQcjs.matchRoute.call(void 0, app.routes, pathname)) == null ? void 0 : _a.params) != null ? _b : null;
+}
+function parseCookies(header) {
+  const cookies = {};
+  for (const part of (header != null ? header : "").split(";")) {
+    const eq = part.indexOf("=");
+    if (eq < 1) {
+      continue;
+    }
+    const name = part.slice(0, eq).trim();
+    if (name && !(name in cookies)) {
+      cookies[name] = part.slice(eq + 1).trim();
+    }
+  }
+  return cookies;
+}
+function browserContext(req) {
+  const headers = {};
+  const forwarded = {
+    "accept-language": req.headers["x-forwarded-accept-language"],
+    host: req.headers["x-forwarded-host"]
+  };
+  for (const [name, value] of Object.entries(forwarded)) {
+    if (typeof value === "string" && value !== "") {
+      headers[name] = value;
+    }
+  }
+  const cookie = req.headers.cookie;
+  if (typeof cookie === "string" && cookie !== "") {
+    headers.cookie = cookie;
+  }
+  return { cookies: parseCookies(cookie), headers };
+}
+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);
+  });
+  instance.get("/_render", (req, reply) => _chunkT5QVCXVBcjs.__async.call(void 0, null, null, function* () {
+    const target = req.query.url;
+    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" });
+    }
+    const { pathname, search } = new URL(target, "http://localhost");
+    const params = matchClaim(app, pathname);
+    if (params === null) {
+      serveLog.error(`\u043F\u0443\u0442\u044C \xAB${pathname}\xBB \u0432\u043D\u0435 \u0437\u0430\u044F\u0432\u043A\u0438 \u043F\u0440\u0438\u043B\u043E\u0436\u0435\u043D\u0438\u044F`);
+      return reply.code(404).send({ error: `\u043F\u0443\u0442\u044C \xAB${pathname}\xBB \u0432\u043D\u0435 \u0437\u0430\u044F\u0432\u043A\u0438 \u043F\u0440\u0438\u043B\u043E\u0436\u0435\u043D\u0438\u044F` });
+    }
+    const startedAt = Date.now();
+    try {
+      const result = yield _chunkZOU6W6ZQcjs.renderApp.call(void 0, app, { context: browserContext(req), params, pathname, search });
+      const elapsed = Date.now() - startedAt;
+      if (elapsed >= slowRenderMs) {
+        serveLog.warn(`\u043C\u0435\u0434\u043B\u0435\u043D\u043D\u044B\u0439 \u0440\u0435\u043D\u0434\u0435\u0440 \xAB${pathname}\xBB: ${String(elapsed)}\u043C\u0441`);
+      }
+      return result;
+    } catch (error) {
+      serveLog.error(`\u0440\u0435\u043D\u0434\u0435\u0440 \xAB${pathname}\xBB \u0443\u043F\u0430\u043B \u0437\u0430 ${String(Date.now() - startedAt)}\u043C\u0441`, error);
+      return reply.code(500).send({ error: error instanceof Error ? error.message : String(error) });
+    }
+  }));
+  return Promise.resolve();
+};
+
+// src/serve/index.ts
+var SHUTDOWN_SIGNALS = ["SIGTERM", "SIGINT"];
+function serveApp(_0) {
+  return _chunkT5QVCXVBcjs.__async.call(void 0, this, arguments, function* (app, options = {}) {
+    var _a, _b, _c, _d;
+    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 });
+    yield instance.register(appPlugin, { app, slowRenderMs: options.slowRenderMs });
+    instance.addHook("onRequest", (req, _reply, done) => {
+      serveLog.debug(`\u2192 ${req.method} ${req.url}`);
+      done();
+    });
+    instance.addHook("onResponse", (req, reply, done) => {
+      const elapsed = reply.elapsedTime.toFixed(1);
+      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 });
+    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();
+        });
+      }
+    }
+    serveLog.info(
+      `\u043F\u0440\u0438\u043B\u043E\u0436\u0435\u043D\u0438\u0435 \xAB${app.name}\xBB \u0441\u043B\u0443\u0448\u0430\u0435\u0442 ${instance.addresses().map((a) => String(a.port)).join(", ")}`
+    );
+    return instance;
+  });
+}
+
+
+
+exports.appPlugin = appPlugin; exports.serveApp = serveApp;

package/serve/index.d.cts

@@ -0,0 +1,60 @@
+import { I as IslandDescriptor } from '../descriptor-Dujg_1on.cjs';
+import { A as AppRoute } from '../routes-B0hDrkiF.cjs';
+import { FastifyPluginAsync, FastifyInstance } from 'fastify';
+import '../define-slot-DYNCLDJY.cjs';
+import '../types-Dx5qGiwk.cjs';
+import '@foxford/ioc';
+
+/** Приложение, которое можно поднять сервисом: остров плюс его заявка на адреса. */
+type ServableApp = IslandDescriptor & {
+    routes?: ReadonlyArray<AppRoute>;
+};
+/** Настройки плагина. */
+interface AppPluginOptions {
+    app: ServableApp;
+    /** Порог, выше которого рендер считается медленным и уходит в `warn`, мс. */
+    slowRenderMs?: number;
+}
+/**
+ * Регистрирует ручки приложения на инстансе fastify: `/_render`, `/_routes`, `/_health`.
+ *
+ * Плагином, поэтому монтируется и в свой сервер, и в чужой — под префиксом, рядом с ручками
+ * потребителя, вместе с его плагинами.
+ *
+ * @param instance - Инстанс fastify
+ * @param options - Приложение и порог медленного рендера
+ */
+declare const appPlugin: FastifyPluginAsync<AppPluginOptions>;
+
+/** Настройки инстанса. */
+interface ServeAppOptions {
+    /** Порт; `0` — свободный, фактический смотри в `server.addresses()`. */
+    port?: number;
+    /** Интерфейс прослушивания. */
+    host?: string;
+    /** Порог, выше которого рендер считается медленным и уходит в `warn`, мс. */
+    slowRenderMs?: number;
+    /**
+     * Расширение инстанса ДО прослушивания: сюда потребитель регистрирует свои плагины.
+     * Вызывается после ручек приложения, поэтому хуки видят и их.
+     */
+    configure?: (instance: FastifyInstance) => void | Promise<void>;
+    /**
+     * Закрывать инстанс по `SIGTERM`/`SIGINT`. По умолчанию да: сервис живёт в оркестраторе,
+     * который именно так и просит его уйти, а незакрытый инстанс рвёт запросы на середине.
+     */
+    gracefulShutdown?: boolean;
+}
+/**
+ * Поднимает приложение отдельным сервисом.
+ *
+ * Сахар над {@link appPlugin}: если сервер нужен свой (общий порт с чужими ручками, свой
+ * порядок плагинов), бери плагин и регистрируй сам.
+ *
+ * @param app - Дескриптор приложения вместе с его заявкой на адреса
+ * @param options - Порт, расширение инстанса, поведение при остановке
+ * @returns Слушающий инстанс fastify
+ */
+declare function serveApp(app: ServableApp, options?: ServeAppOptions): Promise<FastifyInstance>;
+
+export { type AppPluginOptions, type ServableApp, type ServeAppOptions, appPlugin, serveApp };