@softure-ai/blog 0.0.0-stage → 0.1.6

package/dist/next/og-image.js

@@ -0,0 +1,77 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// The social card of an article (`opengraph-image`): its title on the brand's background, the brand's
+// name above and the blog's name below. Mount it in `app/blog/[slug]/opengraph-image.tsx`:
+//
+//   export { BlogArticleOgImage as default, generateBlogStaticParams as generateStaticParams } from "@softure-ai/blog/next";
+//   export const size = { width: 1200, height: 630 };
+//   export const contentType = "image/png";
+//   export const revalidate = 300;
+//
+// A slug that is not a published article gets the blog's own card, never a 404: a crawler that
+// fetched the page earlier would show an empty preview.
+//
+// The card writes in `blog({ brand: { fonts } })` when the app lists them (`next/og`'s default font
+// otherwise): each file is read on the first card and kept, and a file that cannot be read fails the
+// card with a message naming it. A path is read from the app's root on the Node.js runtime (the
+// route's default); a route moved to the edge runtime takes https URLs only.
+import { formatMessage } from "@softure-ai/core";
+import { getSoftureConfig } from "@softure-ai/core/next";
+import { DEFAULT_THEME } from "@softure-ai/ui";
+import { ImageResponse } from "next/og";
+import { getBlogOptions } from "../server/options.js";
+import { getPageContext } from "./context.js";
+import { getTextBySlug } from "./data.js";
+import { loadBrandOgFonts } from "./og-fonts.js";
+/** The card's size: the 1.91:1 every network crops to. */
+export const OG_IMAGE_SIZE = { width: 1200, height: 630 };
+/** The card's colours: the brand's, else the dark scheme of @softure-ai/ui's default theme. */
+export function getOgColors(brand) {
+    const dark = DEFAULT_THEME.dark;
+    return {
+        background: brand?.colors?.background ?? dark["color-background"],
+        foreground: brand?.colors?.foreground ?? dark["color-foreground"],
+        accent: brand?.colors?.accent ?? dark["color-accent-fill"],
+    };
+}
+/**
+ * The card's `font-family`: every family it is given, once each and in order, so a second family (a
+ * `latin-ext` subset file under its own name) draws the characters the first lacks.
+ */
+export function getOgFontFamily(fonts) {
+    const names = [...new Set(fonts.map((font) => font.name))];
+    return names.length === 0 ? undefined : names.map((name) => JSON.stringify(name)).join(", ");
+}
+export function renderArticleOgImage({ title, label, brand, fonts }) {
+    const colors = getOgColors(brand);
+    const fontFamily = getOgFontFamily(fonts ?? []);
+    return new ImageResponse((_jsxs("div", { style: {
+            width: "100%",
+            height: "100%",
+            display: "flex",
+            flexDirection: "column",
+            justifyContent: "space-between",
+            background: colors.background,
+            color: colors.foreground,
+            padding: "56px 72px 64px",
+            ...(fontFamily === undefined ? {} : { fontFamily }),
+        }, children: [_jsx("div", { style: { display: "flex", fontSize: 34, fontWeight: 700 }, children: brand?.name ?? "" }), _jsx("div", { style: { display: "flex", fontSize: title.length > 60 ? 56 : 68, fontWeight: 700, lineHeight: 1.08 }, children: title }), _jsxs("div", { style: { display: "flex", alignItems: "center", gap: 14, fontSize: 28 }, children: [_jsx("div", { style: { display: "flex", width: 12, height: 12, borderRadius: 2, background: colors.accent } }), _jsx("div", { style: { display: "flex" }, children: label })] })] })), { ...OG_IMAGE_SIZE, ...(fonts === undefined ? {} : { fonts: [...fonts] }) });
+}
+function getLabel(config) {
+    const context = getPageContext(config);
+    const name = context.messages.pages.blogTitle;
+    return context.brand === null ? name : formatMessage(context.messages.pages.titleWithBrand, { title: name, brand: context.brand });
+}
+/** The default export of an article's `opengraph-image.tsx`. */
+export async function BlogArticleOgImage({ params }) {
+    const config = getSoftureConfig();
+    const { slug } = await params;
+    const article = await getTextBySlug(config, slug);
+    const isVisible = article !== null && article.status === "published" && article.kind === "article";
+    const label = getLabel(config);
+    const { brand } = getBlogOptions(config);
+    const fonts = await loadBrandOgFonts(brand?.fonts ?? []);
+    if (!fonts.ok)
+        throw new Error(fonts.error);
+    return renderArticleOgImage({ title: isVisible ? article.title : label, label, brand, fonts: fonts.fonts.length === 0 ? undefined : fonts.fonts });
+}
+//# sourceMappingURL=og-image.js.map

