@reblu/site-next 1.18.0 → 1.19.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @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

package/README.md

@@ -682,6 +682,43 @@ 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

@@ -26,8 +26,12 @@ __export(seo_exports, {
   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);
@@ -75,7 +79,34 @@ function resolveSeoTitle(input, context) {
   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
@@ -86,6 +117,17 @@ function buildMetadata(input) {
   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,
@@ -94,8 +136,12 @@ function buildMetadata(input) {
   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

@@ -1 +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 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: { siteName?: string | null; seoTitleTemplate?: string | null }\n  description?: string | null\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  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"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAsBO,IAAM,6BAA6B;AAEnC,IAAM,wBAAwB;AAE9B,IAAM,4BAA4B;AAElC,IAAM,gCAAgC;AAEtC,IAAM,mCAAmC;AAKzC,SAAS,yBAAyB,UAAgD;AACvF,QAAM,cAAc,SAAS,MAAM,qBAAqB,EAAE,SAAS;AACnE,MAAI,gBAAgB,EAAG,QAAO;AAC9B,MAAI,cAAc,EAAG,QAAO;AAC5B,MAAI,SAAS,SAAS,8BAA+B,QAAO;AAC5D,SAAO;AACT;AAOO,SAAS,wBAAwB,UAA6C;AACnF,QAAM,UAAU,UAAU,KAAK,KAAK;AACpC,MAAI,WAAW,yBAAyB,OAAO,MAAM,KAAM,QAAO;AAClE,SAAO;AACT;AAmBA,IAAM,mBAAmB;AACzB,IAAM,qBAAqB;AAM3B,SAAS,eAAe,MAAc,QAAyB;AAC7D,QAAM,WAAW,KAAK,kBAAkB;AACxC,QAAM,SAAS,OAAO,kBAAkB;AACxC,WAAS,IAAI,SAAS,QAAQ,MAAM,GAAG,MAAM,IAAI,IAAI,SAAS,QAAQ,QAAQ,IAAI,CAAC,GAAG;AACpF,UAAM,SAAS,SAAS,MAAM,GAAG,CAAC;AAClC,UAAM,QAAQ,SAAS,MAAM,IAAI,OAAO,MAAM;AAC9C,QAAI,CAAC,iBAAiB,KAAK,MAAM,KAAK,CAAC,mBAAmB,KAAK,KAAK,EAAG,QAAO;AAAA,EAChF;AACA,SAAO;AACT;AAEO,SAAS,gBAAgB,OAAsB,SAAkC;AACtF,QAAM,OAAO,MAAM,UAAU,KAAK;AAClC,MAAI,KAAM,QAAO;AAEjB,QAAM,WAAW,QAAQ,UAAU,KAAK,KAAK;AAC7C,QAAM,UAAU,MAAM,OAAO,KAAK,KAAK,MAAM,cAAc,KAAK,KAAK;AACrE,MAAI,CAAC,QAAS,QAAO;AAErB,QAAM,WAAW,wBAAwB,QAAQ,QAAQ;AACzD,MAAI,SAAS,SAAS,yBAAyB,GAAG;AAChD,QAAI,CAAC,SAAU,QAAO;AACtB,QAAI,eAAe,SAAS,QAAQ,EAAG,QAAO;AAAA,EAChD;AAKA,QAAM,CAAC,SAAS,IAAI,QAAQ,EAAE,IAAI,SAAS,MAAM,qBAAqB;AACtE,QAAM,QAAQ,CAAC,SAAiB,KAAK,MAAM,yBAAyB,EAAE,KAAK,QAAQ;AACnF,SAAO,GAAG,MAAM,MAAM,CAAC,GAAG,OAAO,GAAG,MAAM,KAAK,CAAC,GAAG,KAAK;AAC1D;AAeO,SAAS,cAAc,OAAqC;AACjE,QAAM,QACJ,MAAM,KAAK,OAAO,KAAK,KACvB,gBAAgB,OAAO;AAAA,IACrB,UAAU,MAAM,OAAO;AAAA,IACvB,UAAU,MAAM,OAAO;AAAA,EACzB,CAAC;AAEH,QAAM,WAAqB,CAAC;AAC5B,MAAI,MAAO,UAAS,QAAQ,EAAE,UAAU,MAAM;AAC9C,QAAM,cAAc,MAAM,aAAa,KAAK;AAC5C,MAAI,YAAa,UAAS,cAAc;AACxC,SAAO;AACT;","names":[]}
+{"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

@@ -54,6 +54,39 @@ interface SeoTitleContext {
     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?: {
@@ -61,10 +94,17 @@ interface BuildMetadataInput extends SeoTitleInput {
     } | null;
     /** `GET /api/site/config` (or the subset needed here). */
     config: {
-        siteName?: string | null;
         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
@@ -73,4 +113,4 @@ interface BuildMetadataInput extends SeoTitleInput {
  */
 declare function buildMetadata(input: BuildMetadataInput): Metadata;
 
-export { type BuildMetadataInput, 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, buildMetadata, resolveSeoTitle, resolveSeoTitleTemplate, validateSeoTitleTemplate };
+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

@@ -54,6 +54,39 @@ interface SeoTitleContext {
     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?: {
@@ -61,10 +94,17 @@ interface BuildMetadataInput extends SeoTitleInput {
     } | null;
     /** `GET /api/site/config` (or the subset needed here). */
     config: {
-        siteName?: string | null;
         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
@@ -73,4 +113,4 @@ interface BuildMetadataInput extends SeoTitleInput {
  */
 declare function buildMetadata(input: BuildMetadataInput): Metadata;
 
-export { type BuildMetadataInput, 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, buildMetadata, resolveSeoTitle, resolveSeoTitleTemplate, validateSeoTitleTemplate };
+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

@@ -43,7 +43,34 @@ function resolveSeoTitle(input, context) {
   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
@@ -54,6 +81,17 @@ function buildMetadata(input) {
   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,
@@ -61,8 +99,12 @@ export {
   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

@@ -1 +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 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: { siteName?: string | null; seoTitleTemplate?: string | null }\n  description?: string | null\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  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"],"mappings":";AAsBO,IAAM,6BAA6B;AAEnC,IAAM,wBAAwB;AAE9B,IAAM,4BAA4B;AAElC,IAAM,gCAAgC;AAEtC,IAAM,mCAAmC;AAKzC,SAAS,yBAAyB,UAAgD;AACvF,QAAM,cAAc,SAAS,MAAM,qBAAqB,EAAE,SAAS;AACnE,MAAI,gBAAgB,EAAG,QAAO;AAC9B,MAAI,cAAc,EAAG,QAAO;AAC5B,MAAI,SAAS,SAAS,8BAA+B,QAAO;AAC5D,SAAO;AACT;AAOO,SAAS,wBAAwB,UAA6C;AACnF,QAAM,UAAU,UAAU,KAAK,KAAK;AACpC,MAAI,WAAW,yBAAyB,OAAO,MAAM,KAAM,QAAO;AAClE,SAAO;AACT;AAmBA,IAAM,mBAAmB;AACzB,IAAM,qBAAqB;AAM3B,SAAS,eAAe,MAAc,QAAyB;AAC7D,QAAM,WAAW,KAAK,kBAAkB;AACxC,QAAM,SAAS,OAAO,kBAAkB;AACxC,WAAS,IAAI,SAAS,QAAQ,MAAM,GAAG,MAAM,IAAI,IAAI,SAAS,QAAQ,QAAQ,IAAI,CAAC,GAAG;AACpF,UAAM,SAAS,SAAS,MAAM,GAAG,CAAC;AAClC,UAAM,QAAQ,SAAS,MAAM,IAAI,OAAO,MAAM;AAC9C,QAAI,CAAC,iBAAiB,KAAK,MAAM,KAAK,CAAC,mBAAmB,KAAK,KAAK,EAAG,QAAO;AAAA,EAChF;AACA,SAAO;AACT;AAEO,SAAS,gBAAgB,OAAsB,SAAkC;AACtF,QAAM,OAAO,MAAM,UAAU,KAAK;AAClC,MAAI,KAAM,QAAO;AAEjB,QAAM,WAAW,QAAQ,UAAU,KAAK,KAAK;AAC7C,QAAM,UAAU,MAAM,OAAO,KAAK,KAAK,MAAM,cAAc,KAAK,KAAK;AACrE,MAAI,CAAC,QAAS,QAAO;AAErB,QAAM,WAAW,wBAAwB,QAAQ,QAAQ;AACzD,MAAI,SAAS,SAAS,yBAAyB,GAAG;AAChD,QAAI,CAAC,SAAU,QAAO;AACtB,QAAI,eAAe,SAAS,QAAQ,EAAG,QAAO;AAAA,EAChD;AAKA,QAAM,CAAC,SAAS,IAAI,QAAQ,EAAE,IAAI,SAAS,MAAM,qBAAqB;AACtE,QAAM,QAAQ,CAAC,SAAiB,KAAK,MAAM,yBAAyB,EAAE,KAAK,QAAQ;AACnF,SAAO,GAAG,MAAM,MAAM,CAAC,GAAG,OAAO,GAAG,MAAM,KAAK,CAAC,GAAG,KAAK;AAC1D;AAeO,SAAS,cAAc,OAAqC;AACjE,QAAM,QACJ,MAAM,KAAK,OAAO,KAAK,KACvB,gBAAgB,OAAO;AAAA,IACrB,UAAU,MAAM,OAAO;AAAA,IACvB,UAAU,MAAM,OAAO;AAAA,EACzB,CAAC;AAEH,QAAM,WAAqB,CAAC;AAC5B,MAAI,MAAO,UAAS,QAAQ,EAAE,UAAU,MAAM;AAC9C,QAAM,cAAc,MAAM,aAAa,KAAK;AAC5C,MAAI,YAAa,UAAS,cAAc;AACxC,SAAO;AACT;","names":[]}
+{"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.18.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",
@@ -250,9 +250,9 @@
   "dependencies": {
     "@radix-ui/react-dialog": "^1.1.15",
     "zustand": "^5.0.9",
-    "@reblu/site-contracts": "^1.11.0",
-    "@reblu/site-ui": "^0.7.0",
-    "@reblu/site-client": "^5.4.0"
+    "@reblu/site-client": "^5.4.0",
+    "@reblu/site-contracts": "^1.12.0",
+    "@reblu/site-ui": "^0.7.0"
   },
   "devDependencies": {
     "@testing-library/jest-dom": "^6.9.1",