@pixelated-tech/components 3.13.10 → 3.13.12

package/dist/components/general/schema-blogposting.js

@@ -1,3 +1,4 @@
+'use client';
 import { jsx as _jsx } from "react/jsx-runtime";
 import PropTypes from 'prop-types';
 /**
@@ -15,4 +16,3 @@ export function SchemaBlogPosting(props) {
             __html: JSON.stringify(post),
         } }));
 }
-export default SchemaBlogPosting;

package/dist/components/general/schema-breadcrumb.js

@@ -0,0 +1,78 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import PropTypes from 'prop-types';
+/**
+ * Build breadcrumb trail from root to current path.
+ * e.g., "/store/item-slug" produces ["/", "/store", "/store/item-slug"]
+ */
+function buildPathSegments(currentPath) {
+    const segments = ['/'];
+    if (currentPath === '/')
+        return segments;
+    const parts = currentPath.split('/').filter(Boolean);
+    let accumulated = '';
+    for (const part of parts) {
+        accumulated += '/' + part;
+        segments.push(accumulated);
+    }
+    return segments;
+}
+/**
+ * Determine breadcrumb name for a path segment.
+ * Uses route name if exact match found, otherwise uses humanized path segment.
+ */
+function getSegmentName(routes, path, segment) {
+    if (path === '/')
+        return 'Home';
+    // Only use exact route matches with valid paths to avoid duplicating parent breadcrumb names
+    const route = routes.find((r) => r.path && r.path === path);
+    if (route)
+        return route.name || segment;
+    // Fallback: humanize the path segment
+    return segment
+        .split('-')
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(' ');
+}
+/**
+ * BreadcrumbListSchema — auto-generates a breadcrumb list as JSON-LD from routes.json data.
+ * Parses the current path, builds breadcrumb trail by matching path segments to routes array,
+ * and embeds as schema.org/BreadcrumbList for SEO rich snippets.
+ * Accepts flexible route objects from routes.json with any additional properties.
+ *
+ * @param {array} [props.routes] - Routes array from routes.json with name and optional path properties.
+ * @param {string} [props.currentPath] - Current page path (e.g. "/store/vintage-oakley"). Defaults to "/" if not provided.
+ * @param {string} [props.siteUrl] - Full domain URL from siteInfo.url. Defaults to https://example.com.
+ */
+BreadcrumbListSchema.propTypes = {
+    /** Routes array from routes.json. Accepts routes with any properties; only uses name and path. */
+    routes: PropTypes.arrayOf(PropTypes.object).isRequired,
+    /** Current page path to generate breadcrumbs for (e.g. "/store/item-slug"). Defaults to "/". */
+    currentPath: PropTypes.string,
+    /** Site domain URL for constructing full breadcrumb URLs. Defaults to https://example.com. */
+    siteUrl: PropTypes.string,
+};
+export function BreadcrumbListSchema({ routes, currentPath = '/', siteUrl = 'https://example.com', }) {
+    // Type-safe conversion: routes prop is now flexible (accepts any object)
+    // Filter to ensure only valid Route objects with 'name' property
+    const validRoutes = (Array.isArray(routes)
+        ? routes.filter((r) => !!(r && typeof r === 'object' && 'name' in r))
+        : []);
+    const pathSegments = buildPathSegments(currentPath || '/');
+    const finalSiteUrl = siteUrl || 'https://example.com';
+    const itemListElement = pathSegments.map((path, index) => {
+        const segment = path.split('/').filter(Boolean).pop() || 'Home';
+        return {
+            '@type': 'ListItem',
+            'position': index + 1,
+            'name': getSegmentName(validRoutes, path, segment),
+            'item': `${finalSiteUrl.replace(/\/$/, '')}${path}`,
+        };
+    });
+    const jsonLD = {
+        '@context': 'https://schema.org',
+        '@type': 'BreadcrumbList',
+        'itemListElement': itemListElement,
+    };
+    return (_jsx("script", { type: "application/ld+json", dangerouslySetInnerHTML: { __html: JSON.stringify(jsonLD) } }));
+}

