barakopress 0.2.0

package/dist/routes/sitemap.js

@@ -0,0 +1,33 @@
+import { listPosts } from "../cms.js";
+/*
+ * Built from the same cached read as every other page, so it costs nothing in the steady state
+ * and cannot disagree with what the site serves.
+ *
+ * A post whose SEO block says noIndex is left out: the CMS resolves that flag per entry and its
+ * own sitemap honours it, so a site that ignored it here would contradict the CMS on the one
+ * signal an editor set deliberately.
+ */
+export function createSitemap(config) {
+    return async function sitemap() {
+        let indexable = [];
+        try {
+            const { posts } = await listPosts(config, { pageSize: config.pageSizes.sitemap });
+            indexable = posts.filter((p) => !p.seo?.noIndex);
+        }
+        catch {
+            // A sitemap that throws is worse than a short one: it fails the build when
+            // prerendered, and serves a crawler a 500 at runtime.
+            indexable = [];
+        }
+        return [
+            { url: config.site.url, changeFrequency: "daily", priority: 1 },
+            ...indexable.map((p) => ({
+                url: `${config.site.url}${config.routes.post}/${p.slug}`,
+                lastModified: p.publishedAt ? new Date(p.publishedAt) : undefined,
+                changeFrequency: "monthly",
+                priority: 0.7,
+            })),
+        ];
+    };
+}
+//# sourceMappingURL=sitemap.js.map

package/dist/routes/sitemap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap.js","sourceRoot":"","sources":["../../src/routes/sitemap.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,MAAmB;IAC7C,OAAO,KAAK,UAAU,OAAO;QACzB,IAAI,SAAS,GAAmD,EAAE,CAAC;QACnE,IAAI,CAAC;YACD,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;YAClF,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC;YACL,2EAA2E;YAC3E,sDAAsD;YACtD,SAAS,GAAG,EAAE,CAAC;QACnB,CAAC;QAED,OAAO;YACH,EAAE,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE;YAC/D,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACrB,GAAG,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE;gBACxD,YAAY,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS;gBACjE,eAAe,EAAE,SAAkB;gBACnC,QAAQ,EAAE,GAAG;aAChB,CAAC,CAAC;SACN,CAAC;IACN,CAAC,CAAC;AACN,CAAC"}

package/dist/screens/archive.d.ts

@@ -0,0 +1,13 @@
+import type { PressConfig } from "../config.js";
+type SlugParams = {
+    params: Promise<{
+        slug: string;
+    }>;
+};
+export declare function createArchive(config: PressConfig, which: "author" | "category"): ({ params }: SlugParams) => Promise<import("react").JSX.Element>;
+/** Slugs for a static export of an archive route. */
+export declare function createArchiveStaticParams(config: PressConfig, which: "author" | "category"): () => Promise<{
+    slug: string;
+}[]>;
+export {};
+//# sourceMappingURL=archive.d.ts.map

package/dist/screens/archive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../src/screens/archive.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAKhD,KAAK,UAAU,GAAG;IAAE,MAAM,EAAE,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC;AASxD,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,GAAG,UAAU,gBAC7B,UAAU,0CA0C3D;AAED,qDAAqD;AACrD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,GAAG,UAAU,SACzC,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAe5E"}

package/dist/screens/archive.js

