react-cheminfo 0.64.0 → 0.65.0

package/lib/server/siteView.js

@@ -0,0 +1,21 @@
+import { viewOrigins } from "./answerAddresses.js";
+import { mcpServer } from "./mcpServer.js";
+/**
+ * The MCP App showing an answer on the site's own page: inline the answer's
+ * card, the page itself over the full screen, framed from this server or from
+ * the static site. One per tool server, named by every tool whose answer
+ * carries a `meta` from `cardMeta` or `pageAnswer`.
+ * @param options - Its address, its name, and the two addresses it frames.
+ * @returns The resource, for `createToolRoutes({ resources })`.
+ */
+export function siteView(options) {
+    const { uri, name, description, addresses, height } = options;
+    return mcpServer().embedView({
+        uri,
+        name,
+        description,
+        origins: viewOrigins(addresses),
+        height,
+    });
+}
+//# sourceMappingURL=siteView.js.map

package/lib/server/siteView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"siteView.js","sourceRoot":"","sources":["../../src/server/siteView.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAoB3C;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAwB;IAC/C,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC9D,OAAO,SAAS,EAAE,CAAC,SAAS,CAAC;QAC3B,GAAG;QACH,IAAI;QACJ,WAAW;QACX,OAAO,EAAE,WAAW,CAAC,SAAS,CAAC;QAC/B,MAAM;KACP,CAAC,CAAC;AACL,CAAC"}

package/lib/server/spaPages.d.ts

@@ -0,0 +1,32 @@
+import type { RouteMeta } from '../seo/core/routes.ts';
+import type { SpaSiteOptions } from './spaSiteOptions.ts';
+/** The page an address is answered with. */
+export interface SpaAnswer {
+    /** The page, its head and its crawl path written for the address. */
+    html: string;
+    /** Whether the app routes the address, rather than drawing its "not found". */
+    known: boolean;
+}
+/** Writes the page every address of a single-page app is answered with. */
+export interface SpaPages {
+    /**
+     * The page for one address.
+     * @param url - The address asked for, query string included.
+     * @param origin - Where the site is served, mount path included.
+     * @returns The page, and whether the app routes the address.
+     */
+    answer: (url: string, origin: string) => Promise<SpaAnswer>;
+}
+/**
+ * Prepare the pages of a single-page app from its built template: the snippet
+ * is put in once, the crawl path is written once per page and kept, and the
+ * head — which names the origin the request arrived on — per request.
+ * @param template - The built `index.html`.
+ * @param routes - Every address the app routes itself.
+ * @param options - The site, and how its pages are written.
+ * @returns The page writer.
+ * @throws {Error} When an indexed site's template carries no head or body
+ * marker, rather than failing on every request afterwards.
+ */
+export declare function createSpaPages(template: string, routes: readonly RouteMeta[], options: SpaSiteOptions): SpaPages;
+//# sourceMappingURL=spaPages.d.ts.map

package/lib/server/spaPages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spaPages.d.ts","sourceRoot":"","sources":["../../src/server/spaPages.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAWvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,4CAA4C;AAC5C,MAAM,WAAW,SAAS;IACxB,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,2EAA2E;AAC3E,MAAM,WAAW,QAAQ;IACvB;;;;;OAKG;IACH,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;CAC7D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,SAAS,SAAS,EAAE,EAC5B,OAAO,EAAE,cAAc,GACtB,QAAQ,CA2DV"}

package/lib/server/spaPages.js

