@mailoo/blog 0.0.0-stage → 1.33.0

package/LICENSE

@@ -0,0 +1,16 @@
+Mailoo Integrator Use License
+
+Copyright (c) 2026 Mailoo
+
+Permission is granted to use, install, and distribute this software in
+unmodified form, including as a dependency of an application.
+
+Modification of this software is not permitted.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,143 @@
-# Temporary Holding Version
+# `@mailoo/blog`
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Headless Mailoo Blog module for Next.js apps.
+
+## Install
+
+```bash
+pnpm add @mailoo/blog @mailoo/next-core
+```
+
+## Env (server-only)
+
+```
+MAILOO_BLOG_API=
+MAILOO_BLOG_API_KEY=
+MAILOO_BLOG_PROJECT_UID=
+MAILOO_BLOG_INTEGRATION_ID=
+```
+
+The API key needs `blog.external-read` for GET routes, `blog.article-mark`
+for like/dislike/feedback POST routes, and `image.external-read` when the
+host proxies cover/body images (or FULL).
+
+Pass `imageProxyPrefixWithIdEquals` so list, slug, category description, and
+JSON-LD image URLs point at your BFF instead of the canonical Mailoo embed
+URL (that URL is **401** without `X-API-Key`):
+
+```ts
+const client = createMailooBlogClient(config, {
+  imageProxyPrefixWithIdEquals: '/api/v1/images/public/content?id=',
+})
+```
+
+Mount `createPublicImageContentHandler` from `@mailoo/images/routes` on that
+path. Omit the option to keep canonical URLs for server-only callers.
+`rewriteMailooBlogMediaUrls` does the same rewrite for a single article.
+
+## Usage
+
+### BFF routes
+
+```ts
+// app/api/v1/blog/route.ts
+import { createBlogListHandler } from '@mailoo/blog/routes'
+export const GET = createBlogListHandler()
+```
+
+```ts
+// app/api/v1/blog/slug/[slug]/route.ts
+import { createBlogSlugHandler } from '@mailoo/blog/routes'
+export const GET = createBlogSlugHandler()
+```
+
+```ts
+// app/api/v1/blog/slug/[slug]/json-ld/route.ts
+import { createBlogJsonLdHandler } from '@mailoo/blog/routes'
+export const GET = createBlogJsonLdHandler()
+```
+
+```ts
+// app/api/v1/blog/slug/[slug]/reaction/route.ts
+import { createBlogReactionHandler } from '@mailoo/blog/routes'
+export const POST = createBlogReactionHandler()
+```
+
+```ts
+// app/api/v1/blog/slug/[slug]/feedback/route.ts
+import { createBlogFeedbackHandler } from '@mailoo/blog/routes'
+export const POST = createBlogFeedbackHandler()
+```
+
+### Server client / RSC helpers
+
+```ts
+import {
+  createMailooBlogClient,
+  getMailooBlogConfigFromEnv,
+  fetchBlogPostBySlug,
+} from '@mailoo/blog/server'
+
+const config = getMailooBlogConfigFromEnv()
+if (config) {
+  const client = createMailooBlogClient(config)
+  const list = await client.listPosts({ limit: 20, locale })
+  if (list.ok) {
+    const posts = list.data
+    const { pagination, imagePublicEmbedBaseUrl } = list
+  }
+  const post = await client.getPostBySlug(slug, locale)
+  // Slug detail includes likeCount / dislikeCount / feedbackCount
+  const jsonLd = await client.getPostJsonLd(slug, locale)
+  await client.setReaction(slug, {
+    visitorKey,
+    action: 'set',
+    sentiment: 'LIKE',
+  })
+  await client.setFeedback(slug, {
+    visitorKey,
+    action: 'set',
+    comment: 'Helpful article',
+  })
+}
+```
+
+Use `createMailooBlogClient` (direct Mailoo API) from RSC, sitemap, and
+other server jobs so they never loop back to the host BFF. Direct client
+fetches use Next.js `next: { revalidate: 60 }` by default; pass
+`{ revalidate: 0 }` (or another number) as the last argument to override.
+`listPosts` keeps the API list envelope: `data` (posts array),
+`pagination`, and `imagePublicEmbedBaseUrl`. Use
+`fetchBlogPostBySlug` / `fetchBlogPostJsonLd` only when calling the
+same-origin BFF from the browser or another same-origin path.
+`setReaction` / `setFeedback` always POST without ISR cache.
+
+### Components
+
+```tsx
+import {
+  BlogArticleBody,
+  BlogLinkedLinksDisplay,
+  BlogPrintableButtons,
+  BlogArticleMarks,
+  BlogArticleShare,
+} from '@mailoo/blog/client'
+```
+
+`BlogArticleMarks` POSTs to same-origin BFF (`/api/v1/blog/slug/.../reaction|feedback`),
+shows public counts, and stores visitor state in `localStorage`. Pass i18n labels
+from the host.
+
+`BlogArticleShare` renders X / Facebook / LinkedIn / copy-link controls. Pass
+interpolated `text`, i18n `labels`, and optional absolute `url` (when omitted,
+clicks use `origin + pathname`). Subpath: `@mailoo/blog/client/share`.
+
+Host app owns locale routing, i18n strings, theme, and page layouts.
+
+## Host: errors must not take down the app
+
+`createMailooBlogClient` methods return `{ ok: false, status }` on network /
+upstream failure — they **never throw**. Check `ok` before rendering. Prefer
+feature-local error UI over crashing the page. Do not call the blog client
+from root `layout.tsx`. Article pages: use `notFound()` only for HTTP 404;
+other failures should show an in-page error (HTTP 200).

