@marvalt/wadapter 2.3.19 → 2.3.20

package/dist/index.js

@@ -259,8 +259,8 @@ class WordPressClient {
         return this.makeRequest(`/wp-custom/v1/pages/${pageId}/blocks`);
     }
     /**
-     * Fetch WordPress Reading Settings from custom endpoint
-     * @returns Settings including front page information
+     * Fetch WordPress Settings from custom endpoint
+     * @returns Settings including front page information and site branding
      */
     async getSettings() {
         return this.makeRequest('/wp-custom/v1/settings');
@@ -696,6 +696,287 @@ function useGravityFormsConfig(formId, config) {
     };
 }
 
+/**
+ * @license GPL-3.0-or-later
+ *
+ * This file is part of the MarVAlt Open SDK.
+ * Copyright (c) 2025 Vibune Pty Ltd.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ * See the GNU General Public License for more details.
+ */
+let wordpressStaticData = null;
+async function loadWordPressData(path = '/wordpress-data.json') {
+    try {
+        const res = await fetch(path);
+        if (!res.ok)
+            return null;
+        wordpressStaticData = (await res.json());
+        return wordpressStaticData;
+    }
+    catch {
+        return null;
+    }
+}
+function hasWordPressStatic() {
+    return !!wordpressStaticData && Array.isArray(wordpressStaticData.posts);
+}
+function getWordPressPosts() {
+    return wordpressStaticData?.posts ?? [];
+}
+function getWordPressPages() {
+    return wordpressStaticData?.pages ?? [];
+}
+function getWordPressMedia() {
+    return wordpressStaticData?.media ?? [];
+}
+function getWordPressCategories() {
+    return wordpressStaticData?.categories ?? [];
+}
+function getWordPressTags() {
+    return wordpressStaticData?.tags ?? [];
+}
+/**
+ * Get frontpage metadata from static data
+ * This is set by the generator based on WordPress Reading Settings or slug 'frontpage'
+ */
+function getFrontpageMetadata() {
+    return wordpressStaticData?.front_page;
+}
+/**
+ * Get site settings (logo, site icon, site name, description) from static data
+ * This is set by the generator from WordPress theme mods and options
+ */
+function getSiteSettings() {
+    return wordpressStaticData?.site_settings;
+}
+
+/**
+ * @license GPL-3.0-or-later
+ *
+ * This file is part of the MarVAlt Open SDK.
+ * Copyright (c) 2025 Vibune Pty Ltd.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ * See the GNU General Public License for more details.
+ */
+/**
+ * Get root pages (pages with parent = 0)
+ * Sorted by menu_order
+ */
+function getRootPages(pages) {
+    return pages
+        .filter(page => page.parent === 0)
+        .sort((a, b) => a.menu_order - b.menu_order);
+}
+/**
+ * Get child pages of a specific parent
+ * Sorted by menu_order
+ */
+function getChildPages(pages, parentId) {
+    return pages
+        .filter(page => page.parent === parentId)
+        .sort((a, b) => a.menu_order - b.menu_order);
+}
+function buildPageHierarchy(pages) {
+    const pageMap = new Map();
+    const rootPages = [];
+    // Create map of all pages with children array
+    pages.forEach(page => {
+        pageMap.set(page.id, { ...page, children: [] });
+    });
+    // Build hierarchy
+    pages.forEach(page => {
+        const hierarchicalPage = pageMap.get(page.id);
+        if (page.parent === 0) {
+            rootPages.push(hierarchicalPage);
+        }
+        else {
+            const parent = pageMap.get(page.parent);
+            if (parent) {
+                if (!parent.children) {
+                    parent.children = [];
+                }
+                parent.children.push(hierarchicalPage);
+            }
+        }
+    });
+    // Sort root pages and recursively sort children
+    const sortByMenuOrder = (pages) => {
+        return pages
+            .sort((a, b) => a.menu_order - b.menu_order)
+            .map(page => ({
+            ...page,
+            children: page.children ? sortByMenuOrder(page.children) : undefined,
+        }));
+    };
+    return sortByMenuOrder(rootPages);
+}
+/**
+ * Build menu structure from WordPress pages
+ * Converts WordPress pages to a generic menu structure
+ *
+ * @param pages - Array of WordPress pages
+ * @param baseUrl - Base URL for building page URLs (default: '/')
+ * @param filterPublished - Only include published pages (default: true)
+ * @returns Array of menu items with nested children
+ */
+function buildMenuStructure(pages, baseUrl = '/', filterPublished = true) {
+    // Filter published pages if requested
+    const filteredPages = filterPublished
+        ? pages.filter(page => page.status === 'publish')
+        : pages;
+    // Build hierarchy
+    const hierarchicalPages = buildPageHierarchy(filteredPages);
+    // Convert to menu items
+    const convertToMenuItem = (page) => {
+        const url = baseUrl === '/'
+            ? `/${page.slug}`
+            : `${baseUrl.replace(/\/$/, '')}/${page.slug}`;
+        const menuItem = {
+            id: page.id,
+            title: page.title?.rendered || page.slug,
+            slug: page.slug,
+            url,
+            menuOrder: page.menu_order,
+        };
+        // Add children if they exist
+        if (page.children && page.children.length > 0) {
+            menuItem.children = page.children.map(convertToMenuItem);
+        }
+        return menuItem;
+    };
+    return hierarchicalPages.map(convertToMenuItem);
+}
+/**
+ * Find a page by slug
+ */
+function findPageBySlug(pages, slug) {
+    return pages.find(page => page.slug === slug);
+}
+/**
+ * Find a page by ID
+ */
+function findPageById(pages, id) {
+    return pages.find(page => page.id === id);
+}
+/**
+ * Get frontpage (page with slug 'frontpage' or 'home')
+ * Useful for determining homepage content
+ */
+function getFrontpage(pages) {
+    return pages.find(page => page.slug === 'frontpage' ||
+        page.slug === 'home' ||
+        page.slug === '');
+}
+/**
+ * Get frontpage slug using standardized approach
+ *
+ * Priority:
+ * 1. front_page metadata from generator (WordPress Reading Settings or slug 'frontpage')
+ * 2. Fallback to getFrontpage() utility (slug check: 'frontpage', 'home', '')
+ *
+ * @param pages - Array of WordPress pages (optional, used for fallback)
+ * @param frontPageMetadata - Frontpage metadata from static data (optional)
+ * @returns Frontpage slug string, or undefined if not found
+ */
+function getFrontpageSlug(pages, frontPageMetadata) {
+    // First priority: Use metadata from generator (WordPress Reading Settings or slug 'frontpage')
+    if (frontPageMetadata?.slug) {
+        return frontPageMetadata.slug;
+    }
+    // Fallback: Check pages for slug 'frontpage', 'home', or ''
+    if (pages) {
+        const frontpage = getFrontpage(pages);
+        return frontpage?.slug;
+    }
+    return undefined;
+}
+
+/**
+ * @license GPL-3.0-or-later
+ *
+ * This file is part of the MarVAlt Open SDK.
+ * Copyright (c) 2025 Vibune Pty Ltd.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ * See the GNU General Public License for more details.
+ */
+// React Hook for Frontpage Slug
+// Standardized approach for determining frontpage slug from WordPress static data
+/**
+ * Hook to get the frontpage slug using standardized approach
+ *
+ * Priority:
+ * 1. front_page metadata from generator (WordPress Reading Settings or slug 'frontpage')
+ * 2. Fallback to getFrontpage() utility (slug check: 'frontpage', 'home', '')
+ *
+ * @param overrideSlug - Optional override slug (if provided, this takes precedence)
+ * @param dataPath - Path to WordPress static data JSON file (default: '/wordpress-data.json')
+ * @returns Object with slug, loading state, and error
+ */
+function useFrontpageSlug(overrideSlug, dataPath = '/wordpress-data.json') {
+    const [slug, setSlug] = require$$0.useState(overrideSlug);
+    const [loading, setLoading] = require$$0.useState(true);
+    const [error, setError] = require$$0.useState(null);
+    require$$0.useEffect(() => {
+        // If override slug is provided, use it immediately
+        if (overrideSlug) {
+            setSlug(overrideSlug);
+            setLoading(false);
+            return;
+        }
+        const fetchFrontpageSlug = async () => {
+            try {
+                setLoading(true);
+                setError(null);
+                // Load WordPress static data
+                await loadWordPressData(dataPath);
+                // Get frontpage metadata and pages
+                const frontPageMetadata = getFrontpageMetadata();
+                const pages = getWordPressPages();
+                // Use standardized utility to get frontpage slug
+                const frontpageSlug = getFrontpageSlug(pages, frontPageMetadata);
+                setSlug(frontpageSlug);
+            }
+            catch (err) {
+                setError(err instanceof Error ? err : new Error('Failed to load frontpage slug'));
+                setSlug(undefined);
+            }
+            finally {
+                setLoading(false);
+            }
+        };
+        fetchFrontpageSlug();
+    }, [overrideSlug, dataPath]);
+    return {
+        slug,
+        loading,
+        error,
+    };
+}
+
 var jsxRuntime = {exports: {}};
 
 var reactJsxRuntime_production_min = {};
