@mailoo/blog 0.0.0-stage → 1.33.0

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/server/client.ts","../../src/server/fetch-bff.ts","../../src/server/utils.ts"],"sourcesContent":["import { unstable_rethrow } from 'next/navigation'\nimport type { MailooIntegrationConfig } from '@mailoo/next-core'\nimport { readMailooIntegrationConfig } from '@mailoo/next-core'\nimport {\n  rewriteMailooBlogMediaUrls,\n  rewriteMailooPublicImageUrls,\n  rewriteMailooPublicImageUrlsAnyHost,\n} from '@mailoo/images'\nimport type {\n  BlogArticleMarkState,\n  BlogCategoryApi,\n  BlogTagApi,\n  BlogListPagination,\n  BlogListQuery,\n  BlogPostApiData,\n  MailooBlogFetchOptions,\n  SetBlogFeedbackInput,\n  SetBlogReactionInput,\n} from '../types.js'\n\nexport type MailooBlogConfig = MailooIntegrationConfig\nexport type { MailooBlogFetchOptions }\n\n/** Host image proxy. Omit to keep canonical Mailoo embed URLs. */\nexport type CreateMailooBlogClientOptions = {\n  /**\n   * Integrator prefix ending with `?id=` (absolute or same-origin path).\n   * Example: `/api/v1/images/public/content?id=`\n   */\n  imageProxyPrefixWithIdEquals?: string\n}\n\nconst DEFAULT_REVALIDATE = 60\n\n/** Read MAILOO_BLOG_* env (API, API_KEY, PROJECT_UID, INTEGRATION_ID). */\nexport function getMailooBlogConfigFromEnv(): MailooBlogConfig | null {\n  return readMailooIntegrationConfig({ prefix: 'MAILOO_BLOG' })\n}\n\nfunction blogBasePath(config: MailooBlogConfig): string {\n  return `${config.apiBaseUrl}/api/v1/blog/${config.projectUid}/integrations/${config.integrationId}`\n}\n\nfunction resolveRevalidate(options?: MailooBlogFetchOptions): number {\n  return options?.revalidate ?? DEFAULT_REVALIDATE\n}\n\nasync function blogFetchJson(\n  config: MailooBlogConfig,\n  path: string,\n  query?: Record<string, string | undefined>,\n  options?: MailooBlogFetchOptions\n): Promise<\n  { ok: true; json: unknown; status: number } | { ok: false; status: number }\n> {\n  const url = new URL(`${blogBasePath(config)}${path}`)\n  if (query) {\n    for (const [k, v] of Object.entries(query)) {\n      if (v !== undefined && v !== '') url.searchParams.set(k, v)\n    }\n  }\n  try {\n    const revalidate = resolveRevalidate(options)\n    const res = await fetch(url.toString(), {\n      method: 'GET',\n      headers: {\n        'Content-Type': 'application/json',\n        'X-API-Key': config.apiKey,\n      },\n      next: { revalidate },\n    } as RequestInit)\n    if (!res.ok) {\n      return { ok: false, status: res.status }\n    }\n    return { ok: true, json: await res.json(), status: res.status }\n  } catch (error) {\n    unstable_rethrow(error)\n    return { ok: false, status: 500 }\n  }\n}\n\nasync function blogPostJson(\n  config: MailooBlogConfig,\n  path: string,\n  body: unknown\n): Promise<\n  | { ok: true; data: BlogArticleMarkState; status: number }\n  | { ok: false; status: number }\n> {\n  try {\n    const res = await fetch(`${blogBasePath(config)}${path}`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        'X-API-Key': config.apiKey,\n      },\n      body: JSON.stringify(body),\n      cache: 'no-store',\n    })\n    if (!res.ok) {\n      return { ok: false, status: res.status }\n    }\n    const json = (await res.json()) as { data?: BlogArticleMarkState }\n    if (!json.data || typeof json.data !== 'object') {\n      return { ok: false, status: 500 }\n    }\n    return { ok: true, data: json.data, status: res.status }\n  } catch (error) {\n    unstable_rethrow(error)\n    return { ok: false, status: 500 }\n  }\n}\n\nasync function blogGet<T>(\n  config: MailooBlogConfig,\n  path: string,\n  query?: Record<string, string | undefined>,\n  options?: MailooBlogFetchOptions\n): Promise<\n  { ok: true; data: T; status: number } | { ok: false; status: number }\n> {\n  const fetched = await blogFetchJson(config, path, query, options)\n  if (!fetched.ok) return fetched\n  const json = fetched.json as { data?: T } & T\n  const data =\n    (json as { data?: T }).data !== undefined\n      ? (json as { data: T }).data\n      : (json as T)\n  return { ok: true, data, status: fetched.status }\n}\n\nfunction isBlogListPagination(value: unknown): value is BlogListPagination {\n  if (value === null || typeof value !== 'object') return false\n  const p = value as Record<string, unknown>\n  return (\n    typeof p.page === 'number' &&\n    typeof p.limit === 'number' &&\n    typeof p.total === 'number' &&\n    typeof p.totalPages === 'number' &&\n    typeof p.hasNextPage === 'boolean' &&\n    typeof p.hasPrevPage === 'boolean'\n  )\n}\n\nfunction queryRecord(query: BlogListQuery): Record<string, string | undefined> {\n  const q: Record<string, string | undefined> = {}\n  for (const [k, v] of Object.entries(query)) {\n    if (v === undefined) continue\n    q[k] = String(v)\n  }\n  return q\n}\n\nfunction imageProxyPrefix(\n  options?: CreateMailooBlogClientOptions\n): string | undefined {\n  const raw = options?.imageProxyPrefixWithIdEquals?.trim()\n  return raw || undefined\n}\n\nfunction rewritePost(\n  post: BlogPostApiData,\n  canonicalPrefixWithIdEquals: string,\n  proxyPrefixWithIdEquals: string\n): BlogPostApiData {\n  return rewriteMailooBlogMediaUrls(post, {\n    canonicalPrefixWithIdEquals,\n    proxyPrefixWithIdEquals,\n  })\n}\n\ntype CategoryDescription = {\n  description?: string\n  descriptionHtml?: string\n  imagePublicEmbedBaseUrl?: string\n}\n\nexport function createMailooBlogClient(\n  config: MailooBlogConfig,\n  clientOptions?: CreateMailooBlogClientOptions\n) {\n  const proxyPrefix = imageProxyPrefix(clientOptions)\n  return {\n    async listPosts(\n      query: BlogListQuery = {},\n      options?: MailooBlogFetchOptions\n    ): Promise<\n      | {\n          ok: true\n          data: BlogPostApiData[]\n          pagination: BlogListPagination\n          imagePublicEmbedBaseUrl: string\n          status: number\n        }\n      | { ok: false; status: number }\n    > {\n      const fetched = await blogFetchJson(\n        config,\n        '',\n        queryRecord(query),\n        options\n      )\n      if (!fetched.ok) return fetched\n      const json = fetched.json\n      if (json === null || typeof json !== 'object') {\n        return { ok: false, status: 500 }\n      }\n      const body = json as {\n        data?: unknown\n        pagination?: unknown\n        imagePublicEmbedBaseUrl?: unknown\n      }\n      const imagePublicEmbedBaseUrl =\n        typeof body.imagePublicEmbedBaseUrl === 'string'\n          ? body.imagePublicEmbedBaseUrl.trim()\n          : ''\n      if (\n        !Array.isArray(body.data) ||\n        !isBlogListPagination(body.pagination) ||\n        !imagePublicEmbedBaseUrl\n      ) {\n        return { ok: false, status: 500 }\n      }\n      const posts = body.data as BlogPostApiData[]\n      return {\n        ok: true,\n        data: proxyPrefix\n          ? posts.map((post) =>\n              rewritePost(post, imagePublicEmbedBaseUrl, proxyPrefix)\n            )\n          : posts,\n        pagination: body.pagination,\n        imagePublicEmbedBaseUrl,\n        status: fetched.status,\n      }\n    },\n\n    async getPostBySlug(\n      slug: string,\n      locale?: string,\n      options?: MailooBlogFetchOptions\n    ) {\n      const result = await blogGet<BlogPostApiData>(\n        config,\n        `/slug/${encodeURIComponent(slug)}`,\n        locale ? { locale } : undefined,\n        options\n      )\n      if (!result.ok || !proxyPrefix) return result\n      const canonical = result.data.imagePublicEmbedBaseUrl?.trim()\n      if (!canonical) return { ok: false as const, status: 500 }\n      return {\n        ...result,\n        data: rewritePost(result.data, canonical, proxyPrefix),\n      }\n    },\n\n    async getPostJsonLd(\n      slug: string,\n      locale?: string,\n      options?: MailooBlogFetchOptions\n    ) {\n      const result = await blogGet<{ jsonLd: Record<string, unknown> }>(\n        config,\n        `/slug/${encodeURIComponent(slug)}/json-ld`,\n        locale ? { locale } : undefined,\n        options\n      )\n      if (!result.ok || !proxyPrefix) return result\n      const rewritten = rewriteMailooPublicImageUrlsAnyHost(\n        JSON.stringify(result.data.jsonLd),\n        proxyPrefix\n      )\n      try {\n        return {\n          ...result,\n          data: { jsonLd: JSON.parse(rewritten) as Record<string, unknown> },\n        }\n      } catch {\n        return { ok: false as const, status: 500 }\n      }\n    },\n\n    async listCategories(locale?: string, options?: MailooBlogFetchOptions) {\n      return blogGet<BlogCategoryApi[]>(\n        config,\n        '/categories',\n        locale ? { locale } : undefined,\n        options\n      )\n    },\n\n    async listTags(locale?: string, options?: MailooBlogFetchOptions) {\n      return blogGet<BlogTagApi[]>(\n        config,\n        '/tags',\n        locale ? { locale } : undefined,\n        options\n      )\n    },\n\n    async getTagBySlug(\n      slug: string,\n      locale?: string,\n      options?: MailooBlogFetchOptions\n    ) {\n      return blogGet<BlogTagApi>(\n        config,\n        `/tags/slug/${encodeURIComponent(slug)}`,\n        locale ? { locale } : undefined,\n        options\n      )\n    },\n\n    async getCategoryDescription(\n      slug: string,\n      locale?: string,\n      options?: MailooBlogFetchOptions\n    ) {\n      const result = await blogGet<CategoryDescription>(\n        config,\n        `/categories/slug/${encodeURIComponent(slug)}/description`,\n        locale ? { locale } : undefined,\n        options\n      )\n      if (!result.ok || !proxyPrefix) return result\n      const canonical = result.data.imagePublicEmbedBaseUrl?.trim()\n      if (!canonical) return { ok: false as const, status: 500 }\n      const opts = {\n        canonicalPrefixWithIdEquals: canonical,\n        proxyPrefixWithIdEquals: proxyPrefix,\n      }\n      return {\n        ...result,\n        data: {\n          ...result.data,\n          description:\n            typeof result.data.description === 'string'\n              ? rewriteMailooPublicImageUrls(result.data.description, opts)\n              : result.data.description,\n          descriptionHtml:\n            typeof result.data.descriptionHtml === 'string'\n              ? rewriteMailooPublicImageUrls(result.data.descriptionHtml, opts)\n              : result.data.descriptionHtml,\n        },\n      }\n    },\n\n    async setReaction(slug: string, input: SetBlogReactionInput) {\n      return blogPostJson(\n        config,\n        `/slug/${encodeURIComponent(slug)}/reaction`,\n        input\n      )\n    },\n\n    async setFeedback(slug: string, input: SetBlogFeedbackInput) {\n      return blogPostJson(\n        config,\n        `/slug/${encodeURIComponent(slug)}/feedback`,\n        input\n      )\n    },\n  }\n}\n\nexport type MailooBlogClient = ReturnType<typeof createMailooBlogClient>\n","import { unstable_rethrow } from 'next/navigation'\nimport { getRequestOriginBaseUrl } from '@mailoo/next-core/request-origin'\nimport type { BlogPostApiData } from '../types.js'\n\n/**\n * Fetch a blog post via the host app's same-origin BFF\n * (`GET /api/v1/blog/slug/:slug`).\n * Never throws on network / Host / JSON failures — returns `{ ok: false }`.\n */\nexport async function fetchBlogPostBySlug(\n  slug: string,\n  locale: string,\n  options?: { bffBasePath?: string; revalidate?: number }\n): Promise<\n  { ok: true; data: BlogPostApiData } | { ok: false; status: number }\n> {\n  try {\n    const base = await getRequestOriginBaseUrl()\n    const bffBase = options?.bffBasePath ?? '/api/v1/blog'\n    const revalidate = options?.revalidate ?? 60\n    const slugUrl = new URL(\n      `${base}${bffBase}/slug/${encodeURIComponent(slug)}`\n    )\n    if (locale) slugUrl.searchParams.set('locale', locale)\n    const res = await fetch(slugUrl.toString(), {\n      next: { revalidate },\n    } as RequestInit)\n\n    if (!res.ok) {\n      return { ok: false, status: res.status }\n    }\n\n    const json = (await res.json()) as { data?: BlogPostApiData }\n    const data = json?.data\n    if (!data?.id) {\n      return { ok: false, status: 404 }\n    }\n\n    return { ok: true, data }\n  } catch (error) {\n    unstable_rethrow(error)\n    return { ok: false, status: 500 }\n  }\n}\n\n/**\n * Fetch BlogPosting JSON-LD via same-origin BFF.\n * Returns null on any failure (never throws).\n */\nexport async function fetchBlogPostJsonLd(\n  slug: string,\n  locale: string,\n  options?: { bffBasePath?: string; revalidate?: number }\n): Promise<Record<string, unknown> | null> {\n  try {\n    const base = await getRequestOriginBaseUrl()\n    const bffBase = options?.bffBasePath ?? '/api/v1/blog'\n    const revalidate = options?.revalidate ?? 60\n    const url = new URL(\n      `${base}${bffBase}/slug/${encodeURIComponent(slug)}/json-ld`\n    )\n    if (locale) url.searchParams.set('locale', locale)\n    const res = await fetch(url.toString(), {\n      next: { revalidate },\n    } as RequestInit)\n    if (!res.ok) return null\n    const json = (await res.json()) as {\n      data?: { jsonLd?: Record<string, unknown> }\n    }\n    return json?.data?.jsonLd ?? null\n  } catch (error) {\n    unstable_rethrow(error)\n    return null\n  }\n}\n\n/** Replace Mailoo JSON-LD placeholders with site-specific values. */\nexport function applyJsonLdPlaceholders(\n  jsonLd: Record<string, unknown>,\n  vars: { canonicalUrl: string; origin: string; locale: string }\n): Record<string, unknown> {\n  const raw = JSON.stringify(jsonLd)\n  if (!raw.includes('{{canonicalUrl}}') && !raw.includes('{{origin}}')) {\n    return jsonLd\n  }\n  const replaced = raw\n    .replaceAll('{{canonicalUrl}}', vars.canonicalUrl)\n    .replaceAll('{{origin}}', vars.origin)\n    .replaceAll('{{locale}}', vars.locale)\n  return JSON.parse(replaced) as Record<string, unknown>\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,SAAS,wBAAwB;AAEjC,SAAS,mCAAmC;AAC5C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAyBP,IAAM,qBAAqB;AAGpB,SAAS,6BAAsD;AACpE,SAAO,4BAA4B,EAAE,QAAQ,cAAc,CAAC;AAC9D;AAEA,SAAS,aAAa,QAAkC;AACtD,SAAO,GAAG,OAAO,UAAU,gBAAgB,OAAO,UAAU,iBAAiB,OAAO,aAAa;AACnG;AAEA,SAAS,kBAAkB,SAA0C;AACnE,SAAO,SAAS,cAAc;AAChC;AAEA,eAAe,cACb,QACA,MACA,OACA,SAGA;AACA,QAAM,MAAM,IAAI,IAAI,GAAG,aAAa,MAAM,CAAC,GAAG,IAAI,EAAE;AACpD,MAAI,OAAO;AACT,eAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,KAAK,GAAG;AAC1C,UAAI,MAAM,UAAa,MAAM,GAAI,KAAI,aAAa,IAAI,GAAG,CAAC;AAAA,IAC5D;AAAA,EACF;AACA,MAAI;AACF,UAAM,aAAa,kBAAkB,OAAO;AAC5C,UAAM,MAAM,MAAM,MAAM,IAAI,SAAS,GAAG;AAAA,MACtC,QAAQ;AAAA,MACR,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,aAAa,OAAO;AAAA,MACtB;AAAA,MACA,MAAM,EAAE,WAAW;AAAA,IACrB,CAAgB;AAChB,QAAI,CAAC,IAAI,IAAI;AACX,aAAO,EAAE,IAAI,OAAO,QAAQ,IAAI,OAAO;AAAA,IACzC;AACA,WAAO,EAAE,IAAI,MAAM,MAAM,MAAM,IAAI,KAAK,GAAG,QAAQ,IAAI,OAAO;AAAA,EAChE,SAAS,OAAO;AACd,qBAAiB,KAAK;AACtB,WAAO,EAAE,IAAI,OAAO,QAAQ,IAAI;AAAA,EAClC;AACF;AAEA,eAAe,aACb,QACA,MACA,MAIA;AACA,MAAI;AACF,UAAM,MAAM,MAAM,MAAM,GAAG,aAAa,MAAM,CAAC,GAAG,IAAI,IAAI;AAAA,MACxD,QAAQ;AAAA,MACR,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,aAAa,OAAO;AAAA,MACtB;AAAA,MACA,MAAM,KAAK,UAAU,IAAI;AAAA,MACzB,OAAO;AAAA,IACT,CAAC;AACD,QAAI,CAAC,IAAI,IAAI;AACX,aAAO,EAAE,IAAI,OAAO,QAAQ,IAAI,OAAO;AAAA,IACzC;AACA,UAAM,OAAQ,MAAM,IAAI,KAAK;AAC7B,QAAI,CAAC,KAAK,QAAQ,OAAO,KAAK,SAAS,UAAU;AAC/C,aAAO,EAAE,IAAI,OAAO,QAAQ,IAAI;AAAA,IAClC;AACA,WAAO,EAAE,IAAI,MAAM,MAAM,KAAK,MAAM,QAAQ,IAAI,OAAO;AAAA,EACzD,SAAS,OAAO;AACd,qBAAiB,KAAK;AACtB,WAAO,EAAE,IAAI,OAAO,QAAQ,IAAI;AAAA,EAClC;AACF;AAEA,eAAe,QACb,QACA,MACA,OACA,SAGA;AACA,QAAM,UAAU,MAAM,cAAc,QAAQ,MAAM,OAAO,OAAO;AAChE,MAAI,CAAC,QAAQ,GAAI,QAAO;AACxB,QAAM,OAAO,QAAQ;AACrB,QAAM,OACH,KAAsB,SAAS,SAC3B,KAAqB,OACrB;AACP,SAAO,EAAE,IAAI,MAAM,MAAM,QAAQ,QAAQ,OAAO;AAClD;AAEA,SAAS,qBAAqB,OAA6C;AACzE,MAAI,UAAU,QAAQ,OAAO,UAAU,SAAU,QAAO;AACxD,QAAM,IAAI;AACV,SACE,OAAO,EAAE,SAAS,YAClB,OAAO,EAAE,UAAU,YACnB,OAAO,EAAE,UAAU,YACnB,OAAO,EAAE,eAAe,YACxB,OAAO,EAAE,gBAAgB,aACzB,OAAO,EAAE,gBAAgB;AAE7B;AAEA,SAAS,YAAY,OAA0D;AAC7E,QAAM,IAAwC,CAAC;AAC/C,aAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,KAAK,GAAG;AAC1C,QAAI,MAAM,OAAW;AACrB,MAAE,CAAC,IAAI,OAAO,CAAC;AAAA,EACjB;AACA,SAAO;AACT;AAEA,SAAS,iBACP,SACoB;AACpB,QAAM,MAAM,SAAS,8BAA8B,KAAK;AACxD,SAAO,OAAO;AAChB;AAEA,SAAS,YACP,MACA,6BACA,yBACiB;AACjB,SAAO,2BAA2B,MAAM;AAAA,IACtC;AAAA,IACA;AAAA,EACF,CAAC;AACH;AAQO,SAAS,uBACd,QACA,eACA;AACA,QAAM,cAAc,iBAAiB,aAAa;AAClD,SAAO;AAAA,IACL,MAAM,UACJ,QAAuB,CAAC,GACxB,SAUA;AACA,YAAM,UAAU,MAAM;AAAA,QACpB;AAAA,QACA;AAAA,QACA,YAAY,KAAK;AAAA,QACjB;AAAA,MACF;AACA,UAAI,CAAC,QAAQ,GAAI,QAAO;AACxB,YAAM,OAAO,QAAQ;AACrB,UAAI,SAAS,QAAQ,OAAO,SAAS,UAAU;AAC7C,eAAO,EAAE,IAAI,OAAO,QAAQ,IAAI;AAAA,MAClC;AACA,YAAM,OAAO;AAKb,YAAM,0BACJ,OAAO,KAAK,4BAA4B,WACpC,KAAK,wBAAwB,KAAK,IAClC;AACN,UACE,CAAC,MAAM,QAAQ,KAAK,IAAI,KACxB,CAAC,qBAAqB,KAAK,UAAU,KACrC,CAAC,yBACD;AACA,eAAO,EAAE,IAAI,OAAO,QAAQ,IAAI;AAAA,MAClC;AACA,YAAM,QAAQ,KAAK;AACnB,aAAO;AAAA,QACL,IAAI;AAAA,QACJ,MAAM,cACF,MAAM;AAAA,UAAI,CAAC,SACT,YAAY,MAAM,yBAAyB,WAAW;AAAA,QACxD,IACA;AAAA,QACJ,YAAY,KAAK;AAAA,QACjB;AAAA,QACA,QAAQ,QAAQ;AAAA,MAClB;AAAA,IACF;AAAA,IAEA,MAAM,cACJ,MACA,QACA,SACA;AACA,YAAM,SAAS,MAAM;AAAA,QACnB;AAAA,QACA,SAAS,mBAAmB,IAAI,CAAC;AAAA,QACjC,SAAS,EAAE,OAAO,IAAI;AAAA,QACtB;AAAA,MACF;AACA,UAAI,CAAC,OAAO,MAAM,CAAC,YAAa,QAAO;AACvC,YAAM,YAAY,OAAO,KAAK,yBAAyB,KAAK;AAC5D,UAAI,CAAC,UAAW,QAAO,EAAE,IAAI,OAAgB,QAAQ,IAAI;AACzD,aAAO;AAAA,QACL,GAAG;AAAA,QACH,MAAM,YAAY,OAAO,MAAM,WAAW,WAAW;AAAA,MACvD;AAAA,IACF;AAAA,IAEA,MAAM,cACJ,MACA,QACA,SACA;AACA,YAAM,SAAS,MAAM;AAAA,QACnB;AAAA,QACA,SAAS,mBAAmB,IAAI,CAAC;AAAA,QACjC,SAAS,EAAE,OAAO,IAAI;AAAA,QACtB;AAAA,MACF;AACA,UAAI,CAAC,OAAO,MAAM,CAAC,YAAa,QAAO;AACvC,YAAM,YAAY;AAAA,QAChB,KAAK,UAAU,OAAO,KAAK,MAAM;AAAA,QACjC;AAAA,MACF;AACA,UAAI;AACF,eAAO;AAAA,UACL,GAAG;AAAA,UACH,MAAM,EAAE,QAAQ,KAAK,MAAM,SAAS,EAA6B;AAAA,QACnE;AAAA,MACF,QAAQ;AACN,eAAO,EAAE,IAAI,OAAgB,QAAQ,IAAI;AAAA,MAC3C;AAAA,IACF;AAAA,IAEA,MAAM,eAAe,QAAiB,SAAkC;AACtE,aAAO;AAAA,QACL;AAAA,QACA;AAAA,QACA,SAAS,EAAE,OAAO,IAAI;AAAA,QACtB;AAAA,MACF;AAAA,IACF;AAAA,IAEA,MAAM,SAAS,QAAiB,SAAkC;AAChE,aAAO;AAAA,QACL;AAAA,QACA;AAAA,QACA,SAAS,EAAE,OAAO,IAAI;AAAA,QACtB;AAAA,MACF;AAAA,IACF;AAAA,IAEA,MAAM,aACJ,MACA,QACA,SACA;AACA,aAAO;AAAA,QACL;AAAA,QACA,cAAc,mBAAmB,IAAI,CAAC;AAAA,QACtC,SAAS,EAAE,OAAO,IAAI;AAAA,QACtB;AAAA,MACF;AAAA,IACF;AAAA,IAEA,MAAM,uBACJ,MACA,QACA,SACA;AACA,YAAM,SAAS,MAAM;AAAA,QACnB;AAAA,QACA,oBAAoB,mBAAmB,IAAI,CAAC;AAAA,QAC5C,SAAS,EAAE,OAAO,IAAI;AAAA,QACtB;AAAA,MACF;AACA,UAAI,CAAC,OAAO,MAAM,CAAC,YAAa,QAAO;AACvC,YAAM,YAAY,OAAO,KAAK,yBAAyB,KAAK;AAC5D,UAAI,CAAC,UAAW,QAAO,EAAE,IAAI,OAAgB,QAAQ,IAAI;AACzD,YAAM,OAAO;AAAA,QACX,6BAA6B;AAAA,QAC7B,yBAAyB;AAAA,MAC3B;AACA,aAAO;AAAA,QACL,GAAG;AAAA,QACH,MAAM;AAAA,UACJ,GAAG,OAAO;AAAA,UACV,aACE,OAAO,OAAO,KAAK,gBAAgB,WAC/B,6BAA6B,OAAO,KAAK,aAAa,IAAI,IAC1D,OAAO,KAAK;AAAA,UAClB,iBACE,OAAO,OAAO,KAAK,oBAAoB,WACnC,6BAA6B,OAAO,KAAK,iBAAiB,IAAI,IAC9D,OAAO,KAAK;AAAA,QACpB;AAAA,MACF;AAAA,IACF;AAAA,IAEA,MAAM,YAAY,MAAc,OAA6B;AAC3D,aAAO;AAAA,QACL;AAAA,QACA,SAAS,mBAAmB,IAAI,CAAC;AAAA,QACjC;AAAA,MACF;AAAA,IACF;AAAA,IAEA,MAAM,YAAY,MAAc,OAA6B;AAC3D,aAAO;AAAA,QACL;AAAA,QACA,SAAS,mBAAmB,IAAI,CAAC;AAAA,QACjC;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;;;AC5WA,SAAS,oBAAAA,yBAAwB;AACjC,SAAS,+BAA+B;AAQxC,eAAsB,oBACpB,MACA,QACA,SAGA;AACA,MAAI;AACF,UAAM,OAAO,MAAM,wBAAwB;AAC3C,UAAM,UAAU,SAAS,eAAe;AACxC,UAAM,aAAa,SAAS,cAAc;AAC1C,UAAM,UAAU,IAAI;AAAA,MAClB,GAAG,IAAI,GAAG,OAAO,SAAS,mBAAmB,IAAI,CAAC;AAAA,IACpD;AACA,QAAI,OAAQ,SAAQ,aAAa,IAAI,UAAU,MAAM;AACrD,UAAM,MAAM,MAAM,MAAM,QAAQ,SAAS,GAAG;AAAA,MAC1C,MAAM,EAAE,WAAW;AAAA,IACrB,CAAgB;AAEhB,QAAI,CAAC,IAAI,IAAI;AACX,aAAO,EAAE,IAAI,OAAO,QAAQ,IAAI,OAAO;AAAA,IACzC;AAEA,UAAM,OAAQ,MAAM,IAAI,KAAK;AAC7B,UAAM,OAAO,MAAM;AACnB,QAAI,CAAC,MAAM,IAAI;AACb,aAAO,EAAE,IAAI,OAAO,QAAQ,IAAI;AAAA,IAClC;AAEA,WAAO,EAAE,IAAI,MAAM,KAAK;AAAA,EAC1B,SAAS,OAAO;AACd,IAAAA,kBAAiB,KAAK;AACtB,WAAO,EAAE,IAAI,OAAO,QAAQ,IAAI;AAAA,EAClC;AACF;AAMA,eAAsB,oBACpB,MACA,QACA,SACyC;AACzC,MAAI;AACF,UAAM,OAAO,MAAM,wBAAwB;AAC3C,UAAM,UAAU,SAAS,eAAe;AACxC,UAAM,aAAa,SAAS,cAAc;AAC1C,UAAM,MAAM,IAAI;AAAA,MACd,GAAG,IAAI,GAAG,OAAO,SAAS,mBAAmB,IAAI,CAAC;AAAA,IACpD;AACA,QAAI,OAAQ,KAAI,aAAa,IAAI,UAAU,MAAM;AACjD,UAAM,MAAM,MAAM,MAAM,IAAI,SAAS,GAAG;AAAA,MACtC,MAAM,EAAE,WAAW;AAAA,IACrB,CAAgB;AAChB,QAAI,CAAC,IAAI,GAAI,QAAO;AACpB,UAAM,OAAQ,MAAM,IAAI,KAAK;AAG7B,WAAO,MAAM,MAAM,UAAU;AAAA,EAC/B,SAAS,OAAO;AACd,IAAAA,kBAAiB,KAAK;AACtB,WAAO;AAAA,EACT;AACF;AAGO,SAAS,wBACd,QACA,MACyB;AACzB,QAAM,MAAM,KAAK,UAAU,MAAM;AACjC,MAAI,CAAC,IAAI,SAAS,kBAAkB,KAAK,CAAC,IAAI,SAAS,YAAY,GAAG;AACpE,WAAO;AAAA,EACT;AACA,QAAM,WAAW,IACd,WAAW,oBAAoB,KAAK,YAAY,EAChD,WAAW,cAAc,KAAK,MAAM,EACpC,WAAW,cAAc,KAAK,MAAM;AACvC,SAAO,KAAK,MAAM,QAAQ;AAC5B;;;ACtFA,IAAM,eAAe;AACrB,IAAM,WAAW;AAEjB,SAAS,aAAa,KAA4B;AAChD,QAAM,IAAI,IAAI,KAAK;AACnB,MAAI,CAAC,EAAG,QAAO;AACf,MACE,EAAE,WAAW,SAAS,KACtB,EAAE,WAAW,UAAU,KACvB,EAAE,WAAW,GAAG,GAChB;AACA,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAEO,SAAS,8BACd,aACA,iBACe;AACf,MAAI,aAAa;AACf,UAAM,IAAI,YAAY,MAAM,YAAY;AACxC,QAAI,IAAI,CAAC,GAAG;AACV,YAAM,MAAM,aAAa,EAAE,CAAC,CAAC;AAC7B,UAAI,IAAK,QAAO;AAAA,IAClB;AAAA,EACF;AACA,MAAI,iBAAiB;AACnB,UAAM,IAAI,gBAAgB,MAAM,QAAQ;AACxC,QAAI,IAAI,CAAC,GAAG;AACV,YAAM,MAAM,aAAa,EAAE,CAAC,CAAC;AAC7B,UAAI,IAAK,QAAO;AAAA,IAClB;AAAA,EACF;AACA,SAAO;AACT;AAMO,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;","names":["unstable_rethrow"]}

package/dist/utils-DXbN9MTi.d.cts

@@ -0,0 +1,120 @@
+/** Item in `linkedLinks` on slug detail responses (blog external API). */
+interface BlogPostLinkedLinkApi {
+    id: string;
+    type: 'internal_article' | 'update_announcement' | 'external_resource';
+    label: string;
+    url: string;
+    intro: string | null;
+    date: string | null;
+    sortOrder: number;
+}
+type BlogPostReactionSentiment = 'LIKE' | 'DISLIKE';
+type BlogArticleMarkCounts = {
+    likeCount: number;
+    dislikeCount: number;
+    feedbackCount: number;
+};
+type BlogArticleMarkState = BlogArticleMarkCounts & {
+    sentiment: BlogPostReactionSentiment | null;
+    hasFeedback: boolean;
+};
+type SetBlogReactionInput = {
+    visitorKey: string;
+    action: 'set' | 'clear';
+    sentiment?: BlogPostReactionSentiment;
+    comment?: string;
+    locale?: string;
+};
+type SetBlogFeedbackInput = {
+    visitorKey: string;
+    action: 'set' | 'clear';
+    comment?: string;
+    locale?: string;
+};
+/** Raw article payload from BFF / Mailoo blog API */
+interface BlogPostApiData {
+    id: string;
+    title: string;
+    slug: string;
+    excerpt?: string | null;
+    content: string;
+    htmlContent?: string | null;
+    publishedAt?: string | null;
+    createdAt: string;
+    author?: {
+        id?: string;
+        name?: string | null;
+        email?: string | null;
+        avatar?: string | null;
+        bio?: string | null;
+    };
+    category?: string | {
+        id: string;
+        slug: string;
+        name: string;
+    } | null;
+    readTime?: string | null;
+    readTimeMinutes?: number | null;
+    /** Page visits from external GET slug; not incremented by BFF/MCP reads. */
+    accessCount?: number;
+    /** Present on slug detail; optional on list. */
+    likeCount?: number;
+    dislikeCount?: number;
+    feedbackCount?: number;
+    tags?: BlogTagApi[];
+    metaTitle?: string | null;
+    metaDescription?: string | null;
+    ogImageUrl?: string | null;
+    canonicalUrl?: string | null;
+    /** Canonical embed prefix (`…/images/public/content?id=`). Not anonymously fetchable. */
+    imagePublicEmbedBaseUrl?: string;
+    seoWords?: Array<{
+        slug: string;
+        word: string;
+    }>;
+    linkedLinks?: BlogPostLinkedLinkApi[];
+}
+interface BlogCategoryApi {
+    id: string;
+    slug: string;
+    name: string;
+}
+interface BlogTagApi {
+    slug: string;
+    name: string;
+}
+interface BlogListQuery {
+    locale?: string;
+    limit?: number;
+    page?: number;
+    categoryId?: string;
+    category?: string;
+    intentId?: string;
+    audienceId?: string;
+    seoClusterId?: string;
+    tag?: string;
+    [key: string]: string | number | undefined;
+}
+/** Pagination sibling on the external blog list envelope. */
+type BlogListPagination = {
+    page: number;
+    limit: number;
+    total: number;
+    totalPages: number;
+    hasNextPage: boolean;
+    hasPrevPage: boolean;
+};
+/** ISR / cache hint for direct Mailoo API fetches (Next.js `fetch`). */
+type MailooBlogFetchOptions = {
+    /** Seconds; default 60. Pass 0 to skip ISR. */
+    revalidate?: number;
+};
+
+declare function firstEmbedImageUrlFromArticle(htmlContent: string | null | undefined, markdownContent: string | null | undefined): string | null;
+/**
+ * Default Tailwind Typography class string for article body.
+ * Hosts may pass a custom `className` instead.
+ */
+declare const BLOG_ARTICLE_PROSE_CLASSNAME: string;
+
+export { type BlogPostApiData as B, type MailooBlogFetchOptions as M, type SetBlogReactionInput as S, type BlogPostLinkedLinkApi as a, type BlogCategoryApi as b, type BlogTagApi as c, type BlogListQuery as d, type BlogListPagination as e, type BlogPostReactionSentiment as f, type BlogArticleMarkCounts as g, type BlogArticleMarkState as h, type SetBlogFeedbackInput as i, BLOG_ARTICLE_PROSE_CLASSNAME as j, firstEmbedImageUrlFromArticle as k };

package/dist/utils-DXbN9MTi.d.ts

@@ -0,0 +1,120 @@
+/** Item in `linkedLinks` on slug detail responses (blog external API). */
+interface BlogPostLinkedLinkApi {
+    id: string;
+    type: 'internal_article' | 'update_announcement' | 'external_resource';
+    label: string;
+    url: string;
+    intro: string | null;
+    date: string | null;
+    sortOrder: number;
+}
+type BlogPostReactionSentiment = 'LIKE' | 'DISLIKE';
+type BlogArticleMarkCounts = {
+    likeCount: number;
+    dislikeCount: number;
+    feedbackCount: number;
+};
+type BlogArticleMarkState = BlogArticleMarkCounts & {
+    sentiment: BlogPostReactionSentiment | null;
+    hasFeedback: boolean;
+};
+type SetBlogReactionInput = {
+    visitorKey: string;
+    action: 'set' | 'clear';
+    sentiment?: BlogPostReactionSentiment;
+    comment?: string;
+    locale?: string;
+};
+type SetBlogFeedbackInput = {
+    visitorKey: string;
+    action: 'set' | 'clear';
+    comment?: string;
+    locale?: string;
+};
+/** Raw article payload from BFF / Mailoo blog API */
+interface BlogPostApiData {
+    id: string;
+    title: string;
+    slug: string;
+    excerpt?: string | null;
+    content: string;
+    htmlContent?: string | null;
+    publishedAt?: string | null;
+    createdAt: string;
+    author?: {
+        id?: string;
+        name?: string | null;
+        email?: string | null;
+        avatar?: string | null;
+        bio?: string | null;
+    };
+    category?: string | {
+        id: string;
+        slug: string;
+        name: string;
+    } | null;
+    readTime?: string | null;
+    readTimeMinutes?: number | null;
+    /** Page visits from external GET slug; not incremented by BFF/MCP reads. */
+    accessCount?: number;
+    /** Present on slug detail; optional on list. */
+    likeCount?: number;
+    dislikeCount?: number;
+    feedbackCount?: number;
+    tags?: BlogTagApi[];
+    metaTitle?: string | null;
+    metaDescription?: string | null;
+    ogImageUrl?: string | null;
+    canonicalUrl?: string | null;
+    /** Canonical embed prefix (`…/images/public/content?id=`). Not anonymously fetchable. */
+    imagePublicEmbedBaseUrl?: string;
+    seoWords?: Array<{
+        slug: string;
+        word: string;
+    }>;
+    linkedLinks?: BlogPostLinkedLinkApi[];
+}
+interface BlogCategoryApi {
+    id: string;
+    slug: string;
+    name: string;
+}
+interface BlogTagApi {
+    slug: string;
+    name: string;
+}
+interface BlogListQuery {
+    locale?: string;
+    limit?: number;
+    page?: number;
+    categoryId?: string;
+    category?: string;
+    intentId?: string;
+    audienceId?: string;
+    seoClusterId?: string;
+    tag?: string;
+    [key: string]: string | number | undefined;
+}
+/** Pagination sibling on the external blog list envelope. */
+type BlogListPagination = {
+    page: number;
+    limit: number;
+    total: number;
+    totalPages: number;
+    hasNextPage: boolean;
+    hasPrevPage: boolean;
+};
+/** ISR / cache hint for direct Mailoo API fetches (Next.js `fetch`). */
+type MailooBlogFetchOptions = {
+    /** Seconds; default 60. Pass 0 to skip ISR. */
+    revalidate?: number;
+};
+
+declare function firstEmbedImageUrlFromArticle(htmlContent: string | null | undefined, markdownContent: string | null | undefined): string | null;
+/**
+ * Default Tailwind Typography class string for article body.
+ * Hosts may pass a custom `className` instead.
+ */
+declare const BLOG_ARTICLE_PROSE_CLASSNAME: string;
+
+export { type BlogPostApiData as B, type MailooBlogFetchOptions as M, type SetBlogReactionInput as S, type BlogPostLinkedLinkApi as a, type BlogCategoryApi as b, type BlogTagApi as c, type BlogListQuery as d, type BlogListPagination as e, type BlogPostReactionSentiment as f, type BlogArticleMarkCounts as g, type BlogArticleMarkState as h, type SetBlogFeedbackInput as i, BLOG_ARTICLE_PROSE_CLASSNAME as j, firstEmbedImageUrlFromArticle as k };

package/package.json

@@ -1,6 +1,113 @@
 {
   "name": "@mailoo/blog",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.33.0",
+  "description": "Headless Mailoo Blog module for Next.js (BFF routes, server client, components)",
+  "license": "LicenseRef-Mailoo-NoModification",
+  "homepage": "https://mailoo.app/en/support/docs/integrations/nextjs-packages",
+  "keywords": [
+    "mailoo",
+    "nextjs",
+    "blog"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.js",
+      "require": "./dist/server/index.cjs"
+    },
+    "./routes": {
+      "types": "./dist/routes/index.d.ts",
+      "import": "./dist/routes/index.js",
+      "require": "./dist/routes/index.cjs"
+    },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "import": "./dist/client/index.js",
+      "require": "./dist/client/index.cjs"
+    },
+    "./client/article-body": {
+      "types": "./dist/client/article-body.d.ts",
+      "import": "./dist/client/article-body.js",
+      "require": "./dist/client/article-body.cjs"
+    },
+    "./client/linked-links": {
+      "types": "./dist/client/linked-links.d.ts",
+      "import": "./dist/client/linked-links.js",
+      "require": "./dist/client/linked-links.cjs"
+    },
+    "./client/printable": {
+      "types": "./dist/client/printable.d.ts",
+      "import": "./dist/client/printable.js",
+      "require": "./dist/client/printable.cjs"
+    },
+    "./client/marks": {
+      "types": "./dist/client/marks.d.ts",
+      "import": "./dist/client/marks.js",
+      "require": "./dist/client/marks.cjs"
+    },
+    "./client/share": {
+      "types": "./dist/client/share.d.ts",
+      "import": "./dist/client/share.js",
+      "require": "./dist/client/share.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@mailoo/images": "1.33.0"
+  },
+  "peerDependencies": {
+    "@mailoo/next-core": "^1.18.4",
+    "next": ">=16.3.4",
+    "react": ">=18.3.1",
+    "react-dom": ">=18.3.1",
+    "react-markdown": ">=9.1.0",
+    "remark-gfm": ">=4.0.1"
+  },
+  "peerDependenciesMeta": {
+    "react-markdown": {
+      "optional": true
+    },
+    "remark-gfm": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@mailoo/next-core": "1.33.0",
+    "@types/node": "^25.9.5",
+    "@types/react": "^19.2.18",
+    "next": "^16.3.4",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
+    "react-markdown": "^10.1.0",
+    "remark-gfm": "^4.0.1",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.10"
+  },
+  "engines": {
+    "node": ">=20.20.2"
+  },
+  "scripts": {
+    "build": "tsup",
+    "clean": "rm -rf dist .turbo",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "type-check": "tsc --noEmit"
+  }
 }