package/dist/client/article-body.cjs

@@ -0,0 +1,115 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/blog-article-body.tsx
+var blog_article_body_exports = {};
+__export(blog_article_body_exports, {
+  BlogArticleBody: () => BlogArticleBody
+});
+module.exports = __toCommonJS(blog_article_body_exports);
+var import_react_markdown = __toESM(require("react-markdown"), 1);
+var import_remark_gfm = __toESM(require("remark-gfm"), 1);
+
+// src/markdown-link-target.ts
+function markdownHrefOpensInNewTab(href) {
+  const h = href.trim();
+  if (h === "") return false;
+  if (h.startsWith("#") || h.startsWith("?")) return false;
+  if (h.startsWith("//")) return true;
+  if (h.startsWith("/")) return false;
+  if (h.startsWith("./") || h.startsWith("../")) return false;
+  const lower = h.toLowerCase();
+  return lower.startsWith("http://") || lower.startsWith("https://");
+}
+
+// src/server/utils.ts
+var BLOG_ARTICLE_PROSE_CLASSNAME = [
+  "prose",
+  "prose-gray",
+  "prose-lg",
+  "max-w-none",
+  "dark:prose-invert",
+  "prose-a:text-blue-600",
+  "hover:prose-a:text-blue-700",
+  "dark:prose-a:text-blue-400",
+  "dark:hover:prose-a:text-blue-300",
+  "prose-blockquote:border-blue-500",
+  "prose-img:rounded-lg",
+  "prose-img:shadow-sm"
+].join(" ");
+
+// src/components/blog-article-body.tsx
+var import_jsx_runtime = require("react/jsx-runtime");
+function BlogArticleBody({
+  htmlContent,
+  markdownFallback,
+  className = BLOG_ARTICLE_PROSE_CLASSNAME
+}) {
+  const html = htmlContent?.trim();
+  if (html) {
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+      "div",
+      {
+        className,
+        dangerouslySetInnerHTML: { __html: html }
+      }
+    );
+  }
+  const md = markdownFallback?.trim();
+  if (md) {
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className, children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+      import_react_markdown.default,
+      {
+        remarkPlugins: [import_remark_gfm.default],
+        components: {
+          a({ children, href, ...props }) {
+            const h = href ?? "";
+            const openNew = markdownHrefOpensInNewTab(h);
+            return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+              "a",
+              {
+                href: h,
+                ...openNew ? { target: "_blank", rel: "noopener noreferrer" } : {},
+                ...props,
+                children
+              }
+            );
+          }
+        },
+        children: md
+      }
+    ) });
+  }
+  return null;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BlogArticleBody
+});
+//# sourceMappingURL=article-body.cjs.map

