@softure-ai/blog 0.0.0-stage → 0.1.5

package/dist/pages/index.js

@@ -0,0 +1,9 @@
+// Page logic without React and without Next: paths, dates, listing order, crumbs, JSON-LD and the
+// 301/410 decisions. The components (`../ui/`) and the Next adapter (`../next/`) render what it returns.
+export { findArticlesLinkingTerm, renderPageBody } from "./body.js";
+export { formatDay, getArticleDates, getDayInZone } from "./dates.js";
+export { getArticleImageUrl, getArticleJsonLd, getGlossaryJsonLd, getTermJsonLd, serializeJsonLd } from "./json-ld.js";
+export { getArticleCrumbs, getClusterAnchor, getClusterLabel, getTermCrumbs, groupByCluster, sortTerms, splitClusterLead, } from "./listing.js";
+export { getArticlePath, getReservedSlugs, getTermPath, getTextPath, matchBlogPath, normalizeRoute, } from "./paths.js";
+export { buildGonePage, createCachedBlogPathDecider, decideBlogPath, } from "./redirects.js";
+//# sourceMappingURL=index.js.map

package/dist/pages/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pages/index.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,yGAAyG;AACzG,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAA8B,MAAM,WAAW,CAAC;AAChG,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,YAAY,EAAqB,MAAM,YAAY,CAAC;AACzF,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,aAAa,EAAE,eAAe,EAAsB,MAAM,cAAc,CAAC;AAC3I,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,cAAc,EACd,SAAS,EACT,gBAAgB,GAIjB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,aAAa,EACb,cAAc,GAIf,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,aAAa,EACb,2BAA2B,EAC3B,cAAc,GAKf,MAAM,gBAAgB,CAAC"}

package/dist/pages/json-ld.d.ts

@@ -0,0 +1,33 @@
+import type { Locale, SiteUrls } from "@softure-ai/core";
+import type { BlogArticle } from "../contract.js";
+import type { Crumb } from "./listing.js";
+import { type BlogRoutes } from "./paths.js";
+export interface JsonLdContext {
+    /** The site's origin and canonical rule (`getSiteUrls(config)`: seo's when the app lists it, else `appOrigin`). */
+    readonly urls: SiteUrls;
+    readonly routes: BlogRoutes;
+    readonly locale: Locale;
+    readonly timezone: string;
+    /** The brand as author and publisher; `null` leaves them out. */
+    readonly brand: string | null;
+}
+type JsonLd = Record<string, unknown>;
+/** JSON for a `<script type="application/ld+json">`: no text in it can close the tag. */
+export declare function serializeJsonLd(data: unknown): string;
+/**
+ * The URL of an article's OG image (Next serves `opengraph-image` under the page's path). A file, not a
+ * page: on the site's origin without the canonical trailing-slash rule.
+ */
+export declare function getArticleImageUrl(article: Pick<BlogArticle, "slug">, ctx: Pick<JsonLdContext, "urls" | "routes">): string;
+/**
+ * An article: `BlogPosting` (an `Article` type), its `BreadcrumbList`, and `FAQPage` when it has
+ * questions, in one `@graph`. `dateModified` equals the visible update day, or the publication day
+ * when the content never changed: a mismatch reads as a faked freshness.
+ */
+export declare function getArticleJsonLd(article: BlogArticle, crumbs: readonly Crumb[], ctx: JsonLdContext): JsonLd;
+/** A term: `DefinedTerm` in the glossary's `DefinedTermSet`, and its `BreadcrumbList`. */
+export declare function getTermJsonLd(term: BlogArticle, crumbs: readonly Crumb[], ctx: JsonLdContext, glossaryTitle: string): JsonLd;
+/** The glossary index: one `DefinedTermSet` with every term, in the order given. */
+export declare function getGlossaryJsonLd(terms: readonly BlogArticle[], ctx: JsonLdContext, glossaryTitle: string): JsonLd;
+export {};
+//# sourceMappingURL=json-ld.d.ts.map