@@ -0,0 +1,47 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import Link from "next/link";
+import { notFound } from "next/navigation";
+import { getTerm, listPostsBy } from "../cms.js";
+import { renderMarkdown } from "../markdown.js";
+import { Card } from "./blog-index.js";
+/*
+ * Posts by author, or by category.
+ *
+ * One screen for both, because they differ only in which type is resolved and which reference is
+ * filtered on, and both of those are in the config. A site with no author type simply never
+ * mounts the route; the factory still refuses cleanly if it is mounted anyway.
+ */
+export function createArchive(config, which) {
+    return async function ArchivePage({ params }) {
+        if (!config.types[which])
+            notFound();
+        const { slug } = await params;
+        const [term, posts] = await Promise.all([
+            getTerm(config, which, slug),
+            listPostsBy(config, which, slug),
+        ]);
+        if (!term || !posts)
+            notFound();
+        return (_jsxs(_Fragment, { children: [_jsx("p", { className: "meta", children: _jsx(Link, { href: "/", children: "Back" }) }), _jsx("h1", { children: term.name }), term.description && (_jsx("div", { className: "prose", dangerouslySetInnerHTML: { __html: renderMarkdown(term.description) } })), which === "author" && term.website && (_jsx("p", { className: "meta", children: _jsx("a", { href: term.website, rel: "noopener noreferrer", children: term.website }) })), _jsxs("h2", { style: { marginTop: "2.5rem" }, children: [posts.length, " ", posts.length === 1 ? "post" : "posts"] }), posts.map((p) => (_jsx(Card, { config: config, post: p }, p.id)))] }));
+    };
+}
+/** Slugs for a static export of an archive route. */
+export function createArchiveStaticParams(config, which) {
+    return async function generateStaticParams() {
+        const type = config.types[which];
+        if (!type)
+            return [];
+        const { list } = await import("../delivery.js");
+        try {
+            const res = await list(config, type, { pageSize: 100 });
+            return res.items
+                .map((c) => c.slug ?? "")
+                .filter(Boolean)
+                .map((slug) => ({ slug }));
+        }
+        catch {
+            return [];
+        }
+    };
+}
+//# sourceMappingURL=archive.js.map

package/dist/screens/archive.js.map

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

package/dist/screens/blog-index.d.ts

@@ -0,0 +1,9 @@
+import type { PressConfig } from "../config.js";
+import { type Post } from "../cms.js";
+export declare function Card({ config, post, featured, }: {
+    config: PressConfig;
+    post: Post;
+    featured?: boolean;
+}): import("react").JSX.Element;
+export declare function createBlogIndex(config: PressConfig): () => Promise<import("react").JSX.Element>;
+//# sourceMappingURL=blog-index.d.ts.map

package/dist/screens/blog-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog-index.d.ts","sourceRoot":"","sources":["../../src/screens/blog-index.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAyB,KAAK,IAAI,EAAE,MAAM,WAAW,CAAC;AAiB7D,wBAAgB,IAAI,CAAC,EACjB,MAAM,EACN,IAAI,EACJ,QAAgB,GACnB,EAAE;IACC,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB,+BAwCA;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,8CAoDlD"}

package/dist/screens/blog-index.js

@@ -0,0 +1,38 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import Link from "next/link";
+import { formatDate, listPosts } from "../cms.js";
+/*
+ * The post list.
+ *
+ * A factory rather than a component, because a Next route is a file and a package cannot write
+ * files into someone else's app. The consumer's page.tsx is:
+ *
+ *     import { createBlogIndex } from "barakopress";
+ *     import { config } from "@/press.config";
+ *     export default createBlogIndex(config);
+ *     export const revalidate = 300;
+ *
+ * `Card` is exported too, so a site that wants its own list but the engine's card can have one
+ * without copying the markup.
+ */
+export function Card({ config, post, featured = false, }) {
+    return (_jsxs("article", { className: featured ? "card featured-card" : "card", children: [featured && _jsx("span", { className: "chip", children: "Featured" }), _jsx("h2", { children: _jsx(Link, { href: `${config.routes.post}/${post.slug}`, children: post.title }) }), _jsxs("p", { className: "meta", children: [post.publishedAt && (_jsx("time", { dateTime: post.publishedAt, children: formatDate(config, post.publishedAt) })), post.author && config.routes.author && (_jsxs(_Fragment, { children: [" by ", _jsx(Link, { href: `${config.routes.author}/${post.author.slug}`, children: post.author.name })] })), post.category && config.routes.category && (_jsxs(_Fragment, { children: [" in ", _jsx(Link, { href: `${config.routes.category}/${post.category.slug}`, children: post.category.name })] }))] }), post.excerpt && _jsx("p", { className: "excerpt", children: post.excerpt }), post.tags.length > 0 && (_jsx("p", { className: "tags", children: post.tags.map((t) => (_jsx("span", { className: "tag", children: t }, t))) }))] }));
+}
+export function createBlogIndex(config) {
+    return async function BlogIndex() {
+        let posts = [];
+        let failure = null;
+        try {
+            ({ posts } = await listPosts(config));
+        }
+        catch (e) {
+            // An unreachable CMS is the likeliest thing to be wrong, so it gets a readable page
+            // rather than a stack trace. This render is not cached, so the next request retries.
+            failure = e instanceof Error ? e.message : String(e);
+        }
+        const featured = posts.filter((p) => p.featured);
+        const rest = posts.filter((p) => !p.featured);
+        return (_jsxs(_Fragment, { children: [_jsxs("header", { className: "masthead", children: [_jsx("h1", { children: config.site.name }), config.site.tagline && _jsx("p", { className: "tagline", children: config.site.tagline })] }), failure && (_jsxs("div", { className: "notice error", children: [_jsx("p", { children: _jsx("strong", { children: "This page could not be loaded." }) }), _jsx("p", { children: "Please try again shortly." })] })), !failure && posts.length === 0 && (_jsxs("div", { className: "notice", children: [_jsx("p", { children: _jsx("strong", { children: "Nothing published yet." }) }), _jsx("p", { children: "Only published entries of a type opted into public delivery appear here." })] })), featured.map((p) => (_jsx(Card, { config: config, post: p, featured: true }, p.id))), rest.map((p) => (_jsx(Card, { config: config, post: p }, p.id)))] }));
+    };
+}
+//# sourceMappingURL=blog-index.js.map

