@lynxflow/seo-engine 1.8.29 → 2.0.0

package/src/rank-math-parity.ts

@@ -1,235 +0,0 @@
-/**
- * 👑 Rank Math Parity & Real-Time Content SEO Score Engine
- *
- * Implements the core features that made Rank Math famous (3M+ installs):
- * 1. Real-Time 0-100 On-Page Content SEO Score (Checklist: Title, Slug, H2, Density, Words, Internal/External links)
- * 2. 301/302/410 Redirection Manager & 404 Error Monitor
- * 3. AI Image Alt Text Generator (Keyword-rich accessibility attributes)
- * 4. Robots.txt Generator & AI Crawlers Rule Validator
- */
-
-export interface OnPageCheckItem {
-  id: string;
-  category: "basic_seo" | "additional_seo" | "title_readability" | "content_readability";
-  label: string;
-  passed: boolean;
-  scoreImpact: number;
-  tip: string;
-}
-
-export interface OnPageSeoScoreResult {
-  score: number; // 0 to 100
-  grade: "poor" | "fair" | "good" | "great"; // < 50 = poor (red), 50-79 = fair (yellow), 80-89 = good (green), 90+ = great (bright green)
-  focusKeyword: string;
-  wordCount: number;
-  keywordDensityPercent: number;
-  checklist: OnPageCheckItem[];
-  criticalFixes: string[];
-}
-
-export interface RedirectRule {
-  id: string;
-  sourcePath: string;
-  destinationUrl: string;
-  statusCode: 301 | 302 | 307 | 410 | 451;
-  isActive: boolean;
-  hitsCount: number;
-  createdAt: string;
-}
-
-export class RankMathParityEngine {
-  /**
-   * 1. Calculates the exact 0-100 Real-Time On-Page Content SEO Score (Rank Math Benchmark).
-   */
-  static calculateOnPageScore(opts: {
-    focusKeyword: string;
-    title: string;
-    description: string;
-    slug: string;
-    htmlOrMarkdownContent: string;
-    imagesCount?: number;
-    hasInternalLinks?: boolean;
-    hasExternalLinks?: boolean;
-  }): OnPageSeoScoreResult {
-    const kw = opts.focusKeyword.trim().toLowerCase();
-    const title = opts.title.toLowerCase();
-    const desc = opts.description.toLowerCase();
-    const slug = opts.slug.toLowerCase();
-    const content = opts.htmlOrMarkdownContent.toLowerCase();
-
-    const plainText = content.replace(/<[^>]+>/g, " ").replace(/[#*`_~]/g, " ");
-    const words = plainText.split(/\s+/).filter((w) => w.length > 1);
-    const wordCount = words.length;
-
-    // Count keyword occurrences
-    const kwRegex = new RegExp(kw.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), "gi");
-    const matches = content.match(kwRegex) || [];
-    const kwCount = matches.length;
-    const density = wordCount > 0 ? parseFloat(((kwCount / wordCount) * 100).toFixed(2)) : 0;
-
-    const checklist: OnPageCheckItem[] = [];
-
-    // --- Basic SEO ---
-    const inTitle = title.includes(kw);
-    checklist.push({
-      id: "kw_in_title",
-      category: "basic_seo",
-      label: `Mot-clé principal dans le titre SEO`,
-      passed: inTitle,
-      scoreImpact: 15,
-      tip: inTitle ? "Titre optimisé !" : `Ajoutez "${opts.focusKeyword}" dans votre balise Titre.`,
-    });
-
-    const inDesc = desc.includes(kw);
-    checklist.push({
-      id: "kw_in_desc",
-      category: "basic_seo",
-      label: `Mot-clé principal dans la Meta Description`,
-      passed: inDesc,
-      scoreImpact: 10,
-      tip: inDesc ? "Meta description optimisée !" : `Mentionnez "${opts.focusKeyword}" dans la description.`,
-    });
-
-    const inSlug = slug.includes(kw.replace(/\s+/g, "-")) || slug.includes(encodeURIComponent(kw));
-    checklist.push({
-      id: "kw_in_slug",
-      category: "basic_seo",
-      label: `Mot-clé principal dans l'URL / Slug`,
-      passed: inSlug,
-      scoreImpact: 10,
-      tip: inSlug ? "Slug court et ciblé !" : `Intégrez "${opts.focusKeyword}" dans l'URL.`,
-    });
-
-    const first10Percent = content.slice(0, Math.max(200, Math.floor(content.length * 0.15)));
-    const inBeginning = first10Percent.includes(kw);
-    checklist.push({
-      id: "kw_in_beginning",
-      category: "basic_seo",
-      label: `Mot-clé au début du contenu (premier paragraphe)`,
-      passed: inBeginning,
-      scoreImpact: 10,
-      tip: inBeginning ? "Accroche immédiate réussie !" : "Introduisez le mot-clé dans les 100 premiers mots.",
-    });
-
-    const wordsPassed = wordCount >= 600;
-    checklist.push({
-      id: "content_length",
-      category: "basic_seo",
-      label: `Longueur du contenu suffisant (min. 600 mots)`,
-      passed: wordsPassed,
-      scoreImpact: 15,
-      tip: wordsPassed ? `${wordCount} mots (Parfait)` : `Votre contenu ne compte que ${wordCount} mots. Visez au moins 600 mots.`,
-    });
-
-    // --- Additional SEO ---
-    const inH2 = content.includes(`## `) || content.includes(`<h2`) || content.includes(`<h3`);
-    checklist.push({
-      id: "kw_in_subheadings",
-      category: "additional_seo",
-      label: `Structure en sous-titres H2/H3 présente`,
-      passed: inH2,
-      scoreImpact: 10,
-      tip: inH2 ? "Hiérarchie H2/H3 bien structurée !" : "Structurez votre page avec des sous-titres H2 et H3.",
-    });
-
-    const densityPassed = density >= 0.5 && density <= 2.5;
-    checklist.push({
-      id: "kw_density",
-      category: "additional_seo",
-      label: `Densité de mot-clé équilibrée (0.5% - 2.5%)`,
-      passed: densityPassed,
-      scoreImpact: 10,
-      tip: densityPassed ? `Densité idéale (${density}%)` : `Densité actuelle : ${density}%. Évitez le bourrage ou le sous-dosage.`,
-    });
-
-    const internalPassed = opts.hasInternalLinks ?? true;
-    checklist.push({
-      id: "has_internal_links",
-      category: "additional_seo",
-      label: `Maillage interne vers d'autres pages du site`,
-      passed: internalPassed,
-      scoreImpact: 10,
-      tip: internalPassed ? "Maillage interne actif !" : "Ajoutez au moins 2 à 3 liens internes.",
-    });
-
-    // --- Title & Content Readability ---
-    const titleLengthPassed = opts.title.length >= 40 && opts.title.length <= 65;
-    checklist.push({
-      id: "title_length",
-      category: "title_readability",
-      label: `Longueur idéale du titre (40-65 caractères)`,
-      passed: titleLengthPassed,
-      scoreImpact: 5,
-      tip: titleLengthPassed ? `${opts.title.length} car. (Taille parfaite)` : `Actuellement ${opts.title.length} car. Visez entre 40 et 65 caractères.`,
-    });
-
-    const hasImages = (opts.imagesCount || 0) > 0 || content.includes("<img") || content.includes("![");
-    checklist.push({
-      id: "has_media",
-      category: "content_readability",
-      label: `Présence d'images avec balises ALT`,
-      passed: hasImages,
-      scoreImpact: 5,
-      tip: hasImages ? "Images et visuels détectés !" : "Ajoutez au moins une image illustrative.",
-    });
-
-    // Calculate score
-    const totalScore = checklist.reduce((acc, item) => acc + (item.passed ? item.scoreImpact : 0), 0);
-    const score = Math.min(100, totalScore);
-
-    let grade: "poor" | "fair" | "good" | "great" = "poor";
-    if (score >= 90) grade = "great";
-    else if (score >= 80) grade = "good";
-    else if (score >= 50) grade = "fair";
-
-    const criticalFixes = checklist.filter((item) => !item.passed).map((item) => item.tip);
-
-    return {
-      score,
-      grade,
-      focusKeyword: opts.focusKeyword,
-      wordCount,
-      keywordDensityPercent: density,
-      checklist,
-      criticalFixes,
-    };
-  }
-
-  /**
-   * 2. Generates SEO-rich Alt text for images based on surrounding context.
-   */
-  static generateImageAltText(imageFilename: string, pageTopic: string, serviceName: string): string {
-    const cleanName = imageFilename
-      .replace(/\.[^/.]+$/, "")
-      .replace(/[-_]/g, " ")
-      .replace(/[^a-zA-Z0-9\s]/g, "");
-
-    return `${serviceName} : illustration de ${cleanName} pour ${pageTopic}`;
-  }
-
-  /**
-   * 3. Generates optimal robots.txt rules including Search Engine & AI bot crawler directives.
-   */
-  static generateRobotsTxt(domain: string, allowAiBots = true): string {
-    const sitemapUrl = `${domain.replace(/\/$/, "")}/sitemap.xml`;
-
-    return [
-      `User-agent: *`,
-      `Allow: /`,
-      `Disallow: /api/`,
-      `Disallow: /admin/`,
-      `Disallow: /checkout/`,
-      ``,
-      `# 🤖 AI Assistants & Answer Engines (ChatGPT, Perplexity, Claude)`,
-      `User-agent: GPTBot`,
-      allowAiBots ? `Allow: /` : `Disallow: /`,
-      `User-agent: PerplexityBot`,
-      allowAiBots ? `Allow: /` : `Disallow: /`,
-      `User-agent: ClaudeBot`,
-      allowAiBots ? `Allow: /` : `Disallow: /`,
-      ``,
-      `# 🗺️ Sitemaps`,
-      `Sitemap: ${sitemapUrl}`,
-    ].join("\n");
-  }
-}

package/src/rate-limited-translator.ts

@@ -1,110 +0,0 @@
-/**
- * 🌐 LynxRateLimitedTranslator (Lightweight SDK Client)
- * 
- * Provides fast, rate-limited translation for the SDK:
- * 1. Uses local in-memory multilingual dictionary (0ms, 0€)
- * 2. Connects to the LynxSEO Backend API for serverless / high-volume translations
- * 3. Supports optional Google Cloud Translation API Key if configured
- */
-
-import { DICTIONARIES } from "./i18n-dictionary";
-
-export interface TranslationClientConfig {
-  apiKey?: string;
-  backendEndpoint?: string; // e.g. https://lynxseo.studio/api/translate
-}
-
-export class LynxRateLimitedTranslator {
-  private static cache: Map<string, string> = new Map();
-
-  /**
-   * Translates an array of strings safely
-   */
-  static async translateBatch(
-    contents: string[],
-    targetLang: string,
-    sourceLang = "en",
-    config: TranslationClientConfig = {}
-  ): Promise<string[]> {
-    if (!contents || contents.length === 0) return [];
-    if (targetLang === sourceLang) return contents;
-
-    const unCachedIndices: number[] = [];
-    const results: string[] = new Array(contents.length);
-
-    contents.forEach((text, i) => {
-      const cacheKey = `${targetLang}:${text.trim()}`;
-      if (this.cache.has(cacheKey)) {
-        results[i] = this.cache.get(cacheKey)!;
-      } else {
-        unCachedIndices.push(i);
-      }
-    });
-
-    if (unCachedIndices.length === 0) {
-      return results;
-    }
-
-    const textsToTranslate = unCachedIndices.map((idx) => contents[idx]);
-    let translatedChunks: string[] = [];
-
-    // If backend endpoint is configured, forward to LynxSEO backend
-    if (config.backendEndpoint) {
-      try {
-        const res = await fetch(`${config.backendEndpoint}/batch`, {
-          method: "POST",
-          headers: { "Content-Type": "application/json" },
-          body: JSON.stringify({ contents: textsToTranslate, targetLang, sourceLang }),
-        });
-        if (res.ok) {
-          const json = await res.json();
-          translatedChunks = json.translations || textsToTranslate;
-        }
-      } catch {
-        translatedChunks = textsToTranslate;
-      }
-    } else if (config.apiKey) {
-      // Direct Google Cloud API v2
-      try {
-        const url = `https://translation.googleapis.com/language/translate/v2?key=${config.apiKey}`;
-        const res = await fetch(url, {
-          method: "POST",
-          headers: { "Content-Type": "application/json" },
-          body: JSON.stringify({ q: textsToTranslate, target: targetLang, source: sourceLang, format: "text" }),
-        });
-        if (res.ok) {
-          const json = await res.json();
-          translatedChunks = json?.data?.translations?.map((t: any) => t.translatedText) || textsToTranslate;
-        }
-      } catch {
-        translatedChunks = textsToTranslate;
-      }
-    } else {
-      // Fallback: Safe rate-limited public gateway
-      translatedChunks = [];
-      for (const text of textsToTranslate) {
-        await new Promise((r) => setTimeout(r, 200));
-        try {
-          const url = `https://translate.googleapis.com/translate_a/single?client=gtx&sl=${sourceLang}&tl=${targetLang}&dt=t&q=${encodeURIComponent(text)}`;
-          const res = await fetch(url);
-          if (res.ok) {
-            const json = await res.json();
-            translatedChunks.push(json?.[0]?.[0]?.[0] || text);
-          } else {
-            translatedChunks.push(text);
-          }
-        } catch {
-          translatedChunks.push(text);
-        }
-      }
-    }
-
-    unCachedIndices.forEach((originalIndex, chunkIndex) => {
-      const translatedText = translatedChunks[chunkIndex] || contents[originalIndex];
-      results[originalIndex] = translatedText;
-      this.cache.set(`${targetLang}:${contents[originalIndex].trim()}`, translatedText);
-    });
-
-    return results;
-  }
-}

package/src/real-reviews-sync.ts

@@ -1,207 +0,0 @@
-/**
- * 🌟 Real Reviews & Star Ratings Ingestion Engine
- *
- * Official Compliance with Google Search Central Review Snippet Guidelines:
- * 1. Requires reviews to be visibly rendered in the DOM (`generateVisibleReviewsHtmlBlock`).
- * 2. Restricts AggregateRating to legitimate non-self-serving entities (Product, SoftwareApplication).
- * 3. Pulls live authentic review records from Google Places API (New), Trustpilot API or DataForSEO.
- */
-
-export interface VerifiedReview {
-  id: string;
-  source: "google_places" | "trustpilot" | "g2" | "producthunt" | "verified_customer";
-  authorName: string;
-  ratingValue: number; // 1 to 5
-  reviewText: string;
-  datePublished: string; // YYYY-MM-DD
-  verifiedPurchase?: boolean;
-}
-
-export interface RealAggregateRating {
-  ratingValue: string; // e.g. "4.8"
-  reviewCount: string; // e.g. "142"
-  bestRating: "5";
-  worstRating: "1";
-  ratingDistribution: {
-    5: number;
-    4: number;
-    3: number;
-    2: number;
-    1: number;
-  };
-  sampleReviews: VerifiedReview[];
-}
-
-export class RealReviewsSyncEngine {
-  /**
-   * 1. Fetches authentic reviews directly from Google Places API (New).
-   * Endpoint: https://places.googleapis.com/v1/places/{PLACE_ID}?fields=rating,userRatingCount,reviews&key={API_KEY}
-   */
-  static async fetchGooglePlacesReviews(opts: {
-    placeId: string;
-    googleApiKey: string;
-    languageCode?: string;
-  }): Promise<{ aggregate: RealAggregateRating | null; reviews: VerifiedReview[] }> {
-    try {
-      const url = `https://places.googleapis.com/v1/places/${encodeURIComponent(opts.placeId)}?fields=rating,userRatingCount,reviews&languageCode=${opts.languageCode || "fr"}&key=${encodeURIComponent(opts.googleApiKey)}`;
-      const res = await fetch(url);
-      if (!res.ok) {
-        throw new Error(`Google Places API returned ${res.status}`);
-      }
-      const data = await res.json() as any;
-
-      const reviews: VerifiedReview[] = (data.reviews || []).map((r: any, idx: number) => ({
-        id: `g_place_${idx}_${r.publishTime || Date.now()}`,
-        source: "google_places",
-        authorName: r.authorAttribution?.displayName || "Utilisateur Google",
-        ratingValue: r.rating || 5,
-        reviewText: r.text?.text || r.originalText?.text || "",
-        datePublished: r.publishTime ? r.publishTime.split("T")[0] : new Date().toISOString().split("T")[0],
-        verifiedPurchase: true,
-      }));
-
-      const ratingVal = data.rating ? Number(data.rating).toFixed(1) : (reviews.length ? (reviews.reduce((a, b) => a + b.ratingValue, 0) / reviews.length).toFixed(1) : "5.0");
-      const reviewCnt = data.userRatingCount ? data.userRatingCount.toString() : reviews.length.toString();
-
-      const aggregate: RealAggregateRating = {
-        ratingValue: ratingVal,
-        reviewCount: reviewCnt,
-        bestRating: "5",
-        worstRating: "1",
-        ratingDistribution: {
-          5: Math.round(Number(reviewCnt) * 0.85),
-          4: Math.round(Number(reviewCnt) * 0.10),
-          3: Math.round(Number(reviewCnt) * 0.03),
-          2: Math.round(Number(reviewCnt) * 0.01),
-          1: Math.round(Number(reviewCnt) * 0.01),
-        },
-        sampleReviews: reviews,
-      };
-
-      return { aggregate, reviews };
-    } catch (err) {
-      console.warn("Could not fetch live Google Places reviews:", err);
-      return { aggregate: null, reviews: [] };
-    }
-  }
-
-  /**
-   * 2. Computes real AggregateRating & distribution from an array of verified reviews.
-   */
-  static computeAggregateFromReviews(reviews: VerifiedReview[]): RealAggregateRating | null {
-    if (!reviews || reviews.length === 0) {
-      return null;
-    }
-
-    const distribution = { 1: 0, 2: 0, 3: 0, 4: 0, 5: 0 };
-    let sum = 0;
-
-    for (const r of reviews) {
-      const rounded = Math.min(5, Math.max(1, Math.round(r.ratingValue))) as 1 | 2 | 3 | 4 | 5;
-      distribution[rounded] = (distribution[rounded] || 0) + 1;
-      sum += r.ratingValue;
-    }
-
-    const avg = (sum / reviews.length).toFixed(1);
-
-    return {
-      ratingValue: avg,
-      reviewCount: reviews.length.toString(),
-      bestRating: "5",
-      worstRating: "1",
-      ratingDistribution: distribution,
-      sampleReviews: reviews.slice(0, 5),
-    };
-  }
-
-  /**
-   * 3. Transforms raw DataForSEO or custom reviews into VerifiedReview format.
-   */
-  static mapGoogleBusinessReviews(rawGoogleReviews: Array<{
-    author_title?: string;
-    rating?: { value?: number };
-    review_text?: string;
-    time_ago?: string;
-    timestamp?: string;
-  }>): VerifiedReview[] {
-    return (rawGoogleReviews || []).map((r, i) => {
-      const date = r.timestamp
-        ? new Date(r.timestamp).toISOString().split("T")[0]
-        : new Date().toISOString().split("T")[0];
-
-      return {
-        id: `g_rev_${i}_${Date.now()}`,
-        source: "google_places",
-        authorName: r.author_title || "Client Vérifié",
-        ratingValue: r.rating?.value || 5,
-        reviewText: r.review_text || "",
-        datePublished: date,
-        verifiedPurchase: true,
-      };
-    });
-  }
-
-  /**
-   * 4. Converts verified reviews into Google Schema.org Review[] JSON-LD objects.
-   */
-  static toSchemaOrgReviews(reviews: VerifiedReview[]): Record<string, unknown>[] {
-    return (reviews || []).map((r) => ({
-      "@type": "Review",
-      author: {
-        "@type": "Person",
-        name: r.authorName,
-      },
-      datePublished: r.datePublished,
-      reviewBody: r.reviewText,
-      reviewRating: {
-        "@type": "Rating",
-        ratingValue: r.ratingValue.toString(),
-        bestRating: "5",
-        worstRating: "1",
-      },
-    }));
-  }
-
-  /**
-   * 5. Generates the mandatory visible HTML review widget for the web page.
-   * Google Strict Requirement: Marked up reviews MUST be visible in the page content.
-   */
-  static generateVisibleReviewsHtmlBlock(opts: {
-    aggregate: RealAggregateRating;
-    productName: string;
-  }): string {
-    const starStr = "★".repeat(Math.round(Number(opts.aggregate.ratingValue))) + "☆".repeat(5 - Math.round(Number(opts.aggregate.ratingValue)));
-
-    const reviewsHtml = opts.aggregate.sampleReviews
-      .map(
-        (r) => `
-        <div class="lynx-review-card" style="border: 1px solid #334155; border-radius: 8px; padding: 16px; margin-bottom: 12px; background: rgba(30, 41, 59, 0.5);">
-          <div style="display: flex; justify-content: space-between; margin-bottom: 8px;">
-            <strong style="color: #f8fafc;">${r.authorName}</strong>
-            <span style="color: #fbbf24;">${"★".repeat(r.ratingValue)}${"☆".repeat(5 - r.ratingValue)}</span>
-          </div>
-          <p style="color: #cbd5e1; font-size: 0.95rem; margin: 0 0 8px 0;">"${r.reviewText}"</p>
-          <small style="color: #64748b;">Avis vérifié (${r.source}) • ${r.datePublished}</small>
-        </div>`
-      )
-      .join("");
-
-    return `
-      <section class="lynx-verified-reviews-section" style="margin: 32px 0;">
-        <div style="display: flex; align-items: center; gap: 16px; margin-bottom: 24px;">
-          <div>
-            <span style="font-size: 2.25rem; font-weight: 800; color: #f8fafc;">${opts.aggregate.ratingValue}</span>
-            <span style="color: #64748b; font-size: 1.1rem;"> / 5</span>
-          </div>
-          <div>
-            <div style="color: #fbbf24; font-size: 1.25rem;">${starStr}</div>
-            <p style="margin: 0; color: #94a3b8; font-size: 0.875rem;">Basé sur ${opts.aggregate.reviewCount} avis vérifiés pour ${opts.productName}</p>
-          </div>
-        </div>
-        <div class="lynx-reviews-list">
-          ${reviewsHtml}
-        </div>
-      </section>
-    `;
-  }
-}

package/src/rss-syndication-feed.ts

@@ -1,56 +0,0 @@
-/**
- * 📰 RSS 2.0 & Atom Syndication Feed Generator (Inspiration: pages-seo/feed.xml.js)
- *
- * Automatically generates standards-compliant RSS 2.0 and Atom feeds for published
- * programmatic landing pages and articles to accelerate syndication and indexing.
- */
-
-export interface FeedItem {
-  title: string;
-  url: string;
-  description: string;
-  publishedAt: string; // ISO date
-  author?: string;
-  category?: string;
-}
-
-export class RssSyndicationFeedGenerator {
-  /**
-   * Generates a valid RSS 2.0 XML string.
-   */
-  static generateRss2(opts: {
-    siteTitle: string;
-    siteUrl: string;
-    description: string;
-    items: FeedItem[];
-  }): string {
-    const itemsXml = opts.items
-      .map(
-        (item) => `
-    <item>
-      <title><![CDATA[${item.title}]]></title>
-      <link>${item.url}</link>
-      <guid isPermaLink="true">${item.url}</guid>
-      <description><![CDATA[${item.description}]]></description>
-      <pubDate>${new Date(item.publishedAt).toUTCString()}</pubDate>
-      ${item.category ? `<category>${item.category}</category>` : ""}
-      ${item.author ? `<author>${item.author}</author>` : ""}
-    </item>
-    `.trim(),
-      )
-      .join("\n");
-
-    return `<?xml version="1.0" encoding="UTF-8"?>
-<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
-  <channel>
-    <title><![CDATA[${opts.siteTitle}]]></title>
-    <link>${opts.siteUrl}</link>
-    <description><![CDATA[${opts.description}]]></description>
-    <atom:link href="${opts.siteUrl}/feed.xml" rel="self" type="application/rss+xml" />
-    <language>fr</language>
-    <lastBuildDate>${new Date().toUTCString()}</lastBuildDate>
-${itemsXml}
-  </channel>
-</rss>`.trim();
-  }
-}