@uniweb/runtime 1.3.11 → 1.3.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/runtime",
-  "version": "1.3.11",
+  "version": "1.3.12",
   "description": "Minimal runtime for loading Uniweb foundations",
   "type": "module",
   "exports": {

package/src/page-renderer.js

@@ -33,7 +33,7 @@
  *   - **Anything build-only.** `injectBuildData` stays in the build lane; it is the
  *     other half of the head seam and has its own parity guard.
  */
-import { renderPage, classifyRenderError, injectPageContent } from './ssr-renderer.js'
+import { renderPage, classifyRenderError, failingSectionOf, injectPageContent } from './ssr-renderer.js'
 import { resolveRequestedPage } from './resolve-page.js'
 import { hydrateDataStore } from './wire-foundation.js'
 import { loadPageData } from './load-page-data.js'
@@ -50,7 +50,9 @@ import { whileReadingIcons } from './page-icons.js'
  * @param {Object} opts
  * @param {Object} opts.website - `uniweb.activeWebsite`, already initialized
  * @param {string} opts.shell - the HTML shell to inject into, taken as given
- * @returns {{ website: Object, render: Function }}
+ * @returns {{ website: Object, render: Function, failingSection: Function }} `failingSection` asks
+ *   which section stopped a page `render` reported as `failed` (`failingSectionOf`). A render per
+ *   block: for a build's report, not for a host answering a request.
  */
 export function createPageRenderer({ website, shell }) {
   if (!website) throw new Error('createPageRenderer: `website` is required')
@@ -187,7 +189,7 @@ export function createPageRenderer({ website, shell }) {
     return { outcome: missing ? 'notFound' : 'rendered', html, page, error: null }
   }
 
-  return { website, render }
+  return { website, render, failingSection: (page, message) => failingSectionOf(page, message) }
 }
 
 /**

package/src/ssr-renderer.js

@@ -579,6 +579,36 @@ export function renderPage(page, website) {
   return { renderedContent, sectionOverrideCSS }
 }
 
+/**
+ * Which section stopped a page from rendering, for a report to whoever can fix it: each block the
+ * page renders, alone, and the deepest that fails the same way. Null when none does, so the layout
+ * around them did. `renderPage` can say only what went wrong: `renderToString` names no component,
+ * and a built foundation's stack names minified ones.
+ *
+ * One render per block, so it's for a page that has already failed and a caller with time to spend.
+ * The same message, since a block alone misses what its layout gives it, and may fail for that.
+ *
+ * @param {Page} page - The page that failed
+ * @param {string} message - What `renderPage` reported
+ * @returns {string|null} the section's type
+ */
+export function failingSectionOf(page, message) {
+  const fails = (block) => {
+    try {
+      renderToString(renderBlock(block))
+      return false
+    } catch (err) {
+      return err.message === message
+    }
+  }
+  const deepest = (block) => {
+    const child = (block.childBlocks || []).find(fails)
+    return child ? deepest(child) : block
+  }
+  const block = page.getAllBlocks().find(fails)
+  return block ? deepest(block).type : null
+}
+
 // ============================================================================
 // HTML injection
 // ============================================================================