package/dist/screens/blog-index.js.map

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

package/dist/screens/blog-post.d.ts

@@ -0,0 +1,20 @@
+import type { Metadata } from "next";
+import type { PressConfig } from "../config.js";
+type SlugParams = {
+    params: Promise<{
+        slug: string;
+    }>;
+};
+type PreviewParams = SlugParams & {
+    searchParams: Promise<{
+        preview?: string;
+    }>;
+};
+export declare function createBlogPost(config: PressConfig): ({ params }: SlugParams) => Promise<import("react").JSX.Element>;
+export declare function createBlogPostPreview(config: PressConfig): ({ params, searchParams }: PreviewParams) => Promise<import("react").JSX.Element>;
+export declare function createPostMetadata(config: PressConfig): ({ params }: SlugParams) => Promise<Metadata>;
+export declare function createPostStaticParams(config: PressConfig): () => Promise<{
+    slug: string;
+}[]>;
+export {};
+//# sourceMappingURL=blog-post.d.ts.map

package/dist/screens/blog-post.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog-post.d.ts","sourceRoot":"","sources":["../../src/screens/blog-post.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAIhD,KAAK,UAAU,GAAG;IAAE,MAAM,EAAE,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC;AACxD,KAAK,aAAa,GAAG,UAAU,GAAG;IAAE,YAAY,EAAE,OAAO,CAAC;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC;AAYlF,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,gBACH,UAAU,0CAMxD;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,8BACW,aAAa,0CAUhF;AASD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,gBACC,UAAU,KAAG,OAAO,CAAC,QAAQ,CAAC,CA8BpF;AASD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,WAAW,SACR,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAoB5E"}

package/dist/screens/blog-post.js