package/dist/client/article-body.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/components/blog-article-body.tsx","../../src/markdown-link-target.ts","../../src/server/utils.ts"],"sourcesContent":["import ReactMarkdown from 'react-markdown'\nimport remarkGfm from 'remark-gfm'\nimport { markdownHrefOpensInNewTab } from '../markdown-link-target.js'\nimport { BLOG_ARTICLE_PROSE_CLASSNAME } from '../server/utils.js'\n\nexport interface BlogArticleBodyProps {\n  htmlContent?: string | null\n  markdownFallback?: string | null\n  /** Override default Tailwind Typography classes */\n  className?: string\n}\n\n/**\n * Renders blog article body: prefers `htmlContent` from the headless API,\n * falls back to Markdown when `htmlContent` is empty.\n */\nexport function BlogArticleBody({\n  htmlContent,\n  markdownFallback,\n  className = BLOG_ARTICLE_PROSE_CLASSNAME,\n}: BlogArticleBodyProps) {\n  const html = htmlContent?.trim()\n  if (html) {\n    return (\n      <div\n        className={className}\n        dangerouslySetInnerHTML={{ __html: html }}\n      />\n    )\n  }\n\n  const md = markdownFallback?.trim()\n  if (md) {\n    return (\n      <div className={className}>\n        <ReactMarkdown\n          remarkPlugins={[remarkGfm]}\n          components={{\n            a({ children, href, ...props }) {\n              const h = href ?? ''\n              const openNew = markdownHrefOpensInNewTab(h)\n              return (\n                <a\n                  href={h}\n                  {...(openNew\n                    ? { target: '_blank', rel: 'noopener noreferrer' }\n                    : {})}\n                  {...props}\n                >\n                  {children}\n                </a>\n              )\n            },\n          }}\n        >\n          {md}\n        </ReactMarkdown>\n      </div>\n    )\n  }\n\n  return null\n}\n","export function markdownHrefOpensInNewTab(href: string): boolean {\n  const h = href.trim()\n  if (h === '') return false\n  if (h.startsWith('#') || h.startsWith('?')) return false\n  if (h.startsWith('//')) return true\n  if (h.startsWith('/')) return false\n  if (h.startsWith('./') || h.startsWith('../')) return false\n  const lower = h.toLowerCase()\n  return lower.startsWith('http://') || lower.startsWith('https://')\n}\n","/**\n * First absolute image URL for OG/Twitter previews: prefer HTML from the API,\n * then markdown image syntax in content.\n */\nconst HTML_IMG_SRC = /<img[^>]+src=[\"']([^\"']+)[\"']/i\nconst MD_IMAGE = /!\\[[^\\]]*]\\(([^)\\s]+)\\)/\n\nfunction normalizeUrl(raw: string): string | null {\n  const u = raw.trim()\n  if (!u) return null\n  if (\n    u.startsWith('http://') ||\n    u.startsWith('https://') ||\n    u.startsWith('/')\n  ) {\n    return u\n  }\n  return null\n}\n\nexport function firstEmbedImageUrlFromArticle(\n  htmlContent: string | null | undefined,\n  markdownContent: string | null | undefined\n): string | null {\n  if (htmlContent) {\n    const m = htmlContent.match(HTML_IMG_SRC)\n    if (m?.[1]) {\n      const url = normalizeUrl(m[1])\n      if (url) return url\n    }\n  }\n  if (markdownContent) {\n    const m = markdownContent.match(MD_IMAGE)\n    if (m?.[1]) {\n      const url = normalizeUrl(m[1])\n      if (url) return url\n    }\n  }\n  return null\n}\n\n/**\n * Default Tailwind Typography class string for article body.\n * Hosts may pass a custom `className` instead.\n */\nexport const BLOG_ARTICLE_PROSE_CLASSNAME = [\n  'prose',\n  'prose-gray',\n  'prose-lg',\n  'max-w-none',\n  'dark:prose-invert',\n  'prose-a:text-blue-600',\n  'hover:prose-a:text-blue-700',\n  'dark:prose-a:text-blue-400',\n  'dark:hover:prose-a:text-blue-300',\n  'prose-blockquote:border-blue-500',\n  'prose-img:rounded-lg',\n  'prose-img:shadow-sm',\n].join(' ')\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,4BAA0B;AAC1B,wBAAsB;;;ACDf,SAAS,0BAA0B,MAAuB;AAC/D,QAAM,IAAI,KAAK,KAAK;AACpB,MAAI,MAAM,GAAI,QAAO;AACrB,MAAI,EAAE,WAAW,GAAG,KAAK,EAAE,WAAW,GAAG,EAAG,QAAO;AACnD,MAAI,EAAE,WAAW,IAAI,EAAG,QAAO;AAC/B,MAAI,EAAE,WAAW,GAAG,EAAG,QAAO;AAC9B,MAAI,EAAE,WAAW,IAAI,KAAK,EAAE,WAAW,KAAK,EAAG,QAAO;AACtD,QAAM,QAAQ,EAAE,YAAY;AAC5B,SAAO,MAAM,WAAW,SAAS,KAAK,MAAM,WAAW,UAAU;AACnE;;;ACoCO,IAAM,+BAA+B;AAAA,EAC1C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,EAAE,KAAK,GAAG;;;AFlCJ;AARC,SAAS,gBAAgB;AAAA,EAC9B;AAAA,EACA;AAAA,EACA,YAAY;AACd,GAAyB;AACvB,QAAM,OAAO,aAAa,KAAK;AAC/B,MAAI,MAAM;AACR,WACE;AAAA,MAAC;AAAA;AAAA,QACC;AAAA,QACA,yBAAyB,EAAE,QAAQ,KAAK;AAAA;AAAA,IAC1C;AAAA,EAEJ;AAEA,QAAM,KAAK,kBAAkB,KAAK;AAClC,MAAI,IAAI;AACN,WACE,4CAAC,SAAI,WACH;AAAA,MAAC,sBAAAA;AAAA,MAAA;AAAA,QACC,eAAe,CAAC,kBAAAC,OAAS;AAAA,QACzB,YAAY;AAAA,UACV,EAAE,EAAE,UAAU,MAAM,GAAG,MAAM,GAAG;AAC9B,kBAAM,IAAI,QAAQ;AAClB,kBAAM,UAAU,0BAA0B,CAAC;AAC3C,mBACE;AAAA,cAAC;AAAA;AAAA,gBACC,MAAM;AAAA,gBACL,GAAI,UACD,EAAE,QAAQ,UAAU,KAAK,sBAAsB,IAC/C,CAAC;AAAA,gBACJ,GAAG;AAAA,gBAEH;AAAA;AAAA,YACH;AAAA,UAEJ;AAAA,QACF;AAAA,QAEC;AAAA;AAAA,IACH,GACF;AAAA,EAEJ;AAEA,SAAO;AACT;","names":["ReactMarkdown","remarkGfm"]}

