@foxford/den 3.2.3 → 3.2.5-beta-3141d32-20260904

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,13 @@ 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`, очередь клиентских падений (`reportIslandError` / `installIslandErrorDrain`) |
+
+| `@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/island/index.cjs

@@ -23,6 +23,50 @@ require('../chunk-A6ZPAM6Z.cjs');
 
 var _chunkT5QVCXVBcjs = require('../chunk-T5QVCXVB.cjs');
 
+// src/island/errors.ts
+var ISLAND_ERRORS_KEY = "__DEN_ISLAND_ERRORS__";
+function denWindow() {
+  return typeof window === "undefined" ? void 0 : window;
+}
+function errorsSlot(w) {
+  const existing = w[ISLAND_ERRORS_KEY];
+  if (existing !== void 0) {
+    return existing;
+  }
+  const created = [];
+  w[ISLAND_ERRORS_KEY] = created;
+  return created;
+}
+function reportIslandError(error, context) {
+  const w = denWindow();
+  if (w === void 0) {
+    return;
+  }
+  errorsSlot(w).push({ context, error });
+}
+function installIslandErrorDrain(drain) {
+  const w = denWindow();
+  if (w === void 0) {
+    return;
+  }
+  if (drain === null) {
+    const empty = [];
+    w[ISLAND_ERRORS_KEY] = empty;
+    return;
+  }
+  const current = w[ISLAND_ERRORS_KEY];
+  const pending = Array.isArray(current) ? current : [];
+  for (const report of pending) {
+    drain(report.error, report.context);
+  }
+  w[ISLAND_ERRORS_KEY] = {
+    push(report) {
+      drain(report.error, report.context);
+      return 1;
+    }
+  };
+}
+
 // src/island/navigate.ts
 var NAVIGATE_EVENT = "den:navigate";
 function navigateIsland(node, route) {
@@ -122,4 +166,7 @@ function describeIsland(descriptor, denState) {
 
 
 
-exports.DOCUMENT_EVENT = DOCUMENT_EVENT; exports.NAVIGATE_EVENT = NAVIGATE_EVENT; exports.ViewLayerToken = _chunkXOJ2VWX4cjs.ViewLayerToken; exports.activateIslandViewModels = _chunkXDM6J4LJcjs.activateIslandViewModels; exports.collectDocumentContribution = _chunkXDM6J4LJcjs.collectDocumentContribution; exports.collectIslandState = _chunkXDM6J4LJcjs.collectIslandState; exports.createIslandContainer = _chunkXDM6J4LJcjs.createIslandContainer; exports.describeIsland = describeIsland; exports.getAppContainer = _chunkXDM6J4LJcjs.getAppContainer; exports.getIslandsSnapshot = getIslandsSnapshot; exports.hydrateIslandState = _chunkXDM6J4LJcjs.hydrateIslandState; exports.isDocumentSource = _chunkXDM6J4LJcjs.isDocumentSource; exports.matchRoute = _chunkXDM6J4LJcjs.matchRoute; exports.navigateIsland = navigateIsland; exports.normalizeRoutes = _chunkXDM6J4LJcjs.normalizeRoutes; exports.onIslandDocument = onIslandDocument; exports.onIslandNavigate = onIslandNavigate; exports.pathPattern = _chunkXDM6J4LJcjs.pathPattern; exports.publishIslandDocument = publishIslandDocument; exports.registerIsland = registerIsland; exports.renderApp = _chunkXDM6J4LJcjs.renderApp; exports.resolveEagerUnits = _chunkXDM6J4LJcjs.resolveEagerUnits; exports.resolveViewAdapter = _chunkXOJ2VWX4cjs.resolveViewAdapter; exports.slotAddress = slotAddress; exports.subscribeIslands = subscribeIslands; exports.viewAdapterOf = _chunkXOJ2VWX4cjs.viewAdapterOf;
+
+
+
+exports.DOCUMENT_EVENT = DOCUMENT_EVENT; exports.ISLAND_ERRORS_KEY = ISLAND_ERRORS_KEY; exports.NAVIGATE_EVENT = NAVIGATE_EVENT; exports.ViewLayerToken = _chunkXOJ2VWX4cjs.ViewLayerToken; exports.activateIslandViewModels = _chunkXDM6J4LJcjs.activateIslandViewModels; exports.collectDocumentContribution = _chunkXDM6J4LJcjs.collectDocumentContribution; exports.collectIslandState = _chunkXDM6J4LJcjs.collectIslandState; exports.createIslandContainer = _chunkXDM6J4LJcjs.createIslandContainer; exports.describeIsland = describeIsland; exports.getAppContainer = _chunkXDM6J4LJcjs.getAppContainer; exports.getIslandsSnapshot = getIslandsSnapshot; exports.hydrateIslandState = _chunkXDM6J4LJcjs.hydrateIslandState; exports.installIslandErrorDrain = installIslandErrorDrain; exports.isDocumentSource = _chunkXDM6J4LJcjs.isDocumentSource; exports.matchRoute = _chunkXDM6J4LJcjs.matchRoute; exports.navigateIsland = navigateIsland; exports.normalizeRoutes = _chunkXDM6J4LJcjs.normalizeRoutes; exports.onIslandDocument = onIslandDocument; exports.onIslandNavigate = onIslandNavigate; exports.pathPattern = _chunkXDM6J4LJcjs.pathPattern; exports.publishIslandDocument = publishIslandDocument; exports.registerIsland = registerIsland; exports.renderApp = _chunkXDM6J4LJcjs.renderApp; exports.reportIslandError = reportIslandError; exports.resolveEagerUnits = _chunkXDM6J4LJcjs.resolveEagerUnits; exports.resolveViewAdapter = _chunkXOJ2VWX4cjs.resolveViewAdapter; exports.slotAddress = slotAddress; exports.subscribeIslands = subscribeIslands; exports.viewAdapterOf = _chunkXOJ2VWX4cjs.viewAdapterOf;

package/island/index.d.cts

@@ -69,6 +69,51 @@ interface DocumentSource {
  */
 declare function isDocumentSource(value: unknown): value is DocumentSource;
 
+/**
+ * Клиентские падения острова между бандлами.
+ *
+ * Сетевое приложение оживает своим бандлом, хост — своим. У каждого своя копия модулей,
+ * module-level очередь в одной не видна в другой. Шина — один ключ на `window`.
+ *
+ * Остров всегда делает `.push({ error, context })` ({@link reportIslandError}). Пока хоста
+ * нет — это обычный массив. Хост после Sentry.init зовёт {@link installIslandErrorDrain}:
+ * сливает backlog и подменяет значение объектом с тем же `.push` — дальше ошибки идут
+ * сразу в приёмник. Обёртки нет: стек и тип остаются приложению.
+ */
+/** Фаза, на которой остров упал. */
+type IslandErrorPhase = 'render' | 'hydrate' | 'navigate';
+/** Контекст падения острова для приёмника. */
+interface IslandErrorContext {
+    /** Имя приложения из дескриптора. */
+    appName: string;
+    phase: IslandErrorPhase;
+}
+/** Одна запись: исходное исключение и контекст. */
+interface IslandErrorReport {
+    error: unknown;
+    context: IslandErrorContext;
+}
+/** Приёмник: хост шлёт в Sentry (или куда угодно). */
+type IslandErrorDrain = (error: unknown, context: IslandErrorContext) => void;
+/**
+ * Ключ на `window` — обязан совпадать у хоста и remote.
+ *
+ * Значение: массив (до приёмника) либо объект с `push` (после {@link installIslandErrorDrain}).
+ */
+declare const ISLAND_ERRORS_KEY = "__DEN_ISLAND_ERRORS__";
+/**
+ * Кладёт исходное исключение в шину на `window`.
+ *
+ * До приёмника — в массив; после — сразу в drain (тот же `.push`).
+ */
+declare function reportIslandError(error: unknown, context: IslandErrorContext): void;
+/**
+ * Сливает накопленное и подменяет слот drain-объектом с `.push`.
+ *
+ * Зовёт хост после инициализации наблюдаемости. `null` — снимает: снова обычный массив.
+ */
+declare function installIslandErrorDrain(drain: IslandErrorDrain | null): void;
+
 /**
  * Адрес, по которому рендерится остров.
  *
@@ -324,4 +369,4 @@ declare function getAppContainer(): Container;
  */
 declare function slotAddress(app: string, slot: string): string;
 
-export { AppAssets, type CreateIslandContainerOptions, DOCUMENT_EVENT, type DocumentContribution, type DocumentHead, type DocumentSource, IslandDescriptor, type IslandRecord, type IslandRoute, NAVIGATE_EVENT, type RenderAppRequest, type RenderAppResult, activateIslandViewModels, collectDocumentContribution, collectIslandState, createIslandContainer, describeIsland, getAppContainer, getIslandsSnapshot, hydrateIslandState, isDocumentSource, navigateIsland, onIslandDocument, onIslandNavigate, publishIslandDocument, registerIsland, renderApp, resolveEagerUnits, slotAddress, subscribeIslands };
+export { AppAssets, type CreateIslandContainerOptions, DOCUMENT_EVENT, type DocumentContribution, type DocumentHead, type DocumentSource, ISLAND_ERRORS_KEY, IslandDescriptor, type IslandErrorContext, type IslandErrorDrain, type IslandErrorPhase, type IslandErrorReport, type IslandRecord, type IslandRoute, NAVIGATE_EVENT, type RenderAppRequest, type RenderAppResult, activateIslandViewModels, collectDocumentContribution, collectIslandState, createIslandContainer, describeIsland, getAppContainer, getIslandsSnapshot, hydrateIslandState, installIslandErrorDrain, isDocumentSource, navigateIsland, onIslandDocument, onIslandNavigate, publishIslandDocument, registerIsland, renderApp, reportIslandError, resolveEagerUnits, slotAddress, subscribeIslands };

package/island/index.d.ts

@@ -69,6 +69,51 @@ interface DocumentSource {
  */
 declare function isDocumentSource(value: unknown): value is DocumentSource;
 
+/**
+ * Клиентские падения острова между бандлами.
+ *
+ * Сетевое приложение оживает своим бандлом, хост — своим. У каждого своя копия модулей,
+ * module-level очередь в одной не видна в другой. Шина — один ключ на `window`.
+ *
+ * Остров всегда делает `.push({ error, context })` ({@link reportIslandError}). Пока хоста
+ * нет — это обычный массив. Хост после Sentry.init зовёт {@link installIslandErrorDrain}:
+ * сливает backlog и подменяет значение объектом с тем же `.push` — дальше ошибки идут
+ * сразу в приёмник. Обёртки нет: стек и тип остаются приложению.
+ */
+/** Фаза, на которой остров упал. */
+type IslandErrorPhase = 'render' | 'hydrate' | 'navigate';
+/** Контекст падения острова для приёмника. */
+interface IslandErrorContext {
+    /** Имя приложения из дескриптора. */
+    appName: string;
+    phase: IslandErrorPhase;
+}
+/** Одна запись: исходное исключение и контекст. */
+interface IslandErrorReport {
+    error: unknown;
+    context: IslandErrorContext;
+}
+/** Приёмник: хост шлёт в Sentry (или куда угодно). */
+type IslandErrorDrain = (error: unknown, context: IslandErrorContext) => void;
+/**
+ * Ключ на `window` — обязан совпадать у хоста и remote.
+ *
+ * Значение: массив (до приёмника) либо объект с `push` (после {@link installIslandErrorDrain}).
+ */
+declare const ISLAND_ERRORS_KEY = "__DEN_ISLAND_ERRORS__";
+/**
+ * Кладёт исходное исключение в шину на `window`.
+ *
+ * До приёмника — в массив; после — сразу в drain (тот же `.push`).
+ */
+declare function reportIslandError(error: unknown, context: IslandErrorContext): void;
+/**
+ * Сливает накопленное и подменяет слот drain-объектом с `.push`.
+ *
+ * Зовёт хост после инициализации наблюдаемости. `null` — снимает: снова обычный массив.
+ */
+declare function installIslandErrorDrain(drain: IslandErrorDrain | null): void;
+
 /**
  * Адрес, по которому рендерится остров.
  *
@@ -324,4 +369,4 @@ declare function getAppContainer(): Container;
  */
 declare function slotAddress(app: string, slot: string): string;
 
-export { AppAssets, type CreateIslandContainerOptions, DOCUMENT_EVENT, type DocumentContribution, type DocumentHead, type DocumentSource, IslandDescriptor, type IslandRecord, type IslandRoute, NAVIGATE_EVENT, type RenderAppRequest, type RenderAppResult, activateIslandViewModels, collectDocumentContribution, collectIslandState, createIslandContainer, describeIsland, getAppContainer, getIslandsSnapshot, hydrateIslandState, isDocumentSource, navigateIsland, onIslandDocument, onIslandNavigate, publishIslandDocument, registerIsland, renderApp, resolveEagerUnits, slotAddress, subscribeIslands };
+export { AppAssets, type CreateIslandContainerOptions, DOCUMENT_EVENT, type DocumentContribution, type DocumentHead, type DocumentSource, ISLAND_ERRORS_KEY, IslandDescriptor, type IslandErrorContext, type IslandErrorDrain, type IslandErrorPhase, type IslandErrorReport, type IslandRecord, type IslandRoute, NAVIGATE_EVENT, type RenderAppRequest, type RenderAppResult, activateIslandViewModels, collectDocumentContribution, collectIslandState, createIslandContainer, describeIsland, getAppContainer, getIslandsSnapshot, hydrateIslandState, installIslandErrorDrain, isDocumentSource, navigateIsland, onIslandDocument, onIslandNavigate, publishIslandDocument, registerIsland, renderApp, reportIslandError, resolveEagerUnits, slotAddress, subscribeIslands };

package/island/index.js

@@ -23,6 +23,50 @@ import {
   __spreadValues
 } from "../chunk-6FNC3XMI.js";
 
+// src/island/errors.ts
+var ISLAND_ERRORS_KEY = "__DEN_ISLAND_ERRORS__";
+function denWindow() {
+  return typeof window === "undefined" ? void 0 : window;
+}
+function errorsSlot(w) {
+  const existing = w[ISLAND_ERRORS_KEY];
+  if (existing !== void 0) {
+    return existing;
+  }
+  const created = [];
+  w[ISLAND_ERRORS_KEY] = created;
+  return created;
+}
+function reportIslandError(error, context) {
+  const w = denWindow();
+  if (w === void 0) {
+    return;
+  }
+  errorsSlot(w).push({ context, error });
+}
+function installIslandErrorDrain(drain) {
+  const w = denWindow();
+  if (w === void 0) {
+    return;
+  }
+  if (drain === null) {
+    const empty = [];
+    w[ISLAND_ERRORS_KEY] = empty;
+    return;
+  }
+  const current = w[ISLAND_ERRORS_KEY];
+  const pending = Array.isArray(current) ? current : [];
+  for (const report of pending) {
+    drain(report.error, report.context);
+  }
+  w[ISLAND_ERRORS_KEY] = {
+    push(report) {
+      drain(report.error, report.context);
+      return 1;
+    }
+  };
+}
+
 // src/island/navigate.ts
 var NAVIGATE_EVENT = "den:navigate";
 function navigateIsland(node, route) {
@@ -97,6 +141,7 @@ function describeIsland(descriptor, denState) {
 }
 export {
   DOCUMENT_EVENT,
+  ISLAND_ERRORS_KEY,
   NAVIGATE_EVENT,
   ViewLayerToken,
   activateIslandViewModels,
@@ -107,6 +152,7 @@ export {
   getAppContainer,
   getIslandsSnapshot,
   hydrateIslandState,
+  installIslandErrorDrain,
   isDocumentSource,
   matchRoute,
   navigateIsland,
@@ -117,6 +163,7 @@ export {
   publishIslandDocument,
   registerIsland,
   renderApp,
+  reportIslandError,
   resolveEagerUnits,
   resolveViewAdapter,
   slotAddress,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foxford/den",
-  "version": "3.2.3",
+  "version": "3.2.5-beta-3141d32-20260904",
   "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": "3141d32",
   "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();