@@ -0,0 +1,103 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { notFound } from "next/navigation";
+import { getPost, getPostPreview, listPosts } from "../cms.js";
+import { PostView } from "./post-view.js";
+/*
+ * The post page, in two shapes.
+ *
+ * `createBlogPost` reads only `params`, so it can be prerendered and works under
+ * `output: "export"`. `createBlogPostPreview` also reads `searchParams` for a preview token,
+ * which forces dynamic rendering: a static export refuses it outright with "couldn't be rendered
+ * statically because it used searchParams". A static site takes the first and gives up draft
+ * preview, which is the honest trade and the reason these are two exports rather than a flag.
+ */
+export function createBlogPost(config) {
+    return async function PostPage({ params }) {
+        const { slug } = await params;
+        const post = await getPost(config, slug);
+        if (!post)
+            notFound();
+        return _jsx(PostView, { config: config, post: post });
+    };
+}
+export function createBlogPostPreview(config) {
+    return async function PostPreviewPage({ params, searchParams }) {
+        const { slug } = await params;
+        const { preview } = await searchParams;
+        // A token routes to the uncached read, so a draft never enters the shared cache.
+        const post = preview ? await getPostPreview(config, slug, preview) : await getPost(config, slug);
+        if (!post)
+            notFound();
+        return _jsx(PostView, { config: config, post: post, preview: Boolean(preview) });
+    };
+}
+/*
+ * Metadata from the API's resolved `seo` block rather than assembled here.
+ *
+ * A type opted into SEO fields returns title, description, canonical, social image and noIndex on
+ * every public response, with the title already falling back to the entry's title. So this maps,
+ * and an editor changing the meta description in the console changes the page.
+ */
+export function createPostMetadata(config) {
+    return async function generateMetadata({ params }) {
+        const { slug } = await params;
+        const post = await getPost(config, slug);
+        if (!post)
+            return { title: "Not found" };
+        const seo = post.seo;
+        const title = seo?.title ?? post.title;
+        const description = seo?.description ?? post.excerpt;
+        const image = seo?.imageUrl ?? post.coverImage;
+        return {
+            title,
+            description,
+            alternates: seo?.canonicalUrl ? { canonical: seo.canonicalUrl } : undefined,
+            robots: seo?.noIndex ? { index: false, follow: false } : undefined,
+            openGraph: {
+                title,
+                description,
+                type: "article",
+                publishedTime: post.publishedAt,
+                images: image ? [image] : undefined,
+            },
+            twitter: {
+                card: image ? "summary_large_image" : "summary",
+                title,
+                description,
+                images: image ? [image] : undefined,
+            },
+        };
+    };
+}
+/*
+ * Slugs for a static export, paged to the end rather than to one hardcoded limit.
+ *
+ * Every consumer of an export-mode site needs this, and every one that hand-writes it caps the
+ * page size and silently drops the posts past it. Doing it once here is the difference between an
+ * engine and a snippet in a README.
+ */
+export function createPostStaticParams(config) {
+    return async function generateStaticParams() {
+        const slugs = [];
+        const pageSize = 100;
+        for (let page = 1; page <= 200; page++) {
+            let batch;
+            try {
+                batch = await listPosts(config, { page, pageSize });
+            }
+            catch {
+                // A build with no CMS reachable produces no routes. Under `output: "export"` Next
+                // then refuses the build, which is the correct outcome: a static site with no
+                // content is not something to ship quietly.
+                break;
+            }
+            for (const p of batch.posts)
+                if (p.slug)
+                    slugs.push({ slug: p.slug });
+            if (!batch.hasNextPage)
+                break;
+        }
+        return slugs;
+    };
+}
+//# sourceMappingURL=blog-post.js.map

package/dist/screens/blog-post.js.map

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

package/dist/screens/post-view.d.ts

@@ -0,0 +1,8 @@
+import type { PressConfig } from "../config.js";
+import { type Post } from "../cms.js";
+export declare function PostView({ config, post, preview, }: {
+    config: PressConfig;
+    post: Post;
+    preview?: boolean;
+}): import("react").JSX.Element;
+//# sourceMappingURL=post-view.d.ts.map

package/dist/screens/post-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-view.d.ts","sourceRoot":"","sources":["../../src/screens/post-view.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAc,KAAK,IAAI,EAAE,MAAM,WAAW,CAAC;AAclD,wBAAgB,QAAQ,CAAC,EACrB,MAAM,EACN,IAAI,EACJ,OAAe,GAClB,EAAE;IACC,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB,+BA2DA"}

package/dist/screens/post-view.js

