@gosalesdeal/blog 0.1.0

package/README.md

@@ -0,0 +1,97 @@
+# @gosalesdeal/blog
+
+Render the GoEnterprise blog (list + post detail) in any React 18+ / Next.js App Router app, straight from the BlogPosts API. Server-component friendly, with a typed data client and zero UI dependencies.
+
+## Install
+
+```bash
+npm install @gosalesdeal/blog
+```
+
+`react` (and `react-dom`) are peer dependencies.
+
+## Configure
+
+Components read config from props, then `configureBlog(...)` defaults, then env vars (`BLOG_API_URL` / `NEXT_PUBLIC_BLOG_API_URL`, `BLOG_TENANT_ID` / `NEXT_PUBLIC_BLOG_TENANT_ID`).
+
+```ts
+// e.g. instrumentation.ts or a server entry
+import { configureBlog } from '@gosalesdeal/blog';
+
+configureBlog({
+  apiBaseUrl: process.env.BLOG_API_URL!, // base of the BlogPosts API
+  tenantId: process.env.BLOG_TENANT_ID!, // sent as the X-Tenant header
+});
+```
+
+## Next.js App Router usage
+
+```tsx
+// app/blog/page.tsx
+import { BlogList, generateBlogListMetadata } from '@gosalesdeal/blog';
+import '@gosalesdeal/blog/styles.css';
+
+export const metadata = generateBlogListMetadata({ siteName: 'Acme' });
+
+export default async function Page({ searchParams }: { searchParams: Promise<{ page?: string }> }) {
+  const { page } = await searchParams;
+  return <BlogList page={Number(page) || 1} basePath="/blog" />;
+}
+```
+
+```tsx
+// app/blog/[slug]/page.tsx
+import { notFound } from 'next/navigation';
+import { BlogPost, getPostBySlug, getPublishedSlugs, generateBlogPostMetadata } from '@gosalesdeal/blog';
+import '@gosalesdeal/blog/styles.css';
+
+export async function generateStaticParams() {
+  const slugs = await getPublishedSlugs();
+  return slugs.map((slug) => ({ slug }));
+}
+
+export async function generateMetadata({ params }: { params: Promise<{ slug: string }> }) {
+  const { slug } = await params;
+  const post = await getPostBySlug(slug);
+  if (!post) return {};
+  return generateBlogPostMetadata(post, { siteUrl: 'https://acme.com', siteName: 'Acme' });
+}
+
+export default async function Page({ params }: { params: Promise<{ slug: string }> }) {
+  const { slug } = await params;
+  return (
+    <BlogPost
+      slug={slug}
+      seo={{ siteUrl: 'https://acme.com', siteName: 'Acme' }}
+      fallback={notFound()}
+    />
+  );
+}
+```
+
+## API
+
+### Components
+- `<BlogList page limit category basePath apiBaseUrl tenantId locale emptyState />` — paginated listing of cards.
+- `<BlogPost slug seo trackView renderJsonLd locale fallback />` — full post with header, block body, and JSON-LD.
+- `<BlockRenderer block />` / `renderBlocks(blocks)` — render raw `ContentBlock`s yourself.
+
+### Data client
+`createBlogClient({ apiBaseUrl, tenantId })` → `{ getPostBySlug, getPosts, getPostsByCategory, getPublishedSlugs, getCategories, incrementView }`. The same functions are exported standalone (each accepts an optional trailing `config`).
+
+### SEO
+`generateBlogPostMetadata`, `generateBlogListMetadata`, `generateBlogPostJsonLd`, `generateBlogBreadcrumbJsonLd` — framework-neutral plain objects (assignable to Next's `Metadata`).
+
+## Styling
+
+The bundled `@gosalesdeal/blog/styles.css` is optional and namespaced under `.ggblog-*`. Theme it by overriding the CSS variables on `.ggblog-post` / `.ggblog-list` (`--ggblog-accent`, `--ggblog-fg`, `--ggblog-border`, …), or skip it and bring your own.
+
+## Scope & notes
+
+- Renders **block-based** posts (`content_blocks`). All 17 block types are supported; `accordion` and `tabs` are interactive (`"use client"`), everything else is a server component.
+- Block HTML (text/embed/accordion/tab content) is treated as **trusted CMS output**. If your authors are untrusted, sanitize upstream.
+- The page-builder (`landingPage.schema_json`) rendering path is out of scope.
+
+## License
+
+MIT

package/dist/client/blogClient.d.ts

@@ -0,0 +1,31 @@
+import { BlogConfig } from '../config';
+import { BlogPost, BlogCategory, PaginatedResponse } from '../types/blog';
+export interface GetPostsParams {
+    page?: number;
+    limit?: number;
+    category?: string;
+    search?: string;
+    featured?: boolean;
+}
+/** Fetch a single published post by slug. Returns null when not found. */
+export declare function getPostBySlug(slug: string, config?: Partial<BlogConfig>): Promise<BlogPost | null>;
+/** Fetch a paginated list of posts. */
+export declare function getPosts(params?: GetPostsParams, config?: Partial<BlogConfig>): Promise<PaginatedResponse<BlogPost>>;
+/** Fetch posts within a category by its slug. */
+export declare function getPostsByCategory(categorySlug: string, params?: GetPostsParams, config?: Partial<BlogConfig>): Promise<PaginatedResponse<BlogPost>>;
+/** Slugs of all published posts (for static generation / sitemaps). */
+export declare function getPublishedSlugs(config?: Partial<BlogConfig>): Promise<string[]>;
+/** All blog categories. */
+export declare function getCategories(config?: Partial<BlogConfig>): Promise<BlogCategory[]>;
+/** Best-effort view-count increment. Never throws. */
+export declare function incrementView(postId: string, config?: Partial<BlogConfig>): Promise<void>;
+export interface BlogClient {
+    getPostBySlug: (slug: string) => Promise<BlogPost | null>;
+    getPosts: (params?: GetPostsParams) => Promise<PaginatedResponse<BlogPost>>;
+    getPostsByCategory: (categorySlug: string, params?: GetPostsParams) => Promise<PaginatedResponse<BlogPost>>;
+    getPublishedSlugs: () => Promise<string[]>;
+    getCategories: () => Promise<BlogCategory[]>;
+    incrementView: (postId: string) => Promise<void>;
+}
+/** Bind all fetchers to a single config. */
+export declare function createBlogClient(config: Partial<BlogConfig>): BlogClient;

package/dist/client/blogClient.js

@@ -0,0 +1,129 @@
+import { resolveConfig } from "../config.js";
+const EMPTY_PAGINATION = {
+  total: 0,
+  page: 1,
+  limit: 0,
+  pages: 0,
+  hasNext: false,
+  hasPrev: false
+};
+function buildUrl(base, path, query) {
+  const url = `${base.replace(/\/$/, "")}${path}`;
+  if (!query) return url;
+  const search = new URLSearchParams();
+  for (const [key, value] of Object.entries(query)) {
+    if (value !== void 0 && value !== null && value !== "") {
+      search.set(key, String(value));
+    }
+  }
+  const qs = search.toString();
+  return qs ? `${url}?${qs}` : url;
+}
+async function doFetch(path, config, query, init) {
+  const cfg = resolveConfig(config);
+  const fetchFn = cfg.fetch ?? globalThis.fetch;
+  if (typeof fetchFn !== "function") {
+    throw new Error("[@gosalesdeal/blog] No fetch implementation available. Provide config.fetch.");
+  }
+  const headers = {
+    Accept: "application/json",
+    ...cfg.headers ?? {},
+    ...init?.headers ?? {}
+  };
+  if (cfg.tenantId) headers["X-Tenant"] = cfg.tenantId;
+  return fetchFn(buildUrl(cfg.apiBaseUrl, path, query), { ...init, headers });
+}
+function normalizePost(post) {
+  if (!post) return null;
+  const blocks = Array.isArray(post.content_blocks) ? post.content_blocks : Array.isArray(post.blocks) ? post.blocks : [];
+  return {
+    ...post,
+    content_blocks: [...blocks].sort((a, b) => (a.display_order ?? 0) - (b.display_order ?? 0))
+  };
+}
+function normalizeList(body) {
+  const root = body;
+  const data = root?.data ?? root;
+  if (Array.isArray(data)) {
+    return {
+      items: data.map((p) => normalizePost(p)).filter(Boolean),
+      pagination: { ...EMPTY_PAGINATION, total: data.length, limit: data.length }
+    };
+  }
+  const items = Array.isArray(data?.items) ? data.items : [];
+  return {
+    items: items.map((p) => normalizePost(p)).filter(Boolean),
+    pagination: data?.pagination ?? { ...EMPTY_PAGINATION, total: items.length }
+  };
+}
+async function getPostBySlug(slug, config) {
+  const res = await doFetch(`/blog-posts/slug/${encodeURIComponent(slug)}`, config);
+  if (res.status === 404) return null;
+  if (!res.ok) throw new Error(`[@gosalesdeal/blog] GET /blog-posts/slug/${slug} -> ${res.status}`);
+  const body = await res.json();
+  return normalizePost(body?.data ?? body);
+}
+async function getPosts(params = {}, config) {
+  const res = await doFetch("/blog-posts/list/paginated", config, {
+    page: params.page,
+    limit: params.limit,
+    category: params.category,
+    search: params.search,
+    featured: params.featured
+  });
+  if (!res.ok) throw new Error(`[@gosalesdeal/blog] GET /blog-posts/list/paginated -> ${res.status}`);
+  return normalizeList(await res.json());
+}
+async function getPostsByCategory(categorySlug, params = {}, config) {
+  const res = await doFetch(`/blog-posts/category/${encodeURIComponent(categorySlug)}`, config, {
+    page: params.page,
+    limit: params.limit
+  });
+  if (!res.ok) {
+    throw new Error(`[@gosalesdeal/blog] GET /blog-posts/category/${categorySlug} -> ${res.status}`);
+  }
+  return normalizeList(await res.json());
+}
+async function getPublishedSlugs(config) {
+  const res = await doFetch("/blog-posts/published/slugs", config);
+  if (!res.ok) throw new Error(`[@gosalesdeal/blog] GET /blog-posts/published/slugs -> ${res.status}`);
+  const body = await res.json();
+  const rows = body?.data ?? [];
+  return rows.map((r) => typeof r === "string" ? r : r.slug).filter(Boolean);
+}
+async function getCategories(config) {
+  const res = await doFetch("/blog-posts/categories", config);
+  if (!res.ok) throw new Error(`[@gosalesdeal/blog] GET /blog-posts/categories -> ${res.status}`);
+  const body = await res.json();
+  return body?.data ?? [];
+}
+async function incrementView(postId, config) {
+  try {
+    await doFetch(`/blog-posts/${encodeURIComponent(postId)}/view`, config, void 0, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ increment: 1 })
+    });
+  } catch {
+  }
+}
+function createBlogClient(config) {
+  return {
+    getPostBySlug: (slug) => getPostBySlug(slug, config),
+    getPosts: (params) => getPosts(params, config),
+    getPostsByCategory: (categorySlug, params) => getPostsByCategory(categorySlug, params, config),
+    getPublishedSlugs: () => getPublishedSlugs(config),
+    getCategories: () => getCategories(config),
+    incrementView: (postId) => incrementView(postId, config)
+  };
+}
+export {
+  createBlogClient,
+  getCategories,
+  getPostBySlug,
+  getPosts,
+  getPostsByCategory,
+  getPublishedSlugs,
+  incrementView
+};
+//# sourceMappingURL=blogClient.js.map