@@ -0,0 +1,126 @@
+import { withoutQueryOrFragment } from "../router/core/address.js";
+import { stripBasePath } from "../router/core/basePath.js";
+import { noscriptIndex } from "../seo/core/noscript.js";
+import { pageHeadTags } from "../seo/core/pageMeta.js";
+import { pageMetaFor, routeFor } from "../seo/core/routes.js";
+import { mountPathOf, resolveSite } from "../seo/core/siteFiles.js";
+import { structuredDataScript } from "../seo/core/structuredData.js";
+import { PAGE_BODY_MARKER, PAGE_HEAD_MARKER, fill, } from "../seo/core/template.js";
+import { injectTrackingScript } from "../seo/core/trackingScript.js";
+/**
+ * Prepare the pages of a single-page app from its built template: the snippet
+ * is put in once, the crawl path is written once per page and kept, and the
+ * head — which names the origin the request arrived on — per request.
+ * @param template - The built `index.html`.
+ * @param routes - Every address the app routes itself.
+ * @param options - The site, and how its pages are written.
+ * @returns The page writer.
+ * @throws {Error} When an indexed site's template carries no head or body
+ * marker, rather than failing on every request afterwards.
+ */
+export function createSpaPages(template, routes, options) {
+    const site = resolveSite(options.site);
+    const indexed = options.indexed ?? true;
+    const page = injectTrackingScript(template, options.trackingScript);
+    if (indexed) {
+        for (const marker of [PAGE_HEAD_MARKER, PAGE_BODY_MARKER]) {
+            if (!page.includes(marker)) {
+                throw new Error(`the page carries no ${marker}`);
+            }
+        }
+    }
+    const write = indexed ? fill : fillIfPresent;
+    const bodyFor = keptBodies(options.maxCachedPages ?? 2000);
+    const crawled = options.noscript?.routes ?? indexedRoutes(routes);
+    const structured = structuredData(routes, options);
+    return {
+        async answer(url, origin) {
+            const mount = mountPathOf({ site, origin });
+            const named = await options.page?.(url);
+            const meta = named?.meta ?? pageMetaFor(routes, url, mount);
+            const content = named?.content ?? {
+                heading: meta.title,
+                paragraphs: [meta.description],
+            };
+            const body = bodyFor(meta.path, `${mount}\n${JSON.stringify(content)}`, () => write(page, PAGE_BODY_MARKER, noscriptIndex({
+                ...options.noscript,
+                site,
+                origin,
+                routes: crawled,
+                content,
+            })));
+            const served = indexed ? meta : { ...meta, indexed: false };
+            const tags = pageHeadTags({
+                site,
+                routes: [served],
+                origin,
+                url: served.path,
+                image: options.image,
+            });
+            const script = indexed ? structured(origin) : undefined;
+            const head = script === undefined ? tags : `${tags}\n${script}`;
+            return {
+                html: write(body, PAGE_HEAD_MARKER, head),
+                known: named !== undefined ||
+                    isKnown(routes, url, mount, options.knownRoute),
+            };
+        },
+    };
+}
+function indexedRoutes(routes) {
+    return routes.filter((route) => route.indexed !== false);
+}
+function isKnown(routes, url, mount, knownRoute) {
+    const path = withoutQueryOrFragment(url);
+    const own = stripBasePath(mount, path);
+    if (knownRoute !== undefined)
+        return knownRoute(own);
+    return (routeFor(routes, own) !== undefined || routeFor(routes, path) !== undefined);
+}
+// The block is the same on every page of an origin, so the one origin a
+// configured site is served at is written once rather than per request.
+function structuredData(routes, options) {
+    const option = options.structuredData ?? {};
+    if (option === false)
+        return () => undefined;
+    if (typeof option === 'function')
+        return option;
+    let last;
+    return (origin) => {
+        if (last?.origin !== origin) {
+            const script = structuredDataScript({
+                ...option,
+                site: options.site,
+                routes,
+                origin,
+            });
+            last = { origin, script };
+        }
+        return last.script;
+    };
+}
+// The crawl path of a page is kept under its canonical path, and rebuilt when
+// what the page says changes — a course renamed, a compound read again.
+function keptBodies(limit) {
+    const kept = new Map();
+    return (path, key, build) => {
+        const entry = kept.get(path);
+        if (entry?.key === key)
+            return entry.html;
+        const html = build();
+        if (limit <= 0)
+            return html;
+        kept.delete(path);
+        if (kept.size >= limit) {
+            const oldest = kept.keys().next();
+            if (oldest.done !== true)
+                kept.delete(oldest.value);
+        }
+        kept.set(path, { key, html });
+        return html;
+    };
+}
+function fillIfPresent(html, marker, content) {
+    return html.includes(marker) ? fill(html, marker, content) : html;
+}
+//# sourceMappingURL=spaPages.js.map

