@reblu/site-next 1.17.0 → 1.19.0

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @reblu/site-next
 
+## 1.19.0
+
+### Minor Changes
+
+- fd17765: `@reblu/site-next/seo`: home / site-level metadata (REB-651). `buildMetadata({ config, home: true })` titles the home page with the site `seoTitle` as-is (never suffixed by the template; empty → `siteName`), describes it with `seoDescription` (empty → `siteDescription`), and turns a valid `canonicalUrl` into `metadataBase` plus `alternates.canonical`, so relative Open Graph paths resolve. New helpers: `resolveSiteSeoTitle`, `resolveSiteSeoDescription`, `validateCanonicalUrl` and `normalizeCanonicalUrl`.
+
+### Patch Changes
+
+- Updated dependencies [fd17765]
+  - @reblu/site-contracts@1.12.0
+
+## 1.18.0
+
+### Minor Changes
+
+- e4dff25: New `@reblu/site-next/seo` subpath (REB-871) — the one page-title rule, shared with the Reblu SITE API. `resolveSeoTitle({ seoTitle, title, sectionLabel }, { template, siteName })`: a non-empty entity SEO title is used as-is (never suffixed); otherwise the tenant template (`Config.seoTitleTemplate`, default `%s | {siteName}`) is applied exactly once to the display title or the list route's section label, and the brand is never duplicated. `buildMetadata({ seo, config, ... })` returns Next `Metadata` with an absolute title (a root-layout `title.template` can no longer append the brand twice). Also exports `DEFAULT_SEO_TITLE_TEMPLATE`, `validateSeoTitleTemplate` and `resolveSeoTitleTemplate`. Dependency-free, no `'use client'`.
+
+### Patch Changes
+
+- Updated dependencies [e4dff25]
+  - @reblu/site-contracts@1.11.0
+
 ## 1.17.0
 
 ### Minor Changes

package/README.md

@@ -642,6 +642,83 @@ whitespace-only value for any key the same as `undefined` — it always falls
 back to that key's default rather than rendering empty. There is no need to
 `?.trim()` a value before passing it.
 
+## Page titles — `buildMetadata` (REB-871)
+
+`@reblu/site-next/seo` (dependency-free, no `'use client'`) holds the one
+page-title rule the Reblu SITE API also applies server-side:
+
+- an entity SEO title (`seoTitle` / `metaTitle`) that is set is the **whole**
+  title — used as-is, the site name is never appended;
+- otherwise the tenant template (`config.seoTitleTemplate`, default
+  `%s | {siteName}`) is applied **once** to the display title — or to the
+  section label on a list/index route;
+- the brand is never duplicated.
+
+Detail endpoints already return `seo.title` resolved, so a detail route is a
+drop-in:
+
+```ts
+// app/servicios/[slug]/page.tsx
+import type { Metadata } from 'next'
+import { buildMetadata } from '@reblu/site-next/seo'
+
+export async function generateMetadata({ params }): Promise<Metadata> {
+  const { slug } = await params
+  const [page, config] = await Promise.all([reblu.pages.bySlug(slug), reblu.config.get()])
+  return buildMetadata({ seo: page.seo, title: page.title, seoTitle: page.seoTitle, config })
+}
+
+// app/blog/page.tsx — list/index route: the template with the section label
+export async function generateMetadata(): Promise<Metadata> {
+  return buildMetadata({ sectionLabel: 'Blog', config: await reblu.config.get() })
+}
+```
+
+`buildMetadata` emits `title: { absolute }`, so a `title.template` in the root
+layout can never append the brand a second time — drop any hand-written
+`` `${title} · Brand` `` from your routes. Passing `title`/`seoTitle` alongside
+`seo` keeps the route correct against an older API that does not send `seo`
+yet. Need the string only? `resolveSeoTitle({ seoTitle, title, sectionLabel },
+{ template: config.seoTitleTemplate, siteName: config.siteName })`.
+Description/Open Graph are intentionally minimal here (REB-823 extends them).
+
+### Home page and canonical URL — `buildMetadata({ config, home: true })` (REB-651)
+
+The site has its own search title and description in nexus (Ajustes → SEO y
+Redes), separate from `siteName`/`siteDescription`, which stay the identity
+used in breadcrumbs and chrome. `GET /api/site/config` serves them as
+`seoTitle`, `seoDescription` and `canonicalUrl` (all `null` when unset).
+
+```ts
+// app/page.tsx — the home page: no hardcoded title, description or domain
+import type { Metadata } from 'next'
+import { buildMetadata } from '@reblu/site-next/seo'
+
+export async function generateMetadata(): Promise<Metadata> {
+  return buildMetadata({ config: await reblu.config.get(), home: true })
+}
+
+// app/layout.tsx — every route resolves relative Open Graph paths against it
+import { normalizeCanonicalUrl } from '@reblu/site-next/seo'
+
+export async function generateMetadata(): Promise<Metadata> {
+  const config = await reblu.config.get()
+  const siteUrl = normalizeCanonicalUrl(config.canonicalUrl) ?? process.env.NEXT_PUBLIC_SITE_URL!
+  return { metadataBase: new URL(siteUrl) /* , title, openGraph… */ }
+}
+```
+
+- `config.seoTitle`, when set, is the **whole** home title — used as-is, never
+  suffixed by the template. Empty → `siteName`, exactly as before.
+- `config.seoDescription` falls back to `siteDescription`.
+- A valid `config.canonicalUrl` (an `https` origin) becomes `metadataBase`
+  plus `alternates.canonical: '/'`, so an `ogImageUrl` given as a relative
+  path resolves against the site's domain. The env var becomes a fallback.
+
+`home: true` is explicit: a route whose title happens to be empty never picks
+up the site's SEO title. Need the strings only? `resolveSiteSeoTitle(config)`
+and `resolveSiteSeoDescription(config)`.
+
 ## Structured data (JSON-LD)
 
 `@reblu/site-next/json-ld` (REB-622, server-only, dependency-free) renders one

package/dist/seo.cjs