package/dist/pages/json-ld.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-ld.d.ts","sourceRoot":"","sources":["../../src/pages/json-ld.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAA+B,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAE1E,MAAM,WAAW,aAAa;IAC5B,mHAAmH;IACnH,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEtC,yFAAyF;AACzF,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAErD;AAeD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,QAAQ,CAAC,GAAG,MAAM,CAE1H;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,KAAK,EAAE,EAAE,GAAG,EAAE,aAAa,GAAG,MAAM,CA4B3G;AAMD,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,KAAK,EAAE,EAAE,GAAG,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAkB5H;AAED,oFAAoF;AACpF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,EAAE,GAAG,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAWlH"}

package/dist/pages/json-ld.js

@@ -0,0 +1,95 @@
+import { getArticleDates } from "./dates.js";
+import { getArticlePath, getTermPath } from "./paths.js";
+/** JSON for a `<script type="application/ld+json">`: no text in it can close the tag. */
+export function serializeJsonLd(data) {
+    return JSON.stringify(data).replace(/</g, "\\u003c");
+}
+/** A crumb's URL: its page's canonical URL, then its fragment (a cluster's anchor on the listing), which the canonical rule drops. */
+function getCrumbUrl(path, urls) {
+    const hashAt = path.indexOf("#");
+    return hashAt === -1 ? urls.getCanonicalUrl(path) : `${urls.getCanonicalUrl(path.slice(0, hashAt))}${path.slice(hashAt)}`;
+}
+function getBreadcrumbs(crumbs, urls) {
+    return {
+        "@type": "BreadcrumbList",
+        itemListElement: crumbs.map((crumb, index) => ({ "@type": "ListItem", position: index + 1, name: crumb.name, item: getCrumbUrl(crumb.path, urls) })),
+    };
+}
+/**
+ * The URL of an article's OG image (Next serves `opengraph-image` under the page's path). A file, not a
+ * page: on the site's origin without the canonical trailing-slash rule.
+ */
+export function getArticleImageUrl(article, ctx) {
+    return `${ctx.urls.origin}${getArticlePath(ctx.routes, article.slug)}/opengraph-image`;
+}
+/**
+ * An article: `BlogPosting` (an `Article` type), its `BreadcrumbList`, and `FAQPage` when it has
+ * questions, in one `@graph`. `dateModified` equals the visible update day, or the publication day
+ * when the content never changed: a mismatch reads as a faked freshness.
+ */
+export function getArticleJsonLd(article, crumbs, ctx) {
+    const dates = getArticleDates(article, ctx.timezone);
+    const url = ctx.urls.getCanonicalUrl(getArticlePath(ctx.routes, article.slug));
+    const brand = ctx.brand === null ? null : { "@type": "Organization", name: ctx.brand, url: ctx.urls.getCanonicalUrl("/") };
+    const graph = [
+        {
+            "@type": "BlogPosting",
+            "@id": `${url}#article`,
+            mainEntityOfPage: url,
+            url,
+            headline: article.title,
+            description: article.description,
+            inLanguage: ctx.locale,
+            datePublished: dates.published,
+            dateModified: dates.updated ?? dates.published,
+            ...(brand === null ? {} : { author: brand, publisher: brand }),
+            image: getArticleImageUrl(article, ctx),
+            ...(article.sources.length > 0 ? { citation: article.sources.map((source) => ({ "@type": "CreativeWork", name: source.name, url: source.url })) } : {}),
+        },
+        getBreadcrumbs(crumbs, ctx.urls),
+    ];
+    if (article.faq.length > 0) {
+        graph.push({
+            "@type": "FAQPage",
+            mainEntity: article.faq.map((entry) => ({ "@type": "Question", name: entry.question, acceptedAnswer: { "@type": "Answer", text: entry.answer } })),
+        });
+    }
+    return { "@context": "https://schema.org", "@graph": graph };
+}
+function getTermSetReference(ctx, glossaryTitle) {
+    return { "@type": "DefinedTermSet", "@id": `${ctx.urls.getCanonicalUrl(ctx.routes.glossary)}#glossary`, name: glossaryTitle };
+}
+/** A term: `DefinedTerm` in the glossary's `DefinedTermSet`, and its `BreadcrumbList`. */
+export function getTermJsonLd(term, crumbs, ctx, glossaryTitle) {
+    const url = ctx.urls.getCanonicalUrl(getTermPath(ctx.routes, term.slug));
+    return {
+        "@context": "https://schema.org",
+        "@graph": [
+            {
+                "@type": "DefinedTerm",
+                "@id": `${url}#term`,
+                url,
+                name: term.title,
+                description: term.description,
+                inLanguage: ctx.locale,
+                ...(term.termForms.length > 0 ? { alternateName: term.termForms } : {}),
+                inDefinedTermSet: getTermSetReference(ctx, glossaryTitle),
+            },
+            getBreadcrumbs(crumbs, ctx.urls),
+        ],
+    };
+}
+/** The glossary index: one `DefinedTermSet` with every term, in the order given. */
+export function getGlossaryJsonLd(terms, ctx, glossaryTitle) {
+    return {
+        "@context": "https://schema.org",
+        ...getTermSetReference(ctx, glossaryTitle),
+        url: ctx.urls.getCanonicalUrl(ctx.routes.glossary),
+        inLanguage: ctx.locale,
+        hasDefinedTerm: terms.map((term) => {
+            const url = ctx.urls.getCanonicalUrl(getTermPath(ctx.routes, term.slug));
+            return { "@type": "DefinedTerm", "@id": `${url}#term`, name: term.title, description: term.description, url };
+        }),
+    };
+}
+//# sourceMappingURL=json-ld.js.map