package/lib/server/spaPages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spaPages.js","sourceRoot":"","sources":["../../src/server/spaPages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAGvD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,IAAI,GACL,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAuBrE;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAC5B,QAAgB,EAChB,MAA4B,EAC5B,OAAuB;IAEvB,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC;IACxC,MAAM,IAAI,GAAG,oBAAoB,CAAC,QAAQ,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACpE,IAAI,OAAO,EAAE,CAAC;QACZ,KAAK,MAAM,MAAM,IAAI,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,EAAE,CAAC;YAC1D,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,uBAAuB,MAAM,EAAE,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC;IAC7C,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;IAClE,MAAM,UAAU,GAAG,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnD,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM;YACtB,MAAM,KAAK,GAAG,WAAW,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YAC5C,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC;YACxC,MAAM,IAAI,GAAG,KAAK,EAAE,IAAI,IAAI,WAAW,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;YAC5D,MAAM,OAAO,GAAgB,KAAK,EAAE,OAAO,IAAI;gBAC7C,OAAO,EAAE,IAAI,CAAC,KAAK;gBACnB,UAAU,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC;aAC/B,CAAC;YACF,MAAM,IAAI,GAAG,OAAO,CAClB,IAAI,CAAC,IAAI,EACT,GAAG,KAAK,KAAK,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,EACtC,GAAG,EAAE,CACH,KAAK,CACH,IAAI,EACJ,gBAAgB,EAChB,aAAa,CAAC;gBACZ,GAAG,OAAO,CAAC,QAAQ;gBACnB,IAAI;gBACJ,MAAM;gBACN,MAAM,EAAE,OAAO;gBACf,OAAO;aACR,CAAC,CACH,CACJ,CAAC;YACF,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YAC5D,MAAM,IAAI,GAAG,YAAY,CAAC;gBACxB,IAAI;gBACJ,MAAM,EAAE,CAAC,MAAM,CAAC;gBAChB,MAAM;gBACN,GAAG,EAAE,MAAM,CAAC,IAAI;gBAChB,KAAK,EAAE,OAAO,CAAC,KAAK;aACrB,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACxD,MAAM,IAAI,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,MAAM,EAAE,CAAC;YAChE,OAAO;gBACL,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,CAAC;gBACzC,KAAK,EACH,KAAK,KAAK,SAAS;oBACnB,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC;aAClD,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,MAA4B;IACjD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,OAAO,CACd,MAA4B,EAC5B,GAAW,EACX,KAAa,EACb,UAAmD;IAEnD,MAAM,IAAI,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACvC,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC;IACrD,OAAO,CACL,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,SAAS,CAC5E,CAAC;AACJ,CAAC;AAED,wEAAwE;AACxE,wEAAwE;AACxE,SAAS,cAAc,CACrB,MAA4B,EAC5B,OAAuB;IAEvB,MAAM,MAAM,GAAG,OAAO,CAAC,cAAc,IAAI,EAAE,CAAC;IAC5C,IAAI,MAAM,KAAK,KAAK;QAAE,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC;IAC7C,IAAI,OAAO,MAAM,KAAK,UAAU;QAAE,OAAO,MAAM,CAAC;IAChD,IAAI,IAAoD,CAAC;IACzD,OAAO,CAAC,MAAM,EAAE,EAAE;QAChB,IAAI,IAAI,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,oBAAoB,CAAC;gBAClC,GAAG,MAAM;gBACT,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,MAAM;gBACN,MAAM;aACP,CAAC,CAAC;YACH,IAAI,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAC5B,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,wEAAwE;AACxE,SAAS,UAAU,CACjB,KAAa;IAEb,MAAM,IAAI,GAAG,IAAI,GAAG,EAAyC,CAAC;IAC9D,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,KAAK,EAAE,GAAG,KAAK,GAAG;YAAE,OAAO,KAAK,CAAC,IAAI,CAAC;QAC1C,MAAM,IAAI,GAAG,KAAK,EAAE,CAAC;QACrB,IAAI,KAAK,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAC5B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAClB,IAAI,IAAI,CAAC,IAAI,IAAI,KAAK,EAAE,CAAC;YACvB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;YAClC,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI;gBAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,IAAY,EAAE,MAAc,EAAE,OAAe;IAClE,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACpE,CAAC"}

package/lib/server/spaSite.d.ts

