@rankcli/agent-runtime 0.0.8 → 0.0.9

package/dist/index.mjs

@@ -27961,6 +27961,588 @@ async function applyFixes(fixes, options) {
   return { applied, skipped };
 }
 
+// src/fixer/schemas.ts
+function generateOrganizationSchema(data) {
+  return {
+    "@context": "https://schema.org",
+    "@type": "Organization",
+    name: data.name,
+    url: data.url,
+    logo: data.logo,
+    description: data.description,
+    foundingDate: data.foundingDate,
+    founder: data.founders?.map((f) => ({
+      "@type": "Person",
+      name: f.name,
+      url: f.url
+    })),
+    address: data.address ? {
+      "@type": "PostalAddress",
+      streetAddress: data.address.streetAddress,
+      addressLocality: data.address.addressLocality,
+      addressRegion: data.address.addressRegion,
+      postalCode: data.address.postalCode,
+      addressCountry: data.address.addressCountry
+    } : void 0,
+    contactPoint: data.contactPoint?.map((cp) => ({
+      "@type": "ContactPoint",
+      telephone: cp.telephone,
+      contactType: cp.contactType,
+      availableLanguage: cp.availableLanguage,
+      areaServed: cp.areaServed
+    })),
+    sameAs: data.sameAs
+  };
+}
+function generateWebSiteSchema(data) {
+  return {
+    "@context": "https://schema.org",
+    "@type": "WebSite",
+    name: data.name,
+    url: data.url,
+    description: data.description,
+    publisher: data.publisher ? {
+      "@type": "Organization",
+      name: data.publisher
+    } : void 0,
+    potentialAction: data.potentialAction ? {
+      "@type": "SearchAction",
+      target: {
+        "@type": "EntryPoint",
+        urlTemplate: data.potentialAction.target
+      },
+      "query-input": data.potentialAction.queryInput
+    } : void 0
+  };
+}
+function generateArticleSchema(data) {
+  const authors = Array.isArray(data.author) ? data.author : [data.author];
+  return {
+    "@context": "https://schema.org",
+    "@type": "Article",
+    headline: data.headline,
+    description: data.description,
+    image: data.image,
+    datePublished: data.datePublished,
+    dateModified: data.dateModified || data.datePublished,
+    author: authors.map((a) => ({
+      "@type": "Person",
+      name: a.name,
+      url: a.url,
+      image: a.image,
+      jobTitle: a.jobTitle,
+      sameAs: a.sameAs
+    })),
+    publisher: {
+      "@type": "Organization",
+      name: data.publisher.name,
+      logo: {
+        "@type": "ImageObject",
+        url: data.publisher.logo
+      }
+    },
+    mainEntityOfPage: data.mainEntityOfPage ? {
+      "@type": "WebPage",
+      "@id": data.mainEntityOfPage
+    } : void 0,
+    wordCount: data.wordCount,
+    articleSection: data.articleSection,
+    keywords: data.keywords?.join(", ")
+  };
+}
+function generateBlogPostingSchema(data) {
+  const schema = generateArticleSchema(data);
+  return { ...schema, "@type": "BlogPosting" };
+}
+function generateNewsArticleSchema(data) {
+  const schema = generateArticleSchema(data);
+  return { ...schema, "@type": "NewsArticle", dateline: data.dateline };
+}
+function generateProductSchema(data) {
+  const offers = Array.isArray(data.offers) ? data.offers : [data.offers];
+  return {
+    "@context": "https://schema.org",
+    "@type": "Product",
+    name: data.name,
+    description: data.description,
+    image: data.image,
+    sku: data.sku,
+    mpn: data.mpn,
+    gtin: data.gtin,
+    brand: data.brand ? {
+      "@type": "Brand",
+      name: data.brand
+    } : void 0,
+    category: data.category,
+    offers: offers.map((o) => ({
+      "@type": "Offer",
+      price: o.price,
+      priceCurrency: o.priceCurrency || "USD",
+      availability: `https://schema.org/${o.availability || "InStock"}`,
+      priceValidUntil: o.priceValidUntil,
+      url: o.url,
+      seller: o.seller ? {
+        "@type": "Organization",
+        name: o.seller
+      } : void 0,
+      itemCondition: o.itemCondition ? `https://schema.org/${o.itemCondition}` : void 0
+    })),
+    aggregateRating: data.aggregateRating ? {
+      "@type": "AggregateRating",
+      ratingValue: data.aggregateRating.ratingValue,
+      reviewCount: data.aggregateRating.reviewCount,
+      ratingCount: data.aggregateRating.ratingCount,
+      bestRating: data.aggregateRating.bestRating || 5,
+      worstRating: data.aggregateRating.worstRating || 1
+    } : void 0,
+    review: data.review?.map((r) => ({
+      "@type": "Review",
+      author: {
+        "@type": "Person",
+        name: r.author
+      },
+      datePublished: r.datePublished,
+      reviewBody: r.reviewBody,
+      reviewRating: {
+        "@type": "Rating",
+        ratingValue: r.reviewRating.ratingValue,
+        bestRating: r.reviewRating.bestRating || 5
+      }
+    }))
+  };
+}
+function generateSoftwareApplicationSchema(data) {
+  const offers = Array.isArray(data.offers) ? data.offers : [data.offers];
+  return {
+    "@context": "https://schema.org",
+    "@type": "SoftwareApplication",
+    name: data.name,
+    description: data.description,
+    applicationCategory: data.applicationCategory,
+    operatingSystem: data.operatingSystem || "Web",
+    offers: offers.map((o) => ({
+      "@type": "Offer",
+      price: o.price,
+      priceCurrency: o.priceCurrency || "USD"
+    })),
+    aggregateRating: data.aggregateRating ? {
+      "@type": "AggregateRating",
+      ratingValue: data.aggregateRating.ratingValue,
+      reviewCount: data.aggregateRating.reviewCount,
+      bestRating: data.aggregateRating.bestRating || 5
+    } : void 0,
+    screenshot: data.screenshot,
+    featureList: data.featureList
+  };
+}
+function generateFAQSchema(data) {
+  return {
+    "@context": "https://schema.org",
+    "@type": "FAQPage",
+    mainEntity: data.questions.map((q) => ({
+      "@type": "Question",
+      name: q.question,
+      acceptedAnswer: {
+        "@type": "Answer",
+        text: q.answer
+      }
+    }))
+  };
+}
+function generateHowToSchema(data) {
+  return {
+    "@context": "https://schema.org",
+    "@type": "HowTo",
+    name: data.name,
+    description: data.description,
+    image: data.image,
+    totalTime: data.totalTime,
+    estimatedCost: data.estimatedCost ? {
+      "@type": "MonetaryAmount",
+      currency: data.estimatedCost.currency,
+      value: data.estimatedCost.value
+    } : void 0,
+    supply: data.supply?.map((s) => ({
+      "@type": "HowToSupply",
+      name: s
+    })),
+    tool: data.tool?.map((t) => ({
+      "@type": "HowToTool",
+      name: t
+    })),
+    step: data.steps.map((step, i) => ({
+      "@type": "HowToStep",
+      position: i + 1,
+      name: step.name,
+      text: step.text,
+      image: step.image,
+      url: step.url
+    }))
+  };
+}
+function generateVideoSchema(data) {
+  const stats = data.interactionStatistic;
+  return {
+    "@context": "https://schema.org",
+    "@type": "VideoObject",
+    name: data.name,
+    description: data.description,
+    thumbnailUrl: data.thumbnailUrl,
+    uploadDate: data.uploadDate,
+    duration: data.duration,
+    contentUrl: data.contentUrl,
+    embedUrl: data.embedUrl,
+    interactionStatistic: stats ? [
+      stats.watchCount ? {
+        "@type": "InteractionCounter",
+        interactionType: { "@type": "WatchAction" },
+        userInteractionCount: stats.watchCount
+      } : null,
+      stats.likeCount ? {
+        "@type": "InteractionCounter",
+        interactionType: { "@type": "LikeAction" },
+        userInteractionCount: stats.likeCount
+      } : null,
+      stats.commentCount ? {
+        "@type": "InteractionCounter",
+        interactionType: { "@type": "CommentAction" },
+        userInteractionCount: stats.commentCount
+      } : null
+    ].filter(Boolean) : void 0,
+    publication: data.publication ? {
+      "@type": "BroadcastEvent",
+      isLiveBroadcast: data.publication.isLiveBroadcast,
+      startDate: data.publication.startDate,
+      endDate: data.publication.endDate
+    } : void 0
+  };
+}
+function generateEventSchema(data) {
+  return {
+    "@context": "https://schema.org",
+    "@type": "Event",
+    name: data.name,
+    description: data.description,
+    startDate: data.startDate,
+    endDate: data.endDate,
+    image: data.image,
+    eventStatus: data.eventStatus ? `https://schema.org/${data.eventStatus}` : void 0,
+    eventAttendanceMode: data.eventAttendanceMode ? `https://schema.org/${data.eventAttendanceMode}` : void 0,
+    location: data.location.type === "VirtualLocation" ? {
+      "@type": "VirtualLocation",
+      url: data.location.url
+    } : {
+      "@type": "Place",
+      name: data.location.name,
+      address: data.location.address ? {
+        "@type": "PostalAddress",
+        ...data.location.address
+      } : void 0
+    },
+    performer: data.performer?.map((p) => ({
+      "@type": "Person",
+      name: p.name,
+      url: p.url
+    })),
+    organizer: data.organizer ? {
+      "@type": "Organization",
+      name: data.organizer.name,
+      url: data.organizer.url
+    } : void 0,
+    offers: data.offers?.map((o) => ({
+      "@type": "Offer",
+      price: o.price,
+      priceCurrency: o.priceCurrency || "USD",
+      availability: `https://schema.org/${o.availability || "InStock"}`,
+      url: o.url,
+      validFrom: o.priceValidUntil
+    }))
+  };
+}
+function generateLocalBusinessSchema(data) {
+  return {
+    "@context": "https://schema.org",
+    "@type": "LocalBusiness",
+    name: data.name,
+    description: data.description,
+    url: data.url,
+    telephone: data.telephone,
+    image: data.image,
+    priceRange: data.priceRange,
+    servesCuisine: data.servesCuisine,
+    menu: data.menu,
+    address: {
+      "@type": "PostalAddress",
+      streetAddress: data.address.streetAddress,
+      addressLocality: data.address.addressLocality,
+      addressRegion: data.address.addressRegion,
+      postalCode: data.address.postalCode,
+      addressCountry: data.address.addressCountry
+    },
+    geo: data.geo ? {
+      "@type": "GeoCoordinates",
+      latitude: data.geo.latitude,
+      longitude: data.geo.longitude
+    } : void 0,
+    openingHoursSpecification: data.openingHours?.map(parseOpeningHours).filter(Boolean),
+    aggregateRating: data.aggregateRating ? {
+      "@type": "AggregateRating",
+      ratingValue: data.aggregateRating.ratingValue,
+      reviewCount: data.aggregateRating.reviewCount,
+      bestRating: data.aggregateRating.bestRating || 5
+    } : void 0,
+    review: data.review?.map((r) => ({
+      "@type": "Review",
+      author: { "@type": "Person", name: r.author },
+      datePublished: r.datePublished,
+      reviewBody: r.reviewBody,
+      reviewRating: {
+        "@type": "Rating",
+        ratingValue: r.reviewRating.ratingValue
+      }
+    }))
+  };
+}
+function parseOpeningHours(hours) {
+  const match = hours.match(/^([A-Za-z,-]+)\s+(\d{2}:\d{2})-(\d{2}:\d{2})$/);
+  if (!match) return null;
+  const dayMap = {
+    "Mo": "Monday",
+    "Tu": "Tuesday",
+    "We": "Wednesday",
+    "Th": "Thursday",
+    "Fr": "Friday",
+    "Sa": "Saturday",
+    "Su": "Sunday"
+  };
+  const dayPart = match[1];
+  const opens = match[2];
+  const closes = match[3];
+  if (dayPart.includes("-")) {
+    const [start, end] = dayPart.split("-");
+    const days = ["Mo", "Tu", "We", "Th", "Fr", "Sa", "Su"];
+    const startIdx = days.indexOf(start);
+    const endIdx = days.indexOf(end);
+    const dayOfWeek = days.slice(startIdx, endIdx + 1).map((d) => dayMap[d]);
+    return { "@type": "OpeningHoursSpecification", dayOfWeek, opens, closes };
+  }
+  return {
+    "@type": "OpeningHoursSpecification",
+    dayOfWeek: dayPart.split(",").map((d) => dayMap[d.trim()]),
+    opens,
+    closes
+  };
+}
+function generateBreadcrumbSchema(data) {
+  return {
+    "@context": "https://schema.org",
+    "@type": "BreadcrumbList",
+    itemListElement: data.items.map((item, index) => ({
+      "@type": "ListItem",
+      position: index + 1,
+      name: item.name,
+      item: item.url
+    }))
+  };
+}
+function generateJobPostingSchema(data) {
+  return {
+    "@context": "https://schema.org",
+    "@type": "JobPosting",
+    title: data.title,
+    description: data.description,
+    datePosted: data.datePosted,
+    validThrough: data.validThrough,
+    employmentType: data.employmentType,
+    hiringOrganization: {
+      "@type": "Organization",
+      name: data.hiringOrganization.name,
+      sameAs: data.hiringOrganization.url,
+      logo: data.hiringOrganization.logo
+    },
+    jobLocation: data.jobLocation ? {
+      "@type": "Place",
+      address: {
+        "@type": "PostalAddress",
+        ...data.jobLocation.address
+      }
+    } : void 0,
+    jobLocationType: data.jobLocationType,
+    baseSalary: data.baseSalary ? {
+      "@type": "MonetaryAmount",
+      currency: data.baseSalary.currency,
+      value: typeof data.baseSalary.value === "number" ? {
+        "@type": "QuantitativeValue",
+        value: data.baseSalary.value,
+        unitText: data.baseSalary.unitText
+      } : {
+        "@type": "QuantitativeValue",
+        minValue: data.baseSalary.value.minValue,
+        maxValue: data.baseSalary.value.maxValue,
+        unitText: data.baseSalary.unitText
+      }
+    } : void 0,
+    experienceRequirements: data.experienceRequirements,
+    educationRequirements: data.educationRequirements ? {
+      "@type": "EducationalOccupationalCredential",
+      credentialCategory: data.educationRequirements
+    } : void 0,
+    skills: data.skills
+  };
+}
+function generateCourseSchema(data) {
+  return {
+    "@context": "https://schema.org",
+    "@type": "Course",
+    name: data.name,
+    description: data.description,
+    provider: {
+      "@type": "Organization",
+      name: data.provider.name,
+      sameAs: data.provider.url
+    },
+    offers: data.offers ? {
+      "@type": "Offer",
+      price: data.offers.price,
+      priceCurrency: data.offers.priceCurrency || "USD",
+      availability: `https://schema.org/${data.offers.availability || "InStock"}`
+    } : void 0,
+    coursePrerequisites: data.coursePrerequisites,
+    educationalLevel: data.educationalLevel,
+    timeRequired: data.timeRequired,
+    image: data.image,
+    aggregateRating: data.aggregateRating ? {
+      "@type": "AggregateRating",
+      ratingValue: data.aggregateRating.ratingValue,
+      reviewCount: data.aggregateRating.reviewCount
+    } : void 0
+  };
+}
+function generateRecipeSchema(data) {
+  return {
+    "@context": "https://schema.org",
+    "@type": "Recipe",
+    name: data.name,
+    description: data.description,
+    image: data.image,
+    author: {
+      "@type": "Person",
+      name: data.author.name,
+      url: data.author.url
+    },
+    datePublished: data.datePublished,
+    prepTime: data.prepTime,
+    cookTime: data.cookTime,
+    totalTime: data.totalTime,
+    recipeYield: data.recipeYield,
+    recipeCategory: data.recipeCategory,
+    recipeCuisine: data.recipeCuisine,
+    recipeIngredient: data.recipeIngredient,
+    recipeInstructions: data.recipeInstructions.map((step, i) => ({
+      "@type": "HowToStep",
+      position: i + 1,
+      name: step.name,
+      text: step.text
+    })),
+    nutrition: data.nutrition ? {
+      "@type": "NutritionInformation",
+      calories: data.nutrition.calories,
+      fatContent: data.nutrition.fatContent,
+      proteinContent: data.nutrition.proteinContent,
+      carbohydrateContent: data.nutrition.carbohydrateContent
+    } : void 0,
+    aggregateRating: data.aggregateRating ? {
+      "@type": "AggregateRating",
+      ratingValue: data.aggregateRating.ratingValue,
+      reviewCount: data.aggregateRating.reviewCount
+    } : void 0,
+    video: data.video ? generateVideoSchema(data.video) : void 0
+  };
+}
+function generateBookSchema(data) {
+  const authors = Array.isArray(data.author) ? data.author : [data.author];
+  return {
+    "@context": "https://schema.org",
+    "@type": "Book",
+    name: data.name,
+    description: data.description,
+    author: authors.map((a) => ({
+      "@type": "Person",
+      name: a.name,
+      url: a.url
+    })),
+    isbn: data.isbn,
+    numberOfPages: data.numberOfPages,
+    bookFormat: data.bookFormat ? `https://schema.org/${data.bookFormat}` : void 0,
+    publisher: data.publisher ? {
+      "@type": "Organization",
+      name: data.publisher
+    } : void 0,
+    datePublished: data.datePublished,
+    image: data.image,
+    inLanguage: data.inLanguage,
+    aggregateRating: data.aggregateRating ? {
+      "@type": "AggregateRating",
+      ratingValue: data.aggregateRating.ratingValue,
+      reviewCount: data.aggregateRating.reviewCount
+    } : void 0,
+    offers: data.offers ? {
+      "@type": "Offer",
+      price: data.offers.price,
+      priceCurrency: data.offers.priceCurrency || "USD",
+      availability: `https://schema.org/${data.offers.availability || "InStock"}`
+    } : void 0
+  };
+}
+function generateSpeakableSchema(data) {
+  return {
+    "@context": "https://schema.org",
+    "@type": "WebPage",
+    speakable: {
+      "@type": "SpeakableSpecification",
+      cssSelector: data.cssSelector,
+      xpath: data.xpath
+    },
+    url: data.url
+  };
+}
+function generateSitelinksSearchboxSchema(data) {
+  return {
+    "@context": "https://schema.org",
+    "@type": "WebSite",
+    url: data.url,
+    potentialAction: {
+      "@type": "SearchAction",
+      target: {
+        "@type": "EntryPoint",
+        urlTemplate: data.searchUrl
+      },
+      "query-input": data.queryInput || "required name=search_term_string"
+    }
+  };
+}
+var Schemas = {
+  organization: generateOrganizationSchema,
+  webSite: generateWebSiteSchema,
+  article: generateArticleSchema,
+  blogPosting: generateBlogPostingSchema,
+  newsArticle: generateNewsArticleSchema,
+  product: generateProductSchema,
+  softwareApplication: generateSoftwareApplicationSchema,
+  faq: generateFAQSchema,
+  howTo: generateHowToSchema,
+  video: generateVideoSchema,
+  event: generateEventSchema,
+  localBusiness: generateLocalBusinessSchema,
+  breadcrumb: generateBreadcrumbSchema,
+  jobPosting: generateJobPostingSchema,
+  course: generateCourseSchema,
+  recipe: generateRecipeSchema,
+  book: generateBookSchema,
+  speakable: generateSpeakableSchema,
+  sitelinksSearchbox: generateSitelinksSearchboxSchema
+};
+
 // src/git/commit-helper.ts
 import { execSync, exec as exec2 } from "child_process";
 import { promisify as promisify2 } from "util";