package/dist/pages/json-ld.js.map

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

package/dist/pages/listing.d.ts

@@ -0,0 +1,46 @@
+import type { Locale } from "@softure-ai/core";
+import type { BlogArticle } from "../contract.js";
+import type { LocalizedText } from "../options.js";
+import { type BlogRoutes } from "./paths.js";
+export interface ClusterGroup<T> {
+    /** `null`: the texts without a cluster. */
+    readonly cluster: string | null;
+    readonly label: string;
+    /** The cluster's pillar, shown before the other cards; `null` without one. */
+    readonly lead: T | null;
+    /** The other texts, in the order they came in (newest first from `listArticles`). */
+    readonly rest: readonly T[];
+}
+/** The display name of a cluster: the app's label in the locale, else the key with spaces and a capital. */
+export declare function getClusterLabel(cluster: string, labels: Readonly<Record<string, LocalizedText>>, locale: Locale): string;
+/** The anchor of a cluster's section on the listing: the target of the article's middle crumb. */
+export declare function getClusterAnchor(cluster: string): string;
+/** The pillar leads its group; the rest keep their order. Without a pillar there is no lead. */
+export declare function splitClusterLead<T extends Pick<BlogArticle, "isPillar">>(articles: readonly T[]): {
+    lead: T | null;
+    rest: T[];
+};
+/**
+ * Articles in groups by cluster. A group's place comes from its newest text (a fresh topic on top);
+ * texts without a cluster always come last, under `otherLabel`.
+ */
+export declare function groupByCluster<T extends Pick<BlogArticle, "cluster" | "isPillar">>(articles: readonly T[], getLabel: (cluster: string) => string, otherLabel: string): ClusterGroup<T>[];
+/** Terms in the locale's alphabetical order (a letter with a diacritic right after its base letter, not after Z). */
+export declare function sortTerms<T extends Pick<BlogArticle, "title">>(terms: readonly T[], locale: Locale): T[];
+export interface Crumb {
+    readonly name: string;
+    /** The path on the site; the last crumb (the page itself) has one too, as JSON-LD needs it. */
+    readonly path: string;
+}
+export interface CrumbLabels {
+    /** The listing's name. */
+    readonly blog: string;
+    /** The glossary's name. */
+    readonly glossary: string;
+    readonly cluster: (cluster: string) => string;
+}
+/** Blog › cluster › title; without a cluster, Blog › title. */
+export declare function getArticleCrumbs(article: Pick<BlogArticle, "slug" | "title" | "cluster">, routes: BlogRoutes, labels: CrumbLabels): Crumb[];
+/** Blog › glossary › term. */
+export declare function getTermCrumbs(term: Pick<BlogArticle, "slug" | "title">, routes: BlogRoutes, labels: CrumbLabels): Crumb[];
+//# sourceMappingURL=listing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"listing.d.ts","sourceRoot":"","sources":["../../src/pages/listing.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAA+B,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAE1E,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACxB,qFAAqF;IACrF,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;CAC7B;AAED,4GAA4G;AAC5G,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAKxH;AAED,kGAAkG;AAClG,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,gGAAgG;AAChG,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,GAAG;IAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,EAAE,CAAA;CAAE,CAG/H;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,UAAU,CAAC,EAChF,QAAQ,EAAE,SAAS,CAAC,EAAE,EACtB,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,EACrC,UAAU,EAAE,MAAM,GACjB,YAAY,CAAC,CAAC,CAAC,EAAE,CAYnB;AAED,qHAAqH;AACrH,wBAAgB,SAAS,CAAC,CAAC,SAAS,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,EAAE,CAExG;AAED,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+FAA+F;IAC/F,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,0BAA0B;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2BAA2B;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;CAC/C;AAED,+DAA+D;AAC/D,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,GAAG,KAAK,EAAE,CAO3I;AAED,8BAA8B;AAC9B,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,GAAG,KAAK,EAAE,CAMzH"}