package/dist/client/article-body.d.cts

@@ -0,0 +1,15 @@
+import * as react from 'react';
+
+interface BlogArticleBodyProps {
+    htmlContent?: string | null;
+    markdownFallback?: string | null;
+    /** Override default Tailwind Typography classes */
+    className?: string;
+}
+/**
+ * Renders blog article body: prefers `htmlContent` from the headless API,
+ * falls back to Markdown when `htmlContent` is empty.
+ */
+declare function BlogArticleBody({ htmlContent, markdownFallback, className, }: BlogArticleBodyProps): react.JSX.Element | null;
+
+export { BlogArticleBody, type BlogArticleBodyProps };

package/dist/client/article-body.d.ts

@@ -0,0 +1,15 @@
+import * as react from 'react';
+
+interface BlogArticleBodyProps {
+    htmlContent?: string | null;
+    markdownFallback?: string | null;
+    /** Override default Tailwind Typography classes */
+    className?: string;
+}
+/**
+ * Renders blog article body: prefers `htmlContent` from the headless API,
+ * falls back to Markdown when `htmlContent` is empty.
+ */
+declare function BlogArticleBody({ htmlContent, markdownFallback, className, }: BlogArticleBodyProps): react.JSX.Element | null;
+
+export { BlogArticleBody, type BlogArticleBodyProps };

package/dist/client/article-body.js

