@lynxflow/seo-engine 1.8.30 → 2.0.0

package/src/features-knowledge-harvester.ts

@@ -1,190 +0,0 @@
-/**
- * 📚 Features & Documentation Knowledge Harvester (Automated Content Extractor)
- * 
- * Automatically crawls and ingests public documentation, feature pages, and WordPress sitemaps.
- * Extracts structured knowledge chunks:
- * - Module Name, Category & H1 Title
- * - Executive Summaries & Key Paragraphs (up to 15 in-depth paragraphs)
- * - Workflows & Step-by-Step Guides
- * - Key Capabilities & Benefit Bullet Points
- * - Structured FAQs & Objection Handling
- * 
- * Provides instant in-memory retrieval for programmatic page generation with zero manual writing.
- */
-
-export interface ExtractedFeatureKnowledge {
-  slug: string;
-  url: string;
-  title: string;
-  headline?: string;
-  category: string;
-  executiveSummary: string;
-  paragraphs: string[]; // Up to 15 clean thematic paragraphs
-  keyBenefits: string[];
-  workflowSteps: { step: number; title: string; description: string }[];
-  faqs: { question: string; answer: string }[];
-  rawTextLength: number;
-}
-
-export class FeaturesKnowledgeHarvester {
-  private static knowledgeStore: Map<string, ExtractedFeatureKnowledge> = new Map();
-
-  /**
-   * Extract knowledge from raw HTML or Markdown content of a public page
-   */
-  static extractFromHtml(url: string, html: string, slug?: string): ExtractedFeatureKnowledge {
-    const pageSlug = slug || url.split("/").filter(Boolean).pop() || "feature";
-
-    // Extract Title (H1 or <title>)
-    const titleMatch = html.match(/<h1[^>]*>([\s\S]*?)<\/h1>/i) || html.match(/<title[^>]*>([\s\S]*?)<\/title>/i);
-    const title = titleMatch ? titleMatch[1].replace(/<[^>]+>/g, "").trim() : "Module " + pageSlug;
-
-    // Extract Paragraphs (<p>)
-    const paragraphMatches = html.matchAll(/<p[^>]*>([\s\S]*?)<\/p>/gi);
-    const paragraphs: string[] = [];
-    for (const match of paragraphMatches) {
-      const clean = match[1].replace(/<[^>]+>/g, "").replace(/\s+/g, " ").trim();
-      if (clean.length > 40 && !clean.includes("Cookie") && !clean.includes("Copyright")) {
-        paragraphs.push(clean);
-        if (paragraphs.length >= 15) break; // Keep the top 15 rich paragraphs
-      }
-    }
-
-    // Extract List Items (<li>) as Key Benefits
-    const liMatches = html.matchAll(/<li[^>]*>([\s\S]*?)<\/li>/gi);
-    const keyBenefits: string[] = [];
-    for (const match of liMatches) {
-      const clean = match[1].replace(/<[^>]+>/g, "").replace(/\s+/g, " ").trim();
-      if (clean.length > 20 && clean.length < 200) {
-        keyBenefits.push(clean);
-        if (keyBenefits.length >= 8) break;
-      }
-    }
-
-    // Extract FAQs (H3/H4 questions with following text or <details>/<summary>)
-    const faqs: { question: string; answer: string }[] = [];
-    const faqMatches = html.matchAll(/<summary[^>]*>([\s\S]*?)<\/summary>[\s\S]*?<p[^>]*>([\s\S]*?)<\/p>/gi);
-    for (const match of faqMatches) {
-      const question = match[1].replace(/<[^>]+>/g, "").trim();
-      const answer = match[2].replace(/<[^>]+>/g, "").trim();
-      if (question && answer) {
-        faqs.push({ question, answer });
-      }
-    }
-
-    // Default workflow steps if not parsed
-    const workflowSteps = [
-      { step: 1, title: "Configuration Automatique", description: `Activation du module ${title} en 1 clic.` },
-      { step: 2, title: "Résolution en Mémoire Vive", description: "Traitement ultra-rapide sans latence SQL." },
-      { step: 3, title: "Déploiement Continu", description: "Mise à jour en temps réel sur l'ensemble de vos pages." },
-    ];
-
-    const executiveSummary = paragraphs.slice(0, 2).join(" ") || `Module de haute performance ${title} optimisé pour Google et le Search IA.`;
-
-    const knowledge: ExtractedFeatureKnowledge = {
-      slug: pageSlug,
-      url,
-      title,
-      category: "Feature Suite",
-      executiveSummary,
-      paragraphs,
-      keyBenefits,
-      workflowSteps,
-      faqs,
-      rawTextLength: paragraphs.join(" ").length,
-    };
-
-    this.knowledgeStore.set(pageSlug, knowledge);
-    return knowledge;
-  }
-
-  /**
-   * Batch ingest multiple pages from a sitemap or list of URLs
-   */
-  static async ingestPagesFromSitemap(sitemapUrl: string): Promise<number> {
-    try {
-      const res = await fetch(sitemapUrl);
-      if (!res.ok) return 0;
-      const xml = await res.text();
-      const urls = [...xml.matchAll(/<loc>([\s\S]*?)<\/loc>/gi)].map((m) => m[1].trim());
-
-      let count = 0;
-      for (const u of urls.slice(0, 50)) {
-        try {
-          const pageRes = await fetch(u);
-          if (pageRes.ok) {
-            const html = await pageRes.text();
-            this.extractFromHtml(u, html);
-            count++;
-          }
-        } catch {
-          // ignore network timeout
-        }
-      }
-      return count;
-    } catch {
-      return 0;
-    }
-  }
-
-  /**
-   * Retrieve extracted knowledge for any module by slug
-   */
-  static getKnowledge(slug: string): ExtractedFeatureKnowledge | undefined {
-    return this.knowledgeStore.get(slug);
-  }
-
-  /**
-   * Get all registered module knowledge chunks
-   */
-  static getAllKnowledge(): ExtractedFeatureKnowledge[] {
-    return Array.from(this.knowledgeStore.values());
-  }
-
-  /**
-   * Generate an ultra-complete, 1000-word programmatic page using harvested knowledge
-   */
-  static buildEnrichedPage(slug: string, locationOrSector: string): string {
-    const k = this.getKnowledge(slug);
-    if (!k) {
-      return `# Solution ${slug} à ${locationOrSector}\n\nExplications complètes et déploiement immédiat.`;
-    }
-
-    return `
-# ${k.title} à ${locationOrSector} (Guide Complet & Déploiement 2026)
-
-> **Résumé Exécutif :** ${k.executiveSummary}
-
----
-
-## 📖 Analyse Approfondie & Fonctionnement
-
-${k.paragraphs.slice(0, 6).join("\n\n")}
-
----
-
-## 💎 Fonctionnalités Clés & Avantages Concrets :
-
-${k.keyBenefits.map((b) => `* **${b}**`).join("\n")}
-
----
-
-## 🛠️ Guide de Mise en Œuvre en 3 Étapes :
-
-${k.workflowSteps.map((s) => `${s.step}. **${s.title}** : ${s.description}`).join("\n")}
-
----
-
-${k.paragraphs.slice(6, 12).join("\n\n")}
-
----
-
-## ❓ Questions Fréquentes & Réponses Officielles :
-
-${k.faqs.length > 0
-  ? k.faqs.map((f) => `### ${f.question}\n${f.answer}`).join("\n\n")
-  : `### Comment activer ${k.title} à ${locationOrSector} ?\nL'activation est instantanée en 1 clic sans compétences techniques.`
-}
-`.trim();
-  }
-}

package/src/free-public-tools.ts

@@ -1,224 +0,0 @@
-/**
- * 🛠️ Free Public Interactive Tools & Lead Magnets Suite
- * Inspired by Ahrefs, Semrush, Moz, and WordStream free tool ecosystems.
- *
- * Provides 6 zero-dependency interactive calculators and simulators that can be embedded
- * on public programmatic pages to maximize dwell time, engagement, backlink acquisition, and user conversion.
- */
-
-import { cleanSeoSlug } from "./slug-engine";
-import { ExtendedSchemaGraphBuilder } from "./extended-schemas";
-
-export interface SerpSimulatorResult {
-  title: string;
-  truncatedTitle: string;
-  titlePixelWidth: number;
-  isTitleTruncated: boolean;
-  description: string;
-  truncatedDescription: string;
-  isDescriptionTruncated: boolean;
-  urlPreview: string;
-  estimatedCtrScore: number; // 0 to 100
-  recommendations: string[];
-}
-
-export interface RoiCalculatorResult {
-  hoursSavedWeekly: number;
-  hoursSavedMonthly: number;
-  monthlyCostSavings: number;
-  annualCostSavings: number;
-  roiPercentage: number;
-  breakEvenDays: number;
-}
-
-export interface DensityAnalysisResult {
-  totalWords: number;
-  characterCount: number;
-  readingTimeMinutes: number;
-  topKeywords: { word: string; count: number; densityPercent: number }[];
-  seoReadabilityScore: number; // 0 to 100
-}
-
-export class FreePublicToolsEngine {
-  /**
-   * 1. Google SERP Preview & CTR Optimizer Simulator (Ahrefs / Moz Parity)
-   */
-  static simulateSerpSnippet(input: {
-    title: string;
-    description: string;
-    url: string;
-    targetKeyword?: string;
-  }): SerpSimulatorResult {
-    const title = (input.title || "").trim();
-    const description = (input.description || "").trim();
-    const url = (input.url || "https://example.com").trim();
-    const kw = (input.targetKeyword || "").toLowerCase().trim();
-
-    // Average pixel width estimation (approx 10px per char on Arial 20px)
-    const titlePixelWidth = title.length * 9.5;
-    const maxTitlePixels = 580; // Google Desktop breakpoint
-    const maxDescChars = 158;
-
-    const isTitleTruncated = titlePixelWidth > maxTitlePixels;
-    const truncatedTitle = isTitleTruncated ? title.slice(0, 56) + "..." : title;
-
-    const isDescriptionTruncated = description.length > maxDescChars;
-    const truncatedDescription = isDescriptionTruncated ? description.slice(0, 155) + "..." : description;
-
-    let ctrScore = 50;
-    const recommendations: string[] = [];
-
-    // Title checks
-    if (title.length >= 40 && title.length <= 60) {
-      ctrScore += 20;
-    } else if (title.length < 30) {
-      recommendations.push("Le titre est trop court (< 30 car.). Ajoutez des précisions pour booster le clic.");
-    } else if (isTitleTruncated) {
-      ctrScore -= 10;
-      recommendations.push("Le titre dépasse 580px et sera tronqué sur Google Desktop.");
-    }
-
-    // Keyword presence
-    if (kw && title.toLowerCase().includes(kw)) {
-      ctrScore += 15;
-    } else if (kw) {
-      recommendations.push(`Le mot-clé principal "${kw}" est absent du titre.`);
-    }
-
-    // Description checks
-    if (description.length >= 120 && description.length <= 158) {
-      ctrScore += 15;
-    } else if (description.length < 80) {
-      recommendations.push("La méta-description est trop courte (< 80 car.).");
-    }
-
-    return {
-      title,
-      truncatedTitle,
-      titlePixelWidth: Math.round(titlePixelWidth),
-      isTitleTruncated,
-      description,
-      truncatedDescription,
-      isDescriptionTruncated,
-      urlPreview: url,
-      estimatedCtrScore: Math.min(Math.max(ctrScore, 10), 100),
-      recommendations,
-    };
-  }
-
-  /**
-   * 2. Free ROI & Time-Saved Automation Calculator
-   */
-  static calculateRoi(input: {
-    hoursSpentPerWeek: number;
-    hourlyRateOrSalary: number;
-    teamMembersCount?: number;
-    softwareMonthlyPrice?: number;
-  }): RoiCalculatorResult {
-    const hours = Math.max(input.hoursSpentPerWeek || 5, 1);
-    const rate = Math.max(input.hourlyRateOrSalary || 35, 1);
-    const team = Math.max(input.teamMembersCount || 1, 1);
-    const softwareCost = input.softwareMonthlyPrice ?? 49;
-
-    // Assuming automation saves ~75% of manual operational time
-    const hoursSavedWeekly = Math.round(hours * 0.75 * team * 10) / 10;
-    const hoursSavedMonthly = Math.round(hoursSavedWeekly * 4.33);
-
-    const monthlyGrossSavings = hoursSavedMonthly * rate;
-    const monthlyNetSavings = Math.max(monthlyGrossSavings - softwareCost, 0);
-    const annualCostSavings = monthlyNetSavings * 12;
-
-    const roiPercentage = softwareCost > 0 ? Math.round((monthlyNetSavings / softwareCost) * 100) : 1000;
-    const breakEvenDays = monthlyGrossSavings > 0 ? Math.max(Math.round((softwareCost / (monthlyGrossSavings / 30))), 1) : 30;
-
-    return {
-      hoursSavedWeekly,
-      hoursSavedMonthly,
-      monthlyCostSavings: Math.round(monthlyNetSavings),
-      annualCostSavings: Math.round(annualCostSavings),
-      roiPercentage,
-      breakEvenDays,
-    };
-  }
-
-  /**
-   * 3. Instant Keyword Density & Readability Analyzer
-   */
-  static analyzeTextDensity(text: string, language: string = "fr"): DensityAnalysisResult {
-    if (!text || typeof text !== "string") {
-      return { totalWords: 0, characterCount: 0, readingTimeMinutes: 0, topKeywords: [], seoReadabilityScore: 0 };
-    }
-
-    const clean = text.toLowerCase().replace(/[^a-z0-9à-ÿ\s]/g, " ");
-    const words = clean.split(/\s+/).filter((w) => w.length > 2);
-    const totalWords = words.length;
-    const characterCount = text.length;
-    const readingTimeMinutes = Math.max(Math.round((totalWords / 200) * 10) / 10, 0.5);
-
-    const stopWords = new Set(["pour", "dans", "avec", "sur", "les", "des", "une", "que", "qui", "est", "par", "the", "and", "for", "with", "this", "that"]);
-    const frequencyMap = new Map<string, number>();
-
-    for (const w of words) {
-      if (!stopWords.has(w)) {
-        frequencyMap.set(w, (frequencyMap.get(w) || 0) + 1);
-      }
-    }
-
-    const sorted = Array.from(frequencyMap.entries()).sort((a, b) => b[1] - a[1]);
-    const topKeywords = sorted.slice(0, 8).map(([word, count]) => ({
-      word,
-      count,
-      densityPercent: totalWords > 0 ? Math.round((count / totalWords) * 1000) / 10 : 0,
-    }));
-
-    let seoReadabilityScore = 70;
-    if (totalWords >= 600) seoReadabilityScore += 20;
-    else if (totalWords < 300) seoReadabilityScore -= 25;
-
-    return {
-      totalWords,
-      characterCount,
-      readingTimeMinutes,
-      topKeywords,
-      seoReadabilityScore: Math.min(Math.max(seoReadabilityScore, 10), 100),
-    };
-  }
-
-  /**
-   * 4. Free SEO Slug Cleanser Helper
-   */
-  static cleanSlugTool(input: string, lang: string = "fr"): { original: string; cleanSlug: string; charSavings: number } {
-    const clean = cleanSeoSlug(input, { language: lang });
-    return {
-      original: input,
-      cleanSlug: clean,
-      charSavings: Math.max(input.length - clean.length, 0),
-    };
-  }
-
-  /**
-   * 5. Free Schema.org Generator Helper
-   */
-  static generateSampleSchema(type: "localBusiness" | "softwareApp" | "faq", name: string, url: string): Record<string, unknown> {
-    if (type === "localBusiness") {
-      return ExtendedSchemaGraphBuilder.buildLocalBusiness({
-        name,
-        url,
-        city: "Paris",
-        country: "France",
-      });
-    }
-    if (type === "faq") {
-      return ExtendedSchemaGraphBuilder.buildFAQPage([
-        { question: `Comment fonctionne ${name} ?`, answer: `${name} automatise vos opérations en quelques clics.` },
-        { question: `Quel est le tarif de ${name} ?`, answer: `Un essai gratuit de 14 jours est disponible sans carte bancaire.` },
-      ]);
-    }
-    return ExtendedSchemaGraphBuilder.buildSoftwareApplication({
-      name,
-      description: `Solution logicielle professionnelle ${name}`,
-      url,
-      priceMonthly: 29,
-    });
-  }
-}

package/src/geo-mesh-linking.ts

@@ -1,93 +0,0 @@
-/**
- * 🗺️ Geographic Mesh Linking Engine
- *
- * Implements geodesic distance calculation (Haversine formula) and
- * administrative zone clustering to connect neighboring cities and propagate PageRank.
- */
-
-export interface GeoCoordinate {
-  latitude: number;
-  longitude: number;
-}
-
-export interface MeshCity {
-  slug: string;
-  name: string;
-  departmentCode?: string;
-  region?: string;
-  country: string;
-  coordinates?: GeoCoordinate;
-  population?: number;
-}
-
-export class GeoMeshLinkingEngine {
-  /**
-   * Computes the great-circle distance between two points in kilometers (Haversine formula).
-   */
-  static computeDistanceKm(coord1: GeoCoordinate, coord2: GeoCoordinate): number {
-    const R = 6371; // Earth radius in KM
-    const dLat = this.deg2rad(coord2.latitude - coord1.latitude);
-    const dLon = this.deg2rad(coord2.longitude - coord1.longitude);
-
-    const a =
-      Math.sin(dLat / 2) * Math.sin(dLat / 2) +
-      Math.cos(this.deg2rad(coord1.latitude)) *
-        Math.cos(this.deg2rad(coord2.latitude)) *
-        Math.sin(dLon / 2) *
-        Math.sin(dLon / 2);
-
-    const c = 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));
-    return R * c;
-  }
-
-  private static deg2rad(deg: number): number {
-    return deg * (Math.PI / 180);
-  }
-
-  /**
-   * Finds the N closest neighbor cities within the same country / department / distance.
-   */
-  static findClosestNeighbors(
-    targetCity: MeshCity,
-    allCities: MeshCity[],
-    maxNeighbors = 4,
-    maxDistanceKm = 50,
-  ): { city: MeshCity; distanceKm?: number }[] {
-    const candidateCities = allCities.filter(
-      (c) => c.slug !== targetCity.slug && c.country === targetCity.country,
-    );
-
-    // If coordinates are available, calculate exact geodesic proximity
-    if (targetCity.coordinates) {
-      const withDistance = candidateCities
-        .filter((c) => Boolean(c.coordinates))
-        .map((c) => ({
-          city: c,
-          distanceKm: this.computeDistanceKm(targetCity.coordinates!, c.coordinates!),
-        }))
-        .filter((item) => item.distanceKm <= maxDistanceKm)
-        .sort((a, b) => a.distanceKm - b.distanceKm);
-
-      if (withDistance.length > 0) {
-        return withDistance.slice(0, maxNeighbors);
-      }
-    }
-
-    // Fallback: match by same department or region
-    const sameDepartment = candidateCities.filter(
-      (c) =>
-        targetCity.departmentCode &&
-        c.departmentCode === targetCity.departmentCode,
-    );
-
-    if (sameDepartment.length > 0) {
-      return sameDepartment.slice(0, maxNeighbors).map((c) => ({ city: c }));
-    }
-
-    const sameRegion = candidateCities.filter(
-      (c) => targetCity.region && c.region === targetCity.region,
-    );
-
-    return sameRegion.slice(0, maxNeighbors).map((c) => ({ city: c }));
-  }
-}