package/dist/pages/listing.js

@@ -0,0 +1,57 @@
+import { getArticlePath, getTermPath } from "./paths.js";
+/** The display name of a cluster: the app's label in the locale, else the key with spaces and a capital. */
+export function getClusterLabel(cluster, labels, locale) {
+    const label = labels[cluster];
+    if (label !== undefined)
+        return label[locale] ?? label.en;
+    const words = cluster.replace(/-/g, " ");
+    return words.charAt(0).toUpperCase() + words.slice(1);
+}
+/** The anchor of a cluster's section on the listing: the target of the article's middle crumb. */
+export function getClusterAnchor(cluster) {
+    return `cluster-${cluster}`;
+}
+/** The pillar leads its group; the rest keep their order. Without a pillar there is no lead. */
+export function splitClusterLead(articles) {
+    const lead = articles.find((article) => article.isPillar) ?? null;
+    return { lead, rest: articles.filter((article) => article !== lead) };
+}
+/**
+ * Articles in groups by cluster. A group's place comes from its newest text (a fresh topic on top);
+ * texts without a cluster always come last, under `otherLabel`.
+ */
+export function groupByCluster(articles, getLabel, otherLabel) {
+    const groups = new Map();
+    for (const article of articles) {
+        const list = groups.get(article.cluster) ?? [];
+        list.push(article);
+        groups.set(article.cluster, list);
+    }
+    const named = [...groups.entries()]
+        .filter((entry) => entry[0] !== null)
+        .map(([cluster, list]) => ({ cluster, label: getLabel(cluster), ...splitClusterLead(list) }));
+    const rest = groups.get(null);
+    return rest === undefined ? named : [...named, { cluster: null, label: otherLabel, ...splitClusterLead(rest) }];
+}
+/** Terms in the locale's alphabetical order (a letter with a diacritic right after its base letter, not after Z). */
+export function sortTerms(terms, locale) {
+    return [...terms].sort((a, b) => a.title.localeCompare(b.title, locale));
+}
+/** Blog › cluster › title; without a cluster, Blog › title. */
+export function getArticleCrumbs(article, routes, labels) {
+    const crumbs = [{ name: labels.blog, path: routes.index }];
+    if (article.cluster !== null) {
+        crumbs.push({ name: labels.cluster(article.cluster), path: `${routes.index}#${getClusterAnchor(article.cluster)}` });
+    }
+    crumbs.push({ name: article.title, path: getArticlePath(routes, article.slug) });
+    return crumbs;
+}
+/** Blog › glossary › term. */
+export function getTermCrumbs(term, routes, labels) {
+    return [
+        { name: labels.blog, path: routes.index },
+        { name: labels.glossary, path: routes.glossary },
+        { name: term.title, path: getTermPath(routes, term.slug) },
+    ];
+}
+//# sourceMappingURL=listing.js.map

package/dist/pages/listing.js.map

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

package/dist/pages/paths.d.ts

