@reblu/site-next 1.18.0 → 1.20.0

package/dist/index.d.cts

@@ -1,9 +1,11 @@
 export { NextCacheAdapter } from './cache.cjs';
-export { CtaButtons, CtaButtonsProps } from './cta-buttons.cjs';
+import { CtaButtonsProps } from './cta-buttons.cjs';
+export { CtaButtonVariant, CtaButtons } from './cta-buttons.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { Cta } from '@reblu/site-contracts';
 import { RebluClient } from '@reblu/site-client';
 import { ReactNode } from 'react';
+import '@reblu/site-ui';
 
 interface StickyMobileCtaProps {
     ctas: Cta[];
@@ -16,7 +18,6 @@ interface StickyMobileCtaProps {
  */
 declare function StickyMobileCta({ ctas }: StickyMobileCtaProps): react_jsx_runtime.JSX.Element | null;
 
-type ButtonSize = 'sm' | 'default' | 'lg';
 /** The `Cta.slot` union — the valid placement keys, sourced from the contract. */
 type CtaSlot = Cta['slot'];
 /**
@@ -25,14 +26,13 @@ type CtaSlot = Cta['slot'];
  * narrower singleton, without coupling this component to the whole surface.
  */
 type CtaClient = Pick<RebluClient, 'ctas'>;
-interface EditableCtaProps {
-    /** CtaSlot value: hero | blog-end | services | contact | sticky-mobile | footer. */
+/** Presentation props `EditableCta` forwards unchanged to {@link CtaButtons}. */
+type ForwardedButtonProps = Omit<CtaButtonsProps, 'ctas'>;
+interface EditableCtaProps extends ForwardedButtonProps {
+    /** CtaSlot value: header | hero | blog-end | services | contact | sticky-mobile | footer. */
     slot: CtaSlot;
     /** The Reblu SDK client instance the SITE owns (env-configured upstream). */
     client: CtaClient;
-    className?: string;
-    buttonClassName?: string;
-    size?: ButtonSize;
     /**
      * Rendered when the slot has no configured CTA (or the upstream fetch fails).
      * Lets each placement keep its existing static CTA as a graceful fallback.
@@ -50,6 +50,6 @@ interface EditableCtaProps {
  * reads `process.env` and stays framework-glue only — the SITE owns the env and
  * wires the ISR-aware {@link NextCacheAdapter}.
  */
-declare function EditableCta({ slot, client, className, buttonClassName, size, fallback, }: EditableCtaProps): Promise<react_jsx_runtime.JSX.Element>;
+declare function EditableCta({ slot, client, fallback, ...buttonProps }: EditableCtaProps): Promise<react_jsx_runtime.JSX.Element>;
 
-export { type CtaClient, type CtaSlot, EditableCta, type EditableCtaProps, StickyMobileCta, type StickyMobileCtaProps };
+export { CtaButtonsProps, type CtaClient, type CtaSlot, EditableCta, type EditableCtaProps, StickyMobileCta, type StickyMobileCtaProps };

package/dist/index.d.ts

@@ -1,9 +1,11 @@
 export { NextCacheAdapter } from './cache.js';
-export { CtaButtons, CtaButtonsProps } from './cta-buttons.js';
+import { CtaButtonsProps } from './cta-buttons.js';
+export { CtaButtonVariant, CtaButtons } from './cta-buttons.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { Cta } from '@reblu/site-contracts';
 import { RebluClient } from '@reblu/site-client';
 import { ReactNode } from 'react';
+import '@reblu/site-ui';
 
 interface StickyMobileCtaProps {
     ctas: Cta[];
@@ -16,7 +18,6 @@ interface StickyMobileCtaProps {
  */
 declare function StickyMobileCta({ ctas }: StickyMobileCtaProps): react_jsx_runtime.JSX.Element | null;
 
-type ButtonSize = 'sm' | 'default' | 'lg';
 /** The `Cta.slot` union — the valid placement keys, sourced from the contract. */
 type CtaSlot = Cta['slot'];
 /**
@@ -25,14 +26,13 @@ type CtaSlot = Cta['slot'];
  * narrower singleton, without coupling this component to the whole surface.
  */
 type CtaClient = Pick<RebluClient, 'ctas'>;
-interface EditableCtaProps {
-    /** CtaSlot value: hero | blog-end | services | contact | sticky-mobile | footer. */
+/** Presentation props `EditableCta` forwards unchanged to {@link CtaButtons}. */
+type ForwardedButtonProps = Omit<CtaButtonsProps, 'ctas'>;
+interface EditableCtaProps extends ForwardedButtonProps {
+    /** CtaSlot value: header | hero | blog-end | services | contact | sticky-mobile | footer. */
     slot: CtaSlot;
     /** The Reblu SDK client instance the SITE owns (env-configured upstream). */
     client: CtaClient;
-    className?: string;
-    buttonClassName?: string;
-    size?: ButtonSize;
     /**
      * Rendered when the slot has no configured CTA (or the upstream fetch fails).
      * Lets each placement keep its existing static CTA as a graceful fallback.
@@ -50,6 +50,6 @@ interface EditableCtaProps {
  * reads `process.env` and stays framework-glue only — the SITE owns the env and
  * wires the ISR-aware {@link NextCacheAdapter}.
  */
-declare function EditableCta({ slot, client, className, buttonClassName, size, fallback, }: EditableCtaProps): Promise<react_jsx_runtime.JSX.Element>;
+declare function EditableCta({ slot, client, fallback, ...buttonProps }: EditableCtaProps): Promise<react_jsx_runtime.JSX.Element>;
 
-export { type CtaClient, type CtaSlot, EditableCta, type EditableCtaProps, StickyMobileCta, type StickyMobileCtaProps };
+export { CtaButtonsProps, type CtaClient, type CtaSlot, EditableCta, type EditableCtaProps, StickyMobileCta, type StickyMobileCtaProps };

package/dist/index.js

@@ -19,25 +19,52 @@ var NextCacheAdapter = class {
 };
 
 // src/cta-buttons.tsx
-import { Button } from "@reblu/site-ui";
+import { Button, cn } from "@reblu/site-ui";
 import Link from "next/link";
-import { jsx } from "react/jsx-runtime";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+var DEFAULT_NEW_WINDOW_HINT = "(se abre en una nueva ventana)";
 function isExternal(href) {
   return /^https?:\/\//i.test(href);
 }
-function CtaButtons({ ctas, className, buttonClassName, size = "lg" }) {
+function CtaButtons({
+  ctas,
+  className,
+  buttonClassName,
+  size = "lg",
+  icon,
+  primaryVariant = "default",
+  secondaryVariant = "default",
+  primaryClassName,
+  secondaryClassName,
+  newWindowHint = DEFAULT_NEW_WINDOW_HINT
+}) {
   if (ctas.length === 0) return null;
-  return /* @__PURE__ */ jsx("div", { className, "data-slot": "cta-buttons", children: ctas.map((cta) => /* @__PURE__ */ jsx(
-    Button,
-    {
-      asChild: true,
-      size,
-      className: buttonClassName,
-      "data-cta-id": cta.analyticsId ?? void 0,
-      children: isExternal(cta.href) ? /* @__PURE__ */ jsx("a", { href: cta.href, target: "_blank", rel: "noopener noreferrer", children: cta.label }) : /* @__PURE__ */ jsx(Link, { href: cta.href, children: cta.label })
-    },
-    cta.id
-  )) });
+  const leadingIcon = icon == null ? null : /* @__PURE__ */ jsx("span", { "aria-hidden": "true", className: "inline-flex shrink-0", children: icon });
+  return /* @__PURE__ */ jsx("div", { className, "data-slot": "cta-buttons", children: ctas.map((cta, index) => {
+    const isPrimary = index === 0;
+    return /* @__PURE__ */ jsx(
+      Button,
+      {
+        asChild: true,
+        size,
+        variant: isPrimary ? primaryVariant : secondaryVariant,
+        className: cn(buttonClassName, isPrimary ? primaryClassName : secondaryClassName),
+        "data-cta-id": cta.analyticsId ?? void 0,
+        children: isExternal(cta.href) ? /* @__PURE__ */ jsxs("a", { href: cta.href, target: "_blank", rel: "noopener noreferrer", children: [
+          leadingIcon,
+          cta.label,
+          newWindowHint ? /* @__PURE__ */ jsxs(Fragment, { children: [
+            " ",
+            /* @__PURE__ */ jsx("span", { className: "sr-only", children: newWindowHint })
+          ] }) : null
+        ] }) : /* @__PURE__ */ jsxs(Link, { href: cta.href, children: [
+          leadingIcon,
+          cta.label
+        ] })
+      },
+      cta.id
+    );
+  }) });
 }
 
 // src/sticky-mobile-cta.tsx
@@ -56,18 +83,11 @@ function StickyMobileCta({ ctas }) {
 }
 
 // src/editable-cta.tsx
-import { Fragment, jsx as jsx3 } from "react/jsx-runtime";
-async function EditableCta({
-  slot,
-  client,
-  className,
-  buttonClassName,
-  size,
-  fallback = null
-}) {
+import { Fragment as Fragment2, jsx as jsx3 } from "react/jsx-runtime";
+async function EditableCta({ slot, client, fallback = null, ...buttonProps }) {
   const { data: ctas } = await client.ctas.list(slot).catch(() => ({ data: [] }));
-  if (ctas.length === 0) return /* @__PURE__ */ jsx3(Fragment, { children: fallback });
-  return /* @__PURE__ */ jsx3(CtaButtons, { ctas, className, buttonClassName, size });
+  if (ctas.length === 0) return /* @__PURE__ */ jsx3(Fragment2, { children: fallback });
+  return /* @__PURE__ */ jsx3(CtaButtons, { ctas, ...buttonProps });
 }
 export {
   CtaButtons,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/next-cache-adapter.ts","../src/cta-buttons.tsx","../src/sticky-mobile-cta.tsx","../src/editable-cta.tsx"],"sourcesContent":["import type { RebluCacheAdapter, RebluCachePolicy } from '@reblu/site-client'\n\n/**\n * Next.js ISR cache adapter (REB-418 / design doc §5.2).\n *\n * Implements the framework-agnostic {@link RebluCacheAdapter} interface exported\n * by `@reblu/site-client`, translating a {@link RebluCachePolicy} into the\n * `fetch` options Next understands. This is the piece that restores the exact\n * ISR behavior demo-site hard-codes today — now injected instead of baked in:\n *\n * ```ts\n * createRebluClient({ baseUrl, apiKey, cache: new NextCacheAdapter(60) })\n * ```\n *\n * - `revalidate` > 0  → `{ next: { revalidate } }` (time-based ISR)\n * - `revalidate` `false` / `0` → `{ cache: 'no-store' }` (dynamic / preview)\n * - omitted `revalidate` → the constructor `defaultRevalidate`\n */\nexport class NextCacheAdapter implements RebluCacheAdapter {\n  /**\n   * @param defaultRevalidate ISR window (seconds) applied when a request omits\n   *   its own `revalidate`. Defaults to `60` for parity with demo-site's current\n   *   ISR default (`client.ts:45`). Pass `false`/`0` to default to no-store.\n   */\n  constructor(private readonly defaultRevalidate: number | false = 60) {}\n\n  resolveRequestInit(policy: RebluCachePolicy): RequestInit {\n    const revalidate = policy.revalidate ?? this.defaultRevalidate\n    if (revalidate === false || revalidate === 0) {\n      return { cache: 'no-store' }\n    }\n    return { next: { revalidate } } as RequestInit\n  }\n}\n","'use client'\n\nimport type { Cta } from '@reblu/site-contracts'\nimport { Button } from '@reblu/site-ui'\nimport Link from 'next/link'\n\ntype ButtonSize = 'sm' | 'default' | 'lg'\n\nexport interface CtaButtonsProps {\n  ctas: Cta[]\n  /** Wrapper class (layout of the button group). */\n  className?: string\n  /** Class applied to each button. */\n  buttonClassName?: string\n  size?: ButtonSize\n}\n\n/** External = absolute http(s) URL (e.g. a Klinikare booking link). */\nfunction isExternal(href: string): boolean {\n  return /^https?:\\/\\//i.test(href)\n}\n\n/**\n * Presentational CTA renderer (REB-394, moved to `@reblu/site-next` in REB-418).\n * Pure — takes already-resolved CTAs and renders one styled button-link each.\n * Internal hrefs use `next/link` (client routing); external URLs open in a new,\n * safely-rel tab. `analyticsId` is surfaced as `data-cta-id` on the clickable\n * element for GA `cta_click` tracking. Renders nothing when there are no CTAs.\n *\n * Imports `Button` from `@reblu/site-ui` (public) — never `@reblu/ui` (private).\n */\nexport function CtaButtons({ ctas, className, buttonClassName, size = 'lg' }: CtaButtonsProps) {\n  if (ctas.length === 0) return null\n\n  return (\n    <div className={className} data-slot='cta-buttons'>\n      {ctas.map((cta) => (\n        <Button\n          key={cta.id}\n          asChild\n          size={size}\n          className={buttonClassName}\n          data-cta-id={cta.analyticsId ?? undefined}\n        >\n          {isExternal(cta.href) ? (\n            <a href={cta.href} target='_blank' rel='noopener noreferrer'>\n              {cta.label}\n            </a>\n          ) : (\n            <Link href={cta.href}>{cta.label}</Link>\n          )}\n        </Button>\n      ))}\n    </div>\n  )\n}\n","import type { Cta } from '@reblu/site-contracts'\n\nimport { CtaButtons } from './cta-buttons'\n\nexport interface StickyMobileCtaProps {\n  ctas: Cta[]\n}\n\n/**\n * StickyMobileCta (REB-394, moved to `@reblu/site-next` in REB-418) — a\n * mobile-only sticky bottom bar surfacing the `sticky-mobile` slot CTAs. Hidden\n * on `md+` (desktop has its own CTAs). Renders nothing when no CTA is configured,\n * so it never adds empty chrome.\n */\nexport function StickyMobileCta({ ctas }: StickyMobileCtaProps) {\n  if (ctas.length === 0) return null\n\n  return (\n    <div className='fixed inset-x-0 bottom-0 z-50 md:hidden border-t border-border bg-background/95 px-4 py-3 backdrop-blur supports-[backdrop-filter]:bg-background/80'>\n      <CtaButtons\n        ctas={ctas}\n        className='flex justify-center gap-3'\n        buttonClassName='w-full rounded-lg font-semibold'\n        size='lg'\n      />\n    </div>\n  )\n}\n","import type { RebluClient } from '@reblu/site-client'\nimport type { Cta } from '@reblu/site-contracts'\nimport type { ReactNode } from 'react'\n\nimport { CtaButtons } from './cta-buttons'\n\ntype ButtonSize = 'sm' | 'default' | 'lg'\n\n/** The `Cta.slot` union — the valid placement keys, sourced from the contract. */\nexport type CtaSlot = Cta['slot']\n\n/**\n * The slice of the SDK client `EditableCta` needs: just the `ctas` namespace.\n * Typing it structurally lets a SITE pass either the full `RebluClient` or a\n * narrower singleton, without coupling this component to the whole surface.\n */\nexport type CtaClient = Pick<RebluClient, 'ctas'>\n\nexport interface EditableCtaProps {\n  /** CtaSlot value: hero | blog-end | services | contact | sticky-mobile | footer. */\n  slot: CtaSlot\n  /** The Reblu SDK client instance the SITE owns (env-configured upstream). */\n  client: CtaClient\n  className?: string\n  buttonClassName?: string\n  size?: ButtonSize\n  /**\n   * Rendered when the slot has no configured CTA (or the upstream fetch fails).\n   * Lets each placement keep its existing static CTA as a graceful fallback.\n   */\n  fallback?: ReactNode\n}\n\n/**\n * EditableCta (REB-394, moved to `@reblu/site-next` in REB-418) — drop-anywhere\n * async Server Component that renders the CTAs configured for a slot from nexus,\n * with no redeploy. Fetches active CTAs via the injected SDK client and degrades\n * gracefully: on empty/failure it renders `fallback` (a static CTA) instead of\n * breaking the page.\n *\n * The client is injected (prop or per-SITE singleton) so this package never\n * reads `process.env` and stays framework-glue only — the SITE owns the env and\n * wires the ISR-aware {@link NextCacheAdapter}.\n */\nexport async function EditableCta({\n  slot,\n  client,\n  className,\n  buttonClassName,\n  size,\n  fallback = null,\n}: EditableCtaProps) {\n  const { data: ctas } = await client.ctas\n    .list(slot)\n    .catch(() => ({ data: [] as Cta[] }))\n\n  if (ctas.length === 0) return <>{fallback}</>\n\n  return (\n    <CtaButtons ctas={ctas} className={className} buttonClassName={buttonClassName} size={size} />\n  )\n}\n"],"mappings":";AAkBO,IAAM,mBAAN,MAAoD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMzD,YAA6B,oBAAoC,IAAI;AAAxC;AAAA,EAAyC;AAAA,EAAzC;AAAA,EAE7B,mBAAmB,QAAuC;AACxD,UAAM,aAAa,OAAO,cAAc,KAAK;AAC7C,QAAI,eAAe,SAAS,eAAe,GAAG;AAC5C,aAAO,EAAE,OAAO,WAAW;AAAA,IAC7B;AACA,WAAO,EAAE,MAAM,EAAE,WAAW,EAAE;AAAA,EAChC;AACF;;;AC9BA,SAAS,cAAc;AACvB,OAAO,UAAU;AAyCL;AA3BZ,SAAS,WAAW,MAAuB;AACzC,SAAO,gBAAgB,KAAK,IAAI;AAClC;AAWO,SAAS,WAAW,EAAE,MAAM,WAAW,iBAAiB,OAAO,KAAK,GAAoB;AAC7F,MAAI,KAAK,WAAW,EAAG,QAAO;AAE9B,SACE,oBAAC,SAAI,WAAsB,aAAU,eAClC,eAAK,IAAI,CAAC,QACT;AAAA,IAAC;AAAA;AAAA,MAEC,SAAO;AAAA,MACP;AAAA,MACA,WAAW;AAAA,MACX,eAAa,IAAI,eAAe;AAAA,MAE/B,qBAAW,IAAI,IAAI,IAClB,oBAAC,OAAE,MAAM,IAAI,MAAM,QAAO,UAAS,KAAI,uBACpC,cAAI,OACP,IAEA,oBAAC,QAAK,MAAM,IAAI,MAAO,cAAI,OAAM;AAAA;AAAA,IAX9B,IAAI;AAAA,EAaX,CACD,GACH;AAEJ;;;ACpCM,gBAAAA,YAAA;AALC,SAAS,gBAAgB,EAAE,KAAK,GAAyB;AAC9D,MAAI,KAAK,WAAW,EAAG,QAAO;AAE9B,SACE,gBAAAA,KAAC,SAAI,WAAU,uJACb,0BAAAA;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA,WAAU;AAAA,MACV,iBAAgB;AAAA,MAChB,MAAK;AAAA;AAAA,EACP,GACF;AAEJ;;;AC6BgC,0BAAAC,YAAA;AAZhC,eAAsB,YAAY;AAAA,EAChC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,WAAW;AACb,GAAqB;AACnB,QAAM,EAAE,MAAM,KAAK,IAAI,MAAM,OAAO,KACjC,KAAK,IAAI,EACT,MAAM,OAAO,EAAE,MAAM,CAAC,EAAW,EAAE;AAEtC,MAAI,KAAK,WAAW,EAAG,QAAO,gBAAAA,KAAA,YAAG,oBAAS;AAE1C,SACE,gBAAAA,KAAC,cAAW,MAAY,WAAsB,iBAAkC,MAAY;AAEhG;","names":["jsx","jsx"]}
+{"version":3,"sources":["../src/next-cache-adapter.ts","../src/cta-buttons.tsx","../src/sticky-mobile-cta.tsx","../src/editable-cta.tsx"],"sourcesContent":["import type { RebluCacheAdapter, RebluCachePolicy } from '@reblu/site-client'\n\n/**\n * Next.js ISR cache adapter (REB-418 / design doc §5.2).\n *\n * Implements the framework-agnostic {@link RebluCacheAdapter} interface exported\n * by `@reblu/site-client`, translating a {@link RebluCachePolicy} into the\n * `fetch` options Next understands. This is the piece that restores the exact\n * ISR behavior demo-site hard-codes today — now injected instead of baked in:\n *\n * ```ts\n * createRebluClient({ baseUrl, apiKey, cache: new NextCacheAdapter(60) })\n * ```\n *\n * - `revalidate` > 0  → `{ next: { revalidate } }` (time-based ISR)\n * - `revalidate` `false` / `0` → `{ cache: 'no-store' }` (dynamic / preview)\n * - omitted `revalidate` → the constructor `defaultRevalidate`\n */\nexport class NextCacheAdapter implements RebluCacheAdapter {\n  /**\n   * @param defaultRevalidate ISR window (seconds) applied when a request omits\n   *   its own `revalidate`. Defaults to `60` for parity with demo-site's current\n   *   ISR default (`client.ts:45`). Pass `false`/`0` to default to no-store.\n   */\n  constructor(private readonly defaultRevalidate: number | false = 60) {}\n\n  resolveRequestInit(policy: RebluCachePolicy): RequestInit {\n    const revalidate = policy.revalidate ?? this.defaultRevalidate\n    if (revalidate === false || revalidate === 0) {\n      return { cache: 'no-store' }\n    }\n    return { next: { revalidate } } as RequestInit\n  }\n}\n","'use client'\n\nimport type { Cta } from '@reblu/site-contracts'\nimport { Button, cn, type ButtonVariantProps } from '@reblu/site-ui'\nimport Link from 'next/link'\nimport type { ReactNode } from 'react'\n\ntype ButtonSize = 'sm' | 'default' | 'lg'\n\n/** A `@reblu/site-ui` Button variant (`default`, `outline`, `secondary`, …). */\nexport type CtaButtonVariant = NonNullable<ButtonVariantProps['variant']>\n\n/** Default screen-reader hint appended to CTAs that open in a new tab. */\nconst DEFAULT_NEW_WINDOW_HINT = '(se abre en una nueva ventana)'\n\nexport interface CtaButtonsProps {\n  ctas: Cta[]\n  /** Wrapper class (layout of the button group). */\n  className?: string\n  /** Class applied to each button. */\n  buttonClassName?: string\n  size?: ButtonSize\n  /**\n   * Leading icon rendered before every CTA label. Decorative: it is wrapped in\n   * an `aria-hidden` span, so the accessible name stays the label.\n   */\n  icon?: ReactNode\n  /** Button variant of the primary CTA (the first one, by `sortOrder`). Default `default`. */\n  primaryVariant?: CtaButtonVariant\n  /** Button variant of every secondary CTA (all but the first). Default `default`. */\n  secondaryVariant?: CtaButtonVariant\n  /**\n   * Extra class for the primary CTA, merged after `buttonClassName`. Lets a SITE\n   * map the primary CTA to its own button style (e.g. a brand `cta` variant).\n   */\n  primaryClassName?: string\n  /** Extra class for every secondary CTA, merged after `buttonClassName`. */\n  secondaryClassName?: string\n  /**\n   * Visually-hidden text appended to CTAs that open in a new tab, so screen\n   * readers announce the context change. Default «(se abre en una nueva ventana)».\n   */\n  newWindowHint?: string\n}\n\n/** External = absolute http(s) URL (e.g. a third-party booking link). */\nfunction isExternal(href: string): boolean {\n  return /^https?:\\/\\//i.test(href)\n}\n\n/**\n * Presentational CTA renderer (REB-394, moved to `@reblu/site-next` in REB-418).\n * Pure — takes already-resolved CTAs and renders one styled button-link each.\n * Internal hrefs use `next/link` (client routing); external URLs open in a new,\n * safely-rel tab and carry a visually-hidden new-window hint. `analyticsId` is\n * surfaced as `data-cta-id` on the clickable element for GA `cta_click`\n * tracking. Renders nothing when there are no CTAs.\n *\n * The first CTA is the primary one; the rest are secondary. Each role takes its\n * own Button variant and extra class, so a SITE maps the CTAs to its own button\n * styles without forking this markup.\n *\n * Imports `Button` from `@reblu/site-ui` (public) — never `@reblu/ui` (private).\n */\nexport function CtaButtons({\n  ctas,\n  className,\n  buttonClassName,\n  size = 'lg',\n  icon,\n  primaryVariant = 'default',\n  secondaryVariant = 'default',\n  primaryClassName,\n  secondaryClassName,\n  newWindowHint = DEFAULT_NEW_WINDOW_HINT,\n}: CtaButtonsProps) {\n  if (ctas.length === 0) return null\n\n  const leadingIcon =\n    icon == null ? null : (\n      <span aria-hidden='true' className='inline-flex shrink-0'>\n        {icon}\n      </span>\n    )\n\n  return (\n    <div className={className} data-slot='cta-buttons'>\n      {ctas.map((cta, index) => {\n        const isPrimary = index === 0\n        return (\n          <Button\n            key={cta.id}\n            asChild\n            size={size}\n            variant={isPrimary ? primaryVariant : secondaryVariant}\n            className={cn(buttonClassName, isPrimary ? primaryClassName : secondaryClassName)}\n            data-cta-id={cta.analyticsId ?? undefined}\n          >\n            {isExternal(cta.href) ? (\n              <a href={cta.href} target='_blank' rel='noopener noreferrer'>\n                {leadingIcon}\n                {cta.label}\n                {newWindowHint ? <> <span className='sr-only'>{newWindowHint}</span></> : null}\n              </a>\n            ) : (\n              <Link href={cta.href}>\n                {leadingIcon}\n                {cta.label}\n              </Link>\n            )}\n          </Button>\n        )\n      })}\n    </div>\n  )\n}\n","import type { Cta } from '@reblu/site-contracts'\n\nimport { CtaButtons } from './cta-buttons'\n\nexport interface StickyMobileCtaProps {\n  ctas: Cta[]\n}\n\n/**\n * StickyMobileCta (REB-394, moved to `@reblu/site-next` in REB-418) — a\n * mobile-only sticky bottom bar surfacing the `sticky-mobile` slot CTAs. Hidden\n * on `md+` (desktop has its own CTAs). Renders nothing when no CTA is configured,\n * so it never adds empty chrome.\n */\nexport function StickyMobileCta({ ctas }: StickyMobileCtaProps) {\n  if (ctas.length === 0) return null\n\n  return (\n    <div className='fixed inset-x-0 bottom-0 z-50 md:hidden border-t border-border bg-background/95 px-4 py-3 backdrop-blur supports-[backdrop-filter]:bg-background/80'>\n      <CtaButtons\n        ctas={ctas}\n        className='flex justify-center gap-3'\n        buttonClassName='w-full rounded-lg font-semibold'\n        size='lg'\n      />\n    </div>\n  )\n}\n","import type { RebluClient } from '@reblu/site-client'\nimport type { Cta } from '@reblu/site-contracts'\nimport type { ReactNode } from 'react'\n\nimport { CtaButtons, type CtaButtonsProps } from './cta-buttons'\n\n/** The `Cta.slot` union — the valid placement keys, sourced from the contract. */\nexport type CtaSlot = Cta['slot']\n\n/**\n * The slice of the SDK client `EditableCta` needs: just the `ctas` namespace.\n * Typing it structurally lets a SITE pass either the full `RebluClient` or a\n * narrower singleton, without coupling this component to the whole surface.\n */\nexport type CtaClient = Pick<RebluClient, 'ctas'>\n\n/** Presentation props `EditableCta` forwards unchanged to {@link CtaButtons}. */\ntype ForwardedButtonProps = Omit<CtaButtonsProps, 'ctas'>\n\nexport interface EditableCtaProps extends ForwardedButtonProps {\n  /** CtaSlot value: header | hero | blog-end | services | contact | sticky-mobile | footer. */\n  slot: CtaSlot\n  /** The Reblu SDK client instance the SITE owns (env-configured upstream). */\n  client: CtaClient\n  /**\n   * Rendered when the slot has no configured CTA (or the upstream fetch fails).\n   * Lets each placement keep its existing static CTA as a graceful fallback.\n   */\n  fallback?: ReactNode\n}\n\n/**\n * EditableCta (REB-394, moved to `@reblu/site-next` in REB-418) — drop-anywhere\n * async Server Component that renders the CTAs configured for a slot from nexus,\n * with no redeploy. Fetches active CTAs via the injected SDK client and degrades\n * gracefully: on empty/failure it renders `fallback` (a static CTA) instead of\n * breaking the page.\n *\n * The client is injected (prop or per-SITE singleton) so this package never\n * reads `process.env` and stays framework-glue only — the SITE owns the env and\n * wires the ISR-aware {@link NextCacheAdapter}.\n */\nexport async function EditableCta({ slot, client, fallback = null, ...buttonProps }: EditableCtaProps) {\n  const { data: ctas } = await client.ctas\n    .list(slot)\n    .catch(() => ({ data: [] as Cta[] }))\n\n  if (ctas.length === 0) return <>{fallback}</>\n\n  return <CtaButtons ctas={ctas} {...buttonProps} />\n}\n"],"mappings":";AAkBO,IAAM,mBAAN,MAAoD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMzD,YAA6B,oBAAoC,IAAI;AAAxC;AAAA,EAAyC;AAAA,EAAzC;AAAA,EAE7B,mBAAmB,QAAuC;AACxD,UAAM,aAAa,OAAO,cAAc,KAAK;AAC7C,QAAI,eAAe,SAAS,eAAe,GAAG;AAC5C,aAAO,EAAE,OAAO,WAAW;AAAA,IAC7B;AACA,WAAO,EAAE,MAAM,EAAE,WAAW,EAAE;AAAA,EAChC;AACF;;;AC9BA,SAAS,QAAQ,UAAmC;AACpD,OAAO,UAAU;AA4EX,SAsB2B,UAtB3B,KAsB2B,YAtB3B;AAnEN,IAAM,0BAA0B;AAiChC,SAAS,WAAW,MAAuB;AACzC,SAAO,gBAAgB,KAAK,IAAI;AAClC;AAgBO,SAAS,WAAW;AAAA,EACzB;AAAA,EACA;AAAA,EACA;AAAA,EACA,OAAO;AAAA,EACP;AAAA,EACA,iBAAiB;AAAA,EACjB,mBAAmB;AAAA,EACnB;AAAA,EACA;AAAA,EACA,gBAAgB;AAClB,GAAoB;AAClB,MAAI,KAAK,WAAW,EAAG,QAAO;AAE9B,QAAM,cACJ,QAAQ,OAAO,OACb,oBAAC,UAAK,eAAY,QAAO,WAAU,wBAChC,gBACH;AAGJ,SACE,oBAAC,SAAI,WAAsB,aAAU,eAClC,eAAK,IAAI,CAAC,KAAK,UAAU;AACxB,UAAM,YAAY,UAAU;AAC5B,WACE;AAAA,MAAC;AAAA;AAAA,QAEC,SAAO;AAAA,QACP;AAAA,QACA,SAAS,YAAY,iBAAiB;AAAA,QACtC,WAAW,GAAG,iBAAiB,YAAY,mBAAmB,kBAAkB;AAAA,QAChF,eAAa,IAAI,eAAe;AAAA,QAE/B,qBAAW,IAAI,IAAI,IAClB,qBAAC,OAAE,MAAM,IAAI,MAAM,QAAO,UAAS,KAAI,uBACpC;AAAA;AAAA,UACA,IAAI;AAAA,UACJ,gBAAgB,iCAAE;AAAA;AAAA,YAAC,oBAAC,UAAK,WAAU,WAAW,yBAAc;AAAA,aAAO,IAAM;AAAA,WAC5E,IAEA,qBAAC,QAAK,MAAM,IAAI,MACb;AAAA;AAAA,UACA,IAAI;AAAA,WACP;AAAA;AAAA,MAjBG,IAAI;AAAA,IAmBX;AAAA,EAEJ,CAAC,GACH;AAEJ;;;AChGM,gBAAAA,YAAA;AALC,SAAS,gBAAgB,EAAE,KAAK,GAAyB;AAC9D,MAAI,KAAK,WAAW,EAAG,QAAO;AAE9B,SACE,gBAAAA,KAAC,SAAI,WAAU,uJACb,0BAAAA;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA,WAAU;AAAA,MACV,iBAAgB;AAAA,MAChB,MAAK;AAAA;AAAA,EACP,GACF;AAEJ;;;ACoBgC,qBAAAC,WAAA,OAAAC,YAAA;AALhC,eAAsB,YAAY,EAAE,MAAM,QAAQ,WAAW,MAAM,GAAG,YAAY,GAAqB;AACrG,QAAM,EAAE,MAAM,KAAK,IAAI,MAAM,OAAO,KACjC,KAAK,IAAI,EACT,MAAM,OAAO,EAAE,MAAM,CAAC,EAAW,EAAE;AAEtC,MAAI,KAAK,WAAW,EAAG,QAAO,gBAAAA,KAAAD,WAAA,EAAG,oBAAS;AAE1C,SAAO,gBAAAC,KAAC,cAAW,MAAa,GAAG,aAAa;AAClD;","names":["jsx","Fragment","jsx"]}

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":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;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;AASO,SAAS,qBAAqB,OAAyC;AAC5E,QAAM,UAAU,MAAM,KAAK;AAC3B,MAAI;AACJ,MAAI;AACF,UAAM,IAAI,IAAI,OAAO;AAAA,EACvB,QAAQ;AACN,WAAO;AAAA,EACT;AACA,MAAI,IAAI,aAAa,SAAU,QAAO;AAGtC,MAAI,IAAI,YAAY,IAAI,YAAY,IAAI,UAAU,IAAI,QAAQ,OAAO,KAAK,OAAO,GAAG;AAClF,WAAO;AAAA,EACT;AACA,MAAI,IAAI,SAAS,QAAQ,QAAQ,EAAE,MAAM,GAAI,QAAO;AACpD,SAAO;AACT;AAQO,SAAS,sBAAsB,OAAiD;AACrF,QAAM,UAAU,OAAO,KAAK;AAC5B,MAAI,CAAC,WAAW,qBAAqB,OAAO,MAAM,KAAM,QAAO;AAC/D,SAAO,IAAI,IAAI,OAAO,EAAE;AAC1B;AAmBO,SAAS,oBAAoB,QAA+B;AACjE,SAAO,OAAO,UAAU,KAAK,KAAK,OAAO,UAAU,KAAK,KAAK;AAC/D;AAGO,SAAS,0BAA0B,QAA+B;AACvE,SAAO,OAAO,gBAAgB,KAAK,KAAK,OAAO,iBAAiB,KAAK,KAAK;AAC5E;AAuBO,SAAS,cAAc,OAAqC;AACjE,MAAI,MAAM,KAAM,QAAO,kBAAkB,KAAK;AAE9C,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;AAEA,SAAS,kBAAkB,OAAqC;AAC9D,QAAM,WAAqB,CAAC;AAC5B,QAAM,eAAe,sBAAsB,MAAM,OAAO,YAAY;AACpE,MAAI,aAAc,UAAS,eAAe,IAAI,IAAI,YAAY;AAE9D,QAAM,QAAQ,oBAAoB,MAAM,MAAM;AAC9C,MAAI,MAAO,UAAS,QAAQ,EAAE,UAAU,MAAM;AAC9C,QAAM,cAAc,MAAM,aAAa,KAAK,KAAK,0BAA0B,MAAM,MAAM;AACvF,MAAI,YAAa,UAAS,cAAc;AAExC,MAAI,aAAc,UAAS,aAAa,EAAE,WAAW,IAAI;AACzD,SAAO;AACT;","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":[]}