@foxford/den 3.2.3 → 3.2.5

package/README.mdx

@@ -177,16 +177,18 @@ describeDocument(): DocumentContribution {
 
 Рантайм вокруг дескриптора отдаёт три ручки:
 
-| Ручка | Ответ |
-| --- | --- |
-| `GET /_render?url=<path+search>` | `200` + ответ `renderApp` телом |
-| `GET /_routes` | `200` + массив regex-строк заявки на адреса |
-| `GET /_health` | `200 ok` |
+| Ручка                            | Ответ                                       |
+| -------------------------------- | ------------------------------------------- |
+| `GET /_render?url=<path+search>` | `200` + ответ `renderApp` телом             |
+| `GET /_routes`                   | `200` + массив regex-строк заявки на адреса |
+| `GET /_health`                   | `200 ok`                                    |
 
 **Статус HTTP описывает транспорт, а исход страницы едет полем `status` в теле.** `200` значит
 «приложение ответило» — хоть `404`, хоть редиректом. Всё остальное значит «до приложения не
 дошли»: `400` — сломанный запрос, `404` — неизвестная ручка или путь вне заявки, `500` — рендер
-упал. Так `404` от приложения не путается с `404` от неверно настроенного прокси.
+упал. Так `404` от приложения не путается с `404` от неверно настроенного прокси. Упавший
+рендер уходит как `reply.send(error)`: Fastify зовёт `onError` у потребителя с исходным
+исключением; тело — стандартный JSON ошибки Fastify.
 
 Браузерные заголовки рантайм читает только из `X-Forwarded-*` и кладёт в `RequestContextToken`;
 `Cookie` — обычным именем.
@@ -262,6 +264,7 @@ export default defineAppConfig({
     render: (tree, render) => ({ head: sheet.getStyleTags(), html: render(sheet.collectStyles(tree)) }),
     container: (c) => c.bind(HttpConfigToken).toValue({ baseUrl: process.env.API_ORIGIN }),
     configure: (instance) => Sentry.setupFastifyErrorHandler(instance),
+    external: ['@foxford/den-sentry'],
     noExternal: ['@foxford/ui', 'styled-components'],
   },
 })
