@uniweb/runtime 0.15.0 → 0.17.0

package/dist/ssr.js

@@ -1,4 +1,4 @@
-import { isRichSchema, deriveCacheKey, resolveDefaultLocale, hasDarkScheme, createUniweb, resolveServiceUrl, substitutePlaceholders, matchWhere, sortRecords, sortToWire } from "@uniweb/core";
+import { isRichSchema, deriveCacheKey, resolveDefaultLocale, hasDarkScheme, createUniweb, substitutePlaceholders, resolveServiceUrl, matchWhere, sortRecords, sortToWire } from "@uniweb/core";
 import React from "react";
 import { renderToString } from "react-dom/server";
 import { sectionDomId } from "@uniweb/core/section-id";
@@ -11,6 +11,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 || "",
@@ -839,29 +840,35 @@ function generate404Html({ baseHtml, website, siteContent }) {
   }
   return { html, hasNotFoundPage: !!notFoundPage };
 }
-function createDefaultFetcher({ basePath = "", dev = false, records = null, fetch: fetchImpl = null } = {}) {
+function createDefaultFetcher({ basePath = "", dev = false, fetch: fetchImpl = null } = {}) {
   const doFetch = (input, init) => (fetchImpl || globalThis.fetch)(input, init);
   const pathPrefix = basePath && basePath !== "/" ? basePath.replace(/\/$/, "") : "";
-  const stampedArrayKey = records?.envelope && typeof records.envelope === "object" && typeof records.envelope.records === "string" && records.envelope.records.length ? records.envelope.records : null;
-  const laneEnvelope = stampedArrayKey ? { list: stampedArrayKey } : null;
-  const doorQueues = /* @__PURE__ */ new Map();
-  const askDoor = (request, ctx) => new Promise((resolve) => {
-    const url = resolveServiceUrl(request.door, pathPrefix);
-    let queue = doorQueues.get(url);
-    if (!queue) {
-      queue = [];
-      doorQueues.set(url, queue);
-      queueMicrotask(() => {
-        doorQueues.delete(url);
-        flushDoor(url, queue, doFetch);
+  const askQueues = /* @__PURE__ */ new Map();
+  const askRecords = (request, ctx) => {
+    if (typeof request.schema !== "string" || !request.schema) {
+      return Promise.resolve({
+        data: null,
+        error: `the payload offers the records service but carries no Model ref for query "${request.query ?? request.as}" (config.queries) — it cannot be asked`
       });
     }
-    queue.push({ request, ctx, resolve });
-  });
+    return new Promise((resolve) => {
+      const url = resolveServiceUrl(request.ask, pathPrefix);
+      let queue = askQueues.get(url);
+      if (!queue) {
+        queue = [];
+        askQueues.set(url, queue);
+        queueMicrotask(() => {
+          askQueues.delete(url);
+          flushAsked(url, queue, doFetch);
+        });
+      }
+      queue.push({ request, ctx, resolve });
+    });
+  };
   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
@@ -872,25 +879,20 @@ function createDefaultFetcher({ basePath = "", dev = false, records = null, fetc
     },
     async resolve(request, ctx = {}) {
       if (!request) return { data: null };
-      if (request.door) return askDoor(request, ctx);
-      const { path, url, endpoint, transform, body: rawBody } = request;
+      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") {
         console.warn(`[default-fetcher] method "${request.method}" is not supported — falling back to GET.`);
         method = "GET";
       }
       let target;
-      if (endpoint) {
-        target = resolveServiceUrl(endpoint, pathPrefix);
-        if (typeof request.locale === "string" && request.locale) {
-          target += (target.includes("?") ? "&" : "?") + "locale=" + encodeURIComponent(request.locale);
-        }
-      } else if (path) {
+      if (path) {
         target = pathPrefix && path.startsWith("/") && !path.startsWith("//") ? pathPrefix + path : path;
       } else if (url) {
         target = url;
       } else {
-        return { data: [], error: "No path, url or endpoint specified" };
+        return { data: [], error: "No path, url or ask specified" };
       }
       const init = { signal: ctx.signal, method };
       if (method === "POST") {
@@ -903,8 +905,7 @@ function createDefaultFetcher({ basePath = "", dev = false, records = null, fetc
       }
       try {
         const response = await doFetch(target, init);
-        const requestEnvelope = request.envelope && typeof request.envelope === "object" ? request.envelope : null;
-        const envelope = requestEnvelope ?? (endpoint && laneEnvelope ? laneEnvelope : {});
+        const envelope = request.envelope && typeof request.envelope === "object" ? request.envelope : {};
         if (!response.ok) {
           let extracted;
           if (envelope.error) {
@@ -954,7 +955,7 @@ function createDefaultFetcher({ basePath = "", dev = false, records = null, fetc
     }
   };
 }
-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 +970,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 +993,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 {
@@ -999,7 +1003,13 @@ async function flushDoor(url, queue, doFetch) {
       body: JSON.stringify(body)
     });
     if (!response.ok) {
-      const error = `HTTP ${response.status}: ${response.statusText}`;
+      let detail = null;
+      try {
+        const problem = safeParseJSON(await response.text());
+        if (problem && typeof problem.detail === "string" && problem.detail) detail = problem.detail;
+      } catch {
+      }
+      const error = detail ? `HTTP ${response.status}: ${detail}` : `HTTP ${response.status}: ${response.statusText}`;
       for (const entry of queue) entry.resolve({ data: null, error });
       return;
     }
@@ -1012,20 +1022,63 @@ 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) {
       const e = errors[key];
-      entry.resolve({ data: null, error: typeof e === "string" ? e : e?.message || JSON.stringify(e) });
+      const detail = typeof e === "string" ? e : e?.detail || e?.message || JSON.stringify(e);
+      const out = { data: null, error: detail };
+      if (e && typeof e === "object" && typeof e.code === "string") out.code = e.code;
+      entry.resolve(out);
       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;
@@ -1105,7 +1158,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();
@@ -1139,7 +1192,6 @@ async function executeFetchConfigs(configs, { content, fetch: fetch2 = null, dev
   }
   const fetcher = createDefaultFetcher({
     basePath: content?.config?.base || "",
-    records: content?.config?.records ?? null,
     dev,
     fetch: fetch2
   });
@@ -1191,10 +1243,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,