@@ -0,0 +1,80 @@
+// src/components/blog-article-body.tsx
+import ReactMarkdown from "react-markdown";
+import remarkGfm from "remark-gfm";
+
+// src/markdown-link-target.ts
+function markdownHrefOpensInNewTab(href) {
+  const h = href.trim();
+  if (h === "") return false;
+  if (h.startsWith("#") || h.startsWith("?")) return false;
+  if (h.startsWith("//")) return true;
+  if (h.startsWith("/")) return false;
+  if (h.startsWith("./") || h.startsWith("../")) return false;
+  const lower = h.toLowerCase();
+  return lower.startsWith("http://") || lower.startsWith("https://");
+}
+
+// src/server/utils.ts
+var BLOG_ARTICLE_PROSE_CLASSNAME = [
+  "prose",
+  "prose-gray",
+  "prose-lg",
+  "max-w-none",
+  "dark:prose-invert",
+  "prose-a:text-blue-600",
+  "hover:prose-a:text-blue-700",
+  "dark:prose-a:text-blue-400",
+  "dark:hover:prose-a:text-blue-300",
+  "prose-blockquote:border-blue-500",
+  "prose-img:rounded-lg",
+  "prose-img:shadow-sm"
+].join(" ");
+
+// src/components/blog-article-body.tsx
+import { jsx } from "react/jsx-runtime";
+function BlogArticleBody({
+  htmlContent,
+  markdownFallback,
+  className = BLOG_ARTICLE_PROSE_CLASSNAME
+}) {
+  const html = htmlContent?.trim();
+  if (html) {
+    return /* @__PURE__ */ jsx(
+      "div",
+      {
+        className,
+        dangerouslySetInnerHTML: { __html: html }
+      }
+    );
+  }
+  const md = markdownFallback?.trim();
+  if (md) {
+    return /* @__PURE__ */ jsx("div", { className, children: /* @__PURE__ */ jsx(
+      ReactMarkdown,
+      {
+        remarkPlugins: [remarkGfm],
+        components: {
+          a({ children, href, ...props }) {
+            const h = href ?? "";
+            const openNew = markdownHrefOpensInNewTab(h);
+            return /* @__PURE__ */ jsx(
+              "a",
+              {
+                href: h,
+                ...openNew ? { target: "_blank", rel: "noopener noreferrer" } : {},
+                ...props,
+                children
+              }
+            );
+          }
+        },
+        children: md
+      }
+    ) });
+  }
+  return null;
+}
+export {
+  BlogArticleBody
+};
+//# sourceMappingURL=article-body.js.map