@@ -2229,54 +2510,6 @@ function useGravityFormsContext() {
     return context;
 }
 
-/**
- * @license GPL-3.0-or-later
- *
- * This file is part of the MarVAlt Open SDK.
- * Copyright (c) 2025 Vibune Pty Ltd.
- *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
- * See the GNU General Public License for more details.
- */
-let wordpressStaticData = null;
-async function loadWordPressData(path = '/wordpress-data.json') {
-    try {
-        const res = await fetch(path);
-        if (!res.ok)
-            return null;
-        wordpressStaticData = (await res.json());
-        return wordpressStaticData;
-    }
-    catch {
-        return null;
-    }
-}
-function hasWordPressStatic() {
-    return !!wordpressStaticData && Array.isArray(wordpressStaticData.posts);
-}
-function getWordPressPosts() {
-    return wordpressStaticData?.posts ?? [];
-}
-function getWordPressPages() {
-    return wordpressStaticData?.pages ?? [];
-}
-function getWordPressMedia() {
-    return wordpressStaticData?.media ?? [];
-}
-function getWordPressCategories() {
-    return wordpressStaticData?.categories ?? [];
-}
-function getWordPressTags() {
-    return wordpressStaticData?.tags ?? [];
-}
-
 /**
  * @license GPL-3.0-or-later
  *
@@ -2504,12 +2737,22 @@ exports.GravityFormsProvider = GravityFormsProvider;
 exports.WordPressClient = WordPressClient;
 exports.WordPressContent = WordPressContent;
 exports.WordPressProvider = WordPressProvider;
+exports.buildMenuStructure = buildMenuStructure;
+exports.buildPageHierarchy = buildPageHierarchy;
 exports.createFormProtectionConfig = createFormProtectionConfig;
 exports.createGravityFormsConfig = createGravityFormsConfig;
 exports.createWordPressConfig = createWordPressConfig;
+exports.findPageById = findPageById;
+exports.findPageBySlug = findPageBySlug;
 exports.getActiveForms = getActiveForms;
+exports.getChildPages = getChildPages;
 exports.getFormById = getFormById;
+exports.getFrontpage = getFrontpage;
+exports.getFrontpageMetadata = getFrontpageMetadata;
+exports.getFrontpageSlug = getFrontpageSlug;
 exports.getPublishedForms = getPublishedForms;
+exports.getRootPages = getRootPages;
+exports.getSiteSettings = getSiteSettings;
 exports.getWordPressCategories = getWordPressCategories;
 exports.getWordPressMedia = getWordPressMedia;
 exports.getWordPressPages = getWordPressPages;
@@ -2526,6 +2769,7 @@ exports.transformWordPressPage = transformWordPressPage;
 exports.transformWordPressPages = transformWordPressPages;
 exports.transformWordPressPost = transformWordPressPost;
 exports.transformWordPressPosts = transformWordPressPosts;
+exports.useFrontpageSlug = useFrontpageSlug;
 exports.useGravityForms = useGravityForms;
 exports.useGravityFormsConfig = useGravityFormsConfig;
 exports.useGravityFormsContext = useGravityFormsContext;