@lynxflow/seo-engine 1.8.30 → 2.0.0

package/src/google-business-profile.ts

@@ -1,280 +0,0 @@
-export interface GoogleBusinessProfileConfig {
-  placeId?: string;
-  businessName: string;
-  category: string;
-  streetAddress: string;
-  addressLocality: string;
-  postalCode: string;
-  addressCountry: string;
-  telephone: string;
-  priceRange?: string;
-  latitude?: number;
-  longitude?: number;
-  openingHours?: string[]; // e.g. ["Mo-Fr 09:00-18:00", "Sa 10:00-16:00"]
-  ratingValue?: number;
-  reviewCount?: number;
-  googleMapsUrl?: string;
-}
-
-export interface GbpAuditResult {
-  score: number;
-  grade: "A+" | "A" | "B" | "C" | "D";
-  passedChecks: number;
-  totalChecks: number;
-  checks: Array<{
-    name: string;
-    status: "pass" | "warn" | "fail";
-    points: number;
-    description: string;
-    recommendation?: string;
-  }>;
-  summary: string;
-  localPackEligibility: "Excellente" | "Moyenne" | "Faible";
-}
-
-export class GoogleBusinessProfileEngine {
-  /**
-   * Generates Schema.org LocalBusiness JSON-LD structure matching Google specifications
-   */
-  static generateLocalBusinessSchema(config: GoogleBusinessProfileConfig) {
-    const schema: Record<string, any> = {
-      "@context": "https://schema.org",
-      "@type": config.category || "LocalBusiness",
-      "name": config.businessName,
-      "address": {
-        "@type": "PostalAddress",
-        "streetAddress": config.streetAddress,
-        "addressLocality": config.addressLocality,
-        "postalCode": config.postalCode,
-        "addressCountry": config.addressCountry || "FR"
-      },
-      "telephone": config.telephone,
-      "priceRange": config.priceRange || "€€"
-    };
-
-    if (config.latitude && config.longitude) {
-      schema.geo = {
-        "@type": "GeoCoordinates",
-        "latitude": config.latitude,
-        "longitude": config.longitude
-      };
-    }
-
-    if (config.openingHours && config.openingHours.length > 0) {
-      schema.openingHours = config.openingHours;
-    }
-
-    if (config.ratingValue && config.reviewCount) {
-      schema.aggregateRating = {
-        "@type": "AggregateRating",
-        "ratingValue": config.ratingValue.toString(),
-        "reviewCount": config.reviewCount.toString(),
-        "bestRating": "5",
-        "worstRating": "1"
-      };
-    }
-
-    if (config.googleMapsUrl || config.placeId) {
-      schema.hasMap = config.googleMapsUrl || `https://www.google.com/maps/place/?q=place_id:${config.placeId}`;
-    }
-
-    return schema;
-  }
-
-  /**
-   * Generates interactive HTML Badge with Google Review stars and direct Maps link
-   */
-  static generateGbpBadgeHtml(config: GoogleBusinessProfileConfig): string {
-    const stars = "★".repeat(Math.round(config.ratingValue || 5)) + "☆".repeat(5 - Math.round(config.ratingValue || 5));
-    const mapsUrl = config.googleMapsUrl || (config.placeId ? `https://www.google.com/maps/place/?q=place_id:${config.placeId}` : "#");
-
-    return `
-      <div style="background:#ffffff;border:1px solid #e2e8f0;border-radius:12px;padding:16px 20px;max-width:420px;box-shadow:0 2px 4px rgba(0,0,0,0.04);font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;">
-        <div style="display:flex;align-items:center;justify-content:space-between;margin-bottom:8px;">
-          <div style="display:flex;align-items:center;gap:8px;">
-            <svg width="20" height="20" viewBox="0 0 24 24" fill="#4285F4"><path d="M12 2C8.13 2 5 5.13 5 9c0 5.25 7 13 7 13s7-7.75 7-13c0-3.87-3.13-7-7-7zm0 9.5c-1.38 0-2.5-1.12-2.5-2.5s1.12-2.5 2.5-2.5 2.5 1.12 2.5 2.5-1.12 2.5-2.5 2.5z"/></svg>
-            <strong style="font-size:15px;color:#0f172a;">${config.businessName}</strong>
-          </div>
-          <span style="font-size:11px;font-weight:700;color:#166534;background:#dcfce7;padding:2px 8px;border-radius:999px;">Vérifié Google</span>
-        </div>
-        <div style="font-size:13px;color:#475569;margin-bottom:8px;">
-          ${config.streetAddress}, ${config.postalCode} ${config.addressLocality}
-        </div>
-        <div style="display:flex;align-items:center;justify-content:space-between;border-top:1px solid #f1f5f9;padding-top:10px;">
-          <div style="display:flex;align-items:center;gap:6px;">
-            <span style="color:#f59e0b;letter-spacing:1px;font-size:14px;">${stars}</span>
-            <strong style="font-size:13px;color:#0f172a;">${config.ratingValue || "4.9"}/5</strong>
-            <span style="font-size:12px;color:#64748b;">(${config.reviewCount || "128"} avis)</span>
-          </div>
-          <a href="${mapsUrl}" target="_blank" rel="noopener noreferrer" style="font-size:12px;color:#2563eb;font-weight:600;text-decoration:none;">Voir sur Google Maps &rarr;</a>
-        </div>
-      </div>
-    `.trim();
-  }
-
-  /**
-   * Complete Diagnostic & Audit of a Google Business Profile / Local SEO setup
-   */
-  static auditProfile(config: GoogleBusinessProfileConfig): GbpAuditResult {
-    const checks: GbpAuditResult["checks"] = [];
-    let score = 0;
-
-    // 1. Nom d'établissement
-    if (config.businessName && config.businessName.length >= 3) {
-      checks.push({
-        name: "Nom de l'établissement (NAP)",
-        status: "pass",
-        points: 15,
-        description: `Nom correctement configuré : "${config.businessName}".`
-      });
-      score += 15;
-    } else {
-      checks.push({
-        name: "Nom de l'établissement (NAP)",
-        status: "fail",
-        points: 15,
-        description: "Nom d'établissement manquant ou trop court.",
-        recommendation: "Renseignez le nom exact de votre entreprise tel qu'affiché sur Google Maps."
-      });
-    }
-
-    // 2. Adresse & Code Postal
-    if (config.streetAddress && config.postalCode && config.addressLocality) {
-      checks.push({
-        name: "Adresse physique complète",
-        status: "pass",
-        points: 20,
-        description: `Adresse géolocalisée : ${config.streetAddress}, ${config.postalCode} ${config.addressLocality}.`
-      });
-      score += 20;
-    } else {
-      checks.push({
-        name: "Adresse physique complète",
-        status: "fail",
-        points: 20,
-        description: "Adresse ou code postal incomplet.",
-        recommendation: "Renseignez la rue, le code postal et la ville pour le ciblage Google Maps Local Pack."
-      });
-    }
-
-    // 3. Téléphone
-    if (config.telephone && config.telephone.length >= 8) {
-      checks.push({
-        name: "Téléphone direct vérifié",
-        status: "pass",
-        points: 10,
-        description: `Numéro de contact : ${config.telephone}.`
-      });
-      score += 10;
-    } else {
-      checks.push({
-        name: "Téléphone direct vérifié",
-        status: "warn",
-        points: 10,
-        description: "Numéro de téléphone absent.",
-        recommendation: "Ajoutez un numéro de téléphone fixe ou mobile local pour permettre les appels directs depuis les SERP."
-      });
-    }
-
-    // 4. Coordonnées GPS
-    if (config.latitude && config.longitude && !isNaN(config.latitude) && !isNaN(config.longitude)) {
-      checks.push({
-        name: "Coordonnées GPS (Lat / Long)",
-        status: "pass",
-        points: 15,
-        description: `Positionnement précis : ${config.latitude}, ${config.longitude}.`
-      });
-      score += 15;
-    } else {
-      checks.push({
-        name: "Coordonnées GPS (Lat / Long)",
-        status: "fail",
-        points: 15,
-        description: "Coordonnées GPS manquantes dans le schéma.",
-        recommendation: "Ajoutez les coordonnées de latitude/longitude exactes pour optimiser l'affichage dans le Google 3-Pack."
-      });
-    }
-
-    // 5. Horaires d'ouverture
-    if (config.openingHours && config.openingHours.length > 0) {
-      checks.push({
-        name: "Horaires d'ouverture",
-        status: "pass",
-        points: 10,
-        description: `${config.openingHours.length} créneau(x) d'ouverture configuré(s).`
-      });
-      score += 10;
-    } else {
-      checks.push({
-        name: "Horaires d'ouverture",
-        status: "warn",
-        points: 10,
-        description: "Horaires d'ouverture non spécifiés.",
-        recommendation: "Indiquez vos horaires (ex: Mo-Fr 09:00-18:00) pour rassurer les clients et éviter le statut 'Fermé'."
-      });
-    }
-
-    // 6. Note Google & Volume d'Avis
-    const rating = config.ratingValue || 0;
-    const reviews = config.reviewCount || 0;
-    if (rating >= 4.5 && reviews >= 20) {
-      checks.push({
-        name: "Réputation & Preuve Sociale",
-        status: "pass",
-        points: 20,
-        description: `Excellente réputation : ${rating}/5 étoiles sur ${reviews} avis.`
-      });
-      score += 20;
-    } else if (rating >= 4.0 && reviews > 0) {
-      checks.push({
-        name: "Réputation & Preuve Sociale",
-        status: "warn",
-        points: 10,
-        description: `Note de ${rating}/5 avec ${reviews} avis.`,
-        recommendation: "Augmentez le volume d'avis certifiés au-delà de 20 avis pour maximiser le taux de conversion."
-      });
-      score += 10;
-    } else {
-      checks.push({
-        name: "Réputation & Preuve Sociale",
-        status: "fail",
-        points: 20,
-        description: "Avis clients absents ou note inférieure à 4.0.",
-        recommendation: "Activez la collecte d'avis clients réels pour afficher les étoiles dorées dans Google."
-      });
-    }
-
-    // 7. Lien Google Maps ou Place ID
-    if (config.placeId || config.googleMapsUrl) {
-      checks.push({
-        name: "Lien Google Place ID officiel",
-        status: "pass",
-        points: 10,
-        description: "Lien direct vers la fiche Maps configuré."
-      });
-      score += 10;
-    } else {
-      checks.push({
-        name: "Lien Google Place ID officiel",
-        status: "warn",
-        points: 10,
-        description: "Place ID Google non renseigné.",
-        recommendation: "Associez votre Place ID Google pour faciliter l'indexation par Google Maps."
-      });
-    }
-
-    const passedChecks = checks.filter(c => c.status === "pass").length;
-    const grade: GbpAuditResult["grade"] = score >= 90 ? "A+" : score >= 75 ? "A" : score >= 60 ? "B" : score >= 40 ? "C" : "D";
-    const eligibility: GbpAuditResult["localPackEligibility"] = score >= 80 ? "Excellente" : score >= 50 ? "Moyenne" : "Faible";
-
-    return {
-      score,
-      grade,
-      passedChecks,
-      totalChecks: checks.length,
-      checks,
-      summary: `Score Local SEO de ${score}/100 (Grade ${grade}) — Éligibilité Google Local 3-Pack : ${eligibility}.`,
-      localPackEligibility: eligibility
-    };
-  }
-}