@@ -0,0 +1,30 @@
+import type { FastifyInstance } from 'fastify';
+import type { SpaSiteOptions } from './spaSiteOptions.ts';
+/**
+ * Serve a single-page app from the backend that answers its API.
+ *
+ * Every address the app routes itself is the built page, with the head of that
+ * address — its title, description, canonical and card — and a crawl path of
+ * its own in its body, so a crawler that runs no script still tells the pages
+ * apart. The `TRACKING_SCRIPT` snippet is in every page. `sitemap.xml` and
+ * `robots.txt` are written from the route table, at the address the site is
+ * served at; the files of the build are served as they are, `assets/` kept for
+ * a year; an address under `reserved` is the API's own 404; and `/health`
+ * answers the deploy script.
+ *
+ *   await app.register(spaSite, {
+ *     root: 'frontend/dist',
+ *     site: 'derepflow',
+ *     siteUrl: process.env.SITE_URL,
+ *     trackingScript: process.env.TRACKING_SCRIPT,
+ *   });
+ *
+ * Without a build — a server started before the frontend was built — it logs
+ * it and serves the API alone.
+ * @param fastify - The server.
+ * @param options - The build, the site, and how its pages are written.
+ * @throws {Error} When `siteUrl` is not an absolute address, or the page of an
+ * indexed site carries no `<!--cheminfo:head-->` or `<!--cheminfo:body-->`.
+ */
+export declare function spaSite(fastify: FastifyInstance, options: SpaSiteOptions): Promise<void>;
+//# sourceMappingURL=spaSite.d.ts.map

package/lib/server/spaSite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spaSite.d.ts","sourceRoot":"","sources":["../../src/server/spaSite.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAgC,MAAM,SAAS,CAAC;AAkB7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAW1D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,OAAO,CAC3B,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC,CAmFf"}

package/lib/server/spaSite.js

