wpheadless-lib 1.1.16 → 1.1.18

package/dist/utils/seo.d.ts

@@ -32,6 +32,9 @@ export declare function getOgImageUrl(entity?: OgLike, featuredMedia?: FeaturedM
 type RewriteOpts = {
     siteUrl?: string;
     wpApiUrl?: string;
+    basePath?: string;
+    inLanguage?: string;
+    canonicalUrl?: string;
 };
 /**
  * Replace Yoast URLs so they match the frontend domain instead of the WP API domain.

package/dist/utils/seo.js

@@ -19,13 +19,22 @@ const normalizeWpApiOrigin = (wpApiUrl) => {
     const cleaned = wpApiUrl.replace(/\/wp-json\/?$/, "");
     return getOrigin(cleaned);
 };
+const normalizeBasePath = (basePath) => {
+    if (!basePath || basePath === "/")
+        return "";
+    return `/${basePath.replace(/^\/+|\/+$/g, "")}`;
+};
 const resolveRewriteOrigins = (opts, canonical) => {
     const targetOrigin = getOrigin(opts.siteUrl);
     const sourceOrigin = normalizeWpApiOrigin(opts.wpApiUrl) || getOrigin(canonical);
-    if (!targetOrigin || !sourceOrigin || targetOrigin === sourceOrigin) {
+    const basePath = normalizeBasePath(opts.basePath);
+    if (!targetOrigin || !sourceOrigin) {
+        return null;
+    }
+    if (targetOrigin === sourceOrigin && !basePath) {
         return null;
     }
-    return { targetOrigin, sourceOrigin };
+    return { targetOrigin, sourceOrigin, basePath };
 };
 const IMAGE_EXTENSIONS = [
     ".jpg",
@@ -43,15 +52,35 @@ const isImageUrl = (url) => {
     return (pathname.includes("/wp-content/uploads/") ||
         IMAGE_EXTENSIONS.some((ext) => pathname.endsWith(ext)));
 };
-const rewriteSchemaValue = (value, { targetOrigin, sourceOrigin }) => {
+const addBasePath = (url, basePath) => {
+    if (!basePath)
+        return;
+    if (url.hash.startsWith("#/schema/person/"))
+        return;
+    if (url.pathname === basePath || url.pathname.startsWith(`${basePath}/`)) {
+        return;
+    }
+    url.pathname = `${basePath}${url.pathname === "/" ? "/" : url.pathname}`;
+};
+const nodeHasType = (node, expected) => {
+    const type = node["@type"];
+    if (Array.isArray(type))
+        return type.includes(expected);
+    return type === expected;
+};
+const rewriteSchemaValue = (value, { targetOrigin, sourceOrigin, basePath }) => {
     if (Array.isArray(value)) {
-        return value.map((item) => rewriteSchemaValue(item, { targetOrigin, sourceOrigin }));
+        return value.map((item) => rewriteSchemaValue(item, { targetOrigin, sourceOrigin, basePath }));
     }
     if (value && typeof value === "object") {
         const obj = value;
         const rewritten = {};
         for (const [key, val] of Object.entries(obj)) {
-            rewritten[key] = rewriteSchemaValue(val, { targetOrigin, sourceOrigin });
+            rewritten[key] = rewriteSchemaValue(val, {
+                targetOrigin,
+                sourceOrigin,
+                basePath,
+            });
         }
         return rewritten;
     }
@@ -63,11 +92,15 @@ const rewriteSchemaValue = (value, { targetOrigin, sourceOrigin }) => {
         catch {
             return value;
         }
-        if (parsed.origin !== sourceOrigin)
-            return value;
         if (isImageUrl(parsed))
             return value;
-        return value.split(sourceOrigin).join(targetOrigin);
+        if (parsed.origin !== sourceOrigin && parsed.origin !== targetOrigin) {
+            return value;
+        }
+        parsed.protocol = new URL(targetOrigin).protocol;
+        parsed.host = new URL(targetOrigin).host;
+        addBasePath(parsed, basePath);
+        return parsed.toString();
     }
     return value;
 };
@@ -77,6 +110,95 @@ const rewriteYoastSchemaUrls = (schema, opts, canonical) => {
         return schema;
     return rewriteSchemaValue(schema, origins);
 };
+const applyCanonicalUrlOverride = (schema, canonicalUrl) => {
+    if (!canonicalUrl || !schema || typeof schema !== "object")
+        return schema;
+    const graph = schema["@graph"];
+    if (!Array.isArray(graph))
+        return schema;
+    const pageUrls = new Set();
+    for (const node of graph) {
+        if (!nodeHasType(node, "WebPage"))
+            continue;
+        if (typeof node["@id"] === "string")
+            pageUrls.add(node["@id"]);
+        if (typeof node.url === "string")
+            pageUrls.add(node.url);
+    }
+    if (!pageUrls.size)
+        return schema;
+    const replacePageReferences = (value) => {
+        if (typeof value === "string") {
+            return pageUrls.has(value) ? canonicalUrl : value;
+        }
+        if (Array.isArray(value))
+            return value.map(replacePageReferences);
+        if (value && typeof value === "object") {
+            return Object.fromEntries(Object.entries(value).map(([key, val]) => [
+                key,
+                replacePageReferences(val),
+            ]));
+        }
+        return value;
+    };
+    const normalizedGraph = graph.map((node) => {
+        const next = replacePageReferences(node);
+        if (nodeHasType(next, "WebPage")) {
+            next["@id"] = canonicalUrl;
+            next.url = canonicalUrl;
+        }
+        return next;
+    });
+    return { ...schema, "@graph": normalizedGraph };
+};
+const getYoastDescription = (yoast) => {
+    const description = yoast?.description || yoast?.og_description;
+    return typeof description === "string" && description.trim()
+        ? description.trim()
+        : undefined;
+};
+const toIsoDateTime = (date) => {
+    if (typeof date !== "string" || !date.trim())
+        return undefined;
+    const trimmed = date.trim();
+    if (/[zZ]$|[+-]\d{2}:?\d{2}$/.test(trimmed))
+        return trimmed;
+    return `${trimmed}+00:00`;
+};
+const getModifiedDate = (entity, yoast) => {
+    const dates = entity;
+    return (toIsoDateTime(dates?.modified_gmt) ||
+        toIsoDateTime(yoast?.article_modified_time) ||
+        toIsoDateTime(dates?.modified));
+};
+const enrichYoastSchema = (schema, entity, yoast, opts) => {
+    if (!schema || typeof schema !== "object")
+        return schema;
+    const graph = schema["@graph"];
+    if (!Array.isArray(graph))
+        return schema;
+    const description = getYoastDescription(yoast);
+    const dateModified = getModifiedDate(entity, yoast);
+    const enriched = graph.map((node) => {
+        const next = { ...node };
+        if (opts.inLanguage && "inLanguage" in next) {
+            next.inLanguage = opts.inLanguage;
+        }
+        if (typeof next.description === "string" && !next.description.trim()) {
+            delete next.description;
+        }
+        if (description &&
+            (nodeHasType(next, "Article") || nodeHasType(next, "WebPage"))) {
+            next.description = description;
+        }
+        if (dateModified &&
+            (nodeHasType(next, "Article") || nodeHasType(next, "WebPage"))) {
+            next.dateModified = dateModified;
+        }
+        return next;
+    });
+    return { ...schema, "@graph": enriched };
+};
 /**
  * Replace Yoast URLs so they match the frontend domain instead of the WP API domain.
  * It stringifies the object to replace origins and keeps structure intact.
@@ -173,7 +295,10 @@ export function getYoastSchema(entity, opts) {
     const yoast = entity?.yoast_head_json;
     if (!yoast?.schema)
         return null;
-    return rewriteYoastSchemaUrls(yoast.schema, opts ?? {}, yoast.canonical) || null;
+    const options = opts ?? {};
+    const enriched = enrichYoastSchema(yoast.schema, entity, yoast, options);
+    const rewritten = rewriteYoastSchemaUrls(enriched, options, yoast.canonical);
+    return applyCanonicalUrlOverride(rewritten, options.canonicalUrl) || null;
 }
 export function stripBreadcrumbsFromSchema(schema) {
     if (!schema || typeof schema !== "object")
@@ -181,15 +306,56 @@ export function stripBreadcrumbsFromSchema(schema) {
     const graph = schema["@graph"];
     if (!Array.isArray(graph))
         return schema;
-    const filtered = graph.filter((node) => {
-        const type = node["@type"];
-        if (!type)
-            return true;
-        if (Array.isArray(type)) {
-            return !type.includes("BreadcrumbList");
+    const containsGravatarUrl = (value) => {
+        if (typeof value === "string") {
+            try {
+                return new URL(value).hostname.endsWith("gravatar.com");
+            }
+            catch {
+                return false;
+            }
         }
-        return type !== "BreadcrumbList";
-    });
+        if (Array.isArray(value))
+            return value.some(containsGravatarUrl);
+        if (value && typeof value === "object") {
+            return Object.values(value).some(containsGravatarUrl);
+        }
+        return false;
+    };
+    const stripSchemaReferences = (node) => {
+        const rest = { ...node };
+        delete rest.breadcrumb;
+        if (nodeHasType(rest, "Article")) {
+            delete rest.commentCount;
+            if (Array.isArray(rest.potentialAction)) {
+                const actions = rest.potentialAction.filter((action) => {
+                    if (!action || typeof action !== "object")
+                        return true;
+                    return !nodeHasType(action, "CommentAction");
+                });
+                if (actions.length) {
+                    rest.potentialAction = actions;
+                }
+                else {
+                    delete rest.potentialAction;
+                }
+            }
+        }
+        if (nodeHasType(rest, "WebSite")) {
+            delete rest.potentialAction;
+        }
+        if (nodeHasType(rest, "Person")) {
+            delete rest.sameAs;
+            delete rest.url;
+            if (containsGravatarUrl(rest.image)) {
+                delete rest.image;
+            }
+        }
+        return rest;
+    };
+    const filtered = graph.filter((node) => {
+        return !nodeHasType(node, "BreadcrumbList");
+    }).map(stripSchemaReferences);
     return { ...schema, "@graph": filtered };
 }
 export function getFeaturedMedia(entity) {

package/dist/views/CategoryListView/index.d.ts

@@ -11,6 +11,8 @@ type CategoryListViewProps = {
     locale?: Locale;
     dateLocale?: string;
     languageLinks?: LanguageLink[];
+    siteUrl?: string;
+    wpApiUrl?: string;
 };
-export declare function CategoryListView({ category, posts, totalPages, baseUrl, homeHref, linkBasePath, locale, dateLocale, languageLinks, }: CategoryListViewProps): import("react").JSX.Element;
+export declare function CategoryListView({ category, posts, totalPages, baseUrl, homeHref, linkBasePath, locale, dateLocale, languageLinks, siteUrl, wpApiUrl, }: CategoryListViewProps): import("react").JSX.Element;
 export {};

package/dist/views/CategoryListView/index.js

@@ -4,13 +4,18 @@ import PostCard from "../../components/PostCard/index.js";
 import styles from "./index.module.css";
 import { getCountLabel, getEmptyLabel, getPaginatorBase } from "./index.utils.js";
 import { Breadcrumbs, JsonLd, LanguageLinks } from "../../components/index.js";
-import { getTranslator, getYoastSchema } from "../../utils/index.js";
-export function CategoryListView({ category, posts, totalPages, baseUrl, homeHref = "/", linkBasePath, locale, dateLocale = "en-US", languageLinks, }) {
+import { getTranslator, getYoastSchema, stripBreadcrumbsFromSchema, } from "../../utils/index.js";
+export function CategoryListView({ category, posts, totalPages, baseUrl, homeHref = "/", linkBasePath, locale, dateLocale = "en-US", languageLinks, siteUrl, wpApiUrl, }) {
     const paginatorBase = getPaginatorBase(category, baseUrl);
     const countLabel = getCountLabel(category, locale);
     const emptyLabel = getEmptyLabel(locale);
     const t = getTranslator(locale);
-    return (_jsxs("div", { className: styles.container, children: [_jsx(JsonLd, { data: getYoastSchema(category) }), _jsxs("header", { className: styles.header, children: [_jsx(Breadcrumbs, { items: [
+    return (_jsxs("div", { className: styles.container, children: [_jsx(JsonLd, { data: stripBreadcrumbsFromSchema(getYoastSchema(category, {
+                    siteUrl,
+                    wpApiUrl,
+                    basePath: linkBasePath,
+                    inLanguage: dateLocale,
+                })) }), _jsxs("header", { className: styles.header, children: [_jsx(Breadcrumbs, { items: [
                             { label: "Home", href: homeHref },
                             { label: category.name },
                         ] }), _jsx("h1", { className: styles.title, children: category.name }), category.description && (_jsx("div", { className: styles.description, dangerouslySetInnerHTML: { __html: category.description } })), countLabel && _jsx("p", { className: styles.count, children: countLabel })] }), posts.length === 0 ? (_jsx("p", { className: styles.empty, children: emptyLabel })) : (_jsxs("section", { "aria-label": t("home.title"), className: styles.gridSection, children: [_jsx("div", { className: styles.grid, children: posts.map((post) => (_jsx(PostCard, { post: post, categorySlug: category.slug, basePath: linkBasePath, locale: locale, dateLocale: dateLocale }, post.id))) }), _jsx(Paginator, { currentPage: 1, totalPages: totalPages, baseUrl: paginatorBase, locale: locale }), _jsx(LanguageLinks, { links: languageLinks, locale: locale })] }))] }));

package/dist/views/LegalPageView/index.d.ts

@@ -8,6 +8,10 @@ type LegalPageViewProps = {
     locale?: Locale;
     priorityImage?: boolean;
     languageLinks?: LanguageLink[];
+    siteUrl?: string;
+    wpApiUrl?: string;
+    basePath?: string;
+    renderYoastSchema?: boolean;
 };
-export declare function LegalPageView({ page, homeHref, locale, priorityImage, languageLinks, }: LegalPageViewProps): import("react").JSX.Element;
+export declare function LegalPageView({ page, dateLocale, homeHref, locale, priorityImage, languageLinks, siteUrl, wpApiUrl, basePath, renderYoastSchema, }: LegalPageViewProps): import("react").JSX.Element;
 export {};

package/dist/views/LegalPageView/index.js

@@ -3,10 +3,18 @@ import Image from "next/image";
 import styles from "./index.module.css";
 import { getLegalContent, getLegalImage } from "./index.utils.js";
 import { Breadcrumbs, JsonLd, LanguageLinks } from "../../components/index.js";
-import { getYoastSchema, stripTags } from "../../utils/index.js";
-export function LegalPageView({ page, homeHref, locale, priorityImage = true, languageLinks, }) {
+import { getYoastSchema, stripBreadcrumbsFromSchema, stripTags, } from "../../utils/index.js";
+export function LegalPageView({ page, dateLocale = "en-US", homeHref, locale, priorityImage = true, languageLinks, siteUrl, wpApiUrl, basePath, renderYoastSchema = true, }) {
     const featuredImage = getLegalImage(page);
     const { titleHtml, contentHtml } = getLegalContent(page);
     const titleText = stripTags(titleHtml) || titleHtml;
-    return (_jsxs("article", { className: styles.article, children: [_jsx(JsonLd, { data: getYoastSchema(page) }), _jsx(Breadcrumbs, { items: [{ label: "Home", href: homeHref }, { label: titleText }] }), featuredImage && (_jsx("div", { className: styles.imageWrapper, children: _jsx(Image, { src: featuredImage.src, alt: featuredImage.alt, width: featuredImage.width, height: featuredImage.height, className: styles.image, priority: priorityImage }) })), _jsx("h1", { dangerouslySetInnerHTML: { __html: titleHtml }, className: styles.title }), _jsx(LanguageLinks, { links: languageLinks, locale: locale }), _jsx("div", { dangerouslySetInnerHTML: { __html: contentHtml }, className: `post-content ${styles.content}` })] }));
+    const yoastSchema = renderYoastSchema
+        ? stripBreadcrumbsFromSchema(getYoastSchema(page, {
+            siteUrl,
+            wpApiUrl,
+            basePath,
+            inLanguage: dateLocale,
+        }))
+        : null;
+    return (_jsxs("article", { className: styles.article, children: [_jsx(JsonLd, { data: yoastSchema }), _jsx(Breadcrumbs, { items: [{ label: "Home", href: homeHref }, { label: titleText }] }), featuredImage && (_jsx("div", { className: styles.imageWrapper, children: _jsx(Image, { src: featuredImage.src, alt: featuredImage.alt, width: featuredImage.width, height: featuredImage.height, className: styles.image, priority: priorityImage }) })), _jsx("h1", { dangerouslySetInnerHTML: { __html: titleHtml }, className: styles.title }), _jsx(LanguageLinks, { links: languageLinks, locale: locale }), _jsx("div", { dangerouslySetInnerHTML: { __html: contentHtml }, className: `post-content ${styles.content}` })] }));
 }

package/dist/views/PostView/index.d.ts

@@ -12,6 +12,7 @@ type PostViewProps = {
     siteUrl?: string;
     wpApiUrl?: string;
     languageLinks?: LanguageLink[];
+    renderYoastSchema?: boolean;
 };
-export declare function PostView({ post, dateLocale, categoryBasePath, locale, authorDescription, disclaimer, priorityImage, siteUrl, wpApiUrl, languageLinks, }: PostViewProps): import("react").JSX.Element;
+export declare function PostView({ post, dateLocale, categoryBasePath, locale, authorDescription, disclaimer, priorityImage, siteUrl, wpApiUrl, languageLinks, renderYoastSchema, }: PostViewProps): import("react").JSX.Element;
 export {};

package/dist/views/PostView/index.js

@@ -2,7 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import Image from "next/image";
 import Link from "next/link";
 import styles from "./index.module.css";
-import { getTranslator, getYoastSchema, rewritePostContentLinks, } from "../../utils/index.js";
+import { getTranslator, getYoastSchema, rewritePostContentLinks, stripBreadcrumbsFromSchema, } from "../../utils/index.js";
 import { Breadcrumbs, JsonLd, LanguageLinks } from "../../components/index.js";
 import { buildCategoryUrl, formatPublishedDate, getAuthor, getFeaturedImage, getPrimaryCategory, } from "./index.utils.js";
 import { stripTags } from "../../utils/index.js";
@@ -11,7 +11,7 @@ function truncateLabel(label, max = 20) {
     const trimmed = label.trim();
     return trimmed.length > max ? `${trimmed.slice(0, max)}…` : trimmed;
 }
-export function PostView({ post, dateLocale = "en-US", categoryBasePath = "/", locale, authorDescription, disclaimer, priorityImage = true, siteUrl, wpApiUrl, languageLinks, }) {
+export function PostView({ post, dateLocale = "en-US", categoryBasePath = "/", locale, authorDescription, disclaimer, priorityImage = true, siteUrl, wpApiUrl, languageLinks, renderYoastSchema = true, }) {
     const t = getTranslator(locale);
     const author = getAuthor(post);
     const authorBio = authorDescription ?? author?.description;
@@ -34,5 +34,13 @@ export function PostView({ post, dateLocale = "en-US", categoryBasePath = "/", l
             { label: "Home", href: categoryBasePath },
             { label: stripTags(post.title.rendered) || post.title.rendered },
         ];
-    return (_jsxs("div", { className: styles.container, children: [_jsx(JsonLd, { data: getYoastSchema(post) }), _jsxs("article", { className: styles.article, children: [_jsx(Breadcrumbs, { items: breadcrumbs }), featuredImage && (_jsxs("figure", { className: styles.figure, children: [_jsx(Image, { src: featuredImage.src, alt: featuredImage.alt, fill: true, className: styles.image, priority: priorityImage, sizes: "(max-width: 1200px) 100vw, 1200px" }), _jsx("div", { className: styles.heroOverlay, "aria-hidden": "true" }), primaryCategory && (_jsx("div", { className: styles.badgeOverlay, children: categoryUrl ? (_jsx(Link, { href: categoryUrl, className: badgeClassName(), title: primaryCategory.name, children: truncateLabel(primaryCategory.name, 20) })) : (_jsx("span", { className: badgeClassName(), title: primaryCategory.name, children: truncateLabel(primaryCategory.name, 20) })) })), _jsx("h1", { dangerouslySetInnerHTML: { __html: post.title.rendered }, className: `${styles.title} ${styles.heroTitle}` })] })), !featuredImage && (_jsx("header", { className: styles.postHeader, children: _jsx("h1", { dangerouslySetInnerHTML: { __html: post.title.rendered }, className: styles.title }) })), _jsxs("div", { className: styles.meta, children: [author && (_jsx("span", { className: styles.authorLabel, children: t("post.authorPrefix", { name: author.name }) })), _jsx("span", { children: "\u2022" }), _jsx("time", { dateTime: post.date, children: publishedDate })] }), _jsx("div", { dangerouslySetInnerHTML: { __html: contentHtml }, className: `post-content ${styles.content}` }), disclaimer && (_jsx(Alert, { className: styles.disclaimer, role: "note", children: disclaimer })), _jsx(LanguageLinks, { links: languageLinks, locale: locale }), author && (_jsx(Card, { as: "aside", className: styles.authorCard, size: "sm", children: _jsx(CardContent, { children: _jsxs("address", { className: styles.authorAddress, children: [_jsx("strong", { className: styles.authorName, children: author.name }), authorBio && _jsx("p", { className: styles.authorBio, children: authorBio })] }) }) }))] })] }));
+    const yoastSchema = renderYoastSchema
+        ? stripBreadcrumbsFromSchema(getYoastSchema(post, {
+            siteUrl,
+            wpApiUrl,
+            basePath: categoryBasePath,
+            inLanguage: dateLocale,
+        }))
+        : null;
+    return (_jsxs("div", { className: styles.container, children: [_jsx(JsonLd, { data: yoastSchema }), _jsxs("article", { className: styles.article, children: [_jsx(Breadcrumbs, { items: breadcrumbs }), featuredImage && (_jsxs("figure", { className: styles.figure, children: [_jsx(Image, { src: featuredImage.src, alt: featuredImage.alt, fill: true, className: styles.image, priority: priorityImage, sizes: "(max-width: 1200px) 100vw, 1200px" }), _jsx("div", { className: styles.heroOverlay, "aria-hidden": "true" }), primaryCategory && (_jsx("div", { className: styles.badgeOverlay, children: categoryUrl ? (_jsx(Link, { href: categoryUrl, className: badgeClassName(), title: primaryCategory.name, children: truncateLabel(primaryCategory.name, 20) })) : (_jsx("span", { className: badgeClassName(), title: primaryCategory.name, children: truncateLabel(primaryCategory.name, 20) })) })), _jsx("h1", { dangerouslySetInnerHTML: { __html: post.title.rendered }, className: `${styles.title} ${styles.heroTitle}` })] })), !featuredImage && (_jsx("header", { className: styles.postHeader, children: _jsx("h1", { dangerouslySetInnerHTML: { __html: post.title.rendered }, className: styles.title }) })), _jsxs("div", { className: styles.meta, children: [author && (_jsx("span", { className: styles.authorLabel, children: t("post.authorPrefix", { name: author.name }) })), _jsx("span", { children: "\u2022" }), _jsx("time", { dateTime: post.date, children: publishedDate })] }), _jsx("div", { dangerouslySetInnerHTML: { __html: contentHtml }, className: `post-content ${styles.content}` }), disclaimer && (_jsx(Alert, { className: styles.disclaimer, role: "note", children: disclaimer })), _jsx(LanguageLinks, { links: languageLinks, locale: locale }), author && (_jsx(Card, { as: "aside", className: styles.authorCard, size: "sm", children: _jsx(CardContent, { children: _jsxs("address", { className: styles.authorAddress, children: [_jsx("strong", { className: styles.authorName, children: author.name }), authorBio && _jsx("p", { className: styles.authorBio, children: authorBio })] }) }) }))] })] }));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wpheadless-lib",
-  "version": "1.1.16",
+  "version": "1.1.18",
   "private": false,
   "type": "module",
   "main": "dist/index.js",