@uniweb/runtime 0.16.0 → 0.17.0

package/dist/ssr.js

@@ -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 || "",
@@ -842,23 +843,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 +867,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 +879,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 +892,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 +955,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 +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 {
@@ -1018,6 +1022,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 +1035,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 +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();
@@ -1199,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,