@@ -0,0 +1,147 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/seo.ts
+var seo_exports = {};
+__export(seo_exports, {
+  DEFAULT_SEO_TITLE_TEMPLATE: () => DEFAULT_SEO_TITLE_TEMPLATE,
+  SEO_SITE_NAME_PLACEHOLDER: () => SEO_SITE_NAME_PLACEHOLDER,
+  SEO_TITLE_PLACEHOLDER: () => SEO_TITLE_PLACEHOLDER,
+  SEO_TITLE_RECOMMENDED_MAX_LENGTH: () => SEO_TITLE_RECOMMENDED_MAX_LENGTH,
+  SEO_TITLE_TEMPLATE_MAX_LENGTH: () => SEO_TITLE_TEMPLATE_MAX_LENGTH,
+  buildMetadata: () => buildMetadata,
+  normalizeCanonicalUrl: () => normalizeCanonicalUrl,
+  resolveSeoTitle: () => resolveSeoTitle,
+  resolveSeoTitleTemplate: () => resolveSeoTitleTemplate,
+  resolveSiteSeoDescription: () => resolveSiteSeoDescription,
+  resolveSiteSeoTitle: () => resolveSiteSeoTitle,
+  validateCanonicalUrl: () => validateCanonicalUrl,
+  validateSeoTitleTemplate: () => validateSeoTitleTemplate
+});
+module.exports = __toCommonJS(seo_exports);
+var DEFAULT_SEO_TITLE_TEMPLATE = "%s | {siteName}";
+var SEO_TITLE_PLACEHOLDER = "%s";
+var SEO_SITE_NAME_PLACEHOLDER = "{siteName}";
+var SEO_TITLE_TEMPLATE_MAX_LENGTH = 60;
+var SEO_TITLE_RECOMMENDED_MAX_LENGTH = 60;
+function validateSeoTitleTemplate(template) {
+  const occurrences = template.split(SEO_TITLE_PLACEHOLDER).length - 1;
+  if (occurrences === 0) return "missing_placeholder";
+  if (occurrences > 1) return "multiple_placeholders";
+  if (template.length > SEO_TITLE_TEMPLATE_MAX_LENGTH) return "too_long";
+  return null;
+}
+function resolveSeoTitleTemplate(template) {
+  const trimmed = template?.trim() ?? "";
+  if (trimmed && validateSeoTitleTemplate(trimmed) === null) return trimmed;
+  return DEFAULT_SEO_TITLE_TEMPLATE;
+}
+var WORD_CHAR_AT_END = /[\p{L}\p{N}\p{M}]$/u;
+var WORD_CHAR_AT_START = /^[\p{L}\p{N}\p{M}]/u;
+function containsPhrase(text, phrase) {
+  const haystack = text.toLocaleLowerCase();
+  const needle = phrase.toLocaleLowerCase();
+  for (let i = haystack.indexOf(needle); i !== -1; i = haystack.indexOf(needle, i + 1)) {
+    const before = haystack.slice(0, i);
+    const after = haystack.slice(i + needle.length);
+    if (!WORD_CHAR_AT_END.test(before) && !WORD_CHAR_AT_START.test(after)) return true;
+  }
+  return false;
+}
+function resolveSeoTitle(input, context) {
+  const asIs = input.seoTitle?.trim();
+  if (asIs) return asIs;
+  const siteName = context.siteName?.trim() ?? "";
+  const display = input.title?.trim() || input.sectionLabel?.trim() || "";
+  if (!display) return siteName;
+  const template = resolveSeoTitleTemplate(context.template);
+  if (template.includes(SEO_SITE_NAME_PLACEHOLDER)) {
+    if (!siteName) return display;
+    if (containsPhrase(display, siteName)) return display;
+  }
+  const [before = "", after = ""] = template.split(SEO_TITLE_PLACEHOLDER);
+  const brand = (part) => part.split(SEO_SITE_NAME_PLACEHOLDER).join(siteName);
+  return `${brand(before)}${display}${brand(after)}`.trim();
+}
+function validateCanonicalUrl(value) {
+  const trimmed = value.trim();
+  let url;
+  try {
+    url = new URL(trimmed);
+  } catch {
+    return "invalid";
+  }
+  if (url.protocol !== "https:") return "not_https";
+  if (url.username || url.password || url.search || url.hash || /[?#]/.test(trimmed)) {
+    return "not_origin";
+  }
+  if (url.pathname.replace(/\/+$/, "") !== "") return "not_origin";
+  return null;
+}
+function normalizeCanonicalUrl(value) {
+  const trimmed = value?.trim();
+  if (!trimmed || validateCanonicalUrl(trimmed) !== null) return null;
+  return new URL(trimmed).origin;
+}
+function resolveSiteSeoTitle(config) {
+  return config.seoTitle?.trim() || config.siteName?.trim() || "";
+}
+function resolveSiteSeoDescription(config) {
+  return config.seoDescription?.trim() || config.siteDescription?.trim() || "";
+}
+function buildMetadata(input) {
+  if (input.home) return buildSiteMetadata(input);
+  const title = input.seo?.title?.trim() || resolveSeoTitle(input, {
+    template: input.config.seoTitleTemplate,
+    siteName: input.config.siteName
+  });
+  const metadata = {};
+  if (title) metadata.title = { absolute: title };
+  const description = input.description?.trim();
+  if (description) metadata.description = description;
+  return metadata;
+}
+function buildSiteMetadata(input) {
+  const metadata = {};
+  const canonicalUrl = normalizeCanonicalUrl(input.config.canonicalUrl);
+  if (canonicalUrl) metadata.metadataBase = new URL(canonicalUrl);
+  const title = resolveSiteSeoTitle(input.config);
+  if (title) metadata.title = { absolute: title };
+  const description = input.description?.trim() || resolveSiteSeoDescription(input.config);
+  if (description) metadata.description = description;
+  if (canonicalUrl) metadata.alternates = { canonical: "/" };
+  return metadata;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_SEO_TITLE_TEMPLATE,
+  SEO_SITE_NAME_PLACEHOLDER,
+  SEO_TITLE_PLACEHOLDER,
+  SEO_TITLE_RECOMMENDED_MAX_LENGTH,
+  SEO_TITLE_TEMPLATE_MAX_LENGTH,
+  buildMetadata,
+  normalizeCanonicalUrl,
+  resolveSeoTitle,
+  resolveSeoTitleTemplate,
+  resolveSiteSeoDescription,
+  resolveSiteSeoTitle,
+  validateCanonicalUrl,
+  validateSeoTitleTemplate
+});
+//# sourceMappingURL=seo.cjs.map

