rankforge 0.3.0

package/src/source-map.json

@@ -0,0 +1,28 @@
+{
+  "search_essentials": "https://developers.google.com/search/docs/essentials",
+  "technical_requirements": "https://developers.google.com/search/docs/essentials/technical",
+  "how_search_works": "https://developers.google.com/search/docs/fundamentals/how-search-works",
+  "crawlable_links": "https://developers.google.com/search/docs/crawling-indexing/links-crawlable",
+  "robots_meta": "https://developers.google.com/search/docs/crawling-indexing/robots-meta-tag",
+  "robots_txt": "https://developers.google.com/search/docs/crawling-indexing/robots/intro",
+  "block_indexing": "https://developers.google.com/search/docs/crawling-indexing/block-indexing",
+  "canonicalization": "https://developers.google.com/search/docs/crawling-indexing/canonicalization",
+  "consolidate_duplicate_urls": "https://developers.google.com/search/docs/crawling-indexing/consolidate-duplicate-urls",
+  "sitemaps": "https://developers.google.com/search/docs/crawling-indexing/sitemaps/overview",
+  "javascript_seo": "https://developers.google.com/search/docs/crawling-indexing/javascript/javascript-seo-basics",
+  "fix_javascript_seo": "https://developers.google.com/search/docs/crawling-indexing/javascript/fix-search-javascript",
+  "valid_metadata": "https://developers.google.com/search/docs/crawling-indexing/valid-page-metadata",
+  "helpful_content": "https://developers.google.com/search/docs/fundamentals/creating-helpful-content",
+  "ai_optimization": "https://developers.google.com/search/docs/fundamentals/ai-optimization-guide",
+  "ai_features": "https://developers.google.com/search/docs/appearance/ai-features",
+  "structured_data_intro": "https://developers.google.com/search/docs/appearance/structured-data/intro-structured-data",
+  "structured_data_policies": "https://developers.google.com/search/docs/appearance/structured-data/sd-policies",
+  "structured_data_gallery": "https://developers.google.com/search/docs/appearance/structured-data/search-gallery",
+  "organization_schema": "https://developers.google.com/search/docs/appearance/structured-data/organization",
+  "title_links": "https://developers.google.com/search/docs/appearance/title-link",
+  "snippets": "https://developers.google.com/search/docs/appearance/snippet",
+  "google_images": "https://developers.google.com/search/docs/appearance/google-images",
+  "favicon": "https://developers.google.com/search/docs/appearance/favicon-in-search",
+  "site_names": "https://developers.google.com/search/docs/appearance/site-names",
+  "spam_policies": "https://developers.google.com/search/docs/essentials/spam-policies"
+}

package/src/structured-data.mjs

@@ -0,0 +1,59 @@
+const requiredProperties = {
+  Organization: ["name", "url"],
+  Product: ["name", "offers"],
+  FAQPage: ["mainEntity"],
+  Article: ["headline", "datePublished", "author"],
+  BreadcrumbList: ["itemListElement"],
+  Event: ["name", "startDate", "location"],
+  VideoObject: ["name", "thumbnailUrl", "uploadDate"],
+  SoftwareApplication: ["name", "applicationCategory", "operatingSystem"],
+};
+
+const hasValue = (value) => {
+  if (value === null || value === undefined) return false;
+  if (typeof value === "string") return value.trim().length > 0;
+  if (Array.isArray(value)) return value.length > 0;
+  return true;
+};
+
+export const structuredDataTypeNames = (value) => {
+  if (!value) return [];
+  return Array.isArray(value) ? value.map(String) : [String(value)];
+};
+
+export const structuredDataNodes = (value) => {
+  if (!value) return [];
+  if (Array.isArray(value)) return value.flatMap(structuredDataNodes);
+  if (typeof value !== "object") return [];
+
+  const nodes = [value];
+  if (value["@graph"]) nodes.push(...structuredDataNodes(value["@graph"]));
+  return nodes;
+};
+
+export const validateStructuredData = (structuredData = []) => {
+  const issues = [];
+
+  for (const [blockIndex, block] of structuredData.entries()) {
+    if (!block?.data) continue;
+
+    for (const [nodeIndex, node] of structuredDataNodes(block.data).entries()) {
+      for (const type of structuredDataTypeNames(node["@type"])) {
+        const required = requiredProperties[type];
+        if (!required) continue;
+
+        const missing = required.filter((property) => !hasValue(node[property]));
+        if (missing.length) {
+          issues.push({
+            type,
+            missing,
+            blockIndex,
+            nodeIndex,
+          });
+        }
+      }
+    }
+  }
+
+  return issues;
+};

package/src/url-utils.mjs

@@ -0,0 +1,25 @@
+export const isHttpUrl = (value) => /^https?:\/\//i.test(String(value || ""));
+
+export const normalizeUrl = (value) => {
+  const parsed = new URL(value);
+  parsed.hash = "";
+  if (parsed.pathname.length > 1) parsed.pathname = parsed.pathname.replace(/\/+$/, "");
+  return parsed.href;
+};
+
+export const resolveUrl = (href, base) => {
+  if (!href) return null;
+  try {
+    return normalizeUrl(new URL(href, base).href);
+  } catch {
+    return null;
+  }
+};
+
+export const sameOrigin = (a, b) => {
+  try {
+    return new URL(a).origin === new URL(b).origin;
+  } catch {
+    return false;
+  }
+};