wpheadless-lib 1.0.0

package/dist/components/PostCard/index.module.css

@@ -0,0 +1,56 @@
+.card {
+  position: relative;
+  display: flex;
+  flex-direction: column;
+  height: 100%;
+}
+
+.badges {
+  display: flex;
+  gap: 0.5rem;
+  flex-wrap: wrap;
+  padding: var(--spacing-sm) var(--spacing-md) 0;
+}
+
+.badge {
+  text-decoration: none;
+}
+
+.postLink {
+  text-decoration: none;
+  color: inherit;
+  display: block;
+  height: 100%;
+}
+
+.imageWrapper {
+  position: relative;
+  height: 220px;
+  overflow: hidden;
+}
+
+.body {
+  padding: var(--spacing-sm) var(--spacing-md) var(--spacing-md);
+  display: flex;
+  flex-direction: column;
+  gap: var(--spacing-sm);
+  align-items: flex-start;
+}
+
+.title {
+  font-size: 1.25rem;
+  font-weight: 700;
+  line-height: 1.3;
+  color: var(--foreground);
+}
+
+.excerpt {
+  font-size: 0.9375rem;
+  color: var(--foreground-light);
+  line-height: 1.5;
+}
+
+.date {
+  font-size: 0.875rem;
+  color: var(--foreground-light);
+}

package/dist/components/PostCard/index.types.d.ts

@@ -0,0 +1,7 @@
+import type { WPPost } from "wpjsapi-lib";
+import { type Locale } from "../../utils";
+export type BuildUrlArgs = {
+    post: WPPost;
+    categorySlug?: string;
+    locale?: Locale;
+};

package/dist/components/PostCard/index.types.js

@@ -0,0 +1 @@
+export {};

package/dist/components/PostCard/index.utils.d.ts

@@ -0,0 +1,8 @@
+import type { WPPost } from "wpjsapi-lib";
+import { type Locale } from "../../utils";
+import type { BuildUrlArgs } from "./index.types";
+export declare const getLangPrefix: (locale?: Locale) => string;
+export declare const resolveCategorySlug: (post: WPPost, categorySlug?: string) => string | undefined;
+export declare const buildPostUrl: ({ post, categorySlug, locale }: BuildUrlArgs) => string;
+export declare const buildCategoryUrl: (slug: string, locale?: Locale) => string;
+export declare const formatPostDate: (date: string, dateLocale?: string) => string;

package/dist/components/PostCard/index.utils.js

@@ -0,0 +1,23 @@
+import { ensureTrailingSlash } from "../../utils";
+export const getLangPrefix = (locale) => locale && locale !== "en" ? `/${locale}` : "";
+export const resolveCategorySlug = (post, categorySlug) => {
+    if (categorySlug)
+        return categorySlug;
+    const categories = (post._embedded?.["wp:term"]?.[0] || []);
+    return categories[0]?.slug;
+};
+export const buildPostUrl = ({ post, categorySlug, locale }) => {
+    const langPrefix = getLangPrefix(locale);
+    const resolvedCategory = categorySlug || resolveCategorySlug(post);
+    const postPath = resolvedCategory
+        ? `/${resolvedCategory}/${post.slug}`
+        : `/${post.slug}`;
+    const url = `${langPrefix}${postPath}`.replace(/\/+/g, "/");
+    return ensureTrailingSlash(url);
+};
+export const buildCategoryUrl = (slug, locale) => ensureTrailingSlash(`${getLangPrefix(locale)}/${slug}`.replace(/\/+/g, "/"));
+export const formatPostDate = (date, dateLocale) => new Date(date).toLocaleDateString(dateLocale || "en-US", {
+    year: "numeric",
+    month: "long",
+    day: "numeric",
+});

package/dist/components/index.d.ts

@@ -0,0 +1,5 @@
+export { default as Header } from "./layout/Header";
+export { default as Footer } from "./layout/Footer";
+export { default as Paginator } from "./Paginator";
+export { default as PostCard } from "./PostCard";
+export { Breadcrumbs } from "./Breadcrumbs";

package/dist/components/index.js

@@ -0,0 +1,5 @@
+export { default as Header } from "./layout/Header";
+export { default as Footer } from "./layout/Footer";
+export { default as Paginator } from "./Paginator";
+export { default as PostCard } from "./PostCard";
+export { Breadcrumbs } from "./Breadcrumbs";

