@uniweb/runtime 0.16.0 → 0.17.1

package/dist/ssr.js

@@ -2,6 +2,7 @@ import { isRichSchema, deriveCacheKey, resolveDefaultLocale, hasDarkScheme, crea
 import React from "react";
 import { renderToString } from "react-dom/server";
 import { sectionDomId } from "@uniweb/core/section-id";
+import { applyBasePath } from "@uniweb/core/base-path";
 import { routePatternToRegex, decodeRouteValue, splitPathCapture } from "@uniweb/core/route-match";
 import { DEFAULT_ICON_BASE, iconUrl } from "@uniweb/core/icon-corpus";
 import { buildTheme, FONT_LINKS_MARKER, buildSectionOverrides } from "@uniweb/theming";
@@ -11,6 +12,7 @@ import { resolveFetchConfigs } from "@uniweb/core/fetch-config";
 import { deriveCacheKey as deriveCacheKey$1 } from "@uniweb/core/datastore";
 import { buildDetailConfig } from "@uniweb/core/detail-url";
 import { resolveDefaultLocale as resolveDefaultLocale$1 } from "@uniweb/core/locale-config";
+import { resolveRecordsService } from "@uniweb/core/records-service";
 function guaranteeItemStructure(item) {
   return {
     title: item.title || "",
@@ -248,6 +250,23 @@ function getComponentMeta(componentName) {
 function getComponentDefaults(componentName) {
   return globalThis.uniweb?.getComponentDefaults?.(componentName) || {};
 }
+function siteUrl(url) {
+  return applyBasePath(url, globalThis.uniweb?.activeWebsite?.basePath || "");
+}
+function withOpacity(color, opacity) {
+  if (typeof color !== "string" || !color) return color;
+  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;
+}
 function default404Html(basePath = "") {
   const homeHref = basePath ? `${basePath}/` : "/";
   return `<div class="page-not-found" style="min-height:80vh;display:flex;flex-direction:column;align-items:center;justify-content:center;padding:2rem;text-align:center"><h1 style="font-size:3rem;font-weight:bold;color:#1f2937;margin-bottom:1rem">404</h1><p style="color:#64748b;margin-bottom:2rem">Page not found</p><a href="${homeHref}" style="color:#3b82f6;text-decoration:underline">Go to homepage</a></div>`;
@@ -394,28 +413,6 @@ function getWrapperProps(block) {
   }
   return { id: sectionDomId(block), style, className, background };
 }
-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;
-}
-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;
-}
 function renderBackground(background) {
   if (!background?.mode) return null;
   const containerStyle = {
@@ -472,7 +469,7 @@ 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"
@@ -842,23 +839,23 @@ function generate404Html({ baseHtml, website, siteContent }) {
 function createDefaultFetcher({ basePath = "", dev = false, fetch: fetchImpl = null } = {}) {
   const doFetch = (input, init) => (fetchImpl || globalThis.fetch)(input, init);
   const pathPrefix = basePath && basePath !== "/" ? basePath.replace(/\/$/, "") : "";
-  const doorQueues = /* @__PURE__ */ new Map();
-  const askDoor = (request, ctx) => {
+  const askQueues = /* @__PURE__ */ new Map();
+  const askRecords = (request, ctx) => {
     if (typeof request.schema !== "string" || !request.schema) {
       return Promise.resolve({
         data: null,
-        error: `the payload stamps a records door but carries no Model ref for query "${request.query ?? request.as}" (config.queries) — the door cannot be asked`
+        error: `the payload offers the records service but carries no Model ref for query "${request.query ?? request.as}" (config.queries) — it cannot be asked`
       });
     }
     return new Promise((resolve) => {
-      const url = resolveServiceUrl(request.door, pathPrefix);
-      let queue = doorQueues.get(url);
+      const url = resolveServiceUrl(request.ask, pathPrefix);
+      let queue = askQueues.get(url);
       if (!queue) {
         queue = [];
-        doorQueues.set(url, queue);
+        askQueues.set(url, queue);
         queueMicrotask(() => {
-          doorQueues.delete(url);
-          flushDoor(url, queue, doFetch);
+          askQueues.delete(url);
+          flushAsked(url, queue, doFetch);
         });
       }
       queue.push({ request, ctx, resolve });
@@ -866,8 +863,8 @@ function createDefaultFetcher({ basePath = "", dev = false, fetch: fetchImpl = n
   };
   return {
     /**
-     * The cache identity is the request's ADDRESS — or, on a question door,
-     * the QUESTION (`deriveCacheKey` hashes every operator of an address-less
+     * The cache identity is the request's ADDRESS — or, when asked of the
+     * records service, the QUESTION (`deriveCacheKey` hashes every operator of an address-less
      * request). Operators evaluated here run over a shared cached value and
      * must NOT split the cache: two pages declaring different `where:` clauses
      * against the same path share one entry — the file is fetched once and
@@ -878,7 +875,7 @@ function createDefaultFetcher({ basePath = "", dev = false, fetch: fetchImpl = n
     },
     async resolve(request, ctx = {}) {
       if (!request) return { data: null };
-      if (request.door) return askDoor(request, ctx);
+      if (request.ask) return askRecords(request, ctx);
       const { path, url, transform, body: rawBody } = request;
       let method = (request.method || "GET").toUpperCase();
       if (method !== "GET" && method !== "POST") {
@@ -891,7 +888,7 @@ function createDefaultFetcher({ basePath = "", dev = false, fetch: fetchImpl = n
       } else if (url) {
         target = url;
       } else {
-        return { data: [], error: "No path, url or door specified" };
+        return { data: [], error: "No path, url or ask specified" };
       }
       const init = { signal: ctx.signal, method };
       if (method === "POST") {
@@ -954,7 +951,7 @@ function createDefaultFetcher({ basePath = "", dev = false, fetch: fetchImpl = n
     }
   };
 }
-function doorQuestion(request) {
+function toQuestion(request) {
   const q = { schema: request.schema };
   let where = request.where && typeof request.where === "object" ? request.where : null;
   let scope = typeof request.scope === "string" && request.scope ? request.scope : null;
@@ -969,19 +966,22 @@ function doorQuestion(request) {
   if (sort) q.sort = sort;
   if (typeof request.limit === "number" && request.limit > 0) q.limit = request.limit;
   if (request.depth === "brief" || request.depth === "full") q.depth = request.depth;
+  if (typeof request.cursor === "string" && request.cursor) q.cursor = request.cursor;
   return q;
 }
-const DOOR_OPERATOR = { nin: "not_in" };
+const OPERATOR_ALIAS = { nin: "not_in" };
 function renameOperators(where) {
   if (Array.isArray(where)) return where.map(renameOperators);
   if (!where || typeof where !== "object") return where;
   const out = {};
   for (const [key, value] of Object.entries(where)) {
-    out[DOOR_OPERATOR[key] ?? key] = value && typeof value === "object" ? renameOperators(value) : value;
+    out[OPERATOR_ALIAS[key] ?? key] = value && typeof value === "object" ? renameOperators(value) : value;
   }
   return out;
 }
-async function flushDoor(url, queue, doFetch) {
+const MAX_PAGES = 50;
+async function flushAsked(url, queue, doFetch) {
+  const pending = /* @__PURE__ */ new Map();
   const body = {};
   const keys = [];
   for (const entry of queue) {
@@ -989,7 +989,7 @@ async function flushDoor(url, queue, doFetch) {
     let key = base;
     for (let n = 2; key in body; n += 1) key = `${base}#${n}`;
     keys.push(key);
-    body[key] = doorQuestion(entry.request);
+    body[key] = toQuestion(entry.request);
   }
   let parsed;
   try {
@@ -1018,6 +1018,8 @@ async function flushDoor(url, queue, doFetch) {
   const data = parsed && typeof parsed.data === "object" && parsed.data ? parsed.data : {};
   const errors = parsed && typeof parsed.errors === "object" && parsed.errors ? parsed.errors : {};
   const depths = parsed && typeof parsed.depths === "object" && parsed.depths ? parsed.depths : {};
+  const cursors = parsed && typeof parsed.cursors === "object" && parsed.cursors ? parsed.cursors : {};
+  const limits = parsed && typeof parsed.limits === "object" && parsed.limits ? parsed.limits : {};
   queue.forEach((entry, i) => {
     const key = keys[i];
     if (key in errors) {
@@ -1029,12 +1031,50 @@ async function flushDoor(url, queue, doFetch) {
       return;
     }
     if (!(key in data)) {
-      entry.resolve({ data: null, error: `the records door answered without the key "${key}"` });
+      entry.resolve({ data: null, error: `the records service answered without the key "${key}"` });
       return;
     }
     const depth = depths[key] === "brief" || depths[key] === "full" ? depths[key] : entry.request.depth === "brief" || entry.request.depth === "full" ? entry.request.depth : void 0;
-    entry.resolve(depth ? { data: data[key], meta: { depth } } : { data: data[key] });
+    const cursor = typeof cursors[key] === "string" && cursors[key] ? cursors[key] : null;
+    const bound = typeof limits[key] === "number" ? limits[key] : void 0;
+    const rows = Array.isArray(data[key]) ? data[key] : data[key];
+    if (cursor && entry.request.exhaustive && Array.isArray(rows)) {
+      const acc = entry.collected ? entry.collected.concat(rows) : rows.slice();
+      const page = (entry.page || 1) + 1;
+      if (page <= MAX_PAGES) {
+        pending.set(entry, { cursor, collected: acc, page, depth, bound });
+        return;
+      }
+      entry.resolve({ data: acc, meta: withMeta({ depth, bound, truncated: true, pages: MAX_PAGES }) });
+      return;
+    }
+    const collected = entry.collected ? entry.collected.concat(Array.isArray(rows) ? rows : []) : rows;
+    const meta = withMeta({
+      depth,
+      bound,
+      // ⭐ A cursor IS the truncation signal, and it is the only one for a query
+      // that declared no `limit`: `limits` is reported only when an author's own
+      // limit was clamped (the records contract §5).
+      truncated: cursor ? true : void 0,
+      pages: entry.page && entry.page > 1 ? entry.page : void 0
+    });
+    entry.resolve(meta ? { data: collected, meta } : { data: collected });
   });
+  if (pending.size === 0) return;
+  await Promise.all([...pending].map(([entry, state]) => {
+    const next = {
+      ...entry,
+      request: { ...entry.request, cursor: state.cursor },
+      collected: state.collected,
+      page: state.page
+    };
+    return flushAsked(url, [next], doFetch);
+  }));
+}
+function withMeta(fields) {
+  const out = {};
+  for (const [k, v] of Object.entries(fields)) if (v !== void 0) out[k] = v;
+  return Object.keys(out).length ? out : void 0;
 }
 function applyOperators(data, request, { dev = false } = {}) {
   if (!Array.isArray(data)) return data;
@@ -1114,7 +1154,7 @@ function resolvePageFetchConfigs(content, route, { locale = null } = {}) {
     locale,
     defaultLocale: resolveDefaultLocale$1(content?.config) ?? null,
     queries: content?.config?.queries ?? null,
-    records: content?.config?.records ?? null,
+    services: content?.config?.services ?? null,
     variables: binding?.variables ?? null
   };
   const out = /* @__PURE__ */ new Map();
@@ -1199,10 +1239,42 @@ async function prefetchAndHydrate({ website, content, route, locale = null, fetc
   hydrateDataStore(website, fetched);
   return fetched;
 }
+async function collectSiteRecords(content, { locale, fetch: fetch2, signal, only = null } = {}) {
+  const config = content?.config;
+  const services = config?.services ?? null;
+  const queries = config?.queries ?? null;
+  if (!queries || typeof queries !== "object") return empty();
+  if (!resolveRecordsService(services, locale)) return empty();
+  const names = Object.keys(queries).filter((n) => only ? only.includes(n) : true);
+  if (names.length === 0) return empty();
+  const configs = resolveFetchConfigs(
+    names.map((name) => ({ query: name, as: name })),
+    { services, queries, locale, defaultLocale: config?.defaultLanguage ?? locale }
+  );
+  const fetcher = createDefaultFetcher({ fetch: fetch2, basePath: config?.base ?? "" });
+  const records = {};
+  const errors = {};
+  const meta = {};
+  await Promise.all([...configs].map(async ([name, cfg]) => {
+    if (!cfg.ask) return;
+    const result = await fetcher.resolve({ ...cfg, depth: "brief", exhaustive: true }, { signal });
+    if (result?.error) {
+      errors[name] = result.error;
+      return;
+    }
+    records[name] = Array.isArray(result?.data) ? result.data : [];
+    if (result?.meta) meta[name] = result.meta;
+  }));
+  return { records, errors: Object.keys(errors).length ? errors : null, meta };
+}
+function empty() {
+  return { records: {}, errors: null, meta: {} };
+}
 export {
   applyDefaults,
   applySchemas,
   classifyRenderError,
+  collectSiteRecords,
   createPageRenderer,
   escapeHtml,
   executeFetchConfigs,