@@ -0,0 +1,170 @@
+import { readFile } from 'node:fs/promises';
+import { join, relative, resolve, sep } from 'node:path';
+import { robotsTxt } from "../seo/core/robots.js";
+import { originOf, resolveSite, sitemapXml } from "../seo/core/siteFiles.js";
+import { healthRoute } from "./healthRoute.js";
+import { BUNDLE_CACHE, DEFAULT_RESERVED, HIDDEN, PAGE_CACHE, } from "./routeOptions.js";
+import { readRouteTable } from "./routeTable.js";
+import { isHashedBundle, listSiteFiles } from "./siteFiles.js";
+import { createSpaPages } from "./spaPages.js";
+/** The page the build wrote, which is a template and never served as it is. */
+const INDEX = 'index.html';
+/** What keeps a page out of the index without stopping its crawl. */
+const NO_INDEX = 'noindex, nofollow';
+/** The policy of a site nobody is meant to find. */
+const DISALLOW_ALL = 'User-agent: *\nDisallow: /\n';
+/**
+ * Serve a single-page app from the backend that answers its API.
+ *
+ * Every address the app routes itself is the built page, with the head of that
+ * address — its title, description, canonical and card — and a crawl path of
+ * its own in its body, so a crawler that runs no script still tells the pages
+ * apart. The `TRACKING_SCRIPT` snippet is in every page. `sitemap.xml` and
+ * `robots.txt` are written from the route table, at the address the site is
+ * served at; the files of the build are served as they are, `assets/` kept for
+ * a year; an address under `reserved` is the API's own 404; and `/health`
+ * answers the deploy script.
+ *
+ *   await app.register(spaSite, {
+ *     root: 'frontend/dist',
+ *     site: 'derepflow',
+ *     siteUrl: process.env.SITE_URL,
+ *     trackingScript: process.env.TRACKING_SCRIPT,
+ *   });
+ *
+ * Without a build — a server started before the frontend was built — it logs
+ * it and serves the API alone.
+ * @param fastify - The server.
+ * @param options - The build, the site, and how its pages are written.
+ * @throws {Error} When `siteUrl` is not an absolute address, or the page of an
+ * indexed site carries no `<!--cheminfo:head-->` or `<!--cheminfo:body-->`.
+ */
+export async function spaSite(fastify, options) {
+    const { health = true, reserved = DEFAULT_RESERVED, notFoundStatus = 200, indexed = true, siteUrl, robots = DEFAULT_RESERVED, sitemapPaths, setHeaders, } = options;
+    const site = resolveSite(options.site);
+    if (health !== false) {
+        await healthRoute(fastify, health === true ? {} : health);
+    }
+    const root = resolve(options.root);
+    const files = await listSiteFiles(root);
+    if (!files?.has(INDEX)) {
+        fastify.log.warn({ root }, 'no built frontend: serving the API alone');
+        return;
+    }
+    const routes = options.routes ?? readRouteTable(root, [homeOf(site)]);
+    const configured = siteUrl?.trim() || undefined;
+    if (configured !== undefined)
+        originOf({ site, origin: configured });
+    const pages = createSpaPages(await readFile(join(root, INDEX), 'utf8'), routes, options);
+    const originFor = (request) => configured ?? requestOrigin(request, site);
+    // An optional peer, installed only by a site that has a server: importing
+    // react-cheminfo/server must not need it.
+    const { default: fastifyStatic } = await import('@fastify/static');
+    await fastify.register(fastifyStatic, {
+        root,
+        serve: false,
+        cacheControl: false,
+        setHeaders: (reply, path) => {
+            const file = relative(root, path).split(sep).join('/');
+            reply.header('cache-control', isHashedBundle(file) ? BUNDLE_CACHE : PAGE_CACHE);
+            if (!indexed)
+                reply.header('x-robots-tag', NO_INDEX);
+            setHeaders?.(reply, file);
+        },
+    });
+    const sendPage = sender(pages, originFor, { indexed, notFoundStatus });
+    const answer = (request, reply) => {
+        const { pathname, search } = new URL(request.url, 'http://site');
+        if (reserved.some((prefix) => pathname.startsWith(prefix))) {
+            return reply.callNotFound();
+        }
+        if (pathname === `/${INDEX}`)
+            return sendPage(request, reply, `/${search}`);
+        const file = buildFile(files, pathname);
+        if (file !== undefined)
+            return reply.sendFile(file);
+        return sendPage(request, reply, request.url);
+    };
+    fastify.get('/', { schema: HIDDEN }, answer);
+    fastify.get('/*', { schema: HIDDEN }, answer);
+    fastify.get('/robots.txt', { schema: HIDDEN }, (request, reply) => reply
+        .type('text/plain; charset=utf-8')
+        .send(indexed
+        ? robotsTxt({ site, routes, origin: originFor(request) }, robots)
+        : DISALLOW_ALL));
+    fastify.get('/sitemap.xml', { schema: HIDDEN }, async (request, reply) => {
+        if (!indexed)
+            return reply.callNotFound();
+        const paths = (await sitemapPaths?.()) ?? [];
+        const listed = [...routes];
+        for (const path of paths)
+            listed.push({ path, title: '', description: '' });
+        return reply
+            .type('application/xml; charset=utf-8')
+            .send(sitemapXml({ site, routes: listed, origin: originFor(request) }));
+    });
+}
+/**
+ * The handler answering an address with its page.
+ * @param pages - The page writer.
+ * @param originFor - Where the site is served, for a request.
+ * @param status - How the answer is labelled.
+ * @param status.indexed - Whether search engines may index the site.
+ * @param status.notFoundStatus - The status of an address the app does not route.
+ * @returns The handler.
+ */
+function sender(pages, originFor, status) {
+    return async (request, reply, url) => {
+        const { html, known } = await pages.answer(url, originFor(request));
+        reply.header('cache-control', PAGE_CACHE);
+        if (!status.indexed)
+            reply.header('x-robots-tag', NO_INDEX);
+        return reply
+            .code(known ? 200 : status.notFoundStatus)
+            .type('text/html; charset=utf-8')
+            .send(html);
+    };
+}
+/**
+ * The file of the build an address names, never the template.
+ * @param files - The files of the build.
+ * @param pathname - The address, without its query.
+ * @returns The file, or `undefined` when the address is a page.
+ */
+function buildFile(files, pathname) {
+    let path;
+    try {
+        path = decodeURIComponent(pathname);
+    }
+    catch {
+        return undefined;
+    }
+    const local = path.replace(/^\/+/, '');
+    if (local === '' || local === INDEX)
+        return undefined;
+    return files.has(local) ? local : undefined;
+}
+/**
+ * The origin a request arrived on. The `Host` header is the client's to write,
+ * so one that is not a host falls back to the site's own address rather than
+ * reaching a canonical link.
+ * @param request - The request.
+ * @param site - The site served.
+ * @returns The origin, e.g. `https://pdb.cheminfo.org`.
+ */
+function requestOrigin(request, site) {
+    const candidate = `${request.protocol}://${request.host}`;
+    return URL.canParse(candidate)
+        ? new URL(candidate).origin
+        : `https://${site.host}`;
+}
+/**
+ * The page a site answers when its build wrote no route table.
+ * @param site - The site.
+ * @returns Its home page, titled and described by its tagline.
+ */
+function homeOf(site) {
+    const title = site.tagline.replace(/\.$/, '');
+    return { path: '/', title, description: site.tagline };
+}
+//# sourceMappingURL=spaSite.js.map