package/dist/components/layout/Footer/index.d.ts

@@ -0,0 +1,12 @@
+export declare const dynamic = "force-static";
+export declare const revalidate = 3600;
+type FooterProps = {
+    menuId: string;
+    wpApiUrl: string;
+    wpUsername: string;
+    wpAppPassword: string;
+    siteName: string;
+    locale?: string;
+};
+export default function Footer({ menuId, wpApiUrl, wpUsername, wpAppPassword, siteName, locale, }: FooterProps): Promise<import("react/jsx-runtime").JSX.Element>;
+export {};

package/dist/components/layout/Footer/index.js

@@ -0,0 +1,36 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import Link from "next/link";
+import { createMenuEndpoints, createAuth } from "wpjsapi-lib";
+import { convertWpUrl, getTranslator } from "../../../utils";
+import styles from "./index.module.css";
+export const dynamic = "force-static";
+export const revalidate = 3600;
+export default async function Footer({ menuId, wpApiUrl, wpUsername, wpAppPassword, siteName, locale, }) {
+    const auth = createAuth({
+        method: "basic",
+        credentials: {
+            username: wpUsername,
+            password: wpAppPassword,
+        },
+    });
+    const menusApi = createMenuEndpoints({
+        baseUrl: wpApiUrl,
+        auth,
+    });
+    let menuItems = [];
+    const t = getTranslator(locale);
+    try {
+        const parsedMenuId = parseInt(menuId);
+        const itemsResponse = await menusApi.items.list({
+            menus: [parsedMenuId],
+            per_page: 100,
+            orderby: "menu_order",
+            order: "asc",
+        });
+        menuItems = itemsResponse.items;
+    }
+    catch (e) {
+        console.error("Error obteniendo menú footer:", e);
+    }
+    return (_jsx("footer", { className: styles.footer, children: _jsx("div", { className: "container", children: _jsxs("div", { className: styles.wrapper, children: [_jsxs("div", { className: styles.grid, children: [_jsxs("div", { children: [_jsx("h3", { className: styles.siteName, children: siteName }), _jsx("p", { className: `${styles.muted} text-muted`, children: t("footer.tagline") })] }), menuItems.length > 0 && (_jsxs("nav", { "aria-label": t("footer.navAria"), className: styles.nav, children: [_jsx("h4", { className: styles.navTitle, children: t("footer.navTitle") }), _jsx("ul", { className: styles.list, children: menuItems.map((item) => (_jsx("li", { children: _jsx(Link, { href: convertWpUrl(item.url, wpApiUrl), className: "footer-link", children: item.title.rendered }) }, item.id))) })] }))] }), _jsxs("div", { className: styles.bottomBar, children: [_jsxs("span", { children: ["\u00A9 ", new Date().getFullYear(), " ", siteName] }), _jsx("span", { children: t("footer.noCookies") })] })] }) }) }));
+}

package/dist/components/layout/Footer/index.module.css

@@ -0,0 +1,61 @@
+.footer {
+  background: var(--background-alt);
+  border-top: 1px solid var(--border);
+  margin-top: var(--spacing-xl);
+}
+
+.wrapper {
+  padding: var(--spacing-xl) 0 var(--spacing-lg);
+}
+
+.grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
+  gap: var(--spacing-lg);
+  margin-bottom: var(--spacing-lg);
+}
+
+.siteName {
+  font-size: 1.25rem;
+  font-weight: bold;
+  margin-bottom: 1rem;
+  color: var(--foreground);
+}
+
+.muted {
+  font-size: 0.875rem;
+}
+
+.nav {
+  display: block;
+}
+
+.navTitle {
+  font-size: 0.875rem;
+  font-weight: 600;
+  margin-bottom: 1rem;
+  color: var(--foreground);
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+}
+
+.list {
+  list-style: none;
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+  margin: 0;
+  padding: 0;
+}
+
+.bottomBar {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  border-top: 1px solid var(--border);
+  padding-top: var(--spacing-md);
+  font-size: 0.875rem;
+  color: var(--foreground-light);
+  gap: var(--spacing-md);
+  flex-wrap: wrap;
+}

package/dist/components/layout/Header/index.d.ts