@@ -270,11 +273,11 @@ export default defineAppConfig({
 `den build [--root <каталог>] [--base <префикс>]` выпускает три выхода, `den dev` — то же плюс
 подъём процесса и пересборка на изменение исходников:
 
-| Выход | Что внутри | Кто потребляет |
-| --- | --- | --- |
-| `build/client` | браузерный бандл и манифест | браузер, по ссылкам из ответа рендера |
-| `build/server` | дескриптор с вплавленными серверными кусками конфига | хост, импортом в своём процессе |
-| `build/server.mjs` | тот же дескриптор под сетевым рантаймом | `node build/server.mjs` |
+| Выход              | Что внутри                                           | Кто потребляет                        |
+| ------------------ | ---------------------------------------------------- | ------------------------------------- |
+| `build/client`     | браузерный бандл и манифест                          | браузер, по ссылкам из ответа рендера |
+| `build/server`     | дескриптор с вплавленными серверными кусками конфига | хост, импортом в своём процессе       |
+| `build/server.mjs` | тот же дескриптор под сетевым рантаймом              | `node build/server.mjs`               |
 
 **Про фреймворк команда не знает.** Чем собирать и чем оживлять, приносит пресет из пакета
 адаптера, поэтому приложение на другом фреймворке подключается своим пресетом и в командах не
@@ -297,12 +300,12 @@ export default defineAppConfig({
 
 ## Подпути
 
-| Подпуть | Что там |
-| --- | --- |
-| `@foxford/den` | рантайм, `define*`, менеджеры контейнеров и состояния |
-| `@foxford/den/define` | те же `define*` без сайд-эффекта установки резолвера |
-| `@foxford/den/adapter` | шов резолва для адаптеров хостов |
-| `@foxford/den/island` | остров: жизненный цикл, шов `renderApp`, порт `ViewAdapter` |
-| `@foxford/den/serve` | сетевой транспорт: `serveApp`, `appPlugin` |
-| `@foxford/den/build` | конфиг приложения и сборка: `defineAppConfig`, `buildApp` |
-| `@foxford/den/bin` | точка входа команды `den` |
+| Подпуть                | Что там                                                     |
+| ---------------------- | ----------------------------------------------------------- |
+| `@foxford/den`         | рантайм, `define*`, менеджеры контейнеров и состояния       |
+| `@foxford/den/define`  | те же `define*` без сайд-эффекта установки резолвера        |
+| `@foxford/den/adapter` | шов резолва для адаптеров хостов                            |
+| `@foxford/den/island`  | остров: жизненный цикл, шов `renderApp`, порт `ViewAdapter` |
+| `@foxford/den/serve`   | сетевой транспорт: `serveApp`, `appPlugin`                  |
+| `@foxford/den/build`   | конфиг приложения и сборка: `defineAppConfig`, `buildApp`   |
+| `@foxford/den/bin`     | точка входа команды `den`                                   |

package/bin/den.cjs

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

package/bin/den.js

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

package/builder/index.cjs

@@ -2,7 +2,7 @@
 
 
 
-var _chunk3X4WVHUUcjs = require('../chunk-3X4WVHUU.cjs');
+var _chunkG6RT4EBOcjs = require('../chunk-G6RT4EBO.cjs');
 require('../chunk-KQAB6C6Q.cjs');
 require('../chunk-A6ZPAM6Z.cjs');
 require('../chunk-T5QVCXVB.cjs');
@@ -10,4 +10,4 @@ require('../chunk-T5QVCXVB.cjs');
 
 
 
-exports.buildApp = _chunk3X4WVHUUcjs.buildApp; exports.defineAppConfig = _chunk3X4WVHUUcjs.defineAppConfig; exports.devApp = _chunk3X4WVHUUcjs.devApp;
+exports.buildApp = _chunkG6RT4EBOcjs.buildApp; exports.defineAppConfig = _chunkG6RT4EBOcjs.defineAppConfig; exports.devApp = _chunkG6RT4EBOcjs.devApp;

package/builder/index.d.cts

@@ -75,6 +75,16 @@ interface AppServerConfig {
      * default-экспорта разъезжается, и вместо фабрики приходит пространство имён модуля.
      */
     noExternal?: Array<string | RegExp>;
+    /**
+     * Зависимости, которые серверный выход обязан оставить ВНЕШНИМИ, а не вплавить в бандл.
+     *
+     * Типичный случай — `@foxford/den-sentry`: вместе с ним в бандл уезжают `@sentry/node` и
+     * хуки `require`, а внутри `server.mjs` с top-level await их голый `require` даёт
+     * `ERR_AMBIGUOUS_MODULE_SYNTAX`. Пакет из npm остаётся снаружи целиком — транзитив
+     * грузится уже из его `node_modules`. Должен резолвиться из корня приложения (прямая
+     * зависимость в `package.json`).
+     */
+    external?: Array<string | RegExp>;
 }
 /** Конфиг приложения. */
 interface AppConfig {

package/builder/index.d.ts

@@ -75,6 +75,16 @@ interface AppServerConfig {
      * default-экспорта разъезжается, и вместо фабрики приходит пространство имён модуля.
      */
     noExternal?: Array<string | RegExp>;
+    /**
+     * Зависимости, которые серверный выход обязан оставить ВНЕШНИМИ, а не вплавить в бандл.
+     *
+     * Типичный случай — `@foxford/den-sentry`: вместе с ним в бандл уезжают `@sentry/node` и
+     * хуки `require`, а внутри `server.mjs` с top-level await их голый `require` даёт
+     * `ERR_AMBIGUOUS_MODULE_SYNTAX`. Пакет из npm остаётся снаружи целиком — транзитив
+     * грузится уже из его `node_modules`. Должен резолвиться из корня приложения (прямая
+     * зависимость в `package.json`).
+     */
+    external?: Array<string | RegExp>;
 }
 /** Конфиг приложения. */
 interface AppConfig {

package/builder/index.js

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

package/{chunk-XU5HUIPK.js → chunk-4XR6EUOW.js}

@@ -203,9 +203,10 @@ function dependenciesOf(root) {
   return [...Object.keys((_a = manifest.dependencies) != null ? _a : {}), ...Object.keys((_b = manifest.devDependencies) != null ? _b : {})];
 }
 function viteConfigFor(options) {
-  var _a, _b, _c, _d, _e;
+  var _a, _b, _c, _d, _e, _f, _g;
   const { assets, base, config, configPath, entryFileNames, input, mode, outDir, root, target } = options;
   const entry = (_a = config.entry) != null ? _a : "src/index.ts";
+  const external = (_c = (_b = config.server) == null ? void 0 : _b.external) != null ? _c : [];
   const composed = {
     // Сборщику относительный префикс, если своего нет: ленивые чанки тогда грузятся от адреса
     // уже загруженного чанка, и подмена CDN уводит за собой и их
@@ -220,7 +221,7 @@ function viteConfigFor(options) {
       // к файлу, а входы у нас виртуальные — их резолвит плагин
       rollupOptions: __spreadValues(__spreadValues({
         input
-      }, target === "server" ? { external: [ENGINE] } : {}), entryFileNames === void 0 ? {} : { output: { entryFileNames } }),
+      }, target === "server" ? { external: [ENGINE, ...external] } : {}), entryFileNames === void 0 ? {} : { output: { entryFileNames } }),
       ssr: target === "server"
     },
     configFile: false,
@@ -228,11 +229,14 @@ function viteConfigFor(options) {
     // программный вызов он иначе не доедет.
     mode,
     plugins: [
-      ...(_c = (_b = config.preset) == null ? void 0 : _b.plugins) != null ? _c : [],
+      ...(_e = (_d = config.preset) == null ? void 0 : _d.plugins) != null ? _e : [],
       denAppModules({ assets, base, config, configPath, entry: path2.join(root, entry), mode })
     ],
     root,
-    ssr: { noExternal: (_e = (_d = config.server) == null ? void 0 : _d.noExternal) != null ? _e : [] }
+    ssr: {
+      external,
+      noExternal: (_g = (_f = config.server) == null ? void 0 : _f.noExternal) != null ? _g : []
+    }
   };
   return config.vite ? config.vite(composed, target) : composed;
 }

package/{chunk-3X4WVHUU.cjs → chunk-G6RT4EBO.cjs}

@@ -203,9 +203,10 @@ function dependenciesOf(root) {
   return [...Object.keys((_a = manifest.dependencies) != null ? _a : {}), ...Object.keys((_b = manifest.devDependencies) != null ? _b : {})];
 }
 function viteConfigFor(options) {
-  var _a, _b, _c, _d, _e;
+  var _a, _b, _c, _d, _e, _f, _g;
   const { assets, base, config, configPath, entryFileNames, input, mode, outDir, root, target } = options;
   const entry = (_a = config.entry) != null ? _a : "src/index.ts";
+  const external = (_c = (_b = config.server) == null ? void 0 : _b.external) != null ? _c : [];
   const composed = {
     // Сборщику относительный префикс, если своего нет: ленивые чанки тогда грузятся от адреса
     // уже загруженного чанка, и подмена CDN уводит за собой и их
@@ -220,7 +221,7 @@ function viteConfigFor(options) {
       // к файлу, а входы у нас виртуальные — их резолвит плагин
       rollupOptions: _chunkT5QVCXVBcjs.__spreadValues.call(void 0, _chunkT5QVCXVBcjs.__spreadValues.call(void 0, {
         input
-      }, target === "server" ? { external: [ENGINE] } : {}), entryFileNames === void 0 ? {} : { output: { entryFileNames } }),
+      }, target === "server" ? { external: [ENGINE, ...external] } : {}), entryFileNames === void 0 ? {} : { output: { entryFileNames } }),
       ssr: target === "server"
     },
     configFile: false,
@@ -228,11 +229,14 @@ function viteConfigFor(options) {
     // программный вызов он иначе не доедет.
     mode,
     plugins: [
-      ...(_c = (_b = config.preset) == null ? void 0 : _b.plugins) != null ? _c : [],
+      ...(_e = (_d = config.preset) == null ? void 0 : _d.plugins) != null ? _e : [],
       denAppModules({ assets, base, config, configPath, entry: _path2.default.join(root, entry), mode })
     ],
     root,
-    ssr: { noExternal: (_e = (_d = config.server) == null ? void 0 : _d.noExternal) != null ? _e : [] }
+    ssr: {
+      external,
+      noExternal: (_g = (_f = config.server) == null ? void 0 : _f.noExternal) != null ? _g : []
+    }
   };
   return config.vite ? config.vite(composed, target) : composed;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foxford/den",
-  "version": "3.2.3",
+  "version": "3.2.5",
   "description": "Den — декларативный метафреймворк Foxford (core runtime)",
   "keywords": [
     "foxford",
@@ -90,13 +90,14 @@
     "bin",
     "builder",
     "chunk-3RX2OSUL.js",
-    "chunk-3X4WVHUU.cjs",
+    "chunk-4XR6EUOW.js",
     "chunk-6FNC3XMI.js",
     "chunk-6QV4L6R2.cjs",
     "chunk-A6ZPAM6Z.cjs",
     "chunk-C7BM4DGX.cjs",
     "chunk-E23E2VUC.js",
     "chunk-E56BKBQZ.js",
+    "chunk-G6RT4EBO.cjs",
     "chunk-H5DKRHHQ.cjs",
     "chunk-KQAB6C6Q.cjs",
     "chunk-RG7ZV5BD.js",
@@ -106,7 +107,6 @@
     "chunk-WBHHHICS.js",
     "chunk-XDM6J4LJ.cjs",
     "chunk-XOJ2VWX4.cjs",
-    "chunk-XU5HUIPK.js",
     "define-repository-CwAXed2X.d.cts",
     "define-repository-q_T4hqeP.d.ts",
     "define-slot-DouHW8RK.d.cts",
@@ -134,6 +134,6 @@
     "view-adapter-BV62bdhM.d.ts",
     "view-adapter-DF1me25J.d.cts"
   ],
-  "sha": "8ba3d93",
+  "sha": "25ef468",
   "scripts": {}
 }

package/serve/index.cjs

@@ -140,7 +140,7 @@ var appPlugin = (instance, options) => {
       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 reply.send(error instanceof Error ? error : new Error(String(error)));
     }
   }));
   return Promise.resolve();

package/serve/index.js

@@ -140,7 +140,7 @@ var appPlugin = (instance, options) => {
       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 reply.send(error instanceof Error ? error : new Error(String(error)));
     }
   }));
   return Promise.resolve();