@solutiondesk/blog 1.0.0-1edea54 → 1.0.0-2914fd8

package/README.md

@@ -31,7 +31,7 @@ const { post } = await blog.getPost("metadata-that-pays-off");
 | --- | --- | --- |
 | `listPosts({ lang, tag, author, limit, cursor })` | `GET /v1/blog/{workspace}/posts` | One page, newest first, without the text; `nextCursor` for the next page (`limit` 1–50, default 20). |
 | `allPosts({ lang, tag, author })` | the same, page by page | An async iterator over every published post, e.g. for a sitemap. |
-| `getPost(slug, { lang, redirect })` | `GET /v1/blog/{workspace}/posts/{slug}` | One post with `markdown`, `html`, `headings` and `readingMinutes`. |
+| `getPost(slug, { lang, redirect })` | `GET /v1/blog/{workspace}/posts/{slug}` | One post with `markdown`, `html`, `headings`, `readingMinutes` and the blog's own building blocks it uses (`customBlocks`, `blocks`). |
 | `listTags({ lang })` | `GET /v1/blog/{workspace}/tags` | Every tag with its label and how many published posts carry it. |
 | `listAuthors({ lang })` | `GET /v1/blog/{workspace}/authors` | Every author with their role. |
 | `getPreview(token, { lang })` | `GET /v1/blog/{workspace}/preview?token=` | The current state of a post, drafts too, for your preview route. |