package/lib/server/spaSite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spaSite.js","sourceRoot":"","sources":["../../src/server/spaSite.ts"],"names":[],"mappings":"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"}

package/lib/server/spaSiteOptions.d.ts

@@ -0,0 +1,126 @@
+import type { FastifyReply } from 'fastify';
+import type { SiteId, SiteRecord } from '../ecosystem/core/sites.ts';
+import type { NoscriptText } from '../seo/core/noscript.ts';
+import type { PageContent } from '../seo/core/pageProse.ts';
+import type { RobotsDisallow } from '../seo/core/robots.ts';
+import type { RouteMeta } from '../seo/core/routes.ts';
+import type { StructuredDataOptions } from '../seo/core/structuredData.ts';
+import type { HealthRouteOptions } from './healthRoute.ts';
+/** A page an address names that the route table does not: a compound, a course. */
+export interface SpaPage {
+    /** Its title, description and canonical path. */
+    meta: RouteMeta;
+    /**
+     * What it says for itself in the crawl path.
+     * @default its title as heading, its description as the paragraph
+     */
+    content?: PageContent;
+}
+/** What the structured-data block says beyond the site and its address. */
+export type SpaStructuredData = Omit<StructuredDataOptions, 'site' | 'routes' | 'origin' | 'languages'>;
+/** Options of `spaSite`. */
+export interface SpaSiteOptions {
+    /** The directory holding the built frontend. */
+    root: string;
+    /** The site, named or passed. */
+    site: SiteRecord | SiteId;
+    /**
+     * Every address the frontend routes itself, each with its title and
+     * description.
+     * @default the `routes.json` the build wrote beside the page, or the site's
+     * home page alone
+     */
+    routes?: readonly RouteMeta[];
+    /**
+     * Where the site is served, mount path included, e.g.
+     * `https://learn.cheminfo.org/surge`. Every canonical, card and sitemap address
+     * is built on it. A blank value is unset, as compose forwards `${SITE_URL:-}`.
+     * @default the origin the request arrived on
+     */
+    siteUrl?: string;
+    /**
+     * The analytics snippet, put at the end of the head of every page.
+     * @default undefined - nothing is loaded
+     */
+    trackingScript?: string;
+    /**
+     * Address prefixes another plugin answers, such as the API, which never
+     * answer a page: an unknown address there is the API's own 404.
+     * @default ['/v1/', '/docs']
+     */
+    reserved?: readonly string[];
+    /**
+     * The prose of the crawl path, and the pages it links.
+     * @default the site's name and tagline, linking every indexed route
+     */
+    noscript?: NoscriptText;
+    /**
+     * The structured-data block of every page: what kind of application the site
+     * is, a function writing the whole `<script>` for the origin served (an
+     * author, a citation, a search action), or `false` for none.
+     * @default {} - a free web application, described by the site's tagline
+     */
+    structuredData?: false | SpaStructuredData | ((origin: string) => string);
+    /**
+     * The card a link to a page unfurls into, as an absolute address or a path.
+     * @default '/og.png'
+     */
+    image?: string;
+    /**
+     * Addresses `robots.txt` keeps out of the index, each optionally with the
+     * sentence saying why.
+     * @default ['/v1/', '/docs']
+     */
+    robots?: ReadonlyArray<string | RobotsDisallow>;
+    /**
+     * More addresses the sitemap lists after the route table: one per compound,
+     * per published course.
+     * @default undefined - the route table alone
+     */
+    sitemapPaths?: () => readonly string[] | Promise<readonly string[]>;
+    /**
+     * The page an address names when the route table does not: read from the
+     * database, so `/compound/1234` is indexed under the compound's own name.
+     * `undefined` falls back to the table.
+     * @default undefined - every address is read from the table
+     */
+    page?: (url: string) => SpaPage | undefined | Promise<SpaPage | undefined>;
+    /**
+     * Whether an address is one the app routes, given its path without the query
+     * and without the mount.
+     * @default whether the route table claims it, or `page` named it
+     */
+    knownRoute?: (path: string) => boolean;
+    /**
+     * The status an address the app does not route is answered with. It is
+     * still the page, so the app draws its own "not found", but a crawler is not
+     * handed a soft 404.
+     * @default 200
+     */
+    notFoundStatus?: number;
+    /**
+     * Whether search engines may index the site. An admin site sets `false`:
+     * every answer then carries `X-Robots-Tag: noindex, nofollow`, `robots.txt`
+     * disallows everything, there is no sitemap, and a page without the
+     * `<!--cheminfo:head-->` marker is served as it is.
+     * @default true
+     */
+    indexed?: boolean;
+    /**
+     * How many pages, each with its own crawl path, are kept built.
+     * @default 2000
+     */
+    maxCachedPages?: number;
+    /**
+     * Whether `/health` is answered here, and with what more.
+     * @default true
+     */
+    health?: boolean | HealthRouteOptions;
+    /**
+     * Headers for a file of the build, such as a cross-origin opening for the
+     * decks another site fetches.
+     * @default undefined - the cache headers alone
+     */
+    setHeaders?: (reply: FastifyReply, file: string) => void;
+}
+//# sourceMappingURL=spaSiteOptions.d.ts.map