@@ -0,0 +1,13 @@
+export declare const dynamic = "force-static";
+export declare const revalidate = 3600;
+type HeaderProps = {
+    menuId: string;
+    wpApiUrl: string;
+    wpUsername: string;
+    wpAppPassword: string;
+    siteName: string;
+    homeHref?: string;
+    locale?: string;
+};
+export default function Header({ menuId, wpApiUrl, wpUsername, wpAppPassword, siteName, homeHref, locale, }: HeaderProps): Promise<import("react/jsx-runtime").JSX.Element>;
+export {};

package/dist/components/layout/Header/index.js

@@ -0,0 +1,36 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import Link from "next/link";
+import { createMenuEndpoints, createAuth } from "wpjsapi-lib";
+import { convertWpUrl, getTranslator } from "../../../utils";
+import styles from "./index.module.css";
+export const dynamic = "force-static";
+export const revalidate = 3600;
+export default async function Header({ menuId, wpApiUrl, wpUsername, wpAppPassword, siteName, homeHref = "/", locale, }) {
+    const t = getTranslator(locale);
+    const auth = createAuth({
+        method: "basic",
+        credentials: {
+            username: wpUsername,
+            password: wpAppPassword,
+        },
+    });
+    const menusApi = createMenuEndpoints({
+        baseUrl: wpApiUrl,
+        auth,
+    });
+    let menuItems = [];
+    try {
+        const parsedMenuId = parseInt(menuId);
+        const itemsResponse = await menusApi.items.list({
+            menus: [parsedMenuId],
+            per_page: 100,
+            orderby: "menu_order",
+            order: "asc",
+        });
+        menuItems = itemsResponse.items;
+    }
+    catch (e) {
+        console.error("Error obteniendo menú:", e);
+    }
+    return (_jsx("header", { className: styles.header, children: _jsx("div", { className: "container", children: _jsxs("div", { className: styles.inner, children: [_jsx(Link, { href: homeHref, className: styles.logo, children: siteName }), _jsx("div", { className: styles.navWrapper, children: menuItems.length > 0 && (_jsx("nav", { "aria-label": t("header.navAria"), className: styles.nav, children: _jsx("ul", { className: styles.list, children: menuItems.map((item) => (_jsx("li", { children: _jsx(Link, { href: convertWpUrl(item.url, wpApiUrl), className: "header-link", children: item.title.rendered }) }, item.id))) }) })) })] }) }) }));
+}

package/dist/components/layout/Header/index.module.css

@@ -0,0 +1,48 @@
+.header {
+  position: sticky;
+  top: 0;
+  z-index: 100;
+  border-bottom: 1px solid var(--border);
+  backdrop-filter: blur(20px);
+  background: var(--card-bg);
+  box-shadow: 0 1px 3px var(--shadow);
+}
+
+.inner {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 1.25rem 0;
+  gap: 3rem;
+}
+
+.logo {
+  font-size: 1.75rem;
+  font-weight: 700;
+  color: var(--primary);
+  font-family: var(--font-display);
+  letter-spacing: -0.02em;
+  text-decoration: none;
+}
+
+.navWrapper {
+  display: flex;
+  align-items: center;
+  gap: 2rem;
+  flex: 1;
+}
+
+.nav {
+  flex: 1;
+  display: flex;
+  justify-content: flex-end;
+}
+
+.list {
+  display: flex;
+  gap: 2.5rem;
+  list-style: none;
+  align-items: center;
+  margin: 0;
+  padding: 0;
+}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./base";
+export * from "./utils";
+export * from "./plugins";
+export * from "./views";
+export * from "./components";
+export * from "./api";

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from "./base";
+export * from "./utils";
+export * from "./plugins";
+export * from "./views";
+export * from "./components";
+export * from "./api";

package/dist/plugins/index.d.ts

@@ -0,0 +1 @@
+export * from "./yoast";

package/dist/plugins/index.js

@@ -0,0 +1 @@
+export * from "./yoast";

package/dist/plugins/yoast/index.d.ts

@@ -0,0 +1,16 @@
+import type { Metadata } from "next";
+import { WPYoastSchema } from "wpjsapi-lib";
+export declare const extractYoastSchema: (entity: unknown) => WPYoastSchema | null;
+type YoastMetaFallback = {
+    title?: string;
+    description?: string;
+    url?: string;
+    type?: string;
+    siteName?: string;
+    image?: string;
+};
+export declare const extractYoastMetadata: (entity: unknown, fallback?: YoastMetaFallback, opts?: {
+    siteUrl?: string;
+    wpApiUrl?: string;
+}) => Metadata | null;
+export {};