@@ -29598,7 +30180,7 @@ function generateKeyFacts(facts, options = {}) {
       return formatted.join("\n");
   }
 }
-function generateFAQSchema(faqs, options = {}) {
+function generateFAQSchema2(faqs, options = {}) {
   const format = options.format || "json-ld";
   if (format === "markdown") {
     const lines = ["## FAQ", ""];
@@ -29681,7 +30263,7 @@ function generateAICitableContent(config) {
     sections.push("");
   }
   if (config.faqs && config.faqs.length > 0) {
-    sections.push(generateFAQSchema(config.faqs, { format: "markdown" }));
+    sections.push(generateFAQSchema2(config.faqs, { format: "markdown" }));
     sections.push("");
   }
   return sections.join("\n").trim();
@@ -30522,6 +31104,7 @@ export {
   PRIORITY_WEIGHTS,
   SEO_SCOPES,
   SITE_PROFILE_QUESTIONS,
+  Schemas,
   addTrackingResult,
   analyzeAnchorText,
   analyzeCanonicalAdvanced,
@@ -30667,7 +31250,7 @@ export {
   generateComparisonTable,
   generateCompleteSocialMetaSetup,
   generateDuplicateIssues,
-  generateFAQSchema,
+  generateFAQSchema2 as generateFAQSchema,
   generateFixes,
   generateGA4EnvTemplate,
   generateGA4ReactComponent,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rankcli/agent-runtime",
-  "version": "0.0.8",
+  "version": "0.0.9",
   "description": "RankCLI agent runtime - executes SEO audits and fixes with AI",
   "homepage": "https://rankcli.dev",
   "main": "dist/index.js",

package/src/fixer/index.ts

@@ -3,3 +3,4 @@
  */
 
 export * from './framework-fixes.js';
+export * from './schemas.js';