@foxford/den 3.7.0 → 4.0.0

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

@@ -66,7 +66,7 @@ function collectAssets(outDir, base) {
 }
 
 // src/serve/port.ts
-var DEFAULT_PORT = 3e3;
+var DEFAULT_PORT = 8080;
 function resolvePort(declared) {
   var _a, _b;
   return Number((_b = (_a = process.env["PORT"]) != null ? _a : declared) != null ? _b : DEFAULT_PORT);
@@ -145,7 +145,8 @@ loadAppEnv(fileURLToPath(new URL('..', import.meta.url)))
 await serveApp(app, {
 ${assets}  configure: config.server?.configure,
   host: process.env.HOST,
-  port: Number(process.env.PORT ?? config.server?.port ?? ${String(DEFAULT_PORT)}),
+  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)}),
 })
 `;
 }
@@ -201,7 +202,8 @@ function loadAppConfig(root) {
       configFile: false,
       logLevel: "silent",
       root,
-      server: { middlewareMode: true }
+      // Этот сервер только загружает конфиг; пересборкой в dev управляет watchSources.
+      server: { middlewareMode: true, watch: null }
     });
     try {
       const loaded = yield server.ssrLoadModule(configPath);
@@ -324,7 +326,7 @@ var _url = require('url');
 var _os = require('os'); var _os2 = _interopRequireDefault(_os);
 var TOOL = "den";
 var PAD = 11;
-var ENDPOINTS = ["/_render?url=<\u043F\u0443\u0442\u044C>", "/_routes", "/_health"];
+var ENDPOINTS = ["/_render?url=<\u043F\u0443\u0442\u044C>", "/_routes"];
 var OUTPUTS = ["build/client", "build/server", "build/server.mjs"];
 var SHORTCUTS = [
   { key: "r", title: "\u043F\u0435\u0440\u0435\u0441\u043E\u0431\u0440\u0430\u0442\u044C" },

package/{define-repository-AO7JI6Cb.d.ts → define-repository-Ck45La_2.d.ts}

@@ -1,4 +1,4 @@
-import { a as DefineServiceOptions, S as ServiceDefinition, b as DefineViewModelOptions, V as ViewModelDefinition, D as DefineRepositoryOptions, d as RepositoryDefinition } from './types-BxMQ-VOd.js';
+import { a as DefineServiceOptions, S as ServiceDefinition, b as DefineViewModelOptions, V as ViewModelDefinition, D as DefineRepositoryOptions, d as RepositoryDefinition } from './types-Ccd5bmt1.js';
 import { Token } from '@foxford/ioc';
 
 /**

package/{define-repository-C0MI-J32.d.cts → define-repository-DAyeXF48.d.cts}

@@ -1,4 +1,4 @@
-import { a as DefineServiceOptions, S as ServiceDefinition, b as DefineViewModelOptions, V as ViewModelDefinition, D as DefineRepositoryOptions, d as RepositoryDefinition } from './types-BxMQ-VOd.cjs';
+import { a as DefineServiceOptions, S as ServiceDefinition, b as DefineViewModelOptions, V as ViewModelDefinition, D as DefineRepositoryOptions, d as RepositoryDefinition } from './types-Ccd5bmt1.cjs';
 import { Token } from '@foxford/ioc';
 
 /**

package/{define-slot-CdWdFM16.d.ts → define-slot-BTlLQ__T.d.ts}

@@ -1,4 +1,4 @@
-import { c as Definition, L as LayerDefinition } from './types-BxMQ-VOd.js';
+import { c as Definition, L as LayerDefinition } from './types-Ccd5bmt1.js';
 import { Container } from '@foxford/ioc';
 
 /**

package/{define-slot-BEeHNEph.d.cts → define-slot-C6hrdJS3.d.cts}

@@ -1,4 +1,4 @@
-import { c as Definition, L as LayerDefinition } from './types-BxMQ-VOd.cjs';
+import { c as Definition, L as LayerDefinition } from './types-Ccd5bmt1.cjs';
 import { Container } from '@foxford/ioc';
 
 /**

package/define.d.cts

@@ -1,6 +1,6 @@
-export { d as defineRepository, a as defineService, b as defineViewModel } from './define-repository-C0MI-J32.cjs';
-export { D as DefineSlotOptions, S as SlotDefinition, d as defineSlot } from './define-slot-BEeHNEph.cjs';
-export { D as DefineRepositoryOptions, a as DefineServiceOptions, b as DefineViewModelOptions, c as Definition, d as RepositoryDefinition, S as ServiceDefinition, e as SlotEntry, f as SlotRegistry, g as SlotRegistryToken, V as ViewModelDefinition } from './types-BxMQ-VOd.cjs';
+export { d as defineRepository, a as defineService, b as defineViewModel } from './define-repository-DAyeXF48.cjs';
+export { D as DefineSlotOptions, S as SlotDefinition, d as defineSlot } from './define-slot-C6hrdJS3.cjs';
+export { D as DefineRepositoryOptions, a as DefineServiceOptions, b as DefineViewModelOptions, c as Definition, d as RepositoryDefinition, S as ServiceDefinition, e as SlotEntry, f as SlotRegistry, g as SlotRegistryToken, V as ViewModelDefinition } from './types-Ccd5bmt1.cjs';
 import { Token, Container } from '@foxford/ioc';
 import { HierarchicalLogger } from '@foxford/logger';
 

package/define.d.ts

@@ -1,6 +1,6 @@
-export { d as defineRepository, a as defineService, b as defineViewModel } from './define-repository-AO7JI6Cb.js';
-export { D as DefineSlotOptions, S as SlotDefinition, d as defineSlot } from './define-slot-CdWdFM16.js';
-export { D as DefineRepositoryOptions, a as DefineServiceOptions, b as DefineViewModelOptions, c as Definition, d as RepositoryDefinition, S as ServiceDefinition, e as SlotEntry, f as SlotRegistry, g as SlotRegistryToken, V as ViewModelDefinition } from './types-BxMQ-VOd.js';
+export { d as defineRepository, a as defineService, b as defineViewModel } from './define-repository-Ck45La_2.js';
+export { D as DefineSlotOptions, S as SlotDefinition, d as defineSlot } from './define-slot-BTlLQ__T.js';
+export { D as DefineRepositoryOptions, a as DefineServiceOptions, b as DefineViewModelOptions, c as Definition, d as RepositoryDefinition, S as ServiceDefinition, e as SlotEntry, f as SlotRegistry, g as SlotRegistryToken, V as ViewModelDefinition } from './types-Ccd5bmt1.js';
 import { Token, Container } from '@foxford/ioc';
 import { HierarchicalLogger } from '@foxford/logger';
 

package/{descriptor-BSaHM5B4.d.ts → descriptor-CNJFrEbS.d.ts}

@@ -1,5 +1,5 @@
-import { S as SlotDefinition } from './define-slot-CdWdFM16.js';
-import { L as LayerDefinition, c as Definition } from './types-BxMQ-VOd.js';
+import { S as SlotDefinition } from './define-slot-BTlLQ__T.js';
+import { L as LayerDefinition, c as Definition } from './types-Ccd5bmt1.js';
 import { Token } from '@foxford/ioc';
 
 /**

package/{descriptor-C2j6Zz6c.d.cts → descriptor-DmfJP4jQ.d.cts}

@@ -1,5 +1,5 @@
-import { S as SlotDefinition } from './define-slot-BEeHNEph.cjs';
-import { L as LayerDefinition, c as Definition } from './types-BxMQ-VOd.cjs';
+import { S as SlotDefinition } from './define-slot-C6hrdJS3.cjs';
+import { L as LayerDefinition, c as Definition } from './types-Ccd5bmt1.cjs';
 import { Token } from '@foxford/ioc';
 
 /**

package/index.d.cts

@@ -1,11 +1,11 @@
-import { C as Core, j as ContainerManager, R as RequestContext, k as GuardRunner, l as Guard, m as GuardResult, N as NavigationManager, n as NavigationEntry, o as NavigationInterceptor, p as Disposable, q as LeaveGuardResult, r as StateSerializer, s as DefineGuardOptions, G as GuardDefinition, E as ExtensionConfig, t as DefineExtensionOptions, u as ExtensionDefinition, A as ActionGuard, v as DefineActionGuardOptions, w as ActionGuardDefinition, x as LayoutConfig, y as DefineLayoutOptions, z as LayoutDefinition, h as LayerConfig, B as DefineLayerOptions, L as LayerDefinition } from './types-BxMQ-VOd.cjs';
-export { F as Activatable, H as ActivatableToken, I as ContainerManagerToken, D as DefineRepositoryOptions, a as DefineServiceOptions, b as DefineViewModelOptions, c as Definition, J as GuardRunnerToken, K as NavigationManagerToken, d as RepositoryDefinition, i as RequestContextToken, S as ServiceDefinition, e as SlotEntry, f as SlotRegistry, g as SlotRegistryToken, M as StateCache, O as StateParticipant, P as StateRegistry, Q as StateRegistryToken, T as StateSerializerToken, V as ViewModelDefinition } from './types-BxMQ-VOd.cjs';
+import { C as Core, j as ContainerManager, R as RequestContext, k as GuardRunner, l as Guard, m as GuardResult, N as NavigationManager, n as NavigationEntry, o as NavigationInterceptor, p as Disposable, q as LeaveGuardResult, r as StateSerializer, s as DefineGuardOptions, G as GuardDefinition, E as ExtensionConfig, t as DefineExtensionOptions, u as ExtensionDefinition, A as ActionGuard, v as DefineActionGuardOptions, w as ActionGuardDefinition, x as LayoutConfig, y as DefineLayoutOptions, z as LayoutDefinition, h as LayerConfig, B as DefineLayerOptions, L as LayerDefinition } from './types-Ccd5bmt1.cjs';
+export { F as Activatable, H as ActivatableToken, I as ContainerManagerToken, D as DefineRepositoryOptions, a as DefineServiceOptions, b as DefineViewModelOptions, c as Definition, J as GuardRunnerToken, K as NavigationManagerToken, d as RepositoryDefinition, i as RequestContextToken, S as ServiceDefinition, e as SlotEntry, f as SlotRegistry, g as SlotRegistryToken, M as StateCache, O as StateParticipant, P as StateRegistry, Q as StateRegistryToken, T as StateSerializerToken, V as ViewModelDefinition } from './types-Ccd5bmt1.cjs';
 import { Container, Token } from '@foxford/ioc';
 import { DefinitionResolver } from './adapter.cjs';
-export { d as defineRepository, a as defineService, b as defineViewModel } from './define-repository-C0MI-J32.cjs';
-export { D as DefineSlotOptions, S as SlotDefinition, d as defineSlot } from './define-slot-BEeHNEph.cjs';
-export { V as ViewAdapter, a as ViewLayerDefinition, b as ViewLayerToken } from './view-adapter-DMLlp3Iu.cjs';
-import './descriptor-C2j6Zz6c.cjs';
+export { d as defineRepository, a as defineService, b as defineViewModel } from './define-repository-DAyeXF48.cjs';
+export { D as DefineSlotOptions, S as SlotDefinition, d as defineSlot } from './define-slot-C6hrdJS3.cjs';
+export { V as ViewAdapter, a as ViewLayerDefinition, b as ViewLayerToken } from './view-adapter-CrHh7CjB.cjs';
+import './descriptor-DmfJP4jQ.cjs';
 import './server-render-CocWXQKC.cjs';
 
 /**

package/index.d.ts

@@ -1,11 +1,11 @@
-import { C as Core, j as ContainerManager, R as RequestContext, k as GuardRunner, l as Guard, m as GuardResult, N as NavigationManager, n as NavigationEntry, o as NavigationInterceptor, p as Disposable, q as LeaveGuardResult, r as StateSerializer, s as DefineGuardOptions, G as GuardDefinition, E as ExtensionConfig, t as DefineExtensionOptions, u as ExtensionDefinition, A as ActionGuard, v as DefineActionGuardOptions, w as ActionGuardDefinition, x as LayoutConfig, y as DefineLayoutOptions, z as LayoutDefinition, h as LayerConfig, B as DefineLayerOptions, L as LayerDefinition } from './types-BxMQ-VOd.js';
-export { F as Activatable, H as ActivatableToken, I as ContainerManagerToken, D as DefineRepositoryOptions, a as DefineServiceOptions, b as DefineViewModelOptions, c as Definition, J as GuardRunnerToken, K as NavigationManagerToken, d as RepositoryDefinition, i as RequestContextToken, S as ServiceDefinition, e as SlotEntry, f as SlotRegistry, g as SlotRegistryToken, M as StateCache, O as StateParticipant, P as StateRegistry, Q as StateRegistryToken, T as StateSerializerToken, V as ViewModelDefinition } from './types-BxMQ-VOd.js';
+import { C as Core, j as ContainerManager, R as RequestContext, k as GuardRunner, l as Guard, m as GuardResult, N as NavigationManager, n as NavigationEntry, o as NavigationInterceptor, p as Disposable, q as LeaveGuardResult, r as StateSerializer, s as DefineGuardOptions, G as GuardDefinition, E as ExtensionConfig, t as DefineExtensionOptions, u as ExtensionDefinition, A as ActionGuard, v as DefineActionGuardOptions, w as ActionGuardDefinition, x as LayoutConfig, y as DefineLayoutOptions, z as LayoutDefinition, h as LayerConfig, B as DefineLayerOptions, L as LayerDefinition } from './types-Ccd5bmt1.js';
+export { F as Activatable, H as ActivatableToken, I as ContainerManagerToken, D as DefineRepositoryOptions, a as DefineServiceOptions, b as DefineViewModelOptions, c as Definition, J as GuardRunnerToken, K as NavigationManagerToken, d as RepositoryDefinition, i as RequestContextToken, S as ServiceDefinition, e as SlotEntry, f as SlotRegistry, g as SlotRegistryToken, M as StateCache, O as StateParticipant, P as StateRegistry, Q as StateRegistryToken, T as StateSerializerToken, V as ViewModelDefinition } from './types-Ccd5bmt1.js';
 import { Container, Token } from '@foxford/ioc';
 import { DefinitionResolver } from './adapter.js';
-export { d as defineRepository, a as defineService, b as defineViewModel } from './define-repository-AO7JI6Cb.js';
-export { D as DefineSlotOptions, S as SlotDefinition, d as defineSlot } from './define-slot-CdWdFM16.js';
-export { V as ViewAdapter, a as ViewLayerDefinition, b as ViewLayerToken } from './view-adapter-DNLRSFka.js';
-import './descriptor-BSaHM5B4.js';
+export { d as defineRepository, a as defineService, b as defineViewModel } from './define-repository-Ck45La_2.js';
+export { D as DefineSlotOptions, S as SlotDefinition, d as defineSlot } from './define-slot-BTlLQ__T.js';
+export { V as ViewAdapter, a as ViewLayerDefinition, b as ViewLayerToken } from './view-adapter-DPDvv09J.js';
+import './descriptor-CNJFrEbS.js';
 import './server-render-CocWXQKC.js';
 
 /**

package/island/index.d.cts

@@ -1,11 +1,11 @@
-import { A as AppAssets, I as IslandDescriptor } from '../descriptor-C2j6Zz6c.cjs';
-import { R as RequestContext, c as Definition } from '../types-BxMQ-VOd.cjs';
-export { i as RequestContextToken } from '../types-BxMQ-VOd.cjs';
+import { A as AppAssets, I as IslandDescriptor } from '../descriptor-DmfJP4jQ.cjs';
+import { R as RequestContext, c as Definition } from '../types-Ccd5bmt1.cjs';
+export { i as RequestContextToken } from '../types-Ccd5bmt1.cjs';
 import { Container, Token } from '@foxford/ioc';
-export { A as AppRoute, R as RouteDeclaration, a as RouteMatch, m as matchRoute, n as normalizeRoutes, p as pathPattern } from '../routes-BvV405k4.cjs';
+export { A as AppRoute, R as RouteDeclaration, a as RouteMatch, m as matchRoute, n as normalizeRoutes, p as pathPattern } from '../routes-DQ4ud4bu.cjs';
 export { R as RenderTree, a as ServerRender, S as ServerRenderResult } from '../server-render-CocWXQKC.cjs';
-export { R as RenderIslandOptions, V as ViewAdapter, a as ViewLayerDefinition, b as ViewLayerToken, r as resolveViewAdapter, v as viewAdapterOf } from '../view-adapter-DMLlp3Iu.cjs';
-import '../define-slot-BEeHNEph.cjs';
+export { R as RenderIslandOptions, V as ViewAdapter, a as ViewLayerDefinition, b as ViewLayerToken, r as resolveViewAdapter, v as viewAdapterOf } from '../view-adapter-CrHh7CjB.cjs';
+import '../define-slot-C6hrdJS3.cjs';
 
 /** Вклад приложения в `<head>` документа. */
 interface DocumentHead {
@@ -278,6 +278,9 @@ declare function parseCookieHeader(header: string | undefined): Record<string, s
 /**
  * Реквизиты запроса в браузере: куки документа, заголовков нет.
  *
+ * Реквизитов бэкенда тоже нет: в браузере их подставляет он сам — куку по своим правилам,
+ * остальное ему предъявлять нечем и незачем.
+ *
  * Биндится в контейнер острова при сборке, чтобы единица, требующая `RequestContextToken`,
  * резолвилась на обеих сторонах одинаково; иначе приложению пришлось бы держать две
  * реализации и переключать их по среде.

package/island/index.d.ts

@@ -1,11 +1,11 @@
-import { A as AppAssets, I as IslandDescriptor } from '../descriptor-BSaHM5B4.js';
-import { R as RequestContext, c as Definition } from '../types-BxMQ-VOd.js';
-export { i as RequestContextToken } from '../types-BxMQ-VOd.js';
+import { A as AppAssets, I as IslandDescriptor } from '../descriptor-CNJFrEbS.js';
+import { R as RequestContext, c as Definition } from '../types-Ccd5bmt1.js';
+export { i as RequestContextToken } from '../types-Ccd5bmt1.js';
 import { Container, Token } from '@foxford/ioc';
-export { A as AppRoute, R as RouteDeclaration, a as RouteMatch, m as matchRoute, n as normalizeRoutes, p as pathPattern } from '../routes-Di3K_0uQ.js';
+export { A as AppRoute, R as RouteDeclaration, a as RouteMatch, m as matchRoute, n as normalizeRoutes, p as pathPattern } from '../routes-TkIxQ0Uc.js';
 export { R as RenderTree, a as ServerRender, S as ServerRenderResult } from '../server-render-CocWXQKC.js';
-export { R as RenderIslandOptions, V as ViewAdapter, a as ViewLayerDefinition, b as ViewLayerToken, r as resolveViewAdapter, v as viewAdapterOf } from '../view-adapter-DNLRSFka.js';
-import '../define-slot-CdWdFM16.js';
+export { R as RenderIslandOptions, V as ViewAdapter, a as ViewLayerDefinition, b as ViewLayerToken, r as resolveViewAdapter, v as viewAdapterOf } from '../view-adapter-DPDvv09J.js';
+import '../define-slot-BTlLQ__T.js';
 
 /** Вклад приложения в `<head>` документа. */
 interface DocumentHead {
@@ -278,6 +278,9 @@ declare function parseCookieHeader(header: string | undefined): Record<string, s
 /**
  * Реквизиты запроса в браузере: куки документа, заголовков нет.
  *
+ * Реквизитов бэкенда тоже нет: в браузере их подставляет он сам — куку по своим правилам,
+ * остальное ему предъявлять нечем и незачем.
+ *
  * Биндится в контейнер острова при сборке, чтобы единица, требующая `RequestContextToken`,
  * резолвилась на обеих сторонах одинаково; иначе приложению пришлось бы держать две
  * реализации и переключать их по среде.

package/ops/index.cjs

@@ -0,0 +1,17 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+
+
+var _chunk2P5TAWRWcjs = require('../chunk-2P5TAWRW.cjs');
+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;

package/ops/index.d.cts

@@ -0,0 +1,39 @@
+import * as _prometheus_io_client from '@prometheus-io/client';
+import { Registry, Counter, Histogram } from '@prometheus-io/client';
+import { IncomingMessage, ServerResponse, Server } from 'node:http';
+
+/** Реестр одного процесса; точкам измерений не нужен включённый Sentry. */
+declare class ProcessMetrics {
+    readonly registry: Registry<_prometheus_io_client.RegistryContentType>;
+    private runtimeStarted;
+    counter(name: string, labelNames?: string[]): Counter<string>;
+    histogram(name: string, labelNames?: string[]): Histogram<string>;
+    /** Полный штатный набор Node/process-метрик клиента и дополнительные данные процесса. */
+    startRuntime(appName: string): void;
+    /** HTTP-измерения с ограниченными метками маршрута; вызывается один раз на запрос. */
+    trackHttp(req: IncomingMessage, res: ServerResponse, route: () => string): void;
+}
+declare function getProcessMetrics(): ProcessMetrics;
+
+/** Служебный путь без query; работает и с относительным URL node:http. */
+declare function isOpsPath(url?: string): boolean;
+/** Подключает штатную межпроцессную агрегацию; вызывается и в primary, и в воркерах. */
+declare function clusterMetrics(metrics?: ProcessMetrics): {
+    contentType: string;
+    collect: () => Promise<string>;
+    shutdown: () => Promise<void>;
+};
+interface OpsOptions {
+    port?: number;
+    host?: string;
+    metrics?: ProcessMetrics;
+    collect?: () => Promise<string>;
+    contentType?: string;
+    isLive?: () => boolean;
+}
+/** Второй HTTP-сервер в том же приложении. GET /healthz и /livez отвечают 200. */
+declare function startOpsServer(options?: OpsOptions): Promise<Server>;
+/** Ограниченное по времени закрытие обоих видов серверов node:http. */
+declare function closeHttpServer(server: Server, timeoutMs?: number): Promise<void>;
+
+export { type OpsOptions, ProcessMetrics, closeHttpServer, clusterMetrics, getProcessMetrics, isOpsPath, startOpsServer };

package/ops/index.d.ts

@@ -0,0 +1,39 @@
+import * as _prometheus_io_client from '@prometheus-io/client';
+import { Registry, Counter, Histogram } from '@prometheus-io/client';
+import { IncomingMessage, ServerResponse, Server } from 'node:http';
+
+/** Реестр одного процесса; точкам измерений не нужен включённый Sentry. */
+declare class ProcessMetrics {
+    readonly registry: Registry<_prometheus_io_client.RegistryContentType>;
+    private runtimeStarted;
+    counter(name: string, labelNames?: string[]): Counter<string>;
+    histogram(name: string, labelNames?: string[]): Histogram<string>;
+    /** Полный штатный набор Node/process-метрик клиента и дополнительные данные процесса. */
+    startRuntime(appName: string): void;
+    /** HTTP-измерения с ограниченными метками маршрута; вызывается один раз на запрос. */
+    trackHttp(req: IncomingMessage, res: ServerResponse, route: () => string): void;
+}
+declare function getProcessMetrics(): ProcessMetrics;
+
+/** Служебный путь без query; работает и с относительным URL node:http. */
+declare function isOpsPath(url?: string): boolean;
+/** Подключает штатную межпроцессную агрегацию; вызывается и в primary, и в воркерах. */
+declare function clusterMetrics(metrics?: ProcessMetrics): {
+    contentType: string;
+    collect: () => Promise<string>;
+    shutdown: () => Promise<void>;
+};
+interface OpsOptions {
+    port?: number;
+    host?: string;
+    metrics?: ProcessMetrics;
+    collect?: () => Promise<string>;
+    contentType?: string;
+    isLive?: () => boolean;
+}
+/** Второй HTTP-сервер в том же приложении. GET /healthz и /livez отвечают 200. */
+declare function startOpsServer(options?: OpsOptions): Promise<Server>;
+/** Ограниченное по времени закрытие обоих видов серверов node:http. */
+declare function closeHttpServer(server: Server, timeoutMs?: number): Promise<void>;
+
+export { type OpsOptions, ProcessMetrics, closeHttpServer, clusterMetrics, getProcessMetrics, isOpsPath, startOpsServer };

package/ops/index.js

@@ -0,0 +1,17 @@
+import {
+  ProcessMetrics,
+  closeHttpServer,
+  clusterMetrics,
+  getProcessMetrics,
+  isOpsPath,
+  startOpsServer
+} from "../chunk-DUU4MQ4B.js";
+import "../chunk-6FNC3XMI.js";
+export {
+  ProcessMetrics,
+  closeHttpServer,
+  clusterMetrics,
+  getProcessMetrics,
+  isOpsPath,
+  startOpsServer
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foxford/den",
-  "version": "3.7.0",
+  "version": "4.0.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-2P5TAWRW.cjs",
     "chunk-3RX2OSUL.js",
     "chunk-6FNC3XMI.js",
     "chunk-6QV4L6R2.cjs",
     "chunk-A6ZPAM6Z.cjs",
     "chunk-C7BM4DGX.cjs",
+    "chunk-DUU4MQ4B.js",
     "chunk-E23E2VUC.js",
     "chunk-E56BKBQZ.js",
+    "chunk-FMRORLLE.js",
     "chunk-H5DKRHHQ.cjs",
     "chunk-KQAB6C6Q.cjs",
-    "chunk-P4J4M2WZ.cjs",
+    "chunk-OC4LQ2CK.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": "46c9d1a",
   "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,13 @@ require('../chunk-6QV4L6R2.cjs');
 var _chunkA6ZPAM6Zcjs = require('../chunk-A6ZPAM6Z.cjs');
 
 
+
+
+
+var _chunk2P5TAWRWcjs = require('../chunk-2P5TAWRW.cjs');
+
+
+
 var _chunkT5QVCXVBcjs = require('../chunk-T5QVCXVB.cjs');
 
 // src/serve/index.ts
@@ -79,7 +86,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 +98,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";
   }
-  return { cookies: _chunkQTWJTYZWcjs.parseCookieHeader.call(void 0, cookie), headers };
+  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 = _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 +131,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 +144,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 +161,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"
@@ -157,10 +181,35 @@ var appPlugin = (instance, options) => {
 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 = _chunk2P5TAWRWcjs.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)) {
+        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 _chunk2P5TAWRWcjs.closeHttpServer.call(void 0, ops);
+      }
+    }));
     yield instance.register(appPlugin, { app, slowRenderMs: options.slowRenderMs });
     if (options.assets) {
       registerAssets(instance, options.assets);
@@ -174,14 +223,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 _chunk2P5TAWRWcjs.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(

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`.
  *
  * Плагином, поэтому монтируется и в свой сервер, и в чужой — под префиксом, рядом с ручками
  * потребителя, вместе с его плагинами.
@@ -54,6 +57,8 @@ declare function loadAppEnv(root: string): void;
 interface ServeAppOptions {
     /** Порт; `0` — свободный, фактический смотри в `server.addresses()`. */
     port?: number;
+    /** Второй HTTP-сервер для probes и метрик; false — подключается потребителем. */
+    ops?: OpsOptions | false;
     /** Интерфейс прослушивания. */
     host?: string;
     /** Порог, выше которого рендер считается медленным и уходит в `warn`, мс. */