package/dist/plugins/yoast/index.js

@@ -0,0 +1,44 @@
+import { rewriteYoastUrls } from "../../utils/seo";
+const hasYoast = (entity) => {
+    if (!entity || typeof entity !== "object")
+        return false;
+    if (!("yoast_head_json" in entity))
+        return false;
+    const yoast = entity.yoast_head_json;
+    return yoast !== undefined && yoast !== null;
+};
+export const extractYoastSchema = (entity) => {
+    const yoastEntity = hasYoast(entity) ? entity : null;
+    return yoastEntity?.yoast_head_json?.schema || null;
+};
+export const extractYoastMetadata = (entity, fallback = {}, opts = {}) => {
+    const yoastEntity = hasYoast(entity) ? entity : null;
+    const yoast = rewriteYoastUrls(yoastEntity?.yoast_head_json, opts);
+    if (!yoast)
+        return null;
+    const imageUrl = yoast.og_image?.[0]?.url || fallback.image;
+    const title = yoast.title || fallback.title;
+    const description = yoast.description || fallback.description;
+    const canonical = fallback.url;
+    return {
+        title,
+        description,
+        alternates: {
+            canonical,
+        },
+        openGraph: {
+            title: yoast.title || fallback.title,
+            description: yoast.og_description || yoast.description || fallback.description,
+            url: fallback.url,
+            type: yoast.og_type || "website",
+            siteName: yoast.og_site_name || fallback.siteName,
+            images: imageUrl ? [{ url: imageUrl }] : [],
+        },
+        twitter: {
+            card: yoast.twitter_card || "summary_large_image",
+            title: yoast.twitter_title || yoast.title || fallback.title,
+            description: yoast.twitter_description || yoast.description || fallback.description,
+            images: imageUrl ? [imageUrl] : undefined,
+        },
+    };
+};

package/dist/utils/hreflang.d.ts

@@ -0,0 +1,37 @@
+export type LanguageConfig = {
+    code: string;
+    basePath: string;
+    langId?: string;
+};
+export declare function getTranslationKey(entity: unknown): string | undefined;
+export declare function getEntityLanguageId(entity: unknown): string | undefined;
+type BuildUrlParams<T> = {
+    entity: T;
+    langCfg: LanguageConfig;
+};
+export declare function buildLanguageAlternatesFromTranslations<T>({ translations, languages, buildUrl, ensurePageExists, }: {
+    translations: T[];
+    languages: LanguageConfig[];
+    buildUrl: (params: BuildUrlParams<T>) => string | null | undefined;
+    ensurePageExists?: (params: BuildUrlParams<T>) => Promise<boolean>;
+}): Promise<Record<string, string> | undefined>;
+export declare function resolveLanguageAlternates<T>({ translationKey, languages, fetchTranslations, buildUrl, ensurePageExists, }: {
+    translationKey?: string;
+    languages: LanguageConfig[];
+    fetchTranslations: (translationKey: string) => Promise<T[]>;
+    buildUrl: (params: BuildUrlParams<T>) => string | null | undefined;
+    ensurePageExists?: (params: BuildUrlParams<T>) => Promise<boolean>;
+}): Promise<Record<string, string> | undefined>;
+export declare function buildLanguageAlternatesPerLanguage<T>({ languages, fetcher, buildUrl, ensurePageExists, }: {
+    languages: LanguageConfig[];
+    fetcher: (langCfg: LanguageConfig) => Promise<T | null>;
+    buildUrl: (params: BuildUrlParams<T>) => string | null | undefined;
+    ensurePageExists?: (params: BuildUrlParams<T>) => Promise<boolean>;
+}): Promise<Record<string, string> | undefined>;
+export declare function buildAbsoluteLangUrl({ basePath, path, siteUrl, }: {
+    basePath: string;
+    path: string;
+    siteUrl?: string;
+}): string;
+export declare function withXDefault(languages?: Record<string, string>): Record<string, string> | undefined;
+export {};

package/dist/utils/hreflang.js