package/dist/next/og-image.js.map

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

package/dist/next/pages.d.ts

@@ -0,0 +1,45 @@
+import type { Metadata } from "next/types.js";
+import type { ReactNode } from "react";
+type SlugParams = Promise<{
+    readonly slug: string;
+}>;
+export interface BlogIndexPageProps {
+    /** The app's call to action under the cards. */
+    readonly cta?: ReactNode;
+}
+export interface BlogArticlePageProps {
+    readonly params: SlugParams;
+    /** The app's call to action right after the text. */
+    readonly cta?: ReactNode;
+    /** The app's block under the article, e.g. `<Waitlist placement="blog" />`. */
+    readonly afterArticle?: ReactNode;
+}
+export interface GlossaryTermPageProps {
+    readonly params: SlugParams;
+    readonly cta?: ReactNode;
+}
+/** No page is built ahead: the build has no database. The first request renders a slug. */
+export declare function generateBlogStaticParams(): {
+    slug: string;
+}[];
+export declare function generateBlogIndexMetadata(): Promise<Metadata>;
+/** The listing: cards grouped by cluster, the pillar first. Mount with `dynamic = "force-dynamic"`. */
+export declare function BlogIndexPage({ cta }?: BlogIndexPageProps): Promise<import("react").JSX.Element>;
+export declare function generateArticleMetadata({ params }: {
+    readonly params: SlugParams;
+}): Promise<Metadata>;
+/** An article with "read next" under it. Mount with `revalidate` and `generateBlogStaticParams`. */
+export declare function BlogArticlePage({ params, cta, afterArticle }: BlogArticlePageProps): Promise<import("react").JSX.Element>;
+export declare function generateGlossaryIndexMetadata(): Promise<Metadata>;
+/** The glossary index. Mount with `dynamic = "force-dynamic"`. */
+export declare function GlossaryIndexPage(): Promise<import("react").JSX.Element>;
+export declare function generateTermMetadata({ params }: {
+    readonly params: SlugParams;
+}): Promise<Metadata>;
+/** A glossary term with the articles that expand on it. Mount with `revalidate` and `generateBlogStaticParams`. */
+export declare function GlossaryTermPage({ params, cta }: GlossaryTermPageProps): Promise<import("react").JSX.Element>;
+export declare function generateMethodMetadata(): Metadata;
+/** "How our texts are made". Mount it with `blog({ methodPage: true })`; without that it is a 404. */
+export declare function BlogMethodPage(): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=pages.d.ts.map

package/dist/next/pages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../src/next/pages.tsx"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAkBvC,KAAK,UAAU,GAAG,OAAO,CAAC;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAErD,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,qDAAqD;IACrD,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC;IACzB,+EAA+E;IAC/E,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,CAAC;CACnC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC;CAC1B;AAED,2FAA2F;AAC3F,wBAAgB,wBAAwB,IAAI;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAE7D;AAsED,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,QAAQ,CAAC,CAMnE;AAED,uGAAuG;AACvG,wBAAsB,aAAa,CAAC,EAAE,GAAG,EAAE,GAAE,kBAAuB,wCAOnE;AAED,wBAAsB,uBAAuB,CAAC,EAAE,MAAM,EAAE,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAO5G;AAED,oGAAoG;AACpG,wBAAsB,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,EAAE,EAAE,oBAAoB,wCAuBxF;AAED,wBAAsB,6BAA6B,IAAI,OAAO,CAAC,QAAQ,CAAC,CAMvE;AAED,kEAAkE;AAClE,wBAAsB,iBAAiB,yCAMtC;AAED,wBAAsB,oBAAoB,CAAC,EAAE,MAAM,EAAE,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAOzG;AAED,mHAAmH;AACnH,wBAAsB,gBAAgB,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,qBAAqB,wCAsB5E;AAED,wBAAgB,sBAAsB,IAAI,QAAQ,CAKjD;AAED,sGAAsG;AACtG,wBAAgB,cAAc,gCAK7B"}

