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

package/README.mdx

@@ -186,7 +186,9 @@ describeDocument(): DocumentContribution {
 **Статус HTTP описывает транспорт, а исход страницы едет полем `status` в теле.** `200` значит
 «приложение ответило» — хоть `404`, хоть редиректом. Всё остальное значит «до приложения не
 дошли»: `400` — сломанный запрос, `404` — неизвестная ручка или путь вне заявки, `500` — рендер
-упал. Так `404` от приложения не путается с `404` от неверно настроенного прокси.
+упал. Так `404` от приложения не путается с `404` от неверно настроенного прокси. Упавший
+рендер уходит как `reply.send(error)`: Fastify зовёт `onError` у потребителя с исходным
+исключением; тело — стандартный JSON ошибки Fastify.
 
 Браузерные заголовки рантайм читает только из `X-Forwarded-*` и кладёт в `RequestContextToken`;
 `Cookie` — обычным именем.
@@ -303,7 +305,8 @@ export default defineAppConfig({
 | `@foxford/den`         | рантайм, `define*`, менеджеры контейнеров и состояния       |
 | `@foxford/den/define`  | те же `define*` без сайд-эффекта установки резолвера        |
 | `@foxford/den/adapter` | шов резолва для адаптеров хостов                            |
-| `@foxford/den/island`  | остров: жизненный цикл, шов `renderApp`, порт `ViewAdapter` |
+| `@foxford/den/island`  | остров: жизненный цикл, шов `renderApp`, порт `ViewAdapter`, очередь клиентских падений (`reportIslandError` / `installIslandErrorDrain`) |
+
 | `@foxford/den/serve`   | сетевой транспорт: `serveApp`, `appPlugin`                  |
 | `@foxford/den/build`   | конфиг приложения и сборка: `defineAppConfig`, `buildApp`   |
 | `@foxford/den/bin`     | точка входа команды `den`                                   |

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.4",
+  "version": "3.2.5-beta-3141d32-20260904",
   "description": "Den — декларативный метафреймворк Foxford (core runtime)",
   "keywords": [
     "foxford",
@@ -134,6 +134,6 @@
     "view-adapter-BV62bdhM.d.ts",
     "view-adapter-DF1me25J.d.cts"
   ],
-  "sha": "41b3ba5",
+  "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();