@foxford/den 3.1.4 → 3.2.1

package/bin/den.cjs

@@ -1,7 +1,8 @@
 "use strict";
 
 
-var _chunkZBB5SBEVcjs = require('../chunk-ZBB5SBEV.cjs');
+var _chunkUB3GCX73cjs = require('../chunk-UB3GCX73.cjs');
+require('../chunk-KQAB6C6Q.cjs');
 require('../chunk-A6ZPAM6Z.cjs');
 
 
@@ -69,11 +70,11 @@ function run(argv) {
     }
     const target = { base: options["base"], root: (_a = options["root"]) != null ? _a : process.cwd() };
     if (command === "build") {
-      yield _chunkZBB5SBEVcjs.buildApp.call(void 0, target);
+      yield _chunkUB3GCX73cjs.buildApp.call(void 0, target);
       return;
     }
     if (command === "dev") {
-      yield _chunkZBB5SBEVcjs.devApp.call(void 0, target);
+      yield _chunkUB3GCX73cjs.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,8 @@
 import {
   buildApp,
   devApp
-} from "../chunk-YECHY3NR.js";
+} from "../chunk-URSWYSZF.js";
+import "../chunk-RG7ZV5BD.js";
 import "../chunk-TPBI6TOU.js";
 import {
   __async

package/builder/index.cjs

@@ -2,11 +2,12 @@
 
 
 
-var _chunkZBB5SBEVcjs = require('../chunk-ZBB5SBEV.cjs');
+var _chunkUB3GCX73cjs = require('../chunk-UB3GCX73.cjs');
+require('../chunk-KQAB6C6Q.cjs');
 require('../chunk-A6ZPAM6Z.cjs');
 require('../chunk-T5QVCXVB.cjs');
 
 
 
 
-exports.buildApp = _chunkZBB5SBEVcjs.buildApp; exports.defineAppConfig = _chunkZBB5SBEVcjs.defineAppConfig; exports.devApp = _chunkZBB5SBEVcjs.devApp;
+exports.buildApp = _chunkUB3GCX73cjs.buildApp; exports.defineAppConfig = _chunkUB3GCX73cjs.defineAppConfig; exports.devApp = _chunkUB3GCX73cjs.devApp;

package/builder/index.d.cts

@@ -53,6 +53,14 @@ interface AppServerConfig {
      * по parent-chain на любом рендере.
      */
     container?: (container: Container) => void;
+    /**
+     * Порт процесса приложения.
+     *
+     * `PORT` в окружении важнее: порт назначает тот, кто процесс поднимает, — в проде оркестратор.
+     * Объявление здесь — умолчание самого приложения, чтобы адрес не приходилось повторять в каждой
+     * команде запуска и в префиксе артефактов.
+     */
+    port?: number;
     /**
      * Расширение сетевого инстанса до начала прослушивания: Sentry, метрики, cors.
      *
@@ -99,18 +107,30 @@ type BuildMode = 'production' | 'development';
 interface BuildAppOptions {
     /** Корень приложения. */
     root: string;
-    /** Префикс адресов артефактов: в проде CDN, в разработке развязка у хоста. */
+    /**
+     * Префикс адресов артефактов: в проде CDN.
+     *
+     * Не задан — в разработке подставляется адрес самого приложения (артефакты отдаёт оно),
+     * в проде корень.
+     */
     base?: string;
     /** Режим сборки; по умолчанию `production`. */
     mode?: BuildMode;
 }
+/** Чем сборка закончилась — то, что нужно знать поднимающему процесс. */
+interface AppBuildResult {
+    /** Префикс адресов артефактов, с которым собран клиентский выход. */
+    base: string;
+    /** Порт, который процесс будет слушать: окружение, затем умолчание приложения. */
+    port: number;
+}
 /**
  * Собирает приложение целиком.
  *
  * @param options - Корень приложения и префикс адресов артефактов
  * @throws Если конфига нет либо пресет сообщил, что ему не хватает объявленного
  */
-declare function buildApp(options: BuildAppOptions): Promise<void>;
+declare function buildApp(options: BuildAppOptions): Promise<AppBuildResult>;
 
 /** Наблюдение берёт те же опции, что сборка: путь у них один. */
 type DevAppOptions = BuildAppOptions;

package/builder/index.d.ts

@@ -53,6 +53,14 @@ interface AppServerConfig {
      * по parent-chain на любом рендере.
      */
     container?: (container: Container) => void;
+    /**
+     * Порт процесса приложения.
+     *
+     * `PORT` в окружении важнее: порт назначает тот, кто процесс поднимает, — в проде оркестратор.
+     * Объявление здесь — умолчание самого приложения, чтобы адрес не приходилось повторять в каждой
+     * команде запуска и в префиксе артефактов.
+     */
+    port?: number;
     /**
      * Расширение сетевого инстанса до начала прослушивания: Sentry, метрики, cors.
      *
@@ -99,18 +107,30 @@ type BuildMode = 'production' | 'development';
 interface BuildAppOptions {
     /** Корень приложения. */
     root: string;
-    /** Префикс адресов артефактов: в проде CDN, в разработке развязка у хоста. */
+    /**
+     * Префикс адресов артефактов: в проде CDN.
+     *
+     * Не задан — в разработке подставляется адрес самого приложения (артефакты отдаёт оно),
+     * в проде корень.
+     */
     base?: string;
     /** Режим сборки; по умолчанию `production`. */
     mode?: BuildMode;
 }
+/** Чем сборка закончилась — то, что нужно знать поднимающему процесс. */
+interface AppBuildResult {
+    /** Префикс адресов артефактов, с которым собран клиентский выход. */
+    base: string;
+    /** Порт, который процесс будет слушать: окружение, затем умолчание приложения. */
+    port: number;
+}
 /**
  * Собирает приложение целиком.
  *
  * @param options - Корень приложения и префикс адресов артефактов
  * @throws Если конфига нет либо пресет сообщил, что ему не хватает объявленного
  */
-declare function buildApp(options: BuildAppOptions): Promise<void>;
+declare function buildApp(options: BuildAppOptions): Promise<AppBuildResult>;
 
 /** Наблюдение берёт те же опции, что сборка: путь у них один. */
 type DevAppOptions = BuildAppOptions;

package/builder/index.js

@@ -2,7 +2,8 @@ import {
   buildApp,
   defineAppConfig,
   devApp
-} from "../chunk-YECHY3NR.js";
+} from "../chunk-URSWYSZF.js";
+import "../chunk-RG7ZV5BD.js";
 import "../chunk-TPBI6TOU.js";
 import "../chunk-6FNC3XMI.js";
 export {

package/chunk-KQAB6C6Q.cjs

@@ -0,0 +1,15 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }// src/serve/env.ts
+var _fs = require('fs'); var _fs2 = _interopRequireDefault(_fs);
+var _path = require('path'); var _path2 = _interopRequireDefault(_path);
+var ENV_FILE = ".env";
+function loadAppEnv(root) {
+  const file = _path2.default.join(root, ENV_FILE);
+  if (!_fs2.default.existsSync(file)) {
+    return;
+  }
+  process.loadEnvFile(file);
+}
+
+
+
+exports.loadAppEnv = loadAppEnv;