@@ -0,0 +1,19 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import Link from "next/link";
+import { formatDate } from "../cms.js";
+import { renderMarkdown } from "../markdown.js";
+/*
+ * The rendering, shared by the static screen and the preview screen.
+ *
+ * It is its own component because reading `searchParams` forces a route to render dynamically,
+ * and a site built with `output: "export"` is refused outright for it. Preview needs the query
+ * string; a published post does not. Splitting the fetch from the render is what lets one set of
+ * markup serve a static site and a server-rendered one.
+ *
+ * Every link is built from `config.routes`, so a site that mounts posts at /writing gets /writing
+ * links here, in the feed and in the sitemap, instead of three files disagreeing.
+ */
+export function PostView({ config, post, preview = false, }) {
+    return (_jsxs("article", { children: [preview && (_jsx("div", { className: "notice preview-banner", children: "Preview. This is how the post will look. It is not published, and it is served uncached so nothing here reaches another reader." })), _jsx("p", { className: "meta", children: _jsx(Link, { href: "/", children: "Back" }) }), _jsx("h1", { children: post.title }), _jsxs("p", { className: "meta", children: [post.publishedAt && (_jsx("time", { dateTime: post.publishedAt, children: formatDate(config, post.publishedAt) })), post.author && config.routes.author && (_jsxs(_Fragment, { children: [" by ", _jsx(Link, { href: `${config.routes.author}/${post.author.slug}`, children: post.author.name })] })), post.author && !config.routes.author && _jsx(_Fragment, { children: ` by ${post.author.name}` }), post.category && config.routes.category && (_jsxs(_Fragment, { children: [" in ", _jsx(Link, { href: `${config.routes.category}/${post.category.slug}`, children: post.category.name })] }))] }), post.coverImage && (_jsx("img", { className: "cover", src: post.coverImage, alt: post.coverImageAlt ?? "" })), _jsx("div", { className: "prose", dangerouslySetInnerHTML: { __html: renderMarkdown(post.body) } }), post.tags.length > 0 && (_jsx("p", { className: "tags", children: post.tags.map((t) => (_jsx("span", { className: "tag", children: t }, t))) }))] }));
+}
+//# sourceMappingURL=post-view.js.map