package/dist/client/article-body.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/components/blog-article-body.tsx","../../src/markdown-link-target.ts","../../src/server/utils.ts"],"sourcesContent":["import ReactMarkdown from 'react-markdown'\nimport remarkGfm from 'remark-gfm'\nimport { markdownHrefOpensInNewTab } from '../markdown-link-target.js'\nimport { BLOG_ARTICLE_PROSE_CLASSNAME } from '../server/utils.js'\n\nexport interface BlogArticleBodyProps {\n  htmlContent?: string | null\n  markdownFallback?: string | null\n  /** Override default Tailwind Typography classes */\n  className?: string\n}\n\n/**\n * Renders blog article body: prefers `htmlContent` from the headless API,\n * falls back to Markdown when `htmlContent` is empty.\n */\nexport function BlogArticleBody({\n  htmlContent,\n  markdownFallback,\n  className = BLOG_ARTICLE_PROSE_CLASSNAME,\n}: BlogArticleBodyProps) {\n  const html = htmlContent?.trim()\n  if (html) {\n    return (\n      <div\n        className={className}\n        dangerouslySetInnerHTML={{ __html: html }}\n      />\n    )\n  }\n\n  const md = markdownFallback?.trim()\n  if (md) {\n    return (\n      <div className={className}>\n        <ReactMarkdown\n          remarkPlugins={[remarkGfm]}\n          components={{\n            a({ children, href, ...props }) {\n              const h = href ?? ''\n              const openNew = markdownHrefOpensInNewTab(h)\n              return (\n                <a\n                  href={h}\n                  {...(openNew\n                    ? { target: '_blank', rel: 'noopener noreferrer' }\n                    : {})}\n                  {...props}\n                >\n                  {children}\n                </a>\n              )\n            },\n          }}\n        >\n          {md}\n        </ReactMarkdown>\n      </div>\n    )\n  }\n\n  return null\n}\n","export function markdownHrefOpensInNewTab(href: string): boolean {\n  const h = href.trim()\n  if (h === '') return false\n  if (h.startsWith('#') || h.startsWith('?')) return false\n  if (h.startsWith('//')) return true\n  if (h.startsWith('/')) return false\n  if (h.startsWith('./') || h.startsWith('../')) return false\n  const lower = h.toLowerCase()\n  return lower.startsWith('http://') || lower.startsWith('https://')\n}\n","/**\n * First absolute image URL for OG/Twitter previews: prefer HTML from the API,\n * then markdown image syntax in content.\n */\nconst HTML_IMG_SRC = /<img[^>]+src=[\"']([^\"']+)[\"']/i\nconst MD_IMAGE = /!\\[[^\\]]*]\\(([^)\\s]+)\\)/\n\nfunction normalizeUrl(raw: string): string | null {\n  const u = raw.trim()\n  if (!u) return null\n  if (\n    u.startsWith('http://') ||\n    u.startsWith('https://') ||\n    u.startsWith('/')\n  ) {\n    return u\n  }\n  return null\n}\n\nexport function firstEmbedImageUrlFromArticle(\n  htmlContent: string | null | undefined,\n  markdownContent: string | null | undefined\n): string | null {\n  if (htmlContent) {\n    const m = htmlContent.match(HTML_IMG_SRC)\n    if (m?.[1]) {\n      const url = normalizeUrl(m[1])\n      if (url) return url\n    }\n  }\n  if (markdownContent) {\n    const m = markdownContent.match(MD_IMAGE)\n    if (m?.[1]) {\n      const url = normalizeUrl(m[1])\n      if (url) return url\n    }\n  }\n  return null\n}\n\n/**\n * Default Tailwind Typography class string for article body.\n * Hosts may pass a custom `className` instead.\n */\nexport const BLOG_ARTICLE_PROSE_CLASSNAME = [\n  'prose',\n  'prose-gray',\n  'prose-lg',\n  'max-w-none',\n  'dark:prose-invert',\n  'prose-a:text-blue-600',\n  'hover:prose-a:text-blue-700',\n  'dark:prose-a:text-blue-400',\n  'dark:hover:prose-a:text-blue-300',\n  'prose-blockquote:border-blue-500',\n  'prose-img:rounded-lg',\n  'prose-img:shadow-sm',\n].join(' ')\n"],"mappings":";AAAA,OAAO,mBAAmB;AAC1B,OAAO,eAAe;;;ACDf,SAAS,0BAA0B,MAAuB;AAC/D,QAAM,IAAI,KAAK,KAAK;AACpB,MAAI,MAAM,GAAI,QAAO;AACrB,MAAI,EAAE,WAAW,GAAG,KAAK,EAAE,WAAW,GAAG,EAAG,QAAO;AACnD,MAAI,EAAE,WAAW,IAAI,EAAG,QAAO;AAC/B,MAAI,EAAE,WAAW,GAAG,EAAG,QAAO;AAC9B,MAAI,EAAE,WAAW,IAAI,KAAK,EAAE,WAAW,KAAK,EAAG,QAAO;AACtD,QAAM,QAAQ,EAAE,YAAY;AAC5B,SAAO,MAAM,WAAW,SAAS,KAAK,MAAM,WAAW,UAAU;AACnE;;;ACoCO,IAAM,+BAA+B;AAAA,EAC1C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,EAAE,KAAK,GAAG;;;AFlCJ;AARC,SAAS,gBAAgB;AAAA,EAC9B;AAAA,EACA;AAAA,EACA,YAAY;AACd,GAAyB;AACvB,QAAM,OAAO,aAAa,KAAK;AAC/B,MAAI,MAAM;AACR,WACE;AAAA,MAAC;AAAA;AAAA,QACC;AAAA,QACA,yBAAyB,EAAE,QAAQ,KAAK;AAAA;AAAA,IAC1C;AAAA,EAEJ;AAEA,QAAM,KAAK,kBAAkB,KAAK;AAClC,MAAI,IAAI;AACN,WACE,oBAAC,SAAI,WACH;AAAA,MAAC;AAAA;AAAA,QACC,eAAe,CAAC,SAAS;AAAA,QACzB,YAAY;AAAA,UACV,EAAE,EAAE,UAAU,MAAM,GAAG,MAAM,GAAG;AAC9B,kBAAM,IAAI,QAAQ;AAClB,kBAAM,UAAU,0BAA0B,CAAC;AAC3C,mBACE;AAAA,cAAC;AAAA;AAAA,gBACC,MAAM;AAAA,gBACL,GAAI,UACD,EAAE,QAAQ,UAAU,KAAK,sBAAsB,IAC/C,CAAC;AAAA,gBACJ,GAAG;AAAA,gBAEH;AAAA;AAAA,YACH;AAAA,UAEJ;AAAA,QACF;AAAA,QAEC;AAAA;AAAA,IACH,GACF;AAAA,EAEJ;AAEA,SAAO;AACT;","names":[]}