package/chunk-RG7ZV5BD.js

@@ -0,0 +1,15 @@
+// src/serve/env.ts
+import fs from "fs";
+import path from "path";
+var ENV_FILE = ".env";
+function loadAppEnv(root) {
+  const file = path.join(root, ENV_FILE);
+  if (!fs.existsSync(file)) {
+    return;
+  }
+  process.loadEnvFile(file);
+}
+
+export {
+  loadAppEnv
+};

package/{chunk-ZBB5SBEV.cjs → chunk-UB3GCX73.cjs}

@@ -1,5 +1,8 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
+var _chunkKQAB6C6Qcjs = require('./chunk-KQAB6C6Q.cjs');
+
+
 var _chunkA6ZPAM6Zcjs = require('./chunk-A6ZPAM6Z.cjs');
 
 
@@ -35,7 +38,7 @@ function collectAssets(outDir, base) {
   const css = [];
   const js = [];
   const seen = /* @__PURE__ */ new Set();
-  const prefix = base.endsWith("/") ? base : `${base}/`;
+  const prefix = base === "" ? "" : base.endsWith("/") ? base : `${base}/`;
   function walk(key) {
     var _a, _b;
     if (seen.has(key)) {
@@ -64,6 +67,10 @@ function collectAssets(outDir, base) {
 
 // src/serve/port.ts
 var DEFAULT_PORT = 3e3;
+function resolvePort(declared) {
+  var _a, _b;
+  return Number((_b = (_a = process.env["PORT"]) != null ? _a : declared) != null ? _b : DEFAULT_PORT);
+}
 
 // src/builder/entries.ts
 var VIRTUAL_CLIENT = "virtual:den/client";
@@ -102,27 +109,34 @@ if (server.render) {
 export default descriptor
 `;
 }
-function generateServerProcess(configPath) {
-  return `import { serveApp } from '@foxford/den/serve'
+function generateServerProcess(configPath, base, mode) {
+  const assets = mode === "development" ? `  assets: { base: ${JSON.stringify(base)}, dir: fileURLToPath(new URL('./client', import.meta.url)) },
+` : "";
+  return `import { fileURLToPath } from 'node:url'
+
+import { loadAppEnv, serveApp } from '@foxford/den/serve'
 
 import app from ${JSON.stringify(VIRTUAL_SERVER_APP)}
 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, {
-  configure: config.server?.configure,
+${assets}  configure: config.server?.configure,
   host: process.env.HOST,
-  port: Number(process.env.PORT ?? ${String(DEFAULT_PORT)}),
+  port: Number(process.env.PORT ?? config.server?.port ?? ${String(DEFAULT_PORT)}),
 })
 `;
 }
 
 // src/builder/plugin.ts
 function denAppModules(options) {
-  const { assets, config, configPath, entry } = options;
+  const { assets, base, config, configPath, entry, mode } = options;
   const sources = {
     [VIRTUAL_CLIENT]: () => generateClientEntry(entry, config.preset.clientEntry),
     [VIRTUAL_SERVER_APP]: () => generateServerApp(entry, configPath, assets),
-    [VIRTUAL_SERVER_PROCESS]: () => generateServerProcess(configPath)
+    [VIRTUAL_SERVER_PROCESS]: () => generateServerProcess(configPath, base, mode)
   };
   return {
     load: (id) => {
@@ -184,7 +198,9 @@ function viteConfigFor(options) {
   const { assets, base, config, configPath, entryFileNames, input, mode, outDir, root, target } = options;
   const entry = (_a = config.entry) != null ? _a : "src/index.ts";
   const composed = {
-    base,
+    // Сборщику относительный префикс, если своего нет: ленивые чанки тогда грузятся от адреса
+    // уже загруженного чанка, и подмена CDN уводит за собой и их
+    base: base === "" ? "./" : base,
     build: {
       // Клиентский выход чистит свой каталог сам, серверные — нет: они пишут рядом с уже
       // собранным клиентским, и очистка снесла бы его вместе с манифестом
@@ -202,7 +218,10 @@ function viteConfigFor(options) {
     // Режим объявляем явно: плагины сборщика выбирают по нему рантайм фреймворка, а через
     // программный вызов он иначе не доедет.
     mode,
-    plugins: [...config.preset.plugins, denAppModules({ assets, config, configPath, entry: _path2.default.join(root, entry) })],
+    plugins: [
+      ...config.preset.plugins,
+      denAppModules({ assets, base, config, configPath, entry: _path2.default.join(root, entry), mode })
+    ],
     root,
     ssr: { noExternal: (_c = (_b = config.server) == null ? void 0 : _b.noExternal) != null ? _c : [] }
   };
@@ -210,12 +229,15 @@ function viteConfigFor(options) {
 }
 function buildApp(options) {
   return _chunkT5QVCXVBcjs.__async.call(void 0, this, null, function* () {
-    var _a, _b;
-    const { base = "/", mode = "production" } = options;
+    var _a, _b, _c, _d;
+    const { mode = "production" } = options;
     process.env["NODE_ENV"] = mode;
     const root = _path2.default.resolve(options.root);
+    _chunkKQAB6C6Qcjs.loadAppEnv.call(void 0, root);
     const { config, configPath } = yield loadAppConfig(root);
-    const refusal = (_b = (_a = config.preset).validate) == null ? void 0 : _b.call(_a, dependenciesOf(root));
+    const port = resolvePort((_a = config.server) == null ? void 0 : _a.port);
+    const base = (_b = options.base) != null ? _b : "";
+    const refusal = (_d = (_c = config.preset).validate) == null ? void 0 : _d.call(_c, dependenciesOf(root));
     if (refusal !== void 0 && refusal !== null) {
       throw new Error(`den: ${refusal}`);
     }
@@ -246,11 +268,11 @@ function buildApp(options) {
         target: "server"
       }))
     );
+    return { base, port };
   });
 }
 
 // src/builder/dev.ts
-var _child_process = require('child_process');
 
 
 var _url = require('url');
@@ -284,7 +306,7 @@ function assetsSummary(assets) {
 }
 function bannerLines(facts2) {
   var _a;
-  const port = (_a = process.env["PORT"]) != null ? _a : String(DEFAULT_PORT);
+  const port = String((_a = facts2.port) != null ? _a : "");
   const network = networkAddress();
   const label = (title) => `  \u2192  ${title.padEnd(PAD)}`;
   return [
@@ -296,7 +318,10 @@ function bannerLines(facts2) {
     `${label("\u043B\u043E\u043A\u0430\u043B\u044C\u043D\u043E")}http://localhost:${port}`,
     ...network === void 0 ? [] : [`${label("\u0432 \u0441\u0435\u0442\u0438")}http://${network}:${port}`],
     `${label("\u0440\u0443\u0447\u043A\u0438")}${ENDPOINTS.join("   ")}`,
-    `${label("\u0430\u0440\u0442\u0435\u0444\u0430\u043A\u0442\u044B")}${assetsSummary(facts2.assets)}`,
+    // Префикс печатается, только когда он есть: при относительной сборке артефакты идут с
+    // адреса самого приложения, а он уже назван строкой выше
+    ...facts2.base === void 0 || facts2.base === "" ? [] : [`${label("\u043F\u0440\u0435\u0444\u0438\u043A\u0441")}${facts2.base}`],
+    `${label("\u0447\u0430\u043D\u043A\u0438")}${assetsSummary(facts2.assets)}`,
     `${label("\u0432\u044B\u0445\u043E\u0434\u044B")}${OUTPUTS.join(", ")}`,
     `${label("\u043F\u0440\u0430\u0432\u043A\u0438")}${facts2.watched.join(", ")}`,
     `${label("\u043A\u043B\u0430\u0432\u0438\u0448\u0438")}${SHORTCUTS.map(({ key, title }) => `${key} \u2014 ${title}`).join(", ")}`,
@@ -307,6 +332,63 @@ function helpLines() {
   return ["", "  \u043A\u043B\u0430\u0432\u0438\u0448\u0430 + enter:", ...SHORTCUTS.map(({ key, title }) => `    ${key}  ${title}`), ""];
 }
 
+// src/builder/process.ts
+var _child_process = require('child_process');
+var SHUTDOWN_TIMEOUT_MS = 5e3;
+function signalGroup(pid, signal) {
+  try {
+    process.kill(-pid, signal);
+  } catch (e) {
+  }
+}
+function appProcess(entry) {
+  let child = null;
+  function stop() {
+    return _chunkT5QVCXVBcjs.__async.call(void 0, this, null, function* () {
+      const running = child;
+      child = null;
+      if (!running || running.exitCode !== null || running.pid === void 0) {
+        return;
+      }
+      const { pid } = running;
+      yield new Promise((resolve) => {
+        const forced = setTimeout(() => signalGroup(pid, "SIGKILL"), SHUTDOWN_TIMEOUT_MS);
+        running.once("exit", () => {
+          clearTimeout(forced);
+          resolve();
+        });
+        signalGroup(pid, "SIGTERM");
+      });
+    });
+  }
+  function start(env) {
+    const started = _child_process.spawn.call(void 0, process.execPath, [...process.execArgv, entry], {
+      detached: true,
+      env: _chunkT5QVCXVBcjs.__spreadValues.call(void 0, _chunkT5QVCXVBcjs.__spreadValues.call(void 0, {}, process.env), env),
+      stdio: "inherit"
+    });
+    child = started;
+    started.on("exit", (code, signal) => {
+      if (child !== started) {
+        return;
+      }
+      child = null;
+      _chunkA6ZPAM6Zcjs.logger.error(`\u043F\u0440\u043E\u0446\u0435\u0441\u0441 \u043F\u0440\u0438\u043B\u043E\u0436\u0435\u043D\u0438\u044F \u0437\u0430\u0432\u0435\u0440\u0448\u0438\u043B\u0441\u044F \u0441\u0430\u043C (\u043A\u043E\u0434 ${String(code)}, \u0441\u0438\u0433\u043D\u0430\u043B ${String(signal)})`);
+    });
+  }
+  for (const signal of ["SIGINT", "SIGTERM"]) {
+    process.once(signal, () => {
+      void stop().then(() => process.exit(0));
+    });
+  }
+  process.on("exit", () => {
+    if ((child == null ? void 0 : child.pid) !== void 0) {
+      signalGroup(child.pid, "SIGTERM");
+    }
+  });
+  return { start, stop };
+}
+
 // src/builder/dev.ts
 var SERVER_ENTRY = "build/server.mjs";
 var WATCHED = ["src", "den.config.ts"];
@@ -315,7 +397,21 @@ function debugPattern(name) {
   return (name === void 0 ? DEBUG_SCOPES : [`${name}:*`, ...DEBUG_SCOPES]).join(",");
 }
 var DEBOUNCE_MS = 150;
-var SHUTDOWN_TIMEOUT_MS = 5e3;
+function watchSources(root, onChange) {
+  let pending = null;
+  for (const target of WATCHED) {
+    const watched = _path2.default.join(root, target);
+    if (!_fs2.default.existsSync(watched)) {
+      continue;
+    }
+    _fs2.default.watch(watched, { recursive: true }, () => {
+      if (pending) {
+        clearTimeout(pending);
+      }
+      pending = setTimeout(onChange, DEBOUNCE_MS);
+    });
+  }
+}
 function facts(root) {
   return _chunkT5QVCXVBcjs.__async.call(void 0, this, null, function* () {
     try {
@@ -338,52 +434,10 @@ function devApp(options) {
   return _chunkT5QVCXVBcjs.__async.call(void 0, this, null, function* () {
     _chunkA6ZPAM6Zcjs.logger.setDebug(true);
     const root = _path2.default.resolve(options.root);
-    const entry = _path2.default.join(root, SERVER_ENTRY);
-    let child = null;
-    let pending = null;
     let building = false;
     let dirty = false;
     const describe = describer(root);
-    function signalGroup(pid, signal) {
-      try {
-        process.kill(-pid, signal);
-      } catch (e) {
-      }
-    }
-    function stop() {
-      return _chunkT5QVCXVBcjs.__async.call(void 0, this, null, function* () {
-        const running = child;
-        child = null;
-        if (!running || running.exitCode !== null || running.pid === void 0) {
-          return;
-        }
-        const { pid } = running;
-        yield new Promise((resolve) => {
-          const forced = setTimeout(() => signalGroup(pid, "SIGKILL"), SHUTDOWN_TIMEOUT_MS);
-          running.once("exit", () => {
-            clearTimeout(forced);
-            resolve();
-          });
-          signalGroup(pid, "SIGTERM");
-        });
-      });
-    }
-    function start(name) {
-      var _a;
-      const started = _child_process.spawn.call(void 0, process.execPath, [...process.execArgv, entry], {
-        detached: true,
-        env: _chunkT5QVCXVBcjs.__spreadProps.call(void 0, _chunkT5QVCXVBcjs.__spreadValues.call(void 0, {}, process.env), { DEBUG: (_a = process.env["DEBUG"]) != null ? _a : debugPattern(name) }),
-        stdio: "inherit"
-      });
-      child = started;
-      started.on("exit", (code, signal) => {
-        if (child !== started) {
-          return;
-        }
-        child = null;
-        _chunkA6ZPAM6Zcjs.logger.error(`\u043F\u0440\u043E\u0446\u0435\u0441\u0441 \u043F\u0440\u0438\u043B\u043E\u0436\u0435\u043D\u0438\u044F \u0437\u0430\u0432\u0435\u0440\u0448\u0438\u043B\u0441\u044F \u0441\u0430\u043C (\u043A\u043E\u0434 ${String(code)}, \u0441\u0438\u0433\u043D\u0430\u043B ${String(signal)})`);
-      });
-    }
+    const app = appProcess(_path2.default.join(root, SERVER_ENTRY));
     function show(lines) {
       process.stdout.write(`${lines.join("\n")}
 `);
@@ -402,26 +456,27 @@ function devApp(options) {
           show(helpLines());
         }
         if (key === "q") {
-          void stop().then(() => process.exit(0));
+          void app.stop().then(() => process.exit(0));
         }
       });
     }
     function rebuild() {
       return _chunkT5QVCXVBcjs.__async.call(void 0, this, null, function* () {
+        var _a;
         if (building) {
           dirty = true;
-          return false;
+          return null;
         }
         building = true;
-        let built2 = false;
+        let built = null;
         try {
           do {
             dirty = false;
-            yield stop();
+            yield app.stop();
             try {
-              yield buildApp(_chunkT5QVCXVBcjs.__spreadProps.call(void 0, _chunkT5QVCXVBcjs.__spreadValues.call(void 0, {}, options), { mode: "development" }));
-              start((yield describe()).name);
-              built2 = true;
+              const result = yield buildApp(_chunkT5QVCXVBcjs.__spreadProps.call(void 0, _chunkT5QVCXVBcjs.__spreadValues.call(void 0, {}, options), { mode: "development" }));
+              app.start({ DEBUG: (_a = process.env["DEBUG"]) != null ? _a : debugPattern((yield describe()).name) });
+              built = result;
             } catch (error) {
               _chunkA6ZPAM6Zcjs.logger.error("\u0441\u0431\u043E\u0440\u043A\u0430 \u043D\u0435 \u043F\u0440\u043E\u0448\u043B\u0430 \u2014 \u0441\u0435\u0440\u0432\u0438\u0441 \u041D\u0415 \u041F\u041E\u0414\u041D\u042F\u0422, \u0436\u0434\u0443 \u043F\u0440\u0430\u0432\u043A\u0438:", error);
             }
@@ -429,38 +484,25 @@ function devApp(options) {
         } finally {
           building = false;
         }
-        return built2;
+        return built;
       });
     }
     const startedAt = Date.now();
-    const built = yield rebuild();
+    const address = yield rebuild();
     const elapsed = Date.now() - startedAt;
-    for (const target of WATCHED) {
-      const watched = _path2.default.join(root, target);
-      if (!_fs2.default.existsSync(watched)) {
-        continue;
-      }
-      _fs2.default.watch(watched, { recursive: true }, () => {
-        if (pending) {
-          clearTimeout(pending);
-        }
-        pending = setTimeout(() => void rebuild(), DEBOUNCE_MS);
-      });
-    }
-    if (built) {
-      show(bannerLines(_chunkT5QVCXVBcjs.__spreadValues.call(void 0, { elapsedMs: elapsed, mode: "development", watched: WATCHED }, yield describe())));
+    watchSources(root, () => void rebuild());
+    if (address !== null) {
+      show(
+        bannerLines(_chunkT5QVCXVBcjs.__spreadValues.call(void 0, {
+          base: address.base,
+          elapsedMs: elapsed,
+          mode: "development",
+          port: address.port,
+          watched: WATCHED
+        }, yield describe()))
+      );
     }
     listenForKeys();
-    for (const signal of ["SIGINT", "SIGTERM"]) {
-      process.once(signal, () => {
-        void stop().then(() => process.exit(0));
-      });
-    }
-    process.on("exit", () => {
-      if ((child == null ? void 0 : child.pid) !== void 0) {
-        signalGroup(child.pid, "SIGTERM");
-      }
-    });
   });
 }
 

package/{chunk-YECHY3NR.js → chunk-URSWYSZF.js}

@@ -1,3 +1,6 @@
+import {
+  loadAppEnv
+} from "./chunk-RG7ZV5BD.js";
 import {
   logger
 } from "./chunk-TPBI6TOU.js";
@@ -35,7 +38,7 @@ function collectAssets(outDir, base) {
   const css = [];
   const js = [];
   const seen = /* @__PURE__ */ new Set();
-  const prefix = base.endsWith("/") ? base : `${base}/`;
+  const prefix = base === "" ? "" : base.endsWith("/") ? base : `${base}/`;
   function walk(key) {
     var _a, _b;
     if (seen.has(key)) {
@@ -64,6 +67,10 @@ function collectAssets(outDir, base) {
 
 // src/serve/port.ts
 var DEFAULT_PORT = 3e3;
+function resolvePort(declared) {
+  var _a, _b;
+  return Number((_b = (_a = process.env["PORT"]) != null ? _a : declared) != null ? _b : DEFAULT_PORT);
+}
 
 // src/builder/entries.ts
 var VIRTUAL_CLIENT = "virtual:den/client";
@@ -102,27 +109,34 @@ if (server.render) {
 export default descriptor
 `;
 }
-function generateServerProcess(configPath) {
-  return `import { serveApp } from '@foxford/den/serve'
+function generateServerProcess(configPath, base, mode) {
+  const assets = mode === "development" ? `  assets: { base: ${JSON.stringify(base)}, dir: fileURLToPath(new URL('./client', import.meta.url)) },
+` : "";
+  return `import { fileURLToPath } from 'node:url'
+
+import { loadAppEnv, serveApp } from '@foxford/den/serve'
 
 import app from ${JSON.stringify(VIRTUAL_SERVER_APP)}
 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, {
-  configure: config.server?.configure,
+${assets}  configure: config.server?.configure,
   host: process.env.HOST,
-  port: Number(process.env.PORT ?? ${String(DEFAULT_PORT)}),
+  port: Number(process.env.PORT ?? config.server?.port ?? ${String(DEFAULT_PORT)}),
 })
 `;
 }
 
 // src/builder/plugin.ts
 function denAppModules(options) {
-  const { assets, config, configPath, entry } = options;
+  const { assets, base, config, configPath, entry, mode } = options;
   const sources = {
     [VIRTUAL_CLIENT]: () => generateClientEntry(entry, config.preset.clientEntry),
     [VIRTUAL_SERVER_APP]: () => generateServerApp(entry, configPath, assets),
-    [VIRTUAL_SERVER_PROCESS]: () => generateServerProcess(configPath)
+    [VIRTUAL_SERVER_PROCESS]: () => generateServerProcess(configPath, base, mode)
   };
   return {
     load: (id) => {
@@ -184,7 +198,9 @@ function viteConfigFor(options) {
   const { assets, base, config, configPath, entryFileNames, input, mode, outDir, root, target } = options;
   const entry = (_a = config.entry) != null ? _a : "src/index.ts";
   const composed = {
-    base,
+    // Сборщику относительный префикс, если своего нет: ленивые чанки тогда грузятся от адреса
+    // уже загруженного чанка, и подмена CDN уводит за собой и их
+    base: base === "" ? "./" : base,
     build: {
       // Клиентский выход чистит свой каталог сам, серверные — нет: они пишут рядом с уже
       // собранным клиентским, и очистка снесла бы его вместе с манифестом
@@ -202,7 +218,10 @@ function viteConfigFor(options) {
     // Режим объявляем явно: плагины сборщика выбирают по нему рантайм фреймворка, а через
     // программный вызов он иначе не доедет.
     mode,
-    plugins: [...config.preset.plugins, denAppModules({ assets, config, configPath, entry: path2.join(root, entry) })],
+    plugins: [
+      ...config.preset.plugins,
+      denAppModules({ assets, base, config, configPath, entry: path2.join(root, entry), mode })
+    ],
     root,
     ssr: { noExternal: (_c = (_b = config.server) == null ? void 0 : _b.noExternal) != null ? _c : [] }
   };
@@ -210,12 +229,15 @@ function viteConfigFor(options) {
 }
 function buildApp(options) {
   return __async(this, null, function* () {
-    var _a, _b;
-    const { base = "/", mode = "production" } = options;
+    var _a, _b, _c, _d;
+    const { mode = "production" } = options;
     process.env["NODE_ENV"] = mode;
     const root = path2.resolve(options.root);
+    loadAppEnv(root);
     const { config, configPath } = yield loadAppConfig(root);
-    const refusal = (_b = (_a = config.preset).validate) == null ? void 0 : _b.call(_a, dependenciesOf(root));
+    const port = resolvePort((_a = config.server) == null ? void 0 : _a.port);
+    const base = (_b = options.base) != null ? _b : "";
+    const refusal = (_d = (_c = config.preset).validate) == null ? void 0 : _d.call(_c, dependenciesOf(root));
     if (refusal !== void 0 && refusal !== null) {
       throw new Error(`den: ${refusal}`);
     }
@@ -246,11 +268,11 @@ function buildApp(options) {
         target: "server"
       }))
     );
+    return { base, port };
   });
 }
 
 // src/builder/dev.ts
-import { spawn } from "child_process";
 import fs3 from "fs";
 import path3 from "path";
 import { pathToFileURL } from "url";
@@ -284,7 +306,7 @@ function assetsSummary(assets) {
 }
 function bannerLines(facts2) {
   var _a;
-  const port = (_a = process.env["PORT"]) != null ? _a : String(DEFAULT_PORT);
+  const port = String((_a = facts2.port) != null ? _a : "");
   const network = networkAddress();
   const label = (title) => `  \u2192  ${title.padEnd(PAD)}`;
   return [
@@ -296,7 +318,10 @@ function bannerLines(facts2) {
     `${label("\u043B\u043E\u043A\u0430\u043B\u044C\u043D\u043E")}http://localhost:${port}`,
     ...network === void 0 ? [] : [`${label("\u0432 \u0441\u0435\u0442\u0438")}http://${network}:${port}`],
     `${label("\u0440\u0443\u0447\u043A\u0438")}${ENDPOINTS.join("   ")}`,
-    `${label("\u0430\u0440\u0442\u0435\u0444\u0430\u043A\u0442\u044B")}${assetsSummary(facts2.assets)}`,
+    // Префикс печатается, только когда он есть: при относительной сборке артефакты идут с
+    // адреса самого приложения, а он уже назван строкой выше
+    ...facts2.base === void 0 || facts2.base === "" ? [] : [`${label("\u043F\u0440\u0435\u0444\u0438\u043A\u0441")}${facts2.base}`],
+    `${label("\u0447\u0430\u043D\u043A\u0438")}${assetsSummary(facts2.assets)}`,
     `${label("\u0432\u044B\u0445\u043E\u0434\u044B")}${OUTPUTS.join(", ")}`,
     `${label("\u043F\u0440\u0430\u0432\u043A\u0438")}${facts2.watched.join(", ")}`,
     `${label("\u043A\u043B\u0430\u0432\u0438\u0448\u0438")}${SHORTCUTS.map(({ key, title }) => `${key} \u2014 ${title}`).join(", ")}`,
@@ -307,6 +332,63 @@ function helpLines() {
   return ["", "  \u043A\u043B\u0430\u0432\u0438\u0448\u0430 + enter:", ...SHORTCUTS.map(({ key, title }) => `    ${key}  ${title}`), ""];
 }
 
+// src/builder/process.ts
+import { spawn } from "child_process";
+var SHUTDOWN_TIMEOUT_MS = 5e3;
+function signalGroup(pid, signal) {
+  try {
+    process.kill(-pid, signal);
+  } catch (e) {
+  }
+}
+function appProcess(entry) {
+  let child = null;
+  function stop() {
+    return __async(this, null, function* () {
+      const running = child;
+      child = null;
+      if (!running || running.exitCode !== null || running.pid === void 0) {
+        return;
+      }
+      const { pid } = running;
+      yield new Promise((resolve) => {
+        const forced = setTimeout(() => signalGroup(pid, "SIGKILL"), SHUTDOWN_TIMEOUT_MS);
+        running.once("exit", () => {
+          clearTimeout(forced);
+          resolve();
+        });
+        signalGroup(pid, "SIGTERM");
+      });
+    });
+  }
+  function start(env) {
+    const started = spawn(process.execPath, [...process.execArgv, entry], {
+      detached: true,
+      env: __spreadValues(__spreadValues({}, process.env), env),
+      stdio: "inherit"
+    });
+    child = started;
+    started.on("exit", (code, signal) => {
+      if (child !== started) {
+        return;
+      }
+      child = null;
+      logger.error(`\u043F\u0440\u043E\u0446\u0435\u0441\u0441 \u043F\u0440\u0438\u043B\u043E\u0436\u0435\u043D\u0438\u044F \u0437\u0430\u0432\u0435\u0440\u0448\u0438\u043B\u0441\u044F \u0441\u0430\u043C (\u043A\u043E\u0434 ${String(code)}, \u0441\u0438\u0433\u043D\u0430\u043B ${String(signal)})`);
+    });
+  }
+  for (const signal of ["SIGINT", "SIGTERM"]) {
+    process.once(signal, () => {
+      void stop().then(() => process.exit(0));
+    });
+  }
+  process.on("exit", () => {
+    if ((child == null ? void 0 : child.pid) !== void 0) {
+      signalGroup(child.pid, "SIGTERM");
+    }
+  });
+  return { start, stop };
+}
+
 // src/builder/dev.ts
 var SERVER_ENTRY = "build/server.mjs";
 var WATCHED = ["src", "den.config.ts"];
@@ -315,7 +397,21 @@ function debugPattern(name) {
   return (name === void 0 ? DEBUG_SCOPES : [`${name}:*`, ...DEBUG_SCOPES]).join(",");
 }
 var DEBOUNCE_MS = 150;
-var SHUTDOWN_TIMEOUT_MS = 5e3;
+function watchSources(root, onChange) {
+  let pending = null;
+  for (const target of WATCHED) {
+    const watched = path3.join(root, target);
+    if (!fs3.existsSync(watched)) {
+      continue;
+    }
+    fs3.watch(watched, { recursive: true }, () => {
+      if (pending) {
+        clearTimeout(pending);
+      }
+      pending = setTimeout(onChange, DEBOUNCE_MS);
+    });
+  }
+}
 function facts(root) {
   return __async(this, null, function* () {
     try {
@@ -338,52 +434,10 @@ function devApp(options) {
   return __async(this, null, function* () {
     logger.setDebug(true);
     const root = path3.resolve(options.root);
-    const entry = path3.join(root, SERVER_ENTRY);
-    let child = null;
-    let pending = null;
     let building = false;
     let dirty = false;
     const describe = describer(root);
-    function signalGroup(pid, signal) {
-      try {
-        process.kill(-pid, signal);
-      } catch (e) {
-      }
-    }
-    function stop() {
-      return __async(this, null, function* () {
-        const running = child;
-        child = null;
-        if (!running || running.exitCode !== null || running.pid === void 0) {
-          return;
-        }
-        const { pid } = running;
-        yield new Promise((resolve) => {
-          const forced = setTimeout(() => signalGroup(pid, "SIGKILL"), SHUTDOWN_TIMEOUT_MS);
-          running.once("exit", () => {
-            clearTimeout(forced);
-            resolve();
-          });
-          signalGroup(pid, "SIGTERM");
-        });
-      });
-    }
-    function start(name) {
-      var _a;
-      const started = spawn(process.execPath, [...process.execArgv, entry], {
-        detached: true,
-        env: __spreadProps(__spreadValues({}, process.env), { DEBUG: (_a = process.env["DEBUG"]) != null ? _a : debugPattern(name) }),
-        stdio: "inherit"
-      });
-      child = started;
-      started.on("exit", (code, signal) => {
-        if (child !== started) {
-          return;
-        }
-        child = null;
-        logger.error(`\u043F\u0440\u043E\u0446\u0435\u0441\u0441 \u043F\u0440\u0438\u043B\u043E\u0436\u0435\u043D\u0438\u044F \u0437\u0430\u0432\u0435\u0440\u0448\u0438\u043B\u0441\u044F \u0441\u0430\u043C (\u043A\u043E\u0434 ${String(code)}, \u0441\u0438\u0433\u043D\u0430\u043B ${String(signal)})`);
-      });
-    }
+    const app = appProcess(path3.join(root, SERVER_ENTRY));
     function show(lines) {
       process.stdout.write(`${lines.join("\n")}
 `);
@@ -402,26 +456,27 @@ function devApp(options) {
           show(helpLines());
         }
         if (key === "q") {
-          void stop().then(() => process.exit(0));
+          void app.stop().then(() => process.exit(0));
         }
       });
     }
     function rebuild() {
       return __async(this, null, function* () {
+        var _a;
         if (building) {
           dirty = true;
-          return false;
+          return null;
         }
         building = true;
-        let built2 = false;
+        let built = null;
         try {
           do {
             dirty = false;
-            yield stop();
+            yield app.stop();
             try {
-              yield buildApp(__spreadProps(__spreadValues({}, options), { mode: "development" }));
-              start((yield describe()).name);
-              built2 = true;
+              const result = yield buildApp(__spreadProps(__spreadValues({}, options), { mode: "development" }));
+              app.start({ DEBUG: (_a = process.env["DEBUG"]) != null ? _a : debugPattern((yield describe()).name) });
+              built = result;
             } catch (error) {
               logger.error("\u0441\u0431\u043E\u0440\u043A\u0430 \u043D\u0435 \u043F\u0440\u043E\u0448\u043B\u0430 \u2014 \u0441\u0435\u0440\u0432\u0438\u0441 \u041D\u0415 \u041F\u041E\u0414\u041D\u042F\u0422, \u0436\u0434\u0443 \u043F\u0440\u0430\u0432\u043A\u0438:", error);
             }
@@ -429,38 +484,25 @@ function devApp(options) {
         } finally {
           building = false;
         }
-        return built2;
+        return built;
       });
     }
     const startedAt = Date.now();
-    const built = yield rebuild();
+    const address = yield rebuild();
     const elapsed = Date.now() - startedAt;
-    for (const target of WATCHED) {
-      const watched = path3.join(root, target);
-      if (!fs3.existsSync(watched)) {
-        continue;
-      }
-      fs3.watch(watched, { recursive: true }, () => {
-        if (pending) {
-          clearTimeout(pending);
-        }
-        pending = setTimeout(() => void rebuild(), DEBOUNCE_MS);
-      });
-    }
-    if (built) {
-      show(bannerLines(__spreadValues({ elapsedMs: elapsed, mode: "development", watched: WATCHED }, yield describe())));
+    watchSources(root, () => void rebuild());
+    if (address !== null) {
+      show(
+        bannerLines(__spreadValues({
+          base: address.base,
+          elapsedMs: elapsed,
+          mode: "development",
+          port: address.port,
+          watched: WATCHED
+        }, yield describe()))
+      );
     }
     listenForKeys();
-    for (const signal of ["SIGINT", "SIGTERM"]) {
-      process.once(signal, () => {
-        void stop().then(() => process.exit(0));
-      });
-    }
-    process.on("exit", () => {
-      if ((child == null ? void 0 : child.pid) !== void 0) {
-        signalGroup(child.pid, "SIGTERM");
-      }
-    });
   });
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foxford/den",
-  "version": "3.1.4",
+  "version": "3.2.1",
   "description": "Den — декларативный метафреймворк Foxford (core runtime)",
   "keywords": [
     "foxford",
@@ -24,8 +24,8 @@
   },
   "dependencies": {
     "fastify": "^5.11.2",
-    "@foxford/logger": "^1.2.2",
-    "@foxford/ioc": "^1.1.2"
+    "@foxford/ioc": "^1.1.2",
+    "@foxford/logger": "^1.2.2"
   },
   "peerDependencies": {
     "vite": ">=5.0.0"
@@ -88,15 +88,17 @@
     "chunk-A6ZPAM6Z.cjs",
     "chunk-C7BM4DGX.cjs",
     "chunk-E23E2VUC.js",
+    "chunk-KQAB6C6Q.cjs",
     "chunk-MCN4GFEQ.js",
+    "chunk-RG7ZV5BD.js",
     "chunk-T5QVCXVB.cjs",
     "chunk-TPBI6TOU.js",
     "chunk-TPHJUDHG.js",
+    "chunk-UB3GCX73.cjs",
+    "chunk-URSWYSZF.js",
     "chunk-WBHHHICS.js",
     "chunk-XOJ2VWX4.cjs",
-    "chunk-YECHY3NR.js",
     "chunk-Z5BL4DJA.cjs",
-    "chunk-ZBB5SBEV.cjs",
     "chunk-ZOU6W6ZQ.cjs",
     "define-repository-CwAXed2X.d.cts",
     "define-repository-q_T4hqeP.d.ts",
@@ -125,6 +127,6 @@
     "view-adapter-B4gEb-ms.d.ts",
     "view-adapter-DJ7yB6Ml.d.cts"
   ],
-  "sha": "d7b1436",
+  "sha": "57a2d9b",
   "scripts": {}
 }

package/serve/index.cjs

@@ -1,5 +1,8 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
+var _chunkKQAB6C6Qcjs = require('../chunk-KQAB6C6Q.cjs');
+
+
 
 
 var _chunkZOU6W6ZQcjs = require('../chunk-ZOU6W6ZQ.cjs');
@@ -16,6 +19,52 @@ var _chunkT5QVCXVBcjs = require('../chunk-T5QVCXVB.cjs');
 var _fastify = require('fastify'); var _fastify2 = _interopRequireDefault(_fastify);
 var _logger = require('@foxford/logger');
 
+// src/serve/assets.ts
+var _fs = require('fs');
+var _path = require('path'); var _path2 = _interopRequireDefault(_path);
+var MIME = {
+  ".css": "text/css",
+  ".gif": "image/gif",
+  ".jpeg": "image/jpeg",
+  ".jpg": "image/jpeg",
+  ".js": "text/javascript",
+  ".json": "application/json",
+  ".map": "application/json",
+  ".mjs": "text/javascript",
+  ".png": "image/png",
+  ".svg": "image/svg+xml",
+  ".ttf": "font/ttf",
+  ".webp": "image/webp",
+  ".woff": "font/woff",
+  ".woff2": "font/woff2"
+};
+var HASHED_DIR = "assets/";
+function assetsPrefix(base) {
+  const { pathname } = new URL(base, "http://assets.invalid");
+  return pathname.endsWith("/") ? pathname : `${pathname}/`;
+}
+function assetFile(dir, relative) {
+  const file = _path2.default.normalize(_path2.default.join(dir, relative));
+  return file.startsWith(_path2.default.normalize(dir)) ? file : null;
+}
+function registerAssets(instance, source) {
+  const dir = _path2.default.resolve(source.dir);
+  const prefix = assetsPrefix(source.base);
+  instance.get(`${prefix}*`, (request, reply) => {
+    var _a;
+    const relative = request.params["*"];
+    const file = assetFile(dir, relative);
+    if (file === null) {
+      return reply.code(404).send();
+    }
+    const stat = _fs.existsSync.call(void 0, file) ? _fs.statSync.call(void 0, file) : null;
+    if (stat === null || !stat.isFile()) {
+      return reply.code(404).send();
+    }
+    return reply.header("access-control-allow-origin", "*").header("cache-control", relative.startsWith(HASHED_DIR) ? "public, max-age=31536000, immutable" : "no-cache").header("content-length", stat.size).type((_a = MIME[_path2.default.extname(file)]) != null ? _a : "application/octet-stream").send(_fs.createReadStream.call(void 0, file));
+  });
+}
+
 // src/serve/plugin.ts
 
 var DEFAULT_SLOW_RENDER_MS = 1e3;
@@ -106,6 +155,9 @@ function serveApp(_0) {
     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 });
+    if (options.assets) {
+      registerAssets(instance, options.assets);
+    }
     instance.addHook("onRequest", (req, _reply, done) => {
       serveLog.debug(`\u2192 ${req.method} ${req.url}`);
       done();
@@ -134,4 +186,6 @@ function serveApp(_0) {
 
 
 
-exports.appPlugin = appPlugin; exports.serveApp = serveApp;
+
+
+exports.appPlugin = appPlugin; exports.loadAppEnv = _chunkKQAB6C6Qcjs.loadAppEnv; exports.registerAssets = registerAssets; exports.serveApp = serveApp;

package/serve/index.d.cts

@@ -1,10 +1,25 @@
+import { FastifyInstance, FastifyPluginAsync } from 'fastify';
 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';
 
+/** Что раздаётся и по какому префиксу. */
+interface AppAssetsSource {
+    /** Префикс адресов артефактов — тот, с которым собран клиентский выход. */
+    base: string;
+    /** Каталог клиентского выхода. */
+    dir: string;
+}
+/**
+ * Заводит раздачу артефактов на инстансе.
+ *
+ * @param instance - Инстанс fastify
+ * @param source - Префикс адресов и каталог выхода
+ */
+declare function registerAssets(instance: FastifyInstance, source: AppAssetsSource): void;
+
 /** Приложение, которое можно поднять сервисом: остров плюс его заявка на адреса. */
 type ServableApp = IslandDescriptor & {
     routes?: ReadonlyArray<AppRoute>;
@@ -26,6 +41,15 @@ interface AppPluginOptions {
  */
 declare const appPlugin: FastifyPluginAsync<AppPluginOptions>;
 
+/**
+ * Кладёт умолчания из `<root>/.env` в окружение процесса.
+ *
+ * Отсутствие файла — норма, а не отказ: он локальный и в репозиторий не попадает.
+ *
+ * @param root - Корень приложения
+ */
+declare function loadAppEnv(root: string): void;
+
 /** Настройки инстанса. */
 interface ServeAppOptions {
     /** Порт; `0` — свободный, фактический смотри в `server.addresses()`. */
@@ -44,6 +68,13 @@ interface ServeAppOptions {
      * который именно так и просит его уйти, а незакрытый инстанс рвёт запросы на середине.
      */
     gracefulShutdown?: boolean;
+    /**
+     * Клиентские артефакты приложения: префикс адресов и каталог выхода.
+     *
+     * Отдаёт их само приложение — адреса знает его сборка, а хост получает только ссылки. В
+     * проде перед процессом стоит CDN, и до него эти адреса не доходят.
+     */
+    assets?: AppAssetsSource;
 }
 /**
  * Поднимает приложение отдельным сервисом.
@@ -57,4 +88,4 @@ interface ServeAppOptions {
  */
 declare function serveApp(app: ServableApp, options?: ServeAppOptions): Promise<FastifyInstance>;
 
-export { type AppPluginOptions, type ServableApp, type ServeAppOptions, appPlugin, serveApp };
+export { type AppAssetsSource, type AppPluginOptions, type ServableApp, type ServeAppOptions, appPlugin, loadAppEnv, registerAssets, serveApp };

package/serve/index.d.ts

@@ -1,10 +1,25 @@
+import { FastifyInstance, FastifyPluginAsync } from 'fastify';
 import { I as IslandDescriptor } from '../descriptor-DQ6Gi7A_.js';
 import { A as AppRoute } from '../routes-0uXJ0fux.js';
-import { FastifyPluginAsync, FastifyInstance } from 'fastify';
 import '../define-slot-Cngzae6i.js';
 import '../types-Dx5qGiwk.js';
 import '@foxford/ioc';
 
+/** Что раздаётся и по какому префиксу. */
+interface AppAssetsSource {
+    /** Префикс адресов артефактов — тот, с которым собран клиентский выход. */
+    base: string;
+    /** Каталог клиентского выхода. */
+    dir: string;
+}
+/**
+ * Заводит раздачу артефактов на инстансе.
+ *
+ * @param instance - Инстанс fastify
+ * @param source - Префикс адресов и каталог выхода
+ */
+declare function registerAssets(instance: FastifyInstance, source: AppAssetsSource): void;
+
 /** Приложение, которое можно поднять сервисом: остров плюс его заявка на адреса. */
 type ServableApp = IslandDescriptor & {
     routes?: ReadonlyArray<AppRoute>;
@@ -26,6 +41,15 @@ interface AppPluginOptions {
  */
 declare const appPlugin: FastifyPluginAsync<AppPluginOptions>;
 
+/**
+ * Кладёт умолчания из `<root>/.env` в окружение процесса.
+ *
+ * Отсутствие файла — норма, а не отказ: он локальный и в репозиторий не попадает.
+ *
+ * @param root - Корень приложения
+ */
+declare function loadAppEnv(root: string): void;
+
 /** Настройки инстанса. */
 interface ServeAppOptions {
     /** Порт; `0` — свободный, фактический смотри в `server.addresses()`. */
@@ -44,6 +68,13 @@ interface ServeAppOptions {
      * который именно так и просит его уйти, а незакрытый инстанс рвёт запросы на середине.
      */
     gracefulShutdown?: boolean;
+    /**
+     * Клиентские артефакты приложения: префикс адресов и каталог выхода.
+     *
+     * Отдаёт их само приложение — адреса знает его сборка, а хост получает только ссылки. В
+     * проде перед процессом стоит CDN, и до него эти адреса не доходят.
+     */
+    assets?: AppAssetsSource;
 }
 /**
  * Поднимает приложение отдельным сервисом.
@@ -57,4 +88,4 @@ interface ServeAppOptions {
  */
 declare function serveApp(app: ServableApp, options?: ServeAppOptions): Promise<FastifyInstance>;
 
-export { type AppPluginOptions, type ServableApp, type ServeAppOptions, appPlugin, serveApp };
+export { type AppAssetsSource, type AppPluginOptions, type ServableApp, type ServeAppOptions, appPlugin, loadAppEnv, registerAssets, serveApp };

package/serve/index.js

@@ -1,3 +1,6 @@
+import {
+  loadAppEnv
+} from "../chunk-RG7ZV5BD.js";
 import {
   matchRoute,
   normalizeRoutes,
@@ -16,6 +19,52 @@ import {
 import Fastify from "fastify";
 import { log as log2 } from "@foxford/logger";
 
+// src/serve/assets.ts
+import { createReadStream, existsSync, statSync } from "fs";
+import path from "path";
+var MIME = {
+  ".css": "text/css",
+  ".gif": "image/gif",
+  ".jpeg": "image/jpeg",
+  ".jpg": "image/jpeg",
+  ".js": "text/javascript",
+  ".json": "application/json",
+  ".map": "application/json",
+  ".mjs": "text/javascript",
+  ".png": "image/png",
+  ".svg": "image/svg+xml",
+  ".ttf": "font/ttf",
+  ".webp": "image/webp",
+  ".woff": "font/woff",
+  ".woff2": "font/woff2"
+};
+var HASHED_DIR = "assets/";
+function assetsPrefix(base) {
+  const { pathname } = new URL(base, "http://assets.invalid");
+  return pathname.endsWith("/") ? pathname : `${pathname}/`;
+}
+function assetFile(dir, relative) {
+  const file = path.normalize(path.join(dir, relative));
+  return file.startsWith(path.normalize(dir)) ? file : null;
+}
+function registerAssets(instance, source) {
+  const dir = path.resolve(source.dir);
+  const prefix = assetsPrefix(source.base);
+  instance.get(`${prefix}*`, (request, reply) => {
+    var _a;
+    const relative = request.params["*"];
+    const file = assetFile(dir, relative);
+    if (file === null) {
+      return reply.code(404).send();
+    }
+    const stat = existsSync(file) ? statSync(file) : null;
+    if (stat === null || !stat.isFile()) {
+      return reply.code(404).send();
+    }
+    return reply.header("access-control-allow-origin", "*").header("cache-control", relative.startsWith(HASHED_DIR) ? "public, max-age=31536000, immutable" : "no-cache").header("content-length", stat.size).type((_a = MIME[path.extname(file)]) != null ? _a : "application/octet-stream").send(createReadStream(file));
+  });
+}
+
 // src/serve/plugin.ts
 import { log } from "@foxford/logger";
 var DEFAULT_SLOW_RENDER_MS = 1e3;
@@ -106,6 +155,9 @@ function serveApp(_0) {
     const serveLog = (_b = appLog.getLogger("serve")) != null ? _b : appLog;
     const instance = Fastify({ logger: false });
     yield instance.register(appPlugin, { app, slowRenderMs: options.slowRenderMs });
+    if (options.assets) {
+      registerAssets(instance, options.assets);
+    }
     instance.addHook("onRequest", (req, _reply, done) => {
       serveLog.debug(`\u2192 ${req.method} ${req.url}`);
       done();
@@ -133,5 +185,7 @@ function serveApp(_0) {
 }
 export {
   appPlugin,
+  loadAppEnv,
+  registerAssets,
   serveApp
 };