chaingrow-blog 0.7.0 → 0.7.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +3 -1
- package/dist/{blog-cards-D1j7ZqHK.d.ts → blog-cards-CcHb2bcv.d.ts} +12 -3
- package/dist/{blog-cards-DPfcmUUD.d.cts → blog-cards-PjckhJAG.d.cts} +12 -3
- package/dist/{chunk-BXEQ6QKM.js → chunk-2FIOFNM6.js} +4 -3
- package/dist/{chunk-BXEQ6QKM.js.map → chunk-2FIOFNM6.js.map} +1 -1
- package/dist/{chunk-K3HNYPEP.js → chunk-KDUQNIJ2.js} +61 -18
- package/dist/chunk-KDUQNIJ2.js.map +1 -0
- package/dist/index.cjs +62 -17
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +3 -3
- package/dist/index.d.ts +3 -3
- package/dist/index.js +6 -2
- package/dist/index.js.map +1 -1
- package/dist/next/index.cjs +59 -18
- package/dist/next/index.cjs.map +1 -1
- package/dist/next/index.d.cts +1 -1
- package/dist/next/index.d.ts +1 -1
- package/dist/next/index.js +2 -2
- package/dist/next/webhook.d.cts +1 -1
- package/dist/next/webhook.d.ts +1 -1
- package/dist/react/index.cjs +59 -18
- package/dist/react/index.cjs.map +1 -1
- package/dist/react/index.d.cts +4 -4
- package/dist/react/index.d.ts +4 -4
- package/dist/react/index.js +2 -2
- package/dist/{types-DvkCm1rh.d.ts → types-DSBF7V30.d.cts} +6 -4
- package/dist/{types-DvkCm1rh.d.cts → types-DSBF7V30.d.ts} +6 -4
- package/package.json +18 -5
- package/dist/chunk-K3HNYPEP.js.map +0 -1
package/README.md
CHANGED
|
@@ -499,6 +499,8 @@ When your blog has more than one attached image or video, `<BlogRenderer>` distr
|
|
|
499
499
|
|
|
500
500
|
The placement is pure function of `(blocks.length, generatedMedia.length)` — same input always produces the same output, so two visitors see the same layout.
|
|
501
501
|
|
|
502
|
+
Images the author placed in the text itself are `image` blocks (with `mediaId`) and render exactly where they sit; `generatedMedia` only carries what is not placed, and since 0.7.2 an entry that repeats a placed image is skipped. The default header shows `og_image` as a cover only when the body has no image at all.
|
|
503
|
+
|
|
502
504
|
### Customising the media slot
|
|
503
505
|
|
|
504
506
|
Override the `media` component just like any other block-level override:
|
|
@@ -584,7 +586,7 @@ Returns `{ POST }` with overrides — pass an `onEvent` callback to run custom l
|
|
|
584
586
|
Default list page. Calls `listBlogs()` internally and renders one of three preset layouts: `minimalist` (default), `list`, `bare`. On locale-prefixed sites set `pathPrefix` per locale, or pass `hrefFor={(blog) => string}` for full href control (see [Localized routes](#localized-routes-i18n)). For full design control, skip this and write your own page using `listBlogs()`.
|
|
585
587
|
|
|
586
588
|
#### `<BlogDetail blog={} components={} formatDate={} />`
|
|
587
|
-
Article layout: `<article>` → Header → `<BlogRenderer>` → Footer. Default Header: og_image → h1 → time → description. Default Footer: nothing. Override Header, Footer, and per-block renderers via `components`.
|
|
589
|
+
Article layout: `<article>` → Header → `<BlogRenderer>` → Footer. Default Header: og_image (only when the body shows no image) → h1 → time → description. Default Footer: nothing. Override Header, Footer, and per-block renderers via `components`.
|
|
588
590
|
|
|
589
591
|
#### `<BlogRenderer blog={} components={} />`
|
|
590
592
|
Renders `blog.blocks` and distributes `blog.generatedMedia` across them.
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { B as Blog, F as FaqItem, a as Block, E as EmbeddedMedia } from './types-
|
|
1
|
+
import { B as Blog, F as FaqItem, a as Block, E as EmbeddedMedia } from './types-DSBF7V30.js';
|
|
2
2
|
|
|
3
3
|
/**
|
|
4
4
|
* Consumer-supplied extras for BlogPosting. Everything is optional — the
|
|
@@ -63,6 +63,14 @@ declare const SCHEMA_ORG_CONTEXT: "https://schema.org";
|
|
|
63
63
|
* enough blocks to spread across.
|
|
64
64
|
*/
|
|
65
65
|
declare function distributeMediaPositions(blockCount: number, mediaCount: number): number[];
|
|
66
|
+
/**
|
|
67
|
+
* Ids of the attachments already placed in the text as `image` blocks
|
|
68
|
+
* (`mediaId`), list items included. `interleaveMedia` skips those, so an
|
|
69
|
+
* image the author placed never shows a second time.
|
|
70
|
+
*/
|
|
71
|
+
declare function placedMediaIds(blocks: Block[]): Set<string>;
|
|
72
|
+
/** Whether the text itself contains an image (list items included). */
|
|
73
|
+
declare function hasTextImage(blocks: Block[]): boolean;
|
|
66
74
|
/** One interleaved slot in a blog's body — either a block or a media item. */
|
|
67
75
|
type InterleavedSlot = {
|
|
68
76
|
kind: 'block';
|
|
@@ -78,7 +86,8 @@ type InterleavedSlot = {
|
|
|
78
86
|
* `distributeMediaPositions`. Returns a flat array of typed slots that
|
|
79
87
|
* `<BlogRenderer>` can map over directly. Exposed so consumers who need a
|
|
80
88
|
* custom layout (e.g. wrapping each section in a `<section>`) can use the
|
|
81
|
-
* same placement logic without re-implementing it.
|
|
89
|
+
* same placement logic without re-implementing it. Media already placed in
|
|
90
|
+
* the text as an `image` block is skipped (see `placedMediaIds`).
|
|
82
91
|
*/
|
|
83
92
|
declare function interleaveMedia(blocks: Block[], media: EmbeddedMedia[] | undefined): InterleavedSlot[];
|
|
84
93
|
|
|
@@ -120,4 +129,4 @@ declare function toBlogCard(blog: Blog, opts?: ToBlogCardOptions): BlogCard;
|
|
|
120
129
|
*/
|
|
121
130
|
declare function mergeBlogs(chaingrow: BlogCard[], extra?: BlogCard[]): BlogCard[];
|
|
122
131
|
|
|
123
|
-
export { type BlogCard as B, type InterleavedSlot as I, SCHEMA_ORG_CONTEXT as S, type ToBlogCardOptions as T, type BlogJsonLdOptions as a, buildBlogJsonLd as b, buildBlogPostingSchema as c, buildFAQPageSchema as d, distributeMediaPositions as e, interleaveMedia as i, mergeBlogs as m, toBlogCard as t };
|
|
132
|
+
export { type BlogCard as B, type InterleavedSlot as I, SCHEMA_ORG_CONTEXT as S, type ToBlogCardOptions as T, type BlogJsonLdOptions as a, buildBlogJsonLd as b, buildBlogPostingSchema as c, buildFAQPageSchema as d, distributeMediaPositions as e, hasTextImage as h, interleaveMedia as i, mergeBlogs as m, placedMediaIds as p, toBlogCard as t };
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { B as Blog, F as FaqItem, a as Block, E as EmbeddedMedia } from './types-
|
|
1
|
+
import { B as Blog, F as FaqItem, a as Block, E as EmbeddedMedia } from './types-DSBF7V30.cjs';
|
|
2
2
|
|
|
3
3
|
/**
|
|
4
4
|
* Consumer-supplied extras for BlogPosting. Everything is optional — the
|
|
@@ -63,6 +63,14 @@ declare const SCHEMA_ORG_CONTEXT: "https://schema.org";
|
|
|
63
63
|
* enough blocks to spread across.
|
|
64
64
|
*/
|
|
65
65
|
declare function distributeMediaPositions(blockCount: number, mediaCount: number): number[];
|
|
66
|
+
/**
|
|
67
|
+
* Ids of the attachments already placed in the text as `image` blocks
|
|
68
|
+
* (`mediaId`), list items included. `interleaveMedia` skips those, so an
|
|
69
|
+
* image the author placed never shows a second time.
|
|
70
|
+
*/
|
|
71
|
+
declare function placedMediaIds(blocks: Block[]): Set<string>;
|
|
72
|
+
/** Whether the text itself contains an image (list items included). */
|
|
73
|
+
declare function hasTextImage(blocks: Block[]): boolean;
|
|
66
74
|
/** One interleaved slot in a blog's body — either a block or a media item. */
|
|
67
75
|
type InterleavedSlot = {
|
|
68
76
|
kind: 'block';
|
|
@@ -78,7 +86,8 @@ type InterleavedSlot = {
|
|
|
78
86
|
* `distributeMediaPositions`. Returns a flat array of typed slots that
|
|
79
87
|
* `<BlogRenderer>` can map over directly. Exposed so consumers who need a
|
|
80
88
|
* custom layout (e.g. wrapping each section in a `<section>`) can use the
|
|
81
|
-
* same placement logic without re-implementing it.
|
|
89
|
+
* same placement logic without re-implementing it. Media already placed in
|
|
90
|
+
* the text as an `image` block is skipped (see `placedMediaIds`).
|
|
82
91
|
*/
|
|
83
92
|
declare function interleaveMedia(blocks: Block[], media: EmbeddedMedia[] | undefined): InterleavedSlot[];
|
|
84
93
|
|
|
@@ -120,4 +129,4 @@ declare function toBlogCard(blog: Blog, opts?: ToBlogCardOptions): BlogCard;
|
|
|
120
129
|
*/
|
|
121
130
|
declare function mergeBlogs(chaingrow: BlogCard[], extra?: BlogCard[]): BlogCard[];
|
|
122
131
|
|
|
123
|
-
export { type BlogCard as B, type InterleavedSlot as I, SCHEMA_ORG_CONTEXT as S, type ToBlogCardOptions as T, type BlogJsonLdOptions as a, buildBlogJsonLd as b, buildBlogPostingSchema as c, buildFAQPageSchema as d, distributeMediaPositions as e, interleaveMedia as i, mergeBlogs as m, toBlogCard as t };
|
|
132
|
+
export { type BlogCard as B, type InterleavedSlot as I, SCHEMA_ORG_CONTEXT as S, type ToBlogCardOptions as T, type BlogJsonLdOptions as a, buildBlogJsonLd as b, buildBlogPostingSchema as c, buildFAQPageSchema as d, distributeMediaPositions as e, hasTextImage as h, interleaveMedia as i, mergeBlogs as m, placedMediaIds as p, toBlogCard as t };
|
|
@@ -2,8 +2,9 @@ import {
|
|
|
2
2
|
SCHEMA_ORG_CONTEXT,
|
|
3
3
|
buildBlogJsonLd,
|
|
4
4
|
createClient,
|
|
5
|
+
hasTextImage,
|
|
5
6
|
interleaveMedia
|
|
6
|
-
} from "./chunk-
|
|
7
|
+
} from "./chunk-KDUQNIJ2.js";
|
|
7
8
|
|
|
8
9
|
// src/next/metadata.ts
|
|
9
10
|
var trimTrailingSlash = (s) => s.replace(/\/+$/, "");
|
|
@@ -319,7 +320,7 @@ function DefaultHeader({
|
|
|
319
320
|
blog,
|
|
320
321
|
formatDate
|
|
321
322
|
}) {
|
|
322
|
-
const hasInlineMedia = (blog.generatedMedia?.length ?? 0) > 0;
|
|
323
|
+
const hasInlineMedia = (blog.generatedMedia?.length ?? 0) > 0 || hasTextImage(blog.blocks);
|
|
323
324
|
const heroImage = !hasInlineMedia && blog.og_image ? /* @__PURE__ */ jsx3("img", { src: blog.og_image, alt: blog.title }) : null;
|
|
324
325
|
return /* @__PURE__ */ jsxs2(Fragment2, { children: [
|
|
325
326
|
heroImage,
|
|
@@ -633,4 +634,4 @@ export {
|
|
|
633
634
|
listBlogs,
|
|
634
635
|
getBlogSitemapEntries
|
|
635
636
|
};
|
|
636
|
-
//# sourceMappingURL=chunk-
|
|
637
|
+
//# sourceMappingURL=chunk-2FIOFNM6.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/next/metadata.ts","../src/next/BlogPage.tsx","../src/react/defaults.tsx","../src/react/BlogRenderer.tsx","../src/react/BlogDetail.tsx","../src/react/BlogJsonLd.tsx","../src/next/index.ts"],"sourcesContent":["import type { Metadata } from 'next';\nimport { getBlog, listBlogs } from './index';\nimport type { NextClientOptions } from './index';\n\nconst trimTrailingSlash = (s: string): string => s.replace(/\\/+$/, '');\nconst normalizePathPrefix = (s: string): string => {\n let p = s.trim();\n if (!p.startsWith('/')) p = '/' + p;\n while (p.length > 1 && p.endsWith('/')) p = p.slice(0, -1);\n return p;\n};\n\n/**\n * Opt-in hreflang configuration for `generateBlogMetadata`. ChainGrow serves\n * language variants of a post under one shared slug, so the SDK can emit\n * `alternates.languages` (and a canonical) for every variant it finds —\n * pass this when your site serves more than one language.\n */\nexport type BlogAlternatesOptions = {\n /** Absolute site origin, e.g. `https://example.com` (no trailing slash needed). */\n siteUrl: string;\n /**\n * Blog path prefix. A static string applies to every language; pass a\n * function for locale-prefixed routing, e.g.\n * `(lang) => (lang === 'de' ? '/blog' : `/${lang}/blog`)`.\n * Defaults to `/blog`.\n */\n pathPrefix?: string | ((language: string) => string);\n /** Language whose URL is additionally emitted as `x-default`. */\n xDefaultLanguage?: string;\n};\n\nexport type BlogMetadataOptions = NextClientOptions & {\n alternates?: BlogAlternatesOptions;\n};\n\nconst blogUrlFor = (\n alternates: BlogAlternatesOptions,\n language: string,\n slug: string,\n): string => {\n const base = trimTrailingSlash(alternates.siteUrl);\n const rawPrefix =\n typeof alternates.pathPrefix === 'function'\n ? alternates.pathPrefix(language)\n : (alternates.pathPrefix ?? '/blog');\n return `${base}${normalizePathPrefix(rawPrefix)}/${slug}`;\n};\n\n/**\n * Next.js `Metadata` factory for a chaingrow blog. Wire it up like:\n *\n * ```ts\n * export async function generateMetadata({ params }) {\n * const { slug } = await params;\n * return generateBlogMetadata(slug);\n * }\n * ```\n *\n * Reuses `getBlog()` which is ISR-tagged, so `generateMetadata` + the page\n * render share one backend hit.\n *\n * Pass `opts.alternates` to also emit `alternates.canonical` and hreflang\n * `alternates.languages` built from the post's language variants (ChainGrow\n * publishes translations under the same slug):\n *\n * ```ts\n * return generateBlogMetadata(slug, locale, {\n * alternates: {\n * siteUrl: 'https://example.com',\n * pathPrefix: (lang) => (lang === 'de' ? '/blog' : `/${lang}/blog`),\n * xDefaultLanguage: 'de',\n * },\n * });\n * ```\n *\n * The variant lookup reuses the ISR-cached `listBlogs()` response (same\n * cache entry as the blog index and sitemaps), so it does not add a backend\n * hit per page view.\n *\n * Returns `{}` on 404 — the page's own `notFound()` owns the HTTP status;\n * this helper just declines to emit half-populated metadata for a missing\n * post.\n *\n * Fields that aren't present on the Blog are omitted (not set to\n * `undefined`) so spread-overrides like\n * `{ ...await generateBlogMetadata(slug), alternates: { canonical } }` do\n * what you expect.\n */\nexport async function generateBlogMetadata(\n slug: string,\n language?: string,\n opts?: BlogMetadataOptions,\n): Promise<Metadata> {\n const blog = await getBlog(slug, language, opts);\n if (!blog) return {};\n\n const images = blog.og_image ? [blog.og_image] : undefined;\n const description = blog.description ?? undefined;\n\n const meta: Metadata = {\n title: blog.title,\n ...(description ? { description } : {}),\n openGraph: {\n type: 'article',\n title: blog.title,\n ...(description ? { description } : {}),\n ...(images ? { images } : {}),\n ...(blog.published_at ? { publishedTime: blog.published_at } : {}),\n },\n twitter: {\n card: blog.og_image ? 'summary_large_image' : 'summary',\n title: blog.title,\n ...(description ? { description } : {}),\n ...(images ? { images } : {}),\n },\n };\n\n if (opts?.alternates) {\n const alternates = opts.alternates;\n const canonical = blogUrlFor(alternates, blog.language, blog.slug);\n let languages: Record<string, string> | undefined;\n try {\n const all = await listBlogs({ status: 'PUBLISHED' }, opts);\n const variants = all.filter((b) => b.slug === blog.slug && b.language);\n if (variants.length > 1) {\n languages = {};\n for (const variant of variants) {\n languages[variant.language] = blogUrlFor(\n alternates,\n variant.language,\n variant.slug,\n );\n }\n const xDefaultUrl = alternates.xDefaultLanguage\n ? languages[alternates.xDefaultLanguage]\n : undefined;\n if (xDefaultUrl) languages['x-default'] = xDefaultUrl;\n }\n } catch (err) {\n // hreflang is an enhancement — never fail metadata generation over it.\n console.error(\n 'chaingrow-blog: hreflang variant lookup failed, emitting canonical only:',\n err,\n );\n }\n meta.alternates = {\n canonical,\n ...(languages ? { languages } : {}),\n };\n }\n\n return meta;\n}\n\nexport type BlogIndexMetadataOptions = {\n /** Page title, e.g. `'Blog | Acme'`. */\n title: string;\n description?: string;\n /** Absolute canonical URL of the index page, e.g. `https://example.com/blog`. */\n canonical?: string;\n /** OG/Twitter preview image URL. */\n ogImage?: string;\n};\n\n/**\n * Next.js `Metadata` for a blog *index* page (`app/blog/page.tsx`). The blog\n * detail page gets its metadata from the post itself, but the index has no\n * single post to draw from — without this, greenfield apps fall back to the\n * site-default title on `/blog`. Synchronous (no API call):\n *\n * ```ts\n * export const metadata = generateBlogIndexMetadata({\n * title: 'Blog | Acme',\n * description: 'Product updates and guides from Acme.',\n * canonical: 'https://example.com/blog',\n * });\n * ```\n */\nexport function generateBlogIndexMetadata(\n opts: BlogIndexMetadataOptions,\n): Metadata {\n const { title, description, canonical, ogImage } = opts;\n const images = ogImage ? [ogImage] : undefined;\n return {\n title,\n ...(description ? { description } : {}),\n ...(canonical ? { alternates: { canonical } } : {}),\n openGraph: {\n type: 'website',\n title,\n ...(description ? { description } : {}),\n ...(canonical ? { url: canonical } : {}),\n ...(images ? { images } : {}),\n },\n twitter: {\n card: ogImage ? 'summary_large_image' : 'summary',\n title,\n ...(description ? { description } : {}),\n ...(images ? { images } : {}),\n },\n };\n}\n","import * as React from 'react';\nimport type { Metadata } from 'next';\nimport { notFound } from 'next/navigation';\nimport type { Blog } from '../types';\nimport { BlogDetail } from '../react/BlogDetail';\nimport { BlogJsonLd } from '../react/BlogJsonLd';\nimport { getBlog } from './index';\nimport { generateBlogMetadata, type BlogMetadataOptions } from './metadata';\n\nexport type BlogPageRouteParams = { slug: string; locale?: string };\n\ntype RouteArgs = {\n params: Promise<BlogPageRouteParams>;\n};\n\n/**\n * Default-batteries `app/blog/[slug]/page.tsx` component. Fetches the blog,\n * renders JSON-LD + the detail layout, 404s if missing. Zero configuration\n * and zero CSS framework dependency — typography styles are emitted inline\n * under the scoped `cg-blog-article` class so a fresh app looks good without\n * Tailwind, prose, or anything else installed.\n *\n * If you want a custom layout, breadcrumbs, or to coexist with an existing\n * blog, skip this component and compose `getBlog()` + `<BlogJsonLd>` +\n * `<BlogDetail>` directly in your page file.\n */\nexport async function BlogPage({\n params,\n}: RouteArgs): Promise<React.JSX.Element> {\n const { slug, locale } = await params;\n let blog: Blog | null = null;\n try {\n blog = await getBlog(slug, locale);\n } catch (err) {\n console.error('chaingrow-blog: <BlogPage> getBlog failed:', err);\n }\n if (!blog) notFound();\n\n return (\n <div className=\"cg-blog-article\">\n {/* eslint-disable-next-line react/no-danger */}\n <style dangerouslySetInnerHTML={{ __html: ARTICLE_CSS }} />\n <BlogJsonLd blog={blog} />\n <BlogDetail blog={blog} />\n </div>\n );\n}\n\n// Color strategy: every text element uses \\`color: inherit\\` so the host\n// app's text color cascades down. Muted variants (date, hr) use\n// \\`currentColor\\` with opacity. Backgrounds for placeholders use a\n// translucent neutral that works against any host background. No\n// \\`prefers-color-scheme\\` rules — the host's theme system (Tailwind\n// \\`dark:\\`, \\`data-theme\\`, OS preference, whatever) drives the SDK\n// without it having to know how the host implements the toggle.\nconst ARTICLE_CSS = `\n.cg-blog-article {\n max-width: 720px;\n margin: 0 auto;\n padding: 4rem 1.5rem 6rem;\n font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, \"Helvetica Neue\", Arial, sans-serif;\n font-size: 1.0625rem;\n line-height: 1.7;\n color: inherit;\n -webkit-font-smoothing: antialiased;\n -moz-osx-font-smoothing: grayscale;\n}\n.cg-blog-article h1 {\n font-size: clamp(2rem, 4vw, 2.625rem);\n font-weight: 700;\n line-height: 1.15;\n letter-spacing: -0.022em;\n color: inherit;\n margin: 0 0 1rem;\n}\n.cg-blog-article time {\n display: block;\n font-size: 0.8125rem;\n color: currentColor;\n opacity: 0.55;\n margin: 0 0 2rem;\n font-weight: 400;\n}\n.cg-blog-article h2 {\n font-size: 1.625rem;\n font-weight: 700;\n line-height: 1.25;\n letter-spacing: -0.015em;\n color: inherit;\n margin: 3rem 0 1rem;\n}\n.cg-blog-article h3 {\n font-size: 1.25rem;\n font-weight: 700;\n line-height: 1.3;\n color: inherit;\n margin: 2.25rem 0 0.75rem;\n}\n.cg-blog-article h4 {\n font-size: 1.0625rem;\n font-weight: 700;\n color: inherit;\n margin: 1.75rem 0 0.5rem;\n}\n.cg-blog-article p {\n margin: 0 0 1.25rem;\n color: inherit;\n}\n.cg-blog-article a {\n color: inherit;\n text-decoration: underline;\n text-underline-offset: 3px;\n text-decoration-thickness: 1px;\n transition: opacity 150ms ease;\n}\n.cg-blog-article a:hover { opacity: 0.7; }\n.cg-blog-article strong { color: inherit; font-weight: 700; }\n.cg-blog-article em { font-style: italic; }\n.cg-blog-article ul,\n.cg-blog-article ol {\n margin: 0 0 1.5rem;\n padding-left: 1.5rem;\n color: inherit;\n}\n.cg-blog-article li {\n margin-bottom: 0.5rem;\n line-height: 1.65;\n}\n.cg-blog-article li > p { margin: 0 0 0.5rem; }\n.cg-blog-article li:last-child > p:last-child { margin-bottom: 0; }\n.cg-blog-article blockquote {\n margin: 2rem 0;\n padding: 0.5rem 0 0.5rem 1.5rem;\n border-left: 3px solid currentColor;\n font-style: italic;\n color: inherit;\n font-size: 1.125rem;\n line-height: 1.6;\n}\n.cg-blog-article blockquote p:last-child { margin-bottom: 0; }\n.cg-blog-article img {\n display: block;\n width: 100%;\n height: auto;\n margin: 2.25rem 0;\n border-radius: 6px;\n background: rgba(128, 128, 128, 0.08);\n}\n.cg-blog-article video {\n display: block;\n width: 100%;\n height: auto;\n margin: 2.25rem 0;\n border-radius: 6px;\n background: rgba(128, 128, 128, 0.15);\n}\n.cg-blog-article hr {\n border: 0;\n height: 1px;\n background: currentColor;\n opacity: 0.15;\n margin: 3rem 0;\n}\n.cg-blog-article code {\n background: rgba(128, 128, 128, 0.15);\n color: inherit;\n padding: 0.15em 0.4em;\n border-radius: 3px;\n font-size: 0.9em;\n font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n}\n.cg-blog-article pre {\n background: rgba(128, 128, 128, 0.12);\n color: inherit;\n padding: 1.25rem 1.5rem;\n border-radius: 6px;\n overflow-x: auto;\n font-size: 0.9375rem;\n line-height: 1.6;\n margin: 1.75rem 0;\n}\n.cg-blog-article pre code {\n background: transparent;\n color: inherit;\n padding: 0;\n border-radius: 0;\n font-size: inherit;\n}\n@media (max-width: 640px) {\n .cg-blog-article {\n padding: 2.5rem 1.25rem 4rem;\n font-size: 1rem;\n }\n .cg-blog-article h2 { margin-top: 2.25rem; }\n .cg-blog-article h3 { margin-top: 1.75rem; }\n}\n`;\n\n/**\n * Default-batteries `generateMetadata` for the detail page. Zero configuration.\n *\n * Greenfield use:\n *\n * ```ts\n * export const generateMetadata = generateBlogPageMetadata();\n * ```\n *\n * Multilingual sites can pass `alternates` to get canonical + hreflang\n * `alternates.languages` for every language variant of the post:\n *\n * ```ts\n * export const generateMetadata = generateBlogPageMetadata({\n * alternates: {\n * siteUrl: 'https://example.com',\n * pathPrefix: (lang) => (lang === 'de' ? '/blog' : `/${lang}/blog`),\n * },\n * });\n * ```\n *\n * For custom metadata or coexistence with a legacy blog, skip this and call\n * `generateBlogMetadata(slug, locale)` directly in your own\n * `generateMetadata`.\n */\nexport function generateBlogPageMetadata(\n opts?: BlogMetadataOptions,\n): (args: RouteArgs) => Promise<Metadata> {\n return async ({ params }) => {\n const { slug, locale } = await params;\n try {\n return await generateBlogMetadata(slug, locale, opts);\n } catch (err) {\n console.error(\n 'chaingrow-blog: generateBlogPageMetadata failed:',\n err,\n );\n return {};\n }\n };\n}\n","import * as React from 'react';\nimport type { Block, EmbeddedMedia, ListItem } from '../types';\n\n/**\n * Default components for each Block type. All are headless — no\n * classNames baked in. Consumers customize via:\n * - `classNames={{ heading: \"...\" }}` on `<BlogRenderer>` — threads\n * through to `className` on the Default component below.\n * - `components={{ heading: MyHeading }}` — full replacement.\n */\n\nexport const DefaultHeading = ({\n level,\n children,\n className,\n}: {\n level: 1 | 2 | 3;\n children: React.ReactNode;\n className?: string;\n}) => {\n if (level === 1) return <h1 className={className}>{children}</h1>;\n if (level === 3) return <h3 className={className}>{children}</h3>;\n return <h2 className={className}>{children}</h2>;\n};\n\nexport const DefaultParagraph = ({\n children,\n className,\n}: {\n children: React.ReactNode;\n className?: string;\n}) => <p className={className}>{children}</p>;\n\nexport const DefaultBulletList = ({\n items,\n className,\n renderBlock,\n}: {\n items: ListItem[];\n className?: string;\n renderBlock: (b: Block, i: number) => React.ReactNode;\n}) => (\n <ul className={className}>\n {items.map((item, i) => (\n <li key={i}>{item.content.map((b, j) => renderBlock(b, j))}</li>\n ))}\n </ul>\n);\n\nexport const DefaultOrderedList = ({\n items,\n className,\n renderBlock,\n}: {\n items: ListItem[];\n className?: string;\n renderBlock: (b: Block, i: number) => React.ReactNode;\n}) => (\n <ol className={className}>\n {items.map((item, i) => (\n <li key={i}>{item.content.map((b, j) => renderBlock(b, j))}</li>\n ))}\n </ol>\n);\n\nexport const DefaultBlockquote = ({\n children,\n className,\n}: {\n children: React.ReactNode;\n className?: string;\n}) => <blockquote className={className}>{children}</blockquote>;\n\nexport const DefaultCodeBlock = ({\n language,\n code,\n className,\n}: {\n language?: string;\n code: string;\n className?: string;\n}) => (\n <pre className={className}>\n <code className={language ? `language-${language}` : undefined}>{code}</code>\n </pre>\n);\n\nexport const DefaultImage = ({\n src,\n alt,\n caption,\n width,\n height,\n className,\n}: {\n src: string;\n alt: string;\n caption?: string;\n width?: number;\n height?: number;\n mediaId?: string;\n className?: string;\n}) => {\n const img = (\n // eslint-disable-next-line @next/next/no-img-element\n <img src={src} alt={alt} width={width} height={height} />\n );\n if (caption) {\n return (\n <figure className={className}>\n {img}\n <figcaption>{caption}</figcaption>\n </figure>\n );\n }\n return <span className={className}>{img}</span>;\n};\n\nexport const DefaultDivider = ({ className }: { className?: string }) => (\n <hr className={className} />\n);\n\n/**\n * Default renderer for a single embedded media item. Bare HTML — no\n * classNames, no styles. Override via `components.media` on `<BlogRenderer>`.\n * `alt` falls back to the generation prompt, which is a sensible description\n * string since it was the LLM input that produced the image.\n */\nexport const DefaultMedia = ({ media }: { media: EmbeddedMedia }) => {\n if (media.media_type === 'VIDEO') {\n return (\n <video\n src={media.media_url}\n controls\n playsInline\n preload=\"metadata\"\n />\n );\n }\n // eslint-disable-next-line @next/next/no-img-element\n return <img src={media.media_url} alt={media.prompt} />;\n};\n","import * as React from 'react';\nimport type {\n Blog,\n Block,\n BlockType,\n EmbeddedMedia,\n Inline,\n ListItem,\n Mark,\n} from '../types';\nimport { interleaveMedia } from '../media-placement';\nimport {\n DefaultHeading,\n DefaultParagraph,\n DefaultBulletList,\n DefaultOrderedList,\n DefaultBlockquote,\n DefaultCodeBlock,\n DefaultImage,\n DefaultDivider,\n DefaultMedia,\n} from './defaults';\n\n/**\n * Override map for per-block components. Keys are the discriminants\n * of `Block`. Consumers pass any subset; unspecified blocks render\n * via the matching `Default*` component.\n *\n * v0.3.0 breaking change: the keys changed to match the new Block\n * union. If you upgraded from 0.2.x, rename `list` → `bulletList` /\n * `orderedList`, `quote` → `blockquote`, `code` → `codeBlock`, drop\n * `image_placeholder` (images are now first-class via `image`).\n */\nexport type BlockComponents = Partial<{\n heading: React.ComponentType<{\n level: 1 | 2 | 3;\n children: React.ReactNode;\n className?: string;\n }>;\n paragraph: React.ComponentType<{\n children: React.ReactNode;\n className?: string;\n }>;\n bulletList: React.ComponentType<{\n items: ListItem[];\n className?: string;\n renderBlock: (b: Block, i: number) => React.ReactNode;\n }>;\n orderedList: React.ComponentType<{\n items: ListItem[];\n className?: string;\n renderBlock: (b: Block, i: number) => React.ReactNode;\n }>;\n blockquote: React.ComponentType<{\n children: React.ReactNode;\n className?: string;\n }>;\n codeBlock: React.ComponentType<{\n language?: string;\n code: string;\n className?: string;\n }>;\n image: React.ComponentType<{\n src: string;\n alt: string;\n caption?: string;\n width?: number;\n height?: number;\n mediaId?: string;\n className?: string;\n }>;\n divider: React.ComponentType<{ className?: string }>;\n /** Renders a single attached image/video when `<BlogRenderer>` distributes\n * `blog.generatedMedia` across the body. Default renders a bare\n * `<img>` or `<video controls>`. */\n media: React.ComponentType<{ media: EmbeddedMedia }>;\n wrapper: React.ComponentType<{ children: React.ReactNode; blog: Blog }>;\n}>;\n\n/** Simple Tailwind-style className override map. Applied to the\n * default component for each block type. `components` override takes\n * precedence — if you replace the component, className won't reach it\n * unless your override handles it. */\nexport type BlockClassNames = Partial<Record<BlockType, string>>;\n\nconst MARK_ORDER: Mark['type'][] = [\n 'bold',\n 'italic',\n 'strike',\n 'code',\n 'link',\n];\n\n/** Render an array of Inline runs into text+mark JSX. */\nfunction InlineRenderer({ inline }: { inline: Inline[] }) {\n return (\n <>\n {inline.map((run, i) => (\n <InlineRun key={i} run={run} />\n ))}\n </>\n );\n}\n\nfunction InlineRun({ run }: { run: Inline }) {\n const marks = run.marks\n ? [...run.marks].sort(\n (a, b) => MARK_ORDER.indexOf(b.type) - MARK_ORDER.indexOf(a.type),\n )\n : [];\n let node: React.ReactNode = run.text;\n for (const mark of marks) {\n switch (mark.type) {\n case 'bold':\n node = <strong>{node}</strong>;\n break;\n case 'italic':\n node = <em>{node}</em>;\n break;\n case 'strike':\n node = <s>{node}</s>;\n break;\n case 'code':\n node = <code>{node}</code>;\n break;\n case 'link':\n node = (\n <a href={mark.href} rel=\"noopener noreferrer\">\n {node}\n </a>\n );\n break;\n }\n }\n return <>{node}</>;\n}\n\nexport function BlockRenderer({\n block,\n components = {},\n classNames = {},\n renderBlock,\n}: {\n block: Block;\n components?: BlockComponents;\n classNames?: BlockClassNames;\n renderBlock?: (b: Block, i: number) => React.ReactNode;\n}) {\n // Parent supplies a renderBlock callback so list items can recurse\n // into the same switch. When not provided (top-level call), wire it\n // to a local closure.\n const recurse: (b: Block, i: number) => React.ReactNode =\n renderBlock ??\n ((b, i) => (\n <BlockRenderer\n key={i}\n block={b}\n components={components}\n classNames={classNames}\n renderBlock={recurse}\n />\n ));\n\n switch (block.type) {\n case 'heading': {\n const Heading = components.heading ?? DefaultHeading;\n return (\n <Heading level={block.level} className={classNames.heading}>\n <InlineRenderer inline={block.content} />\n </Heading>\n );\n }\n case 'paragraph': {\n const Paragraph = components.paragraph ?? DefaultParagraph;\n return (\n <Paragraph className={classNames.paragraph}>\n <InlineRenderer inline={block.content} />\n </Paragraph>\n );\n }\n case 'bulletList': {\n const BulletList = components.bulletList ?? DefaultBulletList;\n return (\n <BulletList\n items={block.items}\n className={classNames.bulletList}\n renderBlock={recurse}\n />\n );\n }\n case 'orderedList': {\n const OrderedList = components.orderedList ?? DefaultOrderedList;\n return (\n <OrderedList\n items={block.items}\n className={classNames.orderedList}\n renderBlock={recurse}\n />\n );\n }\n case 'blockquote': {\n const Blockquote = components.blockquote ?? DefaultBlockquote;\n return (\n <Blockquote className={classNames.blockquote}>\n <InlineRenderer inline={block.content} />\n </Blockquote>\n );\n }\n case 'codeBlock': {\n const CodeBlock = components.codeBlock ?? DefaultCodeBlock;\n return (\n <CodeBlock\n language={block.language}\n code={block.code}\n className={classNames.codeBlock}\n />\n );\n }\n case 'image': {\n const ImageComp = components.image ?? DefaultImage;\n return (\n <ImageComp\n src={block.src}\n alt={block.alt}\n caption={block.caption}\n width={block.width}\n height={block.height}\n mediaId={block.mediaId}\n className={classNames.image}\n />\n );\n }\n case 'divider': {\n const Divider = components.divider ?? DefaultDivider;\n return <Divider className={classNames.divider} />;\n }\n }\n}\n\nexport function BlogRenderer({\n blog,\n components = {},\n classNames = {},\n}: {\n blog: Blog;\n components?: BlockComponents;\n classNames?: BlockClassNames;\n}) {\n const Media = components.media ?? DefaultMedia;\n const Wrapper = components.wrapper;\n\n // Distribute `blog.generatedMedia` across `blog.blocks` at positions\n // floor(i * N / K) — first media at top of body, the rest spread evenly.\n const slots = interleaveMedia(blog.blocks, blog.generatedMedia);\n\n const content = (\n <>\n {slots.map((slot) =>\n slot.kind === 'block' ? (\n <BlockRenderer\n key={`b:${slot.index}`}\n block={slot.block}\n components={components}\n classNames={classNames}\n />\n ) : (\n <Media key={`m:${slot.media.id}`} media={slot.media} />\n ),\n )}\n </>\n );\n\n if (Wrapper) return <Wrapper blog={blog}>{content}</Wrapper>;\n return content;\n}\n","import * as React from 'react';\nimport type { Blog } from '../types';\nimport { BlogRenderer, type BlockComponents } from './BlogRenderer';\n\nexport type BlogDetailComponents = {\n /**\n * Renders above the body. Default: og_image → h1 → time → description.\n * Override to add tags, author chip, share buttons, read time, etc.\n */\n Header?: (props: {\n blog: Blog;\n formatDate: (iso: string) => string;\n }) => React.ReactNode;\n /** Renders below the body. Default: nothing. */\n Footer?: (props: { blog: Blog }) => React.ReactNode;\n /** Forwarded to <BlogRenderer components={...} />. */\n blocks?: BlockComponents;\n};\n\nconst defaultFormatDate = (iso: string): string =>\n new Date(iso).toLocaleDateString();\n\nfunction DefaultHeader({\n blog,\n formatDate,\n}: {\n blog: Blog;\n formatDate: (iso: string) => string;\n}): React.JSX.Element {\n // Bare semantic HTML — no classNames, no styles. Consumers wrap the whole\n // BlogDetail in their own `.prose` / typography container to handle styling.\n //\n // When `generatedMedia` is present, the body (rendered by <BlogRenderer>)\n // distributes those attachments across the blocks and the first one lands\n // at the top of the body — immediately under this header. Rendering\n // `og_image` here too would duplicate the hero image, so we skip it in\n // that case and leave `og_image` as a meta-only field (still used by\n // OpenGraph / Twitter card previews via `generateBlogMetadata`).\n const hasInlineMedia = (blog.generatedMedia?.length ?? 0) > 0;\n // eslint-disable-next-line @next/next/no-img-element\n const heroImage =\n !hasInlineMedia && blog.og_image ? (\n <img src={blog.og_image} alt={blog.title} />\n ) : null;\n return (\n <>\n {heroImage}\n <h1>{blog.title}</h1>\n {blog.published_at && (\n <time dateTime={blog.published_at}>\n {formatDate(blog.published_at)}\n </time>\n )}\n {blog.description && <p>{blog.description}</p>}\n </>\n );\n}\n\nexport function BlogDetail({\n blog,\n components,\n formatDate = defaultFormatDate,\n}: {\n blog: Blog;\n components?: BlogDetailComponents;\n formatDate?: (iso: string) => string;\n}): React.JSX.Element {\n const Header = components?.Header ?? DefaultHeader;\n const Footer = components?.Footer;\n return (\n <article>\n <Header blog={blog} formatDate={formatDate} />\n <BlogRenderer blog={blog} components={components?.blocks} />\n {Footer ? <Footer blog={blog} /> : null}\n </article>\n );\n}\n","import * as React from 'react';\nimport type { Blog } from '../types';\nimport {\n buildBlogJsonLd,\n SCHEMA_ORG_CONTEXT,\n type BlogJsonLdOptions,\n} from '../json-ld';\n\n/**\n * Render an array of Schema.org graph items as a single\n * `<script type=\"application/ld+json\">` tag with a merged `@graph`.\n * Google treats one `@graph` script as equivalent to N separate scripts, and\n * a single tag keeps the DOM uncluttered for consumers who already ship their\n * own schemas (Organization, breadcrumbs, WebSite, …).\n */\nexport function JsonLdGraph({\n items,\n}: {\n items: Record<string, unknown>[];\n}): React.JSX.Element | null {\n if (!items || items.length === 0) return null;\n const payload = JSON.stringify({\n '@context': SCHEMA_ORG_CONTEXT,\n '@graph': items,\n });\n return (\n <script\n type=\"application/ld+json\"\n // eslint-disable-next-line react/no-danger\n dangerouslySetInnerHTML={{ __html: payload }}\n />\n );\n}\n\n/**\n * Default-batteries JSON-LD for a chaingrow Blog: emits BlogPosting +\n * FAQPage (if the post has FAQs) + any LLM-generated extras from\n * `structured_data.jsonLd`. Consumers who already ship their own graph items\n * (breadcrumbs, Organization, …) pass them via `extraSchemas` and they end\n * up in the same `@graph`.\n */\nexport function BlogJsonLd({\n blog,\n extraSchemas,\n ...opts\n}: {\n blog: Blog;\n extraSchemas?: Record<string, unknown>[];\n} & BlogJsonLdOptions): React.JSX.Element | null {\n const items = [...(extraSchemas ?? []), ...buildBlogJsonLd(blog, opts)];\n return <JsonLdGraph items={items} />;\n}\n","import type { MetadataRoute } from 'next';\nimport type { Blog } from '../types';\nimport { createClient } from '../client';\n\nexport type NextClientOptions = {\n apiUrl?: string;\n apiKey?: string;\n revalidate?: number | false;\n};\n\nconst DEFAULT_API_URL = 'https://api.chaingrow.de';\n\n/**\n * Default ISR window for `getBlog` / `listBlogs` when the consumer doesn't\n * set `revalidate` explicitly. 7 days — blog posts are effectively immutable\n * once published, so caching for a week is sensible, and the webhook\n * (`chaingrow-blog/next/webhook`) invalidates the cache immediately on\n * publish anyway so this window is really just a safety net for when the\n * webhook isn't mounted or misses a delivery.\n *\n * Override per-call with `{ revalidate: N }` (seconds), `{ revalidate: 0 }`\n * (never cache — every request hits ChainGrow), or `{ revalidate: false }`\n * (cache forever, only the webhook can invalidate).\n */\nconst DEFAULT_REVALIDATE_SECONDS = 60 * 60 * 24 * 7;\n\nconst resolveEnv = (opts: NextClientOptions = {}) => {\n const apiUrl =\n opts.apiUrl ?? process.env.CHAINGROW_API_URL ?? DEFAULT_API_URL;\n const apiKey = opts.apiKey ?? process.env.CHAINGROW_API_KEY;\n if (!apiKey) {\n throw new Error(\n 'chaingrow-blog: CHAINGROW_API_KEY is not set (env var or apiKey option required)',\n );\n }\n return { apiUrl, apiKey };\n};\n\nconst buildFetch = (tag: string, revalidate: number | false | undefined) => {\n const effectiveRevalidate: number | false =\n revalidate === undefined ? DEFAULT_REVALIDATE_SECONDS : revalidate;\n return ((input: RequestInfo | URL, init?: RequestInit) =>\n fetch(input, {\n ...init,\n next: {\n tags: ['chaingrow:blog', tag],\n revalidate: effectiveRevalidate,\n },\n } as RequestInit)) as typeof fetch;\n};\n\nexport async function getBlog(\n slug: string,\n language?: string,\n opts: NextClientOptions = {},\n): Promise<Blog | null> {\n const { apiUrl, apiKey } = resolveEnv(opts);\n const client = createClient({\n apiUrl,\n apiKey,\n fetch: buildFetch(`chaingrow:blog:${slug}`, opts.revalidate),\n });\n return client.getBlog(slug, language);\n}\n\nexport async function listBlogs(\n listOpts: { status?: 'DRAFT' | 'PUBLISHED'; language?: string } = {},\n opts: NextClientOptions = {},\n): Promise<Blog[]> {\n const { apiUrl, apiKey } = resolveEnv(opts);\n const client = createClient({\n apiUrl,\n apiKey,\n fetch: buildFetch('chaingrow:blog:list', opts.revalidate),\n });\n return client.listBlogs(listOpts);\n}\n\nconst trimTrailingSlash = (s: string): string => s.replace(/\\/+$/, '');\nconst normalizePathPrefix = (s: string): string => {\n let p = s.trim();\n if (!p.startsWith('/')) p = '/' + p;\n while (p.length > 1 && p.endsWith('/')) p = p.slice(0, -1);\n return p;\n};\n\n/**\n * Returns ChainGrow blog entries already shaped for Next.js's\n * `app/sitemap.ts` (`MetadataRoute.Sitemap`). Spread the result into your\n * sitemap array — no mapping required at the call site.\n *\n * ```ts\n * // app/sitemap.ts\n * import type { MetadataRoute } from 'next';\n * import { getBlogSitemapEntries } from 'chaingrow-blog/next';\n *\n * export default async function sitemap(): Promise<MetadataRoute.Sitemap> {\n * const blogs = await getBlogSitemapEntries({\n * siteUrl: 'https://example.com',\n * pathPrefix: '/blog',\n * });\n * return [\n * { url: 'https://example.com', lastModified: new Date() },\n * ...blogs,\n * ];\n * }\n * ```\n *\n * For news sitemaps, image sitemaps, or any case that needs the full blog\n * shape (title, language, attached media), call `listBlogs()` directly.\n */\nexport async function getBlogSitemapEntries(opts: {\n siteUrl: string;\n pathPrefix?: string;\n language?: string;\n} & NextClientOptions): Promise<MetadataRoute.Sitemap> {\n const baseUrl = trimTrailingSlash(opts.siteUrl);\n const pathPrefix = normalizePathPrefix(opts.pathPrefix ?? '/blog');\n const blogs = await listBlogs(\n { status: 'PUBLISHED', language: opts.language },\n {\n apiKey: opts.apiKey,\n apiUrl: opts.apiUrl,\n revalidate: opts.revalidate,\n },\n );\n return blogs.map((blog) => ({\n url: `${baseUrl}${pathPrefix}/${blog.slug}`,\n lastModified: new Date(blog.published_at),\n }));\n}\n\nexport type { Blog } from '../types';\nexport {\n generateBlogMetadata,\n generateBlogIndexMetadata,\n type BlogAlternatesOptions,\n type BlogMetadataOptions,\n type BlogIndexMetadataOptions,\n} from './metadata';\nexport { BlogPage, generateBlogPageMetadata } from './BlogPage';\nexport type { BlogPageRouteParams } from './BlogPage';\n"],"mappings":"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","names":["jsx","Fragment","jsx","jsxs","jsx","jsx","jsxs","trimTrailingSlash","normalizePathPrefix"]}
|
|
1
|
+
{"version":3,"sources":["../src/next/metadata.ts","../src/next/BlogPage.tsx","../src/react/defaults.tsx","../src/react/BlogRenderer.tsx","../src/react/BlogDetail.tsx","../src/react/BlogJsonLd.tsx","../src/next/index.ts"],"sourcesContent":["import type { Metadata } from 'next';\nimport { getBlog, listBlogs } from './index';\nimport type { NextClientOptions } from './index';\n\nconst trimTrailingSlash = (s: string): string => s.replace(/\\/+$/, '');\nconst normalizePathPrefix = (s: string): string => {\n let p = s.trim();\n if (!p.startsWith('/')) p = '/' + p;\n while (p.length > 1 && p.endsWith('/')) p = p.slice(0, -1);\n return p;\n};\n\n/**\n * Opt-in hreflang configuration for `generateBlogMetadata`. ChainGrow serves\n * language variants of a post under one shared slug, so the SDK can emit\n * `alternates.languages` (and a canonical) for every variant it finds —\n * pass this when your site serves more than one language.\n */\nexport type BlogAlternatesOptions = {\n /** Absolute site origin, e.g. `https://example.com` (no trailing slash needed). */\n siteUrl: string;\n /**\n * Blog path prefix. A static string applies to every language; pass a\n * function for locale-prefixed routing, e.g.\n * `(lang) => (lang === 'de' ? '/blog' : `/${lang}/blog`)`.\n * Defaults to `/blog`.\n */\n pathPrefix?: string | ((language: string) => string);\n /** Language whose URL is additionally emitted as `x-default`. */\n xDefaultLanguage?: string;\n};\n\nexport type BlogMetadataOptions = NextClientOptions & {\n alternates?: BlogAlternatesOptions;\n};\n\nconst blogUrlFor = (\n alternates: BlogAlternatesOptions,\n language: string,\n slug: string,\n): string => {\n const base = trimTrailingSlash(alternates.siteUrl);\n const rawPrefix =\n typeof alternates.pathPrefix === 'function'\n ? alternates.pathPrefix(language)\n : (alternates.pathPrefix ?? '/blog');\n return `${base}${normalizePathPrefix(rawPrefix)}/${slug}`;\n};\n\n/**\n * Next.js `Metadata` factory for a chaingrow blog. Wire it up like:\n *\n * ```ts\n * export async function generateMetadata({ params }) {\n * const { slug } = await params;\n * return generateBlogMetadata(slug);\n * }\n * ```\n *\n * Reuses `getBlog()` which is ISR-tagged, so `generateMetadata` + the page\n * render share one backend hit.\n *\n * Pass `opts.alternates` to also emit `alternates.canonical` and hreflang\n * `alternates.languages` built from the post's language variants (ChainGrow\n * publishes translations under the same slug):\n *\n * ```ts\n * return generateBlogMetadata(slug, locale, {\n * alternates: {\n * siteUrl: 'https://example.com',\n * pathPrefix: (lang) => (lang === 'de' ? '/blog' : `/${lang}/blog`),\n * xDefaultLanguage: 'de',\n * },\n * });\n * ```\n *\n * The variant lookup reuses the ISR-cached `listBlogs()` response (same\n * cache entry as the blog index and sitemaps), so it does not add a backend\n * hit per page view.\n *\n * Returns `{}` on 404 — the page's own `notFound()` owns the HTTP status;\n * this helper just declines to emit half-populated metadata for a missing\n * post.\n *\n * Fields that aren't present on the Blog are omitted (not set to\n * `undefined`) so spread-overrides like\n * `{ ...await generateBlogMetadata(slug), alternates: { canonical } }` do\n * what you expect.\n */\nexport async function generateBlogMetadata(\n slug: string,\n language?: string,\n opts?: BlogMetadataOptions,\n): Promise<Metadata> {\n const blog = await getBlog(slug, language, opts);\n if (!blog) return {};\n\n const images = blog.og_image ? [blog.og_image] : undefined;\n const description = blog.description ?? undefined;\n\n const meta: Metadata = {\n title: blog.title,\n ...(description ? { description } : {}),\n openGraph: {\n type: 'article',\n title: blog.title,\n ...(description ? { description } : {}),\n ...(images ? { images } : {}),\n ...(blog.published_at ? { publishedTime: blog.published_at } : {}),\n },\n twitter: {\n card: blog.og_image ? 'summary_large_image' : 'summary',\n title: blog.title,\n ...(description ? { description } : {}),\n ...(images ? { images } : {}),\n },\n };\n\n if (opts?.alternates) {\n const alternates = opts.alternates;\n const canonical = blogUrlFor(alternates, blog.language, blog.slug);\n let languages: Record<string, string> | undefined;\n try {\n const all = await listBlogs({ status: 'PUBLISHED' }, opts);\n const variants = all.filter((b) => b.slug === blog.slug && b.language);\n if (variants.length > 1) {\n languages = {};\n for (const variant of variants) {\n languages[variant.language] = blogUrlFor(\n alternates,\n variant.language,\n variant.slug,\n );\n }\n const xDefaultUrl = alternates.xDefaultLanguage\n ? languages[alternates.xDefaultLanguage]\n : undefined;\n if (xDefaultUrl) languages['x-default'] = xDefaultUrl;\n }\n } catch (err) {\n // hreflang is an enhancement — never fail metadata generation over it.\n console.error(\n 'chaingrow-blog: hreflang variant lookup failed, emitting canonical only:',\n err,\n );\n }\n meta.alternates = {\n canonical,\n ...(languages ? { languages } : {}),\n };\n }\n\n return meta;\n}\n\nexport type BlogIndexMetadataOptions = {\n /** Page title, e.g. `'Blog | Acme'`. */\n title: string;\n description?: string;\n /** Absolute canonical URL of the index page, e.g. `https://example.com/blog`. */\n canonical?: string;\n /** OG/Twitter preview image URL. */\n ogImage?: string;\n};\n\n/**\n * Next.js `Metadata` for a blog *index* page (`app/blog/page.tsx`). The blog\n * detail page gets its metadata from the post itself, but the index has no\n * single post to draw from — without this, greenfield apps fall back to the\n * site-default title on `/blog`. Synchronous (no API call):\n *\n * ```ts\n * export const metadata = generateBlogIndexMetadata({\n * title: 'Blog | Acme',\n * description: 'Product updates and guides from Acme.',\n * canonical: 'https://example.com/blog',\n * });\n * ```\n */\nexport function generateBlogIndexMetadata(\n opts: BlogIndexMetadataOptions,\n): Metadata {\n const { title, description, canonical, ogImage } = opts;\n const images = ogImage ? [ogImage] : undefined;\n return {\n title,\n ...(description ? { description } : {}),\n ...(canonical ? { alternates: { canonical } } : {}),\n openGraph: {\n type: 'website',\n title,\n ...(description ? { description } : {}),\n ...(canonical ? { url: canonical } : {}),\n ...(images ? { images } : {}),\n },\n twitter: {\n card: ogImage ? 'summary_large_image' : 'summary',\n title,\n ...(description ? { description } : {}),\n ...(images ? { images } : {}),\n },\n };\n}\n","import * as React from 'react';\nimport type { Metadata } from 'next';\nimport { notFound } from 'next/navigation';\nimport type { Blog } from '../types';\nimport { BlogDetail } from '../react/BlogDetail';\nimport { BlogJsonLd } from '../react/BlogJsonLd';\nimport { getBlog } from './index';\nimport { generateBlogMetadata, type BlogMetadataOptions } from './metadata';\n\nexport type BlogPageRouteParams = { slug: string; locale?: string };\n\ntype RouteArgs = {\n params: Promise<BlogPageRouteParams>;\n};\n\n/**\n * Default-batteries `app/blog/[slug]/page.tsx` component. Fetches the blog,\n * renders JSON-LD + the detail layout, 404s if missing. Zero configuration\n * and zero CSS framework dependency — typography styles are emitted inline\n * under the scoped `cg-blog-article` class so a fresh app looks good without\n * Tailwind, prose, or anything else installed.\n *\n * If you want a custom layout, breadcrumbs, or to coexist with an existing\n * blog, skip this component and compose `getBlog()` + `<BlogJsonLd>` +\n * `<BlogDetail>` directly in your page file.\n */\nexport async function BlogPage({\n params,\n}: RouteArgs): Promise<React.JSX.Element> {\n const { slug, locale } = await params;\n let blog: Blog | null = null;\n try {\n blog = await getBlog(slug, locale);\n } catch (err) {\n console.error('chaingrow-blog: <BlogPage> getBlog failed:', err);\n }\n if (!blog) notFound();\n\n return (\n <div className=\"cg-blog-article\">\n {/* eslint-disable-next-line react/no-danger */}\n <style dangerouslySetInnerHTML={{ __html: ARTICLE_CSS }} />\n <BlogJsonLd blog={blog} />\n <BlogDetail blog={blog} />\n </div>\n );\n}\n\n// Color strategy: every text element uses \\`color: inherit\\` so the host\n// app's text color cascades down. Muted variants (date, hr) use\n// \\`currentColor\\` with opacity. Backgrounds for placeholders use a\n// translucent neutral that works against any host background. No\n// \\`prefers-color-scheme\\` rules — the host's theme system (Tailwind\n// \\`dark:\\`, \\`data-theme\\`, OS preference, whatever) drives the SDK\n// without it having to know how the host implements the toggle.\nconst ARTICLE_CSS = `\n.cg-blog-article {\n max-width: 720px;\n margin: 0 auto;\n padding: 4rem 1.5rem 6rem;\n font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, \"Helvetica Neue\", Arial, sans-serif;\n font-size: 1.0625rem;\n line-height: 1.7;\n color: inherit;\n -webkit-font-smoothing: antialiased;\n -moz-osx-font-smoothing: grayscale;\n}\n.cg-blog-article h1 {\n font-size: clamp(2rem, 4vw, 2.625rem);\n font-weight: 700;\n line-height: 1.15;\n letter-spacing: -0.022em;\n color: inherit;\n margin: 0 0 1rem;\n}\n.cg-blog-article time {\n display: block;\n font-size: 0.8125rem;\n color: currentColor;\n opacity: 0.55;\n margin: 0 0 2rem;\n font-weight: 400;\n}\n.cg-blog-article h2 {\n font-size: 1.625rem;\n font-weight: 700;\n line-height: 1.25;\n letter-spacing: -0.015em;\n color: inherit;\n margin: 3rem 0 1rem;\n}\n.cg-blog-article h3 {\n font-size: 1.25rem;\n font-weight: 700;\n line-height: 1.3;\n color: inherit;\n margin: 2.25rem 0 0.75rem;\n}\n.cg-blog-article h4 {\n font-size: 1.0625rem;\n font-weight: 700;\n color: inherit;\n margin: 1.75rem 0 0.5rem;\n}\n.cg-blog-article p {\n margin: 0 0 1.25rem;\n color: inherit;\n}\n.cg-blog-article a {\n color: inherit;\n text-decoration: underline;\n text-underline-offset: 3px;\n text-decoration-thickness: 1px;\n transition: opacity 150ms ease;\n}\n.cg-blog-article a:hover { opacity: 0.7; }\n.cg-blog-article strong { color: inherit; font-weight: 700; }\n.cg-blog-article em { font-style: italic; }\n.cg-blog-article ul,\n.cg-blog-article ol {\n margin: 0 0 1.5rem;\n padding-left: 1.5rem;\n color: inherit;\n}\n.cg-blog-article li {\n margin-bottom: 0.5rem;\n line-height: 1.65;\n}\n.cg-blog-article li > p { margin: 0 0 0.5rem; }\n.cg-blog-article li:last-child > p:last-child { margin-bottom: 0; }\n.cg-blog-article blockquote {\n margin: 2rem 0;\n padding: 0.5rem 0 0.5rem 1.5rem;\n border-left: 3px solid currentColor;\n font-style: italic;\n color: inherit;\n font-size: 1.125rem;\n line-height: 1.6;\n}\n.cg-blog-article blockquote p:last-child { margin-bottom: 0; }\n.cg-blog-article img {\n display: block;\n width: 100%;\n height: auto;\n margin: 2.25rem 0;\n border-radius: 6px;\n background: rgba(128, 128, 128, 0.08);\n}\n.cg-blog-article video {\n display: block;\n width: 100%;\n height: auto;\n margin: 2.25rem 0;\n border-radius: 6px;\n background: rgba(128, 128, 128, 0.15);\n}\n.cg-blog-article hr {\n border: 0;\n height: 1px;\n background: currentColor;\n opacity: 0.15;\n margin: 3rem 0;\n}\n.cg-blog-article code {\n background: rgba(128, 128, 128, 0.15);\n color: inherit;\n padding: 0.15em 0.4em;\n border-radius: 3px;\n font-size: 0.9em;\n font-family: ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace;\n}\n.cg-blog-article pre {\n background: rgba(128, 128, 128, 0.12);\n color: inherit;\n padding: 1.25rem 1.5rem;\n border-radius: 6px;\n overflow-x: auto;\n font-size: 0.9375rem;\n line-height: 1.6;\n margin: 1.75rem 0;\n}\n.cg-blog-article pre code {\n background: transparent;\n color: inherit;\n padding: 0;\n border-radius: 0;\n font-size: inherit;\n}\n@media (max-width: 640px) {\n .cg-blog-article {\n padding: 2.5rem 1.25rem 4rem;\n font-size: 1rem;\n }\n .cg-blog-article h2 { margin-top: 2.25rem; }\n .cg-blog-article h3 { margin-top: 1.75rem; }\n}\n`;\n\n/**\n * Default-batteries `generateMetadata` for the detail page. Zero configuration.\n *\n * Greenfield use:\n *\n * ```ts\n * export const generateMetadata = generateBlogPageMetadata();\n * ```\n *\n * Multilingual sites can pass `alternates` to get canonical + hreflang\n * `alternates.languages` for every language variant of the post:\n *\n * ```ts\n * export const generateMetadata = generateBlogPageMetadata({\n * alternates: {\n * siteUrl: 'https://example.com',\n * pathPrefix: (lang) => (lang === 'de' ? '/blog' : `/${lang}/blog`),\n * },\n * });\n * ```\n *\n * For custom metadata or coexistence with a legacy blog, skip this and call\n * `generateBlogMetadata(slug, locale)` directly in your own\n * `generateMetadata`.\n */\nexport function generateBlogPageMetadata(\n opts?: BlogMetadataOptions,\n): (args: RouteArgs) => Promise<Metadata> {\n return async ({ params }) => {\n const { slug, locale } = await params;\n try {\n return await generateBlogMetadata(slug, locale, opts);\n } catch (err) {\n console.error(\n 'chaingrow-blog: generateBlogPageMetadata failed:',\n err,\n );\n return {};\n }\n };\n}\n","import * as React from 'react';\nimport type { Block, EmbeddedMedia, ListItem } from '../types';\n\n/**\n * Default components for each Block type. All are headless — no\n * classNames baked in. Consumers customize via:\n * - `classNames={{ heading: \"...\" }}` on `<BlogRenderer>` — threads\n * through to `className` on the Default component below.\n * - `components={{ heading: MyHeading }}` — full replacement.\n */\n\nexport const DefaultHeading = ({\n level,\n children,\n className,\n}: {\n level: 1 | 2 | 3;\n children: React.ReactNode;\n className?: string;\n}) => {\n if (level === 1) return <h1 className={className}>{children}</h1>;\n if (level === 3) return <h3 className={className}>{children}</h3>;\n return <h2 className={className}>{children}</h2>;\n};\n\nexport const DefaultParagraph = ({\n children,\n className,\n}: {\n children: React.ReactNode;\n className?: string;\n}) => <p className={className}>{children}</p>;\n\nexport const DefaultBulletList = ({\n items,\n className,\n renderBlock,\n}: {\n items: ListItem[];\n className?: string;\n renderBlock: (b: Block, i: number) => React.ReactNode;\n}) => (\n <ul className={className}>\n {items.map((item, i) => (\n <li key={i}>{item.content.map((b, j) => renderBlock(b, j))}</li>\n ))}\n </ul>\n);\n\nexport const DefaultOrderedList = ({\n items,\n className,\n renderBlock,\n}: {\n items: ListItem[];\n className?: string;\n renderBlock: (b: Block, i: number) => React.ReactNode;\n}) => (\n <ol className={className}>\n {items.map((item, i) => (\n <li key={i}>{item.content.map((b, j) => renderBlock(b, j))}</li>\n ))}\n </ol>\n);\n\nexport const DefaultBlockquote = ({\n children,\n className,\n}: {\n children: React.ReactNode;\n className?: string;\n}) => <blockquote className={className}>{children}</blockquote>;\n\nexport const DefaultCodeBlock = ({\n language,\n code,\n className,\n}: {\n language?: string;\n code: string;\n className?: string;\n}) => (\n <pre className={className}>\n <code className={language ? `language-${language}` : undefined}>{code}</code>\n </pre>\n);\n\nexport const DefaultImage = ({\n src,\n alt,\n caption,\n width,\n height,\n className,\n}: {\n src: string;\n alt: string;\n caption?: string;\n width?: number;\n height?: number;\n mediaId?: string;\n className?: string;\n}) => {\n const img = (\n // eslint-disable-next-line @next/next/no-img-element\n <img src={src} alt={alt} width={width} height={height} />\n );\n if (caption) {\n return (\n <figure className={className}>\n {img}\n <figcaption>{caption}</figcaption>\n </figure>\n );\n }\n return <span className={className}>{img}</span>;\n};\n\nexport const DefaultDivider = ({ className }: { className?: string }) => (\n <hr className={className} />\n);\n\n/**\n * Default renderer for a single embedded media item. Bare HTML — no\n * classNames, no styles. Override via `components.media` on `<BlogRenderer>`.\n * `alt` falls back to the generation prompt, which is a sensible description\n * string since it was the LLM input that produced the image.\n */\nexport const DefaultMedia = ({ media }: { media: EmbeddedMedia }) => {\n if (media.media_type === 'VIDEO') {\n return (\n <video\n src={media.media_url}\n controls\n playsInline\n preload=\"metadata\"\n />\n );\n }\n // eslint-disable-next-line @next/next/no-img-element\n return <img src={media.media_url} alt={media.prompt} />;\n};\n","import * as React from 'react';\nimport type {\n Blog,\n Block,\n BlockType,\n EmbeddedMedia,\n Inline,\n ListItem,\n Mark,\n} from '../types';\nimport { interleaveMedia } from '../media-placement';\nimport {\n DefaultHeading,\n DefaultParagraph,\n DefaultBulletList,\n DefaultOrderedList,\n DefaultBlockquote,\n DefaultCodeBlock,\n DefaultImage,\n DefaultDivider,\n DefaultMedia,\n} from './defaults';\n\n/**\n * Override map for per-block components. Keys are the discriminants\n * of `Block`. Consumers pass any subset; unspecified blocks render\n * via the matching `Default*` component.\n *\n * v0.3.0 breaking change: the keys changed to match the new Block\n * union. If you upgraded from 0.2.x, rename `list` → `bulletList` /\n * `orderedList`, `quote` → `blockquote`, `code` → `codeBlock`, drop\n * `image_placeholder` (images are now first-class via `image`).\n */\nexport type BlockComponents = Partial<{\n heading: React.ComponentType<{\n level: 1 | 2 | 3;\n children: React.ReactNode;\n className?: string;\n }>;\n paragraph: React.ComponentType<{\n children: React.ReactNode;\n className?: string;\n }>;\n bulletList: React.ComponentType<{\n items: ListItem[];\n className?: string;\n renderBlock: (b: Block, i: number) => React.ReactNode;\n }>;\n orderedList: React.ComponentType<{\n items: ListItem[];\n className?: string;\n renderBlock: (b: Block, i: number) => React.ReactNode;\n }>;\n blockquote: React.ComponentType<{\n children: React.ReactNode;\n className?: string;\n }>;\n codeBlock: React.ComponentType<{\n language?: string;\n code: string;\n className?: string;\n }>;\n image: React.ComponentType<{\n src: string;\n alt: string;\n caption?: string;\n width?: number;\n height?: number;\n mediaId?: string;\n className?: string;\n }>;\n divider: React.ComponentType<{ className?: string }>;\n /** Renders a single attached image/video when `<BlogRenderer>` distributes\n * `blog.generatedMedia` across the body. Default renders a bare\n * `<img>` or `<video controls>`. */\n media: React.ComponentType<{ media: EmbeddedMedia }>;\n wrapper: React.ComponentType<{ children: React.ReactNode; blog: Blog }>;\n}>;\n\n/** Simple Tailwind-style className override map. Applied to the\n * default component for each block type. `components` override takes\n * precedence — if you replace the component, className won't reach it\n * unless your override handles it. */\nexport type BlockClassNames = Partial<Record<BlockType, string>>;\n\nconst MARK_ORDER: Mark['type'][] = [\n 'bold',\n 'italic',\n 'strike',\n 'code',\n 'link',\n];\n\n/** Render an array of Inline runs into text+mark JSX. */\nfunction InlineRenderer({ inline }: { inline: Inline[] }) {\n return (\n <>\n {inline.map((run, i) => (\n <InlineRun key={i} run={run} />\n ))}\n </>\n );\n}\n\nfunction InlineRun({ run }: { run: Inline }) {\n const marks = run.marks\n ? [...run.marks].sort(\n (a, b) => MARK_ORDER.indexOf(b.type) - MARK_ORDER.indexOf(a.type),\n )\n : [];\n let node: React.ReactNode = run.text;\n for (const mark of marks) {\n switch (mark.type) {\n case 'bold':\n node = <strong>{node}</strong>;\n break;\n case 'italic':\n node = <em>{node}</em>;\n break;\n case 'strike':\n node = <s>{node}</s>;\n break;\n case 'code':\n node = <code>{node}</code>;\n break;\n case 'link':\n node = (\n <a href={mark.href} rel=\"noopener noreferrer\">\n {node}\n </a>\n );\n break;\n }\n }\n return <>{node}</>;\n}\n\nexport function BlockRenderer({\n block,\n components = {},\n classNames = {},\n renderBlock,\n}: {\n block: Block;\n components?: BlockComponents;\n classNames?: BlockClassNames;\n renderBlock?: (b: Block, i: number) => React.ReactNode;\n}) {\n // Parent supplies a renderBlock callback so list items can recurse\n // into the same switch. When not provided (top-level call), wire it\n // to a local closure.\n const recurse: (b: Block, i: number) => React.ReactNode =\n renderBlock ??\n ((b, i) => (\n <BlockRenderer\n key={i}\n block={b}\n components={components}\n classNames={classNames}\n renderBlock={recurse}\n />\n ));\n\n switch (block.type) {\n case 'heading': {\n const Heading = components.heading ?? DefaultHeading;\n return (\n <Heading level={block.level} className={classNames.heading}>\n <InlineRenderer inline={block.content} />\n </Heading>\n );\n }\n case 'paragraph': {\n const Paragraph = components.paragraph ?? DefaultParagraph;\n return (\n <Paragraph className={classNames.paragraph}>\n <InlineRenderer inline={block.content} />\n </Paragraph>\n );\n }\n case 'bulletList': {\n const BulletList = components.bulletList ?? DefaultBulletList;\n return (\n <BulletList\n items={block.items}\n className={classNames.bulletList}\n renderBlock={recurse}\n />\n );\n }\n case 'orderedList': {\n const OrderedList = components.orderedList ?? DefaultOrderedList;\n return (\n <OrderedList\n items={block.items}\n className={classNames.orderedList}\n renderBlock={recurse}\n />\n );\n }\n case 'blockquote': {\n const Blockquote = components.blockquote ?? DefaultBlockquote;\n return (\n <Blockquote className={classNames.blockquote}>\n <InlineRenderer inline={block.content} />\n </Blockquote>\n );\n }\n case 'codeBlock': {\n const CodeBlock = components.codeBlock ?? DefaultCodeBlock;\n return (\n <CodeBlock\n language={block.language}\n code={block.code}\n className={classNames.codeBlock}\n />\n );\n }\n case 'image': {\n const ImageComp = components.image ?? DefaultImage;\n return (\n <ImageComp\n src={block.src}\n alt={block.alt}\n caption={block.caption}\n width={block.width}\n height={block.height}\n mediaId={block.mediaId}\n className={classNames.image}\n />\n );\n }\n case 'divider': {\n const Divider = components.divider ?? DefaultDivider;\n return <Divider className={classNames.divider} />;\n }\n }\n}\n\nexport function BlogRenderer({\n blog,\n components = {},\n classNames = {},\n}: {\n blog: Blog;\n components?: BlockComponents;\n classNames?: BlockClassNames;\n}) {\n const Media = components.media ?? DefaultMedia;\n const Wrapper = components.wrapper;\n\n // Distribute `blog.generatedMedia` across `blog.blocks` at positions\n // floor(i * N / K) — first media at top of body, the rest spread evenly.\n // Images placed in the text render as their own `image` blocks instead.\n const slots = interleaveMedia(blog.blocks, blog.generatedMedia);\n\n const content = (\n <>\n {slots.map((slot) =>\n slot.kind === 'block' ? (\n <BlockRenderer\n key={`b:${slot.index}`}\n block={slot.block}\n components={components}\n classNames={classNames}\n />\n ) : (\n <Media key={`m:${slot.media.id}`} media={slot.media} />\n ),\n )}\n </>\n );\n\n if (Wrapper) return <Wrapper blog={blog}>{content}</Wrapper>;\n return content;\n}\n","import * as React from 'react';\nimport type { Blog } from '../types';\nimport { hasTextImage } from '../media-placement';\nimport { BlogRenderer, type BlockComponents } from './BlogRenderer';\n\nexport type BlogDetailComponents = {\n /**\n * Renders above the body. Default: og_image → h1 → time → description.\n * Override to add tags, author chip, share buttons, read time, etc.\n */\n Header?: (props: {\n blog: Blog;\n formatDate: (iso: string) => string;\n }) => React.ReactNode;\n /** Renders below the body. Default: nothing. */\n Footer?: (props: { blog: Blog }) => React.ReactNode;\n /** Forwarded to <BlogRenderer components={...} />. */\n blocks?: BlockComponents;\n};\n\nconst defaultFormatDate = (iso: string): string =>\n new Date(iso).toLocaleDateString();\n\nfunction DefaultHeader({\n blog,\n formatDate,\n}: {\n blog: Blog;\n formatDate: (iso: string) => string;\n}): React.JSX.Element {\n // Bare semantic HTML — no classNames, no styles. Consumers wrap the whole\n // BlogDetail in their own `.prose` / typography container to handle styling.\n //\n // When the body shows any image — attachments spread by <BlogRenderer>\n // (the first lands at the top of the body, right under this header) or\n // images placed in the text — `og_image` is one of them, so rendering it\n // here too would show it twice. It then stays a meta-only field (still\n // used by OpenGraph / Twitter card previews via `generateBlogMetadata`).\n const hasInlineMedia =\n (blog.generatedMedia?.length ?? 0) > 0 || hasTextImage(blog.blocks);\n // eslint-disable-next-line @next/next/no-img-element\n const heroImage =\n !hasInlineMedia && blog.og_image ? (\n <img src={blog.og_image} alt={blog.title} />\n ) : null;\n return (\n <>\n {heroImage}\n <h1>{blog.title}</h1>\n {blog.published_at && (\n <time dateTime={blog.published_at}>\n {formatDate(blog.published_at)}\n </time>\n )}\n {blog.description && <p>{blog.description}</p>}\n </>\n );\n}\n\nexport function BlogDetail({\n blog,\n components,\n formatDate = defaultFormatDate,\n}: {\n blog: Blog;\n components?: BlogDetailComponents;\n formatDate?: (iso: string) => string;\n}): React.JSX.Element {\n const Header = components?.Header ?? DefaultHeader;\n const Footer = components?.Footer;\n return (\n <article>\n <Header blog={blog} formatDate={formatDate} />\n <BlogRenderer blog={blog} components={components?.blocks} />\n {Footer ? <Footer blog={blog} /> : null}\n </article>\n );\n}\n","import * as React from 'react';\nimport type { Blog } from '../types';\nimport {\n buildBlogJsonLd,\n SCHEMA_ORG_CONTEXT,\n type BlogJsonLdOptions,\n} from '../json-ld';\n\n/**\n * Render an array of Schema.org graph items as a single\n * `<script type=\"application/ld+json\">` tag with a merged `@graph`.\n * Google treats one `@graph` script as equivalent to N separate scripts, and\n * a single tag keeps the DOM uncluttered for consumers who already ship their\n * own schemas (Organization, breadcrumbs, WebSite, …).\n */\nexport function JsonLdGraph({\n items,\n}: {\n items: Record<string, unknown>[];\n}): React.JSX.Element | null {\n if (!items || items.length === 0) return null;\n const payload = JSON.stringify({\n '@context': SCHEMA_ORG_CONTEXT,\n '@graph': items,\n });\n return (\n <script\n type=\"application/ld+json\"\n // eslint-disable-next-line react/no-danger\n dangerouslySetInnerHTML={{ __html: payload }}\n />\n );\n}\n\n/**\n * Default-batteries JSON-LD for a chaingrow Blog: emits BlogPosting +\n * FAQPage (if the post has FAQs) + any LLM-generated extras from\n * `structured_data.jsonLd`. Consumers who already ship their own graph items\n * (breadcrumbs, Organization, …) pass them via `extraSchemas` and they end\n * up in the same `@graph`.\n */\nexport function BlogJsonLd({\n blog,\n extraSchemas,\n ...opts\n}: {\n blog: Blog;\n extraSchemas?: Record<string, unknown>[];\n} & BlogJsonLdOptions): React.JSX.Element | null {\n const items = [...(extraSchemas ?? []), ...buildBlogJsonLd(blog, opts)];\n return <JsonLdGraph items={items} />;\n}\n","import type { MetadataRoute } from 'next';\nimport type { Blog } from '../types';\nimport { createClient } from '../client';\n\nexport type NextClientOptions = {\n apiUrl?: string;\n apiKey?: string;\n revalidate?: number | false;\n};\n\nconst DEFAULT_API_URL = 'https://api.chaingrow.de';\n\n/**\n * Default ISR window for `getBlog` / `listBlogs` when the consumer doesn't\n * set `revalidate` explicitly. 7 days — blog posts are effectively immutable\n * once published, so caching for a week is sensible, and the webhook\n * (`chaingrow-blog/next/webhook`) invalidates the cache immediately on\n * publish anyway so this window is really just a safety net for when the\n * webhook isn't mounted or misses a delivery.\n *\n * Override per-call with `{ revalidate: N }` (seconds), `{ revalidate: 0 }`\n * (never cache — every request hits ChainGrow), or `{ revalidate: false }`\n * (cache forever, only the webhook can invalidate).\n */\nconst DEFAULT_REVALIDATE_SECONDS = 60 * 60 * 24 * 7;\n\nconst resolveEnv = (opts: NextClientOptions = {}) => {\n const apiUrl =\n opts.apiUrl ?? process.env.CHAINGROW_API_URL ?? DEFAULT_API_URL;\n const apiKey = opts.apiKey ?? process.env.CHAINGROW_API_KEY;\n if (!apiKey) {\n throw new Error(\n 'chaingrow-blog: CHAINGROW_API_KEY is not set (env var or apiKey option required)',\n );\n }\n return { apiUrl, apiKey };\n};\n\nconst buildFetch = (tag: string, revalidate: number | false | undefined) => {\n const effectiveRevalidate: number | false =\n revalidate === undefined ? DEFAULT_REVALIDATE_SECONDS : revalidate;\n return ((input: RequestInfo | URL, init?: RequestInit) =>\n fetch(input, {\n ...init,\n next: {\n tags: ['chaingrow:blog', tag],\n revalidate: effectiveRevalidate,\n },\n } as RequestInit)) as typeof fetch;\n};\n\nexport async function getBlog(\n slug: string,\n language?: string,\n opts: NextClientOptions = {},\n): Promise<Blog | null> {\n const { apiUrl, apiKey } = resolveEnv(opts);\n const client = createClient({\n apiUrl,\n apiKey,\n fetch: buildFetch(`chaingrow:blog:${slug}`, opts.revalidate),\n });\n return client.getBlog(slug, language);\n}\n\nexport async function listBlogs(\n listOpts: { status?: 'DRAFT' | 'PUBLISHED'; language?: string } = {},\n opts: NextClientOptions = {},\n): Promise<Blog[]> {\n const { apiUrl, apiKey } = resolveEnv(opts);\n const client = createClient({\n apiUrl,\n apiKey,\n fetch: buildFetch('chaingrow:blog:list', opts.revalidate),\n });\n return client.listBlogs(listOpts);\n}\n\nconst trimTrailingSlash = (s: string): string => s.replace(/\\/+$/, '');\nconst normalizePathPrefix = (s: string): string => {\n let p = s.trim();\n if (!p.startsWith('/')) p = '/' + p;\n while (p.length > 1 && p.endsWith('/')) p = p.slice(0, -1);\n return p;\n};\n\n/**\n * Returns ChainGrow blog entries already shaped for Next.js's\n * `app/sitemap.ts` (`MetadataRoute.Sitemap`). Spread the result into your\n * sitemap array — no mapping required at the call site.\n *\n * ```ts\n * // app/sitemap.ts\n * import type { MetadataRoute } from 'next';\n * import { getBlogSitemapEntries } from 'chaingrow-blog/next';\n *\n * export default async function sitemap(): Promise<MetadataRoute.Sitemap> {\n * const blogs = await getBlogSitemapEntries({\n * siteUrl: 'https://example.com',\n * pathPrefix: '/blog',\n * });\n * return [\n * { url: 'https://example.com', lastModified: new Date() },\n * ...blogs,\n * ];\n * }\n * ```\n *\n * For news sitemaps, image sitemaps, or any case that needs the full blog\n * shape (title, language, attached media), call `listBlogs()` directly.\n */\nexport async function getBlogSitemapEntries(opts: {\n siteUrl: string;\n pathPrefix?: string;\n language?: string;\n} & NextClientOptions): Promise<MetadataRoute.Sitemap> {\n const baseUrl = trimTrailingSlash(opts.siteUrl);\n const pathPrefix = normalizePathPrefix(opts.pathPrefix ?? '/blog');\n const blogs = await listBlogs(\n { status: 'PUBLISHED', language: opts.language },\n {\n apiKey: opts.apiKey,\n apiUrl: opts.apiUrl,\n revalidate: opts.revalidate,\n },\n );\n return blogs.map((blog) => ({\n url: `${baseUrl}${pathPrefix}/${blog.slug}`,\n lastModified: new Date(blog.published_at),\n }));\n}\n\nexport type { Blog } from '../types';\nexport {\n generateBlogMetadata,\n generateBlogIndexMetadata,\n type BlogAlternatesOptions,\n type BlogMetadataOptions,\n type BlogIndexMetadataOptions,\n} from './metadata';\nexport { BlogPage, generateBlogPageMetadata } from './BlogPage';\nexport type { BlogPageRouteParams } from './BlogPage';\n"],"mappings":"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","names":["jsx","Fragment","jsx","jsxs","jsx","jsx","jsxs","trimTrailingSlash","normalizePathPrefix"]}
|
|
@@ -1,4 +1,16 @@
|
|
|
1
1
|
// src/client.ts
|
|
2
|
+
var TRANSIENT_NETWORK_CODES = /* @__PURE__ */ new Set([
|
|
3
|
+
"EAI_AGAIN",
|
|
4
|
+
"ETIMEDOUT",
|
|
5
|
+
"ECONNRESET",
|
|
6
|
+
"UND_ERR_CONNECT_TIMEOUT",
|
|
7
|
+
"UND_ERR_SOCKET"
|
|
8
|
+
]);
|
|
9
|
+
var NETWORK_ATTEMPTS = 3;
|
|
10
|
+
function causeCode(err) {
|
|
11
|
+
const cause = err instanceof Error ? err.cause : void 0;
|
|
12
|
+
return cause && typeof cause === "object" && "code" in cause ? String(cause.code) : void 0;
|
|
13
|
+
}
|
|
2
14
|
function createClient(opts) {
|
|
3
15
|
const baseUrl = opts.apiUrl.replace(/\/$/, "");
|
|
4
16
|
const doFetch = opts.fetch ?? fetch;
|
|
@@ -14,24 +26,33 @@ function createClient(opts) {
|
|
|
14
26
|
}
|
|
15
27
|
});
|
|
16
28
|
let res;
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
if (res.status === 429) {
|
|
20
|
-
const waitSec = parseInt(res.headers.get("Retry-After") ?? "1", 10);
|
|
21
|
-
await new Promise(
|
|
22
|
-
(resolve) => setTimeout(resolve, Math.max(0, waitSec) * 1e3)
|
|
23
|
-
);
|
|
29
|
+
for (let attempt = 1; attempt <= NETWORK_ATTEMPTS; attempt++) {
|
|
30
|
+
try {
|
|
24
31
|
res = await doFetch(url, buildInit());
|
|
32
|
+
if (res.status === 429) {
|
|
33
|
+
const waitSec = parseInt(res.headers.get("Retry-After") ?? "1", 10);
|
|
34
|
+
await new Promise(
|
|
35
|
+
(resolve) => setTimeout(resolve, Math.max(0, waitSec) * 1e3)
|
|
36
|
+
);
|
|
37
|
+
res = await doFetch(url, buildInit());
|
|
38
|
+
}
|
|
39
|
+
break;
|
|
40
|
+
} catch (err) {
|
|
41
|
+
const code = causeCode(err);
|
|
42
|
+
if (attempt < NETWORK_ATTEMPTS && code !== void 0 && TRANSIENT_NETWORK_CODES.has(code)) {
|
|
43
|
+
await new Promise((resolve) => setTimeout(resolve, 250 * attempt));
|
|
44
|
+
continue;
|
|
45
|
+
}
|
|
46
|
+
const detail = code ? `${code}${err instanceof Error && err.message ? ` (${err.message})` : ""}` : err instanceof Error ? err.message : String(err);
|
|
47
|
+
const e = new Error(
|
|
48
|
+
`chaingrow-blog: could not reach ${method} ${url} \u2014 ${detail}. Set CHAINGROW_API_URL to override the API host (default https://api.chaingrow.de).`
|
|
49
|
+
);
|
|
50
|
+
e.cause = err;
|
|
51
|
+
throw e;
|
|
25
52
|
}
|
|
26
|
-
}
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
const detail = code ? `${code}${err instanceof Error && err.message ? ` (${err.message})` : ""}` : err instanceof Error ? err.message : String(err);
|
|
30
|
-
const e = new Error(
|
|
31
|
-
`chaingrow-blog: could not reach ${method} ${url} \u2014 ${detail}. Set CHAINGROW_API_URL to override the API host (default https://api.chaingrow.de).`
|
|
32
|
-
);
|
|
33
|
-
e.cause = err;
|
|
34
|
-
throw e;
|
|
53
|
+
}
|
|
54
|
+
if (!res) {
|
|
55
|
+
throw new Error(`chaingrow-blog: ${method} ${url} \u2014 no response`);
|
|
35
56
|
}
|
|
36
57
|
if (res.status === 404) return null;
|
|
37
58
|
if (!res.ok) {
|
|
@@ -145,8 +166,28 @@ function distributeMediaPositions(blockCount, mediaCount) {
|
|
|
145
166
|
(_, i) => Math.floor(i * blockCount / mediaCount)
|
|
146
167
|
);
|
|
147
168
|
}
|
|
169
|
+
function placedMediaIds(blocks) {
|
|
170
|
+
const ids = /* @__PURE__ */ new Set();
|
|
171
|
+
const walk = (list) => {
|
|
172
|
+
for (const b of list) {
|
|
173
|
+
if (b.type === "image" && b.mediaId) ids.add(b.mediaId);
|
|
174
|
+
else if (b.type === "bulletList" || b.type === "orderedList") {
|
|
175
|
+
for (const item of b.items) walk(item.content);
|
|
176
|
+
}
|
|
177
|
+
}
|
|
178
|
+
};
|
|
179
|
+
walk(blocks);
|
|
180
|
+
return ids;
|
|
181
|
+
}
|
|
182
|
+
function hasTextImage(blocks) {
|
|
183
|
+
const walk = (list) => list.some(
|
|
184
|
+
(b) => b.type === "image" || (b.type === "bulletList" || b.type === "orderedList") && b.items.some((item) => walk(item.content))
|
|
185
|
+
);
|
|
186
|
+
return walk(blocks);
|
|
187
|
+
}
|
|
148
188
|
function interleaveMedia(blocks, media) {
|
|
149
|
-
const
|
|
189
|
+
const placed = placedMediaIds(blocks);
|
|
190
|
+
const mediaList = (media ?? []).filter((m) => !placed.has(m.id));
|
|
150
191
|
const positions = distributeMediaPositions(blocks.length, mediaList.length);
|
|
151
192
|
const slots = [];
|
|
152
193
|
let mediaCursor = 0;
|
|
@@ -171,6 +212,8 @@ export {
|
|
|
171
212
|
buildBlogJsonLd,
|
|
172
213
|
SCHEMA_ORG_CONTEXT,
|
|
173
214
|
distributeMediaPositions,
|
|
215
|
+
placedMediaIds,
|
|
216
|
+
hasTextImage,
|
|
174
217
|
interleaveMedia
|
|
175
218
|
};
|
|
176
|
-
//# sourceMappingURL=chunk-
|
|
219
|
+
//# sourceMappingURL=chunk-KDUQNIJ2.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/client.ts","../src/json-ld.ts","../src/media-placement.ts"],"sourcesContent":["import type { Blog } from './types';\n\nexport type ClientOptions = {\n apiUrl: string;\n apiKey: string;\n fetch?: typeof fetch;\n};\n\nexport type ListBlogsOptions = {\n status?: 'DRAFT' | 'PUBLISHED';\n language?: string;\n};\n\nexport type ChaingrowClient = {\n getBlog(slug: string, language?: string): Promise<Blog | null>;\n getBlogById(id: string): Promise<Blog | null>;\n listBlogs(opts?: ListBlogsOptions): Promise<Blog[]>;\n};\n\n// Error codes that indicate a transient network hiccup rather than a broken\n// setup: flaky DNS resolution (musl containers throw EAI_AGAIN under load),\n// dropped or timed-out connections. Anything else (bad host, TLS failure)\n// fails fast so misconfiguration stays visible.\nconst TRANSIENT_NETWORK_CODES = new Set([\n 'EAI_AGAIN',\n 'ETIMEDOUT',\n 'ECONNRESET',\n 'UND_ERR_CONNECT_TIMEOUT',\n 'UND_ERR_SOCKET',\n]);\n\nconst NETWORK_ATTEMPTS = 3;\n\nfunction causeCode(err: unknown): string | undefined {\n const cause = err instanceof Error ? err.cause : undefined;\n return cause && typeof cause === 'object' && 'code' in cause\n ? String((cause as { code?: unknown }).code)\n : undefined;\n}\n\nexport function createClient(opts: ClientOptions): ChaingrowClient {\n const baseUrl = opts.apiUrl.replace(/\\/$/, '');\n const doFetch = opts.fetch ?? fetch;\n\n const request = async <T>(\n path: string,\n init?: RequestInit,\n ): Promise<T | null> => {\n const url = `${baseUrl}${path}`;\n const method = init?.method ?? 'GET';\n const buildInit = (): RequestInit => ({\n ...init,\n headers: {\n 'X-API-Key': opts.apiKey,\n Accept: 'application/json',\n ...(init?.headers ?? {}),\n },\n });\n\n let res: Response | undefined;\n for (let attempt = 1; attempt <= NETWORK_ATTEMPTS; attempt++) {\n try {\n res = await doFetch(url, buildInit());\n\n // Transparent one-shot retry on 429, honoring Retry-After (seconds).\n if (res.status === 429) {\n const waitSec = parseInt(res.headers.get('Retry-After') ?? '1', 10);\n await new Promise((resolve) =>\n setTimeout(resolve, Math.max(0, waitSec) * 1000),\n );\n res = await doFetch(url, buildInit());\n }\n break;\n } catch (err) {\n const code = causeCode(err);\n if (\n attempt < NETWORK_ATTEMPTS &&\n code !== undefined &&\n TRANSIENT_NETWORK_CODES.has(code)\n ) {\n await new Promise((resolve) => setTimeout(resolve, 250 * attempt));\n continue;\n }\n\n // `fetch failed` / DNS / connection errors land here. Node's default\n // message buries the host in `err.cause`, which makes integration\n // debugging miserable. Surface the URL and the override env var on\n // the top-level message so it appears in the consumer's server log.\n const detail = code\n ? `${code}${err instanceof Error && err.message ? ` (${err.message})` : ''}`\n : err instanceof Error\n ? err.message\n : String(err);\n const e = new Error(\n `chaingrow-blog: could not reach ${method} ${url} — ${detail}. ` +\n `Set CHAINGROW_API_URL to override the API host (default https://api.chaingrow.de).`,\n );\n (e as Error & { cause?: unknown }).cause = err;\n throw e;\n }\n }\n if (!res) {\n throw new Error(`chaingrow-blog: ${method} ${url} — no response`);\n }\n\n if (res.status === 404) return null;\n if (!res.ok) {\n throw new Error(\n `chaingrow-blog: ${method} ${url} failed (${res.status})`,\n );\n }\n return (await res.json()) as T;\n };\n\n return {\n async getBlog(slug, language) {\n const qs = language ? `?language=${encodeURIComponent(language)}` : '';\n return request<Blog>(\n `/api/v1/blogs/by-slug/${encodeURIComponent(slug)}${qs}`,\n );\n },\n\n async getBlogById(id) {\n return request<Blog>(`/api/v1/blogs/${encodeURIComponent(id)}`);\n },\n\n async listBlogs(listOpts = {}) {\n const collected: Blog[] = [];\n // Page through until the server-reported `total` is reached. Backends\n // without pagination return everything on the first request\n // (total === data.length), so this loop runs exactly once there.\n const MAX_PAGES = 100;\n for (let page = 0; page < MAX_PAGES; page++) {\n const params = new URLSearchParams();\n if (listOpts.status) params.set('status', listOpts.status);\n if (listOpts.language) params.set('language', listOpts.language);\n if (collected.length > 0)\n params.set('offset', String(collected.length));\n const qs = params.toString();\n const response = await request<{ data: Blog[]; total: number }>(\n `/api/v1/blogs${qs ? `?${qs}` : ''}`,\n );\n if (!response) break;\n const batch = response.data ?? [];\n collected.push(...batch);\n const total =\n typeof response.total === 'number' ? response.total : collected.length;\n if (batch.length === 0 || collected.length >= total) break;\n }\n // The language filter also runs server-side (API builds that predate\n // it ignore the query param) — keep this client-side pass as a\n // fallback; against a filtering server it's a no-op.\n if (listOpts.language) {\n return collected.filter((b) => b.language === listOpts.language);\n }\n return collected;\n },\n };\n}\n","import type { Blog, FaqItem } from './types';\n\n/**\n * Consumer-supplied extras for BlogPosting. Everything is optional — the\n * SDK doesn't know the customer's base URL, organisation name, or author\n * identity, so it just omits what it isn't told. Schema.org treats\n * `author`, `publisher`, and `url` as recommended but not required.\n */\nexport type BlogJsonLdOptions = {\n /** Absolute URL of the blog page (e.g. `https://example.com/blog/my-post`). */\n url?: string;\n author?: { name: string; type?: 'Person' | 'Organization'; url?: string };\n publisher?: { name: string; logo?: string };\n};\n\nconst Schema = Object.freeze({ context: 'https://schema.org' });\n\n/**\n * Build a Schema.org `BlogPosting` JSON-LD object from a chaingrow Blog.\n * Fields that aren't present on the Blog (description, og_image, …) are\n * omitted entirely so the resulting JSON has no `undefined` junk.\n */\nexport function buildBlogPostingSchema(\n blog: Blog,\n opts: BlogJsonLdOptions = {},\n): Record<string, unknown> {\n const schema: Record<string, unknown> = {\n '@type': 'BlogPosting',\n headline: blog.title,\n datePublished: blog.published_at,\n };\n if (blog.description) schema.description = blog.description;\n if (blog.og_image) schema.image = blog.og_image;\n if (opts.url) {\n schema.url = opts.url;\n schema.mainEntityOfPage = opts.url;\n }\n if (opts.author) {\n schema.author = {\n '@type': opts.author.type ?? 'Organization',\n name: opts.author.name,\n ...(opts.author.url ? { url: opts.author.url } : {}),\n };\n }\n if (opts.publisher) {\n schema.publisher = {\n '@type': 'Organization',\n name: opts.publisher.name,\n ...(opts.publisher.logo\n ? { logo: { '@type': 'ImageObject', url: opts.publisher.logo } }\n : {}),\n };\n }\n return schema;\n}\n\n/**\n * Build a Schema.org `FAQPage` JSON-LD object from chaingrow's `{question, answer}[]`\n * pairs. Returns `null` for empty input so callers can skip it with a single\n * `if (faqSchema) items.push(faqSchema)` / `filter(Boolean)`.\n */\nexport function buildFAQPageSchema(\n faq: FaqItem[] | null | undefined,\n): Record<string, unknown> | null {\n if (!faq || faq.length === 0) return null;\n return {\n '@type': 'FAQPage',\n mainEntity: faq.map(({ question, answer }) => ({\n '@type': 'Question',\n name: question,\n acceptedAnswer: { '@type': 'Answer', text: answer },\n })),\n };\n}\n\n/**\n * Combines BlogPosting + FAQPage + any LLM-generated `structured_data.jsonLd`\n * extras into a flat array ready for `@graph`. Tolerant of missing/malformed\n * `structured_data` — if the backend ever sends something unexpected we just\n * skip it rather than crashing the consumer's page.\n */\nexport function buildBlogJsonLd(\n blog: Blog,\n opts: BlogJsonLdOptions = {},\n): Record<string, unknown>[] {\n const items: Record<string, unknown>[] = [buildBlogPostingSchema(blog, opts)];\n const faq = buildFAQPageSchema(blog.faq);\n if (faq) items.push(faq);\n items.push(...extractLlmJsonLd(blog.structured_data));\n return items;\n}\n\n/** Schema-org context string — exposed so `<JsonLdGraph>` and any\n * bring-your-own renderer use the same value. */\nexport const SCHEMA_ORG_CONTEXT = Schema.context;\n\n/**\n * Pull the JSON-LD array out of `blog.structured_data`. Per\n * `structuredDataOutputSchema` in @chaingrow/contracts the expected shape is\n * `{ jsonLd: Array<Record<string, unknown>> }`, but historical rows may be\n * `null`, a plain object, or even malformed — normalise to an empty array in\n * every degenerate case so the caller gets a safe spread target.\n */\nfunction extractLlmJsonLd(\n sd: Blog['structured_data'],\n): Record<string, unknown>[] {\n if (!sd || typeof sd !== 'object') return [];\n const ld = (sd as { jsonLd?: unknown }).jsonLd;\n if (!Array.isArray(ld)) return [];\n return ld.filter(\n (entry): entry is Record<string, unknown> =>\n typeof entry === 'object' && entry !== null && !Array.isArray(entry),\n );\n}\n","import type { Block, EmbeddedMedia } from './types';\n\n/**\n * Compute the block-index insertion point for each media item when\n * distributing `mediaCount` attachments across `blockCount` blocks.\n *\n * Formula: media `i` goes at insertion index `floor(i * blockCount / mediaCount)`.\n * An insertion index of `0` means \"before block 0\" (top of body); `blockCount`\n * means \"after the last block\".\n *\n * Examples (blockCount = 10):\n * mediaCount = 1 → [0] (single media at top)\n * mediaCount = 2 → [0, 5] (top + middle)\n * mediaCount = 3 → [0, 3, 6] (top, 1/3, 2/3)\n * mediaCount = 4 → [0, 2, 5, 7] (every quarter)\n *\n * When `blockCount` is 0 every media falls at position 0 and stacks at the\n * top. When two media round to the same position they both land there and\n * render consecutively; this is deterministic but not always visually ideal\n * for very small `blockCount / mediaCount` ratios — assume content has\n * enough blocks to spread across.\n */\nexport function distributeMediaPositions(\n blockCount: number,\n mediaCount: number,\n): number[] {\n if (mediaCount <= 0) return [];\n if (blockCount <= 0) return Array.from({ length: mediaCount }, () => 0);\n return Array.from({ length: mediaCount }, (_, i) =>\n Math.floor((i * blockCount) / mediaCount),\n );\n}\n\n/**\n * Ids of the attachments already placed in the text as `image` blocks\n * (`mediaId`), list items included. `interleaveMedia` skips those, so an\n * image the author placed never shows a second time.\n */\nexport function placedMediaIds(blocks: Block[]): Set<string> {\n const ids = new Set<string>();\n const walk = (list: Block[]) => {\n for (const b of list) {\n if (b.type === 'image' && b.mediaId) ids.add(b.mediaId);\n else if (b.type === 'bulletList' || b.type === 'orderedList') {\n for (const item of b.items) walk(item.content);\n }\n }\n };\n walk(blocks);\n return ids;\n}\n\n/** Whether the text itself contains an image (list items included). */\nexport function hasTextImage(blocks: Block[]): boolean {\n const walk = (list: Block[]): boolean =>\n list.some(\n (b) =>\n b.type === 'image' ||\n ((b.type === 'bulletList' || b.type === 'orderedList') &&\n b.items.some((item) => walk(item.content))),\n );\n return walk(blocks);\n}\n\n/** One interleaved slot in a blog's body — either a block or a media item. */\nexport type InterleavedSlot =\n | { kind: 'block'; block: Block; index: number }\n | { kind: 'media'; media: EmbeddedMedia; index: number };\n\n/**\n * Walk `blocks` once, splicing in `media` at the positions returned by\n * `distributeMediaPositions`. Returns a flat array of typed slots that\n * `<BlogRenderer>` can map over directly. Exposed so consumers who need a\n * custom layout (e.g. wrapping each section in a `<section>`) can use the\n * same placement logic without re-implementing it. Media already placed in\n * the text as an `image` block is skipped (see `placedMediaIds`).\n */\nexport function interleaveMedia(\n blocks: Block[],\n media: EmbeddedMedia[] | undefined,\n): InterleavedSlot[] {\n const placed = placedMediaIds(blocks);\n const mediaList = (media ?? []).filter((m) => !placed.has(m.id));\n const positions = distributeMediaPositions(blocks.length, mediaList.length);\n\n const slots: InterleavedSlot[] = [];\n let mediaCursor = 0;\n for (let b = 0; b <= blocks.length; b++) {\n while (mediaCursor < mediaList.length && positions[mediaCursor] === b) {\n const media = mediaList[mediaCursor]!;\n slots.push({ kind: 'media', media, index: mediaCursor });\n mediaCursor++;\n }\n if (b < blocks.length) {\n const block = blocks[b]!;\n slots.push({ kind: 'block', block, index: b });\n }\n }\n return slots;\n}\n"],"mappings":"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","names":["media"]}
|
package/dist/index.cjs
CHANGED
|
@@ -30,13 +30,27 @@ __export(src_exports, {
|
|
|
30
30
|
distributeMediaPositions: () => distributeMediaPositions,
|
|
31
31
|
escapeXml: () => escapeXml,
|
|
32
32
|
filterRecentForNews: () => filterRecentForNews,
|
|
33
|
+
hasTextImage: () => hasTextImage,
|
|
33
34
|
interleaveMedia: () => interleaveMedia,
|
|
34
35
|
mergeBlogs: () => mergeBlogs,
|
|
36
|
+
placedMediaIds: () => placedMediaIds,
|
|
35
37
|
toBlogCard: () => toBlogCard
|
|
36
38
|
});
|
|
37
39
|
module.exports = __toCommonJS(src_exports);
|
|
38
40
|
|
|
39
41
|
// src/client.ts
|
|
42
|
+
var TRANSIENT_NETWORK_CODES = /* @__PURE__ */ new Set([
|
|
43
|
+
"EAI_AGAIN",
|
|
44
|
+
"ETIMEDOUT",
|
|
45
|
+
"ECONNRESET",
|
|
46
|
+
"UND_ERR_CONNECT_TIMEOUT",
|
|
47
|
+
"UND_ERR_SOCKET"
|
|
48
|
+
]);
|
|
49
|
+
var NETWORK_ATTEMPTS = 3;
|
|
50
|
+
function causeCode(err) {
|
|
51
|
+
const cause = err instanceof Error ? err.cause : void 0;
|
|
52
|
+
return cause && typeof cause === "object" && "code" in cause ? String(cause.code) : void 0;
|
|
53
|
+
}
|
|
40
54
|
function createClient(opts) {
|
|
41
55
|
const baseUrl = opts.apiUrl.replace(/\/$/, "");
|
|
42
56
|
const doFetch = opts.fetch ?? fetch;
|
|
@@ -52,24 +66,33 @@ function createClient(opts) {
|
|
|
52
66
|
}
|
|
53
67
|
});
|
|
54
68
|
let res;
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
if (res.status === 429) {
|
|
58
|
-
const waitSec = parseInt(res.headers.get("Retry-After") ?? "1", 10);
|
|
59
|
-
await new Promise(
|
|
60
|
-
(resolve) => setTimeout(resolve, Math.max(0, waitSec) * 1e3)
|
|
61
|
-
);
|
|
69
|
+
for (let attempt = 1; attempt <= NETWORK_ATTEMPTS; attempt++) {
|
|
70
|
+
try {
|
|
62
71
|
res = await doFetch(url, buildInit());
|
|
72
|
+
if (res.status === 429) {
|
|
73
|
+
const waitSec = parseInt(res.headers.get("Retry-After") ?? "1", 10);
|
|
74
|
+
await new Promise(
|
|
75
|
+
(resolve) => setTimeout(resolve, Math.max(0, waitSec) * 1e3)
|
|
76
|
+
);
|
|
77
|
+
res = await doFetch(url, buildInit());
|
|
78
|
+
}
|
|
79
|
+
break;
|
|
80
|
+
} catch (err) {
|
|
81
|
+
const code = causeCode(err);
|
|
82
|
+
if (attempt < NETWORK_ATTEMPTS && code !== void 0 && TRANSIENT_NETWORK_CODES.has(code)) {
|
|
83
|
+
await new Promise((resolve) => setTimeout(resolve, 250 * attempt));
|
|
84
|
+
continue;
|
|
85
|
+
}
|
|
86
|
+
const detail = code ? `${code}${err instanceof Error && err.message ? ` (${err.message})` : ""}` : err instanceof Error ? err.message : String(err);
|
|
87
|
+
const e = new Error(
|
|
88
|
+
`chaingrow-blog: could not reach ${method} ${url} \u2014 ${detail}. Set CHAINGROW_API_URL to override the API host (default https://api.chaingrow.de).`
|
|
89
|
+
);
|
|
90
|
+
e.cause = err;
|
|
91
|
+
throw e;
|
|
63
92
|
}
|
|
64
|
-
}
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
const detail = code ? `${code}${err instanceof Error && err.message ? ` (${err.message})` : ""}` : err instanceof Error ? err.message : String(err);
|
|
68
|
-
const e = new Error(
|
|
69
|
-
`chaingrow-blog: could not reach ${method} ${url} \u2014 ${detail}. Set CHAINGROW_API_URL to override the API host (default https://api.chaingrow.de).`
|
|
70
|
-
);
|
|
71
|
-
e.cause = err;
|
|
72
|
-
throw e;
|
|
93
|
+
}
|
|
94
|
+
if (!res) {
|
|
95
|
+
throw new Error(`chaingrow-blog: ${method} ${url} \u2014 no response`);
|
|
73
96
|
}
|
|
74
97
|
if (res.status === 404) return null;
|
|
75
98
|
if (!res.ok) {
|
|
@@ -183,8 +206,28 @@ function distributeMediaPositions(blockCount, mediaCount) {
|
|
|
183
206
|
(_, i) => Math.floor(i * blockCount / mediaCount)
|
|
184
207
|
);
|
|
185
208
|
}
|
|
209
|
+
function placedMediaIds(blocks) {
|
|
210
|
+
const ids = /* @__PURE__ */ new Set();
|
|
211
|
+
const walk = (list) => {
|
|
212
|
+
for (const b of list) {
|
|
213
|
+
if (b.type === "image" && b.mediaId) ids.add(b.mediaId);
|
|
214
|
+
else if (b.type === "bulletList" || b.type === "orderedList") {
|
|
215
|
+
for (const item of b.items) walk(item.content);
|
|
216
|
+
}
|
|
217
|
+
}
|
|
218
|
+
};
|
|
219
|
+
walk(blocks);
|
|
220
|
+
return ids;
|
|
221
|
+
}
|
|
222
|
+
function hasTextImage(blocks) {
|
|
223
|
+
const walk = (list) => list.some(
|
|
224
|
+
(b) => b.type === "image" || (b.type === "bulletList" || b.type === "orderedList") && b.items.some((item) => walk(item.content))
|
|
225
|
+
);
|
|
226
|
+
return walk(blocks);
|
|
227
|
+
}
|
|
186
228
|
function interleaveMedia(blocks, media) {
|
|
187
|
-
const
|
|
229
|
+
const placed = placedMediaIds(blocks);
|
|
230
|
+
const mediaList = (media ?? []).filter((m) => !placed.has(m.id));
|
|
188
231
|
const positions = distributeMediaPositions(blocks.length, mediaList.length);
|
|
189
232
|
const slots = [];
|
|
190
233
|
let mediaCursor = 0;
|
|
@@ -318,8 +361,10 @@ function mergeBlogs(chaingrow, extra = []) {
|
|
|
318
361
|
distributeMediaPositions,
|
|
319
362
|
escapeXml,
|
|
320
363
|
filterRecentForNews,
|
|
364
|
+
hasTextImage,
|
|
321
365
|
interleaveMedia,
|
|
322
366
|
mergeBlogs,
|
|
367
|
+
placedMediaIds,
|
|
323
368
|
toBlogCard
|
|
324
369
|
});
|
|
325
370
|
//# sourceMappingURL=index.cjs.map
|