package/src/i18n-detector.ts

@@ -1,98 +0,0 @@
-/**
- * 🌐 Dynamic i18n & Locale Auto-Detector
- * Automatically detects and synchronizes website locales without requiring hardcoded lists.
- * Compatible with next-intl, next-i18next, i18next, Paraglide, and Astro i18n.
- */
-
-export const SUPPORTED_CANONICAL_LOCALES = [
-  "en",
-  "fr",
-  "es",
-  "de",
-  "it",
-  "pt",
-  "nl",
-  "ru",
-  "tr",
-  "zh",
-  "ja",
-  "ko",
-  "hi",
-  "id",
-  "ar",
-  "pl",
-  "sv",
-  "no",
-  "da",
-  "fi",
-  "cs",
-  "el",
-  "ro",
-  "hu",
-  "uk",
-  "vi",
-  "th",
-  "ms",
-  "bg",
-  "hr",
-  "sk",
-  "sl",
-  "et",
-  "lv",
-  "lt",
-  "fa",
-  "bn",
-  "ta",
-  "sw",
-  "af",
-  "tl",
-] as const;
-
-export type SupportedLocale = (typeof SUPPORTED_CANONICAL_LOCALES)[number];
-
-export class I18nDetector {
-  /**
-   * Resolves a clean 2-letter ISO language code from any locale string (e.g. "fr-FR" -> "fr").
-   */
-  static normalizeLocale(localeInput?: string): string {
-    if (!localeInput || typeof localeInput !== "string") return "en";
-    const clean = localeInput.toLowerCase().split(/[-_]/)[0].trim();
-    return clean || "en";
-  }
-
-  /**
-   * Auto-detects and extracts active locales from common environment variables or array inputs.
-   */
-  static resolveActiveLocales(explicitLocales?: string[] | string): string[] {
-    if (explicitLocales) {
-      const list = Array.isArray(explicitLocales) ? explicitLocales : [explicitLocales];
-      const normalized = list.map((l) => this.normalizeLocale(l)).filter(Boolean);
-      return Array.from(new Set(normalized));
-    }
-
-    // Default fallback
-    return ["en", "fr"];
-  }
-
-  /**
-   * Matches whether a given path segment is a language prefix (e.g. "/fr/autopost-facebook/paris").
-   */
-  static extractLocaleFromPath(pathname: string, activeLocales: string[]): { locale: string; remainingPath: string } {
-    const cleanPath = pathname.startsWith("/") ? pathname : `/${pathname}`;
-    const segments = cleanPath.split("/").filter(Boolean);
-
-    if (segments.length > 0 && activeLocales.includes(segments[0].toLowerCase())) {
-      const locale = segments[0].toLowerCase();
-      const remainingSegments = segments.slice(1);
-      return {
-        locale,
-        remainingPath: `/${remainingSegments.join("/")}`,
-      };
-    }
-
-    return {
-      locale: activeLocales[0] || "en",
-      remainingPath: cleanPath,
-    };
-  }
-}