@@ -0,0 +1,95 @@
+import { getAbsoluteUrl } from "./routing";
+const normalizeBasePath = (basePath) => basePath.endsWith("/") ? basePath : `${basePath}/`;
+export function getTranslationKey(entity) {
+    const meta = entity?.meta;
+    const value = meta?.translation_key_v2;
+    return typeof value === "string" && value.trim().length > 0
+        ? value
+        : undefined;
+}
+export function getEntityLanguageId(entity) {
+    const lang = entity?.language?.[0] ??
+        entity?.taxonomies?.language?.[0];
+    return typeof lang === "number" ? lang.toString() : lang;
+}
+export async function buildLanguageAlternatesFromTranslations({ translations, languages, buildUrl, ensurePageExists, }) {
+    if (!translations?.length)
+        return undefined;
+    const alternates = {};
+    for (const langCfg of languages) {
+        if (!langCfg.langId)
+            continue;
+        const match = translations.find((translation) => getEntityLanguageId(translation)?.toString() ===
+            langCfg.langId?.toString());
+        if (!match)
+            continue;
+        if (ensurePageExists) {
+            const exists = await ensurePageExists({ entity: match, langCfg });
+            if (!exists)
+                continue;
+        }
+        const url = buildUrl({ entity: match, langCfg });
+        if (!url)
+            continue;
+        alternates[langCfg.code] = url;
+    }
+    return Object.keys(alternates).length > 1 ? alternates : undefined;
+}
+export async function resolveLanguageAlternates({ translationKey, languages, fetchTranslations, buildUrl, ensurePageExists, }) {
+    if (!translationKey)
+        return undefined;
+    const translations = await fetchTranslations(translationKey);
+    return buildLanguageAlternatesFromTranslations({
+        translations,
+        languages,
+        buildUrl,
+        ensurePageExists,
+    });
+}
+export async function buildLanguageAlternatesPerLanguage({ languages, fetcher, buildUrl, ensurePageExists, }) {
+    const alternates = {};
+    for (const langCfg of languages) {
+        if (!langCfg.langId)
+            continue;
+        try {
+            const entity = await fetcher(langCfg);
+            if (!entity)
+                continue;
+            if (ensurePageExists) {
+                const exists = await ensurePageExists({ entity, langCfg });
+                if (!exists)
+                    continue;
+            }
+            const url = buildUrl({ entity, langCfg });
+            if (!url)
+                continue;
+            alternates[langCfg.code] = url;
+        }
+        catch (error) {
+            console.error("Error building hreflang for lang", langCfg.code, error);
+        }
+    }
+    return Object.keys(alternates).length > 1 ? alternates : undefined;
+}
+export function buildAbsoluteLangUrl({ basePath, path, siteUrl, }) {
+    const normalizedBase = normalizeBasePath(basePath);
+    const normalizedPath = path.startsWith("/")
+        ? path.slice(1)
+        : path.replace(/^\/+/, "");
+    return getAbsoluteUrl(`${normalizedBase}${normalizedPath}`, siteUrl);
+}
+export function withXDefault(languages) {
+    if (!languages)
+        return undefined;
+    const keys = Object.keys(languages);
+    if (keys.length === 0)
+        return undefined;
+    const preferred = languages["en"] ??
+        languages["es"] ??
+        languages["default"] ??
+        languages[keys[0]];
+    const result = preferred
+        ? { ...languages, "x-default": preferred }
+        : { ...languages };
+    return Object.keys(result).length > 1 ? result : undefined;
+}

package/dist/utils/html.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Remove HTML tags from a string.
+ */
+export declare function stripTags(html?: string): string | undefined;

package/dist/utils/html.js

@@ -0,0 +1,8 @@
+/**
+ * Remove HTML tags from a string.
+ */
+export function stripTags(html) {
+    if (!html)
+        return undefined;
+    return html.replace(/<[^>]*>/g, "");
+}

package/dist/utils/i18n.d.ts

@@ -0,0 +1,12 @@
+type MessageTree = {
+    [key: string]: string | MessageTree;
+};
+type Messages = Record<string, MessageTree>;
+/**
+ * Allow projects to override/extend default translations.
+ * Call once during app bootstrap with per-locale overrides.
+ */
+export declare function extendTranslations(overrides: Partial<Messages>): void;
+export type Locale = string;
+export declare function getTranslator(locale?: string): (key: string, vars?: Record<string, string | number>) => string;
+export {};