@@ -0,0 +1,37 @@
+export interface BlogRoutes {
+    /** The listing; an article lives at `<index>/<slug>`. */
+    readonly index: string;
+    /** The glossary index; a term lives at `<glossary>/<slug>`. */
+    readonly glossary: string;
+    /** The "how our texts are made" page (only with `blog({ methodPage: true })`). */
+    readonly method: string;
+    /** The RSS feed of the published texts. */
+    readonly rss: string;
+}
+export type BlogPathKind = "article" | "term";
+export interface BlogPathMatch {
+    readonly kind: BlogPathKind;
+    readonly slug: string;
+}
+/** A route without its trailing slashes (the root stays `/`). A loop, not `/\/+$/`: linear on any input. */
+export declare function normalizeRoute(path: string): string;
+export declare function getArticlePath(routes: BlogRoutes, slug: string): string;
+export declare function getTermPath(routes: BlogRoutes, slug: string): string;
+/** The path of a text by its kind. */
+export declare function getTextPath(routes: BlogRoutes, kind: BlogPathKind, slug: string): string;
+/**
+ * Slugs an article cannot take: a static page one segment under the listing (the glossary index,
+ * the method page when the app mounts it) wins over the article route, so such an article would be
+ * unreachable. Merged with the app's own `reservedSlugs`, without repeats.
+ */
+export declare function getReservedSlugs(routes: BlogRoutes, options: {
+    readonly methodPage: boolean;
+    readonly reservedSlugs: readonly string[];
+}): string[];
+/**
+ * The text a request path names: exactly `<index>/<slug>` or `<glossary>/<slug>` with a slug the
+ * parser could have accepted, and not a reserved slug. Anything else (the listing, a deeper path such
+ * as an OG image, upper case, a static page) is `null`, so it never costs a database query.
+ */
+export declare function matchBlogPath(pathname: string, routes: BlogRoutes, reservedSlugs: readonly string[]): BlogPathMatch | null;
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/pages/paths.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,UAAU;IACzB,yDAAyD;IACzD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,kFAAkF;IAClF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,MAAM,CAAC;AAE9C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAMD,4GAA4G;AAC5G,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAInD;AAMD,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,sCAAsC;AACtC,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAExF;AAUD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE;IAAE,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAAG,MAAM,EAAE,CAInJ;AAMD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,MAAM,EAAE,GAAG,aAAa,GAAG,IAAI,CAM1H"}

package/dist/pages/paths.js

@@ -0,0 +1,61 @@
+// Where the blog's pages live: the module's routes (`blog({ routes })`), the paths of articles and
+// terms under them, the slugs the static pages take, and the reverse: which text a request path names.
+/** A slug as the file parser accepts it: kebab-case, at most 100 characters. */
+const SLUG = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+const MAX_SLUG_LENGTH = 100;
+/** A route without its trailing slashes (the root stays `/`). A loop, not `/\/+$/`: linear on any input. */
+export function normalizeRoute(path) {
+    let end = path.length;
+    while (end > 1 && path[end - 1] === "/")
+        end -= 1;
+    return path.slice(0, end);
+}
+function joinPath(base, segment) {
+    return base === "/" ? `/${segment}` : `${base}/${segment}`;
+}
+export function getArticlePath(routes, slug) {
+    return joinPath(routes.index, slug);
+}
+export function getTermPath(routes, slug) {
+    return joinPath(routes.glossary, slug);
+}
+/** The path of a text by its kind. */
+export function getTextPath(routes, kind, slug) {
+    return kind === "term" ? getTermPath(routes, slug) : getArticlePath(routes, slug);
+}
+/** The one segment `path` adds under `base`, or `null` when it is not exactly one segment deeper. */
+function getChildSegment(base, path) {
+    const prefix = base === "/" ? "/" : `${base}/`;
+    if (!path.startsWith(prefix))
+        return null;
+    const rest = path.slice(prefix.length);
+    return rest === "" || rest.includes("/") ? null : rest;
+}
+/**
+ * Slugs an article cannot take: a static page one segment under the listing (the glossary index,
+ * the method page when the app mounts it) wins over the article route, so such an article would be
+ * unreachable. Merged with the app's own `reservedSlugs`, without repeats.
+ */
+export function getReservedSlugs(routes, options) {
+    const pages = options.methodPage ? [routes.glossary, routes.method] : [routes.glossary];
+    const derived = pages.map((path) => getChildSegment(routes.index, path)).filter((segment) => segment !== null);
+    return [...new Set([...options.reservedSlugs, ...derived])];
+}
+function isSlug(segment) {
+    return segment.length <= MAX_SLUG_LENGTH && SLUG.test(segment);
+}
+/**
+ * The text a request path names: exactly `<index>/<slug>` or `<glossary>/<slug>` with a slug the
+ * parser could have accepted, and not a reserved slug. Anything else (the listing, a deeper path such
+ * as an OG image, upper case, a static page) is `null`, so it never costs a database query.
+ */
+export function matchBlogPath(pathname, routes, reservedSlugs) {
+    const termSlug = getChildSegment(routes.glossary, pathname);
+    if (termSlug !== null && isSlug(termSlug))
+        return { kind: "term", slug: termSlug };
+    const articleSlug = getChildSegment(routes.index, pathname);
+    if (articleSlug !== null && isSlug(articleSlug) && !reservedSlugs.includes(articleSlug))
+        return { kind: "article", slug: articleSlug };
+    return null;
+}
+//# sourceMappingURL=paths.js.map