package/dist/client/blogClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blogClient.js","sources":["../../src/client/blogClient.ts"],"sourcesContent":["import { resolveConfig, type BlogConfig } from '../config';\nimport type {\n  BlogPost,\n  BlogCategory,\n  ContentBlock,\n  PaginatedResponse,\n  PaginationMeta,\n  BlogApiResponse,\n} from '../types/blog';\n\nexport interface GetPostsParams {\n  page?: number;\n  limit?: number;\n  category?: string;\n  search?: string;\n  featured?: boolean;\n}\n\nconst EMPTY_PAGINATION: PaginationMeta = {\n  total: 0,\n  page: 1,\n  limit: 0,\n  pages: 0,\n  hasNext: false,\n  hasPrev: false,\n};\n\nfunction buildUrl(base: string, path: string, query?: Record<string, unknown>): string {\n  const url = `${base.replace(/\\/$/, '')}${path}`;\n  if (!query) return url;\n  const search = new URLSearchParams();\n  for (const [key, value] of Object.entries(query)) {\n    if (value !== undefined && value !== null && value !== '') {\n      search.set(key, String(value));\n    }\n  }\n  const qs = search.toString();\n  return qs ? `${url}?${qs}` : url;\n}\n\nasync function doFetch(\n  path: string,\n  config: Partial<BlogConfig> | undefined,\n  query?: Record<string, unknown>,\n  init?: RequestInit,\n): Promise<Response> {\n  const cfg = resolveConfig(config);\n  const fetchFn = cfg.fetch ?? globalThis.fetch;\n  if (typeof fetchFn !== 'function') {\n    throw new Error('[@gosalesdeal/blog] No fetch implementation available. Provide config.fetch.');\n  }\n  const headers: Record<string, string> = {\n    Accept: 'application/json',\n    ...(cfg.headers ?? {}),\n    ...((init?.headers as Record<string, string>) ?? {}),\n  };\n  if (cfg.tenantId) headers['X-Tenant'] = cfg.tenantId;\n  return fetchFn(buildUrl(cfg.apiBaseUrl, path, query), { ...init, headers });\n}\n\n/** Sort blocks by display_order and guarantee an array. */\nfunction normalizePost(post: BlogPost | null | undefined): BlogPost | null {\n  if (!post) return null;\n  const blocks: ContentBlock[] = Array.isArray(post.content_blocks)\n    ? post.content_blocks\n    : Array.isArray(post.blocks)\n      ? post.blocks\n      : [];\n  return {\n    ...post,\n    content_blocks: [...blocks].sort((a, b) => (a.display_order ?? 0) - (b.display_order ?? 0)),\n  };\n}\n\n/** Unwrap `{data:{items,pagination}}`, `{items,pagination}`, or `{data:[...]}`. */\nfunction normalizeList(body: unknown): PaginatedResponse<BlogPost> {\n  const root = body as BlogApiResponse<unknown> & PaginatedResponse<BlogPost>;\n  const data = (root?.data ?? root) as\n    | PaginatedResponse<BlogPost>\n    | BlogPost[]\n    | undefined;\n  if (Array.isArray(data)) {\n    return {\n      items: data.map((p) => normalizePost(p)!).filter(Boolean),\n      pagination: { ...EMPTY_PAGINATION, total: data.length, limit: data.length },\n    };\n  }\n  const items = Array.isArray(data?.items) ? data!.items : [];\n  return {\n    items: items.map((p) => normalizePost(p)!).filter(Boolean),\n    pagination: data?.pagination ?? { ...EMPTY_PAGINATION, total: items.length },\n  };\n}\n\n/** Fetch a single published post by slug. Returns null when not found. */\nexport async function getPostBySlug(\n  slug: string,\n  config?: Partial<BlogConfig>,\n): Promise<BlogPost | null> {\n  const res = await doFetch(`/blog-posts/slug/${encodeURIComponent(slug)}`, config);\n  if (res.status === 404) return null;\n  if (!res.ok) throw new Error(`[@gosalesdeal/blog] GET /blog-posts/slug/${slug} -> ${res.status}`);\n  const body = (await res.json()) as BlogApiResponse<BlogPost>;\n  return normalizePost(body?.data ?? (body as unknown as BlogPost));\n}\n\n/** Fetch a paginated list of posts. */\nexport async function getPosts(\n  params: GetPostsParams = {},\n  config?: Partial<BlogConfig>,\n): Promise<PaginatedResponse<BlogPost>> {\n  const res = await doFetch('/blog-posts/list/paginated', config, {\n    page: params.page,\n    limit: params.limit,\n    category: params.category,\n    search: params.search,\n    featured: params.featured,\n  });\n  if (!res.ok) throw new Error(`[@gosalesdeal/blog] GET /blog-posts/list/paginated -> ${res.status}`);\n  return normalizeList(await res.json());\n}\n\n/** Fetch posts within a category by its slug. */\nexport async function getPostsByCategory(\n  categorySlug: string,\n  params: GetPostsParams = {},\n  config?: Partial<BlogConfig>,\n): Promise<PaginatedResponse<BlogPost>> {\n  const res = await doFetch(`/blog-posts/category/${encodeURIComponent(categorySlug)}`, config, {\n    page: params.page,\n    limit: params.limit,\n  });\n  if (!res.ok) {\n    throw new Error(`[@gosalesdeal/blog] GET /blog-posts/category/${categorySlug} -> ${res.status}`);\n  }\n  return normalizeList(await res.json());\n}\n\n/** Slugs of all published posts (for static generation / sitemaps). */\nexport async function getPublishedSlugs(config?: Partial<BlogConfig>): Promise<string[]> {\n  const res = await doFetch('/blog-posts/published/slugs', config);\n  if (!res.ok) throw new Error(`[@gosalesdeal/blog] GET /blog-posts/published/slugs -> ${res.status}`);\n  const body = (await res.json()) as BlogApiResponse<Array<{ slug: string } | string>>;\n  const rows = body?.data ?? [];\n  return rows.map((r) => (typeof r === 'string' ? r : r.slug)).filter(Boolean);\n}\n\n/** All blog categories. */\nexport async function getCategories(config?: Partial<BlogConfig>): Promise<BlogCategory[]> {\n  const res = await doFetch('/blog-posts/categories', config);\n  if (!res.ok) throw new Error(`[@gosalesdeal/blog] GET /blog-posts/categories -> ${res.status}`);\n  const body = (await res.json()) as BlogApiResponse<BlogCategory[]>;\n  return body?.data ?? [];\n}\n\n/** Best-effort view-count increment. Never throws. */\nexport async function incrementView(\n  postId: string,\n  config?: Partial<BlogConfig>,\n): Promise<void> {\n  try {\n    await doFetch(`/blog-posts/${encodeURIComponent(postId)}/view`, config, undefined, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify({ increment: 1 }),\n    });\n  } catch {\n    // view tracking is non-critical\n  }\n}\n\nexport interface BlogClient {\n  getPostBySlug: (slug: string) => Promise<BlogPost | null>;\n  getPosts: (params?: GetPostsParams) => Promise<PaginatedResponse<BlogPost>>;\n  getPostsByCategory: (\n    categorySlug: string,\n    params?: GetPostsParams,\n  ) => Promise<PaginatedResponse<BlogPost>>;\n  getPublishedSlugs: () => Promise<string[]>;\n  getCategories: () => Promise<BlogCategory[]>;\n  incrementView: (postId: string) => Promise<void>;\n}\n\n/** Bind all fetchers to a single config. */\nexport function createBlogClient(config: Partial<BlogConfig>): BlogClient {\n  return {\n    getPostBySlug: (slug) => getPostBySlug(slug, config),\n    getPosts: (params) => getPosts(params, config),\n    getPostsByCategory: (categorySlug, params) => getPostsByCategory(categorySlug, params, config),\n    getPublishedSlugs: () => getPublishedSlugs(config),\n    getCategories: () => getCategories(config),\n    incrementView: (postId) => incrementView(postId, config),\n  };\n}\n"],"names":[],"mappings":"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"}

package/dist/components/BlogList.d.ts

@@ -0,0 +1,24 @@
+import { ReactNode } from 'react';
+import { BlogConfig } from '../config';
+export interface BlogListProps {
+    /** 1-based page number. Default 1. */
+    page?: number;
+    /** Posts per page. Default 12. */
+    limit?: number;
+    /** Filter by category slug. */
+    category?: string;
+    /** Link prefix for post/pagination URLs. Default '/blog'. */
+    basePath?: string;
+    /** API base URL (overrides configured/env default). */
+    apiBaseUrl?: string;
+    /** Tenant id sent as `X-Tenant`. */
+    tenantId?: string;
+    /** Full config override (takes precedence over apiBaseUrl/tenantId props). */
+    config?: Partial<BlogConfig>;
+    /** Locale for date formatting. Default 'en-US'. */
+    locale?: string;
+    /** Rendered when there are no posts. */
+    emptyState?: ReactNode;
+}
+/** Async server component: fetches and renders a paginated list of posts. */
+export declare function BlogList({ page, limit, category, basePath, apiBaseUrl, tenantId, config, locale, emptyState, }: BlogListProps): Promise<import("react").JSX.Element>;

package/dist/components/BlogList.js

@@ -0,0 +1,60 @@
+import { jsx, Fragment, jsxs } from "react/jsx-runtime";
+import { getPosts } from "../client/blogClient.js";
+import { formatDate } from "../lib/format.js";
+async function BlogList({
+  page = 1,
+  limit = 12,
+  category,
+  basePath = "/blog",
+  apiBaseUrl,
+  tenantId,
+  config,
+  locale = "en-US",
+  emptyState = null
+}) {
+  const cfg = {
+    ...config,
+    ...apiBaseUrl ? { apiBaseUrl } : {},
+    ...tenantId ? { tenantId } : {}
+  };
+  const { items, pagination } = await getPosts({ page, limit, category }, cfg);
+  if (items.length === 0) return /* @__PURE__ */ jsx(Fragment, { children: emptyState });
+  const prefix = basePath.replace(/\/$/, "");
+  const postHref = (slug) => `${prefix}/${slug}`;
+  const pageHref = (n) => `${prefix}?page=${n}`;
+  return /* @__PURE__ */ jsxs("div", { className: "ggblog-list", children: [
+    /* @__PURE__ */ jsx("div", { className: "ggblog-list-grid", children: items.map((post) => /* @__PURE__ */ jsx("article", { className: "ggblog-card", children: /* @__PURE__ */ jsxs("a", { className: "ggblog-card-link", href: postHref(post.slug), children: [
+      post.featured_image ? /* @__PURE__ */ jsx("div", { className: "ggblog-card-image", children: /* @__PURE__ */ jsx(
+        "img",
+        {
+          src: post.featured_image,
+          alt: post.featured_image_alt ?? post.title,
+          loading: "lazy"
+        }
+      ) }) : null,
+      /* @__PURE__ */ jsxs("div", { className: "ggblog-card-body", children: [
+        post.categories?.[0]?.category?.name ? /* @__PURE__ */ jsx("span", { className: "ggblog-card-category", children: post.categories[0].category.name }) : null,
+        /* @__PURE__ */ jsx("h3", { className: "ggblog-card-title", children: post.title }),
+        post.excerpt ? /* @__PURE__ */ jsx("p", { className: "ggblog-card-excerpt", children: post.excerpt }) : null,
+        /* @__PURE__ */ jsxs("div", { className: "ggblog-card-meta", children: [
+          post.author_name ? /* @__PURE__ */ jsx("span", { children: post.author_name }) : null,
+          post.published_at ? /* @__PURE__ */ jsx("time", { dateTime: post.published_at, children: formatDate(post.published_at, locale) }) : null
+        ] })
+      ] })
+    ] }) }, post.post_id)) }),
+    pagination.pages > 1 ? /* @__PURE__ */ jsxs("nav", { className: "ggblog-pagination", "aria-label": "Blog pagination", children: [
+      pagination.hasPrev ? /* @__PURE__ */ jsx("a", { className: "ggblog-page-prev", href: pageHref(pagination.page - 1), children: "Previous" }) : /* @__PURE__ */ jsx("span", {}),
+      /* @__PURE__ */ jsxs("span", { className: "ggblog-page-status", children: [
+        "Page ",
+        pagination.page,
+        " of ",
+        pagination.pages
+      ] }),
+      pagination.hasNext ? /* @__PURE__ */ jsx("a", { className: "ggblog-page-next", href: pageHref(pagination.page + 1), children: "Next" }) : /* @__PURE__ */ jsx("span", {})
+    ] }) : null
+  ] });
+}
+export {
+  BlogList
+};
+//# sourceMappingURL=BlogList.js.map

package/dist/components/BlogList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlogList.js","sources":["../../src/components/BlogList.tsx"],"sourcesContent":["import type { ReactNode } from 'react';\nimport type { BlogConfig } from '../config';\nimport { getPosts } from '../client/blogClient';\nimport { formatDate } from '../lib/format';\n\nexport interface BlogListProps {\n  /** 1-based page number. Default 1. */\n  page?: number;\n  /** Posts per page. Default 12. */\n  limit?: number;\n  /** Filter by category slug. */\n  category?: string;\n  /** Link prefix for post/pagination URLs. Default '/blog'. */\n  basePath?: string;\n  /** API base URL (overrides configured/env default). */\n  apiBaseUrl?: string;\n  /** Tenant id sent as `X-Tenant`. */\n  tenantId?: string;\n  /** Full config override (takes precedence over apiBaseUrl/tenantId props). */\n  config?: Partial<BlogConfig>;\n  /** Locale for date formatting. Default 'en-US'. */\n  locale?: string;\n  /** Rendered when there are no posts. */\n  emptyState?: ReactNode;\n}\n\n/** Async server component: fetches and renders a paginated list of posts. */\nexport async function BlogList({\n  page = 1,\n  limit = 12,\n  category,\n  basePath = '/blog',\n  apiBaseUrl,\n  tenantId,\n  config,\n  locale = 'en-US',\n  emptyState = null,\n}: BlogListProps) {\n  const cfg: Partial<BlogConfig> = {\n    ...config,\n    ...(apiBaseUrl ? { apiBaseUrl } : {}),\n    ...(tenantId ? { tenantId } : {}),\n  };\n  const { items, pagination } = await getPosts({ page, limit, category }, cfg);\n\n  if (items.length === 0) return <>{emptyState}</>;\n\n  const prefix = basePath.replace(/\\/$/, '');\n  const postHref = (slug: string) => `${prefix}/${slug}`;\n  const pageHref = (n: number) => `${prefix}?page=${n}`;\n\n  return (\n    <div className=\"ggblog-list\">\n      <div className=\"ggblog-list-grid\">\n        {items.map((post) => (\n          <article key={post.post_id} className=\"ggblog-card\">\n            <a className=\"ggblog-card-link\" href={postHref(post.slug)}>\n              {post.featured_image ? (\n                <div className=\"ggblog-card-image\">\n                  {/* eslint-disable-next-line @next/next/no-img-element */}\n                  <img\n                    src={post.featured_image}\n                    alt={post.featured_image_alt ?? post.title}\n                    loading=\"lazy\"\n                  />\n                </div>\n              ) : null}\n              <div className=\"ggblog-card-body\">\n                {post.categories?.[0]?.category?.name ? (\n                  <span className=\"ggblog-card-category\">{post.categories[0].category!.name}</span>\n                ) : null}\n                <h3 className=\"ggblog-card-title\">{post.title}</h3>\n                {post.excerpt ? <p className=\"ggblog-card-excerpt\">{post.excerpt}</p> : null}\n                <div className=\"ggblog-card-meta\">\n                  {post.author_name ? <span>{post.author_name}</span> : null}\n                  {post.published_at ? (\n                    <time dateTime={post.published_at}>{formatDate(post.published_at, locale)}</time>\n                  ) : null}\n                </div>\n              </div>\n            </a>\n          </article>\n        ))}\n      </div>\n\n      {pagination.pages > 1 ? (\n        <nav className=\"ggblog-pagination\" aria-label=\"Blog pagination\">\n          {pagination.hasPrev ? (\n            <a className=\"ggblog-page-prev\" href={pageHref(pagination.page - 1)}>\n              Previous\n            </a>\n          ) : (\n            <span />\n          )}\n          <span className=\"ggblog-page-status\">\n            Page {pagination.page} of {pagination.pages}\n          </span>\n          {pagination.hasNext ? (\n            <a className=\"ggblog-page-next\" href={pageHref(pagination.page + 1)}>\n              Next\n            </a>\n          ) : (\n            <span />\n          )}\n        </nav>\n      ) : null}\n    </div>\n  );\n}\n"],"names":[],"mappings":";;;AA2BA,eAAsB,SAAS;AAAA,EAC7B,OAAO;AAAA,EACP,QAAQ;AAAA,EACR;AAAA,EACA,WAAW;AAAA,EACX;AAAA,EACA;AAAA,EACA;AAAA,EACA,SAAS;AAAA,EACT,aAAa;AACf,GAAkB;AAChB,QAAM,MAA2B;AAAA,IAC/B,GAAG;AAAA,IACH,GAAI,aAAa,EAAE,WAAA,IAAe,CAAA;AAAA,IAClC,GAAI,WAAW,EAAE,aAAa,CAAA;AAAA,EAAC;AAEjC,QAAM,EAAE,OAAO,WAAA,IAAe,MAAM,SAAS,EAAE,MAAM,OAAO,SAAA,GAAY,GAAG;AAE3E,MAAI,MAAM,WAAW,EAAG,wCAAU,UAAA,YAAW;AAE7C,QAAM,SAAS,SAAS,QAAQ,OAAO,EAAE;AACzC,QAAM,WAAW,CAAC,SAAiB,GAAG,MAAM,IAAI,IAAI;AACpD,QAAM,WAAW,CAAC,MAAc,GAAG,MAAM,SAAS,CAAC;AAEnD,SACE,qBAAC,OAAA,EAAI,WAAU,eACb,UAAA;AAAA,IAAA,oBAAC,SAAI,WAAU,oBACZ,gBAAM,IAAI,CAAC,SACV,oBAAC,WAAA,EAA2B,WAAU,eACpC,UAAA,qBAAC,OAAE,WAAU,oBAAmB,MAAM,SAAS,KAAK,IAAI,GACrD,UAAA;AAAA,MAAA,KAAK,iBACJ,oBAAC,OAAA,EAAI,WAAU,qBAEb,UAAA;AAAA,QAAC;AAAA,QAAA;AAAA,UACC,KAAK,KAAK;AAAA,UACV,KAAK,KAAK,sBAAsB,KAAK;AAAA,UACrC,SAAQ;AAAA,QAAA;AAAA,MAAA,GAEZ,IACE;AAAA,MACJ,qBAAC,OAAA,EAAI,WAAU,oBACZ,UAAA;AAAA,QAAA,KAAK,aAAa,CAAC,GAAG,UAAU,OAC/B,oBAAC,QAAA,EAAK,WAAU,wBAAwB,eAAK,WAAW,CAAC,EAAE,SAAU,MAAK,IACxE;AAAA,QACJ,oBAAC,MAAA,EAAG,WAAU,qBAAqB,eAAK,OAAM;AAAA,QAC7C,KAAK,UAAU,oBAAC,KAAA,EAAE,WAAU,uBAAuB,UAAA,KAAK,SAAQ,IAAO;AAAA,QACxE,qBAAC,OAAA,EAAI,WAAU,oBACZ,UAAA;AAAA,UAAA,KAAK,cAAc,oBAAC,QAAA,EAAM,UAAA,KAAK,aAAY,IAAU;AAAA,UACrD,KAAK,eACJ,oBAAC,QAAA,EAAK,UAAU,KAAK,cAAe,UAAA,WAAW,KAAK,cAAc,MAAM,EAAA,CAAE,IACxE;AAAA,QAAA,EAAA,CACN;AAAA,MAAA,EAAA,CACF;AAAA,IAAA,EAAA,CACF,EAAA,GAzBY,KAAK,OA0BnB,CACD,EAAA,CACH;AAAA,IAEC,WAAW,QAAQ,IAClB,qBAAC,SAAI,WAAU,qBAAoB,cAAW,mBAC3C,UAAA;AAAA,MAAA,WAAW,UACV,oBAAC,KAAA,EAAE,WAAU,oBAAmB,MAAM,SAAS,WAAW,OAAO,CAAC,GAAG,UAAA,WAAA,CAErE,wBAEC,QAAA,EAAK;AAAA,MAER,qBAAC,QAAA,EAAK,WAAU,sBAAqB,UAAA;AAAA,QAAA;AAAA,QAC7B,WAAW;AAAA,QAAK;AAAA,QAAK,WAAW;AAAA,MAAA,GACxC;AAAA,MACC,WAAW,UACV,oBAAC,KAAA,EAAE,WAAU,oBAAmB,MAAM,SAAS,WAAW,OAAO,CAAC,GAAG,UAAA,OAAA,CAErE,wBAEC,QAAA,CAAA,CAAK;AAAA,IAAA,EAAA,CAEV,IACE;AAAA,EAAA,GACN;AAEJ;"}

package/dist/components/BlogPost.d.ts

@@ -0,0 +1,25 @@
+import { ReactNode } from 'react';
+import { BlogConfig } from '../config';
+import { SeoOptions } from '../seo';
+export interface BlogPostProps {
+    /** Slug of the post to render. */
+    slug: string;
+    /** API base URL (overrides configured/env default). */
+    apiBaseUrl?: string;
+    /** Tenant id sent as `X-Tenant`. */
+    tenantId?: string;
+    /** Full config override (takes precedence over apiBaseUrl/tenantId props). */
+    config?: Partial<BlogConfig>;
+    /** Fire a best-effort view increment. Default true. */
+    trackView?: boolean;
+    /** Emit BlogPosting + breadcrumb JSON-LD. Default true. */
+    renderJsonLd?: boolean;
+    /** SEO context (site origin/name) used for JSON-LD canonical URLs. */
+    seo?: SeoOptions;
+    /** Locale for date formatting. Default 'en-US'. */
+    locale?: string;
+    /** Rendered when the post is not found (consumer typically calls notFound()). */
+    fallback?: ReactNode;
+}
+/** Async server component: fetches a post by slug and renders it. */
+export declare function BlogPost({ slug, apiBaseUrl, tenantId, config, trackView, renderJsonLd, seo, locale, fallback, }: BlogPostProps): Promise<import("react").JSX.Element>;

package/dist/components/BlogPost.js

@@ -0,0 +1,53 @@
+import { jsx, Fragment, jsxs } from "react/jsx-runtime";
+import { getPostBySlug, incrementView } from "../client/blogClient.js";
+import { renderBlocks } from "../render/BlockRenderer.js";
+import { formatDate } from "../lib/format.js";
+import { generateBlogPostJsonLd, generateBlogBreadcrumbJsonLd } from "../seo/index.js";
+import { JsonLd } from "./JsonLd.js";
+function mergeConfig(config, apiBaseUrl, tenantId) {
+  return {
+    ...config,
+    ...apiBaseUrl ? { apiBaseUrl } : {},
+    ...tenantId ? { tenantId } : {}
+  };
+}
+async function BlogPost({
+  slug,
+  apiBaseUrl,
+  tenantId,
+  config,
+  trackView = true,
+  renderJsonLd = true,
+  seo,
+  locale = "en-US",
+  fallback = null
+}) {
+  const cfg = mergeConfig(config, apiBaseUrl, tenantId);
+  const post = await getPostBySlug(slug, cfg);
+  if (!post) return /* @__PURE__ */ jsx(Fragment, { children: fallback });
+  if (trackView) await incrementView(post.post_id, cfg);
+  return /* @__PURE__ */ jsxs("article", { className: "ggblog-post", children: [
+    renderJsonLd ? /* @__PURE__ */ jsxs(Fragment, { children: [
+      /* @__PURE__ */ jsx(JsonLd, { id: "ggblog-post-jsonld", data: generateBlogPostJsonLd(post, seo) }),
+      /* @__PURE__ */ jsx(JsonLd, { id: "ggblog-breadcrumb-jsonld", data: generateBlogBreadcrumbJsonLd(post, seo) })
+    ] }) : null,
+    /* @__PURE__ */ jsxs("header", { className: "ggblog-post-header", children: [
+      /* @__PURE__ */ jsx("h1", { className: "ggblog-post-title", children: post.title }),
+      /* @__PURE__ */ jsxs("div", { className: "ggblog-post-meta", children: [
+        post.author_name ? /* @__PURE__ */ jsx("span", { className: "ggblog-post-author", children: post.author_name }) : null,
+        post.published_at ? /* @__PURE__ */ jsx("time", { dateTime: post.published_at, children: formatDate(post.published_at, locale) }) : null,
+        post.reading_time ? /* @__PURE__ */ jsxs("span", { className: "ggblog-post-readtime", children: [
+          post.reading_time,
+          " min read"
+        ] }) : null
+      ] }),
+      post.excerpt ? /* @__PURE__ */ jsx("p", { className: "ggblog-post-excerpt", children: post.excerpt }) : null,
+      post.featured_image ? /* @__PURE__ */ jsx("figure", { className: "ggblog-post-cover", children: /* @__PURE__ */ jsx("img", { src: post.featured_image, alt: post.featured_image_alt ?? post.title }) }) : null
+    ] }),
+    /* @__PURE__ */ jsx("div", { className: "ggblog-post-body", children: renderBlocks(post.content_blocks) })
+  ] });
+}
+export {
+  BlogPost
+};
+//# sourceMappingURL=BlogPost.js.map

package/dist/components/BlogPost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlogPost.js","sources":["../../src/components/BlogPost.tsx"],"sourcesContent":["import type { ReactNode } from 'react';\nimport type { BlogConfig } from '../config';\nimport { getPostBySlug, incrementView } from '../client/blogClient';\nimport { renderBlocks } from '../render/BlockRenderer';\nimport { formatDate } from '../lib/format';\nimport { generateBlogPostJsonLd, generateBlogBreadcrumbJsonLd, type SeoOptions } from '../seo';\nimport { JsonLd } from './JsonLd';\n\nexport interface BlogPostProps {\n  /** Slug of the post to render. */\n  slug: string;\n  /** API base URL (overrides configured/env default). */\n  apiBaseUrl?: string;\n  /** Tenant id sent as `X-Tenant`. */\n  tenantId?: string;\n  /** Full config override (takes precedence over apiBaseUrl/tenantId props). */\n  config?: Partial<BlogConfig>;\n  /** Fire a best-effort view increment. Default true. */\n  trackView?: boolean;\n  /** Emit BlogPosting + breadcrumb JSON-LD. Default true. */\n  renderJsonLd?: boolean;\n  /** SEO context (site origin/name) used for JSON-LD canonical URLs. */\n  seo?: SeoOptions;\n  /** Locale for date formatting. Default 'en-US'. */\n  locale?: string;\n  /** Rendered when the post is not found (consumer typically calls notFound()). */\n  fallback?: ReactNode;\n}\n\nfunction mergeConfig(\n  config?: Partial<BlogConfig>,\n  apiBaseUrl?: string,\n  tenantId?: string,\n): Partial<BlogConfig> {\n  return {\n    ...config,\n    ...(apiBaseUrl ? { apiBaseUrl } : {}),\n    ...(tenantId ? { tenantId } : {}),\n  };\n}\n\n/** Async server component: fetches a post by slug and renders it. */\nexport async function BlogPost({\n  slug,\n  apiBaseUrl,\n  tenantId,\n  config,\n  trackView = true,\n  renderJsonLd = true,\n  seo,\n  locale = 'en-US',\n  fallback = null,\n}: BlogPostProps) {\n  const cfg = mergeConfig(config, apiBaseUrl, tenantId);\n  const post = await getPostBySlug(slug, cfg);\n  if (!post) return <>{fallback}</>;\n\n  if (trackView) await incrementView(post.post_id, cfg);\n\n  return (\n    <article className=\"ggblog-post\">\n      {renderJsonLd ? (\n        <>\n          <JsonLd id=\"ggblog-post-jsonld\" data={generateBlogPostJsonLd(post, seo)} />\n          <JsonLd id=\"ggblog-breadcrumb-jsonld\" data={generateBlogBreadcrumbJsonLd(post, seo)} />\n        </>\n      ) : null}\n\n      <header className=\"ggblog-post-header\">\n        <h1 className=\"ggblog-post-title\">{post.title}</h1>\n        <div className=\"ggblog-post-meta\">\n          {post.author_name ? <span className=\"ggblog-post-author\">{post.author_name}</span> : null}\n          {post.published_at ? (\n            <time dateTime={post.published_at}>{formatDate(post.published_at, locale)}</time>\n          ) : null}\n          {post.reading_time ? (\n            <span className=\"ggblog-post-readtime\">{post.reading_time} min read</span>\n          ) : null}\n        </div>\n        {post.excerpt ? <p className=\"ggblog-post-excerpt\">{post.excerpt}</p> : null}\n        {post.featured_image ? (\n          <figure className=\"ggblog-post-cover\">\n            {/* eslint-disable-next-line @next/next/no-img-element */}\n            <img src={post.featured_image} alt={post.featured_image_alt ?? post.title} />\n          </figure>\n        ) : null}\n      </header>\n\n      <div className=\"ggblog-post-body\">{renderBlocks(post.content_blocks)}</div>\n    </article>\n  );\n}\n"],"names":[],"mappings":";;;;;;AA6BA,SAAS,YACP,QACA,YACA,UACqB;AACrB,SAAO;AAAA,IACL,GAAG;AAAA,IACH,GAAI,aAAa,EAAE,WAAA,IAAe,CAAA;AAAA,IAClC,GAAI,WAAW,EAAE,aAAa,CAAA;AAAA,EAAC;AAEnC;AAGA,eAAsB,SAAS;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,YAAY;AAAA,EACZ,eAAe;AAAA,EACf;AAAA,EACA,SAAS;AAAA,EACT,WAAW;AACb,GAAkB;AAChB,QAAM,MAAM,YAAY,QAAQ,YAAY,QAAQ;AACpD,QAAM,OAAO,MAAM,cAAc,MAAM,GAAG;AAC1C,MAAI,CAAC,KAAM,QAAO,oBAAA,UAAA,EAAG,UAAA,UAAS;AAE9B,MAAI,UAAW,OAAM,cAAc,KAAK,SAAS,GAAG;AAEpD,SACE,qBAAC,WAAA,EAAQ,WAAU,eAChB,UAAA;AAAA,IAAA,eACC,qBAAA,UAAA,EACE,UAAA;AAAA,MAAA,oBAAC,UAAO,IAAG,sBAAqB,MAAM,uBAAuB,MAAM,GAAG,GAAG;AAAA,MACzE,oBAAC,UAAO,IAAG,4BAA2B,MAAM,6BAA6B,MAAM,GAAG,EAAA,CAAG;AAAA,IAAA,EAAA,CACvF,IACE;AAAA,IAEJ,qBAAC,UAAA,EAAO,WAAU,sBAChB,UAAA;AAAA,MAAA,oBAAC,MAAA,EAAG,WAAU,qBAAqB,UAAA,KAAK,OAAM;AAAA,MAC9C,qBAAC,OAAA,EAAI,WAAU,oBACZ,UAAA;AAAA,QAAA,KAAK,cAAc,oBAAC,QAAA,EAAK,WAAU,sBAAsB,UAAA,KAAK,aAAY,IAAU;AAAA,QACpF,KAAK,eACJ,oBAAC,QAAA,EAAK,UAAU,KAAK,cAAe,UAAA,WAAW,KAAK,cAAc,MAAM,EAAA,CAAE,IACxE;AAAA,QACH,KAAK,eACJ,qBAAC,QAAA,EAAK,WAAU,wBAAwB,UAAA;AAAA,UAAA,KAAK;AAAA,UAAa;AAAA,QAAA,EAAA,CAAS,IACjE;AAAA,MAAA,GACN;AAAA,MACC,KAAK,UAAU,oBAAC,KAAA,EAAE,WAAU,uBAAuB,UAAA,KAAK,SAAQ,IAAO;AAAA,MACvE,KAAK,iBACJ,oBAAC,UAAA,EAAO,WAAU,qBAEhB,UAAA,oBAAC,OAAA,EAAI,KAAK,KAAK,gBAAgB,KAAK,KAAK,sBAAsB,KAAK,OAAO,GAC7E,IACE;AAAA,IAAA,GACN;AAAA,wBAEC,OAAA,EAAI,WAAU,oBAAoB,UAAA,aAAa,KAAK,cAAc,EAAA,CAAE;AAAA,EAAA,GACvE;AAEJ;"}

package/dist/components/JsonLd.d.ts

@@ -0,0 +1,6 @@
+/** Renders a Schema.org JSON-LD block in the server HTML. `<` is escaped so the
+ * payload can never break out of the <script> tag. */
+export declare function JsonLd({ data, id }: {
+    data: Record<string, unknown>;
+    id?: string;
+}): import("react").JSX.Element;

package/dist/components/JsonLd.js

@@ -0,0 +1,15 @@
+import { jsx } from "react/jsx-runtime";
+function JsonLd({ data, id }) {
+  return /* @__PURE__ */ jsx(
+    "script",
+    {
+      type: "application/ld+json",
+      id,
+      dangerouslySetInnerHTML: { __html: JSON.stringify(data).replace(/</g, "\\u003c") }
+    }
+  );
+}
+export {
+  JsonLd
+};
+//# sourceMappingURL=JsonLd.js.map

package/dist/components/JsonLd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonLd.js","sources":["../../src/components/JsonLd.tsx"],"sourcesContent":["/** Renders a Schema.org JSON-LD block in the server HTML. `<` is escaped so the\n * payload can never break out of the <script> tag. */\nexport function JsonLd({ data, id }: { data: Record<string, unknown>; id?: string }) {\n  return (\n    <script\n      type=\"application/ld+json\"\n      id={id}\n      dangerouslySetInnerHTML={{ __html: JSON.stringify(data).replace(/</g, '\\\\u003c') }}\n    />\n  );\n}\n"],"names":[],"mappings":";AAEO,SAAS,OAAO,EAAE,MAAM,MAAsD;AACnF,SACE;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,MAAK;AAAA,MACL;AAAA,MACA,yBAAyB,EAAE,QAAQ,KAAK,UAAU,IAAI,EAAE,QAAQ,MAAM,SAAS,EAAA;AAAA,IAAE;AAAA,EAAA;AAGvF;"}

package/dist/config.d.ts

@@ -0,0 +1,16 @@
+export interface BlogConfig {
+    /** Base URL of the BlogPosts API, e.g. https://api.example.com */
+    apiBaseUrl: string;
+    /** Tenant/account id sent as the `X-Tenant` header. */
+    tenantId?: string;
+    /** Extra headers merged into every request. */
+    headers?: Record<string, string>;
+    /** Custom fetch implementation (defaults to global fetch). */
+    fetch?: typeof fetch;
+}
+/** Set process-wide defaults used when a component/fetcher omits config. */
+export declare function configureBlog(config: Partial<BlogConfig>): void;
+/** Defaults from `configureBlog` then environment variables. */
+export declare function getDefaultConfig(): Partial<BlogConfig>;
+/** Merge an optional override over the defaults and validate. */
+export declare function resolveConfig(override?: Partial<BlogConfig>): BlogConfig;

package/dist/config.js

@@ -0,0 +1,32 @@
+let moduleDefaults = {};
+function configureBlog(config) {
+  moduleDefaults = { ...moduleDefaults, ...config };
+}
+function readEnv(name) {
+  if (typeof process === "undefined" || !process.env) return void 0;
+  const value = process.env[name];
+  return value && value.length > 0 ? value : void 0;
+}
+function getDefaultConfig() {
+  return {
+    apiBaseUrl: moduleDefaults.apiBaseUrl ?? readEnv("BLOG_API_URL") ?? readEnv("NEXT_PUBLIC_BLOG_API_URL"),
+    tenantId: moduleDefaults.tenantId ?? readEnv("BLOG_TENANT_ID") ?? readEnv("NEXT_PUBLIC_BLOG_TENANT_ID"),
+    headers: moduleDefaults.headers,
+    fetch: moduleDefaults.fetch
+  };
+}
+function resolveConfig(override) {
+  const merged = { ...getDefaultConfig(), ...override };
+  if (!merged.apiBaseUrl) {
+    throw new Error(
+      "[@gosalesdeal/blog] Missing apiBaseUrl. Pass it as a prop, call configureBlog({ apiBaseUrl }), or set BLOG_API_URL."
+    );
+  }
+  return merged;
+}
+export {
+  configureBlog,
+  getDefaultConfig,
+  resolveConfig
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sources":["../src/config.ts"],"sourcesContent":["// Runtime configuration for talking to the BlogPosts API. Components accept an\n// inline config via props; `configureBlog` lets an app set process-wide\n// defaults once (e.g. in a server entry) so components can be called with just\n// a slug. Environment variables are the final fallback.\n\nexport interface BlogConfig {\n  /** Base URL of the BlogPosts API, e.g. https://api.example.com */\n  apiBaseUrl: string;\n  /** Tenant/account id sent as the `X-Tenant` header. */\n  tenantId?: string;\n  /** Extra headers merged into every request. */\n  headers?: Record<string, string>;\n  /** Custom fetch implementation (defaults to global fetch). */\n  fetch?: typeof fetch;\n}\n\nlet moduleDefaults: Partial<BlogConfig> = {};\n\n/** Set process-wide defaults used when a component/fetcher omits config. */\nexport function configureBlog(config: Partial<BlogConfig>): void {\n  moduleDefaults = { ...moduleDefaults, ...config };\n}\n\nfunction readEnv(name: string): string | undefined {\n  if (typeof process === 'undefined' || !process.env) return undefined;\n  const value = process.env[name];\n  return value && value.length > 0 ? value : undefined;\n}\n\n/** Defaults from `configureBlog` then environment variables. */\nexport function getDefaultConfig(): Partial<BlogConfig> {\n  return {\n    apiBaseUrl:\n      moduleDefaults.apiBaseUrl ??\n      readEnv('BLOG_API_URL') ??\n      readEnv('NEXT_PUBLIC_BLOG_API_URL'),\n    tenantId:\n      moduleDefaults.tenantId ??\n      readEnv('BLOG_TENANT_ID') ??\n      readEnv('NEXT_PUBLIC_BLOG_TENANT_ID'),\n    headers: moduleDefaults.headers,\n    fetch: moduleDefaults.fetch,\n  };\n}\n\n/** Merge an optional override over the defaults and validate. */\nexport function resolveConfig(override?: Partial<BlogConfig>): BlogConfig {\n  const merged = { ...getDefaultConfig(), ...override };\n  if (!merged.apiBaseUrl) {\n    throw new Error(\n      '[@gosalesdeal/blog] Missing apiBaseUrl. Pass it as a prop, call configureBlog({ apiBaseUrl }), or set BLOG_API_URL.',\n    );\n  }\n  return merged as BlogConfig;\n}\n"],"names":[],"mappings":"AAgBA,IAAI,iBAAsC,CAAA;AAGnC,SAAS,cAAc,QAAmC;AAC/D,mBAAiB,EAAE,GAAG,gBAAgB,GAAG,OAAA;AAC3C;AAEA,SAAS,QAAQ,MAAkC;AACjD,MAAI,OAAO,YAAY,eAAe,CAAC,QAAQ,IAAK,QAAO;AAC3D,QAAM,QAAQ,QAAQ,IAAI,IAAI;AAC9B,SAAO,SAAS,MAAM,SAAS,IAAI,QAAQ;AAC7C;AAGO,SAAS,mBAAwC;AACtD,SAAO;AAAA,IACL,YACE,eAAe,cACf,QAAQ,cAAc,KACtB,QAAQ,0BAA0B;AAAA,IACpC,UACE,eAAe,YACf,QAAQ,gBAAgB,KACxB,QAAQ,4BAA4B;AAAA,IACtC,SAAS,eAAe;AAAA,IACxB,OAAO,eAAe;AAAA,EAAA;AAE1B;AAGO,SAAS,cAAc,UAA4C;AACxE,QAAM,SAAS,EAAE,GAAG,iBAAA,GAAoB,GAAG,SAAA;AAC3C,MAAI,CAAC,OAAO,YAAY;AACtB,UAAM,IAAI;AAAA,MACR;AAAA,IAAA;AAAA,EAEJ;AACA,SAAO;AACT;"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { BlogPost, type BlogPostProps } from './components/BlogPost';
+export { BlogList, type BlogListProps } from './components/BlogList';
+export { JsonLd } from './components/JsonLd';
+export { BlockRenderer, renderBlocks, type BlockRendererProps } from './render/BlockRenderer';
+export { configureBlog, getDefaultConfig, resolveConfig, type BlogConfig } from './config';
+export { createBlogClient, getPostBySlug, getPosts, getPostsByCategory, getPublishedSlugs, getCategories, incrementView, type BlogClient, type GetPostsParams, } from './client/blogClient';
+export { generateBlogPostMetadata, generateBlogListMetadata, generateBlogPostJsonLd, generateBlogBreadcrumbJsonLd, type BlogMetadata, type SeoOptions, } from './seo';
+export { formatDate } from './lib/format';
+export type * from './types/blog';

package/dist/index.js

@@ -0,0 +1,31 @@
+import { BlogPost } from "./components/BlogPost.js";
+import { BlogList } from "./components/BlogList.js";
+import { JsonLd } from "./components/JsonLd.js";
+import { BlockRenderer, renderBlocks } from "./render/BlockRenderer.js";
+import { configureBlog, getDefaultConfig, resolveConfig } from "./config.js";
+import { createBlogClient, getCategories, getPostBySlug, getPosts, getPostsByCategory, getPublishedSlugs, incrementView } from "./client/blogClient.js";
+import { generateBlogBreadcrumbJsonLd, generateBlogListMetadata, generateBlogPostJsonLd, generateBlogPostMetadata } from "./seo/index.js";
+import { formatDate } from "./lib/format.js";
+export {
+  BlockRenderer,
+  BlogList,
+  BlogPost,
+  JsonLd,
+  configureBlog,
+  createBlogClient,
+  formatDate,
+  generateBlogBreadcrumbJsonLd,
+  generateBlogListMetadata,
+  generateBlogPostJsonLd,
+  generateBlogPostMetadata,
+  getCategories,
+  getDefaultConfig,
+  getPostBySlug,
+  getPosts,
+  getPostsByCategory,
+  getPublishedSlugs,
+  incrementView,
+  renderBlocks,
+  resolveConfig
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;"}

package/dist/lib/format.d.ts

@@ -0,0 +1,2 @@
+/** Format an ISO date string for display. Returns '' for missing/invalid input. */
+export declare function formatDate(iso?: string, locale?: string): string;

package/dist/lib/format.js

@@ -0,0 +1,10 @@
+function formatDate(iso, locale = "en-US") {
+  if (!iso) return "";
+  const date = new Date(iso);
+  if (Number.isNaN(date.getTime())) return "";
+  return date.toLocaleDateString(locale, { year: "numeric", month: "long", day: "numeric" });
+}
+export {
+  formatDate
+};
+//# sourceMappingURL=format.js.map

package/dist/lib/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sources":["../../src/lib/format.ts"],"sourcesContent":["/** Format an ISO date string for display. Returns '' for missing/invalid input. */\nexport function formatDate(iso?: string, locale = 'en-US'): string {\n  if (!iso) return '';\n  const date = new Date(iso);\n  if (Number.isNaN(date.getTime())) return '';\n  return date.toLocaleDateString(locale, { year: 'numeric', month: 'long', day: 'numeric' });\n}\n"],"names":[],"mappings":"AACO,SAAS,WAAW,KAAc,SAAS,SAAiB;AACjE,MAAI,CAAC,IAAK,QAAO;AACjB,QAAM,OAAO,IAAI,KAAK,GAAG;AACzB,MAAI,OAAO,MAAM,KAAK,QAAA,CAAS,EAAG,QAAO;AACzC,SAAO,KAAK,mBAAmB,QAAQ,EAAE,MAAM,WAAW,OAAO,QAAQ,KAAK,WAAW;AAC3F;"}