@puzzle-ui/seo 0.0.0-stage → 0.5.0

package/dist/validation/validate.js

@@ -0,0 +1,450 @@
+import { createSeoNode, validateSeoGraph } from "../core/graph.js";
+import { createDefaultSchemaRegistry } from "../schema/create-registry.js";
+import { validateSchemaNode } from "../schema/validate.js";
+// src/validation/validate.ts
+const defaultRegistry = createDefaultSchemaRegistry();
+const SCHEMA_DOCS = "https://schema.org/";
+const GOOGLE_DOCS = "https://developers.google.com/search/docs/appearance/structured-data";
+const isObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const getTypes = (node) => {
+	const value = node["@type"];
+	return (Array.isArray(value) ? value : [value]).filter((type) => typeof type === "string" && type.trim().length > 0);
+};
+const hasValue = (value) => {
+	if (value === void 0 || value === null) return false;
+	if (typeof value === "string") return value.trim().length > 0;
+	if (Array.isArray(value)) return value.length > 0;
+	return true;
+};
+const getNodes = (graph) => graph?.["@graph"] ?? [];
+const createIssue = (source, code, message, severity = "warning", details = {}) => ({
+	source,
+	code,
+	message,
+	severity,
+	...details
+});
+const normalizeMode = (mode) => mode;
+const normalizeSeverity = (severity, mode) => {
+	if (mode === "strict" && severity === "warning") return "error";
+	return severity;
+};
+const createSummary = (issues) => {
+	const summary = {
+		errors: 0,
+		warnings: 0,
+		infos: 0,
+		total: issues.length
+	};
+	for (const issue of issues) switch (issue.severity) {
+		case "error":
+			summary.errors += 1;
+			break;
+		case "warning":
+			summary.warnings += 1;
+			break;
+		case "info": summary.infos += 1;
+	}
+	return summary;
+};
+const createReport = (mode, issues) => {
+	const normalizedIssues = issues.map((issue) => ({
+		...issue,
+		severity: normalizeSeverity(issue.severity, mode)
+	}));
+	const summary = createSummary(normalizedIssues);
+	return {
+		valid: summary.errors === 0,
+		mode,
+		issues: normalizedIssues,
+		summary
+	};
+};
+const validateGraph = (graph, options, registry) => {
+	const issues = [];
+	if (!Array.isArray(graph["@graph"])) return [createIssue("graph", "invalid-graph", "SEO graph must contain an @graph array.", "error")];
+	const result = validateSeoGraph(graph, {
+		baseUrl: options.baseUrl,
+		strictReferences: options.mode === "strict",
+		allowedExternalReferences: options.allowExternalReferences ?? true
+	});
+	for (const issue of result.issues) issues.push(createIssue("graph", issue.code, issue.message, issue.severity, {
+		path: issue.path,
+		nodeId: issue.nodeId,
+		property: issue.property,
+		suggestion: issue.code === "unresolved-reference" ? "Register the referenced node or verify its @id." : void 0
+	}));
+	for (let index = 0; index < graph["@graph"].length; index += 1) {
+		const node = graph["@graph"][index];
+		if (!isObject(node)) continue;
+		const nodeId = typeof node["@id"] === "string" ? node["@id"] : void 0;
+		const result = validateSchemaNode(node, registry, {
+			strict: options.mode === "strict",
+			allowUnknownProperties: options.allowUnknownProperties ?? options.mode !== "strict",
+			validateRequiredProperties: options.validateRequiredProperties ?? false
+		});
+		for (const issue of result.issues) issues.push(createIssue("schema", issue.code, issue.message, issue.severity, {
+			path: issue.path ? `@graph[${index}]${issue.path.replace("$", "")}` : `@graph[${index}]`,
+			nodeId,
+			property: issue.property,
+			suggestion: issue.code === "unknown-property" ? "Check the Schema.org property name or extend the registry." : issue.code === "unknown-type" ? "Use a registered Schema.org type or add a custom definition." : void 0,
+			docsUrl: SCHEMA_DOCS
+		}));
+	}
+	return issues;
+};
+const validateDate = (value) => {
+	if (typeof value !== "string") return false;
+	return value.trim().length > 0 && !Number.isNaN(Date.parse(value));
+};
+const validateSemanticNode = (node, index) => {
+	const issues = [];
+	const types = getTypes(node);
+	const nodeId = typeof node["@id"] === "string" ? node["@id"] : void 0;
+	const path = `@graph[${index}]`;
+	const add = (code, message, property, suggestion) => {
+		issues.push(createIssue("semantic", code, message, "warning", {
+			path: `${path}.${property}`,
+			nodeId,
+			property,
+			suggestion,
+			docsUrl: SCHEMA_DOCS
+		}));
+	};
+	if (types.some((type) => [
+		"Article",
+		"NewsArticle",
+		"BlogPosting",
+		"TechArticle"
+	].includes(type.split("/").pop() ?? type))) {
+		if (!hasValue(node.headline)) add("article-missing-headline", "Article nodes should provide a headline.", "headline", "Add a descriptive headline.");
+		if (hasValue(node.datePublished) && !validateDate(node.datePublished)) add("invalid-publication-date", "Article datePublished is not a valid date.", "datePublished", "Use a valid ISO 8601 date or datetime.");
+		if (hasValue(node.dateModified) && !validateDate(node.dateModified)) add("invalid-modification-date", "Article dateModified is not a valid date.", "dateModified", "Use a valid ISO 8601 date or datetime.");
+		if (hasValue(node.datePublished) && hasValue(node.dateModified) && validateDate(node.datePublished) && validateDate(node.dateModified) && Date.parse(String(node.dateModified)) < Date.parse(String(node.datePublished))) add("modification-before-publication", "Article dateModified is earlier than datePublished.", "dateModified", "Verify the publication and modification dates.");
+	}
+	if (types.includes("Product") || types.includes("https://schema.org/Product")) {
+		if (!hasValue(node.name)) add("product-missing-name", "Product nodes should provide a name.", "name", "Add the product's visible name.");
+		if (hasValue(node.offers) && !Array.isArray(node.offers) && !isObject(node.offers)) add("invalid-product-offers", "Product offers must be an Offer node or an array of Offer nodes.", "offers", "Provide an Offer object or an array of Offer objects.");
+	}
+	if (types.includes("Offer") || types.includes("https://schema.org/Offer")) {
+		if (hasValue(node.price)) {
+			const price = Number(node.price);
+			if (!Number.isFinite(price) || price < 0) add("invalid-offer-price", "Offer price must be a non-negative finite number.", "price", "Provide a valid numeric price.");
+		}
+		if (hasValue(node.price) && !hasValue(node.priceCurrency)) add("offer-missing-currency", "Offers with a price should specify priceCurrency.", "priceCurrency", "Provide an ISO 4217 currency code, such as EUR or USD.");
+		if (hasValue(node.priceCurrency) && !/^[A-Z]{3}$/.test(String(node.priceCurrency))) add("invalid-price-currency", "Offer priceCurrency should use an ISO 4217 currency code.", "priceCurrency", "Use a three-letter uppercase currency code.");
+	}
+	if (types.includes("BreadcrumbList") || types.includes("https://schema.org/BreadcrumbList")) {
+		const elements = node.itemListElement;
+		if (!Array.isArray(elements) || elements.length === 0) add("breadcrumb-missing-items", "BreadcrumbList should contain itemListElement entries.", "itemListElement", "Add at least one ListItem.");
+		else {
+			const positions = /* @__PURE__ */ new Set();
+			elements.forEach((item, itemIndex) => {
+				if (!isObject(item)) {
+					add("invalid-breadcrumb-item", "Breadcrumb entries should be ListItem objects.", `itemListElement[${itemIndex}]`, "Provide a ListItem with position, name and item.");
+					return;
+				}
+				const position = Number(item.position);
+				if (!Number.isInteger(position) || position < 1 || positions.has(position)) add("invalid-breadcrumb-position", "Breadcrumb positions must be unique positive integers.", `itemListElement[${itemIndex}].position`, "Use sequential positions starting at 1.");
+				else positions.add(position);
+				if (!hasValue(item.name)) add("breadcrumb-missing-name", "Breadcrumb ListItem should provide a name.", `itemListElement[${itemIndex}].name`, "Provide the visible breadcrumb label.");
+				if (!hasValue(item.item) && itemIndex !== elements.length - 1) add("breadcrumb-missing-item", "Breadcrumb ListItem should provide an item URL.", `itemListElement[${itemIndex}].item`, "Provide the destination URL.");
+			});
+		}
+	}
+	return issues;
+};
+const richResultRules = {
+	article: {
+		type: "Article",
+		required: [],
+		recommended: [
+			"headline",
+			"image",
+			"datePublished",
+			"dateModified",
+			"author"
+		],
+		docsUrl: `${GOOGLE_DOCS}/article`
+	},
+	product: {
+		type: "Product",
+		required: ["name"],
+		requireAny: [
+			"offers",
+			"aggregateRating",
+			"review"
+		],
+		recommended: ["image", "description"],
+		docsUrl: `${GOOGLE_DOCS}/product`
+	},
+	breadcrumb: {
+		type: "BreadcrumbList",
+		required: ["itemListElement"],
+		docsUrl: `${GOOGLE_DOCS}/breadcrumb`
+	},
+	event: {
+		type: "Event",
+		required: [
+			"name",
+			"startDate",
+			"location"
+		],
+		docsUrl: `${GOOGLE_DOCS}/event`
+	},
+	recipe: {
+		type: "Recipe",
+		required: ["name", "image"],
+		recommended: [
+			"author",
+			"description",
+			"prepTime",
+			"cookTime",
+			"recipeYield",
+			"nutrition"
+		],
+		docsUrl: `${GOOGLE_DOCS}/recipe`
+	},
+	"job-posting": {
+		type: "JobPosting",
+		required: [
+			"title",
+			"description",
+			"datePosted",
+			"hiringOrganization",
+			"jobLocation"
+		],
+		recommended: [
+			"validThrough",
+			"employmentType",
+			"baseSalary"
+		],
+		docsUrl: `${GOOGLE_DOCS}/job-posting`
+	},
+	"local-business": {
+		type: "LocalBusiness",
+		required: ["name", "address"],
+		recommended: [
+			"telephone",
+			"url",
+			"image",
+			"openingHoursSpecification"
+		],
+		docsUrl: `${GOOGLE_DOCS}/local-business`
+	},
+	"software-application": {
+		type: "SoftwareApplication",
+		required: ["name", "offers"],
+		requireAny: ["aggregateRating", "review"],
+		recommended: ["applicationCategory", "operatingSystem"],
+		docsUrl: `${GOOGLE_DOCS}/software-app`
+	}
+};
+const profileMatches = (node, profile, registry) => {
+	const expected = richResultRules[profile].type;
+	return getTypes(node).some((type) => registry.isTypeOf(type, expected));
+};
+const getNestedObjects = (value) => {
+	return (Array.isArray(value) ? value : [value]).filter(isObject);
+};
+const hasNestedValue = (value, property) => getNestedObjects(value).some((item) => hasValue(item[property]));
+const validateRichResults = (nodes, profiles, registry) => {
+	const issues = [];
+	for (const profile of profiles) {
+		const rule = richResultRules[profile];
+		nodes.forEach((node, nodeIndex) => {
+			if (!profileMatches(node, profile, registry)) return;
+			const nodeId = typeof node["@id"] === "string" ? node["@id"] : void 0;
+			const path = `@graph[${nodeIndex}]`;
+			const add = (code, message, property, severity = "warning", suggestion) => {
+				issues.push(createIssue("rich-results", code, message, severity, {
+					nodeId,
+					property,
+					path: property ? `${path}.${property}` : path,
+					suggestion,
+					docsUrl: rule.docsUrl
+				}));
+			};
+			for (const property of rule.required) {
+				if (hasValue(node[property])) continue;
+				add(`rich-results-missing-${property}`, `${rule.type} is missing the required Rich Results property "${property}".`, property, "warning", `Add the ${property} property to meet the ${profile} structured data requirements.`);
+			}
+			for (const property of rule.recommended ?? []) {
+				if (hasValue(node[property])) continue;
+				add(`rich-results-recommended-${property}`, `${rule.type} should provide the recommended property "${property}".`, property, "info", `Consider adding ${property} to provide more complete structured data.`);
+			}
+			if (rule.requireAny && !rule.requireAny.some((property) => hasValue(node[property]))) add("rich-results-missing-alternative", `${rule.type} must provide at least one of: ${rule.requireAny.join(", ")}.`, void 0, "warning", `Provide at least one of: ${rule.requireAny.join(", ")}.`);
+			if (profile === "product" && hasValue(node.offers)) {
+				if (!hasNestedValue(node.offers, "price")) add("rich-results-product-offer-missing-price", "Product offers should include a price.", "offers", "warning", "Add a price to each Offer object.");
+			}
+			if (profile === "breadcrumb") {
+				const elements = node.itemListElement;
+				if (Array.isArray(elements) && elements.length < 2) add("rich-results-breadcrumb-minimum-items", "BreadcrumbList must contain at least two ListItem entries.", "itemListElement", "warning", "Provide at least two breadcrumb items.");
+			}
+			if (profile === "event" && isObject(node.location)) {
+				if (!hasValue(node.location.name)) add("rich-results-event-missing-location-name", "Event location should include a name.", "location.name", "warning", "Provide the name of the physical event venue.");
+				if (!hasValue(node.location.address)) add("rich-results-event-missing-address", "Event location should include a detailed address.", "location.address", "warning", "Provide the venue's PostalAddress.");
+			}
+			if (profile === "local-business" && hasValue(node.address)) {
+				if (!isObject(node.address)) add("rich-results-business-invalid-address", "LocalBusiness address should be a PostalAddress object.", "address", "warning", "Provide an address object with the relevant PostalAddress fields.");
+			}
+			if (profile === "software-application" && hasValue(node.offers)) {
+				if (!hasNestedValue(node.offers, "price")) add("rich-results-software-missing-price", "SoftwareApplication offers must include a price.", "offers.price", "warning", "Provide an Offer object with a price. Use 0 for a free application.");
+			}
+			if (profile === "job-posting") {
+				if (isObject(node.hiringOrganization) && !hasValue(node.hiringOrganization.name)) add("rich-results-job-missing-employer-name", "JobPosting hiringOrganization should include a name.", "hiringOrganization.name", "warning", "Provide the employer's organization name.");
+				const locations = getNestedObjects(node.jobLocation);
+				const hasCountry = locations.some((location) => {
+					if (!isObject(location.address)) return false;
+					return hasValue(location.address.addressCountry);
+				});
+				if (locations.length > 0 && !hasCountry) add("rich-results-job-missing-country", "JobPosting jobLocation address should include addressCountry.", "jobLocation.address.addressCountry", "warning", "Provide the country code or country name in the job location address.");
+			}
+		});
+	}
+	return issues;
+};
+const isSafeHttpUrl = (value) => {
+	try {
+		const url = new URL(value);
+		return (url.protocol === "http:" || url.protocol === "https:") && !url.username && !url.password;
+	} catch {
+		return false;
+	}
+};
+const validateMetadata = (metadata) => {
+	const issues = [];
+	const add = (code, message, property, suggestion, severity = "warning") => {
+		issues.push(createIssue("metadata", code, message, severity, {
+			path: property,
+			property,
+			suggestion
+		}));
+	};
+	if (!hasValue(metadata.title)) add("missing-title", "SEO title is missing.", "title", "Provide a descriptive page title.");
+	else {
+		const title = String(metadata.title);
+		if (title.length > 60) add("title-too-long", "SEO title exceeds the recommended 60 characters.", "title", "Consider shortening the title.", "info");
+		if (title.length < 15) add("title-too-short", "SEO title is unusually short.", "title", "Consider providing a more descriptive title.", "info");
+	}
+	if (!hasValue(metadata.description)) add("missing-description", "SEO meta description is missing.", "description", "Provide a concise description of the page.");
+	else {
+		const description = String(metadata.description);
+		if (description.length > 160) add("description-too-long", "SEO description exceeds the recommended 160 characters.", "description", "Consider shortening the description.", "info");
+		if (description.length < 50) add("description-too-short", "SEO description is unusually short.", "description", "Consider providing more descriptive content.", "info");
+	}
+	if (hasValue(metadata.canonical)) {
+		if (!isSafeHttpUrl(String(metadata.canonical))) add("invalid-canonical", "Canonical URL must be an absolute HTTP(S) URL without credentials.", "canonical", "Provide a valid canonical URL.", "error");
+	}
+	if (hasValue(metadata.locale)) try {
+		Intl.getCanonicalLocales(String(metadata.locale));
+	} catch {
+		add("invalid-metadata-locale", "Metadata locale is invalid.", "locale", "Use a valid BCP 47 locale such as en, nl or nl-NL.", "error");
+	}
+	const openGraph = metadata.openGraph;
+	if (openGraph) {
+		if (hasValue(openGraph.url) && !isSafeHttpUrl(String(openGraph.url))) add("invalid-og-url", "Open Graph URL must be an absolute HTTP(S) URL.", "openGraph.url", "Provide a valid Open Graph URL.", "error");
+		if (!hasValue(openGraph.title)) add("missing-og-title", "Open Graph title is missing.", "openGraph.title", "Provide an Open Graph title.");
+		if (!hasValue(openGraph.description)) add("missing-og-description", "Open Graph description is missing.", "openGraph.description", "Provide an Open Graph description.");
+		for (const [index, image] of (openGraph.images ?? []).entries()) {
+			if (!isSafeHttpUrl(String(image.url))) add("invalid-og-image-url", "Open Graph image URL must be an absolute HTTP(S) URL.", `openGraph.images[${index}].url`, "Provide an absolute image URL.", "error");
+			if (!hasValue(image.alt)) add("missing-og-image-alt", "Open Graph image should have alternative text.", `openGraph.images[${index}].alt`, "Provide descriptive image alternative text.", "info");
+			if (image.width !== void 0 && (!Number.isInteger(image.width) || image.width <= 0)) add("invalid-og-image-width", "Open Graph image width must be a positive integer.", `openGraph.images[${index}].width`, "Provide a positive integer width.", "error");
+			if (image.height !== void 0 && (!Number.isInteger(image.height) || image.height <= 0)) add("invalid-og-image-height", "Open Graph image height must be a positive integer.", `openGraph.images[${index}].height`, "Provide a positive integer height.", "error");
+		}
+	}
+	if (metadata.twitter?.images && metadata.twitter.images.some((image) => !isSafeHttpUrl(image))) add("invalid-twitter-image-url", "Twitter image URLs must be absolute HTTP(S) URLs.", "twitter.images", "Provide valid absolute image URLs.", "error");
+	const alternates = metadata.alternates?.alternates ?? [];
+	const seenLocales = /* @__PURE__ */ new Set();
+	for (const [index, alternate] of alternates.entries()) {
+		const locale = alternate.locale.toLowerCase();
+		if (seenLocales.has(locale)) add("duplicate-hreflang", `Duplicate hreflang locale: ${alternate.locale}.`, `alternates.alternates[${index}].locale`, "Each hreflang locale should appear only once.", "error");
+		seenLocales.add(locale);
+		if (!isSafeHttpUrl(String(alternate.url))) add("invalid-hreflang-url", "Hreflang URL must be an absolute HTTP(S) URL.", `alternates.alternates[${index}].url`, "Provide a valid absolute URL.", "error");
+	}
+	for (const property of ["publishedTime", "modifiedTime"]) {
+		const value = metadata[property];
+		if (hasValue(value) && !validateDate(value)) add(`invalid-${property}`, `${property} must be a valid date or datetime.`, property, "Use an ISO 8601 date or datetime.", "error");
+	}
+	const robots = metadata.robots;
+	if (robots) for (const property of ["maxSnippet", "maxVideoPreview"]) {
+		const value = robots[property];
+		if (value !== void 0 && (!Number.isInteger(value) || value < -1)) add(`invalid-robots-${property}`, `robots.${property} must be an integer greater than or equal to -1.`, `robots.${property}`, "Use -1 or a non-negative integer.", "error");
+	}
+	return issues;
+};
+const executeCustomValidators = (validators, context) => {
+	const issues = [];
+	for (const validator of validators) try {
+		const result = validator(context);
+		if (!Array.isArray(result)) continue;
+		issues.push(...result.map((issue) => ({
+			...issue,
+			source: "custom"
+		})));
+	} catch (error) {
+		issues.push(createIssue("custom", "custom-validator-failed", error instanceof Error ? error.message : "A custom SEO validator failed.", "error"));
+	}
+	return issues;
+};
+const validateSeo = (input, options = {}) => {
+	const mode = normalizeMode(options.mode ?? "warn");
+	if (mode === "off") return createReport("off", []);
+	const registry = options.registry ?? defaultRegistry;
+	const graph = input.graph ?? (input.nodes ? { "@graph": [...input.nodes] } : void 0);
+	const issues = [];
+	for (const conflict of registry.getConflicts()) issues.push(createIssue("registry", conflict.code, conflict.message, "warning", {
+		path: conflict.property,
+		property: conflict.property,
+		suggestion: "Resolve the conflicting Schema.org definitions.",
+		docsUrl: SCHEMA_DOCS
+	}));
+	if (graph) {
+		issues.push(...validateGraph(graph, {
+			...options,
+			mode
+		}, registry));
+		if (Array.isArray(graph["@graph"])) {
+			graph["@graph"].forEach((node, index) => {
+				if (isObject(node)) issues.push(...validateSemanticNode(node, index));
+			});
+			if (options.profiles?.length) issues.push(...validateRichResults(getNodes(graph), options.profiles, registry));
+		}
+	}
+	if (input.metadata) issues.push(...validateMetadata(input.metadata));
+	if (options.validators?.length) {
+		const context = {
+			graph,
+			metadata: input.metadata,
+			registry,
+			mode
+		};
+		issues.push(...executeCustomValidators(options.validators, context));
+	}
+	return createReport(mode, issues);
+};
+const validateSeoMetadata = (metadata, options = {}) => {
+	return validateSeo({ metadata }, options);
+};
+/**
+* A standalone node receives its @id when it is added to a graph, so assign the
+* same generated ID here instead of reporting it as missing. Invalid nodes are
+* left untouched so their issues are still reported.
+*/
+const withNodeId = (node, options) => {
+	if (typeof node["@id"] === "string") return node;
+	try {
+		return {
+			...node,
+			"@id": createSeoNode(node, { baseUrl: options.baseUrl })["@id"]
+		};
+	} catch {
+		return node;
+	}
+};
+const validateSeoNode = (node, options = {}) => {
+	return validateSeo({ nodes: [withNodeId(node, options)] }, options);
+};
+export { validateSeo, validateSeoMetadata, validateSeoNode };
+
+//# sourceMappingURL=validate.js.map

