@lynxflow/seo-engine 1.8.27 → 1.8.29

package/src/engine.test.ts

@@ -91,6 +91,52 @@ describe("Extended Schema.org Builder", () => {
     expect(schema["@type"]).toBe("Organization");
     expect(schema.sameAs).toContain("https://wikidata.org/wiki/Q123");
   });
+
+  it("Builds complete Speakable schema for voice search & assistant", () => {
+    const speakable = ExtendedSchemaGraphBuilder.buildSpeakable({
+      cssSelectors: [".headline", ".direct-answer"],
+    });
+    expect(speakable["@type"]).toBe("SpeakableSpecification");
+    expect(speakable.cssSelector).toEqual([".headline", ".direct-answer"]);
+  });
+
+  it("Builds complete PodcastEpisode and Restaurant schemas", () => {
+    const podcast = ExtendedSchemaGraphBuilder.buildPodcastEpisode({
+      title: "SEO Trends 2026",
+      description: "Deep dive into GEO",
+      audioUrl: "https://example.com/ep1.mp3",
+      publishedDate: "2026-08-28",
+      seriesName: "LynxCast",
+    });
+    expect(podcast["@type"]).toBe("PodcastEpisode");
+    expect(podcast.name).toBe("SEO Trends 2026");
+
+    const restaurant = ExtendedSchemaGraphBuilder.buildRestaurant({
+      name: "Le Gourmet",
+      url: "https://legourmet.fr",
+      servesCuisine: ["French", "Mediterranean"],
+      address: { street: "12 Rue de Paris", city: "Paris", postalCode: "75001", country: "FR" },
+    });
+    expect(restaurant["@type"]).toBe("Restaurant");
+    expect(restaurant.servesCuisine).toContain("French");
+  });
+
+  it("Builds Book, Dataset, FactCheck, Carousel, and QAPage schemas", () => {
+    const book = ExtendedSchemaGraphBuilder.buildBook({ name: "SEO in 2026", author: "LynxFlow" });
+    expect(book["@type"]).toBe("Book");
+
+    const dataset = ExtendedSchemaGraphBuilder.buildDataset({ name: "Search Data", description: "Keywords dataset", url: "https://data.com", keywords: ["seo", "ai"] });
+    expect(dataset["@type"]).toBe("Dataset");
+
+    const factCheck = ExtendedSchemaGraphBuilder.buildFactCheck({ claimReviewed: "AI replaces search", ratingValue: "4", authorName: "LynxFact", url: "https://fact.com" });
+    expect(factCheck["@type"]).toBe("ClaimReview");
+
+    const carousel = ExtendedSchemaGraphBuilder.buildCarousel([{ name: "Item 1", url: "https://item1.com", position: 1 }]);
+    expect(carousel["@type"]).toBe("ItemList");
+
+    const qa = ExtendedSchemaGraphBuilder.buildQAPage({ questionText: "How to rank #1?", authorName: "User1", answerText: "Use LynxSEO.", answerAuthor: "LynxBot" });
+    expect(qa["@type"]).toBe("QAPage");
+  });
 });
 
 describe("Master Programmatic Matrix Engine (English Default)", () => {

package/src/extended-schemas.ts

@@ -378,4 +378,212 @@ export class ExtendedSchemaGraphBuilder {
         : undefined,
     };
   }
+
+  /**
+   * 11. Speakable Schema (Google Assistant & Voice Search) - Rank Math Pro Parity
+   */
+  static buildSpeakable(opts: {
+    cssSelectors?: string[];
+    xpaths?: string[];
+  }): Record<string, unknown> {
+    return {
+      "@type": "SpeakableSpecification",
+      cssSelector: opts.cssSelectors || [".headline", ".summary", ".direct-answer", "article h1", "article p:first-of-type"],
+      xpath: opts.xpaths,
+    };
+  }
+
+  /**
+   * 12. Podcast & PodcastEpisode Schema
+   */
+  static buildPodcastEpisode(opts: {
+    title: string;
+    description: string;
+    audioUrl: string;
+    duration?: string;
+    publishedDate: string;
+    seriesName: string;
+  }): Record<string, unknown> {
+    return {
+      "@context": "https://schema.org",
+      "@type": "PodcastEpisode",
+      name: opts.title,
+      description: opts.description,
+      datePublished: opts.publishedDate,
+      timeRequired: opts.duration || "PT15M",
+      associatedMedia: {
+        "@type": "AudioObject",
+        contentUrl: opts.audioUrl,
+      },
+      partOfSeries: {
+        "@type": "PodcastSeries",
+        name: opts.seriesName,
+      },
+    };
+  }
+
+  /**
+   * 13. Restaurant Schema (with Menu & Cuisine)
+   */
+  static buildRestaurant(opts: {
+    name: string;
+    url: string;
+    servesCuisine: string[];
+    menuUrl?: string;
+    priceRange?: string;
+    telephone?: string;
+    address: { street: string; city: string; postalCode: string; country: string };
+  }): Record<string, unknown> {
+    return {
+      "@context": "https://schema.org",
+      "@type": "Restaurant",
+      name: opts.name,
+      url: opts.url,
+      servesCuisine: opts.servesCuisine,
+      hasMenu: opts.menuUrl,
+      priceRange: opts.priceRange || "€€",
+      telephone: opts.telephone,
+      address: {
+        "@type": "PostalAddress",
+        streetAddress: opts.address.street,
+        addressLocality: opts.address.city,
+        postalCode: opts.address.postalCode,
+        addressCountry: opts.address.country,
+      },
+    };
+  }
+
+  /**
+   * 14. Book Schema
+   */
+  static buildBook(opts: {
+    name: string;
+    author: string;
+    isbn?: string;
+    bookFormat?: string;
+    url?: string;
+  }): Record<string, unknown> {
+    return {
+      "@context": "https://schema.org",
+      "@type": "Book",
+      name: opts.name,
+      author: {
+        "@type": "Person",
+        name: opts.author,
+      },
+      isbn: opts.isbn,
+      bookFormat: opts.bookFormat || "https://schema.org/EBook",
+      url: opts.url,
+    };
+  }
+
+  /**
+   * 15. Dataset Schema (Data Search & Research)
+   */
+  static buildDataset(opts: {
+    name: string;
+    description: string;
+    url: string;
+    keywords: string[];
+    temporalCoverage?: string;
+    distributionUrl?: string;
+  }): Record<string, unknown> {
+    return {
+      "@context": "https://schema.org",
+      "@type": "Dataset",
+      name: opts.name,
+      description: opts.description,
+      url: opts.url,
+      keywords: opts.keywords,
+      temporalCoverage: opts.temporalCoverage || "2024/2026",
+      distribution: opts.distributionUrl
+        ? [
+            {
+              "@type": "DataDownload",
+              encodingFormat: "application/json",
+              contentUrl: opts.distributionUrl,
+            },
+          ]
+        : undefined,
+    };
+  }
+
+  /**
+   * 16. FactCheck Schema (Google ClaimReview)
+   */
+  static buildFactCheck(opts: {
+    claimReviewed: string;
+    ratingValue: string;
+    authorName: string;
+    url: string;
+  }): Record<string, unknown> {
+    return {
+      "@context": "https://schema.org",
+      "@type": "ClaimReview",
+      claimReviewed: opts.claimReviewed,
+      url: opts.url,
+      reviewRating: {
+        "@type": "Rating",
+        ratingValue: opts.ratingValue,
+        bestRating: "5",
+        worstRating: "1",
+      },
+      author: {
+        "@type": "Organization",
+        name: opts.authorName,
+      },
+    };
+  }
+
+  /**
+   * 17. Carousel / ItemList Schema
+   */
+  static buildCarousel(items: Array<{ name: string; url: string; position: number; image?: string }>): Record<string, unknown> {
+    return {
+      "@context": "https://schema.org",
+      "@type": "ItemList",
+      itemListElement: items.map((item) => ({
+        "@type": "ListItem",
+        position: item.position,
+        url: item.url,
+        name: item.name,
+        image: item.image,
+      })),
+    };
+  }
+
+  /**
+   * 18. QAPage Schema (bbPress / Forums / Community QA)
+   */
+  static buildQAPage(opts: {
+    questionText: string;
+    authorName: string;
+    answerText: string;
+    answerAuthor: string;
+    upvoteCount?: number;
+  }): Record<string, unknown> {
+    return {
+      "@context": "https://schema.org",
+      "@type": "QAPage",
+      mainEntity: {
+        "@type": "Question",
+        name: opts.questionText,
+        text: opts.questionText,
+        author: {
+          "@type": "Person",
+          name: opts.authorName,
+        },
+        answerCount: 1,
+        acceptedAnswer: {
+          "@type": "Answer",
+          text: opts.answerText,
+          upvoteCount: opts.upvoteCount ?? 12,
+          author: {
+            "@type": "Person",
+            name: opts.answerAuthor,
+          },
+        },
+      },
+    };
+  }
 }