@uniweb/runtime 0.16.0 → 0.17.1

package/src/prefetch.js

@@ -10,12 +10,12 @@
  * compute that itself: resolve the configs, issue the requests, unwrap the responses in the
  * shape the datastore expects — a copy of the runtime's logic, in another repo, drifting
  * (the records envelope went silently unread that way on 2026-09-02). [Diego, 2026-09-03]:
- * *the backend sets `config.records`; the fetch comes from the runtime.* The host now calls
+ * *the backend sets the records service; the fetch comes from the runtime.* The host now calls
  * this and carries no copy. Hosting agreed to exactly that shape the same day.
  *
  * ⛔ Contract with the host, deliberately small:
  *   - `content`  the render payload (`site-content.json` / `__DATA__`), config included —
- *                `config.records` and `config.base` are read from it.
+ *                `config.services` and `config.base` are read from it.
  *   - `route`    the page to prefetch for; a `[slug]` template resolves through the same
  *                matcher the SPA uses, so `/blog/post-1` finds `/blog/:slug`.
  *   - `fetch`    how to dispatch a request. The runtime composes the address; the host
@@ -46,8 +46,8 @@
  *                is a different cache decision (hosting, 2026-09-03).
  *
  * It resolves nothing the host owns and models no host route layout: every address is
- * `{base}/…` from the payload, or the question door the host itself published at
- * `config.records.query`.
+ * `{base}/…` from the payload, or the records service the host itself
+ * published at `config.services.records`.
  */
 import { resolveFetchConfigs } from '@uniweb/core/fetch-config'
 import { deriveCacheKey } from '@uniweb/core/datastore'
@@ -118,7 +118,7 @@ export function resolvePageFetchConfigs(content, route, { locale = null } = {})
     locale,
     defaultLocale: resolveDefaultLocale(content?.config) ?? null,
     queries: content?.config?.queries ?? null,
-    records: content?.config?.records ?? null,
+    services: content?.config?.services ?? null,
     variables: binding?.variables ?? null,
   }
   const out = new Map()
@@ -163,7 +163,7 @@ export function resolvePageFetchConfigs(content, route, { locale = null } = {})
  * @param {Object[]} configs  resolved configs (from `resolvePageFetchConfigs` or the host's own
  *                             call to `resolveFetchConfigs`)
  * @param {Object} opts
- * @param {Object} opts.content  the payload — `config.base`, `config.records`
+ * @param {Object} opts.content  the payload — `config.base`, `config.services`
  * @param {Function} [opts.fetch]  the transport; defaults to the global `fetch`
  * @param {boolean} [opts.dev]
  * @returns {Promise<Array<{ config: Object, outcome: 'fetched'|'failed'|'skipped', data: any, error?: string }>>}
@@ -178,7 +178,7 @@ export async function executeFetchConfigs(configs, { content, fetch = null, dev
     fetch,
   })
   const ctx = { website: null }
-  // Dispatched together, not one after another: a question door batches the
+  // Dispatched together, not one after another: the records service batches the
   // requests issued in one tick into one POST, and a page's configs are
   // independent of each other. Order is preserved in the result.
   return Promise.all((configs || []).filter(Boolean).map(async (config) => {

package/src/ssr-renderer.js

@@ -18,6 +18,7 @@ import React from 'react'
 import { renderToString } from 'react-dom/server'
 import { createUniweb, resolveDefaultLocale } from '@uniweb/core'
 import { sectionDomId } from '@uniweb/core/section-id'
+import { siteUrl, withOpacity } from './background-shared.js'
 import { routePatternToRegex } from '@uniweb/core/route-match'
 import { DEFAULT_ICON_BASE, iconUrl } from '@uniweb/core/icon-corpus'
 import { buildSectionOverrides, FONT_LINKS_MARKER } from '@uniweb/theming'
@@ -86,37 +87,6 @@ export function getWrapperProps(block) {
   return { id: sectionDomId(block), style, className, background }
 }
 
-/**
- * Convert hex/rgb color to rgba with opacity.
- * Mirrors withOpacity() in Background.jsx.
- */
-function withOpacity(color, opacity) {
-  if (color.startsWith('#')) {
-    const r = parseInt(color.slice(1, 3), 16)
-    const g = parseInt(color.slice(3, 5), 16)
-    const b = parseInt(color.slice(5, 7), 16)
-    return `rgba(${r}, ${g}, ${b}, ${opacity})`
-  }
-  if (color.startsWith('rgb')) {
-    const match = color.match(/rgba?\((\d+),\s*(\d+),\s*(\d+)/)
-    if (match) {
-      return `rgba(${match[1]}, ${match[2]}, ${match[3]}, ${opacity})`
-    }
-  }
-  return color
-}
-
-/**
- * Resolve a URL against the site's base path.
- * Mirrors resolveUrl() in Background.jsx.
- */
-function resolveUrl(url) {
-  if (!url || !url.startsWith('/')) return url
-  const basePath = globalThis.uniweb?.activeWebsite?.basePath || ''
-  if (!basePath) return url
-  if (url.startsWith(basePath + '/') || url === basePath) return url
-  return basePath + url
-}
 
 /**
  * Render a background element for SSR.
@@ -189,7 +159,7 @@ export function renderBackground(background) {
         style: {
           position: 'absolute',
           inset: '0',
-          backgroundImage: `url(${resolveUrl(img.src)})`,
+          backgroundImage: `url(${siteUrl(img.src)})`,
           backgroundPosition: img.position || 'center',
           backgroundSize: img.size || 'cover',
           backgroundRepeat: 'no-repeat',

package/src/ssr.js

@@ -58,7 +58,7 @@ export {
 
 // Server-side prefetch — the runtime executing a page's fetches for a host, so an isolate
 // receives `fetchedData` computed by our fetcher and the host carries no copy of it.
-// [Diego, 2026-09-03]: the backend sets config.records; the fetch comes from the runtime.
+// [Diego, 2026-09-03]: the backend sets the records service; the fetch comes from the runtime.
 export {
   findPageForRoute,
   resolvePageFetchConfigs,
@@ -72,6 +72,13 @@ export {
 // what it deliberately leaves to the host.
 export { createPageRenderer, prefetchAndHydrate } from './page-renderer.js'
 
+// The whole corpus, rather than one page — for a host that indexes a site or
+// derives something over every record its queries return. It asks through the
+// same client and the same composition a page render uses, which is the point:
+// an index that composed its own questions could offer a result whose page then
+// renders empty. The host supplies only the transport.
+export { collectSiteRecords } from './collect-records.js'
+
 // Appearance. injectPageContent() already emits this for every prerendered
 // page; exported for lanes that assemble a shell without a per-page render.
 export { renderAppearanceBootScript } from './appearance.js'