package/dist/pages/paths.js.map

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

package/dist/pages/redirects.d.ts

@@ -0,0 +1,57 @@
+import type { BlogArticleKind, BlogArticleStatus } from "../contract.js";
+import { type BlogPathMatch, type BlogRoutes } from "./paths.js";
+export type BlogPathDecision = {
+    readonly kind: "pass";
+} | {
+    readonly kind: "redirect";
+    readonly path: string;
+} | {
+    readonly kind: "gone";
+};
+export interface BlogPathLookup {
+    /** The row under its current slug, in any status; `null` when there is none. */
+    readonly findText: (slug: string) => Promise<{
+        readonly status: BlogArticleStatus;
+        readonly kind: BlogArticleKind;
+    } | null>;
+    /** The current slug of the text that once had `oldSlug`: the target of a 301. */
+    readonly findRedirect: (oldSlug: string) => Promise<string | null>;
+}
+/**
+ * - A current row wins over the history: a slug back in use is the address of a text again.
+ * - A withdrawn text under the path of its own kind → 410.
+ * - A published text under the other kind's path (a term at the article path) → 301 to its own path.
+ * - An old slug → 301 to the current path of its text (which may answer 410 itself).
+ * - Everything else (unknown, draft) passes on: the page answers 404.
+ */
+export declare function decideBlogPath(match: BlogPathMatch, routes: BlogRoutes, lookup: BlogPathLookup): Promise<BlogPathDecision>;
+export interface CachedDeciderOptions {
+    /** How long a decision holds; an urgent fix through the CLI shows up at the latest after this. Default 60 s. */
+    readonly ttlMs?: number;
+    /** The most decisions kept; paths a scanner makes up cannot grow the memory. Default 500. */
+    readonly maxEntries?: number;
+    readonly now?: () => number;
+    /** Where a failed lookup is reported; `console.error` by default. */
+    readonly onError?: (message: string) => void;
+}
+/**
+ * Decisions with a memory: the proxy runs on every request and the pages are cached (ISR), so
+ * without one every cached view would cost a query. A failed lookup is not remembered and passes the
+ * request on: the page answers by itself, and a database outage never turns the blog into a 500.
+ */
+export declare function createCachedBlogPathDecider(routes: BlogRoutes, lookup: BlogPathLookup, { ttlMs, maxEntries, now, onError }?: CachedDeciderOptions): (match: BlogPathMatch) => Promise<BlogPathDecision>;
+export interface GonePageCopy {
+    readonly title: string;
+    readonly heading: string;
+    readonly body: string;
+    readonly link: string;
+}
+/**
+ * The body of a 410: a short page with the way on. No React (the proxy renders no components), no
+ * script, no external resource; `noindex`. Every value is escaped: copy comes from the app's overrides.
+ */
+export declare function buildGonePage(copy: GonePageCopy, options: {
+    readonly lang: string;
+    readonly indexPath: string;
+}): string;
+//# sourceMappingURL=redirects.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redirects.d.ts","sourceRoot":"","sources":["../../src/pages/redirects.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAe,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAE9E,MAAM,MAAM,gBAAgB,GACxB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9B,MAAM,WAAW,cAAc;IAC7B,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAC5H,iFAAiF;IACjF,QAAQ,CAAC,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACpE;AAID;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAUhI;AAED,MAAM,WAAW,oBAAoB;IACnC,gHAAgH;IAChH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,6FAA6F;IAC7F,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,qEAAqE;IACrE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,cAAc,EACtB,EAAE,KAAc,EAAE,UAAgB,EAAE,GAAc,EAAE,OAA6C,EAAE,GAAE,oBAAyB,GAC7H,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAqBrD;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAMD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAiBxH"}