package/dist/next/pages.js

@@ -0,0 +1,189 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// The blog's pages, ready to mount with one line each (docs/02-module-standard.md §8):
+//
+//   app/blog/page.tsx                  export { BlogIndexPage as default, generateBlogIndexMetadata as generateMetadata } from "@softure-ai/blog/next";
+//                                      export const dynamic = "force-dynamic";
+//   app/blog/[slug]/page.tsx           export { BlogArticlePage as default, generateArticleMetadata as generateMetadata, generateBlogStaticParams as generateStaticParams } from "@softure-ai/blog/next";
+//                                      export const revalidate = 300;
+//   app/blog/glossary/page.tsx         GlossaryIndexPage, generateGlossaryIndexMetadata; dynamic
+//   app/blog/glossary/[slug]/page.tsx  GlossaryTermPage, generateTermMetadata, generateBlogStaticParams; revalidate
+//   app/blog/how-we-write/page.tsx     BlogMethodPage, generateMethodMetadata (with `blog({ methodPage: true })`)
+//   app/blog/rss.xml/route.ts          serveBlogRss as GET; dynamic (see discovery.ts)
+//
+// Next reads `dynamic` and `revalidate` statically, so they stay literals in the app's files: the
+// listing and the glossary index render per request (a build has no database) over cached reads;
+// articles and terms render on their first request and are kept for `revalidate` seconds (ISR).
+// 301 and 410 are answered before the page by `@softure-ai/blog/proxy`; anything else that is not a
+// published text of the page's kind is a 404 here.
+import { formatMessage, getSiteUrls } from "@softure-ai/core";
+import { getSoftureConfig } from "@softure-ai/core/next";
+import { notFound } from "next/navigation";
+import { getRelatedArticles } from "../discovery/related.js";
+import { findArticlesLinkingTerm, renderPageBody } from "../pages/body.js";
+import { getArticleDates } from "../pages/dates.js";
+import { getArticleJsonLd, getGlossaryJsonLd, getTermJsonLd, serializeJsonLd } from "../pages/json-ld.js";
+import { getArticleCrumbs, getClusterLabel, getTermCrumbs, groupByCluster, sortTerms } from "../pages/listing.js";
+import { getArticlePath, getTermPath } from "../pages/paths.js";
+import { toGlossary } from "../render/glossary.js";
+import { getBlogOptions } from "../server/options.js";
+import { BlogArticleView } from "../ui/blog-article.js";
+import { GlossaryIndexView, GlossaryTermView } from "../ui/blog-glossary.js";
+import { BlogListingView } from "../ui/blog-listing.js";
+import { BlogMethodView } from "../ui/blog-method.js";
+import { getPageContext } from "./context.js";
+import { getPublishedArticles, getPublishedTerms, getTextBySlug } from "./data.js";
+/** No page is built ahead: the build has no database. The first request renders a slug. */
+export function generateBlogStaticParams() {
+    return [];
+}
+function isPublished(text, kind) {
+    return text !== null && text.status === "published" && text.kind === kind;
+}
+function getCrumbLabels(config, context) {
+    const clusters = getBlogOptions(config).clusters;
+    return {
+        blog: context.messages.pages.blogTitle,
+        glossary: context.messages.glossary.title,
+        cluster: (cluster) => getClusterLabel(cluster, clusters, config.locale),
+    };
+}
+function getJsonLdContext(config, context) {
+    return { urls: getSiteUrls(config), routes: context.routes, locale: config.locale, timezone: config.timezone, brand: context.brand };
+}
+function getBodyOptions(config, context, terms) {
+    const origins = [config.appOrigin, getSiteUrls(config).origin];
+    return { glossary: toGlossary(terms), routes: context.routes, options: getBlogOptions(config), origins, messages: context.messages };
+}
+function withBrand(title, context) {
+    return context.brand === null ? title : formatMessage(context.messages.pages.titleWithBrand, { title, brand: context.brand });
+}
+/** A page's canonical URL: seo's host and trailing-slash rule when the app lists seo, else on `appOrigin`. */
+function getCanonicalUrl(config, path) {
+    return getSiteUrls(config).getCanonicalUrl(path);
+}
+/** The feed link a reader finds in `<head>` (`<link rel="alternate" type="application/rss+xml">`); a file, so no trailing-slash rule. */
+function getFeedAlternates(config, context) {
+    return { "application/rss+xml": [{ url: `${getSiteUrls(config).origin}${context.routes.rss}`, title: withBrand(context.messages.pages.blogTitle, context) }] };
+}
+/** Metadata of a page with a fixed path; an empty listing stays out of the index (thin content). */
+function getStaticMetadata(config, context, page) {
+    return {
+        title: withBrand(page.title, context),
+        description: page.description,
+        robots: { index: page.isEmpty !== true, follow: true },
+        alternates: { canonical: getCanonicalUrl(config, page.path), ...(page.hasFeed === true ? { types: getFeedAlternates(config, context) } : {}) },
+        openGraph: { type: "website", title: page.title, description: page.description, url: getCanonicalUrl(config, page.path), ...(context.brand === null ? {} : { siteName: context.brand }) },
+    };
+}
+function getTextMetadata(config, context, text, path, options = {}) {
+    const dates = getArticleDates(text, config.timezone);
+    const url = getCanonicalUrl(config, path);
+    return {
+        title: withBrand(text.title, context),
+        description: text.description,
+        robots: { index: true, follow: true },
+        alternates: { canonical: url, ...(options.hasFeed === true ? { types: getFeedAlternates(config, context) } : {}) },
+        openGraph: {
+            type: "article",
+            title: text.title,
+            description: text.description,
+            url,
+            locale: config.locale,
+            publishedTime: dates.published,
+            modifiedTime: dates.updated ?? dates.published,
+            ...(context.brand === null ? {} : { siteName: context.brand }),
+        },
+    };
+}
+export async function generateBlogIndexMetadata() {
+    const config = getSoftureConfig();
+    const context = getPageContext(config);
+    const articles = await getPublishedArticles(config);
+    const copy = context.messages.pages;
+    return getStaticMetadata(config, context, { title: copy.blogTitle, description: copy.blogDescription, path: context.routes.index, isEmpty: articles.length === 0, hasFeed: true });
+}
+/** The listing: cards grouped by cluster, the pillar first. Mount with `dynamic = "force-dynamic"`. */
+export async function BlogIndexPage({ cta } = {}) {
+    const config = getSoftureConfig();
+    const context = getPageContext(config);
+    const labels = getCrumbLabels(config, context);
+    const [articles, terms] = await Promise.all([getPublishedArticles(config), getPublishedTerms(config)]);
+    const groups = groupByCluster(articles, labels.cluster, context.messages.pages.otherCluster);
+    return _jsx(BlogListingView, { context: context, groups: groups, termCount: terms.length, timezone: config.timezone, cta: cta });
+}
+export async function generateArticleMetadata({ params }) {
+    const config = getSoftureConfig();
+    const { slug } = await params;
+    const article = await getTextBySlug(config, slug);
+    if (!isPublished(article, "article"))
+        return {};
+    const context = getPageContext(config);
+    return getTextMetadata(config, context, article, getArticlePath(context.routes, article.slug), { hasFeed: true });
+}
+/** An article with "read next" under it. Mount with `revalidate` and `generateBlogStaticParams`. */
+export async function BlogArticlePage({ params, cta, afterArticle }) {
+    const config = getSoftureConfig();
+    const { slug } = await params;
+    const article = await getTextBySlug(config, slug);
+    if (!isPublished(article, "article"))
+        notFound();
+    const context = getPageContext(config);
+    const [terms, published] = await Promise.all([getPublishedTerms(config), getPublishedArticles(config)]);
+    const body = renderPageBody(article, getBodyOptions(config, context, terms));
+    const crumbs = getArticleCrumbs(article, context.routes, getCrumbLabels(config, context));
+    const jsonLd = serializeJsonLd(getArticleJsonLd(article, crumbs, getJsonLdContext(config, context)));
+    return (_jsx(BlogArticleView, { context: context, article: article, dates: getArticleDates(article, config.timezone), body: body, crumbs: crumbs, jsonLd: jsonLd, cta: cta, afterArticle: afterArticle, related: getRelatedArticles(article, published) }));
+}
+export async function generateGlossaryIndexMetadata() {
+    const config = getSoftureConfig();
+    const context = getPageContext(config);
+    const terms = await getPublishedTerms(config);
+    const copy = context.messages.glossary;
+    return getStaticMetadata(config, context, { title: copy.title, description: copy.description, path: context.routes.glossary, isEmpty: terms.length === 0 });
+}
+/** The glossary index. Mount with `dynamic = "force-dynamic"`. */
+export async function GlossaryIndexPage() {
+    const config = getSoftureConfig();
+    const context = getPageContext(config);
+    const terms = sortTerms(await getPublishedTerms(config), config.locale);
+    const jsonLd = terms.length === 0 ? null : serializeJsonLd(getGlossaryJsonLd(terms, getJsonLdContext(config, context), context.messages.glossary.title));
+    return _jsx(GlossaryIndexView, { context: context, terms: terms, jsonLd: jsonLd });
+}
+export async function generateTermMetadata({ params }) {
+    const config = getSoftureConfig();
+    const { slug } = await params;
+    const term = await getTextBySlug(config, slug);
+    if (!isPublished(term, "term"))
+        return {};
+    const context = getPageContext(config);
+    return getTextMetadata(config, context, term, getTermPath(context.routes, term.slug));
+}
+/** A glossary term with the articles that expand on it. Mount with `revalidate` and `generateBlogStaticParams`. */
+export async function GlossaryTermPage({ params, cta }) {
+    const config = getSoftureConfig();
+    const { slug } = await params;
+    const term = await getTextBySlug(config, slug);
+    if (!isPublished(term, "term"))
+        notFound();
+    const context = getPageContext(config);
+    const [terms, articles] = await Promise.all([getPublishedTerms(config), getPublishedArticles(config)]);
+    const bodyOptions = getBodyOptions(config, context, terms);
+    const crumbs = getTermCrumbs(term, context.routes, getCrumbLabels(config, context));
+    const jsonLd = serializeJsonLd(getTermJsonLd(term, crumbs, getJsonLdContext(config, context), context.messages.glossary.title));
+    return (_jsx(GlossaryTermView, { context: context, term: term, dates: getArticleDates(term, config.timezone), body: renderPageBody(term, bodyOptions), crumbs: crumbs, jsonLd: jsonLd, articles: findArticlesLinkingTerm(articles, term.slug, bodyOptions), cta: cta }));
+}
+export function generateMethodMetadata() {
+    const config = getSoftureConfig();
+    const context = getPageContext(config);
+    const copy = context.messages.method;
+    return getStaticMetadata(config, context, { title: copy.title, description: copy.description, path: context.routes.method });
+}
+/** "How our texts are made". Mount it with `blog({ methodPage: true })`; without that it is a 404. */
+export function BlogMethodPage() {
+    const config = getSoftureConfig();
+    const context = getPageContext(config);
+    if (context.methodPath === null)
+        notFound();
+    return _jsx(BlogMethodView, { context: context });
+}
+//# sourceMappingURL=pages.js.map