package/dist/seo.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/seo.ts"],"sourcesContent":["/**\n * `@reblu/site-next/seo` — the ONE page-title rule (REB-871), shared by the\n * Reblu SITE API (which serves `seo.title` already resolved on every detail\n * endpoint) and by SITEs (index/list routes, or an older API without `seo`).\n *\n * The rule, in order:\n *   1. An entity SEO title (`seoTitle` / `metaTitle`) that is non-empty after\n *      trimming is the WHOLE title — used as-is, never suffixed.\n *   2. Otherwise the tenant template (`SiteSettings.seoTitleTemplate`, default\n *      `%s | {siteName}`) is applied ONCE to the display title — the entity\n *      title on a detail route, the section label on a list/index route.\n *   3. The brand is never duplicated: a display title that already names the\n *      site is used alone, and a site with no name drops the brand part.\n *\n * Own tsup entry with ZERO runtime dependencies (no React, no `next` — only\n * the `Metadata` TYPE) so base-api can import it server-side and a SITE can\n * call it from `generateMetadata` with no RSC-boundary cost. It must never\n * carry `'use client'`.\n */\nimport type { Metadata } from 'next'\n\n/** Applied when the tenant never chose a template (`seoTitleTemplate` NULL). */\nexport const DEFAULT_SEO_TITLE_TEMPLATE = '%s | {siteName}'\n/** The display-title placeholder — must appear exactly once in a template. */\nexport const SEO_TITLE_PLACEHOLDER = '%s'\n/** Optional brand placeholder, replaced by `siteName`. */\nexport const SEO_SITE_NAME_PLACEHOLDER = '{siteName}'\n/** Upper bound for a stored template (write-side validation). */\nexport const SEO_TITLE_TEMPLATE_MAX_LENGTH = 60\n/** Recommended length of a full page title in search results. */\nexport const SEO_TITLE_RECOMMENDED_MAX_LENGTH = 60\n\nexport type SeoTitleTemplateIssue = 'missing_placeholder' | 'multiple_placeholders' | 'too_long'\n\n/** `null` when `template` is a valid title template, otherwise why it is not. */\nexport function validateSeoTitleTemplate(template: string): SeoTitleTemplateIssue | null {\n  const occurrences = template.split(SEO_TITLE_PLACEHOLDER).length - 1\n  if (occurrences === 0) return 'missing_placeholder'\n  if (occurrences > 1) return 'multiple_placeholders'\n  if (template.length > SEO_TITLE_TEMPLATE_MAX_LENGTH) return 'too_long'\n  return null\n}\n\n/**\n * The template to apply: the stored one (trimmed) when valid, otherwise the\n * default. An invalid stored value (hand-edited row) degrades to the default\n * instead of producing a broken title.\n */\nexport function resolveSeoTitleTemplate(template: string | null | undefined): string {\n  const trimmed = template?.trim() ?? ''\n  if (trimmed && validateSeoTitleTemplate(trimmed) === null) return trimmed\n  return DEFAULT_SEO_TITLE_TEMPLATE\n}\n\nexport interface SeoTitleInput {\n  /** Entity SEO title (`seoTitle` on pages, `metaTitle` on posts/products/courses). */\n  seoTitle?: string | null\n  /** Display title of the entity (detail routes). */\n  title?: string | null\n  /** Label of a list/index route (e.g. \"Blog\"), used when there is no entity title. */\n  sectionLabel?: string | null\n}\n\nexport interface SeoTitleContext {\n  /** `Config.seoTitleTemplate` — null/undefined/invalid → the default. */\n  template?: string | null\n  /** `Config.siteName`. */\n  siteName?: string | null\n}\n\n/** A letter, digit or combining mark — accents included (Unicode-aware). */\nconst WORD_CHAR_AT_END = /[\\p{L}\\p{N}\\p{M}]$/u\nconst WORD_CHAR_AT_START = /^[\\p{L}\\p{N}\\p{M}]/u\n\n/**\n * Whether `phrase` occurs in `text` as a whole word/phrase (case-insensitive):\n * the brand \"Arte\" is in \"Galería Arte\" but not in \"Cartera\" or \"Artesanía\".\n */\nfunction containsPhrase(text: string, phrase: string): boolean {\n  const haystack = text.toLocaleLowerCase()\n  const needle = phrase.toLocaleLowerCase()\n  for (let i = haystack.indexOf(needle); i !== -1; i = haystack.indexOf(needle, i + 1)) {\n    const before = haystack.slice(0, i)\n    const after = haystack.slice(i + needle.length)\n    if (!WORD_CHAR_AT_END.test(before) && !WORD_CHAR_AT_START.test(after)) return true\n  }\n  return false\n}\n\nexport function resolveSeoTitle(input: SeoTitleInput, context: SeoTitleContext): string {\n  const asIs = input.seoTitle?.trim()\n  if (asIs) return asIs\n\n  const siteName = context.siteName?.trim() ?? ''\n  const display = input.title?.trim() || input.sectionLabel?.trim() || ''\n  if (!display) return siteName\n\n  const template = resolveSeoTitleTemplate(context.template)\n  if (template.includes(SEO_SITE_NAME_PLACEHOLDER)) {\n    if (!siteName) return display\n    if (containsPhrase(display, siteName)) return display\n  }\n\n  // Split on the placeholder BEFORE inserting the display title, so the title\n  // itself is never scanned for placeholders (applied exactly once) and no\n  // `String.replace` special pattern (`$&`, `$1`) can reach it.\n  const [before = '', after = ''] = template.split(SEO_TITLE_PLACEHOLDER)\n  const brand = (part: string) => part.split(SEO_SITE_NAME_PLACEHOLDER).join(siteName)\n  return `${brand(before)}${display}${brand(after)}`.trim()\n}\n\nexport type CanonicalUrlIssue = 'invalid' | 'not_https' | 'not_origin'\n\n/**\n * REB-651 — `null` when `value` is a valid canonical site URL: an absolute\n * `https` origin, with nothing after the host but optional trailing slashes\n * (no path, query, fragment or credentials). Otherwise why it is not.\n */\nexport function validateCanonicalUrl(value: string): CanonicalUrlIssue | null {\n  const trimmed = value.trim()\n  let url: URL\n  try {\n    url = new URL(trimmed)\n  } catch {\n    return 'invalid'\n  }\n  if (url.protocol !== 'https:') return 'not_https'\n  // `?` / `#` with nothing after them parse to an empty search/hash, so the\n  // raw string is checked as well: a bare `?` is still not an origin.\n  if (url.username || url.password || url.search || url.hash || /[?#]/.test(trimmed)) {\n    return 'not_origin'\n  }\n  if (url.pathname.replace(/\\/+$/, '') !== '') return 'not_origin'\n  return null\n}\n\n/**\n * The stored/served form of a canonical site URL: the origin with no trailing\n * slash (`https://example.com`), host lower-cased and default port dropped.\n * `null` when unset or invalid — a hand-edited row never yields a broken\n * `metadataBase`.\n */\nexport function normalizeCanonicalUrl(value: string | null | undefined): string | null {\n  const trimmed = value?.trim()\n  if (!trimmed || validateCanonicalUrl(trimmed) !== null) return null\n  return new URL(trimmed).origin\n}\n\n/** The site-level SEO fields of `GET /api/site/config` (REB-651). */\nexport interface SiteSeoConfig {\n  siteName?: string | null\n  siteDescription?: string | null\n  /** `Config.seoTitle` — the site's own search title. */\n  seoTitle?: string | null\n  /** `Config.seoDescription` — the site's own search description. */\n  seoDescription?: string | null\n  /** `Config.canonicalUrl` — the site origin, fed to `metadataBase`. */\n  canonicalUrl?: string | null\n}\n\n/**\n * The home page title (REB-651): a non-empty site `seoTitle` is used as-is —\n * never suffixed by the template, the same rule as an entity SEO title —\n * otherwise `siteName`, exactly as before the field existed.\n */\nexport function resolveSiteSeoTitle(config: SiteSeoConfig): string {\n  return config.seoTitle?.trim() || config.siteName?.trim() || ''\n}\n\n/** The home page description: `seoDescription`, else `siteDescription`. */\nexport function resolveSiteSeoDescription(config: SiteSeoConfig): string {\n  return config.seoDescription?.trim() || config.siteDescription?.trim() || ''\n}\n\nexport interface BuildMetadataInput extends SeoTitleInput {\n  /** The detail endpoint's `seo` block — its `title` is already resolved. */\n  seo?: { title?: string | null } | null\n  /** `GET /api/site/config` (or the subset needed here). */\n  config: { seoTitleTemplate?: string | null } & SiteSeoConfig\n  description?: string | null\n  /**\n   * REB-651 — the home / site-level path: the title is the site `seoTitle`\n   * as-is (else `siteName`), the description the site `seoDescription` (else\n   * `siteDescription`), and a valid `canonicalUrl` becomes `metadataBase`.\n   * Explicit on purpose: a page whose title happens to be empty must never be\n   * titled with the site's SEO title.\n   */\n  home?: boolean\n}\n\n/**\n * Next `Metadata` for a SITE route. The title is emitted as `absolute` so a\n * root-layout `title.template` can never append the brand a second time.\n * Description/Open Graph are deliberately minimal here (REB-823 extends them).\n */\nexport function buildMetadata(input: BuildMetadataInput): Metadata {\n  if (input.home) return buildSiteMetadata(input)\n\n  const title =\n    input.seo?.title?.trim() ||\n    resolveSeoTitle(input, {\n      template: input.config.seoTitleTemplate,\n      siteName: input.config.siteName,\n    })\n\n  const metadata: Metadata = {}\n  if (title) metadata.title = { absolute: title }\n  const description = input.description?.trim()\n  if (description) metadata.description = description\n  return metadata\n}\n\nfunction buildSiteMetadata(input: BuildMetadataInput): Metadata {\n  const metadata: Metadata = {}\n  const canonicalUrl = normalizeCanonicalUrl(input.config.canonicalUrl)\n  if (canonicalUrl) metadata.metadataBase = new URL(canonicalUrl)\n\n  const title = resolveSiteSeoTitle(input.config)\n  if (title) metadata.title = { absolute: title }\n  const description = input.description?.trim() || resolveSiteSeoDescription(input.config)\n  if (description) metadata.description = description\n\n  if (canonicalUrl) metadata.alternates = { canonical: '/' }\n  return metadata\n}\n"],"mappings":"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","names":[]}

package/dist/seo.d.cts

@@ -0,0 +1,116 @@
+import { Metadata } from 'next';
+
+/**
+ * `@reblu/site-next/seo` — the ONE page-title rule (REB-871), shared by the
+ * Reblu SITE API (which serves `seo.title` already resolved on every detail
+ * endpoint) and by SITEs (index/list routes, or an older API without `seo`).
+ *
+ * The rule, in order:
+ *   1. An entity SEO title (`seoTitle` / `metaTitle`) that is non-empty after
+ *      trimming is the WHOLE title — used as-is, never suffixed.
+ *   2. Otherwise the tenant template (`SiteSettings.seoTitleTemplate`, default
+ *      `%s | {siteName}`) is applied ONCE to the display title — the entity
+ *      title on a detail route, the section label on a list/index route.
+ *   3. The brand is never duplicated: a display title that already names the
+ *      site is used alone, and a site with no name drops the brand part.
+ *
+ * Own tsup entry with ZERO runtime dependencies (no React, no `next` — only
+ * the `Metadata` TYPE) so base-api can import it server-side and a SITE can
+ * call it from `generateMetadata` with no RSC-boundary cost. It must never
+ * carry `'use client'`.
+ */
+
+/** Applied when the tenant never chose a template (`seoTitleTemplate` NULL). */
+declare const DEFAULT_SEO_TITLE_TEMPLATE = "%s | {siteName}";
+/** The display-title placeholder — must appear exactly once in a template. */
+declare const SEO_TITLE_PLACEHOLDER = "%s";
+/** Optional brand placeholder, replaced by `siteName`. */
+declare const SEO_SITE_NAME_PLACEHOLDER = "{siteName}";
+/** Upper bound for a stored template (write-side validation). */
+declare const SEO_TITLE_TEMPLATE_MAX_LENGTH = 60;
+/** Recommended length of a full page title in search results. */
+declare const SEO_TITLE_RECOMMENDED_MAX_LENGTH = 60;
+type SeoTitleTemplateIssue = 'missing_placeholder' | 'multiple_placeholders' | 'too_long';
+/** `null` when `template` is a valid title template, otherwise why it is not. */
+declare function validateSeoTitleTemplate(template: string): SeoTitleTemplateIssue | null;
+/**
+ * The template to apply: the stored one (trimmed) when valid, otherwise the
+ * default. An invalid stored value (hand-edited row) degrades to the default
+ * instead of producing a broken title.
+ */
+declare function resolveSeoTitleTemplate(template: string | null | undefined): string;
+interface SeoTitleInput {
+    /** Entity SEO title (`seoTitle` on pages, `metaTitle` on posts/products/courses). */
+    seoTitle?: string | null;
+    /** Display title of the entity (detail routes). */
+    title?: string | null;
+    /** Label of a list/index route (e.g. "Blog"), used when there is no entity title. */
+    sectionLabel?: string | null;
+}
+interface SeoTitleContext {
+    /** `Config.seoTitleTemplate` — null/undefined/invalid → the default. */
+    template?: string | null;
+    /** `Config.siteName`. */
+    siteName?: string | null;
+}
+declare function resolveSeoTitle(input: SeoTitleInput, context: SeoTitleContext): string;
+type CanonicalUrlIssue = 'invalid' | 'not_https' | 'not_origin';
+/**
+ * REB-651 — `null` when `value` is a valid canonical site URL: an absolute
+ * `https` origin, with nothing after the host but optional trailing slashes
+ * (no path, query, fragment or credentials). Otherwise why it is not.
+ */
+declare function validateCanonicalUrl(value: string): CanonicalUrlIssue | null;
+/**
+ * The stored/served form of a canonical site URL: the origin with no trailing
+ * slash (`https://example.com`), host lower-cased and default port dropped.
+ * `null` when unset or invalid — a hand-edited row never yields a broken
+ * `metadataBase`.
+ */
+declare function normalizeCanonicalUrl(value: string | null | undefined): string | null;
+/** The site-level SEO fields of `GET /api/site/config` (REB-651). */
+interface SiteSeoConfig {
+    siteName?: string | null;
+    siteDescription?: string | null;
+    /** `Config.seoTitle` — the site's own search title. */
+    seoTitle?: string | null;
+    /** `Config.seoDescription` — the site's own search description. */
+    seoDescription?: string | null;
+    /** `Config.canonicalUrl` — the site origin, fed to `metadataBase`. */
+    canonicalUrl?: string | null;
+}
+/**
+ * The home page title (REB-651): a non-empty site `seoTitle` is used as-is —
+ * never suffixed by the template, the same rule as an entity SEO title —
+ * otherwise `siteName`, exactly as before the field existed.
+ */
+declare function resolveSiteSeoTitle(config: SiteSeoConfig): string;
+/** The home page description: `seoDescription`, else `siteDescription`. */
+declare function resolveSiteSeoDescription(config: SiteSeoConfig): string;
+interface BuildMetadataInput extends SeoTitleInput {
+    /** The detail endpoint's `seo` block — its `title` is already resolved. */
+    seo?: {
+        title?: string | null;
+    } | null;
+    /** `GET /api/site/config` (or the subset needed here). */
+    config: {
+        seoTitleTemplate?: string | null;
+    } & SiteSeoConfig;
+    description?: string | null;
+    /**
+     * REB-651 — the home / site-level path: the title is the site `seoTitle`
+     * as-is (else `siteName`), the description the site `seoDescription` (else
+     * `siteDescription`), and a valid `canonicalUrl` becomes `metadataBase`.
+     * Explicit on purpose: a page whose title happens to be empty must never be
+     * titled with the site's SEO title.
+     */
+    home?: boolean;
+}
+/**
+ * Next `Metadata` for a SITE route. The title is emitted as `absolute` so a
+ * root-layout `title.template` can never append the brand a second time.
+ * Description/Open Graph are deliberately minimal here (REB-823 extends them).
+ */
+declare function buildMetadata(input: BuildMetadataInput): Metadata;
+
+export { type BuildMetadataInput, type CanonicalUrlIssue, DEFAULT_SEO_TITLE_TEMPLATE, SEO_SITE_NAME_PLACEHOLDER, SEO_TITLE_PLACEHOLDER, SEO_TITLE_RECOMMENDED_MAX_LENGTH, SEO_TITLE_TEMPLATE_MAX_LENGTH, type SeoTitleContext, type SeoTitleInput, type SeoTitleTemplateIssue, type SiteSeoConfig, buildMetadata, normalizeCanonicalUrl, resolveSeoTitle, resolveSeoTitleTemplate, resolveSiteSeoDescription, resolveSiteSeoTitle, validateCanonicalUrl, validateSeoTitleTemplate };

package/dist/seo.d.ts

@@ -0,0 +1,116 @@
+import { Metadata } from 'next';
+
+/**
+ * `@reblu/site-next/seo` — the ONE page-title rule (REB-871), shared by the
+ * Reblu SITE API (which serves `seo.title` already resolved on every detail
+ * endpoint) and by SITEs (index/list routes, or an older API without `seo`).
+ *
+ * The rule, in order:
+ *   1. An entity SEO title (`seoTitle` / `metaTitle`) that is non-empty after
+ *      trimming is the WHOLE title — used as-is, never suffixed.
+ *   2. Otherwise the tenant template (`SiteSettings.seoTitleTemplate`, default
+ *      `%s | {siteName}`) is applied ONCE to the display title — the entity
+ *      title on a detail route, the section label on a list/index route.
+ *   3. The brand is never duplicated: a display title that already names the
+ *      site is used alone, and a site with no name drops the brand part.
+ *
+ * Own tsup entry with ZERO runtime dependencies (no React, no `next` — only
+ * the `Metadata` TYPE) so base-api can import it server-side and a SITE can
+ * call it from `generateMetadata` with no RSC-boundary cost. It must never
+ * carry `'use client'`.
+ */
+
+/** Applied when the tenant never chose a template (`seoTitleTemplate` NULL). */
+declare const DEFAULT_SEO_TITLE_TEMPLATE = "%s | {siteName}";
+/** The display-title placeholder — must appear exactly once in a template. */
+declare const SEO_TITLE_PLACEHOLDER = "%s";
+/** Optional brand placeholder, replaced by `siteName`. */
+declare const SEO_SITE_NAME_PLACEHOLDER = "{siteName}";
+/** Upper bound for a stored template (write-side validation). */
+declare const SEO_TITLE_TEMPLATE_MAX_LENGTH = 60;
+/** Recommended length of a full page title in search results. */
+declare const SEO_TITLE_RECOMMENDED_MAX_LENGTH = 60;
+type SeoTitleTemplateIssue = 'missing_placeholder' | 'multiple_placeholders' | 'too_long';
+/** `null` when `template` is a valid title template, otherwise why it is not. */
+declare function validateSeoTitleTemplate(template: string): SeoTitleTemplateIssue | null;
+/**
+ * The template to apply: the stored one (trimmed) when valid, otherwise the
+ * default. An invalid stored value (hand-edited row) degrades to the default
+ * instead of producing a broken title.
+ */
+declare function resolveSeoTitleTemplate(template: string | null | undefined): string;
+interface SeoTitleInput {
+    /** Entity SEO title (`seoTitle` on pages, `metaTitle` on posts/products/courses). */
+    seoTitle?: string | null;
+    /** Display title of the entity (detail routes). */
+    title?: string | null;
+    /** Label of a list/index route (e.g. "Blog"), used when there is no entity title. */
+    sectionLabel?: string | null;
+}
+interface SeoTitleContext {
+    /** `Config.seoTitleTemplate` — null/undefined/invalid → the default. */
+    template?: string | null;
+    /** `Config.siteName`. */
+    siteName?: string | null;
+}
+declare function resolveSeoTitle(input: SeoTitleInput, context: SeoTitleContext): string;
+type CanonicalUrlIssue = 'invalid' | 'not_https' | 'not_origin';
+/**
+ * REB-651 — `null` when `value` is a valid canonical site URL: an absolute
+ * `https` origin, with nothing after the host but optional trailing slashes
+ * (no path, query, fragment or credentials). Otherwise why it is not.
+ */
+declare function validateCanonicalUrl(value: string): CanonicalUrlIssue | null;
+/**
+ * The stored/served form of a canonical site URL: the origin with no trailing
+ * slash (`https://example.com`), host lower-cased and default port dropped.
+ * `null` when unset or invalid — a hand-edited row never yields a broken
+ * `metadataBase`.
+ */
+declare function normalizeCanonicalUrl(value: string | null | undefined): string | null;
+/** The site-level SEO fields of `GET /api/site/config` (REB-651). */
+interface SiteSeoConfig {
+    siteName?: string | null;
+    siteDescription?: string | null;
+    /** `Config.seoTitle` — the site's own search title. */
+    seoTitle?: string | null;
+    /** `Config.seoDescription` — the site's own search description. */
+    seoDescription?: string | null;
+    /** `Config.canonicalUrl` — the site origin, fed to `metadataBase`. */
+    canonicalUrl?: string | null;
+}
+/**
+ * The home page title (REB-651): a non-empty site `seoTitle` is used as-is —
+ * never suffixed by the template, the same rule as an entity SEO title —
+ * otherwise `siteName`, exactly as before the field existed.
+ */
+declare function resolveSiteSeoTitle(config: SiteSeoConfig): string;
+/** The home page description: `seoDescription`, else `siteDescription`. */
+declare function resolveSiteSeoDescription(config: SiteSeoConfig): string;
+interface BuildMetadataInput extends SeoTitleInput {
+    /** The detail endpoint's `seo` block — its `title` is already resolved. */
+    seo?: {
+        title?: string | null;
+    } | null;
+    /** `GET /api/site/config` (or the subset needed here). */
+    config: {
+        seoTitleTemplate?: string | null;
+    } & SiteSeoConfig;
+    description?: string | null;
+    /**
+     * REB-651 — the home / site-level path: the title is the site `seoTitle`
+     * as-is (else `siteName`), the description the site `seoDescription` (else
+     * `siteDescription`), and a valid `canonicalUrl` becomes `metadataBase`.
+     * Explicit on purpose: a page whose title happens to be empty must never be
+     * titled with the site's SEO title.
+     */
+    home?: boolean;
+}
+/**
+ * Next `Metadata` for a SITE route. The title is emitted as `absolute` so a
+ * root-layout `title.template` can never append the brand a second time.
+ * Description/Open Graph are deliberately minimal here (REB-823 extends them).
+ */
+declare function buildMetadata(input: BuildMetadataInput): Metadata;
+
+export { type BuildMetadataInput, type CanonicalUrlIssue, DEFAULT_SEO_TITLE_TEMPLATE, SEO_SITE_NAME_PLACEHOLDER, SEO_TITLE_PLACEHOLDER, SEO_TITLE_RECOMMENDED_MAX_LENGTH, SEO_TITLE_TEMPLATE_MAX_LENGTH, type SeoTitleContext, type SeoTitleInput, type SeoTitleTemplateIssue, type SiteSeoConfig, buildMetadata, normalizeCanonicalUrl, resolveSeoTitle, resolveSeoTitleTemplate, resolveSiteSeoDescription, resolveSiteSeoTitle, validateCanonicalUrl, validateSeoTitleTemplate };

package/dist/seo.js

@@ -0,0 +1,110 @@
+// src/seo.ts
+var DEFAULT_SEO_TITLE_TEMPLATE = "%s | {siteName}";
+var SEO_TITLE_PLACEHOLDER = "%s";
+var SEO_SITE_NAME_PLACEHOLDER = "{siteName}";
+var SEO_TITLE_TEMPLATE_MAX_LENGTH = 60;
+var SEO_TITLE_RECOMMENDED_MAX_LENGTH = 60;
+function validateSeoTitleTemplate(template) {
+  const occurrences = template.split(SEO_TITLE_PLACEHOLDER).length - 1;
+  if (occurrences === 0) return "missing_placeholder";
+  if (occurrences > 1) return "multiple_placeholders";
+  if (template.length > SEO_TITLE_TEMPLATE_MAX_LENGTH) return "too_long";
+  return null;
+}
+function resolveSeoTitleTemplate(template) {
+  const trimmed = template?.trim() ?? "";
+  if (trimmed && validateSeoTitleTemplate(trimmed) === null) return trimmed;
+  return DEFAULT_SEO_TITLE_TEMPLATE;
+}
+var WORD_CHAR_AT_END = /[\p{L}\p{N}\p{M}]$/u;
+var WORD_CHAR_AT_START = /^[\p{L}\p{N}\p{M}]/u;
+function containsPhrase(text, phrase) {
+  const haystack = text.toLocaleLowerCase();
+  const needle = phrase.toLocaleLowerCase();
+  for (let i = haystack.indexOf(needle); i !== -1; i = haystack.indexOf(needle, i + 1)) {
+    const before = haystack.slice(0, i);
+    const after = haystack.slice(i + needle.length);
+    if (!WORD_CHAR_AT_END.test(before) && !WORD_CHAR_AT_START.test(after)) return true;
+  }
+  return false;
+}
+function resolveSeoTitle(input, context) {
+  const asIs = input.seoTitle?.trim();
+  if (asIs) return asIs;
+  const siteName = context.siteName?.trim() ?? "";
+  const display = input.title?.trim() || input.sectionLabel?.trim() || "";
+  if (!display) return siteName;
+  const template = resolveSeoTitleTemplate(context.template);
+  if (template.includes(SEO_SITE_NAME_PLACEHOLDER)) {
+    if (!siteName) return display;
+    if (containsPhrase(display, siteName)) return display;
+  }
+  const [before = "", after = ""] = template.split(SEO_TITLE_PLACEHOLDER);
+  const brand = (part) => part.split(SEO_SITE_NAME_PLACEHOLDER).join(siteName);
+  return `${brand(before)}${display}${brand(after)}`.trim();
+}
+function validateCanonicalUrl(value) {
+  const trimmed = value.trim();
+  let url;
+  try {
+    url = new URL(trimmed);
+  } catch {
+    return "invalid";
+  }
+  if (url.protocol !== "https:") return "not_https";
+  if (url.username || url.password || url.search || url.hash || /[?#]/.test(trimmed)) {
+    return "not_origin";
+  }
+  if (url.pathname.replace(/\/+$/, "") !== "") return "not_origin";
+  return null;
+}
+function normalizeCanonicalUrl(value) {
+  const trimmed = value?.trim();
+  if (!trimmed || validateCanonicalUrl(trimmed) !== null) return null;
+  return new URL(trimmed).origin;
+}
+function resolveSiteSeoTitle(config) {
+  return config.seoTitle?.trim() || config.siteName?.trim() || "";
+}
+function resolveSiteSeoDescription(config) {
+  return config.seoDescription?.trim() || config.siteDescription?.trim() || "";
+}
+function buildMetadata(input) {
+  if (input.home) return buildSiteMetadata(input);
+  const title = input.seo?.title?.trim() || resolveSeoTitle(input, {
+    template: input.config.seoTitleTemplate,
+    siteName: input.config.siteName
+  });
+  const metadata = {};
+  if (title) metadata.title = { absolute: title };
+  const description = input.description?.trim();
+  if (description) metadata.description = description;
+  return metadata;
+}
+function buildSiteMetadata(input) {
+  const metadata = {};
+  const canonicalUrl = normalizeCanonicalUrl(input.config.canonicalUrl);
+  if (canonicalUrl) metadata.metadataBase = new URL(canonicalUrl);
+  const title = resolveSiteSeoTitle(input.config);
+  if (title) metadata.title = { absolute: title };
+  const description = input.description?.trim() || resolveSiteSeoDescription(input.config);
+  if (description) metadata.description = description;
+  if (canonicalUrl) metadata.alternates = { canonical: "/" };
+  return metadata;
+}
+export {
+  DEFAULT_SEO_TITLE_TEMPLATE,
+  SEO_SITE_NAME_PLACEHOLDER,
+  SEO_TITLE_PLACEHOLDER,
+  SEO_TITLE_RECOMMENDED_MAX_LENGTH,
+  SEO_TITLE_TEMPLATE_MAX_LENGTH,
+  buildMetadata,
+  normalizeCanonicalUrl,
+  resolveSeoTitle,
+  resolveSeoTitleTemplate,
+  resolveSiteSeoDescription,
+  resolveSiteSeoTitle,
+  validateCanonicalUrl,
+  validateSeoTitleTemplate
+};
+//# sourceMappingURL=seo.js.map

package/dist/seo.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/seo.ts"],"sourcesContent":["/**\n * `@reblu/site-next/seo` — the ONE page-title rule (REB-871), shared by the\n * Reblu SITE API (which serves `seo.title` already resolved on every detail\n * endpoint) and by SITEs (index/list routes, or an older API without `seo`).\n *\n * The rule, in order:\n *   1. An entity SEO title (`seoTitle` / `metaTitle`) that is non-empty after\n *      trimming is the WHOLE title — used as-is, never suffixed.\n *   2. Otherwise the tenant template (`SiteSettings.seoTitleTemplate`, default\n *      `%s | {siteName}`) is applied ONCE to the display title — the entity\n *      title on a detail route, the section label on a list/index route.\n *   3. The brand is never duplicated: a display title that already names the\n *      site is used alone, and a site with no name drops the brand part.\n *\n * Own tsup entry with ZERO runtime dependencies (no React, no `next` — only\n * the `Metadata` TYPE) so base-api can import it server-side and a SITE can\n * call it from `generateMetadata` with no RSC-boundary cost. It must never\n * carry `'use client'`.\n */\nimport type { Metadata } from 'next'\n\n/** Applied when the tenant never chose a template (`seoTitleTemplate` NULL). */\nexport const DEFAULT_SEO_TITLE_TEMPLATE = '%s | {siteName}'\n/** The display-title placeholder — must appear exactly once in a template. */\nexport const SEO_TITLE_PLACEHOLDER = '%s'\n/** Optional brand placeholder, replaced by `siteName`. */\nexport const SEO_SITE_NAME_PLACEHOLDER = '{siteName}'\n/** Upper bound for a stored template (write-side validation). */\nexport const SEO_TITLE_TEMPLATE_MAX_LENGTH = 60\n/** Recommended length of a full page title in search results. */\nexport const SEO_TITLE_RECOMMENDED_MAX_LENGTH = 60\n\nexport type SeoTitleTemplateIssue = 'missing_placeholder' | 'multiple_placeholders' | 'too_long'\n\n/** `null` when `template` is a valid title template, otherwise why it is not. */\nexport function validateSeoTitleTemplate(template: string): SeoTitleTemplateIssue | null {\n  const occurrences = template.split(SEO_TITLE_PLACEHOLDER).length - 1\n  if (occurrences === 0) return 'missing_placeholder'\n  if (occurrences > 1) return 'multiple_placeholders'\n  if (template.length > SEO_TITLE_TEMPLATE_MAX_LENGTH) return 'too_long'\n  return null\n}\n\n/**\n * The template to apply: the stored one (trimmed) when valid, otherwise the\n * default. An invalid stored value (hand-edited row) degrades to the default\n * instead of producing a broken title.\n */\nexport function resolveSeoTitleTemplate(template: string | null | undefined): string {\n  const trimmed = template?.trim() ?? ''\n  if (trimmed && validateSeoTitleTemplate(trimmed) === null) return trimmed\n  return DEFAULT_SEO_TITLE_TEMPLATE\n}\n\nexport interface SeoTitleInput {\n  /** Entity SEO title (`seoTitle` on pages, `metaTitle` on posts/products/courses). */\n  seoTitle?: string | null\n  /** Display title of the entity (detail routes). */\n  title?: string | null\n  /** Label of a list/index route (e.g. \"Blog\"), used when there is no entity title. */\n  sectionLabel?: string | null\n}\n\nexport interface SeoTitleContext {\n  /** `Config.seoTitleTemplate` — null/undefined/invalid → the default. */\n  template?: string | null\n  /** `Config.siteName`. */\n  siteName?: string | null\n}\n\n/** A letter, digit or combining mark — accents included (Unicode-aware). */\nconst WORD_CHAR_AT_END = /[\\p{L}\\p{N}\\p{M}]$/u\nconst WORD_CHAR_AT_START = /^[\\p{L}\\p{N}\\p{M}]/u\n\n/**\n * Whether `phrase` occurs in `text` as a whole word/phrase (case-insensitive):\n * the brand \"Arte\" is in \"Galería Arte\" but not in \"Cartera\" or \"Artesanía\".\n */\nfunction containsPhrase(text: string, phrase: string): boolean {\n  const haystack = text.toLocaleLowerCase()\n  const needle = phrase.toLocaleLowerCase()\n  for (let i = haystack.indexOf(needle); i !== -1; i = haystack.indexOf(needle, i + 1)) {\n    const before = haystack.slice(0, i)\n    const after = haystack.slice(i + needle.length)\n    if (!WORD_CHAR_AT_END.test(before) && !WORD_CHAR_AT_START.test(after)) return true\n  }\n  return false\n}\n\nexport function resolveSeoTitle(input: SeoTitleInput, context: SeoTitleContext): string {\n  const asIs = input.seoTitle?.trim()\n  if (asIs) return asIs\n\n  const siteName = context.siteName?.trim() ?? ''\n  const display = input.title?.trim() || input.sectionLabel?.trim() || ''\n  if (!display) return siteName\n\n  const template = resolveSeoTitleTemplate(context.template)\n  if (template.includes(SEO_SITE_NAME_PLACEHOLDER)) {\n    if (!siteName) return display\n    if (containsPhrase(display, siteName)) return display\n  }\n\n  // Split on the placeholder BEFORE inserting the display title, so the title\n  // itself is never scanned for placeholders (applied exactly once) and no\n  // `String.replace` special pattern (`$&`, `$1`) can reach it.\n  const [before = '', after = ''] = template.split(SEO_TITLE_PLACEHOLDER)\n  const brand = (part: string) => part.split(SEO_SITE_NAME_PLACEHOLDER).join(siteName)\n  return `${brand(before)}${display}${brand(after)}`.trim()\n}\n\nexport type CanonicalUrlIssue = 'invalid' | 'not_https' | 'not_origin'\n\n/**\n * REB-651 — `null` when `value` is a valid canonical site URL: an absolute\n * `https` origin, with nothing after the host but optional trailing slashes\n * (no path, query, fragment or credentials). Otherwise why it is not.\n */\nexport function validateCanonicalUrl(value: string): CanonicalUrlIssue | null {\n  const trimmed = value.trim()\n  let url: URL\n  try {\n    url = new URL(trimmed)\n  } catch {\n    return 'invalid'\n  }\n  if (url.protocol !== 'https:') return 'not_https'\n  // `?` / `#` with nothing after them parse to an empty search/hash, so the\n  // raw string is checked as well: a bare `?` is still not an origin.\n  if (url.username || url.password || url.search || url.hash || /[?#]/.test(trimmed)) {\n    return 'not_origin'\n  }\n  if (url.pathname.replace(/\\/+$/, '') !== '') return 'not_origin'\n  return null\n}\n\n/**\n * The stored/served form of a canonical site URL: the origin with no trailing\n * slash (`https://example.com`), host lower-cased and default port dropped.\n * `null` when unset or invalid — a hand-edited row never yields a broken\n * `metadataBase`.\n */\nexport function normalizeCanonicalUrl(value: string | null | undefined): string | null {\n  const trimmed = value?.trim()\n  if (!trimmed || validateCanonicalUrl(trimmed) !== null) return null\n  return new URL(trimmed).origin\n}\n\n/** The site-level SEO fields of `GET /api/site/config` (REB-651). */\nexport interface SiteSeoConfig {\n  siteName?: string | null\n  siteDescription?: string | null\n  /** `Config.seoTitle` — the site's own search title. */\n  seoTitle?: string | null\n  /** `Config.seoDescription` — the site's own search description. */\n  seoDescription?: string | null\n  /** `Config.canonicalUrl` — the site origin, fed to `metadataBase`. */\n  canonicalUrl?: string | null\n}\n\n/**\n * The home page title (REB-651): a non-empty site `seoTitle` is used as-is —\n * never suffixed by the template, the same rule as an entity SEO title —\n * otherwise `siteName`, exactly as before the field existed.\n */\nexport function resolveSiteSeoTitle(config: SiteSeoConfig): string {\n  return config.seoTitle?.trim() || config.siteName?.trim() || ''\n}\n\n/** The home page description: `seoDescription`, else `siteDescription`. */\nexport function resolveSiteSeoDescription(config: SiteSeoConfig): string {\n  return config.seoDescription?.trim() || config.siteDescription?.trim() || ''\n}\n\nexport interface BuildMetadataInput extends SeoTitleInput {\n  /** The detail endpoint's `seo` block — its `title` is already resolved. */\n  seo?: { title?: string | null } | null\n  /** `GET /api/site/config` (or the subset needed here). */\n  config: { seoTitleTemplate?: string | null } & SiteSeoConfig\n  description?: string | null\n  /**\n   * REB-651 — the home / site-level path: the title is the site `seoTitle`\n   * as-is (else `siteName`), the description the site `seoDescription` (else\n   * `siteDescription`), and a valid `canonicalUrl` becomes `metadataBase`.\n   * Explicit on purpose: a page whose title happens to be empty must never be\n   * titled with the site's SEO title.\n   */\n  home?: boolean\n}\n\n/**\n * Next `Metadata` for a SITE route. The title is emitted as `absolute` so a\n * root-layout `title.template` can never append the brand a second time.\n * Description/Open Graph are deliberately minimal here (REB-823 extends them).\n */\nexport function buildMetadata(input: BuildMetadataInput): Metadata {\n  if (input.home) return buildSiteMetadata(input)\n\n  const title =\n    input.seo?.title?.trim() ||\n    resolveSeoTitle(input, {\n      template: input.config.seoTitleTemplate,\n      siteName: input.config.siteName,\n    })\n\n  const metadata: Metadata = {}\n  if (title) metadata.title = { absolute: title }\n  const description = input.description?.trim()\n  if (description) metadata.description = description\n  return metadata\n}\n\nfunction buildSiteMetadata(input: BuildMetadataInput): Metadata {\n  const metadata: Metadata = {}\n  const canonicalUrl = normalizeCanonicalUrl(input.config.canonicalUrl)\n  if (canonicalUrl) metadata.metadataBase = new URL(canonicalUrl)\n\n  const title = resolveSiteSeoTitle(input.config)\n  if (title) metadata.title = { absolute: title }\n  const description = input.description?.trim() || resolveSiteSeoDescription(input.config)\n  if (description) metadata.description = description\n\n  if (canonicalUrl) metadata.alternates = { canonical: '/' }\n  return metadata\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reblu/site-next",
-  "version": "1.17.0",
+  "version": "1.19.0",
   "description": "Next.js RSC glue for Reblu SITEs — cache + CTA + auth server/client components.",
   "license": "Apache-2.0",
   "author": "Reblu — Adolfo Unturbe",
@@ -221,6 +221,16 @@
         "types": "./dist/opening-hours.d.cts",
         "default": "./dist/opening-hours.cjs"
       }
+    },
+    "./seo": {
+      "import": {
+        "types": "./dist/seo.d.ts",
+        "default": "./dist/seo.js"
+      },
+      "require": {
+        "types": "./dist/seo.d.cts",
+        "default": "./dist/seo.cjs"
+      }
     }
   },
   "publishConfig": {
@@ -240,8 +250,8 @@
   "dependencies": {
     "@radix-ui/react-dialog": "^1.1.15",
     "zustand": "^5.0.9",
-    "@reblu/site-client": "^5.3.1",
-    "@reblu/site-contracts": "^1.6.1",
+    "@reblu/site-client": "^5.4.0",
+    "@reblu/site-contracts": "^1.12.0",
     "@reblu/site-ui": "^0.7.0"
   },
   "devDependencies": {