package/dist/pages/redirects.js

@@ -0,0 +1,78 @@
+import { getTextPath } from "./paths.js";
+const PASS = { kind: "pass" };
+/**
+ * - A current row wins over the history: a slug back in use is the address of a text again.
+ * - A withdrawn text under the path of its own kind → 410.
+ * - A published text under the other kind's path (a term at the article path) → 301 to its own path.
+ * - An old slug → 301 to the current path of its text (which may answer 410 itself).
+ * - Everything else (unknown, draft) passes on: the page answers 404.
+ */
+export async function decideBlogPath(match, routes, lookup) {
+    const text = await lookup.findText(match.slug);
+    if (text !== null) {
+        if (text.kind === match.kind)
+            return text.status === "withdrawn" ? { kind: "gone" } : PASS;
+        return text.status === "published" ? { kind: "redirect", path: getTextPath(routes, text.kind, match.slug) } : PASS;
+    }
+    const target = await lookup.findRedirect(match.slug);
+    if (target === null || target === match.slug)
+        return PASS;
+    const current = await lookup.findText(target);
+    return current === null ? PASS : { kind: "redirect", path: getTextPath(routes, current.kind, target) };
+}
+/**
+ * Decisions with a memory: the proxy runs on every request and the pages are cached (ISR), so
+ * without one every cached view would cost a query. A failed lookup is not remembered and passes the
+ * request on: the page answers by itself, and a database outage never turns the blog into a 500.
+ */
+export function createCachedBlogPathDecider(routes, lookup, { ttlMs = 60_000, maxEntries = 500, now = Date.now, onError = (message) => console.error(message) } = {}) {
+    const cache = new Map();
+    return async (match) => {
+        const key = `${match.kind}:${match.slug}`;
+        const cached = cache.get(key);
+        if (cached !== undefined && cached.expiresAt > now())
+            return cached.decision;
+        let decision;
+        try {
+            decision = await decideBlogPath(match, routes, lookup);
+        }
+        catch (error) {
+            onError(`@softure-ai/blog proxy: lookup of the ${match.kind} "${match.slug}" failed: ${error instanceof Error ? error.message : String(error)}`);
+            return PASS;
+        }
+        cache.delete(key);
+        if (cache.size >= maxEntries) {
+            const oldest = cache.keys().next().value;
+            if (oldest !== undefined)
+                cache.delete(oldest);
+        }
+        cache.set(key, { decision, expiresAt: now() + ttlMs });
+        return decision;
+    };
+}
+function escapeHtml(text) {
+    return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+/**
+ * The body of a 410: a short page with the way on. No React (the proxy renders no components), no
+ * script, no external resource; `noindex`. Every value is escaped: copy comes from the app's overrides.
+ */
+export function buildGonePage(copy, options) {
+    return [
+        "<!doctype html>",
+        `<html lang="${escapeHtml(options.lang)}">`,
+        "<head>",
+        '<meta charset="utf-8">',
+        '<meta name="viewport" content="width=device-width, initial-scale=1">',
+        '<meta name="robots" content="noindex">',
+        `<title>${escapeHtml(copy.title)}</title>`,
+        "</head>",
+        '<body style="font-family:system-ui,sans-serif;max-width:40rem;margin:4rem auto;padding:0 1rem;line-height:1.5">',
+        `<h1>${escapeHtml(copy.heading)}</h1>`,
+        `<p>${escapeHtml(copy.body)} <a href="${escapeHtml(options.indexPath)}">${escapeHtml(copy.link)}</a></p>`,
+        "</body>",
+        "</html>",
+        "",
+    ].join("\n");
+}
+//# sourceMappingURL=redirects.js.map

package/dist/pages/redirects.js.map

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

package/dist/proxy/index.d.ts

@@ -0,0 +1,15 @@
+import { type SoftureConfig } from "@softure-ai/core";
+import { type BlogContext } from "../db/articles.js";
+import { type CachedDeciderOptions } from "../pages/redirects.js";
+export type BlogRedirects = (request: Request) => Promise<Response | null>;
+export interface BlogRedirectsOptions extends CachedDeciderOptions {
+    /** The store's context; the shared database handle of `config.database` by default (tests pass PGlite). */
+    readonly getContext?: () => Promise<BlogContext>;
+}
+/**
+ * Answers a request for a text's address: 301 to the current path (the query kept) for an old slug
+ * or a text under the other kind's path, 410 with a short page for a withdrawn text, `null` for
+ * everything else (the next piece or the page answers). Only GET and HEAD are considered.
+ */
+export declare function createBlogRedirects(config: SoftureConfig, options?: BlogRedirectsOptions): BlogRedirects;
+//# sourceMappingURL=index.d.ts.map

package/dist/proxy/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/proxy/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEnE,OAAO,EAAuC,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE1F,OAAO,EAAmE,KAAK,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAGnI,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;AAE3E,MAAM,WAAW,oBAAqB,SAAQ,oBAAoB;IAChE,2GAA2G;IAC3G,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;CAClD;AAUD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,GAAE,oBAAyB,GAAG,aAAa,CA4B5G"}

package/dist/proxy/index.js

@@ -0,0 +1,60 @@
+// The proxy piece of @softure-ai/blog: 301 from an old slug, 410 for a withdrawn text, before the page
+// (docs/02-module-standard.md §8, the ID-3 pattern). It uses only Web `Request` and `Response`, and it
+// is async (it may query the database), so the app awaits it first in its `proxy.ts`:
+//
+//   const blogRedirects = createBlogRedirects(softureConfig);
+//   export async function proxy(request: NextRequest) {
+//     return (await blogRedirects(request)) ?? guard(request) ?? NextResponse.next();
+//   }
+//
+// Next 16 runs `proxy.ts` on Node.js, so the database handle is the process-wide one.
+import { systemClock } from "@softure-ai/core";
+import { getSharedDatabase } from "@softure-ai/db";
+import { findArticleBySlug, findSlugRedirect } from "../db/articles.js";
+import { matchBlogPath } from "../pages/paths.js";
+import { buildGonePage, createCachedBlogPathDecider } from "../pages/redirects.js";
+import { getBlogMessages, getBlogReservedSlugs, getBlogRoutes } from "../server/options.js";
+function createDefaultContext(config) {
+    return async () => {
+        if (config.database === null)
+            throw new Error("@softure-ai/blog: softure.config.ts has no database; the blog needs one");
+        const { db } = await getSharedDatabase(config.database.url);
+        return { db, clock: systemClock, config };
+    };
+}
+/**
+ * Answers a request for a text's address: 301 to the current path (the query kept) for an old slug
+ * or a text under the other kind's path, 410 with a short page for a withdrawn text, `null` for
+ * everything else (the next piece or the page answers). Only GET and HEAD are considered.
+ */
+export function createBlogRedirects(config, options = {}) {
+    const routes = getBlogRoutes(config);
+    const reservedSlugs = getBlogReservedSlugs(config);
+    const getContext = options.getContext ?? createDefaultContext(config);
+    const lookup = {
+        findText: async (slug) => findArticleBySlug(await getContext(), slug),
+        findRedirect: async (oldSlug) => findSlugRedirect(await getContext(), oldSlug),
+    };
+    const decide = createCachedBlogPathDecider(routes, lookup, options);
+    const gonePage = buildGonePage(getBlogMessages(config).gone, { lang: config.locale, indexPath: routes.index });
+    return async (request) => {
+        if (request.method !== "GET" && request.method !== "HEAD")
+            return null;
+        const url = new URL(request.url);
+        const match = matchBlogPath(url.pathname, routes, reservedSlugs);
+        if (match === null)
+            return null;
+        const decision = await decide(match);
+        if (decision.kind === "redirect") {
+            const target = new URL(decision.path, url);
+            target.search = url.search;
+            // 301, not 308: what the roadmap asks for and what every crawler reads as a move.
+            return Response.redirect(target, 301);
+        }
+        if (decision.kind === "gone") {
+            return new Response(request.method === "HEAD" ? null : gonePage, { status: 410, headers: { "content-type": "text/html; charset=utf-8" } });
+        }
+        return null;
+    };
+}
+//# sourceMappingURL=index.js.map