package/lib/server/spaSiteOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spaSiteOptions.d.ts","sourceRoot":"","sources":["../../src/server/spaSiteOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAE3E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,mFAAmF;AACnF,MAAM,WAAW,OAAO;IACtB,iDAAiD;IACjD,IAAI,EAAE,SAAS,CAAC;IAChB;;;OAGG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED,2EAA2E;AAC3E,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAClC,qBAAqB,EACrB,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAC3C,CAAC;AAEF,4BAA4B;AAC5B,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC;IAC1B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IAC9B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,KAAK,GAAG,iBAAiB,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;IAC1E;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC,MAAM,GAAG,cAAc,CAAC,CAAC;IAChD;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IACpE;;;;;OAKG;IACH,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IAC3E;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACvC;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,kBAAkB,CAAC;IACtC;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1D"}

package/lib/server/spaSiteOptions.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=spaSiteOptions.js.map

package/lib/server/spaSiteOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spaSiteOptions.js","sourceRoot":"","sources":["../../src/server/spaSiteOptions.ts"],"names":[],"mappings":""}

package/lib/server/staticSite.d.ts

@@ -22,6 +22,15 @@ export interface StaticSiteOptions {
      * @default ['/v1/']
      */
     reserved?: readonly string[];
+    /**
+     * The path the deployment is mounted at, `/osiris` for
+     * `https://www.cheminfo.org/osiris/`, behind a proxy that takes it off before
+     * the request arrives. It is written into the `<base href="/">` of every page
+     * when they are read, and in front of every redirect, so one image serves a
+     * host of its own and a shared one without a rebuild or a copy of the build.
+     * @default '' - the site owns the root of its host
+     */
+    basePath?: string;
 }
 /**
  * Serve a site's build from Node, with the rules every static host of the

package/lib/server/staticSite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"staticSite.d.ts","sourceRoot":"","sources":["../../src/server/staticSite.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EAIhB,MAAM,SAAS,CAAC;AAMjB,qCAAqC;AACrC,MAAM,WAAW,iBAAiB;IAChC,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7C;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B;AAwBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAyDf"}
+{"version":3,"file":"staticSite.d.ts","sourceRoot":"","sources":["../../src/server/staticSite.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAgC,MAAM,SAAS,CAAC;AAe7E,qCAAqC;AACrC,MAAM,WAAW,iBAAiB;IAChC,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7C;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAWD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAyDf"}