package/dist/next/pages.js.map

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

package/dist/next/refresh.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `POST <routes.refresh>`: expires every cached read of the blog, so the next request reads the
+ * tables again. Answers 204 refreshed, 401 for a missing or wrong secret, 429 over the `blog-refresh`
+ * bucket (per client address; callers without one share a single count), 503 when counting fails,
+ * 500 when the secret is not set or shorter than 32 characters. A missing security module or bucket
+ * is a setup error, thrown.
+ */
+export declare function refreshBlogCache(request: Request): Promise<Response>;
+//# sourceMappingURL=refresh.d.ts.map

package/dist/next/refresh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refresh.d.ts","sourceRoot":"","sources":["../../src/next/refresh.ts"],"names":[],"mappings":"AA8BA;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CA0B1E"}

package/dist/next/refresh.js

@@ -0,0 +1,81 @@
+// The cache refresh route: `softure-blog publish --commit` calls it so the running app shows the change
+// at once instead of after `revalidateSeconds`. Mount it in app/api/blog/refresh/route.ts:
+//
+//   export { refreshBlogCache as POST } from "@softure-ai/blog/next";
+//
+// The caller is the command, not a person: no session, so the route checks a Bearer secret from the
+// environment (BLOG_REFRESH_SECRET). Order, as in mcp-access: identify the client, count the
+// request, check the secret, then expire the tag. Each refusal happens before the next step costs
+// anything. security is an optional dependency of the blog, reached through a dynamic import.
+import { createHash, timingSafeEqual } from "node:crypto";
+import { errorLogLabel, getModule } from "@softure-ai/core";
+import { getSoftureConfig } from "@softure-ai/core/next";
+import { revalidateTag } from "next/cache";
+import { BLOG_REFRESH_RATE_LIMIT_BUCKET, BLOG_REFRESH_SECRET_ENV, MIN_REFRESH_SECRET_LENGTH } from "../discovery/refresh.js";
+import { getBlogContext } from "./context.js";
+import { BLOG_CACHE_TAG } from "./data.js";
+const SECURITY_MODULE_ID = "security";
+/**
+ * The one rate limit key of every caller `identifyClient` cannot place: the command often calls the
+ * app on a private name (`--app-url http://web:3000`), past the proxy that sets the client header.
+ */
+const UNIDENTIFIED_CLIENT_KEY = "unidentified";
+const BEARER_PREFIX = /^Bearer[ \t]+/i;
+const NO_STORE = { "cache-control": "no-store" };
+function answer(status, headers = {}) {
+    return new Response(null, { status, headers: { ...NO_STORE, ...headers } });
+}
+/**
+ * `POST <routes.refresh>`: expires every cached read of the blog, so the next request reads the
+ * tables again. Answers 204 refreshed, 401 for a missing or wrong secret, 429 over the `blog-refresh`
+ * bucket (per client address; callers without one share a single count), 503 when counting fails,
+ * 500 when the secret is not set or shorter than 32 characters. A missing security module or bucket
+ * is a setup error, thrown.
+ */
+export async function refreshBlogCache(request) {
+    const secret = (process.env[BLOG_REFRESH_SECRET_ENV] ?? "").trim();
+    if (secret.length < MIN_REFRESH_SECRET_LENGTH) {
+        console.error(`@softure-ai/blog: the cache refresh route needs ${BLOG_REFRESH_SECRET_ENV} of at least ${String(MIN_REFRESH_SECRET_LENGTH)} characters`);
+        return answer(500);
+    }
+    const config = getSoftureConfig();
+    assertRateLimitBucket(config);
+    const { consumeRateLimit, identifyClient } = await import("@softure-ai/security/server");
+    const client = identifyClient({ config }, request.headers);
+    let limit;
+    try {
+        // Counted before the secret is checked, so a flood of guesses is stopped first.
+        limit = await consumeRateLimit(await getBlogContext(config), { bucket: BLOG_REFRESH_RATE_LIMIT_BUCKET, key: client.ok ? client.value : UNIDENTIFIED_CLIENT_KEY });
+    }
+    catch (error) {
+        // Fails closed and says nothing: the route is public and this runs before authentication.
+        console.error(`@softure-ai/blog: counting a cache refresh failed: ${errorLogLabel(error)}`);
+        return answer(503);
+    }
+    if (!limit.ok)
+        return answer(429, { "retry-after": String(limit.retryAfterSeconds) });
+    if (!hasSecret(request.headers.get("authorization"), secret))
+        return answer(401, { "www-authenticate": "Bearer" });
+    // `expire: 0`: the next request waits for fresh reads. The "max" profile would serve the old page once more.
+    revalidateTag(BLOG_CACHE_TAG, { expire: 0 });
+    return answer(204);
+}
+/** Compares digests in constant time, so the answer time says nothing about the secret's length or prefix. */
+function hasSecret(header, secret) {
+    if (header === null || !BEARER_PREFIX.test(header))
+        return false;
+    const given = createHash("sha256").update(header.replace(BEARER_PREFIX, "").trim()).digest();
+    return timingSafeEqual(given, createHash("sha256").update(secret).digest());
+}
+/** A missing module or bucket is a setup bug: thrown, so it reaches the log by name instead of a quiet 503. */
+function assertRateLimitBucket(config) {
+    const security = getModule(config, SECURITY_MODULE_ID);
+    if (security === undefined) {
+        throw new Error("@softure-ai/blog: the cache refresh route is rate-limited by the security module; add security() to modules");
+    }
+    const options = security.options;
+    if (options?.buckets?.[BLOG_REFRESH_RATE_LIMIT_BUCKET] === undefined) {
+        throw new Error(`@softure-ai/blog: the security module has no "${BLOG_REFRESH_RATE_LIMIT_BUCKET}" bucket; spread BLOG_RATE_LIMIT_BUCKETS into security({ buckets })`);
+    }
+}
+//# sourceMappingURL=refresh.js.map

package/dist/next/refresh.js.map

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