package/dist/components/general/schema-faq.js

@@ -1,4 +1,6 @@
+'use client';
 import { jsx as _jsx } from "react/jsx-runtime";
+import PropTypes from 'prop-types';
 // normalizeFaqs turns a JSON-LD FAQPage payload into a form where each
 // question has a single `acceptedAnswer.text` string.  Some of our data
 // sources (WordPress, CMS exports) allow multiple answer fragments; we
@@ -19,6 +21,15 @@ function normalizeFaqs(data) {
     }
     return faqs;
 }
+/**
+ * SchemaFAQ — Inject a JSON-LD <script> tag containing an FAQPage schema object.
+ *
+ * @param {object} [props.faqsData] - Structured JSON-LD object representing an FAQ page (FAQPage schema).
+ */
+SchemaFAQ.propTypes = {
+    /** Structured FAQPage JSON-LD object */
+    faqsData: PropTypes.object.isRequired,
+};
 export function SchemaFAQ({ faqsData }) {
     const normalized = normalizeFaqs(faqsData);
     return (_jsx("script", { type: "application/ld+json", dangerouslySetInnerHTML: {

package/dist/components/general/schema-localbusiness.js

@@ -1,3 +1,4 @@
+'use client';
 import { jsx as _jsx } from "react/jsx-runtime";
 import PropTypes from "prop-types";
 /**

package/dist/components/general/schema-product.js

@@ -0,0 +1,51 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import PropTypes from 'prop-types';
+/**
+ * ProductSchema — embeds a product/offer as JSON-LD for SEO (schema.org/Product).
+ *
+ * @param {shape} [props.product] - Product object conforming to schema.org/Product; will be serialized as JSON-LD.
+ * @param {string} [props.product.name] - The product name.
+ * @param {string} [props.product.description] - Product description.
+ * @param {shape} [props.product.brand] - Brand information (name and @type).
+ * @param {shape} [props.product.offers] - Offer information including price, currency, URL, and availability.
+ */
+ProductSchema.propTypes = {
+    /** Product information object to be serialized as JSON-LD. */
+    product: PropTypes.shape({
+        '@context': PropTypes.string.isRequired,
+        '@type': PropTypes.string.isRequired,
+        name: PropTypes.string.isRequired,
+        description: PropTypes.string,
+        image: PropTypes.oneOfType([PropTypes.string, PropTypes.arrayOf(PropTypes.string)]),
+        brand: PropTypes.shape({
+            '@type': PropTypes.string.isRequired,
+            name: PropTypes.string.isRequired,
+        }),
+        offers: PropTypes.oneOfType([
+            PropTypes.shape({
+                '@type': PropTypes.string.isRequired,
+                url: PropTypes.string,
+                priceCurrency: PropTypes.string,
+                price: PropTypes.oneOfType([PropTypes.string, PropTypes.number]),
+                availability: PropTypes.string,
+            }),
+            PropTypes.arrayOf(PropTypes.shape({
+                '@type': PropTypes.string.isRequired,
+                url: PropTypes.string,
+                priceCurrency: PropTypes.string,
+                price: PropTypes.oneOfType([PropTypes.string, PropTypes.number]),
+                availability: PropTypes.string,
+            }))
+        ]),
+        aggregateRating: PropTypes.shape({
+            '@type': PropTypes.string,
+            ratingValue: PropTypes.oneOfType([PropTypes.string, PropTypes.number]),
+            reviewCount: PropTypes.oneOfType([PropTypes.string, PropTypes.number]),
+        }),
+    }).isRequired,
+};
+export function ProductSchema(props) {
+    const { product } = props;
+    return (_jsx("script", { type: "application/ld+json", dangerouslySetInnerHTML: { __html: JSON.stringify(product) } }));
+}

package/dist/components/general/schema-recipe.js

@@ -1,3 +1,4 @@
+'use client';
 import { jsx as _jsx } from "react/jsx-runtime";
 import PropTypes from 'prop-types';
 /**
@@ -55,4 +56,3 @@ export function RecipeSchema(props) {
     const { recipe } = props;
     return (_jsx("script", { type: "application/ld+json", dangerouslySetInnerHTML: { __html: JSON.stringify(recipe) } }));
 }
-export default RecipeSchema;

package/dist/components/general/schema-review.js

@@ -0,0 +1,47 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import PropTypes from 'prop-types';
+/**
+ * ReviewSchema — embeds a review as JSON-LD for SEO (schema.org/Review).
+ *
+ * @param {shape} [props.review] - Review object conforming to schema.org/Review; will be serialized as JSON-LD.
+ * @param {string} [props.review.name] - The headline or title of the review.
+ * @param {string} [props.review.reviewBody] - The body of the review content.
+ * @param {string} [props.review.datePublished] - ISO date the review was published.
+ * @param {shape} [props.review.author] - Author information (name and @type).
+ * @param {shape} [props.review.itemReviewed] - The item being reviewed (product, service, etc.).
+ * @param {shape} [props.review.reviewRating] - Rating information including ratingValue, bestRating, worstRating.
+ * @param {shape} [props.review.publisher] - Organization publishing the review.
+ */
+ReviewSchema.propTypes = {
+    /** Review information object to be serialized as JSON-LD. */
+    review: PropTypes.shape({
+        '@context': PropTypes.string.isRequired,
+        '@type': PropTypes.string.isRequired,
+        name: PropTypes.string.isRequired,
+        reviewBody: PropTypes.string,
+        datePublished: PropTypes.string,
+        author: PropTypes.shape({
+            '@type': PropTypes.string.isRequired,
+            name: PropTypes.string.isRequired,
+        }),
+        itemReviewed: PropTypes.shape({
+            '@type': PropTypes.string.isRequired,
+            name: PropTypes.string,
+        }),
+        reviewRating: PropTypes.shape({
+            '@type': PropTypes.string.isRequired,
+            ratingValue: PropTypes.oneOfType([PropTypes.string, PropTypes.number]),
+            bestRating: PropTypes.oneOfType([PropTypes.string, PropTypes.number]),
+            worstRating: PropTypes.oneOfType([PropTypes.string, PropTypes.number]),
+        }),
+        publisher: PropTypes.shape({
+            '@type': PropTypes.string.isRequired,
+            name: PropTypes.string,
+        }),
+    }).isRequired,
+};
+export function ReviewSchema(props) {
+    const { review } = props;
+    return (_jsx("script", { type: "application/ld+json", dangerouslySetInnerHTML: { __html: JSON.stringify(review) } }));
+}

package/dist/components/general/schema-services.js

@@ -1,7 +1,33 @@
+'use client';
 import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
 import PropTypes from 'prop-types';
-const servicesSchemaPropTypes = {
-    siteInfo: PropTypes.object,
+/**
+ * Services Schema Component
+ * Generates JSON-LD structured data for services
+ * https://schema.org/Service
+ */
+/**
+ * ServicesSchema — Inject JSON-LD <script> tags for each service offered by the business, using schema.org/Service format.
+ *
+ * @param {object} [props.siteInfo] - Optional site information object containing business details and services array.
+ * @param {object} [props.provider] - Optional provider information object to override siteInfo for the service provider.
+ * @param {array} [props.services] - Optional array of service objects to override siteInfo.services.
+ */
+ServicesSchema.propTypes = {
+    siteInfo: PropTypes.shape({
+        name: PropTypes.string,
+        url: PropTypes.string,
+        image: PropTypes.string,
+        telephone: PropTypes.string,
+        email: PropTypes.string,
+        services: PropTypes.arrayOf(PropTypes.shape({
+            name: PropTypes.string.isRequired,
+            description: PropTypes.string.isRequired,
+            url: PropTypes.string,
+            image: PropTypes.string,
+            areaServed: PropTypes.oneOfType([PropTypes.string, PropTypes.arrayOf(PropTypes.string)]),
+        }))
+    }),
     provider: PropTypes.shape({
         name: PropTypes.string.isRequired,
         url: PropTypes.string.isRequired,
@@ -30,7 +56,7 @@ export function ServicesSchema(props) {
     if (!services.length || !provider.name) {
         return null;
     }
-    const serviceObjects = services.map((service) => ({
+    const serviceObjects = services.filter((service) => service != null).map((service) => ({
         '@type': 'Service',
         name: service.name,
         description: service.description,
@@ -51,5 +77,3 @@ export function ServicesSchema(props) {
                     ...service
                 }) } }, idx))) }));
 }
-ServicesSchema.propTypes = servicesSchemaPropTypes;
-export default ServicesSchema;

package/dist/components/general/schema-website.js

@@ -1,12 +1,25 @@
+'use client';
 import { jsx as _jsx } from "react/jsx-runtime";
 import PropTypes from "prop-types";
 /**
  * Website Schema Component
  * Generates JSON-LD structured data for websites
  * https://schema.org/WebSite
+ */
+/**
+ * WebsiteSchema — Inject a JSON-LD <script> tag containing a WebSite schema object, using provided props or siteInfo from config.
  *
- * This component uses siteInfo passed as props to generate schema data.
- * It does not use client-side hooks and can be rendered on the server.
+ * @param {object} [props.siteInfo] - Optional site information object containing business details to populate the schema.
+ * @param {string} [props.name] - Name of the website (overrides siteInfo.name).
+ * @param {string} [props.url] - URL of the website (overrides siteInfo.url).
+ * @param {string} [props.description] - Description of the website (overrides siteInfo.description).
+ * @param {string} [props.keywords] - Comma-separated keywords for the website (overrides siteInfo.keywords).
+ * @param {string} [props.inLanguage] - Language of the website content (overrides siteInfo.default_locale).
+ * @param {array} [props.sameAs] - Array of URLs representing social profiles or related sites (overrides siteInfo.sameAs).
+ * @param {object} [props.potentialAction] - Object defining a potentialAction for the website, such as a SearchAction (overrides siteInfo.potentialAction).
+ * @param {object} [props.publisher] - Object defining the publisher of the website, including name, url, and logo (overrides siteInfo).
+ * @param {number} [props.copyrightYear] - Year of copyright for the website (overrides siteInfo.copyrightYear).
+ * @param {object} [props.copyrightHolder] - Object defining the copyright holder, including name and url (overrides siteInfo).
  */
 WebsiteSchema.propTypes = {
     name: PropTypes.string,

package/dist/components/general/well-known.js

@@ -3,7 +3,6 @@ import { readFile } from 'fs/promises';
 import crypto from 'crypto';
 import { NextResponse } from 'next/server';
 import { flattenRoutes } from './sitemap';
-/* ===== Shared helpers for .well-known files ===== */
 /**
  * Read JSON from disk safely — returns null on error. Exported for testing.
  */

package/dist/components/integrations/contentful.delivery.js

@@ -332,3 +332,204 @@ export async function getContentfulDiscountCodes(props) {
         return [];
     }
 }
+/* ========== GET CONTENTFUL REVIEWS AS SCHEMA ========== */
+/**
+ * getContentfulReviewsSchema — Retrieve review entries from Contentful and convert them to schema.org/Review JSON-LD format.
+ *
+ * @param {shape} [props.apiProps] - Contentful API configuration object (base_url, space_id, environment, access tokens).
+ * @param {string} [props.itemName] - Name of the item/product being reviewed (e.g., 'Epoxy Flooring Service').
+ * @param {string} [props.itemType] - Schema type of the item being reviewed (default: 'Product').
+ * @param {string} [props.publisherName] - Name of the organization publishing the reviews.
+ */
+getContentfulReviewsSchema.propTypes = {
+    /** Contentful API configuration */
+    apiProps: PropTypes.shape({
+        proxyURL: PropTypes.string,
+        base_url: PropTypes.string.isRequired,
+        space_id: PropTypes.string.isRequired,
+        environment: PropTypes.string.isRequired,
+        delivery_access_token: PropTypes.string.isRequired,
+    }).isRequired,
+    /** Name of the item/product being reviewed */
+    itemName: PropTypes.string.isRequired,
+    /** Schema type of the item being reviewed */
+    itemType: PropTypes.string,
+    /** Name of the organization publishing the reviews */
+    publisherName: PropTypes.string,
+};
+export async function getContentfulReviewsSchema(props) {
+    const contentType = "reviews";
+    const itemName = props.itemName;
+    const itemType = props.itemType || "Product";
+    const publisherName = props.publisherName;
+    try {
+        if (debug)
+            console.log("Fetching Reviews and converting to schema");
+        const response = await getContentfulEntriesByType({
+            apiProps: props.apiProps,
+            contentType: contentType
+        });
+        if (!response || !response.items) {
+            console.error("No reviews found in Contentful");
+            return [];
+        }
+        const reviewSchemas = response.items.map((item) => {
+            // Extract reviewer name from "fields.reviewer" which comes as " - Name"
+            const reviewerNameRaw = item.fields.reviewer || "Anonymous";
+            const reviewerName = reviewerNameRaw.replace(/^\s*-\s*/, "").trim();
+            // Convert Contentful date to ISO format (remove quotes if present)
+            const publishDate = new Date(item.sys.createdAt).toISOString().split("T")[0];
+            // Create Review schema object
+            const reviewSchema = {
+                "@context": "https://schema.org/",
+                "@type": "Review",
+                "name": "", // Will be extracted or generated from review body
+                "reviewBody": item.fields.description?.replace(/^"|"$/g, "").trim() || "",
+                "datePublished": publishDate,
+                "author": {
+                    "@type": "Person",
+                    "name": reviewerName
+                },
+                "itemReviewed": {
+                    "@type": itemType,
+                    "name": itemName
+                },
+                "reviewRating": {
+                    "@type": "Rating",
+                    "ratingValue": "5",
+                    "bestRating": "5",
+                    "worstRating": "1"
+                }
+            };
+            // Generate name from first sentence of review or use generic title
+            if (reviewSchema.reviewBody) {
+                const sentences = reviewSchema.reviewBody.split(/[.!?]/);
+                reviewSchema.name = sentences[0].trim().substring(0, 100) || "Review";
+            }
+            // Add publisher if provided
+            if (publisherName) {
+                reviewSchema.publisher = {
+                    "@type": "Organization",
+                    "name": publisherName
+                };
+            }
+            return reviewSchema;
+        });
+        if (debug)
+            console.log("Review Schemas: ", reviewSchemas);
+        return reviewSchemas;
+    }
+    catch (error) {
+        console.error('Error fetching reviews:', error);
+        return [];
+    }
+}
+/* ========== GET CONTENTFUL PRODUCT AS SCHEMA ========== */
+/**
+ * getContentfulProductSchema — Retrieve a product entry from Contentful and convert it to schema.org/Product JSON-LD format.
+ *
+ * @param {shape} [props.apiProps] - Contentful API configuration object (base_url, space_id, environment, access tokens).
+ * @param {string} [props.productId] - The product ID field value to search for (e.g., 'PIX-000779').
+ * @param {string} [props.siteUrl] - Optional base site URL for the offer URL.
+ * @param {function} [props.getAssetUrl] - Optional function to transform asset URLs.
+ */
+getContentfulProductSchema.propTypes = {
+    /** Contentful API configuration */
+    apiProps: PropTypes.shape({
+        proxyURL: PropTypes.string,
+        base_url: PropTypes.string.isRequired,
+        space_id: PropTypes.string.isRequired,
+        environment: PropTypes.string.isRequired,
+        delivery_access_token: PropTypes.string.isRequired,
+    }).isRequired,
+    /** Product ID to search for */
+    productId: PropTypes.string.isRequired,
+    /** Optional site URL for offer */
+    siteUrl: PropTypes.string,
+    /** Optional function to transform asset URLs */
+    getAssetUrl: PropTypes.func,
+};
+export async function getContentfulProductSchema(props) {
+    const contentType = "item";
+    const productId = props.productId;
+    const siteUrl = props.siteUrl || '';
+    const getAssetUrl = props.getAssetUrl;
+    try {
+        if (debug)
+            console.log("Fetching Product and converting to schema");
+        const response = await getContentfulEntriesByType({
+            apiProps: props.apiProps,
+            contentType: contentType
+        });
+        if (!response || !response.items) {
+            console.error("No products found in Contentful");
+            return null;
+        }
+        // Use existing helper function to find product by ID field
+        const product = await getContentfulEntryByField({
+            cards: response,
+            searchField: 'id',
+            searchVal: productId
+        });
+        if (!product) {
+            console.error(`Product with ID ${productId} not found`);
+            return null;
+        }
+        const fields = product.fields;
+        // Create Product schema object
+        const productSchema = {
+            '@context': 'https://schema.org/',
+            '@type': 'Product',
+            name: fields.title || '',
+            description: fields.description || '',
+            image: [],
+            brand: {
+                '@type': 'Brand',
+                name: fields.brand || 'Pixelated'
+            },
+            offers: {
+                '@type': 'Offer',
+                url: siteUrl || '',
+                priceCurrency: 'USD',
+                price: String(fields.price || '0'),
+                availability: 'https://schema.org/InStock'
+            }
+        };
+        // Handle images
+        if (Array.isArray(fields.images) && fields.images.length > 0) {
+            // Note: Contentful images are links to assets
+            // In a real implementation, you'd need to resolve these asset URLs
+            // For now, we store them as asset IDs that can be looked up later
+            productSchema.image = fields.images.map((img) => {
+                if (img.sys?.id) {
+                    return getAssetUrl ? getAssetUrl(img.sys.id) : `https://assets.ctfassets.net/${img.sys.id}`;
+                }
+                return '';
+            }).filter((url) => url);
+        }
+        // Add additional product attributes if available
+        if (fields.brand) {
+            productSchema.brand.name = fields.brand;
+        }
+        if (fields.model) {
+            productSchema.model = fields.model;
+        }
+        if (fields.color) {
+            productSchema.color = fields.color;
+        }
+        // Add rating based on availability/quantity
+        if (fields.quantity !== undefined) {
+            const availability = fields.quantity > 0
+                ? 'https://schema.org/InStock'
+                : 'https://schema.org/OutOfStock';
+            productSchema.offers.availability = availability;
+        }
+        if (debug)
+            console.log("Contentful Product Schema: ", productSchema);
+        return productSchema;
+    }
+    catch (error) {
+        console.error('Error fetching product:', error);
+        return null;
+    }
+}

package/dist/components/integrations/wordpress.components.js

@@ -1,5 +1,5 @@
 'use client';
-import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { useEffect, useState } from 'react';
 import PropTypes from 'prop-types';
 import { usePixelatedConfig } from "../config/config.client";
@@ -9,6 +9,8 @@ import { getWordPressItems, getWordPressLastModified } from './wordpress.functio
 import { Loading, ToggleLoading } from '../general/loading';
 import { CacheManager } from "../general/cache-manager";
 import "./wordpress.css";
+import { SchemaBlogPosting } from '../general/schema-blogposting';
+import { mapWordPressToBlogPosting } from '../general/schema-blogposting.functions';
 // https://microformats.org/wiki/h-entry
 function decodeString(str) {
     const textarea = document.createElement('textarea');
@@ -103,7 +105,7 @@ export function BlogPostList(props) {
             ToggleLoading({ show: false });
         })();
     }, [site, baseURL, count, cachedPosts]);
-    return (_jsxs(_Fragment, { children: [_jsx(Loading, {}), posts.map((post) => (_jsx(PageGridItem, { children: _jsx(BlogPostSummary, { ID: post.ID, title: post.title, date: post.date, excerpt: post.excerpt, URL: post.URL, categories: post.categories, featured_image: post.featured_image, showCategories: showCategories }) }, post.ID)))] }));
+    return (_jsxs(_Fragment, { children: [_jsx(Loading, {}), posts.map((post) => (_jsxs(PageGridItem, { children: [_jsx(SchemaBlogPosting, { post: mapWordPressToBlogPosting(post, false) }, post.ID), _jsx(BlogPostSummary, { ID: post.ID, title: post.title, date: post.date, excerpt: post.excerpt, URL: post.URL, categories: post.categories, featured_image: post.featured_image, showCategories: showCategories })] }, post.ID)))] }));
 }
 /**
  * BlogPostSummary — Render a compact summary card for a single WordPress post.

package/dist/components/integrations/wordpress.css

@@ -46,6 +46,8 @@
 
 	.article-featured-image img {
 		/* border-radius: 20px; */
+		min-width: 100%;
+		min-height: 100%;
 		width: 100%;
 		height: 100%;
 		max-height: 150px;

package/dist/components/shoppingcart/ebay.functions.js

@@ -392,3 +392,72 @@ export function getEbayItemsSearch(props) {
     };
     return fetchData(props.token);
 }
+/* ========== PRODUCT SCHEMA ========== */
+/**
+ * getEbayProductSchema — Convert an eBay item into schema.org/Product JSON-LD format.
+ *
+ * @param {object} [props.item] - eBay item object from the Browse API.
+ * @param {string} [props.brandName] - Optional brand name to include in the schema.
+ * @param {string} [props.siteUrl] - Optional site URL for the offer URL.
+ */
+getEbayProductSchema.propTypes = {
+    /** eBay item object */
+    item: PropTypes.any.isRequired,
+    /** Optional brand name */
+    brandName: PropTypes.string,
+    /** Optional site URL for offer */
+    siteUrl: PropTypes.string,
+};
+export function getEbayProductSchema(props) {
+    const item = props.item;
+    const brandName = props.brandName || 'eBay';
+    const siteUrl = props.siteUrl || item.itemWebUrl || '';
+    if (!item || !item.title || !item.price) {
+        return null;
+    }
+    // Get the primary image
+    const primaryImage = item.image?.imageUrl || item.thumbnailImages?.[0]?.imageUrl || '';
+    // Collect all images
+    const allImages = [];
+    if (primaryImage)
+        allImages.push(primaryImage);
+    if (Array.isArray(item.additionalImages)) {
+        item.additionalImages.forEach((img) => {
+            if (img.imageUrl)
+                allImages.push(img.imageUrl);
+        });
+    }
+    const productSchema = {
+        '@context': 'https://schema.org/',
+        '@type': 'Product',
+        name: item.title,
+        description: item.title,
+        image: allImages.length > 1 ? allImages : (allImages[0] || ''),
+        brand: {
+            '@type': 'Brand',
+            name: brandName
+        },
+        offers: {
+            '@type': 'Offer',
+            url: siteUrl,
+            priceCurrency: item.price?.currency || 'USD',
+            price: String(item.price?.value || '0'),
+            availability: 'https://schema.org/InStock',
+            seller: {
+                '@type': 'Organization',
+                name: item.seller?.username || 'eBay Seller'
+            }
+        }
+    };
+    // Add seller rating if available
+    if (item.seller?.feedbackPercentage || item.seller?.feedbackScore) {
+        productSchema.aggregateRating = {
+            '@type': 'AggregateRating',
+            ratingValue: item.seller.feedbackPercentage ? String(item.seller.feedbackPercentage) : '0',
+            reviewCount: item.seller.feedbackScore ? String(item.seller.feedbackScore) : '0'
+        };
+    }
+    if (debug)
+        console.log("eBay Product Schema:", productSchema);
+    return productSchema;
+}