package/dist/screens/post-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-view.js","sourceRoot":"","sources":["../../src/screens/post-view.tsx"],"names":[],"mappings":";AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,UAAU,EAAa,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,QAAQ,CAAC,EACrB,MAAM,EACN,IAAI,EACJ,OAAO,GAAG,KAAK,GAKlB;IACG,OAAO,CACH,8BACK,OAAO,IAAI,CACR,cAAK,SAAS,EAAC,uBAAuB,gJAGhC,CACT,EAED,YAAG,SAAS,EAAC,MAAM,YACf,KAAC,IAAI,IAAC,IAAI,EAAC,GAAG,qBAAY,GAC1B,EAEJ,uBAAK,IAAI,CAAC,KAAK,GAAM,EAErB,aAAG,SAAS,EAAC,MAAM,aACd,IAAI,CAAC,WAAW,IAAI,CACjB,eAAM,QAAQ,EAAE,IAAI,CAAC,WAAW,YAAG,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,GAAQ,CAClF,EACA,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,CACpC,8BACK,MAAM,EACP,KAAC,IAAI,IAAC,IAAI,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,YACpD,IAAI,CAAC,MAAM,CAAC,IAAI,GACd,IACR,CACN,EACA,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,4BAAG,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,GAAI,EACxE,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,IAAI,CACxC,8BACK,MAAM,EACP,KAAC,IAAI,IAAC,IAAI,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,YACxD,IAAI,CAAC,QAAQ,CAAC,IAAI,GAChB,IACR,CACN,IACD,EAEH,IAAI,CAAC,UAAU,IAAI,CAIhB,cAAK,SAAS,EAAC,OAAO,EAAC,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,GAAG,EAAE,IAAI,CAAC,aAAa,IAAI,EAAE,GAAI,CACjF,EAED,cAAK,SAAS,EAAC,OAAO,EAAC,uBAAuB,EAAE,EAAE,MAAM,EAAE,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAI,EAExF,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CACrB,YAAG,SAAS,EAAC,MAAM,YACd,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAClB,eAAc,SAAS,EAAC,KAAK,YACxB,CAAC,IADK,CAAC,CAEL,CACV,CAAC,GACF,CACP,IACK,CACb,CAAC;AACN,CAAC"}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "barakopress",
+  "version": "0.2.0",
+  "description": "A configurable blog engine for barakoCMS: Next.js server components, cached until the CMS says otherwise.",
+  "license": "MIT",
+  "author": "Arnel Robles",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./styles.css": "./src/styles.css",
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20.9.0"
+  },
+  "scripts": {
+    "build:package": "tsc -p tsconfig.build.json",
+    "watch": "tsc -p tsconfig.build.json --watch",
+    "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
+    "dev": "npm run build:package && next dev",
+    "build": "npm run build:package && next build",
+    "start": "next start",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "prepare": "npm run build:package"
+  },
+  "dependencies": {
+    "marked": "^18.0.0"
+  },
+  "peerDependencies": {
+    "next": ">=16",
+    "react": ">=19"
+  },
+  "devDependencies": {
+    "@types/node": "^26.5.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "next": "^16.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.0"
+  },
+  "keywords": [
+    "barakocms",
+    "headless-cms",
+    "blog",
+    "blog-engine",
+    "nextjs",
+    "react-server-components",
+    "rss",
+    "sitemap"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/BaryoDev/barakoPress.git"
+  },
+  "homepage": "https://github.com/BaryoDev/barakoPress#readme",
+  "bugs": {
+    "url": "https://github.com/BaryoDev/barakoPress/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/cms.ts

@@ -0,0 +1,196 @@
+import type { PressConfig } from "./config.js";
+import { includesFor } from "./config.js";
+import { bySlug, bySlugPreview, list, type PublicContent, type Seo } from "./delivery.js";
+
+export type { Seo };
+
+/*
+ * Mapping a stored entry onto what a page renders.
+ *
+ * Every field name comes from the config's field map, so a client whose post type calls its title
+ * `Headline` configures that instead of forking this file. An absent name means the site has no
+ * such field: the value is undefined and the screens leave the slot out rather than render it
+ * empty.
+ */
+
+export interface Post {
+    id: string;
+    slug: string;
+    title: string;
+    excerpt?: string;
+    body: string;
+    publishedAt?: string;
+    coverImage?: string;
+    coverImageAlt?: string;
+    featured: boolean;
+    tags: string[];
+    author?: Ref;
+    category?: Ref;
+    seo?: Seo;
+}
+
+export interface Ref {
+    id: string;
+    slug: string;
+    name: string;
+}
+
+const str = (v: unknown): string => (typeof v === "string" ? v : "");
+
+/** Reads a field by its configured name, or undefined when the site has no such field. */
+function field(data: Record<string, unknown>, name: string | undefined): unknown {
+    return name ? data[name] : undefined;
+}
+
+/*
+ * A resolved reference. `include` gives back the whole target entry, so this handles that and a
+ * bare id, and gives up rather than inventing a label when neither a name nor a slug is there.
+ */
+function toRef(config: PressConfig, v: unknown): Ref | undefined {
+    if (!v || typeof v !== "object") return undefined;
+    const d = v as Record<string, unknown>;
+    const data = (d.data ?? d) as Record<string, unknown>;
+    const name = str(data.Name) || str(data.Title) || str(field(data, config.fields.title));
+    const slug = str(d.slug) || str(field(data, config.fields.slug)) || str(data.Slug);
+    if (!name && !slug) return undefined;
+    return { id: str(d.id), slug, name: name || slug };
+}
+
+export function toPost(config: PressConfig, c: PublicContent): Post {
+    const d = c.data;
+    const f = config.fields;
+    const tags = field(d, f.tags);
+    return {
+        id: c.id,
+        slug: c.slug ?? str(field(d, f.slug)),
+        title: str(field(d, f.title)) || "Untitled",
+        excerpt: str(field(d, f.excerpt)) || undefined,
+        body: str(field(d, f.body)),
+        publishedAt: str(field(d, f.publishedAt)) || c.createdAt || undefined,
+        coverImage: str(field(d, f.coverImage)) || undefined,
+        coverImageAlt: str(field(d, f.coverImageAlt)) || undefined,
+        featured: field(d, f.featured) === true,
+        tags: Array.isArray(tags) ? tags.filter((t): t is string => typeof t === "string") : [],
+        author: toRef(config, field(d, f.author)),
+        category: toRef(config, field(d, f.category)),
+        seo: c.seo ?? undefined,
+    };
+}
+
+/*
+ * Ordering is asked of the API, not done here.
+ *
+ * Sorting the page that came back only orders those rows, so on a blog past one page the "newest"
+ * list is newest-of-an-arbitrary-page. The API can order every row, so it does.
+ */
+function sortKey(config: PressConfig): string | undefined {
+    return config.fields.publishedAt ? `-${config.fields.publishedAt}` : undefined;
+}
+
+export async function listPosts(
+    config: PressConfig,
+    opts: { page?: number; pageSize?: number } = {},
+): Promise<{ posts: Post[]; total: number; hasNextPage: boolean }> {
+    const res = await list(config, config.types.post, {
+        page: opts.page ?? 1,
+        pageSize: opts.pageSize ?? config.pageSizes.index,
+        include: includesFor(config),
+        sort: sortKey(config),
+    });
+    return {
+        posts: res.items.map((c) => toPost(config, c)),
+        total: res.totalItems,
+        hasNextPage: res.hasNextPage,
+    };
+}
+
+export async function getPost(config: PressConfig, slug: string): Promise<Post | null> {
+    const c = await bySlug(config, config.types.post, slug);
+    return c ? toPost(config, c) : null;
+}
+
+export async function getPostPreview(
+    config: PressConfig,
+    slug: string,
+    token: string,
+): Promise<Post | null> {
+    const c = await bySlugPreview(config, config.types.post, slug, token);
+    return c ? toPost(config, c) : null;
+}
+
+/*
+ * Filtering by a reference takes the target's id, not its slug, so an archive is two calls:
+ * resolve the slug, then filter. Both are cached and tagged, so it costs two reads once.
+ */
+async function idForSlug(config: PressConfig, type: string, slug: string): Promise<string | null> {
+    const c = await bySlug(config, type, slug);
+    return c?.id ?? null;
+}
+
+/** Posts by author or category. Null when the site has no such type, or the slug is unknown. */
+export async function listPostsBy(
+    config: PressConfig,
+    which: "author" | "category",
+    slug: string,
+): Promise<Post[] | null> {
+    const type = config.types[which];
+    const fieldName = config.fields[which];
+    if (!type || !fieldName) return null;
+
+    const id = await idForSlug(config, type, slug);
+    if (!id) return null;
+
+    const res = await list(config, config.types.post, {
+        pageSize: config.pageSizes.archive,
+        include: includesFor(config),
+        filter: [[fieldName, "eq", id]],
+        sort: sortKey(config),
+    });
+    return res.items.map((c) => toPost(config, c));
+}
+
+export interface Term {
+    id: string;
+    slug: string;
+    name: string;
+    description?: string;
+    photo?: string;
+    website?: string;
+}
+
+/*
+ * An author or category entry, for the heading of its archive page.
+ *
+ * These secondary types keep the blueprint's names with the post type's title and slug as
+ * fallbacks. One flat field map cannot describe three types, and a model whose author type
+ * differs wholesale wants its own screen. That is a fair boundary for the engine, and it is
+ * stated here so nobody discovers it by reading the source.
+ */
+export async function getTerm(
+    config: PressConfig,
+    which: "author" | "category",
+    slug: string,
+): Promise<Term | null> {
+    const type = config.types[which];
+    if (!type) return null;
+    const c = await bySlug(config, type, slug);
+    if (!c) return null;
+
+    const d = c.data;
+    return {
+        id: c.id,
+        slug: c.slug ?? (str(field(d, config.fields.slug)) || str(d.Slug)),
+        name: str(d.Name) || str(d.Title) || str(field(d, config.fields.title)) || "Untitled",
+        description: str(d.Description) || str(d.Bio) || undefined,
+        photo: str(d.Photo) || undefined,
+        website: str(d.Website) || undefined,
+    };
+}
+
+export function formatDate(config: PressConfig, value?: string): string {
+    if (!value) return "";
+    const d = new Date(value);
+    return Number.isNaN(d.getTime())
+        ? ""
+        : d.toLocaleDateString(config.locale, { day: "numeric", month: "long", year: "numeric" });
+}