package/dist/validation/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","names":[],"sources":["../../src/validation/validate.ts"],"sourcesContent":["import { createSeoNode, validateSeoGraph } from \"../core\";\n\nimport type { SeoGraph, SeoNode } from \"../core\";\n\nimport { createDefaultSchemaRegistry, validateSchemaNode } from \"../schema\";\n\nimport type { SchemaRegistry } from \"../schema\";\n\nimport type { ResolvedSeoMetadata, SeoPageMetadata } from \"../metadata/types\";\n\nimport type {\n  SeoCustomValidator,\n  SeoRichResultProfile,\n  SeoValidationContext,\n  SeoValidationIssue,\n  SeoValidationMode,\n  SeoValidationOptions,\n  SeoValidationReport,\n  SeoValidationSource,\n  SeoValidationSummary,\n  SeoValidationInput,\n} from \"./types\";\n\nconst defaultRegistry = createDefaultSchemaRegistry();\n\nconst SCHEMA_DOCS = \"https://schema.org/\";\n\nconst GOOGLE_DOCS =\n  \"https://developers.google.com/search/docs/appearance/structured-data\";\n\nconst isObject = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nconst getTypes = (node: SeoNode): string[] => {\n  const value = node[\"@type\"];\n\n  return (Array.isArray(value) ? value : [value]).filter(\n    (type): type is string =>\n      typeof type === \"string\" && type.trim().length > 0,\n  );\n};\n\nconst hasValue = (value: unknown): boolean => {\n  if (value === undefined || value === null) {\n    return false;\n  }\n\n  if (typeof value === \"string\") {\n    return value.trim().length > 0;\n  }\n\n  if (Array.isArray(value)) {\n    return value.length > 0;\n  }\n\n  return true;\n};\n\nconst getNodes = (graph?: SeoGraph): SeoNode[] => graph?.[\"@graph\"] ?? [];\n\nconst createIssue = (\n  source: SeoValidationSource,\n  code: string,\n  message: string,\n  severity: SeoValidationIssue[\"severity\"] = \"warning\",\n  details: Partial<\n    Pick<\n      SeoValidationIssue,\n      \"path\" | \"nodeId\" | \"property\" | \"suggestion\" | \"docsUrl\"\n    >\n  > = {},\n): SeoValidationIssue => ({\n  source,\n  code,\n  message,\n  severity,\n  ...details,\n});\n\nconst normalizeMode = (mode: SeoValidationMode): SeoValidationMode => mode;\n\nconst normalizeSeverity = (\n  severity: SeoValidationIssue[\"severity\"],\n  mode: SeoValidationMode,\n): SeoValidationIssue[\"severity\"] => {\n  if (mode === \"strict\" && severity === \"warning\") {\n    return \"error\";\n  }\n\n  return severity;\n};\n\nconst createSummary = (\n  issues: readonly SeoValidationIssue[],\n): SeoValidationSummary => {\n  const summary = {\n    errors: 0,\n    warnings: 0,\n    infos: 0,\n    total: issues.length,\n  };\n\n  for (const issue of issues) {\n    switch (issue.severity) {\n      case \"error\":\n        summary.errors += 1;\n        break;\n\n      case \"warning\":\n        summary.warnings += 1;\n        break;\n\n      case \"info\":\n        summary.infos += 1;\n        break;\n    }\n  }\n\n  return summary;\n};\n\nconst createReport = (\n  mode: SeoValidationMode,\n  issues: SeoValidationIssue[],\n): SeoValidationReport => {\n  const normalizedIssues = issues.map((issue) => ({\n    ...issue,\n    severity: normalizeSeverity(issue.severity, mode),\n  }));\n\n  const summary = createSummary(normalizedIssues);\n\n  return {\n    valid: summary.errors === 0,\n    mode,\n    issues: normalizedIssues,\n    summary,\n  };\n};\n\n// ---------------------------------------------------------------------------\n// Graph validation\n// ---------------------------------------------------------------------------\n\nconst validateGraph = (\n  graph: SeoGraph,\n  options: SeoValidationOptions,\n  registry: SchemaRegistry,\n): SeoValidationIssue[] => {\n  const issues: SeoValidationIssue[] = [];\n\n  if (!Array.isArray(graph[\"@graph\"])) {\n    return [\n      createIssue(\n        \"graph\",\n        \"invalid-graph\",\n        \"SEO graph must contain an @graph array.\",\n        \"error\",\n      ),\n    ];\n  }\n\n  const result = validateSeoGraph(graph, {\n    baseUrl: options.baseUrl,\n    strictReferences: options.mode === \"strict\",\n    allowedExternalReferences: options.allowExternalReferences ?? true,\n  });\n\n  for (const issue of result.issues) {\n    issues.push(\n      createIssue(\"graph\", issue.code, issue.message, issue.severity, {\n        path: issue.path,\n        nodeId: issue.nodeId,\n        property: issue.property,\n        suggestion:\n          issue.code === \"unresolved-reference\"\n            ? \"Register the referenced node or verify its @id.\"\n            : undefined,\n      }),\n    );\n  }\n\n  for (let index = 0; index < graph[\"@graph\"].length; index += 1) {\n    const node = graph[\"@graph\"][index];\n\n    if (!isObject(node)) {\n      continue;\n    }\n\n    const nodeId = typeof node[\"@id\"] === \"string\" ? node[\"@id\"] : undefined;\n\n    const result = validateSchemaNode(node, registry, {\n      strict: options.mode === \"strict\",\n      allowUnknownProperties:\n        options.allowUnknownProperties ?? options.mode !== \"strict\",\n      validateRequiredProperties: options.validateRequiredProperties ?? false,\n    });\n\n    for (const issue of result.issues) {\n      issues.push(\n        createIssue(\"schema\", issue.code, issue.message, issue.severity, {\n          path: issue.path\n            ? `@graph[${index}]${issue.path.replace(\"$\", \"\")}`\n            : `@graph[${index}]`,\n          nodeId,\n          property: issue.property,\n          suggestion:\n            issue.code === \"unknown-property\"\n              ? \"Check the Schema.org property name or extend the registry.\"\n              : issue.code === \"unknown-type\"\n                ? \"Use a registered Schema.org type or add a custom definition.\"\n                : undefined,\n          docsUrl: SCHEMA_DOCS,\n        }),\n      );\n    }\n  }\n\n  return issues;\n};\n\n// ---------------------------------------------------------------------------\n// Semantic validation\n// ---------------------------------------------------------------------------\n\nconst validateDate = (value: unknown): boolean => {\n  if (typeof value !== \"string\") {\n    return false;\n  }\n\n  return value.trim().length > 0 && !Number.isNaN(Date.parse(value));\n};\n\nconst validateSemanticNode = (\n  node: SeoNode,\n  index: number,\n): SeoValidationIssue[] => {\n  const issues: SeoValidationIssue[] = [];\n\n  const types = getTypes(node);\n\n  const nodeId = typeof node[\"@id\"] === \"string\" ? node[\"@id\"] : undefined;\n\n  const path = `@graph[${index}]`;\n\n  const add = (\n    code: string,\n    message: string,\n    property: string,\n    suggestion: string,\n  ) => {\n    issues.push(\n      createIssue(\"semantic\", code, message, \"warning\", {\n        path: `${path}.${property}`,\n        nodeId,\n        property,\n        suggestion,\n        docsUrl: SCHEMA_DOCS,\n      }),\n    );\n  };\n\n  // Article\n\n  if (\n    types.some((type) =>\n      [\"Article\", \"NewsArticle\", \"BlogPosting\", \"TechArticle\"].includes(\n        type.split(\"/\").pop() ?? type,\n      ),\n    )\n  ) {\n    if (!hasValue(node.headline)) {\n      add(\n        \"article-missing-headline\",\n        \"Article nodes should provide a headline.\",\n        \"headline\",\n        \"Add a descriptive headline.\",\n      );\n    }\n\n    if (hasValue(node.datePublished) && !validateDate(node.datePublished)) {\n      add(\n        \"invalid-publication-date\",\n        \"Article datePublished is not a valid date.\",\n        \"datePublished\",\n        \"Use a valid ISO 8601 date or datetime.\",\n      );\n    }\n\n    if (hasValue(node.dateModified) && !validateDate(node.dateModified)) {\n      add(\n        \"invalid-modification-date\",\n        \"Article dateModified is not a valid date.\",\n        \"dateModified\",\n        \"Use a valid ISO 8601 date or datetime.\",\n      );\n    }\n\n    if (\n      hasValue(node.datePublished) &&\n      hasValue(node.dateModified) &&\n      validateDate(node.datePublished) &&\n      validateDate(node.dateModified) &&\n      Date.parse(String(node.dateModified)) <\n        Date.parse(String(node.datePublished))\n    ) {\n      add(\n        \"modification-before-publication\",\n        \"Article dateModified is earlier than datePublished.\",\n        \"dateModified\",\n        \"Verify the publication and modification dates.\",\n      );\n    }\n  }\n\n  // Product\n\n  if (\n    types.includes(\"Product\") ||\n    types.includes(\"https://schema.org/Product\")\n  ) {\n    if (!hasValue(node.name)) {\n      add(\n        \"product-missing-name\",\n        \"Product nodes should provide a name.\",\n        \"name\",\n        \"Add the product's visible name.\",\n      );\n    }\n\n    if (\n      hasValue(node.offers) &&\n      !Array.isArray(node.offers) &&\n      !isObject(node.offers)\n    ) {\n      add(\n        \"invalid-product-offers\",\n        \"Product offers must be an Offer node or an array of Offer nodes.\",\n        \"offers\",\n        \"Provide an Offer object or an array of Offer objects.\",\n      );\n    }\n  }\n\n  // Offer\n\n  if (types.includes(\"Offer\") || types.includes(\"https://schema.org/Offer\")) {\n    if (hasValue(node.price)) {\n      const price = Number(node.price);\n\n      if (!Number.isFinite(price) || price < 0) {\n        add(\n          \"invalid-offer-price\",\n          \"Offer price must be a non-negative finite number.\",\n          \"price\",\n          \"Provide a valid numeric price.\",\n        );\n      }\n    }\n\n    if (hasValue(node.price) && !hasValue(node.priceCurrency)) {\n      add(\n        \"offer-missing-currency\",\n        \"Offers with a price should specify priceCurrency.\",\n        \"priceCurrency\",\n        \"Provide an ISO 4217 currency code, such as EUR or USD.\",\n      );\n    }\n\n    if (\n      hasValue(node.priceCurrency) &&\n      !/^[A-Z]{3}$/.test(String(node.priceCurrency))\n    ) {\n      add(\n        \"invalid-price-currency\",\n        \"Offer priceCurrency should use an ISO 4217 currency code.\",\n        \"priceCurrency\",\n        \"Use a three-letter uppercase currency code.\",\n      );\n    }\n  }\n\n  // BreadcrumbList\n\n  if (\n    types.includes(\"BreadcrumbList\") ||\n    types.includes(\"https://schema.org/BreadcrumbList\")\n  ) {\n    const elements = node.itemListElement;\n\n    if (!Array.isArray(elements) || elements.length === 0) {\n      add(\n        \"breadcrumb-missing-items\",\n        \"BreadcrumbList should contain itemListElement entries.\",\n        \"itemListElement\",\n        \"Add at least one ListItem.\",\n      );\n    } else {\n      const positions = new Set<number>();\n\n      elements.forEach((item, itemIndex) => {\n        if (!isObject(item)) {\n          add(\n            \"invalid-breadcrumb-item\",\n            \"Breadcrumb entries should be ListItem objects.\",\n            `itemListElement[${itemIndex}]`,\n            \"Provide a ListItem with position, name and item.\",\n          );\n\n          return;\n        }\n\n        const position = Number(item.position);\n\n        if (\n          !Number.isInteger(position) ||\n          position < 1 ||\n          positions.has(position)\n        ) {\n          add(\n            \"invalid-breadcrumb-position\",\n            \"Breadcrumb positions must be unique positive integers.\",\n            `itemListElement[${itemIndex}].position`,\n            \"Use sequential positions starting at 1.\",\n          );\n        } else {\n          positions.add(position);\n        }\n\n        if (!hasValue(item.name)) {\n          add(\n            \"breadcrumb-missing-name\",\n            \"Breadcrumb ListItem should provide a name.\",\n            `itemListElement[${itemIndex}].name`,\n            \"Provide the visible breadcrumb label.\",\n          );\n        }\n\n        if (!hasValue(item.item) && itemIndex !== elements.length - 1) {\n          add(\n            \"breadcrumb-missing-item\",\n            \"Breadcrumb ListItem should provide an item URL.\",\n            `itemListElement[${itemIndex}].item`,\n            \"Provide the destination URL.\",\n          );\n        }\n      });\n    }\n  }\n\n  return issues;\n};\n\n// ---------------------------------------------------------------------------\n// Rich Results profiles\n// ---------------------------------------------------------------------------\n\ninterface RichResultRule {\n  type: string;\n  required: readonly string[];\n  recommended?: readonly string[];\n  requireAny?: readonly string[];\n  docsUrl: string;\n}\n\nconst richResultRules: Record<SeoRichResultProfile, RichResultRule> = {\n  article: {\n    type: \"Article\",\n    required: [],\n    recommended: [\n      \"headline\",\n      \"image\",\n      \"datePublished\",\n      \"dateModified\",\n      \"author\",\n    ],\n    docsUrl: `${GOOGLE_DOCS}/article`,\n  },\n\n  product: {\n    type: \"Product\",\n    required: [\"name\"],\n    requireAny: [\"offers\", \"aggregateRating\", \"review\"],\n    recommended: [\"image\", \"description\"],\n    docsUrl: `${GOOGLE_DOCS}/product`,\n  },\n\n  breadcrumb: {\n    type: \"BreadcrumbList\",\n    required: [\"itemListElement\"],\n    docsUrl: `${GOOGLE_DOCS}/breadcrumb`,\n  },\n\n  event: {\n    type: \"Event\",\n    required: [\"name\", \"startDate\", \"location\"],\n    docsUrl: `${GOOGLE_DOCS}/event`,\n  },\n\n  recipe: {\n    type: \"Recipe\",\n    required: [\"name\", \"image\"],\n    recommended: [\n      \"author\",\n      \"description\",\n      \"prepTime\",\n      \"cookTime\",\n      \"recipeYield\",\n      \"nutrition\",\n    ],\n    docsUrl: `${GOOGLE_DOCS}/recipe`,\n  },\n\n  \"job-posting\": {\n    type: \"JobPosting\",\n    required: [\n      \"title\",\n      \"description\",\n      \"datePosted\",\n      \"hiringOrganization\",\n      \"jobLocation\",\n    ],\n    recommended: [\"validThrough\", \"employmentType\", \"baseSalary\"],\n    docsUrl: `${GOOGLE_DOCS}/job-posting`,\n  },\n\n  \"local-business\": {\n    type: \"LocalBusiness\",\n    required: [\"name\", \"address\"],\n    recommended: [\"telephone\", \"url\", \"image\", \"openingHoursSpecification\"],\n    docsUrl: `${GOOGLE_DOCS}/local-business`,\n  },\n\n  \"software-application\": {\n    type: \"SoftwareApplication\",\n    required: [\"name\", \"offers\"],\n    requireAny: [\"aggregateRating\", \"review\"],\n    recommended: [\"applicationCategory\", \"operatingSystem\"],\n    docsUrl: `${GOOGLE_DOCS}/software-app`,\n  },\n};\n\nconst profileMatches = (\n  node: SeoNode,\n  profile: SeoRichResultProfile,\n  registry: SchemaRegistry,\n): boolean => {\n  const expected = richResultRules[profile].type;\n\n  return getTypes(node).some((type) => registry.isTypeOf(type, expected));\n};\n\nconst getNestedObjects = (value: unknown): Record<string, unknown>[] => {\n  const values = Array.isArray(value) ? value : [value];\n\n  return values.filter(isObject);\n};\n\nconst hasNestedValue = (value: unknown, property: string): boolean =>\n  getNestedObjects(value).some((item) => hasValue(item[property]));\n\nconst validateRichResults = (\n  nodes: readonly SeoNode[],\n  profiles: readonly SeoRichResultProfile[],\n  registry: SchemaRegistry,\n): SeoValidationIssue[] => {\n  const issues: SeoValidationIssue[] = [];\n\n  for (const profile of profiles) {\n    const rule = richResultRules[profile];\n\n    nodes.forEach((node, nodeIndex) => {\n      if (!profileMatches(node, profile, registry)) {\n        return;\n      }\n\n      const nodeId = typeof node[\"@id\"] === \"string\" ? node[\"@id\"] : undefined;\n\n      const path = `@graph[${nodeIndex}]`;\n\n      const add = (\n        code: string,\n        message: string,\n        property?: string,\n        severity: SeoValidationIssue[\"severity\"] = \"warning\",\n        suggestion?: string,\n      ) => {\n        issues.push(\n          createIssue(\"rich-results\", code, message, severity, {\n            nodeId,\n            property,\n            path: property ? `${path}.${property}` : path,\n            suggestion,\n            docsUrl: rule.docsUrl,\n          }),\n        );\n      };\n\n      // Required properties\n\n      for (const property of rule.required) {\n        if (hasValue(node[property])) {\n          continue;\n        }\n\n        add(\n          `rich-results-missing-${property}`,\n          `${rule.type} is missing the required Rich Results property \"${property}\".`,\n          property,\n          \"warning\",\n          `Add the ${property} property to meet the ${profile} structured data requirements.`,\n        );\n      }\n\n      // Recommended properties\n\n      for (const property of rule.recommended ?? []) {\n        if (hasValue(node[property])) {\n          continue;\n        }\n\n        add(\n          `rich-results-recommended-${property}`,\n          `${rule.type} should provide the recommended property \"${property}\".`,\n          property,\n          \"info\",\n          `Consider adding ${property} to provide more complete structured data.`,\n        );\n      }\n\n      // At least one of a group of alternative properties\n\n      if (\n        rule.requireAny &&\n        !rule.requireAny.some((property) => hasValue(node[property]))\n      ) {\n        add(\n          \"rich-results-missing-alternative\",\n          `${rule.type} must provide at least one of: ${rule.requireAny.join(\", \")}.`,\n          undefined,\n          \"warning\",\n          `Provide at least one of: ${rule.requireAny.join(\", \")}.`,\n        );\n      }\n\n      // Product-specific checks\n\n      if (profile === \"product\" && hasValue(node.offers)) {\n        if (!hasNestedValue(node.offers, \"price\")) {\n          add(\n            \"rich-results-product-offer-missing-price\",\n            \"Product offers should include a price.\",\n            \"offers\",\n            \"warning\",\n            \"Add a price to each Offer object.\",\n          );\n        }\n      }\n\n      // Breadcrumb-specific checks\n\n      if (profile === \"breadcrumb\") {\n        const elements = node.itemListElement;\n\n        if (Array.isArray(elements) && elements.length < 2) {\n          add(\n            \"rich-results-breadcrumb-minimum-items\",\n            \"BreadcrumbList must contain at least two ListItem entries.\",\n            \"itemListElement\",\n            \"warning\",\n            \"Provide at least two breadcrumb items.\",\n          );\n        }\n      }\n\n      // Event-specific checks\n\n      if (profile === \"event\" && isObject(node.location)) {\n        if (!hasValue(node.location.name)) {\n          add(\n            \"rich-results-event-missing-location-name\",\n            \"Event location should include a name.\",\n            \"location.name\",\n            \"warning\",\n            \"Provide the name of the physical event venue.\",\n          );\n        }\n\n        if (!hasValue(node.location.address)) {\n          add(\n            \"rich-results-event-missing-address\",\n            \"Event location should include a detailed address.\",\n            \"location.address\",\n            \"warning\",\n            \"Provide the venue's PostalAddress.\",\n          );\n        }\n      }\n\n      // LocalBusiness-specific checks\n\n      if (profile === \"local-business\" && hasValue(node.address)) {\n        if (!isObject(node.address)) {\n          add(\n            \"rich-results-business-invalid-address\",\n            \"LocalBusiness address should be a PostalAddress object.\",\n            \"address\",\n            \"warning\",\n            \"Provide an address object with the relevant PostalAddress fields.\",\n          );\n        }\n      }\n\n      // SoftwareApplication-specific checks\n\n      if (profile === \"software-application\" && hasValue(node.offers)) {\n        if (!hasNestedValue(node.offers, \"price\")) {\n          add(\n            \"rich-results-software-missing-price\",\n            \"SoftwareApplication offers must include a price.\",\n            \"offers.price\",\n            \"warning\",\n            \"Provide an Offer object with a price. Use 0 for a free application.\",\n          );\n        }\n      }\n\n      // JobPosting-specific checks\n\n      if (profile === \"job-posting\") {\n        if (\n          isObject(node.hiringOrganization) &&\n          !hasValue(node.hiringOrganization.name)\n        ) {\n          add(\n            \"rich-results-job-missing-employer-name\",\n            \"JobPosting hiringOrganization should include a name.\",\n            \"hiringOrganization.name\",\n            \"warning\",\n            \"Provide the employer's organization name.\",\n          );\n        }\n\n        const locations = getNestedObjects(node.jobLocation);\n\n        const hasCountry = locations.some((location) => {\n          if (!isObject(location.address)) {\n            return false;\n          }\n\n          return hasValue(location.address.addressCountry);\n        });\n\n        if (locations.length > 0 && !hasCountry) {\n          add(\n            \"rich-results-job-missing-country\",\n            \"JobPosting jobLocation address should include addressCountry.\",\n            \"jobLocation.address.addressCountry\",\n            \"warning\",\n            \"Provide the country code or country name in the job location address.\",\n          );\n        }\n      }\n    });\n  }\n\n  return issues;\n};\n\n// ---------------------------------------------------------------------------\n// Metadata validation\n// ---------------------------------------------------------------------------\n\nconst isSafeHttpUrl = (value: string): boolean => {\n  try {\n    const url = new URL(value);\n\n    return (\n      (url.protocol === \"http:\" || url.protocol === \"https:\") &&\n      !url.username &&\n      !url.password\n    );\n  } catch {\n    return false;\n  }\n};\n\nconst validateMetadata = (\n  metadata: SeoPageMetadata | ResolvedSeoMetadata,\n): SeoValidationIssue[] => {\n  const issues: SeoValidationIssue[] = [];\n\n  const add = (\n    code: string,\n    message: string,\n    property: string,\n    suggestion: string,\n    severity: SeoValidationIssue[\"severity\"] = \"warning\",\n  ) => {\n    issues.push(\n      createIssue(\"metadata\", code, message, severity, {\n        path: property,\n        property,\n        suggestion,\n      }),\n    );\n  };\n\n  // Title\n\n  if (!hasValue(metadata.title)) {\n    add(\n      \"missing-title\",\n      \"SEO title is missing.\",\n      \"title\",\n      \"Provide a descriptive page title.\",\n    );\n  } else {\n    const title = String(metadata.title);\n\n    if (title.length > 60) {\n      add(\n        \"title-too-long\",\n        \"SEO title exceeds the recommended 60 characters.\",\n        \"title\",\n        \"Consider shortening the title.\",\n        \"info\",\n      );\n    }\n\n    if (title.length < 15) {\n      add(\n        \"title-too-short\",\n        \"SEO title is unusually short.\",\n        \"title\",\n        \"Consider providing a more descriptive title.\",\n        \"info\",\n      );\n    }\n  }\n\n  // Description\n\n  if (!hasValue(metadata.description)) {\n    add(\n      \"missing-description\",\n      \"SEO meta description is missing.\",\n      \"description\",\n      \"Provide a concise description of the page.\",\n    );\n  } else {\n    const description = String(metadata.description);\n\n    if (description.length > 160) {\n      add(\n        \"description-too-long\",\n        \"SEO description exceeds the recommended 160 characters.\",\n        \"description\",\n        \"Consider shortening the description.\",\n        \"info\",\n      );\n    }\n\n    if (description.length < 50) {\n      add(\n        \"description-too-short\",\n        \"SEO description is unusually short.\",\n        \"description\",\n        \"Consider providing more descriptive content.\",\n        \"info\",\n      );\n    }\n  }\n\n  // Canonical\n\n  if (hasValue(metadata.canonical)) {\n    if (!isSafeHttpUrl(String(metadata.canonical))) {\n      add(\n        \"invalid-canonical\",\n        \"Canonical URL must be an absolute HTTP(S) URL without credentials.\",\n        \"canonical\",\n        \"Provide a valid canonical URL.\",\n        \"error\",\n      );\n    }\n  }\n\n  // Locale\n\n  if (hasValue(metadata.locale)) {\n    try {\n      Intl.getCanonicalLocales(String(metadata.locale));\n    } catch {\n      add(\n        \"invalid-metadata-locale\",\n        \"Metadata locale is invalid.\",\n        \"locale\",\n        \"Use a valid BCP 47 locale such as en, nl or nl-NL.\",\n        \"error\",\n      );\n    }\n  }\n\n  // Open Graph\n\n  const openGraph = metadata.openGraph;\n\n  if (openGraph) {\n    if (hasValue(openGraph.url) && !isSafeHttpUrl(String(openGraph.url))) {\n      add(\n        \"invalid-og-url\",\n        \"Open Graph URL must be an absolute HTTP(S) URL.\",\n        \"openGraph.url\",\n        \"Provide a valid Open Graph URL.\",\n        \"error\",\n      );\n    }\n\n    if (!hasValue(openGraph.title)) {\n      add(\n        \"missing-og-title\",\n        \"Open Graph title is missing.\",\n        \"openGraph.title\",\n        \"Provide an Open Graph title.\",\n      );\n    }\n\n    if (!hasValue(openGraph.description)) {\n      add(\n        \"missing-og-description\",\n        \"Open Graph description is missing.\",\n        \"openGraph.description\",\n        \"Provide an Open Graph description.\",\n      );\n    }\n\n    for (const [index, image] of (openGraph.images ?? []).entries()) {\n      if (!isSafeHttpUrl(String(image.url))) {\n        add(\n          \"invalid-og-image-url\",\n          \"Open Graph image URL must be an absolute HTTP(S) URL.\",\n          `openGraph.images[${index}].url`,\n          \"Provide an absolute image URL.\",\n          \"error\",\n        );\n      }\n\n      if (!hasValue(image.alt)) {\n        add(\n          \"missing-og-image-alt\",\n          \"Open Graph image should have alternative text.\",\n          `openGraph.images[${index}].alt`,\n          \"Provide descriptive image alternative text.\",\n          \"info\",\n        );\n      }\n\n      if (\n        image.width !== undefined &&\n        (!Number.isInteger(image.width) || image.width <= 0)\n      ) {\n        add(\n          \"invalid-og-image-width\",\n          \"Open Graph image width must be a positive integer.\",\n          `openGraph.images[${index}].width`,\n          \"Provide a positive integer width.\",\n          \"error\",\n        );\n      }\n\n      if (\n        image.height !== undefined &&\n        (!Number.isInteger(image.height) || image.height <= 0)\n      ) {\n        add(\n          \"invalid-og-image-height\",\n          \"Open Graph image height must be a positive integer.\",\n          `openGraph.images[${index}].height`,\n          \"Provide a positive integer height.\",\n          \"error\",\n        );\n      }\n    }\n  }\n\n  // Twitter\n\n  if (\n    metadata.twitter?.images &&\n    metadata.twitter.images.some((image) => !isSafeHttpUrl(image))\n  ) {\n    add(\n      \"invalid-twitter-image-url\",\n      \"Twitter image URLs must be absolute HTTP(S) URLs.\",\n      \"twitter.images\",\n      \"Provide valid absolute image URLs.\",\n      \"error\",\n    );\n  }\n\n  // Hreflang\n\n  const alternates = metadata.alternates?.alternates ?? [];\n\n  const seenLocales = new Set<string>();\n\n  for (const [index, alternate] of alternates.entries()) {\n    const locale = alternate.locale.toLowerCase();\n\n    if (seenLocales.has(locale)) {\n      add(\n        \"duplicate-hreflang\",\n        `Duplicate hreflang locale: ${alternate.locale}.`,\n        `alternates.alternates[${index}].locale`,\n        \"Each hreflang locale should appear only once.\",\n        \"error\",\n      );\n    }\n\n    seenLocales.add(locale);\n\n    if (!isSafeHttpUrl(String(alternate.url))) {\n      add(\n        \"invalid-hreflang-url\",\n        \"Hreflang URL must be an absolute HTTP(S) URL.\",\n        `alternates.alternates[${index}].url`,\n        \"Provide a valid absolute URL.\",\n        \"error\",\n      );\n    }\n  }\n\n  // Article metadata\n\n  for (const property of [\"publishedTime\", \"modifiedTime\"] as const) {\n    const value = metadata[property];\n\n    if (hasValue(value) && !validateDate(value)) {\n      add(\n        `invalid-${property}`,\n        `${property} must be a valid date or datetime.`,\n        property,\n        \"Use an ISO 8601 date or datetime.\",\n        \"error\",\n      );\n    }\n  }\n\n  // Robots\n\n  const robots = metadata.robots;\n\n  if (robots) {\n    for (const property of [\"maxSnippet\", \"maxVideoPreview\"] as const) {\n      const value = robots[property];\n\n      if (value !== undefined && (!Number.isInteger(value) || value < -1)) {\n        add(\n          `invalid-robots-${property}`,\n          `robots.${property} must be an integer greater than or equal to -1.`,\n          `robots.${property}`,\n          \"Use -1 or a non-negative integer.\",\n          \"error\",\n        );\n      }\n    }\n  }\n\n  return issues;\n};\n\n// ---------------------------------------------------------------------------\n// Custom validators\n// ---------------------------------------------------------------------------\n\nconst executeCustomValidators = (\n  validators: readonly SeoCustomValidator[],\n  context: SeoValidationContext,\n): SeoValidationIssue[] => {\n  const issues: SeoValidationIssue[] = [];\n\n  for (const validator of validators) {\n    try {\n      const result = validator(context);\n\n      if (!Array.isArray(result)) {\n        continue;\n      }\n\n      issues.push(\n        ...result.map((issue) => ({\n          ...issue,\n          source: \"custom\" as const,\n        })),\n      );\n    } catch (error) {\n      issues.push(\n        createIssue(\n          \"custom\",\n          \"custom-validator-failed\",\n          error instanceof Error\n            ? error.message\n            : \"A custom SEO validator failed.\",\n          \"error\",\n        ),\n      );\n    }\n  }\n\n  return issues;\n};\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\nexport const validateSeo = (\n  input: SeoValidationInput,\n  options: SeoValidationOptions = {},\n): SeoValidationReport => {\n  const mode = normalizeMode(options.mode ?? \"warn\");\n\n  if (mode === \"off\") {\n    return createReport(\"off\", []);\n  }\n\n  const registry = options.registry ?? defaultRegistry;\n\n  const graph =\n    input.graph ??\n    (input.nodes\n      ? {\n          \"@graph\": [...input.nodes],\n        }\n      : undefined);\n\n  const issues: SeoValidationIssue[] = [];\n\n  // Registry diagnostics\n\n  for (const conflict of registry.getConflicts()) {\n    issues.push(\n      createIssue(\"registry\", conflict.code, conflict.message, \"warning\", {\n        path: conflict.property,\n        property: conflict.property,\n        suggestion: \"Resolve the conflicting Schema.org definitions.\",\n        docsUrl: SCHEMA_DOCS,\n      }),\n    );\n  }\n\n  // Graph and Schema.org validation\n\n  if (graph) {\n    issues.push(\n      ...validateGraph(\n        graph,\n        {\n          ...options,\n          mode,\n        },\n        registry,\n      ),\n    );\n\n    if (Array.isArray(graph[\"@graph\"])) {\n      graph[\"@graph\"].forEach((node, index) => {\n        if (isObject(node)) {\n          issues.push(...validateSemanticNode(node, index));\n        }\n      });\n\n      if (options.profiles?.length) {\n        issues.push(\n          ...validateRichResults(getNodes(graph), options.profiles, registry),\n        );\n      }\n    }\n  }\n\n  // Metadata validation\n\n  if (input.metadata) {\n    issues.push(...validateMetadata(input.metadata));\n  }\n\n  // Custom validators\n\n  if (options.validators?.length) {\n    const context: SeoValidationContext = {\n      graph,\n      metadata: input.metadata,\n      registry,\n      mode,\n    };\n\n    issues.push(...executeCustomValidators(options.validators, context));\n  }\n\n  return createReport(mode, issues);\n};\n\nexport const validateSeoMetadata = (\n  metadata: SeoPageMetadata | ResolvedSeoMetadata,\n  options: Pick<SeoValidationOptions, \"mode\"> = {},\n): SeoValidationReport => {\n  return validateSeo(\n    {\n      metadata,\n    },\n    options,\n  );\n};\n\n/**\n * A standalone node receives its @id when it is added to a graph, so assign the\n * same generated ID here instead of reporting it as missing. Invalid nodes are\n * left untouched so their issues are still reported.\n */\nconst withNodeId = (node: SeoNode, options: SeoValidationOptions): SeoNode => {\n  if (typeof node[\"@id\"] === \"string\") {\n    return node;\n  }\n\n  try {\n    return {\n      ...node,\n      \"@id\": createSeoNode(node, { baseUrl: options.baseUrl })[\"@id\"],\n    };\n  } catch {\n    return node;\n  }\n};\n\nexport const validateSeoNode = (\n  node: SeoNode,\n  options: SeoValidationOptions = {},\n): SeoValidationReport => {\n  return validateSeo(\n    {\n      nodes: [withNodeId(node, options)],\n    },\n    options,\n  );\n};\n"],"mappings":"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"}