@@ -83,6 +83,35 @@ export default async function PostPage({ params }: { params: Promise<{ slug: str
 
 Anything that runs on a server works the same way: Astro, Remix, SvelteKit, Nuxt or a plain Node script that renders your site at build time.
 
+## Your own building blocks
+
+In SolutionDesk, the blog can define its own building blocks under **Blog → Website**: what a block is called, whether it sits in a sentence, on its own line or around content, and which fields it has — a newsletter box, a product card, an app button. Writers add them to posts from **Block**. How a block looks is up to your website.
+
+In `html`, every such block is a neutral element with its **text version** (set in SolutionDesk, e.g. `Subscribe to Weekly tips`), so a page without your markup still reads well:
+
+| Kind | HTML |
+| --- | --- |
+| in a sentence | `<span class="sd-block" data-block="app-button" data-props="{…}">…</span>` |
+| on its own line | `<div class="sd-block" data-block="newsletter" data-props="{…}">…</div>` |
+| around content | `<div class="sd-block" …><p class="sd-block-text">…</p><div class="sd-block-body">…</div></div>` |
+
+`data-props` holds the block's field values as JSON, already checked the way SolutionDesk checks them: text fields as strings, on/off fields as `true`/`false`; a value that isn't valid (an unsafe address, a picture that isn't from your blog, an option that isn't offered) is left out. `post.customBlocks` names the blocks a post uses, `post.blocks` describes them (name, kind, fields, text version template).
+
+`renderBlogBlocks` swaps them for your own markup, by block name:
+
+```ts
+import { escapeBlogHtml, renderBlogBlocks } from "@solutiondesk/blog";
+
+const html = renderBlogBlocks(post.html, {
+  newsletter: ({ props }) =>
+    `<newsletter-signup list="${escapeBlogHtml(String(props.list ?? ""))}"></newsletter-signup>`,
+  aside: ({ props, childrenHtml }) =>
+    `<aside class="note"><h4>${escapeBlogHtml(String(props.title ?? ""))}</h4>${childrenHtml}</aside>`,
+});
+```
+
+Your renderer gets `block` (the name), `props`, `inline`, `textHtml` (the text version) and, for a block around content, `childrenHtml` (that content, with blocks inside already rendered). Return `undefined` to keep the neutral element. Values in `props` are raw text — escape them with `escapeBlogHtml` before putting them into HTML. A block without a renderer keeps its text version. With React, you can also hydrate your own components from `data-block` and `data-props` with an HTML parser of your choice.
+
 ## Moved articles
 
 When the team changes an article's address, the old slug answers with a `301` to the new one.

package/dist/index.cjs

@@ -257,6 +257,69 @@ async function parseWebhook(secret, rawBody, header, options = {}) {
   }
 }
 
+// src/blocks.ts
+function escapeBlogHtml(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
+function unescapeAttribute(value) {
+  return value.replace(/&quot;/g, '"').replace(/&#39;/g, "'").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&");
+}
+var OPEN = /<(span|div) class="sd-block" data-block="([^"]*)" data-props="([^"]*)">/g;
+function closingEnd(html, tag, from) {
+  const pattern = new RegExp(`<${tag}[\\s>]|</${tag}>`, "g");
+  pattern.lastIndex = from;
+  let depth = 1;
+  for (let match = pattern.exec(html); match; match = pattern.exec(html)) {
+    depth += match[0].startsWith("</") ? -1 : 1;
+    if (depth === 0) return match.index + match[0].length;
+  }
+  return html.length;
+}
+function parseProps(raw) {
+  try {
+    const parsed = JSON.parse(unescapeAttribute(raw));
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return {};
+    const props = {};
+    for (const [key, value] of Object.entries(parsed)) {
+      if (typeof value === "string" || typeof value === "boolean") props[key] = value;
+    }
+    return props;
+  } catch {
+    return {};
+  }
+}
+function renderBlogBlocks(html, renderers) {
+  let out = "";
+  let pos = 0;
+  OPEN.lastIndex = 0;
+  for (let open = OPEN.exec(html); open; open = OPEN.exec(html)) {
+    const [whole, tag = "div", name = "", rawProps = ""] = open;
+    const start = open.index;
+    const contentStart = start + whole.length;
+    const end = closingEnd(html, tag, contentStart);
+    const inner = html.slice(contentStart, end - `</${tag}>`.length);
+    const body = /^(?:<p class="sd-block-text">([\s\S]*?)<\/p>)?<div class="sd-block-body">([\s\S]*)<\/div>$/.exec(
+      inner
+    );
+    const element = {
+      block: unescapeAttribute(name),
+      props: parseProps(rawProps),
+      inline: tag === "span",
+      textHtml: body ? body[1] ?? "" : inner,
+      childrenHtml: body ? renderBlogBlocks(body[2] ?? "", renderers) : null
+    };
+    const own = renderers[element.block]?.(element);
+    out += html.slice(pos, start);
+    if (own !== void 0) out += own;
+    else if (body) {
+      out += `${whole}${body[1] !== void 0 ? `<p class="sd-block-text">${body[1]}</p>` : ""}<div class="sd-block-body">${element.childrenHtml}</div></${tag}>`;
+    } else out += html.slice(start, end);
+    pos = end;
+    OPEN.lastIndex = end;
+  }
+  return out + html.slice(pos);
+}
+
 // src/client.ts
 function createBlogClient(options) {
   const workspace = required(options.workspace, "workspace");
@@ -350,7 +413,9 @@ exports.SIGNATURE_HEADER = SIGNATURE_HEADER;
 exports.SolutionDeskError = SolutionDeskError;
 exports.createBlogClient = createBlogClient;
 exports.createMemoryEtagCache = createMemoryEtagCache;
+exports.escapeBlogHtml = escapeBlogHtml;
 exports.imageUrl = imageUrl;
 exports.imageWidthFor = imageWidthFor;
 exports.parseBlogWebhook = parseBlogWebhook;
+exports.renderBlogBlocks = renderBlogBlocks;
 exports.verifyWebhookSignature = verifyWebhookSignature;

package/dist/index.d.cts

@@ -144,6 +144,56 @@ type WebhookBody = string | Uint8Array | ArrayBuffer;
  */
 declare function verifyWebhookSignature(secret: string, rawBody: WebhookBody, header: string | null | undefined, options?: VerifyWebhookOptions): Promise<boolean>;
 
+/**
+ * The blog's own building blocks in a post's `html` (contract in SolutionDesk's
+ * `docs/help/06-eigene-bausteine.md`): the API renders each one as a neutral
+ * element — `<span class="sd-block" data-block="…" data-props="…">` in a
+ * sentence, `<div class="sd-block" …>` on its own line, and around content
+ * `<div class="sd-block" …><p class="sd-block-text">…</p><div class="sd-block-body">…</div></div>`.
+ * The text inside is the block's text version; `data-props` its checked field
+ * values as JSON. `renderBlogBlocks` swaps them for your own markup.
+ */
+/** A field's checked value: `boolean` fields are true/false, every other type a string. */
+type BlogBlockValue = string | boolean;
+/** One block found in the HTML, handed to your renderer. */
+interface BlogBlockElement {
+    /** The block's name (`newsletter-box`). */
+    block: string;
+    /**
+     * Its field values, already checked by SolutionDesk (an invalid value is left
+     * out, so every field may be missing). Strings are raw text — escape them
+     * (`escapeBlogHtml`) when you put them into HTML.
+     */
+    props: Record<string, BlogBlockValue>;
+    /** `inline` (a `<span>` in a sentence) or a `<div>` (`block` or `container`). */
+    inline: boolean;
+    /** The text version as HTML (escaped), what the element shows without your markup. */
+    textHtml: string;
+    /**
+     * For a block around content: that content as HTML (own blocks inside are
+     * already rendered); otherwise null.
+     */
+    childrenHtml: string | null;
+}
+/** Your markup for a block, as HTML; `undefined` keeps SolutionDesk's neutral element. */
+type BlogBlockRenderer = (element: BlogBlockElement) => string | undefined;
+/** `&`, `<`, `>`, `"` and `'` as character references. */
+declare function escapeBlogHtml(value: string): string;
+/**
+ * The post's `html` with the blog's own blocks rendered by `renderers` (by
+ * block name). A block without a renderer — or whose renderer returns
+ * `undefined` — keeps the neutral element with its text version. Blocks inside
+ * a container are rendered first and reach its renderer in `childrenHtml`.
+ *
+ * ```ts
+ * const html = renderBlogBlocks(post.html, {
+ *   "newsletter-box": ({ props }) =>
+ *     `<newsletter-form list="${escapeBlogHtml(String(props.list ?? ""))}"></newsletter-form>`,
+ * });
+ * ```
+ */
+declare function renderBlogBlocks(html: string, renderers: Readonly<Record<string, BlogBlockRenderer>>): string;
+
 /**
  * The answers of the public blog API (`GET /v1/blog/{workspace}/…`). Written by
  * hand so the package has no dependencies; a drift test in the SolutionDesk
@@ -212,13 +262,52 @@ interface PublicBlogPostSummary {
     languages: string[];
     readingMinutes: number;
 }
+/** What a field of one of the blog's own blocks holds. */
+type PublicBlogBlockFieldType = "text" | "longText" | "icon" | "url" | "choice" | "image" | "video" | "boolean";
+/**
+ * One field of a block: an attribute of its directive (`key="value"`).
+ * `boolean` fields are true/false, every other value a string. `options` lists
+ * a `choice` field's values (null for other types).
+ */
+interface PublicBlogBlockField {
+    key: string;
+    label: string;
+    type: PublicBlogBlockFieldType;
+    required: boolean;
+    options: string[] | null;
+}
+/**
+ * A building block the blog defines itself — WHAT it is; how it looks is your
+ * website's own component. Written in Markdown as `:name[label]{…}` in running
+ * text (`inline`), `::name[label]{…}` alone on a line (`block`) or
+ * `:::name{…}` … `:::` around content (`container`). `text` is the template of
+ * its text version (`{key}` = a field's value).
+ */
+interface PublicBlogBlockDefinition {
+    /** The directive name (`newsletter-box`). */
+    name: string;
+    /** Display name. */
+    label: string;
+    kind: "inline" | "block" | "container";
+    fields: PublicBlogBlockField[];
+    text: string;
+}
 /** One post with its text. */
 interface PublicBlogPost extends PublicBlogPostSummary {
+    /** The post's Markdown, the blog's own building blocks as written (see `blocks`). */
     markdown: string;
-    /** The Markdown as safe HTML (headings carry `id`s). */
+    /**
+     * The Markdown as safe HTML (headings carry `id`s). The blog's own blocks are
+     * neutral `sd-block` elements: `data-block` the name, `data-props` the checked
+     * values as JSON, the text version inside — see `renderBlogBlocks`.
+     */
     html: string;
     /** The outline, for a table of contents. */
     headings: BlogHeading[];
+    /** The blog's own building blocks the post uses, by name (in the blog's order). */
+    customBlocks: string[];
+    /** The definitions of those blocks (empty when the post uses none). */
+    blocks: PublicBlogBlockDefinition[];
     closing: PublicBlogClosing | null;
 }
 /** `GET …/posts`. */
@@ -346,4 +435,4 @@ declare function createBlogClient(options: BlogClientOptions): BlogClient;
  */
 declare function parseBlogWebhook(secret: string, rawBody: WebhookBody, signatureHeader: string | null | undefined, options?: VerifyWebhookOptions): Promise<BlogWebhookBody | null>;
 
-export { type BaseClientOptions, type BlogClient, type BlogClientOptions, type BlogHeading, type BlogPostMoved, type BlogPostResult, type BlogWebhookBody, type BlogWebhookEvent, type CachedResponse, DEFAULT_BASE_URL, EVENT_HEADER, type EtagCache, type FetchInitLike, type FetchLike, type FetchResponseLike, type GetPostParams, IMAGE_WIDTHS, type ImageWidth, type LangParams, type ListPostsParams, type PublicBlogAuthor, type PublicBlogAuthorsPayload, type PublicBlogClosing, type PublicBlogImage, type PublicBlogPost, type PublicBlogPostPayload, type PublicBlogPostSummary, type PublicBlogPostsPayload, type PublicBlogTag, type PublicBlogTagsPayload, type RequestOptions, SIGNATURE_HEADER, SolutionDeskError, type VerifyWebhookOptions, type WebhookBody, createBlogClient, createMemoryEtagCache, imageUrl, imageWidthFor, parseBlogWebhook, verifyWebhookSignature };
+export { type BaseClientOptions, type BlogBlockElement, type BlogBlockRenderer, type BlogBlockValue, type BlogClient, type BlogClientOptions, type BlogHeading, type BlogPostMoved, type BlogPostResult, type BlogWebhookBody, type BlogWebhookEvent, type CachedResponse, DEFAULT_BASE_URL, EVENT_HEADER, type EtagCache, type FetchInitLike, type FetchLike, type FetchResponseLike, type GetPostParams, IMAGE_WIDTHS, type ImageWidth, type LangParams, type ListPostsParams, type PublicBlogAuthor, type PublicBlogAuthorsPayload, type PublicBlogBlockDefinition, type PublicBlogBlockField, type PublicBlogBlockFieldType, type PublicBlogClosing, type PublicBlogImage, type PublicBlogPost, type PublicBlogPostPayload, type PublicBlogPostSummary, type PublicBlogPostsPayload, type PublicBlogTag, type PublicBlogTagsPayload, type RequestOptions, SIGNATURE_HEADER, SolutionDeskError, type VerifyWebhookOptions, type WebhookBody, createBlogClient, createMemoryEtagCache, escapeBlogHtml, imageUrl, imageWidthFor, parseBlogWebhook, renderBlogBlocks, verifyWebhookSignature };

package/dist/index.d.ts

@@ -144,6 +144,56 @@ type WebhookBody = string | Uint8Array | ArrayBuffer;
  */
 declare function verifyWebhookSignature(secret: string, rawBody: WebhookBody, header: string | null | undefined, options?: VerifyWebhookOptions): Promise<boolean>;
 
+/**
+ * The blog's own building blocks in a post's `html` (contract in SolutionDesk's
+ * `docs/help/06-eigene-bausteine.md`): the API renders each one as a neutral
+ * element — `<span class="sd-block" data-block="…" data-props="…">` in a
+ * sentence, `<div class="sd-block" …>` on its own line, and around content
+ * `<div class="sd-block" …><p class="sd-block-text">…</p><div class="sd-block-body">…</div></div>`.
+ * The text inside is the block's text version; `data-props` its checked field
+ * values as JSON. `renderBlogBlocks` swaps them for your own markup.
+ */
+/** A field's checked value: `boolean` fields are true/false, every other type a string. */
+type BlogBlockValue = string | boolean;
+/** One block found in the HTML, handed to your renderer. */
+interface BlogBlockElement {
+    /** The block's name (`newsletter-box`). */
+    block: string;
+    /**
+     * Its field values, already checked by SolutionDesk (an invalid value is left
+     * out, so every field may be missing). Strings are raw text — escape them
+     * (`escapeBlogHtml`) when you put them into HTML.
+     */
+    props: Record<string, BlogBlockValue>;
+    /** `inline` (a `<span>` in a sentence) or a `<div>` (`block` or `container`). */
+    inline: boolean;
+    /** The text version as HTML (escaped), what the element shows without your markup. */
+    textHtml: string;
+    /**
+     * For a block around content: that content as HTML (own blocks inside are
+     * already rendered); otherwise null.
+     */
+    childrenHtml: string | null;
+}
+/** Your markup for a block, as HTML; `undefined` keeps SolutionDesk's neutral element. */
+type BlogBlockRenderer = (element: BlogBlockElement) => string | undefined;
+/** `&`, `<`, `>`, `"` and `'` as character references. */
+declare function escapeBlogHtml(value: string): string;
+/**
+ * The post's `html` with the blog's own blocks rendered by `renderers` (by
+ * block name). A block without a renderer — or whose renderer returns
+ * `undefined` — keeps the neutral element with its text version. Blocks inside
+ * a container are rendered first and reach its renderer in `childrenHtml`.
+ *
+ * ```ts
+ * const html = renderBlogBlocks(post.html, {
+ *   "newsletter-box": ({ props }) =>
+ *     `<newsletter-form list="${escapeBlogHtml(String(props.list ?? ""))}"></newsletter-form>`,
+ * });
+ * ```
+ */
+declare function renderBlogBlocks(html: string, renderers: Readonly<Record<string, BlogBlockRenderer>>): string;
+
 /**
  * The answers of the public blog API (`GET /v1/blog/{workspace}/…`). Written by
  * hand so the package has no dependencies; a drift test in the SolutionDesk
@@ -212,13 +262,52 @@ interface PublicBlogPostSummary {
     languages: string[];
     readingMinutes: number;
 }
+/** What a field of one of the blog's own blocks holds. */
+type PublicBlogBlockFieldType = "text" | "longText" | "icon" | "url" | "choice" | "image" | "video" | "boolean";
+/**
+ * One field of a block: an attribute of its directive (`key="value"`).
+ * `boolean` fields are true/false, every other value a string. `options` lists
+ * a `choice` field's values (null for other types).
+ */
+interface PublicBlogBlockField {
+    key: string;
+    label: string;
+    type: PublicBlogBlockFieldType;
+    required: boolean;
+    options: string[] | null;
+}
+/**
+ * A building block the blog defines itself — WHAT it is; how it looks is your
+ * website's own component. Written in Markdown as `:name[label]{…}` in running
+ * text (`inline`), `::name[label]{…}` alone on a line (`block`) or
+ * `:::name{…}` … `:::` around content (`container`). `text` is the template of
+ * its text version (`{key}` = a field's value).
+ */
+interface PublicBlogBlockDefinition {
+    /** The directive name (`newsletter-box`). */
+    name: string;
+    /** Display name. */
+    label: string;
+    kind: "inline" | "block" | "container";
+    fields: PublicBlogBlockField[];
+    text: string;
+}
 /** One post with its text. */
 interface PublicBlogPost extends PublicBlogPostSummary {
+    /** The post's Markdown, the blog's own building blocks as written (see `blocks`). */
     markdown: string;
-    /** The Markdown as safe HTML (headings carry `id`s). */
+    /**
+     * The Markdown as safe HTML (headings carry `id`s). The blog's own blocks are
+     * neutral `sd-block` elements: `data-block` the name, `data-props` the checked
+     * values as JSON, the text version inside — see `renderBlogBlocks`.
+     */
     html: string;
     /** The outline, for a table of contents. */
     headings: BlogHeading[];
+    /** The blog's own building blocks the post uses, by name (in the blog's order). */
+    customBlocks: string[];
+    /** The definitions of those blocks (empty when the post uses none). */
+    blocks: PublicBlogBlockDefinition[];
     closing: PublicBlogClosing | null;
 }
 /** `GET …/posts`. */
@@ -346,4 +435,4 @@ declare function createBlogClient(options: BlogClientOptions): BlogClient;
  */
 declare function parseBlogWebhook(secret: string, rawBody: WebhookBody, signatureHeader: string | null | undefined, options?: VerifyWebhookOptions): Promise<BlogWebhookBody | null>;
 
-export { type BaseClientOptions, type BlogClient, type BlogClientOptions, type BlogHeading, type BlogPostMoved, type BlogPostResult, type BlogWebhookBody, type BlogWebhookEvent, type CachedResponse, DEFAULT_BASE_URL, EVENT_HEADER, type EtagCache, type FetchInitLike, type FetchLike, type FetchResponseLike, type GetPostParams, IMAGE_WIDTHS, type ImageWidth, type LangParams, type ListPostsParams, type PublicBlogAuthor, type PublicBlogAuthorsPayload, type PublicBlogClosing, type PublicBlogImage, type PublicBlogPost, type PublicBlogPostPayload, type PublicBlogPostSummary, type PublicBlogPostsPayload, type PublicBlogTag, type PublicBlogTagsPayload, type RequestOptions, SIGNATURE_HEADER, SolutionDeskError, type VerifyWebhookOptions, type WebhookBody, createBlogClient, createMemoryEtagCache, imageUrl, imageWidthFor, parseBlogWebhook, verifyWebhookSignature };
+export { type BaseClientOptions, type BlogBlockElement, type BlogBlockRenderer, type BlogBlockValue, type BlogClient, type BlogClientOptions, type BlogHeading, type BlogPostMoved, type BlogPostResult, type BlogWebhookBody, type BlogWebhookEvent, type CachedResponse, DEFAULT_BASE_URL, EVENT_HEADER, type EtagCache, type FetchInitLike, type FetchLike, type FetchResponseLike, type GetPostParams, IMAGE_WIDTHS, type ImageWidth, type LangParams, type ListPostsParams, type PublicBlogAuthor, type PublicBlogAuthorsPayload, type PublicBlogBlockDefinition, type PublicBlogBlockField, type PublicBlogBlockFieldType, type PublicBlogClosing, type PublicBlogImage, type PublicBlogPost, type PublicBlogPostPayload, type PublicBlogPostSummary, type PublicBlogPostsPayload, type PublicBlogTag, type PublicBlogTagsPayload, type RequestOptions, SIGNATURE_HEADER, SolutionDeskError, type VerifyWebhookOptions, type WebhookBody, createBlogClient, createMemoryEtagCache, escapeBlogHtml, imageUrl, imageWidthFor, parseBlogWebhook, renderBlogBlocks, verifyWebhookSignature };

package/dist/index.js

@@ -255,6 +255,69 @@ async function parseWebhook(secret, rawBody, header, options = {}) {
   }
 }
 
+// src/blocks.ts
+function escapeBlogHtml(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
+function unescapeAttribute(value) {
+  return value.replace(/&quot;/g, '"').replace(/&#39;/g, "'").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&");
+}
+var OPEN = /<(span|div) class="sd-block" data-block="([^"]*)" data-props="([^"]*)">/g;
+function closingEnd(html, tag, from) {
+  const pattern = new RegExp(`<${tag}[\\s>]|</${tag}>`, "g");
+  pattern.lastIndex = from;
+  let depth = 1;
+  for (let match = pattern.exec(html); match; match = pattern.exec(html)) {
+    depth += match[0].startsWith("</") ? -1 : 1;
+    if (depth === 0) return match.index + match[0].length;
+  }
+  return html.length;
+}
+function parseProps(raw) {
+  try {
+    const parsed = JSON.parse(unescapeAttribute(raw));
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return {};
+    const props = {};
+    for (const [key, value] of Object.entries(parsed)) {
+      if (typeof value === "string" || typeof value === "boolean") props[key] = value;
+    }
+    return props;
+  } catch {
+    return {};
+  }
+}
+function renderBlogBlocks(html, renderers) {
+  let out = "";
+  let pos = 0;
+  OPEN.lastIndex = 0;
+  for (let open = OPEN.exec(html); open; open = OPEN.exec(html)) {
+    const [whole, tag = "div", name = "", rawProps = ""] = open;
+    const start = open.index;
+    const contentStart = start + whole.length;
+    const end = closingEnd(html, tag, contentStart);
+    const inner = html.slice(contentStart, end - `</${tag}>`.length);
+    const body = /^(?:<p class="sd-block-text">([\s\S]*?)<\/p>)?<div class="sd-block-body">([\s\S]*)<\/div>$/.exec(
+      inner
+    );
+    const element = {
+      block: unescapeAttribute(name),
+      props: parseProps(rawProps),
+      inline: tag === "span",
+      textHtml: body ? body[1] ?? "" : inner,
+      childrenHtml: body ? renderBlogBlocks(body[2] ?? "", renderers) : null
+    };
+    const own = renderers[element.block]?.(element);
+    out += html.slice(pos, start);
+    if (own !== void 0) out += own;
+    else if (body) {
+      out += `${whole}${body[1] !== void 0 ? `<p class="sd-block-text">${body[1]}</p>` : ""}<div class="sd-block-body">${element.childrenHtml}</div></${tag}>`;
+    } else out += html.slice(start, end);
+    pos = end;
+    OPEN.lastIndex = end;
+  }
+  return out + html.slice(pos);
+}
+
 // src/client.ts
 function createBlogClient(options) {
   const workspace = required(options.workspace, "workspace");
@@ -341,4 +404,4 @@ function parseBlogWebhook(secret, rawBody, signatureHeader, options) {
   return parseWebhook(secret, rawBody, signatureHeader, options);
 }
 
-export { DEFAULT_BASE_URL, EVENT_HEADER, IMAGE_WIDTHS, SIGNATURE_HEADER, SolutionDeskError, createBlogClient, createMemoryEtagCache, imageUrl, imageWidthFor, parseBlogWebhook, verifyWebhookSignature };
+export { DEFAULT_BASE_URL, EVENT_HEADER, IMAGE_WIDTHS, SIGNATURE_HEADER, SolutionDeskError, createBlogClient, createMemoryEtagCache, escapeBlogHtml, imageUrl, imageWidthFor, parseBlogWebhook, renderBlogBlocks, verifyWebhookSignature };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solutiondesk/blog",
-  "version": "1.0.0-1edea54",
+  "version": "1.0.0-2914fd8",
   "description": "Typed, zero-dependency client for the SolutionDesk public blog API: posts, tags, authors, previews and webhook verification.",
   "keywords": [
     "solutiondesk",